@openora/core 0.4.1-canary.16 → 0.4.1-canary.161

package/dist/server/db/migrate.d.ts

@@ -1,4 +1,5 @@
 import 'dotenv/config';
+import { type MigrationMeta } from 'drizzle-orm/migrator';
 export type RunMigrationsOptions = {
     /** Absolute path to the drizzle migrations folder (the dir holding the .sql + meta/). */
     migrationsFolder: string;
@@ -8,15 +9,52 @@ export type RunMigrationsOptions = {
     migrationsSchema?: string;
     /** Override the DB url; defaults to DATABASE_ADMIN_URL ?? DATABASE_URL. */
     databaseUrl?: string;
+    /**
+     * Maps a legacy journal hash to the hashes in the current migration history that produce the
+     * same final schema. Use only when a released migration history was re-baselined: when the
+     * legacy hash is present, its listed current hashes are treated as already applied.
+     */
+    migrationHashAliases?: Readonly<Record<string, readonly string[]>>;
     /**
      * Postgres extensions to `CREATE EXTENSION IF NOT EXISTS` before applying. drizzle-kit can't
      * express extensions in schema, so a module whose index needs one (eg pg_trgm for a GIN
      * trgm index) declares it here instead of hand-editing a regenerated migration.
      */
     extensions?: string[];
+    /**
+     * Raw SQL statements to run, in order, before the migrator applies any pending migration.
+     * Unlike `extensions` (a bare identifier interpolated into a fixed `CREATE EXTENSION`
+     * template, hence the strict name check), each entry here is a full statement the caller is
+     * trusted to have written safely - these are literal string constants in module source, never
+     * user input. This is for data cleanup drizzle-kit has no way to generate because it isn't a
+     * schema diff at all (eg deduping rows that violate a new constraint a pending migration is
+     * about to add) - a module declares it here instead of hand-editing a regenerated migration,
+     * same rationale as `extensions`, different problem shape.
+     */
+    preSql?: string[];
+    /**
+     * Raw SQL statements to run, in order, AFTER every pending migration is applied. Same
+     * trust model as `preSql`; for constraints drizzle-kit cannot express against a table
+     * it has just created (eg an append-only trigger on the audit log). Runs while the
+     * migration advisory lock is still held, so concurrent runners never overlap here.
+     */
+    postSql?: string[];
+};
+type SqlClient = {
+    query(sql: string, values?: unknown[]): Promise<unknown>;
 };
+/**
+ * Serializes migration runners for one journal. The lock is session-scoped, so
+ * it remains held while each migration uses its own transaction connection.
+ */
+export declare function withMigrationAdvisoryLock<T>(client: SqlClient, lockName: string, action: () => Promise<T>): Promise<T>;
+export declare function applyMigrationsIndividually({ migrations, apply, }: {
+    migrations: MigrationMeta[];
+    apply: (migration: MigrationMeta) => Promise<void>;
+}): Promise<void>;
 /** Apply one migration set against the admin connection. Idempotent: drizzle skips already-recorded migrations. */
 export declare function runMigrations(opts: RunMigrationsOptions): Promise<void>;
 /** Apply the engine `outbox` migration set (the only engine-owned table); domain modules ship their own `migrate`. */
 export declare function migrate(databaseUrl?: string): Promise<void>;
+export {};
 //# sourceMappingURL=migrate.d.ts.map

package/dist/server/db/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/server/db/migrate.ts"],"names":[],"mappings":"AAKA,OAAO,eAAe,CAAC;AAMvB,MAAM,MAAM,oBAAoB,GAAG;IACjC,yFAAyF;IACzF,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAUF,mHAAmH;AACnH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,iBAkB7D;AAED,sHAAsH;AACtH,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,iBAO3C"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/server/db/migrate.ts"],"names":[],"mappings":"AAMA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,MAAM,oBAAoB,GAAG;IACjC,yFAAyF;IACzF,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACnE;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAcF,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D,CAAC;AAEF;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,cAQzB;AAED,wBAAsB,2BAA2B,CAAC,EAChD,UAAU,EACV,KAAK,GACN,EAAE;IACD,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,KAAK,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD,iBAIA;AAED,mHAAmH;AACnH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,iBA4E7D;AAED,sHAAsH;AACtH,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,iBAO3C"}

