@openora/core 0.4.1-canary.15 → 0.4.1-canary.150

package/dist/server/db/outbox/__tests__/relay.int.test.js

@@ -0,0 +1,183 @@
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from 'vitest';
+import { randomUUID } from 'node:crypto';
+import { eq, sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { migrate } from '@openora/core/server/migrate';
+import { OutboxRelay } from '../relay.js';
+import { eventOutbox } from '../schema.js';
+let db;
+async function seedRow(overrides = {}) {
+    const [row] = await db.drizzle.db
+        .insert(eventOutbox)
+        .values({
+        eventId: randomUUID(),
+        topic: 'wallet.deposit.completed',
+        payload: { id: randomUUID() },
+        occurredAt: new Date(),
+        ...overrides,
+    })
+        .returning();
+    return row;
+}
+function brokerThat(onPublish) {
+    return {
+        publish: vi.fn(async (envelope) => {
+            onPublish?.(envelope);
+        }),
+        subscribe: () => () => { },
+        close: async () => { },
+    };
+}
+async function rowsById() {
+    const rows = await db.drizzle.db.select().from(eventOutbox);
+    return new Map(rows.map((r) => [r.eventId, r]));
+}
+beforeAll(async () => {
+    db = await createTestDb([migrate]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${eventOutbox} RESTART IDENTITY CASCADE`);
+});
+describe('OutboxRelay.drainOnce (real PG)', () => {
+    it('publishes pending rows in order and marks them published', async () => {
+        const a = await seedRow({
+            topic: 'wallet.deposit.completed',
+            occurredAt: new Date('2026-01-01T00:00:00.000Z'),
+        });
+        await seedRow({
+            topic: 'wallet.withdrawal.completed',
+            occurredAt: new Date('2026-01-01T00:00:01.000Z'),
+        });
+        const broker = brokerThat();
+        const relay = new OutboxRelay(db.drizzle.db, broker);
+        const n = await relay.drainOnce();
+        expect(n).toBe(2);
+        expect(broker.publish).toHaveBeenCalledTimes(2);
+        expect(broker.publish.mock.calls[0][0]).toMatchObject({
+            eventId: a.eventId,
+            topic: a.topic,
+        });
+        const rows = await db.drizzle.db.select().from(eventOutbox);
+        expect(rows.every((r) => r.publishedAt !== null)).toBe(true);
+    });
+    it('is a no-op when nothing is pending', async () => {
+        await seedRow({ publishedAt: new Date() });
+        const broker = brokerThat();
+        const relay = new OutboxRelay(db.drizzle.db, broker);
+        const n = await relay.drainOnce();
+        expect(n).toBe(0);
+        expect(broker.publish).not.toHaveBeenCalled();
+    });
+    it('leaves the row pending when broker.publish throws', async () => {
+        const row = await seedRow();
+        const broker = {
+            publish: vi.fn(async () => {
+                throw new Error('broker unreachable');
+            }),
+            subscribe: () => () => { },
+            close: async () => { },
+        };
+        const relay = new OutboxRelay(db.drizzle.db, broker);
+        await expect(relay.drainOnce()).rejects.toThrow('broker unreachable');
+        const [after] = await db.drizzle.db
+            .select()
+            .from(eventOutbox)
+            .where(eq(eventOutbox.eventId, row.eventId));
+        expect(after?.publishedAt).toBeNull();
+    });
+    it('keeps rows published before a mid-batch publish failure, retrying only the failing row', async () => {
+        const a = await seedRow({ occurredAt: new Date('2026-01-01T00:00:00.000Z') });
+        const b = await seedRow({ occurredAt: new Date('2026-01-01T00:00:01.000Z') });
+        const c = await seedRow({ occurredAt: new Date('2026-01-01T00:00:02.000Z') });
+        const broker = brokerThat((envelope) => {
+            if (envelope.eventId === b.eventId) {
+                throw new Error('broker unreachable');
+            }
+        });
+        const relay = new OutboxRelay(db.drizzle.db, broker);
+        await expect(relay.drainOnce()).rejects.toThrow('broker unreachable');
+        const afterFailure = await rowsById();
+        expect(afterFailure.get(a.eventId)?.publishedAt).not.toBeNull();
+        expect(afterFailure.get(b.eventId)?.publishedAt).toBeNull();
+        expect(afterFailure.get(c.eventId)?.publishedAt).toBeNull();
+        const publishSpy = broker.publish;
+        publishSpy.mockClear();
+        publishSpy.mockImplementation(async () => undefined);
+        const n = await relay.drainOnce();
+        expect(n).toBe(2);
+        expect(publishSpy).toHaveBeenCalledTimes(2);
+        expect(publishSpy.mock.calls.map((call) => call[0].eventId)).toEqual([b.eventId, c.eventId]);
+        const afterRetry = await rowsById();
+        expect([...afterRetry.values()].every((r) => r.publishedAt !== null)).toBe(true);
+    });
+});
+function deferred() {
+    let resolve = () => { };
+    const promise = new Promise((r) => {
+        resolve = r;
+    });
+    return { promise, resolve: () => resolve() };
+}
+describe('OutboxRelay poll loop (real PG)', () => {
+    it('publishes on its own, with nobody calling drainOnce', async () => {
+        const row = await seedRow();
+        const relay = new OutboxRelay(db.drizzle.db, brokerThat(), { intervalMs: 10 });
+        relay.start();
+        try {
+            await vi.waitFor(async () => {
+                expect((await rowsById()).get(row.eventId)?.publishedAt).not.toBeNull();
+            });
+        }
+        finally {
+            await relay.stop();
+        }
+    });
+    it('reports a failing drain to onError and keeps polling', async () => {
+        await seedRow();
+        const errors = [];
+        const broker = brokerThat(() => {
+            throw new Error('broker unreachable');
+        });
+        const relay = new OutboxRelay(db.drizzle.db, broker, {
+            intervalMs: 10,
+            onError: (err) => errors.push(err),
+        });
+        relay.start();
+        try {
+            await vi.waitFor(() => expect(errors.length).toBeGreaterThan(1));
+        }
+        finally {
+            await relay.stop();
+        }
+        expect(errors[0]).toMatchObject({ message: 'broker unreachable' });
+    });
+    it('stops the timer but waits for the drain already in flight', async () => {
+        await seedRow();
+        const publishStarted = deferred();
+        const releasePublish = deferred();
+        const broker = {
+            publish: vi.fn(async () => {
+                publishStarted.resolve();
+                await releasePublish.promise;
+            }),
+            subscribe: () => () => { },
+            close: async () => { },
+        };
+        const relay = new OutboxRelay(db.drizzle.db, broker, { intervalMs: 10 });
+        relay.start();
+        await publishStarted.promise;
+        let stopped = false;
+        const stopping = relay.stop().then(() => {
+            stopped = true;
+        });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(stopped).toBe(false);
+        releasePublish.resolve();
+        await stopping;
+        expect(stopped).toBe(true);
+    });
+});
+//# sourceMappingURL=relay.int.test.js.map

package/dist/server/db/outbox/__tests__/relay.int.test.js.map

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

package/dist/server/db/query-helpers.d.ts

@@ -2,6 +2,15 @@ import type { DrizzleTx } from './drizzle.js';
 export declare function findOneOrThrow<T>(rows: T[], error: Error): T;
 export declare function pageToOffset(page: number, limit: number): number;
 export declare function moneyToNumber(amount: string): number;
+export declare function moneyEquals(a: string, b: string): boolean;
+export declare function isPositiveMoney(value: string): boolean;
+export declare function moneyCompare(a: string, b: string): -1 | 0 | 1;
+export declare function moneyScaleBy(amount: string, factor: string): string;
+export declare function moneyDivide(dividend: string, divisor: string): string;
+export declare function moneyAdd(a: string, b: string): string;
+export declare function moneySubtract(a: string, b: string): string;
+export declare function moneyFloorToScale(amount: string, scale: number): string;
+export declare function moneyCeilToScale(amount: string, scale: number): string;
 export declare function mapConcurrent<T, R>(items: readonly T[], concurrency: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
 export declare function withAdvisoryXactLock<T>(txn: DrizzleTx, key: string, fn: () => Promise<T>): Promise<T>;
 //# sourceMappingURL=query-helpers.d.ts.map

package/dist/server/db/query-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-helpers.d.ts","sourceRoot":"","sources":["../../../src/server/db/query-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAM5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAEvD;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAOD,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EACtC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAad;AAID,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAGZ"}
+{"version":3,"file":"query-helpers.d.ts","sourceRoot":"","sources":["../../../src/server/db/query-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAM5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAEvD;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzD;AAuBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAG7D;AAKD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOrE;AAMD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtE;AAaD,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EACtC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAad;AAID,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAGZ"}

package/dist/server/db/query-helpers.js

@@ -1,3 +1,4 @@
+import { MONEY_SCALE, MoneyAmountSchema } from '@openora/core/contracts';
 import { sql } from 'drizzle-orm';
 export function findOneOrThrow(rows, error) {
     const row = rows[0];
@@ -16,6 +17,79 @@ export function pageToOffset(page, limit) {
 export function moneyToNumber(amount) {
     return Number(amount);
 }
+// Exact equality for two decimal-string money amounts, ignoring notation ("10" === "10.00").
+// Never route this through moneyToNumber: a float carries ~15 significant digits, so at
+// MONEY_SCALE two genuinely different amounts compare equal and an idempotency replay
+// accepts a mismatched retry. Scaling to integer minor units keeps the compare exact.
+export function moneyEquals(a, b) {
+    return toMinorUnits(a) === toMinorUnits(b);
+}
+function toMinorUnits(amount) {
+    const [whole, fraction = ''] = amount.split('.');
+    return BigInt(whole + fraction.padEnd(MONEY_SCALE, '0').slice(0, MONEY_SCALE));
+}
+function fromMinorUnits(units) {
+    const sign = units < 0n ? '-' : '';
+    const digits = (units < 0n ? -units : units).toString().padStart(MONEY_SCALE + 1, '0');
+    const whole = digits.slice(0, -MONEY_SCALE);
+    const fraction = digits.slice(-MONEY_SCALE);
+    return `${sign}${whole}.${fraction}`;
+}
+// Exact three-way compare for two decimal-string money amounts. Never route this through
+// moneyToNumber for the same reason moneyEquals doesn't: a float carries ~15 significant
+// digits, so at MONEY_SCALE (18) two genuinely different amounts can compare equal, or
+// worse, order backwards.
+// A vendor- or operator-supplied amount is untrusted input: a malformed string ('NaN',
+// '', '1e3') must read as "not a positive amount", never reach the ledger, and never be
+// compared as a float. `Number(x) > 0` is false for 'NaN', so a bare float guard lets it
+// through to the next comparison.
+export function isPositiveMoney(value) {
+    return MoneyAmountSchema.safeParse(value).success && moneyCompare(value, '0') > 0;
+}
+export function moneyCompare(a, b) {
+    const diff = toMinorUnits(a) - toMinorUnits(b);
+    return diff < 0n ? -1 : diff > 0n ? 1 : 0;
+}
+// Exact decimal multiplication of two money amounts (`amount * factor`), via the same
+// bigint minor-units path as moneyEquals/moneyCompare - never JS float. Both operands are
+// non-negative decimal strings; the result is truncated (not rounded) to MONEY_SCALE.
+export function moneyScaleBy(amount, factor) {
+    const product = (toMinorUnits(amount) * toMinorUnits(factor)) / 10n ** BigInt(MONEY_SCALE);
+    return fromMinorUnits(product);
+}
+export function moneyDivide(dividend, divisor) {
+    const divisorUnits = toMinorUnits(divisor);
+    if (divisorUnits === 0n) {
+        throw new RangeError('moneyDivide: division by zero');
+    }
+    const dividendUnits = toMinorUnits(dividend) * 10n ** BigInt(MONEY_SCALE);
+    return fromMinorUnits(dividendUnits / divisorUnits);
+}
+// Exact decimal addition and subtraction over the same bigint minor-units path. Used to
+// derive one side of a balance change from the other: reading the balance separately and
+// then updating it leaves a window for a concurrent writer, and an append-only audit row
+// that records the wrong `before` cannot be corrected afterwards.
+export function moneyAdd(a, b) {
+    return fromMinorUnits(toMinorUnits(a) + toMinorUnits(b));
+}
+export function moneySubtract(a, b) {
+    return fromMinorUnits(toMinorUnits(a) - toMinorUnits(b));
+}
+export function moneyFloorToScale(amount, scale) {
+    const divisor = 10n ** BigInt(MONEY_SCALE - scale);
+    return fromUnitsAtScale(toMinorUnits(amount) / divisor, scale);
+}
+export function moneyCeilToScale(amount, scale) {
+    const divisor = 10n ** BigInt(MONEY_SCALE - scale);
+    const units = toMinorUnits(amount);
+    const scaledUnits = units / divisor + (units % divisor === 0n ? 0n : 1n);
+    return fromUnitsAtScale(scaledUnits, scale);
+}
+function fromUnitsAtScale(units, scale) {
+    const digits = units.toString().padStart(scale + 1, '0');
+    const whole = digits.slice(0, digits.length - scale) || '0';
+    return scale === 0 ? whole : `${whole}.${digits.slice(digits.length - scale)}`;
+}
 // Run `fn` over `items` with at most `concurrency` promises in flight, results in input
 // order. Use this instead of `Promise.all(items.map(fn))` whenever `items` comes from a
 // query (unbounded) and `fn` touches the DB: an uncapped fan-out opens one pool connection

package/dist/server/db/query-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-helpers.js","sourceRoot":"","sources":["../../../src/server/db/query-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGlC,MAAM,UAAU,cAAc,CAAI,IAAS,EAAE,KAAY;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAa;IACtD,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC5B,CAAC;AAED,oFAAoF;AACpF,uFAAuF;AACvF,qFAAqF;AACrF,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,wFAAwF;AACxF,wFAAwF;AACxF,2FAA2F;AAC3F,4FAA4F;AAC5F,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAmB,EACnB,WAAmB,EACnB,EAA0C;IAE1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,IAAI,CAAC,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0FAA0F;AAC1F,wHAAwH;AACxH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAc,EACd,GAAW,EACX,EAAoB;IAEpB,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAA,yCAAyC,GAAG,IAAI,CAAC,CAAC;IACvE,OAAO,EAAE,EAAE,CAAC;AACd,CAAC"}
+{"version":3,"file":"query-helpers.js","sourceRoot":"","sources":["../../../src/server/db/query-helpers.ts"],"names":[],"mappings":"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"}

package/dist/server/db/zod-jsonb.d.ts

@@ -0,0 +1,52 @@
+import type * as z from 'zod';
+/**
+ * A jsonb column whose TypeScript type is inferred from its Zod schema and enforced at
+ * both ends of the driver, rather than asserted by `jsonb().$type<T>()`.
+ *
+ * `$type<T>()` is a cast Postgres never checks, so the column's declared shape and the
+ * shape actually stored drift apart silently: rows written by an earlier release outlive
+ * the contract that produced them, and the mismatch only surfaces when a route tries to
+ * serialize one and fails output validation - taking every other row in that response
+ * down with it.
+ *
+ * Writes parse and throw, because a value the current contract cannot express has no
+ * business entering the column - that is where the drift is cheap to fix. Reads degrade
+ * to `null` and log, because a row already in the table is a fact: refusing to serve it
+ * would trade one unreadable field for a dead endpoint.
+ *
+ * `severity: 'error'` is for a column whose absence changes a decision rather than a
+ * rendering - a compliance signal an operator reads before approving a player. The value
+ * still degrades to null, because failing the read would take an admin's whole queue down
+ * (and the player's own status page with it, which reads the same row), but the drift is
+ * logged at error level and so reaches the bound error tracker instead of sitting in a
+ * warn line nobody greps. An empty compliance field must never look like a quiet fact.
+ */
+export declare function zodJsonb<S extends z.ZodType>(schema: S, columnName: string, { severity }?: {
+    severity?: 'warn' | 'error';
+}): {
+    (): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: z.core.output<S>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: z.core.output<S>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: z.core.output<S>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+};
+//# sourceMappingURL=zod-jsonb.d.ts.map

package/dist/server/db/zod-jsonb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-jsonb.d.ts","sourceRoot":"","sources":["../../../src/server/db/zod-jsonb.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,CAAC,MAAM,KAAK,CAAC;AAK9B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC1C,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,MAAM,EAClB,EAAE,QAAiB,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;;;EAyB5D"}

package/dist/server/db/zod-jsonb.js

@@ -0,0 +1,52 @@
+import { customType } from 'drizzle-orm/pg-core';
+import { createLogger } from '../kernel/logger.js';
+const logger = createLogger('zod-jsonb');
+/**
+ * A jsonb column whose TypeScript type is inferred from its Zod schema and enforced at
+ * both ends of the driver, rather than asserted by `jsonb().$type<T>()`.
+ *
+ * `$type<T>()` is a cast Postgres never checks, so the column's declared shape and the
+ * shape actually stored drift apart silently: rows written by an earlier release outlive
+ * the contract that produced them, and the mismatch only surfaces when a route tries to
+ * serialize one and fails output validation - taking every other row in that response
+ * down with it.
+ *
+ * Writes parse and throw, because a value the current contract cannot express has no
+ * business entering the column - that is where the drift is cheap to fix. Reads degrade
+ * to `null` and log, because a row already in the table is a fact: refusing to serve it
+ * would trade one unreadable field for a dead endpoint.
+ *
+ * `severity: 'error'` is for a column whose absence changes a decision rather than a
+ * rendering - a compliance signal an operator reads before approving a player. The value
+ * still degrades to null, because failing the read would take an admin's whole queue down
+ * (and the player's own status page with it, which reads the same row), but the drift is
+ * logged at error level and so reaches the bound error tracker instead of sitting in a
+ * warn line nobody greps. An empty compliance field must never look like a quiet fact.
+ */
+export function zodJsonb(schema, columnName, { severity = 'warn' } = {}) {
+    return customType({
+        dataType: () => 'jsonb',
+        // Serialized here for the same reason drizzle's own `jsonb` does it: node-postgres
+        // stringifies an object parameter as "[object Object]", which Postgres rejects.
+        toDriver: (value) => JSON.stringify(schema.parse(value)),
+        fromDriver: (value) => {
+            const parsed = schema.safeParse(value);
+            if (parsed.success) {
+                return parsed.data;
+            }
+            // No row id here - the driver sees the value alone. This says a column has drifted
+            // and roughly how; finding the rows is a query, not a log line.
+            const context = { column: columnName, issues: parsed.error.issues.slice(0, 3) };
+            const message = 'stored jsonb no longer matches its contract, read as null';
+            if (severity === 'error') {
+                // `err` is what makes createLogger forward this to the error tracker.
+                logger.error({ ...context, err: parsed.error }, message);
+            }
+            else {
+                logger.warn(context, message);
+            }
+            return null;
+        },
+    });
+}
+//# sourceMappingURL=zod-jsonb.js.map

package/dist/server/db/zod-jsonb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-jsonb.js","sourceRoot":"","sources":["../../../src/server/db/zod-jsonb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAS,EACT,UAAkB,EAClB,EAAE,QAAQ,GAAG,MAAM,KAAsC,EAAE;IAE3D,OAAO,UAAU,CAA2C;QAC1D,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO;QACvB,mFAAmF;QACnF,gFAAgF;QAChF,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxD,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,MAAM,CAAC,IAAI,CAAC;YACrB,CAAC;YACD,mFAAmF;YACnF,gEAAgE;YAChE,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAChF,MAAM,OAAO,GAAG,2DAA2D,CAAC;YAC5E,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,sEAAsE;gBACtE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,IAAkB,CAAC;QAC5B,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/server/kernel/__tests__/bullmq-job-queue.int.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bullmq-job-queue.int.test.d.ts.map

package/dist/server/kernel/__tests__/bullmq-job-queue.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq-job-queue.int.test.d.ts","sourceRoot":"","sources":["../../../../src/server/kernel/__tests__/bullmq-job-queue.int.test.ts"],"names":[],"mappings":""}