@ebarahona/loopback-transport-core 1.0.0 → 1.2.0

package/dist/discovery/discovery.service.d.ts

@@ -0,0 +1,143 @@
+import type { TransportServer } from '../interfaces';
+import type { Deserializer, Serializer } from '../serializers';
+import type { HandlerDiscoverer } from './handler-discoverer';
+import type { HandlerKind } from './handler-kind';
+import type { RegisteredHandler } from './registered-handler';
+/**
+ * Internal record describing a tag-discovered serializer binding. The
+ * `transport` field is `undefined` for generic bindings (no
+ * `TRANSPORT_NAME_TAG`) and the transport name string for
+ * transport-scoped bindings.
+ *
+ * @internal
+ */
+export interface DiscoveredSerializer {
+    readonly instance: Serializer;
+    readonly transport: string | undefined;
+}
+/**
+ * Internal record describing a tag-discovered deserializer binding.
+ * See {@link DiscoveredSerializer}.
+ *
+ * @internal
+ */
+export interface DiscoveredDeserializer {
+    readonly instance: Deserializer;
+    readonly transport: string | undefined;
+}
+/**
+ * Universal discovery service for the transport-core handler graph.
+ *
+ * Bound at `TransportBindings.DISCOVERY_SERVICE` and populated by the
+ * transport lifecycle observer after discovery and wrapping complete.
+ * Cross-cutting plugins inject this service to enumerate every handler
+ * the application contains, regardless of which {@link HandlerDiscoverer}
+ * found it or which {@link TransportServer} will serve it.
+ *
+ * Equivalent in concept to NestJS's `DiscoveryService` from
+ * `@nestjs/core`.
+ *
+ * The service stores an immutable snapshot. Every accessor returns a
+ * defensive copy so callers cannot mutate internal state.
+ *
+ * @public
+ */
+export declare class DiscoveryService {
+    private handlers;
+    private discoverers;
+    private servers;
+    private serializerEntries;
+    private deserializerEntries;
+    /**
+     * Every handler discovered at boot.
+     *
+     * @public
+     * @returns Frozen, defensively-copied snapshot of all registered
+     *   handlers.
+     */
+    getHandlers(): readonly RegisteredHandler[];
+    /**
+     * Handlers bound to a specific transport server (e.g. `'kafka'`,
+     * `'redis-pubsub'`).
+     *
+     * @public
+     * @param transport - Transport server tag.
+     */
+    getHandlersForTransport(transport: string): readonly RegisteredHandler[];
+    /**
+     * Handlers of a given kind.
+     *
+     * @public
+     * @param kind - `'request'` or `'event'`.
+     */
+    getHandlersByKind(kind: HandlerKind): readonly RegisteredHandler[];
+    /**
+     * Handlers produced by a specific discoverer (by
+     * `HandlerDiscoverer.id`).
+     *
+     * @public
+     * @param discovererId - Stable id of the discoverer (e.g. `'message'`).
+     */
+    getHandlersByDiscoverer(discovererId: string): readonly RegisteredHandler[];
+    /**
+     * All bound `HandlerDiscoverer` instances (default + plugin-contributed).
+     *
+     * @public
+     */
+    getDiscoverers(): readonly HandlerDiscoverer[];
+    /**
+     * All bound `TransportServer` instances.
+     *
+     * @public
+     */
+    getTransportServers(): readonly TransportServer[];
+    /**
+     * All bound `Serializer` instances discovered by tag at boot.
+     *
+     * Includes both generic and transport-scoped bindings. Use
+     * {@link getSerializerForTransport} to resolve which serializer a
+     * specific transport server would use.
+     *
+     * @public
+     */
+    getSerializers(): readonly Serializer[];
+    /**
+     * All bound `Deserializer` instances discovered by tag at boot.
+     *
+     * Includes both generic and transport-scoped bindings. Use
+     * {@link getDeserializerForTransport} to resolve which deserializer
+     * a specific transport server would use.
+     *
+     * @public
+     */
+    getDeserializers(): readonly Deserializer[];
+    /**
+     * Resolve the serializer that would be used by a server with the
+     * given transport name, applying the same transport-scoped \> generic
+     * precedence as `ServerBase.resolveSerializer`.
+     *
+     * Returns `undefined` if no tagged binding exists, in which case the
+     * subclass default on the server would be used.
+     *
+     * @public
+     * @param transport - Transport name tag (e.g. `'kafka'`).
+     */
+    getSerializerForTransport(transport: string): Serializer | undefined;
+    /**
+     * Resolve the deserializer that would be used by a server with the
+     * given transport name. See {@link getSerializerForTransport} for
+     * precedence rules.
+     *
+     * @public
+     * @param transport - Transport name tag (e.g. `'kafka'`).
+     */
+    getDeserializerForTransport(transport: string): Deserializer | undefined;
+    /**
+     * Replace the service's internal snapshot. Called by the transport
+     * lifecycle observer after discovery and handler wrapping complete.
+     *
+     * @internal Package-internal contract between the lifecycle observer
+     *   and the service. Not part of the consumer-facing API.
+     */
+    _populate(handlers: readonly RegisteredHandler[], discoverers: readonly HandlerDiscoverer[], servers: readonly TransportServer[], serializers?: readonly DiscoveredSerializer[], deserializers?: readonly DiscoveredDeserializer[]): void;
+}

