js-stores v0.1.24

js-stores

A small store library (using "Immer" internally)

Installation

npm install --save js-stores

Usage

import { defineMessages } from 'js-messages'
import { createStore, HandlerFactory } from 'js-stores'

const CounterActions = defineMessages({
  increment: (delta: number = 1) => ({ delta }),
  decrement: (delta: number = 1) => ({ delta }),
  reset: {}
})

type CounterState = { count: number }

type CounterHandlerFactory =
  HandlerFactory<CounterState, typeof CounterActions>

const createCounterHandler: CounterHandlerFactory = () => {
  return {
    increment(model, { delta }) {
      model.count += delta
    },

    decrement(model, { delta }) {
      model.count -= delta
    },

    reset(model) {
      model.count = 0
    }
  }
}

const store = createStore(createCounterHandler, { count: 0 })

console.log('Initial state:', store.getState())

const unsubscribe = store.subscribe(() => {
  console.log('New state:', store.getState())
})

store.dispatch(CounterActions.increment())
store.dispatch(CounterActions.increment())
store.dispatch(CounterActions.increment())
store.dispatch(CounterActions.increment(10))
store.dispatch(CounterActions.reset())
store.dispatch(CounterActions.decrement(3))

unsubscribe()

store.dispatch(CounterActions.decrement(4))
console.log('Final state:', store.getState())

/*
  Output:
  
  Initial state: { count: 0 }
  New state: { count: 1 }
  New state: { count: 2 }
  New state: { count: 3 }
  New state: { count: 13 }
  New state: { count: 0 }
  New state: { count: -3 }
  Final state: { count: -7 }  
*/

License

"js-stores" is licensed under LGPLv3.

Project status

"js-stores" is currently in alpha status.