@adonis-agora/durable 0.1.0

package/dist/src/testing/in-memory-state-store.d.ts

@@ -0,0 +1,64 @@
+import type { RunQuery, SignalWaiter, StateStore, StepCheckpoint, WorkflowRun } from '../interfaces.js';
+/**
+ * A non-durable, in-process `StateStore` for tests and local development.
+ * The shipped `@dudousxd/nestjs-durable-store` package re-exports an equivalent.
+ */
+export declare class InMemoryStateStore implements StateStore {
+    private readonly runs;
+    private readonly checkpoints;
+    private readonly signalWaiters;
+    /**
+     * Normalized search-attribute side-table, the in-memory analog of the SQL stores'
+     * `durable_run_attributes`: `key -> (runId -> row)`. Maintained on every create/update so an
+     * attribute query can be pushed DOWN to a key-indexed candidate set instead of scanning every run
+     * and comparing in-process. Mirrors {@link normalizeAttributeRows} so behavior matches the SQL path.
+     */
+    private readonly attributeIndex;
+    /** Test/observability hook: how many candidate runs the last attribute query's index produced. */
+    lastAttributeCandidates: number;
+    /**
+     * Test/observability hook: how many checkpoint rows the LAST checkpoint read materialized (the rows
+     * actually returned to the caller). `listCheckpoints` returns all rows for the run; the targeted
+     * {@link getLatestCheckpointByName} / {@link listCheckpointsByNamePrefix} return only the matches —
+     * so this lets the benchmark contrast "fetch N, scan in JS" against "fetch the k that match".
+     */
+    lastCheckpointRowsRead: number;
+    private key;
+    /** Drop then re-add a run's normalized attribute rows so the index tracks its current attributes. */
+    private reindexAttributes;
+    createRun(run: WorkflowRun): Promise<void>;
+    updateRun(runId: string, patch: Partial<WorkflowRun>): Promise<void>;
+    getRun(runId: string): Promise<WorkflowRun | null>;
+    deleteRun(runId: string): Promise<void>;
+    getCheckpoint(runId: string, seq: number): Promise<StepCheckpoint | null>;
+    saveCheckpoint(checkpoint: StepCheckpoint): Promise<void>;
+    listIncompleteRuns(): Promise<WorkflowRun[]>;
+    listPendingRuns(limit: number): Promise<WorkflowRun[]>;
+    listDueTimers(nowMs: number): Promise<WorkflowRun[]>;
+    tryLockRun(runId: string, owner: string, leaseUntilMs: number, nowMs: number): Promise<boolean>;
+    releaseRunLock(runId: string): Promise<void>;
+    renewRunLock(runId: string, owner: string, leaseUntilMs: number): Promise<boolean>;
+    putSignalWaiter(waiter: SignalWaiter): Promise<void>;
+    takeSignalWaiter(token: string): Promise<SignalWaiter | null>;
+    listSignalWaiters(prefix: string): Promise<SignalWaiter[]>;
+    transaction<T>(work: (tx: {
+        raw: unknown;
+        saveCheckpoint: (cp: StepCheckpoint) => Promise<void>;
+    }) => Promise<T>): Promise<T>;
+    private readonly bufferedSignals;
+    bufferSignal(token: string, payload: unknown): Promise<void>;
+    takeBufferedSignal(token: string): Promise<{
+        payload: unknown;
+    } | null>;
+    /**
+     * Candidate run ids satisfying ONE attribute predicate, served from {@link attributeIndex} — the
+     * pushdown step. Numeric predicates scan only `numValue` rows under the key; string/boolean ones
+     * scan `strValue` rows. This is the in-memory analog of the SQL EXISTS on `durable_run_attributes`.
+     */
+    private candidatesForFilter;
+    listRuns(query: RunQuery): Promise<WorkflowRun[]>;
+    listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
+    getLatestCheckpointByName(runId: string, name: string): Promise<StepCheckpoint | undefined>;
+    listCheckpointsByNamePrefix(runId: string, prefixes: string[]): Promise<StepCheckpoint[]>;
+}
+//# sourceMappingURL=in-memory-state-store.d.ts.map

