@fonderie/events 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fonderie, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @fonderie/events
+
+The event bus wiring the bricks together: publish domain events, subscribe
+with wildcard patterns, and swap transports without touching handlers.
+Memory and PostgreSQL transports built in.
+
+## Install
+
+```sh
+npm install @fonderie/events
+```
+
+## Use
+
+```ts
+import { FonderieApp, defineConfig } from '@fonderie/core';
+import { EventsModule } from '@fonderie/events';
+
+const app = await new FonderieApp(defineConfig({}))
+  .register(new EventsModule())
+  .boot();
+```
+
+```ts
+import { EventBus, matchesPattern, NOTIFICATION_EVENT } from '@fonderie/events';
+```
+
+Domain packages export typed `EVENT_KEYS`; alias them on import
+(`import { EVENT_KEYS as AUTH_EVENTS } from '@fonderie/auth'`) and
+subscribe to exactly the events you care about.
+
+## Why this exists
+
+You've shipped this plumbing before — auth, teams, billing, messaging —
+and the next project will ask for it again. Fonderie packages it once:
+plain TypeScript modules for
+[`@fonderie/core`](https://github.com/fonderie-js/sdk/tree/main/packages/core),
+PostgreSQL-backed, self-hosted, MIT. No external control plane, no
+per-seat anything. Register the modules you need; skip the ones you don't.
+
+**This package owns** how the bricks talk. The publish/subscribe backbone that lets
+producers and consumers stay decoupled — swap transports, keep handlers.
+
+Browse the whole set at
+[fonderie-js/sdk](https://github.com/fonderie-js/sdk) · follow
+[@fonderiejs](https://x.com/fonderiejs)
+
+## License
+
+MIT © Fonderie, Inc.

package/dist/index.cjs

@@ -0,0 +1,286 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EventBus: () => EventBus,
+  EventsModule: () => EventsModule,
+  MemoryTransport: () => MemoryTransport,
+  NOTIFICATION_EVENT: () => NOTIFICATION_EVENT,
+  PGTransport: () => PGTransport,
+  matchesPattern: () => matchesPattern
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/bus.ts
+var import_node_crypto = require("crypto");
+var EventBus = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  async emit(type, payload, opts) {
+    const meta = {
+      id: (0, import_node_crypto.randomUUID)(),
+      type,
+      emittedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      attempts: 0,
+      ...opts?.requestId !== void 0 ? { requestId: opts.requestId } : {}
+    };
+    await this.transport.publish(type, payload, meta);
+  }
+  // consumer identifies the logical subscriber for per-consumer delivery tracking.
+  // Defaults to the pattern string — stable and predictable for single-subscriber patterns.
+  on(type, handler, consumer = type) {
+    this.transport.subscribe(type, handler, consumer);
+  }
+  async start() {
+    await this.transport.start();
+  }
+  async stop() {
+    await this.transport.stop();
+  }
+};
+
+// src/transports/pg.ts
+var import_pg = __toESM(require("pg"), 1);
+var import_store = require("@fonderie/store");
+
+// src/transports/pattern.ts
+function matchesPattern(pattern, eventType) {
+  if (pattern === "*") return true;
+  const regex = new RegExp("^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*") + "$");
+  return regex.test(eventType);
+}
+
+// src/transports/pg.ts
+var PGTransport = class {
+  constructor(config) {
+    this.config = config;
+    this.maxRetries = config.maxRetries ?? 3;
+    this.batchSize = config.batchSize ?? 10;
+    this.pollInterval = config.pollInterval ?? 1e3;
+  }
+  config;
+  subscriptions = [];
+  listenClient = null;
+  store;
+  running = false;
+  wakeResolvers = [];
+  maxRetries;
+  batchSize;
+  pollInterval;
+  // ── Public API ──────────────────────────────────────────────────
+  subscribe(pattern, handler, consumer) {
+    this.subscriptions.push({ pattern, handler, consumer });
+  }
+  async publish(type, payload, meta) {
+    await this.store.query(
+      `INSERT INTO fonderie_events (id, type, payload, meta)
+			 VALUES ($1, $2, $3, $4)`,
+      [meta.id, type, JSON.stringify(payload), JSON.stringify(meta)]
+    );
+    const consumers = this.matchingConsumers(type);
+    if (consumers.length > 0) {
+      await this.store.query(
+        `INSERT INTO fonderie_event_consumers (event_id, consumer, status, attempts)
+				 SELECT $1, unnest($2::text[]), 'pending', 0
+				 ON CONFLICT (event_id, consumer) DO NOTHING`,
+        [meta.id, consumers]
+      );
+    }
+    await this.store.query(`SELECT pg_notify('fonderie_events', '')`);
+  }
+  async start() {
+    this.running = true;
+    this.store = new import_store.PGAdapter(this.config.connectionUrl);
+    await this.store.query(
+      `UPDATE fonderie_event_consumers SET status = 'failed' WHERE status = 'processing'`
+    );
+    this.listenClient = new import_pg.default.Client(this.config.connectionUrl);
+    await this.listenClient.connect();
+    await this.listenClient.query("LISTEN fonderie_events");
+    this.listenClient.on("notification", () => this.wake());
+    this.listenClient.on(
+      "error",
+      (err) => console.error("[events:pg] listen client error:", err.message)
+    );
+    this.runPollLoop().catch((err) => console.error("[events:pg] poll loop crashed:", err));
+  }
+  async stop() {
+    this.running = false;
+    this.wake();
+    await this.listenClient?.end();
+    this.listenClient = null;
+  }
+  // ── Poll loop ───────────────────────────────────────────────────
+  async runPollLoop() {
+    while (this.running) {
+      try {
+        const hadWork = await this.pollAllConsumers();
+        if (!hadWork) await this.sleep();
+      } catch (err) {
+        console.error("[events:pg] poll error:", err);
+        await this.sleep();
+      }
+    }
+  }
+  async pollAllConsumers() {
+    const consumers = [...new Set(this.subscriptions.map((s) => s.consumer))];
+    const results = await Promise.all(consumers.map((c) => this.pollConsumer(c)));
+    return results.some((n) => n > 0);
+  }
+  async pollConsumer(consumer) {
+    const claimed = await this.store.query(
+      `UPDATE fonderie_event_consumers c
+			 SET status = 'processing', attempts = c.attempts + 1
+			 FROM (
+			   SELECT event_id
+			   FROM   fonderie_event_consumers
+			   WHERE  consumer = $1
+			     AND  status IN ('pending', 'failed')
+			     AND  attempts < $2
+			   ORDER BY event_id
+			   LIMIT $3
+			   FOR UPDATE SKIP LOCKED
+			 ) AS locked
+			 WHERE c.event_id = locked.event_id
+			   AND c.consumer = $1
+			 RETURNING c.event_id`,
+      [consumer, this.maxRetries, this.batchSize]
+    );
+    await Promise.all(claimed.map((row) => this.processConsumerEvent(consumer, row.event_id)));
+    return claimed.length;
+  }
+  // ── Event processing ────────────────────────────────────────────
+  async processConsumerEvent(consumer, eventId) {
+    const [event] = await this.store.query(
+      `SELECT type, payload, meta FROM fonderie_events WHERE id = $1`,
+      [eventId]
+    );
+    if (!event) return;
+    const handlers = this.subscriptions.filter((s) => s.consumer === consumer && matchesPattern(s.pattern, event.type)).map((s) => s.handler);
+    try {
+      await Promise.all(handlers.map((h) => h(event.payload, event.meta)));
+      await this.store.query(
+        `UPDATE fonderie_event_consumers
+				 SET status = 'processed', processed_at = now()
+				 WHERE event_id = $1 AND consumer = $2`,
+        [eventId, consumer]
+      );
+    } catch (err) {
+      await this.store.query(
+        `UPDATE fonderie_event_consumers
+				 SET status = CASE WHEN attempts >= $1 THEN 'dead' ELSE 'failed' END,
+				     error  = $2
+				 WHERE event_id = $3 AND consumer = $4`,
+        [this.maxRetries, err instanceof Error ? err.message : String(err), eventId, consumer]
+      );
+    }
+  }
+  // ── Helpers ─────────────────────────────────────────────────────
+  matchingConsumers(eventType) {
+    const seen = /* @__PURE__ */ new Set();
+    for (const sub of this.subscriptions) {
+      if (matchesPattern(sub.pattern, eventType)) seen.add(sub.consumer);
+    }
+    return [...seen];
+  }
+  sleep() {
+    return new Promise((resolve) => {
+      let timer;
+      const wake = () => {
+        clearTimeout(timer);
+        resolve();
+      };
+      timer = setTimeout(() => {
+        const idx = this.wakeResolvers.indexOf(wake);
+        if (idx !== -1) this.wakeResolvers.splice(idx, 1);
+        resolve();
+      }, this.pollInterval);
+      this.wakeResolvers.push(wake);
+    });
+  }
+  wake() {
+    this.wakeResolvers.shift()?.();
+  }
+};
+
+// src/module.ts
+function resolveTransport(config) {
+  if ("type" in config && config.type === "pg") {
+    return new PGTransport({
+      connectionUrl: config.connectionUrl,
+      ...config.maxRetries !== void 0 ? { maxRetries: config.maxRetries } : {},
+      ...config.batchSize !== void 0 ? { batchSize: config.batchSize } : {},
+      ...config.pollInterval !== void 0 ? { pollInterval: config.pollInterval } : {}
+    });
+  }
+  return config;
+}
+var EventsModule = class {
+  name = "@fonderie/events";
+  bus;
+  constructor(config) {
+    this.bus = new EventBus(resolveTransport(config.transport));
+  }
+  install(_app) {
+    this.bus.start().catch((err) => console.error("[events] failed to start transport", err));
+  }
+};
+
+// src/transports/memory.ts
+var MemoryTransport = class {
+  subscriptions = [];
+  async publish(type, payload, meta) {
+    const matching = this.subscriptions.filter((s) => matchesPattern(s.pattern, type));
+    await Promise.all(matching.map((s) => s.handler(payload, meta)));
+  }
+  subscribe(pattern, handler, _consumer) {
+    this.subscriptions.push({ pattern, handler });
+  }
+  async start() {
+  }
+  async stop() {
+  }
+};
+
+// src/index.ts
+var NOTIFICATION_EVENT = "fonderie.notification.send";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EventBus,
+  EventsModule,
+  MemoryTransport,
+  NOTIFICATION_EVENT,
+  PGTransport,
+  matchesPattern
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/bus.ts","../src/transports/pg.ts","../src/transports/pattern.ts","../src/module.ts","../src/transports/memory.ts"],"sourcesContent":["export { EventBus } from './bus';\nexport { EventsModule } from './module';\nexport type { IEventsConfig, EventTransportConfig } from './module';\n\nexport { MemoryTransport, PGTransport } from './transports';\nexport type { IEventTransport, IPGTransportConfig } from './transports';\n\nexport { matchesPattern } from './transports/pattern';\n\nexport type { IEventMeta, IEventHandler, IEventRecord, IConsumerRecord } from './types';\n\n// ── Typed event keys ─────────────────────────────────────────────\n// Each domain package re-exports its own EVENT_KEYS.\n// Consumers alias on import:\n//   import { EVENT_KEYS as AUTH_EVENT_KEYS } from '@fonderie/auth'\n\nexport const NOTIFICATION_EVENT = 'fonderie.notification.send' as const;\nexport type NotificationEvent = typeof NOTIFICATION_EVENT;\n","import { randomUUID } from 'node:crypto';\n\nimport type { IEventTransport } from './transports/types';\nimport type { IEventMeta, IEventHandler } from './types';\n\nexport class EventBus {\n\tconstructor(private transport: IEventTransport) {}\n\n\tasync emit<T = unknown>(type: string, payload: T, opts?: { requestId?: string }): Promise<void> {\n\t\tconst meta: IEventMeta = {\n\t\t\tid: randomUUID(),\n\t\t\ttype,\n\t\t\temittedAt: new Date().toISOString(),\n\t\t\tattempts: 0,\n\t\t\t...(opts?.requestId !== undefined ? { requestId: opts.requestId } : {}),\n\t\t};\n\t\tawait this.transport.publish(type, payload, meta);\n\t}\n\n\t// consumer identifies the logical subscriber for per-consumer delivery tracking.\n\t// Defaults to the pattern string — stable and predictable for single-subscriber patterns.\n\ton<T = unknown>(type: string, handler: IEventHandler<T>, consumer: string = type): void {\n\t\tthis.transport.subscribe(type, handler as IEventHandler, consumer);\n\t}\n\n\tasync start(): Promise<void> {\n\t\tawait this.transport.start();\n\t}\n\n\tasync stop(): Promise<void> {\n\t\tawait this.transport.stop();\n\t}\n}\n","import pg from 'pg';\n\nimport { PGAdapter } from '@fonderie/store';\nimport type { IStoreAdapter } from '@fonderie/store';\nimport type { IEventTransport } from './types';\nimport type { IEventMeta, IEventHandler, IEventRecord } from '../types';\nimport { matchesPattern } from './pattern';\n\nexport interface IPGTransportConfig {\n\tconnectionUrl: string;\n\tmaxRetries?: number; // default 3\n\tbatchSize?: number; // default 10 rows claimed per consumer per poll cycle\n\tpollInterval?: number; // default 1000ms fallback poll when no NOTIFY arrives\n}\n\ninterface Subscription {\n\tpattern: string;\n\thandler: IEventHandler;\n\tconsumer: string;\n}\n\nexport class PGTransport implements IEventTransport {\n\tprivate subscriptions: Subscription[] = [];\n\tprivate listenClient: pg.Client | null = null;\n\tprivate store!: IStoreAdapter;\n\tprivate running = false;\n\tprivate wakeResolvers: Array<() => void> = [];\n\n\tprivate readonly maxRetries: number;\n\tprivate readonly batchSize: number;\n\tprivate readonly pollInterval: number;\n\n\tconstructor(private config: IPGTransportConfig) {\n\t\tthis.maxRetries = config.maxRetries ?? 3;\n\t\tthis.batchSize = config.batchSize ?? 10;\n\t\tthis.pollInterval = config.pollInterval ?? 1_000;\n\t}\n\n\t// ── Public API ──────────────────────────────────────────────────\n\n\tsubscribe(pattern: string, handler: IEventHandler, consumer: string): void {\n\t\tthis.subscriptions.push({ pattern, handler, consumer });\n\t}\n\n\tasync publish(type: string, payload: unknown, meta: IEventMeta): Promise<void> {\n\t\tawait this.store.query(\n\t\t\t`INSERT INTO fonderie_events (id, type, payload, meta)\n\t\t\t VALUES ($1, $2, $3, $4)`,\n\t\t\t[meta.id, type, JSON.stringify(payload), JSON.stringify(meta)],\n\t\t);\n\n\t\tconst consumers = this.matchingConsumers(type);\n\t\tif (consumers.length > 0) {\n\t\t\tawait this.store.query(\n\t\t\t\t`INSERT INTO fonderie_event_consumers (event_id, consumer, status, attempts)\n\t\t\t\t SELECT $1, unnest($2::text[]), 'pending', 0\n\t\t\t\t ON CONFLICT (event_id, consumer) DO NOTHING`,\n\t\t\t\t[meta.id, consumers],\n\t\t\t);\n\t\t}\n\n\t\t// NOTIFY carries no payload — it is a wake signal only\n\t\tawait this.store.query(`SELECT pg_notify('fonderie_events', '')`);\n\t}\n\n\tasync start(): Promise<void> {\n\t\tthis.running = true;\n\t\tthis.store = new PGAdapter(this.config.connectionUrl);\n\n\t\t// Reset any rows left in 'processing' by a crashed instance\n\t\tawait this.store.query(\n\t\t\t`UPDATE fonderie_event_consumers SET status = 'failed' WHERE status = 'processing'`,\n\t\t);\n\n\t\tthis.listenClient = new pg.Client(this.config.connectionUrl);\n\t\tawait this.listenClient.connect();\n\t\tawait this.listenClient.query('LISTEN fonderie_events');\n\n\t\tthis.listenClient.on('notification', () => this.wake());\n\t\tthis.listenClient.on('error', (err) =>\n\t\t\tconsole.error('[events:pg] listen client error:', err.message),\n\t\t);\n\n\t\tthis.runPollLoop().catch((err) => console.error('[events:pg] poll loop crashed:', err));\n\t}\n\n\tasync stop(): Promise<void> {\n\t\tthis.running = false;\n\t\tthis.wake();\n\t\tawait this.listenClient?.end();\n\t\tthis.listenClient = null;\n\t}\n\n\t// ── Poll loop ───────────────────────────────────────────────────\n\n\tprivate async runPollLoop(): Promise<void> {\n\t\twhile (this.running) {\n\t\t\ttry {\n\t\t\t\tconst hadWork = await this.pollAllConsumers();\n\t\t\t\tif (!hadWork) await this.sleep();\n\t\t\t} catch (err) {\n\t\t\t\tconsole.error('[events:pg] poll error:', err);\n\t\t\t\tawait this.sleep();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async pollAllConsumers(): Promise<boolean> {\n\t\tconst consumers = [...new Set(this.subscriptions.map((s) => s.consumer))];\n\t\tconst results = await Promise.all(consumers.map((c) => this.pollConsumer(c)));\n\t\treturn results.some((n) => n > 0);\n\t}\n\n\tprivate async pollConsumer(consumer: string): Promise<number> {\n\t\tconst claimed = await this.store.query<{ event_id: string }>(\n\t\t\t`UPDATE fonderie_event_consumers c\n\t\t\t SET status = 'processing', attempts = c.attempts + 1\n\t\t\t FROM (\n\t\t\t   SELECT event_id\n\t\t\t   FROM   fonderie_event_consumers\n\t\t\t   WHERE  consumer = $1\n\t\t\t     AND  status IN ('pending', 'failed')\n\t\t\t     AND  attempts < $2\n\t\t\t   ORDER BY event_id\n\t\t\t   LIMIT $3\n\t\t\t   FOR UPDATE SKIP LOCKED\n\t\t\t ) AS locked\n\t\t\t WHERE c.event_id = locked.event_id\n\t\t\t   AND c.consumer = $1\n\t\t\t RETURNING c.event_id`,\n\t\t\t[consumer, this.maxRetries, this.batchSize],\n\t\t);\n\n\t\tawait Promise.all(claimed.map((row) => this.processConsumerEvent(consumer, row.event_id)));\n\t\treturn claimed.length;\n\t}\n\n\t// ── Event processing ────────────────────────────────────────────\n\n\tprivate async processConsumerEvent(consumer: string, eventId: string): Promise<void> {\n\t\tconst [event] = await this.store.query<IEventRecord>(\n\t\t\t`SELECT type, payload, meta FROM fonderie_events WHERE id = $1`,\n\t\t\t[eventId],\n\t\t);\n\t\tif (!event) return;\n\n\t\tconst handlers = this.subscriptions\n\t\t\t.filter((s) => s.consumer === consumer && matchesPattern(s.pattern, event.type))\n\t\t\t.map((s) => s.handler);\n\n\t\ttry {\n\t\t\tawait Promise.all(handlers.map((h) => h(event.payload, event.meta)));\n\t\t\tawait this.store.query(\n\t\t\t\t`UPDATE fonderie_event_consumers\n\t\t\t\t SET status = 'processed', processed_at = now()\n\t\t\t\t WHERE event_id = $1 AND consumer = $2`,\n\t\t\t\t[eventId, consumer],\n\t\t\t);\n\t\t} catch (err) {\n\t\t\tawait this.store.query(\n\t\t\t\t`UPDATE fonderie_event_consumers\n\t\t\t\t SET status = CASE WHEN attempts >= $1 THEN 'dead' ELSE 'failed' END,\n\t\t\t\t     error  = $2\n\t\t\t\t WHERE event_id = $3 AND consumer = $4`,\n\t\t\t\t[this.maxRetries, err instanceof Error ? err.message : String(err), eventId, consumer],\n\t\t\t);\n\t\t}\n\t}\n\n\t// ── Helpers ─────────────────────────────────────────────────────\n\n\tprivate matchingConsumers(eventType: string): string[] {\n\t\tconst seen = new Set<string>();\n\t\tfor (const sub of this.subscriptions) {\n\t\t\tif (matchesPattern(sub.pattern, eventType)) seen.add(sub.consumer);\n\t\t}\n\t\treturn [...seen];\n\t}\n\n\tprivate sleep(): Promise<void> {\n\t\treturn new Promise<void>((resolve) => {\n\t\t\tlet timer: ReturnType<typeof setTimeout>;\n\t\t\tconst wake = () => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\ttimer = setTimeout(() => {\n\t\t\t\tconst idx = this.wakeResolvers.indexOf(wake);\n\t\t\t\tif (idx !== -1) this.wakeResolvers.splice(idx, 1);\n\t\t\t\tresolve();\n\t\t\t}, this.pollInterval);\n\t\t\tthis.wakeResolvers.push(wake);\n\t\t});\n\t}\n\n\tprivate wake(): void {\n\t\tthis.wakeResolvers.shift()?.();\n\t}\n}\n","// Glob matching for event topic patterns.\n// '*' alone matches everything. Otherwise '*' is a wildcard for any\n// characters including dots, so 'sport.*' matches 'sport.event.created'.\nexport function matchesPattern(pattern: string, eventType: string): boolean {\n\tif (pattern === '*') return true;\n\tconst regex = new RegExp('^' + pattern.replace(/\\./g, '\\\\.').replace(/\\*/g, '.*') + '$');\n\treturn regex.test(eventType);\n}\n","import type { IFonderieModule, IFonderieApp } from '@fonderie/core';\n\nimport { EventBus } from './bus';\nimport { PGTransport } from './transports/pg';\nimport type { IEventTransport } from './transports/types';\n\nexport type EventTransportConfig =\n\t| {\n\t\t\ttype: 'pg';\n\t\t\tconnectionUrl: string;\n\t\t\tmaxRetries?: number;\n\t\t\tbatchSize?: number;\n\t\t\tpollInterval?: number;\n\t  }\n\t| IEventTransport;\n\nexport interface IEventsConfig {\n\ttransport: EventTransportConfig;\n}\n\nfunction resolveTransport(config: EventTransportConfig): IEventTransport {\n\tif ('type' in config && config.type === 'pg') {\n\t\treturn new PGTransport({\n\t\t\tconnectionUrl: config.connectionUrl,\n\t\t\t...(config.maxRetries !== undefined ? { maxRetries: config.maxRetries } : {}),\n\t\t\t...(config.batchSize !== undefined ? { batchSize: config.batchSize } : {}),\n\t\t\t...(config.pollInterval !== undefined ? { pollInterval: config.pollInterval } : {}),\n\t\t});\n\t}\n\n\treturn config as IEventTransport;\n}\n\nexport class EventsModule implements IFonderieModule {\n\treadonly name = '@fonderie/events';\n\treadonly bus: EventBus;\n\n\tconstructor(config: IEventsConfig) {\n\t\tthis.bus = new EventBus(resolveTransport(config.transport));\n\t}\n\n\tinstall(_app: IFonderieApp): void {\n\t\tthis.bus.start().catch((err) => console.error('[events] failed to start transport', err));\n\t}\n}\n","import type { IEventTransport } from './types';\nimport type { IEventMeta, IEventHandler } from '../types';\nimport { matchesPattern } from './pattern';\n\nexport class MemoryTransport implements IEventTransport {\n\tprivate subscriptions: Array<{ pattern: string; handler: IEventHandler }> = [];\n\n\tasync publish(type: string, payload: unknown, meta: IEventMeta): Promise<void> {\n\t\tconst matching = this.subscriptions.filter((s) => matchesPattern(s.pattern, type));\n\t\tawait Promise.all(matching.map((s) => s.handler(payload, meta)));\n\t}\n\n\tsubscribe(pattern: string, handler: IEventHandler, _consumer: string): void {\n\t\tthis.subscriptions.push({ pattern, handler });\n\t}\n\n\tasync start(): Promise<void> {}\n\tasync stop(): Promise<void> {}\n}\n"],"mappings":"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","names":["pg"]}

package/dist/index.d.cts

@@ -0,0 +1,105 @@
+import { IFonderieModule, IFonderieApp } from '@fonderie/core';
+
+interface IEventMeta {
+    id: string;
+    type: string;
+    emittedAt: string;
+    attempts: number;
+    requestId?: string;
+}
+interface IEventRecord {
+    id: string;
+    type: string;
+    payload: Record<string, unknown>;
+    meta: IEventMeta;
+    created_at: Date;
+}
+interface IConsumerRecord {
+    event_id: string;
+    consumer: string;
+    status: 'pending' | 'processing' | 'processed' | 'failed' | 'dead';
+    attempts: number;
+    error: string | null;
+    processed_at: Date | null;
+}
+type IEventHandler<T = unknown> = (payload: T, meta: IEventMeta) => Promise<void>;
+
+interface IEventTransport {
+    publish(type: string, payload: unknown, meta: IEventMeta): Promise<void>;
+    subscribe(type: string, handler: IEventHandler, consumer: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+declare class EventBus {
+    private transport;
+    constructor(transport: IEventTransport);
+    emit<T = unknown>(type: string, payload: T, opts?: {
+        requestId?: string;
+    }): Promise<void>;
+    on<T = unknown>(type: string, handler: IEventHandler<T>, consumer?: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+type EventTransportConfig = {
+    type: 'pg';
+    connectionUrl: string;
+    maxRetries?: number;
+    batchSize?: number;
+    pollInterval?: number;
+} | IEventTransport;
+interface IEventsConfig {
+    transport: EventTransportConfig;
+}
+declare class EventsModule implements IFonderieModule {
+    readonly name = "@fonderie/events";
+    readonly bus: EventBus;
+    constructor(config: IEventsConfig);
+    install(_app: IFonderieApp): void;
+}
+
+declare class MemoryTransport implements IEventTransport {
+    private subscriptions;
+    publish(type: string, payload: unknown, meta: IEventMeta): Promise<void>;
+    subscribe(pattern: string, handler: IEventHandler, _consumer: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+interface IPGTransportConfig {
+    connectionUrl: string;
+    maxRetries?: number;
+    batchSize?: number;
+    pollInterval?: number;
+}
+declare class PGTransport implements IEventTransport {
+    private config;
+    private subscriptions;
+    private listenClient;
+    private store;
+    private running;
+    private wakeResolvers;
+    private readonly maxRetries;
+    private readonly batchSize;
+    private readonly pollInterval;
+    constructor(config: IPGTransportConfig);
+    subscribe(pattern: string, handler: IEventHandler, consumer: string): void;
+    publish(type: string, payload: unknown, meta: IEventMeta): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private runPollLoop;
+    private pollAllConsumers;
+    private pollConsumer;
+    private processConsumerEvent;
+    private matchingConsumers;
+    private sleep;
+    private wake;
+}
+
+declare function matchesPattern(pattern: string, eventType: string): boolean;
+
+declare const NOTIFICATION_EVENT: "fonderie.notification.send";
+type NotificationEvent = typeof NOTIFICATION_EVENT;
+
+export { EventBus, type EventTransportConfig, EventsModule, type IConsumerRecord, type IEventHandler, type IEventMeta, type IEventRecord, type IEventTransport, type IEventsConfig, type IPGTransportConfig, MemoryTransport, NOTIFICATION_EVENT, type NotificationEvent, PGTransport, matchesPattern };

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+import { IFonderieModule, IFonderieApp } from '@fonderie/core';
+
+interface IEventMeta {
+    id: string;
+    type: string;
+    emittedAt: string;
+    attempts: number;
+    requestId?: string;
+}
+interface IEventRecord {
+    id: string;
+    type: string;
+    payload: Record<string, unknown>;
+    meta: IEventMeta;
+    created_at: Date;
+}
+interface IConsumerRecord {
+    event_id: string;
+    consumer: string;
+    status: 'pending' | 'processing' | 'processed' | 'failed' | 'dead';
+    attempts: number;
+    error: string | null;
+    processed_at: Date | null;
+}
+type IEventHandler<T = unknown> = (payload: T, meta: IEventMeta) => Promise<void>;
+
+interface IEventTransport {
+    publish(type: string, payload: unknown, meta: IEventMeta): Promise<void>;
+    subscribe(type: string, handler: IEventHandler, consumer: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+declare class EventBus {
+    private transport;
+    constructor(transport: IEventTransport);
+    emit<T = unknown>(type: string, payload: T, opts?: {
+        requestId?: string;
+    }): Promise<void>;
+    on<T = unknown>(type: string, handler: IEventHandler<T>, consumer?: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+type EventTransportConfig = {
+    type: 'pg';
+    connectionUrl: string;
+    maxRetries?: number;
+    batchSize?: number;
+    pollInterval?: number;
+} | IEventTransport;
+interface IEventsConfig {
+    transport: EventTransportConfig;
+}
+declare class EventsModule implements IFonderieModule {
+    readonly name = "@fonderie/events";
+    readonly bus: EventBus;
+    constructor(config: IEventsConfig);
+    install(_app: IFonderieApp): void;
+}
+
+declare class MemoryTransport implements IEventTransport {
+    private subscriptions;
+    publish(type: string, payload: unknown, meta: IEventMeta): Promise<void>;
+    subscribe(pattern: string, handler: IEventHandler, _consumer: string): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+interface IPGTransportConfig {
+    connectionUrl: string;
+    maxRetries?: number;
+    batchSize?: number;
+    pollInterval?: number;
+}
+declare class PGTransport implements IEventTransport {
+    private config;
+    private subscriptions;
+    private listenClient;
+    private store;
+    private running;
+    private wakeResolvers;
+    private readonly maxRetries;
+    private readonly batchSize;
+    private readonly pollInterval;
+    constructor(config: IPGTransportConfig);
+    subscribe(pattern: string, handler: IEventHandler, consumer: string): void;
+    publish(type: string, payload: unknown, meta: IEventMeta): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private runPollLoop;
+    private pollAllConsumers;
+    private pollConsumer;
+    private processConsumerEvent;
+    private matchingConsumers;
+    private sleep;
+    private wake;
+}
+
+declare function matchesPattern(pattern: string, eventType: string): boolean;
+
+declare const NOTIFICATION_EVENT: "fonderie.notification.send";
+type NotificationEvent = typeof NOTIFICATION_EVENT;
+
+export { EventBus, type EventTransportConfig, EventsModule, type IConsumerRecord, type IEventHandler, type IEventMeta, type IEventRecord, type IEventTransport, type IEventsConfig, type IPGTransportConfig, MemoryTransport, NOTIFICATION_EVENT, type NotificationEvent, PGTransport, matchesPattern };

package/dist/index.js

@@ -0,0 +1,244 @@
+// src/bus.ts
+import { randomUUID } from "crypto";
+var EventBus = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  async emit(type, payload, opts) {
+    const meta = {
+      id: randomUUID(),
+      type,
+      emittedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      attempts: 0,
+      ...opts?.requestId !== void 0 ? { requestId: opts.requestId } : {}
+    };
+    await this.transport.publish(type, payload, meta);
+  }
+  // consumer identifies the logical subscriber for per-consumer delivery tracking.
+  // Defaults to the pattern string — stable and predictable for single-subscriber patterns.
+  on(type, handler, consumer = type) {
+    this.transport.subscribe(type, handler, consumer);
+  }
+  async start() {
+    await this.transport.start();
+  }
+  async stop() {
+    await this.transport.stop();
+  }
+};
+
+// src/transports/pg.ts
+import pg from "pg";
+import { PGAdapter } from "@fonderie/store";
+
+// src/transports/pattern.ts
+function matchesPattern(pattern, eventType) {
+  if (pattern === "*") return true;
+  const regex = new RegExp("^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*") + "$");
+  return regex.test(eventType);
+}
+
+// src/transports/pg.ts
+var PGTransport = class {
+  constructor(config) {
+    this.config = config;
+    this.maxRetries = config.maxRetries ?? 3;
+    this.batchSize = config.batchSize ?? 10;
+    this.pollInterval = config.pollInterval ?? 1e3;
+  }
+  config;
+  subscriptions = [];
+  listenClient = null;
+  store;
+  running = false;
+  wakeResolvers = [];
+  maxRetries;
+  batchSize;
+  pollInterval;
+  // ── Public API ──────────────────────────────────────────────────
+  subscribe(pattern, handler, consumer) {
+    this.subscriptions.push({ pattern, handler, consumer });
+  }
+  async publish(type, payload, meta) {
+    await this.store.query(
+      `INSERT INTO fonderie_events (id, type, payload, meta)
+			 VALUES ($1, $2, $3, $4)`,
+      [meta.id, type, JSON.stringify(payload), JSON.stringify(meta)]
+    );
+    const consumers = this.matchingConsumers(type);
+    if (consumers.length > 0) {
+      await this.store.query(
+        `INSERT INTO fonderie_event_consumers (event_id, consumer, status, attempts)
+				 SELECT $1, unnest($2::text[]), 'pending', 0
+				 ON CONFLICT (event_id, consumer) DO NOTHING`,
+        [meta.id, consumers]
+      );
+    }
+    await this.store.query(`SELECT pg_notify('fonderie_events', '')`);
+  }
+  async start() {
+    this.running = true;
+    this.store = new PGAdapter(this.config.connectionUrl);
+    await this.store.query(
+      `UPDATE fonderie_event_consumers SET status = 'failed' WHERE status = 'processing'`
+    );
+    this.listenClient = new pg.Client(this.config.connectionUrl);
+    await this.listenClient.connect();
+    await this.listenClient.query("LISTEN fonderie_events");
+    this.listenClient.on("notification", () => this.wake());
+    this.listenClient.on(
+      "error",
+      (err) => console.error("[events:pg] listen client error:", err.message)
+    );
+    this.runPollLoop().catch((err) => console.error("[events:pg] poll loop crashed:", err));
+  }
+  async stop() {
+    this.running = false;
+    this.wake();
+    await this.listenClient?.end();
+    this.listenClient = null;
+  }
+  // ── Poll loop ───────────────────────────────────────────────────
+  async runPollLoop() {
+    while (this.running) {
+      try {
+        const hadWork = await this.pollAllConsumers();
+        if (!hadWork) await this.sleep();
+      } catch (err) {
+        console.error("[events:pg] poll error:", err);
+        await this.sleep();
+      }
+    }
+  }
+  async pollAllConsumers() {
+    const consumers = [...new Set(this.subscriptions.map((s) => s.consumer))];
+    const results = await Promise.all(consumers.map((c) => this.pollConsumer(c)));
+    return results.some((n) => n > 0);
+  }
+  async pollConsumer(consumer) {
+    const claimed = await this.store.query(
+      `UPDATE fonderie_event_consumers c
+			 SET status = 'processing', attempts = c.attempts + 1
+			 FROM (
+			   SELECT event_id
+			   FROM   fonderie_event_consumers
+			   WHERE  consumer = $1
+			     AND  status IN ('pending', 'failed')
+			     AND  attempts < $2
+			   ORDER BY event_id
+			   LIMIT $3
+			   FOR UPDATE SKIP LOCKED
+			 ) AS locked
+			 WHERE c.event_id = locked.event_id
+			   AND c.consumer = $1
+			 RETURNING c.event_id`,
+      [consumer, this.maxRetries, this.batchSize]
+    );
+    await Promise.all(claimed.map((row) => this.processConsumerEvent(consumer, row.event_id)));
+    return claimed.length;
+  }
+  // ── Event processing ────────────────────────────────────────────
+  async processConsumerEvent(consumer, eventId) {
+    const [event] = await this.store.query(
+      `SELECT type, payload, meta FROM fonderie_events WHERE id = $1`,
+      [eventId]
+    );
+    if (!event) return;
+    const handlers = this.subscriptions.filter((s) => s.consumer === consumer && matchesPattern(s.pattern, event.type)).map((s) => s.handler);
+    try {
+      await Promise.all(handlers.map((h) => h(event.payload, event.meta)));
+      await this.store.query(
+        `UPDATE fonderie_event_consumers
+				 SET status = 'processed', processed_at = now()
+				 WHERE event_id = $1 AND consumer = $2`,
+        [eventId, consumer]
+      );
+    } catch (err) {
+      await this.store.query(
+        `UPDATE fonderie_event_consumers
+				 SET status = CASE WHEN attempts >= $1 THEN 'dead' ELSE 'failed' END,
+				     error  = $2
+				 WHERE event_id = $3 AND consumer = $4`,
+        [this.maxRetries, err instanceof Error ? err.message : String(err), eventId, consumer]
+      );
+    }
+  }
+  // ── Helpers ─────────────────────────────────────────────────────
+  matchingConsumers(eventType) {
+    const seen = /* @__PURE__ */ new Set();
+    for (const sub of this.subscriptions) {
+      if (matchesPattern(sub.pattern, eventType)) seen.add(sub.consumer);
+    }
+    return [...seen];
+  }
+  sleep() {
+    return new Promise((resolve) => {
+      let timer;
+      const wake = () => {
+        clearTimeout(timer);
+        resolve();
+      };
+      timer = setTimeout(() => {
+        const idx = this.wakeResolvers.indexOf(wake);
+        if (idx !== -1) this.wakeResolvers.splice(idx, 1);
+        resolve();
+      }, this.pollInterval);
+      this.wakeResolvers.push(wake);
+    });
+  }
+  wake() {
+    this.wakeResolvers.shift()?.();
+  }
+};
+
+// src/module.ts
+function resolveTransport(config) {
+  if ("type" in config && config.type === "pg") {
+    return new PGTransport({
+      connectionUrl: config.connectionUrl,
+      ...config.maxRetries !== void 0 ? { maxRetries: config.maxRetries } : {},
+      ...config.batchSize !== void 0 ? { batchSize: config.batchSize } : {},
+      ...config.pollInterval !== void 0 ? { pollInterval: config.pollInterval } : {}
+    });
+  }
+  return config;
+}
+var EventsModule = class {
+  name = "@fonderie/events";
+  bus;
+  constructor(config) {
+    this.bus = new EventBus(resolveTransport(config.transport));
+  }
+  install(_app) {
+    this.bus.start().catch((err) => console.error("[events] failed to start transport", err));
+  }
+};
+
+// src/transports/memory.ts
+var MemoryTransport = class {
+  subscriptions = [];
+  async publish(type, payload, meta) {
+    const matching = this.subscriptions.filter((s) => matchesPattern(s.pattern, type));
+    await Promise.all(matching.map((s) => s.handler(payload, meta)));
+  }
+  subscribe(pattern, handler, _consumer) {
+    this.subscriptions.push({ pattern, handler });
+  }
+  async start() {
+  }
+  async stop() {
+  }
+};
+
+// src/index.ts
+var NOTIFICATION_EVENT = "fonderie.notification.send";
+export {
+  EventBus,
+  EventsModule,
+  MemoryTransport,
+  NOTIFICATION_EVENT,
+  PGTransport,
+  matchesPattern
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bus.ts","../src/transports/pg.ts","../src/transports/pattern.ts","../src/module.ts","../src/transports/memory.ts","../src/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { IEventTransport } from './transports/types';\nimport type { IEventMeta, IEventHandler } from './types';\n\nexport class EventBus {\n\tconstructor(private transport: IEventTransport) {}\n\n\tasync emit<T = unknown>(type: string, payload: T, opts?: { requestId?: string }): Promise<void> {\n\t\tconst meta: IEventMeta = {\n\t\t\tid: randomUUID(),\n\t\t\ttype,\n\t\t\temittedAt: new Date().toISOString(),\n\t\t\tattempts: 0,\n\t\t\t...(opts?.requestId !== undefined ? { requestId: opts.requestId } : {}),\n\t\t};\n\t\tawait this.transport.publish(type, payload, meta);\n\t}\n\n\t// consumer identifies the logical subscriber for per-consumer delivery tracking.\n\t// Defaults to the pattern string — stable and predictable for single-subscriber patterns.\n\ton<T = unknown>(type: string, handler: IEventHandler<T>, consumer: string = type): void {\n\t\tthis.transport.subscribe(type, handler as IEventHandler, consumer);\n\t}\n\n\tasync start(): Promise<void> {\n\t\tawait this.transport.start();\n\t}\n\n\tasync stop(): Promise<void> {\n\t\tawait this.transport.stop();\n\t}\n}\n","import pg from 'pg';\n\nimport { PGAdapter } from '@fonderie/store';\nimport type { IStoreAdapter } from '@fonderie/store';\nimport type { IEventTransport } from './types';\nimport type { IEventMeta, IEventHandler, IEventRecord } from '../types';\nimport { matchesPattern } from './pattern';\n\nexport interface IPGTransportConfig {\n\tconnectionUrl: string;\n\tmaxRetries?: number; // default 3\n\tbatchSize?: number; // default 10 rows claimed per consumer per poll cycle\n\tpollInterval?: number; // default 1000ms fallback poll when no NOTIFY arrives\n}\n\ninterface Subscription {\n\tpattern: string;\n\thandler: IEventHandler;\n\tconsumer: string;\n}\n\nexport class PGTransport implements IEventTransport {\n\tprivate subscriptions: Subscription[] = [];\n\tprivate listenClient: pg.Client | null = null;\n\tprivate store!: IStoreAdapter;\n\tprivate running = false;\n\tprivate wakeResolvers: Array<() => void> = [];\n\n\tprivate readonly maxRetries: number;\n\tprivate readonly batchSize: number;\n\tprivate readonly pollInterval: number;\n\n\tconstructor(private config: IPGTransportConfig) {\n\t\tthis.maxRetries = config.maxRetries ?? 3;\n\t\tthis.batchSize = config.batchSize ?? 10;\n\t\tthis.pollInterval = config.pollInterval ?? 1_000;\n\t}\n\n\t// ── Public API ──────────────────────────────────────────────────\n\n\tsubscribe(pattern: string, handler: IEventHandler, consumer: string): void {\n\t\tthis.subscriptions.push({ pattern, handler, consumer });\n\t}\n\n\tasync publish(type: string, payload: unknown, meta: IEventMeta): Promise<void> {\n\t\tawait this.store.query(\n\t\t\t`INSERT INTO fonderie_events (id, type, payload, meta)\n\t\t\t VALUES ($1, $2, $3, $4)`,\n\t\t\t[meta.id, type, JSON.stringify(payload), JSON.stringify(meta)],\n\t\t);\n\n\t\tconst consumers = this.matchingConsumers(type);\n\t\tif (consumers.length > 0) {\n\t\t\tawait this.store.query(\n\t\t\t\t`INSERT INTO fonderie_event_consumers (event_id, consumer, status, attempts)\n\t\t\t\t SELECT $1, unnest($2::text[]), 'pending', 0\n\t\t\t\t ON CONFLICT (event_id, consumer) DO NOTHING`,\n\t\t\t\t[meta.id, consumers],\n\t\t\t);\n\t\t}\n\n\t\t// NOTIFY carries no payload — it is a wake signal only\n\t\tawait this.store.query(`SELECT pg_notify('fonderie_events', '')`);\n\t}\n\n\tasync start(): Promise<void> {\n\t\tthis.running = true;\n\t\tthis.store = new PGAdapter(this.config.connectionUrl);\n\n\t\t// Reset any rows left in 'processing' by a crashed instance\n\t\tawait this.store.query(\n\t\t\t`UPDATE fonderie_event_consumers SET status = 'failed' WHERE status = 'processing'`,\n\t\t);\n\n\t\tthis.listenClient = new pg.Client(this.config.connectionUrl);\n\t\tawait this.listenClient.connect();\n\t\tawait this.listenClient.query('LISTEN fonderie_events');\n\n\t\tthis.listenClient.on('notification', () => this.wake());\n\t\tthis.listenClient.on('error', (err) =>\n\t\t\tconsole.error('[events:pg] listen client error:', err.message),\n\t\t);\n\n\t\tthis.runPollLoop().catch((err) => console.error('[events:pg] poll loop crashed:', err));\n\t}\n\n\tasync stop(): Promise<void> {\n\t\tthis.running = false;\n\t\tthis.wake();\n\t\tawait this.listenClient?.end();\n\t\tthis.listenClient = null;\n\t}\n\n\t// ── Poll loop ───────────────────────────────────────────────────\n\n\tprivate async runPollLoop(): Promise<void> {\n\t\twhile (this.running) {\n\t\t\ttry {\n\t\t\t\tconst hadWork = await this.pollAllConsumers();\n\t\t\t\tif (!hadWork) await this.sleep();\n\t\t\t} catch (err) {\n\t\t\t\tconsole.error('[events:pg] poll error:', err);\n\t\t\t\tawait this.sleep();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async pollAllConsumers(): Promise<boolean> {\n\t\tconst consumers = [...new Set(this.subscriptions.map((s) => s.consumer))];\n\t\tconst results = await Promise.all(consumers.map((c) => this.pollConsumer(c)));\n\t\treturn results.some((n) => n > 0);\n\t}\n\n\tprivate async pollConsumer(consumer: string): Promise<number> {\n\t\tconst claimed = await this.store.query<{ event_id: string }>(\n\t\t\t`UPDATE fonderie_event_consumers c\n\t\t\t SET status = 'processing', attempts = c.attempts + 1\n\t\t\t FROM (\n\t\t\t   SELECT event_id\n\t\t\t   FROM   fonderie_event_consumers\n\t\t\t   WHERE  consumer = $1\n\t\t\t     AND  status IN ('pending', 'failed')\n\t\t\t     AND  attempts < $2\n\t\t\t   ORDER BY event_id\n\t\t\t   LIMIT $3\n\t\t\t   FOR UPDATE SKIP LOCKED\n\t\t\t ) AS locked\n\t\t\t WHERE c.event_id = locked.event_id\n\t\t\t   AND c.consumer = $1\n\t\t\t RETURNING c.event_id`,\n\t\t\t[consumer, this.maxRetries, this.batchSize],\n\t\t);\n\n\t\tawait Promise.all(claimed.map((row) => this.processConsumerEvent(consumer, row.event_id)));\n\t\treturn claimed.length;\n\t}\n\n\t// ── Event processing ────────────────────────────────────────────\n\n\tprivate async processConsumerEvent(consumer: string, eventId: string): Promise<void> {\n\t\tconst [event] = await this.store.query<IEventRecord>(\n\t\t\t`SELECT type, payload, meta FROM fonderie_events WHERE id = $1`,\n\t\t\t[eventId],\n\t\t);\n\t\tif (!event) return;\n\n\t\tconst handlers = this.subscriptions\n\t\t\t.filter((s) => s.consumer === consumer && matchesPattern(s.pattern, event.type))\n\t\t\t.map((s) => s.handler);\n\n\t\ttry {\n\t\t\tawait Promise.all(handlers.map((h) => h(event.payload, event.meta)));\n\t\t\tawait this.store.query(\n\t\t\t\t`UPDATE fonderie_event_consumers\n\t\t\t\t SET status = 'processed', processed_at = now()\n\t\t\t\t WHERE event_id = $1 AND consumer = $2`,\n\t\t\t\t[eventId, consumer],\n\t\t\t);\n\t\t} catch (err) {\n\t\t\tawait this.store.query(\n\t\t\t\t`UPDATE fonderie_event_consumers\n\t\t\t\t SET status = CASE WHEN attempts >= $1 THEN 'dead' ELSE 'failed' END,\n\t\t\t\t     error  = $2\n\t\t\t\t WHERE event_id = $3 AND consumer = $4`,\n\t\t\t\t[this.maxRetries, err instanceof Error ? err.message : String(err), eventId, consumer],\n\t\t\t);\n\t\t}\n\t}\n\n\t// ── Helpers ─────────────────────────────────────────────────────\n\n\tprivate matchingConsumers(eventType: string): string[] {\n\t\tconst seen = new Set<string>();\n\t\tfor (const sub of this.subscriptions) {\n\t\t\tif (matchesPattern(sub.pattern, eventType)) seen.add(sub.consumer);\n\t\t}\n\t\treturn [...seen];\n\t}\n\n\tprivate sleep(): Promise<void> {\n\t\treturn new Promise<void>((resolve) => {\n\t\t\tlet timer: ReturnType<typeof setTimeout>;\n\t\t\tconst wake = () => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\ttimer = setTimeout(() => {\n\t\t\t\tconst idx = this.wakeResolvers.indexOf(wake);\n\t\t\t\tif (idx !== -1) this.wakeResolvers.splice(idx, 1);\n\t\t\t\tresolve();\n\t\t\t}, this.pollInterval);\n\t\t\tthis.wakeResolvers.push(wake);\n\t\t});\n\t}\n\n\tprivate wake(): void {\n\t\tthis.wakeResolvers.shift()?.();\n\t}\n}\n","// Glob matching for event topic patterns.\n// '*' alone matches everything. Otherwise '*' is a wildcard for any\n// characters including dots, so 'sport.*' matches 'sport.event.created'.\nexport function matchesPattern(pattern: string, eventType: string): boolean {\n\tif (pattern === '*') return true;\n\tconst regex = new RegExp('^' + pattern.replace(/\\./g, '\\\\.').replace(/\\*/g, '.*') + '$');\n\treturn regex.test(eventType);\n}\n","import type { IFonderieModule, IFonderieApp } from '@fonderie/core';\n\nimport { EventBus } from './bus';\nimport { PGTransport } from './transports/pg';\nimport type { IEventTransport } from './transports/types';\n\nexport type EventTransportConfig =\n\t| {\n\t\t\ttype: 'pg';\n\t\t\tconnectionUrl: string;\n\t\t\tmaxRetries?: number;\n\t\t\tbatchSize?: number;\n\t\t\tpollInterval?: number;\n\t  }\n\t| IEventTransport;\n\nexport interface IEventsConfig {\n\ttransport: EventTransportConfig;\n}\n\nfunction resolveTransport(config: EventTransportConfig): IEventTransport {\n\tif ('type' in config && config.type === 'pg') {\n\t\treturn new PGTransport({\n\t\t\tconnectionUrl: config.connectionUrl,\n\t\t\t...(config.maxRetries !== undefined ? { maxRetries: config.maxRetries } : {}),\n\t\t\t...(config.batchSize !== undefined ? { batchSize: config.batchSize } : {}),\n\t\t\t...(config.pollInterval !== undefined ? { pollInterval: config.pollInterval } : {}),\n\t\t});\n\t}\n\n\treturn config as IEventTransport;\n}\n\nexport class EventsModule implements IFonderieModule {\n\treadonly name = '@fonderie/events';\n\treadonly bus: EventBus;\n\n\tconstructor(config: IEventsConfig) {\n\t\tthis.bus = new EventBus(resolveTransport(config.transport));\n\t}\n\n\tinstall(_app: IFonderieApp): void {\n\t\tthis.bus.start().catch((err) => console.error('[events] failed to start transport', err));\n\t}\n}\n","import type { IEventTransport } from './types';\nimport type { IEventMeta, IEventHandler } from '../types';\nimport { matchesPattern } from './pattern';\n\nexport class MemoryTransport implements IEventTransport {\n\tprivate subscriptions: Array<{ pattern: string; handler: IEventHandler }> = [];\n\n\tasync publish(type: string, payload: unknown, meta: IEventMeta): Promise<void> {\n\t\tconst matching = this.subscriptions.filter((s) => matchesPattern(s.pattern, type));\n\t\tawait Promise.all(matching.map((s) => s.handler(payload, meta)));\n\t}\n\n\tsubscribe(pattern: string, handler: IEventHandler, _consumer: string): void {\n\t\tthis.subscriptions.push({ pattern, handler });\n\t}\n\n\tasync start(): Promise<void> {}\n\tasync stop(): Promise<void> {}\n}\n","export { EventBus } from './bus';\nexport { EventsModule } from './module';\nexport type { IEventsConfig, EventTransportConfig } from './module';\n\nexport { MemoryTransport, PGTransport } from './transports';\nexport type { IEventTransport, IPGTransportConfig } from './transports';\n\nexport { matchesPattern } from './transports/pattern';\n\nexport type { IEventMeta, IEventHandler, IEventRecord, IConsumerRecord } from './types';\n\n// ── Typed event keys ─────────────────────────────────────────────\n// Each domain package re-exports its own EVENT_KEYS.\n// Consumers alias on import:\n//   import { EVENT_KEYS as AUTH_EVENT_KEYS } from '@fonderie/auth'\n\nexport const NOTIFICATION_EVENT = 'fonderie.notification.send' as const;\nexport type NotificationEvent = typeof NOTIFICATION_EVENT;\n"],"mappings":"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","names":[]}

package/dist/migrations/index.d.ts

@@ -0,0 +1,3 @@
+declare function getMigrationsPath(): string;
+
+export { getMigrationsPath };

package/dist/migrations/index.js

@@ -0,0 +1,9 @@
+// src/migrations/index.ts
+import { createMigrationsPath } from "@fonderie/store";
+function getMigrationsPath() {
+  return createMigrationsPath(import.meta.url);
+}
+export {
+  getMigrationsPath
+};
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/migrations/index.ts"],"sourcesContent":["import { createMigrationsPath } from '@fonderie/store';\n\nexport function getMigrationsPath(): string {\n\treturn createMigrationsPath(import.meta.url);\n}\n"],"mappings":";AAAA,SAAS,4BAA4B;AAE9B,SAAS,oBAA4B;AAC3C,SAAO,qBAAqB,YAAY,GAAG;AAC5C;","names":[]}

package/dist/migrations/sql/001_events.sql

@@ -0,0 +1,10 @@
+CREATE TABLE IF NOT EXISTS fonderie_events (
+	id          UUID        NOT NULL PRIMARY KEY DEFAULT gen_random_uuid(),
+	type        TEXT        NOT NULL,
+	payload     JSONB       NOT NULL DEFAULT '{}',
+	meta        JSONB       NOT NULL DEFAULT '{}',
+	created_at  TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS fonderie_events_created_idx
+	ON fonderie_events (created_at);

package/dist/migrations/sql/002_event_consumers.sql

@@ -0,0 +1,25 @@
+-- Drop mutable delivery columns from fonderie_events (no-op on fresh installs)
+ALTER TABLE fonderie_events
+	DROP COLUMN IF EXISTS status,
+	DROP COLUMN IF EXISTS attempts,
+	DROP COLUMN IF EXISTS error,
+	DROP COLUMN IF EXISTS processed_at;
+
+DROP INDEX IF EXISTS fonderie_events_status_idx;
+
+-- Per-consumer delivery tracking
+CREATE TABLE IF NOT EXISTS fonderie_event_consumers (
+	event_id      UUID        NOT NULL REFERENCES fonderie_events(id) ON DELETE CASCADE,
+	consumer      TEXT        NOT NULL,
+	status        TEXT        NOT NULL DEFAULT 'pending'
+	                          CHECK (status IN ('pending', 'processing', 'processed', 'failed', 'dead')),
+	attempts      INT         NOT NULL DEFAULT 0,
+	error         TEXT,
+	processed_at  TIMESTAMPTZ,
+	PRIMARY KEY (event_id, consumer)
+);
+
+-- Partial index — each consumer's poll touches only its own pending rows
+CREATE INDEX IF NOT EXISTS fonderie_event_consumers_poll_idx
+	ON fonderie_event_consumers (consumer, status, event_id)
+	WHERE status IN ('pending', 'failed');

package/package.json

@@ -0,0 +1,81 @@
+{
+	"name": "@fonderie/events",
+	"version": "1.0.0",
+	"description": "Event bus for @fonderie-js — memory and PostgreSQL transports built-in, adapter interface for Redis/Kafka/RabbitMQ.",
+	"keywords": [
+		"fonderie-js",
+		"events",
+		"event-bus",
+		"pubsub",
+		"outbox",
+		"typescript"
+	],
+	"license": "MIT",
+	"type": "module",
+	"engines": {
+		"node": ">=20"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
+		"./migrations": {
+			"types": "./dist/migrations/index.d.ts",
+			"import": "./dist/migrations/index.js"
+		}
+	},
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "tsup && node -e \"require('node:fs').cpSync('src/migrations/sql', 'dist/migrations/sql', {recursive:true})\"",
+		"dev": "tsup --watch",
+		"typecheck": "tsc --noEmit",
+		"test": "tsx --test src/__tests__/*.test.ts",
+		"lint": "biome lint src",
+		"format": "biome format --write src",
+		"check": "biome check --write src"
+	},
+	"peerDependencies": {
+		"@fonderie/core": "^0.1.0",
+		"@fonderie/store": "^0.1.0",
+		"pg": "^8.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@fonderie/store": {
+			"optional": true
+		},
+		"pg": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@fonderie/core": "../core",
+		"@fonderie/store": "../store",
+		"@types/node": "^25.6.0",
+		"@types/pg": "^8.11.10",
+		"pg": "^8.13.3",
+		"tsup": "^8.5.1",
+		"tsx": "^4.21.0",
+		"typescript": "^6.0.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist",
+		"LICENSE",
+		"README.md"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/fonderie-js/sdk.git",
+		"directory": "packages/events"
+	},
+	"homepage": "https://github.com/fonderie-js/sdk/tree/main/packages/events#readme",
+	"bugs": {
+		"url": "https://github.com/fonderie-js/sdk/issues"
+	}
+}