@quilla-be-kit/messaging 0.2.0

package/dist/postgres/pg-event-bus.js

@@ -0,0 +1,115 @@
+const DEFAULT_EVENTS_TABLE = 'events';
+const DEFAULT_MAX_RETRIES = 3;
+export class PgEventBus {
+    pool;
+    eventsTable;
+    maxRetries;
+    constructor(options) {
+        this.pool = options.pool;
+        this.eventsTable = options.eventsTableName ?? DEFAULT_EVENTS_TABLE;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    async publish(event) {
+        const publishedAt = new Date();
+        await this.pool.query(`INSERT INTO ${this.eventsTable}
+         (id, event_type, event_version, event_kind, payload, source_service,
+          aggregate_id, correlation_id, status, claimed_by, claimed_at,
+          retry_count, last_error, created_at, published_at)
+       VALUES ($1, $2, $3, $4, $5::jsonb, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)`, [
+            event.id,
+            event.eventType,
+            event.eventVersion,
+            event.eventKind,
+            JSON.stringify(event.payload),
+            event.sourceService,
+            event.aggregateId ?? null,
+            event.correlationId ?? null,
+            'PENDING',
+            null,
+            null,
+            0,
+            null,
+            event.createdAt,
+            publishedAt,
+        ]);
+    }
+    // NOT EXISTS guards against claiming a second event for an aggregate while
+    // an earlier one is still CLAIMED. Advisory xact lock closes the race
+    // between NOT EXISTS and UPDATE across overlapping transactions.
+    async claim(instanceId, batchSize) {
+        const result = await this.pool.query(`WITH claimed AS (
+         SELECT id FROM ${this.eventsTable} e
+         WHERE e.status = 'PENDING'
+           AND NOT EXISTS (
+             SELECT 1 FROM ${this.eventsTable} e2
+             WHERE e2.aggregate_id IS NOT NULL
+               AND e2.aggregate_id = e.aggregate_id
+               AND e2.status = 'CLAIMED'
+           )
+           AND (e.aggregate_id IS NULL
+                OR pg_try_advisory_xact_lock(hashtext(e.aggregate_id)::bigint))
+         ORDER BY e.created_at
+         LIMIT $1
+         FOR UPDATE SKIP LOCKED
+       )
+       UPDATE ${this.eventsTable} t
+       SET status = 'CLAIMED', claimed_by = $2, claimed_at = $3
+       FROM claimed c
+       WHERE t.id = c.id
+       RETURNING t.*`, [batchSize, instanceId, new Date()]);
+        return result.rows.map((r) => this.rowToEntry(r));
+    }
+    async markDone(id) {
+        await this.pool.query(`DELETE FROM ${this.eventsTable} WHERE id = $1`, [id]);
+    }
+    async markFailed(id, reason) {
+        await this.pool.query(`UPDATE ${this.eventsTable}
+       SET retry_count = retry_count + 1,
+           last_error = $1,
+           status = CASE WHEN retry_count + 1 >= $3 THEN 'FAILED' ELSE 'PENDING' END,
+           claimed_by = NULL,
+           claimed_at = NULL
+       WHERE id = $2`, [reason, id, this.maxRetries]);
+    }
+    async resetStale(olderThan) {
+        const result = await this.pool.query(`UPDATE ${this.eventsTable}
+       SET status = 'PENDING', claimed_by = NULL, claimed_at = NULL
+       WHERE status = 'CLAIMED' AND claimed_at < $1`, [olderThan]);
+        return result.rowCount ?? 0;
+    }
+    async cleanupFailed(olderThan, options) {
+        const limit = options?.limit;
+        const result = limit
+            ? await this.pool.query(`WITH cte AS (
+             SELECT id FROM ${this.eventsTable}
+             WHERE status = 'FAILED' AND created_at < $1
+             ORDER BY created_at ASC
+             LIMIT $2
+           )
+           DELETE FROM ${this.eventsTable} t
+           USING cte
+           WHERE t.id = cte.id`, [olderThan, limit])
+            : await this.pool.query(`DELETE FROM ${this.eventsTable} WHERE status = 'FAILED' AND created_at < $1`, [olderThan]);
+        return result.rowCount ?? 0;
+    }
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            eventType: row.event_type,
+            eventVersion: row.event_version,
+            eventKind: row.event_kind,
+            payload: row.payload,
+            sourceService: row.source_service,
+            ...(row.aggregate_id !== null ? { aggregateId: row.aggregate_id } : {}),
+            ...(row.correlation_id !== null ? { correlationId: row.correlation_id } : {}),
+            status: row.status,
+            ...(row.claimed_by !== null ? { claimedBy: row.claimed_by } : {}),
+            ...(row.claimed_at !== null ? { claimedAt: row.claimed_at } : {}),
+            retryCount: row.retry_count,
+            ...(row.last_error !== null ? { lastError: row.last_error } : {}),
+            createdAt: row.created_at,
+            publishedAt: row.published_at,
+        };
+    }
+}
+//# sourceMappingURL=pg-event-bus.js.map

