@asenajs/asena 0.7.1 → 0.8.0

package/dist/lib/server/config/AsenaConfig.js

@@ -1,2 +1,40 @@
-export {};
+import { DEFAULT_TRANSPORT_NAME } from '../microservice/types';
+/**
+ * Normalize the transport() hook result into a single shape.
+ *
+ * - A bare WebSocketTransport (has a publish function) is the legacy form → { websocket }
+ * - An object form is discriminated per field; a single MicroserviceTransport
+ *   (has a send function) becomes the 'default' named transport
+ * - An object with none of the known fields throws (catches accidentally
+ *   returning a bare MicroserviceTransport, which would otherwise be a silent no-op)
+ *
+ * CAVEAT: the legacy detection is duck-typed on `publish`. A custom
+ * MicroserviceTransport that also defines a `publish` method would be
+ * mistaken for a bare WebSocketTransport when returned bare - such
+ * transports must use the explicit `{ microservice: ... }` object form.
+ */
+export async function normalizeTransportConfig(result) {
+    // Legacy form: bare WebSocketTransport (publish is its only required member)
+    if (typeof result.publish === 'function') {
+        return { websocket: result, microservices: new Map(), interceptors: [] };
+    }
+    const config = result;
+    if (config.websocket === undefined && config.microservice === undefined && config.interceptors === undefined) {
+        throw new Error('transport() returned an object without websocket/microservice/interceptors fields - return a WebSocketTransport or an AsenaTransportConfig object');
+    }
+    const websocket = config.websocket ? await config.websocket : undefined;
+    const microservices = new Map();
+    if (config.microservice) {
+        const resolved = await config.microservice;
+        if (typeof resolved.send === 'function') {
+            microservices.set(DEFAULT_TRANSPORT_NAME, resolved);
+        }
+        else {
+            for (const [name, transport] of Object.entries(resolved)) {
+                microservices.set(name, transport);
+            }
+        }
+    }
+    return { websocket, microservices, interceptors: config.interceptors || [] };
+}
 //# sourceMappingURL=AsenaConfig.js.map

