@datx/jsonapi
DatX is an opinionated data store. It features support for references to other models and first-class TypeScript support.
@datx/jsonapi
is a datx mixin that adds JSON API support.
Basic usage
import { Collection, Model, Attribute } from '@datx/core';
import { jsonapiCollection, jsonapiModel } from '@datx/jsonapi';
class Person extends jsonapiModel(Model) {
public static type = 'person'; // Unique name of the model class
@Attribute()
public name: string; // A normal attribute without a default value
@Attribute()
public surname: string;
@Attribute({ toOne: Person })
public spouse?: Person; // A reference to a Person model
public get fullName() {
return `${this.name} ${this.surname}`;
}
}
class AppData extends jsonapiCollection(Collection) {
public static types = [Person]; // A list of models available in the collection
}
const store = new AppData();
const john = store.add(new Person({ name: 'John', surname: 'Smith' })); // Add a model instance to the store
const jane = store.add({ name: 'Jane', surname: 'Smith', spouse: john }, Person); // Add a model to the store
await john.save(); // POST to the server
const people = await store.fetchAll(Person); // Get all people from the server
Getting started
npm install --save @datx/jsonapi
Polyfilling
The lib makes use of the following features that are not yet available everywhere. Based on your browser support, you might want to polyfill them:
How to add the polyfills. Note: Fetch API is not included in the polyfills mentioned in the Troubleshooting page. Instead, you need to add it as a separate library. If you don't have any special requirements (like server-side rendering), you can use the window.fetch polyfill.
API reference
Troubleshooting
Having issues with the library? Check out the troubleshooting page or open an issue.
License
The MIT License
Credits
datx-jsonapi is maintained and sponsored by Infinum.