@venturekit/data 0.0.32 → 0.0.34

package/dist/jobs/postgres.js

@@ -0,0 +1,270 @@
+/**
+ * @venturekit/data — durable background jobs in Postgres.
+ *
+ * The `queues` intent (SQS) stays the default for opaque, high-throughput
+ * fan-out. This is for the other kind of work: the kind the product talks about.
+ * "Which imports are still geocoding for this tenant" is a screen, and a queue
+ * has no query surface — messages are invisible until received and then
+ * invisible to everyone else. Rebuilding that visibility over SQS means a second
+ * table tracking what you enqueued, at which point the queue is the redundant
+ * half, because the table can be claimed from directly.
+ *
+ * Unlike the outbox, there is no port and no adapter here. The whole value is
+ * that the work lives in queryable rows, and the claim — `FOR UPDATE SKIP
+ * LOCKED` — is SQL rather than portable logic. An abstraction over it would have
+ * exactly one implementation and would hide the one feature worth having.
+ *
+ * ```ts
+ * // enqueue in the transaction that made the work necessary
+ * await withTransaction(async (tx) => {
+ *   const batch = await stageImport(tx, rows);
+ *   await enqueueJob(tx.query, { kind: 'geocode-import', tenantId, payload: { batch: batch.id } });
+ * });
+ *
+ * // drain in a `schedules` cron
+ * await runJobsOnce({
+ *   'geocode-import': async (job) => { await geocode(job.payload); },
+ * });
+ * ```
+ */
+import { query } from '../query/index.js';
+import { assertSqlIdentifier } from '../internal/identifier.js';
+/** Default table name, created by `vk_data_003_jobs.sql`. */
+export const DEFAULT_JOB_TABLE = 'vk_job';
+const iso = (v) => v instanceof Date ? v.toISOString() : v;
+const isoOrNull = (v) => v === null ? null : iso(v);
+function mapRow(r) {
+    return {
+        id: r.id,
+        tenantId: r.tenant_id,
+        kind: r.kind,
+        payload: r.payload,
+        status: r.status,
+        runAfter: iso(r.run_after),
+        attempts: r.attempts,
+        maxAttempts: r.max_attempts,
+        lockedAt: isoOrNull(r.locked_at),
+        lockedBy: r.locked_by,
+        lastError: r.last_error,
+        createdAt: iso(r.created_at),
+        finishedAt: isoOrNull(r.finished_at),
+    };
+}
+const COLUMNS = `id, tenant_id, kind, payload, status, run_after, attempts,
+                 max_attempts, locked_at, locked_by, last_error, created_at,
+                 finished_at`;
+function tableOf(options, context) {
+    const table = options.tableName ?? DEFAULT_JOB_TABLE;
+    assertSqlIdentifier(table, context);
+    return table;
+}
+/**
+ * Enqueue a job **on the caller's transaction**.
+ *
+ * `querier` is required and not defaulted, for the same reason as
+ * `appendToOutbox`: a job enqueued on a pooled connection can commit while the
+ * transaction that needed it rolls back, leaving a worker to act on a state that
+ * does not exist. Pass the transaction's `query`.
+ */
+export async function enqueueJob(querier, input, options = {}) {
+    const table = tableOf(options, 'enqueueJob.tableName');
+    const rows = await querier(`INSERT INTO ${table} (tenant_id, kind, payload, run_after, max_attempts)
+          VALUES ($1, $2, $3::jsonb, coalesce($4, now()), coalesce($5, 5))
+       RETURNING id`, [
+        input.tenantId ?? null,
+        input.kind,
+        JSON.stringify(input.payload ?? {}),
+        input.runAfter ? iso(input.runAfter instanceof Date ? input.runAfter : new Date(input.runAfter)) : null,
+        input.maxAttempts ?? null,
+    ]);
+    const id = rows[0]?.id;
+    if (!id)
+        throw new Error('[venturekit/data] enqueueJob: insert returned no id');
+    return id;
+}
+/**
+ * Claim due jobs, marking them `running`.
+ *
+ * `FOR UPDATE SKIP LOCKED` inside the UPDATE's subquery is what makes several
+ * workers safe on one table: each takes rows nobody else holds and skips the
+ * rest rather than queueing behind them. Without SKIP LOCKED, a second worker
+ * blocks on the first's rows and the pool drains.
+ */
+export async function claimJobs(options = {}) {
+    const table = tableOf(options, 'claimJobs.tableName');
+    const run = options.querier ?? query;
+    const limit = options.limit ?? 10;
+    const workerId = options.workerId ?? process.env.AWS_LAMBDA_LOG_STREAM_NAME ?? 'worker';
+    const rows = await run(`UPDATE ${table} AS j
+        SET status    = 'running',
+            locked_at = now(),
+            locked_by = $2,
+            attempts  = j.attempts + 1,
+            updated_at = now()
+      WHERE j.id IN (
+              SELECT c.id FROM ${table} c
+               WHERE c.status = 'queued'
+                 AND c.run_after <= now()
+                 AND ($3::text[] IS NULL OR c.kind = ANY($3::text[]))
+               ORDER BY c.run_after
+               LIMIT $1
+                 FOR UPDATE SKIP LOCKED
+            )
+   RETURNING ${COLUMNS}`, [limit, workerId, options.kinds ?? null]);
+    return rows.map((r) => mapRow(r));
+}
+/** Mark a claimed job done. */
+export async function completeJob(id, options = {}) {
+    const table = tableOf(options, 'completeJob.tableName');
+    const run = options.querier ?? query;
+    await run(`UPDATE ${table}
+        SET status = 'succeeded', finished_at = now(), locked_at = NULL,
+            locked_by = NULL, last_error = NULL, updated_at = now()
+      WHERE id = $1`, [id]);
+}
+/**
+ * Record a failed attempt: re-queue it with a later `run_after`, or leave it
+ * `failed` once the attempts are spent.
+ *
+ * `attempts` was already incremented by the claim, so a crash between claim and
+ * this call still counts — otherwise a job that kills its worker every time
+ * would retry forever.
+ */
+export async function failJob(id, error, options = {}) {
+    const table = tableOf(options, 'failJob.tableName');
+    const run = options.querier ?? query;
+    const message = error instanceof Error ? error.message : String(error);
+    await run(`UPDATE ${table}
+        SET status     = CASE WHEN attempts >= max_attempts THEN 'failed' ELSE 'queued' END,
+            run_after  = now() + make_interval(
+                           secs => coalesce(
+                             $3::double precision,
+                             least(power(2, attempts)::double precision, 3600)
+                           )
+                         ),
+            locked_at  = NULL,
+            locked_by  = NULL,
+            last_error = $2,
+            finished_at = CASE WHEN attempts >= max_attempts THEN now() ELSE NULL END,
+            updated_at = now()
+      WHERE id = $1`, [id, message.slice(0, 2000), options.retryInSeconds ?? null]);
+}
+/**
+ * Hand a claimed job back **without counting the attempt**.
+ *
+ * For "I cannot run this right now", as distinct from "I ran it and it failed":
+ * no handler is registered yet, a dependency is briefly unavailable, the worker
+ * is shutting down. The claim already incremented `attempts`, so this undoes
+ * that — otherwise a job nobody can run yet would exhaust its attempts while
+ * never actually being attempted, which is how a mid-deploy job ends up `failed`
+ * for no reason.
+ */
+export async function releaseJob(id, reason, options = {}) {
+    const table = tableOf(options, 'releaseJob.tableName');
+    const run = options.querier ?? query;
+    await run(`UPDATE ${table}
+        SET status     = 'queued',
+            attempts   = greatest(attempts - 1, 0),
+            run_after  = now() + make_interval(secs => coalesce($3::double precision, 60)),
+            locked_at  = NULL,
+            locked_by  = NULL,
+            last_error = $2,
+            updated_at = now()
+      WHERE id = $1`, [id, reason.slice(0, 2000), options.retryInSeconds ?? null]);
+}
+/**
+ * Re-queue jobs left `running` by a worker that died, and return how many.
+ *
+ * A crashed worker cannot clean up after itself, so nothing else will ever move
+ * these rows: `running` plus an old `locked_at` is indistinguishable from a dead
+ * process, and treating it as one is the only way the work resumes. Worth a
+ * schedule of its own, or a call at the top of each worker pass.
+ *
+ * Jobs whose attempts are spent go to `failed` rather than back to `queued` —
+ * a job that reliably kills its worker must not do so forever.
+ */
+export async function reclaimStuckJobs(options = {}) {
+    const table = tableOf(options, 'reclaimStuckJobs.tableName');
+    const run = options.querier ?? query;
+    const stale = options.staleAfterSeconds ?? 900;
+    const rows = await run(`UPDATE ${table}
+        SET status     = CASE WHEN attempts >= max_attempts THEN 'failed' ELSE 'queued' END,
+            locked_at  = NULL,
+            locked_by  = NULL,
+            last_error = coalesce(last_error, 'worker lock expired'),
+            finished_at = CASE WHEN attempts >= max_attempts THEN now() ELSE NULL END,
+            updated_at = now()
+      WHERE status = 'running'
+        AND locked_at < now() - make_interval(secs => $1::double precision)
+   RETURNING id`, [stale]);
+    return rows.length;
+}
+/**
+ * The query this table exists to make possible: what work is outstanding.
+ *
+ * With `tenantScoped` (the default) the predicate is
+ * `tenant_id = ANY (vk_tenant_scope())` — the same predicate an RLS policy would
+ * apply, so a caller who goes through this helper cannot see another tenant's
+ * jobs. Platform rows (`tenant_id IS NULL`) fall out naturally, since
+ * `NULL = ANY (...)` is never true.
+ */
+export async function listJobs(options = {}) {
+    const table = tableOf(options, 'listJobs.tableName');
+    const run = options.querier ?? query;
+    const scoped = options.tenantScoped !== false;
+    const rows = await run(`SELECT ${COLUMNS}
+       FROM ${table}
+      WHERE ($1::text IS NULL OR kind = $1)
+        AND ($2::text IS NULL OR status = $2)
+        AND (NOT $4::boolean OR tenant_id = ANY (vk_tenant_scope()))
+      ORDER BY created_at DESC
+      LIMIT $3`, [options.kind ?? null, options.status ?? null, options.limit ?? 50, scoped]);
+    return rows.map((r) => mapRow(r));
+}
+/**
+ * One worker pass: claim, dispatch, settle. The job-queue analogue of the
+ * outbox's `relayOnce`.
+ *
+ * Returns counts rather than throwing on a handler failure — a failing job is
+ * an expected operating condition and the caller's job is to schedule the next
+ * pass. A failing *store* propagates, for the same reason as in the relay: a
+ * worker that cannot record outcomes must stop rather than keep claiming.
+ *
+ * A `kind` with no handler is re-queued with a short delay rather than failed.
+ * A deploy in progress is the usual cause — one version enqueues a kind the
+ * still-running version does not know — and burning an attempt on that would
+ * exhaust a perfectly good job during a rollout.
+ */
+export async function runJobsOnce(handlers, options = {}) {
+    const kinds = options.kinds ?? Object.keys(handlers);
+    const jobs = await claimJobs({ ...options, kinds });
+    const result = {
+        claimed: jobs.length,
+        succeeded: 0,
+        failed: 0,
+        unhandled: 0,
+    };
+    for (const job of jobs) {
+        const handler = handlers[job.kind];
+        if (!handler) {
+            result.unhandled++;
+            /* `releaseJob`, not `failJob`: the job was never attempted, so it must not
+               be charged for the claim. A deploy in progress is the usual cause — one
+               version enqueues a kind the still-running version does not know — and
+               charging that would exhaust a perfectly good job during a rollout. */
+            await releaseJob(job.id, `no handler registered for kind '${job.kind}'`, { ...options, retryInSeconds: 60 });
+            continue;
+        }
+        try {
+            await handler(job);
+            await completeJob(job.id, options);
+            result.succeeded++;
+        }
+        catch (error) {
+            await failJob(job.id, error, options);
+            result.failed++;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=postgres.js.map

package/dist/jobs/postgres.js.map

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

package/dist/outbox/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @venturekit/data — Postgres outbox store.
+ *
+ * The storage half of `@venturekit/runtime/patterns`' transactional outbox. See
+ * `./postgres.ts`.
+ */
+export { createPostgresOutboxStore, appendToOutbox, discardOutboxEvent, DEFAULT_OUTBOX_TABLE, } from './postgres.js';
+export type { EventActor, OutboxRow, OutboxFailure, AppendOutboxInput, PostgresOutboxStore, PostgresOutboxStoreOptions, } from './postgres.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/outbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,eAAe,CAAC"}

package/dist/outbox/index.js

@@ -0,0 +1,8 @@
+/**
+ * @venturekit/data — Postgres outbox store.
+ *
+ * The storage half of `@venturekit/runtime/patterns`' transactional outbox. See
+ * `./postgres.ts`.
+ */
+export { createPostgresOutboxStore, appendToOutbox, discardOutboxEvent, DEFAULT_OUTBOX_TABLE, } from './postgres.js';
+//# sourceMappingURL=index.js.map

package/dist/outbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,eAAe,CAAC"}

package/dist/outbox/postgres.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @venturekit/data — Postgres outbox store.
+ *
+ * The storage half of `@venturekit/runtime/patterns`' transactional outbox. The
+ * relay's rules live there and are pure; this is the adapter that satisfies the
+ * `OutboxStore` port against `vk_outbox`.
+ *
+ * Almost all of the difficulty is in one query. `claim()` carries three
+ * exclusions that the relay explicitly cannot make for itself, because each is a
+ * fact about rows *outside* the batch it is handed:
+ *
+ *   1. quarantined rows (`attempts >= maxAttempts`);
+ *   2. anything queued behind a quarantined row **for the same aggregate** —
+ *      without this, giving up on one event silently promotes its successors and
+ *      the per-aggregate ordering guarantee is lost between passes;
+ *   3. discarded rows, and the successors held behind them must be *released*,
+ *      since a discard is an operator deciding the event will never go.
+ *
+ * (2) and (3) pull in opposite directions and that is the point: a row is held
+ * behind an abandoned predecessor only while that predecessor is *still*
+ * abandoned. Get it wrong in one direction and a quarantine reorders the stream;
+ * wrong in the other and a discard freezes an aggregate permanently.
+ */
+import type { Querier } from '../query/index.js';
+/** Default table name, created by `vk_data_002_outbox.sql`. */
+export declare const DEFAULT_OUTBOX_TABLE = "vk_outbox";
+/** Mirrors `@venturekit/runtime/patterns`' `EventActor`. */
+export interface EventActor {
+    type: 'user' | 'system';
+    id: string;
+}
+/** Mirrors `@venturekit/runtime/patterns`' `OutboxRow`. */
+export interface OutboxRow {
+    id: string;
+    seq: number;
+    type: string;
+    aggregateType: string;
+    aggregateId: string;
+    tenantId: string | null;
+    payload: unknown;
+    eventVersion: number;
+    occurredAt: string;
+    actor: EventActor;
+    attempts: number;
+}
+export interface OutboxFailure {
+    id: string;
+    attempts: number;
+    error: string;
+}
+export interface PostgresOutboxStoreOptions {
+    /**
+     * Runs the statements. Defaults to the pooled `query`.
+     *
+     * The relay reads and marks outside any request, so the pool is right for it.
+     * The *append* side is the opposite — see {@link appendToOutbox}, which must
+     * run on the transaction that makes the state change.
+     */
+    querier?: Querier;
+    /** Table name. Validated as an identifier, since it is interpolated. */
+    tableName?: string;
+}
+export interface PostgresOutboxStore {
+    claim(limit: number, maxAttempts: number): Promise<OutboxRow[]>;
+    markPublished(ids: string[]): Promise<void>;
+    recordFailures(failures: OutboxFailure[]): Promise<void>;
+}
+/**
+ * Create a Postgres-backed outbox store.
+ *
+ * @example
+ * ```ts
+ * import { relayOnce, createEventBridgeEventBus } from '@venturekit/runtime/patterns';
+ * import { createPostgresOutboxStore } from '@venturekit/data/outbox';
+ *
+ * // in a `schedules` cron
+ * await relayOnce(createPostgresOutboxStore(), createEventBridgeEventBus());
+ * ```
+ */
+export declare function createPostgresOutboxStore(options?: PostgresOutboxStoreOptions): PostgresOutboxStore;
+/** What {@link appendToOutbox} needs; the envelope plus nothing. */
+export interface AppendOutboxInput {
+    id: string;
+    type: string;
+    aggregateType: string;
+    aggregateId: string;
+    tenantId?: string | null;
+    payload: unknown;
+    /** Payload schema version. Defaults to 1. */
+    version?: number;
+    occurredAt?: string;
+    actor: EventActor;
+    correlationId?: string | null;
+    causationId?: string | null;
+}
+/**
+ * Append an event to the outbox **on the caller's transaction**.
+ *
+ * `querier` is required and not defaulted, unlike everywhere else in this
+ * module. Defaulting it to the pool would make the easiest call the wrong one:
+ * an event written on a pooled connection does not commit with the state change
+ * it describes, which is the single guarantee the outbox exists to provide. Pass
+ * the transaction's `query`.
+ *
+ * ```ts
+ * await withTransaction(async (tx) => {
+ *   await tx.query('UPDATE orders SET status = $2 WHERE id = $1', [id, 'placed']);
+ *   await appendToOutbox(tx.query, createEvent({ ... }));
+ * });
+ * ```
+ */
+export declare function appendToOutbox(querier: Querier, event: AppendOutboxInput, options?: {
+    tableName?: string;
+}): Promise<void>;
+/**
+ * Retire an event an operator has decided will never publish.
+ *
+ * Deliberately does **not** touch `attempts`: the quarantine bound and the
+ * discard are different decisions, and collapsing them means raising the bound
+ * later drags retired events back onto the bus. Discarding also releases any
+ * successors of this aggregate that were held behind it.
+ */
+export declare function discardOutboxEvent(id: string, reason: string, options?: PostgresOutboxStoreOptions): Promise<boolean>;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/outbox/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/outbox/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAwErB;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/outbox/postgres.js

@@ -0,0 +1,177 @@
+/**
+ * @venturekit/data — Postgres outbox store.
+ *
+ * The storage half of `@venturekit/runtime/patterns`' transactional outbox. The
+ * relay's rules live there and are pure; this is the adapter that satisfies the
+ * `OutboxStore` port against `vk_outbox`.
+ *
+ * Almost all of the difficulty is in one query. `claim()` carries three
+ * exclusions that the relay explicitly cannot make for itself, because each is a
+ * fact about rows *outside* the batch it is handed:
+ *
+ *   1. quarantined rows (`attempts >= maxAttempts`);
+ *   2. anything queued behind a quarantined row **for the same aggregate** —
+ *      without this, giving up on one event silently promotes its successors and
+ *      the per-aggregate ordering guarantee is lost between passes;
+ *   3. discarded rows, and the successors held behind them must be *released*,
+ *      since a discard is an operator deciding the event will never go.
+ *
+ * (2) and (3) pull in opposite directions and that is the point: a row is held
+ * behind an abandoned predecessor only while that predecessor is *still*
+ * abandoned. Get it wrong in one direction and a quarantine reorders the stream;
+ * wrong in the other and a discard freezes an aggregate permanently.
+ */
+import { query } from '../query/index.js';
+import { assertSqlIdentifier } from '../internal/identifier.js';
+/** Default table name, created by `vk_data_002_outbox.sql`. */
+export const DEFAULT_OUTBOX_TABLE = 'vk_outbox';
+const toIso = (v) => v instanceof Date ? v.toISOString() : v;
+function mapRow(r) {
+    return {
+        id: r.id,
+        /* `bigint` comes back from node-postgres as a STRING to avoid silent
+           precision loss. Left unconverted the relay would sort `'10' < '9'` and be
+           wrong from the tenth event onward — so the conversion is the adapter's
+           job, exactly as the port says. */
+        seq: typeof r.seq === 'string' ? Number(r.seq) : r.seq,
+        type: r.type,
+        aggregateType: r.aggregate_type,
+        aggregateId: r.aggregate_id,
+        tenantId: r.tenant_id,
+        payload: r.payload,
+        eventVersion: r.event_version,
+        occurredAt: toIso(r.occurred_at),
+        actor: r.actor,
+        attempts: r.attempts,
+    };
+}
+/**
+ * Create a Postgres-backed outbox store.
+ *
+ * @example
+ * ```ts
+ * import { relayOnce, createEventBridgeEventBus } from '@venturekit/runtime/patterns';
+ * import { createPostgresOutboxStore } from '@venturekit/data/outbox';
+ *
+ * // in a `schedules` cron
+ * await relayOnce(createPostgresOutboxStore(), createEventBridgeEventBus());
+ * ```
+ */
+export function createPostgresOutboxStore(options = {}) {
+    const table = options.tableName ?? DEFAULT_OUTBOX_TABLE;
+    assertSqlIdentifier(table, 'PostgresOutboxStoreOptions.tableName');
+    const run = options.querier ?? query;
+    return {
+        async claim(limit, maxAttempts) {
+            const rows = await run(`WITH
+         /* Aggregates with an abandoned event: quarantined (out of attempts) or
+            discarded. Holds only those STILL abandoned, so a discard releases
+            the successors it was taken to release. */
+         blocked AS (
+           SELECT DISTINCT aggregate_type, aggregate_id
+             FROM ${table}
+            WHERE published_at IS NULL
+              AND discarded_at IS NULL
+              AND attempts >= $2
+         )
+         SELECT o.id, o.seq, o.type, o.aggregate_type, o.aggregate_id,
+                o.tenant_id, o.payload, o.event_version, o.occurred_at,
+                o.actor, o.attempts
+           FROM ${table} o
+           LEFT JOIN blocked b
+                  ON b.aggregate_type = o.aggregate_type
+                 AND b.aggregate_id   = o.aggregate_id
+          WHERE o.published_at IS NULL
+            AND o.discarded_at IS NULL
+            AND o.attempts < $2
+            AND b.aggregate_id IS NULL
+          ORDER BY o.seq
+          LIMIT $1
+            /* Two relay instances reading the same rows is safe but wasteful.
+               SKIP LOCKED lets a second pass take different work instead of
+               waiting on the first. */
+            FOR UPDATE SKIP LOCKED`, [limit, maxAttempts]);
+            return rows.map(mapRow);
+        },
+        async markPublished(ids) {
+            if (ids.length === 0)
+                return;
+            await run(`UPDATE ${table} SET published_at = now() WHERE id = ANY($1::uuid[])`, [ids]);
+        },
+        async recordFailures(failures) {
+            if (failures.length === 0)
+                return;
+            /* One statement via UNNEST rather than a loop: the relay calls this once
+               per pass with whatever failed, and N round trips for N bad rows is the
+               slowest part of a bad pass. */
+            await run(`UPDATE ${table} AS o
+            SET attempts   = f.attempts,
+                last_error = f.error,
+                failed_at  = now()
+           FROM (
+             SELECT * FROM unnest($1::uuid[], $2::int[], $3::text[])
+                            AS t(id, attempts, error)
+           ) AS f
+          WHERE o.id = f.id`, [
+                failures.map((f) => f.id),
+                failures.map((f) => f.attempts),
+                failures.map((f) => f.error.slice(0, 2000)),
+            ]);
+        },
+    };
+}
+/**
+ * Append an event to the outbox **on the caller's transaction**.
+ *
+ * `querier` is required and not defaulted, unlike everywhere else in this
+ * module. Defaulting it to the pool would make the easiest call the wrong one:
+ * an event written on a pooled connection does not commit with the state change
+ * it describes, which is the single guarantee the outbox exists to provide. Pass
+ * the transaction's `query`.
+ *
+ * ```ts
+ * await withTransaction(async (tx) => {
+ *   await tx.query('UPDATE orders SET status = $2 WHERE id = $1', [id, 'placed']);
+ *   await appendToOutbox(tx.query, createEvent({ ... }));
+ * });
+ * ```
+ */
+export async function appendToOutbox(querier, event, options = {}) {
+    const table = options.tableName ?? DEFAULT_OUTBOX_TABLE;
+    assertSqlIdentifier(table, 'appendToOutbox.tableName');
+    await querier(`INSERT INTO ${table}
+       (id, type, aggregate_type, aggregate_id, tenant_id, payload,
+        event_version, occurred_at, actor, correlation_id, causation_id)
+     VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7, $8, $9::jsonb, $10, $11)`, [
+        event.id,
+        event.type,
+        event.aggregateType,
+        event.aggregateId,
+        event.tenantId ?? null,
+        JSON.stringify(event.payload),
+        event.version ?? 1,
+        event.occurredAt ?? new Date().toISOString(),
+        JSON.stringify(event.actor),
+        event.correlationId ?? null,
+        event.causationId ?? null,
+    ]);
+}
+/**
+ * Retire an event an operator has decided will never publish.
+ *
+ * Deliberately does **not** touch `attempts`: the quarantine bound and the
+ * discard are different decisions, and collapsing them means raising the bound
+ * later drags retired events back onto the bus. Discarding also releases any
+ * successors of this aggregate that were held behind it.
+ */
+export async function discardOutboxEvent(id, reason, options = {}) {
+    const table = options.tableName ?? DEFAULT_OUTBOX_TABLE;
+    assertSqlIdentifier(table, 'discardOutboxEvent.tableName');
+    const run = options.querier ?? query;
+    const rows = await run(`UPDATE ${table}
+        SET discarded_at = now(), discard_reason = $2
+      WHERE id = $1 AND published_at IS NULL AND discarded_at IS NULL
+      RETURNING id`, [id, reason]);
+    return rows.length > 0;
+}
+//# sourceMappingURL=postgres.js.map

package/dist/outbox/postgres.js.map

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

package/dist/query/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAIH,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAqBrD,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,UAAU,EACV,MAAM,EACN,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA+B5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACvD,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,EAAE,EACvB,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAChC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,CAAC,CAAC,CA6CZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAIH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAqBrD,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,UAAU,EACV,MAAM,EACN,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA+B5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACvD,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,EAAE,EACvB,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAChC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,CAAC,CAAC,CA6CZ"}

package/dist/query/index.js.map

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

package/dist/query/secret.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secret.d.ts","sourceRoot":"","sources":["../../src/query/secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,OAAQ,CAAC;AAsCtD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBxD;AAoHD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
+{"version":3,"file":"secret.d.ts","sourceRoot":"","sources":["../../src/query/secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,OAAQ,CAAC;AAsCtD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBxD;AAqHD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}