Compile json schema to typescript typings
[In Beta]: Bug reports appreciated!
Input:
{
"title": "Example Schema",
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"age": {
"description": "Age in years",
"type": "integer",
"minimum": 0
},
"hairColor": {
"enum": ["black", "brown", "blue"],
"type": "string"
}
},
"required": ["firstName", "lastName"]
}Output:
export interface ExampleSchema {
firstName: string;
lastName: string;
/**
* Age in years
*/
age?: number;
hairColor?: "black" | "brown" | "blue";
}npm install json-schema-to-typescript
import {compileFromFile} from 'json-schema-to-typescript'
fs.writeFileSync('dist/foo.d.ts', await compileFromFile('src/foo.json'))See /example for a fully working demo.
npm test
-
title=>interface - Primitive types:
- array
- homogeneous array
- boolean
- integer
- number
- null
- object
- string
- homogeneous enum
- heterogeneous enum
- Non/extensible interfaces
- Custom JSON-schema extensions
- Nested properties
- Schema definitions
- Schema references
- Local (filesystem) schema references
- External (network) schema references
- Add support for running in browser
- default interface name
- infer unnamed interface name from filename
-
anyOf("union") -
allOf("intersection") -
additionalPropertiesof type -
extends -
requiredproperties on objects (eg) -
validateRequired(eg) - literal objects in enum (eg)
- referencing schema by id (eg)
- clean up + refactor code
dependencies(single, multiple)divisibleBy(eg)format(eg)multipleOf(eg)maximum(eg)minimum(eg)maxItems(eg)minItems(eg)maxProperties(eg)minProperties(eg)not/disallowoneOf("xor", useanyOfinstead)pattern(string, regex)patternProperties(eg)uniqueItems(eg)
- JSON-schema spec: http://json-schema.org/latest/json-schema-core.html
- JSON-schema wiki: https://github.com/json-schema/json-schema/wiki
- JSON-schema test suite: https://github.com/json-schema/JSON-Schema-Test-Suite/blob/node
- TypeScript spec: https://github.com/Microsoft/TypeScript/blob/master/doc/spec.md