mongoose-plugin-created

A mongoose.js plugin to create a document creation timestamp with optional user identifier.

Installation

npm i --save mongoose-plugin-created

API Reference

Example

var createdPlugin = require('mongoose-plugin-created');
var schema = Schema({...});
schema.plugin(createdPlugin[, OPTIONS]);

mongoose-plugin-created~options

Kind: inner property of mongoose-plugin-created

| Param | Type | Default | Description | | --- | --- | --- | --- | | [options] | object | | | | [options.date] | object | | options for configuring the path for storing the date. | | options.date.useVirtual | boolean | true | use a virtual path to infer the document creation date from the ObjectId _id. Will revert to a real path if options.date.options are specified. | | options.date.path | string | "created.date" | the path for storing the creation date if not a virtual. | | options.date.options | object | | property options to set (type will always be Date). (e.g. {select: false}) | | [options.by] | object | | options for configuring the path for storing the creator. | | options.by.path | string | "created.by" | the path for storing the document creator. | | options.by.ref | string | | the reference model to use (e.g. {by: {ref: 'ModelRefName'}}) | | options.by.options | object | | property options to set (if not a reference the type will always be String). (e.g. {select: false}) | | [options.expires] | object | | options for configuring the path to store the expiration time for the document based on the date path. | | options.expires.path | string | "created.expires" | the path for storing the document expiration timestamp. This is an approimation due to MongoDB's method for expiring documents | | options.expires.options | object | | property options to set ()type will always be Date). (e.g. {select: false}) |

Examples

With Defaults

var createdPlugin = require('mongoose-plugin-created');
var schema = Schema({foo: String});
schema.plugin(createdPlugin);

var Foo = mongoose.model('Foo', schema);
var foo = Foo(); // foo.created --> {date: 'Wed May 05 2015 12:05:50 GMT-0400 (EDT)'}

With Options

var createdPlugin = require('mongoose-plugin-created');
var schema = Schema({foo: String});
schema.plugin(createdPlugin, {by: {ref: 'UserModel'}});

var Foo = mongoose.model('Foo', schema);
var foo = Foo(); // foo.created --> {date: 'Wed May 05 2015 12:05:50 GMT-0400 (EDT)'}
foo.created.by = userA; // foo.created --> {date: 'Wed May 05 2015 12:05:50 GMT-0400 (EDT)', by: '507f191e810c19729de860ea'}

License

Apache 2.0