dc-api-mongo

Mongoose based MongoDB driver for dc-api-core

Provides mongo database driver and session store.

Dependencies

• dc-api-core
• Mongoose

---

Installation

1. Install package - npm i dc-api-mongo --save or yarn add dc-api-mongo
2. Add dc-api-mongo to plugins array in config.json
3. Fill db field in config.json by template
4. Create directory models in back-end root
5. Create directory mongo in models
6. Done!

---

config.json template

Field	Default	Description
db.mongo.uri	Autogenerated	MongoDB URI
db.mongo.host	Required	Database hostname
db.mongo.name	Required	Database name
db.mongo.port	27017	Database port
db.mongo.user	Optional	Database username
db.mongo.pass		and password
db.mongo.nonStrict	[]	List of models without schema
db.mongo.srv	false	If true using SRV record
db.mongo.*	Optional	Query parameters in URI

Example configuration

{
    "db": {
        "mongo.billing": {
            "uri": " mongodb+srv://admin:[e-mail]/billing?authSource=admin&retryWrites=true&w=majority"
        },
        "mongo.control-panel"
            "host": "project-00000.provider.mongodb.net",
            "user": "admin",
            "pass": "password",
            "name": "control-panel",
            "srv": true,
            "authSource": "admin",
            "retryWrites": true,
            "w": "majority"
        }
    }
}

Creating model

1. Create file ModelName.js in models/mongo directory
2. Fill model file.
3. Done!

Example:

module.exports = {
    // Any mongoose schema constuctions allowed
    field: { type: String, required: true },
    otherField: { type: Number, default: Date.now() + 1000 * 60 },

    // Second argument of schema constuctor
    // new Schema(..., $options)
    $options: { strict: false },

    // Register default auto-increment field "uid"
    $increment: 'uid',
    // Same with options
    $increment: { field: 'uid', start: 1 },

    // Mongoose virtual fields
    $virtuals: {
        timestamp: {
            // schema.virtual('timestamp').get(<this function>)
            get () {
                // `document.timestamp` will return creation time in ms
                return this._id.getTimestamp().getTime();
            }
        }
    }
};

Other examples you can find in Mongoose Docs.