package/dist/src/testing/in-memory-state-store.d.ts.map

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

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

@@ -0,0 +1,259 @@
+import { normalizeAttributeRows } from '../search-attributes.js';
+/**
+ * A non-durable, in-process `StateStore` for tests and local development.
+ * The shipped `@dudousxd/nestjs-durable-store` package re-exports an equivalent.
+ */
+export class InMemoryStateStore {
+    runs = new Map();
+    checkpoints = new Map();
+    signalWaiters = new Map();
+    /**
+     * Normalized search-attribute side-table, the in-memory analog of the SQL stores'
+     * `durable_run_attributes`: `key -> (runId -> row)`. Maintained on every create/update so an
+     * attribute query can be pushed DOWN to a key-indexed candidate set instead of scanning every run
+     * and comparing in-process. Mirrors {@link normalizeAttributeRows} so behavior matches the SQL path.
+     */
+    attributeIndex = new Map();
+    /** Test/observability hook: how many candidate runs the last attribute query's index produced. */
+    lastAttributeCandidates = 0;
+    /**
+     * Test/observability hook: how many checkpoint rows the LAST checkpoint read materialized (the rows
+     * actually returned to the caller). `listCheckpoints` returns all rows for the run; the targeted
+     * {@link getLatestCheckpointByName} / {@link listCheckpointsByNamePrefix} return only the matches —
+     * so this lets the benchmark contrast "fetch N, scan in JS" against "fetch the k that match".
+     */
+    lastCheckpointRowsRead = 0;
+    key(runId, seq) {
+        return `${runId}:${seq}`;
+    }
+    /** Drop then re-add a run's normalized attribute rows so the index tracks its current attributes. */
+    reindexAttributes(runId, attributes) {
+        for (const byRun of this.attributeIndex.values())
+            byRun.delete(runId);
+        for (const row of normalizeAttributeRows(runId, attributes)) {
+            let byRun = this.attributeIndex.get(row.key);
+            if (!byRun) {
+                byRun = new Map();
+                this.attributeIndex.set(row.key, byRun);
+            }
+            byRun.set(runId, row);
+        }
+    }
+    async createRun(run) {
+        this.runs.set(run.id, { ...run });
+        this.reindexAttributes(run.id, run.searchAttributes);
+    }
+    async updateRun(runId, patch) {
+        const existing = this.runs.get(runId);
+        if (!existing)
+            throw new Error(`run ${runId} not found`);
+        const next = { ...existing, ...patch };
+        this.runs.set(runId, next);
+        if ('searchAttributes' in patch)
+            this.reindexAttributes(runId, next.searchAttributes);
+    }
+    async getRun(runId) {
+        const run = this.runs.get(runId);
+        return run ? { ...run } : null;
+    }
+    async deleteRun(runId) {
+        this.runs.delete(runId);
+        for (const [key, cp] of this.checkpoints) {
+            if (cp.runId === runId)
+                this.checkpoints.delete(key);
+        }
+        for (const [token, waiter] of this.signalWaiters) {
+            if (waiter.runId === runId)
+                this.signalWaiters.delete(token);
+        }
+        // Drop the run's normalized attribute rows (reindex with no attributes clears them).
+        this.reindexAttributes(runId, undefined);
+    }
+    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 listPendingRuns(limit) {
+        return [...this.runs.values()]
+            .filter((r) => r.status === 'pending')
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime() || a.id.localeCompare(b.id))
+            .slice(0, limit)
+            .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 renewRunLock(runId, owner, leaseUntilMs) {
+        const run = this.runs.get(runId);
+        if (!run || run.lockedBy !== owner)
+            return false;
+        run.lockedUntil = leaseUntilMs;
+        return true;
+    }
+    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 listSignalWaiters(prefix) {
+        return [...this.signalWaiters.values()]
+            .filter((w) => w.token.startsWith(prefix))
+            .map((w) => ({ ...w }));
+    }
+    // No real DB transaction (there's no DB) — run the work and save the checkpoint. Exactly-once
+    // across a crash needs a SQL store; this keeps `ctx.transaction` usable in tests / local dev.
+    async transaction(work) {
+        return work({ raw: this, saveCheckpoint: (cp) => this.saveCheckpoint(cp) });
+    }
+    bufferedSignals = new Map();
+    async bufferSignal(token, payload) {
+        const queue = this.bufferedSignals.get(token) ?? [];
+        queue.push(payload);
+        this.bufferedSignals.set(token, queue);
+    }
+    async takeBufferedSignal(token) {
+        const queue = this.bufferedSignals.get(token);
+        if (!queue || queue.length === 0)
+            return null;
+        const payload = queue.shift();
+        if (queue.length === 0)
+            this.bufferedSignals.delete(token);
+        return { payload };
+    }
+    /**
+     * Candidate run ids satisfying ONE attribute predicate, served from {@link attributeIndex} — the
+     * pushdown step. Numeric predicates scan only `numValue` rows under the key; string/boolean ones
+     * scan `strValue` rows. This is the in-memory analog of the SQL EXISTS on `durable_run_attributes`.
+     */
+    candidatesForFilter(f) {
+        const byRun = this.attributeIndex.get(f.key);
+        const out = new Set();
+        if (!byRun)
+            return out;
+        const numeric = typeof f.value === 'number';
+        const operand = typeof f.value === 'boolean' ? (f.value ? 'true' : 'false') : f.value;
+        for (const row of byRun.values()) {
+            const actual = numeric ? row.numValue : row.strValue;
+            if (actual == null)
+                continue;
+            let ok = false;
+            switch (f.op) {
+                case 'eq':
+                    ok = actual === operand;
+                    break;
+                case 'ne':
+                    ok = actual !== operand;
+                    break;
+                case 'gt':
+                    ok = actual > operand;
+                    break;
+                case 'gte':
+                    ok = actual >= operand;
+                    break;
+                case 'lt':
+                    ok = actual < operand;
+                    break;
+                case 'lte':
+                    ok = actual <= operand;
+                    break;
+            }
+            if (ok)
+                out.add(row.runId);
+        }
+        return out;
+    }
+    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);
+        if (query.statuses)
+            runs = runs.filter((r) => query.statuses?.includes(r.status));
+        if (query.tag)
+            runs = runs.filter((r) => r.tags?.includes(query.tag));
+        if (query.attributes?.length) {
+            // Pushdown: intersect per-predicate candidate sets from the key-indexed side-table, so we only
+            // ever materialize the runs that already satisfy EVERY attribute filter (no full per-run scan).
+            let candidates = null;
+            for (const f of query.attributes) {
+                const next = this.candidatesForFilter(f);
+                if (candidates == null) {
+                    candidates = next;
+                }
+                else {
+                    const prev = candidates;
+                    candidates = new Set([...prev].filter((id) => next.has(id)));
+                }
+                if (candidates.size === 0)
+                    break;
+            }
+            const ids = candidates ?? new Set();
+            this.lastAttributeCandidates = ids.size;
+            runs = runs.filter((r) => ids.has(r.id));
+        }
+        // Newest first (matches the store adapters' `createdAt DESC`) — recent runs on top in the dashboard.
+        runs.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+        const offset = query.offset ?? 0;
+        const limit = query.limit ?? runs.length;
+        return runs.slice(offset, offset + limit).map((r) => ({ ...r }));
+    }
+    async listCheckpoints(runId) {
+        const rows = [...this.checkpoints.values()]
+            .filter((cp) => cp.runId === runId)
+            .sort((a, b) => a.seq - b.seq)
+            .map((cp) => ({ ...cp }));
+        this.lastCheckpointRowsRead = rows.length;
+        return rows;
+    }
+    async getLatestCheckpointByName(runId, name) {
+        let latest;
+        for (const cp of this.checkpoints.values()) {
+            if (cp.runId !== runId || cp.name !== name)
+                continue;
+            if (!latest || cp.seq > latest.seq)
+                latest = cp;
+        }
+        this.lastCheckpointRowsRead = latest ? 1 : 0;
+        return latest ? { ...latest } : undefined;
+    }
+    async listCheckpointsByNamePrefix(runId, prefixes) {
+        const rows = [...this.checkpoints.values()]
+            .filter((cp) => cp.runId === runId && prefixes.some((p) => cp.name.startsWith(p)))
+            .sort((a, b) => a.seq - b.seq)
+            .map((cp) => ({ ...cp }));
+        this.lastCheckpointRowsRead = rows.length;
+        return rows;
+    }
+}
+//# sourceMappingURL=in-memory-state-store.js.map

