@nestarc/inbox 0.0.0-stage → 0.2.0

package/dist/storage/prisma/prisma-inbox.storage.js

@@ -0,0 +1,369 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaInboxStorage = void 0;
+const node_crypto_1 = require("node:crypto");
+const errors_1 = require("../../contracts/errors");
+const STATUSES = [
+    "PENDING",
+    "PROCESSING",
+    "RETRYABLE",
+    "COMPLETED",
+    "DEAD",
+];
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function record(row) {
+    return {
+        id: row.id,
+        scope: row.scope_kind === "global"
+            ? { kind: "global" }
+            : { kind: "tenant", id: row.scope_id },
+        source: row.source,
+        consumer: row.consumer,
+        messageId: row.message_id,
+        eventType: row.event_type,
+        schemaVersion: row.schema_version,
+        payload: row.payload,
+        payloadPurged: row.payload_purged,
+        fingerprint: row.fingerprint,
+        fingerprintVersion: row.fingerprint_version,
+        status: row.status,
+        claimToken: String(row.claim_token),
+        rowVersion: String(row.row_version),
+        attemptCount: row.attempt_count,
+        cycleAttemptCount: row.cycle_attempt_count,
+        requeueCount: row.requeue_count,
+        receivedAt: row.received_at,
+        completedAt: row.completed_at,
+        nextAttemptAt: row.next_attempt_at,
+        leaseExpiresAt: row.lease_expires_at,
+        workerId: row.worker_id,
+        lastErrorCode: row.last_error_code,
+        lastErrorMessage: row.last_error_message,
+        lastRequeueReason: row.last_requeue_reason,
+        lastRequeueActor: row.last_requeue_actor,
+        lastRequeueAt: row.last_requeue_at,
+        ...(row.correlation_id === null
+            ? {}
+            : { correlationId: row.correlation_id }),
+        ...(row.causation_id === null ? {} : { causationId: row.causation_id }),
+        headers: row.headers,
+        ...(row.replay_of === null || row.replay_of === undefined
+            ? {}
+            : {
+                replay: {
+                    originalInboxId: row.replay_of,
+                    requestId: row.replay_request_id,
+                    sourceVersion: String(row.replay_source_version),
+                    actor: row.replay_actor,
+                    reason: row.replay_reason,
+                    requestedAt: row.replayed_at,
+                },
+            }),
+    };
+}
+function scopeValues(scope) {
+    return scope
+        ? [scope.kind, scope.kind === "tenant" ? scope.id : ""]
+        : [null, null];
+}
+/** Internal PostgreSQL implementation. Undefined scope is reserved for privileged administration. */
+class PrismaInboxStorage {
+    prisma;
+    options;
+    constructor(prisma, options = {}) {
+        this.prisma = prisma;
+        this.options = options;
+    }
+    async assertSchema() {
+        try {
+            const versions = await this.prisma.$queryRawUnsafe("SELECT version FROM public.nestarc_inbox_schema WHERE singleton = true");
+            if (versions.length !== 1 || versions[0]?.version !== 2)
+                throw new errors_1.InboxSchemaError();
+            // Reading the complete projection detects incomplete/old migrations without modifying schema.
+            await this.prisma
+                .$queryRawUnsafe(`SELECT id, scope_kind, scope_id, source, consumer,
+        message_id, event_type, schema_version, payload, payload_purged, fingerprint,
+        fingerprint_version, status, claim_token, row_version, attempt_count,
+        cycle_attempt_count, requeue_count, received_at, completed_at, next_attempt_at,
+        lease_expires_at, worker_id, last_error_code, last_error_message, last_requeue_reason,
+        last_requeue_actor, last_requeue_at, correlation_id, causation_id, headers,
+        replay_of, replay_request_id, replay_source_version, replay_actor, replay_reason, replayed_at
+        FROM public.nestarc_inbox LIMIT 0`);
+            const constraints = await this.prisma.$queryRawUnsafe(`
+        SELECT EXISTS (
+          SELECT 1 FROM pg_constraint c
+          WHERE c.conrelid = 'public.nestarc_inbox'::regclass
+            AND c.contype = 'u' AND NOT c.condeferrable
+            AND ARRAY(SELECT a.attname::text FROM unnest(c.conkey) WITH ORDINALITY k(attnum, n)
+              JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = k.attnum ORDER BY k.n)
+              = ARRAY['scope_kind','scope_id','source','consumer','message_id']::text[]
+        ) AS valid`);
+            if (!constraints[0]?.valid)
+                throw new errors_1.InboxSchemaError();
+            const replayConstraints = await this.prisma.$queryRawUnsafe(`
+        SELECT EXISTS (
+          SELECT 1 FROM pg_constraint c
+          WHERE c.conrelid = 'public.nestarc_inbox'::regclass
+            AND c.contype = 'u' AND NOT c.condeferrable
+            AND ARRAY(SELECT a.attname::text FROM unnest(c.conkey) WITH ORDINALITY k(attnum, n)
+              JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = k.attnum ORDER BY k.n)
+              = ARRAY['scope_kind','scope_id','replay_request_id']::text[]
+        ) AND EXISTS (
+          SELECT 1 FROM pg_constraint WHERE conrelid='public.nestarc_inbox'::regclass
+            AND conname='nestarc_inbox_replay_check' AND contype='c' AND convalidated
+        ) AND EXISTS (
+          SELECT 1 FROM pg_constraint WHERE conrelid='public.nestarc_inbox'::regclass
+            AND conname='nestarc_inbox_replay_original_fk' AND contype='f' AND convalidated
+            AND confrelid='public.nestarc_inbox'::regclass
+        ) AS valid`);
+            if (!replayConstraints[0]?.valid)
+                throw new errors_1.InboxSchemaError();
+        }
+        catch {
+            throw new errors_1.InboxSchemaError();
+        }
+    }
+    async accept(envelope) {
+        const identity = [
+            envelope.scope.kind,
+            envelope.scope.kind === "tenant" ? envelope.scope.id : "",
+            envelope.source,
+            envelope.consumer,
+            envelope.messageId,
+        ];
+        return this.prisma.$transaction(async (tx) => {
+            const inserted = await tx.$queryRawUnsafe(`INSERT INTO public.nestarc_inbox
+        (id,scope_kind,scope_id,source,consumer,message_id,event_type,schema_version,payload,
+         fingerprint,fingerprint_version,correlation_id,causation_id,headers)
+        VALUES ($1::uuid,$2,$3,$4,$5,$6,$7,$8::integer,$9::jsonb,$10,$11::integer,$12,$13,$14::jsonb)
+        ON CONFLICT (scope_kind,scope_id,source,consumer,message_id) DO NOTHING RETURNING *`, (0, node_crypto_1.randomUUID)(), ...identity, envelope.eventType, envelope.schemaVersion, envelope.payloadJson, envelope.fingerprint, envelope.fingerprintVersion, envelope.correlationId ?? null, envelope.causationId ?? null, JSON.stringify(envelope.headers ?? {}));
+            if (inserted[0]) {
+                // Admission applies only to new records. A duplicate must still succeed at capacity.
+                // Counting our uncommitted row makes rejection roll back this insertion, never an ACK.
+                if (this.options.maxPendingMessages !== undefined) {
+                    const count = await tx.$queryRawUnsafe(`SELECT count(*) > $1::integer AS full
+            FROM (SELECT 1 FROM public.nestarc_inbox
+              WHERE status IN ('PENDING','PROCESSING','RETRYABLE') LIMIT ($1::bigint + 1)) pending`, this.options.maxPendingMessages);
+                    if (count[0]?.full)
+                        throw new errors_1.InboxBackpressureError();
+                }
+                return {
+                    kind: "accepted",
+                    id: inserted[0].id,
+                    status: inserted[0].status,
+                };
+            }
+            // Separate READ COMMITTED statement sees a concurrent winner after ON CONFLICT waits for it.
+            const winner = await tx.$queryRawUnsafe(`SELECT * FROM public.nestarc_inbox
+        WHERE scope_kind=$1 AND scope_id=$2 AND source=$3 AND consumer=$4 AND message_id=$5`, ...identity);
+            if (!winner[0])
+                throw new errors_1.InboxStateConflictError();
+            return this.duplicate(winner[0], envelope);
+        }, { isolationLevel: "ReadCommitted", timeout: 10_000, maxWait: 5_000 });
+    }
+    duplicate(row, envelope) {
+        if (row.fingerprint !== envelope.fingerprint ||
+            row.fingerprint_version !== envelope.fingerprintVersion) {
+            throw new errors_1.InboxConflictError();
+        }
+        return { kind: "duplicate", id: row.id, status: row.status };
+    }
+    async claim(consumers, limit, workerId, leaseMs, maxAttempts) {
+        if (consumers.length === 0 || limit < 1)
+            return [];
+        return this.prisma.$transaction(async (tx) => {
+            await tx.$executeRawUnsafe(`WITH exhausted AS (
+        SELECT id FROM public.nestarc_inbox WHERE consumer = ANY($1::text[])
+          AND cycle_attempt_count >= $2::integer
+          AND ((status = 'PROCESSING' AND lease_expires_at <= clock_timestamp())
+            OR (status IN ('PENDING','RETRYABLE') AND next_attempt_at <= clock_timestamp()))
+        ORDER BY next_attempt_at,id LIMIT $3::integer FOR UPDATE SKIP LOCKED
+      ) UPDATE public.nestarc_inbox i SET status='DEAD',lease_expires_at=NULL,worker_id=NULL,
+        last_error_code='ATTEMPTS_EXHAUSTED',last_error_message='The processing attempt limit was reached.',
+        row_version=i.row_version+1 FROM exhausted e WHERE i.id=e.id`, consumers, maxAttempts, Math.min(1000, Math.max(limit, 100)));
+            const rows = await tx.$queryRawUnsafe(`WITH candidates AS (
+        SELECT id FROM public.nestarc_inbox WHERE consumer = ANY($1::text[])
+          AND cycle_attempt_count < $2::integer
+          AND ((status IN ('PENDING','RETRYABLE') AND next_attempt_at <= clock_timestamp())
+            OR (status='PROCESSING' AND lease_expires_at <= clock_timestamp()))
+        ORDER BY next_attempt_at,id LIMIT $3::integer FOR UPDATE SKIP LOCKED
+      ) UPDATE public.nestarc_inbox i SET status='PROCESSING',claim_token=i.claim_token+1,
+        row_version=i.row_version+1,attempt_count=i.attempt_count+1,
+        cycle_attempt_count=i.cycle_attempt_count+1,worker_id=$4,
+        lease_expires_at=clock_timestamp()+($5::double precision * interval '1 millisecond')
+        FROM candidates c WHERE i.id=c.id RETURNING i.*`, consumers, maxAttempts, limit, workerId, leaseMs);
+            return rows.map(record);
+        }, { isolationLevel: "ReadCommitted", timeout: 10_000, maxWait: 5_000 });
+    }
+    async run(claimed, fn, options) {
+        await this.prisma.$transaction(async (tx) => {
+            let timer;
+            const deadline = new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new errors_1.InboxTimeoutError()), options.timeoutMs);
+            });
+            const work = async () => {
+                await tx.$queryRawUnsafe(`SELECT
+          set_config('statement_timeout',$1,true),
+          set_config('idle_in_transaction_session_timeout',$1,true),
+          set_config('lock_timeout',$2,true)`, `${options.timeoutMs}ms`, `${options.lockTimeoutMs}ms`);
+                await fn(tx);
+                const changed = await tx.$executeRawUnsafe(`UPDATE public.nestarc_inbox
+          SET status='COMPLETED',completed_at=clock_timestamp(),lease_expires_at=NULL,worker_id=NULL,
+            row_version=row_version+1,last_error_code=NULL,last_error_message=NULL
+          WHERE id=$1::uuid AND status='PROCESSING' AND claim_token=$2::bigint
+            AND lease_expires_at > clock_timestamp()`, claimed.id, claimed.claimToken);
+                if (changed !== 1)
+                    throw new errors_1.InboxLeaseLostError();
+            };
+            try {
+                // Rejection returns from the interactive transaction, closing it before late callback writes.
+                await Promise.race([work(), deadline]);
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
+            }
+        }, {
+            isolationLevel: "ReadCommitted",
+            timeout: options.timeoutMs,
+            maxWait: options.maxWaitMs,
+        });
+    }
+    async heartbeat(id, token, leaseMs) {
+        return ((await this.prisma.$executeRawUnsafe(`UPDATE public.nestarc_inbox
+      SET lease_expires_at=clock_timestamp()+($3::double precision * interval '1 millisecond')
+      WHERE id=$1::uuid AND claim_token=$2::bigint AND status='PROCESSING'
+        AND lease_expires_at > clock_timestamp()`, id, token, leaseMs)) === 1);
+    }
+    async fail(id, token, error, permanent, delayMs, maxAttempts) {
+        return ((await this.prisma.$executeRawUnsafe(`UPDATE public.nestarc_inbox
+      SET status=CASE WHEN $3::boolean OR cycle_attempt_count >= $4::integer THEN 'DEAD' ELSE 'RETRYABLE' END,
+        next_attempt_at=clock_timestamp()+($5::double precision * interval '1 millisecond'),
+        lease_expires_at=NULL,worker_id=NULL,row_version=row_version+1,
+        last_error_code=$6,last_error_message=$7
+      WHERE id=$1::uuid AND claim_token=$2::bigint AND status='PROCESSING'
+        AND lease_expires_at > clock_timestamp()`, id, token, permanent, maxAttempts, delayMs, error.code, error.message)) === 1);
+    }
+    async get(id, scope) {
+        const rows = await this.prisma.$queryRawUnsafe(`SELECT * FROM public.nestarc_inbox
+      WHERE id=$1::uuid AND ($2::text IS NULL OR (scope_kind=$2 AND scope_id=$3))`, id, ...scopeValues(scope));
+        return rows[0] ? record(rows[0]) : null;
+    }
+    async list(options = {}, scope) {
+        const limit = options.limit ?? 50;
+        if (!Number.isInteger(limit) || limit < 1 || limit > 1000)
+            throw new errors_1.InboxValidationError("List limit must be between 1 and 1000.");
+        if (options.cursor !== undefined && !UUID.test(options.cursor))
+            throw new errors_1.InboxValidationError("Invalid inbox cursor.");
+        if (options.status !== undefined && !STATUSES.includes(options.status))
+            throw new errors_1.InboxValidationError("Invalid inbox status.");
+        const rows = await this.prisma.$queryRawUnsafe(`SELECT * FROM public.nestarc_inbox
+      WHERE ($1::text IS NULL OR (scope_kind=$1 AND scope_id=$2))
+        AND ($3::text IS NULL OR status=$3) AND ($4::text IS NULL OR consumer=$4)
+        AND ($5::uuid IS NULL OR id > $5::uuid)
+      ORDER BY id LIMIT $6::integer`, ...scopeValues(scope), options.status ?? null, options.consumer ?? null, options.cursor ?? null, limit + 1);
+        const page = rows.slice(0, limit);
+        return {
+            records: page.map(record),
+            nextCursor: rows.length > limit ? page[page.length - 1].id : null,
+        };
+    }
+    async requeue(id, scope, expectedVersion, reason, actor) {
+        const rows = await this.prisma.$queryRawUnsafe(`UPDATE public.nestarc_inbox
+      SET status='PENDING',cycle_attempt_count=0,requeue_count=requeue_count+1,
+        next_attempt_at=clock_timestamp(),row_version=row_version+1,
+        last_requeue_reason=$5,last_requeue_actor=$6,last_requeue_at=clock_timestamp()
+      WHERE id=$1::uuid AND ($2::text IS NULL OR (scope_kind=$2 AND scope_id=$3))
+        AND status='DEAD' AND row_version=$4::bigint RETURNING *`, id, ...scopeValues(scope), expectedVersion, reason, actor);
+        if (!rows[0])
+            throw new errors_1.InboxStateConflictError();
+        return record(rows[0]);
+    }
+    async replay(options, scope) {
+        return this.prisma.$transaction(async (tx) => {
+            // Serialize replay admission against cleanup and other requests for this original.
+            const originals = await tx.$queryRawUnsafe(`SELECT * FROM public.nestarc_inbox
+        WHERE id=$1::uuid AND ($2::text IS NULL OR (scope_kind=$2 AND scope_id=$3)) FOR UPDATE`, options.id, ...scopeValues(scope));
+            const original = originals[0];
+            if (!original)
+                throw new errors_1.InboxStateConflictError();
+            const existing = async () => (await tx.$queryRawUnsafe(`SELECT * FROM public.nestarc_inbox
+        WHERE scope_kind=$1 AND scope_id=$2 AND replay_request_id=$3::uuid`, original.scope_kind, original.scope_id, options.requestId))[0];
+            const duplicate = (row) => {
+                if (row.replay_of !== original.id ||
+                    row.consumer !== options.targetConsumer ||
+                    String(row.replay_source_version) !== options.expectedVersion ||
+                    row.replay_actor !== options.actor ||
+                    row.replay_reason !== options.reason)
+                    throw new errors_1.InboxReplayConflictError();
+                return { kind: "duplicate", record: record(row) };
+            };
+            // Return an already committed request even if cleanup advanced the source version.
+            const prior = await existing();
+            if (prior)
+                return duplicate(prior);
+            if (original.status !== "COMPLETED" ||
+                original.payload_purged ||
+                String(original.row_version) !== options.expectedVersion)
+                throw new errors_1.InboxStateConflictError();
+            const rows = await tx.$queryRawUnsafe(`INSERT INTO public.nestarc_inbox
+        (id,scope_kind,scope_id,source,consumer,message_id,event_type,schema_version,payload,
+          fingerprint,fingerprint_version,correlation_id,causation_id,headers,
+          replay_of,replay_request_id,replay_source_version,replay_actor,replay_reason,replayed_at)
+        VALUES ($1::uuid,$2,$3,$4,$5,$6,$7,$8::integer,$9::jsonb,$10,$11::integer,$12,$13,$14::jsonb,
+          $15::uuid,$16::uuid,$17::bigint,$18,$19,clock_timestamp())
+        ON CONFLICT DO NOTHING RETURNING *`, (0, node_crypto_1.randomUUID)(), original.scope_kind, original.scope_id, original.source, options.targetConsumer, `replay:${original.id}:${options.requestId}`, original.event_type, original.schema_version, JSON.stringify(original.payload), original.fingerprint, original.fingerprint_version, original.correlation_id, original.causation_id, JSON.stringify(original.headers ?? {}), original.id, options.requestId, options.expectedVersion, options.actor, options.reason);
+            if (!rows[0]) {
+                const winner = await existing();
+                if (winner)
+                    return duplicate(winner);
+                // An externally accepted message occupied the synthetic delivery identity.
+                throw new errors_1.InboxReplayConflictError();
+            }
+            if (this.options.maxPendingMessages !== undefined) {
+                const count = await tx.$queryRawUnsafe(`SELECT count(*) > $1::integer AS full FROM (SELECT 1 FROM public.nestarc_inbox
+            WHERE status IN ('PENDING','PROCESSING','RETRYABLE') LIMIT ($1::bigint + 1)) pending`, this.options.maxPendingMessages);
+                if (count[0]?.full)
+                    throw new errors_1.InboxBackpressureError();
+            }
+            return { kind: "accepted", record: record(rows[0]) };
+        }, { isolationLevel: "ReadCommitted", timeout: 10_000, maxWait: 5_000 });
+    }
+    async stats(scope) {
+        const rows = await this.prisma.$queryRawUnsafe(`
+      SELECT status,count(*) AS count,min(received_at) AS oldest FROM public.nestarc_inbox
+      WHERE ($1::text IS NULL OR (scope_kind=$1 AND scope_id=$2)) GROUP BY status`, ...scopeValues(scope));
+        const counts = {
+            PENDING: 0,
+            PROCESSING: 0,
+            RETRYABLE: 0,
+            COMPLETED: 0,
+            DEAD: 0,
+        };
+        let oldestPendingAt = null;
+        for (const row of rows) {
+            counts[row.status] = Number(row.count);
+            if (["PENDING", "PROCESSING", "RETRYABLE"].includes(row.status) &&
+                row.oldest &&
+                (!oldestPendingAt || row.oldest < oldestPendingAt))
+                oldestPendingAt = row.oldest;
+        }
+        return { counts, oldestPendingAt };
+    }
+    async purgeCompletedPayload(before, limit, scope) {
+        if (!Number.isInteger(limit) ||
+            limit < 1 ||
+            limit > 1000 ||
+            !Number.isFinite(before.getTime())) {
+            throw new errors_1.InboxValidationError("Payload cleanup requires a valid date and a limit between 1 and 1000.");
+        }
+        return this.prisma.$executeRawUnsafe(`WITH candidates AS (
+      SELECT id FROM public.nestarc_inbox WHERE status='COMPLETED' AND NOT payload_purged
+        AND completed_at < $1::timestamptz AND ($2::text IS NULL OR (scope_kind=$2 AND scope_id=$3))
+      ORDER BY completed_at,id LIMIT $4::integer FOR UPDATE SKIP LOCKED
+    ) UPDATE public.nestarc_inbox i SET payload=NULL,payload_purged=true,row_version=i.row_version+1
+      FROM candidates c WHERE i.id=c.id`, before, ...scopeValues(scope), limit);
+    }
+}
+exports.PrismaInboxStorage = PrismaInboxStorage;
+//# sourceMappingURL=prisma-inbox.storage.js.map

