@ebarahona/loopback-transport-core 1.0.0

package/dist/client/client-proxy.js.map

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

package/dist/client/index.d.ts

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

package/dist/client/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client-proxy"), exports);
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/context/execution-context.d.ts

@@ -0,0 +1,102 @@
+/**
+ * The type of transport handling the current request.
+ */
+export type ContextType = 'http' | 'rpc' | 'event';
+/**
+ * Handler function type. Avoids bare `Function`.
+ */
+export type HandlerFunction = (...args: unknown[]) => unknown;
+/**
+ * Controller class type. Avoids bare `Function`.
+ */
+export type ControllerClass<T = unknown> = abstract new (...args: never[]) => T;
+/**
+ * HTTP-specific context. Wraps Express request/response.
+ */
+export interface HttpContext {
+    getRequest<T = unknown>(): T;
+    getResponse<T = unknown>(): T;
+}
+/**
+ * RPC-specific context (gRPC, request/response patterns).
+ */
+export interface RpcContext {
+    getData<T = unknown>(): T;
+    getContext<T = unknown>(): T;
+    getMethod(): string;
+}
+/**
+ * Event-specific context (Kafka, RabbitMQ, MQTT, NATS events).
+ */
+export interface EventContext {
+    getData<T = unknown>(): T;
+    getPattern(): string;
+    getContext<T = unknown>(): T;
+}
+/**
+ * Unified execution context that works across HTTP, RPC, and event transports.
+ *
+ * Immutable after construction. Created via static factory methods
+ * that guarantee the transport-specific context is present.
+ * No half-built contexts, no post-construction mutation.
+ *
+ * NestJS-compatible mental model: getType() + switchToHttp/Rpc/Event.
+ * Cleaner construction: factory methods enforce correct state.
+ */
+export declare class ExecutionContext {
+    private readonly type;
+    private readonly args;
+    private readonly handler;
+    private readonly controllerClass;
+    private readonly httpCtx?;
+    private readonly rpcCtx?;
+    private readonly eventCtx?;
+    private constructor();
+    /**
+     * Create an HTTP execution context.
+     */
+    static forHttp(args: unknown[], handler: HandlerFunction, controllerClass: ControllerClass, httpCtx: HttpContext): ExecutionContext;
+    /**
+     * Create an RPC execution context (gRPC, request/response patterns).
+     */
+    static forRpc(args: unknown[], handler: HandlerFunction, controllerClass: ControllerClass, rpcCtx: RpcContext): ExecutionContext;
+    /**
+     * Create an event execution context (Kafka, RabbitMQ, MQTT, NATS).
+     */
+    static forEvent(args: unknown[], handler: HandlerFunction, controllerClass: ControllerClass, eventCtx: EventContext): ExecutionContext;
+    /**
+     * Returns the transport type handling this request.
+     */
+    getType(): ContextType;
+    /**
+     * Returns the controller class the handler belongs to.
+     */
+    getClass<T = unknown>(): ControllerClass<T>;
+    /**
+     * Returns the handler function that will be invoked.
+     */
+    getHandler(): HandlerFunction;
+    /**
+     * Returns a copy of the arguments array.
+     */
+    getArgs<T extends readonly unknown[] = readonly unknown[]>(): T;
+    /**
+     * Returns a specific argument by index.
+     */
+    getArgByIndex<T = unknown>(index: number): T;
+    /**
+     * Switch to HTTP context.
+     * Throws if the current type is not 'http' or context is missing.
+     */
+    switchToHttp(): HttpContext;
+    /**
+     * Switch to RPC context.
+     * Throws if the current type is not 'rpc' or context is missing.
+     */
+    switchToRpc(): RpcContext;
+    /**
+     * Switch to event context.
+     * Throws if the current type is not 'event' or context is missing.
+     */
+    switchToEvent(): EventContext;
+}