package/dist/src/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/src/testing/in-memory-transport.d.ts

@@ -0,0 +1,25 @@
+import type { ControlMessage, ControlPlane, Heartbeat, RemoteTask, StepResult, Transport, WorkflowStepEvent } from '../interfaces.js';
+import { type StepHandler } from '../protocol.js';
+/**
+ * An in-process `Transport` (and `ControlPlane`) for tests and local development: registered
+ * handlers stand in for remote workers, so a whole cross-app workflow runs in a single process,
+ * and control messages broadcast locally. Pass the same instance as both `transport` and
+ * `controlPlane`.
+ */
+export declare class InMemoryTransport implements Transport, ControlPlane {
+    private readonly handlers;
+    private resultHandler?;
+    private stepEventHandler?;
+    private readonly controlHandlers;
+    /** 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;
+    /** Workflow step lifecycle: deliver to the engine's handler (async, mirroring a real broker). */
+    dispatchStepEvent(event: WorkflowStepEvent): Promise<void>;
+    onStepEvent(handler: (event: WorkflowStepEvent) => Promise<void>): void;
+    publishControl(msg: ControlMessage): Promise<void>;
+    onControl(handler: (msg: ControlMessage) => void): void;
+}
+//# sourceMappingURL=in-memory-transport.d.ts.map

