npm - @fragno-dev/workflows - Versions diffs - 0.0.1 → 0.0.3 - Mend

@fragno-dev/workflows 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2212) hide show

package/dist/node/runner/step.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"step.js","names":["kind: \"wake\" \| \"retry\"","runAt: Date","#state","#workflowName","#instanceRef","#instanceId","#runNumber","#maxSteps","#time","#getDbNow","#writeLog","#beginStep","#throwIfPauseRequested","#setStepContext","#runWithTimeout","nextRetryAt: Date \| null","retryBase: Date","#endStep","#sleepUntil","#inFlightSteps","#stepCount","#activeStepKey","#activeAttempt","timer: ReturnType<typeof setTimeout> \| null","log: WorkflowLogCreate"],"sources":["../../../src/runner/step.ts"],"sourcesContent":["// Workflow step executor with in-memory state, retries, and waiting semantics.\n\nimport type { FragnoRuntime } from \"@fragno-dev/core\";\nimport type {\n WorkflowDuration,\n WorkflowLogger,\n WorkflowLogLevel,\n WorkflowLogOptions,\n WorkflowStep,\n WorkflowStepConfig,\n} from \"../workflow\";\nimport { NonRetryableError } from \"../workflow\";\nimport type { WorkflowLogCreate, WorkflowStepRecord } from \"./types\";\nimport { computeRetryDelayMs, normalizeRetryConfig, normalizeWaitTimeoutMs } from \"./utils\";\nimport { parseDurationMs } from \"../utils\";\nimport { isTerminalStatus } from \"./status\";\nimport type { RunnerState } from \"./state\";\nimport {\n getStepSnapshot,\n queueEventUpdate,\n queueLogCreate,\n queueStepCreate,\n queueStepUpdate,\n} from \"./state\";\n\nclass WorkflowSuspend extends Error {\n constructor(\n readonly kind: \"wake\" \| \"retry\",\n readonly runAt: Date,\n ) {\n super(\"WORKFLOW_SUSPEND\");\n }\n}\n\nclass WorkflowPause extends Error {\n constructor() {\n super(\"WORKFLOW_PAUSE\");\n }\n}\n\nclass WorkflowAbort extends Error {\n constructor() {\n super(\"WORKFLOW_ABORT\");\n }\n}\n\nclass WaitForEventTimeoutError extends Error {\n constructor() {\n super(\"WAIT_FOR_EVENT_TIMEOUT\");\n this.name = \"WaitForEventTimeoutError\";\n }\n}\n\nconst coerceDate = (timestamp: Date \| number) =>\n timestamp instanceof Date ? timestamp : new Date(timestamp);\n\nconst coerceEventTimestamp = (timestamp: unknown) => {\n if (timestamp instanceof Date) {\n return timestamp;\n }\n if (typeof timestamp === \"string\" \|\| typeof timestamp === \"number\") {\n return new Date(timestamp);\n }\n return new Date(NaN);\n};\n\nexport class RunnerStep implements WorkflowStep {\n log: WorkflowLogger;\n #state: RunnerState;\n #workflowName: string;\n #instanceRef: WorkflowStepRecord[\"instanceRef\"];\n #instanceId: string;\n #runNumber: number;\n #inFlightSteps = new Set<string>();\n #maxSteps: number;\n #stepCount = 0;\n #time: FragnoRuntime[\"time\"];\n #getDbNow: () => Promise<Date>;\n #activeStepKey: string \| null = null;\n #activeAttempt: number \| null = null;\n\n constructor(options: {\n state: RunnerState;\n workflowName: string;\n instanceRef: WorkflowStepRecord[\"instanceRef\"];\n instanceId: string;\n runNumber: number;\n maxSteps: number;\n time: FragnoRuntime[\"time\"];\n getDbNow: () => Promise<Date>;\n }) {\n this.#state = options.state;\n this.#workflowName = options.workflowName;\n this.#instanceRef = options.instanceRef;\n this.#instanceId = options.instanceId;\n this.#runNumber = options.runNumber;\n this.#maxSteps = options.maxSteps;\n this.#time = options.time;\n this.#getDbNow = options.getDbNow;\n this.log = {\n debug: (message, data, opts) => this.#writeLog(\"debug\", message, data, opts),\n info: (message, data, opts) => this.#writeLog(\"info\", message, data, opts),\n warn: (message, data, opts) => this.#writeLog(\"warn\", message, data, opts),\n error: (message, data, opts) => this.#writeLog(\"error\", message, data, opts),\n };\n }\n\n async do<T>(\n name: string,\n configOrCallback: WorkflowStepConfig \| (() => Promise<T> \| T),\n maybeCallback?: () => Promise<T> \| T,\n ): Promise<T> {\n const { config, callback } =\n typeof configOrCallback === \"function\"\n ? { config: undefined, callback: configOrCallback }\n : { config: configOrCallback, callback: maybeCallback };\n\n if (!callback) {\n throw new Error(\"Missing step callback\");\n }\n\n this.#beginStep(name);\n const now = this.#time.now();\n const dbNow = await this.#getDbNow();\n\n try {\n const existing = getStepSnapshot(this.#state, name);\n if (existing && existing.type !== \"do\") {\n throw new Error(\"STEP_TYPE_MISMATCH\");\n }\n\n if (existing?.status === \"completed\") {\n await this.#throwIfPauseRequested();\n return existing.result as T;\n }\n\n if (existing?.status === \"waiting\" && existing.nextRetryAt) {\n if (existing.nextRetryAt > dbNow) {\n await this.#throwIfPauseRequested();\n throw new WorkflowSuspend(\"retry\", existing.nextRetryAt);\n }\n }\n\n if (existing?.status === \"errored\") {\n const err = new Error(existing.errorMessage ?? \"STEP_FAILED\");\n err.name = existing.errorName ?? \"Error\";\n throw err;\n }\n\n const { maxAttempts, delayMs, backoff } = normalizeRetryConfig(config);\n const timeoutMs = config?.timeout ? parseDurationMs(config.timeout) : null;\n\n if (existing && (existing.attempts ?? 0) >= maxAttempts) {\n if (existing.id) {\n queueStepUpdate(this.#state, name, existing.id, {\n status: \"errored\",\n errorName: \"StepMaxAttemptsExceeded\",\n errorMessage: \"STEP_MAX_ATTEMPTS_EXCEEDED\",\n updatedAt: now,\n });\n }\n throw new NonRetryableError(\"STEP_MAX_ATTEMPTS_EXCEEDED\", \"StepMaxAttemptsExceeded\");\n }\n\n const attempt = (existing?.attempts ?? 0) + 1;\n\n const startUpdate = {\n status: \"running\",\n attempts: attempt,\n maxAttempts,\n timeoutMs,\n nextRetryAt: null,\n errorName: null,\n errorMessage: null,\n updatedAt: now,\n };\n\n if (existing?.id) {\n queueStepUpdate(this.#state, name, existing.id, startUpdate);\n } else {\n queueStepCreate(this.#state, name, {\n instanceRef: this.#instanceRef,\n workflowName: this.#workflowName,\n instanceId: this.#instanceId,\n runNumber: this.#runNumber,\n stepKey: name,\n name,\n type: \"do\",\n status: \"running\",\n attempts: attempt,\n maxAttempts,\n timeoutMs,\n nextRetryAt: null,\n wakeAt: null,\n waitEventType: null,\n result: null,\n errorName: null,\n errorMessage: null,\n createdAt: now,\n updatedAt: now,\n });\n }\n\n this.#setStepContext(name, attempt);\n\n try {\n const result = await this.#runWithTimeout(callback, timeoutMs);\n const completionUpdate = {\n status: \"completed\",\n result,\n updatedAt: this.#time.now(),\n };\n const snapshot = getStepSnapshot(this.#state, name);\n queueStepUpdate(this.#state, name, snapshot?.id, completionUpdate);\n await this.#throwIfPauseRequested();\n return result;\n } catch (err) {\n if (\n err instanceof WorkflowSuspend \|\|\n err instanceof WorkflowPause \|\|\n err instanceof WorkflowAbort\n ) {\n throw err;\n }\n\n const error = err as Error;\n const nonRetryable = error instanceof NonRetryableError;\n const shouldRetry = !nonRetryable && attempt < maxAttempts;\n\n let nextRetryAt: Date \| null = null;\n if (shouldRetry) {\n let retryBase: Date;\n try {\n retryBase = await this.#getDbNow();\n } catch {\n retryBase = this.#time.now();\n }\n nextRetryAt = new Date(\n retryBase.getTime() + computeRetryDelayMs(attempt, delayMs, backoff),\n );\n }\n\n const failureUpdate = {\n status: shouldRetry ? \"waiting\" : \"errored\",\n errorName: error.name,\n errorMessage: error.message,\n nextRetryAt,\n updatedAt: this.#time.now(),\n };\n const snapshot = getStepSnapshot(this.#state, name);\n queueStepUpdate(this.#state, name, snapshot?.id, failureUpdate);\n\n if (shouldRetry && nextRetryAt) {\n await this.#throwIfPauseRequested();\n throw new WorkflowSuspend(\"retry\", nextRetryAt);\n }\n\n throw error;\n }\n } finally {\n this.#endStep(name);\n }\n }\n\n async sleep(name: string, duration: WorkflowDuration): Promise<void> {\n const dbNow = await this.#getDbNow();\n const wakeAt = new Date(dbNow.getTime() + parseDurationMs(duration));\n return this.#sleepUntil(name, wakeAt);\n }\n\n async sleepUntil(name: string, timestamp: Date \| number): Promise<void> {\n const wakeAt = coerceDate(timestamp);\n return this.#sleepUntil(name, wakeAt);\n }\n\n async waitForEvent<T = unknown>(\n name: string,\n options: { type: string; timeout?: WorkflowDuration },\n ): Promise<{ type: string; payload: Readonly<T>; timestamp: Date }> {\n this.#beginStep(name);\n this.#setStepContext(name, null);\n const now = this.#time.now();\n const dbNow = await this.#getDbNow();\n\n try {\n const existing = getStepSnapshot(this.#state, name);\n if (existing && existing.type !== \"waitForEvent\") {\n throw new Error(\"STEP_TYPE_MISMATCH\");\n }\n\n if (existing?.status === \"completed\" && existing.result) {\n await this.#throwIfPauseRequested();\n const result = existing.result as {\n type: string;\n payload: Readonly<T>;\n timestamp: Date \| string \| number;\n };\n return { ...result, timestamp: coerceEventTimestamp(result.timestamp) };\n }\n\n if (existing?.status === \"errored\") {\n throw new WaitForEventTimeoutError();\n }\n\n const timeoutMs = existing?.timeoutMs ?? normalizeWaitTimeoutMs(options.timeout);\n const wakeAt = existing?.wakeAt ?? new Date(dbNow.getTime() + timeoutMs);\n\n const event = this.#state.events.find((candidate) => {\n if (candidate.type !== options.type \|\| candidate.deliveredAt !== null) {\n return false;\n }\n const createdAt = coerceEventTimestamp(candidate.createdAt);\n if (Number.isNaN(createdAt.getTime())) {\n return false;\n }\n return createdAt <= wakeAt;\n });\n\n if (event) {\n const eventTimestamp = coerceEventTimestamp(event.createdAt);\n const result = {\n type: event.type,\n payload: event.payload as Readonly<T>,\n timestamp: eventTimestamp,\n };\n\n queueEventUpdate(this.#state, event, {\n deliveredAt: now,\n consumedByStepKey: name,\n });\n\n if (existing?.id) {\n queueStepUpdate(this.#state, name, existing.id, {\n status: \"completed\",\n result,\n updatedAt: now,\n });\n } else {\n queueStepCreate(this.#state, name, {\n instanceRef: this.#instanceRef,\n workflowName: this.#workflowName,\n instanceId: this.#instanceId,\n runNumber: this.#runNumber,\n stepKey: name,\n name,\n type: \"waitForEvent\",\n status: \"completed\",\n attempts: 1,\n maxAttempts: 1,\n timeoutMs: normalizeWaitTimeoutMs(options.timeout),\n nextRetryAt: null,\n wakeAt: null,\n waitEventType: options.type,\n result,\n errorName: null,\n errorMessage: null,\n createdAt: now,\n updatedAt: now,\n });\n }\n\n await this.#throwIfPauseRequested();\n return { ...result, timestamp: coerceEventTimestamp(result.timestamp) };\n }\n\n if (wakeAt <= dbNow) {\n if (existing?.id) {\n queueStepUpdate(this.#state, name, existing.id, {\n status: \"errored\",\n errorName: \"WaitForEventTimeoutError\",\n errorMessage: \"WAIT_FOR_EVENT_TIMEOUT\",\n updatedAt: now,\n });\n }\n throw new WaitForEventTimeoutError();\n }\n\n if (existing?.id) {\n queueStepUpdate(this.#state, name, existing.id, {\n status: \"waiting\",\n wakeAt,\n waitEventType: options.type,\n timeoutMs,\n updatedAt: now,\n });\n } else {\n queueStepCreate(this.#state, name, {\n instanceRef: this.#instanceRef,\n workflowName: this.#workflowName,\n instanceId: this.#instanceId,\n runNumber: this.#runNumber,\n stepKey: name,\n name,\n type: \"waitForEvent\",\n status: \"waiting\",\n attempts: 0,\n maxAttempts: 1,\n timeoutMs,\n nextRetryAt: null,\n wakeAt,\n waitEventType: options.type,\n result: null,\n errorName: null,\n errorMessage: null,\n createdAt: now,\n updatedAt: now,\n });\n }\n\n await this.#throwIfPauseRequested();\n throw new WorkflowSuspend(\"wake\", wakeAt);\n } finally {\n this.#endStep(name);\n }\n }\n\n async #sleepUntil(name: string, wakeAt: Date): Promise<void> {\n this.#beginStep(name);\n this.#setStepContext(name, null);\n const now = this.#time.now();\n const dbNow = await this.#getDbNow();\n\n try {\n const existing = getStepSnapshot(this.#state, name);\n if (existing && existing.type !== \"sleep\") {\n throw new Error(\"STEP_TYPE_MISMATCH\");\n }\n\n if (existing?.status === \"completed\") {\n await this.#throwIfPauseRequested();\n return;\n }\n\n if (existing?.wakeAt && existing.wakeAt <= dbNow) {\n if (existing.id) {\n queueStepUpdate(this.#state, name, existing.id, {\n status: \"completed\",\n updatedAt: now,\n });\n }\n await this.#throwIfPauseRequested();\n return;\n }\n\n if (existing?.id) {\n queueStepUpdate(this.#state, name, existing.id, {\n status: \"waiting\",\n wakeAt: existing.wakeAt ?? wakeAt,\n updatedAt: now,\n });\n } else {\n queueStepCreate(this.#state, name, {\n instanceRef: this.#instanceRef,\n workflowName: this.#workflowName,\n instanceId: this.#instanceId,\n runNumber: this.#runNumber,\n stepKey: name,\n name,\n type: \"sleep\",\n status: \"waiting\",\n attempts: 0,\n maxAttempts: 1,\n timeoutMs: null,\n nextRetryAt: null,\n wakeAt,\n waitEventType: null,\n result: null,\n errorName: null,\n errorMessage: null,\n createdAt: now,\n updatedAt: now,\n });\n }\n\n await this.#throwIfPauseRequested();\n throw new WorkflowSuspend(\"wake\", wakeAt);\n } finally {\n this.#endStep(name);\n }\n }\n\n #beginStep(stepKey: string) {\n if (this.#inFlightSteps.has(stepKey)) {\n throw new Error(\"DUPLICATE_STEP_KEY\");\n }\n this.#inFlightSteps.add(stepKey);\n this.#stepCount += 1;\n if (this.#stepCount > this.#maxSteps) {\n throw new Error(\"MAX_STEPS_EXCEEDED\");\n }\n }\n\n #endStep(stepKey: string) {\n this.#inFlightSteps.delete(stepKey);\n if (this.#activeStepKey === stepKey) {\n this.#activeStepKey = null;\n this.#activeAttempt = null;\n }\n }\n\n #setStepContext(stepKey: string, attempt: number \| null) {\n this.#activeStepKey = stepKey;\n this.#activeAttempt = attempt;\n }\n\n async #throwIfPauseRequested() {\n // Use the latest heartbeat snapshot to avoid extra database roundtrips per step.\n if (this.#state.remoteStateRefresh) {\n await this.#state.remoteStateRefresh();\n }\n\n const remote = this.#state.remoteState;\n if (remote.missing) {\n return;\n }\n\n if (remote.runNumber !== this.#runNumber \|\| isTerminalStatus(remote.status)) {\n throw new WorkflowAbort();\n }\n\n if (\n remote.pauseRequested \|\|\n remote.status === \"waitingForPause\" \|\|\n remote.status === \"paused\"\n ) {\n throw new WorkflowPause();\n }\n }\n\n async #runWithTimeout<T>(callback: () => Promise<T> \| T, timeoutMs: number \| null): Promise<T> {\n if (!timeoutMs) {\n return await callback();\n }\n\n let timer: ReturnType<typeof setTimeout> \| null = null;\n try {\n return await Promise.race([\n Promise.resolve().then(callback),\n new Promise<T>((_, reject) => {\n timer = setTimeout(() => {\n reject(new Error(\"STEP_TIMEOUT\"));\n }, timeoutMs);\n }),\n ]);\n } finally {\n if (timer) {\n clearTimeout(timer);\n }\n }\n }\n\n async #writeLog(\n level: WorkflowLogLevel,\n message: string,\n data?: unknown,\n options?: WorkflowLogOptions,\n ): Promise<void> {\n const log: WorkflowLogCreate = {\n instanceRef: this.#instanceRef,\n workflowName: this.#workflowName,\n instanceId: this.#instanceId,\n runNumber: this.#runNumber,\n stepKey: this.#activeStepKey,\n attempt: this.#activeAttempt,\n level,\n category: options?.category ?? \"workflow\",\n message,\n data: data ?? null,\n createdAt: this.#time.now(),\n };\n\n queueLogCreate(this.#state, log);\n }\n}\n\nexport { WorkflowSuspend, WorkflowPause, WorkflowAbort };\n"],"mappings":"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"}
1	+ {"version":3,"file":"step.js","names":["#state","#taskKind","#mode","#nextStepKey","#createStepTxQueue","#upsertStep","#findPendingEvent","#queueEventUpdate","pendingMutations: Array<(ctx: HandlerTxContext<HooksMap>) => void>","pendingServiceCalls: AnyTxResult[]","pendingTerminalErrorMutations: Array<(ctx: HandlerTxContext<HooksMap>) => void>","calls: readonly AnyTxResult[]","#stepOccurrences","#buildStepCreateBase"],"sources":["../../../src/runner/step.ts"],"sourcesContent":["// Runner implementation of the WorkflowStep interface.\n\nimport type { HandlerTxContext, HooksMap } from \"@fragno-dev/db\";\n\nimport { isSystemEventActor } from \"../system-events\";\nimport { parseDurationMs } from \"../utils\";\nimport type {\n AnyTxResult,\n WorkflowDuration,\n WorkflowStep,\n WorkflowStepConfig,\n WorkflowStepTx,\n} from \"../workflow\";\nimport { WaitForEventTimeoutError } from \"../workflow\";\nimport type { RunnerState, WorkflowStepSnapshot } from \"./state\";\nimport type {\n RunnerTaskKind,\n WorkflowEventRecord,\n WorkflowEventUpdate,\n WorkflowStepCreateDraft,\n WorkflowStepUpdateDraft,\n} from \"./types\";\nimport { isMutateOnlyTx, isNonRetryableError, toError } from \"./utils\";\n\nexport type RunnerStepSuspendReason =\n \| { type: \"sleep\"; stepKey: string; delayMs?: number \| null; runAt?: Date }\n \| {\n type: \"waitForEvent\";\n stepKey: string;\n eventType: string;\n delayMs?: number \| null;\n runAt?: Date;\n }\n \| { type: \"retry\"; stepKey: string; delayMs?: number \| null };\n\nexport class RunnerStepSuspended extends Error {\n readonly reason: RunnerStepSuspendReason;\n\n constructor(reason: RunnerStepSuspendReason) {\n super(\"WORKFLOW_STEP_SUSPENDED\");\n this.name = \"RunnerStepSuspended\";\n this.reason = reason;\n }\n}\n\nexport class RunnerStepReplayStopped extends Error {\n readonly stepKey: string;\n\n constructor(stepKey: string) {\n super(\"WORKFLOW_REPLAY_STOPPED\");\n this.name = \"RunnerStepReplayStopped\";\n this.stepKey = stepKey;\n }\n}\n\ntype RunnerStepOptions = {\n state: RunnerState;\n taskKind: RunnerTaskKind;\n mode?: \"execute\" \| \"restore\";\n};\n\ntype StepTxQueue = {\n tx: WorkflowStepTx;\n commitSuccess: () => void;\n commitTerminalError: () => void;\n};\n\n/*\n Build a deterministic step key from type, name, and optional occurrence.\n * Bigger picture: stable step keys are the identity for replayable workflow steps.\n /\nfunction buildStepKey(type: string, name: string, occurrence?: number): string {\n const base = `${type}:${name}`;\n if (occurrence === undefined \|\| occurrence === 0) {\n return base;\n }\n return `${base}#${occurrence}`;\n}\n\n/\n Normalize timestamps to a Date instance.\n * Bigger picture: step scheduling uses consistent Date objects for comparisons.\n /\nfunction coerceTimestamp(timestamp: Date \| number): Date {\n return timestamp instanceof Date ? timestamp : new Date(timestamp);\n}\n\n/\n Strip delay-only fields from persisted snapshots.\n * Bigger picture: runner state stores the durable fields, not scheduling hints.\n /\nfunction stripDelayFields<T extends Record<string, unknown>>(data: T): T {\n const { nextRetryDelayMs, wakeDelayMs, ...rest } = data as T & {\n nextRetryDelayMs?: unknown;\n wakeDelayMs?: unknown;\n };\n return rest as T;\n}\n\n/\n Treat both \\\"complete\\\" and \\\"completed\\\" as terminal step statuses.\n * Bigger picture: keeps runner compatible with existing persisted values.\n /\nfunction isCompletedStatus(status?: string \| null): boolean {\n return status === \"completed\" \|\| status === \"complete\";\n}\n\n/\n Compute retry delay based on the configured backoff strategy.\n * Bigger picture: centralizes retry timing so scheduling is deterministic.\n /\nfunction computeBackoffDelayMs(\n retries: NonNullable<WorkflowStepConfig[\"retries\"]>,\n attempt: number,\n): number {\n const baseDelay = parseDurationMs(retries.delay);\n switch (retries.backoff) {\n case \"linear\":\n return baseDelay Math.max(attempt, 1);\n case \"exponential\":\n return baseDelay * Math.pow(2, Math.max(attempt - 1, 0));\n default:\n return baseDelay;\n }\n}\n\nexport class RunnerStep implements WorkflowStep {\n #state: RunnerState;\n #taskKind: RunnerTaskKind;\n #mode: \"execute\" \| \"restore\";\n #stepOccurrences = new Map<string, number>();\n\n constructor(options: RunnerStepOptions) {\n this.#state = options.state;\n this.#taskKind = options.taskKind;\n this.#mode = options.mode ?? \"execute\";\n }\n\n async do<T>(name: string, callback: (tx: WorkflowStepTx) => Promise<T> \| T): Promise<T>;\n async do<T>(\n name: string,\n config: WorkflowStepConfig,\n callback: (tx: WorkflowStepTx) => Promise<T> \| T,\n ): Promise<T>;\n async do<T>(\n name: string,\n configOrCallback: WorkflowStepConfig \| ((tx: WorkflowStepTx) => Promise<T> \| T),\n maybeCallback?: (tx: WorkflowStepTx) => Promise<T> \| T,\n ): Promise<T> {\n const config =\n typeof configOrCallback === \"function\" ? undefined : (configOrCallback as WorkflowStepConfig);\n const callback =\n typeof configOrCallback === \"function\"\n ? configOrCallback\n : (maybeCallback as typeof maybeCallback);\n\n if (!callback) {\n throw new Error(\"WORKFLOW_STEP_CALLBACK_REQUIRED\");\n }\n\n const stepKey = this.#nextStepKey(\"do\", name);\n const snapshot = this.#state.stepsByKey.get(stepKey);\n\n if (snapshot && isCompletedStatus(snapshot.status)) {\n return snapshot.result as T;\n }\n\n if (this.#mode === \"restore\") {\n throw new RunnerStepReplayStopped(stepKey);\n }\n\n if (snapshot?.status === \"errored\") {\n const error = new Error(snapshot.errorMessage ?? \"STEP_FAILED\");\n error.name = snapshot.errorName ?? \"Error\";\n throw error;\n }\n\n if (snapshot?.status === \"waiting\" && snapshot.nextRetryAt) {\n if (this.#taskKind !== \"retry\") {\n throw new RunnerStepSuspended({ type: \"retry\", stepKey, delayMs: null });\n }\n }\n\n const attempt = (snapshot?.attempts ?? 0) + 1;\n const maxAttempts = config?.retries ? config.retries.limit + 1 : 1;\n const timeoutMs = snapshot?.timeoutMs ?? null;\n\n const txQueue = this.#createStepTxQueue();\n\n try {\n const result = await callback(txQueue.tx);\n txQueue.commitSuccess();\n\n this.#upsertStep(stepKey, {\n name,\n type: \"do\",\n status: \"completed\",\n attempts: attempt,\n maxAttempts,\n timeoutMs,\n result,\n errorName: null,\n errorMessage: null,\n nextRetryAt: null,\n wakeAt: null,\n waitEventType: null,\n });\n\n return result;\n } catch (err) {\n const error = toError(err);\n const nonRetryable = isNonRetryableError(error);\n const retries = config?.retries;\n const canRetry = !nonRetryable && Boolean(retries && attempt <= retries.limit);\n\n if (nonRetryable) {\n txQueue.commitTerminalError();\n this.#upsertStep(stepKey, {\n name,\n type: \"do\",\n status: \"errored\",\n attempts: attempt,\n maxAttempts,\n timeoutMs,\n errorName: error.name,\n errorMessage: error.message,\n nextRetryAt: null,\n wakeAt: null,\n waitEventType: null,\n });\n throw error;\n }\n\n if (canRetry && retries) {\n const delayMs = computeBackoffDelayMs(retries, attempt);\n\n this.#upsertStep(stepKey, {\n name,\n type: \"do\",\n status: \"waiting\",\n attempts: attempt,\n maxAttempts: retries.limit + 1,\n timeoutMs,\n errorName: error.name,\n errorMessage: error.message,\n nextRetryDelayMs: delayMs,\n nextRetryAt: null,\n wakeAt: null,\n waitEventType: null,\n });\n\n throw new RunnerStepSuspended({ type: \"retry\", stepKey, delayMs });\n }\n\n txQueue.commitTerminalError();\n this.#upsertStep(stepKey, {\n name,\n type: \"do\",\n status: \"errored\",\n attempts: attempt,\n maxAttempts,\n timeoutMs,\n errorName: error.name,\n errorMessage: error.message,\n nextRetryAt: null,\n wakeAt: null,\n waitEventType: null,\n });\n\n throw error;\n }\n }\n\n async sleep(name: string, duration: WorkflowDuration): Promise<void> {\n const delayMs = parseDurationMs(duration);\n const stepKey = this.#nextStepKey(\"sleep\", name);\n const snapshot = this.#state.stepsByKey.get(stepKey);\n\n if (isCompletedStatus(snapshot?.status)) {\n return;\n }\n\n if (this.#mode === \"restore\") {\n throw new RunnerStepReplayStopped(stepKey);\n }\n\n if (this.#taskKind === \"wake\" && snapshot?.status === \"waiting\") {\n this.#upsertStep(stepKey, {\n name,\n type: \"sleep\",\n status: \"completed\",\n attempts: snapshot?.attempts ?? 0,\n maxAttempts: snapshot?.maxAttempts ?? 1,\n timeoutMs: snapshot?.timeoutMs ?? null,\n wakeAt: null,\n waitEventType: null,\n nextRetryAt: null,\n });\n return;\n }\n\n if (snapshot?.status === \"waiting\") {\n throw new RunnerStepSuspended({ type: \"sleep\", stepKey, delayMs: null });\n }\n\n if (!snapshot) {\n this.#upsertStep(stepKey, {\n name,\n type: \"sleep\",\n status: \"waiting\",\n attempts: 0,\n maxAttempts: 1,\n timeoutMs: null,\n wakeDelayMs: delayMs,\n wakeAt: null,\n waitEventType: null,\n nextRetryAt: null,\n });\n }\n\n throw new RunnerStepSuspended({ type: \"sleep\", stepKey, delayMs });\n }\n\n async sleepUntil(name: string, timestamp: Date \| number): Promise<void> {\n const stepKey = this.#nextStepKey(\"sleep\", name);\n const target = coerceTimestamp(timestamp);\n const snapshot = this.#state.stepsByKey.get(stepKey);\n\n if (isCompletedStatus(snapshot?.status)) {\n return;\n }\n\n if (this.#mode === \"restore\") {\n throw new RunnerStepReplayStopped(stepKey);\n }\n\n if (this.#taskKind === \"wake\" && snapshot?.status === \"waiting\") {\n this.#upsertStep(stepKey, {\n name,\n type: \"sleep\",\n status: \"completed\",\n attempts: snapshot?.attempts ?? 0,\n maxAttempts: snapshot?.maxAttempts ?? 1,\n timeoutMs: snapshot?.timeoutMs ?? null,\n wakeAt: null,\n waitEventType: null,\n nextRetryAt: null,\n });\n return;\n }\n\n if (snapshot?.status === \"waiting\") {\n throw new RunnerStepSuspended({ type: \"sleep\", stepKey, delayMs: null });\n }\n\n if (!snapshot) {\n this.#upsertStep(stepKey, {\n name,\n type: \"sleep\",\n status: \"waiting\",\n attempts: 0,\n maxAttempts: 1,\n timeoutMs: null,\n wakeAt: target,\n waitEventType: null,\n nextRetryAt: null,\n });\n }\n\n throw new RunnerStepSuspended({ type: \"sleep\", stepKey, runAt: target });\n }\n\n async waitForEvent<T = unknown>(\n name: string,\n options: { type: string; timeout?: WorkflowDuration },\n ): Promise<{ type: string; payload: Readonly<T>; timestamp: Date }> {\n const stepKey = this.#nextStepKey(\"waitForEvent\", name);\n const snapshot = this.#state.stepsByKey.get(stepKey);\n\n if (snapshot && isCompletedStatus(snapshot.status)) {\n return snapshot.result as { type: string; payload: Readonly<T>; timestamp: Date };\n }\n\n if (this.#mode === \"restore\") {\n throw new RunnerStepReplayStopped(stepKey);\n }\n\n const event = this.#findPendingEvent(options.type, snapshot?.wakeAt ?? null);\n if (event) {\n this.#queueEventUpdate(event, {\n consumedByStepKey: stepKey,\n });\n event.consumedByStepKey = stepKey;\n\n const result = {\n type: event.type,\n payload: (event.payload ?? null) as Readonly<T>,\n timestamp: event.createdAt,\n };\n\n this.#upsertStep(stepKey, {\n name,\n type: \"waitForEvent\",\n status: \"completed\",\n attempts: snapshot?.attempts ?? 0,\n maxAttempts: snapshot?.maxAttempts ?? 1,\n timeoutMs: snapshot?.timeoutMs ?? null,\n result,\n waitEventType: options.type,\n errorName: null,\n errorMessage: null,\n nextRetryAt: null,\n wakeAt: null,\n });\n\n return result;\n }\n\n const timeoutMs = options.timeout ? parseDurationMs(options.timeout) : null;\n\n if (snapshot?.status === \"waiting\") {\n if (this.#taskKind !== \"wake\") {\n throw new RunnerStepSuspended({\n type: \"waitForEvent\",\n stepKey,\n eventType: options.type,\n delayMs: null,\n });\n }\n\n if (!snapshot.wakeAt) {\n throw new RunnerStepSuspended({\n type: \"waitForEvent\",\n stepKey,\n eventType: options.type,\n delayMs: null,\n });\n }\n\n const error = new WaitForEventTimeoutError();\n this.#upsertStep(stepKey, {\n name,\n type: \"waitForEvent\",\n status: \"errored\",\n attempts: snapshot?.attempts ?? 0,\n maxAttempts: snapshot?.maxAttempts ?? 1,\n timeoutMs: snapshot?.timeoutMs ?? null,\n errorName: error.name,\n errorMessage: error.message,\n waitEventType: options.type,\n nextRetryAt: null,\n wakeAt: null,\n });\n throw error;\n }\n\n if (!snapshot) {\n this.#upsertStep(stepKey, {\n name,\n type: \"waitForEvent\",\n status: \"waiting\",\n attempts: 0,\n maxAttempts: 1,\n timeoutMs,\n wakeDelayMs: timeoutMs ?? undefined,\n waitEventType: options.type,\n nextRetryAt: null,\n wakeAt: null,\n });\n }\n\n throw new RunnerStepSuspended({\n type: \"waitForEvent\",\n stepKey,\n eventType: options.type,\n delayMs: timeoutMs ?? null,\n });\n }\n\n #createStepTxQueue(): StepTxQueue {\n const pendingMutations: Array<(ctx: HandlerTxContext<HooksMap>) => void> = [];\n const pendingServiceCalls: AnyTxResult[] = [];\n const pendingTerminalErrorMutations: Array<(ctx: HandlerTxContext<HooksMap>) => void> = [];\n\n const tx: WorkflowStepTx = {\n mutate: (fn) => {\n pendingMutations.push(fn);\n },\n onTerminalError: {\n mutate: (fn) => {\n pendingTerminalErrorMutations.push(fn);\n },\n },\n serviceCalls: (factory) => {\n let calls: readonly AnyTxResult[];\n try {\n calls = factory();\n } catch (error) {\n const err = toError(error);\n if (err.message.startsWith(\"Cannot add retrieval operation in state\")) {\n throw new Error(\"WORKFLOW_STEP_TX_RETRIEVE_NOT_SUPPORTED\");\n }\n throw err;\n }\n for (const call of calls) {\n if (!isMutateOnlyTx(call)) {\n throw new Error(\"WORKFLOW_STEP_TX_RETRIEVE_NOT_SUPPORTED\");\n }\n pendingServiceCalls.push(call);\n }\n },\n };\n\n return {\n tx,\n commitSuccess: () => {\n this.#state.mutations.txMutations.push(...pendingMutations);\n this.#state.mutations.txServiceCalls.push(...pendingServiceCalls);\n },\n commitTerminalError: () => {\n this.#state.mutations.txMutations.push(...pendingTerminalErrorMutations);\n },\n };\n }\n\n #findPendingEvent(type: string, wakeAt?: Date \| null): WorkflowEventRecord \| undefined {\n return this.#state.events.find(\n (event) =>\n !isSystemEventActor(event.actor) &&\n event.type === type &&\n !event.consumedByStepKey &&\n (!wakeAt \|\| event.createdAt <= wakeAt),\n );\n }\n\n #nextStepKey(type: string, name: string): string {\n const baseKey = buildStepKey(type, name);\n const occurrence = this.#stepOccurrences.get(baseKey) ?? 0;\n this.#stepOccurrences.set(baseKey, occurrence + 1);\n return buildStepKey(type, name, occurrence);\n }\n\n #queueEventUpdate(event: WorkflowEventRecord, data: WorkflowEventUpdate) {\n const key = event.id.toString();\n const existing = this.#state.mutations.eventUpdates.get(key);\n if (existing) {\n this.#state.mutations.eventUpdates.set(key, {\n id: existing.id,\n data: { ...existing.data, ...data },\n });\n return;\n }\n\n this.#state.mutations.eventUpdates.set(key, { id: event.id, data });\n }\n\n #upsertStep(stepKey: string, data: WorkflowStepUpdateDraft) {\n const snapshot = this.#state.stepsByKey.get(stepKey);\n const existingCreate = this.#state.mutations.stepCreates.get(stepKey);\n\n if (existingCreate) {\n this.#state.mutations.stepCreates.set(stepKey, {\n ...existingCreate,\n ...data,\n });\n } else if (snapshot?.id) {\n const existingUpdate = this.#state.mutations.stepUpdates.get(stepKey);\n if (existingUpdate) {\n this.#state.mutations.stepUpdates.set(stepKey, {\n id: existingUpdate.id,\n data: { ...existingUpdate.data, ...data },\n });\n } else {\n this.#state.mutations.stepUpdates.set(stepKey, { id: snapshot.id, data });\n }\n } else {\n const createBase = this.#buildStepCreateBase(stepKey, data);\n this.#state.mutations.stepCreates.set(stepKey, {\n ...createBase,\n ...data,\n });\n }\n\n const nextSnapshot = {\n ...snapshot,\n ...(existingCreate && stripDelayFields(existingCreate)),\n ...stripDelayFields(data),\n } as WorkflowStepSnapshot;\n\n this.#state.stepsByKey.set(stepKey, nextSnapshot);\n }\n\n #buildStepCreateBase(stepKey: string, data: WorkflowStepUpdateDraft): WorkflowStepCreateDraft {\n return {\n instanceRef: this.#state.instance.id,\n runNumber: this.#state.instance.runNumber,\n stepKey,\n name: data.name ?? stepKey,\n type: data.type ?? \"do\",\n status: data.status ?? \"waiting\",\n attempts: data.attempts ?? 0,\n maxAttempts: data.maxAttempts ?? 1,\n timeoutMs: data.timeoutMs ?? null,\n nextRetryAt: data.nextRetryAt ?? null,\n wakeAt: data.wakeAt ?? null,\n waitEventType: data.waitEventType ?? null,\n result: data.result ?? null,\n errorName: data.errorName ?? null,\n errorMessage: data.errorMessage ?? null,\n nextRetryDelayMs: data.nextRetryDelayMs,\n wakeDelayMs: data.wakeDelayMs,\n };\n }\n}\n"],"mappings":"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"}