package/dist/lib/server/config/AsenaConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsenaConfig.js","sourceRoot":"","sources":["../../../../lib/server/config/AsenaConfig.ts"],"names":[],"mappings":""}
+{"version":3,"file":"AsenaConfig.js","sourceRoot":"","sources":["../../../../lib/server/config/AsenaConfig.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AA2C/D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAiD;IAEjD,6EAA6E;IAC7E,IAAI,OAAQ,MAA6B,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACjE,OAAO,EAAE,SAAS,EAAE,MAA4B,EAAE,aAAa,EAAE,IAAI,GAAG,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IACjG,CAAC;IAED,MAAM,MAAM,GAAG,MAA8B,CAAC;IAE9C,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7G,MAAM,IAAI,KAAK,CACb,mJAAmJ,CACpJ,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAiC,CAAC;IAE/D,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;QAE3C,IAAI,OAAQ,QAAkC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACnE,aAAa,CAAC,GAAG,CAAC,sBAAsB,EAAE,QAAiC,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAiD,CAAC,EAAE,CAAC;gBAClG,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;AAC/E,CAAC"}

package/dist/lib/server/decorators/components/MessageController.d.ts

@@ -0,0 +1,49 @@
+import type { MessageControllerParams } from '../../microservice';
+/**
+ * @description MessageController decorator - Marks a class as a microservice message controller
+ *
+ * Message controllers contain @MessagePattern (request/response) and
+ * @EventPattern (fire-and-forget) decorated methods. They are registered into the
+ * microservice transport configured via the @Config transport() hook.
+ *
+ * The prefix is joined (with a dot) onto every @MessagePattern AND @EventPattern
+ * in the class. A single handler opts out with `prefix: false`.
+ *
+ * @param params - Optional configuration or prefix string
+ *
+ * @example
+ * // With prefix
+ * @MessageController('order')
+ * export class OrderHandler {
+ *   @MessagePattern('create')  // Handles 'order.create'
+ *   async create(data: CreateOrderDto, context: MessageContext) {
+ *     return this.orderService.create(data);
+ *   }
+ *
+ *   @EventPattern('created')  // Handles 'order.created'
+ *   async onCreated(event: OrderEvent) { }
+ *
+ *   // Absolute - another service's event vocabulary
+ *   @EventPattern({ pattern: 'payment.completed', prefix: false })
+ *   async onPaymentCompleted(event: PaymentEvent) { }
+ * }
+ *
+ * @example
+ * // Without prefix
+ * @MessageController()
+ * export class GlobalHandler {
+ *   @MessagePattern('ping')  // Handles 'ping'
+ *   async ping() {
+ *     return 'pong';
+ *   }
+ * }
+ *
+ * @example
+ * // Bound to a named transport (multi-broker projects)
+ * @MessageController({ prefix: 'metrics', transport: 'analytics' })
+ * export class AnalyticsHandler {
+ *   @EventPattern('page.viewed')  // Handles 'metrics.page.viewed'
+ *   async onPageViewed(event: PageViewedEvent) { }
+ * }
+ */
+export declare const MessageController: (params?: MessageControllerParams | string) => ClassDecorator;

package/dist/lib/server/decorators/components/MessageController.js

@@ -0,0 +1,62 @@
+import { ComponentConstants, ComponentType } from '../../../ioc';
+import { defineComponent } from '../../../ioc/component';
+import { defineTypedMetadata } from '../../../utils';
+import { DEFAULT_TRANSPORT_NAME } from '../../microservice';
+/**
+ * @description MessageController decorator - Marks a class as a microservice message controller
+ *
+ * Message controllers contain @MessagePattern (request/response) and
+ * @EventPattern (fire-and-forget) decorated methods. They are registered into the
+ * microservice transport configured via the @Config transport() hook.
+ *
+ * The prefix is joined (with a dot) onto every @MessagePattern AND @EventPattern
+ * in the class. A single handler opts out with `prefix: false`.
+ *
+ * @param params - Optional configuration or prefix string
+ *
+ * @example
+ * // With prefix
+ * @MessageController('order')
+ * export class OrderHandler {
+ *   @MessagePattern('create')  // Handles 'order.create'
+ *   async create(data: CreateOrderDto, context: MessageContext) {
+ *     return this.orderService.create(data);
+ *   }
+ *
+ *   @EventPattern('created')  // Handles 'order.created'
+ *   async onCreated(event: OrderEvent) { }
+ *
+ *   // Absolute - another service's event vocabulary
+ *   @EventPattern({ pattern: 'payment.completed', prefix: false })
+ *   async onPaymentCompleted(event: PaymentEvent) { }
+ * }
+ *
+ * @example
+ * // Without prefix
+ * @MessageController()
+ * export class GlobalHandler {
+ *   @MessagePattern('ping')  // Handles 'ping'
+ *   async ping() {
+ *     return 'pong';
+ *   }
+ * }
+ *
+ * @example
+ * // Bound to a named transport (multi-broker projects)
+ * @MessageController({ prefix: 'metrics', transport: 'analytics' })
+ * export class AnalyticsHandler {
+ *   @EventPattern('page.viewed')  // Handles 'metrics.page.viewed'
+ *   async onPageViewed(event: PageViewedEvent) { }
+ * }
+ */
+export const MessageController = (params) => {
+    // Normalize params BEFORE defineComponent - a bare string must become a prefix,
+    // otherwise paramsGenerator would treat it as the component name
+    const _params = typeof params === 'string' ? { prefix: params, name: undefined } : params || { prefix: undefined, name: undefined };
+    return defineComponent(ComponentType.MESSAGE_CONTROLLER, _params, (target) => {
+        // Store prefix + transport binding metadata for PrepareMicroserviceService
+        defineTypedMetadata(ComponentConstants.MessagePrefixKey, _params.prefix || '', target);
+        defineTypedMetadata(ComponentConstants.MessageTransportKey, _params.transport || DEFAULT_TRANSPORT_NAME, target);
+    });
+};
+//# sourceMappingURL=MessageController.js.map

package/dist/lib/server/decorators/components/MessageController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageController.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/MessageController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAyC,EAAkB,EAAE;IAC7F,gFAAgF;IAChF,iEAAiE;IACjE,MAAM,OAAO,GACX,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAEtH,OAAO,eAAe,CAAC,aAAa,CAAC,kBAAkB,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;QAC3E,2EAA2E;QAC3E,mBAAmB,CAAS,kBAAkB,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAE/F,mBAAmB,CACjB,kBAAkB,CAAC,mBAAmB,EACtC,OAAO,CAAC,SAAS,IAAI,sBAAsB,EAC3C,MAAM,CACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

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

@@ -8,3 +8,4 @@ export * from './WebSocket';
 export * from './StaticServe';
 export * from './EventService';
 export * from './FrontendController';
+export * from './MessageController';

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

@@ -8,4 +8,5 @@ export * from './WebSocket';
 export * from './StaticServe';
 export * from './EventService';
 export * from './FrontendController';
+export * from './MessageController';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/dist/lib/server/event/EventDispatchService.d.ts

@@ -26,14 +26,10 @@ export declare class EventDispatchService implements ICoreService {
      */
     private warmedUp;
     /**
-     * Exact pattern cache for O(1) lookup
-     * Key: exact event pattern, Value: handlers for that pattern
+     * Hybrid lookup index (exact Map + wildcard array), shared implementation
+     * with the microservice transports
      */
-    private exactMatches;
-    /**
-     * Wildcard patterns that need O(n) matching
-     */
-    private wildcardPatterns;
+    private index;
     /**
      * Register a handler for an event pattern
      *

package/dist/lib/server/event/EventDispatchService.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { CoreService } from '../../ioc';
 import { ICoreServiceNames } from '../../ioc';
-import { matchesEventPattern } from './eventPatternMatcher';
+import { PatternHandlerIndex } from './PatternHandlerIndex';
 /**
  * @description Internal event dispatch service
  * Handles pattern matching, storage, and dispatching of events
@@ -33,14 +33,10 @@ let EventDispatchService = class EventDispatchService {
      */
     warmedUp = false;
     /**
-     * Exact pattern cache for O(1) lookup
-     * Key: exact event pattern, Value: handlers for that pattern
+     * Hybrid lookup index (exact Map + wildcard array), shared implementation
+     * with the microservice transports
      */
-    exactMatches = new Map();
-    /**
-     * Wildcard patterns that need O(n) matching
-     */
-    wildcardPatterns = [];
+    index = new PatternHandlerIndex();
     /**
      * Register a handler for an event pattern
      *
@@ -94,24 +90,8 @@ let EventDispatchService = class EventDispatchService {
         if (!this.warmedUp) {
             this.warmup();
         }
-        const handlersToCall = [];
-        // 1. Check exact match cache - O(1)
-        const exactHandlers = this.exactMatches.get(eventName);
-        if (exactHandlers) {
-            for (const handler of exactHandlers) {
-                // Find full subscription info (for 'once' support)
-                const sub = this.handlers.find((s) => s.handler === handler && s.pattern === eventName);
-                if (sub) {
-                    handlersToCall.push(sub);
-                }
-            }
-        }
-        // 2. Check wildcard patterns - O(n) but smaller n
-        for (const sub of this.wildcardPatterns) {
-            if (matchesEventPattern(eventName, sub.pattern)) {
-                handlersToCall.push(sub);
-            }
-        }
+        // 1-2. Collect matching subscriptions: exact matches O(1), then wildcards O(n)
+        const handlersToCall = this.index.collect(eventName);
         // 3. No handlers matched
         if (handlersToCall.length === 0) {
             return false;
@@ -159,19 +139,9 @@ let EventDispatchService = class EventDispatchService {
      * @private
      */
     warmup() {
-        this.exactMatches.clear();
-        this.wildcardPatterns = [];
+        this.index.clear();
         for (const sub of this.handlers) {
-            if (sub.pattern.includes('*')) {
-                // Wildcard pattern - needs O(n) matching on dispatch
-                this.wildcardPatterns.push(sub);
-            }
-            else {
-                // Exact pattern - O(1) lookup on dispatch
-                const handlers = this.exactMatches.get(sub.pattern) || [];
-                handlers.push(sub.handler);
-                this.exactMatches.set(sub.pattern, handlers);
-            }
+            this.index.add(sub.pattern, sub);
         }
         this.warmedUp = true;
     }
@@ -191,8 +161,7 @@ let EventDispatchService = class EventDispatchService {
      */
     clearHandlers() {
         this.handlers = [];
-        this.exactMatches.clear();
-        this.wildcardPatterns = [];
+        this.index.clear();
         this.warmedUp = false;
     }
 };

package/dist/lib/server/event/EventDispatchService.js.map

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

package/dist/lib/server/event/PatternHandlerIndex.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @description Shared pattern → handler index with the hybrid lookup strategy
+ * used across Asena's event and messaging systems:
+ *
+ * - Exact patterns → Map (O(1) lookup on collect)
+ * - Wildcard patterns → Array (O(n) matchesEventPattern check, smaller n)
+ *
+ * Consumers: EventDispatchService (in-process events), InMemoryTransport and
+ * RedisMicroserviceTransport (microservice event handlers). The generic type T
+ * lets each consumer store what it needs (a bare handler or a subscription object).
+ *
+ * Collection order: exact matches first (registration order), then wildcard
+ * matches (registration order).
+ */
+export declare class PatternHandlerIndex<T> {
+    /**
+     * Exact pattern → entries (O(1) fast path)
+     */
+    private exact;
+    /**
+     * Wildcard patterns, matched with matchesEventPattern on collect
+     */
+    private wildcard;
+    /**
+     * Register an entry under a pattern
+     */
+    add(pattern: string, entry: T): void;
+    /**
+     * Remove a specific entry registered under a pattern (identity comparison)
+     *
+     * @returns true if the entry was found and removed
+     */
+    remove(pattern: string, entry: T): boolean;
+    /**
+     * Collect all entries whose pattern matches the given event name
+     */
+    collect(eventName: string): T[];
+    /**
+     * All registered patterns - exact first (registration order), then wildcard
+     *
+     * Diagnostics only: consumers use it to explain why an expected source
+     * matched no handler (e.g. the Kafka transport's external-topic hint).
+     */
+    patterns(): string[];
+    /**
+     * Whether the index holds no entries at all
+     */
+    get isEmpty(): boolean;
+    /**
+     * Remove all entries
+     */
+    clear(): void;
+}

package/dist/lib/server/event/PatternHandlerIndex.js

@@ -0,0 +1,100 @@
+import { matchesEventPattern } from './eventPatternMatcher';
+/**
+ * @description Shared pattern → handler index with the hybrid lookup strategy
+ * used across Asena's event and messaging systems:
+ *
+ * - Exact patterns → Map (O(1) lookup on collect)
+ * - Wildcard patterns → Array (O(n) matchesEventPattern check, smaller n)
+ *
+ * Consumers: EventDispatchService (in-process events), InMemoryTransport and
+ * RedisMicroserviceTransport (microservice event handlers). The generic type T
+ * lets each consumer store what it needs (a bare handler or a subscription object).
+ *
+ * Collection order: exact matches first (registration order), then wildcard
+ * matches (registration order).
+ */
+export class PatternHandlerIndex {
+    /**
+     * Exact pattern → entries (O(1) fast path)
+     */
+    exact = new Map();
+    /**
+     * Wildcard patterns, matched with matchesEventPattern on collect
+     */
+    wildcard = [];
+    /**
+     * Register an entry under a pattern
+     */
+    add(pattern, entry) {
+        if (pattern.includes('*')) {
+            this.wildcard.push({ pattern, entry });
+            return;
+        }
+        const entries = this.exact.get(pattern) || [];
+        entries.push(entry);
+        this.exact.set(pattern, entries);
+    }
+    /**
+     * Remove a specific entry registered under a pattern (identity comparison)
+     *
+     * @returns true if the entry was found and removed
+     */
+    remove(pattern, entry) {
+        if (pattern.includes('*')) {
+            const index = this.wildcard.findIndex((item) => item.pattern === pattern && item.entry === entry);
+            if (index !== -1) {
+                this.wildcard.splice(index, 1);
+                return true;
+            }
+            return false;
+        }
+        const entries = this.exact.get(pattern);
+        if (!entries) {
+            return false;
+        }
+        const index = entries.indexOf(entry);
+        if (index === -1) {
+            return false;
+        }
+        entries.splice(index, 1);
+        if (!entries.length) {
+            this.exact.delete(pattern);
+        }
+        return true;
+    }
+    /**
+     * Collect all entries whose pattern matches the given event name
+     */
+    collect(eventName) {
+        const result = [...(this.exact.get(eventName) || [])];
+        for (const item of this.wildcard) {
+            if (matchesEventPattern(eventName, item.pattern)) {
+                result.push(item.entry);
+            }
+        }
+        return result;
+    }
+    /**
+     * All registered patterns - exact first (registration order), then wildcard
+     *
+     * Diagnostics only: consumers use it to explain why an expected source
+     * matched no handler (e.g. the Kafka transport's external-topic hint).
+     */
+    patterns() {
+        return [...this.exact.keys(), ...this.wildcard.map((item) => item.pattern)];
+    }
+    /**
+     * Whether the index holds no entries at all
+     */
+    get isEmpty() {
+        return this.exact.size === 0 && this.wildcard.length === 0;
+    }
+    /**
+     * Remove all entries
+     */
+    clear() {
+        this.exact.clear();
+        this.wildcard = [];
+    }
+}
+//# sourceMappingURL=PatternHandlerIndex.js.map

package/dist/lib/server/event/PatternHandlerIndex.js.map

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

package/dist/lib/server/event/decorators/On.d.ts

@@ -20,6 +20,10 @@ import type { OnParams } from '../types';
  *
  *   @On({ event: 'deleted', skip: true })  // Temporarily disabled
  *   handleDeleted(eventName: string, data: any) { }
+ *
+ *   // Absolute - opts out of the 'user' prefix
+ *   @On({ event: 'payment.completed', prefix: false })
+ *   handlePayment(eventName: string, data: any) { }
  * }
  *
  * @example

package/dist/lib/server/event/decorators/On.js

@@ -21,6 +21,10 @@ import { defineTypedMetadata, getOwnTypedMetadata } from '../../../utils';
  *
  *   @On({ event: 'deleted', skip: true })  // Temporarily disabled
  *   handleDeleted(eventName: string, data: any) { }
+ *
+ *   // Absolute - opts out of the 'user' prefix
+ *   @On({ event: 'payment.completed', prefix: false })
+ *   handlePayment(eventName: string, data: any) { }
  * }
  *
  * @example
