Types

All public types are exported from the package root (reflow-ts).

Persisted data

type PersistedPrimitive = string | number | boolean | null | undefined | Date
type PersistedValue = PersistedPrimitive | PersistedValue[] | { [key: string]: PersistedValue }

Everything stored as workflow input or step output must be a PersistedValue. See Storage.

Runs and steps

type RunStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled'
type StepStatus = 'pending' | 'running' | 'completed' | 'completed-early' | 'failed'

Type	Shape
WorkflowRun	{ id, workflow, input, idempotencyKey, status, createdAt, updatedAt }
ClaimedRun	WorkflowRun & { leaseId }
StepResult	{ id, runId, name, status, output, error, attempts, createdAt, updatedAt }
RunInfo	{ run: WorkflowRun; steps: StepResult[] } — returned by getRunStatus()
CreateRunResult	{ run: WorkflowRun; created: boolean } — returned by storage.createRun()
RetryConfig	{ maxAttempts, backoff, initialDelayMs?, timeoutMs? }

Workflow & engine types

Type	Purpose
Workflow<TName, TInput, TPrev, TSteps>	The workflow builder type
AnyWorkflow	A workflow with any parameters (for collections)
StepContext	The object passed to step handlers
StepConfig	The config-object form of .step()
StepDefinition	Internal step representation exposed on the workflow
ParallelBranch / InferBranchOutput	Branch handler type and its output inference
ExecutionUnit	A sequential step or a parallel group
FailureContext	The object passed to onFailure
Engine / EngineConfig / EngineHooks	Engine surface
EngineEvent / EngineEventOf / StreamOptions / ResultStream	Events & streams
EnqueueOptions	{ idempotencyKey? }
StorageAdapter	Custom storage contract

Inference helpers

For building typed wrappers around Reflow:

type InferInput<W>        // extract a workflow's input type
type InferSteps<W>        // extract a workflow's accumulated steps map
type WorkflowInputMap<T>  // { [name]: inputType } across a workflow tuple
type WorkflowStepsMap<T>  // { [name]: stepsRecord } across a workflow tuple

WorkflowInputMap is what powers enqueue()'s type-safety — it maps each registered workflow name to its required input shape.