@hardlydifficult/workflow-engine 1.0.0

package/README.md

@@ -0,0 +1,90 @@
+# @hardlydifficult/workflow-engine
+
+General-purpose state machine with typed statuses, validated transitions, and persistent state.
+
+## Installation
+
+```bash
+npm install @hardlydifficult/workflow-engine @hardlydifficult/state-tracker
+```
+
+## Usage
+
+```typescript
+import { WorkflowEngine } from "@hardlydifficult/workflow-engine";
+
+type Status = "idle" | "running" | "completed" | "failed";
+interface Data { count: number; result?: string; }
+
+const engine = new WorkflowEngine<Status, Data>({
+  key: "my-workflow",
+  initialStatus: "idle",
+  initialData: { count: 0 },
+  transitions: {
+    idle: ["running", "failed"],
+    running: ["completed", "failed"],
+    completed: [],
+    failed: [],
+  },
+  stateDirectory: "/var/data",
+  onTransition: (event) => console.log(`${event.from} -> ${event.to}`),
+});
+
+await engine.load();
+
+await engine.transition("running", (draft) => {
+  draft.count = 1;
+});
+
+await engine.transition("completed", (draft) => {
+  draft.result = "done";
+});
+
+engine.isTerminal; // true
+```
+
+## API
+
+### `new WorkflowEngine<TStatus, TData>(options)`
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `key` | `string` | Unique persistence key |
+| `initialStatus` | `TStatus` | Default status for new workflows |
+| `initialData` | `TData` | Default data for new workflows |
+| `transitions` | `Record<TStatus, TStatus[]>` | Allowed transitions per status |
+| `stateDirectory` | `string?` | Persistence directory |
+| `autoSaveMs` | `number?` | Auto-save interval (default 5000) |
+| `onTransition` | `function?` | Event callback |
+
+### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `status` | `TStatus` | Current status |
+| `data` | `Readonly<TData>` | Current data |
+| `isLoaded` | `boolean` | Whether `load()` has been called |
+| `isPersistent` | `boolean` | Whether disk storage is available |
+| `isTerminal` | `boolean` | Whether current status has no outgoing transitions |
+
+### Methods
+
+| Method | Description |
+|--------|-------------|
+| `load()` | Load persisted state from disk. Safe to call multiple times. |
+| `transition(to, updater?)` | Change status, optionally mutate data. Validates transition, persists immediately. |
+| `update(updater)` | Mutate data without changing status. Persists immediately. |
+| `save()` | Force-save current state to disk. |
+| `canTransition(to)` | Check if a transition is allowed from current status. |
+| `allowedTransitions()` | List statuses reachable from current status. |
+
+### Updater Pattern
+
+`transition()` and `update()` accept an updater callback that receives a `structuredClone` of the data. Mutate it directly — if the updater throws, nothing changes.
+
+```typescript
+await engine.transition("running", (draft) => {
+  draft.count += 1;
+  draft.result = computeResult();
+});
+```

package/dist/WorkflowEngine.d.ts

@@ -0,0 +1,51 @@
+import type { DataUpdater, WorkflowEngineOptions } from "./types.js";
+/**
+ * General-purpose state machine with typed statuses, validated transitions,
+ * and persistent state via StateTracker.
+ */
+export declare class WorkflowEngine<TStatus extends string, TData> {
+    private readonly tracker;
+    private readonly transitions;
+    private readonly onTransitionCb?;
+    private loaded;
+    constructor(options: WorkflowEngineOptions<TStatus, TData>);
+    /** Current status */
+    get status(): TStatus;
+    /** Current data (read-only) */
+    get data(): Readonly<TData>;
+    /** Whether load() has been called */
+    get isLoaded(): boolean;
+    /** Whether disk storage is available */
+    get isPersistent(): boolean;
+    /** Whether the current status is terminal (no outgoing transitions) */
+    get isTerminal(): boolean;
+    /**
+     * Load persisted state from disk.
+     * Uses defaults if no state file exists. Safe to call multiple times.
+     */
+    load(): Promise<void>;
+    /**
+     * Transition to a new status, optionally mutating data.
+     *
+     * The updater receives a structuredClone of current data.
+     * If the updater throws, the transition is aborted.
+     * On success, state is persisted immediately.
+     */
+    transition(to: TStatus, updater?: DataUpdater<TData>): Promise<void>;
+    /**
+     * Update data without changing status.
+     *
+     * The updater receives a structuredClone of current data.
+     * If the updater throws, no changes are applied.
+     * On success, state is persisted immediately.
+     */
+    update(updater: DataUpdater<TData>): Promise<void>;
+    /** Check if a specific transition is allowed from current status */
+    canTransition(to: TStatus): boolean;
+    /** Get statuses reachable from current status */
+    allowedTransitions(): readonly TStatus[];
+    /** Force-save current state to disk */
+    save(): Promise<void>;
+    private emitEvent;
+}
+//# sourceMappingURL=WorkflowEngine.d.ts.map

