@asenajs/asena 0.7.1 → 0.8.0

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;

package/dist/lib/server/microservice/decorators/EventPattern.js

@@ -0,0 +1,59 @@
+import { ComponentConstants } from '../../../ioc';
+import { defineTypedMetadata, getOwnTypedMetadata } from '../../../utils';
+/**
+ * @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 function EventPattern(params) {
+    // Normalize params - support both object and string
+    const _params = typeof params === 'string' ? { pattern: params, skip: false } : params;
+    return function (target, propertyKey, descriptor) {
+        // Get existing handlers metadata (other @MessagePattern/@EventPattern methods)
+        const handlers = getOwnTypedMetadata(ComponentConstants.MessageHandlersKey, target.constructor) || {};
+        // Add this handler's metadata
+        handlers[propertyKey.toString()] = {
+            pattern: _params.pattern,
+            type: 'event',
+            methodName: propertyKey.toString(),
+            // `!== false` covers the string shorthand and objects that omit the flag
+            prefix: _params.prefix !== false,
+            skip: _params.skip || false,
+        };
+        // Store updated metadata
+        defineTypedMetadata(ComponentConstants.MessageHandlersKey, handlers, target.constructor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=EventPattern.js.map

package/dist/lib/server/microservice/decorators/EventPattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventPattern.js","sourceRoot":"","sources":["../../../../../lib/server/microservice/decorators/EventPattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmC;IAC9D,oDAAoD;IACpD,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAEvF,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,UAA8B;QAC3F,+EAA+E;QAC/E,MAAM,QAAQ,GACZ,mBAAmB,CACjB,kBAAkB,CAAC,kBAAkB,EACrC,MAAM,CAAC,WAAW,CACnB,IAAI,EAAE,CAAC;QAEV,8BAA8B;QAC9B,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,GAAG;YACjC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE;YAClC,yEAAyE;YACzE,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,KAAK;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;SAC5B,CAAC;QAEF,yBAAyB;QACzB,mBAAmB,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAEzF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { MessagePatternParams } from '../types';
+/**
+ * @description MessagePattern decorator - Marks a method as a request/response handler
+ *
+ * Methods decorated with @MessagePattern will be automatically registered into the
+ * configured microservice transport when the server boots (via PrepareMicroserviceService).
+ * The method's return value is sent back to the caller as the reply.
+ *
+ * The controller prefix is joined onto the pattern ('order' + 'create' → 'order.create').
+ * Pass `prefix: false` to register the pattern verbatim.
+ * Wildcards are NOT allowed — request/response requires exact routing — and
+ * `prefix: false` does not relax that.
+ *
+ * @param params - Request pattern or configuration object
+ *
+ * @example
+ * @MessageController('order')
+ * export class OrderHandler {
+ *   @MessagePattern('create')  // Handles 'order.create'
+ *   async create(data: CreateOrderDto, context: MessageContext) {
+ *     return this.orderService.create(data);  // reply sent to caller
+ *   }
+ *
+ *   @MessagePattern({ pattern: 'ping', prefix: false })  // Handles 'ping'
+ *   async ping(data: any, context: MessageContext) { }
+ *
+ *   @MessagePattern({ pattern: 'delete', skip: true })  // Temporarily disabled
+ *   async delete(data: any, context: MessageContext) { }
+ * }
+ */
+export declare function MessagePattern(params: MessagePatternParams | string): MethodDecorator;

package/dist/lib/server/microservice/decorators/MessagePattern.js

