@asenajs/asena 0.7.1 → 0.8.1

package/dist/lib/server/messaging/Ulak.js

@@ -11,6 +11,8 @@ import { CoreService, ICoreServiceNames } from '../../ioc';
 import { UlakError, UlakErrorCode } from './types';
 import { Inject } from '../../ioc/component';
 import { blue } from '../../logger';
+import { DEFAULT_TRANSPORT_NAME } from '../microservice/types';
+import { composeOnSend } from '../microservice/interceptorChain';
 /**
  * Central WebSocket message broker for Asena.js
  *
@@ -42,6 +44,14 @@ let Ulak = class Ulak {
      * Map of namespace path to WebSocket service instance
      */
     namespaces = new Map();
+    /**
+     * Named microservice transports (set during bootstrap by PrepareMicroserviceService)
+     */
+    microserviceTransports = new Map();
+    /**
+     * Messaging interceptors applied to all outgoing send/emit calls
+     */
+    microserviceInterceptors = [];
     /**
      * Initialize Ulak messaging system
      * Called after dependency injection is complete
@@ -258,6 +268,86 @@ let Ulak = class Ulak {
         const service = this.namespaces.get(namespace);
         return service ? service.sockets.size : 0;
     }
+    /**
+     * Wire the microservice transports into Ulak
+     * Called during bootstrap by PrepareMicroserviceService - not intended for user code
+     *
+     * @param transports - Named transports ('default' for the single-transport form)
+     * @param interceptors - Interceptors applied to all outgoing send/emit calls
+     */
+    setMicroserviceTransports(transports, interceptors = []) {
+        this.microserviceTransports = transports;
+        this.microserviceInterceptors = interceptors;
+    }
+    /**
+     * Check if a microservice transport is configured and connected
+     *
+     * @param transport - Named transport to check
+     * @returns True when the transport exists and reports a live connection
+     */
+    isMicroserviceConnected(transport = DEFAULT_TRANSPORT_NAME) {
+        const instance = this.microserviceTransports.get(transport);
+        return instance ? instance.isConnected : false;
+    }
+    /**
+     * Get all configured microservice transports (read-only)
+     * Used by the health endpoint to report per-transport status
+     */
+    getMicroserviceTransports() {
+        return this.microserviceTransports;
+    }
+    /**
+     * Send a request to another service and await its reply (request/response)
+     *
+     * @param pattern - Full request pattern (e.g. 'order.create')
+     * @param data - Request payload
+     * @param options - Timeout, headers and named transport selection
+     * @returns The reply produced by the remote @MessagePattern handler
+     * @throws {UlakError} NO_TRANSPORT / TRANSPORT_NOT_FOUND / TIMEOUT / REMOTE_ERROR
+     */
+    async send(pattern, data, options) {
+        if (!pattern) {
+            // Fail fast: an empty pattern would otherwise create a nonsense broker
+            // stream and burn the full request timeout before surfacing
+            throw new UlakError('Pattern cannot be empty', UlakErrorCode.SEND_FAILED);
+        }
+        const transport = this.getMicroserviceTransport(options?.transport);
+        const ctx = { pattern, kind: 'send', headers: { ...options?.headers }, data };
+        return composeOnSend(this.microserviceInterceptors, ctx, () => transport.send(pattern, data, { timeout: options?.timeout, headers: ctx.headers }));
+    }
+    /**
+     * Emit a fire-and-forget event to other services
+     *
+     * @param pattern - Full event pattern (e.g. 'order.created')
+     * @param data - Event payload
+     * @param options - Headers and named transport selection
+     * @throws {UlakError} NO_TRANSPORT / TRANSPORT_NOT_FOUND
+     */
+    async emit(pattern, data, options) {
+        if (!pattern) {
+            throw new UlakError('Pattern cannot be empty', UlakErrorCode.SEND_FAILED);
+        }
+        const transport = this.getMicroserviceTransport(options?.transport);
+        const ctx = { pattern, kind: 'emit', headers: { ...options?.headers }, data };
+        await composeOnSend(this.microserviceInterceptors, ctx, () => transport.emit(pattern, data, { headers: ctx.headers }));
+    }
+    /**
+     * Select a pattern-scoped microservice messaging view
+     * Patterns passed to the returned view are joined with the prefix ('order' + 'create' → 'order.create')
+     *
+     * @param prefix - Pattern prefix (empty for absolute patterns)
+     * @param options - Named transport selection
+     * @returns Scoped messages instance
+     *
+     * @example
+     * ```typescript
+     * const orders = ulak.messages('order');
+     * const res = await orders.send('create', dto); // sends 'order.create'
+     * ```
+     */
+    messages(prefix, options) {
+        return new UlakMessages((prefix || ''), this, options?.transport);
+    }
     /**
      * Dispose of all resources and stop background tasks
      * Should be called during application shutdown
@@ -284,6 +374,23 @@ let Ulak = class Ulak {
         }
         return service;
     }
+    /**
+     * Get a named microservice transport or throw
+     *
+     * @param name - Named transport (defaults to 'default')
+     * @throws {UlakError} NO_TRANSPORT when none configured, TRANSPORT_NOT_FOUND for unknown names
+     */
+    getMicroserviceTransport(name = DEFAULT_TRANSPORT_NAME) {
+        if (this.microserviceTransports.size === 0) {
+            throw new UlakError('No microservice transport configured - configure a microservice transport in your @Config transport()', UlakErrorCode.NO_TRANSPORT);
+        }
+        const transport = this.microserviceTransports.get(name);
+        if (!transport) {
+            const available = Array.from(this.microserviceTransports.keys()).join(', ');
+            throw new UlakError(`Microservice transport "${name}" not found - available transports: ${available}`, UlakErrorCode.TRANSPORT_NOT_FOUND);
+        }
+        return transport;
+    }
 };
 __decorate([
     Inject(ICoreServiceNames.SERVER_LOGGER),
@@ -319,6 +426,36 @@ class UlakNameSpace {
         return this.ulak.getSocketCount(this.path);
     }
 }
+/**
+ * Internal implementation of pattern-scoped microservice messaging
+ */
+class UlakMessages {
+    prefix;
+    ulak;
+    transport;
+    constructor(prefix, ulak, transport) {
+        this.prefix = prefix;
+        this.ulak = ulak;
+        this.transport = transport;
+    }
+    async send(pattern, data, options) {
+        return this.ulak.send(this.buildPattern(pattern), data, { ...options, transport: this.transport });
+    }
+    async emit(pattern, data, options) {
+        await this.ulak.emit(this.buildPattern(pattern), data, { ...options, transport: this.transport });
+    }
+    /**
+     * Join prefix and pattern (same rule as message handler prefixes):
+     * no prefix → pattern, no pattern → prefix, both → prefix.pattern
+     */
+    buildPattern(pattern) {
+        if (!this.prefix)
+            return pattern;
+        if (!pattern)
+            return this.prefix;
+        return `${this.prefix}.${pattern}`;
+    }
+}
 /**
  * Helper function for injecting scoped Ulak namespace
  *
@@ -351,4 +488,41 @@ class UlakNameSpace {
 export function ulak(namespace) {
     return [ICoreServiceNames.__ULAK__, (ulak) => ulak.namespace(namespace)];
 }
+/**
+ * Helper functions for injecting microservice messaging views from Ulak
+ * Declaration merging keeps the single `ulak` entry point:
+ * `ulak('/chat')` → WebSocket namespace, `ulak.messages('order')` → microservice messaging
+ */
+// eslint-disable-next-line @typescript-eslint/no-namespace
+(function (ulak) {
+    /**
+     * Inject a pattern-scoped microservice messaging view
+     *
+     * @param prefix - Pattern prefix joined to every send/emit ('' for absolute patterns)
+     * @param options - Named transport selection (multi-broker projects)
+     * @returns A tuple of [serviceName, expression] for @Inject decorator
+     *
+     * @example
+     * ```typescript
+     * @Service('CheckoutService')
+     * export class CheckoutService {
+     *   @Inject(ulak.messages('order'))
+     *   private orders: Ulak.Messages<'order'>;
+     *
+     *   async checkout(dto: CheckoutDto) {
+     *     const res = await this.orders.send('create', dto);  // sends 'order.create'
+     *     await this.orders.emit('created', { id: res.id });  // emits 'order.created'
+     *   }
+     * }
+     *
+     * // Named transport (multi-broker projects)
+     * @Inject(ulak.messages('metrics', { transport: 'analytics' }))
+     * private metrics: Ulak.Messages<'metrics'>;
+     * ```
+     */
+    function messages(prefix, options) {
+        return [ICoreServiceNames.__ULAK__, (u) => u.messages(prefix, options)];
+    }
+    ulak.messages = messages;
+})(ulak || (ulak = {}));
 //# sourceMappingURL=Ulak.js.map

package/dist/lib/server/messaging/Ulak.js.map

@@ -1 +1 @@
-{"version":3,"file":"Ulak.js","sourceRoot":"","sources":["../../../../lib/server/messaging/Ulak.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Ulak.js","sourceRoot":"","sources":["../../../../lib/server/messaging/Ulak.ts"],"names":[],"mappings":"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"}

package/dist/lib/server/messaging/types.d.ts

@@ -9,7 +9,11 @@ export declare enum UlakErrorCode {
     SEND_FAILED = "SEND_FAILED",
     BROADCAST_FAILED = "BROADCAST_FAILED",
     SOCKET_NOT_FOUND = "SOCKET_NOT_FOUND",
-    SERVICE_NOT_INITIALIZED = "SERVICE_NOT_INITIALIZED"
+    SERVICE_NOT_INITIALIZED = "SERVICE_NOT_INITIALIZED",
+    NO_TRANSPORT = "NO_TRANSPORT",
+    TRANSPORT_NOT_FOUND = "TRANSPORT_NOT_FOUND",
+    TIMEOUT = "TIMEOUT",
+    REMOTE_ERROR = "REMOTE_ERROR"
 }
 /**
  * Custom error class for Ulak messaging system

package/dist/lib/server/messaging/types.js

@@ -11,6 +11,11 @@ export var UlakErrorCode;
     UlakErrorCode["BROADCAST_FAILED"] = "BROADCAST_FAILED";
     UlakErrorCode["SOCKET_NOT_FOUND"] = "SOCKET_NOT_FOUND";
     UlakErrorCode["SERVICE_NOT_INITIALIZED"] = "SERVICE_NOT_INITIALIZED";
+    // Microservice messaging
+    UlakErrorCode["NO_TRANSPORT"] = "NO_TRANSPORT";
+    UlakErrorCode["TRANSPORT_NOT_FOUND"] = "TRANSPORT_NOT_FOUND";
+    UlakErrorCode["TIMEOUT"] = "TIMEOUT";
+    UlakErrorCode["REMOTE_ERROR"] = "REMOTE_ERROR";
 })(UlakErrorCode || (UlakErrorCode = {}));
 /**
  * Custom error class for Ulak messaging system

package/dist/lib/server/messaging/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../lib/server/messaging/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,4DAA2C,CAAA;IAC3C,sEAAqD,CAAA;IACrD,wDAAuC,CAAA;IACvC,oDAAmC,CAAA;IACnC,4CAA2B,CAAA;IAC3B,sDAAqC,CAAA;IACrC,sDAAqC,CAAA;IACrC,oEAAmD,CAAA;AACrD,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAgB;IAEpB,SAAS,CAAU;IAEnB,KAAK,CAAS;IAE9B,YAAY,OAAe,EAAE,IAAmB,EAAE,SAAkB,EAAE,KAAa;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,4CAA4C;QAC5C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../lib/server/messaging/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,aAeX;AAfD,WAAY,aAAa;IACvB,4DAA2C,CAAA;IAC3C,sEAAqD,CAAA;IACrD,wDAAuC,CAAA;IACvC,oDAAmC,CAAA;IACnC,4CAA2B,CAAA;IAC3B,sDAAqC,CAAA;IACrC,sDAAqC,CAAA;IACrC,oEAAmD,CAAA;IAEnD,yBAAyB;IACzB,8CAA6B,CAAA;IAC7B,4DAA2C,CAAA;IAC3C,oCAAmB,CAAA;IACnB,8CAA6B,CAAA;AAC/B,CAAC,EAfW,aAAa,KAAb,aAAa,QAexB;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAgB;IAEpB,SAAS,CAAU;IAEnB,KAAK,CAAS;IAE9B,YAAY,OAAe,EAAE,IAAmB,EAAE,SAAkB,EAAE,KAAa;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,4CAA4C;QAC5C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF"}

package/dist/lib/server/microservice/InMemoryTransport.d.ts

@@ -0,0 +1,45 @@
+import type { EmitOptions, EventPatternHandler, MessageHandler, MicroserviceTransport, SendOptions } from './MicroserviceTransport';
+/**
+ * @description Zero-dependency in-process microservice transport.
+ *
+ * Messages never leave the process — send/emit dispatch directly to handlers
+ * registered in the same application. Useful as:
+ * - a development mode before a broker is available
+ * - a test double for @MessageController integration tests
+ * - the reference implementation of the MicroserviceTransport SPI
+ *
+ * Delivery semantics: synchronous at-most-once, attempt is always 1.
+ *
+ * @example
+ * @Config()
+ * export class AppConfig extends ConfigService {
+ *   transport() {
+ *     return { microservice: new InMemoryTransport() };
+ *   }
+ * }
+ */
+export declare class InMemoryTransport implements MicroserviceTransport {
+    readonly name = "in-memory";
+    /**
+     * Exact request pattern -> handler (request/response requires exact routing)
+     */
+    private messageHandlers;
+    /**
+     * Event handler index (shared hybrid exact/wildcard implementation)
+     */
+    private eventHandlers;
+    /**
+     * Monotonic counter used to build message ids
+     */
+    private sequence;
+    readonly isConnected = true;
+    init(): Promise<void>;
+    registerMessageHandler(pattern: string, handler: MessageHandler): void;
+    registerEventHandler(pattern: string, handler: EventPatternHandler): void;
+    listen(): Promise<void>;
+    send<T = unknown>(pattern: string, data?: unknown, options?: SendOptions): Promise<T>;
+    emit(pattern: string, data?: unknown, options?: EmitOptions): Promise<void>;
+    destroy(): Promise<void>;
+    private createContext;
+    private withTimeout;
+}

package/dist/lib/server/microservice/InMemoryTransport.js

@@ -0,0 +1,124 @@
+import { UlakError, UlakErrorCode } from '../messaging/types';
+import { PatternHandlerIndex } from '../event/PatternHandlerIndex';
+/**
+ * @description Zero-dependency in-process microservice transport.
+ *
+ * Messages never leave the process — send/emit dispatch directly to handlers
+ * registered in the same application. Useful as:
+ * - a development mode before a broker is available
+ * - a test double for @MessageController integration tests
+ * - the reference implementation of the MicroserviceTransport SPI
+ *
+ * Delivery semantics: synchronous at-most-once, attempt is always 1.
+ *
+ * @example
+ * @Config()
+ * export class AppConfig extends ConfigService {
+ *   transport() {
+ *     return { microservice: new InMemoryTransport() };
+ *   }
+ * }
+ */
+export class InMemoryTransport {
+    name = 'in-memory';
+    /**
+     * Exact request pattern -> handler (request/response requires exact routing)
+     */
+    messageHandlers = new Map();
+    /**
+     * Event handler index (shared hybrid exact/wildcard implementation)
+     */
+    eventHandlers = new PatternHandlerIndex();
+    /**
+     * Monotonic counter used to build message ids
+     */
+    sequence = 0;
+    isConnected = true;
+    async init() {
+        // Nothing to connect - in-process only
+    }
+    registerMessageHandler(pattern, handler) {
+        // Validate the FINAL pattern: the decorator only sees the raw method
+        // pattern, so a wildcard or emptiness introduced by the @MessageController
+        // prefix would otherwise slip through
+        if (!pattern) {
+            throw new Error('Message pattern cannot be empty - check @MessagePattern and the @MessageController prefix');
+        }
+        if (pattern.includes('*')) {
+            throw new Error(`Message pattern "${pattern}" cannot contain wildcards - request/response requires exact routing ` +
+                '(a wildcard likely leaked in via the @MessageController prefix - remove it, or set ' +
+                'prefix: false on the @MessagePattern)');
+        }
+        if (this.messageHandlers.has(pattern)) {
+            throw new Error(`Duplicate @MessagePattern('${pattern}') - a message pattern can only have one handler`);
+        }
+        this.messageHandlers.set(pattern, handler);
+    }
+    registerEventHandler(pattern, handler) {
+        if (!pattern) {
+            throw new Error('Event pattern cannot be empty - check @EventPattern and the @MessageController prefix');
+        }
+        this.eventHandlers.add(pattern, handler);
+    }
+    async listen() {
+        // Nothing to consume - handlers are invoked directly by send/emit
+    }
+    async send(pattern, data, options) {
+        const handler = this.messageHandlers.get(pattern);
+        if (!handler) {
+            throw new UlakError(`No message handler registered for pattern "${pattern}"`, UlakErrorCode.SEND_FAILED);
+        }
+        const context = this.createContext(pattern, crypto.randomUUID(), options?.headers);
+        const invocation = Promise.resolve().then(() => handler(data, context));
+        try {
+            const result = options?.timeout ? await this.withTimeout(invocation, options.timeout, pattern) : await invocation;
+            return result;
+        }
+        catch (error) {
+            if (error instanceof UlakError) {
+                throw error;
+            }
+            throw new UlakError(`Handler for pattern "${pattern}" failed: ${error.message}`, UlakErrorCode.REMOTE_ERROR, undefined, error);
+        }
+    }
+    async emit(pattern, data, options) {
+        const handlers = this.eventHandlers.collect(pattern);
+        // One context per emit: every handler of the same event must observe the
+        // SAME messageId (as in Redis, where all handlers see the entry id) - the
+        // documented messageId-dedup recipe relies on this
+        const context = this.createContext(pattern, undefined, options?.headers);
+        // Fire-and-forget: handler failures must not reach the emitter
+        await Promise.allSettled(handlers.map((handler) => Promise.resolve().then(() => handler(data, context))));
+    }
+    async destroy() {
+        this.messageHandlers.clear();
+        this.eventHandlers.clear();
+    }
+    createContext(pattern, correlationId, headers) {
+        return {
+            pattern,
+            messageId: `mem-${++this.sequence}`,
+            correlationId,
+            headers: { ...headers },
+            timestamp: Date.now(),
+            attempt: 1,
+        };
+    }
+    withTimeout(promise, timeout, pattern) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new UlakError(`Request "${pattern}" timed out after ${timeout}ms`, UlakErrorCode.TIMEOUT));
+            }, timeout);
+            promise
+                .then((value) => {
+                clearTimeout(timer);
+                resolve(value);
+            })
+                .catch((error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+}
+//# sourceMappingURL=InMemoryTransport.js.map

package/dist/lib/server/microservice/InMemoryTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryTransport.js","sourceRoot":"","sources":["../../../../lib/server/microservice/InMemoryTransport.ts"],"names":[],"mappings":"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"}

package/dist/lib/server/microservice/MicroserviceTransport.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @description Context passed to every microservice message/event handler.
+ * Carries transport-level metadata about the incoming message.
+ */
+export interface MessageContext {
+    /**
+     * Concrete pattern of the incoming message (e.g. 'order.create')
+     */
+    pattern: string;
+    /**
+     * Transport-assigned unique id of the message (e.g. Redis stream entry id).
+     * Useful for idempotency/deduplication in at-least-once transports.
+     */
+    messageId: string;
+    /**
+     * Correlation id, present only for request/response messages
+     */
+    correlationId?: string;
+    /**
+     * Message headers (trace context, user metadata, ...)
+     */
+    headers: Record<string, string>;
+    /**
+     * Producer-side timestamp (epoch millis)
+     */
+    timestamp: number;
+    /**
+     * Delivery attempt number, starting at 1.
+     * Greater than 1 means the message was redelivered (at-least-once transports).
+     */
+    attempt: number;
+}
+/**
+ * @description Handler for request/response messages (@MessagePattern).
+ * The return value is serialized and sent back to the caller as the reply.
+ */
+export type MessageHandler = (data: any, context: MessageContext) => any | Promise<any>;
+/**
+ * @description Handler for fire-and-forget events (@EventPattern)
+ */
+export type EventPatternHandler = (data: any, context: MessageContext) => void | Promise<void>;
+/**
+ * @description Options for request/response sends
+ */
+export interface SendOptions {
+    /**
+     * Reply timeout in milliseconds (transport default applies when omitted)
+     */
+    timeout?: number;
+    /**
+     * Extra headers attached to the outgoing message
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * @description Options for fire-and-forget emits
+ */
+export interface EmitOptions {
+    /**
+     * Extra headers attached to the outgoing event
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * @description Options for transport shutdown
+ */
+export interface DestroyOptions {
+    /**
+     * Max time in milliseconds to wait for in-flight handlers to finish
+     * before closing connections (graceful drain)
+     */
+    drainTimeout?: number;
+}
+/**
+ * @description Broker-agnostic microservice transport SPI.
+ *
+ * A transport carries two message semantics between Asena services:
+ * - request/response (@MessagePattern) — exact patterns, a reply is produced
+ * - fire-and-forget events (@EventPattern) — wildcard patterns allowed
+ *
+ * Lifecycle contract (driven by PrepareMicroserviceService):
+ * 1. registerMessageHandler / registerEventHandler — push all handler registrations
+ * 2. init() — connect broker resources; after init, send/emit must work (client-only mode)
+ * 3. listen() — start consuming. MUST only consume sources that have at least one
+ *    registered handler; with zero handlers no consumer may be started (client-only mode)
+ * 4. destroy() — graceful drain, then release all resources
+ */
+export interface MicroserviceTransport {
+    /**
+     * Human-readable transport name (used in logs and health reporting)
+     */
+    readonly name: string;
+    /**
+     * Whether the transport currently holds a live broker connection.
+     * Read by the health endpoint.
+     */
+    readonly isConnected: boolean;
+    /**
+     * Connect broker resources. Called once before listen().
+     * After init() resolves, send()/emit() must be usable (client-only mode).
+     */
+    init(): Promise<void>;
+    /**
+     * Register a request/response handler. Patterns must be exact (no wildcards).
+     */
+    registerMessageHandler(pattern: string, handler: MessageHandler): void;
+    /**
+     * Register a fire-and-forget event handler. Patterns arrive with the
+     * @MessageController prefix already resolved and may contain wildcards
+     * (e.g. 'payment.*').
+     */
+    registerEventHandler(pattern: string, handler: EventPatternHandler): void;
+    /**
+     * Start consuming registered patterns.
+     * Contract: only sources with at least one registered handler are consumed;
+     * with zero handlers no consumer loop is started.
+     */
+    listen(): Promise<void>;
+    /**
+     * Send a request and await its reply (request/response semantics)
+     */
+    send<T = unknown>(pattern: string, data?: unknown, options?: SendOptions): Promise<T>;
+    /**
+     * Emit a fire-and-forget event
+     */
+    emit(pattern: string, data?: unknown, options?: EmitOptions): Promise<void>;
+    /**
+     * Gracefully shut down: stop consuming, drain in-flight handlers,
+     * reject pending sends, release connections.
+     */
+    destroy(options?: DestroyOptions): Promise<void>;
+}

package/dist/lib/server/microservice/MicroserviceTransport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MicroserviceTransport.js.map

package/dist/lib/server/microservice/MicroserviceTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MicroserviceTransport.js","sourceRoot":"","sources":["../../../../lib/server/microservice/MicroserviceTransport.ts"],"names":[],"mappings":""}

package/dist/lib/server/microservice/decorators/EventPattern.d.ts

@@ -0,0 +1,38 @@
+import type { EventPatternParams } from '../types';
+/**
+ * @description EventPattern decorator - Marks a method as a fire-and-forget event handler
+ *
+ * Methods decorated with @EventPattern will be automatically registered into the
+ * configured microservice transport when the server boots (via PrepareMicroserviceService).
+ * No reply is produced; delivery is at-least-once on durable transports, so handlers
+ * should be idempotent (use context.messageId for deduplication).
+ *
+ * The controller prefix is joined onto the pattern ('order' + 'created' →
+ * 'order.created'), matching what ulak.messages('order').emit('created') publishes.
+ * Pass `prefix: false` when the pattern is absolute — another service's event
+ * vocabulary, a Kafka external topic name, or a global catch-all.
+ * Wildcards are supported: 'payment.*', '*.completed', 'user.*.created'.
+ * Note that under a prefix, '*' becomes 'order.*' and is no longer a global catch-all.
+ *
+ * @param params - Event pattern or configuration object
+ *
+ * @example
+ * @MessageController('order')
+ * export class OrderHandler {
+ *   @EventPattern('created')  // Handles 'order.created'
+ *   async onCreated(event: OrderEvent, context: MessageContext) { }
+ *
+ *   // Absolute - another service's event vocabulary
+ *   @EventPattern({ pattern: 'payment.completed', prefix: false })
+ *   async onPaymentCompleted(event: PaymentEvent, context: MessageContext) {
+ *     await this.orderService.markPaid(event.orderId);
+ *   }
+ *
+ *   @EventPattern('*')  // Wildcards allowed - handles 'order.*'
+ *   async onAnyOrderEvent(event: any, context: MessageContext) { }
+ *
+ *   @EventPattern({ pattern: 'stock.depleted', skip: true })  // Temporarily disabled
+ *   async onStockDepleted(event: any, context: MessageContext) { }
+ * }
+ */
+export declare function EventPattern(params: EventPatternParams | string): MethodDecorator;