Build a Yup schema from a JSON Schema, GraphQL schema (type definition) or any other similar type/class and field/properties model or schema :)
See Advanced config for all the more advanced configuration options available to customize this builder to support any of your requirements.
The builder currently supports the most commonly used JSON Schema layout
To support other schemas see Advanced config
You can use the YupBuilderConfig and TypeHandlerConfig type interfaces to facilitate building up the config object to pass to the YupBuilder.
Install
npm install schema-to-yup -S or yarn add schema-to-yup
Create a JSON schema to validate against
const schema = {
$schema: "http://json-schema.org/draft-07/schema#",
$id: "http://example.com/person.schema.json",
title: "Person",
description: "A person",
type: "object",
properties: {
name: {
description: "Name of the person",
type: "string",
},
email: {
type: "string",
format: "email",
},
foobar: {
type: "string",
matches: "(foo|bar)",
},
age: {
description: "Age of person",
type: "number",
exclusiveMinimum: 0,
required: true,
},
characterType: {
enum: ["good", "bad"],
enum_titles: ["Good", "Bad"],
type: "string",
title: "Type of people",
propertyOrder: 3,
},
},
required: ["name", "email"],
};Create a config object to configure details of your validation
const config = {
// for error messages...
errMessages: {
age: {
required: "A person must have an age",
},
email: {
required: "You must enter an email address",
format: "Not a valid email address",
},
},
};Create the yup schema using the builder method buildYup
const { buildYup } = require("schema-to-yup");
const yupSchema = buildYup(schema, config);Use the yup schema methods such as isValid to validate
// console.dir(schema)
const valid = await yupSchema.isValid({
name: "jimmy",
age: 24,
});
console.log({
valid,
});
// => {valid: true}The above example would generate the following sort of Yup validation schema:
const schema = yup.object().shape({
name: yup.string().required(),
age: yup.number().required().positive(),
// ...
});Please note that this library does not currently resolve $ref (JSON Pointers) out of the box. You can use another library for that.
You could f.ex use json-schema-ref-parser to preprocess your schema. Also see:
By default, any property will be explicitly notRequired unless set to be required, either via required: true in the property constraint object or via the required list of properties of the object schema definition (of the property).
You can override the notRequired behavior by setting it on the new mode object of the configuration which can be used to control and fine-tune runtime behaviour.
const jsonSchema = {
title: "users",
type: "object",
properties: {
username: { type: "string" },
},
};const yupSchema = buildYup(jsonSchema, {
mode: {
notRequired: true, // default setting
},
});
// will be valid since username is not required by default
const valid = yupSchema.validateSync({
foo: "dfds",
});const yupSchema = buildYup(jsonSchema, {
mode: {
notRequired: true, // default setting
},
});
// will be invalid since username is required by default when notRequired mode is disabled
const valid = yupSchema.validateSync({
foo: "dfds",
});The new run time mode settings are demonstrated under sample-runs/mode
No validation error (prop not required unless explicitly specified):
$ npx babel-node sample-runs/modes/not-required-on.js
Validation error if not valid type:
$ npx babel-node sample-runs/modes/not-required-on.js
You can access the internal Yup shape, via shapeConfig on the yup schema returned by the buildYup schema builder function. Alternatively simply call propsToShape() on the yup builder.
This allows you to easily mix and match to suit more advanced requirements.
const { buildYup } = require("json-schema-to-yup");
const { shapeConfig } = buildYup(json, config);
// alternatively
// const shape = buildYup(json, config).propsToShape()
const schema = yup.object().shape({
...shapeConfig,
...customShapeConfig,
});Currently the following schema types are supported:
arraybooleandatenumberobjectstring
strictdefaultnullableconstrequirednotRequiredoneOf(enum,anyOf)notOneOfrefValueForfor confirm password scenariotypeErrorcustom type error message (in config)whenisTypenullable(isNullable)
Reference constraints within the schema can be defined as follows:
schema = {
required: ["startDate", "endDate"],
type: "object",
properties: {
startDate: {
type: "number",
},
endDate: {
type: "number",
min: "startDate",
},
},
};Internally this will be resolved using Yup.ref as documented here in the Yup readme.
ref allows you to reference the value of a sibling (or sibling descendant) field to validate the current field.
Yup.ref is supported in the Yup docs for the following:
- string: .length, .min, .max
- number: .min, .max, .lessThan, .moreThan
- date: .min, .max
- array: .length, .min, .max
ensurecompactitems(of)maxItems(max)minItems(min)itemsOf(of)
No keys
maxDate(max)minDate(min)
integermoreThan(exclusiveMinimum)lessThan(exclusiveMaximum)positivenegativemin(minimum)max(maximum)truncateround
camelCaseconstantCasenoUnknown(propertyNames)
minLength(min)maxLength(max)pattern(matchesorregex)email(format: 'email')url(format: 'url')lowercaseuppercasetrim
For pattern (RegExp) you can additionally provide a flags property, such as flags: 'i'. This will be converted to a RegExp using new RegExp(pattern, flags)
For the pattern constraint you can also pass in excludeEmptyString to exclude empty string from being evaluated as a pattern constraints.
- JSON schema to Elastic Search mapping
- JSON Schema to GraphQL types with decorators/directives
- JSON Schema to Mongoose schema
- JSON Schema to MobX State Tree types
- Convert JSON schema to mongoose 5 schema
The library JSON Schema model builder is a powerful toolset to build a framework to create any kind of output model from a JSON schema.
If you enjoy this declarative/generator approach, try it out!
See Advanced config
Uses jest for unit testing.
- Have unit tests that cover most of the constraints supported.
- Could use some refactoring using the latest infrastructure (see
NumericConstraint) - Please help add more test coverage and help refactor to make this lib even more awesome :)
A new version is under development at schema-to-yup-mono which is this code ported to a lerna monorepo with a cleaner, mode modular structure. More work needs to be done in terms of TDD and unit testing. Ideally this repo should be ported to Nx
Please feel free to come with ideas and suggestions on how to further improve this library.
2018 Kristian Mandrup (CTO@Tecla5)
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent