@nodii/saga 0.0.2 → 0.2.0

package/dist/state-store/postgres.js

@@ -0,0 +1,270 @@
+// PostgresSagaStateStore — real, production-bound saga_state store.
+//
+// Spec § 5.5 — 21-column schema mirrored verbatim. The store uses the
+// `postgres` (porsager/postgres) client because Drizzle and the other
+// nodii-libs ORM choices have not yet stabilized — the SQL is hand-rolled
+// so the schema is byte-identical to the migration shipped at
+// `src/migrations/001-saga-state.sql`.
+//
+// Wire shape:
+//   - tenant_id, parent_saga_id, parent_relationship: persisted as TEXT
+//     to allow non-UUID test tenants. Production callers pass UUIDs.
+//   - step_outputs + children + compensation_log: jsonb columns.
+//   - next_resume_at: the reaper queries this; we keep it nullable.
+//   - All reads/writes go through the configured `nodii_services` pool
+//     (or any postgres.Sql) — RLS is not applied to saga_state per
+//     audit-only doctrine § 5.5.
+//
+// 16KB cap on step_outputs entries (§ 5.5 three-level resolution): we
+// enforce on `appendStepOutput` — entries exceeding the cap are stored
+// with `{ _truncated: true, original_bytes: N }` so the saga log stays
+// queryable. Truncation counter would normally fire a metric; we keep
+// the hook explicit on the store interface so tests can observe.
+const STEP_OUTPUT_CAP_BYTES = 16 * 1024; // § 5.5 cap-and-truncate
+export class PostgresSagaStateStore {
+    sql;
+    table;
+    onTruncate;
+    constructor(opts) {
+        this.sql = opts.sql;
+        this.table = opts.tableName ?? "saga_state";
+        this.onTruncate = opts.onTruncate;
+    }
+    async createSaga(row) {
+        // NOTE on jsonb params: porsager/postgres auto-stringifies JS objects/
+        // arrays/null when bound to jsonb-typed slots, so we pass the raw JS
+        // value (NOT JSON.stringify(...)). Passing a pre-stringified string
+        // sends it as TEXT and the `::jsonb` cast then encodes the literal
+        // string as a JSON scalar — see the in-tree debug commit notes.
+        const stmt = `INSERT INTO ${this.table}
+      (id, tenant_id, type, status, current_step, step_outputs, episode,
+       trigger_trace_id, trigger_span_id, trigger_request_id,
+       parent_saga_id, parent_relationship, children,
+       started_at, completed_at, next_resume_at, failure_reason, failure_step,
+       compensation_log, last_admin_action, last_admin_actor_id, last_admin_at,
+       input, cancel_reason)
+      VALUES ($1,$2,$3,$4,$5,$6::jsonb,$7,$8,$9,$10,$11,$12,$13::jsonb,
+              $14::timestamptz,$15::timestamptz,$16::timestamptz,$17,$18,$19::jsonb,$20,$21,$22::timestamptz,$23::jsonb,$24)`;
+        await this.sql.unsafe(stmt, [
+            row.id,
+            row.tenant_id,
+            row.type,
+            row.status,
+            row.current_step,
+            row.step_outputs ?? {},
+            row.episode,
+            row.trigger_trace_id,
+            row.trigger_span_id,
+            row.trigger_request_id,
+            row.parent_saga_id,
+            row.parent_relationship,
+            row.children ?? [],
+            row.started_at,
+            row.completed_at,
+            row.next_resume_at ?? null,
+            row.failure_reason,
+            row.failure_step,
+            row.compensation_log ?? [],
+            row.last_admin_action,
+            row.last_admin_actor_id,
+            row.last_admin_at,
+            row.input ?? null,
+            row.cancel_reason,
+        ]);
+    }
+    async getSaga(sagaId) {
+        const stmt = `SELECT id, tenant_id, type, status, current_step, step_outputs,
+        episode, trigger_trace_id, trigger_span_id, trigger_request_id,
+        parent_saga_id, parent_relationship, children,
+        to_char(started_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS started_at,
+        to_char(completed_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS completed_at,
+        to_char(next_resume_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS next_resume_at,
+        failure_reason, failure_step, compensation_log,
+        last_admin_action, last_admin_actor_id,
+        to_char(last_admin_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS last_admin_at,
+        input, cancel_reason
+      FROM ${this.table} WHERE id = $1 LIMIT 1`;
+        const rows = (await this.sql.unsafe(stmt, [sagaId]));
+        if (!rows.length)
+            return null;
+        const r = rows[0];
+        if (!r)
+            return null;
+        return rawToRow(r);
+    }
+    async updateSagaStatus(sagaId, update) {
+        const sets = [];
+        const args = [];
+        let i = 1;
+        const push = (col, cast, value) => {
+            sets.push(`${col} = $${i}${cast}`);
+            args.push(value);
+            i += 1;
+        };
+        if (update.status !== undefined)
+            push("status", "", update.status);
+        if (update.current_step !== undefined)
+            push("current_step", "", update.current_step);
+        if (update.completed_at !== undefined)
+            push("completed_at", "::timestamptz", update.completed_at);
+        if (update.next_resume_at !== undefined)
+            push("next_resume_at", "::timestamptz", update.next_resume_at);
+        if (update.failure_reason !== undefined)
+            push("failure_reason", "", update.failure_reason);
+        if (update.failure_step !== undefined)
+            push("failure_step", "", update.failure_step);
+        if (update.last_admin_action !== undefined)
+            push("last_admin_action", "", update.last_admin_action);
+        if (update.last_admin_actor_id !== undefined)
+            push("last_admin_actor_id", "", update.last_admin_actor_id);
+        if (update.last_admin_at !== undefined)
+            push("last_admin_at", "::timestamptz", update.last_admin_at);
+        if (update.cancel_reason !== undefined)
+            push("cancel_reason", "", update.cancel_reason);
+        if (!sets.length)
+            return;
+        args.push(sagaId);
+        const stmt = `UPDATE ${this.table} SET ${sets.join(", ")} WHERE id = $${i}`;
+        await this.sql.unsafe(stmt, args);
+    }
+    async appendStepOutput(sagaId, stepName, output) {
+        // 16KB cap per § 5.5 — measured against the JSON-serialized size,
+        // but the actual value sent to postgres is the JS object (porsager/
+        // postgres handles the jsonb encoding itself).
+        let toStore = output ?? null;
+        try {
+            const serialized = JSON.stringify(toStore);
+            if (serialized.length > STEP_OUTPUT_CAP_BYTES) {
+                this.onTruncate?.({
+                    sagaId,
+                    stepName,
+                    originalBytes: serialized.length,
+                });
+                toStore = { _truncated: true, original_bytes: serialized.length };
+            }
+        }
+        catch {
+            toStore = { _truncated: true, reason: "non_serializable_output" };
+        }
+        const stmt = `UPDATE ${this.table}
+      SET step_outputs = jsonb_set(
+        COALESCE(step_outputs, '{}'::jsonb),
+        ARRAY[$2::text],
+        $3::jsonb,
+        true
+      )
+      WHERE id = $1`;
+        await this.sql.unsafe(stmt, [sagaId, stepName, toStore]);
+    }
+    async appendCompensationLog(sagaId, entry) {
+        // Pass entry as a JS object; postgres.js handles the jsonb encoding.
+        const stmt = `UPDATE ${this.table}
+      SET compensation_log = COALESCE(compensation_log, '[]'::jsonb) || jsonb_build_array($2::jsonb)
+      WHERE id = $1`;
+        await this.sql.unsafe(stmt, [sagaId, entry]);
+    }
+    async list(filter) {
+        const args = [];
+        const wheres = [];
+        let i = 1;
+        if (filter?.tenantId !== undefined) {
+            wheres.push(`tenant_id = $${i}`);
+            args.push(filter.tenantId);
+            i += 1;
+        }
+        if (filter?.status !== undefined) {
+            wheres.push(`status = $${i}`);
+            args.push(filter.status);
+            i += 1;
+        }
+        if (filter?.type !== undefined) {
+            wheres.push(`type = $${i}`);
+            args.push(filter.type);
+            i += 1;
+        }
+        const where = wheres.length ? ` WHERE ${wheres.join(" AND ")}` : "";
+        const stmt = `SELECT id, tenant_id, type, status, current_step, step_outputs,
+        episode, trigger_trace_id, trigger_span_id, trigger_request_id,
+        parent_saga_id, parent_relationship, children,
+        to_char(started_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS started_at,
+        to_char(completed_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS completed_at,
+        to_char(next_resume_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS next_resume_at,
+        failure_reason, failure_step, compensation_log,
+        last_admin_action, last_admin_actor_id,
+        to_char(last_admin_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS last_admin_at,
+        input, cancel_reason
+      FROM ${this.table}${where} ORDER BY started_at DESC`;
+        const rows = (await this.sql.unsafe(stmt, args));
+        return rows.map(rawToRow);
+    }
+    /** Reaper-side scan — used by `startSagaReaper`. */
+    async listStalePaused(cutoffIso) {
+        const stmt = `SELECT id, tenant_id, type, status, current_step, step_outputs,
+        episode, trigger_trace_id, trigger_span_id, trigger_request_id,
+        parent_saga_id, parent_relationship, children,
+        to_char(started_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS started_at,
+        to_char(completed_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS completed_at,
+        to_char(next_resume_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS next_resume_at,
+        failure_reason, failure_step, compensation_log,
+        last_admin_action, last_admin_actor_id,
+        to_char(last_admin_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS last_admin_at,
+        input, cancel_reason
+      FROM ${this.table}
+      WHERE status = 'paused' AND next_resume_at IS NOT NULL AND next_resume_at < $1::timestamptz`;
+        const rows = (await this.sql.unsafe(stmt, [cutoffIso]));
+        return rows.map(rawToRow);
+    }
+    /** Outbox helpers — see `async-step.ts`. */
+    async writeOutboxBegin(args) {
+        const stmt = `INSERT INTO saga_outbox (id, saga_id, step_name, event_type, payload, tenant_id, created_at)
+      VALUES (gen_random_uuid(), $1, $2, $3, $4::jsonb, $5, now())`;
+        await this.sql.unsafe(stmt, [
+            args.sagaId,
+            args.stepName,
+            args.eventType,
+            args.payload ?? null,
+            args.tenantId,
+        ]);
+    }
+    async readOutboxForSaga(sagaId) {
+        const stmt = `SELECT step_name, event_type, payload,
+      to_char(created_at, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"') AS created_at
+      FROM saga_outbox WHERE saga_id = $1 ORDER BY created_at ASC`;
+        const rows = (await this.sql.unsafe(stmt, [sagaId]));
+        return rows.map((r) => ({
+            stepName: r.step_name,
+            eventType: r.event_type,
+            payload: r.payload,
+            createdAt: r.created_at,
+        }));
+    }
+}
+function rawToRow(r) {
+    return {
+        id: r.id,
+        tenant_id: r.tenant_id,
+        type: r.type,
+        status: r.status,
+        current_step: r.current_step,
+        step_outputs: r.step_outputs ?? {},
+        episode: r.episode,
+        trigger_trace_id: r.trigger_trace_id,
+        trigger_span_id: r.trigger_span_id,
+        trigger_request_id: r.trigger_request_id,
+        parent_saga_id: r.parent_saga_id,
+        parent_relationship: r.parent_relationship === "compensation_of" ? "compensation_of" : "child",
+        children: r.children ?? [],
+        started_at: r.started_at,
+        completed_at: r.completed_at,
+        next_resume_at: r.next_resume_at,
+        failure_reason: r.failure_reason,
+        failure_step: r.failure_step,
+        compensation_log: r.compensation_log ?? [],
+        last_admin_action: r.last_admin_action,
+        last_admin_actor_id: r.last_admin_actor_id,
+        last_admin_at: r.last_admin_at,
+        input: r.input,
+        cancel_reason: r.cancel_reason,
+    };
+}
+//# sourceMappingURL=postgres.js.map

