cerebral-signals

A mixed synchronous and asynchronous flow control tool

Creating a custom signal

const CerebralSignal = require('cerebral-signals')

const MySignal = CerebralSignal([
  // Context providers
])

const signal = MySignal([
  actionA,
  actionB
])

Included context providers

Input

Any payload passed into signal or updated using "next" will be available on the context as "input".

const CerebralSignal = require('cerebral-signals')
const InputProvider = require('cerebral-signals/providers/Input')

const MySignal = CerebralSignal([
  InputProvider()
])

function actionA(context) {
  context.input.foo // "bar"
}

const signal = MySignal([
  actionA
])

signal({
  foo: 'bar'
})

Output

Actions without any output will progress automatically. If you want to go down a specific path, pass payload and/or run async, you need an output to do that.

const CerebralSignal = require('cerebral-signals')
const OutputProvivder = require('cerebral-signals/providers/Output')

const MySignal = CerebralSignal([
  OutputProvivder()
])

function actionA(context) {
  // Trigger next action manually with a payload
  context.output({
    foo: 'bar'
  })
}

function actionB(context) {
  // If InputProvider was available the updated
  // (merged) payload would be available on "input"

  // Goes down to actionC, argument would be a payload.
  // This is run async, which is why the action is marked
  // as async as well
  setTimeout(() => context.output.alt1())
}
actionB.async = true

const signal = MySignal([
  actionA,
  actionB, {
    alt1: [],
    alt2: []
  }
])

signal()