package/dist/postgres/pg-event-bus.js.map

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

package/dist/postgres/pg-local-outbox.d.ts

@@ -0,0 +1,26 @@
+import type { Pool } from 'pg';
+import type { LocalOutboxEntry, LocalOutboxInsertInput } from '../local-outbox/local-outbox-entry.type.js';
+import type { LocalOutboxReader } from '../local-outbox/local-outbox-reader.interface.js';
+import type { LocalOutboxWriter } from '../local-outbox/local-outbox-writer.interface.js';
+import type { TransactionHandle } from '../local-outbox/transaction-handle.interface.js';
+export type PgLocalOutboxOptions = {
+    readonly pool: Pool;
+    readonly tableName?: string;
+    readonly maxRetries?: number;
+};
+export declare class PgLocalOutbox implements LocalOutboxWriter, LocalOutboxReader {
+    private readonly pool;
+    private readonly tableName;
+    private readonly maxRetries;
+    constructor(options: PgLocalOutboxOptions);
+    insert(entries: readonly LocalOutboxInsertInput[], trx: TransactionHandle): Promise<void>;
+    claim(instanceId: string, batchSize: number): Promise<readonly LocalOutboxEntry[]>;
+    markSent(id: string, publishedAt: Date): Promise<void>;
+    markFailed(id: string, reason: string): Promise<void>;
+    resetStale(olderThan: Date): Promise<number>;
+    cleanup(olderThan: Date, options?: {
+        readonly limit?: number;
+    }): Promise<number>;
+    private rowToEntry;
+}
+//# sourceMappingURL=pg-local-outbox.d.ts.map

package/dist/postgres/pg-local-outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-local-outbox.d.ts","sourceRoot":"","sources":["../../src/postgres/pg-local-outbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EAEvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAuBzF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,qBAAa,aAAc,YAAW,iBAAiB,EAAE,iBAAiB;IACxE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,oBAAoB;IAMnC,MAAM,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCzF,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC;IAmBlF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAStD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAarD,UAAU,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAU5C,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBtF,OAAO,CAAC,UAAU;CAkBnB"}

package/dist/postgres/pg-local-outbox.js

