resumable-workflow 1.0.0

package/README.md

@@ -0,0 +1,109 @@
+# Resumable Workflow
+
+A lightweight, framework-agnostic Node.js library to ensure multi-step processes survive server crashes. It uses a declarative functional API and checkpoints progress to persistent storage after every step.
+
+## Features
+- **Checkpointing:** Automatically saves state after each successful step.
+- **Resumable:** Easily resume failed or interrupted runs by ID.
+- **Result Pattern:** Returns descriptive objects instead of throwing errors for better control and performance.
+- **Auto-Resume:** Optional background resumption of incomplete tasks on startup.
+- **Pluggable Storage:** Default file-system storage included, with interfaces for Redis or SQL.
+
+## Architecture
+
+The library is split into three main parts:
+1. **The Engine (`src/core`):** Manages the execution loop and ensures that steps are called in order.
+2. **Storage Providers (`src/storage`):** Handles the physical saving and loading of the workflow state.
+3. **Types (`src/types`):** Provides strict generic support so your input and output data are always type-safe.
+
+## Installation
+```bash
+pnpm add resumable-workflow
+```
+
+## Usage
+
+### 1. Define and Start a Workflow
+```typescript
+import { createWorkflow } from 'resumable-workflow';
+
+const onboarding = createWorkflow({
+  id: 'user-onboarding',
+  steps: [
+    {
+      name: 'create-user',
+      run: async ({ input }) => {
+        // Logic to create user
+        return { userId: '123' }; // Merged into state
+      }
+    },
+    {
+      name: 'send-welcome-email',
+      run: async ({ state }) => {
+        // Access state.userId from previous step
+        await mailer.send(state.userId);
+        return { emailSent: true };
+      }
+    }
+  ]
+});
+
+const response = await onboarding.start({ email: 'user@example.com' });
+
+if (response.success) {
+  console.log('Workflow finished:', response.result);
+} else {
+  console.error('Workflow failed at:', response.stepName, 'Error:', response.error);
+  // You can store response.runId to resume later
+}
+```
+
+### 2. Resume a Failed Run
+```typescript
+const response = await onboarding.resume(failedRunId);
+```
+
+### 3. Auto-Resume on Startup
+```typescript
+const workflow = createWorkflow({
+  id: 'critical-process',
+  autoResume: true, // Will automatically scan and resume pending tasks
+  steps: [...]
+});
+```
+
+## API
+
+### `createWorkflow(config)`
+Returns an engine with `start`, `resume`, `listIncomplete`, and `resumeAllIncomplete`.
+
+#### Config:
+- `id`: Unique string identifying the workflow.
+- `steps`: Array of step objects `{ name, run }`.
+- `autoResume`: (Optional) Boolean.
+- `storage`: (Optional) Custom storage provider.
+
+### The Result Object
+All execution methods return a `WorkflowResult`:
+- **Success:** `{ success: true, result: T, runId: string }`
+- **Failure:** `{ success: false, error: string, runId: string, stepName: string }`
+
+## Development & Release
+
+### Workflow for Changes
+1. Make your changes.
+2. Run `pnpm changeset` and follow the prompts to describe your change.
+3. Commit the generated changeset file.
+
+### CI/CD
+This project uses **GitHub Actions** for CI. Every pull request is automatically:
+- Linted with Biome
+- Built with tsup
+- Tested with Vitest
+
+## Contributing
+
+We welcome contributions! Please see our [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed instructions on how to set up the project, our coding standards, and the pull request process.
+
+## License
+MIT

package/dist/index.d.mts

@@ -0,0 +1,67 @@
+interface Step<TInput = unknown, TState = Record<string, unknown>, TOutput = unknown> {
+    readonly name: string;
+    readonly run: (context: {
+        readonly input: TInput;
+        readonly state: TState;
+    }) => Promise<TOutput>;
+}
+interface WorkflowConfig<TInput = unknown, TState = Record<string, unknown>> {
+    readonly id: string;
+    readonly steps: readonly Step<TInput, TState, unknown>[];
+    readonly autoResume?: boolean;
+    readonly storage?: StorageProvider;
+}
+type WorkflowStatus = 'pending' | 'completed' | 'failed';
+interface WorkflowRunState<TInput = unknown, TState = Record<string, unknown>> {
+    readonly workflowId: string;
+    readonly runId: string;
+    readonly status: WorkflowStatus;
+    readonly currentStepIndex: number;
+    readonly input: TInput;
+    readonly state: TState;
+    readonly error?: string;
+}
+type WorkflowResult<T = Record<string, unknown>> = {
+    readonly success: true;
+    readonly result: T;
+    readonly runId: string;
+} | {
+    readonly success: false;
+    readonly error: string;
+    readonly runId: string;
+    readonly stepName: string;
+};
+interface StorageProvider {
+    saveRun(state: WorkflowRunState<unknown, Record<string, unknown>>): Promise<void>;
+    getRun(runId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null>;
+    listIncompleteRuns(workflowId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
+}
+
+declare class Workflow<TInput = unknown, TState extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly storage;
+    private readonly workflowId;
+    private readonly config;
+    constructor(config: WorkflowConfig<TInput, TState>);
+    private executeStep;
+    private run;
+    start(input: TInput): Promise<WorkflowResult<TState>>;
+    resume(runId: string): Promise<WorkflowResult<TState>>;
+    listIncomplete(): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
+    resumeAllIncomplete(): Promise<WorkflowResult<TState>[]>;
+}
+/**
+ * Factory function for backward compatibility and ease of use
+ */
+declare function createWorkflow<TInput = unknown, TState extends Record<string, unknown> = Record<string, unknown>>(config: WorkflowConfig<TInput, TState>): Workflow<TInput, TState>;
+
+declare class FileStorage implements StorageProvider {
+    private readonly baseDir;
+    constructor(baseDir?: string);
+    private ensureDir;
+    private getFilePath;
+    saveRun(state: WorkflowRunState<unknown, Record<string, unknown>>): Promise<void>;
+    getRun(runId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null>;
+    listIncompleteRuns(workflowId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
+}
+
+export { FileStorage, type Step, type StorageProvider, Workflow, type WorkflowConfig, type WorkflowResult, type WorkflowRunState, type WorkflowStatus, createWorkflow };

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+interface Step<TInput = unknown, TState = Record<string, unknown>, TOutput = unknown> {
+    readonly name: string;
+    readonly run: (context: {
+        readonly input: TInput;
+        readonly state: TState;
+    }) => Promise<TOutput>;
+}
+interface WorkflowConfig<TInput = unknown, TState = Record<string, unknown>> {
+    readonly id: string;
+    readonly steps: readonly Step<TInput, TState, unknown>[];
+    readonly autoResume?: boolean;
+    readonly storage?: StorageProvider;
+}
+type WorkflowStatus = 'pending' | 'completed' | 'failed';
+interface WorkflowRunState<TInput = unknown, TState = Record<string, unknown>> {
+    readonly workflowId: string;
+    readonly runId: string;
+    readonly status: WorkflowStatus;
+    readonly currentStepIndex: number;
+    readonly input: TInput;
+    readonly state: TState;
+    readonly error?: string;
+}
+type WorkflowResult<T = Record<string, unknown>> = {
+    readonly success: true;
+    readonly result: T;
+    readonly runId: string;
+} | {
+    readonly success: false;
+    readonly error: string;
+    readonly runId: string;
+    readonly stepName: string;
+};
+interface StorageProvider {
+    saveRun(state: WorkflowRunState<unknown, Record<string, unknown>>): Promise<void>;
+    getRun(runId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null>;
+    listIncompleteRuns(workflowId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
+}
+
+declare class Workflow<TInput = unknown, TState extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly storage;
+    private readonly workflowId;
+    private readonly config;
+    constructor(config: WorkflowConfig<TInput, TState>);
+    private executeStep;
+    private run;
+    start(input: TInput): Promise<WorkflowResult<TState>>;
+    resume(runId: string): Promise<WorkflowResult<TState>>;
+    listIncomplete(): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
+    resumeAllIncomplete(): Promise<WorkflowResult<TState>[]>;
+}
+/**
+ * Factory function for backward compatibility and ease of use
+ */
+declare function createWorkflow<TInput = unknown, TState extends Record<string, unknown> = Record<string, unknown>>(config: WorkflowConfig<TInput, TState>): Workflow<TInput, TState>;
+
+declare class FileStorage implements StorageProvider {
+    private readonly baseDir;
+    constructor(baseDir?: string);
+    private ensureDir;
+    private getFilePath;
+    saveRun(state: WorkflowRunState<unknown, Record<string, unknown>>): Promise<void>;
+    getRun(runId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null>;
+    listIncompleteRuns(workflowId: string): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
+}
+
+export { FileStorage, type Step, type StorageProvider, Workflow, type WorkflowConfig, type WorkflowResult, type WorkflowRunState, type WorkflowStatus, createWorkflow };

package/dist/index.js

@@ -0,0 +1,219 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FileStorage: () => FileStorage,
+  Workflow: () => Workflow,
+  createWorkflow: () => createWorkflow
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/engine.ts
+var import_node_crypto = require("crypto");
+
+// src/storage/file-storage.ts
+var import_promises = __toESM(require("fs/promises"));
+var import_node_path = __toESM(require("path"));
+var FileStorage = class {
+  constructor(baseDir = ".resumable-workflow") {
+    this.baseDir = import_node_path.default.resolve(baseDir);
+  }
+  async ensureDir() {
+    await import_promises.default.mkdir(this.baseDir, { recursive: true });
+  }
+  getFilePath(runId) {
+    return import_node_path.default.join(this.baseDir, `${runId}.json`);
+  }
+  async saveRun(state) {
+    await this.ensureDir();
+    await import_promises.default.writeFile(
+      this.getFilePath(state.runId),
+      JSON.stringify(state, null, 2)
+    );
+  }
+  async getRun(runId) {
+    try {
+      const data = await import_promises.default.readFile(this.getFilePath(runId), "utf-8");
+      return JSON.parse(data);
+    } catch (_e) {
+      return null;
+    }
+  }
+  async listIncompleteRuns(workflowId) {
+    try {
+      await this.ensureDir();
+      const files = await import_promises.default.readdir(this.baseDir);
+      const runs = [];
+      for (const file of files) {
+        if (file.endsWith(".json")) {
+          const data = await import_promises.default.readFile(
+            import_node_path.default.join(this.baseDir, file),
+            "utf-8"
+          );
+          const run = JSON.parse(data);
+          if (run.workflowId === workflowId && run.status === "pending") {
+            runs.push(run);
+          }
+        }
+      }
+      return runs;
+    } catch (_e) {
+      return [];
+    }
+  }
+};
+
+// src/core/engine.ts
+var Workflow = class {
+  constructor(config) {
+    this.config = config;
+    this.storage = config.storage || new FileStorage();
+    this.workflowId = config.id;
+    if (config.autoResume) {
+      this.resumeAllIncomplete().catch((err) => {
+        console.error(
+          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,
+          err
+        );
+      });
+    }
+  }
+  async executeStep(currentState, stepIndex) {
+    const step = this.config.steps[stepIndex];
+    if (!step) {
+      return;
+    }
+    try {
+      const result = await step.run({
+        input: currentState.input,
+        state: currentState.state
+      });
+      if (result !== null && typeof result === "object" && !Array.isArray(result)) {
+        currentState.state = {
+          ...currentState.state,
+          ...result
+        };
+      } else if (result !== void 0) {
+        currentState.state[step.name || `step_${stepIndex}`] = result;
+      }
+      currentState.currentStepIndex = stepIndex + 1;
+      if (currentState.currentStepIndex === this.config.steps.length) {
+        currentState.status = "completed";
+      }
+      await this.storage.saveRun(currentState);
+    } catch (error) {
+      currentState.status = "failed";
+      currentState.error = error instanceof Error ? error.message : String(error);
+      await this.storage.saveRun(currentState);
+      throw error;
+    }
+  }
+  async run(input, existingRun) {
+    const runId = existingRun?.runId || (0, import_node_crypto.randomUUID)();
+    const currentState = existingRun || {
+      workflowId: this.workflowId,
+      runId,
+      status: "pending",
+      currentStepIndex: 0,
+      input,
+      state: {}
+    };
+    if (!existingRun) {
+      await this.storage.saveRun(currentState);
+    }
+    try {
+      for (let i = currentState.currentStepIndex; i < this.config.steps.length; i++) {
+        await this.executeStep(currentState, i);
+      }
+    } catch (_error) {
+      return {
+        success: false,
+        error: currentState.error || "Unknown error",
+        runId: currentState.runId,
+        stepName: this.config.steps[currentState.currentStepIndex]?.name || `step_${currentState.currentStepIndex}`
+      };
+    }
+    return {
+      success: true,
+      result: currentState.state,
+      runId: currentState.runId
+    };
+  }
+  start(input) {
+    return this.run(input);
+  }
+  async resume(runId) {
+    const runState = await this.storage.getRun(runId);
+    if (!runState) {
+      return {
+        success: false,
+        error: `Run ${runId} not found`,
+        runId,
+        stepName: "unknown"
+      };
+    }
+    if (runState.status === "completed") {
+      return {
+        success: true,
+        result: runState.state,
+        runId: runState.runId
+      };
+    }
+    return this.run(
+      runState.input,
+      runState
+    );
+  }
+  listIncomplete() {
+    return this.storage.listIncompleteRuns(this.workflowId);
+  }
+  async resumeAllIncomplete() {
+    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);
+    return Promise.all(
+      incomplete.map(
+        (runState) => this.run(
+          runState.input,
+          runState
+        )
+      )
+    );
+  }
+};
+function createWorkflow(config) {
+  return new Workflow(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FileStorage,
+  Workflow,
+  createWorkflow
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core/engine.ts","../src/storage/file-storage.ts"],"sourcesContent":["export { createWorkflow, Workflow } from './core/engine';\nexport { FileStorage } from './storage/file-storage';\nexport type {\n  Step,\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from './types';\n","import { randomUUID } from 'node:crypto';\nimport { FileStorage } from '../storage/file-storage';\nimport type {\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from '../types';\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nexport class Workflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  private readonly storage: StorageProvider;\n  private readonly workflowId: string;\n  private readonly config: WorkflowConfig<TInput, TState>;\n\n  constructor(config: WorkflowConfig<TInput, TState>) {\n    this.config = config;\n    this.storage = config.storage || new FileStorage();\n    this.workflowId = config.id;\n\n    if (config.autoResume) {\n      this.resumeAllIncomplete().catch((err) => {\n        console.error(\n          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,\n          err\n        );\n      });\n    }\n  }\n\n  private async executeStep(\n    currentState: Mutable<WorkflowRunState<TInput, TState>>,\n    stepIndex: number\n  ): Promise<void> {\n    const step = this.config.steps[stepIndex];\n    if (!step) {\n      return;\n    }\n\n    try {\n      const result = await step.run({\n        input: currentState.input,\n        state: currentState.state,\n      });\n\n      if (\n        result !== null &&\n        typeof result === 'object' &&\n        !Array.isArray(result)\n      ) {\n        currentState.state = {\n          ...currentState.state,\n          ...(result as Partial<TState>),\n        };\n      } else if (result !== undefined) {\n        (currentState.state as Record<string, unknown>)[\n          step.name || `step_${stepIndex}`\n        ] = result;\n      }\n\n      currentState.currentStepIndex = stepIndex + 1;\n\n      if (currentState.currentStepIndex === this.config.steps.length) {\n        currentState.status = 'completed';\n      }\n\n      await this.storage.saveRun(currentState);\n    } catch (error) {\n      currentState.status = 'failed';\n      currentState.error =\n        error instanceof Error ? error.message : String(error);\n      await this.storage.saveRun(currentState);\n      throw error;\n    }\n  }\n\n  private async run(\n    input: TInput,\n    existingRun?: WorkflowRunState<TInput, TState>\n  ): Promise<WorkflowResult<TState>> {\n    const runId = existingRun?.runId || randomUUID();\n    const currentState: Mutable<WorkflowRunState<TInput, TState>> =\n      (existingRun as Mutable<WorkflowRunState<TInput, TState>>) || {\n        workflowId: this.workflowId,\n        runId,\n        status: 'pending' as WorkflowStatus,\n        currentStepIndex: 0,\n        input,\n        state: {} as TState,\n      };\n\n    if (!existingRun) {\n      await this.storage.saveRun(currentState);\n    }\n\n    try {\n      for (\n        let i = currentState.currentStepIndex;\n        i < this.config.steps.length;\n        i++\n      ) {\n        await this.executeStep(currentState, i);\n      }\n    } catch (_error) {\n      return {\n        success: false,\n        error: currentState.error || 'Unknown error',\n        runId: currentState.runId,\n        stepName:\n          this.config.steps[currentState.currentStepIndex]?.name ||\n          `step_${currentState.currentStepIndex}`,\n      };\n    }\n\n    return {\n      success: true,\n      result: currentState.state,\n      runId: currentState.runId,\n    };\n  }\n\n  start(input: TInput): Promise<WorkflowResult<TState>> {\n    return this.run(input);\n  }\n\n  async resume(runId: string): Promise<WorkflowResult<TState>> {\n    const runState = await this.storage.getRun(runId);\n    if (!runState) {\n      return {\n        success: false,\n        error: `Run ${runId} not found`,\n        runId,\n        stepName: 'unknown',\n      };\n    }\n    if (runState.status === 'completed') {\n      return {\n        success: true,\n        result: runState.state as TState,\n        runId: runState.runId,\n      };\n    }\n    return this.run(\n      runState.input as TInput,\n      runState as WorkflowRunState<TInput, TState>\n    );\n  }\n\n  listIncomplete(): Promise<\n    WorkflowRunState<unknown, Record<string, unknown>>[]\n  > {\n    return this.storage.listIncompleteRuns(this.workflowId);\n  }\n\n  async resumeAllIncomplete(): Promise<WorkflowResult<TState>[]> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    return Promise.all(\n      incomplete.map((runState) =>\n        this.run(\n          runState.input as TInput,\n          runState as WorkflowRunState<TInput, TState>\n        )\n      )\n    );\n  }\n}\n\n/**\n * Factory function for backward compatibility and ease of use\n */\nexport function createWorkflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n>(config: WorkflowConfig<TInput, TState>) {\n  return new Workflow(config);\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport type { StorageProvider, WorkflowRunState } from '../types';\n\nexport class FileStorage implements StorageProvider {\n  private readonly baseDir: string;\n\n  constructor(baseDir = '.resumable-workflow') {\n    this.baseDir = path.resolve(baseDir);\n  }\n\n  private async ensureDir(): Promise<void> {\n    await fs.mkdir(this.baseDir, { recursive: true });\n  }\n\n  private getFilePath(runId: string): string {\n    return path.join(this.baseDir, `${runId}.json`);\n  }\n\n  async saveRun(\n    state: WorkflowRunState<unknown, Record<string, unknown>>\n  ): Promise<void> {\n    await this.ensureDir();\n    await fs.writeFile(\n      this.getFilePath(state.runId),\n      JSON.stringify(state, null, 2)\n    );\n  }\n\n  async getRun(\n    runId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null> {\n    try {\n      const data = await fs.readFile(this.getFilePath(runId), 'utf-8');\n      return JSON.parse(data) as WorkflowRunState<\n        unknown,\n        Record<string, unknown>\n      >;\n    } catch (_e) {\n      // Return null if file doesn't exist or is invalid\n      return null;\n    }\n  }\n\n  async listIncompleteRuns(\n    workflowId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]> {\n    try {\n      await this.ensureDir();\n      const files = await fs.readdir(this.baseDir);\n      const runs: WorkflowRunState<unknown, Record<string, unknown>>[] = [];\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const data = await fs.readFile(\n            path.join(this.baseDir, file),\n            'utf-8'\n          );\n          const run = JSON.parse(data) as WorkflowRunState<\n            unknown,\n            Record<string, unknown>\n          >;\n          if (run.workflowId === workflowId && run.status === 'pending') {\n            runs.push(run);\n          }\n        }\n      }\n      return runs;\n    } catch (_e) {\n      // Return empty array if directory doesn't exist or fails to read\n      return [];\n    }\n  }\n}\n"],"mappings":"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","names":["path","fs"]}

package/dist/index.mjs

@@ -0,0 +1,180 @@
+// src/core/engine.ts
+import { randomUUID } from "crypto";
+
+// src/storage/file-storage.ts
+import fs from "fs/promises";
+import path from "path";
+var FileStorage = class {
+  constructor(baseDir = ".resumable-workflow") {
+    this.baseDir = path.resolve(baseDir);
+  }
+  async ensureDir() {
+    await fs.mkdir(this.baseDir, { recursive: true });
+  }
+  getFilePath(runId) {
+    return path.join(this.baseDir, `${runId}.json`);
+  }
+  async saveRun(state) {
+    await this.ensureDir();
+    await fs.writeFile(
+      this.getFilePath(state.runId),
+      JSON.stringify(state, null, 2)
+    );
+  }
+  async getRun(runId) {
+    try {
+      const data = await fs.readFile(this.getFilePath(runId), "utf-8");
+      return JSON.parse(data);
+    } catch (_e) {
+      return null;
+    }
+  }
+  async listIncompleteRuns(workflowId) {
+    try {
+      await this.ensureDir();
+      const files = await fs.readdir(this.baseDir);
+      const runs = [];
+      for (const file of files) {
+        if (file.endsWith(".json")) {
+          const data = await fs.readFile(
+            path.join(this.baseDir, file),
+            "utf-8"
+          );
+          const run = JSON.parse(data);
+          if (run.workflowId === workflowId && run.status === "pending") {
+            runs.push(run);
+          }
+        }
+      }
+      return runs;
+    } catch (_e) {
+      return [];
+    }
+  }
+};
+
+// src/core/engine.ts
+var Workflow = class {
+  constructor(config) {
+    this.config = config;
+    this.storage = config.storage || new FileStorage();
+    this.workflowId = config.id;
+    if (config.autoResume) {
+      this.resumeAllIncomplete().catch((err) => {
+        console.error(
+          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,
+          err
+        );
+      });
+    }
+  }
+  async executeStep(currentState, stepIndex) {
+    const step = this.config.steps[stepIndex];
+    if (!step) {
+      return;
+    }
+    try {
+      const result = await step.run({
+        input: currentState.input,
+        state: currentState.state
+      });
+      if (result !== null && typeof result === "object" && !Array.isArray(result)) {
+        currentState.state = {
+          ...currentState.state,
+          ...result
+        };
+      } else if (result !== void 0) {
+        currentState.state[step.name || `step_${stepIndex}`] = result;
+      }
+      currentState.currentStepIndex = stepIndex + 1;
+      if (currentState.currentStepIndex === this.config.steps.length) {
+        currentState.status = "completed";
+      }
+      await this.storage.saveRun(currentState);
+    } catch (error) {
+      currentState.status = "failed";
+      currentState.error = error instanceof Error ? error.message : String(error);
+      await this.storage.saveRun(currentState);
+      throw error;
+    }
+  }
+  async run(input, existingRun) {
+    const runId = existingRun?.runId || randomUUID();
+    const currentState = existingRun || {
+      workflowId: this.workflowId,
+      runId,
+      status: "pending",
+      currentStepIndex: 0,
+      input,
+      state: {}
+    };
+    if (!existingRun) {
+      await this.storage.saveRun(currentState);
+    }
+    try {
+      for (let i = currentState.currentStepIndex; i < this.config.steps.length; i++) {
+        await this.executeStep(currentState, i);
+      }
+    } catch (_error) {
+      return {
+        success: false,
+        error: currentState.error || "Unknown error",
+        runId: currentState.runId,
+        stepName: this.config.steps[currentState.currentStepIndex]?.name || `step_${currentState.currentStepIndex}`
+      };
+    }
+    return {
+      success: true,
+      result: currentState.state,
+      runId: currentState.runId
+    };
+  }
+  start(input) {
+    return this.run(input);
+  }
+  async resume(runId) {
+    const runState = await this.storage.getRun(runId);
+    if (!runState) {
+      return {
+        success: false,
+        error: `Run ${runId} not found`,
+        runId,
+        stepName: "unknown"
+      };
+    }
+    if (runState.status === "completed") {
+      return {
+        success: true,
+        result: runState.state,
+        runId: runState.runId
+      };
+    }
+    return this.run(
+      runState.input,
+      runState
+    );
+  }
+  listIncomplete() {
+    return this.storage.listIncompleteRuns(this.workflowId);
+  }
+  async resumeAllIncomplete() {
+    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);
+    return Promise.all(
+      incomplete.map(
+        (runState) => this.run(
+          runState.input,
+          runState
+        )
+      )
+    );
+  }
+};
+function createWorkflow(config) {
+  return new Workflow(config);
+}
+export {
+  FileStorage,
+  Workflow,
+  createWorkflow
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/engine.ts","../src/storage/file-storage.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { FileStorage } from '../storage/file-storage';\nimport type {\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from '../types';\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nexport class Workflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  private readonly storage: StorageProvider;\n  private readonly workflowId: string;\n  private readonly config: WorkflowConfig<TInput, TState>;\n\n  constructor(config: WorkflowConfig<TInput, TState>) {\n    this.config = config;\n    this.storage = config.storage || new FileStorage();\n    this.workflowId = config.id;\n\n    if (config.autoResume) {\n      this.resumeAllIncomplete().catch((err) => {\n        console.error(\n          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,\n          err\n        );\n      });\n    }\n  }\n\n  private async executeStep(\n    currentState: Mutable<WorkflowRunState<TInput, TState>>,\n    stepIndex: number\n  ): Promise<void> {\n    const step = this.config.steps[stepIndex];\n    if (!step) {\n      return;\n    }\n\n    try {\n      const result = await step.run({\n        input: currentState.input,\n        state: currentState.state,\n      });\n\n      if (\n        result !== null &&\n        typeof result === 'object' &&\n        !Array.isArray(result)\n      ) {\n        currentState.state = {\n          ...currentState.state,\n          ...(result as Partial<TState>),\n        };\n      } else if (result !== undefined) {\n        (currentState.state as Record<string, unknown>)[\n          step.name || `step_${stepIndex}`\n        ] = result;\n      }\n\n      currentState.currentStepIndex = stepIndex + 1;\n\n      if (currentState.currentStepIndex === this.config.steps.length) {\n        currentState.status = 'completed';\n      }\n\n      await this.storage.saveRun(currentState);\n    } catch (error) {\n      currentState.status = 'failed';\n      currentState.error =\n        error instanceof Error ? error.message : String(error);\n      await this.storage.saveRun(currentState);\n      throw error;\n    }\n  }\n\n  private async run(\n    input: TInput,\n    existingRun?: WorkflowRunState<TInput, TState>\n  ): Promise<WorkflowResult<TState>> {\n    const runId = existingRun?.runId || randomUUID();\n    const currentState: Mutable<WorkflowRunState<TInput, TState>> =\n      (existingRun as Mutable<WorkflowRunState<TInput, TState>>) || {\n        workflowId: this.workflowId,\n        runId,\n        status: 'pending' as WorkflowStatus,\n        currentStepIndex: 0,\n        input,\n        state: {} as TState,\n      };\n\n    if (!existingRun) {\n      await this.storage.saveRun(currentState);\n    }\n\n    try {\n      for (\n        let i = currentState.currentStepIndex;\n        i < this.config.steps.length;\n        i++\n      ) {\n        await this.executeStep(currentState, i);\n      }\n    } catch (_error) {\n      return {\n        success: false,\n        error: currentState.error || 'Unknown error',\n        runId: currentState.runId,\n        stepName:\n          this.config.steps[currentState.currentStepIndex]?.name ||\n          `step_${currentState.currentStepIndex}`,\n      };\n    }\n\n    return {\n      success: true,\n      result: currentState.state,\n      runId: currentState.runId,\n    };\n  }\n\n  start(input: TInput): Promise<WorkflowResult<TState>> {\n    return this.run(input);\n  }\n\n  async resume(runId: string): Promise<WorkflowResult<TState>> {\n    const runState = await this.storage.getRun(runId);\n    if (!runState) {\n      return {\n        success: false,\n        error: `Run ${runId} not found`,\n        runId,\n        stepName: 'unknown',\n      };\n    }\n    if (runState.status === 'completed') {\n      return {\n        success: true,\n        result: runState.state as TState,\n        runId: runState.runId,\n      };\n    }\n    return this.run(\n      runState.input as TInput,\n      runState as WorkflowRunState<TInput, TState>\n    );\n  }\n\n  listIncomplete(): Promise<\n    WorkflowRunState<unknown, Record<string, unknown>>[]\n  > {\n    return this.storage.listIncompleteRuns(this.workflowId);\n  }\n\n  async resumeAllIncomplete(): Promise<WorkflowResult<TState>[]> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    return Promise.all(\n      incomplete.map((runState) =>\n        this.run(\n          runState.input as TInput,\n          runState as WorkflowRunState<TInput, TState>\n        )\n      )\n    );\n  }\n}\n\n/**\n * Factory function for backward compatibility and ease of use\n */\nexport function createWorkflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n>(config: WorkflowConfig<TInput, TState>) {\n  return new Workflow(config);\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport type { StorageProvider, WorkflowRunState } from '../types';\n\nexport class FileStorage implements StorageProvider {\n  private readonly baseDir: string;\n\n  constructor(baseDir = '.resumable-workflow') {\n    this.baseDir = path.resolve(baseDir);\n  }\n\n  private async ensureDir(): Promise<void> {\n    await fs.mkdir(this.baseDir, { recursive: true });\n  }\n\n  private getFilePath(runId: string): string {\n    return path.join(this.baseDir, `${runId}.json`);\n  }\n\n  async saveRun(\n    state: WorkflowRunState<unknown, Record<string, unknown>>\n  ): Promise<void> {\n    await this.ensureDir();\n    await fs.writeFile(\n      this.getFilePath(state.runId),\n      JSON.stringify(state, null, 2)\n    );\n  }\n\n  async getRun(\n    runId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null> {\n    try {\n      const data = await fs.readFile(this.getFilePath(runId), 'utf-8');\n      return JSON.parse(data) as WorkflowRunState<\n        unknown,\n        Record<string, unknown>\n      >;\n    } catch (_e) {\n      // Return null if file doesn't exist or is invalid\n      return null;\n    }\n  }\n\n  async listIncompleteRuns(\n    workflowId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]> {\n    try {\n      await this.ensureDir();\n      const files = await fs.readdir(this.baseDir);\n      const runs: WorkflowRunState<unknown, Record<string, unknown>>[] = [];\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const data = await fs.readFile(\n            path.join(this.baseDir, file),\n            'utf-8'\n          );\n          const run = JSON.parse(data) as WorkflowRunState<\n            unknown,\n            Record<string, unknown>\n          >;\n          if (run.workflowId === workflowId && run.status === 'pending') {\n            runs.push(run);\n          }\n        }\n      }\n      return runs;\n    } catch (_e) {\n      // Return empty array if directory doesn't exist or fails to read\n      return [];\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "resumable-workflow",
+  "version": "1.0.0",
+  "description": "A lightweight, persistent workflow engine for Node.js. Ensure multi-step processes survive crashes and resume automatically.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "workflow",
+    "resumable",
+    "persistent",
+    "checkpoint",
+    "saga",
+    "state-machine",
+    "reliability",
+    "nodejs",
+    "typescript"
+  ],
+  "author": "Mohamed Ragab",
+  "license": "MIT",
+  "devDependencies": {
+    "@biomejs/biome": "2.3.13",
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "22.13.1",
+    "tsup": "8.5.1",
+    "typescript": "5.7.3",
+    "ultracite": "7.1.1",
+    "vitest": "3.0.5"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsup",
+    "lint": "biome lint .",
+    "format": "biome format . --write",
+    "check": "biome check --write .",
+    "version": "changeset version",
+    "release": "pnpm build && changeset publish"
+  }
+}