package/dist/context/execution-context.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionContext = void 0;
+/**
+ * Unified execution context that works across HTTP, RPC, and event transports.
+ *
+ * Immutable after construction. Created via static factory methods
+ * that guarantee the transport-specific context is present.
+ * No half-built contexts, no post-construction mutation.
+ *
+ * NestJS-compatible mental model: getType() + switchToHttp/Rpc/Event.
+ * Cleaner construction: factory methods enforce correct state.
+ */
+class ExecutionContext {
+    constructor(type, args, handler, controllerClass, contexts) {
+        this.type = type;
+        this.args = [...args];
+        this.handler = handler;
+        this.controllerClass = controllerClass;
+        this.httpCtx = contexts.http;
+        this.rpcCtx = contexts.rpc;
+        this.eventCtx = contexts.event;
+    }
+    /**
+     * Create an HTTP execution context.
+     */
+    static forHttp(args, handler, controllerClass, httpCtx) {
+        return new ExecutionContext('http', args, handler, controllerClass, {
+            http: httpCtx,
+        });
+    }
+    /**
+     * Create an RPC execution context (gRPC, request/response patterns).
+     */
+    static forRpc(args, handler, controllerClass, rpcCtx) {
+        return new ExecutionContext('rpc', args, handler, controllerClass, {
+            rpc: rpcCtx,
+        });
+    }
+    /**
+     * Create an event execution context (Kafka, RabbitMQ, MQTT, NATS).
+     */
+    static forEvent(args, handler, controllerClass, eventCtx) {
+        return new ExecutionContext('event', args, handler, controllerClass, {
+            event: eventCtx,
+        });
+    }
+    /**
+     * Returns the transport type handling this request.
+     */
+    getType() {
+        return this.type;
+    }
+    /**
+     * Returns the controller class the handler belongs to.
+     */
+    getClass() {
+        return this.controllerClass;
+    }
+    /**
+     * Returns the handler function that will be invoked.
+     */
+    getHandler() {
+        return this.handler;
+    }
+    /**
+     * Returns a copy of the arguments array.
+     */
+    getArgs() {
+        return [...this.args];
+    }
+    /**
+     * Returns a specific argument by index.
+     */
+    getArgByIndex(index) {
+        return this.args[index];
+    }
+    /**
+     * Switch to HTTP context.
+     * Throws if the current type is not 'http' or context is missing.
+     */
+    switchToHttp() {
+        if (this.type !== 'http' || !this.httpCtx) {
+            throw new Error(`Cannot switch to HTTP context: current transport type is "${this.type}"`);
+        }
+        return this.httpCtx;
+    }
+    /**
+     * Switch to RPC context.
+     * Throws if the current type is not 'rpc' or context is missing.
+     */
+    switchToRpc() {
+        if (this.type !== 'rpc' || !this.rpcCtx) {
+            throw new Error(`Cannot switch to RPC context: current transport type is "${this.type}"`);
+        }
+        return this.rpcCtx;
+    }
+    /**
+     * Switch to event context.
+     * Throws if the current type is not 'event' or context is missing.
+     */
+    switchToEvent() {
+        if (this.type !== 'event' || !this.eventCtx) {
+            throw new Error(`Cannot switch to event context: current transport type is "${this.type}"`);
+        }
+        return this.eventCtx;
+    }
+}
+exports.ExecutionContext = ExecutionContext;
+//# sourceMappingURL=execution-context.js.map

package/dist/context/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/context/execution-context.ts"],"names":[],"mappings":";;;AA2CA;;;;;;;;;GASG;AACH,MAAa,gBAAgB;IAS3B,YACE,IAAiB,EACjB,IAAe,EACf,OAAwB,EACxB,eAAgC,EAChC,QAIC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,IAAe,EACf,OAAwB,EACxB,eAAgC,EAChC,OAAoB;QAEpB,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE;YAClE,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAe,EACf,OAAwB,EACxB,eAAgC,EAChC,MAAkB;QAElB,OAAO,IAAI,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE;YACjE,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,IAAe,EACf,OAAwB,EACxB,eAAgC,EAChC,QAAsB;QAEtB,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE;YACnE,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,eAAqC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAiB,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa,CAAc,KAAa;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAM,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACzC,MAAM,IAAI,KAAK,CACb,6DAA6D,IAAI,CAAC,IAAI,GAAG,CAC1E,CAAC;SACH;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YACvC,MAAM,IAAI,KAAK,CACb,4DAA4D,IAAI,CAAC,IAAI,GAAG,CACzE,CAAC;SACH;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC3C,MAAM,IAAI,KAAK,CACb,8DAA8D,IAAI,CAAC,IAAI,GAAG,CAC3E,CAAC;SACH;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAhJD,4CAgJC"}

package/dist/context/index.d.ts

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

package/dist/context/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./execution-context"), exports);
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

package/dist/decorators/constants.d.ts

