@warlock.js/herald 5.23.2 → 5.25.0

package/esm/drivers/rabbitmq/rabbitmq-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rabbitmq-driver.mjs","names":[],"sources":["../../../../../../../../herald/src/drivers/rabbitmq/rabbitmq-driver.ts"],"sourcesContent":["import { EventEmitter } from \"node:events\";\r\nimport type { BrokerDriverContract, ChannelContract } from \"../../contracts\";\r\nimport { EventMessage } from \"../../message-managers/event-message\";\r\nimport { type EventConsumerClass } from \"../../message-managers/types\";\r\nimport type {\r\n  BrokerDriverType,\r\n  BrokerEvent,\r\n  BrokerEventListener,\r\n  ChannelOptions,\r\n  HealthCheckResult,\r\n  RabbitMQConnectionOptions,\r\n} from \"../../types\";\r\nimport { prepareConsumerSubscription } from \"./../../message-managers/prepare-consumer-subscription\";\r\nimport { RabbitMQChannel } from \"./rabbitmq-channel\";\r\n\r\n// ============================================================\r\n// Lazy-loaded amqplib Module\r\n// ============================================================\r\n\r\n/**\r\n * Shape of the lazily-imported amqplib module\r\n */\r\ntype AmqplibModule = typeof import(\"amqplib\");\r\n\r\n/**\r\n * The single amqplib load, shared by every caller.\r\n *\r\n * Memoized as a promise rather than as a resolved value so the loader stays\r\n * idempotent: without it, two callers arriving before the first `import()`\r\n * settles would each start their own load and the last writer would win, so a\r\n * caller could end up observing a module instance it never awaited.\r\n *\r\n * Resolves to `undefined` when amqplib is not installed.\r\n */\r\nlet amqplibModulePromise: Promise<AmqplibModule | undefined> | undefined;\r\n\r\n/**\r\n * Installation instructions for amqplib\r\n */\r\nconst AMQPLIB_INSTALL_INSTRUCTIONS = `\r\nRabbitMQ driver requires the amqplib package.\r\nInstall it with:\r\n\r\n  npx warlock add herald --driver=rabbitmq\r\n\r\nOr manually:\r\n\r\n  npm install amqplib\r\n  pnpm add amqplib\r\n  yarn add amqplib\r\n`.trim();\r\n\r\n/**\r\n * Strip `user:password@` credentials from any `amqp(s)://` URL embedded in a\r\n * string. The connection URL carries plaintext broker credentials, and\r\n * amqplib/Node's URL parser commonly echoes the offending URL verbatim in a\r\n * malformed-URL error (e.g. an unencoded `@`/`:` in the password) — applied\r\n * to every error `connect()` surfaces so a credential never reaches whatever\r\n * the host app does with a thrown connection error (console.error,\r\n * structured logging, an error tracker).\r\n */\r\nfunction redactAmqpCredentials(message: string): string {\r\n  return message.replace(/(amqps?:\\/\\/)[^/@\\s]+@/gi, \"$1****:****@\");\r\n}\r\n\r\n/**\r\n * Load amqplib, reusing the single shared load for every caller.\r\n *\r\n * @returns The amqplib module, or `undefined` when it is not installed.\r\n */\r\nfunction loadAmqplibModule(): Promise<AmqplibModule | undefined> {\r\n  if (!amqplibModulePromise) {\r\n    amqplibModulePromise = import(\"amqplib\").catch(() => undefined);\r\n  }\r\n\r\n  return amqplibModulePromise;\r\n}\r\n\r\n// ============================================================\r\n// RabbitMQ Driver\r\n// ============================================================\r\n\r\n/**\r\n * RabbitMQ Driver\r\n *\r\n * Implementation of BrokerDriverContract for RabbitMQ/AMQP.\r\n *\r\n * **Important:** This driver requires the `amqplib` package to be installed.\r\n * Install it with: `npx warlock add herald --driver=rabbitmq` or `npm install amqplib`\r\n *\r\n * @example\r\n * ```typescript\r\n * const driver = new RabbitMQDriver({\r\n *   driver: \"rabbitmq\",\r\n *   host: \"localhost\",\r\n *   port: 5672,\r\n *   username: \"guest\",\r\n *   password: \"guest\",\r\n * });\r\n *\r\n * await driver.connect();\r\n * const channel = driver.channel(\"user.created\");\r\n * ```\r\n */\r\nexport class RabbitMQDriver implements BrokerDriverContract {\r\n  public readonly name = \"rabbitmq\" as const;\r\n\r\n  public readonly consumers: EventConsumerClass[] = [];\r\n\r\n  private readonly options: RabbitMQConnectionOptions;\r\n  private readonly events = new EventEmitter();\r\n  private readonly channels = new Map<string, ChannelContract<any>>();\r\n\r\n  private connection: any = null;\r\n  private amqpChannel: any = null;\r\n  private _isConnected = false;\r\n\r\n  /**\r\n   * Create a new RabbitMQ driver\r\n   *\r\n   * @param options - RabbitMQ connection options\r\n   */\r\n  public constructor(options: RabbitMQConnectionOptions) {\r\n    this.options = options;\r\n  }\r\n\r\n  /**\r\n   * Whether connected to RabbitMQ\r\n   */\r\n  public get isConnected(): boolean {\r\n    return this._isConnected;\r\n  }\r\n\r\n  /**\r\n   * Subscribe the given consumer class to the driver\r\n   *\r\n   * @param consumer - Consumer class to subscribe\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * driver.subscribe(UserUpdatedConsumer);\r\n   * ```\r\n   */\r\n  public subscribe(Consumer: EventConsumerClass) {\r\n    if (this.isConnected) {\r\n      this.channel(Consumer.eventName).subscribe(\r\n        prepareConsumerSubscription(Consumer, (error, eventName) => {\r\n          this.events.emit(\"error\", error, eventName);\r\n        }),\r\n        {\r\n          consumerId: Consumer.consumerId,\r\n        },\r\n      );\r\n    } else {\r\n      this.consumers.push(Consumer);\r\n    }\r\n\r\n    return () => {\r\n      this.unsubscribe(Consumer);\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Unsubscribe the given consumer\r\n   */\r\n  public unsubscribe(Consumer: EventConsumerClass): void {\r\n    if (this.isConnected) {\r\n      this.channel(Consumer.eventName).unsubscribeById(Consumer.consumerId);\r\n    }\r\n    const index = this.consumers.indexOf(Consumer);\r\n    if (index > -1) {\r\n      this.consumers.splice(index, 1);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Publish the given event message.\r\n   * Auto-creates the channel if it hasn't been accessed before.\r\n   */\r\n  public publish<TPayload = Record<string, any>>(event: EventMessage<TPayload>): void {\r\n    this.channel(event.eventName).publish(event.serialize());\r\n  }\r\n\r\n  /**\r\n   * Connect to RabbitMQ\r\n   */\r\n  public async connect(): Promise<void> {\r\n    const amqplib = await loadAmqplibModule();\r\n\r\n    if (!amqplib) {\r\n      throw new Error(`amqplib is not installed.\\n\\n${AMQPLIB_INSTALL_INSTRUCTIONS}`);\r\n    }\r\n\r\n    try {\r\n      // Build connection URL\r\n      const url = this.buildConnectionUrl();\r\n\r\n      // Build connection options merging our options with native client options\r\n      const connectOptions = {\r\n        heartbeat: this.options.heartbeat ?? 60,\r\n        timeout: this.options.connectionTimeout,\r\n        // Merge native amqplib client options\r\n        ...this.options.clientOptions,\r\n      };\r\n\r\n      // Connect using cached module\r\n      this.connection = await amqplib.connect(url, connectOptions);\r\n\r\n      // Create channel\r\n      this.amqpChannel = await this.connection.createChannel();\r\n\r\n      // Set prefetch if specified\r\n      if (this.options.prefetch) {\r\n        await this.amqpChannel.prefetch(this.options.prefetch);\r\n      }\r\n\r\n      this._isConnected = true;\r\n      this.events.emit(\"connected\");\r\n\r\n      for (const consumer of this.consumers) {\r\n        this.subscribe(consumer);\r\n      }\r\n\r\n      this.consumers.length = 0;\r\n\r\n      // Handle connection close\r\n      this.connection.on(\"close\", () => {\r\n        this._isConnected = false;\r\n        this.events.emit(\"disconnected\");\r\n\r\n        if (this.options.reconnect !== false) {\r\n          this.handleReconnect();\r\n        }\r\n      });\r\n\r\n      // Handle errors\r\n      this.connection.on(\"error\", (error: Error) => {\r\n        this.events.emit(\"error\", error);\r\n      });\r\n    } catch (error) {\r\n      this._isConnected = false;\r\n      const message = error instanceof Error ? error.message : String(error);\r\n      throw new Error(`Failed to connect to RabbitMQ: ${redactAmqpCredentials(message)}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Build connection URL from options\r\n   */\r\n  private buildConnectionUrl(): string {\r\n    if (this.options.uri) {\r\n      return this.options.uri;\r\n    }\r\n\r\n    const protocol = \"amqp\";\r\n    const host = this.options.host ?? \"localhost\";\r\n    const port = this.options.port ?? 5672;\r\n    const vhost = this.options.vhost ?? \"/\";\r\n    // URI-encoded so a credential containing a reserved URL character\r\n    // (`@`, `:`, `/`, whitespace — common in generated secrets) can't produce\r\n    // a malformed URL whose parser error echoes the raw credential back.\r\n    const username = encodeURIComponent(this.options.username ?? \"guest\");\r\n    const password = encodeURIComponent(this.options.password ?? \"guest\");\r\n\r\n    const encodedVhost = encodeURIComponent(vhost);\r\n\r\n    return `${protocol}://${username}:${password}@${host}:${port}/${encodedVhost}`;\r\n  }\r\n\r\n  /**\r\n   * Handle reconnection\r\n   */\r\n  private async handleReconnect(): Promise<void> {\r\n    const delay = this.options.reconnectDelay ?? 5000;\r\n    let attempt = 0;\r\n\r\n    const tryReconnect = async () => {\r\n      attempt++;\r\n      this.events.emit(\"reconnecting\", attempt);\r\n\r\n      try {\r\n        await this.connect();\r\n      } catch {\r\n        setTimeout(tryReconnect, delay);\r\n      }\r\n    };\r\n\r\n    setTimeout(tryReconnect, delay);\r\n  }\r\n\r\n  /**\r\n   * Disconnect from RabbitMQ\r\n   */\r\n  public async disconnect(): Promise<void> {\r\n    if (this.amqpChannel) {\r\n      try {\r\n        await this.amqpChannel.close();\r\n      } catch {\r\n        // Ignore close errors\r\n      }\r\n      this.amqpChannel = null;\r\n    }\r\n\r\n    if (this.connection) {\r\n      try {\r\n        await this.connection.close();\r\n      } catch {\r\n        // Ignore close errors\r\n      }\r\n      this.connection = null;\r\n    }\r\n\r\n    this._isConnected = false;\r\n    this.events.emit(\"disconnected\");\r\n  }\r\n\r\n  /**\r\n   * Register event listener\r\n   */\r\n  public on(event: BrokerEvent, listener: BrokerEventListener): void {\r\n    this.events.on(event, listener as any);\r\n  }\r\n\r\n  /**\r\n   * Remove event listener\r\n   */\r\n  public off(event: BrokerEvent, listener: BrokerEventListener): void {\r\n    this.events.off(event, listener as any);\r\n  }\r\n\r\n  /**\r\n   * Get or create a channel\r\n   */\r\n  public channel<TPayload = unknown>(\r\n    name: string,\r\n    options?: ChannelOptions<TPayload>,\r\n  ): ChannelContract<TPayload> {\r\n    // Check cache\r\n    const existing = this.channels.get(name);\r\n    if (existing) {\r\n      return existing as ChannelContract<TPayload>;\r\n    }\r\n\r\n    // Create new channel\r\n    const channel = new RabbitMQChannel<TPayload>(name, this.amqpChannel, options);\r\n\r\n    this.channels.set(name, channel);\r\n    return channel;\r\n  }\r\n\r\n  /**\r\n   * Start consuming messages\r\n   */\r\n  public async startConsuming(): Promise<void> {\r\n    // Channels start consuming when subscribe() is called\r\n    // This method is for batch start if needed\r\n  }\r\n\r\n  /**\r\n   * Stop consuming messages from all subscribed channels.\r\n   * Gracefully cancels all active consumers.\r\n   */\r\n  public async stopConsuming(): Promise<void> {\r\n    const stops = Array.from(this.channels.values()).map(channel =>\r\n      (channel as RabbitMQChannel<any>).stopConsuming(),\r\n    );\r\n    await Promise.all(stops);\r\n  }\r\n\r\n  /**\r\n   * Health check\r\n   */\r\n  public async healthCheck(): Promise<HealthCheckResult> {\r\n    if (!this._isConnected || !this.connection) {\r\n      return {\r\n        healthy: false,\r\n        error: \"Not connected to RabbitMQ\",\r\n      };\r\n    }\r\n\r\n    const start = Date.now();\r\n\r\n    try {\r\n      // Simple check - verify channel is open\r\n      await this.amqpChannel.checkQueue(\"amq.rabbitmq.reply-to\").catch(() => {\r\n        // Queue might not exist, but if we get here, connection is alive\r\n      });\r\n\r\n      return {\r\n        healthy: true,\r\n        latency: Date.now() - start,\r\n      };\r\n    } catch (error) {\r\n      return {\r\n        healthy: false,\r\n        error: error instanceof Error ? error.message : String(error),\r\n        latency: Date.now() - start,\r\n      };\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get all channel names\r\n   */\r\n  public getChannelNames(): string[] {\r\n    return Array.from(this.channels.keys());\r\n  }\r\n\r\n  /**\r\n   * Close a specific channel\r\n   */\r\n  public async closeChannel(name: string): Promise<void> {\r\n    const channel = this.channels.get(name);\r\n    if (channel) {\r\n      await channel.delete();\r\n      this.channels.delete(name);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get the raw AMQP channel (for advanced use)\r\n   */\r\n  public getRawChannel(): any {\r\n    return this.amqpChannel;\r\n  }\r\n\r\n  /**\r\n   * Get the raw connection (for advanced use)\r\n   */\r\n  public getRawConnection(): any {\r\n    return this.connection;\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"rabbitmq-driver.mjs","names":[],"sources":["../../../../../../../../herald/src/drivers/rabbitmq/rabbitmq-driver.ts"],"sourcesContent":["import { EventEmitter } from \"node:events\";\nimport type { BrokerDriverContract, ChannelContract } from \"../../contracts\";\nimport { EventMessage } from \"../../message-managers/event-message\";\nimport { type EventConsumerClass } from \"../../message-managers/types\";\nimport type {\n  BrokerDriverType,\n  BrokerEvent,\n  BrokerEventListener,\n  ChannelOptions,\n  HealthCheckResult,\n  RabbitMQConnectionOptions,\n} from \"../../types\";\nimport { prepareConsumerSubscription } from \"./../../message-managers/prepare-consumer-subscription\";\nimport { RabbitMQChannel } from \"./rabbitmq-channel\";\n\n// ============================================================\n// Lazy-loaded amqplib Module\n// ============================================================\n\n/**\n * Shape of the lazily-imported amqplib module\n */\ntype AmqplibModule = typeof import(\"amqplib\");\n\n/**\n * The single amqplib load, shared by every caller.\n *\n * Memoized as a promise rather than as a resolved value so the loader stays\n * idempotent: without it, two callers arriving before the first `import()`\n * settles would each start their own load and the last writer would win, so a\n * caller could end up observing a module instance it never awaited.\n *\n * Resolves to `undefined` when amqplib is not installed.\n */\nlet amqplibModulePromise: Promise<AmqplibModule | undefined> | undefined;\n\n/**\n * Installation instructions for amqplib\n */\nconst AMQPLIB_INSTALL_INSTRUCTIONS = `\nRabbitMQ driver requires the amqplib package.\nInstall it with:\n\n  npx warlock add herald --driver=rabbitmq\n\nOr manually:\n\n  npm install amqplib\n  pnpm add amqplib\n  yarn add amqplib\n`.trim();\n\n/**\n * Strip `user:password@` credentials from any `amqp(s)://` URL embedded in a\n * string. The connection URL carries plaintext broker credentials, and\n * amqplib/Node's URL parser commonly echoes the offending URL verbatim in a\n * malformed-URL error (e.g. an unencoded `@`/`:` in the password) — applied\n * to every error `connect()` surfaces so a credential never reaches whatever\n * the host app does with a thrown connection error (console.error,\n * structured logging, an error tracker).\n */\nfunction redactAmqpCredentials(message: string): string {\n  return message.replace(/(amqps?:\\/\\/)[^/@\\s]+@/gi, \"$1****:****@\");\n}\n\n/**\n * Load amqplib, reusing the single shared load for every caller.\n *\n * @returns The amqplib module, or `undefined` when it is not installed.\n */\nfunction loadAmqplibModule(): Promise<AmqplibModule | undefined> {\n  if (!amqplibModulePromise) {\n    amqplibModulePromise = import(\"amqplib\").catch(() => undefined);\n  }\n\n  return amqplibModulePromise;\n}\n\n// ============================================================\n// RabbitMQ Driver\n// ============================================================\n\n/**\n * RabbitMQ Driver\n *\n * Implementation of BrokerDriverContract for RabbitMQ/AMQP.\n *\n * **Important:** This driver requires the `amqplib` package to be installed.\n * Install it with: `npx warlock add herald --driver=rabbitmq` or `npm install amqplib`\n *\n * @example\n * ```typescript\n * const driver = new RabbitMQDriver({\n *   driver: \"rabbitmq\",\n *   host: \"localhost\",\n *   port: 5672,\n *   username: \"guest\",\n *   password: \"guest\",\n * });\n *\n * await driver.connect();\n * const channel = driver.channel(\"user.created\");\n * ```\n */\nexport class RabbitMQDriver implements BrokerDriverContract {\n  public readonly name = \"rabbitmq\" as const;\n\n  public readonly consumers: EventConsumerClass[] = [];\n\n  private readonly options: RabbitMQConnectionOptions;\n  private readonly events = new EventEmitter();\n  private readonly channels = new Map<string, ChannelContract<any>>();\n\n  private connection: any = null;\n  private amqpChannel: any = null;\n  private _isConnected = false;\n\n  /**\n   * Create a new RabbitMQ driver\n   *\n   * @param options - RabbitMQ connection options\n   */\n  public constructor(options: RabbitMQConnectionOptions) {\n    this.options = options;\n  }\n\n  /**\n   * Whether connected to RabbitMQ\n   */\n  public get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Subscribe the given consumer class to the driver\n   *\n   * @param consumer - Consumer class to subscribe\n   *\n   * @example\n   * ```typescript\n   * driver.subscribe(UserUpdatedConsumer);\n   * ```\n   */\n  public subscribe(Consumer: EventConsumerClass) {\n    if (this.isConnected) {\n      this.channel(Consumer.eventName).subscribe(\n        prepareConsumerSubscription(Consumer, (error, eventName) => {\n          this.events.emit(\"error\", error, eventName);\n        }),\n        {\n          consumerId: Consumer.consumerId,\n        },\n      );\n    } else {\n      this.consumers.push(Consumer);\n    }\n\n    return () => {\n      this.unsubscribe(Consumer);\n    };\n  }\n\n  /**\n   * Unsubscribe the given consumer\n   */\n  public unsubscribe(Consumer: EventConsumerClass): void {\n    if (this.isConnected) {\n      this.channel(Consumer.eventName).unsubscribeById(Consumer.consumerId);\n    }\n    const index = this.consumers.indexOf(Consumer);\n    if (index > -1) {\n      this.consumers.splice(index, 1);\n    }\n  }\n\n  /**\n   * Publish the given event message.\n   * Auto-creates the channel if it hasn't been accessed before.\n   */\n  public publish<TPayload = Record<string, any>>(event: EventMessage<TPayload>): void {\n    this.channel(event.eventName).publish(event.serialize());\n  }\n\n  /**\n   * Connect to RabbitMQ\n   */\n  public async connect(): Promise<void> {\n    const amqplib = await loadAmqplibModule();\n\n    if (!amqplib) {\n      throw new Error(`amqplib is not installed.\\n\\n${AMQPLIB_INSTALL_INSTRUCTIONS}`);\n    }\n\n    try {\n      // Build connection URL\n      const url = this.buildConnectionUrl();\n\n      // Build connection options merging our options with native client options\n      const connectOptions = {\n        heartbeat: this.options.heartbeat ?? 60,\n        timeout: this.options.connectionTimeout,\n        // Merge native amqplib client options\n        ...this.options.clientOptions,\n      };\n\n      // Connect using cached module\n      this.connection = await amqplib.connect(url, connectOptions);\n\n      // Create channel\n      this.amqpChannel = await this.connection.createChannel();\n\n      // Set prefetch if specified\n      if (this.options.prefetch) {\n        await this.amqpChannel.prefetch(this.options.prefetch);\n      }\n\n      this._isConnected = true;\n      this.events.emit(\"connected\");\n\n      for (const consumer of this.consumers) {\n        this.subscribe(consumer);\n      }\n\n      this.consumers.length = 0;\n\n      // Handle connection close\n      this.connection.on(\"close\", () => {\n        this._isConnected = false;\n        this.events.emit(\"disconnected\");\n\n        if (this.options.reconnect !== false) {\n          this.handleReconnect();\n        }\n      });\n\n      // Handle errors\n      this.connection.on(\"error\", (error: Error) => {\n        this.events.emit(\"error\", error);\n      });\n    } catch (error) {\n      this._isConnected = false;\n      const message = error instanceof Error ? error.message : String(error);\n      throw new Error(`Failed to connect to RabbitMQ: ${redactAmqpCredentials(message)}`);\n    }\n  }\n\n  /**\n   * Build connection URL from options\n   */\n  private buildConnectionUrl(): string {\n    if (this.options.uri) {\n      return this.options.uri;\n    }\n\n    const protocol = \"amqp\";\n    const host = this.options.host ?? \"localhost\";\n    const port = this.options.port ?? 5672;\n    const vhost = this.options.vhost ?? \"/\";\n    // URI-encoded so a credential containing a reserved URL character\n    // (`@`, `:`, `/`, whitespace — common in generated secrets) can't produce\n    // a malformed URL whose parser error echoes the raw credential back.\n    const username = encodeURIComponent(this.options.username ?? \"guest\");\n    const password = encodeURIComponent(this.options.password ?? \"guest\");\n\n    const encodedVhost = encodeURIComponent(vhost);\n\n    return `${protocol}://${username}:${password}@${host}:${port}/${encodedVhost}`;\n  }\n\n  /**\n   * Handle reconnection\n   */\n  private async handleReconnect(): Promise<void> {\n    const delay = this.options.reconnectDelay ?? 5000;\n    let attempt = 0;\n\n    const tryReconnect = async () => {\n      attempt++;\n      this.events.emit(\"reconnecting\", attempt);\n\n      try {\n        await this.connect();\n      } catch {\n        setTimeout(tryReconnect, delay);\n      }\n    };\n\n    setTimeout(tryReconnect, delay);\n  }\n\n  /**\n   * Disconnect from RabbitMQ\n   */\n  public async disconnect(): Promise<void> {\n    if (this.amqpChannel) {\n      try {\n        await this.amqpChannel.close();\n      } catch {\n        // Ignore close errors\n      }\n      this.amqpChannel = null;\n    }\n\n    if (this.connection) {\n      try {\n        await this.connection.close();\n      } catch {\n        // Ignore close errors\n      }\n      this.connection = null;\n    }\n\n    this._isConnected = false;\n    this.events.emit(\"disconnected\");\n  }\n\n  /**\n   * Register event listener\n   */\n  public on(event: BrokerEvent, listener: BrokerEventListener): void {\n    this.events.on(event, listener as any);\n  }\n\n  /**\n   * Remove event listener\n   */\n  public off(event: BrokerEvent, listener: BrokerEventListener): void {\n    this.events.off(event, listener as any);\n  }\n\n  /**\n   * Get or create a channel\n   */\n  public channel<TPayload = unknown>(\n    name: string,\n    options?: ChannelOptions<TPayload>,\n  ): ChannelContract<TPayload> {\n    // Check cache\n    const existing = this.channels.get(name);\n    if (existing) {\n      return existing as ChannelContract<TPayload>;\n    }\n\n    // Create new channel\n    const channel = new RabbitMQChannel<TPayload>(name, this.amqpChannel, options);\n\n    this.channels.set(name, channel);\n    return channel;\n  }\n\n  /**\n   * Start consuming messages\n   */\n  public async startConsuming(): Promise<void> {\n    // Channels start consuming when subscribe() is called\n    // This method is for batch start if needed\n  }\n\n  /**\n   * Stop consuming messages from all subscribed channels.\n   * Gracefully cancels all active consumers.\n   */\n  public async stopConsuming(): Promise<void> {\n    const stops = Array.from(this.channels.values()).map(channel =>\n      (channel as RabbitMQChannel<any>).stopConsuming(),\n    );\n    await Promise.all(stops);\n  }\n\n  /**\n   * Health check\n   */\n  public async healthCheck(): Promise<HealthCheckResult> {\n    if (!this._isConnected || !this.connection) {\n      return {\n        healthy: false,\n        error: \"Not connected to RabbitMQ\",\n      };\n    }\n\n    const start = Date.now();\n\n    try {\n      // Simple check - verify channel is open\n      await this.amqpChannel.checkQueue(\"amq.rabbitmq.reply-to\").catch(() => {\n        // Queue might not exist, but if we get here, connection is alive\n      });\n\n      return {\n        healthy: true,\n        latency: Date.now() - start,\n      };\n    } catch (error) {\n      return {\n        healthy: false,\n        error: error instanceof Error ? error.message : String(error),\n        latency: Date.now() - start,\n      };\n    }\n  }\n\n  /**\n   * Get all channel names\n   */\n  public getChannelNames(): string[] {\n    return Array.from(this.channels.keys());\n  }\n\n  /**\n   * Close a specific channel\n   */\n  public async closeChannel(name: string): Promise<void> {\n    const channel = this.channels.get(name);\n    if (channel) {\n      await channel.delete();\n      this.channels.delete(name);\n    }\n  }\n\n  /**\n   * Get the raw AMQP channel (for advanced use)\n   */\n  public getRawChannel(): any {\n    return this.amqpChannel;\n  }\n\n  /**\n   * Get the raw connection (for advanced use)\n   */\n  public getRawConnection(): any {\n    return this.connection;\n  }\n}\n"],"mappings":"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"}

