@dudousxd/nestjs-durable-core 0.1.0

package/dist/testing/in-memory-state-store.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStateStore = void 0;
+/**
+ * A non-durable, in-process `StateStore` for tests and local development.
+ * The shipped `@dudousxd/nestjs-durable-store` package re-exports an equivalent.
+ */
+class InMemoryStateStore {
+    runs = new Map();
+    checkpoints = new Map();
+    signalWaiters = new Map();
+    key(runId, seq) {
+        return `${runId}:${seq}`;
+    }
+    async createRun(run) {
+        this.runs.set(run.id, { ...run });
+    }
+    async updateRun(runId, patch) {
+        const existing = this.runs.get(runId);
+        if (!existing)
+            throw new Error(`run ${runId} not found`);
+        this.runs.set(runId, { ...existing, ...patch });
+    }
+    async getRun(runId) {
+        const run = this.runs.get(runId);
+        return run ? { ...run } : null;
+    }
+    async getCheckpoint(runId, seq) {
+        const cp = this.checkpoints.get(this.key(runId, seq));
+        return cp ? { ...cp } : null;
+    }
+    async saveCheckpoint(checkpoint) {
+        this.checkpoints.set(this.key(checkpoint.runId, checkpoint.seq), { ...checkpoint });
+    }
+    async listIncompleteRuns() {
+        return [...this.runs.values()].filter((r) => r.status === 'running').map((r) => ({ ...r }));
+    }
+    async listDueTimers(nowMs) {
+        return [...this.runs.values()]
+            .filter((r) => r.status === 'suspended' && r.wakeAt !== undefined && r.wakeAt <= nowMs)
+            .map((r) => ({ ...r }));
+    }
+    async tryLockRun(runId, owner, leaseUntilMs, nowMs) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return false;
+        if (run.lockedUntil !== undefined && run.lockedUntil > nowMs)
+            return false;
+        run.lockedBy = owner;
+        run.lockedUntil = leaseUntilMs;
+        return true;
+    }
+    async releaseRunLock(runId) {
+        const run = this.runs.get(runId);
+        if (run) {
+            run.lockedBy = undefined;
+            run.lockedUntil = undefined;
+        }
+    }
+    async putSignalWaiter(waiter) {
+        this.signalWaiters.set(waiter.token, { ...waiter });
+    }
+    async takeSignalWaiter(token) {
+        const waiter = this.signalWaiters.get(token);
+        if (!waiter)
+            return null;
+        this.signalWaiters.delete(token);
+        return { ...waiter };
+    }
+    async listRuns(query) {
+        let runs = [...this.runs.values()];
+        if (query.workflow)
+            runs = runs.filter((r) => r.workflow === query.workflow);
+        if (query.status)
+            runs = runs.filter((r) => r.status === query.status);
+        const offset = query.offset ?? 0;
+        const limit = query.limit ?? runs.length;
+        return runs.slice(offset, offset + limit).map((r) => ({ ...r }));
+    }
+    async listCheckpoints(runId) {
+        return [...this.checkpoints.values()]
+            .filter((cp) => cp.runId === runId)
+            .sort((a, b) => a.seq - b.seq)
+            .map((cp) => ({ ...cp }));
+    }
+}
+exports.InMemoryStateStore = InMemoryStateStore;
+//# sourceMappingURL=in-memory-state-store.js.map

package/dist/testing/in-memory-state-store.js.map

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

package/dist/testing/in-memory-transport.d.ts

@@ -0,0 +1,16 @@
+import type { Heartbeat, RemoteTask, StepResult, Transport } from '../interfaces';
+import { type StepHandler } from '../protocol';
+/**
+ * An in-process `Transport` for tests and local development: registered handlers stand in
+ * for remote workers, so a whole cross-app workflow runs in a single process.
+ */
+export declare class InMemoryTransport implements Transport {
+    private readonly handlers;
+    private resultHandler?;
+    /** Register a fake worker handler for a step name. */
+    handle(name: string, fn: StepHandler): void;
+    dispatch(task: RemoteTask): Promise<void>;
+    onResult(handler: (result: StepResult) => Promise<void>): void;
+    onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void;
+}
+//# sourceMappingURL=in-memory-transport.d.ts.map