package/dist/server/db/migrate.js

@@ -1,12 +1,12 @@
-// Uses drizzle-orm's migrator, NOT drizzle-kit (dev-only authoring tool). Each migration
-// set ships its compiled SQL in the package tarball (the per-module `drizzle/` dirs land in
-// `dist/**` via copy-drizzle), so a consumer runs migrations straight from node_modules with
-// no source checkout. Every module owns its own journal + tracking table and calls
-// `runMigrations`; this file owns only the engine `outbox` set. See ADR-0022/0020/0027.
+// Uses Drizzle's generated migration journal, but executes one file per database transaction.
+// PostgreSQL enum values cannot be used until the transaction that adds them has committed.
+// Each migration set ships its compiled SQL in the package tarball (the per-module `drizzle/`
+// dirs land in `dist/**` via copy-drizzle), so a consumer runs migrations straight from
+// node_modules with no source checkout. Every module owns its own journal + tracking table and
+// calls `runMigrations`; this file owns only the engine `outbox` set. See ADR-0022/0020/0027.
 import 'dotenv/config';
 import { fileURLToPath } from 'node:url';
-import { drizzle } from 'drizzle-orm/node-postgres';
-import { migrate as drizzleMigrate } from 'drizzle-orm/node-postgres/migrator';
+import { readMigrationFiles } from 'drizzle-orm/migrator';
 import { Pool } from 'pg';
 function migrateUrl(override) {
     const url = override ?? process.env['DATABASE_ADMIN_URL'] ?? process.env['DATABASE_URL'];
@@ -15,6 +15,27 @@ function migrateUrl(override) {
     }
     return url;
 }
+function quoteIdentifier(identifier) {
+    return `"${identifier.replaceAll('"', '""')}"`;
+}
+/**
+ * Serializes migration runners for one journal. The lock is session-scoped, so
+ * it remains held while each migration uses its own transaction connection.
+ */
+export async function withMigrationAdvisoryLock(client, lockName, action) {
+    await client.query('SELECT pg_advisory_lock(hashtext($1))', [lockName]);
+    try {
+        return await action();
+    }
+    finally {
+        await client.query('SELECT pg_advisory_unlock(hashtext($1))', [lockName]);
+    }
+}
+export async function applyMigrationsIndividually({ migrations, apply, }) {
+    for (const migration of migrations) {
+        await apply(migration);
+    }
+}
 /** Apply one migration set against the admin connection. Idempotent: drizzle skips already-recorded migrations. */
 export async function runMigrations(opts) {
     const pool = new Pool({ connectionString: migrateUrl(opts.databaseUrl) });
@@ -25,12 +46,60 @@ export async function runMigrations(opts) {
             }
             await pool.query(`CREATE EXTENSION IF NOT EXISTS ${ext}`);
         }