package/dist/state-store/postgres.js.map

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

package/dist/test-doubles/in-memory-signal-bus.d.ts

@@ -0,0 +1,38 @@
+import type { SagaSignalBus } from "../types";
+export declare class NoopSignalBus implements SagaSignalBus {
+    emit(): Promise<void>;
+    consume(): Promise<unknown | null>;
+    list(): Promise<{
+        sagaId: string;
+        eventType: string;
+        payload: unknown;
+    }[]>;
+    close(): Promise<void>;
+}
+export declare class InMemorySignalBus implements SagaSignalBus {
+    private buffer;
+    emit(args: {
+        sagaId: string;
+        eventType: string;
+        payload: unknown;
+        scope?: "siblings" | "global";
+        to?: string;
+    }): Promise<void>;
+    consume(args: {
+        sagaId: string;
+        eventType: string;
+        from?: string;
+        predicate?: (payload: unknown) => boolean;
+    }): Promise<unknown | null>;
+    list(args: {
+        sagaId: string;
+        eventType?: string;
+    }): Promise<{
+        sagaId: string;
+        eventType: string;
+        payload: unknown;
+    }[]>;
+    close(): Promise<void>;
+    reset(): void;
+}
+//# sourceMappingURL=in-memory-signal-bus.d.ts.map