package/dist/discovery/discovery.service.js

@@ -0,0 +1,165 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscoveryService = void 0;
+const core_1 = require("@loopback/core");
+/**
+ * Universal discovery service for the transport-core handler graph.
+ *
+ * Bound at `TransportBindings.DISCOVERY_SERVICE` and populated by the
+ * transport lifecycle observer after discovery and wrapping complete.
+ * Cross-cutting plugins inject this service to enumerate every handler
+ * the application contains, regardless of which {@link HandlerDiscoverer}
+ * found it or which {@link TransportServer} will serve it.
+ *
+ * Equivalent in concept to NestJS's `DiscoveryService` from
+ * `@nestjs/core`.
+ *
+ * The service stores an immutable snapshot. Every accessor returns a
+ * defensive copy so callers cannot mutate internal state.
+ *
+ * @public
+ */
+let DiscoveryService = class DiscoveryService {
+    handlers = Object.freeze([]);
+    discoverers = Object.freeze([]);
+    servers = Object.freeze([]);
+    serializerEntries = Object.freeze([]);
+    deserializerEntries = Object.freeze([]);
+    /**
+     * Every handler discovered at boot.
+     *
+     * @public
+     * @returns Frozen, defensively-copied snapshot of all registered
+     *   handlers.
+     */
+    getHandlers() {
+        return Object.freeze(this.handlers.slice());
+    }
+    /**
+     * Handlers bound to a specific transport server (e.g. `'kafka'`,
+     * `'redis-pubsub'`).
+     *
+     * @public
+     * @param transport - Transport server tag.
+     */
+    getHandlersForTransport(transport) {
+        return Object.freeze(this.handlers.filter(h => h.transport === transport));
+    }
+    /**
+     * Handlers of a given kind.
+     *
+     * @public
+     * @param kind - `'request'` or `'event'`.
+     */
+    getHandlersByKind(kind) {
+        return Object.freeze(this.handlers.filter(h => h.kind === kind));
+    }
+    /**
+     * Handlers produced by a specific discoverer (by
+     * `HandlerDiscoverer.id`).
+     *
+     * @public
+     * @param discovererId - Stable id of the discoverer (e.g. `'message'`).
+     */
+    getHandlersByDiscoverer(discovererId) {
+        return Object.freeze(this.handlers.filter(h => h.discovererId === discovererId));
+    }
+    /**
+     * All bound `HandlerDiscoverer` instances (default + plugin-contributed).
+     *
+     * @public
+     */
+    getDiscoverers() {
+        return Object.freeze(this.discoverers.slice());
+    }
+    /**
+     * All bound `TransportServer` instances.
+     *
+     * @public
+     */
+    getTransportServers() {
+        return Object.freeze(this.servers.slice());
+    }
+    /**
+     * All bound `Serializer` instances discovered by tag at boot.
+     *
+     * Includes both generic and transport-scoped bindings. Use
+     * {@link getSerializerForTransport} to resolve which serializer a
+     * specific transport server would use.
+     *
+     * @public
+     */
+    getSerializers() {
+        return Object.freeze(this.serializerEntries.map(entry => entry.instance));
+    }
+    /**
+     * All bound `Deserializer` instances discovered by tag at boot.
+     *
+     * Includes both generic and transport-scoped bindings. Use
+     * {@link getDeserializerForTransport} to resolve which deserializer
+     * a specific transport server would use.
+     *
+     * @public
+     */
+    getDeserializers() {
+        return Object.freeze(this.deserializerEntries.map(entry => entry.instance));
+    }
+    /**
+     * Resolve the serializer that would be used by a server with the
+     * given transport name, applying the same transport-scoped \> generic
+     * precedence as `ServerBase.resolveSerializer`.
+     *
+     * Returns `undefined` if no tagged binding exists, in which case the
+     * subclass default on the server would be used.
+     *
+     * @public
+     * @param transport - Transport name tag (e.g. `'kafka'`).
+     */
+    getSerializerForTransport(transport) {
+        const scoped = this.serializerEntries.find(entry => entry.transport === transport);
+        if (scoped !== undefined)
+            return scoped.instance;
+        const generic = this.serializerEntries.find(entry => entry.transport === undefined);
+        return generic?.instance;
+    }
+    /**
+     * Resolve the deserializer that would be used by a server with the
+     * given transport name. See {@link getSerializerForTransport} for
+     * precedence rules.
+     *
+     * @public
+     * @param transport - Transport name tag (e.g. `'kafka'`).
+     */
+    getDeserializerForTransport(transport) {
+        const scoped = this.deserializerEntries.find(entry => entry.transport === transport);
+        if (scoped !== undefined)
+            return scoped.instance;
+        const generic = this.deserializerEntries.find(entry => entry.transport === undefined);
+        return generic?.instance;
+    }
+    /**
+     * Replace the service's internal snapshot. Called by the transport
+     * lifecycle observer after discovery and handler wrapping complete.
+     *
+     * @internal Package-internal contract between the lifecycle observer
+     *   and the service. Not part of the consumer-facing API.
+     */
+    _populate(handlers, discoverers, servers, serializers = [], deserializers = []) {
+        this.handlers = Object.freeze(handlers.slice());
+        this.discoverers = Object.freeze(discoverers.slice());
+        this.servers = Object.freeze(servers.slice());
+        this.serializerEntries = Object.freeze(serializers.map(entry => Object.freeze({ ...entry })));
+        this.deserializerEntries = Object.freeze(deserializers.map(entry => Object.freeze({ ...entry })));
+    }
+};
+exports.DiscoveryService = DiscoveryService;
+exports.DiscoveryService = DiscoveryService = __decorate([
+    (0, core_1.injectable)({ scope: core_1.BindingScope.SINGLETON })
+], DiscoveryService);
+//# sourceMappingURL=discovery.service.js.map

