@drschwabe/stack v2.0.0
Stack
Stack is a route driven state management library that leverages the familiar callback and middleware pattern used in Express.
Install
npm install --save @drschwabe/stackUsage
var stack = require('stack')
stack.on('/do-something', (state, next) => {
//modify state here, then pass it along:
next(null, state)
})
stack.fire('/do-something')Unlike Express however, instead of http requests the idea is to pass your entire application's state through your 'stack' of listeners. Each execute in order, asynchronously, passing along the modified state via next()
The main benefit to this approach is the set of 'commands' (ie: routes) your application now inheritently exposes; essentially an API you can tap into from anywhere, including from modules you later introduce or from outside contributors who can standardize around your stack as the formal way to extend and create new functionality in your app.
API
stack.on(command, callback)
Creates a listener that invokes callback on the given command
stack.fire(command, state, callback)
Fires an arbitrary command causing the stack of listeners listening to that command to fire (in order) until the end of the stack.
Properties
stack.state
The last known state of the stack. Persists after a fire concludes; after the bottom of the stack is reached hence the updated state is retained and available to subsequent fires.
stack.state._command
A special property added to your state object to keep track of the current command being issued. Analogous to req.parms in Express.
stack.state._command[parameter]
Any number of parameters on the command itself (ie: /do-something/:time are made available as a property of the stack.state._command object (ie: stack.state._command.time).
License
MIT