package/dist/test-doubles/in-memory-signal-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-signal-bus.d.ts","sourceRoot":"","sources":["../../src/test-doubles/in-memory-signal-bus.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,qBAAa,aAAc,YAAW,aAAa;IAC3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAGrB,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAGlC,IAAI,IAAI,OAAO,CACnB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAC1D;IAGK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAUD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,MAAM,CAAwB;IAEhC,IAAI,CAAC,IAAI,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;QAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,IAAI,CAAC;IAUX,OAAO,CAAC,IAAI,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;KAC3C,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAarB,IAAI,CAAC,IAAI,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAchE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,KAAK,IAAI,IAAI;CAGd"}

package/dist/test-doubles/in-memory-signal-bus.js

@@ -0,0 +1,68 @@
+// NoopSignalBus + InMemorySignalBus — TEST DOUBLES. Production uses
+// `RedisSignalBus` (Redis Streams). These are kept only for unit tests
+// + parity-fence fixtures.
+export class NoopSignalBus {
+    async emit() {
+        /* no-op */
+    }
+    async consume() {
+        return null;
+    }
+    async list() {
+        return [];
+    }
+    async close() {
+        /* no-op */
+    }
+}
+export class InMemorySignalBus {
+    buffer = [];
+    async emit(args) {
+        this.buffer.push({
+            sagaId: args.sagaId,
+            eventType: args.eventType,
+            payload: args.payload,
+            scope: args.scope ?? "siblings",
+            to: args.to,
+        });
+    }
+    async consume(args) {
+        const idx = this.buffer.findIndex((sig) => {
+            if (sig.eventType !== args.eventType)
+                return false;
+            if (sig.to && sig.to !== args.sagaId)
+                return false;
+            if (args.from && sig.sagaId !== args.from)
+                return false;
+            if (args.predicate && !args.predicate(sig.payload))
+                return false;
+            return true;
+        });
+        if (idx === -1)
+            return null;
+        const signal = this.buffer.splice(idx, 1)[0];
+        return signal ? signal.payload : null;
+    }
+    async list(args) {
+        return this.buffer
+            .filter((sig) => {
+            if (sig.to && sig.to !== args.sagaId)
+                return false;
+            if (args.eventType && sig.eventType !== args.eventType)
+                return false;
+            return true;
+        })
+            .map((sig) => ({
+            sagaId: sig.sagaId,
+            eventType: sig.eventType,
+            payload: sig.payload,
+        }));
+    }
+    async close() {
+        /* no-op */
+    }
+    reset() {
+        this.buffer = [];
+    }
+}
+//# sourceMappingURL=in-memory-signal-bus.js.map