package/dist/discovery/discovery.service.js.map

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

package/dist/discovery/event-handler-discoverer.d.ts

@@ -0,0 +1,19 @@
+import type { Constructor } from '@loopback/core';
+import type { DiscoveredHandler, HandlerDiscoverer } from './handler-discoverer';
+/**
+ * Default {@link HandlerDiscoverer} for the `@eventHandler` decorator
+ * vocabulary. Reads `EVENT_HANDLER_METADATA` from every method on the
+ * supplied controller class and emits a `DiscoveredHandler` of
+ * `kind: 'event'` for each one.
+ *
+ * Registered automatically by `TransportComponent` under the
+ * `TransportBindings.tags.HANDLER_DISCOVERER` tag. Subclass or replace
+ * this discoverer to alter how `@eventHandler` decorators are
+ * interpreted; bind under the same tag to add a new vocabulary instead.
+ *
+ * @public
+ */
+export declare class EventHandlerDiscoverer implements HandlerDiscoverer {
+    readonly id = "event";
+    discover(controllerClass: Constructor<unknown>): DiscoveredHandler[];
+}

package/dist/discovery/event-handler-discoverer.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventHandlerDiscoverer = void 0;
+const core_1 = require("@loopback/core");
+const decorators_1 = require("../decorators");
+const handler_kind_1 = require("./handler-kind");
+/**
+ * Default {@link HandlerDiscoverer} for the `@eventHandler` decorator
+ * vocabulary. Reads `EVENT_HANDLER_METADATA` from every method on the
+ * supplied controller class and emits a `DiscoveredHandler` of
+ * `kind: 'event'` for each one.
+ *
+ * Registered automatically by `TransportComponent` under the
+ * `TransportBindings.tags.HANDLER_DISCOVERER` tag. Subclass or replace
+ * this discoverer to alter how `@eventHandler` decorators are
+ * interpreted; bind under the same tag to add a new vocabulary instead.
+ *
+ * @public
+ */
+class EventHandlerDiscoverer {
+    id = 'event';
+    discover(controllerClass) {
+        const methods = core_1.MetadataInspector.getAllMethodMetadata(decorators_1.EVENT_HANDLER_METADATA.key, controllerClass.prototype);
+        if (!methods)
+            return [];
+        const handlers = [];
+        for (const [methodName, metadata] of Object.entries(methods)) {
+            const options = {};
+            if (metadata.transport !== undefined) {
+                options.transport = metadata.transport;
+            }
+            if (metadata.extras !== undefined) {
+                options.extras = metadata.extras;
+            }
+            const discovered = {
+                pattern: metadata.pattern,
+                transport: metadata.transport ?? '*',
+                kind: handler_kind_1.HANDLER_KIND_EVENT,
+                methodName,
+            };
+            if (options.transport !== undefined || options.extras !== undefined) {
+                discovered.options = options;
+            }
+            handlers.push(discovered);
+        }
+        return handlers;
+    }
+}
+exports.EventHandlerDiscoverer = EventHandlerDiscoverer;
+//# sourceMappingURL=event-handler-discoverer.js.map

