joi-extract-type

Provides native type extraction from Joi Schemas for Typescript.

---

Joi Schemas are great. But if you use Typescrypt to define your entities, it is easy to dupplicate the definition inside the Schemas and all application interfaces.

This library enhances Joi interfaces to provides an utility to infer the type from a Schema.

Why should you use it

• Avoid dupplication from Joi Schemas and application interfaces
• Port javascript applications using Joi to typescript easly
• Does not requires changes to already defined Schemas

Limitation

• Joi is probably a superset of typescript in terms of validation, branching, conditional types, etc. This library is probably suitable for most simples cases, but wont ever prevent every validation error to occour with just static analisys.
• This is experimental and a work in progress. Although I use it in some projects and works for 99% of my schemas.

Installation

npm i --save joi-extract-type

Built for typescript@^3

For typescript 2.9 support checkout branch /typescript@2 or install with:

npm i --save joi-extract-type@ts2-1

Usage

Import the library and patch Joi's typings:

1import * as Joi from 'joi';
2import './index';

Create the schemas and use Joi.extractType to infer the type:

1const is_enabled = Joi.boolean();
2type extractBoolean = Joi.extractType<typeof is_enabled>;
3export const extractedBoolean: extractBoolean = true;

Examples

The following code is copied from this library spec, which compiles the code with tsc that should not output any errors.

1const is_enabled = Joi.boolean();
2type extractBoolean = Joi.extractType<typeof is_enabled>;
3export const extractedBoolean: extractBoolean = true;
4
5const full_name = Joi.string();
6type extractString = Joi.extractType<typeof full_name>;
7export const extractedString: extractString = 'string';
8
9const user = Joi.object({ full_name, is_enabled });
10type extractObject = Joi.extractType<typeof user>;
11export const extractedObject: extractObject = { full_name: extractedString, is_enabled: extractedBoolean };
12
13const roles = Joi.array().items(Joi.string());
14type extractArray = Joi.extractType<typeof roles>;
15export const extactedArray: extractArray = ['admin'];
16
17const apply = Joi.array().items(Joi.object({ id: Joi.string() }));
18type extractApply = Joi.extractType<typeof apply>;
19export const extractedApply: extractApply = [{ id: '3' }, { id: '4' }];
20
21const rule = Joi.object({ apply });
22type extractRule = Joi.extractType<typeof rule>;
23export const extractedRule: extractRule = { apply: extractedApply };
24
25export const jobOperatorRoleSchema = Joi.object({
26    id: Joi.string().required(),
27    user_id: Joi.string().required(),
28    job_id: Joi.string().required(),
29    role: Joi.string().valid([ 'recruiter', 'requester' ]),
30    pipeline_rules: Joi.array().items(rule),
31});
32type extractComplexType = Joi.extractType<typeof jobOperatorRoleSchema>;
33export const extractedComplexType: extractComplexType = {
34    id: '2015',
35    user_id: '102',
36    job_id: '52',
37    role: 'admin',
38    pipeline_rules: [extractedRule]
39};
40
41// typeof extractedComplexType
42// const extractedComplexType: Joi.extractMap<{
43//     id: Joi.StringSchema;
44//     user_id: Joi.StringSchema;
45//     job_id: Joi.StringSchema;
46//     role: Joi.StringSchema;
47//     pipeline_rules: Joi.ArraySchema<Joi.extractMap<{
48//         apply: Joi.ArraySchema<Joi.extractMap<{
49//             id: Joi.StringSchema;
50//         }>>;
51//     }>>;
52// }>