very-express

0.3.6 • Public • Published

VeryExpress

an generator that generate Express rest-api app based on jsonSchema and openApi

Idea

doing same things once is good,
twice is okay, third times is wasting life.

all you need is define the JsonSchema and openApi spec

Quick Start

  1. create JsonSchmea, can refer to output/jsonSchema put it as cli config file
  2. npm i -g very-express
    install package globally
  3. vex -h
    this cmd create the cli config file
  4. vex
    call cli with vex.config.json setting
  5. npm i
  6. npm build
  7. npm run start

JsonSchmea Setup

at the root of schema :

Fields Description
documentName name of collection or table, also used at Model.
interfaceName used at endpoint and naming Class, Interface, Files.
methods available method of rest api.
"x-documentConfig": {
    "documentName": "user",
    "interfaceName": "User",
    "methods": [
        "get",
        "post",
        "put",
        "patch",
        "delete"
    ]
}

at the properites :

"userContact":{
    "type": "string",
    "format": "uuid",
    "required": false,
    "x-foreignKey": "usercontact"
}

Road Map

  • [ ] dockernize
  • [x] generate express app
    • [x] gen. openapi based on json schema
    • [x] gen. controllers based on openapi
      • [x] CRUD + Search api
  • [ ] database
    • [x] mongodb
    • [ ] sql
    • [ ] db encrtption PDPA
  • [ ] oauth2
    • [ ] google
    • [ ] microsoft
    • [ ] github
  • [ ] Role Base Access Control

Enhancement To Do

  • Implement data encryption & hash (PDPA)
    • at JsonSchmea fields, add attribute x-dataSecure: "method" while accessing data, perform encryption based on method selected.

Package Sidebar

Install

npm i very-express

Weekly Downloads

201

Version

0.3.6

License

MIT

Unpacked Size

137 kB

Total Files

84

Last publish

Collaborators

  • justin16l
  • justin26l