package/esm/message-managers/prepare-consumer-subscription.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-consumer-subscription.mjs","names":[],"sources":["../../../../../../../herald/src/message-managers/prepare-consumer-subscription.ts"],"sourcesContent":["import type { MessageHandler } from \"./../types\";\r\nimport { type EventConsumerClass } from \"./types\";\r\n\r\nexport function prepareConsumerSubscription(\r\n  Consumer: EventConsumerClass,\r\n  onError?: (error: unknown, consumerName: string) => void,\r\n) {\r\n  const callback: MessageHandler<any> = async (message, ctx) => {\r\n    const envelope = message.payload;\r\n    let eventPayload = envelope.payload;\r\n\r\n    if (envelope.version) {\r\n      if (!Consumer.isAcceptedVersion(Number(envelope.version))) {\r\n        ctx.ack(); // Acknowledge but don't process\r\n        return;\r\n      }\r\n    }\r\n\r\n    const consumer = new Consumer();\r\n\r\n    if (consumer.schema) {\r\n      const result = await consumer.validate(eventPayload);\r\n      if (!result || result.isValid === false) {\r\n        ctx.nack();\r\n        return;\r\n      }\r\n\r\n      eventPayload = result.data;\r\n    }\r\n    try {\r\n      await consumer.handle(eventPayload, {\r\n        payload: eventPayload,\r\n        eventName: Consumer.eventName,\r\n        messageId: message.metadata.messageId!,\r\n        occurredAt: envelope.occurredAt ? new Date(envelope.occurredAt) : undefined,\r\n        metadata: envelope.metadata,\r\n        version: envelope.version,\r\n        message,\r\n      });\r\n      ctx.ack(); // Auto-ack on success?\r\n    } catch (error) {\r\n      // Bounded retry instead of an unconditional requeue: a message that\r\n      // reliably throws (bad payload, a handler bug, a downstream outage)\r\n      // would otherwise be nack+requeued forever, pinning the consumer in a\r\n      // hot loop. `ctx.retry()` caps redelivery and dead-letters/drops (with\r\n      // a loud log) once the cap is hit.\r\n      await ctx.retry();\r\n      if (onError) {\r\n        onError(error, Consumer.eventName);\r\n      }\r\n    }\r\n  };\r\n\r\n  return callback;\r\n}\r\n"],"mappings":";AAGA,SAAgB,4BACd,UACA,SACA;CACA,MAAM,WAAgC,OAAO,SAAS,QAAQ;EAC5D,MAAM,WAAW,QAAQ;EACzB,IAAI,eAAe,SAAS;EAE5B,IAAI,SAAS,SACX;OAAI,CAAC,SAAS,kBAAkB,OAAO,SAAS,OAAO,CAAC,GAAG;IACzD,IAAI,IAAI;IACR;GACF;;EAGF,MAAM,WAAW,IAAI,SAAS;EAE9B,IAAI,SAAS,QAAQ;GACnB,MAAM,SAAS,MAAM,SAAS,SAAS,YAAY;GACnD,IAAI,CAAC,UAAU,OAAO,YAAY,OAAO;IACvC,IAAI,KAAK;IACT;GACF;GAEA,eAAe,OAAO;EACxB;EACA,IAAI;GACF,MAAM,SAAS,OAAO,cAAc;IAClC,SAAS;IACT,WAAW,SAAS;IACpB,WAAW,QAAQ,SAAS;IAC5B,YAAY,SAAS,aAAa,IAAI,KAAK,SAAS,UAAU,IAAI;IAClE,UAAU,SAAS;IACnB,SAAS,SAAS;IAClB;GACF,CAAC;GACD,IAAI,IAAI;EACV,SAAS,OAAO;GAMd,MAAM,IAAI,MAAM;GAChB,IAAI,SACF,QAAQ,OAAO,SAAS,SAAS;EAErC;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"prepare-consumer-subscription.mjs","names":[],"sources":["../../../../../../../herald/src/message-managers/prepare-consumer-subscription.ts"],"sourcesContent":["import type { MessageHandler } from \"./../types\";\nimport { type EventConsumerClass } from \"./types\";\n\nexport function prepareConsumerSubscription(\n  Consumer: EventConsumerClass,\n  onError?: (error: unknown, consumerName: string) => void,\n) {\n  const callback: MessageHandler<any> = async (message, ctx) => {\n    const envelope = message.payload;\n    let eventPayload = envelope.payload;\n\n    if (envelope.version) {\n      if (!Consumer.isAcceptedVersion(Number(envelope.version))) {\n        ctx.ack(); // Acknowledge but don't process\n        return;\n      }\n    }\n\n    const consumer = new Consumer();\n\n    if (consumer.schema) {\n      const result = await consumer.validate(eventPayload);\n      if (!result || result.isValid === false) {\n        ctx.nack();\n        return;\n      }\n\n      eventPayload = result.data;\n    }\n    try {\n      await consumer.handle(eventPayload, {\n        payload: eventPayload,\n        eventName: Consumer.eventName,\n        messageId: message.metadata.messageId!,\n        occurredAt: envelope.occurredAt ? new Date(envelope.occurredAt) : undefined,\n        metadata: envelope.metadata,\n        version: envelope.version,\n        message,\n      });\n      ctx.ack(); // Auto-ack on success?\n    } catch (error) {\n      // Bounded retry instead of an unconditional requeue: a message that\n      // reliably throws (bad payload, a handler bug, a downstream outage)\n      // would otherwise be nack+requeued forever, pinning the consumer in a\n      // hot loop. `ctx.retry()` caps redelivery and dead-letters/drops (with\n      // a loud log) once the cap is hit.\n      await ctx.retry();\n      if (onError) {\n        onError(error, Consumer.eventName);\n      }\n    }\n  };\n\n  return callback;\n}\n"],"mappings":";AAGA,SAAgB,4BACd,UACA,SACA;CACA,MAAM,WAAgC,OAAO,SAAS,QAAQ;EAC5D,MAAM,WAAW,QAAQ;EACzB,IAAI,eAAe,SAAS;EAE5B,IAAI,SAAS,SACX;OAAI,CAAC,SAAS,kBAAkB,OAAO,SAAS,OAAO,CAAC,GAAG;IACzD,IAAI,IAAI;IACR;GACF;;EAGF,MAAM,WAAW,IAAI,SAAS;EAE9B,IAAI,SAAS,QAAQ;GACnB,MAAM,SAAS,MAAM,SAAS,SAAS,YAAY;GACnD,IAAI,CAAC,UAAU,OAAO,YAAY,OAAO;IACvC,IAAI,KAAK;IACT;GACF;GAEA,eAAe,OAAO;EACxB;EACA,IAAI;GACF,MAAM,SAAS,OAAO,cAAc;IAClC,SAAS;IACT,WAAW,SAAS;IACpB,WAAW,QAAQ,SAAS;IAC5B,YAAY,SAAS,aAAa,IAAI,KAAK,SAAS,UAAU,IAAI;IAClE,UAAU,SAAS;IACnB,SAAS,SAAS;IAClB;GACF,CAAC;GACD,IAAI,IAAI;EACV,SAAS,OAAO;GAMd,MAAM,IAAI,MAAM;GAChB,IAAI,SACF,QAAQ,OAAO,SAAS,SAAS;EAErC;CACF;CAEA,OAAO;AACT"}

