@warlock.js/herald 4.0.161 → 4.0.163

package/cjs/message-managers/event-message.js

@@ -0,0 +1,84 @@
+'use strict';var crypto=require('crypto');class EventMessage {
+    data;
+    /**
+     * Event version
+     */
+    version;
+    /**
+     * Additional metadata (if any)
+     */
+    metadata;
+    /**
+     * Event Message id
+     */
+    messageId;
+    /**
+     * Schema of payload that will be used to determine whether this event should be published
+     */
+    schema;
+    /**
+     * Data that will be sent with the event (Payload)
+     */
+    toJSON() {
+        if (!this.data) {
+            throw new Error(`no Data is defined for Event: ${this.eventName}`);
+        }
+        return this.data;
+    }
+    constructor(data) {
+        this.data = data;
+    }
+    /**
+     * Serialize the event to be ready for publishing
+     */
+    serialize() {
+        if (!this.data && !this.toJSON) {
+            throw new Error("No data or toJSON method provided");
+        }
+        const payload = this.toJSON();
+        return {
+            payload,
+            metadata: this.metadata,
+            messageId: this.messageId ?? crypto.randomUUID(),
+            eventName: this.eventName,
+            version: this.version,
+            occurredAt: new Date(),
+            __through: "EventMessage",
+        };
+    }
+}
+/**
+ * A shorthand to define an event without declaring an entire class.
+ *
+ * This factory function creates an EventMessage subclass that transforms
+ * input data (IncomingData) into a different output format (OutcomingData).
+ *
+ * @template IncomingData - The type of data passed to the constructor
+ * @template OutcomingData - The type of data returned by toJSON()
+ *
+ * @example
+ * ```typescript
+ * const UserCreatedEvent = defineEvent<User, { id: number; name: string }>(
+ *   "user.created",
+ *   { toJSON: (user) => user.only(["id", "name"]) }
+ * );
+ *
+ * publishEvent(new UserCreatedEvent(user));
+ * ```
+ */
+function defineEvent(eventName, options = {}) {
+    // We need to use `any` here to bridge the IncomingData -> OutcomingData transformation
+    // The class accepts IncomingData in constructor but outputs OutcomingData via toJSON()
+    return class AnnouncedEvent extends EventMessage {
+        eventName = eventName;
+        schema = options.schema;
+        constructor(data) {
+            super(data);
+        }
+        toJSON() {
+            if (!options.toJSON)
+                return this.data;
+            return options.toJSON(this.data);
+        }
+    };
+}exports.EventMessage=EventMessage;exports.defineEvent=defineEvent;//# sourceMappingURL=event-message.js.map

package/cjs/message-managers/event-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-message.js","sources":["../../src/message-managers/event-message.ts"],"sourcesContent":[null],"names":["randomUUID"],"mappings":"gDAUsB,YAAY,CAAA;AAqCH,IAAA,IAAA,CAAA;AA/B7B;;AAEG;AACI,IAAA,OAAO,CAAU;AAExB;;AAEG;AACI,IAAA,QAAQ,CAAuB;AAEtC;;AAEG;AACI,IAAA,SAAS,CAAU;AAE1B;;AAEG;AACI,IAAA,MAAM,CAAmB;AAEhC;;AAEG;IACI,MAAM,GAAA;AACX,QAAA,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YACd,MAAM,IAAI,KAAK,CAAC,CAAA,8BAAA,EAAiC,IAAI,CAAC,SAAS,CAAE,CAAA,CAAC,CAAC;AACpE,SAAA;QAED,OAAO,IAAI,CAAC,IAAgB,CAAC;KAC9B;AAED,IAAA,WAAA,CAA6B,IAAe,EAAA;QAAf,IAAI,CAAA,IAAA,GAAJ,IAAI,CAAW;KAAI;AAEhD;;AAEG;IACI,SAAS,GAAA;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AAC9B,YAAA,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACtD,SAAA;AAED,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAE9B,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;AACvB,YAAA,SAAS,EAAE,IAAI,CAAC,SAAS,IAAIA,iBAAU,EAAE;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,IAAI,EAAE;AACtB,YAAA,SAAS,EAAE,cAAc;SAC1B,CAAC;KACH;AACF,CAAA;AAuBD;;;;;;;;;;;;;;;;;;AAkBG;SACa,WAAW,CACzB,SAAiB,EACjB,UAAsC,EAAE,EAAA;;;IAIxC,OAAO,MAAM,cAAe,SAAQ,YAA2B,CAAA;QACtD,SAAS,GAAG,SAAS,CAAC;AACtB,QAAA,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AAE/B,QAAA,WAAA,CAAmB,IAAmB,EAAA;YACpC,KAAK,CAAC,IAAW,CAAC,CAAC;SACpB;QAEM,MAAM,GAAA;YACX,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,IAAqB,CAAC;YAEvD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAoB,CAAkB,CAAC;SACnE;KACF,CAAC;AACJ"}

