| ⛓️ Orchestration and Combinators | Workflow composition (flow), parallel execution (parallel, all, allSettled, race), branching (when, branch), dynamic mapping (map), durable waits (waitForEvent, wait, resumeWorkflow), and AST exports (toMermaid, toDot, toJSON). |
🌊 Flow Instance Methods (Flow) | Primary workflow instance interface (run, execute, start), SLA timeouts (flow.timeout), versioning (flow.version), network guardrails (flow.networkPolicy), live monitoring (flow.monitor), execution hooks (flow.hook), manual compensations (flow.compensate), resumption (flow.resume), and AST inspection. |
🧱 Step Methods (Step) | Core execution unit construction (Step.create), Standard Schema validation (schema, spec, strict), lifecycle hooks (onBefore, onSkip, onAfter), retries (onFail), sagas (compensate), idempotency (idempotent), caching (cache), DI (withDependencies, requireDependency), output reduction (reduce), and network egress guardrails (allowNetwork, allowUnixSockets, denyNetwork, networkPolicy). |
⚙️ Execution Options (ExecutionOptions) | Runtime configuration options passed to .run() and .resume(): POJO mode (pojo, mode), cooperative cancellation (signal), deadlines (timeout), dependency injection (services), durability (durable), multi-tenancy (namespace), idempotency (idempotencyKey), execution hooks (stepExecutionHook), and live monitoring (monitor). |
| 💾 Storage and Persistence Utilities | Persistent checkpoint management (useStorage, getStorageAdapter), error modes (setErrorMode), optimistic concurrency control (OCC), serialized snapshot creation (checkpoint, restoreCheckpoint), and expiration cleanup (cleanExpiredCheckpoints). |
🚨 Error Hierarchy and Exceptions (SigloError) | Strongly typed runtime exception model rooted at SigloError: timeouts, cancellations, schema validation failures, saga rollbacks (CompensationException, UnresolvableCompensationException), network guardrail violations (NetworkPolicyViolationException), idempotency conflicts, version mismatches, and normalizeError(). |
🧪 Deterministic Testing (@siglo/testing) | Deterministic test harness (createWorkflowHarness), virtual clocks (FakeClock), step spies (spyStep), step mocking (mockStep), event injection (injectEvent), test assertions, execution fixtures, and replay (replayExecution). |
