@logoran/enjoi v3.2.5

enjoi

Converts a JSON schema to a Joi schema for object validation.

Schema Support

enjoi is built against json-schema v4, but does not support all of json-schema.

Here is a list of some missing keyword support still being worked on:

• object:patternProperties - Joi limitation.

API

• enjoi(schema [, options])
  • schema - a JSON schema or a string type representation (such as 'integer').
  • options - an (optional) object of additional options such as subSchemas and custom types.
    • subSchemas - an (optional) object with keys representing schema ids, and values representing schemas.
    • types - an (optional) object with keys representing type names and values representing a Joi schema.
    • refineType(type, format) - an (optional) function to call to apply to type based on the type and format of the JSON schema.
    • strictMode - make schemas strict(value) with a default value of false.
    • extensions - an (optional) object with keys representing schema ids, and values extending schemas.
    • Joi - an (optional) Joi which will be used. default hapijs/joi.

Example:

const Joi = require('joi');
const Enjoi = require('enjoi');

const schema = Enjoi({
    type: 'object',
    properties: {
        firstName: {
            description: 'First name.',
            type: 'string'
        },
        lastName: {
            description: 'Last name.',
            type: 'string'
        },
        age: {
            description: 'Age in years',
            type: 'integer',
            minimum: 1
        }
    },
    'required': ['firstName', 'lastName']
});

Joi.validate({firstName: 'John', lastName: 'Doe', age: 45}, schema, function (error, value) {
    error && console.log(error);
});

Can also call validate directly on the created schema.

schema.validate({firstName: 'John', lastName: 'Doe', age: 45}, function (error, value) {
    error && console.log(error);
});

Sub Schemas

Sub-schemas can be provided through the subSchemas option for $ref values to lookup against.

Example:

const schema = Enjoi({
    type: 'object',
    properties: {
        a: {
            $ref: '#/b' // # is root schema
        },
        b: {
            type: 'string'
        },
        c: {
            $ref: '#sub/d' // #sub is 'sub' under subSchemas.
        }
    }
}, {
    subSchemas: {
        sub: {
            d: {
                'type': 'string'
            }
        }
    }
});

Custom Types

Custom types can be provided through the types option.

const schema = Enjoi({
    type: 'thing'
}, {
    types: {
        thing: Joi.any()
    }
});

Refine Type

You can use the refine type function to help refine types based on type and format. This will allow transforming a type for lookup against the custom types.

const schema = Enjoi({
    type: 'string',
    format: 'email'
}, {
    types: {
        email: Joi.string().email()
    },
    refineType(type, format) {
        if (type === 'string' && format === 'email') {
            return 'email';
        }
    }
});

Extensions Joi

Use defined Extensions can be provided through the extensions option. Sometimes it's used along with Joi option.

const joiEnum = require('joi-enum-extensions');
const joi = Joi.extend(joiEnum);
const schema = Enjoi({
    title: 'sex',
    type: 'integer',
    'x-enum': {
        'male': 0,
        'female': 1
    },
}, {
    Joi: joi,
    extensions: {
        integer: function (schema, current) {
            if (current['x-enum']) {
                return schema.map(current['x-enum']);
            }
        }
    }
});