simple-tjscli

simple-tjscli is interactive cli tool for JSONSchema generation from TypeScript interface. simple-tjscli using two generator that YousefED/typescript-json-schema and vega/ts-json-schema-generator. You can select one tool after generate JSONSchema from TypeScript interface.

Only One Time 🙆

TypeScript interface convert to JSON schema.

export interface Song {
  /**
   * song name
   * @minLength 2
   * @maxLength 256
   * */
  name: string;

  /**
   * song length represent using second unit
   * @type integer
   * @maximum 1200
   * */
  seconds: string;
}

JSON schema generate from interface below,

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": { "type": "string", "description": "song name", "minLength": 2, "maxLength": 256 },
    "seconds": { "type": "string", "description": "song length represent using second unit", "maximum": 1200 }
  },
  "required": ["name", "seconds"]
}

Also You can create TypeScript variable like that(apply TypeScript template),

import { JSONSchema7 } from 'json-schema';

const Song = {
  $schema: 'http://json-schema.org/draft-07/schema#',
  type: 'object',
  properties: {
    name: { type: 'string', description: 'song name', minLength: 2, maxLength: 256 },
    seconds: { type: 'string', description: 'song length represent using second unit', maximum: 1200 },
  },
  required: ['name', 'seconds'],
};

export default Song;

Yes, simple-tjscli on counter part of json-schema-to-ts.

fastify.js

If you use fastify.js, simple-tjscli is a good parter to management of schemas. simple-tjscli generate definitions for addSchema function. So you define TypeScript interface after generate validation and @fastify/swagger. Yes, simple-tjscli is a one of option like fluent-json-schema, typebox, json-schema-to-ts

graph LR
    A[TypeScript <br />interface] -->|simple-tjscli| B[JSON schema]
    B -->|route| C[fastify.js]
    C -->|ajv| D[validateion <br />Request/Response <br />DTO]
    C -->|"@"fastify/swagger| E[Swagger.io <br />Documentation]

Only One conversion

Install

npm install simple-tjscli --save-dev

Usage

See below example.

# interfactive mode
$ npx tjscli tsj -i

# Pass file and type
$ npx tjscli tsj -f hello.ts -t IPrompt

# Watch mode
$ npx tjscli tsj-w --watch [watching directory]

Most case, interactive mode or watch mode satisfy your need. tjscli ask to you that interface file to convert JSONSchema.

Example Project

maeum is example project. maeum using simple-tjscli and fast-maker.

# Clone the boilerplate:
git clone --depth=1 \
  https://github.com/imjuni/maeum \
  your-project-name

cd your-project-name
npm install

# run simple-tjscli watch mode
npm run tjs-w

Options

name	shortcut	type	generator	desc.
--cwd	-w	string	tsj, tjs	working directory
--config	-c	string	tsj, tjs	configuration file path. example
--project	-p	string	tsj, tjs	tsconfig.json file path
--files	-f	string[]	tsj, tjs	target file
--types	-t	string[]	tsj, tjs	target type
--sync	-s	boolean	tsj, tjs	sync mode, schema have same directory structure in input file
--interactive	-i	boolean	tsj, tjs	interactive mode, ask input file and type
--noBanner	-b	boolean	tsj, tjs	no banner in generated schema
--output	-o	string	tsj, tjs	output directory
--outputType	-u	enum('json', 'ts')	tsj, tjs	output schema type
--extName	-e	string	tsj, tjs	output file extension
--prefix	-x	string	tsj, tjs	output file name prefix, ex> JSC -> JSC_IMajor.ts
--overwrite		string	tsj, tjs	If already exists schema file, overwrite schema
--template		string	tsj, tjs	template string for output typescript file
--templatePath		string	tsj, tjs	template file path for output typescript file
--verbose	-v	boolean	tsj, tjs	verbose message
--watch		string	tsj	only work in watch mode. watch directory
--debounceTime		number	tsj	only work in watch mode. watch file debounceTime. default 1000ms
--seperateDefinitions		boolean	tsj	create definitions.ts file using definitions value in generated json-schema
--skipTypeCheck		boolean	tsj	ts-json-schema-generator option
--topRef		boolean	tsj	ts-json-schema-generator option
--expose		enum('all', 'none', 'export')	tsj	ts-json-schema-generator option
--jsDoc		enum('none', 'extended', 'basic')	tsj	ts-json-schema-generator option
--extraTags		string[]	tsj	ts-json-schema-generator option
--additionalProperties		boolean	tsj	ts-json-schema-generator option

Programming Interface

function	desc.
generateJSONSchemaUsingTSJ	generate json-schema using vega/ts-json-schema-generator
generateJSONSchemaUsingTJS	generate json-schema using YousefED/typescript-json-schema
watchJSONSchemaUsingTSJ	watch for generate json-schema using vega/ts-json-schema-generator