joi

joigoose

Joi validation for your Mongoose models without the hassle of maintaining two schemas

Showing:

Popularity

Downloads/wk

1.4K

GitHub Stars

174

Maintenance

Last Commit

5mos ago

Contributors

14

Package

Dependencies

2

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

joigoose

npm version Build Status Dependencies Status

Joi and Mongoose sitting in a tree K-I-S-S-I-N-G...

Joi validation for your Mongoose models without the hassle of maintaining two schemas.

Installation

⚠️ WARNING! Use the v7.x.x branch of Joigoose if you're still using the scoped version of Joi.

npm install joigoose

Usage

1. Import Mongoose and Joi

We must pass Mongoose into Joigoose so it knows about ObjectIds and other Mongoose specific stuff:

const Mongoose = require("mongoose");
const Joigoose = require("joigoose")(Mongoose);

With Joi options which apply to all validators:

const Mongoose = require("mongoose");
const Joigoose = require("joigoose")(Mongoose, { convert: false });

With subdocument options to all subdocuments:

const Mongoose = require("mongoose");
const Joigoose = require("joigoose")(Mongoose, null, {
  _id: false,
  timestamps: false,
});

2. Write your Joi schema (see here about how to specify ObjectIds!)

Things to know!

Mongoose specific options can be specified in the meta object (see below).

Arrays with items of different types will end up with the Mongoose type Mixed. Ideally, Joi schemas shouldn't have to contain Mongoose specific types, such as Mongoose.Schema.Types.ObjectId because these Joi schemas may be required to work on frontend clients too.

var joiUserSchema = Joi.object({
  name: Joi.object({
    first: Joi.string().required(),
    last: Joi.string().required(),
  }),
  email: Joi.string().email().required(),
  bestFriend: Joi.string().meta({
    _mongoose: { type: "ObjectId", ref: "User" },
  }),
  metaInfo: Joi.any(),
  addresses: Joi.array()
    .items({
      line1: Joi.string().required(),
      line2: Joi.string(),
    })
    .meta({ _mongoose: { _id: false, timestamps: true } }),
});

3. Convert your Joi schema to a Mongoose-style schema

var mongooseUserSchema = new Mongoose.Schema(
  Joigoose.convert(joiUserSchema, options)
);

Conversion options

Options can be passed to the convert method as an object. Valid options are described below.

KeyTypeDefaultDescription
typeKeyString"type"The name of the key used for specifying the type in the generated schema.
Example:
{
  typeKey: '$type',
}

4. Create your model

User = Mongoose.model("User", mongooseUserSchema);

5. Enjoy!

var aGoodUser = new User({
  name: {
    first: "Barry",
    last: "White",
  },
  email: "barry@white.com",
  metaInfo: {
    hobbies: ["cycling", "dancing", "listening to Shpongle"],
  },
});

aGoodUser.save(function (err, result) {
  // -> Success!
});

var aBadUser = new User({
  name: {
    first: "Barry",
    last: "White",
  },
  email: "Im not an email address!",
});

aBadUser.save(function (err, result) {
  // -> Error!
  // {
  //     "message": "User validation failed",
  //     "name": "ValidationError",
  //     "errors": {
  //         "email": {
  //             "properties": {
  //                 "type": "user defined",
  //                 "message": "Validator failed for path `{PATH}` with value `{VALUE}`",
  //                 "path": "email",
  //                 "value": "Im not an email address!"
  //             },
  //             "message": "Validator failed for path `email` with value `Im not an email address!`",
  //             "name": "ValidatorError",
  //             "kind": "user defined",
  //             "path": "email",
  //             "value": "Im not an email address!"
  //         }
  //     }
  // }
});

Known Limitations

I didn't spend long writing this, but I've aimed for 100% code coverage. It can be so much better, so help me out! Submit your issues and pull requests on GitHub.

  • No peer based validation (and, nand, or, xor, with, without, ref, assert, alternatives, when etc)
  • No Joi.binary object type
  • No Joi.func object type
  • No Joi.in object type

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial