@multiplier-labs/stepflow 0.3.1 → 0.3.3

package/dist/storage/index.d.ts

@@ -1,8 +1,8 @@
-import { i as StorageAdapter, j as WorkflowRunRecord, d as ListRunsOptions, P as PaginatedResult, k as WorkflowRunStepRecord, W as WorkflowEventRecord, L as ListEventsOptions, C as CreateRunInput, U as UpdateRunInput, e as StepResult } from '../types-BlwFEGzj.js';
-export { E as ExtendedListRunsOptions, a as ExtendedRunStatus, b as ExtendedStepStatus, c as ExtendedWorkflowRunRecord, S as StepRecord, f as StepflowDatabase, g as StepflowRunsTable, h as StepflowStepResultsTable, l as WorkflowStorage } from '../types-BlwFEGzj.js';
+import { i as StorageAdapter, j as WorkflowRunRecord, d as ListRunsOptions, P as PaginatedResult, k as WorkflowRunStepRecord, W as WorkflowEventRecord, L as ListEventsOptions, C as CreateRunInput, U as UpdateRunInput, e as StepResult } from '../types-DSEjiLMj.js';
+export { E as ExtendedListRunsOptions, a as ExtendedRunStatus, b as ExtendedStepStatus, c as ExtendedWorkflowRunRecord, S as StepRecord, f as StepflowDatabase, g as StepflowRunsTable, h as StepflowStepResultsTable, l as WorkflowStorage } from '../types-DSEjiLMj.js';
 import Database from 'better-sqlite3';
 import { Pool, PoolConfig } from 'pg';
-import '../types-BVShq7zT.js';
+import '../types-K5Gjk3H_.js';
 
 /**
  * In-memory storage adapter for development and testing.
@@ -30,7 +30,7 @@ declare class MemoryStorageAdapter implements StorageAdapter {
     private steps;
     private events;
     /** Create and persist a new workflow run record. */
-    createRun(run: Omit<WorkflowRunRecord, "id" | "createdAt">): Promise<WorkflowRunRecord>;
+    createRun(run: Omit<WorkflowRunRecord, 'id' | 'createdAt'>): Promise<WorkflowRunRecord>;
     /** Retrieve a workflow run by ID, or null if not found. */
     getRun(runId: string): Promise<WorkflowRunRecord | null>;
     /** Apply partial updates to an existing workflow run. No-op if the run does not exist. */
