@asenajs/asena 0.7.1 → 0.8.1

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"HealthServer.js","sourceRoot":"","sources":["../../../../lib/server/health/HealthServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAqB,MAAM,cAAc,CAAC;AAIvD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IAMJ;IACA;IACA;IAPX,MAAM,CAAmB;IAEzB,SAAS,GAAG,CAAC,CAAC;IAEtB,YACmB,OAAsB,EACtB,IAAU,EACV,MAAoB;QAFpB,YAAO,GAAP,OAAO,CAAe;QACtB,SAAI,GAAJ,IAAI,CAAM;QACV,WAAM,GAAN,MAAM,CAAc;IACpC,CAAC;IAEG,KAAK;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;QAE7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACvB,KAAK,EAAE,CAAC,OAAgB,EAAE,EAAE;gBAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAEjC,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;oBAC1B,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBACpD,CAAC;gBAED,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACpC,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,8BAA8B,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;IAChG,CAAC;IAEM,IAAI;QACT,KAAK,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAEO,mBAAmB;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAEzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAEhE,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,MAAM,GAAiD,EAAE,CAAC;QAChE,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC;YAExC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;YAExD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAClB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EACpE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CACjC,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1 @@
+export * from './HealthServer';

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

@@ -0,0 +1,2 @@
+export * from './HealthServer';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -1,6 +1,28 @@
 import type { AsenaWebSocketService } from '../web/websocket';
 import { type ICoreService, ICoreServiceNames } from '../../ioc';
 import { type BulkOperation, type BulkResult } from './types';
+import type { MessagingInterceptor } from '../microservice/types';
+import type { EmitOptions, MicroserviceTransport, SendOptions } from '../microservice/MicroserviceTransport';
+/**
+ * @description Options for Ulak microservice sends - adds named transport selection
+ */
+export interface UlakSendOptions extends SendOptions {
+    /**
+     * Named microservice transport to use (multi-broker projects)
+     * @default 'default'
+     */
+    transport?: string;
+}
+/**
+ * @description Options for Ulak microservice emits - adds named transport selection
+ */
+export interface UlakEmitOptions extends EmitOptions {
+    /**
+     * Named microservice transport to use (multi-broker projects)
+     * @default 'default'
+     */
+    transport?: string;
+}
 /**
  * Central WebSocket message broker for Asena.js
  *
@@ -32,6 +54,14 @@ export declare class Ulak implements ICoreService {
      * Map of namespace path to WebSocket service instance
      */
     private namespaces;
+    /**
+     * Named microservice transports (set during bootstrap by PrepareMicroserviceService)
+     */
+    private microserviceTransports;
+    /**
+     * Messaging interceptors applied to all outgoing send/emit calls
+     */
+    private microserviceInterceptors;
     /**
      * Initialize Ulak messaging system
      * Called after dependency injection is complete
@@ -133,6 +163,62 @@ export declare class Ulak implements ICoreService {
      * @returns Number of active sockets
      */
     getSocketCount(namespace: string): number;
+    /**
+     * 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: Map<string, MicroserviceTransport>, interceptors?: MessagingInterceptor[]): void;
+    /**
+     * 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?: string): boolean;
+    /**
+     * Get all configured microservice transports (read-only)
+     * Used by the health endpoint to report per-transport status
+     */
+    getMicroserviceTransports(): ReadonlyMap<string, MicroserviceTransport>;
+    /**
+     * 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
+     */
+    send<T = unknown>(pattern: string, data?: unknown, options?: UlakSendOptions): Promise<T>;
+    /**
+     * 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
+     */
+    emit(pattern: string, data?: unknown, options?: UlakEmitOptions): Promise<void>;
+    /**
+     * 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<T extends string = ''>(prefix?: T, options?: {
+        transport?: string;
+    }): Ulak.Messages<T>;
     /**
      * Dispose of all resources and stop background tasks
      * Should be called during application shutdown
@@ -146,6 +232,13 @@ export declare class Ulak implements ICoreService {
      * @throws {UlakError} If namespace not found
      */
     private getNamespaceService;
+    /**
+     * 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
+     */
+    private getMicroserviceTransport;
 }
 /**
  * Scoped namespace interface
@@ -191,6 +284,34 @@ export declare namespace Ulak {
          */
         getSocketCount(): number;
     }
+    /**
+     * Pattern-scoped microservice messaging view
+     * Provides ergonomic API without repeating the pattern prefix
+     */
+    interface Messages<P extends string = string> {
+        /**
+         * The pattern prefix ('' for absolute patterns)
+         */
+        readonly prefix: P;
+        /**
+         * Send a request and await its reply (request/response)
+         * The pattern is joined with the prefix ('create' → 'order.create')
+         *
+         * @param pattern - Request pattern relative to the prefix
+         * @param data - Request payload
+         * @param options - Timeout and headers
+         */
+        send<T = unknown>(pattern: string, data?: unknown, options?: SendOptions): Promise<T>;
+        /**
+         * Emit a fire-and-forget event
+         * The pattern is joined with the prefix ('created' → 'order.created')
+         *
+         * @param pattern - Event pattern relative to the prefix
+         * @param data - Event payload
+         * @param options - Headers
+         */
+        emit(pattern: string, data?: unknown, options?: EmitOptions): Promise<void>;
+    }
 }
 /**
  * Helper function for injecting scoped Ulak namespace
@@ -222,3 +343,38 @@ export declare namespace Ulak {
  * ```
  */
 export declare function ulak<T extends string>(namespace: T): readonly [ICoreServiceNames.__ULAK__, (ulak: Ulak) => Ulak.NameSpace<T>];
+/**
+ * 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
+ */
+export declare namespace 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<P extends string = ''>(prefix?: P, options?: {
+        transport?: string;
+    }): readonly [ICoreServiceNames.__ULAK__, (u: Ulak) => Ulak.Messages<P>];
+}