schemez

This library allows users to create JSON schemas and respective TypeScript types in a manner consistent with TypeScript coding. Not only does this reduce code duplication, it makes it simpler for TypeScript developers to learn it.

Heavily based on seemingly abandoned project jsonschema-definer.

Added features like "pick", "omit", and etc, improved code and typescript support, and removed validator to avoid dependency.

🔥 Install

npm i -D schemez
yarn add -D schemez
pnpm i -D schemez

👌 Usage

Basic example

import s from "schemez";

// Lets define a simple object schema
const UserSchema = s.shape({
  name: s.string(),
  email: s.string().format('email').optional(),
  password: s.string().minLength(8),
  role: s.enum('client', 'supplier'),
  birthday: s.instanceOf(Date)
});

// Now lets get interface from schema
type User = typeof UserSchema.type
/*
  type User = {
    name: string,
    email?: string | undefined,
    password: string,
    role: 'client' | 'supplier',
    birthday: Date
  }
*/

// Get plain JSON Schema using .valueOf()
console.log(UserSchema.valueOf())

const AdminUserSchema = UserSchema.andShape({
	company: s.string().minLength(3),
});

// Now lets get interface from schema
type AdminUser = typeof AdminUserSchema.type
/*
  type AdminUser = {
    name: string,
    email?: string | undefined,
    password: string,
    role: 'client' | 'supplier',
    birthday: Date,
  }
*/

// Get plain JSON Schema using .valueOf()
console.log(AdminUserSchema.valueOf())

const BotUserSchema = UserSchema.pick("name", "role");

// Now lets get interface from schema
type BotUser = typeof BotUserSchema.type
/*
  type BotUser = {
    name: string,
    role: 'client' | 'supplier',
  }
*/

// Get plain JSON Schema using .valueOf()
console.log(BotUserSchema.valueOf())

👍 Reasons for using schemez

• Sensible defaults (ie properties are required by default)
• Built in TypeScript and TypeScript Support
• Reduced code duplication with TypeScript-like utilities (ie pick, omit, etc)
• Less code overall
• Can be easily extended to include UI via JSON Schema prop "description"

👎 Reasons against using schemez

• New
• Existing libraries with similar features (find more below)

👀 Comparison against similar libraries (fluent-json-schema vs schemez vs typebox)

Comparison

⭐️ Show your support

Give a ⭐️ if this project helped you!

📚 Documentation

Full documentation available here

Main exported variable s: SchemaFactory extends BaseSchema. Examples found in test files.

🏭 Release setup

Uses semantic-release to manage releases.

🔐 Commit message format

semantic-release uses the commit messages to determine the consumer impact of changes in the codebase. Following formalized conventions for commit messages, semantic-release automatically determines the next semantic version number, generates a changelog and publishes the release.

By default, semantic-release uses Angular Commit Message Conventions. The commit message format can be changed with the preset or config options of the @semantic-release/commit-analyzer and @semantic-release/release-notes-generator plugins.

Tools such as commitizen or commitlint can be used to help contributors and enforce valid commit messages.

The table below shows which commit message gets you which release type when semantic-release runs (using the default configuration):

| Commit message | Release type | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------- | | fix(pencil): stop graphite breaking when too much pressure applied | ~~Patch~~ Fix Release | | feat(pencil): add 'graphiteWidth' option | ~~Minor~~ Feature Release | | perf(pencil): remove graphiteWidth optionBREAKING CHANGE: The graphiteWidth option has been removed.The default graphite width of 10mm is always used for performance reasons. | ~~Major~~ Breaking Release (Note that the BREAKING CHANGE: token must be in the footer of the commit) |

Ref: https://github.com/semantic-release/semantic-release#commit-message-format

🤝 Contributing

Contributions, issues and feature requests are welcome!Feel free to check issues page.

🧪 Run tests

pnpm test

✍️ Author

👤 TriStarGod

• Github: @TriStarGod