subjective
v6.3.0
Published
Opinionated state management
Downloads
22
Maintainers
Readme
Subjective
- Opinionated state management
- Type safety by design. Type inference works for both Update and Selector functions.
- Logging. Inspect where Update function was called.
- Pause observable stream, if needed.
- Always receive the whole state, if needed.
Concepts
State
const state = new Subjective(
productState,
productStateFns,
);
Default Logger
const state = new Subjective(
productState,
productStateFns,
// use default Logger (dev only)
true
);
Custom Logger
const state = new Subjective(
productState,
productStateFns,
// use custom Logger (dev only)
(updateFnName: string, payload: any, updateFnRef: Function) => {
// LOG
const data = JSON.stringify(payload);
const dataTrimmed = data.substring(0, 80);
// logging to console
console.groupCollapsed(
`%c${fnName}: %c${dataTrimmed}${
dataTrimmed.length < data.length ? '…' : ''
}`,
`color: green; font-weight: 300;`,
`color: gray; font-weight: 100;`,
);
console.log(payload);
console.log(updateFnRef);
console.groupEnd();
}
);
Selector function
Subscribe to state.filter.type and notify with its value
state.select(s => s.filter.type).subscribe();
Subscribe to state.filter.type and notify with a whole state
state.select(s => s.filter.type, true).subscribe();
Update function
Update value of state.filter.type
state.update(f => f.updateFilterType, type);
Update value of state.filter.type and do not notify subscribers
state.update(f => f.updateFilterType, type, false);
Update value of state.filter.type and return updated state
const updatedState = state.update(f => f.updateFilterType, type);
Examples
NOTES
Immutable pattern
Always use immutable pattern otherwise it will not work. We can't rely on mutations since object reference is always the same.
Type-safety
Types are always inferred either from state class or payload parameter of the update function.
FUTURE
I've been thinking of this new syntax...check it out.