ts-workflow-engine-lite 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sario
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,352 @@
+# ts-workflow-engine-lite
+
+A lightweight TypeScript workflow engine for embedded, single-process
+applications. It includes workflow execution, a REST API, events, Cron
+scheduling, retries, and local file persistence. Redis and databases are not
+required for local use.
+
+## Install
+
+Add the library to an existing TypeScript project:
+
+```bash
+pnpm add ts-workflow-engine-lite
+```
+
+Node.js 18 or newer is required.
+
+The package is published as an ES module. Use ESM imports from JavaScript or
+TypeScript:
+
+```js
+import { bootstrap, destroyContainer } from "ts-workflow-engine-lite";
+```
+
+TypeScript consumers can use either `moduleResolution: "NodeNext"` or
+`"Bundler"`. This repository keeps extensionless relative imports in its
+TypeScript source; the build step adds the required `.js` extensions only to
+the generated `dist` files.
+
+When working from this repository instead, install the development dependencies
+and run the checked-in quick start:
+
+```bash
+pnpm install
+pnpm example:quickstart
+```
+
+## 5-minute TypeScript quick start
+
+The package entry point is side-effect free. Importing it does not start a
+server, register process handlers, or run a demo.
+
+```ts
+import {
+  bootstrap,
+  destroyContainer,
+  type WorkflowDefinition,
+} from "ts-workflow-engine-lite";
+
+const workflow: WorkflowDefinition = {
+  id: "hello",
+  name: "Hello workflow",
+  startNode: "greet",
+  nodes: {
+    greet: {
+      id: "greet",
+      type: "action",
+      action: async (instance) => ({
+        message: `Hello, ${instance?.context?.name ?? "world"}!`,
+      }),
+      next: [],
+    },
+  },
+};
+
+const { engine, container } = await bootstrap({
+  skipGracefulShutdown: true,
+  logLevel: "WARN",
+});
+
+try {
+  await engine.register(workflow);
+  const instanceId = await engine.start("hello", { name: "Ada" });
+  const instance = await engine.waitForCompletion(instanceId);
+
+  console.log(instance.status); // completed
+  console.log(instance.state?.nodes?.greet?.output);
+} finally {
+  engine.destroy();
+  await destroyContainer(container);
+}
+```
+
+`waitForCompletion()` returns when an instance is `completed`, `failed`, or
+`cancelled`. It accepts `timeoutMs`, `pollIntervalMs`, and an `AbortSignal`.
+
+### Which initialization API should I use?
+
+The package exposes two ways to get a running `WorkflowEngineV2`:
+
+| API                                                                              | Use when                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `bootstrap(options)`                                                             | **Default choice.** One call wires storage, secret manager, optional worker pool and archiving, and graceful shutdown, then returns `{ engine, container }`. Matches what the CLI and the quick start above use.                                                                                                                                                                                                          |
+| `createContainer(options)` + `setContainer(container)` + `createEngine(options)` | You need finer control over initialization order (e.g. registering workflows or a custom `SecretManager` between container and engine creation), or you're composing multiple engines against containers you manage yourself. `createEngine()` reads its container from the process-wide singleton set by `setContainer()` — call `createContainer` and `setContainer` first, or it throws `"Container not initialized"`. |
+
+`bootstrap()` also calls `setContainer(container)` internally, so its
+returned `container` is the same process-wide singleton `createEngine()`
+reads from — you can still call `createEngine()` again afterwards (e.g. to
+create a second engine sharing that container) without calling
+`setContainer` yourself.
+
+## Run the examples
+
+```bash
+pnpm example:quickstart        # minimal embedded workflow
+pnpm example:order             # condition branch and multi-step order workflow
+pnpm example:embedded-express  # mounting createWorkflowRouter into a host Express app
+pnpm example:error-handling    # catching WorkflowNotFoundError / InstanceNotFoundError
+pnpm dev                       # event-driven built-in demo
+```
+
+## Run the REST API
+
+```bash
+pnpm dev:api
+```
+
+The API starts on `http://localhost:3345` with local file storage:
+
+```bash
+curl http://localhost:3345/workflow-api/v1/workflows
+```
+
+Interactive OpenAPI documentation is available at:
+
+```text
+http://localhost:3345/api-docs
+```
+
+The CLI entry point creates `.env` from `.env.example` when needed. The
+embedded `bootstrap()` API reads the current environment but does not create or
+load an `.env` file automatically.
+
+### Mounting into an existing Express app
+
+`startApiServer()` above creates and starts its own standalone `express()`
+app — use it when this package should run as its own HTTP service. To
+instead mount the workflow API as a router inside a host application's
+existing Express app (sharing its port, body parser, and auth middleware),
+use `createWorkflowRouter()`:
+
+```ts
+import express from "express";
+import { bootstrap, createWorkflowRouter } from "ts-workflow-engine-lite";
+
+const { engine, container } = await bootstrap({ skipGracefulShutdown: true });
+
+const app = express();
+app.use(express.json());
+// Apply your own auth/rate-limit middleware here if needed.
+app.use(
+  "/workflow-api/v1",
+  await createWorkflowRouter(engine, container.storage),
+);
+
+app.listen(3000);
+```
+
+The router exposes `/workflows`, `/instances`, `/events`, `/webhooks`,
+`/dlq`, `/templates`, `/analytics`, `/functions`, `/health`, and (unless
+`{ enableMetrics: false }` is passed) `/metrics`. It expects
+`express.json()` to already have run, and does **not** include
+`startApiServer`'s standalone-service concerns — helmet/CORS, rate
+limiting, JWT auth, the welcome/docs pages, or the WebSocket console
+stream. Add whatever of those the host app needs on its own app instance
+before mounting this router.
+
+## Configuration
+
+Set `WORKFLOW_ENGINE_LOG_LEVEL` to `DEBUG`, `INFO`, `WARN`, or `ERROR`.
+Embedded applications can override it with `bootstrap({ logLevel: "WARN" })`
+or change it later with `Logger.setLevel()`.
+
+### Storage modes
+
+| Mode     | Intended use                          | Restart recovery |
+| -------- | ------------------------------------- | ---------------- |
+| `file`   | Default single-process runtime        | Yes              |
+| `memory` | Tests and intentionally ephemeral use | No               |
+
+Local file persistence is enabled by default outside tests. Runtime state is
+stored below `.ts-workflow-engine-data/` using one JSON file per record and atomic temp
+file replacement:
+
+```bash
+STORAGE_TYPE=file
+STORAGE_DIR=.ts-workflow-engine-data
+```
+
+The storage directory is organized by record type:
+
+```text
+.ts-workflow-engine-data/
+├── instances/
+├── workflows/
+├── workflow-metadata/
+├── workflow-versions/
+├── waiting/
+├── metrics/
+├── events/
+├── heartbeats/
+└── dlq/
+```
+
+Each collection also has a `corrupt/` directory. A record that cannot be parsed
+during startup is moved there so one damaged file does not prevent the engine
+from starting. Inspect and recover quarantined files manually; they are not
+loaded automatically.
+
+### Restart recovery
+
+JSON/config-based workflow definitions are restored automatically. Workflow
+definitions containing JavaScript functions or closures cannot be serialized,
+so application code must register those definitions again before resuming
+unfinished instances:
+
+```ts
+const { engine } = await bootstrap({
+  storageType: "file",
+  resumeRunningInstances: false,
+});
+
+await engine.register(workflowWithFunctions);
+await engine.resumeRunningInstancesFromStorage();
+```
+
+`RESUME_ON_STARTUP=true` applies to API mode. Leave it disabled, or set
+`resumeRunningInstances: false` in embedded use, when closure-based workflows
+must be registered first. Embedded applications otherwise opt into recovery
+with `resumeRunningInstances: true`.
+
+### Archive management
+
+Terminal-instance archiving is disabled by default so completed instances stay
+available to queries until normal TTL cleanup. To archive terminal instances
+as date-partitioned local JSON and evict them from hot storage, opt in:
+
+```bash
+ARCHIVE_ENABLED=true
+ARCHIVE_DIR=./archive
+ARCHIVE_RETENTION_DAYS=90
+ARCHIVE_CLEANUP_INTERVAL_MS=21600000
+```
+
+Archive files use `archive/YYYY-MM-DD/<instanceId>.json`. An instance is removed
+from hot storage only after its archive file has been written successfully.
+Expired date partitions are deleted according to `ARCHIVE_RETENTION_DAYS` on
+startup and at the configured cleanup interval. Archived instances are cold
+files: they are not automatically returned by normal instance queries or
+restored into hot storage.
+
+The equivalent embedded options are `storageType`, `storageDirectory`,
+`enableArchiving`, `archiveDirectory`, and `archiveRetentionDays`.
+
+### Backup and restore
+
+Back up `STORAGE_DIR` for active state and `ARCHIVE_DIR` separately when
+archiving is enabled. For a consistent backup across collections, stop the
+engine cleanly before copying the directories. Restore by copying them back to
+the configured paths before startup. Do not edit active JSON files while the
+engine is running.
+
+## Error handling
+
+The engine throws named error classes (exported from the package root) for
+the highest-frequency lookup/concurrency failure modes, so callers can
+`instanceof`-check them instead of matching `Error.message` strings:
+
+| Class                      | Thrown when                                                                                                                                                                                   |
+| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `WorkflowNotFoundError`    | `engine.start()` / `engine.dryRun()` / internal execution reference a `workflowId` (optionally a specific `version`) that isn't registered. Has `.workflowId` and `.version`.                 |
+| `InstanceNotFoundError`    | `engine.signal()` / `engine.query()` / `engine.update()` / `waitForCompletion()` reference an `instanceId` that doesn't resolve to a stored instance. Has `.instanceId`.                      |
+| `ConcurrencyConflictError` | Optimistic concurrency control (CAS) exhausts its retry budget persisting an instance update — another writer kept winning the race on `instance.version`. Has `.instanceId` and `.attempts`. |
+| `LockAcquisitionError`     | `ConcurrencyControl.withLock()` fails to acquire a lock within its retry budget. Has `.resourceId`.                                                                                           |
+
+Other failures (timeouts, invalid state transitions, the max-instances
+limit, schema validation via `DataValidationError`) still throw plain
+`Error` or their own existing error class — see
+[`examples/error-handling.ts`](./examples/error-handling.ts) for a runnable
+demonstration.
+
+## Supported workflow features
+
+- Node types: `action`, `wait`, `event`, `rollback`, `subworkflow`, `condition`,
+  `router`, `loop`, `http`, `sql`, `queue`, `notification`, and `approval`
+- Event bus, hooks, deduplication, Cron scheduling, retries, heartbeats, and
+  dead-letter queue handling
+- REST API for workflows, instances, signals, queries, updates, templates,
+  webhooks, events, analytics, and the dead-letter queue
+- Expression evaluation with built-in and custom functions
+
+## Scope and limitations
+
+This project is intentionally single-process. Local file storage protects state
+across ordinary process restarts, but it is not a transactional database and
+the same `STORAGE_DIR` must never be shared by multiple engine processes.
+Process-local leases, rate limits, idempotency keys, the event bus, and Cron
+scheduling do not provide distributed coordination. The project also does not
+provide clustering, multi-tenancy isolation, GraphQL, or a visual editor.
+
+## Development scripts
+
+```bash
+pnpm build          # clean and compile TypeScript to dist/
+pnpm test           # run Vitest
+pnpm typecheck      # type-check source, tests, and examples
+pnpm lint           # run oxlint checks
+pnpm format:check   # verify formatting
+```
+
+## Optional API layer
+
+The REST API is optional. Core engine imports never pull in `express`, `cors`,
+`helmet`, or any HTTP framework. If you only need the workflow engine, skip
+those dependencies entirely:
+
+```bash
+# Core only (no REST API)
+pnpm add ts-workflow-engine-lite
+```
+
+If you need the REST API, install the peer dependencies:
+
+```bash
+# Full install with REST API
+pnpm add ts-workflow-engine-lite express cors helmet morgan ws swagger-ui-dist
+```
+
+API-related exports (`startApiServer`, `createWorkflowRouter`) use dynamic
+`import()` internally and will throw a clear error if the HTTP packages
+are not installed.
+
+## Examples
+
+| Example                                                         | Script                          | Description                                      |
+| --------------------------------------------------------------- | ------------------------------- | ------------------------------------------------ |
+| [quickstart.ts](./examples/quickstart.ts)                       | `pnpm example:quickstart`       | Minimal workflow with condition routing          |
+| [order-processing.ts](./examples/order-processing.ts)           | `pnpm example:order`            | Multi-step order processing pipeline             |
+| [embedded-express-app.ts](./examples/embedded-express-app.ts)   | `pnpm example:embedded-express` | Embed API in a host Express app                  |
+| [error-handling.ts](./examples/error-handling.ts)               | `pnpm example:error-handling`   | Named error classes and retry handling           |
+| [multi-tenant-workflow.ts](./examples/multi-tenant-workflow.ts) | `pnpm example:multi-tenant`     | Tenant-isolated workflows with condition routing |
+| [approval-pipeline.ts](./examples/approval-pipeline.ts)         | `pnpm example:approval`         | Long-running approval with timeout               |
+| [http-orchestration.ts](./examples/http-orchestration.ts)       | `pnpm example:http`             | HTTP integration with conditional routing        |
+| [parallel-fan-out.ts](./examples/parallel-fan-out.ts)           | `pnpm example:parallel`         | Parallel processing with merge                   |
+| [graceful-degradation.ts](./examples/graceful-degradation.ts)   | `pnpm example:degradation`      | Fallback paths and dead letter queues            |
+| [headless-engine.ts](./examples/headless-engine.ts)             | `pnpm example:headless`         | Pure programmatic usage, no API server           |
+| [worker-pool.ts](./examples/worker-pool.ts)                     | `pnpm example:worker-pool`      | CPU-intensive tasks with worker threads          |
+| [cron-data-sync.ts](./examples/cron-data-sync.ts)               | `pnpm example:cron-sync`        | Scheduled data synchronization                   |
+
+## License
+
+MIT

