@tillhub/schemas
v6.347.0
Published
All Tillhub API OpenAPI 3 compatible JSON Schemas.
Downloads
2,614
Readme
Tillhub API Schemas
All Tillhub API OpenAPI 3 compatible JSON Schemas.
Getting Started
npm install @tillhub/schemas
Use this library to pre-validate request objects. This will always be up-to-date and versioned, since the Tillhub API uses this library as well.
const createCartSchema = require('@tillhub/schemas').v1.carts.create.request
console.log(createCartSchema)
// prints a JS object of the full schema
// {
// type: 'object',
// additionalProperties: true,
// properties: {
// ...
// }
// }
Release flow
Releases are automated with @semantic-release. For triggering a new release just use commit messages started from "feat" or "fix" prefix which is part of proper message format (please do not forget about it!).
CricleCI takes care of publishing the package. it will only trigger on the master branch. After the PR is merged into master, CircleCI will start the deployment process:
- It will checkout the project and installs the dependencies.
- Linter will check the code.
- It will run the tests to make sure everything runs perfectly.
- Code will be compiled.
- Finally, it will publish the new version by running
semantic-release
.
Contributing
Contributions are welcome in the case of falsy information. Those schemas are used as internaly driven data logic and quality.
Contributors should commit only via the following command. Deployment and change tracking is automatised by the underlying semantic-release implementation.
npm run commit
Resources CRUD CLI
Use the schema cli to create new resources automatically using Hygen:
$ npm run new:schema
> # interactive CLI
It will create the resources for the new schema and the route for it. Feel free to edit any files you need and don't forget to add the custom properties (if necessary) on:
/lib/<version>/base.js
License
Apache-2.0