package/dist/testing/in-memory-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-transport.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE/D;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,aAAa,CAAC,CAAwC;IAE9D,sDAAsD;IACtD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAIrC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI9D,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGhE"}

package/dist/testing/in-memory-transport.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryTransport = void 0;
+const protocol_1 = require("../protocol");
+/**
+ * An in-process `Transport` for tests and local development: registered handlers stand in
+ * for remote workers, so a whole cross-app workflow runs in a single process.
+ */
+class InMemoryTransport {
+    handlers = new Map();
+    resultHandler;
+    /** Register a fake worker handler for a step name. */
+    handle(name, fn) {
+        this.handlers.set(name, fn);
+    }
+    async dispatch(task) {
+        if (!this.resultHandler)
+            throw new Error('no result handler registered');
+        await this.resultHandler(await (0, protocol_1.runStepHandler)(task, this.handlers.get(task.name)));
+    }
+    onResult(handler) {
+        this.resultHandler = handler;
+    }
+    onHeartbeat(_handler) {
+        // In-process handlers run synchronously; there is no liveness to track.
+    }
+}
+exports.InMemoryTransport = InMemoryTransport;
+//# sourceMappingURL=in-memory-transport.js.map

package/dist/testing/in-memory-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-transport.js","sourceRoot":"","sources":["../../src/testing/in-memory-transport.ts"],"names":[],"mappings":";;;AACA,0CAA+D;AAE/D;;;GAGG;AACH,MAAa,iBAAiB;IACX,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IACnD,aAAa,CAAyC;IAE9D,sDAAsD;IACtD,MAAM,CAAC,IAAY,EAAE,EAAe;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAgB;QAC7B,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACzE,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,IAAA,yBAAc,EAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,QAAQ,CAAC,OAA8C;QACrD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,QAA4C;QACtD,wEAAwE;IAC1E,CAAC;CACF;AArBD,8CAqBC"}

package/dist/tokens.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dependency-injection tokens. Adapters bind their implementations to these so `core` and
+ * `@dudousxd/nestjs-durable` depend only on the interfaces in `./interfaces`.
+ */
+export declare const STATE_STORE: unique symbol;
+export declare const TRANSPORT: unique symbol;
+export declare const DURABLE_OPTIONS: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,WAAW,eAAuC,CAAC;AAChE,eAAO,MAAM,SAAS,eAAqC,CAAC;AAC5D,eAAO,MAAM,eAAe,eAA2C,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Dependency-injection tokens. Adapters bind their implementations to these so `core` and
+ * `@dudousxd/nestjs-durable` depend only on the interfaces in `./interfaces`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DURABLE_OPTIONS = exports.TRANSPORT = exports.STATE_STORE = void 0;
+exports.STATE_STORE = Symbol('nestjs-durable:STATE_STORE');
+exports.TRANSPORT = Symbol('nestjs-durable:TRANSPORT');
+exports.DURABLE_OPTIONS = Symbol('nestjs-durable:DURABLE_OPTIONS');
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEU,QAAA,WAAW,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AACnD,QAAA,SAAS,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAC/C,QAAA,eAAe,GAAG,MAAM,CAAC,gCAAgC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@dudousxd/nestjs-durable-core",
+  "version": "0.1.0",
+  "description": "Durable workflows for NestJS — core interfaces, engine and deterministic replay",
+  "license": "MIT",
+  "author": "Davide Carvalho",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DavideCarvalho/nestjs-durable.git",
+    "directory": "packages/core"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "reflect-metadata": "^0.2.0",
+    "zod": "^3.0.0 || ^4.0.0"
+  },
+  "devDependencies": {
+    "reflect-metadata": "0.2.2",
+    "typescript": "5.9.3",
+    "zod": "3.25.76"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}