Tiny wrapper around Joi to provide easy validation + errors.

Why?

• Simple terse format - No need to wrap outer objects in Joi.object(), POJOs and simple structures are converted for you
• Verbose Joi imports - By using a callback you can avoid needing to import Joi as a library in your outer library, just import it for the validation construction and let it fall out of scope
• Meaningful errors - Joi, while wonderful, doesn't make extracting errors easy, this library combines validation errors together and makes them readable as one string, readable by a human
• Throw by default - Validation failures throw (configurable) by default without needing to examine the result and pick apart if an error occurred

If given a callback, joyful() will call that function with (Joi) as the only argument, avoiding the need to import Joi into your outer application

import joyful from '@momsfriendlydevco/joyful';

joyful(
    {foo: 'Foo!'},
    joi => ({foo: joi.string().required()}}),
); //= true

joyful(
    {},
    joi => ({foo: joi.string().required()}}),
); //~ will throw a meaningful error

Or if you prefer the exactness of using Joi, use it as a regular validator.

import joyful from '@momsfriendlydevco/joyful';
import Joi from 'joi';

// Full verbose syntax to validate an object
joyful(
    {foo: 'Foo!'},
    Joi.Object({foo: Joi.string().required()}),
); //= true

// Shorter - pass a POJO instead of the wrapping `Joi.object()`
joyful(
    {foo: 'Foo!'},
    {foo: Joi.string().required()},
); //= true

Default function export. This library exposes a simple function joyful(state, schema, options) which accepts:

• state - The input state to validate
• schema - A Joi.Object(), A POJO or a function which can return either. Can also be an array of any of these which are merged in order
• options - Additional options to change the functions behaviour

Options are:

Function export. Return a compiled Joi schema from the "lazy" input schema along with options.

Function export. Utility function which throws if the given state does not conform to the specified schema. This is really just a utilty function of joyful(state, schema, {throws: true})

Function export. Returns an object. Wrapped version of Joyful which will validate an options object, apply defaults and return the valid result If validation fails this function will throw This is really just a utilty function of joyful(state, schema, {populate: true, trim: true, throws: true})

Object export. joi instance.