@warlock.js/herald 4.0.166 → 4.0.171

package/cjs/communicators/broker-registry.d.ts

@@ -0,0 +1,155 @@
+import type { BrokerRegistryEvent, BrokerRegistryListener } from "../types";
+import { Broker, type BrokerOptions } from "./broker";
+/**
+ * Error thrown when a broker is not found
+ */
+export declare class MissingBrokerError extends Error {
+    readonly brokerName?: string;
+    constructor(message: string, brokerName?: string);
+}
+/**
+ * Broker Registry
+ *
+ * Maintains registry of named brokers.
+ * Similar to DataSourceRegistry in @warlock.js/cascade
+ *
+ * @example
+ * ```typescript
+ * // Register a broker
+ * brokerRegistry.register({
+ *   name: "default",
+ *   driver: rabbitMQDriver,
+ *   isDefault: true,
+ * });
+ *
+ * // Get the default broker
+ * const comm = brokerRegistry.get();
+ *
+ * // Get a specific broker by name
+ * const analytics = brokerRegistry.get("analytics");
+ *
+ * // Listen for events
+ * brokerRegistry.on("connected", (comm) => {
+ *   console.log(`${comm.name} connected`);
+ * });
+ * ```
+ */
+declare class BrokerRegistry {
+    private readonly sources;
+    private defaultSource?;
+    private readonly events;
+    /**
+     * Register a new broker
+     *
+     * Sets up event forwarding from the driver to the registry.
+     *
+     * @param options - Broker configuration
+     * @returns The registered broker instance
+     *
+     * @example
+     * ```typescript
+     * const broker = brokerRegistry.register({
+     *   name: "primary",
+     *   driver: myDriver,
+     *   isDefault: true,
+     * });
+     * ```
+     */
+    register(options: BrokerOptions): Broker;
+    /**
+     * Clear all registered brokers
+     */
+    clear(): void;
+    /**
+     * Listen for registry events
+     *
+     * @param event - Event to listen for
+     * @param listener - Callback function
+     *
+     * @example
+     * ```typescript
+     * brokerRegistry.on("registered", (comm) => {
+     *   console.log(`Broker "${comm.name}" registered`);
+     * });
+     *
+     * brokerRegistry.on("connected", (comm) => {
+     *   console.log(`Broker "${comm.name}" connected`);
+     * });
+     * ```
+     */
+    on(event: BrokerRegistryEvent, listener: BrokerRegistryListener): void;
+    /**
+     * Listen for a registry event once
+     *
+     * @param event - Event to listen for
+     * @param listener - Callback function
+     */
+    once(event: BrokerRegistryEvent, listener: BrokerRegistryListener): void;
+    /**
+     * Remove an event listener
+     *
+     * @param event - Event to stop listening for
+     * @param listener - Callback to remove
+     */
+    off(event: BrokerRegistryEvent, listener: BrokerRegistryListener): void;
+    /**
+     * Get a broker by name or the default one
+     *
+     * @param name - Optional broker name
+     * @returns Broker instance
+     * @throws MissingBrokerError if not found
+     *
+     * @example
+     * ```typescript
+     * // Get default broker
+     * const comm = brokerRegistry.get();
+     *
+     * // Get specific broker
+     * const analytics = brokerRegistry.get("analytics");
+     * ```
+     */
+    get(name?: string): Broker;
+    /**
+     * Check if a broker exists
+     *
+     * @param name - Broker name to check
+     * @returns True if exists
+     */
+    has(name: string): boolean;
+    /**
+     * Check if any brokers are registered
+     */
+    hasAny(): boolean;
+    /**
+     * Get all registered brokers
+     *
+     * @returns Array of all brokers
+     *
+     * @example
+     * ```typescript
+     * // Disconnect all brokers
+     * for (const comm of brokerRegistry.getAll()) {
+     *   await comm.disconnect();
+     * }
+     * ```
+     */
+    getAll(): Broker[];
+    /**
+     * Get all broker names
+     *
+     * @returns Array of broker names
+     */
+    getNames(): string[];
+    /**
+     * Get the default broker (if any)
+     *
+     * @returns Default broker or undefined
+     */
+    getDefault(): Broker | undefined;
+}
+/**
+ * Global broker registry instance
+ */
+export declare const brokerRegistry: BrokerRegistry;
+export {};
+//# sourceMappingURL=broker-registry.d.ts.map

