Install

npm i reistore

Examples

Usage

Simple

import{createStore,buildSchema}from"reistore";conststore=createStore();// you can pass initial state here by first argumentconst{schema:{ counter}}=buildSchema().field("counter",()=>0);// add field `counter` with default value `0`store.subscribe((state,changes)=>{if(changes.some(change=>change.in(counter))){// check is counter value changedconsole.log("Counter value: ",state.counter);}});// or you can subscribe directly to counter changesstore.subscribe((state,change)=>{console.log("Counter value: ",change.value);},counter)store.set(counter,1);// > Counter value: 1// > Counter value: 1constvalue=store.state.counter;// value = 1

Arrays and Maps

import{createStore,buildSchema}from"reistore";conststore=createStore();// you can pass initial state here by first argumentconst{schema:{ name, friends, skills}}=buildSchema().field("name",()=>"Alex").array("friends",undefined,()=>["Josie","Max"]).map("skills",b=>b.field("started",()=>"12.03.1990").field("level",()=>"noob"),()=>(newMap()).set("wakeboarding",{level:"master",started:"12.03.1998"}));store.set(name,"Jon");store.set(friends(0),"Max");store.set(friends(1),"Frodo");store.set(skills("sleeping"),{level:"grandmaster",started:"from born"});constvalue=store.state;/*  {    name: "Jon",    friends: ["Max", "Frodo"],    skills: Map {      "wakeboarding" => { level: "master", started: "12.03.1998"},      "sleeping" => { level: "grandmaster", started: "from born" }    }  }*/store.get(friends([0,1]));/*  ["Max", "Frodo"]*/store.get(skills(["sleeping","wakeboarding"],skill=>skill.level))/*  ["grandmaster", "master"]*/

Batch API

import{createStore,buildSchema}from"reistore";conststore=createStore();const{schema:{ counter}}=buildSchema().field("counter",()=>0);store.batch(instructor=>{instructor.set(counter,1);instructor.set(counter,2);console.log(store.state.counter);// value = 2instructor.set(counter,3);});console.log(store.get(counter));// same as store.state.counter// value = 3

Min-Max transform

import{createStore,createSchema,buildSchema}from"reistore";const{schema:{ min, max}}=buildSchema().field("min",()=>0).field("max",()=>0);functiontransformator(change,{ state, set, apply}){apply(change);// apply change to stateif(state.min>state.max){set(max,change.value);// apply change to max if min > max}elseif(state.max<state.min){set(min,change.value);// apply change to max if max < min}}conststore=createStore(undefined,transformator);store.set(min,1);console.log(store.state);// { min: 1, max: 1 }store.set(max,v=>v-10);console.log(store.state);// { min: -9, max: -9 }store.set(min,-15);// { min: -15, max: -9 }console.log(store.state);

Scope

import{createStore,createSchema,createScope,buildSchema}from"reistore";const{schema:{ sum, scope}}=buildSchema().field("sum",()=>0).node("scope",b=>b.field("min").field("max"),()=>({min:0,max:0}));constschema=createSchema();functiontransformator(change,{ state,scope:scopeState, set, apply}){if(change.in(scope.min)&&change.value>scopeState.max){// if changed min and new value(min) > state.scope.maxset(scope.max,change.value);}elseif(change.in(scope.max)&&change.value<scopeState.min){// if changed max and new value(max) < state.scope.minset(scope.min,change.value);}apply(change);// apply change to stateset(sum,state.scope.max+state.scope.min);// update sum}createScope(schema,scope,transformator);conststore=createStore(schema);store.set(scope.min,1);console.log(store.get(scope));// { min: 1, max: 1 }console.log(store.state);// { sum: 2, scope: { min: 1, max: 1 }}