package/dist/test-doubles/in-memory-signal-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-signal-bus.js","sourceRoot":"","sources":["../../src/test-doubles/in-memory-signal-bus.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,uEAAuE;AACvE,2BAA2B;AAI3B,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,IAAI;QACR,WAAW;IACb,CAAC;IACD,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,IAAI;QAGR,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,CAAC,KAAK;QACT,WAAW;IACb,CAAC;CACF;AAUD,MAAM,OAAO,iBAAiB;IACpB,MAAM,GAAqB,EAAE,CAAC;IAEtC,KAAK,CAAC,IAAI,CAAC,IAMV;QACC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU;YAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAKb;QACC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;YACxC,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YACnD,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YACnD,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAC;YACxD,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAGV;QACC,OAAO,IAAI,CAAC,MAAM;aACf,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YACd,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YACnD,IAAI,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACb,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC,CAAC;IACR,CAAC;IAED,KAAK,CAAC,KAAK;QACT,WAAW;IACb,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/test-doubles/in-memory-state-store.d.ts

@@ -0,0 +1,26 @@
+import type { CompensationLogEntry, ListSagasFilter, SagaStateRow, SagaStateStore } from "../types";
+export declare class InMemorySagaStateStore implements SagaStateStore {
+    private rows;
+    private outbox;
+    createSaga(row: SagaStateRow): Promise<void>;
+    getSaga(sagaId: string): Promise<SagaStateRow | null>;
+    updateSagaStatus(sagaId: string, update: Partial<Pick<SagaStateRow, "status" | "current_step" | "completed_at" | "failure_reason" | "failure_step" | "last_admin_action" | "last_admin_actor_id" | "last_admin_at" | "cancel_reason" | "next_resume_at">>): Promise<void>;
+    appendStepOutput(sagaId: string, stepName: string, output: unknown): Promise<void>;
+    appendCompensationLog(sagaId: string, entry: CompensationLogEntry): Promise<void>;
+    list(filter?: ListSagasFilter): Promise<SagaStateRow[]>;
+    listStalePaused(cutoffIso: string): Promise<SagaStateRow[]>;
+    writeOutboxBegin(args: {
+        sagaId: string;
+        stepName: string;
+        eventType: string;
+        payload: unknown;
+        tenantId: string | null;
+    }): Promise<void>;
+    readOutboxForSaga(sagaId: string): Promise<{
+        stepName: string;
+        eventType: string;
+        payload: unknown;
+        createdAt: string;
+    }[]>;
+}
+//# sourceMappingURL=in-memory-state-store.d.ts.map