package/cjs/message-managers/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./event-consumer";
+export * from "./event-message";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/cjs/message-managers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/message-managers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/cjs/message-managers/prepare-consumer-subscription.d.ts

@@ -0,0 +1,4 @@
+import type { MessageHandler } from "./../types";
+import { EventConsumerClass } from "./types";
+export declare function prepareConsumerSubscription(Consumer: EventConsumerClass): MessageHandler<any>;
+//# sourceMappingURL=prepare-consumer-subscription.d.ts.map

package/cjs/message-managers/prepare-consumer-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-consumer-subscription.d.ts","sourceRoot":"","sources":["../../src/message-managers/prepare-consumer-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,kBAAkB,uBA0CvE"}

package/cjs/message-managers/prepare-consumer-subscription.js

@@ -0,0 +1,39 @@
+'use strict';function prepareConsumerSubscription(Consumer) {
+    const callback = async (message, ctx) => {
+        const envelope = message.payload;
+        let eventPayload = envelope.payload;
+        if (envelope.version) {
+            if (!Consumer.isAcceptedVersion(Number(envelope.version))) {
+                ctx.ack(); // Acknowledge but don't process
+                return;
+            }
+        }
+        const consumer = new Consumer();
+        if (consumer.schema) {
+            const result = await consumer.validate(eventPayload);
+            if (!result || result.isValid === false) {
+                ctx.nack();
+                return;
+            }
+            eventPayload = result.data;
+        }
+        try {
+            await consumer.handle(eventPayload, {
+                payload: eventPayload,
+                eventName: Consumer.eventName,
+                messageId: message.metadata.messageId,
+                occurredAt: envelope.occurredAt ? new Date(envelope.occurredAt) : undefined,
+                metadata: envelope.metadata,
+                version: envelope.version,
+                message,
+            });
+            ctx.ack(); // Auto-ack on success?
+        }
+        catch (error) {
+            ctx.nack(true); // Requeue on failure
+            // Or emit error event for logging
+            console.error(error);
+        }
+    };
+    return callback;
+}exports.prepareConsumerSubscription=prepareConsumerSubscription;//# sourceMappingURL=prepare-consumer-subscription.js.map

package/cjs/message-managers/prepare-consumer-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-consumer-subscription.js","sources":["../../src/message-managers/prepare-consumer-subscription.ts"],"sourcesContent":[null],"names":[],"mappings":"aAGM,SAAU,2BAA2B,CAAC,QAA4B,EAAA;IACtE,MAAM,QAAQ,GAAwB,OAAO,OAAO,EAAE,GAAG,KAAI;AAC3D,QAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;AACjC,QAAA,IAAI,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC;QAEpC,IAAI,QAAQ,CAAC,OAAO,EAAE;AACpB,YAAA,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE;AACzD,gBAAA,GAAG,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO;AACR,aAAA;AACF,SAAA;AAED,QAAA,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAEhC,IAAI,QAAQ,CAAC,MAAM,EAAE;YACnB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE;gBACvC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACX,OAAO;AACR,aAAA;AAED,YAAA,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;AAC5B,SAAA;QACD,IAAI;AACF,YAAA,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE;AAClC,gBAAA,OAAO,EAAE,YAAY;gBACrB,SAAS,EAAE,QAAQ,CAAC,SAAS;AAC7B,gBAAA,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAU;AACtC,gBAAA,UAAU,EAAE,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS;gBAC3E,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,OAAO;AACR,aAAA,CAAC,CAAC;AACH,YAAA,GAAG,CAAC,GAAG,EAAE,CAAC;AACX,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;AACd,YAAA,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;AAEf,YAAA,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACtB,SAAA;AACH,KAAC,CAAC;AAEF,IAAA,OAAO,QAAQ,CAAC;AAClB"}

package/cjs/message-managers/types.d.ts

