@rivetkit/workflow-engine 2.1.6 → 2.1.8

package/dist/tsup/index.d.cts

@@ -249,6 +249,43 @@ interface WorkflowError {
     /** Custom error properties (for structured errors) */
     metadata?: Record<string, unknown>;
 }
+/**
+ * Error event emitted while a workflow is running.
+ */
+interface WorkflowStepErrorEvent {
+    workflowId: string;
+    stepName: string;
+    attempt: number;
+    maxRetries: number;
+    remainingRetries: number;
+    willRetry: boolean;
+    retryDelay?: number;
+    retryAt?: number;
+    error: WorkflowError;
+}
+/**
+ * Error event emitted when a rollback handler fails.
+ */
+interface WorkflowRollbackErrorEvent {
+    workflowId: string;
+    stepName: string;
+    error: WorkflowError;
+}
+/**
+ * Error event emitted for workflow-level failures outside individual steps.
+ */
+interface WorkflowRunErrorEvent {
+    workflowId: string;
+    error: WorkflowError;
+}
+type WorkflowErrorEvent = {
+    step: WorkflowStepErrorEvent;
+} | {
+    rollback: WorkflowRollbackErrorEvent;
+} | {
+    workflow: WorkflowRunErrorEvent;
+};
+type WorkflowErrorHandler = (event: WorkflowErrorEvent) => void | Promise<void>;
 /**
  * Complete storage state for a workflow.
  */
@@ -333,11 +370,10 @@ interface LoopConfig<S, T> {
     name: string;
     state?: S;
     run: (ctx: WorkflowContextInterface, state: S) => LoopIterationResult<S, T>;
-    commitInterval?: number;
-    /** Trim loop history every N iterations. Defaults to commitInterval or 20. */
-    historyEvery?: number;
-    /** Retain the last N iterations of history. Defaults to commitInterval or 20. */
-    historyKeep?: number;
+    /** Prune old loop iterations every N iterations. Default: 20. */
+    historyPruneInterval?: number;
+    /** Number of past iterations to retain when pruning. Defaults to historyPruneInterval. */
+    historySize?: number;
 }
 /**
  * Configuration for a branch in join/race.
@@ -384,6 +420,7 @@ interface RunWorkflowOptions {
     mode?: WorkflowRunMode;
     logger?: Logger;
     onHistoryUpdated?: (history: WorkflowHistorySnapshot) => void;
+    onError?: WorkflowErrorHandler;
 }
 type WorkflowFunction<TInput = unknown, TOutput = unknown> = (ctx: WorkflowContextInterface, input: TInput) => Promise<TOutput>;
 /**
@@ -489,6 +526,10 @@ interface EngineDriver {
      * Delete all keys with a given prefix.
      */
     deletePrefix(prefix: Uint8Array): Promise<void>;
+    /**
+     * Delete all keys in the half-open range [start, end).
+     */
+    deleteRange(start: Uint8Array, end: Uint8Array): Promise<void>;
     /**
      * List all key-value pairs with a given prefix.
      *
@@ -534,9 +575,7 @@ interface EngineDriver {
 declare const DEFAULT_MAX_RETRIES = 3;
 declare const DEFAULT_RETRY_BACKOFF_BASE = 100;
 declare const DEFAULT_RETRY_BACKOFF_MAX = 30000;
-declare const DEFAULT_LOOP_COMMIT_INTERVAL = 20;
-declare const DEFAULT_LOOP_HISTORY_EVERY = 20;
-declare const DEFAULT_LOOP_HISTORY_KEEP = 20;
+declare const DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = 20;
 declare const DEFAULT_STEP_TIMEOUT = 30000;
 /**
  * Internal representation of a rollback handler.
@@ -566,8 +605,9 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private usedNamesInExecution;
     private pendingCompletableMessageIds;
     private historyNotifier?;
+    private onError?;
     private logger?;
-    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, logger?: Logger);
+    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, onError?: WorkflowErrorHandler, logger?: Logger, visitedKeys?: Set<string>);
     get abortSignal(): AbortSignal;
     get queue(): WorkflowQueue;
     isEvicted(): boolean;
@@ -582,6 +622,8 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
      * Log a debug message using the configured logger.
      */
     private log;
