Boilerplate for Rest API based on node js, uWebsockets.JS and mongo driver with JSON Schema validation (which is native for mongo)
yarn install
export default {
"MONGO_URL": "mongodb://localhost:27017/yourDatabase",
"dbName": "yourDatabase",
}
yarn start
yarn createLib [libName]
the new collection service will be created under:
/src/lib/[libName]
with all corresponding files and routes
/lib - the directory with all services that serve the database
/modules - the directory with additional helpers (modules, or services that serve additional purposes)
/startup - files that serve to start the server + basic routes
/users/signUp - Sign up with username and password
/users/login - Login with username and password
/users/ownData - get user data for registered user
ctx.mongoDb - The current pool mongo db
ctx.db - The mongodb collections, prepared for mongo queries (e.g. ctx.db.users or ctx.db.products etc...)
ctx.libS - All services/library that serve the collections
ctx.modS - All services/modules that serve different purposes
To check if the user has necessary Authentication
Check if user have the correct rights
Check if user have provided the required parameters for the request
Handle and process the request
import createBasicRoutes from '../../../modules/routing/RouteCreator';
import GetAllUsers from './actions/GetAllUsers';
import GetOwnData from './actions/GetOwnData';
const UserRoutes = createBasicRoutes(
{
prefix: '/users',
routeData: [
{
method: 'all',
path: '/',
handler: GetAllUsers.handler,
},
{
method: 'get',
path: '/ownData',
authentication: true, //if true, user should be logged in.
authorization: AuthorizeUser(),
validation: GetOwnData.validation,
handler: GetOwnData.handler,
},
...
],
},
);
which tokens availability is updated on each request and is valid only for 2 days after last activity of the user
If token provided by the frontends header ("Baerer {{token}}") then the server set the user in ctx.user
In mongoose models are coupled to the database, and using/validating a Model must be in an environment that can access the database. Also, mongoose schema functions (statics/virtuals, etc.) tend to put the business/application logic for handling/manipulating the data on mongoose/mongo, instead of in a service or model layer, which is a tight coupling that will eventually bite at scale.
Also as of Mongo 3.6 you can use draft-4 of the JSON Schema spec directly in Mongo.
In the project we use the package 'ajv' to validate the parameters before we give them try into the database.
The project is using also custom db-connection pool based on "generic-pool", so that we don't need to create connection on each request