knowledge
/
awesome-cheatsheets
mirror of https://github.com/namibia/awesome-cheatsheets.git
1
1
Fork 0
Code Issues Releases Activity

Update FeathersJS cheatsheet to Feathers v4

This commit is contained in:
David Luecke 2019-08-28 08:57:12 -07:00 committed by GitHub
parent 81eae536b6
commit 432c2c8bec
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 106 additions and 214 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

320
backend/feathers.js
View File

@ -113,13 +113,13 @@ app.service('my-service').hooks({
before: { before: {
all: [ all: [
// Use normal functions // Use normal functions
function(context) { console.log('before all hook ran'); } async function(context) { console.log('before all hook ran'); }
], ],
find: [ find: [
// Use ES6 arrow functions // Use ES6 arrow functions
context => console.log('before find hook 1 ran'), context => console.log('before find hook 1 ran'),
context => console.log('before find hook 2 ran') async context => console.log('before find hook 2 ran')
], ],
async create (context) { async create (context) {
@ -177,7 +177,8 @@ service.publish([event,] fn) // registers a publishing function for a specific
app.publish([event,] fn) // registers an event publishing callback app.publish([event,] fn) // registers an event publishing callback
app.on('connection', connection => {}) // fired every time a new real-time connection is established app.on('connection', connection => {}) // fired every time a new real-time connection is established
app.on('login', (payload, info) => {}) // sent by the authentication module and also contains the connection in the info object that is passed as the second parameter app.on('disconnection', connection => {})
app.on('login', (authenticationResult, params, context) => {}) // sent by the authentication module and also contains the connection in the info object that is passed as the second parameter
/* ******************************************************************************************* /* *******************************************************************************************
@ -233,13 +234,6 @@ app.configure(socketio(callback)) // sets up the Socket.io t
app.configure(socketio(options [, callback])) // sets up the Socket.io transport with the given Socket.io options object and optionally calls the callback app.configure(socketio(options [, callback])) // sets up the Socket.io transport with the given Socket.io options object and optionally calls the callback
app.configure(socketio(port, [options], [callback])) // creates a new Socket.io server on a separate port. Options and a callback are optional app.configure(socketio(port, [options], [callback])) // creates a new Socket.io server on a separate port. Options and a callback are optional
// The options can also be used to initialize uWebSocket which is a WebSocket server
// implementation that provides better performace and reduced latency.
// npm install uws --save
app.configure(socketio({
wsEngine: 'uws'
}));
// --> PRIMUS <-- // --> PRIMUS <--
// https://docs.feathersjs.com/api/client/primus.html // https://docs.feathersjs.com/api/client/primus.html
@ -306,55 +300,65 @@ npm install @feathersjs/authentication --save
# Wraps the passport-local authentication strategy (username and password) # Wraps the passport-local authentication strategy (username and password)
npm install @feathersjs/authentication-local --save npm install @feathersjs/authentication-local --save
# Wraps the passport-jwt authentication strategy (JSON Web Token access token) # Allows to use 180+ oAuth providers (Facebook, Google, Twitter etc.)
npm install @feathersjs/authentication-jwt --save npm install @feathersjs/authentication-oauth --save
# Allows you to use any Passport OAuth1 authentication strategy (most notably Twitter)
npm install @feathersjs/authentication-oauth1 --save
# Allows you to use any Passport OAuth2 authentication strategy (FB, Instagram, Github, Google...)
npm install @feathersjs/authentication-oauth2 --save
``` ```
// --> SERVER <-- // --> SERVER <--
// https://docs.feathersjs.com/api/authentication/server.html // https://docs.feathersjs.com/api/authentication/server.html
const options = { const options = {
path: '/authentication', // the authentication service path "authentication": {
header: 'Authorization', // the header to use when using JWT auth "secret": "CHANGE_ME", // The token signing secret
entity: 'user', // the entity that will be added to the request, socket, and context.params. (ie. req.user, socket.user, context.params.user) "entity": "user", // the entity that will be added to the request, socket, and context.params. (ie. req.user, socket.user, context.params.user)
service: 'users', // the service to look up the entity "service": "users", // the service to look up the entity
passReqToCallback: true, // whether the request object should be passed to the strategies `verify` function "authStrategies": [ "jwt", "local" ], // The authentication strategies to allow to create a token
session: false, // whether to use sessions "jwtOptions": {
cookie: { "header": { "typ": "access" }, // by default is an access token but can be any type
enabled: false, // whether cookie creation is enabled "audience": "https://yourdomain.com", // The resource server where the token is processed
name: 'feathers-jwt', // the cookie name "issuer": "feathers", // The issuing server, application or resource
httpOnly: false, // when enabled, prevents the client from reading the cookie. "algorithm": "HS256", // the algorithm to use
secure: true // whether cookies should only be available over HTTPS "expiresIn": "1d" // the access token expiry
}, }
jwt: {
header: { typ: 'access' }, // by default is an access token but can be any type
audience: 'https://yourdomain.com', // The resource server where the token is processed
subject: 'anonymous', // Typically the entity id associated with the JWT
issuer: 'feathers', // The issuing server, application or resource
algorithm: 'HS256', // the algorithm to use
expiresIn: '1d' // the access token expiry
} }
} }
app.configure(auth(options)) // configure the authentication plugin with the given options const { AuthenticationService, JWTStrategy } = require('@feathersjs/authentication');
service = app.service('authentication') // service for creating JWT (implements only the create and remove methods) let authService = new AuthenticationService(app);
service.create(data) // creates a JWT based on the jwt options configured on the plugin service.register('jwt', new JWTStrategy());
service.remove(data) // removes the JWT token (mostly exists for the logout process)
service.hooks({ before }) // registers hooks for this service
service.hooks({ after }) // registers hooks for this service
app.passport.createJWT(payload, options) // used by the authentication service to generate JSON Web Tokens app.use('/authentication', authService);
app.passport.verifyJWT(token, options) // verifies the signature and payload of the passed in JWT token using the options app.configure(expressOauth());
app.get('defaultAuthentication') // The name of the default authentication service
authService = app.service('authentication') // service for creating JWT (implements only the create and remove methods)
authService.hooks({ before }) // registers hooks for this service
authService.hooks({ after }) // registers hooks for this service
new AuthenticationService(app) // Create a new authentication service
class MyAuthenticationService extends AuthenticationService {} // Customize the authentication service
authService.authenticate(data, params, ...strategies) // Authenticate with strategies
authService.create(data, params) // Authenticate with data and params
authService.create({ // Authenticate and create a JWT using the local strategy email/password
strategy: 'local',
email: 'hello@feathersjs.com',
password: 'supersecret'
});
authService.remove(id, params) // removes the JWT token (mostly exists for the logout process)
authService.configuration // The current configuration
authService.register(name, strategy) // Register a new authentication strategy
authService.createAccessToken(payload) // Create a new access token with payload
authService.verifyAccessToken(accessToken) // Verify an existing access token
authService.getTokenOptions(authResult, params) // Get the options for a token
authService.getPayload(authResult, params) // Return the payload for an authentication result
authService.parse(req, res, ...strategies) // Parse an HTTP request and response with using a list of strategies
auth.hooks.authenticate(strategies) // registers an array of authentication strategies on a service method
app.on('login', callback)) // emits an event whenever a client successfully authenticates app.on('login', callback)) // emits an event whenever a client successfully authenticates
app.on('logout', callback)) // emits an event whenever a client successfully logout app.on('logout', callback)) // emits an event whenever a client successfully logout
@ -363,198 +367,77 @@ app.on('logout', callback)) // emits an event whenever a client successfully lo
// https://docs.feathersjs.com/api/authentication/client.html // https://docs.feathersjs.com/api/authentication/client.html
const options = { const options = {
path: '/authentication', // the server-side authentication service path storage: window.localStorage, // The storage to store the access token
header: 'Authorization', // the default authorization header for REST path: '/authentication', // The path of the authentication service
jwtStrategy: 'jwt', // the name of the JWT authentication strategy locationKey: 'access_token', // The name of the window hash parameter to parse for an access token from the window.location. Usually used by the oAuth flow.
entity: 'user', // the entity you are authenticating (ie. a users) locationErrorKey: 'error', // The name of the window hash parameter to parse for authentication errors. Usually used by the oAuth flow.
service: 'users', // the service to look up the entity jwtStrategy: 'jwt', // The access token authentication strategy
cookie: 'feathers-jwt', // the name of the cookie to parse the JWT from when cookies are enabled server side storageKey: 'feathers-jwt', // Key for storing the token in e.g. localStorage
storageKey: 'feathers-jwt', // the key to store the accessToken in localstorage or AsyncStorage on React Native header: 'Authorization', // Name of the accessToken header
storage: undefined // Passing a WebStorage-compatible object to enable automatic storage on the client. scheme: 'Bearer', // The HTTP header scheme
Authentication: AuthenticationClient // Allows to provide a customized authentication client class
} }
app.configure(auth(options)) // configure the authentication plugin with the given options app.configure(auth(options)) // configure the authentication plugin with the given options
app.authenticate() // authenticates using the JWT from the storage app.reAuthenticate() // authenticates using the JWT from the storage
app.authenticate(options) // authenticate with a Feathers server by passing a strategy and other properties as credentials app.authenticate(options) // authenticate with a Feathers server by passing a strategy and other properties as credentials
app.logout() // removes the JWT accessToken from storage on the client app.logout() // removes the JWT accessToken from storage on the client
app.passport.getJWT() // pulls the JWT from storage or the cookie const authenticationInfo = await app.get('authentication'); // The authenticatoin information (like the user)
app.passport.verifyJWT(token) // verifies that a JWT is not expired and decode it to get the payload
app.passport.payloadIsValid(token) // synchronously verify that a token has not expired
app.on('authenticated', callback)) // emits an event whenever the client successfully authenticates app.on('login', callback) // emits an event whenever the client successfully authenticates
app.on('logout', callback)) // emits an event whenever the client successfully authenticates app.on('logout', callback) // emits an event whenever the client successfully authenticates
app.on('reauthentication-error', errorHandler) // will automatically handle attempting to re-authenticate the socket when the client regains connectivity with the server
// --> LOCAL (EMAIL & PASSWORD) <-- // --> LOCAL (EMAIL & PASSWORD) <--
// https://docs.feathersjs.com/api/authentication/local.html // https://docs.feathersjs.com/api/authentication/local.html
const feathers = require('@feathersjs/feathers'); const { LocalStrategy } = require('@feathersjs/authentication-local');
const authentication = require('@feathersjs/authentication');
const local = require('@feathersjs/authentication-local');
const app = feathers();
const options = { const options = {
name: 'local', // the name to use when invoking the authentication Strategy usernameField: 'email', // Name of the username field in the (e.g. 'email')
entity: 'user', // the entity that you're comparing username/password against passwordField: 'password', // Name of the password field (e.g. 'password')
service: 'users', // the service to look up the entity hashSize: 10, // The BCrypt hash size
usernameField: 'email', // key name of username field errorMessage: 'Invalid login', // The error message to return on errors
passwordField: 'password', // key name of password field entityUsernameField: usernameField, // Name of the username field on the entity if authentication request data and entity field names are different
passReqToCallback: true, // whether the request object should be passed to `verify` entityPasswordField: passwordField // Name of the password field on the entity if authentication request data and entity field names are different
session: false, // whether to use sessions
Verifier: Verifier // A Verifier class. Defaults to the built-in one but can be a custom one
} }
app.configure(authentication(options)); authService.register('local', new LocalStrategy());
app.configure(local());
// Setup a hook to only allow valid JWTs or successful
// local auth to authenticate and get new JWT access tokens
app.service('authentication').hooks({
before: {
create: [
authentication.hooks.authenticate(['local', 'jwt'])
]
}
});
local.hooks.hashPassword() // hashes plain text passwords before they are saved to the database local.hooks.hashPassword() // hashes plain text passwords before they are saved to the database
local.hooks.protect('password') // makes sure that protected fields don't get sent to a client local.hooks.protect('password') // makes sure that protected fields don't get sent to a client
// --> JWT <-- // --> OAUTH <--
// https://docs.feathersjs.com/api/authentication/jwt.html // https://docs.feathersjs.com/api/authentication/oauth.html
const { expressOauth, OAuthStrategy } = require('@feathersjs/authentication-oauth');
const feathers = require('@feathersjs/feathers'); class GitHubStrategy extends OAuthStrategy {
const authentication = require('@feathersjs/authentication'); async getEntityData(profile) {
const jwt = require('@feathersjs/authentication-jwt'); const baseData = await super.getEntityData(profile);
const app = feathers();
const options = { return {
name: 'jwt', // the name to use when invoking the authentication Strategy ...baseData,
entity: 'user', // the entity that you pull from if an 'id' is present in the payload email: profile.email
service: 'users', // the service to look up the entity };
passReqToCallback: true, // whether the request object should be passed to `verify` }
jwtFromRequest: [ // a passport-jwt option determining where to parse the JWT
ExtractJwt.fromHeader, // From "Authorization" header
ExtractJwt.fromAuthHeaderWithScheme('Bearer'), // Allowing "Bearer" prefix
ExtractJwt.fromBodyField('body') // from request body
],
secretOrKey: auth.secret, // Your main secret provided to passport-jwt
session: false, // whether to use sessions,
Verifier: Verifier // A Verifier class. Defaults to the built-in one but can be a custom one. See below for details.
} }
app.configure(authentication(options)); authService.register('github', new MyGitHubStrategy());
app.configure(jwt());
// Setup a hook to only allow valid JWTs to authenticate
// and get new JWT access tokens
app.service('authentication').hooks({
before: {
create: [
authentication.hooks.authenticate(['jwt'])
]
}
});
// --> OAUTH1 <--
// https://docs.feathersjs.com/api/authentication/oauth1.html
const feathers = require('@feathersjs/feathers');
const authentication = require('@feathersjs/authentication');
const jwt = require('@feathersjs/authentication-jwt');
const oauth1 = require('@feathersjs/authentication-oauth1');
const session = require('express-session');
const TwitterStrategy = require('passport-twitter').Strategy;
const app = feathers();
// Setup in memory session
app.use(session({
secret: 'super secret',
resave: true,
saveUninitialized: true
}));
const options = { const options = {
idField: '<provider>Id', // The field to look up the entity by when logging in with the provider. Defaults to '<provider>Id' (ie. 'twitterId'). authentication: {
path: '/auth/<provider>', // The route to register the middleware oauth: {
callbackURL: 'http(s)://hostame[:port]/auth/<provider>/callback', // The callback url. Will automatically take into account your host and port and whether you are in production based on your app environment to construct the url. (ie. in development http://localhost:3030/auth/twitter/callback) redirect: '/', // The redirect after a successful login
entity: 'user', // the entity that you are looking up github: { // The per-strategy configuration
service: 'users', // the service to look up the entity key: '<Client ID>',
passReqToCallback: true, // whether the request object should be passed to `verify` secret: '<Client secret>'
session: true, // whether to use sessions, }
handler: fn, // Express middleware for handling the oauth callback. Defaults to the built in middleware. }
formatter: fn, // The response formatter. Defaults the the built in feathers-rest formatter, which returns JSON. }
Verifier: Verifier // A Verifier class. Defaults to the built-in one but can be a custom one. See below for details.
} }
// Setup authentication app.configure(expressOauth(options));
app.configure(authentication(options));
app.configure(jwt());
app.configure(oauth1({
name: 'twitter',
Strategy: TwitterStrategy,
consumerKey: '<your consumer key>',
consumerSecret: '<your consumer secret>'
}));
// Setup a hook to only allow valid JWTs to authenticate
// and get new JWT access tokens
app.service('authentication').hooks({
before: {
create: [
authentication.hooks.authenticate(['jwt'])
]
}
});
// --> OAUTH 2 <--
// https://docs.feathersjs.com/api/authentication/oauth2.html
const feathers = require('@feathersjs/feathers');
const authentication = require('@feathersjs/authentication');
const jwt = require('@feathersjs/authentication-jwt');
const oauth2 = require('@feathersjs/authentication-oauth2');
const FacebookStrategy = require('passport-facebook').Strategy;
const app = feathers();
const options = {
idField: '<provider>Id', // The field to look up the entity by when logging in with the provider. Defaults to '<provider>Id' (ie. 'facebookId').
path: '/auth/<provider>', // The route to register the middleware
callbackURL: 'http(s)://hostname[:port]/auth/<provider>/callback', // The callback url. Will automatically take into account your host and port and whether you are in production based on your app environment to construct the url. (ie. in development http://localhost:3030/auth/facebook/callback)
successRedirect: undefined,
failureRedirect: undefined,
entity: 'user', // the entity that you are looking up
service: 'users', // the service to look up the entity
passReqToCallback: true, // whether the request object should be passed to `verify`
session: false, // whether to use sessions,
handler: fn, // Express middleware for handling the oauth callback. Defaults to the built in middleware.
formatter: fn, // The response formatter. Defaults the the built in feathers-rest formatter, which returns JSON.
Verifier: Verifier // A Verifier class. Defaults to the built-in one but can be a custom one. See below for details.
}
// Setup authentication
app.configure(authentication({ secret: 'super secret' }));
app.configure(jwt());
app.configure(oauth2({
name: 'facebook',
Strategy: FacebookStrategy,
clientID: '<your client id>',
clientSecret: '<your client secret>',
scope: ['public_profile', 'email']
}));
// Setup a hook to only allow valid JWTs to authenticate
// and get new JWT access tokens
app.service('authentication').hooks({
before: {
create: [
authentication.hooks.authenticate(['jwt'])
]
}
});
/* ******************************************************************************************* /* *******************************************************************************************
@ -602,7 +485,9 @@ app.use('/messages', service({
paginate: { // (optional) a pagination object containing a default and max page size paginate: { // (optional) a pagination object containing a default and max page size
default: undefined, // sets the default number of items when $limit is not set default: undefined, // sets the default number of items when $limit is not set
max: undefined // sets the maximum allowed number of items per page (even if the $limit query parameter is set higher) max: undefined // sets the maximum allowed number of items per page (even if the $limit query parameter is set higher)
} },
whitelist: [], // A list of additional non-standard query parameters to allow (e.g [ '$regex', '$populate' ])
multi: true // Allow create with arrays and update and remove with id null to change multiple items
})); }));
adapter.find() // returns a list of all records matching the query in params.query using the common querying mechanism adapter.find() // returns a list of all records matching the query in params.query using the common querying mechanism
@ -612,6 +497,14 @@ adapter.update(id, data, params) // completely replaces a single record identif
adapter.patch(id, data, params) // merges a record identified by id with data. id can be null to allow replacing multiple records (all records that match params.query the same as in .find). id can not be changed adapter.patch(id, data, params) // merges a record identified by id with data. id can be null to allow replacing multiple records (all records that match params.query the same as in .find). id can not be changed
adapter.remove(id, params) // removes a record identified by id. id can be null to allow removing multiple records (all records that match params.query the same as in .find) adapter.remove(id, params) // removes a record identified by id. id can be null to allow removing multiple records (all records that match params.query the same as in .find)
// Hook-less
adapter._find()
adapter._get(id, params)
adapter._create(data, params)
adapter._update(id, data, params)
adapter._patch(id, data, params)
adapter._remove(id, params)
// --> QUERYING <-- // --> QUERYING <--
// https://docs.feathersjs.com/api/databases/querying.html // https://docs.feathersjs.com/api/databases/querying.html
@ -673,14 +566,13 @@ app.service('messages').find({
// │ │ └── ... // │ │ └── ...
// │ ├── services/ # contains our services // │ ├── services/ # contains our services
// │ │ └── ... // │ │ └── ...
// │ ├── tests/ # contains Mocha test files for the app, hooks and services
// │ │ └── ...
// │ │ // │ │
// │ ├── index.js # is used to load and start the application // │ ├── index.js # is used to load and start the application
// │ ├── app.js # configures our Feathers application // │ ├── app.js # configures our Feathers application
// │ ├── app.hooks.js # contains hooks which that run for all services // │ ├── app.hooks.js # contains hooks which that run for all services
// │ └── channels.js # set up Feathers event channels // │ └── channels.js # set up Feathers event channels
// │ // ├── tests/ # contains Mocha test files for the app, hooks and services
// │ └── ...
// ├── .editorconfig # helps developers define and maintain consistent coding styles // ├── .editorconfig # helps developers define and maintain consistent coding styles
// ├── .eslintrc.json # eslint configuration // ├── .eslintrc.json # eslint configuration
// └── package.json # express server for production // └── package.json # express server for production