@warlock.js/herald 4.0.157 → 4.0.158

package/esm/utils/connect-to-communicator.d.ts

@@ -1,129 +0,0 @@
-import { Communicator } from "../communicators";
-import type { ChannelContract } from "../contracts";
-import { EventConsumerClass, EventMessage } from "../message-managers";
-import type { ChannelOptions, ConnectionOptions } from "../types";
-/**
- * Connect to a message broker and register the communicator.
- *
- * This is a high-level utility function that simplifies connection setup
- * for most projects. It handles driver instantiation, connection,
- * communicator creation, and automatic registration.
- *
- * **Supported Drivers:**
- * - `rabbitmq` (default) - RabbitMQ/AMQP driver
- * - `kafka` - Apache Kafka driver (coming soon)
- *
- * @param options - Connection configuration options
- * @returns A connected and registered Communicator instance
- * @throws {Error} If connection fails or driver is not implemented
- *
- * @example
- * ```typescript
- * // RabbitMQ connection
- * const communicator = await connectToCommunicator({
- *   driver: "rabbitmq",
- *   host: "localhost",
- *   port: 5672,
- *   username: "guest",
- *   password: "guest",
- * });
- *
- * // Use the communicator
- * await communicator.channel("user.created").publish({ userId: 1 });
- * ```
- *
- * @example
- * ```typescript
- * // Multiple communicators
- * await connectToCommunicator({
- *   driver: "rabbitmq",
- *   name: "notifications",
- *   isDefault: true,
- *   host: process.env.RABBITMQ_HOST,
- * });
- *
- * await connectToCommunicator({
- *   driver: "rabbitmq",
- *   name: "analytics",
- *   host: process.env.ANALYTICS_RABBITMQ_HOST,
- * });
- *
- * // Use default communicator
- * communicators().channel("notifications").publish({ ... });
- *
- * // Use specific communicator
- * communicators("analytics").channel("events").publish({ ... });
- * ```
- */
-export declare function connectToCommunicator(options: ConnectionOptions): Promise<Communicator>;
-/**
- * Get a communicator by name or the default one.
- *
- * This is the main entry point for using communicators in your application.
- *
- * @param name - Optional communicator name (uses default if not provided)
- * @returns Communicator instance
- * @throws MissingCommunicatorError if communicator not found
- *
- * @example
- * ```typescript
- * // Get default communicator
- * const channel = communicators().channel("user.created");
- * await channel.publish({ userId: 1 });
- *
- * // Get specific communicator
- * const analyticsChannel = communicators("analytics").channel("events");
- * await analyticsChannel.publish({ event: "page_view" });
- *
- * // Subscribe to messages
- * communicators()
- *   .channel<UserPayload>("user.created")
- *   .subscribe(async (message, ctx) => {
- *     console.log("User created:", message.payload);
- *     await ctx.ack();
- *   });
- * ```
- */
-export declare function communicators(name?: string): Communicator;
-/**
- * Get channel instance for the given name from default communicator
- * @param name - Channel name
- * @returns Channel instance
- * @throws MissingCommunicatorError if communicator not found
- *
- * @example
- * ```typescript
- * const channel = communicatorChannel("user.created");
- * await channel.publish({ userId: 1 });
- * ```
- */
-export declare function communicatorChannel<TPayload = unknown>(name: string, options?: ChannelOptions<TPayload>): ChannelContract<TPayload>;
-/**
- * Publish the given
- * @param event - Event message to publish
- * @returns Promise that resolves when the event is published
- * @throws Error if the event is not published
- *
- * @example
- * ```typescript
- * await publishEvent(new UserUpdatedEvent({ id: 1, name: "John Doe" }));
- * ```
- */
-export declare function publishEvent<TPayload = Record<string, any>>(event: EventMessage<TPayload>): Promise<void>;
-/**
- * Subscribe the given consumer to the default communicator
- * @param Consumer - Event consumer class
- * @returns Function to unsubscribe the consumer
- * @throws Error if the consumer is not subscribed
- *
- * @example
- * ```typescript
- * await subscribeConsumer(UserUpdatedConsumer);
- * });
- *
- * // Unsubscribe
- * await unsubscribeConsumer(UserUpdatedConsumer);
- * ```
- */
-export declare function subscribeConsumer<TPayload = Record<string, any>>(Consumer: EventConsumerClass<TPayload>): Promise<() => void>;
-//# sourceMappingURL=connect-to-communicator.d.ts.map