package/dist/node/runner/types.d.ts CHANGED Viewed

@@ -1,21 +1,9 @@
-import { WorkflowsHooks, WorkflowsRegistry } from "../workflow.js";
-import { FragnoRuntime } from "@fragno-dev/core";
-import { DatabaseRequestContext } from "@fragno-dev/db";
+import { workflowsSchema } from "../schema.js";
+import { TableToColumnValues } from "@fragno-dev/db/query";
 //#region src/runner/types.d.ts
-type WorkflowsRunnerFragment = {
-  inContext: <T>(callback: (this: DatabaseRequestContext<WorkflowsHooks>) => T | Promise<T>) => T | Promise<T>;
-  services: Record<string, unknown>;
-};
-type WorkflowsRunnerOptions = {
-  fragment: WorkflowsRunnerFragment;
-  workflows: WorkflowsRegistry;
-  runtime: FragnoRuntime;
-  runnerId?: string;
-  leaseMs?: number;
-  getDbNow?: () => Promise<Date>;
-};
+type WorkflowInstanceRecord = TableToColumnValues<(typeof workflowsSchema)["tables"]["workflow_instance"]>;
+type WorkflowStepRecord = TableToColumnValues<(typeof workflowsSchema)["tables"]["workflow_step"]>;
 //#endregion
