resumable-workflow 1.1.0 → 1.1.3

package/dist/.fuse_hidden00018eed00000002

@@ -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" || run.status === "failed")) {
+            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

@@ -146,6 +146,9 @@ var Workflow = class {
       input,
       state: {}
     };
+    if (existingRun && existingRun.status !== "completed") {
+      currentState.status = "pending";
+    }
     if (!existingRun) {
       await this.storage.saveRun(currentState);
     }

package/dist/index.js.map

@@ -1 +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 (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA2B;;;ACA3B,sBAAe;AACf,uBAAiB;AAGV,IAAM,cAAN,MAA6C;AAAA,EAGlD,YAAY,UAAU,uBAAuB;AAC3C,SAAK,UAAU,iBAAAA,QAAK,QAAQ,OAAO;AAAA,EACrC;AAAA,EAEA,MAAc,YAA2B;AACvC,UAAM,gBAAAC,QAAG,MAAM,KAAK,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA,EAClD;AAAA,EAEQ,YAAY,OAAuB;AACzC,WAAO,iBAAAD,QAAK,KAAK,KAAK,SAAS,GAAG,KAAK,OAAO;AAAA,EAChD;AAAA,EAEA,MAAM,QACJ,OACe;AACf,UAAM,KAAK,UAAU;AACrB,UAAM,gBAAAC,QAAG;AAAA,MACP,KAAK,YAAY,MAAM,KAAK;AAAA,MAC5B,KAAK,UAAU,OAAO,MAAM,CAAC;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,OACJ,OACoE;AACpE,QAAI;AACF,YAAM,OAAO,MAAM,gBAAAA,QAAG,SAAS,KAAK,YAAY,KAAK,GAAG,OAAO;AAC/D,aAAO,KAAK,MAAM,IAAI;AAAA,IAIxB,SAAS,IAAI;AAEX,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,mBACJ,YAC+D;AAC/D,QAAI;AACF,YAAM,KAAK,UAAU;AACrB,YAAM,QAAQ,MAAM,gBAAAA,QAAG,QAAQ,KAAK,OAAO;AAC3C,YAAM,OAA6D,CAAC;AAEpE,iBAAW,QAAQ,OAAO;AACxB,YAAI,KAAK,SAAS,OAAO,GAAG;AAC1B,gBAAM,OAAO,MAAM,gBAAAA,QAAG;AAAA,YACpB,iBAAAD,QAAK,KAAK,KAAK,SAAS,IAAI;AAAA,YAC5B;AAAA,UACF;AACA,gBAAM,MAAM,KAAK,MAAM,IAAI;AAI3B,cACE,IAAI,eAAe,eAClB,IAAI,WAAW,aAAa,IAAI,WAAW,WAC5C;AACA,iBAAK,KAAK,GAAG;AAAA,UACf;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,IACT,SAAS,IAAI;AAEX,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;;;AD9DO,IAAM,WAAN,MAGL;AAAA,EAKA,YAAY,QAAwC;AAClD,SAAK,SAAS;AACd,SAAK,UAAU,OAAO,WAAW,IAAI,YAAY;AACjD,SAAK,aAAa,OAAO;AAEzB,QAAI,OAAO,YAAY;AACrB,WAAK,oBAAoB,EAAE,MAAM,CAAC,QAAQ;AACxC,gBAAQ;AAAA,UACN,uBAAuB,KAAK,UAAU;AAAA,UACtC;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,MAAc,YACZ,cACA,WACe;AACf,UAAM,OAAO,KAAK,OAAO,MAAM,SAAS;AACxC,QAAI,CAAC,MAAM;AACT;AAAA,IACF;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,IAAI;AAAA,QAC5B,OAAO,aAAa;AAAA,QACpB,OAAO,aAAa;AAAA,MACtB,CAAC;AAED,UACE,WAAW,QACX,OAAO,WAAW,YAClB,CAAC,MAAM,QAAQ,MAAM,GACrB;AACA,qBAAa,QAAQ;AAAA,UACnB,GAAG,aAAa;AAAA,UAChB,GAAI;AAAA,QACN;AAAA,MACF,WAAW,WAAW,QAAW;AAC/B,QAAC,aAAa,MACZ,KAAK,QAAQ,QAAQ,SAAS,EAChC,IAAI;AAAA,MACN;AAEA,mBAAa,mBAAmB,YAAY;AAE5C,UAAI,aAAa,qBAAqB,KAAK,OAAO,MAAM,QAAQ;AAC9D,qBAAa,SAAS;AAAA,MACxB;AAEA,YAAM,KAAK,QAAQ,QAAQ,YAAY;AAAA,IACzC,SAAS,OAAO;AACd,mBAAa,SAAS;AACtB,mBAAa,QACX,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACvD,YAAM,KAAK,QAAQ,QAAQ,YAAY;AACvC,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAc,IACZ,OACA,aACiC;AACjC,UAAM,QAAQ,aAAa,aAAS,+BAAW;AAC/C,UAAM,eACH,eAA6D;AAAA,MAC5D,YAAY,KAAK;AAAA,MACjB;AAAA,MACA,QAAQ;AAAA,MACR,kBAAkB;AAAA,MAClB;AAAA,MACA,OAAO,CAAC;AAAA,IACV;AAEF,QAAI,CAAC,aAAa;AAChB,YAAM,KAAK,QAAQ,QAAQ,YAAY;AAAA,IACzC;AAEA,QAAI;AACF,eACM,IAAI,aAAa,kBACrB,IAAI,KAAK,OAAO,MAAM,QACtB,KACA;AACA,cAAM,KAAK,YAAY,cAAc,CAAC;AAAA,MACxC;AAAA,IACF,SAAS,QAAQ;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,aAAa,SAAS;AAAA,QAC7B,OAAO,aAAa;AAAA,QACpB,UACE,KAAK,OAAO,MAAM,aAAa,gBAAgB,GAAG,QAClD,QAAQ,aAAa,gBAAgB;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ,aAAa;AAAA,MACrB,OAAO,aAAa;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,MAAM,OAAgD;AACpD,WAAO,KAAK,IAAI,KAAK;AAAA,EACvB;AAAA,EAEA,MAAM,OAAO,OAAgD;AAC3D,UAAM,WAAW,MAAM,KAAK,QAAQ,OAAO,KAAK;AAChD,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,OAAO,KAAK;AAAA,QACnB;AAAA,QACA,UAAU;AAAA,MACZ;AAAA,IACF;AACA,QAAI,SAAS,WAAW,aAAa;AACnC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,QAAQ,SAAS;AAAA,QACjB,OAAO,SAAS;AAAA,MAClB;AAAA,IACF;AACA,WAAO,KAAK;AAAA,MACV,SAAS;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAAA,EAEA,iBAEE;AACA,WAAO,KAAK,QAAQ,mBAAmB,KAAK,UAAU;AAAA,EACxD;AAAA,EAEA,MAAM,sBAAyD;AAC7D,UAAM,aAAa,MAAM,KAAK,QAAQ,mBAAmB,KAAK,UAAU;AACxE,WAAO,QAAQ;AAAA,MACb,WAAW;AAAA,QAAI,CAAC,aACd,KAAK;AAAA,UACH,SAAS;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAKO,SAAS,eAGd,QAAwC;AACxC,SAAO,IAAI,SAAS,MAAM;AAC5B;","names":["path","fs"]}
+{"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 resuming a failed/halted run, reset its status to pending\n    if (existingRun && existingRun.status !== 'completed') {\n      currentState.status = 'pending';\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 (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\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

@@ -108,6 +108,9 @@ var Workflow = class {
       input,
       state: {}
     };
+    if (existingRun && existingRun.status !== "completed") {
+      currentState.status = "pending";
+    }
     if (!existingRun) {
       await this.storage.saveRun(currentState);
     }

package/dist/index.mjs.map

@@ -1 +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 (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\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":[]}
+{"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 resuming a failed/halted run, reset its status to pending\n    if (existingRun && existingRun.status !== 'completed') {\n      currentState.status = 'pending';\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 (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\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

@@ -1,13 +1,28 @@
 {
   "name": "resumable-workflow",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "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",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
   "files": [
     "dist"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Muhamed-Ragab/resumable-workflow.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Muhamed-Ragab/resumable-workflow/issues"
+  },
+  "homepage": "https://github.com/Muhamed-Ragab/resumable-workflow#readme",
   "keywords": [
     "workflow",
     "resumable",