package/dist/storage/prisma/prisma-inbox.storage.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,40 @@
+import type { InboxRecord, InboxStatus } from "../contracts/types";
+import type { InboxAdminView } from "../inbox-admin.service";
+import type { InboxService } from "../inbox.service";
+export interface InboxTestOptions {
+    /** Overall wait budget, including database reads and worker execution. Default: 5,000. */
+    timeoutMs?: number;
+    /** Delay between state checks. Default: 10. */
+    pollIntervalMs?: number;
+    /** Maximum state-check passes. Default: 1,000. */
+    maxPasses?: number;
+    signal?: AbortSignal;
+}
+export interface InboxWaitOptions extends InboxTestOptions {
+    /** The terminal state to wait for. Default: COMPLETED. */
+    status?: "COMPLETED" | "DEAD";
+}
+/** Safe diagnostics; deliberately excludes payloads, scope and handler error text. */
+export interface InboxTestSnapshot {
+    id: string;
+    status: InboxStatus | null;
+    attemptCount: number | null;
+    cycleAttemptCount: number | null;
+}
+export type InboxTestErrorCode = "INVALID_OPTIONS" | "TIMEOUT" | "ABORTED" | "PASS_LIMIT" | "UNEXPECTED_TERMINAL_STATE";
+export declare class InboxTestError extends Error {
+    readonly code: InboxTestErrorCode;
+    readonly records: readonly InboxTestSnapshot[];
+    constructor(code: InboxTestErrorCode, message: string, records?: readonly InboxTestSnapshot[]);
+}
+type Reader = Pick<InboxAdminView, "get">;
+type Runner = Pick<InboxService, "runOnce">;
+/**
+ * Run the real worker until the requested receipts are COMPLETED.
+ * IDs select assertions, not claims: runOnce may process other owned receipts.
+ * Timeout/cancellation stops waiting and new polls; it cannot cancel an in-flight transaction.
+ */
+export declare function drainInbox(inbox: Runner, admin: Reader, ids: readonly string[], options?: InboxTestOptions): Promise<InboxRecord[]>;
+/** Observe an existing worker without starting processing or changing the receipt. */
+export declare function waitForInboxRecord(admin: Reader, id: string, options?: InboxWaitOptions): Promise<InboxRecord>;
+export {};