package/dist/discovery/event-handler-discoverer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler-discoverer.js","sourceRoot":"","sources":["../../src/discovery/event-handler-discoverer.ts"],"names":[],"mappings":";;;AACA,yCAAiD;AACjD,8CAIuB;AAEvB,iDAAkD;AAElD;;;;;;;;;;;;GAYG;AACH,MAAa,sBAAsB;IACxB,EAAE,GAAG,OAAO,CAAC;IAEtB,QAAQ,CAAC,eAAqC;QAC5C,MAAM,OAAO,GACX,wBAAiB,CAAC,oBAAoB,CACpC,mCAAsB,CAAC,GAAG,EAC1B,eAAe,CAAC,SAAS,CAC1B,CAAC;QACJ,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAwB,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAmB,EAAE,CAAC;YACnC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;YACzC,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAClC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YACnC,CAAC;YAED,MAAM,UAAU,GAAsB;gBACpC,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,GAAG;gBACpC,IAAI,EAAE,iCAAkB;gBACxB,UAAU;aACX,CAAC;YACF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACpE,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;YAC/B,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAlCD,wDAkCC"}

package/dist/discovery/handler-discoverer.d.ts

@@ -0,0 +1,48 @@
+import type { Constructor } from '@loopback/core';
+import type { HandlerOptions } from '../decorators';
+import type { HandlerKind } from './handler-kind';
+/**
+ * Metadata describing a single discovered transport handler. Returned by
+ * {@link HandlerDiscoverer} implementations and consumed by `HandlerRegistry`.
+ *
+ * @public
+ */
+export interface DiscoveredHandler {
+    /** Routing pattern; string for simple matches, object for structured matchers. */
+    pattern: string | Record<string, unknown>;
+    /** Tag of the transport server this handler is for, or `'*'` for wildcard. */
+    transport: string;
+    /** `'request'` = single-response handler; `'event'` = fire-and-forget, chainable. Plugins may use any string for custom kinds. */
+    kind: HandlerKind;
+    /** Name of the method on the controller prototype to invoke. */
+    methodName: string;
+    /** Discoverer-specific options forwarded to the registry / server. */
+    options?: HandlerOptions;
+}
+/**
+ * Contributes a decorator vocabulary to the transport-core handler registry.
+ * Implementations are bound with the `TransportBindings.tags.HANDLER_DISCOVERER`
+ * tag and consulted on every controller class at boot.
+ *
+ * The two built-in discoverers (`MessageHandlerDiscoverer` and
+ * `EventHandlerDiscoverer`) are registered automatically by
+ * `TransportComponent`. Plugins (gRPC routes, cron schedules, WebSocket
+ * subscriptions, etc.) can bind additional implementations under the same
+ * tag without modifying transport-core.
+ *
+ * @public
+ */
+export interface HandlerDiscoverer {
+    /** Stable identifier for logging / debugging (e.g. `'message'`, `'event'`, `'grpc'`). */
+    readonly id: string;
+    /**
+     * Read decorator metadata from a controller class and return its handlers.
+     *
+     * Implementations may return synchronously (`DiscoveredHandler[]`) or
+     * asynchronously (`Promise<DiscoveredHandler[]>`) to support metadata
+     * sources that require I/O (e.g. loading schemas from disk, querying a
+     * service registry). The registry awaits the result transparently, so
+     * both forms are equivalent from the caller's perspective.
+     */
+    discover(controllerClass: Constructor<unknown>): DiscoveredHandler[] | Promise<DiscoveredHandler[]>;
+}

package/dist/discovery/handler-discoverer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=handler-discoverer.js.map

package/dist/discovery/handler-discoverer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-discoverer.js","sourceRoot":"","sources":["../../src/discovery/handler-discoverer.ts"],"names":[],"mappings":""}

package/dist/discovery/handler-kind.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Kind of a transport handler. The two well-known values
+ * (`'request'` and `'event'`) ship as default constants below; plugin
+ * discoverers may use any string value to declare additional kinds
+ * (e.g. `'cron'`, `'subscription'`, `'stream'`) without requiring a
+ * transport-core release.
+ *
+ * The open shape uses the `string & {}` autocomplete trick so editors
+ * still suggest the well-known values while accepting any string.
+ *
+ * @public
+ */
+export type HandlerKind = 'request' | 'event' | (string & {});
+/**
+ * Well-known kind for request/response handlers (`@messageHandler`).
+ * @public
+ */
+export declare const HANDLER_KIND_REQUEST = "request";
+/**
+ * Well-known kind for fire-and-forget chainable event handlers (`@eventHandler`).
+ * @public
+ */
+export declare const HANDLER_KIND_EVENT = "event";

package/dist/discovery/handler-kind.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HANDLER_KIND_EVENT = exports.HANDLER_KIND_REQUEST = void 0;
+/**
+ * Well-known kind for request/response handlers (`@messageHandler`).
+ * @public
+ */
+exports.HANDLER_KIND_REQUEST = 'request';
+/**
+ * Well-known kind for fire-and-forget chainable event handlers (`@eventHandler`).
+ * @public
+ */
+exports.HANDLER_KIND_EVENT = 'event';
+//# sourceMappingURL=handler-kind.js.map

package/dist/discovery/handler-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-kind.js","sourceRoot":"","sources":["../../src/discovery/handler-kind.ts"],"names":[],"mappings":";;;AAcA;;;GAGG;AACU,QAAA,oBAAoB,GAAG,SAAS,CAAC;AAE9C;;;GAGG;AACU,QAAA,kBAAkB,GAAG,OAAO,CAAC"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,7 @@
+export type { DiscoveredHandler, HandlerDiscoverer } from './handler-discoverer';
+export type { HandlerKind } from './handler-kind';
+export { HANDLER_KIND_EVENT, HANDLER_KIND_REQUEST } from './handler-kind';
+export { MessageHandlerDiscoverer } from './message-handler-discoverer';
+export { EventHandlerDiscoverer } from './event-handler-discoverer';
+export type { RegisteredHandler } from './registered-handler';
+export { DiscoveryService } from './discovery.service';