package/dist/src/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,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,SAAS,EAAE,YAAY;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,aAAa,CAAC,CAAwC;IAC9D,OAAO,CAAC,gBAAgB,CAAC,CAA8C;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAE5E,sDAAsD;IACtD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAIrC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/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;IAI/D,iGAAiG;IAC3F,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,WAAW,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMjE,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;CAGxD"}

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

@@ -0,0 +1,49 @@
+import { runStepHandler } from '../protocol.js';
+/**
+ * An in-process `Transport` (and `ControlPlane`) for tests and local development: registered
+ * handlers stand in for remote workers, so a whole cross-app workflow runs in a single process,
+ * and control messages broadcast locally. Pass the same instance as both `transport` and
+ * `controlPlane`.
+ */
+export class InMemoryTransport {
+    handlers = new Map();
+    resultHandler;
+    stepEventHandler;
+    controlHandlers = new Set();
+    /** 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');
+        const result = await runStepHandler(task, this.handlers.get(task.name));
+        // Deliver the result ASYNCHRONOUSLY, not inline: a durable `ctx.call` suspends the run right
+        // after dispatch, so the result must land AFTER that unwinds (else the resume re-enters
+        // mid-suspend). Real brokers are async; this mirrors them.
+        setImmediate(() => void this.resultHandler?.(result));
+    }
+    onResult(handler) {
+        this.resultHandler = handler;
+    }
+    onHeartbeat(_handler) {
+        // In-process handlers run synchronously; there is no liveness to track.
+    }
+    /** Workflow step lifecycle: deliver to the engine's handler (async, mirroring a real broker). */
+    async dispatchStepEvent(event) {
+        await this.stepEventHandler?.(event);
+    }
+    onStepEvent(handler) {
+        this.stepEventHandler = handler;
+    }
+    // Control plane: broadcast to every registered handler (including the publisher's own — the
+    // engine dedupes by `from`), mirroring how a real broker echoes a publish to all subscribers.
+    async publishControl(msg) {
+        for (const handler of this.controlHandlers)
+            handler(msg);
+    }
+    onControl(handler) {
+        this.controlHandlers.add(handler);
+    }
+}
+//# sourceMappingURL=in-memory-transport.js.map