+    private notifyError;
+    private notifyStepError;
     /**
      * Mark a key as visited.
      */
@@ -639,20 +681,18 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     loop<S, T>(nameOrConfig: string | LoopConfig<S, T>, run?: (ctx: WorkflowContextInterface) => LoopIterationResult<undefined, T>): Promise<T>;
     private executeLoop;
     /**
-     * Delete old loop iteration entries to save storage space.
-     *
-     * Loop locations always end with a NameIndex (number) because loops are
-     * created via appendName(). Even for nested loops, the innermost loop's
-     * location ends with its name index:
+     * Collect pending deletions for loop history pruning.
      *
-     *   ctx.loop("outer") → location: [outerIndex]
-     *     iteration 0    → location: [{ loop: outerIndex, iteration: 0 }]
-     *       ctx.loop("inner") → location: [{ loop: outerIndex, iteration: 0 }, innerIndex]
-     *
-     * This function removes iterations older than (currentIteration - historyKeep)
-     * every historyEvery iterations.
+     * Only deletes iterations in the range [fromIteration, keepFrom) where
+     * keepFrom = currentIteration - historySize. This avoids re-scanning
+     * already-deleted iterations.
      */
-    private forgetOldIterations;
+    private collectLoopPruning;
+    /**
+     * Flush storage with optional pending deletions so pruning
+     * happens alongside the state write.
+     */
+    private flushStorageWithDeletions;
     sleep(name: string, durationMs: number): Promise<void>;
     sleepUntil(name: string, timestampMs: number): Promise<void>;
     private executeSleep;
@@ -757,7 +797,8 @@ declare class StepFailedError extends Error {
     readonly stepName: string;
     readonly originalError: unknown;
     readonly attempts: number;
-    constructor(stepName: string, originalError: unknown, attempts: number);
+    readonly retryAt: number;
+    constructor(stepName: string, originalError: unknown, attempts: number, retryAt: number);
 }
 /**
  * Join had branch failures.
@@ -793,6 +834,11 @@ declare class EntryInProgressError extends Error {
     constructor();
 }
 
+/**
+ * Extract structured error information from an error.
+ */
+declare function extractErrorInfo(error: unknown): WorkflowError;
+
 /**
  * Check if a path segment is a loop iteration marker.
  */
@@ -865,9 +911,23 @@ declare function loadStorage(driver: EngineDriver): Promise<Storage>;
  */
 declare function loadMetadata(storage: Storage, driver: EngineDriver, entryId: string): Promise<EntryMetadata>;
 /**
- * Flush all dirty data to the driver.
+ * Pending deletions collected by collectLoopPruning to be included
+ * in the next flush alongside the state write.
+ */
+interface PendingDeletions {
+    prefixes: Uint8Array[];
+    keys: Uint8Array[];
+    ranges: {
+        start: Uint8Array;
+        end: Uint8Array;
+    }[];
+}
+/**
+ * Flush all dirty data to the driver. Optionally includes pending
+ * deletions so that history pruning happens alongside the
+ * state write.
  */
-declare function flush(storage: Storage, driver: EngineDriver, onHistoryUpdated?: () => void): Promise<void>;
+declare function flush(storage: Storage, driver: EngineDriver, onHistoryUpdated?: () => void, pendingDeletions?: PendingDeletions): Promise<void>;
 /**
  * Delete entries with a given location prefix (used for loop forgetting).
  * Also cleans up associated metadata from both memory and driver.
@@ -894,5 +954,13 @@ declare const Loop: {
 };
 
 declare function runWorkflow<TInput, TOutput>(workflowId: string, workflowFn: WorkflowFunction<TInput, TOutput>, input: TInput, driver: EngineDriver, options?: RunWorkflowOptions): WorkflowHandle<TOutput>;
+/**
+ * Remove a step and every later workflow entry, then schedule the workflow to
+ * start again immediately. Omitting `entryId` replays the workflow from the
+ * beginning.
+ */
+declare function replayWorkflowFromStep(workflowId: string, driver: EngineDriver, entryId?: string, options?: {
+    scheduleAlarm?: boolean;
+}): Promise<WorkflowHistorySnapshot>;
 