package/cjs/communicators/broker-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-registry.d.ts","sourceRoot":"","sources":["../../src/communicators/broker-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IA6B/C;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;;;;;;;;;;;;;;;OAgBG;IACI,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAI7E;;;;;OAKG;IACI,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAI/E;;;;;OAKG;IACI,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAI9E;;;;;;;;;;;;;;;OAeG;IACI,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAgBjC;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACI,MAAM,IAAI,OAAO;IAIxB;;;;;;;;;;;;OAYG;IACI,MAAM,IAAI,MAAM,EAAE;IAIzB;;;;OAIG;IACI,QAAQ,IAAI,MAAM,EAAE;IAI3B;;;;OAIG;IACI,UAAU,IAAI,MAAM,GAAG,SAAS;CAGxC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/cjs/communicators/broker-registry.js

@@ -0,0 +1,206 @@
+'use strict';var node_events=require('node:events'),broker=require('./broker.js');/**
+ * Error thrown when a broker is not found
+ */
+class MissingBrokerError extends Error {
+    brokerName;
+    constructor(message, brokerName) {
+        super(message);
+        this.name = "MissingBrokerError";
+        this.brokerName = brokerName;
+    }
+}
+/**
+ * Broker Registry
+ *
+ * Maintains registry of named brokers.
+ * Similar to DataSourceRegistry in @warlock.js/cascade
+ *
+ * @example
+ * ```typescript
+ * // Register a broker
+ * brokerRegistry.register({
+ *   name: "default",
+ *   driver: rabbitMQDriver,
+ *   isDefault: true,
+ * });
+ *
+ * // Get the default broker
+ * const comm = brokerRegistry.get();
+ *
+ * // Get a specific broker by name
+ * const analytics = brokerRegistry.get("analytics");
+ *
+ * // Listen for events
+ * brokerRegistry.on("connected", (comm) => {
+ *   console.log(`${comm.name} connected`);
+ * });
+ * ```
+ */
+class BrokerRegistry {
+    sources = new Map();
+    defaultSource;
+    events = new node_events.EventEmitter();
+    /**
+     * Register a new broker
+     *
+     * Sets up event forwarding from the driver to the registry.
+     *
+     * @param options - Broker configuration
+     * @returns The registered broker instance
+     *
+     * @example
+     * ```typescript
+     * const broker = brokerRegistry.register({
+     *   name: "primary",
+     *   driver: myDriver,
+     *   isDefault: true,
+     * });
+     * ```
+     */
+    register(options) {
+        const broker$1 = new broker.Broker(options);
+        this.sources.set(broker$1.name, broker$1);
+        const isNewDefault = broker$1.isDefault || !this.defaultSource;
+        if (isNewDefault) {
+            this.defaultSource = broker$1;
+        }
+        // Emit registration events
+        this.events.emit("registered", broker$1);
+        if (isNewDefault) {
+            this.events.emit("default-registered", broker$1);
+        }
+        // Forward driver events to registry
+        broker$1.driver.on("connected", () => {
+            this.events.emit("connected", broker$1);
+        });
+        broker$1.driver.on("disconnected", () => {
+            this.events.emit("disconnected", broker$1);
+        });
+        return broker$1;
+    }
+    /**
+     * Clear all registered brokers
+     */
+    clear() {
+        this.defaultSource = undefined;
+        this.sources.clear();
+    }
+    /**
+     * Listen for registry events
+     *
+     * @param event - Event to listen for
+     * @param listener - Callback function
+     *
+     * @example
+     * ```typescript
+     * brokerRegistry.on("registered", (comm) => {
+     *   console.log(`Broker "${comm.name}" registered`);
+     * });
+     *
+     * brokerRegistry.on("connected", (comm) => {
+     *   console.log(`Broker "${comm.name}" connected`);
+     * });
+     * ```
+     */
+    on(event, listener) {
+        this.events.on(event, listener);
+    }
+    /**
+     * Listen for a registry event once
+     *
+     * @param event - Event to listen for
+     * @param listener - Callback function
+     */
+    once(event, listener) {
+        this.events.once(event, listener);
+    }
+    /**
+     * Remove an event listener
+     *
+     * @param event - Event to stop listening for
+     * @param listener - Callback to remove
+     */
+    off(event, listener) {
+        this.events.off(event, listener);
+    }
+    /**
+     * Get a broker by name or the default one
+     *
+     * @param name - Optional broker name
+     * @returns Broker instance
+     * @throws MissingBrokerError if not found
+     *
+     * @example
+     * ```typescript
+     * // Get default broker
+     * const comm = brokerRegistry.get();
+     *
+     * // Get specific broker
+     * const analytics = brokerRegistry.get("analytics");
+     * ```
+     */
+    get(name) {
+        if (name !== undefined) {
+            const source = this.sources.get(name);
+            if (!source) {
+                throw new MissingBrokerError(`Broker "${name}" is not registered.`, name);
+            }
+            return source;
+        }
+        if (!this.defaultSource) {
+            throw new MissingBrokerError("No default broker registered.");
+        }
+        return this.defaultSource;
+    }
+    /**
+     * Check if a broker exists
+     *
+     * @param name - Broker name to check
+     * @returns True if exists
+     */
+    has(name) {
+        return this.sources.has(name);
+    }
+    /**
+     * Check if any brokers are registered
+     */
+    hasAny() {
+        return this.sources.size > 0;
+    }
+    /**
+     * Get all registered brokers
+     *
+     * @returns Array of all brokers
+     *
+     * @example
+     * ```typescript
+     * // Disconnect all brokers
+     * for (const comm of brokerRegistry.getAll()) {
+     *   await comm.disconnect();
+     * }
+     * ```
+     */
+    getAll() {
+        return Array.from(this.sources.values());
+    }
+    /**
+     * Get all broker names
+     *
+     * @returns Array of broker names
+     */
+    getNames() {
+        return Array.from(this.sources.keys());
+    }
+    /**
+     * Get the default broker (if any)
+     *
+     * @returns Default broker or undefined
+     */
+    getDefault() {
+        return this.defaultSource;
+    }
+}
+/**
+ * Global broker registry instance
+ */
+const brokerRegistry = new BrokerRegistry();exports.MissingBrokerError=MissingBrokerError;exports.brokerRegistry=brokerRegistry;//# sourceMappingURL=broker-registry.js.map