package/dist/src/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":"AASA,OAAO,EAAoB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACX,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IACnD,aAAa,CAAyC;IACtD,gBAAgB,CAA+C;IACtD,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;IAE5E,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,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,6FAA6F;QAC7F,wFAAwF;QACxF,2DAA2D;QAC3D,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,QAAQ,CAAC,OAA8C;QACrD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,QAA4C;QACtD,wEAAwE;IAC1E,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,iBAAiB,CAAC,KAAwB;QAC9C,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,WAAW,CAAC,OAAoD;QAC9D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,4FAA4F;IAC5F,8FAA8F;IAC9F,KAAK,CAAC,cAAc,CAAC,GAAmB;QACtC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,SAAS,CAAC,OAAsC;QAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/src/testing-kit/admission-backend-conformance.d.ts

@@ -0,0 +1,18 @@
+import type { AdmissionBackend } from '../index.js';
+/**
+ * Builds an {@link AdmissionBackend} bound to the given test clock. Implementations that hold their
+ * own resources (e.g. a Redis connection) should register the instance for teardown out-of-band.
+ */
+export type AdmissionBackendFactory = (clock: () => number) => AdmissionBackend;
+/**
+ * The SHARED cross-backend behavioural contract for the flow-control admission gate. Both the
+ * in-process `InMemoryAdmissionBackend` and the Redis `RedisAdmissionBackend` run it, so their
+ * concurrency / rate-limit / ordering semantics can never silently drift apart — backend-specific
+ * concerns (leases, pub/sub, cross-pod globality) live in each adapter's own spec.
+ *
+ * The engine always passes a stable `waiterId`, so every gated call is order-tracked: ties with no
+ * priority/fairness fall back to arrival FIFO (or LIFO when configured). These cases assert exactly
+ * that, on ONE backend instance.
+ */
+export declare function runAdmissionBackendContract(name: string, makeBackend: AdmissionBackendFactory): void;
+//# sourceMappingURL=admission-backend-conformance.d.ts.map

package/dist/src/testing-kit/admission-backend-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission-backend-conformance.d.ts","sourceRoot":"","sources":["../../../src/testing-kit/admission-backend-conformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,aAAa,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,MAAM,MAAM,KAAK,gBAAgB,CAAC;AAEhF;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,uBAAuB,GACnC,IAAI,CA2EN"}

package/dist/src/testing-kit/admission-backend-conformance.js