-export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_COMMIT_INTERVAL, DEFAULT_LOOP_HISTORY_EVERY, DEFAULT_LOOP_HISTORY_KEEP, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRunMode, type WorkflowState, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, resolveName, runWorkflow, setEntry };
+export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowError, type WorkflowErrorEvent, type WorkflowErrorHandler, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRollbackErrorEvent, type WorkflowRunErrorEvent, type WorkflowRunMode, type WorkflowState, type WorkflowStepErrorEvent, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry };

package/dist/tsup/index.d.ts

@@ -249,6 +249,43 @@ interface WorkflowError {
     /** Custom error properties (for structured errors) */
     metadata?: Record<string, unknown>;
 }
+/**
+ * Error event emitted while a workflow is running.
+ */
+interface WorkflowStepErrorEvent {
+    workflowId: string;
+    stepName: string;
+    attempt: number;
+    maxRetries: number;
+    remainingRetries: number;
+    willRetry: boolean;
+    retryDelay?: number;
+    retryAt?: number;
+    error: WorkflowError;
+}
+/**
+ * Error event emitted when a rollback handler fails.
+ */
+interface WorkflowRollbackErrorEvent {
+    workflowId: string;
+    stepName: string;
+    error: WorkflowError;
+}
+/**
+ * Error event emitted for workflow-level failures outside individual steps.
+ */
+interface WorkflowRunErrorEvent {
+    workflowId: string;
+    error: WorkflowError;
+}
+type WorkflowErrorEvent = {
+    step: WorkflowStepErrorEvent;
+} | {
+    rollback: WorkflowRollbackErrorEvent;
+} | {
+    workflow: WorkflowRunErrorEvent;
+};
+type WorkflowErrorHandler = (event: WorkflowErrorEvent) => void | Promise<void>;
 /**
  * Complete storage state for a workflow.
  */
@@ -333,11 +370,10 @@ interface LoopConfig<S, T> {
     name: string;
     state?: S;
     run: (ctx: WorkflowContextInterface, state: S) => LoopIterationResult<S, T>;
-    commitInterval?: number;
-    /** Trim loop history every N iterations. Defaults to commitInterval or 20. */
-    historyEvery?: number;
-    /** Retain the last N iterations of history. Defaults to commitInterval or 20. */
-    historyKeep?: number;
+    /** Prune old loop iterations every N iterations. Default: 20. */
+    historyPruneInterval?: number;
+    /** Number of past iterations to retain when pruning. Defaults to historyPruneInterval. */
+    historySize?: number;
 }
 /**
  * Configuration for a branch in join/race.
@@ -384,6 +420,7 @@ interface RunWorkflowOptions {
     mode?: WorkflowRunMode;
     logger?: Logger;
     onHistoryUpdated?: (history: WorkflowHistorySnapshot) => void;
+    onError?: WorkflowErrorHandler;
 }
 type WorkflowFunction<TInput = unknown, TOutput = unknown> = (ctx: WorkflowContextInterface, input: TInput) => Promise<TOutput>;
 /**
@@ -489,6 +526,10 @@ interface EngineDriver {
      * Delete all keys with a given prefix.
      */
     deletePrefix(prefix: Uint8Array): Promise<void>;