package/cjs/communicators/broker-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-registry.js","sources":["../../src/communicators/broker-registry.ts"],"sourcesContent":[null],"names":["EventEmitter","broker","Broker"],"mappings":"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"}

package/{esm/communicators/communicator.d.ts → cjs/communicators/broker.d.ts}

@@ -1,49 +1,49 @@
-import type { CommunicatorDriverContract } from "../contracts";
+import type { BrokerDriverContract } from "../contracts";
 import type { ChannelContract } from "../contracts/channel.contract";
 import { EventMessage } from "../message-managers/event-message";
 import { EventConsumerClass } from "../message-managers/types";
 import type { ChannelOptions } from "../types";
 /**
- * Options for creating a Communicator
+ * Options for creating a Broker
  */
-export interface CommunicatorOptions {
-    /** Unique name for this communicator */
+export interface BrokerOptions {
+    /** Unique name for this broker */
     name: string;
     /** The underlying driver */
-    driver: CommunicatorDriverContract;
-    /** Whether this is the default communicator */
+    driver: BrokerDriverContract;
+    /** Whether this is the default broker */
     isDefault?: boolean;
 }
 /**
- * Communicator - wrapper around a driver with metadata
+ * Broker - wrapper around a driver with metadata
  *
  * Similar to DataSource in @warlock.js/cascade
  *
  * @example
  * ```typescript
- * const communicator = new Communicator({
+ * const broker = new Broker({
  *   name: "default",
  *   driver: rabbitMQDriver,
  *   isDefault: true,
  * });
  *
  * // Get a channel
- * const channel = communicator.channel("user.created");
+ * const channel = broker.channel("user.created");
  * ```
  */
-export declare class Communicator {
-    /** Unique name identifying this communicator */
+export declare class Broker {
+    /** Unique name identifying this broker */
     readonly name: string;
     /** The underlying driver */
-    readonly driver: CommunicatorDriverContract;
-    /** Whether this is the default communicator */
+    readonly driver: BrokerDriverContract;
+    /** Whether this is the default broker */
     readonly isDefault: boolean;
     /**
-     * Create a new Communicator
+     * Create a new Broker
      *
-     * @param options - Communicator configuration
+     * @param options - Broker configuration
      */
-    constructor(options: CommunicatorOptions);
+    constructor(options: BrokerOptions);
     /**
      * Subscribe the given consumer
      */
@@ -62,10 +62,10 @@ export declare class Communicator {
      * @example
      * ```typescript
      * // Simple channel
-     * const channel = communicator.channel("notifications");
+     * const channel = broker.channel("notifications");
      *
      * // Typed channel with schema
-     * const orderChannel = communicator.channel<OrderPayload>("orders", {
+     * const orderChannel = broker.channel<OrderPayload>("orders", {
      *   schema: OrderSchema,
      *   durable: true,
      * });
@@ -73,7 +73,7 @@ export declare class Communicator {
      */
     channel<TPayload = unknown>(name: string, options?: ChannelOptions<TPayload>): ChannelContract<TPayload>;
     /**
-     * Check if the communicator is connected
+     * Check if the broker is connected
      */
     get isConnected(): boolean;
     /**
@@ -97,4 +97,4 @@ export declare class Communicator {
      */
     healthCheck(): Promise<import("../types").HealthCheckResult>;
 }
-//# sourceMappingURL=communicator.d.ts.map
+//# sourceMappingURL=broker.d.ts.map

package/cjs/communicators/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/communicators/broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,MAAM;IACjB,0CAA0C;IAC1C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,4BAA4B;IAC5B,SAAgB,MAAM,EAAE,oBAAoB,CAAC;IAE7C,yCAAyC;IACzC,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC;;;;OAIG;gBACgB,OAAO,EAAE,aAAa;IAMzC;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC;IAIlD;;OAEG;IACI,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;IAI5E;;;;;;;;;;;;;;;;;;OAkBG;IACI,OAAO,CAAC,QAAQ,GAAG,OAAO,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GACjC,eAAe,CAAC,QAAQ,CAAC;IAI5B;;OAEG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACU,WAAW;CAGzB"}

package/cjs/communicators/{communicator.js → broker.js}

@@ -1,31 +1,31 @@
 'use strict';/**
- * Communicator - wrapper around a driver with metadata
+ * Broker - wrapper around a driver with metadata
  *
  * Similar to DataSource in @warlock.js/cascade
  *
  * @example
  * ```typescript
- * const communicator = new Communicator({
+ * const broker = new Broker({
  *   name: "default",
  *   driver: rabbitMQDriver,
  *   isDefault: true,
  * });
  *
  * // Get a channel
- * const channel = communicator.channel("user.created");
+ * const channel = broker.channel("user.created");
  * ```
  */
-class Communicator {
-    /** Unique name identifying this communicator */
+class Broker {
+    /** Unique name identifying this broker */
     name;
     /** The underlying driver */
     driver;
-    /** Whether this is the default communicator */
+    /** Whether this is the default broker */
     isDefault;
     /**
-     * Create a new Communicator
+     * Create a new Broker
      *
-     * @param options - Communicator configuration
+     * @param options - Broker configuration
      */
     constructor(options) {
         this.name = options.name;
@@ -54,10 +54,10 @@ class Communicator {
      * @example
      * ```typescript
      * // Simple channel
-     * const channel = communicator.channel("notifications");
+     * const channel = broker.channel("notifications");
      *
      * // Typed channel with schema
-     * const orderChannel = communicator.channel<OrderPayload>("orders", {
+     * const orderChannel = broker.channel<OrderPayload>("orders", {
      *   schema: OrderSchema,
      *   durable: true,
      * });
@@ -67,7 +67,7 @@ class Communicator {
         return this.driver.channel(name, options);
     }
     /**
-     * Check if the communicator is connected
+     * Check if the broker is connected
      */
     get isConnected() {
         return this.driver.isConnected;
@@ -102,4 +102,4 @@ class Communicator {
     async healthCheck() {
         return this.driver.healthCheck();
     }
-}exports.Communicator=Communicator;//# sourceMappingURL=communicator.js.map
+}exports.Broker=Broker;//# sourceMappingURL=broker.js.map

package/cjs/communicators/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sources":["../../src/communicators/broker.ts"],"sourcesContent":[null],"names":[],"mappings":"aAkBA;;;;;;;;;;;;;;;;AAgBG;MACU,MAAM,CAAA;;AAED,IAAA,IAAI,CAAS;;AAGb,IAAA,MAAM,CAAuB;;AAG7B,IAAA,SAAS,CAAU;AAEnC;;;;AAIG;AACH,IAAA,WAAA,CAAmB,OAAsB,EAAA;AACvC,QAAA,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AACzB,QAAA,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;KAC7C;AAED;;AAEG;AACI,IAAA,SAAS,CAAC,QAAiC,EAAA;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;KACxC;AAED;;AAEG;AACI,IAAA,OAAO,CAAiC,KAA6B,EAAA;AAC1E,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;KAC5B;AAED;;;;;;;;;;;;;;;;;;AAkBG;IACI,OAAO,CACZ,IAAY,EACZ,OAAkC,EAAA;QAElC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAW,IAAI,EAAE,OAAO,CAAC,CAAC;KACrD;AAED;;AAEG;AACH,IAAA,IAAW,WAAW,GAAA;AACpB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;KAChC;AAED;;AAEG;AACI,IAAA,MAAM,OAAO,GAAA;AAClB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;KAC7B;AAED;;AAEG;AACI,IAAA,MAAM,UAAU,GAAA;AACrB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;KAChC;AAED;;AAEG;AACI,IAAA,MAAM,cAAc,GAAA;AACzB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;KACpC;AAED;;AAEG;AACI,IAAA,MAAM,aAAa,GAAA;AACxB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;KACnC;AAED;;AAEG;AACI,IAAA,MAAM,WAAW,GAAA;AACtB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;KAClC;AACF"}

package/cjs/communicators/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./communicator";
-export * from "./communicator-registry";
+export * from "./broker";
+export * from "./broker-registry";
 //# sourceMappingURL=index.d.ts.map

package/cjs/communicators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/communicators/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/communicators/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC"}

package/{esm/contracts/communicator-driver.contract.d.ts → cjs/contracts/broker-driver.contract.d.ts}

@@ -1,9 +1,9 @@
 import { type EventMessage } from "../message-managers/event-message";
 import { EventConsumerClass } from "../message-managers/types";
-import type { ChannelOptions, CommunicatorDriverType, CommunicatorEvent, CommunicatorEventListener, HealthCheckResult } from "../types";
+import type { BrokerDriverType, BrokerEvent, BrokerEventListener, ChannelOptions, HealthCheckResult } from "../types";
 import type { ChannelContract } from "./channel.contract";
 /**
- * Communicator Driver Contract
+ * Broker Driver Contract
  *
  * Base contract for all message bus drivers (RabbitMQ, Kafka, etc.)
  * Similar to DriverContract in @warlock.js/cascade
@@ -11,19 +11,19 @@ import type { ChannelContract } from "./channel.contract";
  * @example
  * ```typescript
  * // Driver implementation
- * class RabbitMQDriver implements CommunicatorDriverContract {
+ * class RabbitMQDriver implements BrokerDriverContract {
  *   readonly name = "rabbitmq";
  *   // ...
  * }
  * ```
  */
-export interface CommunicatorDriverContract {
+export interface BrokerDriverContract {
     /**
      * Driver name identifier
      *
      * @example "rabbitmq", "kafka", "redis-streams"
      */
-    readonly name: CommunicatorDriverType;
+    readonly name: BrokerDriverType;
     /**
      * Whether currently connected to the message broker
      */
@@ -76,14 +76,14 @@ export interface CommunicatorDriverContract {
      * });
      * ```
      */
-    on(event: CommunicatorEvent, listener: CommunicatorEventListener): void;
+    on(event: BrokerEvent, listener: BrokerEventListener): void;
     /**
      * Remove an event listener
      *
      * @param event - Event name
      * @param listener - Callback to remove
      */
-    off(event: CommunicatorEvent, listener: CommunicatorEventListener): void;
+    off(event: BrokerEvent, listener: BrokerEventListener): void;
     /**
      * Subscribe the given consumer class to the driver
      *
@@ -193,4 +193,4 @@ export interface CommunicatorDriverContract {
      */
     closeChannel(name: string): Promise<void>;
 }
-//# sourceMappingURL=communicator-driver.contract.d.ts.map
+//# sourceMappingURL=broker-driver.contract.d.ts.map

package/cjs/contracts/broker-driver.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-driver.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/broker-driver.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;;OAUG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;;;;;;OASG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7D;;;;;;;;;OASG;IACH,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAC;IAEpD;;;;;;;;;OASG;IACH,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAE7E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,QAAQ,GAAG,OAAO,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GACjC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE7B;;;;;;;;;;;;;;OAcG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;;;;;OASG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;OAcG;IACH,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE1C;;;;OAIG;IACH,eAAe,IAAI,MAAM,EAAE,CAAC;IAE5B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/cjs/contracts/channel.contract.d.ts

@@ -9,7 +9,7 @@ import type { ChannelOptions, ChannelStats, MessageHandler, PublishOptions, Requ
  * @example
  * ```typescript
  * // Get a typed channel
- * const userChannel = communicators().channel<UserPayload>("user.created");
+ * const userChannel = herald().channel<UserPayload>("user.created");
  *
  * // Publish
  * await userChannel.publish({ userId: 1, email: "test@example.com" });
@@ -182,5 +182,10 @@ export interface ChannelContract<TPayload = unknown> {
      * Creates the channel if it doesn't exist, or verifies options match.
      */
     assert(): Promise<void>;
+    /**
+     * Stop consuming messages on this channel.
+     * Cancels all active subscriptions gracefully.
+     */
+    stopConsuming(): Promise<void>;
 }
 //# sourceMappingURL=channel.contract.d.ts.map

package/cjs/contracts/channel.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/channel.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IACjD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3C;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhG;;;;;;;;;OASG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE9F;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,SAAS,GAAG,OAAO,EACzB,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,GAC5C,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/B;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3B;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}
+{"version":3,"file":"channel.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/channel.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IACjD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3C;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhG;;;;;;;;;OASG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE9F;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,SAAS,GAAG,OAAO,EACzB,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,GAC5C,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/B;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3B;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC"}

package/cjs/contracts/index.d.ts

@@ -1,3 +1,3 @@
 export * from "./channel.contract";
-export * from "./communicator-driver.contract";
+export * from "./broker-driver.contract";
 //# sourceMappingURL=index.d.ts.map

package/cjs/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}