@openora/core 0.4.1-canary.13 → 0.4.1-canary.131

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

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { findOneOrThrow, pageToOffset } from '../query-helpers.js';
+import { findOneOrThrow, pageToOffset, moneyToNumber, moneyEquals, moneyCompare, moneyScaleBy, moneyDivide, moneyFloorToScale, moneyCeilToScale, mapConcurrent, } from '../query-helpers.js';
 describe('findOneOrThrow', () => {
     it('returns the first row when present', () => {
         expect(findOneOrThrow([{ id: '1' }, { id: '2' }], new Error('nope'))).toEqual({ id: '1' });
@@ -15,4 +15,169 @@ describe('pageToOffset', () => {
         expect(pageToOffset(3, 20)).toBe(40);
     });
 });
+describe('moneyToNumber', () => {
+    it('reads a decimal money string', () => {
+        expect(moneyToNumber('100.50')).toBe(100.5);
+    });
+    it('reads a whole amount', () => {
+        expect(moneyToNumber('100')).toBe(100);
+    });
+    it('reads a zero amount', () => {
+        expect(moneyToNumber('0')).toBe(0);
+        expect(moneyToNumber('0.00')).toBe(0);
+    });
+    it('reads a negative amount', () => {
+        expect(moneyToNumber('-25.75')).toBe(-25.75);
+    });
+    it('keeps the ordering of two amounts that differ lexicographically', () => {
+        expect(moneyToNumber('9.00')).toBeLessThan(moneyToNumber('10.00'));
+    });
+    it('returns NaN for a non-numeric string rather than silently zeroing it', () => {
+        expect(moneyToNumber('abc')).toBeNaN();
+    });
+});
+describe('moneyEquals', () => {
+    it('treats the same amount written at different scales as equal', () => {
+        expect(moneyEquals('10', '10.00')).toBe(true);
+        expect(moneyEquals('0', '0.000000000000000000')).toBe(true);
+        expect(moneyEquals('010.5', '10.5')).toBe(true);
+    });
+    it('separates two amounts that differ by one wei, where a float compare cannot', () => {
+        expect(moneyEquals('1.000000000000000001', '1.000000000000000002')).toBe(false);
+        expect(moneyToNumber('1.000000000000000001')).toBe(moneyToNumber('1.000000000000000002'));
+    });
+});
+describe('moneyCompare', () => {
+    it('orders two amounts written at different scales', () => {
+        expect(moneyCompare('9.00', '10.00')).toBe(-1);
+        expect(moneyCompare('10.00', '9.00')).toBe(1);
+        expect(moneyCompare('10', '10.00')).toBe(0);
+    });
+    it('separates two amounts that differ by one wei, where moneyToNumber cannot', () => {
+        expect(moneyCompare('1.000000000000000001', '1.000000000000000002')).toBe(-1);
+        expect(moneyCompare('1.000000000000000002', '1.000000000000000001')).toBe(1);
+        expect(moneyToNumber('1.000000000000000001')).toBe(moneyToNumber('1.000000000000000002'));
+    });
+    it('orders correctly at the margin where a float compare gives the wrong answer', () => {
+        const a = '123456789012345678.000000000000000001';
+        const b = '123456789012345678.000000000000000002';
+        expect(moneyCompare(a, b)).toBe(-1);
+        expect(moneyToNumber(a)).toBe(moneyToNumber(b));
+    });
+});
+describe('moneyScaleBy', () => {
+    it('multiplies exactly', () => {
+        expect(moneyScaleBy('10', '5')).toBe('50.000000000000000000');
+        expect(moneyScaleBy('0.1', '3')).toBe('0.300000000000000000');
+    });
+    it('scales a whole amount by a fee multiple', () => {
+        expect(moneyScaleBy('2.50', '5')).toBe('12.500000000000000000');
+    });
+    it('is exact where a float multiplication would drift', () => {
+        expect(0.1 * 3).not.toBe(0.3);
+        expect(moneyScaleBy('0.1', '3')).toBe('0.300000000000000000');
+    });
+    it('truncates past MONEY_SCALE rather than rounding up', () => {
+        expect(moneyScaleBy('1.000000000000000001', '0.5')).toBe('0.500000000000000000');
+    });
+});
+describe('moneyDivide', () => {
+    it('divides exactly', () => {
+        expect(moneyDivide('10', '4')).toBe('2.500000000000000000');
+        expect(moneyDivide('1', '3')).toBe('0.333333333333333333');
+    });
+    it('is exact where a float division would drift', () => {
+        expect(0.3 / 0.1).not.toBe(3);
+        expect(moneyDivide('0.3', '0.1')).toBe('3.000000000000000000');
+    });
+    it('is the exact inverse of moneyScaleBy for a whole-dividing pair', () => {
+        expect(moneyDivide(moneyScaleBy('7', '3'), '3')).toBe('7.000000000000000000');
+    });
+    it('derives a cross rate as from/pivot ÷ to/pivot', () => {
+        expect(moneyDivide('60000', '1.1')).toBe('54545.454545454545454545');
+    });
+    it('throws on division by zero rather than returning Infinity/NaN', () => {
+        expect(() => moneyDivide('10', '0')).toThrow(RangeError);
+    });
+    it('truncates past MONEY_SCALE rather than rounding up', () => {
+        expect(moneyDivide('1', '3')).toBe('0.333333333333333333');
+    });
+});
+describe('mapConcurrent', () => {
+    const identity = async (n) => n * 2;
+    it('returns results in input order, not completion order', async () => {
+        const delays = [30, 5, 20, 1];
+        const result = await mapConcurrent(delays, 2, async (ms, index) => {
+            await new Promise((resolve) => setTimeout(resolve, ms));
+            return index;
+        });
+        expect(result).toEqual([0, 1, 2, 3]);
+    });
+    it('passes the index alongside each item', async () => {
+        const seen = [];
+        await mapConcurrent(['a', 'b', 'c'], 2, async (item, index) => {
+            seen.push([item, index]);
+        });
+        expect(seen).toEqual([
+            ['a', 0],
+            ['b', 1],
+            ['c', 2],
+        ]);
+    });
+    it('never runs more than `concurrency` calls at once', async () => {
+        let inFlight = 0;
+        let peak = 0;
+        await mapConcurrent(Array.from({ length: 20 }, (_, i) => i), 3, async () => {
+            inFlight += 1;
+            peak = Math.max(peak, inFlight);
+            await new Promise((resolve) => setTimeout(resolve, 1));
+            inFlight -= 1;
+        });
+        expect(peak).toBe(3);
+    });
+    it('handles an empty list without spawning a worker', async () => {
+        expect(await mapConcurrent([], 5, identity)).toEqual([]);
+    });
+    it('caps the worker count at the item count', async () => {
+        expect(await mapConcurrent([1, 2], 100, identity)).toEqual([2, 4]);
+    });
+    it('runs serially when concurrency is below 1', async () => {
+        expect(await mapConcurrent([1, 2, 3], 0, identity)).toEqual([2, 4, 6]);
+    });
+    it('rejects when any item rejects', async () => {
+        await expect(mapConcurrent([1, 2, 3], 2, async (n) => {
+            if (n === 2) {
+                throw new Error('item 2 failed');
+            }
+            return n;
+        })).rejects.toThrow('item 2 failed');
+    });
+});
+describe('moneyFloorToScale', () => {
+    it('truncates discarded digits rather than rounding them', () => {
+        expect(moneyFloorToScale('66.664999999999999999', 2)).toBe('66.66');
+        expect(moneyFloorToScale('19.999999999999999999', 2)).toBe('19.99');
+    });
+    it('leaves an amount already at the target scale unchanged', () => {
+        expect(moneyFloorToScale('20.00', 2)).toBe('20.00');
+    });
+    it('pads a whole amount out to the target scale', () => {
+        expect(moneyFloorToScale('20', 2)).toBe('20.00');
+    });
+    it('floors a zero amount to zero at scale', () => {
+        expect(moneyFloorToScale('0', 2)).toBe('0.00');
+    });
+});
+describe('moneyCeilToScale', () => {
+    it('rounds up whenever any discarded digit is nonzero', () => {
+        expect(moneyCeilToScale('33.335000000000000001', 2)).toBe('33.34');
+        expect(moneyCeilToScale('19.991', 2)).toBe('20.00');
+    });
+    it('leaves an exact amount unchanged', () => {
+        expect(moneyCeilToScale('33.340000000000000000', 2)).toBe('33.34');
+    });
+    it('leaves a zero amount at zero, never rounding up from nothing', () => {
+        expect(moneyCeilToScale('0', 2)).toBe('0.00');
+    });
+});
 //# sourceMappingURL=query-helpers.test.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"query-helpers.test.js","sourceRoot":"","sources":["../../../../src/server/db/__tests__/query-helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"query-helpers.test.js","sourceRoot":"","sources":["../../../../src/server/db/__tests__/query-helpers.test.ts"],"names":[],"mappings":"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"}

package/dist/server/db/drizzle.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drizzle.service.d.ts","sourceRoot":"","sources":["../../../src/server/db/drizzle.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEzE,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,cAAc,CAA0B,CAAC;AAErE,iGAAiG;AACjG,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;;IAWtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}
+{"version":3,"file":"drizzle.service.d.ts","sourceRoot":"","sources":["../../../src/server/db/drizzle.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGzE,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,cAAc,CAA0B,CAAC;AAErE,iGAAiG;AACjG,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;;IAkBtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/server/db/drizzle.service.js

@@ -1,6 +1,7 @@
 import { createToken } from '@openora/core/contracts';
 import { Pool } from 'pg';
 import { drizzle } from 'drizzle-orm/node-postgres';
+import { createLogger } from '../kernel/logger.js';
 export const DRIZZLE = createToken('DRIZZLE');
 /** One pool, one db (single-tenant, ADR-0026). Holds the connection for the composition root. */
 export class DrizzleService {
@@ -12,6 +13,13 @@ export class DrizzleService {
             throw new Error('DATABASE_URL is required');
         }
         this.pool = new Pool({ connectionString: url });
+        // A pg Pool emits 'error' when an idle backend connection dies (DB restart,
+        // failover, network drop). With no listener Node escalates it to an
+        // uncaughtException and crashes the process, so log it - which reports it via
+        // the error reporter - and let the pool re-establish on the next query.
+        this.pool.on('error', (err) => {
+            createLogger('db').error({ err }, 'idle database pool connection error');
+        });
         this.db = drizzle(this.pool, { casing: 'snake_case' });
     }
     async dispose() {

package/dist/server/db/drizzle.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"drizzle.service.js","sourceRoot":"","sources":["../../../src/server/db/drizzle.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAuB,MAAM,2BAA2B,CAAC;AAEzE,MAAM,CAAC,MAAM,OAAO,GAA0B,WAAW,CAAC,SAAS,CAAC,CAAC;AAErE,iGAAiG;AACjG,MAAM,OAAO,cAAc;IACR,IAAI,CAAO;IACnB,EAAE,CAAiB;IAE5B;QACE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"drizzle.service.js","sourceRoot":"","sources":["../../../src/server/db/drizzle.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAuB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,MAAM,OAAO,GAA0B,WAAW,CAAC,SAAS,CAAC,CAAC;AAErE,iGAAiG;AACjG,MAAM,OAAO,cAAc;IACR,IAAI,CAAO;IACnB,EAAE,CAAiB;IAE5B;QACE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,4EAA4E;QAC5E,oEAAoE;QACpE,8EAA8E;QAC9E,wEAAwE;QACxE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC5B,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,qCAAqC,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;CACF"}

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

@@ -1,6 +1,6 @@
 export { DrizzleService, DRIZZLE } from './drizzle.service.js';
 export { createDrizzleDb, type DrizzleDb, type DrizzleTx } from './drizzle.js';
-export { findOneOrThrow, pageToOffset, withAdvisoryXactLock, moneyToNumber, mapConcurrent, } from './query-helpers.js';
+export { findOneOrThrow, pageToOffset, withAdvisoryXactLock, moneyToNumber, moneyEquals, moneyCompare, moneyScaleBy, moneyDivide, moneyAdd, moneySubtract, moneyFloorToScale, moneyCeilToScale, mapConcurrent, } from './query-helpers.js';
 export { eventOutbox, type EventOutboxRow } from './outbox/schema.js';
 export { DrizzleOutboxWriter } from './outbox/writer.js';
 export { OutboxRelay, type OutboxRelayOptions } from './outbox/relay.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIzE,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIzE,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC"}

package/dist/server/db/index.js

@@ -1,6 +1,6 @@
 export { DrizzleService, DRIZZLE } from './drizzle.service.js';
 export { createDrizzleDb } from './drizzle.js';
-export { findOneOrThrow, pageToOffset, withAdvisoryXactLock, moneyToNumber, mapConcurrent, } from './query-helpers.js';
+export { findOneOrThrow, pageToOffset, withAdvisoryXactLock, moneyToNumber, moneyEquals, moneyCompare, moneyScaleBy, moneyDivide, moneyAdd, moneySubtract, moneyFloorToScale, moneyCeilToScale, mapConcurrent, } from './query-helpers.js';
 // Transactional outbox - writer binds atomically with the state change; relay publishes to MESSAGE_BROKER. See ADR-0016.
 export { eventOutbox } from './outbox/schema.js';
 export { DrizzleOutboxWriter } from './outbox/writer.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAkC,MAAM,cAAc,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,yHAAyH;AACzH,OAAO,EAAE,WAAW,EAAuB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AAEzE,8FAA8F;AAC9F,sGAAsG;AACtG,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAkC,MAAM,cAAc,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,yHAAyH;AACzH,OAAO,EAAE,WAAW,EAAuB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AAEzE,8FAA8F;AAC9F,sGAAsG;AACtG,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC"}

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,117 @@
+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);
+    });
+});
+//# 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,14 @@ 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 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;AAmBD,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"}