SugoiJS MongoDB module - ORM module based
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
.idea
__tests__
classes
constants
coverage
docs
exceptions
interfaces
.travis.yml
LICENSE
README.md
_config.yml
index.d.ts
index.js
jest.config.js
jest.config.json
package-lock.json
package.json

README.md

@Sugoi\mongoDB

Sugoi logo

npm version Build Status codecov

Introduction

SugoiJS is a minimal modular framework.

SugoiJS gives you the ability to use only what you need and do it fast.

this is a standalone module that can be functional on its own (as all of the SugoiJS modules).

Sugoi mongoDB package provides ORM solutions for mongoDB.

This package relays on Sugoi\ORM infrastructure using the ConnectableModel abstract class.

Installation

npm install --save @sugoi/mongoDB

tsconfig.json:

Under your tsconfig - compilerOptions set:

  • "target": "es2015"

  • "emitDecoratorMetadata": true

  • "experimentalDecorators": true

  • "lib": ["es2015","dom"]

Template

You are able to use the config template which was set for the @sugoi/demo application:

{
  "compilerOptions": {
    "baseUrl": "./src",
    "allowJs": true,
    "target": "es2015",
    "module": "commonjs",
    "moduleResolution": "node",
    "sourceMap": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "lib": [
      "es2015",
      "dom"
    ],
    "typeRoots": [
      "./node_modules/@types"
    ],
    "types": [
      "body-parser",
      "express",
      "node"
    ]
  }
}

Bootstrapping

Bootstrapping done by only one line:

MongoModel.setConnection(configuration:IConnectionConfig,connectionName:string = "default")

The connectionName is used for multiple connection

Example:

import {MongoModel} from "@sugoi/mongodb";

MongoModel.setConnection({
                        port: 27017,
                        protocol: "mongodb://",
                        hostName: "my-mongo.services.com",
                        db: "myAuthDB", //authorization DB
                        user: "dbUser",
                        password: "dbPassword"
                      }, "adminDB");

Create Model

to create a model, all you need is to extend the MongoModel class and set your properties.

Just like that:

export class Message extends MongoModel {
    public userId:string;
    public body:string;

    constructor(userId:string,body:string){
        super();
        this.userId = userId;
        this.body = body;
    }
}

By default the collection name is the class name (case sensitive).

For override the collection name, use the @ModelName decorator:

@ModelName("AppMessage")
export class Message extends MongoModel {
        public userId:string;
        public body:string;

    constructor(userId:string,body:string){
        super();
        this.userId = userId;
        this.body = body;
    }
}
Using connections

For using different connection for model you able to either use all you need to use setConnectionName static method or ConnectionName decorator.

@ModelName("AppMessage")
@ConnectionName("appDB")
export class Message extends MongoModel {
            public userId:string;
            public body:string;

    constructor(userId:string,body:string){
        super();
        this.userId = userId;
        this.body = body;
        this.constructor.setConnectionName("adminDB");
    }
}

Model methods

Some of the model main methods:

Query

static find<T=any>(query?: any): Promise<Array>;

static findOne<T=any>(query?: any): Promise;

Upsert

save<T=any>(options: CollectionInsertOneOptions): Promise;

update<T=any>(options?: ReplaceOneOptions): Promise;

Remove

remove<T=any>(): Promise;

Find information about the model interface on @sugoi\orm documentation

Model lifecycle

@sugoi\mongodb module re-export orm lifecycle interfaces.

Find information about the model lifecycle on @sugoi\orm documentation

Documentation

You can find further information on Sugoi official website