-        const db = drizzle(pool, { casing: 'snake_case' });
-        await drizzleMigrate(db, {
+        for (const sql of opts.preSql ?? []) {
+            await pool.query(sql);
+        }
+        const migrationsTable = opts.migrationsTable ?? '__drizzle_migrations';
+        const migrationsSchema = opts.migrationsSchema ?? 'drizzle';
+        const migrationConfig = {
             migrationsFolder: opts.migrationsFolder,
-            ...(opts.migrationsTable ? { migrationsTable: opts.migrationsTable } : {}),
-            ...(opts.migrationsSchema ? { migrationsSchema: opts.migrationsSchema } : {}),
-        });
+            migrationsTable,
+            migrationsSchema,
+        };
+        const schema = quoteIdentifier(migrationsSchema);
+        const table = quoteIdentifier(migrationsTable);
+        await pool.query(`CREATE SCHEMA IF NOT EXISTS ${schema}`);
+        await pool.query(`CREATE TABLE IF NOT EXISTS ${schema}.${table} (id SERIAL PRIMARY KEY, hash text NOT NULL, created_at bigint)`);
+        const lockClient = await pool.connect();
+        try {
+            await withMigrationAdvisoryLock(lockClient, `${migrationsSchema}.${migrationsTable}`, async () => {
+                const applied = await lockClient.query(`SELECT hash FROM ${schema}.${table}`);
+                const appliedHashes = new Set(applied.rows.map(({ hash }) => hash));
+                for (const hash of appliedHashes) {
+                    for (const alias of opts.migrationHashAliases?.[hash] ?? []) {
+                        appliedHashes.add(alias);
+                    }
+                }
+                const pending = readMigrationFiles(migrationConfig).filter((migration) => !appliedHashes.has(migration.hash));
+                await applyMigrationsIndividually({
+                    migrations: pending,
+                    apply: async (migration) => {
+                        const client = await pool.connect();
+                        try {
+                            await client.query('BEGIN');
+                            for (const statement of migration.sql) {
+                                await client.query(statement);
+                            }
+                            await client.query(`INSERT INTO ${schema}.${table} (hash, created_at) VALUES ($1, $2)`, [migration.hash, migration.folderMillis]);
+                            await client.query('COMMIT');
+                        }
+                        catch (error) {
+                            await client.query('ROLLBACK');
+                            throw error;
+                        }
+                        finally {
+                            client.release();
+                        }
+                    },
+                });
+                for (const sql of opts.postSql ?? []) {
+                    await pool.query(sql);
+                }
+            });
+        }
+        finally {
+            lockClient.release();
+        }
     }
     finally {
         await pool.end();

package/dist/server/db/migrate.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/server/db/migrate.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,4FAA4F;AAC5F,6FAA6F;AAC7F,mFAAmF;AACnF,wFAAwF;AACxF,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAmB1B,SAAS,UAAU,CAAC,QAAiB;IACnC,MAAM,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mHAAmH;AACnH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QACnD,MAAM,cAAc,CAAC,EAAE,EAAE;YACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,OAAO,CAAC,WAAoB;IAC1C,OAAO,aAAa,CAAC;QACnB,gBAAgB,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxF,eAAe,EAAE,6BAA6B;QAC9C,gBAAgB,EAAE,SAAS;QAC3B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/server/db/migrate.ts"],"names":[],"mappings":"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"}

package/dist/server/db/outbox/__tests__/relay.int.test.d.ts

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

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

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

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":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAe,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,IAAI,EAAU,CAAC;AAEf,KAAK,UAAU,OAAO,CAAC,YAAsD,EAAE;IAC7E,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;SAC9B,MAAM,CAAC,WAAW,CAAC;SACnB,MAAM,CAAC;QACN,OAAO,EAAE,UAAU,EAAE;QACrB,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE;QAC7B,UAAU,EAAE,IAAI,IAAI,EAAE;QACtB,GAAG,SAAS;KACb,CAAC;SACD,SAAS,EAAE,CAAC;IACf,OAAO,GAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,SAA6C;IAC/D,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,QAAuB,EAAE,EAAE;YAC/C,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC,CAAC;QACF,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;QACzB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5D,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,EAAE,GAAG,MAAM,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;IAClB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,YAAY,WAAW,2BAA2B,CAAC,CAAC;AACrF,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC;YACtB,KAAK,EAAE,0BAA0B;YACjC,UAAU,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;SACjD,CAAC,CAAC;QACH,MAAM,OAAO,CAAC;YACZ,KAAK,EAAE,6BAA6B;YACpC,UAAU,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;SACjD,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAErD,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QAElC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAE,MAAM,CAAC,OAAoC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAClF,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,OAAO,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAErD,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QAElC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAyB;YACnC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;gBACxB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC,CAAC;YACF,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;YACzB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACtB,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAErD,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAEtE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;aAChC,MAAM,EAAE;aACR,IAAI,CAAC,WAAW,CAAC;aACjB,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;QACtG,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,QAAQ,EAAE,EAAE;YACrC,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAErD,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAEtE,MAAM,YAAY,GAAG,MAAM,QAAQ,EAAE,CAAC;QACtC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5D,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;QAE5D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAmC,CAAC;QAC9D,UAAU,CAAC,SAAS,EAAE,CAAC;QACvB,UAAU,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QAElC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,CAAC,UAAU,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7F,MAAM,UAAU,GAAG,MAAM,QAAQ,EAAE,CAAC;QACpC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,SAAS,QAAQ;IACf,IAAI,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;QACtC,OAAO,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/E,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,MAAM,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC1E,CAAC,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE;YACnD,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;SACnC,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM,cAAc,GAAG,QAAQ,EAAE,CAAC;QAClC,MAAM,cAAc,GAAG,QAAQ,EAAE,CAAC;QAClC,MAAM,MAAM,GAAyB;YACnC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;gBACxB,cAAc,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,cAAc,CAAC,OAAO,CAAC;YAC/B,CAAC,CAAC;YACF,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;YACzB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACtB,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAEzE,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,cAAc,CAAC,OAAO,CAAC;QAE7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YACtC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE5B,cAAc,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,QAAQ,CAAC;QACf,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -1,7 +1,21 @@
 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 isUniqueConstraintViolation(e: unknown): boolean;
+export declare function uniqueConstraintName(e: unknown): string | null;
 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 escapeLike(value: string): string;
+export declare function likeContains(value: string): string;
+export declare function likePrefix(value: string): 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;AAKD,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAK/D;AAKD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAW9D;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;AAUD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAGD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;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"}

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];
@@ -9,6 +10,30 @@ export function findOneOrThrow(rows, error) {
 export function pageToOffset(page, limit) {
     return (page - 1) * limit;
 }
+// Postgres unique-violation predicate for the friendly-precheck + DB-guard pattern:
+// services pre-check for slug clashes to return a typed 409, and translate a 23505
+// from the unique index into the same error to close the concurrent-insert race.
+export function isUniqueConstraintViolation(e) {
+    if (typeof e !== 'object' || e === null || !('code' in e)) {
+        return false;
+    }
+    return e.code === '23505';
+}
+// The violated unique index for a 23505 (pg exposes it as `constraint`), so a
+// table with several unique indexes can map each to its own typed error instead
+// of blaming the first one. Null when the cause carries no constraint name.
+export function uniqueConstraintName(e) {
+    let current = e;
+    const seen = new Set();
+    while (typeof current === 'object' && current !== null && !seen.has(current)) {
+        seen.add(current);
+        if ('constraint' in current && typeof current.constraint === 'string') {
+            return current.constraint;
+        }
+        current = 'cause' in current ? current.cause : null;
+    }
+    return null;
+}
 // The single sanctioned JS-side conversion point for a decimal-string money amount.
 // Ledger writes and balance comparisons stay in SQL (numeric arithmetic); this is only
 // for a coarse, non-ledger decision (a review-queue heuristic, a velocity/cap check)
@@ -16,6 +41,92 @@ 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)}`;
+}
+// Escape LIKE wildcards so a caller-supplied value matches literally and a
+// stray % _ or \ can't widen the match. Backslash is the default PG escape char.
+export function escapeLike(value) {
+    return value.replace(/[\\%_]/g, '\\$&');
+}
+// `%value%` contains-match for ilike/like with caller input.
+export function likeContains(value) {
+    return `%${escapeLike(value)}%`;
+}
+// `value%` prefix-match for ilike/like with caller input.
+export function likePrefix(value) {
+    return `${escapeLike(value)}%`;
+}
 // 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"}