package/dist/WorkflowEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowEngine.d.ts","sourceRoot":"","sources":["../src/WorkflowEngine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EAIX,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,cAAc,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAEtB;IACV,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC;IAoB1D,qBAAqB;IACrB,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,+BAA+B;IAC/B,IAAI,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,CAE1B;IAED,qCAAqC;IACrC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,wCAAwC;IACxC,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,uEAAuE;IACvE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;;;;OAMG;IACG,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1E;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,oEAAoE;IACpE,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO;IAInC,iDAAiD;IACjD,kBAAkB,IAAI,SAAS,OAAO,EAAE;IAIxC,uCAAuC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,SAAS;CAclB"}

package/dist/WorkflowEngine.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowEngine = void 0;
+const state_tracker_1 = require("@hardlydifficult/state-tracker");
+/**
+ * General-purpose state machine with typed statuses, validated transitions,
+ * and persistent state via StateTracker.
+ */
+class WorkflowEngine {
+    tracker;
+    transitions;
+    onTransitionCb;
+    loaded = false;
+    constructor(options) {
+        const { transitions, initialStatus } = options;
+        if (!(initialStatus in transitions)) {
+            throw new Error(`initialStatus "${initialStatus}" is not a key in the transitions map`);
+        }
+        this.transitions = transitions;
+        this.onTransitionCb = options.onTransition;
+        this.tracker = new state_tracker_1.StateTracker({
+            key: options.key,
+            default: { status: initialStatus, data: options.initialData },
+            stateDirectory: options.stateDirectory,
+            autoSaveMs: options.autoSaveMs ?? 5000,
+        });
+    }
+    /** Current status */
+    get status() {
+        return this.tracker.state.status;
+    }
+    /** Current data (read-only) */
+    get data() {
+        return this.tracker.state.data;
+    }
+    /** Whether load() has been called */
+    get isLoaded() {
+        return this.loaded;
+    }
+    /** Whether disk storage is available */
+    get isPersistent() {
+        return this.tracker.isPersistent;
+    }
+    /** Whether the current status is terminal (no outgoing transitions) */
+    get isTerminal() {
+        return this.transitions[this.status].length === 0;
+    }
+    /**
+     * Load persisted state from disk.
+     * Uses defaults if no state file exists. Safe to call multiple times.
+     */
+    async load() {
+        await this.tracker.loadAsync();
+        this.loaded = true;
+        this.emitEvent("load");
+    }
+    /**
+     * Transition to a new status, optionally mutating data.
+     *
+     * The updater receives a structuredClone of current data.
+     * If the updater throws, the transition is aborted.
+     * On success, state is persisted immediately.
+     */
+    async transition(to, updater) {
+        const from = this.status;
+        if (this.isTerminal) {
+            throw new Error(`Cannot transition from terminal status "${from}"`);
+        }
+        const allowed = this.transitions[from];
+        if (!allowed.includes(to)) {
+            throw new Error(`Cannot transition from "${from}" to "${to}". ` +
+                `Allowed: [${allowed.join(", ")}]`);
+        }
+        const data = structuredClone(this.tracker.state.data);
+        if (updater !== undefined) {
+            updater(data);
+        }
+        this.tracker.set({ status: to, data });
+        await this.tracker.saveAsync();
+        this.emitEvent("transition", from, to);
+    }
+    /**
+     * Update data without changing status.
+     *
+     * The updater receives a structuredClone of current data.
+     * If the updater throws, no changes are applied.
+     * On success, state is persisted immediately.
+     */
+    async update(updater) {
+        const data = structuredClone(this.tracker.state.data);
+        updater(data);
+        this.tracker.set({ status: this.status, data });
+        await this.tracker.saveAsync();
+        this.emitEvent("update");
+    }
+    /** Check if a specific transition is allowed from current status */
+    canTransition(to) {
+        return this.transitions[this.status].includes(to);
+    }
+    /** Get statuses reachable from current status */
+    allowedTransitions() {
+        return this.transitions[this.status];
+    }
+    /** Force-save current state to disk */
+    async save() {
+        await this.tracker.saveAsync();
+    }
+    emitEvent(type, from, to) {
+        this.onTransitionCb?.({
+            type,
+            from,
+            to,
+            status: this.status,
+            data: this.data,
+            timestamp: new Date().toISOString(),
+        });
+    }
+}
+exports.WorkflowEngine = WorkflowEngine;
+//# sourceMappingURL=WorkflowEngine.js.map

