abxbus 2.4.1

package/dist/cjs/bridge_postgres.js

@@ -0,0 +1,251 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var bridge_postgres_exports = {};
+__export(bridge_postgres_exports, {
+  PostgresEventBridge: () => PostgresEventBridge
+});
+module.exports = __toCommonJS(bridge_postgres_exports);
+var import_base_event = require("./base_event.js");
+var import_event_bus = require("./event_bus.js");
+var import_optional_deps = require("./optional_deps.js");
+const randomSuffix = () => Math.random().toString(36).slice(2, 10);
+const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const DEFAULT_POSTGRES_TABLE = "abxbus_events";
+const DEFAULT_POSTGRES_CHANNEL = "abxbus_events";
+const EVENT_PAYLOAD_COLUMN = "event_payload";
+const validateIdentifier = (value, label) => {
+  if (!IDENTIFIER_RE.test(value)) {
+    throw new Error(`Invalid ${label}: ${JSON.stringify(value)}. Use only [A-Za-z0-9_] and start with a letter/_`);
+  }
+  return value;
+};
+const indexName = (table, suffix) => validateIdentifier(`${table}_${suffix}`.slice(0, 63), "index name");
+const parseTableUrl = (table_url) => {
+  let parsed;
+  try {
+    parsed = new URL(table_url);
+  } catch {
+    throw new Error(
+      "PostgresEventBridge URL must include at least database in path, e.g. postgresql://user:pass@host:5432/dbname[/tablename]"
+    );
+  }
+  const segments = parsed.pathname.split("/").filter(Boolean);
+  if (segments.length < 1) {
+    throw new Error(
+      "PostgresEventBridge URL must include at least database in path, e.g. postgresql://user:pass@host:5432/dbname[/tablename]"
+    );
+  }
+  const db_name = segments[0];
+  const table = segments.length >= 2 ? validateIdentifier(segments[1], "table name") : DEFAULT_POSTGRES_TABLE;
+  const dsn_url = new URL(parsed.toString());
+  dsn_url.pathname = `/${db_name}`;
+  return { dsn: dsn_url.toString(), table };
+};
+const splitBridgePayload = (payload) => {
+  const event_fields = {};
+  const event_payload = { ...payload };
+  for (const [key, value] of Object.entries(payload)) {
+    if (key.startsWith("event_")) {
+      event_fields[key] = value;
+    }
+  }
+  return { event_fields, event_payload };
+};
+class PostgresEventBridge {
+  table_url;
+  dsn;
+  table;
+  channel;
+  name;
+  inbound_bus;
+  running;
+  client;
+  table_columns;
+  notification_handler;
+  constructor(table_url, channel, name) {
+    (0, import_optional_deps.assertOptionalDependencyAvailable)("PostgresEventBridge", "pg");
+    const parsed = parseTableUrl(table_url);
+    this.table_url = table_url;
+    this.dsn = parsed.dsn;
+    this.table = parsed.table;
+    const derived_channel = channel ?? DEFAULT_POSTGRES_CHANNEL;
+    this.channel = validateIdentifier(derived_channel.slice(0, 63), "channel name");
+    this.name = name ?? `PostgresEventBridge_${randomSuffix()}`;
+    this.inbound_bus = new import_event_bus.EventBus(this.name, { max_history_size: 0 });
+    this.running = false;
+    this.client = null;
+    this.table_columns = /* @__PURE__ */ new Set(["event_id", "event_created_at", "event_type", EVENT_PAYLOAD_COLUMN]);
+    this.notification_handler = null;
+    this.dispatch = this.dispatch.bind(this);
+    this.emit = this.emit.bind(this);
+    this.on = this.on.bind(this);
+  }
+  on(event_pattern, handler) {
+    this.ensureStarted();
+    if (typeof event_pattern === "string") {
+      this.inbound_bus.on(event_pattern, handler);
+      return;
+    }
+    this.inbound_bus.on(event_pattern, handler);
+  }
+  async emit(event) {
+    this.ensureStarted();
+    if (!this.client) await this.start();
+    const payload = event.toJSON();
+    const { event_fields, event_payload } = splitBridgePayload(payload);
+    const write_payload = { ...event_fields, [EVENT_PAYLOAD_COLUMN]: event_payload };
+    const keys = Object.keys(write_payload).sort();
+    await this.ensureColumns(keys);
+    const columns_sql = keys.map((key) => `"${key}"`).join(", ");
+    const placeholders_sql = keys.map((_, index) => `$${index + 1}`).join(", ");
+    const values = keys.map(
+      (key) => write_payload[key] === null || write_payload[key] === void 0 ? null : JSON.stringify(write_payload[key])
+    );
+    const update_fields = keys.filter((key) => key !== "event_id");
+    let upsert_sql = `INSERT INTO "${this.table}" (${columns_sql}) VALUES (${placeholders_sql})`;
+    if (update_fields.length > 0) {
+      const updates_sql = update_fields.map((key) => `"${key}" = EXCLUDED."${key}"`).join(", ");
+      upsert_sql += ` ON CONFLICT ("event_id") DO UPDATE SET ${updates_sql}`;
+    } else {
+      upsert_sql += ' ON CONFLICT ("event_id") DO NOTHING';
+    }
+    await this.client.query(upsert_sql, values);
+    await this.client.query("SELECT pg_notify($1, $2)", [this.channel, JSON.stringify(String(event.event_id))]);
+  }
+  async dispatch(event) {
+    return this.emit(event);
+  }
+  async start() {
+    if (this.running) return;
+    if (!(0, import_optional_deps.isNodeRuntime)()) {
+      throw new Error("PostgresEventBridge is only supported in Node.js runtimes");
+    }
+    const mod = await (0, import_optional_deps.importOptionalDependency)("PostgresEventBridge", "pg");
+    const Client = mod.Client ?? mod.default?.Client;
+    this.client = new Client({ connectionString: this.dsn });
+    this.client.on("error", () => {
+    });
+    await this.client.connect();
+    await this.ensureTableExists();
+    await this.refreshColumnCache();
+    await this.ensureColumns(["event_id", "event_created_at", "event_type", EVENT_PAYLOAD_COLUMN]);
+    await this.ensureBaseIndexes();
+    this.notification_handler = (msg) => {
+      if (msg.channel !== this.channel || !msg.payload) return;
+      void this.dispatchByEventId(msg.payload).catch(() => {
+      });
+    };
+    this.client.on("notification", this.notification_handler);
+    await this.client.query(`LISTEN ${this.channel}`);
+    this.running = true;
+  }
+  async close() {
+    this.running = false;
+    if (this.client) {
+      try {
+        await this.client.query(`UNLISTEN ${this.channel}`);
+      } catch {
+      }
+      if (this.notification_handler) {
+        this.client.off("notification", this.notification_handler);
+        this.notification_handler = null;
+      }
+      await this.client.end();
+      this.client = null;
+    }
+    this.inbound_bus.destroy();
+  }
+  ensureStarted() {
+    if (this.running) return;
+    void this.start().catch((error) => {
+      console.error("[abxbus] PostgresEventBridge failed to start", error);
+    });
+  }
+  async dispatchByEventId(event_id) {
+    if (!this.running || !this.client) return;
+    const result = await this.client.query(`SELECT * FROM "${this.table}" WHERE "event_id" = $1`, [event_id]);
+    const row = result.rows?.[0];
+    if (!row) return;
+    const payload = {};
+    const raw_event_payload = row[EVENT_PAYLOAD_COLUMN];
+    if (typeof raw_event_payload === "string") {
+      try {
+        const decoded_event_payload = JSON.parse(raw_event_payload);
+        if (decoded_event_payload && typeof decoded_event_payload === "object" && !Array.isArray(decoded_event_payload)) {
+          Object.assign(payload, decoded_event_payload);
+        }
+      } catch {
+      }
+    }
+    for (const [key, raw_value] of Object.entries(row)) {
+      if (key === EVENT_PAYLOAD_COLUMN || !key.startsWith("event_")) continue;
+      if (raw_value === null || raw_value === void 0) continue;
+      if (typeof raw_value !== "string") {
+        payload[key] = raw_value;
+        continue;
+      }
+      try {
+        payload[key] = JSON.parse(raw_value);
+      } catch {
+        payload[key] = raw_value;
+      }
+    }
+    await this.dispatchInboundPayload(payload);
+  }
+  async dispatchInboundPayload(payload) {
+    const event = import_base_event.BaseEvent.fromJSON(payload).eventReset();
+    this.inbound_bus.emit(event);
+  }
+  async ensureTableExists() {
+    if (!this.client) return;
+    await this.client.query(
+      `CREATE TABLE IF NOT EXISTS "${this.table}" ("event_id" TEXT PRIMARY KEY, "event_created_at" TEXT, "event_type" TEXT, "event_payload" TEXT)`
+    );
+  }
+  async ensureBaseIndexes() {
+    if (!this.client) return;
+    const event_created_at_idx = indexName(this.table, "event_created_at_idx");
+    const event_type_idx = indexName(this.table, "event_type_idx");
+    await this.client.query(`CREATE INDEX IF NOT EXISTS "${event_created_at_idx}" ON "${this.table}" ("event_created_at")`);
+    await this.client.query(`CREATE INDEX IF NOT EXISTS "${event_type_idx}" ON "${this.table}" ("event_type")`);
+  }
+  async refreshColumnCache() {
+    if (!this.client) return;
+    const result = await this.client.query(
+      `SELECT column_name FROM information_schema.columns WHERE table_schema = 'public' AND table_name = $1`,
+      [this.table]
+    );
+    this.table_columns = new Set(result.rows.map((row) => row.column_name));
+  }
+  async ensureColumns(keys) {
+    if (!this.client) return;
+    for (const key of keys) {
+      validateIdentifier(key, "event field name");
+      if (key !== EVENT_PAYLOAD_COLUMN && !key.startsWith("event_")) {
+        throw new Error(`Invalid event field name for bridge column: ${JSON.stringify(key)}. Only event_* fields become columns`);
+      }
+    }
+    const missing = keys.filter((key) => !this.table_columns.has(key));
+    for (const key of missing) {
+      await this.client.query(`ALTER TABLE "${this.table}" ADD COLUMN IF NOT EXISTS "${key}" TEXT`);
+      this.table_columns.add(key);
+    }
+  }
+}
+//# sourceMappingURL=bridge_postgres.js.map