@@ -46,6 +50,8 @@ export function On(params) {
         handlers[propertyKey.toString()] = {
             pattern: _params.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

package/dist/lib/server/event/decorators/On.js.map

@@ -1 +1 @@
-{"version":3,"file":"On.js","sourceRoot":"","sources":["../../../../../lib/server/event/decorators/On.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,EAAE,CAAC,MAAyB;IAC1C,oDAAoD;IACpD,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAErF,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,UAA8B;QAC3F,qDAAqD;QACrD,MAAM,QAAQ,GACZ,mBAAmB,CACjB,kBAAkB,CAAC,gBAAgB,EACnC,MAAM,CAAC,WAAW,CACnB,IAAI,EAAE,CAAC;QAEV,8BAA8B;QAC9B,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,GAAG;YACjC,OAAO,EAAE,OAAO,CAAC,KAAK;YACtB,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE;YAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;SAC5B,CAAC;QAEF,yBAAyB;QACzB,mBAAmB,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAEvF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"On.js","sourceRoot":"","sources":["../../../../../lib/server/event/decorators/On.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,EAAE,CAAC,MAAyB;IAC1C,oDAAoD;IACpD,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAErF,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,UAA8B;QAC3F,qDAAqD;QACrD,MAAM,QAAQ,GACZ,mBAAmB,CACjB,kBAAkB,CAAC,gBAAgB,EACnC,MAAM,CAAC,WAAW,CACnB,IAAI,EAAE,CAAC;QAEV,8BAA8B;QAC9B,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,GAAG;YACjC,OAAO,EAAE,OAAO,CAAC,KAAK;YACtB,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,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAEvF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -1,6 +1,7 @@
 export { EventEmitter } from './EventEmitter';
 export { EventDispatchService } from './EventDispatchService';
 export { matchesEventPattern } from './eventPatternMatcher';
+export { PatternHandlerIndex } from './PatternHandlerIndex';
 export { emitter } from './emitter';
 export * from './types';
 export * from './decorators';

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

@@ -3,6 +3,8 @@ export { EventEmitter } from './EventEmitter';
 export { EventDispatchService } from './EventDispatchService';
 // Pattern matcher (utility)
 export { matchesEventPattern } from './eventPatternMatcher';
+// Shared pattern → handler index (hybrid exact/wildcard lookup)
+export { PatternHandlerIndex } from './PatternHandlerIndex';
 // Injection utility
 export { emitter } from './emitter';
 // Types

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/server/event/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,4BAA4B;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,oBAAoB;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,aAAa;AACb,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/server/event/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,4BAA4B;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,gEAAgE;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,oBAAoB;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,aAAa;AACb,cAAc,cAAc,CAAC"}

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

@@ -21,6 +21,13 @@ export interface OnParams {
      * @example 'download.complete' or 'download.*'
      */
     event: string;
+    /**
+     * Join the @EventService prefix onto `event`.
+     * Set false to listen on an absolute pattern — another domain's event
+     * vocabulary, or a global catch-all ('*').
+     * @default true
+     */
+    prefix?: boolean;
     /**
      * Skip this handler (useful for temporarily disabling handlers)
      * @default false
@@ -40,6 +47,11 @@ export interface EventHandlerMetadata {
      * Method name to call when event is emitted
      */
     methodName: string;
+    /**
+     * Whether the @EventService prefix is joined onto `pattern`.
+     * Normalized at decoration time (`prefix: false` opt-out → false).
+     */
+    prefix: boolean;
     /**
      * Whether this handler should be skipped
      */

package/dist/lib/server/health/HealthServer.d.ts

@@ -0,0 +1,26 @@
+import { type ServerLogger } from '../../logger';
+import type { HealthOptions } from '../AsenaServerFactory';
+import type { Ulak } from '../messaging/Ulak';
+/**
+ * @description Minimal zero-dependency health endpoint for headless/hybrid deployments.
+ *
+ * Serves a single endpoint (default GET /healthz) reporting process liveness and
+ * per-microservice-transport connection state - built for Kubernetes probes on
+ * headless services that have no HTTP adapter.
+ *
+ * Responses:
+ * - No microservice transports configured → 200 { status: 'up', uptime }
+ * - All transports connected → 200 { status: 'up', uptime, transports: { name: 'connected' } }
+ * - Any transport disconnected → 503 { status: 'degraded', ... }
+ */
+export declare class HealthServer {
+    private readonly options;
+    private readonly ulak;
+    private readonly logger;
+    private server?;
+    private startedAt;
+    constructor(options: HealthOptions, ulak: Ulak, logger: ServerLogger);
+    start(): void;
+    stop(): void;
+    private buildHealthResponse;
+}

package/dist/lib/server/health/HealthServer.js

@@ -0,0 +1,63 @@
+import * as bun from 'bun';
+import { blue } from '../../logger';
+/**
+ * @description Minimal zero-dependency health endpoint for headless/hybrid deployments.
+ *
+ * Serves a single endpoint (default GET /healthz) reporting process liveness and
+ * per-microservice-transport connection state - built for Kubernetes probes on
+ * headless services that have no HTTP adapter.
+ *
+ * Responses:
+ * - No microservice transports configured → 200 { status: 'up', uptime }
+ * - All transports connected → 200 { status: 'up', uptime, transports: { name: 'connected' } }
+ * - Any transport disconnected → 503 { status: 'degraded', ... }
+ */
+export class HealthServer {
+    options;
+    ulak;
+    logger;
+    server;
+    startedAt = 0;
+    constructor(options, ulak, logger) {
+        this.options = options;
+        this.ulak = ulak;
+        this.logger = logger;
+    }
+    start() {
+        const path = this.options.path || '/healthz';
+        this.startedAt = Date.now();
+        this.server = bun.serve({
+            port: this.options.port,
+            fetch: (request) => {
+                const url = new URL(request.url);
+                if (url.pathname !== path) {
+                    return new Response('Not Found', { status: 404 });
+                }
+                return this.buildHealthResponse();
+            },
+        });
+        this.logger.info(`${blue('[Health]')} Health endpoint ready at :${this.options.port}${path}`);
+    }
+    stop() {
+        void this.server?.stop(true);
+        this.server = undefined;
+    }
+    buildHealthResponse() {
+        const transports = this.ulak.getMicroserviceTransports();
+        const uptime = Math.round((Date.now() - this.startedAt) / 1000);
+        if (transports.size === 0) {
+            return Response.json({ status: 'up', uptime });
+        }
+        const states = {};
+        let degraded = false;
+        for (const [name, transport] of transports) {
+            const connected = transport.isConnected;
+            states[name] = connected ? 'connected' : 'disconnected';
+            if (!connected) {
+                degraded = true;
+            }
+        }
+        return Response.json({ status: degraded ? 'degraded' : 'up', uptime, transports: states }, { status: degraded ? 503 : 200 });
+    }
+}
+//# sourceMappingURL=HealthServer.js.map