statenext-with-mongo v2.0.0

What is this?

This package work with statenext-api for connect with mongo and help you implement controller faster.

Installation

npm i --save statenext-with-mongo

then import

import ServerBuilder from 'statenext-api'
import withMongo from './src/index'
import { Document, Schema } from "mongoose"

var customer = {

	email : { type:String, required : true},
	password : { type:String, required : true},
	name : { type:String, required : true, trim : true},
	birth : { type:Date},
	hobby : { type:String},
	price : { type:Number},
	created_at : { type:Date , default :Date.now},

}

export interface IUser extends Document {
    email: string;
    firstName: string;
    lastName: string;
  }
  
const UserSchema: Schema = new Schema({
    email: { type: String, required: true, unique: true },
    firstName: { type: String, required: true },
    lastName: { type: String, required: true },
});

let models = [
    {
        model: customer,
        name: "customer"
    },
    {
        model: UserSchema,
        name: "user",
        permission:{
            getable:["firstname","email", "customer"],
            updatable:["name"]
        }
    }
]

let server = new ServerBuilder()

server.setup({
    // services,
    ...withMongo.connect(models, {}, {autoRouting:true, dbVerbose:true})
}).server.listen(8080, () => {
    console.log("listen on 8080")
})

API

REST route

• create

  • path /<db_name>
  • method POST
  • body

• update

  • path /<db_name>/:objectId
  • method PUT
  • body

• deleteOne

  • path /<db_name>/:objectId
  • method DELETE

• deleteMany

  • path /<db_name>
  • method DELETE
  • query

• getOne

  • path /<db_name>/:objectId
  • method GET
  • query
    • _populate

• getMany

  • path /<db_name>
  • method GET
  • query
    • _populate

• getPagination

  • path /<db_name>/pages/:page
  • method GET
  • params
    • page: INT start with 0
  • query
    • _populate
    • _size

Query (kaptuer default query)

• between

  • search number between 2 number
  • usage /?<target_field>=$bt=<min_number>,<max_number>
  • example1 find age between 15 and 22 /?age=$bt=15,22
  • example2 find age more than 15 /?age=$bt=15,
  • example3 find age less than 22 /?age=$bt=,22

• date between

  • search date between 2 date
  • usage /?<target_field>=$date=<start_date>,<end_date>
  • start_date and end_date can be everything that can use with -> new Date(<start_date>)

• date equal

  • search date that equal to query
  • usage /?<target_field>=$datee=<start_date>
  • start_date and end_date can be everything that can use with -> new Date(<start_date>)

• date between milisec

  • search date like date between but in milisec
  • usage /?<target_field>=$date=<start_date>,<end_date>
  • start_date and end_date is unix timestamp as milisec

• in

  • search by multiple value
  • usage /?<target_field>=$in=<values seperate with ,>
  • example find rein, ayaka /name=$in=rein,ayaka

• regular

  • search by regular
  • usage /?<target_field>=
  • example find name with /ab+c/ /?name=$reg=ab+c
  • reg can be anything with new RegExp(reg)