package/dist/test-doubles/in-memory-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-state-store.d.ts","sourceRoot":"","sources":["../../src/test-doubles/in-memory-state-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,cAAc,EACf,MAAM,UAAU,CAAC;AAUlB,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAqB;IAE7B,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAKrD,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,CACb,IAAI,CACF,YAAY,EACV,QAAQ,GACR,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,mBAAmB,GACnB,qBAAqB,GACrB,eAAe,GACf,eAAe,GACf,gBAAgB,CACnB,CACF,GACA,OAAO,CAAC,IAAI,CAAC;IAMV,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAMV,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAMV,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsBvD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAU3D,gBAAgB,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUX,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAC9C;QACE,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,EAAE,CACJ;CAUF"}

package/dist/test-doubles/in-memory-state-store.js

@@ -0,0 +1,87 @@
+// InMemorySagaStateStore — TEST DOUBLE. Production uses
+// `PostgresSagaStateStore`. This implementation is kept only for unit
+// tests + parity-fence fixtures; the public `initSaga()` no longer wires
+// it as a default.
+export class InMemorySagaStateStore {
+    rows = new Map();
+    outbox = [];
+    async createSaga(row) {
+        if (this.rows.has(row.id)) {
+            throw new Error(`saga ${row.id} already exists in state store`);
+        }
+        this.rows.set(row.id, structuredClone(row));
+    }
+    async getSaga(sagaId) {
+        const row = this.rows.get(sagaId);
+        return row ? structuredClone(row) : null;
+    }
+    async updateSagaStatus(sagaId, update) {
+        const row = this.rows.get(sagaId);
+        if (!row)
+            throw new Error(`saga ${sagaId} not found`);
+        Object.assign(row, update);
+    }
+    async appendStepOutput(sagaId, stepName, output) {
+        const row = this.rows.get(sagaId);
+        if (!row)
+            throw new Error(`saga ${sagaId} not found`);
+        row.step_outputs[stepName] = output;
+    }
+    async appendCompensationLog(sagaId, entry) {
+        const row = this.rows.get(sagaId);
+        if (!row)
+            throw new Error(`saga ${sagaId} not found`);
+        row.compensation_log.push({ ...entry });
+    }
+    async list(filter) {
+        let snapshot = Array.from(this.rows.values()).map((r) => structuredClone(r));
+        if (filter) {
+            snapshot = snapshot.filter((r) => {
+                if (filter.tenantId !== undefined && r.tenant_id !== filter.tenantId) {
+                    return false;
+                }
+                if (filter.status !== undefined && r.status !== filter.status) {
+                    return false;
+                }
+                if (filter.type !== undefined && r.type !== filter.type) {
+                    return false;
+                }
+                return true;
+            });
+        }
+        return snapshot;
+    }
+    // Reaper-side scan: rows whose next_resume_at < cutoff and status = 'paused'.
+    async listStalePaused(cutoffIso) {
+        const out = [];
+        for (const r of this.rows.values()) {
+            if (r.status !== "paused")
+                continue;
+            if (!r.next_resume_at)
+                continue;
+            if (r.next_resume_at < cutoffIso)
+                out.push(structuredClone(r));
+        }
+        return out;
+    }
+    async writeOutboxBegin(args) {
+        this.outbox.push({
+            sagaId: args.sagaId,
+            stepName: args.stepName,
+            eventType: args.eventType,
+            payload: structuredClone(args.payload),
+            createdAt: new Date().toISOString(),
+        });
+    }
+    async readOutboxForSaga(sagaId) {
+        return this.outbox
+            .filter((e) => e.sagaId === sagaId)
+            .map((e) => ({
+            stepName: e.stepName,
+            eventType: e.eventType,
+            payload: structuredClone(e.payload),
+            createdAt: e.createdAt,
+        }));
+    }
+}
+//# sourceMappingURL=in-memory-state-store.js.map