@@ -0,0 +1,55 @@
+import { ComponentConstants } from '../../../ioc';
+import { defineTypedMetadata, getOwnTypedMetadata } from '../../../utils';
+/**
+ * @description MessagePattern decorator - Marks a method as a request/response handler
+ *
+ * Methods decorated with @MessagePattern will be automatically registered into the
+ * configured microservice transport when the server boots (via PrepareMicroserviceService).
+ * The method's return value is sent back to the caller as the reply.
+ *
+ * The controller prefix is joined onto the pattern ('order' + 'create' → 'order.create').
+ * Pass `prefix: false` to register the pattern verbatim.
+ * Wildcards are NOT allowed — request/response requires exact routing — and
+ * `prefix: false` does not relax that.
+ *
+ * @param params - Request pattern or configuration object
+ *
+ * @example
+ * @MessageController('order')
+ * export class OrderHandler {
+ *   @MessagePattern('create')  // Handles 'order.create'
+ *   async create(data: CreateOrderDto, context: MessageContext) {
+ *     return this.orderService.create(data);  // reply sent to caller
+ *   }
+ *
+ *   @MessagePattern({ pattern: 'ping', prefix: false })  // Handles 'ping'
+ *   async ping(data: any, context: MessageContext) { }
+ *
+ *   @MessagePattern({ pattern: 'delete', skip: true })  // Temporarily disabled
+ *   async delete(data: any, context: MessageContext) { }
+ * }
+ */
+export function MessagePattern(params) {
+    // Normalize params - support both object and string
+    const _params = typeof params === 'string' ? { pattern: params, skip: false } : params;
+    if (_params.pattern.includes('*')) {
+        throw new Error(`@MessagePattern('${_params.pattern}') cannot contain wildcards - request/response requires exact patterns. Use @EventPattern for wildcard subscriptions.`);
+    }
+    return function (target, propertyKey, descriptor) {
+        // Get existing handlers metadata (other @MessagePattern/@EventPattern methods)
+        const handlers = getOwnTypedMetadata(ComponentConstants.MessageHandlersKey, target.constructor) || {};
+        // Add this handler's metadata
+        handlers[propertyKey.toString()] = {
+            pattern: _params.pattern,
+            type: 'message',
+            methodName: propertyKey.toString(),
+            // `!== false` covers the string shorthand and objects that omit the flag
+            prefix: _params.prefix !== false,
+            skip: _params.skip || false,
+        };
+        // Store updated metadata
+        defineTypedMetadata(ComponentConstants.MessageHandlersKey, handlers, target.constructor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=MessagePattern.js.map

package/dist/lib/server/microservice/decorators/MessagePattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagePattern.js","sourceRoot":"","sources":["../../../../../lib/server/microservice/decorators/MessagePattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqC;IAClE,oDAAoD;IACpD,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAEvF,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,CAAC,OAAO,uHAAuH,CAC3J,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,UAA8B;QAC3F,+EAA+E;QAC/E,MAAM,QAAQ,GACZ,mBAAmB,CACjB,kBAAkB,CAAC,kBAAkB,EACrC,MAAM,CAAC,WAAW,CACnB,IAAI,EAAE,CAAC;QAEV,8BAA8B;QAC9B,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,GAAG;YACjC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE;YAClC,yEAAyE;YACzE,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,KAAK;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;SAC5B,CAAC;QAEF,yBAAyB;QACzB,mBAAmB,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAEzF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from './MessagePattern';
+export * from './EventPattern';

package/dist/lib/server/microservice/decorators/index.js

@@ -0,0 +1,3 @@
+export * from './MessagePattern';
+export * from './EventPattern';
+//# sourceMappingURL=index.js.map

package/dist/lib/server/microservice/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../lib/server/microservice/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './MicroserviceTransport';
+export * from './types';
+export * from './InMemoryTransport';
+export * from './interceptorChain';
+export * from './decorators';

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

@@ -0,0 +1,11 @@
+// Transport SPI
+export * from './MicroserviceTransport';
+// Types (params, metadata, interceptor SPI)
+export * from './types';
+// In-process reference transport
+export * from './InMemoryTransport';
+// Interceptor composition (used by Ulak and PrepareMicroserviceService)
+export * from './interceptorChain';
+// Decorators
+export * from './decorators';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/server/microservice/index.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,cAAc,yBAAyB,CAAC;AAExC,4CAA4C;AAC5C,cAAc,SAAS,CAAC;AAExB,iCAAiC;AACjC,cAAc,qBAAqB,CAAC;AAEpC,wEAAwE;AACxE,cAAc,oBAAoB,CAAC;AAEnC,aAAa;AACb,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { MessageContext } from './MicroserviceTransport';
+import type { MessagingInterceptor, OutboundContext } from './types';
+/**
+ * @description Composes interceptor onSend hooks around an outgoing operation.
+ * Interceptors run in registration order (first interceptor is outermost).
+ *
+ * @param interceptors - Registered messaging interceptors
+ * @param ctx - Outbound context (interceptors may mutate ctx.headers)
+ * @param operation - The actual transport send/emit call
+ */
+export declare function composeOnSend(interceptors: MessagingInterceptor[], ctx: OutboundContext, operation: () => Promise<any>): Promise<any>;
+/**
+ * @description Composes interceptor onReceive hooks around a handler invocation.
+ * Interceptors run in registration order (first interceptor is outermost).
+ *
+ * @param interceptors - Registered messaging interceptors
+ * @param ctx - Incoming message context
+ * @param operation - The actual handler invocation
+ */
+export declare function composeOnReceive(interceptors: MessagingInterceptor[], ctx: MessageContext, operation: () => Promise<any>): Promise<any>;

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

@@ -0,0 +1,39 @@
+/**
+ * @description Composes interceptor onSend hooks around an outgoing operation.
+ * Interceptors run in registration order (first interceptor is outermost).
+ *
+ * @param interceptors - Registered messaging interceptors
+ * @param ctx - Outbound context (interceptors may mutate ctx.headers)
+ * @param operation - The actual transport send/emit call
+ */
+export function composeOnSend(interceptors, ctx, operation) {
+    let next = operation;
+    for (let i = interceptors.length - 1; i >= 0; i--) {
+        const interceptor = interceptors[i];
+        if (interceptor.onSend) {
+            const inner = next;
+            next = () => interceptor.onSend(ctx, inner);
+        }
+    }
+    return next();
+}
+/**
+ * @description Composes interceptor onReceive hooks around a handler invocation.
+ * Interceptors run in registration order (first interceptor is outermost).
+ *
+ * @param interceptors - Registered messaging interceptors
+ * @param ctx - Incoming message context
+ * @param operation - The actual handler invocation
+ */
+export function composeOnReceive(interceptors, ctx, operation) {
+    let next = operation;
+    for (let i = interceptors.length - 1; i >= 0; i--) {
+        const interceptor = interceptors[i];
+        if (interceptor.onReceive) {
+            const inner = next;
+            next = () => interceptor.onReceive(ctx, inner);
+        }
+    }
+    return next();
+}
+//# sourceMappingURL=interceptorChain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interceptorChain.js","sourceRoot":"","sources":["../../../../lib/server/microservice/interceptorChain.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAoC,EACpC,GAAoB,EACpB,SAA6B;IAE7B,IAAI,IAAI,GAAG,SAAS,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAEpC,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC;YAEnB,IAAI,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAoC,EACpC,GAAmB,EACnB,SAA6B;IAE7B,IAAI,IAAI,GAAG,SAAS,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAEpC,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,CAAC;YAEnB,IAAI,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,142 @@
+import type { ComponentParams } from '../../ioc';
+import type { MessageContext } from './MicroserviceTransport';
+/**
+ * @description Name used when a single (unnamed) microservice transport is configured
+ */
+export declare const DEFAULT_TRANSPORT_NAME = "default";
+/**
+ * @description Parameters for @MessageController decorator
+ */
+export interface MessageControllerParams extends ComponentParams {
+    /**
+     * Prefix joined (with a dot) onto every @MessagePattern AND @EventPattern in
+     * this controller. A single handler opts out with `prefix: false`.
+     * Must be a literal path segment — a wildcard prefix is rejected at boot.
+     * @example 'order' turns @MessagePattern('create') into 'order.create'
+     *          and @EventPattern('created') into 'order.created'
+     */
+    prefix?: string;
+    /**
+     * Name of the microservice transport this controller binds to.
+     * Only needed when multiple named transports are configured in transport()
+     * (e.g. part of the project on Redis, part on NATS).
+     * @default 'default'
+     */
+    transport?: string;
+}
+/**
+ * @description Parameters for @MessagePattern method decorator
+ */
+export interface MessagePatternParams {
+    /**
+     * Request pattern to handle. Must be exact — wildcards are not allowed
+     * (request/response requires exact routing).
+     * @example 'create' (joined with the controller prefix → 'order.create')
+     */
+    pattern: string;
+    /**
+     * Join the @MessageController prefix onto `pattern`.
+     * Set false to register the pattern verbatim — for patterns that belong to
+     * another service's vocabulary rather than this controller's.
+     * @default true
+     */
+    prefix?: boolean;
+    /**
+     * Skip this handler (useful for temporarily disabling handlers)
+     * @default false
+     */
+    skip?: boolean;
+}
+/**
+ * @description Parameters for @EventPattern method decorator
+ */
+export interface EventPatternParams {
+    /**
+     * Event pattern to handle. Wildcards are supported.
+     * The controller prefix is joined on unless `prefix: false`.
+     * @example 'created' (joined with the controller prefix → 'order.created')
+     */
+    pattern: string;
+    /**
+     * Join the @MessageController prefix onto `pattern`.
+     * Set false for absolute names: another service's event vocabulary, a Kafka
+     * external topic name, or a global catch-all ('*').
+     * @default true
+     */
+    prefix?: boolean;
+    /**
+     * Skip this handler (useful for temporarily disabling handlers)
+     * @default false
+     */
+    skip?: boolean;
+}
+/**
+ * @description Metadata stored for each @MessagePattern/@EventPattern method
+ * Used by PrepareMicroserviceService to register handlers into the transport
+ */
+export interface MessageHandlerMetadata {
+    /**
+     * Pattern as written on the decorator. The @MessageController prefix is
+     * joined on later by PrepareMicroserviceService unless `prefix` is false.
+     */
+    pattern: string;
+    /**
+     * Handler semantics: request/response ('message') or fire-and-forget ('event')
+     */
+    type: 'message' | 'event';
+    /**
+     * Method name to call when a message arrives
+     */
+    methodName: string;
+    /**
+     * Whether the controller prefix is joined onto `pattern`.
+     * Normalized at decoration time (`prefix: false` opt-out → false).
+     */
+    prefix: boolean;
+    /**
+     * Whether this handler should be skipped
+     */
+    skip: boolean;
+}
+/**
+ * @description Context passed to MessagingInterceptor.onSend for outgoing messages
+ */
+export interface OutboundContext {
+    /**
+     * Full outgoing pattern (prefix already applied)
+     */
+    pattern: string;
+    /**
+     * Whether this is a request ('send') or a fire-and-forget event ('emit')
+     */
+    kind: 'send' | 'emit';
+    /**
+     * Mutable outgoing headers — interceptors inject metadata here (e.g. trace context)
+     */
+    headers: Record<string, string>;
+    /**
+     * Outgoing payload (read-only by convention)
+     */
+    data: unknown;
+}
+/**
+ * @description Zero-dependency messaging interceptor SPI.
+ *
+ * Both hooks are wrappers around the actual operation, so an interceptor can
+ * measure duration and observe errors/replies (e.g. OpenTelemetry spans).
+ * Interceptors are registered via the transport() config hook:
+ * `transport() { return { microservice, interceptors: [myInterceptor] } }`
+ */
+export interface MessagingInterceptor {
+    /**
+     * Wraps outgoing send/emit. Mutate ctx.headers to inject metadata,
+     * call next() to perform the operation (its promise resolves with the
+     * reply for 'send', undefined for 'emit').
+     */
+    onSend?(ctx: OutboundContext, next: () => Promise<any>): Promise<any>;
+    /**
+     * Wraps an incoming handler invocation. Call next() to run the handler
+     * (and any inner interceptors); its promise carries the handler result.
+     */
+    onReceive?(ctx: MessageContext, next: () => Promise<any>): Promise<any>;
+}

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

@@ -0,0 +1,5 @@
+/**
+ * @description Name used when a single (unnamed) microservice transport is configured
+ */
+export const DEFAULT_TRANSPORT_NAME = 'default';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../lib/server/microservice/types.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC"}

package/dist/lib/server/src/services/PrepareEventService.d.ts

@@ -15,6 +15,7 @@ import type { ICoreService } from '../../../ioc';
  * - Prefix='user', event='created' → 'user.created'
  * - Prefix='user', event='*.updated' → 'user.*.updated'
  * - Prefix='user', event='' → 'user'
+ * - Handler opted out (prefix: false) → event, verbatim
  */
 export declare class PrepareEventService implements ICoreService {
     readonly serviceName = "PrepareEventService";
@@ -31,7 +32,9 @@ export declare class PrepareEventService implements ICoreService {
     /**
      * Build final event pattern from prefix and event
      *
-     * Rules:
+     * Rules (identical to PrepareMicroserviceService.buildPattern and
+     * UlakMessages.buildPattern):
+     * - Handler opted out (prefix: false) → event
      * - No prefix → event
      * - No event → prefix
      * - Both → prefix.event

package/dist/lib/server/src/services/PrepareEventService.js

@@ -26,6 +26,7 @@ import { getTypedMetadata } from '../../../utils';
  * - Prefix='user', event='created' → 'user.created'
  * - Prefix='user', event='*.updated' → 'user.*.updated'
  * - Prefix='user', event='' → 'user'
+ * - Handler opted out (prefix: false) → event, verbatim
  */
 let PrepareEventService = class PrepareEventService {
     serviceName = 'PrepareEventService';
@@ -65,7 +66,9 @@ let PrepareEventService = class PrepareEventService {
                 continue;
             }
             // Build final event pattern
-            const finalPattern = this.buildEventPattern(prefix, metadata.pattern);
+            // `!== false`: metadata written by a pre-0.8 decorator build carries no
+            // flag and must follow the current default (apply the prefix)
+            const finalPattern = this.buildEventPattern(prefix, metadata.pattern, metadata.prefix !== false);
             // Bind method to service instance
             const boundHandler = service[methodName].bind(service);
             // Register with EventEmitter
@@ -75,12 +78,16 @@ let PrepareEventService = class PrepareEventService {
     /**
      * Build final event pattern from prefix and event
      *
-     * Rules:
+     * Rules (identical to PrepareMicroserviceService.buildPattern and
+     * UlakMessages.buildPattern):
+     * - Handler opted out (prefix: false) → event
      * - No prefix → event
      * - No event → prefix
      * - Both → prefix.event
      */
-    buildEventPattern(prefix, event) {
+    buildEventPattern(prefix, event, applyPrefix) {
+        if (!applyPrefix)
+            return event;
         if (!prefix)
             return event;
         if (!event)