Event Chains

Event chains describe multi-step flows (login, checkout, onboarding). Uyava tracks attempts in real time and surfaces progress in the Chains panel.

Define a chain

Uyava.defineEventChain(
  id: 'auth.login_flow',
  label: 'Login flow',
  tags: ['auth'],
  steps: const [
    UyavaEventChainStep(stepId: 'open', nodeId: 'ui.login'),
    UyavaEventChainStep(stepId: 'submit', nodeId: 'logic.auth'),
    UyavaEventChainStep(stepId: 'success', nodeId: 'logic.auth'),
  ],
);

Rules:

• id must be unique and stable.
• tags are required; at least one tag must be present.
• Step IDs must be unique within the chain.

Advance a chain

Chain progress is driven by node events that embed a chain payload:

Uyava.emitNodeEvent(
  nodeId: 'logic.auth',
  message: 'Auth submitted',
  payload: {
    'chain': {'id': 'auth.login_flow', 'step': 'submit', 'attempt': 'a1'},
    'edgeId': 'ui.login->logic.auth',
  },
);

Notes:

• attempt is optional. When omitted, Uyava starts a new attempt at the first step.
• Invalid chain IDs or steps emit diagnostics (for example chains.unknown_id).
• The Chains panel shows active attempts as chips and keeps completed runs in history.

Replay behavior

Desktop Pro replays chain attempts alongside the timeline. This makes it easier to follow causal paths in large logs.