package/dist/WorkflowEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowEngine.js","sourceRoot":"","sources":["../src/WorkflowEngine.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { WorkflowEngine } from "./WorkflowEngine.js";
+export type { WorkflowEngineOptions, TransitionEvent, TransitionMap, DataUpdater, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowEngine = void 0;
+var WorkflowEngine_js_1 = require("./WorkflowEngine.js");
+Object.defineProperty(exports, "WorkflowEngine", { enumerable: true, get: function () { return WorkflowEngine_js_1.WorkflowEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yDAAqD;AAA5C,mHAAA,cAAc,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Allowed transitions per status.
+ * Each key is a status, its value is the list of statuses it can transition to.
+ * Statuses with empty arrays are terminal (no outgoing transitions).
+ */
+export type TransitionMap<TStatus extends string> = Record<TStatus, readonly TStatus[]>;
+/**
+ * Callback that receives a mutable draft of the data.
+ * Mutations are applied if the function returns without throwing.
+ */
+export type DataUpdater<TData> = (draft: TData) => void;
+/**
+ * Event emitted on transitions, updates, and loads.
+ */
+export interface TransitionEvent<TStatus extends string, TData> {
+    type: "transition" | "update" | "load";
+    from?: TStatus;
+    to?: TStatus;
+    status: TStatus;
+    data: Readonly<TData>;
+    timestamp: string;
+}
+/**
+ * Configuration for WorkflowEngine.
+ */
+export interface WorkflowEngineOptions<TStatus extends string, TData> {
+    /** Unique key for StateTracker persistence */
+    key: string;
+    /** Initial status when creating a new workflow */
+    initialStatus: TStatus;
+    /** Initial data when creating a new workflow */
+    initialData: TData;
+    /** Map of allowed transitions: status -> allowed next statuses */
+    transitions: TransitionMap<TStatus>;
+    /** Directory for state persistence */
+    stateDirectory?: string;
+    /** Auto-save interval in ms (default 5000) */
+    autoSaveMs?: number;
+    /** Called on transitions, updates, and loads */
+    onTransition?: (event: TransitionEvent<TStatus, TData>) => void;
+}
+/**
+ * Internal persisted shape: status + data together.
+ */
+export interface PersistedState<TStatus extends string, TData> {
+    status: TStatus;
+    data: TData;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,IAAI,MAAM,CACxD,OAAO,EACP,SAAS,OAAO,EAAE,CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK;IAC5D,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK;IAClE,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,WAAW,EAAE,KAAK,CAAC;IACnB,kEAAkE;IAClE,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK;IAC3D,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;CACb"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@hardlydifficult/workflow-engine",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@hardlydifficult/state-tracker": "file:../state-tracker"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.31",
+    "typescript": "5.8.3",
+    "vitest": "1.6.1"
+  },
+  "peerDependencies": {
+    "@hardlydifficult/state-tracker": ">=2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}