@@ -0,0 +1,81 @@
+import { describe, expect, it } from 'vitest';
+/**
+ * The SHARED cross-backend behavioural contract for the flow-control admission gate. Both the
+ * in-process `InMemoryAdmissionBackend` and the Redis `RedisAdmissionBackend` run it, so their
+ * concurrency / rate-limit / ordering semantics can never silently drift apart — backend-specific
+ * concerns (leases, pub/sub, cross-pod globality) live in each adapter's own spec.
+ *
+ * The engine always passes a stable `waiterId`, so every gated call is order-tracked: ties with no
+ * priority/fairness fall back to arrival FIFO (or LIFO when configured). These cases assert exactly
+ * that, on ONE backend instance.
+ */
+export function runAdmissionBackendContract(name, makeBackend) {
+    describe(`AdmissionBackend contract: ${name}`, () => {
+        let now = 1_000_000;
+        const make = (config) => {
+            now = 1_000_000;
+            const backend = makeBackend(() => now);
+            backend.register(config);
+            return backend;
+        };
+        it('caps concurrency: a second call blocks until the first releases', async () => {
+            const b = make({ name: 'q', concurrency: 1 });
+            expect((await b.tryAdmit('q', { waiterId: 'a' })).ok).toBe(true);
+            expect((await b.tryAdmit('q', { waiterId: 'b' })).ok).toBe(false);
+            await b.release('q', 'a');
+            expect((await b.tryAdmit('q', { waiterId: 'b' })).ok).toBe(true);
+        });
+        it('enforces a fixed-window rate limit', async () => {
+            const b = make({ name: 'q', rateLimit: { limit: 2, periodMs: 1000 } });
+            expect((await b.tryAdmit('q', { waiterId: '1' })).ok).toBe(true);
+            expect((await b.tryAdmit('q', { waiterId: '2' })).ok).toBe(true);
+            expect((await b.tryAdmit('q', { waiterId: '3' })).ok).toBe(false);
+            now += 1001;
+            expect((await b.tryAdmit('q', { waiterId: '4' })).ok).toBe(true);
+        });
+        it('admits the highest-priority waiter first when a slot frees', async () => {
+            const b = make({ name: 'q', concurrency: 1 });
+            expect((await b.tryAdmit('q', { waiterId: 'holder' })).ok).toBe(true);
+            expect((await b.tryAdmit('q', { waiterId: 'low', priority: 1 })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'high', priority: 9 })).ok).toBe(false);
+            await b.release('q', 'holder');
+            expect((await b.tryAdmit('q', { waiterId: 'low', priority: 1 })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'high', priority: 9 })).ok).toBe(true);
+        });
+        it('orders plain-concurrency waiters by arrival (FIFO) — no priority/fairness configured', async () => {
+            const b = make({ name: 'q', concurrency: 1 });
+            expect((await b.tryAdmit('q', { waiterId: 'holder' })).ok).toBe(true);
+            expect((await b.tryAdmit('q', { waiterId: 'first' })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'second' })).ok).toBe(false);
+            await b.release('q', 'holder');
+            // The earlier arrival wins the freed slot, on every backend.
+            expect((await b.tryAdmit('q', { waiterId: 'second' })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'first' })).ok).toBe(true);
+        });
+        it('admits the most-recent arrival first when order is LIFO', async () => {
+            const b = make({ name: 'q', concurrency: 1, order: 'lifo' });
+            expect((await b.tryAdmit('q', { waiterId: 'holder' })).ok).toBe(true);
+            expect((await b.tryAdmit('q', { waiterId: 'first' })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'second' })).ok).toBe(false);
+            await b.release('q', 'holder');
+            expect((await b.tryAdmit('q', { waiterId: 'first' })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'second' })).ok).toBe(true);
+        });
+        it('round-robins a contended slot across fairness keys', async () => {
+            const b = make({ name: 'q', concurrency: 1, fairness: 'key' });
+            expect((await b.tryAdmit('q', { waiterId: 'a0', key: 'A' })).ok).toBe(true);
+            expect((await b.tryAdmit('q', { waiterId: 'a1', key: 'A' })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'b0', key: 'B' })).ok).toBe(false);
+            await b.release('q', 'a0');
+            // B (never served) wins over A (just served), not arrival order.
+            expect((await b.tryAdmit('q', { waiterId: 'a1', key: 'A' })).ok).toBe(false);
+            expect((await b.tryAdmit('q', { waiterId: 'b0', key: 'B' })).ok).toBe(true);
+        });
+        it('leaves an unregistered queue ungated', async () => {
+            const b = make({ name: 'q', concurrency: 1 });
+            expect((await b.tryAdmit('other', { waiterId: 'x' })).ok).toBe(true);
+            expect((await b.tryAdmit('other', { waiterId: 'y' })).ok).toBe(true);
+        });
+    });
+}
+//# sourceMappingURL=admission-backend-conformance.js.map

