@warlock.js/herald 4.0.174 → 4.1.2

package/skills/request-and-respond/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: request-and-respond
+description: 'Synchronous-style RPC over the message bus — channel.request<R>(payload, {timeout}) waits for a reply, channel.respond(handler) registers the responder, ctx.reply(response) sends the answer. Triggers: `channel.request`, `channel.respond`, `ctx.reply`, `timeout`, `correlationId`, `headers.correlationId`; "RPC over message bus", "request-response across services", "wait for a reply", "internal service-to-service call instead of HTTP"; typical import `import { herald } from "@warlock.js/herald"`. Skip: setup — `@warlock.js/herald/herald-basics/SKILL.md`; fire-and-forget — `@warlock.js/herald/publish-message/SKILL.md`; consumer ctx flow — `@warlock.js/herald/consume-message/SKILL.md`; competing libs `amqplib` RPC, `nats` request/reply; NestJS `ClientProxy.send`; gRPC; HTTP.'
+---
+
+# Request-response over the bus
+
+Most messaging is fire-and-forget. When you need a reply, use the request/respond pair — a reply-queue + correlation-id pattern under the hood, surfaced as a typed promise.
+
+## Shape
+
+```ts
+// Caller (client)
+const response = await herald()
+  .channel<RequestPayload>("compute.tax")
+  .request<TaxResponse>({ amount: 1000, country: "US" }, { timeout: 30_000 });
+
+// Responder (server)
+herald()
+  .channel<RequestPayload>("compute.tax")
+  .respond(async (message, ctx) => {
+    const tax = await computeTax(message.payload);
+    return { tax, currency: "USD" }; // ← the return value IS the reply
+  });
+```
+
+`request` returns a promise that resolves with the responder's return value. `respond` registers a handler and **automatically replies with whatever the handler returns** (then acks) — so just `return` the response; you don't call `ctx.reply()` yourself inside a `respond` handler. (`ctx.reply` is the lower-level primitive used when you wire a plain `.subscribe()` as a responder by hand.)
+
+## Timeout
+
+```ts
+await channel.request(payload, { timeout: 30_000 });
+```
+
+The promise rejects if no reply arrives within `timeout` ms. Pick a sane number — too short rejects mid-work; too long lets a hung responder block the caller.
+
+## When to use it vs HTTP
+
+| Use HTTP | Use request/respond |
+| --- | --- |
+| Stateless, fast, idempotent ops | Slow / queued ops where the caller can wait |
+| Public API surface | Internal service-to-service |
+| Frontend consumption | Backend orchestration |
+| Synchronous user-facing flow | Async-but-needs-result patterns |
+
+The bus adds queue persistence and retry. HTTP is faster for sub-100ms ops; the bus shines when the operation has variable duration or needs a queue's backpressure.
+
+## When NOT to use it
+
+- "I need a result in under 50ms" — too much overhead on the bus.
+- "The responder might be down for hours" — request will time out repeatedly; consider `publish` + write the result somewhere the caller polls.
+- "Many callers, the response is the same for all" — cache the result and use `publish` for invalidation.
+
+## Multiple responders
+
+`respond(handler)` takes no options — there's no `group` knob here. If multiple consumers `respond()` to the same channel, they all sit on the same queue, so RabbitMQ round-robins between them: **one responder handles each request, and the caller gets exactly one reply.** That's the "share work across responders" pattern — a synchronous worker pool. Make every responder functionally identical, since the caller has no say in which one answers.
+
+For "multiple replies expected" patterns, use a regular `subscribe` + a request id, then the caller listens on a result channel.
+
+## Correlation across replies
+
+Each `request()` generates its own correlation ID and an exclusive reply queue under the hood. The reply carries the same ID; the client matches it to the awaiting promise and resolves. You don't manage correlation IDs manually — and you shouldn't pass your own `correlationId` on a `request()`, since herald overwrites it with the one it uses to match the reply. To thread your own trace id (e.g. a transaction id for logs) through to the responder, put it in `headers` instead — the responder reads it from `message.metadata.headers`.
+
+## Things NOT to do
+
+- Don't use request/respond for high-throughput, low-latency ops. The reply-queue round-trip adds at least one broker hop. HTTP is the right tool.
+- Don't return huge payloads from `respond`. Reply messages travel through the broker; a multi-MB response is a load on the bus and on memory. For big results, write to S3 / cache and reply with a reference.
+- Don't forget to `respond` in long-lived consumers. If the responder crashes, every caller's request will time out — they don't know why.
+- Don't set timeout to `Infinity`. A stuck request becomes a leaked promise — set a real timeout and handle the rejection.
+
+## See also
+
+- [`@warlock.js/herald/publish-message/SKILL.md`](@warlock.js/herald/publish-message/SKILL.md) — fire-and-forget pattern
+- [`@warlock.js/herald/consume-message/SKILL.md`](@warlock.js/herald/consume-message/SKILL.md) — subscribe + ctx flow control (including `ctx.reply`)

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

@@ -1,155 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,206 +0,0 @@
-'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

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

package/cjs/communicators/broker.d.ts