@@ -0,0 +1,102 @@
+import { randomUUID } from 'node:crypto';
+const DEFAULT_TABLE_NAME = 'outbox_events';
+const DEFAULT_MAX_RETRIES = 3;
+const INSERT_COLUMN_COUNT = 14;
+export class PgLocalOutbox {
+    pool;
+    tableName;
+    maxRetries;
+    constructor(options) {
+        this.pool = options.pool;
+        this.tableName = options.tableName ?? DEFAULT_TABLE_NAME;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    async insert(entries, trx) {
+        if (entries.length === 0)
+            return;
+        const params = [];
+        const valueGroups = [];
+        for (const [i, entry] of entries.entries()) {
+            const base = i * INSERT_COLUMN_COUNT;
+            valueGroups.push(`($${base + 1}, $${base + 2}, $${base + 3}, $${base + 4}, $${base + 5}::jsonb, ` +
+                `$${base + 6}, $${base + 7}, $${base + 8}, $${base + 9}, $${base + 10}, ` +
+                `$${base + 11}, $${base + 12}, $${base + 13}, $${base + 14})`);
+            params.push(entry.id ?? randomUUID(), entry.eventType, entry.eventVersion ?? 1, entry.eventKind, JSON.stringify(entry.payload), entry.aggregateId ?? null, entry.correlationId ?? null, 'PENDING', null, null, 0, null, null, entry.createdAt ?? new Date());
+        }
+        await trx.query(`INSERT INTO ${this.tableName}
+        (id, event_type, event_version, event_kind, payload,
+         aggregate_id, correlation_id, status, claimed_by, claimed_at,
+         retry_count, last_error, published_at, created_at)
+       VALUES ${valueGroups.join(', ')}`, params);
+    }
+    async claim(instanceId, batchSize) {
+        const result = await this.pool.query(`WITH claimed AS (
+         SELECT id FROM ${this.tableName}
+         WHERE status = 'PENDING'
+         ORDER BY created_at
+         LIMIT $1
+         FOR UPDATE SKIP LOCKED
+       )
+       UPDATE ${this.tableName} t
+       SET status = 'CLAIMED', claimed_by = $2, claimed_at = $3
+       FROM claimed c
+       WHERE t.id = c.id
+       RETURNING t.*`, [batchSize, instanceId, new Date()]);
+        return result.rows.map((r) => this.rowToEntry(r));
+    }
+    async markSent(id, publishedAt) {
+        await this.pool.query(`UPDATE ${this.tableName}
+       SET status = 'SENT', published_at = $1, claimed_by = NULL, claimed_at = NULL
+       WHERE id = $2`, [publishedAt, id]);
+    }
+    async markFailed(id, reason) {
+        await this.pool.query(`UPDATE ${this.tableName}
+       SET retry_count = retry_count + 1,
+           last_error = $1,
+           status = CASE WHEN retry_count + 1 >= $3 THEN 'FAILED' ELSE 'PENDING' END,
+           claimed_by = NULL,
+           claimed_at = NULL
+       WHERE id = $2`, [reason, id, this.maxRetries]);
+    }
+    async resetStale(olderThan) {
+        const result = await this.pool.query(`UPDATE ${this.tableName}
+       SET status = 'PENDING', claimed_by = NULL, claimed_at = NULL
+       WHERE status = 'CLAIMED' AND claimed_at < $1`, [olderThan]);
+        return result.rowCount ?? 0;
+    }
+    async cleanup(olderThan, options) {
+        const limit = options?.limit;
+        const result = limit
+            ? await this.pool.query(`WITH cte AS (
+             SELECT id FROM ${this.tableName}
+             WHERE status = 'SENT' AND published_at < $1
+             ORDER BY published_at ASC
+             LIMIT $2
+           )
+           DELETE FROM ${this.tableName} t
+           USING cte
+           WHERE t.id = cte.id`, [olderThan, limit])
+            : await this.pool.query(`DELETE FROM ${this.tableName}
+           WHERE status = 'SENT' AND published_at < $1`, [olderThan]);
+        return result.rowCount ?? 0;
+    }
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            eventType: row.event_type,
+            eventVersion: row.event_version,
+            eventKind: row.event_kind,
+            payload: row.payload,
+            ...(row.aggregate_id !== null ? { aggregateId: row.aggregate_id } : {}),
+            ...(row.correlation_id !== null ? { correlationId: row.correlation_id } : {}),
+            status: row.status,
+            ...(row.claimed_by !== null ? { claimedBy: row.claimed_by } : {}),
+            ...(row.claimed_at !== null ? { claimedAt: row.claimed_at } : {}),
+            retryCount: row.retry_count,
+            ...(row.last_error !== null ? { lastError: row.last_error } : {}),
+            ...(row.published_at !== null ? { publishedAt: row.published_at } : {}),
+            createdAt: row.created_at,
+        };
+    }
+}
+//# sourceMappingURL=pg-local-outbox.js.map

package/dist/postgres/pg-local-outbox.js.map

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

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@quilla-be-kit/messaging",
+  "version": "0.2.0",
+  "description": "Broker-agnostic messaging: event-bus + consumer interfaces, local-outbox pattern, outbox forwarder, Postgres reference implementation.",
+  "license": "MIT",
+  "author": "Max Martinez",
+  "homepage": "https://github.com/quilla-kit/quilla-be-kit/tree/main/packages/messaging",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quilla-kit/quilla-be-kit.git",
+    "directory": "packages/messaging"
+  },
+  "bugs": {
+    "url": "https://github.com/quilla-kit/quilla-be-kit/issues"
+  },
+  "keywords": [
+    "messaging",
+    "event-bus",
+    "outbox",
+    "integration-events",
+    "typescript"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./postgres": {
+      "types": "./dist/postgres/index.d.ts",
+      "import": "./dist/postgres/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@quilla-be-kit/errors": "^0.2.0",
+    "@quilla-be-kit/execution-context": "^0.2.0",
+    "@quilla-be-kit/observability": "^0.2.0",
+    "@quilla-be-kit/runtime": "^0.2.0"
+  },
+  "peerDependencies": {
+    "pg": ">=8.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/pg": "^8.15.5",
+    "pg": "^8.13.0",
+    "zod": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}