datx
    TypeScript icon, indicating that this package has built-in type declarations

    1.1.3 • Public • Published

    datx

    Greenkeeper badge

    DatX is an opinionated data store for use with the MobX state management library. It features support for simple observable property definition, references to other models and first-class TypeScript support.


    Basic usage

    import { Collection, Model, prop } from 'datx';
    import { computed } from 'mobx';
    
    class Person extends Model {
      public static type = 'person'; // Unique name of the model class
    
      @prop name: string; // A normal observable property without a default value
      @prop surname: string;
      @prop.toOne(Person) spouse?: Person; // A reference to a Person model
    
      @computed get fullName() { // Standard MobX computed props
        return `${this.name} ${this.surname}`;
      }
    }
    
    class AppData extends 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

    Getting started

    Note: datx has a peer dependency to mobx@^4.2.0 or mobx@^5.5.0, so don't forget to install the latest MobX version:

    npm install --save datx mobx

    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.

    Concepts

    The library contains two main classes - Model and Collection.

    A collection contains models of any kind (they should however be listed in the types property), while a model can be in a single collection (but doesn't need to be in any).

    Models also include some useful methods and properties, but if they're in collision with your data/logic, you can use a PureModel class.

    Mixins

    Mixins are additional plugins that can enhance the regular models and collections. Available mixins:

    • withActions (model) - Adds some helper methods to the model - already included in the Model class, but not in the PureModel class
    • withMeta (model) - Adds some helpful meta data to the model - already included in the Model class, but not in the PureModel class
    • withPatches (model, collection) - Adds patch support to models and collections
    • datx-jsonapi (model, collection and view) - Adds the JSON API features to the model, collection and view

    To check out what are the planed future mixins, check out the issues.

    Want to make your own mixin? Check out the guide.

    API reference

    Troubleshooting

    Having issues with the library? Check out the troubleshooting page or open an issue.


    Build Status

    Package npm version dependency status dev dependency status
    datx npm version Dependency Status devDependency Status
    datx-jsonapi npm version Dependency Status devDependency Status
    datx-utils npm version Dependency Status devDependency Status

    License

    The MIT License

    Credits

    datx is maintained and sponsored by Infinum.

    Keywords

    none

    Install

    npm i datx

    DownloadsWeekly Downloads

    590

    Version

    1.1.3

    License

    MIT

    Unpacked Size

    178 kB

    Total Files

    60

    Last publish

    Collaborators

    • buhin
    • adrianbicanic
    • darkokukovec
    • nives
    • ivicabatinic
    • safo6m
    • fvoska
    • kbambir
    • dkriskov