package/esm/utils/connect-to-broker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connect-to-broker.mjs","names":[],"sources":["../../../../../../../herald/src/utils/connect-to-broker.ts"],"sourcesContent":["import { Broker, brokerRegistry } from \"../communicators\";\r\nimport type { BrokerDriverContract, ChannelContract } from \"../contracts\";\r\nimport { type EventConsumerClass, EventMessage } from \"../message-managers\";\r\nimport type { ChannelOptions, ConnectionOptions, RabbitMQConnectionOptions } from \"../types\";\r\n\r\n/**\r\n * Connect to a message broker and register it.\r\n *\r\n * This is a high-level utility function that simplifies connection setup\r\n * for most projects. It handles driver instantiation, connection,\r\n * broker creation, and automatic registration.\r\n *\r\n * **Supported Drivers:**\r\n * - `rabbitmq` (default) - RabbitMQ/AMQP driver\r\n * - `kafka` - Apache Kafka driver (coming soon)\r\n *\r\n * @param options - Connection configuration options\r\n * @returns A connected and registered Broker instance\r\n * @throws {Error} If connection fails or driver is not implemented\r\n *\r\n * @example\r\n * ```typescript\r\n * // RabbitMQ connection\r\n * const broker = await connectToBroker({\r\n *   driver: \"rabbitmq\",\r\n *   host: \"localhost\",\r\n *   port: 5672,\r\n *   username: \"guest\",\r\n *   password: \"guest\",\r\n * });\r\n *\r\n * // Use the broker\r\n * await broker.channel(\"user.created\").publish({ userId: 1 });\r\n * ```\r\n *\r\n * @example\r\n * ```typescript\r\n * // Multiple brokers\r\n * await connectToBroker({\r\n *   driver: \"rabbitmq\",\r\n *   name: \"notifications\",\r\n *   isDefault: true,\r\n *   host: process.env.RABBITMQ_HOST,\r\n * });\r\n *\r\n * await connectToBroker({\r\n *   driver: \"rabbitmq\",\r\n *   name: \"analytics\",\r\n *   host: process.env.ANALYTICS_RABBITMQ_HOST,\r\n * });\r\n *\r\n * // Use default broker\r\n * herald().channel(\"notifications\").publish({ ... });\r\n *\r\n * // Use specific broker\r\n * herald(\"analytics\").channel(\"events\").publish({ ... });\r\n * ```\r\n */\r\nexport async function connectToBroker(options: ConnectionOptions): Promise<Broker> {\r\n  // Default values\r\n  const driverType = options.driver ?? \"rabbitmq\";\r\n  const brokerName = options.name ?? \"default\";\r\n  const isDefault = options.isDefault ?? true;\r\n\r\n  // Create driver based on type\r\n  let driver: BrokerDriverContract;\r\n\r\n  switch (driverType) {\r\n    case \"rabbitmq\": {\r\n      const rabbitOptions = options as RabbitMQConnectionOptions;\r\n      // Dynamic import to avoid requiring amqplib if not used\r\n      const { RabbitMQDriver } = await import(\"../drivers/rabbitmq/rabbitmq-driver\");\r\n      driver = new RabbitMQDriver(rabbitOptions);\r\n      break;\r\n    }\r\n\r\n    case \"kafka\": {\r\n      // const kafkaOptions = options as KafkaConnectionOptions;\r\n      // Dynamic import to avoid requiring kafkajs if not used\r\n      throw new Error(\r\n        \"Kafka driver is not yet implemented. Coming soon! For now, please use RabbitMQ.\",\r\n      );\r\n    }\r\n\r\n    default:\r\n      throw new Error(`Unknown driver: \"${driverType}\". Supported drivers: rabbitmq, kafka`);\r\n  }\r\n\r\n  // Create broker\r\n  const broker = brokerRegistry.register({\r\n    name: brokerName,\r\n    driver,\r\n    isDefault,\r\n  });\r\n\r\n  // Connect to the message broker\r\n  try {\r\n    await driver.connect();\r\n  } catch (error) {\r\n    throw new Error(\r\n      `Failed to connect to ${driverType}: ${error instanceof Error ? error.message : String(error)}`,\r\n    );\r\n  }\r\n\r\n  return broker;\r\n}\r\n\r\n/**\r\n * Get a broker by name or the default one.\r\n *\r\n * This is the main entry point for using brokers in your application.\r\n * Named after the package — `herald()` carries your messages!\r\n *\r\n * @param name - Optional broker name (uses default if not provided)\r\n * @returns Broker instance\r\n * @throws MissingBrokerError if broker not found\r\n *\r\n * @example\r\n * // Get default broker\r\n * const channel = herald().channel(\"user.created\");\r\n * await channel.publish({ userId: 1 });\r\n *\r\n * // Get specific broker\r\n * const analyticsChannel = herald(\"analytics\").channel(\"events\");\r\n * await analyticsChannel.publish({ event: \"page_view\" });\r\n *\r\n * // Subscribe to messages\r\n * herald()\r\n *   .channel<UserPayload>(\"user.created\")\r\n *   .subscribe(async (message, ctx) => {\r\n *     console.log(\"User created:\", message.payload);\r\n *     await ctx.ack();\r\n *   });\r\n * ```\r\n */\r\nexport function herald(name?: string): Broker {\r\n  return brokerRegistry.get(name);\r\n}\r\n\r\n/**\r\n * Get channel instance for the given name from default broker.\r\n *\r\n * Shorthand for `herald().channel(name, options)`.\r\n *\r\n * @param name - Channel name\r\n * @param options - Optional channel options\r\n * @returns Channel instance\r\n * @throws MissingBrokerError if broker not found\r\n *\r\n * @example\r\n * ```typescript\r\n * const channel = heraldChannel(\"user.created\");\r\n * await channel.publish({ userId: 1 });\r\n * ```\r\n */\r\nexport function heraldChannel<TPayload = unknown>(\r\n  name: string,\r\n  options?: ChannelOptions<TPayload>,\r\n): ChannelContract<TPayload> {\r\n  return herald().channel<TPayload>(name, options);\r\n}\r\n\r\n/**\r\n * Publish an EventMessage to the default broker.\r\n *\r\n * @param event - Event message to publish\r\n * @returns Promise that resolves when the event is published\r\n * @throws Error if the broker is not connected\r\n *\r\n * @example\r\n * ```typescript\r\n * await publishEvent(new UserUpdatedEvent({ id: 1, name: \"John Doe\" }));\r\n * ```\r\n */\r\nexport async function publishEvent<TPayload = Record<string, any>>(event: EventMessage<TPayload>) {\r\n  return herald().publish(event);\r\n}\r\n\r\n/**\r\n * Subscribe an EventConsumer class to the default broker.\r\n *\r\n * @param Consumer - Event consumer class\r\n * @returns Unsubscribe function\r\n * @throws MissingBrokerError if broker not found\r\n *\r\n * @example\r\n * ```typescript\r\n * await subscribeConsumer(UserUpdatedConsumer);\r\n * ```\r\n */\r\nexport async function subscribeConsumer<TPayload = Record<string, any>>(\r\n  Consumer: EventConsumerClass<TPayload>,\r\n) {\r\n  return herald().subscribe(Consumer);\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DA,eAAsB,gBAAgB,SAA6C;CAEjF,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,aAAa,QAAQ,QAAQ;CACnC,MAAM,YAAY,QAAQ,aAAa;CAGvC,IAAI;CAEJ,QAAQ,YAAR;EACE,KAAK,YAAY;GACf,MAAM,gBAAgB;GAEtB,MAAM,EAAE,mBAAmB,MAAM,OAAO;GACxC,SAAS,IAAI,eAAe,aAAa;GACzC;EACF;EAEA,KAAK,SAGH,MAAM,IAAI,MACR,iFACF;EAGF,SACE,MAAM,IAAI,MAAM,oBAAoB,WAAW,sCAAsC;CACzF;CAGA,MAAM,SAAS,eAAe,SAAS;EACrC,MAAM;EACN;EACA;CACF,CAAC;CAGD,IAAI;EACF,MAAM,OAAO,QAAQ;CACvB,SAAS,OAAO;EACd,MAAM,IAAI,MACR,wBAAwB,WAAW,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAC9F;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,OAAO,MAAuB;CAC5C,OAAO,eAAe,IAAI,IAAI;AAChC;;;;;;;;;;;;;;;;;AAkBA,SAAgB,cACd,MACA,SAC2B;CAC3B,OAAO,OAAO,CAAC,CAAC,QAAkB,MAAM,OAAO;AACjD;;;;;;;;;;;;;AAcA,eAAsB,aAA6C,OAA+B;CAChG,OAAO,OAAO,CAAC,CAAC,QAAQ,KAAK;AAC/B;;;;;;;;;;;;;AAcA,eAAsB,kBACpB,UACA;CACA,OAAO,OAAO,CAAC,CAAC,UAAU,QAAQ;AACpC"}
+{"version":3,"file":"connect-to-broker.mjs","names":[],"sources":["../../../../../../../herald/src/utils/connect-to-broker.ts"],"sourcesContent":["import { Broker, brokerRegistry } from \"../communicators\";\nimport type { BrokerDriverContract, ChannelContract } from \"../contracts\";\nimport { type EventConsumerClass, EventMessage } from \"../message-managers\";\nimport type { ChannelOptions, ConnectionOptions, RabbitMQConnectionOptions } from \"../types\";\n\n/**\n * Connect to a message broker and register it.\n *\n * This is a high-level utility function that simplifies connection setup\n * for most projects. It handles driver instantiation, connection,\n * broker creation, and automatic registration.\n *\n * **Supported Drivers:**\n * - `rabbitmq` (default) - RabbitMQ/AMQP driver\n * - `kafka` - Apache Kafka driver (coming soon)\n *\n * @param options - Connection configuration options\n * @returns A connected and registered Broker instance\n * @throws {Error} If connection fails or driver is not implemented\n *\n * @example\n * ```typescript\n * // RabbitMQ connection\n * const broker = await connectToBroker({\n *   driver: \"rabbitmq\",\n *   host: \"localhost\",\n *   port: 5672,\n *   username: \"guest\",\n *   password: \"guest\",\n * });\n *\n * // Use the broker\n * await broker.channel(\"user.created\").publish({ userId: 1 });\n * ```\n *\n * @example\n * ```typescript\n * // Multiple brokers\n * await connectToBroker({\n *   driver: \"rabbitmq\",\n *   name: \"notifications\",\n *   isDefault: true,\n *   host: process.env.RABBITMQ_HOST,\n * });\n *\n * await connectToBroker({\n *   driver: \"rabbitmq\",\n *   name: \"analytics\",\n *   host: process.env.ANALYTICS_RABBITMQ_HOST,\n * });\n *\n * // Use default broker\n * herald().channel(\"notifications\").publish({ ... });\n *\n * // Use specific broker\n * herald(\"analytics\").channel(\"events\").publish({ ... });\n * ```\n */\nexport async function connectToBroker(options: ConnectionOptions): Promise<Broker> {\n  // Default values\n  const driverType = options.driver ?? \"rabbitmq\";\n  const brokerName = options.name ?? \"default\";\n  const isDefault = options.isDefault ?? true;\n\n  // Create driver based on type\n  let driver: BrokerDriverContract;\n\n  switch (driverType) {\n    case \"rabbitmq\": {\n      const rabbitOptions = options as RabbitMQConnectionOptions;\n      // Dynamic import to avoid requiring amqplib if not used\n      const { RabbitMQDriver } = await import(\"../drivers/rabbitmq/rabbitmq-driver\");\n      driver = new RabbitMQDriver(rabbitOptions);\n      break;\n    }\n\n    case \"kafka\": {\n      // const kafkaOptions = options as KafkaConnectionOptions;\n      // Dynamic import to avoid requiring kafkajs if not used\n      throw new Error(\n        \"Kafka driver is not yet implemented. Coming soon! For now, please use RabbitMQ.\",\n      );\n    }\n\n    default:\n      throw new Error(`Unknown driver: \"${driverType}\". Supported drivers: rabbitmq, kafka`);\n  }\n\n  // Create broker\n  const broker = brokerRegistry.register({\n    name: brokerName,\n    driver,\n    isDefault,\n  });\n\n  // Connect to the message broker\n  try {\n    await driver.connect();\n  } catch (error) {\n    throw new Error(\n      `Failed to connect to ${driverType}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  return broker;\n}\n\n/**\n * Get a broker by name or the default one.\n *\n * This is the main entry point for using brokers in your application.\n * Named after the package — `herald()` carries your messages!\n *\n * @param name - Optional broker name (uses default if not provided)\n * @returns Broker instance\n * @throws MissingBrokerError if broker not found\n *\n * @example\n * // Get default broker\n * const channel = herald().channel(\"user.created\");\n * await channel.publish({ userId: 1 });\n *\n * // Get specific broker\n * const analyticsChannel = herald(\"analytics\").channel(\"events\");\n * await analyticsChannel.publish({ event: \"page_view\" });\n *\n * // Subscribe to messages\n * herald()\n *   .channel<UserPayload>(\"user.created\")\n *   .subscribe(async (message, ctx) => {\n *     console.log(\"User created:\", message.payload);\n *     await ctx.ack();\n *   });\n * ```\n */\nexport function herald(name?: string): Broker {\n  return brokerRegistry.get(name);\n}\n\n/**\n * Get channel instance for the given name from default broker.\n *\n * Shorthand for `herald().channel(name, options)`.\n *\n * @param name - Channel name\n * @param options - Optional channel options\n * @returns Channel instance\n * @throws MissingBrokerError if broker not found\n *\n * @example\n * ```typescript\n * const channel = heraldChannel(\"user.created\");\n * await channel.publish({ userId: 1 });\n * ```\n */\nexport function heraldChannel<TPayload = unknown>(\n  name: string,\n  options?: ChannelOptions<TPayload>,\n): ChannelContract<TPayload> {\n  return herald().channel<TPayload>(name, options);\n}\n\n/**\n * Publish an EventMessage to the default broker.\n *\n * @param event - Event message to publish\n * @returns Promise that resolves when the event is published\n * @throws Error if the broker is not connected\n *\n * @example\n * ```typescript\n * await publishEvent(new UserUpdatedEvent({ id: 1, name: \"John Doe\" }));\n * ```\n */\nexport async function publishEvent<TPayload = Record<string, any>>(event: EventMessage<TPayload>) {\n  return herald().publish(event);\n}\n\n/**\n * Subscribe an EventConsumer class to the default broker.\n *\n * @param Consumer - Event consumer class\n * @returns Unsubscribe function\n * @throws MissingBrokerError if broker not found\n *\n * @example\n * ```typescript\n * await subscribeConsumer(UserUpdatedConsumer);\n * ```\n */\nexport async function subscribeConsumer<TPayload = Record<string, any>>(\n  Consumer: EventConsumerClass<TPayload>,\n) {\n  return herald().subscribe(Consumer);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DA,eAAsB,gBAAgB,SAA6C;CAEjF,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,aAAa,QAAQ,QAAQ;CACnC,MAAM,YAAY,QAAQ,aAAa;CAGvC,IAAI;CAEJ,QAAQ,YAAR;EACE,KAAK,YAAY;GACf,MAAM,gBAAgB;GAEtB,MAAM,EAAE,mBAAmB,MAAM,OAAO;GACxC,SAAS,IAAI,eAAe,aAAa;GACzC;EACF;EAEA,KAAK,SAGH,MAAM,IAAI,MACR,iFACF;EAGF,SACE,MAAM,IAAI,MAAM,oBAAoB,WAAW,sCAAsC;CACzF;CAGA,MAAM,SAAS,eAAe,SAAS;EACrC,MAAM;EACN;EACA;CACF,CAAC;CAGD,IAAI;EACF,MAAM,OAAO,QAAQ;CACvB,SAAS,OAAO;EACd,MAAM,IAAI,MACR,wBAAwB,WAAW,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAC9F;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,OAAO,MAAuB;CAC5C,OAAO,eAAe,IAAI,IAAI;AAChC;;;;;;;;;;;;;;;;;AAkBA,SAAgB,cACd,MACA,SAC2B;CAC3B,OAAO,OAAO,CAAC,CAAC,QAAkB,MAAM,OAAO;AACjD;;;;;;;;;;;;;AAcA,eAAsB,aAA6C,OAA+B;CAChG,OAAO,OAAO,CAAC,CAAC,QAAQ,KAAK;AAC/B;;;;;;;;;;;;;AAcA,eAAsB,kBACpB,UACA;CACA,OAAO,OAAO,CAAC,CAAC,UAAU,QAAQ;AACpC"}