abxbus 2.4.1

package/dist/cjs/bridges.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bridges.ts"],
+  "sourcesContent": ["import { BaseEvent } from './base_event.js'\nimport { EventBus } from './event_bus.js'\nimport type { EventClass, EventHandlerCallable, EventPattern, UntypedEventHandlerFunction } from './types.js'\n\ntype EndpointScheme = 'unix' | 'http' | 'https'\n\ntype ParsedEndpoint = {\n  raw: string\n  scheme: EndpointScheme\n  host?: string\n  port?: number\n  path?: string\n}\n\nexport type HTTPEventBridgeOptions = {\n  send_to?: string | null\n  listen_on?: string | null\n  name?: string\n}\n\nconst isNodeRuntime = (): boolean => {\n  const maybe_process = (globalThis as { process?: { versions?: { node?: string } } }).process\n  return typeof maybe_process?.versions?.node === 'string'\n}\n\nconst isBrowserRuntime = (): boolean => !isNodeRuntime() && typeof globalThis.window !== 'undefined'\n\nconst randomSuffix = (): string => Math.random().toString(36).slice(2, 10)\nconst UNIX_SOCKET_MAX_PATH_CHARS = 90\n\nconst parseEndpoint = (raw_endpoint: string): ParsedEndpoint => {\n  let parsed: URL\n  try {\n    parsed = new URL(raw_endpoint)\n  } catch {\n    throw new Error(`Invalid endpoint URL: ${raw_endpoint}`)\n  }\n\n  const protocol = parsed.protocol.replace(/:$/, '').toLowerCase()\n  if (protocol !== 'unix' && protocol !== 'http' && protocol !== 'https') {\n    throw new Error(`Unsupported endpoint scheme: ${raw_endpoint}`)\n  }\n\n  if (protocol === 'unix') {\n    const socket_path = decodeURIComponent(parsed.pathname || '')\n    if (!socket_path) {\n      throw new Error(`Invalid unix endpoint (missing socket path): ${raw_endpoint}`)\n    }\n    const socket_path_len = new TextEncoder().encode(socket_path).length\n    if (socket_path_len > UNIX_SOCKET_MAX_PATH_CHARS) {\n      throw new Error(`Unix socket path is too long (${socket_path_len} chars), max is ${UNIX_SOCKET_MAX_PATH_CHARS}: ${socket_path}`)\n    }\n    return { raw: raw_endpoint, scheme: 'unix', path: socket_path }\n  }\n\n  if (!parsed.hostname) {\n    throw new Error(`Invalid HTTP endpoint (missing hostname): ${raw_endpoint}`)\n  }\n\n  const default_port = protocol === 'https' ? 443 : 80\n  return {\n    raw: raw_endpoint,\n    scheme: protocol,\n    host: parsed.hostname,\n    port: parsed.port ? Number(parsed.port) : default_port,\n    path: `${parsed.pathname || '/'}${parsed.search || ''}`,\n  }\n}\n\nconst importNodeModule = async (specifier: string): Promise<any> => {\n  const dynamic_import = Function('module_name', 'return import(module_name)') as (module_name: string) => Promise<unknown>\n  return dynamic_import(specifier) as Promise<any>\n}\n\nclass _EventBridge {\n  readonly send_to: ParsedEndpoint | null\n  readonly listen_on: ParsedEndpoint | null\n  readonly name: string\n\n  protected readonly inbound_bus: EventBus\n  private start_promise: Promise<void> | null\n  private node_server: any | null\n\n  constructor(send_to?: string | null, listen_on?: string | null, name?: string) {\n    this.send_to = send_to ? parseEndpoint(send_to) : null\n    this.listen_on = listen_on ? parseEndpoint(listen_on) : null\n    this.name = name ?? `EventBridge_${randomSuffix()}`\n    this.inbound_bus = new EventBus(this.name, { max_history_size: 0 })\n    this.start_promise = null\n    this.node_server = null\n\n    if (this.listen_on && isBrowserRuntime()) {\n      throw new Error(`${this.constructor.name} listen_on is not supported in browser runtimes`)\n    }\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.ensureListenerStarted()\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    if (!this.send_to) {\n      throw new Error(`${this.constructor.name}.emit() requires send_to`)\n    }\n\n    const payload = event.toJSON()\n\n    if (this.send_to.scheme === 'unix') {\n      await this.sendUnix(this.send_to, payload)\n      return\n    }\n\n    await this.sendHttp(this.send_to, 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.listen_on) return\n    if (this.node_server) return\n    if (this.start_promise) {\n      await this.start_promise\n      return\n    }\n\n    if (!isNodeRuntime()) {\n      throw new Error(`${this.constructor.name} listen_on is only supported in Node.js runtimes`)\n    }\n\n    const launch = (async () => {\n      const endpoint = this.listen_on\n      if (!endpoint) return\n\n      if (endpoint.scheme === 'unix') {\n        await this.startUnixListener(endpoint)\n        return\n      }\n\n      if (endpoint.scheme !== 'http') {\n        throw new Error(`listen_on only supports unix:// or http:// endpoints, got: ${endpoint.raw}`)\n      }\n\n      await this.startHttpListener(endpoint)\n    })()\n    this.start_promise = launch\n\n    try {\n      await launch\n    } finally {\n      if (this.start_promise === launch) {\n        this.start_promise = null\n      }\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.start_promise) {\n      await Promise.allSettled([this.start_promise])\n      this.start_promise = null\n    }\n\n    if (this.node_server) {\n      const server = this.node_server\n      await new Promise<void>((resolve) => {\n        server.close(() => resolve())\n      })\n      this.node_server = null\n    }\n\n    this.inbound_bus.destroy()\n  }\n\n  private ensureListenerStarted(): void {\n    if (!this.listen_on || this.node_server || this.start_promise) {\n      return\n    }\n    void this.start().catch((error: unknown) => {\n      console.error('[abxbus] EventBridge failed to start listener', error)\n    })\n  }\n\n  private async handleIncomingPayload(payload: unknown): Promise<void> {\n    const event = BaseEvent.fromJSON(payload).eventReset()\n    this.inbound_bus.emit(event)\n  }\n\n  private async sendHttp(endpoint: ParsedEndpoint, payload: unknown): Promise<void> {\n    const response = await fetch(endpoint.raw, {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify(payload),\n    })\n    if (!response.ok) {\n      throw new Error(`IPC HTTP send failed with status ${response.status}: ${endpoint.raw}`)\n    }\n  }\n\n  private async sendUnix(endpoint: ParsedEndpoint, payload: unknown): Promise<void> {\n    if (!isNodeRuntime()) {\n      throw new Error('unix:// send_to is only supported in Node.js runtimes')\n    }\n\n    const socket_path = endpoint.path\n    if (!socket_path) {\n      throw new Error(`Invalid unix endpoint: ${endpoint.raw}`)\n    }\n\n    const node_net = await importNodeModule('node:net')\n    await new Promise<void>((resolve, reject) => {\n      const socket = node_net.createConnection(socket_path, () => {\n        socket.end(`${JSON.stringify(payload)}\\n`)\n      })\n      socket.on('error', (error: unknown) => reject(error))\n      socket.on('close', () => resolve())\n    })\n  }\n\n  private async startHttpListener(endpoint: ParsedEndpoint): Promise<void> {\n    const node_http = await importNodeModule('node:http')\n    const expected_path = endpoint.path || '/'\n\n    this.node_server = node_http.createServer((req: any, res: any) => {\n      const method = (req.method || '').toUpperCase()\n      const request_url = String(req.url || '/')\n\n      if (method !== 'POST') {\n        res.statusCode = 405\n        res.end('method not allowed')\n        return\n      }\n      if (request_url !== expected_path) {\n        res.statusCode = 404\n        res.end('not found')\n        return\n      }\n\n      let body = ''\n      req.setEncoding('utf8')\n      req.on('data', (chunk: string) => {\n        body += chunk\n      })\n      req.on('end', () => {\n        let parsed_payload: unknown\n        try {\n          parsed_payload = JSON.parse(body)\n        } catch {\n          res.statusCode = 400\n          res.end('invalid json')\n          return\n        }\n\n        void this.handleIncomingPayload(parsed_payload)\n          .then(() => {\n            res.statusCode = 202\n            res.end('accepted')\n          })\n          .catch((error: unknown) => {\n            res.statusCode = 500\n            res.end('failed to process event')\n            console.error('[abxbus] EventBridge HTTP listener error', error)\n          })\n      })\n    })\n\n    await new Promise<void>((resolve, reject) => {\n      this.node_server.once('error', (error: unknown) => reject(error))\n      this.node_server.listen(endpoint.port, endpoint.host, () => resolve())\n    })\n  }\n\n  private async startUnixListener(endpoint: ParsedEndpoint): Promise<void> {\n    const socket_path = endpoint.path\n    if (!socket_path) {\n      throw new Error(`Invalid unix endpoint: ${endpoint.raw}`)\n    }\n\n    const node_net = await importNodeModule('node:net')\n    const node_fs = await importNodeModule('node:fs')\n\n    try {\n      await node_fs.promises.unlink(socket_path)\n    } catch (error: unknown) {\n      const code = (error as { code?: string }).code\n      if (code !== 'ENOENT') {\n        throw error\n      }\n    }\n\n    this.node_server = node_net.createServer((socket: any) => {\n      let buffer = ''\n      socket.setEncoding('utf8')\n      socket.on('data', (chunk: string) => {\n        buffer += chunk\n        while (true) {\n          const newline_index = buffer.indexOf('\\n')\n          if (newline_index < 0) break\n          const line = buffer.slice(0, newline_index).trim()\n          buffer = buffer.slice(newline_index + 1)\n          if (!line) continue\n          try {\n            const parsed_payload = JSON.parse(line)\n            void this.handleIncomingPayload(parsed_payload)\n          } catch {\n            // Ignore malformed lines and continue reading next frames.\n          }\n        }\n      })\n      socket.on('end', () => {\n        const remainder = buffer.trim()\n        if (!remainder) return\n        try {\n          const parsed_payload = JSON.parse(remainder)\n          void this.handleIncomingPayload(parsed_payload)\n        } catch {\n          // Ignore malformed trailing frame.\n        }\n      })\n    })\n\n    await new Promise<void>((resolve, reject) => {\n      this.node_server.once('error', (error: unknown) => reject(error))\n      this.node_server.listen(socket_path, () => resolve())\n    })\n  }\n}\n\nexport class HTTPEventBridge extends _EventBridge {\n  constructor(send_to?: string | null, listen_on?: string | null, name?: string)\n  constructor(options?: HTTPEventBridgeOptions)\n  constructor(send_to_or_options?: string | null | HTTPEventBridgeOptions, listen_on?: string | null, name?: string) {\n    const options: HTTPEventBridgeOptions =\n      typeof send_to_or_options === 'object'\n        ? (send_to_or_options ?? {})\n        : { send_to: send_to_or_options ?? undefined, listen_on: listen_on ?? undefined, name }\n\n    if (options.send_to && parseEndpoint(options.send_to).scheme === 'unix') {\n      throw new Error('HTTPEventBridge send_to must be http:// or https://')\n    }\n    if (options.listen_on && parseEndpoint(options.listen_on).scheme !== 'http') {\n      throw new Error('HTTPEventBridge listen_on must be http://')\n    }\n\n    super(options.send_to, options.listen_on, options.name ?? `HTTPEventBridge_${randomSuffix()}`)\n  }\n}\n\nexport class SocketEventBridge extends _EventBridge {\n  constructor(path?: string | null, name?: string) {\n    const normalized = path ? (path.startsWith('unix://') ? path.slice(7) : path) : null\n    if (normalized === '') {\n      throw new Error('SocketEventBridge path must not be empty')\n    }\n\n    const endpoint = normalized ? `unix://${normalized}` : null\n    super(endpoint, endpoint, name ?? `SocketEventBridge_${randomSuffix()}`)\n  }\n}\n\nexport { NATSEventBridge } from './bridge_nats.js'\nexport { RedisEventBridge } from './bridge_redis.js'\nexport { PostgresEventBridge } from './bridge_postgres.js'\nexport { JSONLEventBridge } from './bridge_jsonl.js'\nexport { SQLiteEventBridge } from './bridge_sqlite.js'\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/event_bus.d.ts

@@ -0,0 +1,127 @@
+import { BaseEvent, type BaseEventJSON } from './base_event.js';
+import { EventHistory } from './event_history.js';
+import { EventResult } from './event_result.js';
+import { AsyncLock, type EventConcurrencyMode, type EventHandlerConcurrencyMode, type EventHandlerCompletionMode, LockManager } from './lock_manager.js';
+import { EventHandler, type EphemeralFindEventHandler, type EventHandlerJSON } from './event_handler.js';
+import type { EventBusMiddleware, EventBusMiddlewareInput } from './middlewares.js';
+import type { EventClass, EventHandlerCallable, EventPattern, FindOptions, UntypedEventHandlerFunction } from './types.js';
+export type EventBusOptions = {
+    id?: string;
+    max_history_size?: number | null;
+    max_history_drop?: boolean;
+    event_concurrency?: EventConcurrencyMode | null;
+    event_timeout?: number | null;
+    event_slow_timeout?: number | null;
+    event_handler_concurrency?: EventHandlerConcurrencyMode | null;
+    event_handler_completion?: EventHandlerCompletionMode;
+    event_handler_slow_timeout?: number | null;
+    event_handler_detect_file_paths?: boolean;
+    middlewares?: EventBusMiddlewareInput[];
+};
+export type EventBusJSON = {
+    id: string;
+    name: string;
+    max_history_size: number | null;
+    max_history_drop: boolean;
+    event_concurrency: EventConcurrencyMode;
+    event_timeout: number | null;
+    event_slow_timeout: number | null;
+    event_handler_concurrency: EventHandlerConcurrencyMode;
+    event_handler_completion: EventHandlerCompletionMode;
+    event_handler_slow_timeout: number | null;
+    event_handler_detect_file_paths: boolean;
+    handlers: Record<string, EventHandlerJSON>;
+    handlers_by_key: Record<string, string[]>;
+    event_history: Record<string, BaseEventJSON>;
+    pending_event_queue: string[];
+};
+export declare class GlobalEventBusRegistry {
+    private _bus_refs;
+    add(bus: EventBus): void;
+    discard(bus: EventBus): void;
+    has(bus: EventBus): boolean;
+    get size(): number;
+    [Symbol.iterator](): IterableIterator<EventBus>;
+    findBusById(bus_id: string): EventBus | undefined;
+    findEventById(event_id: string): BaseEvent | null;
+}
+export declare class EventBus {
+    private static _registry_by_constructor;
+    private static _global_event_lock_by_constructor;
+    private static getRegistryForConstructor;
+    private static getGlobalEventLockForConstructor;
+    static get all_instances(): GlobalEventBusRegistry;
+    get all_instances(): GlobalEventBusRegistry;
+    get _lock_for_event_global_serial(): AsyncLock;
+    id: string;
+    name: string;
+    event_timeout: number | null;
+    event_concurrency: EventConcurrencyMode;
+    event_handler_concurrency: EventHandlerConcurrencyMode;
+    event_handler_completion: EventHandlerCompletionMode;
+    event_handler_detect_file_paths: boolean;
+    event_handler_slow_timeout: number | null;
+    event_slow_timeout: number | null;
+    handlers: Map<string, EventHandler>;
+    handlers_by_key: Map<string, string[]>;
+    event_history: EventHistory<BaseEvent>;
+    pending_event_queue: BaseEvent[];
+    in_flight_event_ids: Set<string>;
+    runloop_running: boolean;
+    locks: LockManager;
+    find_waiters: Set<EphemeralFindEventHandler>;
+    middlewares: EventBusMiddleware[];
+    private static normalizeMiddlewares;
+    constructor(name?: string, options?: EventBusOptions);
+    toString(): string;
+    scheduleMicrotask(fn: () => void): void;
+    private _runMiddlewareHook;
+    onEventChange(event: BaseEvent, status: 'pending' | 'started' | 'completed'): Promise<void>;
+    onEventResultChange(event: BaseEvent, result: EventResult, status: 'pending' | 'started' | 'completed'): Promise<void>;
+    private _onEventChange;
+    private _onEventResultChange;
+    private _onBusHandlersChange;
+    private _finalizeEventTimeout;
+    private _createEventTimeoutError;
+    private _runHandlersWithTimeout;
+    private _markEventCompletedIfNeeded;
+    toJSON(): EventBusJSON;
+    private static _stubHandlerFn;
+    private static _upsertHandlerIndex;
+    private static _linkEventResultHandlers;
+    static fromJSON(data: unknown): EventBus;
+    get label(): string;
+    removeEventFromPendingQueue(event: BaseEvent): number;
+    isEventInFlightOrQueued(event_id: string): boolean;
+    removeEventFromHistory(event_id: string): boolean;
+    destroy(): void;
+    on<T extends BaseEvent>(event_pattern: EventClass<T>, handler: EventHandlerCallable<T>, options?: Partial<EventHandler>): EventHandler;
+    on<T extends BaseEvent>(event_pattern: string | '*', handler: UntypedEventHandlerFunction<T>, options?: Partial<EventHandler>): EventHandler;
+    off<T extends BaseEvent>(event_pattern: EventPattern<T> | '*', handler?: EventHandlerCallable<T> | string | EventHandler): void;
+    emit<T extends BaseEvent>(event: T): T;
+    dispatch<T extends BaseEvent>(event: T): T;
+    find(event_pattern: '*', options?: FindOptions<BaseEvent>): Promise<BaseEvent | null>;
+    find(event_pattern: '*', where: (event: BaseEvent) => boolean, options?: FindOptions<BaseEvent>): Promise<BaseEvent | null>;
+    find<T extends BaseEvent>(event_pattern: EventPattern<T>, options?: FindOptions<T>): Promise<T | null>;
+    find<T extends BaseEvent>(event_pattern: EventPattern<T>, where: (event: T) => boolean, options?: FindOptions<T>): Promise<T | null>;
+    private _waitForFutureMatch;
+    waitUntilIdle(timeout?: number | null): Promise<boolean>;
+    isIdle(): boolean;
+    isIdleAndQueueEmpty(): boolean;
+    eventIsChildOf(child_event: BaseEvent, parent_event: BaseEvent): boolean;
+    eventIsParentOf(parent_event: BaseEvent, child_event: BaseEvent): boolean;
+    logTree(): string;
+    findEventById(event_id: string): BaseEvent | null;
+    _getParentEventResultAcrossAllBuses(event: BaseEvent): EventResult | null;
+    private _startRunloop;
+    private _processEvent;
+    _processEventImmediately<T extends BaseEvent>(event: T, handler_result?: EventResult): Promise<T>;
+    private _processEventImmediatelyAcrossBuses;
+    private _runloop;
+    _hasProcessedEvent(event: BaseEvent): boolean;
+    private _resolveImplicitParentHandlerResult;
+    _getEventProxyScopedToThisBus<T extends BaseEvent>(event: T, handler_result?: EventResult): T;
+    private _resolveFindWaiters;
+    _getHandlersForEvent(event: BaseEvent): EventHandler[];
+    private _removeIndexedHandler;
+}