package/esm/utils/connect-to-communicator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect-to-communicator.d.ts","sourceRoot":"","sources":["../../src/utils/connect-to-communicator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAA8B,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAA6B,MAAM,UAAU,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+C7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAEzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,GAAG,OAAO,EACpD,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GACjC,eAAe,CAAC,QAAQ,CAAC,CAE3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,iBAE/F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpE,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC,uBAGvC"}

package/esm/utils/connect-to-communicator.js

@@ -1,169 +0,0 @@
-import {communicatorRegistry}from'../communicators/communicator-registry.js';/**
- * Connect to a message broker and register the communicator.
- *
- * This is a high-level utility function that simplifies connection setup
- * for most projects. It handles driver instantiation, connection,
- * communicator creation, and automatic registration.
- *
- * **Supported Drivers:**
- * - `rabbitmq` (default) - RabbitMQ/AMQP driver
- * - `kafka` - Apache Kafka driver (coming soon)
- *
- * @param options - Connection configuration options
- * @returns A connected and registered Communicator instance
- * @throws {Error} If connection fails or driver is not implemented
- *
- * @example
- * ```typescript
- * // RabbitMQ connection
- * const communicator = await connectToCommunicator({
- *   driver: "rabbitmq",
- *   host: "localhost",
- *   port: 5672,
- *   username: "guest",
- *   password: "guest",
- * });
- *
- * // Use the communicator
- * await communicator.channel("user.created").publish({ userId: 1 });
- * ```
- *
- * @example
- * ```typescript
- * // Multiple communicators
- * await connectToCommunicator({
- *   driver: "rabbitmq",
- *   name: "notifications",
- *   isDefault: true,
- *   host: process.env.RABBITMQ_HOST,
- * });
- *
- * await connectToCommunicator({
- *   driver: "rabbitmq",
- *   name: "analytics",
- *   host: process.env.ANALYTICS_RABBITMQ_HOST,
- * });
- *
- * // Use default communicator
- * communicators().channel("notifications").publish({ ... });
- *
- * // Use specific communicator
- * communicators("analytics").channel("events").publish({ ... });
- * ```
- */
-async function connectToCommunicator(options) {
-    // Default values
-    const driverType = options.driver ?? "rabbitmq";
-    const communicatorName = options.name ?? "default";
-    const isDefault = options.isDefault ?? true;
-    // Create driver based on type
-    let driver;
-    switch (driverType) {
-        case "rabbitmq": {
-            const rabbitOptions = options;
-            // Dynamic import to avoid requiring amqplib if not used
-            const { RabbitMQDriver } = await import('../drivers/rabbitmq/rabbitmq-driver.js');
-            driver = new RabbitMQDriver(rabbitOptions);
-            break;
-        }
-        case "kafka": {
-            // const kafkaOptions = options as KafkaConnectionOptions;
-            // Dynamic import to avoid requiring kafkajs if not used
-            throw new Error("Kafka driver is not yet implemented. Coming soon! For now, please use RabbitMQ.");
-        }
-        default:
-            throw new Error(`Unknown driver: "${driverType}". Supported drivers: rabbitmq, kafka`);
-    }
-    // Create communicator
-    const communicator = communicatorRegistry.register({
-        name: communicatorName,
-        driver,
-        isDefault,
-    });
-    // Connect to the message broker
-    try {
-        await driver.connect();
-    }
-    catch (error) {
-        throw new Error(`Failed to connect to ${driverType}: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    return communicator;
-}
-/**
- * Get a communicator by name or the default one.
- *
- * This is the main entry point for using communicators in your application.
- *
- * @param name - Optional communicator name (uses default if not provided)
- * @returns Communicator instance
- * @throws MissingCommunicatorError if communicator not found
- *
- * @example
- * ```typescript
- * // Get default communicator
- * const channel = communicators().channel("user.created");
- * await channel.publish({ userId: 1 });
- *
- * // Get specific communicator
- * const analyticsChannel = communicators("analytics").channel("events");
- * await analyticsChannel.publish({ event: "page_view" });
- *
- * // Subscribe to messages
- * communicators()
- *   .channel<UserPayload>("user.created")
- *   .subscribe(async (message, ctx) => {
- *     console.log("User created:", message.payload);
- *     await ctx.ack();
- *   });
- * ```
- */
-function communicators(name) {
-    return communicatorRegistry.get(name);
-}
-/**
- * Get channel instance for the given name from default communicator
- * @param name - Channel name
- * @returns Channel instance
- * @throws MissingCommunicatorError if communicator not found
- *
- * @example
- * ```typescript
- * const channel = communicatorChannel("user.created");
- * await channel.publish({ userId: 1 });
- * ```
- */
-function communicatorChannel(name, options) {
-    return communicators().channel(name, options);
-}
-/**
- * Publish the given
- * @param event - Event message to publish
- * @returns Promise that resolves when the event is published
- * @throws Error if the event is not published
- *
- * @example
- * ```typescript
- * await publishEvent(new UserUpdatedEvent({ id: 1, name: "John Doe" }));
- * ```
- */
-async function publishEvent(event) {
-    return communicators().publish(event);
-}
-/**
- * Subscribe the given consumer to the default communicator
- * @param Consumer - Event consumer class
- * @returns Function to unsubscribe the consumer
- * @throws Error if the consumer is not subscribed
- *
- * @example
- * ```typescript
- * await subscribeConsumer(UserUpdatedConsumer);
- * });
- *
- * // Unsubscribe
- * await unsubscribeConsumer(UserUpdatedConsumer);
- * ```
- */
-async function subscribeConsumer(Consumer) {
-    return communicators().subscribe(Consumer);
-}export{communicatorChannel,communicators,connectToCommunicator,publishEvent,subscribeConsumer};//# sourceMappingURL=connect-to-communicator.js.map

package/esm/utils/connect-to-communicator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect-to-communicator.js","sources":["../../src/utils/connect-to-communicator.ts"],"sourcesContent":[null],"names":[],"mappings":"6EAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDG;AACI,eAAe,qBAAqB,CAAC,OAA0B,EAAA;;AAEpE,IAAA,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;AAChD,IAAA,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;AACnD,IAAA,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;;AAG5C,IAAA,IAAI,MAAkC,CAAC;AAEvC,IAAA,QAAQ,UAAU;QAChB,KAAK,UAAU,EAAE;YACf,MAAM,aAAa,GAAG,OAAoC,CAAC;;YAE3D,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,OAAO,wCAAqC,CAAC,CAAC;AAC/E,YAAA,MAAM,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;YAC3C,MAAM;AACP,SAAA;QAED,KAAK,OAAO,EAAE;;;AAGZ,YAAA,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;AACH,SAAA;AAED,QAAA;AACE,YAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,CAAA,qCAAA,CAAuC,CAAC,CAAC;AAC1F,KAAA;;AAGD,IAAA,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,CAAC;AACjD,QAAA,IAAI,EAAE,gBAAgB;QACtB,MAAM;QACN,SAAS;AACV,KAAA,CAAC,CAAC;;IAGH,IAAI;AACF,QAAA,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;AACxB,KAAA;AAAC,IAAA,OAAO,KAAK,EAAE;QACd,MAAM,IAAI,KAAK,CACb,CAAwB,qBAAA,EAAA,UAAU,KAAK,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAE,CAAA,CAChG,CAAC;AACH,KAAA;AAED,IAAA,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AACG,SAAU,aAAa,CAAC,IAAa,EAAA;AACzC,IAAA,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;AAWG;AACa,SAAA,mBAAmB,CACjC,IAAY,EACZ,OAAkC,EAAA;IAElC,OAAO,aAAa,EAAE,CAAC,OAAO,CAAW,IAAI,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;AAUG;AACI,eAAe,YAAY,CAAiC,KAA6B,EAAA;AAC9F,IAAA,OAAO,aAAa,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;AAcG;AACI,eAAe,iBAAiB,CACrC,QAAsC,EAAA;AAEtC,IAAA,OAAO,aAAa,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC7C"}

package/esm/utils/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./connect-to-communicator";
-//# sourceMappingURL=index.d.ts.map

package/esm/utils/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}