@openora/core 0.4.0

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

@@ -0,0 +1,122 @@
+import { describe, it, expect, vi } from 'vitest';
+import { mock } from '../../../../testing/mock.js';
+import { OutboxRelay } from '../relay.js';
+function row(id, topic) {
+    return {
+        eventId: id,
+        topic,
+        payload: { id },
+        schemaVersion: 1,
+        traceId: null,
+        orderingKey: null,
+        occurredAt: new Date('2026-01-01T00:00:00.000Z'),
+        publishedAt: null,
+    };
+}
+// Fake drizzle: transaction() answers the SKIP LOCKED claim select; each row is then
+// marked via a top-level update(). trackPublish links that update() to the row the
+// broker just published, so a mid-batch throw leaves already-marked rows published.
+function harness(rows) {
+    let lastPublishedId = null;
+    const db = mock({
+        transaction: async (callback) => callback({
+            select: () => ({
+                from: () => ({
+                    where: () => ({
+                        orderBy: () => ({
+                            limit: () => ({
+                                for: async () => rows.filter((r) => r.publishedAt === null).map((r) => ({ ...r })),
+                            }),
+                        }),
+                    }),
+                }),
+            }),
+        }),
+        update: () => ({
+            set: (values) => ({
+                where: async () => {
+                    const r = rows.find((x) => x.eventId === lastPublishedId);
+                    if (r)
+                        r.publishedAt = values.publishedAt;
+                },
+            }),
+        }),
+    });
+    return { db, trackPublish: (eventId) => (lastPublishedId = eventId) };
+}
+function brokerThat(trackPublish, onPublish) {
+    return {
+        publish: vi.fn(async (env) => {
+            trackPublish(env.eventId);
+            onPublish?.(env.eventId);
+        }),
+        subscribe: () => () => { },
+        close: async () => { },
+    };
+}
+describe('OutboxRelay.drainOnce', () => {
+    it('publishes pending rows in order and marks them published', async () => {
+        const rows = [row('a', 'wallet.deposit.completed'), row('b', 'wallet.withdrawal.completed')];
+        const { db, trackPublish } = harness(rows);
+        const broker = brokerThat(trackPublish);
+        const relay = new OutboxRelay(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',
+            topic: 'wallet.deposit.completed',
+        });
+        expect(rows.every((r) => r.publishedAt !== null)).toBe(true);
+    });
+    it('is a no-op when nothing is pending', async () => {
+        const rows = [{ ...row('a', 'x'), publishedAt: new Date() }];
+        const { db, trackPublish } = harness(rows);
+        const broker = brokerThat(trackPublish);
+        const relay = new OutboxRelay(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 rows = [row('a', 'wallet.deposit.completed')];
+        const { db, trackPublish } = harness(rows);
+        const broker = {
+            publish: vi.fn(async (env) => {
+                trackPublish(env.eventId);
+                throw new Error('broker unreachable');
+            }),
+            subscribe: () => () => { },
+            close: async () => { },
+        };
+        const relay = new OutboxRelay(db, broker);
+        await expect(relay.drainOnce()).rejects.toThrow('broker unreachable');
+        expect(rows[0]?.publishedAt).toBeNull();
+    });
+    it('keeps rows published before a mid-batch publish failure, retrying only the failing row', async () => {
+        const rows = [
+            row('a', 'wallet.deposit.completed'),
+            row('b', 'wallet.withdrawal.completed'),
+            row('c', 'wallet.deposit.completed'),
+        ];
+        const { db, trackPublish } = harness(rows);
+        const broker = brokerThat(trackPublish, (eventId) => {
+            if (eventId === 'b')
+                throw new Error('broker unreachable');
+        });
+        const relay = new OutboxRelay(db, broker);
+        await expect(relay.drainOnce()).rejects.toThrow('broker unreachable');
+        expect(rows[0]?.publishedAt).not.toBeNull(); // a - published before the failure
+        expect(rows[1]?.publishedAt).toBeNull(); // b - failed
+        expect(rows[2]?.publishedAt).toBeNull(); // c - never reached
+        const publishSpy = broker.publish;
+        publishSpy.mockClear();
+        publishSpy.mockImplementation(async (env) => trackPublish(env.eventId));
+        const n = await relay.drainOnce();
+        expect(n).toBe(2);
+        expect(publishSpy).toHaveBeenCalledTimes(2);
+        expect(publishSpy.mock.calls.map((c) => c[0].eventId)).toEqual(['b', 'c']);
+        expect(rows.every((r) => r.publishedAt !== null)).toBe(true);
+    });
+});
+//# sourceMappingURL=relay.test.js.map

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

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