+    /**
+     * Delete all keys in the half-open range [start, end).
+     */
+    deleteRange(start: Uint8Array, end: Uint8Array): Promise<void>;
     /**
      * List all key-value pairs with a given prefix.
      *
@@ -534,9 +575,7 @@ interface EngineDriver {
 declare const DEFAULT_MAX_RETRIES = 3;
 declare const DEFAULT_RETRY_BACKOFF_BASE = 100;
 declare const DEFAULT_RETRY_BACKOFF_MAX = 30000;
-declare const DEFAULT_LOOP_COMMIT_INTERVAL = 20;
-declare const DEFAULT_LOOP_HISTORY_EVERY = 20;
-declare const DEFAULT_LOOP_HISTORY_KEEP = 20;
+declare const DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = 20;
 declare const DEFAULT_STEP_TIMEOUT = 30000;
 /**
  * Internal representation of a rollback handler.
@@ -566,8 +605,9 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private usedNamesInExecution;
     private pendingCompletableMessageIds;
     private historyNotifier?;
+    private onError?;
     private logger?;
-    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, logger?: Logger);
+    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, onError?: WorkflowErrorHandler, logger?: Logger, visitedKeys?: Set<string>);
     get abortSignal(): AbortSignal;
     get queue(): WorkflowQueue;
     isEvicted(): boolean;
@@ -582,6 +622,8 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
      * Log a debug message using the configured logger.
      */
     private log;
+    private notifyError;
+    private notifyStepError;
     /**
      * Mark a key as visited.
      */
@@ -639,20 +681,18 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     loop<S, T>(nameOrConfig: string | LoopConfig<S, T>, run?: (ctx: WorkflowContextInterface) => LoopIterationResult<undefined, T>): Promise<T>;
     private executeLoop;
     /**
-     * Delete old loop iteration entries to save storage space.
-     *
-     * Loop locations always end with a NameIndex (number) because loops are
-     * created via appendName(). Even for nested loops, the innermost loop's
-     * location ends with its name index:
+     * Collect pending deletions for loop history pruning.
      *
-     *   ctx.loop("outer") → location: [outerIndex]
-     *     iteration 0    → location: [{ loop: outerIndex, iteration: 0 }]
-     *       ctx.loop("inner") → location: [{ loop: outerIndex, iteration: 0 }, innerIndex]
-     *
-     * This function removes iterations older than (currentIteration - historyKeep)
-     * every historyEvery iterations.
+     * Only deletes iterations in the range [fromIteration, keepFrom) where
+     * keepFrom = currentIteration - historySize. This avoids re-scanning
+     * already-deleted iterations.
      */
-    private forgetOldIterations;
+    private collectLoopPruning;
+    /**
+     * Flush storage with optional pending deletions so pruning
+     * happens alongside the state write.
+     */
+    private flushStorageWithDeletions;
     sleep(name: string, durationMs: number): Promise<void>;
     sleepUntil(name: string, timestampMs: number): Promise<void>;
     private executeSleep;
@@ -757,7 +797,8 @@ declare class StepFailedError extends Error {
     readonly stepName: string;
     readonly originalError: unknown;
     readonly attempts: number;
-    constructor(stepName: string, originalError: unknown, attempts: number);
+    readonly retryAt: number;
+    constructor(stepName: string, originalError: unknown, attempts: number, retryAt: number);
 }
 /**
  * Join had branch failures.
@@ -793,6 +834,11 @@ declare class EntryInProgressError extends Error {
     constructor();
 }
 
+/**
+ * Extract structured error information from an error.
+ */
+declare function extractErrorInfo(error: unknown): WorkflowError;
+
 /**
  * Check if a path segment is a loop iteration marker.
  */
@@ -865,9 +911,23 @@ declare function loadStorage(driver: EngineDriver): Promise<Storage>;
  */
 declare function loadMetadata(storage: Storage, driver: EngineDriver, entryId: string): Promise<EntryMetadata>;
 /**
- * Flush all dirty data to the driver.
+ * Pending deletions collected by collectLoopPruning to be included
+ * in the next flush alongside the state write.
+ */
+interface PendingDeletions {
+    prefixes: Uint8Array[];
+    keys: Uint8Array[];
+    ranges: {
+        start: Uint8Array;
+        end: Uint8Array;
+    }[];
+}
+/**
+ * Flush all dirty data to the driver. Optionally includes pending
+ * deletions so that history pruning happens alongside the
+ * state write.
  */
