Nodetomic-api-swagger

Simple and fast Restful API designed for horizontal scalability including cluster, based on Swagger, Socket.io, Nodejs, Redis + Passport, MongoDB, Express

Horizontal scalability

Preview

Swagger Api

http://localhost:8000/docs

Technologies

Codacy

Features

• Tokens
  • JWT merged with REDIS
  • Expiration time
• Redis
  • Pub/Sub
  • Events: Expired, del, etc
• Middleware
  • Login validation
  • Role validation
• Socket.io
  • Support cluster
  • Socket Redis
• Authentication
  • local
  • facebook
  • twitter
  • google
  • github
  • bitbucket
  • and more...
• Session
  • Single or Multiple (One or more devices at the same time)
  • Get list of sessions
  • Destroy a session
• Node
  • Support cluster
  • Support Pm2
• Swagger
  • Routers by swagger
  • Swagger UI

Requirements

• Nodejs >= 6.x.x (Recommended 8.x.x)
• MongoDB >= 3.x.x
• Redis >= 3.x.x (Recommended 4.x.x)

Installation

git clone https://github.com/kevoj/nodetomic-api-swagger
cd nodetomic-api-swagger
npm i

How to create..

Model

src/api/models/hello.js

import mongoose from 'mongoose';
const Schema = mongoose.Schema;

const HelloSchema = new Schema({
  greet: {
    type: String,
    required: [true, 'Greet is required.']
  },
  language: {
    type: String,
    required: [true, 'Language is required.']
  }
});

export default mongoose.model('Hello', HelloSchema);

Controller

src/api/controllers/hello.js

import { result, notFound, error } from 'express-easy-helper';
import Hello from '../models/hello';

export function list(req, res) {
    return Hello.find().exec()
    .then(notFound(res))
    .then(result(res))
    .catch(error(res));
}

Swagger (Router)

src/api/swagger/hello.yaml

/api/hello:
  x-swagger-router-controller: hello 
  get:
    operationId: list
    tags:
      - Hello
    summary: Get list Hello's
    description: Returns all hello
    responses:
      200:
        description: Success
      404:
        description: Not found
      500:
        description: Error

Swagger (Router + middleware)

src/api/swagger/hello.yaml

/api/hello:
  x-swagger-router-controller: hello 
  get:
    operationId: list
    security:
      - Bearer: []
    x-security-scopes:
      - admin
    tags:
      - Hello
    summary: Get list Hello's
    description: Returns all hello
    responses:
      200:
        description: Success
      404:
        description: Not found
      500:
        description: Error

Socket

src/api/sockets/hello.js

let socket = null;
let io = null;

// Constructor
export default (_socket, _io) => {
    socket = _socket;
    io = _io;
    on();
}

// Here should be all events 'on'
export function on() {
    // Listen 'example'
    socket.on('example', function (data) {
        // emit to cool
        io.emit('cool', data);
    });
}

export function emit(data) {
    io.emit('other event', data);
}

Controller + Socket

src/api/controllers/hello.js

import { result, notFound, error } from 'express-easy-helper';
import { emit as socket } from '../sockets/hello';

export function list(req, res) {

    socket.emit('hello world');
  return result(res, 'Emited!');

}

Development

Start

npm start

• http://localhost:8000

Build

npm run build

• Generate output folder: dist

Test

npm test

Lint

npm lint

Pm2 [Development]

Simple

Run pm2 in a single thread and run the monitor

npm run dev-simple

• http://localhost:8000

Cluster

Run pm2 in multiple threads and run the monitor

npm run dev-cluster

• http://localhost:8000

Pm2 [Production]

Simple

Run pm2 in a single thread

npm run simple

• http://localhost:8000

Cluster

Run pm2 in multiple threads

npm run cluster

• http://localhost:8000

Stop

PM2

destroy pm2 simple and pm2 cluster

npm stop

Node

destroyed all process for node

killall node

License

MIT © Leonardo Rico