Skip to content

atek-cloud/json-schema-to-dts

 
 

Repository files navigation

json-schema-to-dts

Convert JSON Schema definitions into accurate (as possible) TypeScript definitions, specifying how the main schema types and lifted sub-schemas should be declared / exported.

Example

Given the schema

{
  "type": "object",
  "properties": {
    "name": { "type": "string", "description": "The name of an object" },
    "not_annotated": { "type": "null" },
    "command": {
      "oneOf": [
        { "const": "a constant!" },
        { "enum": ["multiple", { "options": "are allowed" }] }
      ]
    }
  }
}

And these options:

const options = {
  topLevel: {
    isExported: true,
  },
};

We get the following result:

type JSONPrimitive = boolean | null | number | string;
type JSONValue =
  | JSONPrimitive
  | JSONValue[]
  | {
    [key: string]: JSONValue;
  };
export type Test = {
  /** The name of an object */
  name?: string;
  not_annotated?: null;
  command?:
    | "a constant!"
    | (
      | "multiple"
      | {
        options: "are allowed";
      }
    );
};

API

new Parser()

Produce a new Parser instance.

.addSchema(uri, schema)

Add a schema to the parser where:

  • uri - is a string representing the schema's uri (ie: file:///path/to/schema.json)
  • schema - is the json object representation of the schema

.compile(options)

Compile all added schemas where:

  • topLevel - options for root schemas
    • hasDeclareKeyword - (optional) mark the type declaration as declare
    • isExported - (optional) export the type declaration
  • lifted - options for sub-schemas that have been lifted during compilation
    • hasDeclareKeyword - (optional) mark the type declaration as declare
    • isExported - (optional) export the type declaration
  • sourceFile - (optional) existing source file to add the types to

Returns an object { diagnostics, text } where:

  • diagnostics - is an array of diagnostics
  • text - is the resulting typescript definitions

About

A robust JSON schema to TypeScript compiler

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 86.0%
  • JavaScript 14.0%