Giter VIP home page Giter VIP logo

mongoose-common-plugin's Introduction

mongoose-common-plugin

build status code style styled with prettier made with lass license

Common plugin for Mongoose with standard schema fields and localization support

Table of Contents

Install

npm:

npm install mongoose-common-plugin

Usage

const mongooseCommonPlugin = require('mongoose-common-plugin');
const mongoose = require('mongoose');

const User = new mongoose.Schema({});

User.plugin(mongooseCommonPlugin, { object: 'user' });

module.exports = mongoose.model('User', User);

Options

Default options shown below:

{
  // *REQUIRED*
  // this should be the name of the model lower-cased (e.g. User)
  // inspired by Stripe's API design (e.g. `"object": "charge"`)
  object: '',

  // whether or not your fields/database design is camelCased
  camelCase: false,

  // whether or not to add virtual getter/setter localization support
  // (super useful for adding Mongoose validation errors that are localized)
  locale: true,

  // default locale used (e.g. you could use `i18n.defaultLocale()` if using @ladjs/i18n)
  defaultLocale: 'en',

  // whether or not to use `mongoose-omit-common-fields`
  omitCommonFields: true,

  // either an Array or Object
  // these will get added to `mongoose-hidden`
  // and are extra fields you'd like to ignore from toJSON calls
  // (e.g. `omitExtraFields: [ 'some_field_to_ignore' ]`)
  // note that we automatically add the `-` prefix to keys for Arrays passed
  omitExtraFields: [],

  // options to pass to `mongoose-unique-validator`
  uniqueValidator: {
    message: require('@ladjs/mongoose-error-messages').general.unique
  },

  // options to pass to `mongoose-validation-error-transform`
  // <https://github.com/niftylettuce/mongoose-validation-error-transform>
  validationErrorTransform: {},

  // options to pass to `mongoose-hidden`
  // <https://github.com/mblarsen/mongoose-hidden>
  mongooseHidden: {}
}

Localized Error Messages

By default the options.locale value is true. Therefore you can add localized error messages using i18n.

User model definition:

const i18n = require('i18n');
const mongoose = require('mongoose');
const validator = require('validator');

const User = new mongoose.Schema({
  email: {
    type: String,
    required: true,
    index: true,
    validate: (val, fn) => {
      if (validator.isEmail(val))
        return fn();
      fn(false, i18n.__({
        phrase: 'Invalid email address',
        locale: this.locale
      });
    }
  }
});

Route middleware (assumes you're using something like @ladjs/i18n):

try {
  user.locale = ctx.request.locale;
  await user.validate();
} catch (err) {
  // will throw localized validation error message for `user.email`
  return ctx.throw(Boom.badRequest(err));
}

Contributors

Name Website
Nick Baugh http://niftylettuce.com/

License

MIT © Nick Baugh

mongoose-common-plugin's People

Contributors

niftylettuce avatar shadowgate15 avatar titanism avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

mongoose-common-plugin's Issues

Action required: Greenkeeper could not be activated 🚨

🚨 You need to enable Continuous Integration on all branches of this repository. 🚨

To enable Greenkeeper, you need to make sure that a commit status is reported on all branches. This is required by Greenkeeper because we are using your CI build statuses to figure out when to notify you about breaking changes.

Since we did not receive a CI status on the greenkeeper/initial branch, we assume that you still need to configure it.

If you have already set up a CI for this repository, you might need to check your configuration. Make sure it will run on all new branches. If you don’t want it to run on every branch, you can whitelist branches starting with greenkeeper/.

We recommend using Travis CI, but Greenkeeper will work with every other CI service as well.

Once you have installed CI on this repository, you’ll need to re-trigger Greenkeeper’s initial Pull Request. To do this, please delete the greenkeeper/initial branch in this repository, and then remove and re-add this repository to the Greenkeeper integration’s white list on Github. You'll find this list on your repo or organization’s settings page, under Installed GitHub Apps.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.