duraflows-tester

What problem does it solve?

This guide provides structured testing patterns for validating duraflows workflows using Vitest, enabling deterministic, self-contained tests that do not require real databases or external services.

Core Features & Use Cases

• In-memory test doubles for instances and history, clock injection for timeouts, and mock commands to simulate success, failure, and best-effort outcomes.
• Comprehensive test patterns for command registration, onEnter chains, guards (including ref-name validation), observers, and timeout processing across multiple scenarios.
• Use cases include unit tests for state transitions, timeout-driven moves, guard decisions, and observer correlation, all with reproducible results.

Quick Start

Write Vitest tests that create an in-memory runtime, inject a fixed clock, mock commands, and assert the correct state transitions and history.