package/dist/discovery/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscoveryService = exports.EventHandlerDiscoverer = exports.MessageHandlerDiscoverer = exports.HANDLER_KIND_REQUEST = exports.HANDLER_KIND_EVENT = void 0;
+var handler_kind_1 = require("./handler-kind");
+Object.defineProperty(exports, "HANDLER_KIND_EVENT", { enumerable: true, get: function () { return handler_kind_1.HANDLER_KIND_EVENT; } });
+Object.defineProperty(exports, "HANDLER_KIND_REQUEST", { enumerable: true, get: function () { return handler_kind_1.HANDLER_KIND_REQUEST; } });
+var message_handler_discoverer_1 = require("./message-handler-discoverer");
+Object.defineProperty(exports, "MessageHandlerDiscoverer", { enumerable: true, get: function () { return message_handler_discoverer_1.MessageHandlerDiscoverer; } });
+var event_handler_discoverer_1 = require("./event-handler-discoverer");
+Object.defineProperty(exports, "EventHandlerDiscoverer", { enumerable: true, get: function () { return event_handler_discoverer_1.EventHandlerDiscoverer; } });
+var discovery_service_1 = require("./discovery.service");
+Object.defineProperty(exports, "DiscoveryService", { enumerable: true, get: function () { return discovery_service_1.DiscoveryService; } });
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":";;;AAEA,+CAAwE;AAAhE,kHAAA,kBAAkB,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAChD,2EAAsE;AAA9D,sIAAA,wBAAwB,OAAA;AAChC,uEAAkE;AAA1D,kIAAA,sBAAsB,OAAA;AAE9B,yDAAqD;AAA7C,qHAAA,gBAAgB,OAAA"}

package/dist/discovery/message-handler-discoverer.d.ts

@@ -0,0 +1,19 @@
+import type { Constructor } from '@loopback/core';
+import type { DiscoveredHandler, HandlerDiscoverer } from './handler-discoverer';
+/**
+ * Default {@link HandlerDiscoverer} for the `@messageHandler` decorator
+ * vocabulary. Reads `MESSAGE_HANDLER_METADATA` from every method on the
+ * supplied controller class and emits a `DiscoveredHandler` of
+ * `kind: 'request'` for each one.
+ *
+ * Registered automatically by `TransportComponent` under the
+ * `TransportBindings.tags.HANDLER_DISCOVERER` tag. Subclass or replace
+ * this discoverer to alter how `@messageHandler` decorators are
+ * interpreted; bind under the same tag to add a new vocabulary instead.
+ *
+ * @public
+ */
+export declare class MessageHandlerDiscoverer implements HandlerDiscoverer {
+    readonly id = "message";
+    discover(controllerClass: Constructor<unknown>): DiscoveredHandler[];
+}

