anchor
/
0.0.64
anchor 0.0.64
Install from the command line:
Learn more about npm packages
$ npm install @ironbay/anchor@0.0.64
Install via package.json:
"@ironbay/anchor": "0.0.64"
About this version
Anchor is a code generation tool for JSON:API. It allows you to define your schema once and generate code for all the places where you need to reference it.
It currently supports
- JSON Schema - Generate validators for different create/read/update operations
- Typescript - Generate types for different create/read/update operations
- OrbitJS - Generate a schema that can be loaded into orbitjs
# npm
npm install --save-dev @ironbay/anchor
# yarn
yarn add --dev @ironbay/anchorAnchor works by referencing a config file defined in typescript.
import { Config } from "@ironbay/anchor"
export default Config.define({
outputs: {
typescript: ["api/src/anchor.ts"],
jsonschema: ["api/src/anchor.json"],
orbit: ["react/src/models.ts"],
},
resources: [
{
type: "user",
attributes: {
name: {
type: "string",
},
},
relationships: {
posts: {
type: "many",
resource: "article",
inverse: "author",
},
},
},
{
type: "post",
attributes: {
title: {
type: "string",
ops: {
create: "required"
}
},
},
relationships: {
author: {
type: "one",
resource: "user",
inverse: "articles",
},
},
},
]
})Documentation on the format of this is a work in progress but for now Typescript can help you define this correcty so you should be able to use intellisense to explore the structure. The attribute type definition follows jsonschema and has an additional ops field to define what actions can be taken on the attribute.
Generating code is done by calling anchor gen ./anchor.config.ts. It's useful to add this as a script to your package.json
"scripts": {
"anchor:gen": "anchor gen ./anchor.config.ts"
}