-declare function flush(storage: Storage, driver: EngineDriver, onHistoryUpdated?: () => void): Promise<void>;
+declare function flush(storage: Storage, driver: EngineDriver, onHistoryUpdated?: () => void, pendingDeletions?: PendingDeletions): Promise<void>;
 /**
  * Delete entries with a given location prefix (used for loop forgetting).
  * Also cleans up associated metadata from both memory and driver.
@@ -894,5 +954,13 @@ declare const Loop: {
 };
 
 declare function runWorkflow<TInput, TOutput>(workflowId: string, workflowFn: WorkflowFunction<TInput, TOutput>, input: TInput, driver: EngineDriver, options?: RunWorkflowOptions): WorkflowHandle<TOutput>;
+/**
+ * Remove a step and every later workflow entry, then schedule the workflow to
+ * start again immediately. Omitting `entryId` replays the workflow from the
+ * beginning.
+ */
+declare function replayWorkflowFromStep(workflowId: string, driver: EngineDriver, entryId?: string, options?: {
+    scheduleAlarm?: boolean;
+}): Promise<WorkflowHistorySnapshot>;
 
-export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_COMMIT_INTERVAL, DEFAULT_LOOP_HISTORY_EVERY, DEFAULT_LOOP_HISTORY_KEEP, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRunMode, type WorkflowState, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, resolveName, runWorkflow, setEntry };
+export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowError, type WorkflowErrorEvent, type WorkflowErrorHandler, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRollbackErrorEvent, type WorkflowRunErrorEvent, type WorkflowRunMode, type WorkflowState, type WorkflowStepErrorEvent, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry };

package/dist/tsup/index.js

@@ -1,9 +1,7 @@
 import {
   CancelledError,
   CriticalError,
-  DEFAULT_LOOP_COMMIT_INTERVAL,
-  DEFAULT_LOOP_HISTORY_EVERY,
-  DEFAULT_LOOP_HISTORY_KEEP,
+  DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL,
   DEFAULT_MAX_RETRIES,
   DEFAULT_RETRY_BACKOFF_BASE,
   DEFAULT_RETRY_BACKOFF_MAX,
@@ -28,6 +26,7 @@ import {
   createStorage,
   deleteEntriesWithPrefix,
   emptyLocation,
+  extractErrorInfo,
   flush,
   generateId,
   getEntry,
@@ -40,16 +39,15 @@ import {
   locationsEqual,
   parentLocation,
   registerName,
+  replayWorkflowFromStep,
   resolveName,
   runWorkflow,
   setEntry
-} from "./chunk-JTLDEP6X.js";
+} from "./chunk-4ME2JBMC.js";
 export {
   CancelledError,
   CriticalError,
-  DEFAULT_LOOP_COMMIT_INTERVAL,
-  DEFAULT_LOOP_HISTORY_EVERY,
-  DEFAULT_LOOP_HISTORY_KEEP,
+  DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL,
   DEFAULT_MAX_RETRIES,
   DEFAULT_RETRY_BACKOFF_BASE,
   DEFAULT_RETRY_BACKOFF_MAX,
@@ -74,6 +72,7 @@ export {
   createStorage,
   deleteEntriesWithPrefix,
   emptyLocation,
+  extractErrorInfo,
   flush,
   generateId,
   getEntry,
@@ -86,6 +85,7 @@ export {
   locationsEqual,
   parentLocation,
   registerName,
+  replayWorkflowFromStep,
   resolveName,
   runWorkflow,
   setEntry

package/dist/tsup/testing.cjs

@@ -47,7 +47,7 @@
 
 
 
-var _chunkKQO2TD7Tcjs = require('./chunk-KQO2TD7T.cjs');
+var _chunkOYYWSC77cjs = require('./chunk-OYYWSC77.cjs');
 
 // src/testing.ts
 var InMemoryWorkflowMessageDriver = class {
@@ -88,14 +88,16 @@ var InMemoryWorkflowMessageDriver = class {
     });
   }
   async completeMessage(messageId) {
-    const index = this.#messages.findIndex((message) => message.id === messageId);
+    const index = this.#messages.findIndex(
+      (message) => message.id === messageId
+    );
     if (index !== -1) {
       this.#messages.splice(index, 1);
     }
   }
   async waitForMessages(messageNames, abortSignal) {
     if (abortSignal.aborted) {
-      throw new (0, _chunkKQO2TD7Tcjs.EvictedError)();
+      throw new (0, _chunkOYYWSC77cjs.EvictedError)();
     }
     const nameSet = messageNames.length > 0 ? new Set(messageNames) : void 0;
     if (this.#messages.some(
@@ -116,10 +118,12 @@ var InMemoryWorkflowMessageDriver = class {
         },
         abortSignal,
         onAbort: () => {
-          waiter.reject(new (0, _chunkKQO2TD7Tcjs.EvictedError)());
+          waiter.reject(new (0, _chunkOYYWSC77cjs.EvictedError)());
         }
       };
-      abortSignal.addEventListener("abort", waiter.onAbort, { once: true });
+      abortSignal.addEventListener("abort", waiter.onAbort, {
+        once: true
+      });
       this.#waiters.add(waiter);
     });
   }