package/dist/test-doubles/in-memory-state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-state-store.js","sourceRoot":"","sources":["../../src/test-doubles/in-memory-state-store.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,sEAAsE;AACtE,yEAAyE;AACzE,mBAAmB;AAiBnB,MAAM,OAAO,sBAAsB;IACzB,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IACvC,MAAM,GAAkB,EAAE,CAAC;IAEnC,KAAK,CAAC,UAAU,CAAC,GAAiB;QAChC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,gCAAgC,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,MAAc,EACd,MAcC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,MAAc,EACd,QAAgB,EAChB,MAAe;QAEf,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QACtD,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,MAAc,EACd,KAA2B;QAE3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QACtD,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAwB;QACjC,IAAI,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtD,eAAe,CAAC,CAAC,CAAC,CACnB,CAAC;QACF,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC/B,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACrE,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;oBAC9D,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;oBACxD,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,eAAe,CAAC,SAAiB;QACrC,MAAM,GAAG,GAAmB,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACpC,IAAI,CAAC,CAAC,CAAC,cAAc;gBAAE,SAAS;YAChC,IAAI,CAAC,CAAC,cAAc,GAAG,SAAS;gBAAE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAMtB;QACC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;YACtC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,MAAc;QAQpC,OAAO,IAAI,CAAC,MAAM;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC;YACnC,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;IACR,CAAC;CACF"}

package/dist/test-doubles/index.d.ts

@@ -0,0 +1,4 @@
+export { InMemorySagaStateStore } from "./in-memory-state-store";
+export { NoopSignalBus, InMemorySignalBus } from "./in-memory-signal-bus";
+export { InMemoryIdempotency, NoopIdempotency } from "../idempotency";
+//# sourceMappingURL=index.d.ts.map

package/dist/test-doubles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-doubles/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK1E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/test-doubles/index.js

@@ -0,0 +1,14 @@
+// Test-double surface for @nodii/saga.
+//
+// Importing from `@nodii/saga/test-doubles` is the only sanctioned way
+// to use the in-memory state store + Noop signal bus. They are NOT
+// re-exported through the main `@nodii/saga` barrel — production code
+// must use `PostgresSagaStateStore` + `RedisSignalBus` (the defaults
+// when `db` + `redis` + `serviceId` are passed to `initSaga`).
+export { InMemorySagaStateStore } from "./in-memory-state-store";
+export { NoopSignalBus, InMemorySignalBus } from "./in-memory-signal-bus";
+// Also expose the deterministic InMemoryIdempotency + NoopIdempotency
+// so tests can wire a complete config without pulling from the (eventual)
+// `@nodii/idempotency` package.
+export { InMemoryIdempotency, NoopIdempotency } from "../idempotency";
+//# sourceMappingURL=index.js.map

package/dist/test-doubles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test-doubles/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,uEAAuE;AACvE,mEAAmE;AACnE,sEAAsE;AACtE,qEAAqE;AACrE,+DAA+D;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE1E,sEAAsE;AACtE,0EAA0E;AAC1E,gCAAgC;AAChC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}