@plumbus/core 0.1.0

package/dist/events/__tests__/event-registry.test.js

@@ -0,0 +1,55 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { defineEvent } from '../../define/defineEvent.js';
+import { EventRegistry } from '../registry.js';
+function makeEvent(name, domain, version) {
+    return defineEvent({
+        name,
+        description: `Test event ${name}`,
+        domain,
+        version,
+        payload: z.object({ value: z.string() }),
+    });
+}
+describe('EventRegistry', () => {
+    it('registers and retrieves an event by name', () => {
+        const registry = new EventRegistry();
+        const evt = makeEvent('order.created', 'orders');
+        registry.register(evt);
+        expect(registry.get('order.created')).toBe(evt);
+    });
+    it('retrieves by name@version key', () => {
+        const registry = new EventRegistry();
+        const evt = makeEvent('order.created', 'orders', '2');
+        registry.register(evt);
+        expect(registry.get('order.created@2')).toBe(evt);
+    });
+    it('throws on duplicate registration', () => {
+        const registry = new EventRegistry();
+        const evt = makeEvent('order.created');
+        registry.register(evt);
+        expect(() => registry.register(evt)).toThrow('already registered');
+    });
+    it('has() returns correct boolean', () => {
+        const registry = new EventRegistry();
+        expect(registry.has('nope')).toBe(false);
+        registry.register(makeEvent('order.created'));
+        expect(registry.has('order.created')).toBe(true);
+    });
+    it('getAll() lists all events', () => {
+        const registry = new EventRegistry();
+        registry.register(makeEvent('a'));
+        registry.register(makeEvent('b'));
+        expect(registry.getAll()).toHaveLength(2);
+    });
+    it('getByDomain() filters correctly', () => {
+        const registry = new EventRegistry();
+        registry.register(makeEvent('a.created', 'billing'));
+        registry.register(makeEvent('b.created', 'orders'));
+        registry.register(makeEvent('c.created', 'billing'));
+        expect(registry.getByDomain('billing')).toHaveLength(2);
+        expect(registry.getByDomain('orders')).toHaveLength(1);
+        expect(registry.getByDomain('unknown')).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=event-registry.test.js.map

package/dist/events/__tests__/event-registry.test.js.map

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

package/dist/events/__tests__/event-worker.test.d.ts

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

package/dist/events/__tests__/event-worker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-worker.test.d.ts","sourceRoot":"","sources":["../../../src/events/__tests__/event-worker.test.ts"],"names":[],"mappings":""}

package/dist/events/__tests__/event-worker.test.js

@@ -0,0 +1,174 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ConsumerRegistry } from '../consumer-registry.js';
+import { createInMemoryQueue } from '../queue.js';
+import { createEventWorker } from '../worker.js';
+function makeEnvelope(overrides) {
+    return {
+        id: 'evt-1',
+        eventType: 'order.created',
+        version: '1',
+        occurredAt: new Date(),
+        actor: 'user-1',
+        correlationId: 'corr-1',
+        payload: { orderId: '123' },
+        ...overrides,
+    };
+}
+function mockIdempotency() {
+    const processed = new Set();
+    return {
+        isProcessed: vi.fn(async (eventId, consumerId) => processed.has(`${eventId}:${consumerId}`)),
+        markProcessed: vi.fn(async (eventId, consumerId) => {
+            processed.add(`${eventId}:${consumerId}`);
+        }),
+    };
+}
+function mockDb() {
+    const deadLetterRows = [];
+    return {
+        _deadLetterRows: deadLetterRows,
+        insert: vi.fn().mockReturnValue({
+            values: vi.fn().mockImplementation((row) => {
+                deadLetterRows.push(row);
+                return Promise.resolve();
+            }),
+        }),
+    };
+}
+describe('EventWorker', () => {
+    it('delivers events to matching consumers', async () => {
+        const consumers = new ConsumerRegistry();
+        const handled = [];
+        consumers.register({
+            id: 'c1',
+            eventTypes: ['order.created'],
+            handler: async (env) => {
+                handled.push(env.id);
+            },
+        });
+        const worker = createEventWorker({
+            db: mockDb(),
+            queue: createInMemoryQueue(),
+            consumers,
+            idempotency: mockIdempotency(),
+        });
+        await worker.deliver(makeEnvelope());
+        expect(handled).toEqual(['evt-1']);
+    });
+    it('skips already-processed events (idempotency)', async () => {
+        const consumers = new ConsumerRegistry();
+        const handled = [];
+        consumers.register({
+            id: 'c1',
+            eventTypes: ['order.created'],
+            handler: async (env) => {
+                handled.push(env.id);
+            },
+        });
+        const idemp = mockIdempotency();
+        // Pre-mark as processed
+        await idemp.markProcessed('evt-1', 'c1');
+        const worker = createEventWorker({
+            db: mockDb(),
+            queue: createInMemoryQueue(),
+            consumers,
+            idempotency: idemp,
+        });
+        await worker.deliver(makeEnvelope());
+        expect(handled).toEqual([]);
+    });
+    it('retries on failure and marks processed on eventual success', async () => {
+        const consumers = new ConsumerRegistry();
+        let attempt = 0;
+        consumers.register({
+            id: 'c1',
+            eventTypes: ['order.created'],
+            maxRetries: 3,
+            handler: async () => {
+                attempt++;
+                if (attempt < 3)
+                    throw new Error('transient');
+            },
+        });
+        const idemp = mockIdempotency();
+        const worker = createEventWorker({
+            db: mockDb(),
+            queue: createInMemoryQueue(),
+            consumers,
+            idempotency: idemp,
+        });
+        await worker.deliver(makeEnvelope());
+        expect(attempt).toBe(3);
+        expect(idemp.markProcessed).toHaveBeenCalledWith('evt-1', 'c1');
+    });
+    it('dead-letters events after exhausting retries', async () => {
+        const consumers = new ConsumerRegistry();
+        consumers.register({
+            id: 'c1',
+            eventTypes: ['order.created'],
+            maxRetries: 2,
+            handler: async () => {
+                throw new Error('always fails');
+            },
+        });
+        const db = mockDb();
+        const idemp = mockIdempotency();
+        const worker = createEventWorker({
+            db,
+            queue: createInMemoryQueue(),
+            consumers,
+            idempotency: idemp,
+        });
+        await worker.deliver(makeEnvelope());
+        expect(db._deadLetterRows).toHaveLength(1);
+        expect(db._deadLetterRows[0]).toMatchObject({
+            eventId: 'evt-1',
+            eventType: 'order.created',
+            consumerId: 'c1',
+            lastError: 'always fails',
+        });
+        // Should NOT be marked as processed
+        expect(idemp.markProcessed).not.toHaveBeenCalled();
+    });
+    it('start/stop controls the queue subscription', async () => {
+        const queue = createInMemoryQueue();
+        const consumers = new ConsumerRegistry();
+        const handled = [];
+        consumers.register({
+            id: 'c1',
+            eventTypes: ['order.created'],
+            handler: async (env) => {
+                handled.push(env.id);
+            },
+        });
+        const worker = createEventWorker({
+            db: mockDb(),
+            queue,
+            consumers,
+            idempotency: mockIdempotency(),
+        });
+        expect(worker.isRunning).toBe(false);
+        worker.start();
+        expect(worker.isRunning).toBe(true);
+        await queue.publish(makeEnvelope());
+        expect(handled).toEqual(['evt-1']);
+        worker.stop();
+        expect(worker.isRunning).toBe(false);
+    });
+    it('ignores events with no matching consumers', async () => {
+        const consumers = new ConsumerRegistry();
+        const db = mockDb();
+        const idemp = mockIdempotency();
+        const worker = createEventWorker({
+            db,
+            queue: createInMemoryQueue(),
+            consumers,
+            idempotency: idemp,
+        });
+        // Should not throw
+        await worker.deliver(makeEnvelope({ eventType: 'unknown.event' }));
+        expect(db._deadLetterRows).toEqual([]);
+        expect(idemp.markProcessed).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=event-worker.test.js.map

package/dist/events/__tests__/event-worker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-worker.test.js","sourceRoot":"","sources":["../../../src/events/__tests__/event-worker.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,SAAS,YAAY,CAAC,SAAkC;IACtD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,GAAG;QACZ,UAAU,EAAE,IAAI,IAAI,EAAE;QACtB,KAAK,EAAE,QAAQ;QACf,aAAa,EAAE,QAAQ;QACvB,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,OAAO;QACL,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,UAAkB,EAAE,EAAE,CAC/D,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC,CAC1C;QACD,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,UAAkB,EAAE,EAAE;YACjE,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,MAAM;IACb,MAAM,cAAc,GAAU,EAAE,CAAC;IACjC,OAAO;QACL,eAAe,EAAE,cAAc;QAC/B,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;YAC9B,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,GAAQ,EAAE,EAAE;gBAC9C,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC,CAAC;SACH,CAAC;KACI,CAAC;AACX,CAAC;AAED,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,SAAS,CAAC,QAAQ,CAAC;YACjB,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,CAAC,eAAe,CAAC;YAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACrB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAC/B,EAAE,EAAE,MAAM,EAAE;YACZ,KAAK,EAAE,mBAAmB,EAAE;YAC5B,SAAS;YACT,WAAW,EAAE,eAAe,EAAE;SAC/B,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,SAAS,CAAC,QAAQ,CAAC;YACjB,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,CAAC,eAAe,CAAC;YAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACrB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,wBAAwB;QACxB,MAAM,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAC/B,EAAE,EAAE,MAAM,EAAE;YACZ,KAAK,EAAE,mBAAmB,EAAE;YAC5B,SAAS;YACT,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,SAAS,CAAC,QAAQ,CAAC;YACjB,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,CAAC,eAAe,CAAC;YAC7B,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO,EAAE,CAAC;gBACV,IAAI,OAAO,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;YAChD,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAC/B,EAAE,EAAE,MAAM,EAAE;YACZ,KAAK,EAAE,mBAAmB,EAAE;YAC5B,SAAS;YACT,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,SAAS,CAAC,QAAQ,CAAC;YACjB,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,CAAC,eAAe,CAAC;YAC7B,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;YAClC,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAC/B,EAAE;YACF,KAAK,EAAE,mBAAmB,EAAE;YAC5B,SAAS;YACT,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC1C,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,eAAe;YAC1B,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;QACH,oCAAoC;QACpC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,SAAS,CAAC,QAAQ,CAAC;YACjB,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,CAAC,eAAe,CAAC;YAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACrB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAC/B,EAAE,EAAE,MAAM,EAAE;YACZ,KAAK;YACL,SAAS;YACT,WAAW,EAAE,eAAe,EAAE;SAC/B,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAEnC,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,iBAAiB,CAAC;YAC/B,EAAE;YACF,KAAK,EAAE,mBAAmB,EAAE;YAC5B,SAAS;YACT,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/events/__tests__/queue.test.d.ts

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

package/dist/events/__tests__/queue.test.d.ts.map

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

package/dist/events/__tests__/queue.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest';
+import { createInMemoryQueue } from '../queue.js';
+function makeEnvelope(overrides) {
+    return {
+        id: 'evt-1',
+        eventType: 'order.created',
+        version: '1',
+        occurredAt: new Date(),
+        actor: 'user-1',
+        correlationId: 'corr-1',
+        payload: { orderId: '123' },
+        ...overrides,
+    };
+}
+describe('InMemoryQueue', () => {
+    it('delivers published events to subscribers', async () => {
+        const queue = createInMemoryQueue();
+        const received = [];
+        queue.subscribe(async (e) => {
+            received.push(e);
+        });
+        await queue.publish(makeEnvelope());
+        expect(received).toHaveLength(1);
+        expect(received[0]?.id).toBe('evt-1');
+    });
+    it('delivers to multiple subscribers', async () => {
+        const queue = createInMemoryQueue();
+        const a = [];
+        const b = [];
+        queue.subscribe(async (e) => {
+            a.push(e.id);
+        });
+        queue.subscribe(async (e) => {
+            b.push(e.id);
+        });
+        await queue.publish(makeEnvelope());
+        expect(a).toEqual(['evt-1']);
+        expect(b).toEqual(['evt-1']);
+    });
+    it('unsubscribe removes handler', async () => {
+        const queue = createInMemoryQueue();
+        const received = [];
+        const unsub = queue.subscribe(async (e) => {
+            received.push(e.id);
+        });
+        unsub();
+        await queue.publish(makeEnvelope());
+        expect(received).toEqual([]);
+    });
+    it('throws on publish after close', async () => {
+        const queue = createInMemoryQueue();
+        await queue.close();
+        await expect(queue.publish(makeEnvelope())).rejects.toThrow('closed');
+    });
+    it('throws on subscribe after close', async () => {
+        const queue = createInMemoryQueue();
+        await queue.close();
+        expect(() => queue.subscribe(async () => { })).toThrow('closed');
+    });
+    it('swallows subscriber errors without affecting others', async () => {
+        const queue = createInMemoryQueue();
+        const received = [];
+        queue.subscribe(async () => {
+            throw new Error('boom');
+        });
+        queue.subscribe(async (e) => {
+            received.push(e.id);
+        });
+        await queue.publish(makeEnvelope());
+        expect(received).toEqual(['evt-1']);
+    });
+});
+//# sourceMappingURL=queue.test.js.map

package/dist/events/__tests__/queue.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.js","sourceRoot":"","sources":["../../../src/events/__tests__/queue.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,SAAS,YAAY,CAAC,SAAkC;IACtD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,GAAG;QACZ,UAAU,EAAE,IAAI,IAAI,EAAE;QACtB,KAAK,EAAE,QAAQ;QACf,aAAa,EAAE,QAAQ;QACvB,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,CAAC,GAAa,EAAE,CAAC;QACvB,MAAM,CAAC,GAAa,EAAE,CAAC;QACvB,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACxC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,KAAK,EAAE,CAAC;QAER,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC1B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/events/consumer-registry.d.ts

@@ -0,0 +1,47 @@
+import type { EventEnvelope } from '../types/event.js';
+/**
+ * A consumer function that handles a delivered event.
+ */
+export type EventConsumerHandler = (envelope: EventEnvelope) => Promise<void>;
+export interface EventConsumer {
+    /** Unique identifier for this consumer (used for idempotency tracking) */
+    id: string;
+    /** Event type(s) this consumer subscribes to */
+    eventTypes: string[];
+    /** Optional version constraint (e.g. "1", ">=2") */
+    versionConstraint?: string;
+    /** The handler function */
+    handler: EventConsumerHandler;
+    /** Max retry attempts before dead-lettering (default: 3) */
+    maxRetries?: number;
+}
+/**
+ * Registry that holds all registered event consumers,
+ * indexed by event type for efficient routing during delivery.
+ */
+export declare class ConsumerRegistry {
+    private consumers;
+    private consumersById;
+    /**
+     * Register an event consumer. Throws on duplicate consumer ID.
+     */
+    register(consumer: EventConsumer): void;
+    /**
+     * Register multiple consumers at once.
+     */
+    registerAll(consumers: EventConsumer[]): void;
+    /**
+     * Get all consumers subscribed to an event type.
+     * Optionally filters by version constraint match.
+     */
+    getConsumers(eventType: string, version?: string): EventConsumer[];
+    /**
+     * Get a specific consumer by ID.
+     */
+    getById(id: string): EventConsumer | undefined;
+    /**
+     * Get all registered consumers.
+     */
+    getAll(): EventConsumer[];
+}
+//# sourceMappingURL=consumer-registry.d.ts.map

package/dist/events/consumer-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-registry.d.ts","sourceRoot":"","sources":["../../src/events/consumer-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,aAAa,CAAoC;IAEzD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAavC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,IAAI;IAM7C;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAUlE;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9C;;OAEG;IACH,MAAM,IAAI,aAAa,EAAE;CAG1B"}

package/dist/events/consumer-registry.js

@@ -0,0 +1,79 @@
+/**
+ * Registry that holds all registered event consumers,
+ * indexed by event type for efficient routing during delivery.
+ */
+export class ConsumerRegistry {
+    consumers = new Map();
+    consumersById = new Map();
+    /**
+     * Register an event consumer. Throws on duplicate consumer ID.
+     */
+    register(consumer) {
+        if (this.consumersById.has(consumer.id)) {
+            throw new Error(`Event consumer "${consumer.id}" is already registered`);
+        }
+        this.consumersById.set(consumer.id, consumer);
+        for (const eventType of consumer.eventTypes) {
+            const existing = this.consumers.get(eventType) ?? [];
+            existing.push(consumer);
+            this.consumers.set(eventType, existing);
+        }
+    }
+    /**
+     * Register multiple consumers at once.
+     */
+    registerAll(consumers) {
+        for (const consumer of consumers) {
+            this.register(consumer);
+        }
+    }
+    /**
+     * Get all consumers subscribed to an event type.
+     * Optionally filters by version constraint match.
+     */
+    getConsumers(eventType, version) {
+        const consumers = this.consumers.get(eventType) ?? [];
+        if (!version)
+            return consumers;
+        return consumers.filter((c) => {
+            if (!c.versionConstraint)
+                return true;
+            return matchesVersion(version, c.versionConstraint);
+        });
+    }
+    /**
+     * Get a specific consumer by ID.
+     */
+    getById(id) {
+        return this.consumersById.get(id);
+    }
+    /**
+     * Get all registered consumers.
+     */
+    getAll() {
+        return Array.from(this.consumersById.values());
+    }
+}
+/**
+ * Simple version constraint matcher.
+ * Supports: exact match ("1"), >=N (">=2"), <=N, >N, <N.
+ */
+function matchesVersion(version, constraint) {
+    const v = parseInt(version, 10);
+    if (Number.isNaN(v))
+        return version === constraint;
+    const geMatch = constraint.match(/^>=(\d+)$/);
+    if (geMatch?.[1])
+        return v >= parseInt(geMatch[1], 10);
+    const leMatch = constraint.match(/^<=(\d+)$/);
+    if (leMatch?.[1])
+        return v <= parseInt(leMatch[1], 10);
+    const gtMatch = constraint.match(/^>(\d+)$/);
+    if (gtMatch?.[1])
+        return v > parseInt(gtMatch[1], 10);
+    const ltMatch = constraint.match(/^<(\d+)$/);
+    if (ltMatch?.[1])
+        return v < parseInt(ltMatch[1], 10);
+    return version === constraint;
+}
+//# sourceMappingURL=consumer-registry.js.map

package/dist/events/consumer-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-registry.js","sourceRoot":"","sources":["../../src/events/consumer-registry.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,aAAa,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,QAAuB;QAC9B,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,EAAE,yBAAyB,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAE9C,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACrD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAA0B;QACpC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,SAAiB,EAAE,OAAgB;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,IAAI,CAAC,CAAC,CAAC,iBAAiB;gBAAE,OAAO,IAAI,CAAC;YACtC,OAAO,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,UAAkB;IACzD,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,KAAK,UAAU,CAAC;IAEnD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtD,OAAO,OAAO,KAAK,UAAU,CAAC;AAChC,CAAC"}

package/dist/events/dispatcher.d.ts

@@ -0,0 +1,31 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { EventQueue } from './queue.js';
+export interface DispatcherConfig {
+    db: PostgresJsDatabase;
+    queue: EventQueue;
+    /** Poll interval in milliseconds (default: 1000) */
+    pollIntervalMs?: number;
+    /** Max rows to fetch per poll (default: 100) */
+    batchSize?: number;
+    /** Max retries before moving to dead-letter (default: 5) */
+    maxRetries?: number;
+    /** Base delay in ms for exponential backoff (default: 1000) */
+    backoffBaseMs?: number;
+    /** Max backoff delay in ms (default: 60000) */
+    backoffMaxMs?: number;
+}
+/**
+ * Creates a dispatcher that polls the outbox table for pending events,
+ * publishes them to the queue, and marks them as dispatched.
+ * Returns start/stop controls.
+ */
+export declare function createOutboxDispatcher(config: DispatcherConfig): {
+    /** Run a single poll cycle (useful for testing) */
+    poll: () => Promise<number>;
+    /** Start the background polling loop */
+    start(): void;
+    /** Stop the background polling loop */
+    stop(): void;
+    readonly isRunning: boolean;
+};
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/events/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/events/dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,kBAAkB,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB;IAgI3D,mDAAmD;gBA7G9B,OAAO,CAAC,MAAM,CAAC;IAgHpC,wCAAwC;aAC/B,IAAI;IASb,uCAAuC;YAC/B,IAAI;wBAQK,OAAO;EAI3B"}

package/dist/events/dispatcher.js

@@ -0,0 +1,149 @@
+import { and, eq } from 'drizzle-orm';
+import { deadLetterTable, outboxTable } from './outbox.js';
+/**
+ * Creates a dispatcher that polls the outbox table for pending events,
+ * publishes them to the queue, and marks them as dispatched.
+ * Returns start/stop controls.
+ */
+export function createOutboxDispatcher(config) {
+    const { db, queue, pollIntervalMs = 1000, batchSize = 100, maxRetries = 5, backoffBaseMs = 1000, backoffMaxMs = 60_000, } = config;
+    let timer = null;
+    let running = false;
+    let polling = false;
+    /** Compute exponential backoff delay: min(base * 2^attempt, max) */
+    function computeBackoff(attempt) {
+        return Math.min(backoffBaseMs * 2 ** attempt, backoffMaxMs);
+    }
+    async function poll() {
+        if (polling)
+            return 0;
+        polling = true;
+        try {
+            // Fetch pending rows and failed rows whose backoff has elapsed
+            const now = new Date();
+            const rows = await db
+                .select()
+                .from(outboxTable)
+                .where(eq(outboxTable.status, 'pending'))
+                .limit(batchSize)
+                .orderBy(outboxTable.occurredAt);
+            // Also retry failed rows that have waited long enough
+            const failedRows = await db
+                .select()
+                .from(outboxTable)
+                .where(eq(outboxTable.status, 'retry'))
+                .limit(batchSize)
+                .orderBy(outboxTable.occurredAt);
+            const allRows = [
+                ...rows,
+                ...failedRows.filter((r) => {
+                    const retryCount = parseInt(r.retryCount, 10);
+                    if (retryCount >= maxRetries)
+                        return false;
+                    const backoffMs = computeBackoff(retryCount);
+                    const lastAttempt = r.dispatchedAt ?? r.occurredAt;
+                    return now.getTime() - lastAttempt.getTime() >= backoffMs;
+                }),
+            ];
+            let dispatched = 0;
+            for (const row of allRows) {
+                const claimed = await db
+                    .update(outboxTable)
+                    .set({
+                    status: 'processing',
+                    dispatchedAt: new Date(),
+                })
+                    .where(and(eq(outboxTable.id, row.id), eq(outboxTable.status, row.status)))
+                    .returning({ id: outboxTable.id });
+                if (claimed.length === 0)
+                    continue;
+                const envelope = {
+                    id: row.id,
+                    eventType: row.eventType,
+                    version: row.version,
+                    occurredAt: row.occurredAt,
+                    actor: row.actor,
+                    tenantId: row.tenantId ?? undefined,
+                    correlationId: row.correlationId,
+                    causationId: row.causationId ?? undefined,
+                    payload: row.payload,
+                };
+                try {
+                    await queue.publish(envelope);
+                    await db
+                        .update(outboxTable)
+                        .set({ status: 'dispatched', dispatchedAt: new Date() })
+                        .where(eq(outboxTable.id, row.id));
+                    dispatched++;
+                }
+                catch (err) {
+                    const retryCount = parseInt(row.retryCount, 10) + 1;
+                    const errorMsg = err instanceof Error ? err.message : String(err);
+                    if (retryCount >= maxRetries) {
+                        // Move to dead-letter
+                        await db.insert(deadLetterTable).values({
+                            eventId: row.id,
+                            eventType: row.eventType,
+                            payload: row.payload,
+                            consumerId: null,
+                            lastError: errorMsg,
+                            retryCount: String(retryCount),
+                            metadata: {
+                                correlationId: row.correlationId,
+                                causationId: row.causationId,
+                                actor: row.actor,
+                                tenantId: row.tenantId,
+                            },
+                        });
+                        await db
+                            .update(outboxTable)
+                            .set({ status: 'dead_lettered', retryCount: String(retryCount), lastError: errorMsg })
+                            .where(eq(outboxTable.id, row.id));
+                    }
+                    else {
+                        // Mark for retry with backoff
+                        await db
+                            .update(outboxTable)
+                            .set({
+                            status: 'retry',
+                            retryCount: String(retryCount),
+                            lastError: errorMsg,
+                            dispatchedAt: new Date(), // used as last attempt timestamp for backoff
+                        })
+                            .where(eq(outboxTable.id, row.id));
+                    }
+                }
+            }
+            return dispatched;
+        }
+        finally {
+            polling = false;
+        }
+    }
+    return {
+        /** Run a single poll cycle (useful for testing) */
+        poll,
+        /** Start the background polling loop */
+        start() {
+            if (running)
+                return;
+            running = true;
+            timer = setInterval(() => {
+                void poll();
+            }, pollIntervalMs);
+            void poll();
+        },
+        /** Stop the background polling loop */
+        stop() {
+            running = false;
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+        },
+        get isRunning() {
+            return running;
+        },
+    };
+}
+//# sourceMappingURL=dispatcher.js.map