package/dist/src/testing-kit/admission-backend-conformance.js.map

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

package/dist/src/testing-kit/assertions.d.ts

@@ -0,0 +1,10 @@
+import type { RunStatus, StateStore } from '../index.js';
+export declare function assertRunStatus(store: StateStore, runId: string, status: RunStatus): Promise<void>;
+export declare function assertOutput(store: StateStore, runId: string, expected: unknown): Promise<void>;
+/** The names of the steps that have run, in order. */
+export declare function recordedSteps(store: StateStore, runId: string): Promise<string[]>;
+/** Assert every named step ran (in any order). */
+export declare function assertStepsRan(store: StateStore, runId: string, names: string[]): Promise<void>;
+/** Assert a step ran exactly the given number of attempts (e.g. to verify retries). */
+export declare function assertStepAttempts(store: StateStore, runId: string, name: string, attempts: number): Promise<void>;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/src/testing-kit/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../../src/testing-kit/assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzD,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,sDAAsD;AACtD,wBAAsB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEvF;AAED,kDAAkD;AAClD,wBAAsB,cAAc,CAClC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,uFAAuF;AACvF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/src/testing-kit/assertions.js

@@ -0,0 +1,41 @@
+async function requireRun(store, runId) {
+    const run = await store.getRun(runId);
+    if (!run)
+        throw new Error(`assertion failed: run ${runId} not found`);
+    return run;
+}
+export async function assertRunStatus(store, runId, status) {
+    const run = await requireRun(store, runId);
+    if (run.status !== status) {
+        throw new Error(`expected run ${runId} to be "${status}", but it was "${run.status}"`);
+    }
+}
+export async function assertOutput(store, runId, expected) {
+    const run = await requireRun(store, runId);
+    if (JSON.stringify(run.output) !== JSON.stringify(expected)) {
+        throw new Error(`expected run ${runId} output ${JSON.stringify(expected)}, got ${JSON.stringify(run.output)}`);
+    }
+}
+/** The names of the steps that have run, in order. */
+export async function recordedSteps(store, runId) {
+    return (await store.listCheckpoints(runId)).map((cp) => cp.name);
+}
+/** Assert every named step ran (in any order). */
+export async function assertStepsRan(store, runId, names) {
+    const ran = await recordedSteps(store, runId);
+    for (const name of names) {
+        if (!ran.includes(name)) {
+            throw new Error(`expected step "${name}" to have run; ran: [${ran.join(', ')}]`);
+        }
+    }
+}
+/** Assert a step ran exactly the given number of attempts (e.g. to verify retries). */
+export async function assertStepAttempts(store, runId, name, attempts) {
+    const cp = (await store.listCheckpoints(runId)).find((c) => c.name === name);
+    if (!cp)
+        throw new Error(`expected step "${name}" to have run, but it did not`);
+    if (cp.attempts !== attempts) {
+        throw new Error(`expected step "${name}" to take ${attempts} attempt(s), took ${cp.attempts}`);
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/dist/src/testing-kit/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../../src/testing-kit/assertions.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,UAAU,CAAC,KAAiB,EAAE,KAAa;IACxD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,YAAY,CAAC,CAAC;IACtE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAiB,EACjB,KAAa,EACb,MAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,WAAW,MAAM,kBAAkB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAiB,EACjB,KAAa,EACb,QAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAiB,EAAE,KAAa;IAClE,OAAO,CAAC,MAAM,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAiB,EACjB,KAAa,EACb,KAAe;IAEf,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,wBAAwB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAiB,EACjB,KAAa,EACb,IAAY,EACZ,QAAgB;IAEhB,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC7E,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,+BAA+B,CAAC,CAAC;IAChF,IAAI,EAAE,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,aAAa,QAAQ,qBAAqB,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjG,CAAC;AACH,CAAC"}