-export { WorkflowsRunnerOptions };
+export { WorkflowInstanceRecord, WorkflowStepRecord };
 //# sourceMappingURL=types.d.ts.map

package/dist/node/runner/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/runner/types.ts"],"sourcesContent":[],"mappings":"~~;;;;;;AA0CkB~~,KAJN,uBAAA,GAIM;EAGN,SAAA,EAAA,CAAA,CAAA,CAAA,CAAA,QAAA,EAAsB,CAAA,IAAA,EALb,sBAKa,CALU,cAKV,CAAA,EAAA,GAL8B,CAK9B,GALkC,OAKlC,CAL0C,CAK1C,CAAA,EAAA,GAJ3B,CAI2B,GAJvB,OAIuB,CAJf,CAIe,CAAA;EACtB,QAAA,EAJA,MAIA,CAAA,MAAA,EAAA,OAAA,CAAA;CACC;AACF,KAHC,sBAAA,~~GAGD;EAGgB~~,~~QAAA,EALf,uBAKe~~;~~EAAR~~,~~SAAA~~,~~EAJN~~,~~iBAIM;EAAO,OAAA,EAHf,aAGe;;;mBAAP,QAAQ~~"}
1	+ {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/runner/types.ts"],"sourcesContent":[],"mappings":";;;;KAYY,sBAAA,GAAyB,4BAC3B;KAUE,kBAAA,GAAqB,4BACvB"}

package/dist/node/runner/utils.js CHANGED Viewed

@@ -1,34 +1,33 @@
-import { DEFAULT_WAIT_TIMEOUT_MS, MAX_WAIT_TIMEOUT_MS, MIN_WAIT_TIMEOUT_MS } from "./constants.js";
-import { parseDurationMs } from "../utils.js";
+import { NonRetryableError } from "../workflow.js";
 //#region src/runner/utils.ts
-const normalizeWaitTimeoutMs = (duration) => {
-	const timeoutMs = duration ? parseDurationMs(duration) : DEFAULT_WAIT_TIMEOUT_MS;
-	if (timeoutMs < MIN_WAIT_TIMEOUT_MS || timeoutMs > MAX_WAIT_TIMEOUT_MS) throw new Error("WAIT_FOR_EVENT_TIMEOUT_RANGE");
-	return timeoutMs;
-};
-const normalizeRetryConfig = (config) => {
-	const retries = config?.retries;
-	if (!retries) return {
-		maxAttempts: 1,
-		delayMs: 0,
-		backoff: "constant"
-	};
-	return {
-		maxAttempts: retries.limit + 1,
-		delayMs: parseDurationMs(retries.delay),
-		backoff: retries.backoff ?? "constant"
-	};
-};
-const computeRetryDelayMs = (attempt, delayMs, backoff) => {
-	if (delayMs === 0) return 0;
-	switch (backoff) {
-		case "linear": return delayMs * attempt;
-		case "exponential": return delayMs * Math.pow(2, attempt - 1);
-		default: return delayMs;
-	}
-};
+/**
+* Normalize thrown values into a real Error instance.
+* Bigger picture: runner persists errors consistently regardless of throw type.
+*/
+function toError(error) {
+	return error instanceof Error ? error : new Error(typeof error === "string" ? error : "UNKNOWN_ERROR");
+}
+/**
+* Detect errors that should bypass step retries.
+* Bigger picture: NonRetryableError stops step retry loops for explicit user intent.
+*/
+function isNonRetryableError(error) {
+	if (error instanceof NonRetryableError) return true;
+	if (error && typeof error === "object" && "name" in error) return error.name === "NonRetryableError";
+	return false;
+}
+/**
+* Check that a TxResult is mutate-only (no retrieve phase, no nested service calls).
+* Bigger picture: the runner does a single retrieve, so extra retrieve phases are forbidden.
+*/
+function isMutateOnlyTx(tx) {
+	const { callbacks, serviceCalls } = tx._internal;
+	if (callbacks.retrieve || callbacks.retrieveSuccess) return false;
+	if (serviceCalls && serviceCalls.length > 0) return false;
+	return true;
+}
 //#endregion
-export { computeRetryDelayMs, normalizeRetryConfig, normalizeWaitTimeoutMs };
+export { isMutateOnlyTx, isNonRetryableError, toError };
 //# sourceMappingURL=utils.js.map

package/dist/node/runner/utils.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"utils.js","names":[],"sources":["../../../src/runner/utils.ts"],"sourcesContent":["// ~~Small~~ ~~helpers~~ for ~~timeouts~~ ~~and retry backoff~~.\n\nimport type { ~~WorkflowDuration,~~ ~~WorkflowStepConfig~~ } from \"../workflow\";\nimport { ~~parseDurationMs~~ } from \"../~~utils~~\";\~~nimport~~ { ~~DEFAULT_WAIT_TIMEOUT_MS,~~ ~~MAX_WAIT_TIMEOUT_MS,~~ ~~MIN_WAIT_TIMEOUT_MS~~ } ~~from~~ ~~\"./constants\";\~~n~~\nexport~~ ~~const~~ ~~normalizeWaitTimeoutMs~~ = ~~(duration?:~~ ~~WorkflowDuration)~~ => ~~{\n const~~ ~~timeoutMs~~ = ~~duration~~ ? ~~parseDurationMs~~(~~duration~~) : ~~DEFAULT_WAIT_TIMEOUT_MS;\~~n if ~~(timeoutMs~~ < ~~MIN_WAIT_TIMEOUT_MS~~ ~~\|\| timeoutMs > MAX_WAIT_TIMEOUT_MS) {~~\n ~~throw~~ new Error(\"~~WAIT_FOR_EVENT_TIMEOUT_RANGE~~\");\n }\n ~~return~~ ~~timeoutMs;\~~n~~};\~~n\nexport ~~const~~ ~~normalizeRetryConfig =~~ (~~config?:~~ ~~WorkflowStepConfig~~) => {\n ~~const~~ ~~retries~~ = ~~config?.retries;\n if (!retries~~) {\n return {\n ~~maxAttempts:~~ ~~1,\n delayMs:~~ ~~0,\n backoff:~~ \"~~constant~~\" as ~~const,\n };\n }~~\n\~~n return~~ {\n ~~maxAttempts:~~ ~~retries.limit~~ + ~~1,\n delayMs:~~ ~~parseDurationMs(retries.delay~~)~~,\n backoff: retries~~.~~backoff~~ ?? \"~~constant~~\",\n };\n};\n\~~nexport~~ ~~const~~ ~~computeRetryDelayMs~~ = (~~attempt:~~ ~~number~~, ~~delayMs~~: ~~number~~, ~~backoff~~: ~~string~~) => {\n if (~~delayMs~~ ~~===~~ 0) {\n return 0;\n }\n\n ~~switch~~ (~~backoff~~) {\n ~~case \"linear\":\n~~ return ~~delayMs * attempt~~;\n ~~case~~ \~~"exponential\":\~~n return ~~delayMs * Math.pow(2, attempt - 1)~~;\n ~~default:\n return delayMs;\n~~ }\n~~};\n~~"],"mappings":"~~;;;;AAMA~~,~~MAAa~~,~~0BAA0B~~,~~aAAgC~~;~~CACrE~~,~~MAAM~~,~~YAAY~~,~~WAAW~~,~~gBAAgB~~,~~SAAS,GAAG;AACzD,KAAI,YAAY,uBAAuB,YAAY,oBACjD,OAAM,~~IAAI,MAAM~~,+BAA+B;AAEjD~~,~~QAAO;;AAGT~~,~~MAAa~~,~~wBAAwB~~,~~WAAgC;CACnE~~,~~MAAM~~,~~UAAU~~,~~QAAQ~~;~~AACxB~~,KAAI,~~CAAC~~,~~QACH~~,QAAO;~~EACL~~,~~aAAa;EACb~~,SAAS~~;EACT~~,~~SAAS;EACV;AAGH~~,~~QAAO;EACL~~,~~aAAa~~,~~QAAQ~~,~~QAAQ;EAC7B~~,~~SAAS,gBAAgB,~~QAAQ,~~MAAM;EACvC~~,SAAS~~,QAAQ,WAAW~~;~~EAC7B;;AAGH~~,~~MAAa~~,~~uBAAuB~~,~~SAAiB~~,~~SAAiB,YAAoB~~;~~AACxF~~,~~KAAI~~,~~YAAY~~,~~EACd~~,~~QAAO;AAGT~~,~~SAAQ,SAAR~~;~~EACE~~,~~KAAK~~,~~SACH~~,~~QAAO~~,UAAU~~;EACnB~~,~~KAAK~~,~~cACH,~~QAAO,~~UAAU~~,~~KAAK~~,~~IAAI~~,~~GAAG~~,~~UAAU~~,~~EAAE~~;~~EAC3C~~,~~QACE,~~QAAO"}
1	+ {"version":3,"file":"utils.js","names":[],"sources":["../../../src/runner/utils.ts"],"sourcesContent":["// Shared utilities for runner helpers.\n\nimport type { AnyTxResult } from \"../workflow\";\nimport { NonRetryableError } from \"../workflow\";\n\n/*\n Normalize thrown values into a real Error instance.\n * Bigger picture: runner persists errors consistently regardless of throw type.\n /\nexport function toError(error: unknown): Error {\n return error instanceof Error\n ? error\n : new Error(typeof error === \"string\" ? error : \"UNKNOWN_ERROR\");\n}\n\n/\n Detect errors that should bypass step retries.\n * Bigger picture: NonRetryableError stops step retry loops for explicit user intent.\n /\nexport function isNonRetryableError(error: unknown): boolean {\n if (error instanceof NonRetryableError) {\n return true;\n }\n if (error && typeof error === \"object\" && \"name\" in error) {\n return (error as { name?: unknown }).name === \"NonRetryableError\";\n }\n return false;\n}\n\n/\n Check that a TxResult is mutate-only (no retrieve phase, no nested service calls).\n * Bigger picture: the runner does a single retrieve, so extra retrieve phases are forbidden.\n */\nexport function isMutateOnlyTx(tx: AnyTxResult): boolean {\n const { callbacks, serviceCalls } = tx._internal;\n if (callbacks.retrieve \|\| callbacks.retrieveSuccess) {\n return false;\n }\n if (serviceCalls && serviceCalls.length > 0) {\n return false;\n }\n return true;\n}\n"],"mappings":";;;;;;;AASA,SAAgB,QAAQ,OAAuB;AAC7C,QAAO,iBAAiB,QACpB,QACA,IAAI,MAAM,OAAO,UAAU,WAAW,QAAQ,gBAAgB;;;;;;AAOpE,SAAgB,oBAAoB,OAAyB;AAC3D,KAAI,iBAAiB,kBACnB,QAAO;AAET,KAAI,SAAS,OAAO,UAAU,YAAY,UAAU,MAClD,QAAQ,MAA6B,SAAS;AAEhD,QAAO;;;;;;AAOT,SAAgB,eAAe,IAA0B;CACvD,MAAM,EAAE,WAAW,iBAAiB,GAAG;AACvC,KAAI,UAAU,YAAY,UAAU,gBAClC,QAAO;AAET,KAAI,gBAAgB,aAAa,SAAS,EACxC,QAAO;AAET,QAAO"}