@@ -38,7 +38,7 @@ declare class MemoryStorageAdapter implements StorageAdapter {
     /** List workflow runs with optional filtering, sorting, and pagination. */
     listRuns(options?: ListRunsOptions): Promise<PaginatedResult<WorkflowRunRecord>>;
     /** Create and persist a new step execution record. */
-    createStep(step: Omit<WorkflowRunStepRecord, "id">): Promise<WorkflowRunStepRecord>;
+    createStep(step: Omit<WorkflowRunStepRecord, 'id'>): Promise<WorkflowRunStepRecord>;
     /** Retrieve a step record by ID, or null if not found. */
     getStep(stepId: string): Promise<WorkflowRunStepRecord | null>;
     /** Apply partial updates to an existing step record. No-op if the step does not exist. */
@@ -46,7 +46,7 @@ declare class MemoryStorageAdapter implements StorageAdapter {
     /** Retrieve all step records for a workflow run, ordered by start time ascending. */
     getStepsForRun(runId: string): Promise<WorkflowRunStepRecord[]>;
     /** Persist a workflow event record. */
-    saveEvent(event: Omit<WorkflowEventRecord, "id">): Promise<void>;
+    saveEvent(event: Omit<WorkflowEventRecord, 'id'>): Promise<void>;
     /** Retrieve events for a workflow run with optional filtering and pagination. */
     getEventsForRun(runId: string, options?: ListEventsOptions): Promise<WorkflowEventRecord[]>;
     /** Delete runs (and their associated steps and events) created before the given date. Returns the number of deleted runs. */
@@ -124,15 +124,15 @@ declare class SQLiteStorageAdapter implements StorageAdapter {
      * Prepare all SQL statements for better performance.
      */
     private prepareStatements;
-    createRun(run: Omit<WorkflowRunRecord, "id" | "createdAt">): Promise<WorkflowRunRecord>;
+    createRun(run: Omit<WorkflowRunRecord, 'id' | 'createdAt'>): Promise<WorkflowRunRecord>;
     getRun(runId: string): Promise<WorkflowRunRecord | null>;
     updateRun(runId: string, updates: Partial<WorkflowRunRecord>): Promise<void>;
     listRuns(options?: ListRunsOptions): Promise<PaginatedResult<WorkflowRunRecord>>;
-    createStep(step: Omit<WorkflowRunStepRecord, "id">): Promise<WorkflowRunStepRecord>;
+    createStep(step: Omit<WorkflowRunStepRecord, 'id'>): Promise<WorkflowRunStepRecord>;
     getStep(stepId: string): Promise<WorkflowRunStepRecord | null>;
     updateStep(stepId: string, updates: Partial<WorkflowRunStepRecord>): Promise<void>;
     getStepsForRun(runId: string): Promise<WorkflowRunStepRecord[]>;
-    saveEvent(event: Omit<WorkflowEventRecord, "id">): Promise<void>;
+    saveEvent(event: Omit<WorkflowEventRecord, 'id'>): Promise<void>;
     getEventsForRun(runId: string, options?: ListEventsOptions): Promise<WorkflowEventRecord[]>;
     /**
      * Execute a function within a database transaction (async interface).
@@ -296,7 +296,7 @@ declare class PostgresStorageAdapter implements StorageAdapter {
      * Create a new workflow run.
      * Supports both legacy and new CreateRunInput interfaces.
      */
-    createRun(run: CreateRunInput | Omit<WorkflowRunRecord, "id" | "createdAt">): Promise<WorkflowRunRecord>;
+    createRun(run: CreateRunInput | Omit<WorkflowRunRecord, 'id' | 'createdAt'>): Promise<WorkflowRunRecord>;
     getRun(runId: string): Promise<WorkflowRunRecord | null>;
     /**
      * Update a workflow run.
@@ -312,11 +312,11 @@ declare class PostgresStorageAdapter implements StorageAdapter {
      */
     private applyRunsFilters;
     listRuns(options?: ListRunsOptions): Promise<PaginatedResult<WorkflowRunRecord>>;
-    createStep(step: Omit<WorkflowRunStepRecord, "id">): Promise<WorkflowRunStepRecord>;
+    createStep(step: Omit<WorkflowRunStepRecord, 'id'>): Promise<WorkflowRunStepRecord>;
     getStep(stepId: string): Promise<WorkflowRunStepRecord | null>;
     updateStep(stepId: string, updates: Partial<WorkflowRunStepRecord>): Promise<void>;
     getStepsForRun(runId: string): Promise<WorkflowRunStepRecord[]>;
-    saveEvent(event: Omit<WorkflowEventRecord, "id">): Promise<void>;
+    saveEvent(event: Omit<WorkflowEventRecord, 'id'>): Promise<void>;
     getEventsForRun(runId: string, options?: ListEventsOptions): Promise<WorkflowEventRecord[]>;
     /**
      * Execute a function within a database transaction.
@@ -386,7 +386,7 @@ declare class PostgresStorageAdapter implements StorageAdapter {
      * Save or update a step result.
      * Uses upsert to handle both new and existing results.
      */
-    saveStepResult(result: Omit<StepResult, "id"> & {
+    saveStepResult(result: Omit<StepResult, 'id'> & {
         id?: string;
     }): Promise<void>;
     /**

package/dist/storage/index.js

@@ -2,8 +2,8 @@ import {
   MemoryStorageAdapter,
   PostgresStorageAdapter,
   SQLiteStorageAdapter
-} from "../chunk-FQCT3I2A.js";
-import "../chunk-GXY66V7Q.js";
+} from "../chunk-4VOKMGP6.js";
+import "../chunk-ML35PIHX.js";
 export {
   MemoryStorageAdapter,
   PostgresStorageAdapter as PostgresStorage,

package/dist/{types-BlwFEGzj.d.ts → types-DSEjiLMj.d.ts}

@@ -1,4 +1,4 @@
-import { R as RunStatus, W as WorkflowKind, S as StepStatus, a as WorkflowError } from './types-BVShq7zT.js';
+import { R as RunStatus, W as WorkflowKind, S as StepStatus, a as WorkflowError } from './types-K5Gjk3H_.js';
 
 /**
  * Storage interface types for the workflow engine.
@@ -9,12 +9,12 @@ import { R as RunStatus, W as WorkflowKind, S as StepStatus, a as WorkflowError
  * Extended status of a workflow run.
  * Adds 'pending' and 'timeout' to the core statuses.
  */
-type ExtendedRunStatus = "pending" | "queued" | "running" | "succeeded" | "failed" | "canceled" | "timeout";
+type ExtendedRunStatus = 'pending' | 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' | 'timeout';
 /**
  * Extended status of a workflow step.
  * Uses 'completed' instead of 'succeeded' for consistency.
  */
-type ExtendedStepStatus = "pending" | "running" | "completed" | "failed" | "skipped" | "canceled";
+type ExtendedStepStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'canceled';
 /**
  * Stored representation of a workflow run.
  */
@@ -25,6 +25,7 @@ interface WorkflowRunRecord {
     parentRunId?: string;
     input: Record<string, unknown>;
     context: Record<string, unknown>;
+    completedSteps?: string[];
     output?: Record<string, unknown>;
     error?: {
         code: string;
@@ -60,7 +61,7 @@ interface WorkflowEventRecord {
     runId: string;
     stepKey?: string;
     eventType: string;
-    level: "info" | "warn" | "error";
+    level: 'info' | 'warn' | 'error';
     payload?: unknown;
     timestamp: Date;
 }
@@ -150,8 +151,8 @@ interface ListRunsOptions {
     parentRunId?: string;
     limit?: number;
     offset?: number;
-    orderBy?: "createdAt" | "startedAt" | "finishedAt";
-    orderDirection?: "asc" | "desc";
+    orderBy?: 'createdAt' | 'startedAt' | 'finishedAt';
+    orderDirection?: 'asc' | 'desc';
 }
 /**
  * Extended options for listing runs.
@@ -161,15 +162,15 @@ interface ExtendedListRunsOptions {
     status?: ExtendedRunStatus | ExtendedRunStatus[];
     limit?: number;
     offset?: number;
-    orderBy?: "createdAt" | "startedAt" | "finishedAt";
-    orderDir?: "asc" | "desc";
+    orderBy?: 'createdAt' | 'startedAt' | 'finishedAt';
+    orderDir?: 'asc' | 'desc';
 }
 /**
  * Options for listing events.
  */
 interface ListEventsOptions {
     stepKey?: string;
-    level?: "info" | "warn" | "error";
+    level?: 'info' | 'warn' | 'error';
     limit?: number;
     offset?: number;
 }
@@ -198,7 +199,7 @@ interface WorkflowStorage {
     getStepResult(runId: string, stepName: string): Promise<StepResult | undefined>;
     getStepResults(runId: string): Promise<StepResult[]>;
     getStepsForRun(runId: string): Promise<StepRecord[]>;
-    saveStepResult(result: Omit<StepResult, "id"> & {
+    saveStepResult(result: Omit<StepResult, 'id'> & {
         id?: string;
     }): Promise<void>;
     initialize(): Promise<void>;
@@ -209,15 +210,15 @@ interface WorkflowStorage {
  * Implement this interface to use your preferred database.
  */
 interface StorageAdapter {
-    createRun(run: Omit<WorkflowRunRecord, "id" | "createdAt">): Promise<WorkflowRunRecord>;
+    createRun(run: Omit<WorkflowRunRecord, 'id' | 'createdAt'>): Promise<WorkflowRunRecord>;
     getRun(runId: string): Promise<WorkflowRunRecord | null>;
     updateRun(runId: string, updates: Partial<WorkflowRunRecord>): Promise<void>;
     listRuns(options?: ListRunsOptions): Promise<PaginatedResult<WorkflowRunRecord>>;
-    createStep(step: Omit<WorkflowRunStepRecord, "id">): Promise<WorkflowRunStepRecord>;
+    createStep(step: Omit<WorkflowRunStepRecord, 'id'>): Promise<WorkflowRunStepRecord>;
     getStep(stepId: string): Promise<WorkflowRunStepRecord | null>;
     updateStep(stepId: string, updates: Partial<WorkflowRunStepRecord>): Promise<void>;
     getStepsForRun(runId: string): Promise<WorkflowRunStepRecord[]>;
-    saveEvent(event: Omit<WorkflowEventRecord, "id">): Promise<void>;
+    saveEvent(event: Omit<WorkflowEventRecord, 'id'>): Promise<void>;
     getEventsForRun(runId: string, options?: ListEventsOptions): Promise<WorkflowEventRecord[]>;
     /**
      * Optional transaction support.
@@ -269,8 +270,8 @@ interface StepflowStepResultsTable {
  * Combined database schema for Stepflow.
  */
 interface StepflowDatabase {
-    "stepflow.runs": StepflowRunsTable;
-    "stepflow.step_results": StepflowStepResultsTable;
+    'stepflow.runs': StepflowRunsTable;
+    'stepflow.step_results': StepflowStepResultsTable;
 }
 
 export type { CreateRunInput as C, ExtendedListRunsOptions as E, ListEventsOptions as L, PaginatedResult as P, StepRecord as S, UpdateRunInput as U, WorkflowEventRecord as W, ExtendedRunStatus as a, ExtendedStepStatus as b, ExtendedWorkflowRunRecord as c, ListRunsOptions as d, StepResult as e, StepflowDatabase as f, StepflowRunsTable as g, StepflowStepResultsTable as h, StorageAdapter as i, WorkflowRunRecord as j, WorkflowRunStepRecord as k, WorkflowStorage as l };

package/dist/{types-DzkEqnQJ.d.ts → types-DZUdWmCc.d.ts}

@@ -1,4 +1,4 @@
-import { W as WorkflowKind } from './types-BVShq7zT.js';
+import { W as WorkflowKind } from './types-K5Gjk3H_.js';
 
 /**
  * Event system types for the workflow engine.
@@ -7,7 +7,7 @@ import { W as WorkflowKind } from './types-BVShq7zT.js';
 /**
  * Built-in event types emitted by the workflow engine.
  */
-type BuiltInEventType = "run.created" | "run.queued" | "run.dequeued" | "run.started" | "run.resumed" | "run.completed" | "run.failed" | "run.canceled" | "run.timeout" | "step.started" | "step.completed" | "step.failed" | "step.skipped" | "step.retry";
+type BuiltInEventType = 'run.created' | 'run.queued' | 'run.dequeued' | 'run.started' | 'run.resumed' | 'run.completed' | 'run.failed' | 'run.canceled' | 'run.timeout' | 'step.started' | 'step.completed' | 'step.failed' | 'step.skipped' | 'step.retry';
 /**
  * Event types emitted by the workflow engine.
  * Includes built-in types and allows custom events via string.

package/dist/{types-BVShq7zT.d.ts → types-K5Gjk3H_.d.ts}

@@ -10,18 +10,18 @@ type WorkflowKind = string;
 /**
  * Status of a workflow run.
  */
-type RunStatus = "queued" | "running" | "succeeded" | "failed" | "canceled";
+type RunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled';
 /**
  * Status of a workflow step.
  */
-type StepStatus = "pending" | "running" | "succeeded" | "failed" | "skipped" | "canceled";
+type StepStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'skipped' | 'canceled';
 /**
  * Error handling strategy for a step.
  * - 'fail': Stop the workflow immediately
  * - 'retry': Retry the step up to maxRetries times
  * - 'skip': Mark as skipped and continue to next step
  */
-type StepErrorStrategy = "fail" | "retry" | "skip";
+type StepErrorStrategy = 'fail' | 'retry' | 'skip';
 /**
  * Structured error information stored with runs and steps.
  */
@@ -35,7 +35,7 @@ interface WorkflowError {
  * Result of a completed workflow run.
  */
 interface RunResult {
-    status: "succeeded" | "failed" | "canceled";
+    status: 'succeeded' | 'failed' | 'canceled';
     results: Record<string, unknown>;
     error?: WorkflowError;
     duration: number;

package/docs/stepflow-api-reference.md

@@ -496,7 +496,6 @@ await scheduler.addSchedule({
 await scheduler.removeSchedule(scheduleId);
 await scheduler.updateSchedule(scheduleId, { enabled: false });
 const schedules = await scheduler.getSchedules();
-const schedule = scheduler.getSchedule(scheduleId);
 const runId = await scheduler.triggerNow(scheduleId);
 
 await scheduler.stop();
@@ -780,7 +779,7 @@ const storage = new SQLiteStorageAdapter({
   tablePrefix: 'workflow',   // default: 'workflow'
 });
 
-// Additional methods
+// Additional methods (implementation-only; not part of the StorageAdapter interface)
 storage.transactionSync<T>(fn: () => T): T;
 await storage.getInterruptedRuns(): Promise<WorkflowRunRecord[]>;
 await storage.getLastCompletedStep(runId): Promise<WorkflowRunStepRecord | null>;
@@ -868,7 +867,7 @@ await storage.getStepResults(runId): Promise<StepResult[]>;
 await storage.saveStepResult(result): Promise<void>;
 ```
 
-**Resume support:**
+**Resume support** (implementation-only; not part of the StorageAdapter interface):
 
 ```typescript
 await storage.getInterruptedRuns(): Promise<WorkflowRunRecord[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplier-labs/stepflow",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "A durable, type-safe workflow orchestration engine for Node.js with SQLite persistence, scheduling, and real-time events",
   "type": "module",
   "license": "MIT",
@@ -9,7 +9,8 @@
     "url": "https://github.com/Multiplier-Labs/stepflow"
   },
   "publishConfig": {
-    "registry": "https://npm.pkg.github.com"
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
   },
   "keywords": [
     "workflow",
@@ -52,7 +53,7 @@
   },
   "dependencies": {
     "cron-parser": "^5.5.0",
-    "re2": "^1.23.3"
+    "re2": "^1.24.0"
   },
   "peerDependencies": {
     "better-sqlite3": ">=11.0.0",
@@ -74,12 +75,12 @@
     "@types/better-sqlite3": "^7.6.11",
     "@types/node": "^22.0.0",
     "@types/pg": "^8.18.0",
-    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/coverage-v8": "^4.1.4",
     "better-sqlite3": "^12.8.0",
-    "kysely": "^0.28.12",
+    "kysely": "^0.28.14",
     "pg": "^8.20.0",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.4"
   }
 }