schemez v1.1.2
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)
โญ๏ธ 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 | |
feat(pencil): add 'graphiteWidth' option | |
perf(pencil): remove graphiteWidth option BREAKING CHANGE: The graphiteWidth option has been removed. The default graphite width of 10mm is always used for performance reasons. | 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