package/dist/server/db/outbox/drizzle/migrations/0000_living_snowbird.sql

@@ -0,0 +1,14 @@
+CREATE TABLE "event_outbox" (
+	"event_id" text PRIMARY KEY NOT NULL,
+	"topic" text NOT NULL,
+	"payload" jsonb NOT NULL,
+	"schema_version" integer DEFAULT 1 NOT NULL,
+	"trace_id" text,
+	"ordering_key" text,
+	"occurred_at" timestamp with time zone NOT NULL,
+	"published_at" timestamp with time zone,
+	"attempts" integer DEFAULT 0 NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX "event_outbox_pending_idx" ON "event_outbox" USING btree ("published_at","occurred_at");

package/dist/server/db/outbox/drizzle/migrations/meta/0000_snapshot.json

@@ -0,0 +1,117 @@
+{
+  "id": "8e20a713-5cd3-423e-8eea-8d2bd3d9832c",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "public.event_outbox": {
+      "name": "event_outbox",
+      "schema": "",
+      "columns": {
+        "event_id": {
+          "name": "event_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "topic": {
+          "name": "topic",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "payload": {
+          "name": "payload",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "schema_version": {
+          "name": "schema_version",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 1
+        },
+        "trace_id": {
+          "name": "trace_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "ordering_key": {
+          "name": "ordering_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "occurred_at": {
+          "name": "occurred_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "published_at": {
+          "name": "published_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "attempts": {
+          "name": "attempts",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "event_outbox_pending_idx": {
+          "name": "event_outbox_pending_idx",
+          "columns": [
+            {
+              "expression": "published_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "occurred_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

package/dist/server/db/outbox/drizzle/migrations/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "postgresql",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "7",
+      "when": 1783555226979,
+      "tag": "0000_living_snowbird",
+      "breakpoints": true
+    }
+  ]
+}

package/dist/server/db/outbox/drizzle.config.d.ts

@@ -0,0 +1,4 @@
+import 'dotenv/config';
+declare const _default: import("drizzle-kit").Config;
+export default _default;
+//# sourceMappingURL=drizzle.config.d.ts.map

package/dist/server/db/outbox/drizzle.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.config.d.ts","sourceRoot":"","sources":["../../../../src/server/db/outbox/drizzle.config.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;;AAMvB,wBAeG"}

package/dist/server/db/outbox/drizzle.config.js

@@ -0,0 +1,21 @@
+import 'dotenv/config';
+import { defineConfig } from 'drizzle-kit';
+// Own migration history + tracking table, co-located with the module's schema.
+// One DB shared with sibling modules, but one journal per module so a module can
+// be extracted to its own package without history surgery. See ADR-0020/0027.
+export default defineConfig({
+    dialect: 'postgresql',
+    casing: 'snake_case',
+    schema: ['./schema.ts'],
+    out: './drizzle/migrations',
+    migrations: {
+        table: '__drizzle_migrations_outbox',
+        schema: 'drizzle',
+    },
+    dbCredentials: {
+        url: process.env['DATABASE_ADMIN_URL'] ??
+            process.env['DATABASE_URL'] ??
+            'postgresql://postgres:postgres@localhost:5432/oss_igaming',
+    },
+});
+//# sourceMappingURL=drizzle.config.js.map

package/dist/server/db/outbox/drizzle.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.config.js","sourceRoot":"","sources":["../../../../src/server/db/outbox/drizzle.config.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,+EAA+E;AAC/E,iFAAiF;AACjF,8EAA8E;AAC9E,eAAe,YAAY,CAAC;IAC1B,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,aAAa,CAAC;IACvB,GAAG,EAAE,sBAAsB;IAC3B,UAAU,EAAE;QACV,KAAK,EAAE,6BAA6B;QACpC,MAAM,EAAE,SAAS;KAClB;IACD,aAAa,EAAE;QACb,GAAG,EACD,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;YAC3B,2DAA2D;KAC9D;CACF,CAAC,CAAC"}

package/dist/server/db/outbox/relay.d.ts

@@ -0,0 +1,20 @@
+import type { MessageBrokerAdapter } from '@openora/core/contracts';
+import type { DrizzleDb } from '../drizzle.js';
+export type OutboxRelayOptions = {
+    intervalMs?: number;
+    batchSize?: number;
+    onError?: (err: unknown) => void;
+};
+export declare class OutboxRelay {
+    private readonly db;
+    private readonly broker;
+    private readonly opts;
+    private timer;
+    private draining;
+    constructor(db: DrizzleDb, broker: MessageBrokerAdapter, opts?: OutboxRelayOptions);
+    start(): void;
+    stop(): Promise<void>;
+    private drainSafe;
+    drainOnce(): Promise<number>;
+}
+//# sourceMappingURL=relay.d.ts.map

package/dist/server/db/outbox/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../../../src/server/db/outbox/relay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,yBAAyB,CAAC;AAGnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC,CAAC;AAaF,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAS;gBAGN,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,oBAAoB,EAC5B,IAAI,GAAE,kBAAuB;IAGhD,KAAK,IAAI,IAAI;IAMP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAQb,SAAS;IAUjB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;CAqCnC"}

package/dist/server/db/outbox/relay.js

@@ -0,0 +1,86 @@
+import { asc, eq, isNull } from 'drizzle-orm';
+import { eventOutbox } from './schema.js';
+// Publishes pending outbox rows to the MESSAGE_BROKER. Runs as a background poll
+// loop (start/stop) and is also drainable on demand (drainOnce) for tests and for
+// a synchronous flush. A row is marked published only AFTER broker.publish
+// resolves, so a crash mid-publish leaves it pending and it is retried -
+// at-least-once; consumers dedup on eventId.
+//
+// ponytail: claim-then-publish (no `claimed_at` migration) - the SKIP LOCKED select
+// commits in its own short transaction, then each row publishes and is marked in its own
+// transaction outside that lock, so a publish failure only retries the failing row. The
+// tradeoff: two relays on the same tick can both grab a row - fine under at-least-once
+// (consumers dedup on eventId); add a `claimed_at` claim-update if that ever needs closing.
+export class OutboxRelay {
+    db;
+    broker;
+    opts;
+    timer;
+    draining = false;
+    constructor(db, broker, opts = {}) {
+        this.db = db;
+        this.broker = broker;
+        this.opts = opts;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => void this.drainSafe(), this.opts.intervalMs ?? 1000);
+        this.timer.unref?.();
+    }
+    async stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        while (this.draining)
+            await new Promise((r) => setTimeout(r, 10));
+    }
+    async drainSafe() {
+        try {
+            await this.drainOnce();
+        }
+        catch (err) {
+            this.opts.onError?.(err);
+        }
+    }
+    // Publish one batch of pending rows. Returns how many were published. Reentrant-
+    // safe: a second call while a drain is in flight is a no-op.
+    async drainOnce() {
+        if (this.draining)
+            return 0;
+        this.draining = true;
+        try {
+            const batch = await this.db.transaction((txn) => txn
+                .select()
+                .from(eventOutbox)
+                .where(isNull(eventOutbox.publishedAt))
+                .orderBy(asc(eventOutbox.occurredAt))
+                .limit(this.opts.batchSize ?? 100)
+                .for('update', { skipLocked: true }));
+            let published = 0;
+            for (const row of batch) {
+                const envelope = {
+                    eventId: row.eventId,
+                    topic: row.topic,
+                    payload: row.payload,
+                    occurredAt: row.occurredAt.toISOString(),
+                    schemaVersion: row.schemaVersion,
+                    ...(row.traceId ? { traceId: row.traceId } : {}),
+                    ...(row.orderingKey ? { orderingKey: row.orderingKey } : {}),
+                };
+                await this.broker.publish(envelope);
+                await this.db
+                    .update(eventOutbox)
+                    .set({ publishedAt: new Date() })
+                    .where(eq(eventOutbox.eventId, row.eventId));
+                published += 1;
+            }
+            return published;
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+}
+//# sourceMappingURL=relay.js.map

package/dist/server/db/outbox/relay.js.map

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

package/dist/server/db/outbox/schema.d.ts

@@ -0,0 +1,179 @@
+export declare const eventOutbox: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "event_outbox";
+    schema: undefined;
+    columns: {
+        eventId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "eventId";
+            tableName: "event_outbox";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        topic: import("drizzle-orm/pg-core").PgColumn<{
+            name: "topic";
+            tableName: "event_outbox";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: "event_outbox";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        schemaVersion: import("drizzle-orm/pg-core").PgColumn<{
+            name: "schemaVersion";
+            tableName: "event_outbox";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        traceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "traceId";
+            tableName: "event_outbox";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        orderingKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "orderingKey";
+            tableName: "event_outbox";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        occurredAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "occurredAt";
+            tableName: "event_outbox";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        publishedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "publishedAt";
+            tableName: "event_outbox";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        attempts: import("drizzle-orm/pg-core").PgColumn<{
+            name: "attempts";
+            tableName: "event_outbox";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "createdAt";
+            tableName: "event_outbox";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type EventOutboxRow = typeof eventOutbox.$inferSelect;
+//# sourceMappingURL=schema.d.ts.map

package/dist/server/db/outbox/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/server/db/outbox/schema.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC"}

package/dist/server/db/outbox/schema.js

@@ -0,0 +1,20 @@
+import { pgTable, text, jsonb, integer, timestamp, index } from 'drizzle-orm/pg-core';
+// Transactional outbox table. A money/critical service writes the event envelope
+// here INSIDE the same db.transaction as its state change (via the OUTBOX port),
+// so the row commits atomically with the state - the event can never be lost in
+// the gap between "state changed" and "event published". The OutboxRelay then
+// publishes pending rows to the MESSAGE_BROKER and stamps publishedAt. Delivery
+// is at-least-once; consumers dedup on eventId. See ADR-0016.
+export const eventOutbox = pgTable('event_outbox', {
+    eventId: text().primaryKey(),
+    topic: text().notNull(),
+    payload: jsonb().notNull(),
+    schemaVersion: integer().notNull().default(1),
+    traceId: text(),
+    orderingKey: text(),
+    occurredAt: timestamp({ withTimezone: true }).notNull(),
+    publishedAt: timestamp({ withTimezone: true }),
+    attempts: integer().notNull().default(0),
+    createdAt: timestamp({ withTimezone: true }).notNull().defaultNow(),
+}, (t) => [index('event_outbox_pending_idx').on(t.publishedAt, t.occurredAt)]);
+//# sourceMappingURL=schema.js.map

package/dist/server/db/outbox/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/server/db/outbox/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEtF,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAChC,cAAc,EACd;IACE,OAAO,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE;IAC5B,KAAK,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;IACvB,OAAO,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE;IAC1B,aAAa,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE;IACf,WAAW,EAAE,IAAI,EAAE;IACnB,UAAU,EAAE,SAAS,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACvD,WAAW,EAAE,SAAS,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC9C,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,SAAS,EAAE,SAAS,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;CACpE,EACD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAC3E,CAAC"}

package/dist/server/db/outbox/writer.d.ts

@@ -0,0 +1,5 @@
+import type { OutboxWriter, EventEnvelope } from '@openora/core/contracts';
+export declare class DrizzleOutboxWriter implements OutboxWriter {
+    write(tx: unknown, envelope: EventEnvelope): Promise<void>;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/server/db/outbox/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../../src/server/db/outbox/writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK3E,qBAAa,mBAAoB,YAAW,YAAY;IAChD,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAejE"}