Options
All
  • Public
  • Public/Protected
  • All
Menu

jtdc

JTDc

JSON Type Definition (RFC8927) to TypeScript compiler.

  • Compile enums, interface and types;
  • Modify naming of enums, enum keys and values, interfaces, types, properties and any other rendered entities;
  • Compile validator functions that produce an array of detected validation errors;
  • Validators support recursive structures and shallow checks;
  • Compile type narrowing functions aka type guards;
  • Create custom validator dialect and have explicit control over every aspect of code generation;
  • CLI and programmatic usage;

Full API documentation.

npm install --save-dev @jtdc/cli

By default, validators and type guards use a @jtdc/jtd-dialect runtime dependency. You can alter compiler dialect by providing dialectFactory option to the compiler.

npm install --save-prod @jtdc/jtd-dialect

CLI usage

Let's assume you have user and account type definitions in separate files under ./src folder:

./src/user.json

{
  "user": {
    "properties": {
      "email": {"type": "string"},
      "friends": {
        "elements": {"ref": "user"}
      }
    },
    "optionalProperties": {
      "name": {"type": "string"},
      "age": {"type": "int8"}
    }
  }
}

./src/account.json

{
  "account": {
    "properties": {
      "user": {"ref": "user"},
      "stats": {
        "properties": {
          "visitCount": {"type": "int32"}
        }
      }
    },
    "optionalProperties": {
      "roles": {
        "metadata": {
          "comment": "The default role is guest"
        },
        "elements": {"ref": "role"}
      }
    }
  },
  "role": {
    "enum": ["admin", "guest"]
  }
}

To compile these definitions to TypeScript use this command:

npx jtdc --package @jtdc/cli --rootDir ./src --includes '*.json' --outDir ./src/gen --typeGuards

The result would be output to ./src/gen folder:

./src/gen/user.ts

import {_a, _i, _o, _O, _S, _s, Validator as _Validator} from '@jtdc/jtd-dialect/lib/runtime';

export interface User {
  email: string;
  friends: Array<User>;
  name?: string;
  age?: number;
}

const validateUser: _Validator = (a, b, c) => {
  let d, e, f, g, h;
  b = b || {};
  c = c || '';
  if (_o(a, b, c)) {
    _s(a.email, b, c + '/email');
    d = a.friends;
    e = c + '/friends';
    if (_a(d, b, e)) {
      for (f = 0; f < d.length; f++) {
        validateUser(d[f], b, e + _S + f);
      }
    }
    g = a.name;
    if (_O(g)) {
      _s(g, b, c + '/name');
    }
    h = a.age;
    if (_O(h)) {
      _i(h, b, c + '/age');
    }
  }
  return b.errors;
};
export {validateUser};
const isUser = (value: unknown): value is User => !validateUser(value, {shallow: true});
export {isUser};

./src/gen/account.ts

import {_a, _e, _i, _o, _O, _S, Validator as _Validator} from '@jtdc/jtd-dialect/lib/runtime';
import {User, validateUser} from './user.ts';

export interface Account {
  user: User;
  stats: { visitCount: number; };
  /**
   * The default role is guest
   */
  roles?: Array<Role>;
}

enum Role {ADMIN = 'admin', GUEST = 'guest',}

export {Role};
const validateAccount: _Validator = (a, b, c) => {
  let d, e, f, g, h;
  b = b || {};
  c = c || '';
  if (_o(a, b, c)) {
    validateUser(a.user, b, c + '/user');
    d = a.stats;
    e = c + '/stats';
    if (_o(d, b, e)) {
      _i(d.visitCount, b, e + '/visitCount');
    }
    f = a.roles;
    if (_O(f)) {
      g = c + '/roles';
      if (_a(f, b, g)) {
        for (h = 0; h < f.length; h++) {
          validateRole(f[h], b, g + _S + h);
        }
      }
    }
  }
  return b.errors;
};
export {validateAccount};

const isAccount = (value: unknown): value is Account => !validateAccount(value, {shallow: true});
export {isAccount};

const validateRole: _Validator = (a, b, c) => {
  b = b || {};
  _e(a, (validateRole.cache ||= {}).a ||= ['admin', 'guest'], b, c || '');
  return b.errors;
};
export {validateRole};

const isRole = (value: unknown): value is Role => !validateRole(value, {shallow: true});
export {isRole};

You can find the source code of this example here.

Programmatic usage

Full API documentation.

import {compileTsModules} from '@jtdc/compiler';
import userJson from './src/user.json';
import accountJson from './src/account.json';

compileTsModules({
  './user': userJson,
  './account': accountJson,
});
// → {'./user': 'import …', './account': 'import …'}

Generated using TypeDoc