Spasm: super primitive asynchronous state machine


Spasm is a super primitive asynchronous state machine for Node.js.

$ npm install spasm

Spasm is extremely simple to use. Here’s an example using Commander.js to prompt the user for input from the command line until a non-empty string is provided:

var spasm   = require('spasm');
var program = require('commander');
var machine = spasm({
  'prompt'function(nextcontext) {
    program.prompt('What’s your name? ', function(name) {
      if ('' === name) {
      } else { = name;
  'display'function(nextcontext) {
machine('prompt', {
  salutation: 'Hello, %s.'

spasm() can be passed any object as a set of states, but it must have at least one state (a property with a function for a value). Each state will be passed a next function and the context of the state machine when it’s invoked. next uses process.nextTick() to ensure that each state is invoked asynchronously. The default context is an empty object ({}) if one isn’t passed when the machine is started. If a state makes any changes to context, it will automatically be reflected in any subsequent states. Alternatively, you can pass an entirely new context to next() as a second argument.