Giter Club home page Giter Club logo

json-schema-compiler's Introduction

@saleor/json-schema-compiler

Usage:

pnpm saleor-schema-compiler compile ./src/schemas

With external definitions.json file:

pnpm saleor-schema-compiler compile ./src/schemas --definitions ./src/schemas/definitions.json

Description

It's a CLI tool that takes a directory and recursively transforms all JSON schemas it found into two files: .d.mts and .mjs. The first one contains types and the second one is a JS standalone validator:

Screenshot 2023-06-22 at 14 58 14

Example

Input

TransactionCancelationRequestedResponse.schema.json
{
  "$schema": "http://json-schema.org/draft-07/schema",
  "type": "object",
  "properties": {
    "pspReference": { "type": "string" },
    "result": {
      "$ref": "definitions.json#/definitions/TransactionCancelationRequestedAllowedResult"
    },
    "amount": { "$ref": "definitions.json#/definitions/PositiveDecimal" },
    "time": { "$ref": "definitions.json#/definitions/DateTime" },
    "externalUrl": { "type": "string" },
    "message": { "type": "string" }
  },
  "additionalProperties": false,
  "required": ["pspReference"]
}
definitions.json
{
  "$schema": "http://json-schema.org/draft-07/schema",
  "$id": "definitions.json",
  "definitions": {
    "PositiveDecimal": { "type": "number", "minimum": 0 },
    "DateTime": { "type": "string", "format": "date-time" },
    "TransactionCancelationRequestedAllowedResult": {
      "anyOf": [
        { "type": "string", "const": "CANCEL_SUCCESS" },
        { "type": "string", "const": "CANCEL_FAILURE" }
      ]
    }
  }
}
Command:
pnpm saleor-schema-compiler compile ./src/schemas --definitions ./src/schemas/definitions.json

Output

TransactionCancelationRequestedResponse.d.mts:
import type { ValidateFunction } from "ajv";
import type { JSONObject } from '../../types';
/* eslint-disable */
/**
 * This file was automatically generated by json-schema-to-typescript.
 * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
 * and run json-schema-to-typescript to regenerate this file.
 */

export interface TransactionCancelationRequestedResponse {
  pspReference: string;
  result?: "CANCEL_SUCCESS" | "CANCEL_FAILURE";
  amount?: number;
  time?: string;
  externalUrl?: string;
  message?: string;
}

declare const ValidateTransactionCancelationRequestedResponse: ValidateFunction<TransactionCancelationRequestedResponse>;
export default ValidateTransactionCancelationRequestedResponse;
TransactionCancelationRequestedResponse.mjs

Contains a standalone validator function. Exports default function that a ValidateFunction from Ajv library.

Usage

Generated code can be used as follows:

// As a type:
import { type TransactionCancelationRequestedResponse } from "./src/schemas/TransactionCancelationRequested/TransactionCancelationRequestedResponse.mjs";

// As a validator:
import ValidateTransactionCancelationRequestedResponse from "./src/schemas/TransactionCancelationRequested/TransactionCancelationRequestedResponse.mjs";

const data: unknown = { /* … */ };
const isDataValid = ValidateTransactionCancelationRequestedResponse(data); // true | false

if (isDataValid) {
  data // data has proper type here! TransactionCancelationRequestedResponse
}

json-schema-compiler's People

Contributors

typeofweb avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.