Package Exports

mongoat

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mongoat) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Mongoat

dev dependencies

mongoat gif

Description

Mongoat is a MongoDB ODM. It is written on top of the mongodb npm package to add new features.

Documentation

Because Mongoat is written on top of the mongodb native driver, you can find more about here

Features

Hooks
Enabling datetime (createdAt & updatedAt)
Transparent usage (raw access to native MongoDB driver)
Versioning of documents
Oplogs events (not yet)

Installation

 $> npm install mongoat

Basic usage

var mongoat = require('mongoat');
var url = 'mongodb://localhost:27017/myproject'; // Connection URL

mongoat.MongoClient.connect(url)
.then(function (db) {
    // then use it the same way as native mongodb driver ex:
    db.collection('Person').insert({ name: 'myName' })
    .then(function (ObjectReturnedByMongodb) {
    })
    .catch(function (err) {
    });

    // you can also use callback instead of promise ex:
    db.collection('Person').insert({ name: 'myName' }, 
    function (err, ObjectReturnedByMongodb) {
    });
});

Hooks

You can add multiple before and after hooks for insertions, updates and removals:

before hooks:

db.collection('collectionName').before('insert', function (docToInsert) {
  // triggered when calling to insert()
});

db.collection('collectionName').before('update', function (docToUpdate) {
  // triggered when calling to update() or findAndModify()
});

db.collection('collectionName').before('remove', function (docToRemove) {
  // triggered when calling to remove()
});

after hooks:

db.collection('collectionName').after('insert', function (docToInsert) {
  // triggered when calling to insert()
});

db.collection('collectionName').after('update', function (docToUpdate) {
  // triggered when calling to update() or findAndModify()
});

db.collection('collectionName').after('remove', function (docToRemove) {
  // triggered when calling to remove()
});

Datetime

Enable datetime feature:

    db.collection('collectionName').datetime(true); // Default is false

createdAt:

it will add a createdAt field to all new inserted documents using:

db.collection('collectionName').insert(document, options);

or using one of the following method within the option upsert: ture

db.collection('collectionName').update(query, update, options);
db.collection('collectionName').findAndModify(query, sort, update, options);

updatedAt:

it will add a updatedAt field to all updated documents using:

db.collection('collectionName').update(query, update, options);
// or
db.collection('collectionName').findAndModify(query, sort, update, options);

Versioning

Enable versioning feature:

    db.collection('collectionName').version(true); // Default is false

Enabling this feature for a collection, so each time you perform an insert/update/remove it will create a document in the collection collectionName.vermongo and increment the version of the updated document. The _id in this collection is a composite ID, { _id: _id, _version: _version }. The document in the MyCollection collection will also receive a _version field.

If we want to restore a version

    db.collection('collectionName').restore(version); // Default is false

if version is greater than 0, it will be considered as the version to restore
if version is equal or lower than 0, it will be considered as the starting point of the version to restore (starting form last) ex:

    db.collection('collectionName').restore(0); // restore the last version

    db.collection('collectionName').restore(-2); // restore the last version -2

more about versioning feature here

Tests

Run a MongoDb server if not yet
Run tests npm test

Or to show up code coverage npm run cover it will generate ./coverage folder

Contribution

Please read our Contributing Guidlines before submitting a pull request or an issue !

License

The MIT License MIT