package/dist/src/api/ConsoleWebSocketManager.d.ts

@@ -0,0 +1,57 @@
+import type { IncomingMessage } from "http";
+import type { WebSocket } from "ws";
+import type { HookEventName, HookPayload } from "../event/HookManager.js";
+import type { WorkflowInstance } from "../model/Instance.js";
+import type { StorageProvider } from "../storage/StorageProvider.js";
+export interface InstanceUpdate {
+    instanceId: string;
+    timestamp: number;
+    type: "status" | "node" | "error" | "completed";
+    data: Record<string, unknown>;
+}
+export interface ConsoleConnectedMessage {
+    type: "connected";
+    mode: "global" | "instance";
+    timestamp: number;
+    instanceId?: string;
+    instance?: WorkflowInstance | null;
+    message?: string;
+}
+export interface ConsolePongMessage {
+    type: "pong";
+    timestamp: number;
+}
+export type ConsoleHookData = HookPayload | (HookPayload & {
+    childInstanceId: string;
+    parentInstanceId: string;
+});
+export interface ConsoleHookMessage {
+    type: "hook";
+    event: HookEventName;
+    instanceId?: string;
+    workflowId?: string;
+    nodeId?: string;
+    status?: string;
+    timestamp: string;
+    data: ConsoleHookData;
+}
+export type ConsoleWebSocketMessage = ConsoleConnectedMessage | ConsolePongMessage | ConsoleHookMessage;
+export declare class ConsoleWebSocketManager {
+    private globalConnections;
+    private instanceConnections;
+    private storage?;
+    constructor(storage?: StorageProvider);
+    handleGlobalConnection(ws: WebSocket, _req: IncomingMessage): void;
+    handleConnection(ws: WebSocket, instanceId: string, _req: IncomingMessage): void;
+    broadcastHook(payload: HookPayload): void;
+    broadcastUpdate(instanceId: string, update: InstanceUpdate): void;
+    private sendInitialState;
+    private sendMessage;
+    private removeInstanceConnection;
+    getStats(): {
+        globalConnections: number;
+        instanceConnections: number;
+        instanceCount: number;
+    };
+    shutdown(): void;
+}

