@apployees/json-schema-to-typescript NPM

Fork of bcherny/json-schema-to-typescript targeting browser only. Removed all cli, node, and file-system dependencies.

json-schema-to-typescript

Compile json schema to typescript typings

Example

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"
    }
  },
  "additionalProperties": false,
  "required": ["firstName", "lastName"]
}

Output:

export interface ExampleSchema {
  firstName: string;
  lastName: string;
  /**
   * Age in years
   */
  age?: number;
  hairColor?: "black" | "brown" | "blue";
}

Installation

# Using Yarn:
yarn add json-schema-to-typescript

# Or, using NPM:
npm install json-schema-to-typescript --save

Usage

import { compile } from 'json-schema-to-typescript'

// compile a JS object
let mySchema = {
  properties: [...]
}
compile(mySchema, 'MySchema')
  .then(ts => ...)

See server demo and browser demo for full examples.

Options

compileFromFile and compile accept options as their last argument (all keys are optional):

key	type	default	description
bannerComment	string	`"/* tslint:disable /\n/\n This file was automatically generated by json-schema-to-typescript.\n* DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,\n* and run json-schema-to-typescript to regenerate this file.\n*/"`	Disclaimer comment prepended to the top of each generated file
declareExternallyReferenced	boolean	`true`	Declare external schemas referenced via `$ref`?
enableConstEnums	boolean	`true`	Prepend enums with `const`?
ignoreMinAndMaxItems	boolean	`false`	Ignore maxItems and minItems for `array` types, preventing tuples being generated.
unknownAny	boolean	`true`	Use `unknown` instead of `any` where possible
unreachableDefinitions	boolean	`false`	Generates code for `definitions` that aren't referenced by the schema.
strictIndexSignatures	boolean	`false`	Append all index signatures with `\\| undefined` so that they are strictly typed.
$refOptions	object	`{}`	$RefParser Options, used when resolving `$ref`s

Tests

npm test

Features

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
allOf ("intersection")
anyOf ("union")
oneOf (treated like anyOf)
maxItems (eg)
minItems (eg)
additionalProperties of type
patternProperties (partial support)
extends
required properties on objects (eg)
validateRequired (eg)
literal objects in enum (eg)
referencing schema by id (eg)
custom typescript types via tsType

Custom schema properties:

tsType: Overrides the type that's generated from the schema. Useful for forcing a type to any or when using non-standard JSON schema extensions (eg).
tsEnumNames: Overrides the names used for the elements in an enum. Can also be used to create string enums (eg).