@warlock.js/herald 4.0.162 → 4.0.164

package/esm/drivers/rabbitmq/rabbitmq-driver.js

@@ -0,0 +1,346 @@
+import {EventEmitter}from'node:events';import {prepareConsumerSubscription}from'../../message-managers/prepare-consumer-subscription.js';import {RabbitMQChannel}from'./rabbitmq-channel.js';// ============================================================
+// Lazy-loaded amqplib Module
+// ============================================================
+/**
+ * Cached amqplib module (loaded once, reused)
+ */
+let amqplibModule;
+/**
+ * Module availability flag
+ */
+let isModuleExists = null;
+/**
+ * Installation instructions for amqplib
+ */
+const AMQPLIB_INSTALL_INSTRUCTIONS = `
+RabbitMQ driver requires the amqplib package.
+Install it with:
+
+  npx warlock add herald --driver=rabbitmq
+
+Or manually:
+
+  npm install amqplib
+  pnpm add amqplib
+  yarn add amqplib
+`.trim();
+/**
+ * Load amqplib module
+ */
+async function loadAmqplibModule() {
+    try {
+        amqplibModule = await import('amqplib');
+        isModuleExists = true;
+    }
+    catch {
+        isModuleExists = false;
+    }
+}
+// Kick off eager loading immediately
+loadAmqplibModule();
+// ============================================================
+// RabbitMQ Driver
+// ============================================================
+/**
+ * RabbitMQ Driver
+ *
+ * Implementation of CommunicatorDriverContract for RabbitMQ/AMQP.
+ *
+ * **Important:** This driver requires the `amqplib` package to be installed.
+ * Install it with: `npx warlock add herald --driver=rabbitmq` or `npm install amqplib`
+ *
+ * @example
+ * ```typescript
+ * const driver = new RabbitMQDriver({
+ *   driver: "rabbitmq",
+ *   host: "localhost",
+ *   port: 5672,
+ *   username: "guest",
+ *   password: "guest",
+ * });
+ *
+ * await driver.connect();
+ * const channel = driver.channel("user.created");
+ * ```
+ */
+class RabbitMQDriver {
+    name = "rabbitmq";
+    consumers = [];
+    options;
+    events = new EventEmitter();
+    channels = new Map();
+    connection = null;
+    amqpChannel = null;
+    _isConnected = false;
+    /**
+     * Create a new RabbitMQ driver
+     *
+     * @param options - RabbitMQ connection options
+     */
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Whether connected to RabbitMQ
+     */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Subscribe the given consumer class to the driver
+     *
+     * @param consumer - Consumer class to subscribe
+     *
+     * @example
+     * ```typescript
+     * driver.subscribe(UserUpdatedConsumer);
+     * ```
+     */
+    subscribe(Consumer) {
+        if (this.isConnected) {
+            this.channel(Consumer.eventName).subscribe(prepareConsumerSubscription(Consumer), {
+                consumerId: Consumer.consumerId,
+            });
+        }
+        else {
+            this.consumers.push(Consumer);
+        }
+        return () => {
+            this.unsubscribe(Consumer);
+        };
+    }
+    /**
+     * Unsubscribe the given consumer
+     */
+    unsubscribe(Consumer) {
+        if (this.isConnected) {
+            this.channel(Consumer.eventName).unsubscribeById(Consumer.consumerId);
+        }
+        const index = this.consumers.indexOf(Consumer);
+        if (index > -1) {
+            this.consumers.splice(index, 1);
+        }
+    }
+    /**
+     * Publish the given event message
+     */
+    publish(event) {
+        this.channels.get(event.eventName)?.publish(event.serialize());
+    }
+    /**
+     * Connect to RabbitMQ
+     */
+    async connect() {
+        // Check if amqplib is installed
+        if (isModuleExists === false) {
+            throw new Error(`amqplib is not installed.\n\n${AMQPLIB_INSTALL_INSTRUCTIONS}`);
+        }
+        // Wait for module to load if still loading
+        if (isModuleExists === null) {
+            await loadAmqplibModule();
+            if (!isModuleExists) {
+                throw new Error(`amqplib is not installed.\n\n${AMQPLIB_INSTALL_INSTRUCTIONS}`);
+            }
+        }
+        try {
+            // Build connection URL
+            const url = this.buildConnectionUrl();
+            // Build connection options merging our options with native client options
+            const connectOptions = {
+                heartbeat: this.options.heartbeat ?? 60,
+                timeout: this.options.connectionTimeout,
+                // Merge native amqplib client options
+                ...this.options.clientOptions,
+            };
+            // Connect using cached module
+            this.connection = await amqplibModule.connect(url, connectOptions);
+            // Create channel
+            this.amqpChannel = await this.connection.createChannel();
+            // Set prefetch if specified
+            if (this.options.prefetch) {
+                await this.amqpChannel.prefetch(this.options.prefetch);
+            }
+            this._isConnected = true;
+            this.events.emit("connected");
+            for (const consumer of this.consumers) {
+                this.subscribe(consumer);
+            }
+            this.consumers.length = 0;
+            // Handle connection close
+            this.connection.on("close", () => {
+                this._isConnected = false;
+                this.events.emit("disconnected");
+                if (this.options.reconnect !== false) {
+                    this.handleReconnect();
+                }
+            });
+            // Handle errors
+            this.connection.on("error", (error) => {
+                this.events.emit("error", error);
+            });
+        }
+        catch (error) {
+            this._isConnected = false;
+            throw new Error(`Failed to connect to RabbitMQ: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Build connection URL from options
+     */
+    buildConnectionUrl() {
+        if (this.options.uri) {
+            return this.options.uri;
+        }
+        const protocol = "amqp";
+        const host = this.options.host ?? "localhost";
+        const port = this.options.port ?? 5672;
+        const vhost = this.options.vhost ?? "/";
+        const username = this.options.username ?? "guest";
+        const password = this.options.password ?? "guest";
+        const encodedVhost = encodeURIComponent(vhost);
+        return `${protocol}://${username}:${password}@${host}:${port}/${encodedVhost}`;
+    }
+    /**
+     * Handle reconnection
+     */
+    async handleReconnect() {
+        const delay = this.options.reconnectDelay ?? 5000;
+        let attempt = 0;
+        const tryReconnect = async () => {
+            attempt++;
+            this.events.emit("reconnecting", attempt);
+            try {
+                await this.connect();
+            }
+            catch {
+                setTimeout(tryReconnect, delay);
+            }
+        };
+        setTimeout(tryReconnect, delay);
+    }
+    /**
+     * Disconnect from RabbitMQ
+     */
+    async disconnect() {
+        if (this.amqpChannel) {
+            try {
+                await this.amqpChannel.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.amqpChannel = null;
+        }
+        if (this.connection) {
+            try {
+                await this.connection.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.connection = null;
+        }
+        this._isConnected = false;
+        this.events.emit("disconnected");
+    }
+    /**
+     * Register event listener
+     */
+    on(event, listener) {
+        this.events.on(event, listener);
+    }
+    /**
+     * Remove event listener
+     */
+    off(event, listener) {
+        this.events.off(event, listener);
+    }
+    /**
+     * Get or create a channel
+     */
+    channel(name, options) {
+        // Check cache
+        const existing = this.channels.get(name);
+        if (existing) {
+            return existing;
+        }
+        // Create new channel
+        const channel = new RabbitMQChannel(name, this.amqpChannel, options);
+        this.channels.set(name, channel);
+        return channel;
+    }
+    /**
+     * Start consuming messages
+     */
+    async startConsuming() {
+        // Channels start consuming when subscribe() is called
+        // This method is for batch start if needed
+    }
+    /**
+     * Stop consuming messages
+     */
+    async stopConsuming() {
+        // Cancel all consumers
+        for (const channel of this.channels.values()) {
+            // Channel implementations should handle this    // Need to add pauseAllSubscriptions() to RabbitMQChannel
+            // await channel.stopConsuming();
+        }
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        if (!this._isConnected || !this.connection) {
+            return {
+                healthy: false,
+                error: "Not connected to RabbitMQ",
+            };
+        }
+        const start = Date.now();
+        try {
+            // Simple check - verify channel is open
+            await this.amqpChannel.checkQueue("amq.rabbitmq.reply-to").catch(() => {
+                // Queue might not exist, but if we get here, connection is alive
+            });
+            return {
+                healthy: true,
+                latency: Date.now() - start,
+            };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                error: error instanceof Error ? error.message : String(error),
+                latency: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Get all channel names
+     */
+    getChannelNames() {
+        return Array.from(this.channels.keys());
+    }
+    /**
+     * Close a specific channel
+     */
+    async closeChannel(name) {
+        const channel = this.channels.get(name);
+        if (channel) {
+            await channel.delete();
+            this.channels.delete(name);
+        }
+    }
+    /**
+     * Get the raw AMQP channel (for advanced use)
+     */
+    getRawChannel() {
+        return this.amqpChannel;
+    }
+    /**
+     * Get the raw connection (for advanced use)
+     */
+    getRawConnection() {
+        return this.connection;
+    }
+}export{RabbitMQDriver};//# sourceMappingURL=rabbitmq-driver.js.map

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

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

package/esm/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Warlock Herald - Message Bus / Communicators
+ *
+ * A powerful, type-safe message bus library for RabbitMQ, Kafka, and more.
+ *
+ * Package: @warlock.js/herald
+ *
+ * Let heralds carry your messages across services!
+ *
+ * Structure:
+ * - contracts/ - Core interfaces
+ * - communicators/ - Communicator and registry
+ * - drivers/ - RabbitMQ, Kafka implementations
+ * - types/ - TypeScript type definitions
+ * - utils/ - Connection helpers
+ *
+ * @example
+ * ```typescript
+ * import { connectToCommunicator, communicators } from "@warlock.js/herald";
+ *
+ * // Connect to RabbitMQ
+ * await connectToCommunicator({
+ *   driver: "rabbitmq",
+ *   host: "localhost",
+ *   port: 5672,
+ * });
+ *
+ * // Publish a message
+ * await communicators().channel("user.created").publish({ userId: 1 });
+ *
+ * // Subscribe to messages
+ * communicators()
+ *   .channel<UserPayload>("user.created")
+ *   .subscribe(async (message, ctx) => {
+ *     console.log(message.payload);
+ *     await ctx.ack();
+ *   });
+ * ```
+ */
+export * from "./types";
+export * from "./contracts";
+export * from "./communicators";
+export * from "./drivers";
+export * from "./utils";
+export * from "./message-managers";
+export * from "./decorators";
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,cAAc,CAAC"}

package/esm/index.js

@@ -0,0 +1 @@
+export{Communicator}from'./communicators/communicator.js';export{MissingCommunicatorError,communicatorRegistry}from'./communicators/communicator-registry.js';export{RabbitMQDriver}from'./drivers/rabbitmq/rabbitmq-driver.js';export{RabbitMQChannel}from'./drivers/rabbitmq/rabbitmq-channel.js';export{communicatorChannel,communicators,connectToCommunicator,publishEvent,subscribeConsumer}from'./utils/connect-to-communicator.js';export{EventConsumer,defineConsumer}from'./message-managers/event-consumer.js';export{EventMessage,defineEvent}from'./message-managers/event-message.js';export{Consumable,pendingSubscribers}from'./decorators/consumable.js';//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/esm/message-managers/event-consumer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * This class is used to be part of the Herald Event Consumer Manager.
+ * It should be used to consume events from Either RabbitMQ or Kafka through Herald
+ *
+ * It's highly recommended using it instead of declaring manual channel namd and subscribing to event
+ */
+import { ValidationResult, type ObjectValidator } from "@warlock.js/seal";
+import { ConsumedEventMessage, EventConsumerClass } from "./types";
+export declare abstract class EventConsumer<Payload = Record<string, any>> {
+    /**
+     * Event name
+     */
+    static eventName: string;
+    static consumerId: `${string}-${string}-${string}-${string}-${string}`;
+    get eventName(): string;
+    /**
+     * Min version accepted to be consumed by this class
+     */
+    static minVersion?: number;
+    /**
+     * Max version accepted to be consumed by this class
+     */
+    static maxVersion?: number;
+    /**
+     * Payload validation to auto reject the received event before accessing it in the handle method
+     */
+    schema?: ObjectValidator;
+    /**
+     * The method that will be called when the event is received
+     */
+    abstract handle(payload: Payload, event: ConsumedEventMessage): Promise<void>;
+    /**
+     * Determine whether this is accepted version to be used by this consumer
+     */
+    static isAcceptedVersion(version: number): boolean;
+    /**
+     * Validate the given data
+     */
+    validate(data: Payload): Promise<ValidationResult | void>;
+}
+/**
+ * Define Consumer options
+ */
+type ConsumerOptions<Payload> = {
+    /**
+     * Payload validation to auto reject the received event before accessing it in the handle method
+     */
+    schema?: ObjectValidator;
+    /**
+     * Handle data
+     */
+    handle: (payload: Payload, event: ConsumedEventMessage) => Promise<void>;
+    /**
+     * Validate the payload before executing `handle`
+     */
+    validate?: (payload: Payload) => Promise<ValidationResult | boolean>;
+};
+/**
+ * A shorthand to define an event consumer without declaring an entire class
+ */
+export declare function defineConsumer<Payload = Record<string, any>>(eventName: string, options: ConsumerOptions<Payload>): EventConsumerClass;
+export {};
+//# sourceMappingURL=event-consumer.d.ts.map

package/esm/message-managers/event-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-consumer.d.ts","sourceRoot":"","sources":["../../src/message-managers/event-consumer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEnE,8BAAsB,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC/D;;OAEG;IACH,OAAc,SAAS,EAAE,MAAM,CAAC;IAEhC,OAAc,UAAU,sDAAgB;IAExC,IAAW,SAAS,WAEnB;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,OAAc,UAAU,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACI,MAAM,CAAC,EAAE,eAAe,CAAC;IAEhC;;OAEG;aACa,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpF;;OAEG;WACW,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOzD;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAKvE;AAED;;GAEG;AACH,KAAK,eAAe,CAAC,OAAO,IAAI;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;OAEG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,CAAC;CACtE,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1D,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,GAChC,kBAAkB,CAkBpB"}

package/esm/message-managers/event-consumer.js

@@ -0,0 +1,65 @@
+import {v}from'@warlock.js/seal';import {randomUUID}from'crypto';import {Consumable}from'../decorators/consumable.js';/**
+ * This class is used to be part of the Herald Event Consumer Manager.
+ * It should be used to consume events from Either RabbitMQ or Kafka through Herald
+ *
+ * It's highly recommended using it instead of declaring manual channel namd and subscribing to event
+ */
+class EventConsumer {
+    /**
+     * Event name
+     */
+    static eventName;
+    static consumerId = randomUUID();
+    get eventName() {
+        return this.constructor.eventName;
+    }
+    /**
+     * Min version accepted to be consumed by this class
+     */
+    static minVersion;
+    /**
+     * Max version accepted to be consumed by this class
+     */
+    static maxVersion;
+    /**
+     * Payload validation to auto reject the received event before accessing it in the handle method
+     */
+    schema;
+    /**
+     * Determine whether this is accepted version to be used by this consumer
+     */
+    static isAcceptedVersion(version) {
+        if (this.minVersion && version < this.minVersion)
+            return false;
+        if (this.maxVersion && version > this.maxVersion)
+            return false;
+        return true;
+    }
+    /**
+     * Validate the given data
+     */
+    async validate(data) {
+        if (!this.schema)
+            return;
+        return await v.validate(this.schema, data);
+    }
+}
+/**
+ * A shorthand to define an event consumer without declaring an entire class
+ */
+function defineConsumer(eventName, options) {
+    const Class = class AnnouncedConsumer extends EventConsumer {
+        static eventName = eventName;
+        schema = options.schema;
+        async handle(payload, event) {
+            if (options.validate) {
+                const result = await options.validate(payload);
+                if (!result || !result.isValid)
+                    return;
+            }
+            return options.handle(payload, event);
+        }
+    };
+    Consumable()(Class);
+    return Class;
+}export{EventConsumer,defineConsumer};//# sourceMappingURL=event-consumer.js.map

package/esm/message-managers/event-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-consumer.js","sources":["../../src/message-managers/event-consumer.ts"],"sourcesContent":[null],"names":[],"mappings":"sHAAA;;;;;AAKG;MAMmB,aAAa,CAAA;AACjC;;AAEG;IACI,OAAO,SAAS,CAAS;AAEzB,IAAA,OAAO,UAAU,GAAG,UAAU,EAAE,CAAC;AAExC,IAAA,IAAW,SAAS,GAAA;AAClB,QAAA,OAAQ,IAAI,CAAC,WAAoC,CAAC,SAAS,CAAC;KAC7D;AAED;;AAEG;IACI,OAAO,UAAU,CAAU;AAElC;;AAEG;IACI,OAAO,UAAU,CAAU;AAElC;;AAEG;AACI,IAAA,MAAM,CAAmB;AAOhC;;AAEG;IACI,OAAO,iBAAiB,CAAC,OAAe,EAAA;QAC7C,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU;AAAE,YAAA,OAAO,KAAK,CAAC;QAC/D,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU;AAAE,YAAA,OAAO,KAAK,CAAC;AAE/D,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;IACI,MAAM,QAAQ,CAAC,IAAa,EAAA;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEzB,OAAO,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KAC5C;;AAqBH;;AAEG;AACa,SAAA,cAAc,CAC5B,SAAiB,EACjB,OAAiC,EAAA;AAEjC,IAAA,MAAM,KAAK,GAAG,MAAM,iBAAkB,SAAQ,aAAsB,CAAA;AAC3D,QAAA,OAAO,SAAS,GAAG,SAAS,CAAC;AAC7B,QAAA,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AAExB,QAAA,MAAM,MAAM,CAAC,OAAgB,EAAE,KAA2B,EAAA;YAC/D,IAAI,OAAO,CAAC,QAAQ,EAAE;gBACpB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC/C,gBAAA,IAAI,CAAC,MAAM,IAAI,CAAE,MAA2B,CAAC,OAAO;oBAAE,OAAO;AAC9D,aAAA;YAED,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;SACvC;KACF,CAAC;AAEF,IAAA,UAAU,EAAE,CAAC,KAA2B,CAAC,CAAC;AAE1C,IAAA,OAAO,KAA2B,CAAC;AACrC"}

package/esm/message-managers/event-message.d.ts

@@ -0,0 +1,87 @@
+/**
+ * This class is used to be part of the Herald Event Message Manager.
+ * It should be used to trigger events to Either RabbitMQ or Kafka through Herald
+ *
+ * It's highly recommended using it instead of declaring manual channel namd and publishing data
+ */
+import { GenericObject } from "@mongez/reinforcements";
+import { type ObjectValidator } from "@warlock.js/seal";
+export declare abstract class EventMessage<TPayload = Record<string, any>> {
+    protected data?: TPayload;
+    /**
+     * Event Name
+     */
+    abstract eventName: string;
+    /**
+     * Event version
+     */
+    version?: number;
+    /**
+     * Additional metadata (if any)
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Event Message id
+     */
+    messageId?: string;
+    /**
+     * Schema of payload that will be used to determine whether this event should be published
+     */
+    schema?: ObjectValidator;
+    /**
+     * Data that will be sent with the event (Payload)
+     */
+    toJSON(): TPayload;
+    constructor(data?: TPayload);
+    /**
+     * Serialize the event to be ready for publishing
+     */
+    serialize(): {
+        payload: TPayload;
+        metadata: Record<string, any>;
+        messageId: string;
+        eventName: string;
+        version: number;
+        occurredAt: Date;
+        __through: string;
+    };
+}
+type EventOptions<T> = {
+    /**
+     * Shapen the data that will be used
+     */
+    toJSON?: (data: T) => GenericObject;
+    /**
+     * Validation schema
+     */
+    schema?: ObjectValidator;
+};
+/**
+ * Represents an EventMessage class constructor.
+ *
+ * @template TIncoming - The type of data accepted by the constructor
+ * @template TOutgoing - The type of data returned by toJSON() (defaults to TIncoming)
+ */
+type EventMessageClass<TIncoming = Record<string, any>, TOutgoing = TIncoming> = new (data?: TIncoming) => EventMessage<TOutgoing>;
+/**
+ * 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));
+ * ```
+ */
+export declare function defineEvent<IncomingData = unknown, OutcomingData = unknown>(eventName: string, options?: EventOptions<IncomingData>): EventMessageClass<IncomingData, OutcomingData>;
+export {};
+//# sourceMappingURL=event-message.d.ts.map

package/esm/message-managers/event-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-message.d.ts","sourceRoot":"","sources":["../../src/message-managers/event-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,8BAAsB,YAAY,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAqC5C,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ;IApC5C;;OAEG;IACH,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC;;OAEG;IACI,OAAO,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACI,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEtC;;OAEG;IACI,SAAS,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACI,MAAM,CAAC,EAAE,eAAe,CAAC;IAEhC;;OAEG;IACI,MAAM,IAAI,QAAQ;gBAQI,IAAI,CAAC,EAAE,QAAQ;IAE5C;;OAEG;IACI,SAAS;;;;;;;;;CAiBjB;AAED,KAAK,YAAY,CAAC,CAAC,IAAI;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,aAAa,CAAC;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,KAAK,iBAAiB,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,IAAI,KAC/E,IAAI,CAAC,EAAE,SAAS,KACb,YAAY,CAAC,SAAS,CAAC,CAAC;AAE7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,YAAY,GAAG,OAAO,EAAE,aAAa,GAAG,OAAO,EACzE,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,YAAY,CAAC,YAAY,CAAM,GACvC,iBAAiB,CAAC,YAAY,EAAE,aAAa,CAAC,CAiBhD"}