package/dist/src/api/ConsoleWebSocketManager.js

@@ -0,0 +1,206 @@
+import { errorMessage, Logger } from "../utils/Logger.js";
+const INSTANCE_UPDATE_EVENT_MAP = {
+    status: "workflow.started",
+    node: "node.started",
+    error: "workflow.failed",
+    completed: "workflow.completed",
+};
+export class ConsoleWebSocketManager {
+    globalConnections = new Set();
+    instanceConnections = new Map();
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    handleGlobalConnection(ws, _req) {
+        Logger.info("api", "console-ws", "New global WebSocket connection");
+        this.globalConnections.add(ws);
+        this.sendMessage(ws, {
+            type: "connected",
+            mode: "global",
+            timestamp: Date.now(),
+        });
+        ws.on("message", (message) => {
+            try {
+                const data = JSON.parse(message.toString());
+                if (data.type === "ping") {
+                    this.sendMessage(ws, { type: "pong", timestamp: Date.now() });
+                }
+            }
+            catch {
+            }
+        });
+        ws.on("close", () => {
+            this.globalConnections.delete(ws);
+            Logger.info("api", "console-ws", "Global WebSocket connection closed");
+        });
+        ws.on("error", (error) => {
+            Logger.error("api", "console-ws", `Global WebSocket error: ${error.message}`);
+            this.globalConnections.delete(ws);
+        });
+    }
+    handleConnection(ws, instanceId, _req) {
+        Logger.info("api", "console-ws", `New instance WebSocket connection for ${instanceId}`);
+        if (!this.instanceConnections.has(instanceId)) {
+            this.instanceConnections.set(instanceId, new Set());
+        }
+        this.instanceConnections.get(instanceId).add(ws);
+        this.sendInitialState(ws, instanceId).catch((error) => {
+            Logger.error("api", "console-ws", `Failed to send initial state: ${errorMessage(error)}`);
+        });
+        ws.on("message", (message) => {
+            try {
+                const data = JSON.parse(message.toString());
+                if (data.type === "ping") {
+                    this.sendMessage(ws, { type: "pong", timestamp: Date.now() });
+                }
+            }
+            catch {
+            }
+        });
+        ws.on("close", () => {
+            this.removeInstanceConnection(instanceId, ws);
+        });
+        ws.on("error", (error) => {
+            Logger.error("api", "console-ws", `Instance WebSocket error for ${instanceId}: ${error.message}`);
+            this.removeInstanceConnection(instanceId, ws);
+        });
+    }
+    broadcastHook(payload) {
+        const message = {
+            type: "hook",
+            event: payload.event,
+            instanceId: payload.instanceId,
+            workflowId: payload.workflowId,
+            nodeId: payload.nodeId,
+            status: payload.status,
+            timestamp: payload.timestamp ?? new Date().toISOString(),
+            data: payload,
+        };
+        for (const ws of this.globalConnections) {
+            this.sendMessage(ws, message);
+        }
+        if (payload.instanceId) {
+            const conns = this.instanceConnections.get(payload.instanceId);
+            if (conns) {
+                for (const ws of conns) {
+                    this.sendMessage(ws, message);
+                }
+            }
+            if ((payload.event === "workflow.completed" ||
+                payload.event === "workflow.failed") &&
+                this.storage) {
+                void this.storage
+                    .loadInstance(payload.instanceId)
+                    .then((instance) => {
+                    const parentId = instance?.parentInstanceId;
+                    if (!parentId)
+                        return;
+                    const parentConns = this.instanceConnections.get(parentId);
+                    if (!parentConns)
+                        return;
+                    const parentMessage = {
+                        ...message,
+                        type: "hook",
+                        event: `subworkflow.${payload.event === "workflow.completed" ? "completed" : "failed"}`,
+                        data: {
+                            ...payload,
+                            childInstanceId: payload.instanceId,
+                            parentInstanceId: parentId,
+                        },
+                    };
+                    for (const ws of parentConns) {
+                        this.sendMessage(ws, parentMessage);
+                    }
+                })
+                    .catch(() => {
+                });
+            }
+        }
+    }
+    broadcastUpdate(instanceId, update) {
+        this.broadcastHook({
+            event: INSTANCE_UPDATE_EVENT_MAP[update.type],
+            instanceId,
+            workflowId: "",
+            timestamp: String(update.timestamp),
+            ...update.data,
+        });
+    }
+    async sendInitialState(ws, instanceId) {
+        if (!this.storage) {
+            this.sendMessage(ws, {
+                type: "connected",
+                mode: "instance",
+                instanceId,
+                message: "Storage not available – hook events only",
+                timestamp: Date.now(),
+            });
+            return;
+        }
+        try {
+            const instance = await this.storage.loadInstance(instanceId);
+            this.sendMessage(ws, {
+                type: "connected",
+                mode: "instance",
+                instanceId,
+                instance: instance ?? null,
+                timestamp: Date.now(),
+            });
+        }
+        catch (error) {
+            Logger.error("api", "console-ws", `Failed to load instance ${instanceId}: ${errorMessage(error)}`);
+            this.sendMessage(ws, {
+                type: "connected",
+                mode: "instance",
+                instanceId,
+                instance: null,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    sendMessage(ws, message) {
+        if (ws.readyState === 1) {
+            try {
+                ws.send(JSON.stringify(message));
+            }
+            catch (error) {
+                Logger.error("api", "console-ws", `Failed to send message: ${errorMessage(error)}`);
+            }
+        }
+    }
+    removeInstanceConnection(instanceId, ws) {
+        const connections = this.instanceConnections.get(instanceId);
+        if (connections) {
+            connections.delete(ws);
+            if (connections.size === 0) {
+                this.instanceConnections.delete(instanceId);
+            }
+        }
+    }
+    getStats() {
+        let instanceConnections = 0;
+        for (const conns of this.instanceConnections.values()) {
+            instanceConnections += conns.size;
+        }
+        return {
+            globalConnections: this.globalConnections.size,
+            instanceConnections,
+            instanceCount: this.instanceConnections.size,
+        };
+    }
+    shutdown() {
+        for (const ws of this.globalConnections) {
+            ws.close();
+        }
+        this.globalConnections.clear();
+        for (const conns of this.instanceConnections.values()) {
+            for (const ws of conns) {
+                ws.close();
+            }
+        }
+        this.instanceConnections.clear();
+        Logger.info("api", "console-ws", "WebSocket manager shut down");
+    }
+}
+//# sourceMappingURL=ConsoleWebSocketManager.js.map

package/dist/src/api/ConsoleWebSocketManager.js.map

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