package/dist/node/runner/workflow-state.js ADDED Viewed

@@ -0,0 +1,27 @@
+//#region src/runner/workflow-state.ts
+function createIsolatedWorkflowState(value) {
+	if (typeof structuredClone === "function") try {
+		return structuredClone(value);
+	} catch {}
+	return { ...value };
+}
+/**
+* Create a state controller for a single workflow run/replay.
+* Bigger picture: replay reconstructs state by rerunning workflow code around cached step results,
+* so only in-memory state mutations that execute during replay are restorable.
+*/
+function createWorkflowStateController(initialState, options = {}) {
+	const currentState = initialState;
+	const setState = (nextState) => {
+		Object.assign(currentState, nextState);
+		options.onStateChange?.(currentState);
+	};
+	return {
+		getState: () => currentState,
+		setState
+	};
+}
+//#endregion
+export { createIsolatedWorkflowState, createWorkflowStateController };
+//# sourceMappingURL=workflow-state.js.map

package/dist/node/runner/workflow-state.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"workflow-state.js","names":[],"sources":["../../../src/runner/workflow-state.ts"],"sourcesContent":["// Helpers for holding restorable workflow state snapshots in memory.\n\nimport type { WorkflowStateShape } from \"../workflow\";\n\nexport type WorkflowStateController<TState extends WorkflowStateShape = WorkflowStateShape> = {\n getState: () => TState;\n setState: (nextState: Partial<TState>) => void;\n};\n\ntype WorkflowStateControllerOptions<TState extends WorkflowStateShape> = {\n onStateChange?: (state: TState) => void;\n};\n\nexport function createIsolatedWorkflowState<T extends WorkflowStateShape>(value: T): T {\n if (typeof structuredClone === \"function\") {\n try {\n return structuredClone(value);\n } catch {\n // Fall through so live in-memory members such as listeners or class instances remain usable.\n }\n }\n\n return { ...value };\n}\n\n/**\n * Create a state controller for a single workflow run/replay.\n * Bigger picture: replay reconstructs state by rerunning workflow code around cached step results,\n * so only in-memory state mutations that execute during replay are restorable.\n */\nexport function createWorkflowStateController<TState extends WorkflowStateShape>(\n initialState: TState,\n options: WorkflowStateControllerOptions<TState> = {},\n): WorkflowStateController<TState> {\n const currentState = initialState;\n\n const setState = (nextState: Partial<TState>) => {\n Object.assign(currentState, nextState);\n options.onStateChange?.(currentState);\n };\n\n return {\n getState: () => currentState,\n setState,\n };\n}\n"],"mappings":";AAaA,SAAgB,4BAA0D,OAAa;AACrF,KAAI,OAAO,oBAAoB,WAC7B,KAAI;AACF,SAAO,gBAAgB,MAAM;SACvB;AAKV,QAAO,EAAE,GAAG,OAAO;;;;;;;AAQrB,SAAgB,8BACd,cACA,UAAkD,EAAE,EACnB;CACjC,MAAM,eAAe;CAErB,MAAM,YAAY,cAA+B;AAC/C,SAAO,OAAO,cAAc,UAAU;AACtC,UAAQ,gBAAgB,aAAa;;AAGvC,QAAO;EACL,gBAAgB;EAChB;EACD"}

