# nautilus-nodejs-api-core > Base repository for creating microservices Latest version **1.2.0** (published 2020-07-07) · ISC license · 0 weekly downloads > **Deprecated.** This package is deprecated. ## Install ```sh npm install nautilus-nodejs-api-core pnpm add nautilus-nodejs-api-core yarn add nautilus-nodejs-api-core bun add nautilus-nodejs-api-core ``` ## Health **Score 10/100 (F)** — status: deprecated. Negative: deprecated. ## Facts | | | |---|---| | Version | 1.2.0 | | Published | 2020-07-07 | | First published | 2020-06-20 | | Weekly downloads | 0 | | License | ISC | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 23 | | Unpacked size | 83.4 KB | | Known vulnerabilities | 0 (+5 in 1 direct dependencies) | | Install scripts | no | | GitHub stars | 1 | | Author | charleston anjos | | Maintainers | charleston10 | ## Links - npm: https://www.npmjs.com/package/nautilus-nodejs-api-core - Repository: https://github.com/charleston10/nautilus-nodejs-api-core - Homepage: https://github.com/charleston10/nautilus-nodejs-api-core#readme - Issues: https://github.com/charleston10/nautilus-nodejs-api-core/issues - npm.io page: https://npm.io/package/nautilus-nodejs-api-core ## Dependencies (23) - [pg](https://npm.io/package/pg.md) ^8.2.1 - [cors](https://npm.io/package/cors.md) ^2.8.5 - [node](https://npm.io/package/node.md) ^14.0.5 - [awilix](https://npm.io/package/awilix.md) ^4.2.6 - [dotenv](https://npm.io/package/dotenv.md) ^8.2.0 - [log4js](https://npm.io/package/log4js.md) ^6.3.0 - [morgan](https://npm.io/package/morgan.md) ^1.9.0 - [rimraf](https://npm.io/package/rimraf.md) ^3.0.2 - [express](https://npm.io/package/express.md) ^4.17.1 - [nodemon](https://npm.io/package/nodemon.md) ^2.0.4 - [ts-node](https://npm.io/package/ts-node.md) ^8.10.1 - [cross-env](https://npm.io/package/cross-env.md) ^7.0.2 - [sequelize](https://npm.io/package/sequelize.md) ^5.21.13 - [typescript](https://npm.io/package/typescript.md) ^3.9.3 - [underscore](https://npm.io/package/underscore.md) ^1.10.2 - [body-parser](https://npm.io/package/body-parser.md) ^1.19.0 - [compression](https://npm.io/package/compression.md) ^1.7.4 - [http-status](https://npm.io/package/http-status.md) ^1.4.2 - [sequelize-cli](https://npm.io/package/sequelize-cli.md) ^5.5.1 - [awilix-express](https://npm.io/package/awilix-express.md) ^3.0.0 - [method-override](https://npm.io/package/method-override.md) ^3.0.0 - [express-sanitized](https://npm.io/package/express-sanitized.md) ^0.5.1 - [express-status-monitor](https://npm.io/package/express-status-monitor.md) ^1.3.2 ## Recent versions - 1.2.0 (latest) — 2020-07-07 - 1.1.0 — 2020-07-07 - 1.0.27 — 2020-07-06 - 1.0.26 — 2020-07-05 - 1.0.25 — 2020-07-05 - 1.0.24 — 2020-07-05 - 1.0.23 — 2020-07-05 - 1.0.22 — 2020-07-05 - 1.0.21 — 2020-07-05 - 1.0.20 — 2020-07-05 - 1.0.19 — 2020-07-05 - 1.0.18 — 2020-07-05 - 1.0.17 — 2020-06-23 - 1.0.16 — 2020-06-23 - 1.0.15 — 2020-06-23 - … 15 more at https://npm.io/package/nautilus-nodejs-api-core/versions ## README # Nautilustar API Core NautilusStar API Core is a standard feature set of an api It serves as a core module for building api for microservices It has all integration with http server, routes, database, logs and injection dependency To facilitate integration and development, the Clean architecture concept is used, but you can use any type of architecture. It is possible to make declarations from Mappers, Entities, Model, Repositories, UseCase, Controllers etc. ## Installation Install with `npm` ```npm i nautilus-nodejs-api-core --save``` Npm Package https://www.npmjs.com/package/nautilus-nodejs-api-core ## Sample Repo https://github.com/charleston10/nautilus-nodejs-api-users-sample.git ```git clone https://github.com/charleston10/nautilus-nodejs-api-users-sample.git``` ## Usage This configuration based in Clean Architecture (input request http) Presentration -> Domain -> Data (output response htttp) Data -> Domain -> Presentation ```javascript import path from "path" import { container, application, database, logger } from 'nautilus-nodejs-api-core'; //create register database //is used sequelize for create the configuration //the config database is .env database .register(container) .loadEntity(path.join(`data`, `local`, `entities`), __dirname);//import entities of datbase //create all config the application //register mappers, model, repository, usecase and controllers //all classes and files will be available to be injected in context of application application .register(container) .loadMiddleware([ path.join(`core`, `middleware`) ], __dirname ) .loadValues([ path.join(`data`, `mappers`), path.join(`domain`, `model`) ], __dirname)//declare functions and files for inject .loadModules([ path.join(`data`, `repository`, `*.*`), path.join(`domain`, `usecase`, `**`, `*.*`) ], __dirname)//load modules core of your application to inject .loadRoutes( path.join(`presentation`, `controllers`, `*.*`) , __dirname)//declares routes from api to server .loadDatabase( database .register(container) .configure({...})//connection sequelize .loadEntity( path.join(`data`, `local`, `entities`), __dirname ) ) .start(process.env.PORT || 3000)//get informations by .env .catch((e: any) => { logger.error(e.stack);//log all error stack process.exit(); }) ``` ## Quick start All classes is enable for inject named with first letter in lowerCase Example: GetUserUseCase is enabled how getUserUseCase ### How to config routes The configuration of the controllers is the entire gateway to the application, where it is found in the Presentation layer of our architecture Here we can process input and output, searching the data through UseCase that will execute the necessary rule for the operation ```javascript import { route, GET, POST } from 'awilix-express'; import HTTP_STATUS from 'http-status'; @route('/users') export default class UserController { //variable injected using UserUseCase //classes registered in container in loadModules(domain) private _getAll: any; private _create: any; constructor({ getAll, create }: any) { this._getAll = getAll; this._create = create; } @GET() async get(req: any, res: any, next: any) { const { SUCCESS, ERROR } = this._getAll.outputs; this._getAll .on(SUCCESS, (listResult: Array) => { res .status(HTTP_STATUS.OK) .json(listResult); }) .on(ERROR, next); this._getAll.execute(); } @POST() async create(req: any, res: any, next: any) { const { SUCCESS, ERROR } = this._create.outputs; this._create .on(SUCCESS, (result: Object) => { res .status(HTTP_STATUS.OK) .json(result); }) .on(ERROR, next); this._create.execute(req.body); } } ``` ### How to config UseCase The UseCase component is responsible for executing all business rules of the project It has an asynchronous execution and can emit any result through events The usecase event in this case and the SUCCESS and ERROR event can be customized according to the need **Create User UseCase** ```javascript import { UseCase } from 'nautilus-nodejs-api-core' class Create extends UseCase { //variable injected using UserRepository and UserModel //classes registered in container in loadModules(repository) and loadValues(model) private repository: any; private Model: any; constructor({ userRepository, userModel }: any) { super() this.repository = userRepository; this.Model = userModel; } async execute(data: any) { const { SUCCESS, ERROR } = this.outputs; const model = new this.Model(data); try { const newData = await this.repository.add(model); this.emit(SUCCESS, newData); } catch (error) { this.emit(ERROR, error); } } } Create.setOutputs(['SUCCESS', 'ERROR']); export default Create; ``` **Get All User UseCase** ```javascript import { UseCase } from 'nautilus-nodejs-api-core' class GetAll extends UseCase { private repository: any; //variable injected using UserRepository //classes registered in container in loadModules(repository) constructor({ userRepository }: any) { super() this.repository = userRepository; } async execute() { const { SUCCESS, ERROR } = this.outputs; try { const data = await this.repository.getAll(); this.emit(SUCCESS, data); } catch (error) { this.emit(ERROR, error); } } } GetAll.setOutputs(['SUCCESS', 'ERROR']); export default GetAll; ``` ### How to config Repository All repositories are responsible for obtaining access data, in this case, entering the database Within our core module, there are some standard data access and writing functions that make it easier in our daily lives Using the class extension, it offers the functions GetAll, GetByIDd, Add, Remove, Update, Count and even Transaction The transaction you can use to make multiple inserts and rollback if needed And the methods can be overridden if necessary **Create User Repostiory** ```javascript import { BaseRepository } from 'nautilus-nodejs-api-core' class UserRepository extends BaseRepository { constructor({ userEntity, userMapper }: any) { super(userEntity, userMapper); } } export default UserRepository; ``` ### How to config Middlewares Most of the time, we need to add middleware to our api In a simple case, add Middleware to add an ID to identify a request made. Observation: An order that is being executed is an order that is in the folder (alphabetical order) Example ```javascript const crypto = require("crypto"); export = (req: any, res: any, next: any) => { const id = crypto.randomBytes(10).toString("hex"); req.requestId = id; next() } ``` Add this middleware in our application ```javascript import path from 'path'; application .register(container) .loadMiddleware([ path.join(`core`, `middlewares`),//or [core//middlewares] ], __dirname)//add any middlewares ``` ### How to config Database All database configuration is based on Sequelize, so the use of any database is dynamic and there is a working pattern To specify the bank registration data, it is necessary to use the settings in environment variables The module itself can see the values and make the connection normally ```javascript application.loadDatabase( database .register(container) .configure({ host: process.env.DB_HOST, dialect: process.env.DB_DIALECT, database: process.env.DB_NAME, username: process.env.DB_USERNAME, password: process.env.DB_PASSWORD, options: { logging: false } }) .loadEntity( path.join(`data`, `local`, `entities`), __dirname ) ) ``` ## Dependencies - [Node v7.6+](http://nodejs.org/) - [Express](https://npmjs.com/package/express) - [Sequelize](https://www.npmjs.com/package/sequelize) - [Awilix](https://www.npmjs.com/package/awilix) - [Structure](https://www.npmjs.com/package/structure) - [HTTP Status](https://www.npmjs.com/package/http-status) - [Log4js](https://www.npmjs.com/package/log4js) - [Morgan](https://www.npmjs.com/package/morgan) - [Express Status Monitor](https://www.npmjs.com/package/express-status-monitor) - [Nodemon](https://www.npmjs.com/package/nodemon) - [PM2](https://www.npmjs.com/package/pm2) - [Mocha](https://www.npmjs.com/package/mocha) - [Chai](https://www.npmjs.com/package/chai) - [FactoryGirl](https://www.npmjs.com/package/factory-girl) - [Istanbul](https://www.npmjs.com/package/istanbul) + [NYC](https://www.npmjs.com/package/nyc) - [ESLint](https://www.npmjs.com/package/eslint) ## Special thanks Culture for innovation time in my project [TraceFacil](www.tracefacil.com) and inspired in [boilerplate](https://github.com/charleston10/api-nodejs-clean-architecture) nodejs --- _Source: https://npm.io/package/nautilus-nodejs-api-core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._