package/dist/cjs/bridge_postgres.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bridge_postgres.ts"],
+  "sourcesContent": ["/**\n * PostgreSQL LISTEN/NOTIFY + flat-table bridge for forwarding events.\n */\nimport { BaseEvent } from './base_event.js'\nimport { EventBus } from './event_bus.js'\nimport { assertOptionalDependencyAvailable, importOptionalDependency, isNodeRuntime } from './optional_deps.js'\nimport type { EventClass, EventHandlerCallable, EventPattern, UntypedEventHandlerFunction } from './types.js'\n\nconst randomSuffix = (): string => Math.random().toString(36).slice(2, 10)\nconst IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/\nconst DEFAULT_POSTGRES_TABLE = 'abxbus_events'\nconst DEFAULT_POSTGRES_CHANNEL = 'abxbus_events'\nconst EVENT_PAYLOAD_COLUMN = 'event_payload'\n\nconst validateIdentifier = (value: string, label: string): string => {\n  if (!IDENTIFIER_RE.test(value)) {\n    throw new Error(`Invalid ${label}: ${JSON.stringify(value)}. Use only [A-Za-z0-9_] and start with a letter/_`)\n  }\n  return value\n}\n\nconst indexName = (table: string, suffix: string): string => validateIdentifier(`${table}_${suffix}`.slice(0, 63), 'index name')\n\nconst parseTableUrl = (table_url: string): { dsn: string; table: string } => {\n  let parsed: URL\n  try {\n    parsed = new URL(table_url)\n  } catch {\n    throw new Error(\n      'PostgresEventBridge URL must include at least database in path, e.g. postgresql://user:pass@host:5432/dbname[/tablename]'\n    )\n  }\n\n  const segments = parsed.pathname.split('/').filter(Boolean)\n  if (segments.length < 1) {\n    throw new Error(\n      'PostgresEventBridge URL must include at least database in path, e.g. postgresql://user:pass@host:5432/dbname[/tablename]'\n    )\n  }\n\n  const db_name = segments[0]\n  const table = segments.length >= 2 ? validateIdentifier(segments[1], 'table name') : DEFAULT_POSTGRES_TABLE\n  const dsn_url = new URL(parsed.toString())\n  dsn_url.pathname = `/${db_name}`\n  return { dsn: dsn_url.toString(), table }\n}\n\nconst splitBridgePayload = (\n  payload: Record<string, unknown>\n): { event_fields: Record<string, unknown>; event_payload: Record<string, unknown> } => {\n  const event_fields: Record<string, unknown> = {}\n  const event_payload: Record<string, unknown> = { ...payload }\n  for (const [key, value] of Object.entries(payload)) {\n    if (key.startsWith('event_')) {\n      event_fields[key] = value\n    }\n  }\n  return { event_fields, event_payload }\n}\n\nexport class PostgresEventBridge {\n  readonly table_url: string\n  readonly dsn: string\n  readonly table: string\n  readonly channel: string\n  readonly name: string\n\n  private readonly inbound_bus: EventBus\n  private running: boolean\n  private client: any | null\n  private table_columns: Set<string>\n  private notification_handler: ((msg: { channel: string; payload?: string }) => void) | null\n\n  constructor(table_url: string, channel?: string, name?: string) {\n    assertOptionalDependencyAvailable('PostgresEventBridge', 'pg')\n\n    const parsed = parseTableUrl(table_url)\n    this.table_url = table_url\n    this.dsn = parsed.dsn\n    this.table = parsed.table\n\n    const derived_channel = channel ?? DEFAULT_POSTGRES_CHANNEL\n    this.channel = validateIdentifier(derived_channel.slice(0, 63), 'channel name')\n    this.name = name ?? `PostgresEventBridge_${randomSuffix()}`\n\n    this.inbound_bus = new EventBus(this.name, { max_history_size: 0 })\n    this.running = false\n    this.client = null\n    this.table_columns = new Set(['event_id', 'event_created_at', 'event_type', EVENT_PAYLOAD_COLUMN])\n    this.notification_handler = null\n\n    this.dispatch = this.dispatch.bind(this)\n    this.emit = this.emit.bind(this)\n    this.on = this.on.bind(this)\n  }\n\n  on<T extends BaseEvent>(event_pattern: EventClass<T>, handler: EventHandlerCallable<T>): void\n  on<T extends BaseEvent>(event_pattern: string | '*', handler: UntypedEventHandlerFunction<T>): void\n  on(event_pattern: EventPattern | '*', handler: EventHandlerCallable | UntypedEventHandlerFunction): void {\n    this.ensureStarted()\n    if (typeof event_pattern === 'string') {\n      this.inbound_bus.on(event_pattern, handler as UntypedEventHandlerFunction<BaseEvent>)\n      return\n    }\n    this.inbound_bus.on(event_pattern as EventClass<BaseEvent>, handler as EventHandlerCallable<BaseEvent>)\n  }\n\n  async emit<T extends BaseEvent>(event: T): Promise<void> {\n    this.ensureStarted()\n    if (!this.client) await this.start()\n\n    const payload = event.toJSON() as Record<string, unknown>\n    const { event_fields, event_payload } = splitBridgePayload(payload)\n    const write_payload: Record<string, unknown> = { ...event_fields, [EVENT_PAYLOAD_COLUMN]: event_payload }\n    const keys = Object.keys(write_payload).sort()\n    await this.ensureColumns(keys)\n\n    const columns_sql = keys.map((key) => `\"${key}\"`).join(', ')\n    const placeholders_sql = keys.map((_, index) => `$${index + 1}`).join(', ')\n    const values = keys.map((key) =>\n      write_payload[key] === null || write_payload[key] === undefined ? null : JSON.stringify(write_payload[key])\n    )\n\n    const update_fields = keys.filter((key) => key !== 'event_id')\n    let upsert_sql = `INSERT INTO \"${this.table}\" (${columns_sql}) VALUES (${placeholders_sql})`\n    if (update_fields.length > 0) {\n      const updates_sql = update_fields.map((key) => `\"${key}\" = EXCLUDED.\"${key}\"`).join(', ')\n      upsert_sql += ` ON CONFLICT (\"event_id\") DO UPDATE SET ${updates_sql}`\n    } else {\n      upsert_sql += ' ON CONFLICT (\"event_id\") DO NOTHING'\n    }\n\n    await this.client.query(upsert_sql, values)\n    await this.client.query('SELECT pg_notify($1, $2)', [this.channel, JSON.stringify(String(event.event_id))])\n  }\n\n  async dispatch<T extends BaseEvent>(event: T): Promise<void> {\n    return this.emit(event)\n  }\n\n  async start(): Promise<void> {\n    if (this.running) return\n    if (!isNodeRuntime()) {\n      throw new Error('PostgresEventBridge is only supported in Node.js runtimes')\n    }\n\n    const mod = await importOptionalDependency('PostgresEventBridge', 'pg')\n    const Client = mod.Client ?? mod.default?.Client\n    this.client = new Client({ connectionString: this.dsn })\n    this.client.on('error', () => {})\n    await this.client.connect()\n\n    await this.ensureTableExists()\n    await this.refreshColumnCache()\n    await this.ensureColumns(['event_id', 'event_created_at', 'event_type', EVENT_PAYLOAD_COLUMN])\n    await this.ensureBaseIndexes()\n\n    this.notification_handler = (msg: { channel: string; payload?: string }) => {\n      if (msg.channel !== this.channel || !msg.payload) return\n      void this.dispatchByEventId(msg.payload).catch(() => {\n        // Ignore transient shutdown races while closing connections.\n      })\n    }\n\n    this.client.on('notification', this.notification_handler)\n    await this.client.query(`LISTEN ${this.channel}`)\n    this.running = true\n  }\n\n  async close(): Promise<void> {\n    this.running = false\n    if (this.client) {\n      try {\n        await this.client.query(`UNLISTEN ${this.channel}`)\n      } catch {\n        // ignore\n      }\n      if (this.notification_handler) {\n        this.client.off('notification', this.notification_handler)\n        this.notification_handler = null\n      }\n      await this.client.end()\n      this.client = null\n    }\n    this.inbound_bus.destroy()\n  }\n\n  private ensureStarted(): void {\n    if (this.running) return\n    void this.start().catch((error: unknown) => {\n      console.error('[abxbus] PostgresEventBridge failed to start', error)\n    })\n  }\n\n  private async dispatchByEventId(event_id: string): Promise<void> {\n    if (!this.running || !this.client) return\n    const result = await this.client.query(`SELECT * FROM \"${this.table}\" WHERE \"event_id\" = $1`, [event_id])\n    const row = result.rows?.[0] as Record<string, unknown> | undefined\n    if (!row) return\n\n    const payload: Record<string, unknown> = {}\n    const raw_event_payload = row[EVENT_PAYLOAD_COLUMN]\n    if (typeof raw_event_payload === 'string') {\n      try {\n        const decoded_event_payload = JSON.parse(raw_event_payload)\n        if (decoded_event_payload && typeof decoded_event_payload === 'object' && !Array.isArray(decoded_event_payload)) {\n          Object.assign(payload, decoded_event_payload as Record<string, unknown>)\n        }\n      } catch {\n        // ignore malformed payload column\n      }\n    }\n\n    for (const [key, raw_value] of Object.entries(row)) {\n      if (key === EVENT_PAYLOAD_COLUMN || !key.startsWith('event_')) continue\n      if (raw_value === null || raw_value === undefined) continue\n      if (typeof raw_value !== 'string') {\n        payload[key] = raw_value\n        continue\n      }\n      try {\n        payload[key] = JSON.parse(raw_value)\n      } catch {\n        payload[key] = raw_value\n      }\n    }\n\n    await this.dispatchInboundPayload(payload)\n  }\n\n  private async dispatchInboundPayload(payload: unknown): Promise<void> {\n    const event = BaseEvent.fromJSON(payload).eventReset()\n    this.inbound_bus.emit(event)\n  }\n\n  private async ensureTableExists(): Promise<void> {\n    if (!this.client) return\n    await this.client.query(\n      `CREATE TABLE IF NOT EXISTS \"${this.table}\" (\"event_id\" TEXT PRIMARY KEY, \"event_created_at\" TEXT, \"event_type\" TEXT, \"event_payload\" TEXT)`\n    )\n  }\n\n  private async ensureBaseIndexes(): Promise<void> {\n    if (!this.client) return\n\n    const event_created_at_idx = indexName(this.table, 'event_created_at_idx')\n    const event_type_idx = indexName(this.table, 'event_type_idx')\n\n    await this.client.query(`CREATE INDEX IF NOT EXISTS \"${event_created_at_idx}\" ON \"${this.table}\" (\"event_created_at\")`)\n    await this.client.query(`CREATE INDEX IF NOT EXISTS \"${event_type_idx}\" ON \"${this.table}\" (\"event_type\")`)\n  }\n\n  private async refreshColumnCache(): Promise<void> {\n    if (!this.client) return\n    const result = await this.client.query(\n      `SELECT column_name FROM information_schema.columns WHERE table_schema = 'public' AND table_name = $1`,\n      [this.table]\n    )\n    this.table_columns = new Set((result.rows as Array<{ column_name: string }>).map((row) => row.column_name))\n  }\n\n  private async ensureColumns(keys: string[]): Promise<void> {\n    if (!this.client) return\n    for (const key of keys) {\n      validateIdentifier(key, 'event field name')\n      if (key !== EVENT_PAYLOAD_COLUMN && !key.startsWith('event_')) {\n        throw new Error(`Invalid event field name for bridge column: ${JSON.stringify(key)}. Only event_* fields become columns`)\n      }\n    }\n\n    const missing = keys.filter((key) => !this.table_columns.has(key))\n    for (const key of missing) {\n      await this.client.query(`ALTER TABLE \"${this.table}\" ADD COLUMN IF NOT EXISTS \"${key}\" TEXT`)\n      this.table_columns.add(key)\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/bridge_redis.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Redis pub/sub bridge for forwarding events between runtimes.
+ *
+ * Usage:
+ *   // channel from URL path
+ *   const bridge = new RedisEventBridge('redis://user:pass@localhost:6379/1/my_channel')
+ *
+ *   // explicit channel override
+ *   const bridge2 = new RedisEventBridge('redis://user:pass@localhost:6379/1', 'my_channel')
+ *
+ * URL format:
+ *   redis://user:pass@host:6379/<db>/<optional_channel>
+ */
+import { BaseEvent } from './base_event.js';
+import type { EventClass, EventHandlerCallable, UntypedEventHandlerFunction } from './types.js';
+export declare class RedisEventBridge {
+    readonly url: string;
+    readonly channel: string;
+    readonly name: string;
+    private readonly inbound_bus;
+    private running;
+    private start_promise;
+    private redis_pub;
+    private redis_sub;
+    constructor(redis_url: string, channel?: string, name?: string);
+    on<T extends BaseEvent>(event_pattern: EventClass<T>, handler: EventHandlerCallable<T>): void;
+    on<T extends BaseEvent>(event_pattern: string | '*', handler: UntypedEventHandlerFunction<T>): void;
+    emit<T extends BaseEvent>(event: T): Promise<void>;
+    dispatch<T extends BaseEvent>(event: T): Promise<void>;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    private ensureStarted;
+    private dispatchInboundPayload;
+}

package/dist/cjs/bridge_redis.js

@@ -0,0 +1,175 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var bridge_redis_exports = {};
+__export(bridge_redis_exports, {
+  RedisEventBridge: () => RedisEventBridge
+});
+module.exports = __toCommonJS(bridge_redis_exports);
+var import_base_event = require("./base_event.js");
+var import_event_bus = require("./event_bus.js");
+var import_optional_deps = require("./optional_deps.js");
+const randomSuffix = () => Math.random().toString(36).slice(2, 10);
+const DEFAULT_REDIS_CHANNEL = "abxbus_events";
+const DB_INIT_KEY = "__abxbus:bridge_init__";
+const parseRedisUrl = (redis_url, channel) => {
+  let parsed;
+  try {
+    parsed = new URL(redis_url);
+  } catch {
+    throw new Error(`RedisEventBridge URL must be a valid redis:// or rediss:// URL, got: ${redis_url}`);
+  }
+  const protocol = parsed.protocol.replace(/:$/, "").toLowerCase();
+  if (protocol !== "redis" && protocol !== "rediss") {
+    throw new Error(`RedisEventBridge URL must use redis:// or rediss://, got: ${redis_url}`);
+  }
+  const segments = parsed.pathname.split("/").filter(Boolean);
+  if (segments.length > 2) {
+    throw new Error(`RedisEventBridge URL path must be /<db> or /<db>/<channel>, got: ${parsed.pathname || "/"}`);
+  }
+  let db_index = "0";
+  let channel_from_url;
+  if (segments.length > 0) {
+    db_index = segments[0];
+    if (!/^\d+$/.test(db_index)) {
+      throw new Error(`RedisEventBridge URL db path segment must be numeric, got: ${JSON.stringify(db_index)} in ${redis_url}`);
+    }
+    if (segments.length === 2) {
+      channel_from_url = segments[1];
+    }
+  }
+  const resolved_channel = channel ?? channel_from_url ?? DEFAULT_REDIS_CHANNEL;
+  if (!resolved_channel) {
+    throw new Error("RedisEventBridge channel must not be empty");
+  }
+  const normalized = new URL(parsed.toString());
+  normalized.pathname = `/${db_index}`;
+  return { url: normalized.toString(), channel: resolved_channel };
+};
+class RedisEventBridge {
+  url;
+  channel;
+  name;
+  inbound_bus;
+  running;
+  start_promise;
+  redis_pub;
+  redis_sub;
+  constructor(redis_url, channel, name) {
+    (0, import_optional_deps.assertOptionalDependencyAvailable)("RedisEventBridge", "ioredis");
+    const parsed = parseRedisUrl(redis_url, channel);
+    this.url = parsed.url;
+    this.channel = parsed.channel;
+    this.name = name ?? `RedisEventBridge_${randomSuffix()}`;
+    this.inbound_bus = new import_event_bus.EventBus(this.name, { max_history_size: 0 });
+    this.running = false;
+    this.start_promise = null;
+    this.redis_pub = null;
+    this.redis_sub = null;
+    this.dispatch = this.dispatch.bind(this);
+    this.emit = this.emit.bind(this);
+    this.on = this.on.bind(this);
+  }
+  on(event_pattern, handler) {
+    this.ensureStarted();
+    if (typeof event_pattern === "string") {
+      this.inbound_bus.on(event_pattern, handler);
+      return;
+    }
+    this.inbound_bus.on(event_pattern, handler);
+  }
+  async emit(event) {
+    this.ensureStarted();
+    if (!this.redis_pub) await this.start();
+    const payload = JSON.stringify(event.toJSON());
+    await this.redis_pub.publish(this.channel, payload);
+  }
+  async dispatch(event) {
+    return this.emit(event);
+  }
+  async start() {
+    if (this.running) return;
+    if (this.start_promise) {
+      await this.start_promise;
+      return;
+    }
+    this.start_promise = (async () => {
+      if (!(0, import_optional_deps.isNodeRuntime)()) {
+        throw new Error("RedisEventBridge is only supported in Node.js runtimes");
+      }
+      const mod = await (0, import_optional_deps.importOptionalDependency)("RedisEventBridge", "ioredis");
+      const Redis = mod.default ?? mod.Redis ?? mod;
+      const redis_pub = new Redis(this.url);
+      const redis_sub = new Redis(this.url);
+      redis_pub.on("error", () => {
+      });
+      redis_sub.on("error", () => {
+      });
+      await redis_pub.set(DB_INIT_KEY, "1", "EX", 60, "NX");
+      redis_sub.on("message", (channel_name, message) => {
+        if (channel_name !== this.channel) return;
+        try {
+          const payload = JSON.parse(message);
+          void this.dispatchInboundPayload(payload);
+        } catch {
+        }
+      });
+      await redis_sub.subscribe(this.channel);
+      this.redis_pub = redis_pub;
+      this.redis_sub = redis_sub;
+      this.running = true;
+    })();
+    try {
+      await this.start_promise;
+    } finally {
+      this.start_promise = null;
+    }
+  }
+  async close() {
+    if (this.start_promise) {
+      await this.start_promise.catch(() => {
+      });
+    }
+    this.running = false;
+    if (this.redis_sub) {
+      try {
+        await this.redis_sub.unsubscribe(this.channel);
+      } catch {
+      }
+      await this.redis_sub.quit();
+      this.redis_sub = null;
+    }
+    if (this.redis_pub) {
+      await this.redis_pub.quit();
+      this.redis_pub = null;
+    }
+    this.inbound_bus.destroy();
+  }
+  ensureStarted() {
+    if (this.running) return;
+    if (this.start_promise) return;
+    void this.start().catch((error) => {
+      console.error("[abxbus] RedisEventBridge failed to start", error);
+    });
+  }
+  async dispatchInboundPayload(payload) {
+    const event = import_base_event.BaseEvent.fromJSON(payload).eventReset();
+    this.inbound_bus.emit(event);
+  }
+}
+//# sourceMappingURL=bridge_redis.js.map

package/dist/cjs/bridge_redis.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bridge_redis.ts"],
+  "sourcesContent": ["/**\n * Redis pub/sub bridge for forwarding events between runtimes.\n *\n * Usage:\n *   // channel from URL path\n *   const bridge = new RedisEventBridge('redis://user:pass@localhost:6379/1/my_channel')\n *\n *   // explicit channel override\n *   const bridge2 = new RedisEventBridge('redis://user:pass@localhost:6379/1', 'my_channel')\n *\n * URL format:\n *   redis://user:pass@host:6379/<db>/<optional_channel>\n */\nimport { BaseEvent } from './base_event.js'\nimport { EventBus } from './event_bus.js'\nimport { assertOptionalDependencyAvailable, importOptionalDependency, isNodeRuntime } from './optional_deps.js'\nimport type { EventClass, EventHandlerCallable, EventPattern, UntypedEventHandlerFunction } from './types.js'\n\nconst randomSuffix = (): string => Math.random().toString(36).slice(2, 10)\nconst DEFAULT_REDIS_CHANNEL = 'abxbus_events'\nconst DB_INIT_KEY = '__abxbus:bridge_init__'\n\nconst parseRedisUrl = (redis_url: string, channel?: string): { url: string; channel: string } => {\n  let parsed: URL\n  try {\n    parsed = new URL(redis_url)\n  } catch {\n    throw new Error(`RedisEventBridge URL must be a valid redis:// or rediss:// URL, got: ${redis_url}`)\n  }\n\n  const protocol = parsed.protocol.replace(/:$/, '').toLowerCase()\n  if (protocol !== 'redis' && protocol !== 'rediss') {\n    throw new Error(`RedisEventBridge URL must use redis:// or rediss://, got: ${redis_url}`)\n  }\n\n  const segments = parsed.pathname.split('/').filter(Boolean)\n  if (segments.length > 2) {\n    throw new Error(`RedisEventBridge URL path must be /<db> or /<db>/<channel>, got: ${parsed.pathname || '/'}`)\n  }\n\n  let db_index = '0'\n  let channel_from_url: string | undefined\n\n  if (segments.length > 0) {\n    db_index = segments[0]\n    if (!/^\\d+$/.test(db_index)) {\n      throw new Error(`RedisEventBridge URL db path segment must be numeric, got: ${JSON.stringify(db_index)} in ${redis_url}`)\n    }\n    if (segments.length === 2) {\n      channel_from_url = segments[1]\n    }\n  }\n\n  const resolved_channel = channel ?? channel_from_url ?? DEFAULT_REDIS_CHANNEL\n  if (!resolved_channel) {\n    throw new Error('RedisEventBridge channel must not be empty')\n  }\n\n  const normalized = new URL(parsed.toString())\n  normalized.pathname = `/${db_index}`\n  return { url: normalized.toString(), channel: resolved_channel }\n}\n\nexport class RedisEventBridge {\n  readonly url: string\n  readonly channel: string\n  readonly name: string\n\n  private readonly inbound_bus: EventBus\n  private running: boolean\n  private start_promise: Promise<void> | null\n  private redis_pub: any | null\n  private redis_sub: any | null\n\n  constructor(redis_url: string, channel?: string, name?: string) {\n    assertOptionalDependencyAvailable('RedisEventBridge', 'ioredis')\n\n    const parsed = parseRedisUrl(redis_url, channel)\n    this.url = parsed.url\n    this.channel = parsed.channel\n    this.name = name ?? `RedisEventBridge_${randomSuffix()}`\n    this.inbound_bus = new EventBus(this.name, { max_history_size: 0 })\n    this.running = false\n    this.start_promise = null\n    this.redis_pub = null\n    this.redis_sub = null\n\n    this.dispatch = this.dispatch.bind(this)\n    this.emit = this.emit.bind(this)\n    this.on = this.on.bind(this)\n  }\n\n  on<T extends BaseEvent>(event_pattern: EventClass<T>, handler: EventHandlerCallable<T>): void\n  on<T extends BaseEvent>(event_pattern: string | '*', handler: UntypedEventHandlerFunction<T>): void\n  on(event_pattern: EventPattern | '*', handler: EventHandlerCallable | UntypedEventHandlerFunction): void {\n    this.ensureStarted()\n    if (typeof event_pattern === 'string') {\n      this.inbound_bus.on(event_pattern, handler as UntypedEventHandlerFunction<BaseEvent>)\n      return\n    }\n    this.inbound_bus.on(event_pattern as EventClass<BaseEvent>, handler as EventHandlerCallable<BaseEvent>)\n  }\n\n  async emit<T extends BaseEvent>(event: T): Promise<void> {\n    this.ensureStarted()\n    if (!this.redis_pub) await this.start()\n    const payload = JSON.stringify(event.toJSON())\n    await this.redis_pub.publish(this.channel, payload)\n  }\n\n  async dispatch<T extends BaseEvent>(event: T): Promise<void> {\n    return this.emit(event)\n  }\n\n  async start(): Promise<void> {\n    if (this.running) return\n    if (this.start_promise) {\n      await this.start_promise\n      return\n    }\n\n    // `on(...)` auto-start and explicit `await start()` can happen back-to-back; use one in-flight\n    // startup promise so we do not leak extra Redis clients.\n    this.start_promise = (async () => {\n      if (!isNodeRuntime()) {\n        throw new Error('RedisEventBridge is only supported in Node.js runtimes')\n      }\n\n      const mod = await importOptionalDependency('RedisEventBridge', 'ioredis')\n      const Redis = mod.default ?? mod.Redis ?? mod\n      const redis_pub = new Redis(this.url)\n      const redis_sub = new Redis(this.url)\n\n      redis_pub.on('error', () => {})\n      redis_sub.on('error', () => {})\n\n      // Redis logical DBs are created lazily; writing a short-lived key initializes/validates the selected DB.\n      await redis_pub.set(DB_INIT_KEY, '1', 'EX', 60, 'NX')\n      redis_sub.on('message', (channel_name: string, message: string) => {\n        if (channel_name !== this.channel) return\n        try {\n          const payload = JSON.parse(message)\n          void this.dispatchInboundPayload(payload)\n        } catch {\n          // Ignore malformed payloads.\n        }\n      })\n      await redis_sub.subscribe(this.channel)\n      this.redis_pub = redis_pub\n      this.redis_sub = redis_sub\n      this.running = true\n    })()\n\n    try {\n      await this.start_promise\n    } finally {\n      this.start_promise = null\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.start_promise) {\n      await this.start_promise.catch(() => {})\n    }\n    this.running = false\n    if (this.redis_sub) {\n      try {\n        await this.redis_sub.unsubscribe(this.channel)\n      } catch {\n        // ignore\n      }\n      await this.redis_sub.quit()\n      this.redis_sub = null\n    }\n    if (this.redis_pub) {\n      await this.redis_pub.quit()\n      this.redis_pub = null\n    }\n    this.inbound_bus.destroy()\n  }\n\n  private ensureStarted(): void {\n    if (this.running) return\n    if (this.start_promise) return\n    void this.start().catch((error: unknown) => {\n      console.error('[abxbus] RedisEventBridge failed to start', error)\n    })\n  }\n\n  private async dispatchInboundPayload(payload: unknown): Promise<void> {\n    const event = BaseEvent.fromJSON(payload).eventReset()\n    this.inbound_bus.emit(event)\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/bridge_sqlite.d.ts

@@ -0,0 +1,30 @@
+import { BaseEvent } from './base_event.js';
+import type { EventClass, EventHandlerCallable, UntypedEventHandlerFunction } from './types.js';
+export declare class SQLiteEventBridge {
+    readonly path: string;
+    readonly table: string;
+    readonly poll_interval: number;
+    readonly name: string;
+    private readonly inbound_bus;
+    private running;
+    private last_seen_event_created_at;
+    private last_seen_event_id;
+    private listener_task;
+    private start_task;
+    private db;
+    private table_columns;
+    constructor(path: string, table?: string, poll_interval?: number, name?: string);
+    on<T extends BaseEvent>(event_pattern: EventClass<T>, handler: EventHandlerCallable<T>): void;
+    on<T extends BaseEvent>(event_pattern: string | '*', handler: UntypedEventHandlerFunction<T>): void;
+    emit<T extends BaseEvent>(event: T): Promise<void>;
+    dispatch<T extends BaseEvent>(event: T): Promise<void>;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    private ensureStarted;
+    private listenLoop;
+    private dispatchInboundPayload;
+    private refreshColumnCache;
+    private ensureColumns;
+    private ensureBaseIndexes;
+    private setCursorToLatestRow;
+}