@@ -1,100 +0,0 @@
-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 Broker
- */
-export interface BrokerOptions {
-    /** Unique name for this broker */
-    name: string;
-    /** The underlying driver */
-    driver: BrokerDriverContract;
-    /** Whether this is the default broker */
-    isDefault?: boolean;
-}
-/**
- * Broker - wrapper around a driver with metadata
- *
- * Similar to DataSource in @warlock.js/cascade
- *
- * @example
- * ```typescript
- * const broker = new Broker({
- *   name: "default",
- *   driver: rabbitMQDriver,
- *   isDefault: true,
- * });
- *
- * // Get a channel
- * const channel = broker.channel("user.created");
- * ```
- */
-export declare class Broker {
-    /** Unique name identifying this broker */
-    readonly name: string;
-    /** The underlying driver */
-    readonly driver: BrokerDriverContract;
-    /** Whether this is the default broker */
-    readonly isDefault: boolean;
-    /**
-     * Create a new Broker
-     *
-     * @param options - Broker configuration
-     */
-    constructor(options: BrokerOptions);
-    /**
-     * Subscribe the given consumer
-     */
-    subscribe(consumer: EventConsumerClass<any>): () => void;
-    /**
-     * Publish the given event message
-     */
-    publish<TPayload = Record<string, any>>(event: EventMessage<TPayload>): void;
-    /**
-     * Get or create a channel
-     *
-     * @param name - Channel name
-     * @param options - Channel options
-     * @returns Channel instance
-     *
-     * @example
-     * ```typescript
-     * // Simple channel
-     * const channel = broker.channel("notifications");
-     *
-     * // Typed channel with schema
-     * const orderChannel = broker.channel<OrderPayload>("orders", {
-     *   schema: OrderSchema,
-     *   durable: true,
-     * });
-     * ```
-     */
-    channel<TPayload = unknown>(name: string, options?: ChannelOptions<TPayload>): ChannelContract<TPayload>;
-    /**
-     * Check if the broker is connected
-     */
-    get isConnected(): boolean;
-    /**
-     * Connect the underlying driver
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect the underlying driver
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Start consuming messages
-     */
-    startConsuming(): Promise<void>;
-    /**
-     * Stop consuming messages
-     */
-    stopConsuming(): Promise<void>;
-    /**
-     * Health check
-     */
-    healthCheck(): Promise<import("../types").HealthCheckResult>;
-}
-//# sourceMappingURL=broker.d.ts.map

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

@@ -1 +0,0 @@
-{"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/broker.js

@@ -1,105 +0,0 @@
-'use strict';/**
- * Broker - wrapper around a driver with metadata
- *
- * Similar to DataSource in @warlock.js/cascade
- *
- * @example
- * ```typescript
- * const broker = new Broker({
- *   name: "default",
- *   driver: rabbitMQDriver,
- *   isDefault: true,
- * });
- *
- * // Get a channel
- * const channel = broker.channel("user.created");
- * ```
- */
-class Broker {
-    /** Unique name identifying this broker */
-    name;
-    /** The underlying driver */
-    driver;
-    /** Whether this is the default broker */
-    isDefault;
-    /**
-     * Create a new Broker
-     *
-     * @param options - Broker configuration
-     */
-    constructor(options) {
-        this.name = options.name;
-        this.driver = options.driver;
-        this.isDefault = Boolean(options.isDefault);
-    }
-    /**
-     * Subscribe the given consumer
-     */
-    subscribe(consumer) {
-        return this.driver.subscribe(consumer);
-    }
-    /**
-     * Publish the given event message
-     */
-    publish(event) {
-        this.driver.publish(event);
-    }
-    /**
-     * Get or create a channel
-     *
-     * @param name - Channel name
-     * @param options - Channel options
-     * @returns Channel instance
-     *
-     * @example
-     * ```typescript
-     * // Simple channel
-     * const channel = broker.channel("notifications");
-     *
-     * // Typed channel with schema
-     * const orderChannel = broker.channel<OrderPayload>("orders", {
-     *   schema: OrderSchema,
-     *   durable: true,
-     * });
-     * ```
-     */
-    channel(name, options) {
-        return this.driver.channel(name, options);
-    }
-    /**
-     * Check if the broker is connected
-     */
-    get isConnected() {
-        return this.driver.isConnected;
-    }
-    /**
-     * Connect the underlying driver
-     */
-    async connect() {
-        await this.driver.connect();
-    }
-    /**
-     * Disconnect the underlying driver
-     */
-    async disconnect() {
-        await this.driver.disconnect();
-    }
-    /**
-     * Start consuming messages
-     */
-    async startConsuming() {
-        await this.driver.startConsuming();
-    }
-    /**
-     * Stop consuming messages
-     */
-    async stopConsuming() {
-        await this.driver.stopConsuming();
-    }
-    /**
-     * Health check
-     */
-    async healthCheck() {
-        return this.driver.healthCheck();
-    }
-}exports.Broker=Broker;//# sourceMappingURL=broker.js.map

package/cjs/communicators/broker.js.map

@@ -1 +0,0 @@
-{"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 +0,0 @@
-export * from "./broker";
-export * from "./broker-registry";
-//# sourceMappingURL=index.d.ts.map

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

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