@asenajs/asena 0.7.0 → 0.8.0

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;

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"}