joigoose

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

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({ type: 'ObjectId', ref: 'User' }),
    metaInfo: Joi.any(),
    addresses: Joi.array().items({
        line1: Joi.string().required(),
        line2: Joi.string()
    }).meta({ _id: false, timestamps: true })
});

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

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

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
Joi.boolean default values don't seem to work properly: Automattic/mongoose#4245

jacoobwang/joigoose