package/dist/testing/index.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InboxTestError = void 0;
+exports.drainInbox = drainInbox;
+exports.waitForInboxRecord = waitForInboxRecord;
+const abort_1 = require("../internal/reliability-core/abort");
+class InboxTestError extends Error {
+    code;
+    records;
+    constructor(code, message, records = []) {
+        super(message);
+        this.code = code;
+        this.name = "InboxTestError";
+        this.records = records.map((record) => ({ ...record }));
+    }
+}
+exports.InboxTestError = InboxTestError;
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1 || value > 2147483647)
+        throw new InboxTestError("INVALID_OPTIONS", `${name} must be a positive 32-bit integer.`);
+    return value;
+}
+function receiptIds(ids) {
+    if (!Array.isArray(ids) ||
+        ids.length > 1000 ||
+        Array.from(ids).some((id) => typeof id !== "string" ||
+            !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)))
+        throw new InboxTestError("INVALID_OPTIONS", "Provide at most 1,000 receipt UUIDs.");
+    return [...new Set(ids.map((id) => id.toLowerCase()))];
+}
+function pause(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const aborted = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", aborted);
+            reject(signal.reason);
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", aborted);
+            resolve();
+        }, ms);
+        signal.addEventListener("abort", aborted, { once: true });
+        if (signal.aborted)
+            aborted();
+    });
+}
+async function awaitRecords(reader, ids, options, runner) {
+    const timeoutMs = positiveInteger(options.timeoutMs ?? 5000, "timeoutMs");
+    const pollIntervalMs = positiveInteger(options.pollIntervalMs ?? 10, "pollIntervalMs");
+    const maxPasses = positiveInteger(options.maxPasses ?? 1000, "maxPasses");
+    const status = options.status ?? "COMPLETED";
+    if (status !== "COMPLETED" && status !== "DEAD")
+        throw new InboxTestError("INVALID_OPTIONS", "status must be COMPLETED or DEAD.");
+    const snapshots = ids.map((id) => ({
+        id,
+        status: null,
+        attemptCount: null,
+        cycleAttemptCount: null,
+    }));
+    const controller = new AbortController();
+    const fail = (code, message) => new InboxTestError(code, message, snapshots);
+    const aborted = () => controller.abort(fail("ABORTED", "Inbox test wait was aborted."));
+    options.signal?.addEventListener("abort", aborted, { once: true });
+    if (options.signal?.aborted)
+        aborted();
+    const timer = setTimeout(() => controller.abort(fail("TIMEOUT", `Inbox test did not reach ${status} within ${timeoutMs}ms.`)), timeoutMs);
+    const run = (fn) => (0, abort_1.withAbort)(controller.signal, fn);
+    try {
+        return await run(async () => {
+            if (ids.length === 0)
+                return [];
+            for (let pass = 0; pass < maxPasses; pass++) {
+                const records = [];
+                for (let index = 0; index < ids.length; index++) {
+                    const record = await run(() => reader.get(ids[index]));
+                    snapshots[index] = {
+                        id: ids[index],
+                        status: record?.status ?? null,
+                        attemptCount: record?.attemptCount ?? null,
+                        cycleAttemptCount: record?.cycleAttemptCount ?? null,
+                    };
+                    if (record)
+                        records.push(record);
+                    if (record &&
+                        record.status !== status &&
+                        (record.status === "DEAD" || record.status === "COMPLETED"))
+                        throw fail("UNEXPECTED_TERMINAL_STATE", `Inbox receipt ${record.id} reached ${record.status}; expected ${status}.`);
+                }
+                if (records.length === ids.length &&
+                    records.every((record) => record.status === status))
+                    return records;
+                if (pass + 1 === maxPasses)
+                    break;
+                if (runner)
+                    await run(() => runner.runOnce());
+                // A zero-claim poll may mean a scheduled retry or a live lease, not completion.
+                await pause(pollIntervalMs, controller.signal);
+            }
+            throw fail("PASS_LIMIT", `Inbox test did not reach ${status} after ${maxPasses} state checks.`);
+        });
+    }
+    finally {
+        clearTimeout(timer);
+        options.signal?.removeEventListener("abort", aborted);
+    }
+}
+/**
+ * Run the real worker until the requested receipts are COMPLETED.
+ * IDs select assertions, not claims: runOnce may process other owned receipts.
+ * Timeout/cancellation stops waiting and new polls; it cannot cancel an in-flight transaction.
+ */
+async function drainInbox(inbox, admin, ids, options = {}) {
+    return awaitRecords(admin, receiptIds(ids), { ...options, status: "COMPLETED" }, inbox);
+}
+/** Observe an existing worker without starting processing or changing the receipt. */
+async function waitForInboxRecord(admin, id, options = {}) {
+    const records = await awaitRecords(admin, receiptIds([id]), options);
+    return records[0];
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/worker/inbox-worker.d.ts

@@ -0,0 +1,31 @@
+import type { InboxHandler, InboxOptions, ResolvedWorkerOptions } from "../contracts/types";
+import type { PrismaInboxStorage } from "../storage/prisma/prisma-inbox.storage";
+/** Internal polling worker. Business effects and completion are committed by storage.run(). */
+export declare class InboxWorker {
+    private readonly storage;
+    private readonly options;
+    private readonly observer?;
+    private readonly handlerContext?;
+    private readonly workerId;
+    private readonly handlers;
+    private readonly active;
+    private readonly controllers;
+    private claimPromise;
+    private timer;
+    private running;
+    private stopped;
+    private stopPromise;
+    constructor(storage: PrismaInboxStorage, handlers: InboxHandler<any, any>[], options: ResolvedWorkerOptions, observer?: InboxOptions["observer"], handlerContext?: InboxOptions["handlerContext"]);
+    /** Start background polling. Schema validation must have succeeded first. */
+    start(): void;
+    /** Claim only free slots and wait for this batch. Concurrent calls cannot oversubscribe. */
+    tick(): Promise<number>;
+    /** Stop is terminal and idempotent. Expired in-flight work is recovered via its lease. */
+    stop(): Promise<void>;
+    private schedule;
+    private drain;
+    private process;
+    private recordFailure;
+    private retryDelay;
+    private observe;
+}