@ebarahona/loopback-transport-core 1.0.0 → 1.1.0

package/dist/context/execution-context.js

@@ -1,28 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExecutionContext = void 0;
+const errors_1 = require("../helpers/errors");
 /**
- * Unified execution context that works across HTTP, RPC, and event transports.
+ * 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.
+ * 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.
+ * NestJS-compatible mental model: `getType()` + `switchToHttp/Rpc/Event`.
  * Cleaner construction: factory methods enforce correct state.
+ *
+ * @public
  */
 class ExecutionContext {
+    type;
+    args;
+    handler;
+    controllerClass;
+    httpCtx;
+    rpcCtx;
+    eventCtx;
     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;
+        if (contexts.http !== undefined)
+            this.httpCtx = contexts.http;
+        if (contexts.rpc !== undefined)
+            this.rpcCtx = contexts.rpc;
+        if (contexts.event !== undefined)
+            this.eventCtx = contexts.event;
     }
     /**
      * Create an HTTP execution context.
+     *
+     * @public
      */
     static forHttp(args, handler, controllerClass, httpCtx) {
         return new ExecutionContext('http', args, handler, controllerClass, {
@@ -31,6 +47,8 @@ class ExecutionContext {
     }
     /**
      * Create an RPC execution context (gRPC, request/response patterns).
+     *
+     * @public
      */
     static forRpc(args, handler, controllerClass, rpcCtx) {
         return new ExecutionContext('rpc', args, handler, controllerClass, {
@@ -39,6 +57,8 @@ class ExecutionContext {
     }
     /**
      * Create an event execution context (Kafka, RabbitMQ, MQTT, NATS).
+     *
+     * @public
      */
     static forEvent(args, handler, controllerClass, eventCtx) {
         return new ExecutionContext('event', args, handler, controllerClass, {
@@ -47,61 +67,86 @@ class ExecutionContext {
     }
     /**
      * Returns the transport type handling this request.
+     *
+     * @public
      */
     getType() {
         return this.type;
     }
     /**
      * Returns the controller class the handler belongs to.
+     *
+     * @experimental The generic parameter is asserted, not inferred.
+     *   Callers must verify the resulting class shape themselves.
+     * @typeParam T - Caller-asserted instance type.
      */
     getClass() {
         return this.controllerClass;
     }
     /**
      * Returns the handler function that will be invoked.
+     *
+     * @public
      */
     getHandler() {
         return this.handler;
     }
     /**
      * Returns a copy of the arguments array.
+     *
+     * @experimental Callers assert the tuple shape; no runtime check is
+     *   performed.
+     * @typeParam T - Caller-asserted tuple type.
      */
     getArgs() {
         return [...this.args];
     }
     /**
      * Returns a specific argument by index.
+     *
+     * @experimental Callers assert the value type; no runtime check is
+     *   performed.
+     * @typeParam T - Caller-asserted argument type.
      */
     getArgByIndex(index) {
         return this.args[index];
     }
     /**
-     * Switch to HTTP context.
-     * Throws if the current type is not 'http' or context is missing.
+     * Switch to HTTP context. Throws if the current type is not `http`
+     * or the context is missing.
+     *
+     * @public
+     * @throws TransportError When the current transport type is not HTTP.
      */
     switchToHttp() {
         if (this.type !== 'http' || !this.httpCtx) {
-            throw new Error(`Cannot switch to HTTP context: current transport type is "${this.type}"`);
+            throw new errors_1.TransportError(`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.
+     * Switch to RPC context. Throws if the current type is not `rpc` or
+     * the context is missing.
+     *
+     * @public
+     * @throws TransportError When the current transport type is not RPC.
      */
     switchToRpc() {
         if (this.type !== 'rpc' || !this.rpcCtx) {
-            throw new Error(`Cannot switch to RPC context: current transport type is "${this.type}"`);
+            throw new errors_1.TransportError(`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.
+     * Switch to event context. Throws if the current type is not `event`
+     * or the context is missing.
+     *
+     * @public
+     * @throws TransportError When the current transport type is not event.
      */
     switchToEvent() {
         if (this.type !== 'event' || !this.eventCtx) {
-            throw new Error(`Cannot switch to event context: current transport type is "${this.type}"`);
+            throw new errors_1.TransportError(`Cannot switch to event context: current transport type is "${this.type}"`);
         }
         return this.eventCtx;
     }

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

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

package/dist/context/index.d.ts

@@ -1 +1,2 @@
-export * from './execution-context';
+export { ExecutionContext } from './execution-context';
+export type { ContextType, ControllerClass, EventContext, HandlerFunction, HttpContext, RpcContext, } from './execution-context';

package/dist/context/index.js

@@ -1,18 +1,6 @@
 "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);
+exports.ExecutionContext = void 0;
+var execution_context_1 = require("./execution-context");
+Object.defineProperty(exports, "ExecutionContext", { enumerable: true, get: function () { return execution_context_1.ExecutionContext; } });
 //# sourceMappingURL=index.js.map

package/dist/context/index.js.map

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

package/dist/decorators/constants.d.ts

@@ -1,19 +1,23 @@
 import { MetadataAccessor } from '@loopback/metadata';
 /**
- * Options for @messageHandler and @eventHandler decorators.
+ * Options for the `@messageHandler` and `@eventHandler` decorators.
  * Extracted as a named type for public API stability.
+ *
+ * @public
  */
 export interface HandlerOptions {
     transport?: string;
     extras?: Readonly<Record<string, unknown>>;
 }
 /**
- * Metadata stored by @messageHandler.
+ * 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.
  *
- * 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.
+ * @public
  */
 export interface MessageHandlerMetadata {
     pattern: string;
@@ -21,10 +25,12 @@ export interface MessageHandlerMetadata {
     extras?: Readonly<Record<string, unknown>>;
 }
 /**
- * Metadata stored by @eventHandler.
+ * Metadata stored by `@eventHandler`.
  *
- * Pattern is stored as a normalized string via normalizePattern().
+ * Pattern is stored as a normalized string via `normalizePattern()`.
  * Object patterns are deep-sorted by key and stringified.
+ *
+ * @public
  */
 export interface EventHandlerMetadata {
     pattern: string;
@@ -32,10 +38,14 @@ export interface EventHandlerMetadata {
     extras?: Readonly<Record<string, unknown>>;
 }
 /**
- * Metadata key for @messageHandler decorator.
+ * Metadata key for the `@messageHandler` decorator.
+ *
+ * @public
  */
 export declare const MESSAGE_HANDLER_METADATA: MetadataAccessor<MessageHandlerMetadata, MethodDecorator>;
 /**
- * Metadata key for @eventHandler decorator.
+ * Metadata key for the `@eventHandler` decorator.
+ *
+ * @public
  */
 export declare const EVENT_HANDLER_METADATA: MetadataAccessor<EventHandlerMetadata, MethodDecorator>;

package/dist/decorators/constants.js

@@ -3,11 +3,15 @@ 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.
+ * Metadata key for the `@messageHandler` decorator.
+ *
+ * @public
  */
 exports.MESSAGE_HANDLER_METADATA = metadata_1.MetadataAccessor.create('transport:message-handler');
 /**
- * Metadata key for @eventHandler decorator.
+ * Metadata key for the `@eventHandler` decorator.
+ *
+ * @public
  */
 exports.EVENT_HANDLER_METADATA = metadata_1.MetadataAccessor.create('transport:event-handler');
 //# sourceMappingURL=constants.js.map

package/dist/decorators/constants.js.map

@@ -1 +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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":";;;AAAA,iDAAoD;AA2CpD;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,2BAAgB,CAAC,MAAM,CAG7D,2BAA2B,CAAC,CAAC;AAE/B;;;;GAIG;AACU,QAAA,sBAAsB,GAAG,2BAAgB,CAAC,MAAM,CAG3D,yBAAyB,CAAC,CAAC"}

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

@@ -1,15 +1,18 @@
-import { HandlerOptions } from './constants';
+import { type 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.
+ * 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.
+ * 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
+ * @public
+ * @param pattern - String or object pattern to match (e.g.
+ *   `'order.placed'` or `{event: 'order.placed'}`).
+ * @param options - Optional transport name and extras.
+ * @returns A method decorator that stores the handler metadata.
  *
  * @example
  * ```typescript

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

@@ -1,20 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.eventHandler = void 0;
+exports.eventHandler = eventHandler;
 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.
+ * 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.
+ * 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
+ * @public
+ * @param pattern - String or object pattern to match (e.g.
+ *   `'order.placed'` or `{event: 'order.placed'}`).
+ * @param options - Optional transport name and extras.
+ * @returns A method decorator that stores the handler metadata.
  *
  * @example
  * ```typescript
@@ -32,11 +35,13 @@ const utils_1 = require("../utils");
  */
 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,
-    });
+    const metadata = { pattern: serializedPattern };
+    if (options?.transport !== undefined) {
+        metadata.transport = options.transport;
+    }
+    if (options?.extras !== undefined) {
+        metadata.extras = options.extras;
+    }
+    return metadata_1.MethodDecoratorFactory.createDecorator(constants_1.EVENT_HANDLER_METADATA, metadata);
 }
-exports.eventHandler = eventHandler;
 //# sourceMappingURL=event-handler.decorator.js.map

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

@@ -1 +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"}
+{"version":3,"file":"event-handler.decorator.js","sourceRoot":"","sources":["../../src/decorators/event-handler.decorator.ts"],"names":[],"mappings":";;AAqCA,oCAkBC;AAvDD,iDAA0D;AAC1D,2CAIqB;AACrB,oCAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,YAAY,CAC1B,OAAyC,EACzC,OAAwB;IAExB,MAAM,iBAAiB,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAyB,EAAC,OAAO,EAAE,iBAAiB,EAAC,CAAC;IACpE,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,OAAO,iCAAsB,CAAC,eAAe,CAC3C,kCAAsB,EACtB,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/decorators/index.d.ts

@@ -1,4 +1,5 @@
-export * from './constants';
-export * from './message-handler.decorator';
-export * from './event-handler.decorator';
-export * from './payload.decorator';
+export { MESSAGE_HANDLER_METADATA, EVENT_HANDLER_METADATA } from './constants';
+export type { HandlerOptions, MessageHandlerMetadata, EventHandlerMetadata, } from './constants';
+export { messageHandler } from './message-handler.decorator';
+export { eventHandler } from './event-handler.decorator';
+export { payload, transportCtx } from './payload.decorator';

package/dist/decorators/index.js

@@ -1,21 +1,14 @@
 "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);
+exports.transportCtx = exports.payload = exports.eventHandler = exports.messageHandler = exports.EVENT_HANDLER_METADATA = exports.MESSAGE_HANDLER_METADATA = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "MESSAGE_HANDLER_METADATA", { enumerable: true, get: function () { return constants_1.MESSAGE_HANDLER_METADATA; } });
+Object.defineProperty(exports, "EVENT_HANDLER_METADATA", { enumerable: true, get: function () { return constants_1.EVENT_HANDLER_METADATA; } });
+var message_handler_decorator_1 = require("./message-handler.decorator");
+Object.defineProperty(exports, "messageHandler", { enumerable: true, get: function () { return message_handler_decorator_1.messageHandler; } });
+var event_handler_decorator_1 = require("./event-handler.decorator");
+Object.defineProperty(exports, "eventHandler", { enumerable: true, get: function () { return event_handler_decorator_1.eventHandler; } });
+var payload_decorator_1 = require("./payload.decorator");
+Object.defineProperty(exports, "payload", { enumerable: true, get: function () { return payload_decorator_1.payload; } });
+Object.defineProperty(exports, "transportCtx", { enumerable: true, get: function () { return payload_decorator_1.transportCtx; } });
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8DAA4C;AAC5C,4DAA0C;AAC1C,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,yCAA6E;AAArE,qHAAA,wBAAwB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAMxD,yEAA2D;AAAnD,2HAAA,cAAc,OAAA;AACtB,qEAAuD;AAA/C,uHAAA,YAAY,OAAA;AACpB,yDAA0D;AAAlD,4GAAA,OAAO,OAAA;AAAE,iHAAA,YAAY,OAAA"}

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

@@ -1,12 +1,15 @@
-import { HandlerOptions } from './constants';
+import { type 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.
+ * 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
+ * @public
+ * @param pattern - String or object pattern to match (e.g. `'order.get'`
+ *   or `{cmd: 'order.get'}`).
+ * @param options - Optional transport name and extras.
+ * @returns A method decorator that stores the handler metadata.
  *
  * @example
  * ```typescript

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

@@ -1,17 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.messageHandler = void 0;
+exports.messageHandler = messageHandler;
 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.
+ * 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
+ * @public
+ * @param pattern - String or object pattern to match (e.g. `'order.get'`
+ *   or `{cmd: 'order.get'}`).
+ * @param options - Optional transport name and extras.
+ * @returns A method decorator that stores the handler metadata.
  *
  * @example
  * ```typescript
@@ -30,11 +33,13 @@ const utils_1 = require("../utils");
  */
 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,
-    });
+    const metadata = { pattern: serializedPattern };
+    if (options?.transport !== undefined) {
+        metadata.transport = options.transport;
+    }
+    if (options?.extras !== undefined) {
+        metadata.extras = options.extras;
+    }
+    return metadata_1.MethodDecoratorFactory.createDecorator(constants_1.MESSAGE_HANDLER_METADATA, metadata);
 }
-exports.messageHandler = messageHandler;
 //# sourceMappingURL=message-handler.decorator.js.map

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

@@ -1 +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"}
+{"version":3,"file":"message-handler.decorator.js","sourceRoot":"","sources":["../../src/decorators/message-handler.decorator.ts"],"names":[],"mappings":";;AAmCA,wCAkBC;AArDD,iDAA0D;AAC1D,2CAIqB;AACrB,oCAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,cAAc,CAC5B,OAAyC,EACzC,OAAwB;IAExB,MAAM,iBAAiB,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAA2B,EAAC,OAAO,EAAE,iBAAiB,EAAC,CAAC;IACtE,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,OAAO,iCAAsB,CAAC,eAAe,CAC3C,oCAAwB,EACxB,QAAQ,CACT,CAAC;AACJ,CAAC"}

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

@@ -1,22 +1,31 @@
 /**
  * Parameter decorator that injects the message payload.
  *
+ * @public
+ * @returns The `@inject` decorator bound to
+ *   `TransportBindings.CURRENT_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;
+export declare function payload(): (target: Object, member: string | undefined, methodDescriptorOrParameterIndex?: TypedPropertyDescriptor<import("@loopback/context").BoundValue> | number) => 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)
+ *
+ * - Kafka: `KafkaContext` (topic, partition, offset, consumer)
+ * - RabbitMQ: `RmqContext` (channel, message, pattern)
+ * - gRPC: `GrpcContext` (metadata, call)
+ * - MQTT: `MqttContext` (topic, packet)
+ * - NATS: `NatsContext` (subject, headers)
+ *
+ * @public
+ * @returns The `@inject` decorator bound to
+ *   `TransportBindings.CURRENT_CONTEXT`.
  *
  * @example
  * ```typescript
@@ -27,4 +36,4 @@ export declare function payload(): (target: Object, member: string | undefined,
  * ): Promise<void> { ... }
  * ```
  */
-export declare function transportCtx(): (target: Object, member: string | undefined, methodDescriptorOrParameterIndex?: number | TypedPropertyDescriptor<any> | undefined) => void;
+export declare function transportCtx(): (target: Object, member: string | undefined, methodDescriptorOrParameterIndex?: TypedPropertyDescriptor<import("@loopback/context").BoundValue> | number) => void;

package/dist/decorators/payload.decorator.js

@@ -1,11 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.transportCtx = exports.payload = void 0;
+exports.payload = payload;
+exports.transportCtx = transportCtx;
 const core_1 = require("@loopback/core");
 const keys_1 = require("../keys");
 /**
  * Parameter decorator that injects the message payload.
  *
+ * @public
+ * @returns The `@inject` decorator bound to
+ *   `TransportBindings.CURRENT_PAYLOAD`.
+ *
  * @example
  * ```typescript
  * @eventHandler('order.placed')
@@ -15,16 +20,20 @@ const keys_1 = require("../keys");
 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)
+ *
+ * - Kafka: `KafkaContext` (topic, partition, offset, consumer)
+ * - RabbitMQ: `RmqContext` (channel, message, pattern)
+ * - gRPC: `GrpcContext` (metadata, call)
+ * - MQTT: `MqttContext` (topic, packet)
+ * - NATS: `NatsContext` (subject, headers)
+ *
+ * @public
+ * @returns The `@inject` decorator bound to
+ *   `TransportBindings.CURRENT_CONTEXT`.
  *
  * @example
  * ```typescript
@@ -38,5 +47,4 @@ exports.payload = payload;
 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

@@ -1 +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"}
+{"version":3,"file":"payload.decorator.js","sourceRoot":"","sources":["../../src/decorators/payload.decorator.ts"],"names":[],"mappings":";;AAgBA,0BAEC;AA0BD,oCAEC;AA9CD,yCAAsC;AACtC,kCAA0C;AAE1C;;;;;;;;;;;;GAYG;AACH,SAAgB,OAAO;IACrB,OAAO,IAAA,aAAM,EAAC,wBAAiB,CAAC,eAAe,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,YAAY;IAC1B,OAAO,IAAA,aAAM,EAAC,wBAAiB,CAAC,eAAe,CAAC,CAAC;AACnD,CAAC"}