@@ -154,48 +158,56 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
   __init4() {this.workerPollInterval = 100}
   __init5() {this.messageDriver = this.#inMemoryMessageDriver}
   async get(key) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
-    const entry = this.kv.get(_chunkKQO2TD7Tcjs.keyToHex.call(void 0, key));
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
+    const entry = this.kv.get(_chunkOYYWSC77cjs.keyToHex.call(void 0, key));
     return _nullishCoalesce((entry == null ? void 0 : entry.value), () => ( null));
   }
   async set(key, value) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
-    this.kv.set(_chunkKQO2TD7Tcjs.keyToHex.call(void 0, key), { key, value });
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
+    this.kv.set(_chunkOYYWSC77cjs.keyToHex.call(void 0, key), { key, value });
   }
   async delete(key) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
-    this.kv.delete(_chunkKQO2TD7Tcjs.keyToHex.call(void 0, key));
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
+    this.kv.delete(_chunkOYYWSC77cjs.keyToHex.call(void 0, key));
   }
   async deletePrefix(prefix) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
+    for (const [hexKey, entry] of this.kv) {
+      if (_chunkOYYWSC77cjs.keyStartsWith.call(void 0, entry.key, prefix)) {
+        this.kv.delete(hexKey);
+      }
+    }
+  }
+  async deleteRange(start, end) {
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
     for (const [hexKey, entry] of this.kv) {
-      if (_chunkKQO2TD7Tcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
+      if (_chunkOYYWSC77cjs.compareKeys.call(void 0, entry.key, start) >= 0 && _chunkOYYWSC77cjs.compareKeys.call(void 0, entry.key, end) < 0) {
         this.kv.delete(hexKey);
       }
     }
   }
   async list(prefix) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
     const results = [];
     for (const entry of this.kv.values()) {
-      if (_chunkKQO2TD7Tcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
+      if (_chunkOYYWSC77cjs.keyStartsWith.call(void 0, entry.key, prefix)) {
         results.push({ key: entry.key, value: entry.value });
       }
     }
-    return results.sort((a, b) => _chunkKQO2TD7Tcjs.compareKeys.call(void 0, a.key, b.key));
+    return results.sort((a, b) => _chunkOYYWSC77cjs.compareKeys.call(void 0, a.key, b.key));
   }
   async batch(writes) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
     for (const { key, value } of writes) {
-      this.kv.set(_chunkKQO2TD7Tcjs.keyToHex.call(void 0, key), { key, value });
+      this.kv.set(_chunkOYYWSC77cjs.keyToHex.call(void 0, key), { key, value });
     }
   }
   async setAlarm(workflowId, wakeAt) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
     this.alarms.set(workflowId, wakeAt);
   }
   async clearAlarm(workflowId) {
-    await _chunkKQO2TD7Tcjs.sleep.call(void 0, this.latency);
+    await _chunkOYYWSC77cjs.sleep.call(void 0, this.latency);
     this.alarms.delete(workflowId);
   }
   async waitForMessages(messageNames, abortSignal) {
@@ -206,7 +218,7 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
     }
     while (true) {
       if (abortSignal.aborted) {
-        throw new (0, _chunkKQO2TD7Tcjs.EvictedError)();
+        throw new (0, _chunkOYYWSC77cjs.EvictedError)();
       }
       const messages = await this.messageDriver.receiveMessages({
         names: messageNames.length > 0 ? messageNames : void 0,
@@ -216,7 +228,7 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
       if (messages.length > 0) {
         return;
       }
-      await _chunkKQO2TD7Tcjs.sleep.call(void 0, Math.max(1, this.latency));
+      await _chunkOYYWSC77cjs.sleep.call(void 0, Math.max(1, this.latency));
     }
   }
   /**
@@ -312,5 +324,5 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
 
 
 
-exports.CancelledError = _chunkKQO2TD7Tcjs.CancelledError; exports.CriticalError = _chunkKQO2TD7Tcjs.CriticalError; exports.DEFAULT_LOOP_COMMIT_INTERVAL = _chunkKQO2TD7Tcjs.DEFAULT_LOOP_COMMIT_INTERVAL; exports.DEFAULT_LOOP_HISTORY_EVERY = _chunkKQO2TD7Tcjs.DEFAULT_LOOP_HISTORY_EVERY; exports.DEFAULT_LOOP_HISTORY_KEEP = _chunkKQO2TD7Tcjs.DEFAULT_LOOP_HISTORY_KEEP; exports.DEFAULT_MAX_RETRIES = _chunkKQO2TD7Tcjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkKQO2TD7Tcjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkKQO2TD7Tcjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkKQO2TD7Tcjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkKQO2TD7Tcjs.EntryInProgressError; exports.EvictedError = _chunkKQO2TD7Tcjs.EvictedError; exports.HistoryDivergedError = _chunkKQO2TD7Tcjs.HistoryDivergedError; exports.InMemoryDriver = InMemoryDriver; exports.JoinError = _chunkKQO2TD7Tcjs.JoinError; exports.Loop = _chunkKQO2TD7Tcjs.Loop; exports.MessageWaitError = _chunkKQO2TD7Tcjs.MessageWaitError; exports.RaceError = _chunkKQO2TD7Tcjs.RaceError; exports.RollbackCheckpointError = _chunkKQO2TD7Tcjs.RollbackCheckpointError; exports.RollbackError = _chunkKQO2TD7Tcjs.RollbackError; exports.SleepError = _chunkKQO2TD7Tcjs.SleepError; exports.StepExhaustedError = _chunkKQO2TD7Tcjs.StepExhaustedError; exports.StepFailedError = _chunkKQO2TD7Tcjs.StepFailedError; exports.WorkflowContextImpl = _chunkKQO2TD7Tcjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkKQO2TD7Tcjs.appendLoopIteration; exports.appendName = _chunkKQO2TD7Tcjs.appendName; exports.createEntry = _chunkKQO2TD7Tcjs.createEntry; exports.createHistorySnapshot = _chunkKQO2TD7Tcjs.createHistorySnapshot; exports.createStorage = _chunkKQO2TD7Tcjs.createStorage; exports.deleteEntriesWithPrefix = _chunkKQO2TD7Tcjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkKQO2TD7Tcjs.emptyLocation; exports.flush = _chunkKQO2TD7Tcjs.flush; exports.generateId = _chunkKQO2TD7Tcjs.generateId; exports.getEntry = _chunkKQO2TD7Tcjs.getEntry; exports.getOrCreateMetadata = _chunkKQO2TD7Tcjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkKQO2TD7Tcjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkKQO2TD7Tcjs.isLoopIterationMarker; exports.loadMetadata = _chunkKQO2TD7Tcjs.loadMetadata; exports.loadStorage = _chunkKQO2TD7Tcjs.loadStorage; exports.locationToKey = _chunkKQO2TD7Tcjs.locationToKey; exports.locationsEqual = _chunkKQO2TD7Tcjs.locationsEqual; exports.parentLocation = _chunkKQO2TD7Tcjs.parentLocation; exports.registerName = _chunkKQO2TD7Tcjs.registerName; exports.resolveName = _chunkKQO2TD7Tcjs.resolveName; exports.runWorkflow = _chunkKQO2TD7Tcjs.runWorkflow; exports.setEntry = _chunkKQO2TD7Tcjs.setEntry;
+exports.CancelledError = _chunkOYYWSC77cjs.CancelledError; exports.CriticalError = _chunkOYYWSC77cjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunkOYYWSC77cjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunkOYYWSC77cjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkOYYWSC77cjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkOYYWSC77cjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkOYYWSC77cjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkOYYWSC77cjs.EntryInProgressError; exports.EvictedError = _chunkOYYWSC77cjs.EvictedError; exports.HistoryDivergedError = _chunkOYYWSC77cjs.HistoryDivergedError; exports.InMemoryDriver = InMemoryDriver; exports.JoinError = _chunkOYYWSC77cjs.JoinError; exports.Loop = _chunkOYYWSC77cjs.Loop; exports.MessageWaitError = _chunkOYYWSC77cjs.MessageWaitError; exports.RaceError = _chunkOYYWSC77cjs.RaceError; exports.RollbackCheckpointError = _chunkOYYWSC77cjs.RollbackCheckpointError; exports.RollbackError = _chunkOYYWSC77cjs.RollbackError; exports.SleepError = _chunkOYYWSC77cjs.SleepError; exports.StepExhaustedError = _chunkOYYWSC77cjs.StepExhaustedError; exports.StepFailedError = _chunkOYYWSC77cjs.StepFailedError; exports.WorkflowContextImpl = _chunkOYYWSC77cjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkOYYWSC77cjs.appendLoopIteration; exports.appendName = _chunkOYYWSC77cjs.appendName; exports.createEntry = _chunkOYYWSC77cjs.createEntry; exports.createHistorySnapshot = _chunkOYYWSC77cjs.createHistorySnapshot; exports.createStorage = _chunkOYYWSC77cjs.createStorage; exports.deleteEntriesWithPrefix = _chunkOYYWSC77cjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkOYYWSC77cjs.emptyLocation; exports.extractErrorInfo = _chunkOYYWSC77cjs.extractErrorInfo; exports.flush = _chunkOYYWSC77cjs.flush; exports.generateId = _chunkOYYWSC77cjs.generateId; exports.getEntry = _chunkOYYWSC77cjs.getEntry; exports.getOrCreateMetadata = _chunkOYYWSC77cjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkOYYWSC77cjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkOYYWSC77cjs.isLoopIterationMarker; exports.loadMetadata = _chunkOYYWSC77cjs.loadMetadata; exports.loadStorage = _chunkOYYWSC77cjs.loadStorage; exports.locationToKey = _chunkOYYWSC77cjs.locationToKey; exports.locationsEqual = _chunkOYYWSC77cjs.locationsEqual; exports.parentLocation = _chunkOYYWSC77cjs.parentLocation; exports.registerName = _chunkOYYWSC77cjs.registerName; exports.replayWorkflowFromStep = _chunkOYYWSC77cjs.replayWorkflowFromStep; exports.resolveName = _chunkOYYWSC77cjs.resolveName; exports.runWorkflow = _chunkOYYWSC77cjs.runWorkflow; exports.setEntry = _chunkOYYWSC77cjs.setEntry;
 //# sourceMappingURL=testing.cjs.map