package/dist/node/scenario.d.ts ADDED Viewed

@@ -0,0 +1,343 @@
+import { InstanceStatus, WorkflowDuration, WorkflowEnqueuedHookPayload, WorkflowsRegistry } from "./workflow.js";
+import { WorkflowsHistory, WorkflowsTestClock, WorkflowsTestHarness, WorkflowsTestHarnessOptions, WorkflowsTestRuntime } from "./test.js";
+import { DatabaseFragmentsTestBuilder, SupportedAdapter } from "@fragno-dev/test";
+//#region src/scenario.d.ts
+type WorkflowScenarioVars = Record<string, unknown>;
+type ScenarioInput<T, TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = T | ((ctx: WorkflowScenarioContext<TRegistry, TVars>) => T | Promise<T>);
+type WorkflowScenarioHarnessOptions<TRegistry extends WorkflowsRegistry> = Omit<WorkflowsTestHarnessOptions<TRegistry>, "workflows" | "adapter" | "testBuilder"> & {
+  adapter?: SupportedAdapter;
+  testBuilder?: DatabaseFragmentsTestBuilder<{}, undefined>;
+};
+type WorkflowScenarioDefinition<TRegistry extends WorkflowsRegistry = WorkflowsRegistry, TVars extends WorkflowScenarioVars = WorkflowScenarioVars> = {
+  name: string;
+  workflows: TRegistry;
+  harness?: WorkflowScenarioHarnessOptions<TRegistry>;
+  steps: WorkflowScenarioStep<TRegistry, TVars>[];
+};
+type WorkflowScenarioContext<TRegistry extends WorkflowsRegistry = WorkflowsRegistry, TVars extends WorkflowScenarioVars = WorkflowScenarioVars> = {
+  name: string;
+  harness: WorkflowsTestHarness<TRegistry>;
+  runtime: WorkflowsTestRuntime;
+  clock: WorkflowsTestClock;
+  vars: Partial<TVars>;
+  state: WorkflowScenarioState<TRegistry>;
+  cleanup: () => Promise<void>;
+};
+type WorkflowScenarioResult<TVars extends WorkflowScenarioVars = WorkflowScenarioVars> = {
+  name: string;
+  vars: Partial<TVars>;
+  runtime: WorkflowsTestRuntime;
+  clock: WorkflowsTestClock;
+};
+type WorkflowScenarioInstanceRow = {
+  id: bigint;
+  instanceId: string;
+  workflowName: string;
+  status: string;
+  createdAt: Date;
+  updatedAt: Date;
+  startedAt: Date | null;
+  completedAt: Date | null;
+  params: unknown;
+  output: unknown | null;
+  errorName: string | null;
+  errorMessage: string | null;
+  runNumber: number;
+};
+type WorkflowScenarioStepRow = {
+  id: bigint;
+  instanceRef: bigint;
+  workflowName: string;
+  instanceId: string;
+  runNumber: number;
+  stepKey: string;
+  name: string;
+  type: string;
+  status: string;
+  attempts: number;
+  maxAttempts: number;
+  timeoutMs: number | null;
+  nextRetryAt: Date | null;
+  wakeAt: Date | null;
+  waitEventType: string | null;
+  result: unknown | null;
+  errorName: string | null;
+  errorMessage: string | null;
+  createdAt: Date;
+  updatedAt: Date;
+};
+type WorkflowScenarioEventRow = {
+  id: bigint;
+  instanceRef: bigint;
+  workflowName: string;
+  instanceId: string;
+  runNumber: number;
+  type: string;
+  payload: unknown | null;
+  createdAt: Date;
+  deliveredAt: Date | null;
+  consumedByStepKey: string | null;
+};
+type WorkflowScenarioState<TRegistry extends WorkflowsRegistry = WorkflowsRegistry> = {
+  getInstance: (workflow: (keyof TRegistry & string) | string, instanceId: string) => Promise<WorkflowScenarioInstanceRow | null>;
+  getSteps: (workflow: (keyof TRegistry & string) | string, instanceId: string, options?: {
+    runNumber?: number;
+    order?: "asc" | "desc";
+  }) => Promise<WorkflowScenarioStepRow[]>;
+  getEvents: (workflow: (keyof TRegistry & string) | string, instanceId: string, options?: {
+    runNumber?: number;
+    order?: "asc" | "desc";
+  }) => Promise<WorkflowScenarioEventRow[]>;
+  getStatus: (workflow: (keyof TRegistry & string) | string, instanceId: string) => Promise<InstanceStatus>;
+  getHistory: (workflow: (keyof TRegistry & string) | string, instanceId: string, options?: {
+    runNumber?: number;
+    pageSize?: number;
+    stepsCursor?: string;
+    eventsCursor?: string;
+    order?: "asc" | "desc";
+  }) => Promise<WorkflowsHistory>;
+  /**
+   * Internal helpers for inspecting durable hooks.
+   * These are intentionally semi-hidden; downstream workflows users should not rely on them.
+   */
+  internal: WorkflowScenarioStateInternalUtils;
+};
+type WorkflowScenarioRouteResponse = {
+  type: string;
+  data?: unknown;
+  error?: {
+    message: string;
+    code: string;
+  };
+};
+type WorkflowScenarioHookRow = {
+  id: bigint;
+  namespace: string;
+  hookName: string;
+  payload: unknown;
+  status: "pending" | "processing" | "completed" | "failed";
+  attempts: number;
+  maxAttempts: number;
+  lastAttemptAt: Date | null;
+  nextRetryAt: Date | null;
+  error: string | null;
+  createdAt: Date;
+  nonce: string;
+};
+type WorkflowScenarioStateInternalUtils = {
+  /**
+   * Inspect durable hook rows (fragno_hooks) for debugging.
+   * Defaults to the workflows namespace ("workflows").
+   */
+  getHooks: (options?: {
+    namespace?: string;
+    hookName?: string;
+    status?: WorkflowScenarioHookRow["status"];
+    workflowName?: string;
+    instanceId?: string;
+  }) => Promise<WorkflowScenarioHookRow[]>;
+};
+type WorkflowScenarioStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = WorkflowScenarioCreateStep<TRegistry, TVars> | WorkflowScenarioInitializeAndRunUntilIdleStep<TRegistry, TVars> | WorkflowScenarioCreateBatchStep<TRegistry, TVars> | WorkflowScenarioSendEventStep<TRegistry, TVars> | WorkflowScenarioEventAndRunUntilIdleStep<TRegistry, TVars> | WorkflowScenarioPauseStep<TRegistry, TVars> | WorkflowScenarioResumeStep<TRegistry, TVars> | WorkflowScenarioResumeAndRunUntilIdleStep<TRegistry, TVars> | WorkflowScenarioTerminateStep<TRegistry, TVars> | WorkflowScenarioRestartStep<TRegistry, TVars> | WorkflowScenarioRunCreateUntilIdleStep<TRegistry, TVars> | WorkflowScenarioRunResumeUntilIdleStep<TRegistry, TVars> | WorkflowScenarioRetryAndRunUntilIdleStep<TRegistry, TVars> | WorkflowScenarioTickStep<TRegistry, TVars> | WorkflowScenarioRunUntilIdleStep<TRegistry, TVars> | WorkflowScenarioAdvanceTimeAndRunUntilIdleStep<TRegistry, TVars> | WorkflowScenarioReadStep<TRegistry, TVars> | WorkflowScenarioAssertStep<TRegistry, TVars>;
+type WorkflowScenarioCreateStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "create";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  params?: ScenarioInput<unknown, TRegistry, TVars>;
+  id?: ScenarioInput<string, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioInitializeAndRunUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "initializeAndRunUntilIdle";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  params?: ScenarioInput<unknown, TRegistry, TVars>;
+  id?: ScenarioInput<string, TRegistry, TVars>;
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+  runStoreAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioCreateBatchStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "createBatch";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instances: ScenarioInput<Array<{
+    id: string;
+    params?: unknown;
+  }>, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioSendEventStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "event";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  event: ScenarioInput<{
+    type: string;
+    payload?: unknown;
+  }, TRegistry, TVars>;
+  /**
+   * When set, used as createdAt for the event. Makes ordering deterministic and tests non-flaky.
+   */
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioEventAndRunUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "eventAndRunUntilIdle";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  event: ScenarioInput<{
+    type: string;
+    payload?: unknown;
+  }, TRegistry, TVars>;
+  /**
+   * When set, used as createdAt for the event. Makes ordering deterministic and tests non-flaky.
+   */
+  eventTimestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  /**
+   * When set, used as the tick timestamp for runUntilIdle (e.g. for clock-driven scenarios).
+   */
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+  runStoreAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioPauseStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "pause";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioResumeStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "resume";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioResumeAndRunUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "resumeAndRunUntilIdle";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+  runStoreAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioTerminateStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "terminate";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioRestartStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "restart";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioRunCreateUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "runCreateUntilIdle";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioRunResumeUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "runResumeUntilIdle";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioRetryAndRunUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "retryAndRunUntilIdle";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioTickStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "tick";
+  payload?: ScenarioInput<WorkflowEnqueuedHookPayload, TRegistry, TVars>;
+  workflow?: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId?: ScenarioInput<string, TRegistry, TVars>;
+  reason?: ScenarioInput<WorkflowEnqueuedHookPayload["reason"], TRegistry, TVars>;
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioRunUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "runUntilIdle";
+  payload?: ScenarioInput<WorkflowEnqueuedHookPayload, TRegistry, TVars>;
+  workflow?: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId?: ScenarioInput<string, TRegistry, TVars>;
+  reason?: ScenarioInput<WorkflowEnqueuedHookPayload["reason"], TRegistry, TVars>;
+  timestamp?: ScenarioInput<Date, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioAdvanceTimeAndRunUntilIdleStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "advanceTimeAndRunUntilIdle";
+  workflow: ScenarioInput<(keyof TRegistry & string) | string, TRegistry, TVars>;
+  instanceId: ScenarioInput<string, TRegistry, TVars>;
+  advanceBy?: ScenarioInput<WorkflowDuration, TRegistry, TVars>;
+  setTo?: ScenarioInput<Date | number, TRegistry, TVars>;
+  maxTicks?: ScenarioInput<number, TRegistry, TVars>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioReadStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "read";
+  read: (ctx: WorkflowScenarioContext<TRegistry, TVars>) => unknown | Promise<unknown>;
+  storeAs?: (keyof TVars & string) | undefined;
+};
+type WorkflowScenarioAssertStep<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars> = {
+  type: "assert";
+  assert: (ctx: WorkflowScenarioContext<TRegistry, TVars>) => void | Promise<void>;
+};
+declare function defineScenario<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars>(scenario: WorkflowScenarioDefinition<TRegistry, TVars>): WorkflowScenarioDefinition<TRegistry, TVars>;
+type StepInput<TStep extends {
+  type: string;
+}> = Omit<TStep, "type">;
+declare const createScenarioSteps: <TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars>() => {
+  create: (input: StepInput<WorkflowScenarioCreateStep<TRegistry, TVars>>) => WorkflowScenarioCreateStep<TRegistry, TVars>;
+  initializeAndRunUntilIdle: (input: StepInput<WorkflowScenarioInitializeAndRunUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioInitializeAndRunUntilIdleStep<TRegistry, TVars>;
+  createBatch: (input: StepInput<WorkflowScenarioCreateBatchStep<TRegistry, TVars>>) => WorkflowScenarioCreateBatchStep<TRegistry, TVars>;
+  event: (input: StepInput<WorkflowScenarioSendEventStep<TRegistry, TVars>>) => WorkflowScenarioSendEventStep<TRegistry, TVars>;
+  eventAndRunUntilIdle: (input: StepInput<WorkflowScenarioEventAndRunUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioEventAndRunUntilIdleStep<TRegistry, TVars>;
+  pause: (input: StepInput<WorkflowScenarioPauseStep<TRegistry, TVars>>) => WorkflowScenarioPauseStep<TRegistry, TVars>;
+  resume: (input: StepInput<WorkflowScenarioResumeStep<TRegistry, TVars>>) => WorkflowScenarioResumeStep<TRegistry, TVars>;
+  resumeAndRunUntilIdle: (input: StepInput<WorkflowScenarioResumeAndRunUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioResumeAndRunUntilIdleStep<TRegistry, TVars>;
+  terminate: (input: StepInput<WorkflowScenarioTerminateStep<TRegistry, TVars>>) => WorkflowScenarioTerminateStep<TRegistry, TVars>;
+  restart: (input: StepInput<WorkflowScenarioRestartStep<TRegistry, TVars>>) => WorkflowScenarioRestartStep<TRegistry, TVars>;
+  runCreateUntilIdle: (input: StepInput<WorkflowScenarioRunCreateUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioRunCreateUntilIdleStep<TRegistry, TVars>;
+  runResumeUntilIdle: (input: StepInput<WorkflowScenarioRunResumeUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioRunResumeUntilIdleStep<TRegistry, TVars>;
+  retryAndRunUntilIdle: (input: StepInput<WorkflowScenarioRetryAndRunUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioRetryAndRunUntilIdleStep<TRegistry, TVars>;
+  tick: (input: StepInput<WorkflowScenarioTickStep<TRegistry, TVars>>) => WorkflowScenarioTickStep<TRegistry, TVars>;
+  runUntilIdle: (input: StepInput<WorkflowScenarioRunUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioRunUntilIdleStep<TRegistry, TVars>;
+  advanceTimeAndRunUntilIdle: (input: StepInput<WorkflowScenarioAdvanceTimeAndRunUntilIdleStep<TRegistry, TVars>>) => WorkflowScenarioAdvanceTimeAndRunUntilIdleStep<TRegistry, TVars>;
+  read: (input: StepInput<WorkflowScenarioReadStep<TRegistry, TVars>>) => WorkflowScenarioReadStep<TRegistry, TVars>;
+  assert: (assert: WorkflowScenarioAssertStep<TRegistry, TVars>["assert"]) => WorkflowScenarioAssertStep<TRegistry, TVars>;
+};
+declare const steps: {
+  create: (input: StepInput<WorkflowScenarioCreateStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioCreateStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  initializeAndRunUntilIdle: (input: StepInput<WorkflowScenarioInitializeAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioInitializeAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  createBatch: (input: StepInput<WorkflowScenarioCreateBatchStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioCreateBatchStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  event: (input: StepInput<WorkflowScenarioSendEventStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioSendEventStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  eventAndRunUntilIdle: (input: StepInput<WorkflowScenarioEventAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioEventAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  pause: (input: StepInput<WorkflowScenarioPauseStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioPauseStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  resume: (input: StepInput<WorkflowScenarioResumeStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioResumeStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  resumeAndRunUntilIdle: (input: StepInput<WorkflowScenarioResumeAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioResumeAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  terminate: (input: StepInput<WorkflowScenarioTerminateStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioTerminateStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  restart: (input: StepInput<WorkflowScenarioRestartStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioRestartStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  runCreateUntilIdle: (input: StepInput<WorkflowScenarioRunCreateUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioRunCreateUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  runResumeUntilIdle: (input: StepInput<WorkflowScenarioRunResumeUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioRunResumeUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  retryAndRunUntilIdle: (input: StepInput<WorkflowScenarioRetryAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioRetryAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  tick: (input: StepInput<WorkflowScenarioTickStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioTickStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  runUntilIdle: (input: StepInput<WorkflowScenarioRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  advanceTimeAndRunUntilIdle: (input: StepInput<WorkflowScenarioAdvanceTimeAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioAdvanceTimeAndRunUntilIdleStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  read: (input: StepInput<WorkflowScenarioReadStep<WorkflowsRegistry, WorkflowScenarioVars>>) => WorkflowScenarioReadStep<WorkflowsRegistry, WorkflowScenarioVars>;
+  assert: (assert: (ctx: WorkflowScenarioContext<WorkflowsRegistry, WorkflowScenarioVars>) => void | Promise<void>) => WorkflowScenarioAssertStep<WorkflowsRegistry, WorkflowScenarioVars>;
+};
+declare function runScenario<TRegistry extends WorkflowsRegistry, TVars extends WorkflowScenarioVars>(scenario: WorkflowScenarioDefinition<TRegistry, TVars>): Promise<WorkflowScenarioResult<TVars>>;
+//#endregion
+export { WorkflowScenarioAdvanceTimeAndRunUntilIdleStep, WorkflowScenarioAssertStep, WorkflowScenarioContext, WorkflowScenarioCreateBatchStep, WorkflowScenarioCreateStep, WorkflowScenarioDefinition, WorkflowScenarioEventAndRunUntilIdleStep, WorkflowScenarioEventRow, WorkflowScenarioHarnessOptions, WorkflowScenarioHookRow, WorkflowScenarioInitializeAndRunUntilIdleStep, WorkflowScenarioInstanceRow, WorkflowScenarioPauseStep, WorkflowScenarioReadStep, WorkflowScenarioRestartStep, WorkflowScenarioResult, WorkflowScenarioResumeAndRunUntilIdleStep, WorkflowScenarioResumeStep, WorkflowScenarioRetryAndRunUntilIdleStep, WorkflowScenarioRouteResponse, WorkflowScenarioRunCreateUntilIdleStep, WorkflowScenarioRunResumeUntilIdleStep, WorkflowScenarioRunUntilIdleStep, WorkflowScenarioSendEventStep, WorkflowScenarioState, WorkflowScenarioStateInternalUtils, WorkflowScenarioStep, WorkflowScenarioStepRow, WorkflowScenarioTerminateStep, WorkflowScenarioTickStep, WorkflowScenarioVars, createScenarioSteps, defineScenario, runScenario, steps };
+//# sourceMappingURL=scenario.d.ts.map