@@ -0,0 +1,20 @@
+import { Message } from "../types";
+import { type EventConsumer } from "./event-consumer";
+export type ConsumedEventMessage = {
+    version?: number;
+    occurredAt?: Date;
+    metadata?: Record<string, any>;
+    messageId: string;
+    eventName: string;
+    payload: Record<string, any>;
+    message: Message<any>;
+};
+export type EventConsumerClass<P = Record<string, any>> = {
+    new (): EventConsumer<P>;
+    eventName: string;
+    consumerId: string;
+    minVersion?: number;
+    maxVersion?: number;
+    isAcceptedVersion(version: number): boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/cjs/message-managers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/message-managers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;IACxD,QAAQ,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C,CAAC"}

package/cjs/types.d.ts

@@ -0,0 +1,399 @@
+/// <reference types="node" />
+import type { BaseValidator } from "@warlock.js/seal";
+import { CommunicatorDriverContract } from "./contracts";
+/**
+ * Message metadata that accompanies every message
+ */
+export type MessageMetadata = {
+    /** Unique message ID (auto-generated) */
+    messageId: string;
+    /** Correlation ID for request-response patterns */
+    correlationId?: string;
+    /** Reply-to channel for RPC patterns */
+    replyTo?: string;
+    /** Message priority (0-9, where 9 is highest) */
+    priority?: number;
+    /** Timestamp when message was published */
+    timestamp: Date;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Retry count (incremented on each retry) */
+    retryCount?: number;
+    /** Original queue/channel name */
+    originalChannel?: string;
+};
+/**
+ * A message received from a channel
+ *
+ * @template TPayload - The typed payload
+ */
+export type Message<TPayload = unknown> = {
+    /** Message metadata */
+    readonly metadata: MessageMetadata;
+    /** Typed payload data */
+    readonly payload: TPayload;
+    /** Raw message data from the driver */
+    readonly raw?: unknown;
+};
+/**
+ * Options when publishing a message
+ */
+export type PublishOptions = {
+    /** Message priority (0-9, where 9 is highest) */
+    priority?: number;
+    /** Time-to-live in milliseconds */
+    ttl?: number;
+    /** Delay before message is available (delayed messaging) */
+    delay?: number;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Enable message persistence (survives broker restart) */
+    persistent?: boolean;
+    /** Correlation ID for tracking related messages */
+    correlationId?: string;
+    /** Expiration time in milliseconds */
+    expiration?: number;
+};
+/**
+ * Retry configuration for failed message processing
+ */
+export type RetryOptions = {
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Delay between retries in ms, or function for custom backoff */
+    delay: number | ((attempt: number) => number);
+};
+/**
+ * Dead-letter configuration for messages that exceed retry attempts
+ */
+export type DeadLetterOptions = {
+    /** Dead-letter queue/channel name */
+    channel: string;
+    /** Whether to preserve original message metadata */
+    preserveOriginal?: boolean;
+};
+/**
+ * Options when subscribing to a channel
+ */
+export type SubscribeOptions = {
+    /** Consumer ID for tracking subscriptions (used for unsubscription) */
+    consumerId?: string;
+    /** Consumer group/tag name */
+    group?: string;
+    /** Number of messages to prefetch (concurrency) */
+    prefetch?: number;
+    /** Auto-acknowledge messages (default: false for manual ack) */
+    autoAck?: boolean;
+    /** Retry configuration for failed messages */
+    retry?: RetryOptions;
+    /** Dead-letter configuration */
+    deadLetter?: DeadLetterOptions;
+    /** Exclusive consumer (only one consumer on this queue) */
+    exclusive?: boolean;
+};
+/**
+ * Options for request-response (RPC) pattern
+ */
+export type RequestOptions = PublishOptions & {
+    /** Timeout in milliseconds to wait for response */
+    timeout?: number;
+};
+/**
+ * Context provided to message handlers for controlling message flow
+ */
+export type MessageContext = {
+    /** Acknowledge the message (mark as successfully processed) */
+    ack(): Promise<void>;
+    /** Negative acknowledge (requeue or send to dead-letter) */
+    nack(requeue?: boolean): Promise<void>;
+    /** Reject the message (don't requeue) */
+    reject(): Promise<void>;
+    /** Reply to a message (for RPC patterns) */
+    reply<T>(payload: T): Promise<void>;
+    /** Manually retry the message with optional delay */
+    retry(delay?: number): Promise<void>;
+};
+/**
+ * Represents an active subscription to a channel
+ */
+export type Subscription = {
+    /** Unique subscription ID */
+    readonly id: string;
+    /** Channel name this subscription is for */
+    readonly channel: string;
+    /** Consumer tag (driver-specific identifier) */
+    readonly consumerTag?: string;
+    /** Unsubscribe from the channel */
+    unsubscribe(): Promise<void>;
+    /** Pause message consumption */
+    pause(): Promise<void>;
+    /** Resume message consumption */
+    resume(): Promise<void>;
+    /** Check if subscription is active */
+    isActive(): boolean;
+};
+/**
+ * Handler function for processing messages
+ *
+ * @template TPayload - The typed payload
+ */
+export type MessageHandler<TPayload = unknown> = (message: Message<TPayload>, ctx: MessageContext) => Promise<void> | void;
+/**
+ * Handler function for request-response (RPC) pattern
+ *
+ * @template TPayload - The request payload type
+ * @template TResponse - The response payload type
+ */
+export type ResponseHandler<TPayload = unknown, TResponse = unknown> = (message: Message<TPayload>, ctx: MessageContext) => Promise<TResponse> | TResponse;
+/**
+ * Channel/queue configuration options
+ */
+export type ChannelOptions<TPayload = unknown> = {
+    /** Channel type (queue for point-to-point, topic for pub/sub, fanout for broadcast) */
+    type?: "queue" | "topic" | "fanout";
+    /** Durable channel (survives broker restart) */
+    durable?: boolean;
+    /** Auto-delete when last consumer disconnects */
+    autoDelete?: boolean;
+    /** Exclusive channel (single connection only) */
+    exclusive?: boolean;
+    /** Dead-letter configuration */
+    deadLetter?: DeadLetterOptions;
+    /** Maximum message size in bytes */
+    maxMessageSize?: number;
+    /** Default message TTL in milliseconds */
+    messageTtl?: number;
+    /** Maximum number of messages in queue */
+    maxLength?: number;
+    /** Seal schema for validation before message is published */
+    schema?: BaseValidator;
+};
+/**
+ * Statistics for a channel
+ */
+export type ChannelStats = {
+    /** Number of messages in the queue */
+    messageCount: number;
+    /** Number of active consumers */
+    consumerCount: number;
+    /** Channel name */
+    name: string;
+};
+/**
+ * Supported communicator driver types
+ */
+export type CommunicatorDriverType = "rabbitmq" | "kafka" | "redis-streams" | "sqs";
+/**
+ * Events emitted by communicator drivers
+ */
+export type CommunicatorEvent = "connected" | "disconnected" | "error" | "reconnecting";
+/**
+ * Listener function for communicator events
+ */
+export type CommunicatorEventListener = (...args: unknown[]) => void;
+/**
+ * Result of a health check
+ */
+export type HealthCheckResult = {
+    /** Whether the communicator is healthy */
+    healthy: boolean;
+    /** Latency in milliseconds */
+    latency?: number;
+    /** Error message if unhealthy */
+    error?: string;
+    /** Additional details */
+    details?: Record<string, unknown>;
+};
+/**
+ * Base connection options shared across all drivers
+ */
+export type BaseConnectionOptions = {
+    /** Unique name for this communicator */
+    name?: string;
+    /** Whether this should be the default communicator */
+    isDefault?: boolean;
+};
+/**
+ * Native amqplib socket options
+ * These are passed directly to the underlying socket connection
+ */
+export type RabbitMQSocketOptions = {
+    /** Keep-alive delay in milliseconds */
+    keepAlive?: boolean | number;
+    /** Disable Nagle's algorithm */
+    noDelay?: boolean;
+    /** Socket timeout in milliseconds */
+    timeout?: number;
+    /** Custom certificate authority (for TLS) */
+    ca?: string | Buffer | Array<string | Buffer>;
+    /** Client certificate (for TLS) */
+    cert?: string | Buffer;
+    /** Client private key (for TLS) */
+    key?: string | Buffer;
+    /** Passphrase for the private key */
+    passphrase?: string;
+    /** Server name for SNI (TLS) */
+    servername?: string;
+    /** Reject unauthorized certificates (default: true) */
+    rejectUnauthorized?: boolean;
+};
+/**
+ * RabbitMQ client options (native amqplib options)
+ * These are passed directly to amqplib.connect()
+ */
+export type RabbitMQClientOptions = {
+    /** Frame max size in bytes */
+    frameMax?: number;
+    /** Channel max (0 = unlimited) */
+    channelMax?: number;
+    /** Locale (default: 'en_US') */
+    locale?: string;
+    /** Socket options for the underlying connection */
+    socket?: RabbitMQSocketOptions;
+};
+/**
+ * RabbitMQ-specific connection options
+ *
+ * @template TClientOptions - Native amqplib client options
+ *
+ * @example
+ * ```typescript
+ * const config: RabbitMQConnectionOptions = {
+ *   driver: "rabbitmq",
+ *   host: "localhost",
+ *   port: 5672,
+ *   username: "guest",
+ *   password: "guest",
+ *
+ *   // Native amqplib options
+ *   clientOptions: {
+ *     frameMax: 0,
+ *     channelMax: 0,
+ *     socket: {
+ *       keepAlive: true,
+ *       noDelay: true,
+ *     },
+ *   },
+ * };
+ * ```
+ */
+export type RabbitMQConnectionOptions<TClientOptions extends RabbitMQClientOptions = RabbitMQClientOptions> = BaseConnectionOptions & {
+    driver: "rabbitmq";
+    /** Host address */
+    host?: string;
+    /** Port number */
+    port?: number;
+    /** Username for authentication */
+    username?: string;
+    /** Password for authentication */
+    password?: string;
+    /** Virtual host */
+    vhost?: string;
+    /** Connection URI (alternative to host/port) */
+    uri?: string;
+    /** Heartbeat interval in seconds */
+    heartbeat?: number;
+    /** Connection timeout in milliseconds */
+    connectionTimeout?: number;
+    /** Enable automatic reconnection */
+    reconnect?: boolean;
+    /** Delay between reconnection attempts in milliseconds */
+    reconnectDelay?: number;
+    /** Default prefetch count for consumers */
+    prefetch?: number;
+    /**
+     * Native amqplib client options
+     *
+     * These options are passed directly to amqplib.connect()
+     * for low-level configuration like frame size, TLS, etc.
+     */
+    clientOptions?: TClientOptions;
+};
+/**
+ * Kafka client options (native kafkajs options)
+ */
+export type KafkaClientOptions = {
+    /** Retry configuration */
+    retry?: {
+        initialRetryTime?: number;
+        retries?: number;
+        maxRetryTime?: number;
+        factor?: number;
+        multiplier?: number;
+    };
+    /** Log level */
+    logLevel?: number;
+    /** Custom logger */
+    logCreator?: any;
+};
+/**
+ * Kafka-specific connection options
+ *
+ * @template TClientOptions - Native kafkajs client options
+ */
+export type KafkaConnectionOptions<TClientOptions extends KafkaClientOptions = KafkaClientOptions> = BaseConnectionOptions & {
+    driver: "kafka";
+    /** Broker addresses */
+    brokers: string[];
+    /** Client ID */
+    clientId?: string;
+    /** Connection timeout in milliseconds */
+    connectionTimeout?: number;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+    /** SSL configuration */
+    ssl?: boolean | object;
+    /** SASL authentication */
+    sasl?: {
+        mechanism: "plain" | "scram-sha-256" | "scram-sha-512";
+        username: string;
+        password: string;
+    };
+    /**
+     * Native kafkajs client options
+     */
+    clientOptions?: TClientOptions;
+};
+/**
+ * Union type for all connection options
+ */
+export type ConnectionOptions = RabbitMQConnectionOptions | KafkaConnectionOptions;
+/**
+ * Communicator configuration options
+ *
+ * This is the main type for configuring communicators in your application.
+ * Similar to ConnectionOptions in @warlock.js/cascade.
+ *
+ * @template TClientOptions - Native client options (amqplib, kafkajs, etc.)
+ *
+ * @example
+ * ```typescript
+ * // RabbitMQ with client options
+ * const config: CommunicatorConfigurations<RabbitMQClientOptions> = {
+ *   driver: "rabbitmq",
+ *   host: "localhost",
+ *   clientOptions: {
+ *     socket: { keepAlive: true },
+ *   },
+ * };
+ *
+ * // Kafka
+ * const kafkaConfig: CommunicatorConfigurations<KafkaClientOptions> = {
+ *   driver: "kafka",
+ *   brokers: ["localhost:9092"],
+ *   clientOptions: {
+ *     retry: { retries: 5 },
+ *   },
+ * };
+ * ```
+ */
+export type CommunicatorConfigurations<TClientOptions = any> = RabbitMQConnectionOptions<TClientOptions extends RabbitMQClientOptions ? TClientOptions : RabbitMQClientOptions> | KafkaConnectionOptions<TClientOptions extends KafkaClientOptions ? TClientOptions : KafkaClientOptions>;
+/**
+ * Events emitted by the communicator registry
+ */
+export type CommunicatorRegistryEvent = "registered" | "default-registered" | "connected" | "disconnected";
+/**
+ * Listener for registry events
+ */
+export type CommunicatorRegistryListener = (communicator: CommunicatorDriverContract) => void;
+//# sourceMappingURL=types.d.ts.map

package/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}