DSL Overview

The fluent builder API for defining sagas.

Creating a Saga

import { createSagaMachine } from '@saga-bus/core';

const saga = createSagaMachine<MyState, MyMessages>()
  .name('MySaga')
  .correlate('StartEvent', msg => msg.id, { canStart: true })
  .initial<StartEvent>(msg => ({ /* initial state */ }))
  .on('SomeEvent').handle(async (msg, state, ctx) => state)
  .build();

Builder Chain

Press enter or space to select a node.You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Type Parameters

createSagaMachine<TState, TMessages>()

• TState - Your saga state interface (must extend SagaState)
• TMessages - Union of all message types

Sections

• Builder Methods - .name(), .correlate(), .initial()
• Handlers - .on(), .when(), .handle()
• Context API - SagaContext methods
• TypeScript Tips - Type inference patterns