@@ -0,0 +1,41 @@
+import { MetadataAccessor } from '@loopback/metadata';
+/**
+ * Options for @messageHandler and @eventHandler decorators.
+ * Extracted as a named type for public API stability.
+ */
+export interface HandlerOptions {
+    transport?: string;
+    extras?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Metadata stored by @messageHandler.
+ *
+ * Pattern is stored as a normalized string via normalizePattern().
+ * Object patterns are deep-sorted by key and stringified so that
+ * the same logical pattern always produces the same string key
+ * regardless of property insertion order.
+ */
+export interface MessageHandlerMetadata {
+    pattern: string;
+    transport?: string;
+    extras?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Metadata stored by @eventHandler.
+ *
+ * Pattern is stored as a normalized string via normalizePattern().
+ * Object patterns are deep-sorted by key and stringified.
+ */
+export interface EventHandlerMetadata {
+    pattern: string;
+    transport?: string;
+    extras?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Metadata key for @messageHandler decorator.
+ */
+export declare const MESSAGE_HANDLER_METADATA: MetadataAccessor<MessageHandlerMetadata, MethodDecorator>;
+/**
+ * Metadata key for @eventHandler decorator.
+ */
+export declare const EVENT_HANDLER_METADATA: MetadataAccessor<EventHandlerMetadata, MethodDecorator>;

package/dist/decorators/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_HANDLER_METADATA = exports.MESSAGE_HANDLER_METADATA = void 0;
+const metadata_1 = require("@loopback/metadata");
+/**
+ * Metadata key for @messageHandler decorator.
+ */
+exports.MESSAGE_HANDLER_METADATA = metadata_1.MetadataAccessor.create('transport:message-handler');
+/**
+ * Metadata key for @eventHandler decorator.
+ */
+exports.EVENT_HANDLER_METADATA = metadata_1.MetadataAccessor.create('transport:event-handler');
+//# sourceMappingURL=constants.js.map

package/dist/decorators/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":";;;AAAA,iDAAoD;AAqCpD;;GAEG;AACU,QAAA,wBAAwB,GAAG,2BAAgB,CAAC,MAAM,CAG7D,2BAA2B,CAAC,CAAC;AAE/B;;GAEG;AACU,QAAA,sBAAsB,GAAG,2BAAgB,CAAC,MAAM,CAG3D,yBAAyB,CAAC,CAAC"}

package/dist/decorators/event-handler.decorator.d.ts

@@ -0,0 +1,28 @@
+import { HandlerOptions } from './constants';
+/**
+ * Mark a controller method as a fire-and-forget event handler.
+ *
+ * The transport server dispatches matching events to this method.
+ * No response is sent back to the emitter.
+ *
+ * Multiple event handlers can be registered for the same pattern.
+ * They are chained and all execute.
+ *
+ * @param pattern - String or object pattern to match (e.g., 'order.placed' or {event: 'order.placed'})
+ * @param options - Optional transport name and extras
+ *
+ * @example
+ * ```typescript
+ * // String pattern
+ * @eventHandler('order.placed')
+ * async handleOrder(@payload() data: OrderDto): Promise<void> { ... }
+ *
+ * // With transport and extras override
+ * @eventHandler('payment.received', {
+ *   transport: 'redis',
+ *   extras: {mode: 'stream', consumerGroup: 'payment-workers'},
+ * })
+ * async handlePayment(@payload() data: PaymentDto): Promise<void> { ... }
+ * ```
+ */
+export declare function eventHandler(pattern: string | Record<string, unknown>, options?: HandlerOptions): MethodDecorator;

package/dist/decorators/event-handler.decorator.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventHandler = void 0;
+const metadata_1 = require("@loopback/metadata");
+const constants_1 = require("./constants");
+const utils_1 = require("../utils");
+/**
+ * Mark a controller method as a fire-and-forget event handler.
+ *
+ * The transport server dispatches matching events to this method.
+ * No response is sent back to the emitter.
+ *
+ * Multiple event handlers can be registered for the same pattern.
+ * They are chained and all execute.
+ *
+ * @param pattern - String or object pattern to match (e.g., 'order.placed' or {event: 'order.placed'})
+ * @param options - Optional transport name and extras
+ *
+ * @example
+ * ```typescript
+ * // String pattern
+ * @eventHandler('order.placed')
+ * async handleOrder(@payload() data: OrderDto): Promise<void> { ... }
+ *
+ * // With transport and extras override
+ * @eventHandler('payment.received', {
+ *   transport: 'redis',
+ *   extras: {mode: 'stream', consumerGroup: 'payment-workers'},
+ * })
+ * async handlePayment(@payload() data: PaymentDto): Promise<void> { ... }
+ * ```
+ */
+function eventHandler(pattern, options) {
+    const serializedPattern = (0, utils_1.normalizePattern)(pattern);
+    return metadata_1.MethodDecoratorFactory.createDecorator(constants_1.EVENT_HANDLER_METADATA, {
+        pattern: serializedPattern,
+        transport: options?.transport,
+        extras: options?.extras,
+    });
+}
+exports.eventHandler = eventHandler;
+//# sourceMappingURL=event-handler.decorator.js.map

package/dist/decorators/event-handler.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.decorator.js","sourceRoot":"","sources":["../../src/decorators/event-handler.decorator.ts"],"names":[],"mappings":";;;AAAA,iDAA0D;AAC1D,2CAIqB;AACrB,oCAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,YAAY,CAC1B,OAAyC,EACzC,OAAwB;IAExB,MAAM,iBAAiB,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;IAEpD,OAAO,iCAAsB,CAAC,eAAe,CAC3C,kCAAsB,EACtB;QACE,OAAO,EAAE,iBAAiB;QAC1B,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,MAAM,EAAE,OAAO,EAAE,MAAM;KACxB,CACF,CAAC;AACJ,CAAC;AAdD,oCAcC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,4 @@
+export * from './constants';
+export * from './message-handler.decorator';
+export * from './event-handler.decorator';
+export * from './payload.decorator';

package/dist/decorators/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./message-handler.decorator"), exports);
+__exportStar(require("./event-handler.decorator"), exports);
+__exportStar(require("./payload.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8DAA4C;AAC5C,4DAA0C;AAC1C,sDAAoC"}

package/dist/decorators/message-handler.decorator.d.ts

@@ -0,0 +1,26 @@
+import { HandlerOptions } from './constants';
+/**
+ * Mark a controller method as a request/response message handler.
+ *
+ * The transport server dispatches matching messages to this method
+ * and returns the result to the caller.
+ *
+ * @param pattern - String or object pattern to match (e.g., 'order.get' or {cmd: 'order.get'})
+ * @param options - Optional transport name and extras
+ *
+ * @example
+ * ```typescript
+ * // String pattern
+ * @messageHandler('order.get')
+ * async getOrder(@payload() data: GetOrderReq): Promise<Order> { ... }
+ *
+ * // Object pattern
+ * @messageHandler({cmd: 'order.get', version: 2})
+ * async getOrderV2(@payload() data: GetOrderReq): Promise<Order> { ... }
+ *
+ * // With transport targeting
+ * @messageHandler('order.get', {transport: 'kafka'})
+ * async getOrder(@payload() data: GetOrderReq): Promise<Order> { ... }
+ * ```
+ */
+export declare function messageHandler(pattern: string | Record<string, unknown>, options?: HandlerOptions): MethodDecorator;

package/dist/decorators/message-handler.decorator.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.messageHandler = void 0;
+const metadata_1 = require("@loopback/metadata");
+const constants_1 = require("./constants");
+const utils_1 = require("../utils");
+/**
+ * Mark a controller method as a request/response message handler.
+ *
+ * The transport server dispatches matching messages to this method
+ * and returns the result to the caller.
+ *
+ * @param pattern - String or object pattern to match (e.g., 'order.get' or {cmd: 'order.get'})
+ * @param options - Optional transport name and extras
+ *
+ * @example
+ * ```typescript
+ * // String pattern
+ * @messageHandler('order.get')
+ * async getOrder(@payload() data: GetOrderReq): Promise<Order> { ... }
+ *
+ * // Object pattern
+ * @messageHandler({cmd: 'order.get', version: 2})
+ * async getOrderV2(@payload() data: GetOrderReq): Promise<Order> { ... }
+ *
+ * // With transport targeting
+ * @messageHandler('order.get', {transport: 'kafka'})
+ * async getOrder(@payload() data: GetOrderReq): Promise<Order> { ... }
+ * ```
+ */
+function messageHandler(pattern, options) {
+    const serializedPattern = (0, utils_1.normalizePattern)(pattern);
+    return metadata_1.MethodDecoratorFactory.createDecorator(constants_1.MESSAGE_HANDLER_METADATA, {
+        pattern: serializedPattern,
+        transport: options?.transport,
+        extras: options?.extras,
+    });
+}
+exports.messageHandler = messageHandler;
+//# sourceMappingURL=message-handler.decorator.js.map

package/dist/decorators/message-handler.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler.decorator.js","sourceRoot":"","sources":["../../src/decorators/message-handler.decorator.ts"],"names":[],"mappings":";;;AAAA,iDAA0D;AAC1D,2CAIqB;AACrB,oCAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,cAAc,CAC5B,OAAyC,EACzC,OAAwB;IAExB,MAAM,iBAAiB,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;IAEpD,OAAO,iCAAsB,CAAC,eAAe,CAC3C,oCAAwB,EACxB;QACE,OAAO,EAAE,iBAAiB;QAC1B,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,MAAM,EAAE,OAAO,EAAE,MAAM;KACxB,CACF,CAAC;AACJ,CAAC;AAdD,wCAcC"}

package/dist/decorators/payload.decorator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Parameter decorator that injects the message payload.
+ *
+ * @example
+ * ```typescript
+ * @eventHandler('order.placed')
+ * async handle(@payload() data: OrderDto): Promise<void> { ... }
+ * ```
+ */
+export declare function payload(): (target: Object, member: string | undefined, methodDescriptorOrParameterIndex?: number | TypedPropertyDescriptor<any> | undefined) => void;
+/**
+ * Parameter decorator that injects the transport-specific context.
+ *
+ * The context type depends on the transport:
+ * - Kafka: KafkaContext (topic, partition, offset, consumer)
+ * - RabbitMQ: RmqContext (channel, message, pattern)
+ * - gRPC: GrpcContext (metadata, call)
+ * - MQTT: MqttContext (topic, packet)
+ * - NATS: NatsContext (subject, headers)
+ *
+ * @example
+ * ```typescript
+ * @eventHandler('order.placed')
+ * async handle(
+ *   @payload() data: OrderDto,
+ *   @transportCtx() ctx: KafkaContext,
+ * ): Promise<void> { ... }
+ * ```
+ */
+export declare function transportCtx(): (target: Object, member: string | undefined, methodDescriptorOrParameterIndex?: number | TypedPropertyDescriptor<any> | undefined) => void;

package/dist/decorators/payload.decorator.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transportCtx = exports.payload = void 0;
+const core_1 = require("@loopback/core");
+const keys_1 = require("../keys");
+/**
+ * Parameter decorator that injects the message payload.
+ *
+ * @example
+ * ```typescript
+ * @eventHandler('order.placed')
+ * async handle(@payload() data: OrderDto): Promise<void> { ... }
+ * ```
+ */
+function payload() {
+    return (0, core_1.inject)(keys_1.TransportBindings.CURRENT_PAYLOAD);
+}
+exports.payload = payload;
+/**
+ * Parameter decorator that injects the transport-specific context.
+ *
+ * The context type depends on the transport:
+ * - Kafka: KafkaContext (topic, partition, offset, consumer)
+ * - RabbitMQ: RmqContext (channel, message, pattern)
+ * - gRPC: GrpcContext (metadata, call)
+ * - MQTT: MqttContext (topic, packet)
+ * - NATS: NatsContext (subject, headers)
+ *
+ * @example
+ * ```typescript
+ * @eventHandler('order.placed')
+ * async handle(
+ *   @payload() data: OrderDto,
+ *   @transportCtx() ctx: KafkaContext,
+ * ): Promise<void> { ... }
+ * ```
+ */
+function transportCtx() {
+    return (0, core_1.inject)(keys_1.TransportBindings.CURRENT_CONTEXT);
+}
+exports.transportCtx = transportCtx;
+//# sourceMappingURL=payload.decorator.js.map

package/dist/decorators/payload.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.decorator.js","sourceRoot":"","sources":["../../src/decorators/payload.decorator.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AACtC,kCAA0C;AAE1C;;;;;;;;GAQG;AACH,SAAgB,OAAO;IACrB,OAAO,IAAA,aAAM,EAAC,wBAAiB,CAAC,eAAe,CAAC,CAAC;AACnD,CAAC;AAFD,0BAEC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,YAAY;IAC1B,OAAO,IAAA,aAAM,EAAC,wBAAiB,CAAC,eAAe,CAAC,CAAC;AACnD,CAAC;AAFD,oCAEC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { TransportComponent } from './transport.component';
+export { TransportBooter } from './transport-booter';
+export { TransportBindings, TRANSPORT_SERVER_TAG, TRANSPORT_NAME_TAG, } from './keys';
+export { HandlerRegistry } from './registry';
+export { PacketId, ReadPacket, WritePacket, OutgoingRequest, OutgoingEvent, IncomingRequest, IncomingEvent, IncomingResponse, TransportServer, TransportClient, TransportStatus, MessageHandler, } from './interfaces';
+export { ExecutionContext, ContextType, HttpContext, RpcContext, EventContext, } from './context';
+export { messageHandler, eventHandler, payload, transportCtx, HandlerOptions, MessageHandlerMetadata, EventHandlerMetadata, MESSAGE_HANDLER_METADATA, EVENT_HANDLER_METADATA, } from './decorators';
+export { normalizePattern } from './utils';
+export { ClientProxy } from './client';
+export { ServerBase, HandlerResult } from './server';
+export { Serializer, Deserializer, JsonSerializer, JsonDeserializer, TransportPacket, } from './serializers';

package/dist/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonDeserializer = exports.JsonSerializer = exports.ServerBase = exports.ClientProxy = exports.normalizePattern = exports.EVENT_HANDLER_METADATA = exports.MESSAGE_HANDLER_METADATA = exports.transportCtx = exports.payload = exports.eventHandler = exports.messageHandler = exports.ExecutionContext = exports.HandlerRegistry = exports.TRANSPORT_NAME_TAG = exports.TRANSPORT_SERVER_TAG = exports.TransportBindings = exports.TransportBooter = exports.TransportComponent = void 0;
+// Component
+var transport_component_1 = require("./transport.component");
+Object.defineProperty(exports, "TransportComponent", { enumerable: true, get: function () { return transport_component_1.TransportComponent; } });
+// Booter
+var transport_booter_1 = require("./transport-booter");
+Object.defineProperty(exports, "TransportBooter", { enumerable: true, get: function () { return transport_booter_1.TransportBooter; } });
+// Binding keys and tags
+var keys_1 = require("./keys");
+Object.defineProperty(exports, "TransportBindings", { enumerable: true, get: function () { return keys_1.TransportBindings; } });
+Object.defineProperty(exports, "TRANSPORT_SERVER_TAG", { enumerable: true, get: function () { return keys_1.TRANSPORT_SERVER_TAG; } });
+Object.defineProperty(exports, "TRANSPORT_NAME_TAG", { enumerable: true, get: function () { return keys_1.TRANSPORT_NAME_TAG; } });
+// Registry
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "HandlerRegistry", { enumerable: true, get: function () { return registry_1.HandlerRegistry; } });
+// Context
+var context_1 = require("./context");
+Object.defineProperty(exports, "ExecutionContext", { enumerable: true, get: function () { return context_1.ExecutionContext; } });
+// Decorators
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "messageHandler", { enumerable: true, get: function () { return decorators_1.messageHandler; } });
+Object.defineProperty(exports, "eventHandler", { enumerable: true, get: function () { return decorators_1.eventHandler; } });
+Object.defineProperty(exports, "payload", { enumerable: true, get: function () { return decorators_1.payload; } });
+Object.defineProperty(exports, "transportCtx", { enumerable: true, get: function () { return decorators_1.transportCtx; } });
+Object.defineProperty(exports, "MESSAGE_HANDLER_METADATA", { enumerable: true, get: function () { return decorators_1.MESSAGE_HANDLER_METADATA; } });
+Object.defineProperty(exports, "EVENT_HANDLER_METADATA", { enumerable: true, get: function () { return decorators_1.EVENT_HANDLER_METADATA; } });
+// Utils
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "normalizePattern", { enumerable: true, get: function () { return utils_1.normalizePattern; } });
+// Client
+var client_1 = require("./client");
+Object.defineProperty(exports, "ClientProxy", { enumerable: true, get: function () { return client_1.ClientProxy; } });
+// Server
+var server_1 = require("./server");
+Object.defineProperty(exports, "ServerBase", { enumerable: true, get: function () { return server_1.ServerBase; } });
+// Serializers
+var serializers_1 = require("./serializers");
+Object.defineProperty(exports, "JsonSerializer", { enumerable: true, get: function () { return serializers_1.JsonSerializer; } });
+Object.defineProperty(exports, "JsonDeserializer", { enumerable: true, get: function () { return serializers_1.JsonDeserializer; } });
+//# sourceMappingURL=index.js.map