package/dist/discovery/message-handler-discoverer.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageHandlerDiscoverer = void 0;
+const core_1 = require("@loopback/core");
+const decorators_1 = require("../decorators");
+const handler_kind_1 = require("./handler-kind");
+/**
+ * Default {@link HandlerDiscoverer} for the `@messageHandler` decorator
+ * vocabulary. Reads `MESSAGE_HANDLER_METADATA` from every method on the
+ * supplied controller class and emits a `DiscoveredHandler` of
+ * `kind: 'request'` for each one.
+ *
+ * Registered automatically by `TransportComponent` under the
+ * `TransportBindings.tags.HANDLER_DISCOVERER` tag. Subclass or replace
+ * this discoverer to alter how `@messageHandler` decorators are
+ * interpreted; bind under the same tag to add a new vocabulary instead.
+ *
+ * @public
+ */
+class MessageHandlerDiscoverer {
+    id = 'message';
+    discover(controllerClass) {
+        const methods = core_1.MetadataInspector.getAllMethodMetadata(decorators_1.MESSAGE_HANDLER_METADATA.key, controllerClass.prototype);
+        if (!methods)
+            return [];
+        const handlers = [];
+        for (const [methodName, metadata] of Object.entries(methods)) {
+            const options = {};
+            if (metadata.transport !== undefined) {
+                options.transport = metadata.transport;
+            }
+            if (metadata.extras !== undefined) {
+                options.extras = metadata.extras;
+            }
+            const discovered = {
+                pattern: metadata.pattern,
+                transport: metadata.transport ?? '*',
+                kind: handler_kind_1.HANDLER_KIND_REQUEST,
+                methodName,
+            };
+            if (options.transport !== undefined || options.extras !== undefined) {
+                discovered.options = options;
+            }
+            handlers.push(discovered);
+        }
+        return handlers;
+    }
+}
+exports.MessageHandlerDiscoverer = MessageHandlerDiscoverer;
+//# sourceMappingURL=message-handler-discoverer.js.map

package/dist/discovery/message-handler-discoverer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler-discoverer.js","sourceRoot":"","sources":["../../src/discovery/message-handler-discoverer.ts"],"names":[],"mappings":";;;AACA,yCAAiD;AACjD,8CAIuB;AAEvB,iDAAoD;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAa,wBAAwB;IAC1B,EAAE,GAAG,SAAS,CAAC;IAExB,QAAQ,CAAC,eAAqC;QAC5C,MAAM,OAAO,GACX,wBAAiB,CAAC,oBAAoB,CACpC,qCAAwB,CAAC,GAAG,EAC5B,eAAe,CAAC,SAAS,CAC1B,CAAC;QACJ,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAwB,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAmB,EAAE,CAAC;YACnC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;YACzC,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAClC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YACnC,CAAC;YAED,MAAM,UAAU,GAAsB;gBACpC,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,GAAG;gBACpC,IAAI,EAAE,mCAAoB;gBAC1B,UAAU;aACX,CAAC;YACF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACpE,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;YAC/B,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAlCD,4DAkCC"}

package/dist/discovery/registered-handler.d.ts

@@ -0,0 +1,35 @@
+import type { Constructor } from '@loopback/core';
+import type { HandlerOptions } from '../decorators';
+import type { MessageHandler } from '../interfaces';
+import type { HandlerKind } from './handler-kind';
+/**
+ * Immutable view of a transport handler that was discovered at boot.
+ * Returned by {@link DiscoveryService} for cross-cutting plugins
+ * (metrics, tracing, audit, schema generation) to enumerate the
+ * full handler graph without coupling to specific transports or
+ * decorator vocabularies.
+ *
+ * @public
+ */
+export interface RegisteredHandler {
+    /** Routing pattern (string or structured object). */
+    readonly pattern: string | Record<string, unknown>;
+    /** Transport server tag this handler is bound to. */
+    readonly transport: string;
+    /** Handler kind. */
+    readonly kind: HandlerKind;
+    /** Controller class that declared this handler. */
+    readonly controllerClass: Constructor<unknown>;
+    /** Method name on the controller prototype. */
+    readonly methodName: string;
+    /** Identifier of the {@link HandlerDiscoverer} that produced this entry. */
+    readonly discovererId: string;
+    /** Discoverer-specific handler options. */
+    readonly options?: HandlerOptions;
+    /**
+     * Handler function as produced by the registry's `createHandler()`.
+     * The LB4 interceptor chain (including any `@globalInterceptor`s) runs
+     * at invocation time inside this function.
+     */
+    readonly invoke: MessageHandler;
+}

package/dist/discovery/registered-handler.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=registered-handler.js.map

package/dist/discovery/registered-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registered-handler.js","sourceRoot":"","sources":["../../src/discovery/registered-handler.ts"],"names":[],"mappings":""}