@ebarahona/loopback-transport-core 1.0.0 → 1.1.0

package/dist/helpers/errors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Typed error classes for the transport core.
+ *
+ * Each class extends `Error` and overrides `name` so consumers can match
+ * failures either by `instanceof` or by `error.name`. Throw the most
+ * specific subclass for the failure category — never raw `Error`.
+ */
+/**
+ * General transport-level failure that does not match a more specific
+ * category. Prefer one of the specific subclasses below when applicable.
+ *
+ * @public
+ */
+export declare class TransportError extends Error {
+    readonly name = "TransportError";
+    constructor(message: string);
+}
+/**
+ * Configuration/registration error. Thrown when a binding, tag, or
+ * registration is invalid — e.g. a transport server is registered
+ * without the required transport-name tag, or a handler is registered
+ * twice for the same pattern.
+ *
+ * @public
+ */
+export declare class TransportConfigError extends Error {
+    readonly name = "TransportConfigError";
+    constructor(message: string);
+}
+/**
+ * Pattern validation error. Thrown when a pattern object contains a
+ * value that cannot be normalized — non-JSON-serializable primitives,
+ * non-plain objects, or circular references.
+ *
+ * @public
+ */
+export declare class TransportPatternError extends Error {
+    readonly name = "TransportPatternError";
+    constructor(message: string);
+}
+/**
+ * Serialization or deserialization failure. Always wraps the original
+ * cause via `ErrorOptions.cause` so consumers can inspect the underlying
+ * runtime error (`SyntaxError`, `TypeError`, etc.).
+ *
+ * @public
+ */
+export declare class TransportSerializationError extends Error {
+    readonly name = "TransportSerializationError";
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Timeout error surfaced to handlers and callers when an Observable or
+ * async operation does not settle within the configured budget.
+ *
+ * @public
+ */
+export declare class TransportTimeoutError extends Error {
+    readonly name = "TransportTimeoutError";
+    constructor(message: string);
+}

package/dist/helpers/errors.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Typed error classes for the transport core.
+ *
+ * Each class extends `Error` and overrides `name` so consumers can match
+ * failures either by `instanceof` or by `error.name`. Throw the most
+ * specific subclass for the failure category — never raw `Error`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportTimeoutError = exports.TransportSerializationError = exports.TransportPatternError = exports.TransportConfigError = exports.TransportError = void 0;
+/**
+ * General transport-level failure that does not match a more specific
+ * category. Prefer one of the specific subclasses below when applicable.
+ *
+ * @public
+ */
+class TransportError extends Error {
+    name = 'TransportError';
+    constructor(message) {
+        super(message);
+    }
+}
+exports.TransportError = TransportError;
+/**
+ * Configuration/registration error. Thrown when a binding, tag, or
+ * registration is invalid — e.g. a transport server is registered
+ * without the required transport-name tag, or a handler is registered
+ * twice for the same pattern.
+ *
+ * @public
+ */
+class TransportConfigError extends Error {
+    name = 'TransportConfigError';
+    constructor(message) {
+        super(message);
+    }
+}
+exports.TransportConfigError = TransportConfigError;
+/**
+ * Pattern validation error. Thrown when a pattern object contains a
+ * value that cannot be normalized — non-JSON-serializable primitives,
+ * non-plain objects, or circular references.
+ *
+ * @public
+ */
+class TransportPatternError extends Error {
+    name = 'TransportPatternError';
+    constructor(message) {
+        super(message);
+    }
+}
+exports.TransportPatternError = TransportPatternError;
+/**
+ * Serialization or deserialization failure. Always wraps the original
+ * cause via `ErrorOptions.cause` so consumers can inspect the underlying
+ * runtime error (`SyntaxError`, `TypeError`, etc.).
+ *
+ * @public
+ */
+class TransportSerializationError extends Error {
+    name = 'TransportSerializationError';
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+exports.TransportSerializationError = TransportSerializationError;
+/**
+ * Timeout error surfaced to handlers and callers when an Observable or
+ * async operation does not settle within the configured budget.
+ *
+ * @public
+ */
+class TransportTimeoutError extends Error {
+    name = 'TransportTimeoutError';
+    constructor(message) {
+        super(message);
+    }
+}
+exports.TransportTimeoutError = TransportTimeoutError;
+//# sourceMappingURL=errors.js.map

package/dist/helpers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/helpers/errors.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,KAAK;IACrB,IAAI,GAAG,gBAAgB,CAAC;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AALD,wCAKC;AAED;;;;;;;GAOG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC3B,IAAI,GAAG,sBAAsB,CAAC;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AALD,oDAKC;AAED;;;;;;GAMG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAC5B,IAAI,GAAG,uBAAuB,CAAC;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AALD,sDAKC;AAED;;;;;;GAMG;AACH,MAAa,2BAA4B,SAAQ,KAAK;IAClC,IAAI,GAAG,6BAA6B,CAAC;IACvD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AALD,kEAKC;AAED;;;;;GAKG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAC5B,IAAI,GAAG,uBAAuB,CAAC;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AALD,sDAKC"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,2 @@
+export { TransportError, TransportConfigError, TransportPatternError, TransportSerializationError, TransportTimeoutError, } from './errors';
+export { registerServer, registerServerClass, registerServerProvider, } from './register-server';

package/dist/helpers/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerServerProvider = exports.registerServerClass = exports.registerServer = exports.TransportTimeoutError = exports.TransportSerializationError = exports.TransportPatternError = exports.TransportConfigError = exports.TransportError = void 0;
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "TransportError", { enumerable: true, get: function () { return errors_1.TransportError; } });
+Object.defineProperty(exports, "TransportConfigError", { enumerable: true, get: function () { return errors_1.TransportConfigError; } });
+Object.defineProperty(exports, "TransportPatternError", { enumerable: true, get: function () { return errors_1.TransportPatternError; } });
+Object.defineProperty(exports, "TransportSerializationError", { enumerable: true, get: function () { return errors_1.TransportSerializationError; } });
+Object.defineProperty(exports, "TransportTimeoutError", { enumerable: true, get: function () { return errors_1.TransportTimeoutError; } });
+var register_server_1 = require("./register-server");
+Object.defineProperty(exports, "registerServer", { enumerable: true, get: function () { return register_server_1.registerServer; } });
+Object.defineProperty(exports, "registerServerClass", { enumerable: true, get: function () { return register_server_1.registerServerClass; } });
+Object.defineProperty(exports, "registerServerProvider", { enumerable: true, get: function () { return register_server_1.registerServerProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;AAAA,mCAMkB;AALhB,wGAAA,cAAc,OAAA;AACd,8GAAA,oBAAoB,OAAA;AACpB,+GAAA,qBAAqB,OAAA;AACrB,qHAAA,2BAA2B,OAAA;AAC3B,+GAAA,qBAAqB,OAAA;AAEvB,qDAI2B;AAHzB,iHAAA,cAAc,OAAA;AACd,sHAAA,mBAAmB,OAAA;AACnB,yHAAA,sBAAsB,OAAA"}

package/dist/helpers/register-server.d.ts

@@ -0,0 +1,44 @@
+import type { Application, Binding, Constructor, Provider } from '@loopback/core';
+import type { TransportServer } from '../interfaces';
+/**
+ * Register a concrete transport server instance.
+ *
+ * Use when the server is already constructed (for example in tests or
+ * when no DI is needed).
+ *
+ * @public
+ * @param app - The LoopBack application
+ * @param transport - Transport name (e.g. `'kafka'`, `'rabbitmq'`)
+ * @param instance - A concrete transport server instance
+ * @returns The created binding.
+ */
+export declare function registerServer(app: Application, transport: string, instance: TransportServer): Binding<TransportServer>;
+/**
+ * Register a transport server class with the IoC container.
+ *
+ * The class is instantiated by the container, enabling constructor
+ * injection of config, clients, health checks, and other dependencies.
+ * This is the recommended registration method for transport adapters.
+ *
+ * @public
+ * @param app - The LoopBack application
+ * @param transport - Transport name (e.g. `'kafka'`, `'rabbitmq'`)
+ * @param serverClass - A transport server class constructor
+ * @returns The created binding.
+ */
+export declare function registerServerClass(app: Application, transport: string, serverClass: Constructor<TransportServer>): Binding<TransportServer>;
+/**
+ * Register a transport server provider.
+ *
+ * Providers enable async factory patterns with full DI support. Use
+ * when server construction requires async initialization or complex
+ * setup logic. The binding is singleton-scoped so every resolution
+ * returns the same server instance.
+ *
+ * @public
+ * @param app - The LoopBack application
+ * @param transport - Transport name (e.g. `'kafka'`, `'rabbitmq'`)
+ * @param serverProvider - A provider class that produces a {@link TransportServer}
+ * @returns The created binding.
+ */
+export declare function registerServerProvider(app: Application, transport: string, serverProvider: Constructor<Provider<TransportServer>>): Binding<TransportServer>;

package/dist/helpers/register-server.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerServer = registerServer;
+exports.registerServerClass = registerServerClass;
+exports.registerServerProvider = registerServerProvider;
+const core_1 = require("@loopback/core");
+const keys_1 = require("../keys");
+/**
+ * Tag a transport server binding for booter discovery.
+ *
+ * @internal
+ */
+function tagServerBinding(binding, transport) {
+    return binding
+        .tag(keys_1.TRANSPORT_SERVER_TAG)
+        .tag({ [keys_1.TRANSPORT_NAME_TAG]: transport });
+}
+/**
+ * Register a concrete transport server instance.
+ *
+ * Use when the server is already constructed (for example in tests or
+ * when no DI is needed).
+ *
+ * @public
+ * @param app - The LoopBack application
+ * @param transport - Transport name (e.g. `'kafka'`, `'rabbitmq'`)
+ * @param instance - A concrete transport server instance
+ * @returns The created binding.
+ */
+function registerServer(app, transport, instance) {
+    return tagServerBinding(app.bind(keys_1.TransportBindings.server(transport)).to(instance), transport);
+}
+/**
+ * Register a transport server class with the IoC container.
+ *
+ * The class is instantiated by the container, enabling constructor
+ * injection of config, clients, health checks, and other dependencies.
+ * This is the recommended registration method for transport adapters.
+ *
+ * @public
+ * @param app - The LoopBack application
+ * @param transport - Transport name (e.g. `'kafka'`, `'rabbitmq'`)
+ * @param serverClass - A transport server class constructor
+ * @returns The created binding.
+ */
+function registerServerClass(app, transport, serverClass) {
+    return tagServerBinding(app
+        .bind(keys_1.TransportBindings.server(transport))
+        .toClass(serverClass)
+        .inScope(core_1.BindingScope.SINGLETON), transport);
+}
+/**
+ * Register a transport server provider.
+ *
+ * Providers enable async factory patterns with full DI support. Use
+ * when server construction requires async initialization or complex
+ * setup logic. The binding is singleton-scoped so every resolution
+ * returns the same server instance.
+ *
+ * @public
+ * @param app - The LoopBack application
+ * @param transport - Transport name (e.g. `'kafka'`, `'rabbitmq'`)
+ * @param serverProvider - A provider class that produces a {@link TransportServer}
+ * @returns The created binding.
+ */
+function registerServerProvider(app, transport, serverProvider) {
+    return tagServerBinding(app
+        .bind(keys_1.TransportBindings.server(transport))
+        .toProvider(serverProvider)
+        .inScope(core_1.BindingScope.SINGLETON), transport);
+}
+//# sourceMappingURL=register-server.js.map

package/dist/helpers/register-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-server.js","sourceRoot":"","sources":["../../src/helpers/register-server.ts"],"names":[],"mappings":";;AAmCA,wCASC;AAeD,kDAYC;AAgBD,wDAYC;AAlGD,yCAA4C;AAE5C,kCAIiB;AAEjB;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,OAAiC,EACjC,SAAiB;IAEjB,OAAO,OAAO;SACX,GAAG,CAAC,2BAAoB,CAAC;SACzB,GAAG,CAAC,EAAC,CAAC,yBAAkB,CAAC,EAAE,SAAS,EAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc,CAC5B,GAAgB,EAChB,SAAiB,EACjB,QAAyB;IAEzB,OAAO,gBAAgB,CACrB,GAAG,CAAC,IAAI,CAAC,wBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAC1D,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CACjC,GAAgB,EAChB,SAAiB,EACjB,WAAyC;IAEzC,OAAO,gBAAgB,CACrB,GAAG;SACA,IAAI,CAAC,wBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SACzC,OAAO,CAAC,WAAW,CAAC;SACpB,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,EAClC,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,sBAAsB,CACpC,GAAgB,EAChB,SAAiB,EACjB,cAAsD;IAEtD,OAAO,gBAAgB,CACrB,GAAG;SACA,IAAI,CAAC,wBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SACzC,UAAU,CAAC,cAAc,CAAC;SAC1B,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,EAClC,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,11 +1,19 @@
 export { TransportComponent } from './transport.component';
-export { TransportBooter } from './transport-booter';
-export { TransportBindings, TRANSPORT_SERVER_TAG, TRANSPORT_NAME_TAG, } from './keys';
+export { TransportBooter } from './transport.observer';
+export { DESERIALIZER_TAG, HANDLER_DISCOVERER_TAG, SERIALIZER_TAG, TransportBindings, TRANSPORT_NAME_TAG, TRANSPORT_SERVER_TAG, } from './keys';
+export { registerServer, registerServerClass, registerServerProvider, } from './helpers/register-server';
+export { TransportConfigError, TransportError, TransportPatternError, TransportSerializationError, TransportTimeoutError, } from './helpers/errors';
 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 { DiscoveryService, EventHandlerDiscoverer, HANDLER_KIND_EVENT, HANDLER_KIND_REQUEST, MessageHandlerDiscoverer, } from './discovery';
+export type { DiscoveredHandler, HandlerDiscoverer, HandlerKind, RegisteredHandler, } from './discovery';
+export type { IncomingEvent, IncomingRequest, IncomingResponse, MessageHandler, OutgoingEvent, OutgoingRequest, PacketId, ReadPacket, TransportClient, TransportServer, TransportStatus, WritePacket, } from './interfaces';
+export { ExecutionContext } from './context';
+export type { ContextType, ControllerClass, EventContext, HandlerFunction, HttpContext, RpcContext, } from './context';
+export { EVENT_HANDLER_METADATA, MESSAGE_HANDLER_METADATA, eventHandler, messageHandler, payload, transportCtx, } from './decorators';
+export type { EventHandlerMetadata, HandlerOptions, MessageHandlerMetadata, } from './decorators';
 export { normalizePattern } from './utils';
 export { ClientProxy } from './client';
-export { ServerBase, HandlerResult } from './server';
-export { Serializer, Deserializer, JsonSerializer, JsonDeserializer, TransportPacket, } from './serializers';
+export { ServerBase } from './server';
+export type { HandlerResult } from './server';
+export { CloudEventsDeserializer, CloudEventsSerializer, JsonDeserializer, JsonSerializer, } from './serializers';
+export type { CloudEventsSerializerOptions, Deserializer, Serializer, TransportPacket, } from './serializers';

package/dist/index.js

@@ -1,31 +1,53 @@
 "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;
+exports.JsonSerializer = exports.JsonDeserializer = exports.CloudEventsSerializer = exports.CloudEventsDeserializer = exports.ServerBase = exports.ClientProxy = exports.normalizePattern = exports.transportCtx = exports.payload = exports.messageHandler = exports.eventHandler = exports.MESSAGE_HANDLER_METADATA = exports.EVENT_HANDLER_METADATA = exports.ExecutionContext = exports.MessageHandlerDiscoverer = exports.HANDLER_KIND_REQUEST = exports.HANDLER_KIND_EVENT = exports.EventHandlerDiscoverer = exports.DiscoveryService = exports.HandlerRegistry = exports.TransportTimeoutError = exports.TransportSerializationError = exports.TransportPatternError = exports.TransportError = exports.TransportConfigError = exports.registerServerProvider = exports.registerServerClass = exports.registerServer = exports.TRANSPORT_SERVER_TAG = exports.TRANSPORT_NAME_TAG = exports.TransportBindings = exports.SERIALIZER_TAG = exports.HANDLER_DISCOVERER_TAG = exports.DESERIALIZER_TAG = 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; } });
+// Lifecycle observer (was: transport-booter)
+var transport_observer_1 = require("./transport.observer");
+Object.defineProperty(exports, "TransportBooter", { enumerable: true, get: function () { return transport_observer_1.TransportBooter; } });
 // Binding keys and tags
 var keys_1 = require("./keys");
+Object.defineProperty(exports, "DESERIALIZER_TAG", { enumerable: true, get: function () { return keys_1.DESERIALIZER_TAG; } });
+Object.defineProperty(exports, "HANDLER_DISCOVERER_TAG", { enumerable: true, get: function () { return keys_1.HANDLER_DISCOVERER_TAG; } });
+Object.defineProperty(exports, "SERIALIZER_TAG", { enumerable: true, get: function () { return keys_1.SERIALIZER_TAG; } });
 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; } });
+Object.defineProperty(exports, "TRANSPORT_SERVER_TAG", { enumerable: true, get: function () { return keys_1.TRANSPORT_SERVER_TAG; } });
+// Server registration helpers
+var register_server_1 = require("./helpers/register-server");
+Object.defineProperty(exports, "registerServer", { enumerable: true, get: function () { return register_server_1.registerServer; } });
+Object.defineProperty(exports, "registerServerClass", { enumerable: true, get: function () { return register_server_1.registerServerClass; } });
+Object.defineProperty(exports, "registerServerProvider", { enumerable: true, get: function () { return register_server_1.registerServerProvider; } });
+// Typed errors
+var errors_1 = require("./helpers/errors");
+Object.defineProperty(exports, "TransportConfigError", { enumerable: true, get: function () { return errors_1.TransportConfigError; } });
+Object.defineProperty(exports, "TransportError", { enumerable: true, get: function () { return errors_1.TransportError; } });
+Object.defineProperty(exports, "TransportPatternError", { enumerable: true, get: function () { return errors_1.TransportPatternError; } });
+Object.defineProperty(exports, "TransportSerializationError", { enumerable: true, get: function () { return errors_1.TransportSerializationError; } });
+Object.defineProperty(exports, "TransportTimeoutError", { enumerable: true, get: function () { return errors_1.TransportTimeoutError; } });
 // Registry
 var registry_1 = require("./registry");
 Object.defineProperty(exports, "HandlerRegistry", { enumerable: true, get: function () { return registry_1.HandlerRegistry; } });
+// Handler discovery extension point
+var discovery_1 = require("./discovery");
+Object.defineProperty(exports, "DiscoveryService", { enumerable: true, get: function () { return discovery_1.DiscoveryService; } });
+Object.defineProperty(exports, "EventHandlerDiscoverer", { enumerable: true, get: function () { return discovery_1.EventHandlerDiscoverer; } });
+Object.defineProperty(exports, "HANDLER_KIND_EVENT", { enumerable: true, get: function () { return discovery_1.HANDLER_KIND_EVENT; } });
+Object.defineProperty(exports, "HANDLER_KIND_REQUEST", { enumerable: true, get: function () { return discovery_1.HANDLER_KIND_REQUEST; } });
+Object.defineProperty(exports, "MessageHandlerDiscoverer", { enumerable: true, get: function () { return discovery_1.MessageHandlerDiscoverer; } });
 // 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, "EVENT_HANDLER_METADATA", { enumerable: true, get: function () { return decorators_1.EVENT_HANDLER_METADATA; } });
+Object.defineProperty(exports, "MESSAGE_HANDLER_METADATA", { enumerable: true, get: function () { return decorators_1.MESSAGE_HANDLER_METADATA; } });
 Object.defineProperty(exports, "eventHandler", { enumerable: true, get: function () { return decorators_1.eventHandler; } });
+Object.defineProperty(exports, "messageHandler", { enumerable: true, get: function () { return decorators_1.messageHandler; } });
 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; } });
@@ -37,6 +59,8 @@ 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, "CloudEventsDeserializer", { enumerable: true, get: function () { return serializers_1.CloudEventsDeserializer; } });
+Object.defineProperty(exports, "CloudEventsSerializer", { enumerable: true, get: function () { return serializers_1.CloudEventsSerializer; } });
 Object.defineProperty(exports, "JsonDeserializer", { enumerable: true, get: function () { return serializers_1.JsonDeserializer; } });
+Object.defineProperty(exports, "JsonSerializer", { enumerable: true, get: function () { return serializers_1.JsonSerializer; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,YAAY;AACZ,6DAAyD;AAAjD,yHAAA,kBAAkB,OAAA;AAE1B,SAAS;AACT,uDAAmD;AAA3C,mHAAA,eAAe,OAAA;AAEvB,wBAAwB;AACxB,+BAIgB;AAHd,yGAAA,iBAAiB,OAAA;AACjB,4GAAA,oBAAoB,OAAA;AACpB,0GAAA,kBAAkB,OAAA;AAGpB,WAAW;AACX,uCAA2C;AAAnC,2GAAA,eAAe,OAAA;AAkBvB,UAAU;AACV,qCAMmB;AALjB,2GAAA,gBAAgB,OAAA;AAOlB,aAAa;AACb,2CAUsB;AATpB,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AACZ,qGAAA,OAAO,OAAA;AACP,0GAAA,YAAY,OAAA;AAIZ,sHAAA,wBAAwB,OAAA;AACxB,oHAAA,sBAAsB,OAAA;AAGxB,QAAQ;AACR,iCAAyC;AAAjC,yGAAA,gBAAgB,OAAA;AAExB,SAAS;AACT,mCAAqC;AAA7B,qGAAA,WAAW,OAAA;AAEnB,SAAS;AACT,mCAAmD;AAA3C,oGAAA,UAAU,OAAA;AAElB,cAAc;AACd,6CAMuB;AAHrB,6GAAA,cAAc,OAAA;AACd,+GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,YAAY;AACZ,6DAAyD;AAAjD,yHAAA,kBAAkB,OAAA;AAE1B,6CAA6C;AAC7C,2DAAqD;AAA7C,qHAAA,eAAe,OAAA;AAEvB,wBAAwB;AACxB,+BAOgB;AANd,wGAAA,gBAAgB,OAAA;AAChB,8GAAA,sBAAsB,OAAA;AACtB,sGAAA,cAAc,OAAA;AACd,yGAAA,iBAAiB,OAAA;AACjB,0GAAA,kBAAkB,OAAA;AAClB,4GAAA,oBAAoB,OAAA;AAGtB,8BAA8B;AAC9B,6DAImC;AAHjC,iHAAA,cAAc,OAAA;AACd,sHAAA,mBAAmB,OAAA;AACnB,yHAAA,sBAAsB,OAAA;AAGxB,eAAe;AACf,2CAM0B;AALxB,8GAAA,oBAAoB,OAAA;AACpB,wGAAA,cAAc,OAAA;AACd,+GAAA,qBAAqB,OAAA;AACrB,qHAAA,2BAA2B,OAAA;AAC3B,+GAAA,qBAAqB,OAAA;AAGvB,WAAW;AACX,uCAA2C;AAAnC,2GAAA,eAAe,OAAA;AAEvB,oCAAoC;AACpC,yCAMqB;AALnB,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,+GAAA,kBAAkB,OAAA;AAClB,iHAAA,oBAAoB,OAAA;AACpB,qHAAA,wBAAwB,OAAA;AAyB1B,UAAU;AACV,qCAA2C;AAAnC,2GAAA,gBAAgB,OAAA;AAUxB,aAAa;AACb,2CAOsB;AANpB,oHAAA,sBAAsB,OAAA;AACtB,sHAAA,wBAAwB,OAAA;AACxB,0GAAA,YAAY,OAAA;AACZ,4GAAA,cAAc,OAAA;AACd,qGAAA,OAAO,OAAA;AACP,0GAAA,YAAY,OAAA;AAQd,QAAQ;AACR,iCAAyC;AAAjC,yGAAA,gBAAgB,OAAA;AAExB,SAAS;AACT,mCAAqC;AAA7B,qGAAA,WAAW,OAAA;AAEnB,SAAS;AACT,mCAAoC;AAA5B,oGAAA,UAAU,OAAA;AAGlB,cAAc;AACd,6CAKuB;AAJrB,sHAAA,uBAAuB,OAAA;AACvB,oHAAA,qBAAqB,OAAA;AACrB,+GAAA,gBAAgB,OAAA;AAChB,6GAAA,cAAc,OAAA"}

package/dist/interfaces/index.d.ts

@@ -1,4 +1,4 @@
-export * from './packet.interface';
-export * from './transport-server.interface';
-export * from './transport-client.interface';
-export * from './message-handler.interface';
+export type { IncomingEvent, IncomingRequest, IncomingResponse, OutgoingEvent, OutgoingRequest, PacketId, ReadPacket, WritePacket, } from './packet.interface';
+export type { TransportServer, TransportStatus, } from './transport-server.interface';
+export type { TransportClient } from './transport-client.interface';
+export type { MessageHandler } from './message-handler.interface';

package/dist/interfaces/index.js

@@ -1,21 +1,3 @@
 "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("./packet.interface"), exports);
-__exportStar(require("./transport-server.interface"), exports);
-__exportStar(require("./transport-client.interface"), exports);
-__exportStar(require("./message-handler.interface"), exports);
 //# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,+DAA6C;AAC7C,+DAA6C;AAC7C,8DAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":""}

package/dist/interfaces/message-handler.interface.d.ts

@@ -1,21 +1,27 @@
-import { Observable } from 'rxjs';
+import type { Observable } from 'rxjs';
 /**
  * Function that handles an incoming message.
+ *
+ * @public
+ * @typeParam TInput - Payload shape passed to the handler.
+ * @typeParam TContext - Transport-specific context shape.
+ * @typeParam TResult - Handler return shape.
  */
 export interface MessageHandler<TInput = unknown, TContext = unknown, TResult = unknown> {
     (data: TInput, ctx?: TContext): Promise<TResult> | Promise<Observable<TResult>> | TResult | Observable<TResult>;
     /**
-     * True for @eventHandler, false for @messageHandler.
+     * `true` for `@eventHandler`, `false` for `@messageHandler`.
      */
     isEventHandler?: boolean;
     /**
-     * Target transport name (e.g., 'kafka', 'rabbitmq').
-     * First-class property for routing, not buried in extras.
+     * Target transport name (e.g. `'kafka'`, `'rabbitmq'`). First-class
+     * property for routing, not buried in `extras`.
      */
     transport?: string;
     /**
-     * Transport-specific metadata (e.g., QoS for MQTT, consumer group for Kafka).
-     * Does not contain framework routing metadata (use transport field instead).
+     * Transport-specific metadata (e.g. QoS for MQTT, consumer group for
+     * Kafka). Does not contain framework routing metadata — use the
+     * `transport` field instead.
      */
     extras?: Readonly<Record<string, unknown>>;
 }

package/dist/interfaces/packet.interface.d.ts

@@ -1,12 +1,17 @@
 /**
  * Unique identifier for correlating request/response messages.
+ *
+ * @public
  */
 export interface PacketId {
     id: string;
 }
 /**
- * Inbound message envelope. Used for both requests and events.
- * Events omit the id field.
+ * Inbound message envelope. Used for both requests and events. Events
+ * omit the `id` field.
+ *
+ * @public
+ * @typeParam T - Payload shape.
  */
 export interface ReadPacket<T = unknown> {
     pattern: string;
@@ -14,6 +19,9 @@ export interface ReadPacket<T = unknown> {
 }
 /**
  * Outbound response envelope. Sent back for request/response patterns.
+ *
+ * @public
+ * @typeParam T - Response value shape.
  */
 export interface WritePacket<T = unknown> {
     err?: Error | string | Record<string, unknown>;
@@ -22,21 +30,31 @@ export interface WritePacket<T = unknown> {
 }
 /**
  * A request with a correlation ID for response matching.
+ *
+ * @public
  */
 export type OutgoingRequest = ReadPacket & PacketId;
 /**
  * An event with no correlation ID (fire-and-forget).
+ *
+ * @public
  */
 export type OutgoingEvent = ReadPacket;
 /**
  * Server receives a request with correlation ID.
+ *
+ * @public
  */
 export type IncomingRequest = ReadPacket & PacketId;
 /**
  * Server receives an event (no correlation).
+ *
+ * @public
  */
 export type IncomingEvent = ReadPacket;
 /**
  * Response correlated to a request by ID.
+ *
+ * @public
  */
 export type IncomingResponse = WritePacket & PacketId;

package/dist/interfaces/transport-client.interface.d.ts

@@ -1,33 +1,43 @@
-import { Observable } from 'rxjs';
-import { TransportStatus } from './transport-server.interface';
+import type { Observable } from 'rxjs';
+import type { TransportStatus } from './transport-server.interface';
 /**
- * Interface that all transport clients must implement.
- * Used for sending messages to brokers (producer side).
+ * Interface that all transport clients must implement. Used for
+ * sending messages to brokers (producer side).
+ *
+ * @public
  */
 export interface TransportClient {
     /**
-     * Establish connection to the broker.
-     * Called lazily on first send/emit, or explicitly for eager connection.
+     * Establish connection to the broker. Called lazily on first
+     * send/emit, or explicitly for eager connection.
+     *
+     * @returns Resolves when the connection is healthy.
      */
     connect(): Promise<void>;
     /**
      * Close the connection.
+     *
+     * @returns Resolves once the connection has been torn down.
      */
     close(): Promise<void>;
     /**
-     * Send a request and wait for a response (request/response pattern).
-     * Returns a cold Observable: the message is sent when subscribed.
+     * Send a request and wait for a response (request/response
+     * pattern). Returns a cold Observable: the message is sent when
+     * subscribed.
      *
-     * @param pattern - String or object pattern to match on the server side
-     * @param data - The message payload
+     * @typeParam TResult - Expected response shape.
+     * @typeParam TInput - Caller-provided payload shape.
+     * @param pattern - String or object pattern to match on the server side.
+     * @param data - The message payload.
      */
     send<TResult = unknown, TInput = unknown>(pattern: string | Record<string, unknown>, data: TInput): Observable<TResult>;
     /**
      * Emit an event with no response expected (fire-and-forget pattern).
      * Returns a Promise that resolves when the event is dispatched.
      *
-     * @param pattern - String or object event pattern
-     * @param data - The event payload
+     * @typeParam TInput - Caller-provided payload shape.
+     * @param pattern - String or object event pattern.
+     * @param data - The event payload.
      */
     emit<TInput = unknown>(pattern: string | Record<string, unknown>, data: TInput): Promise<void>;
     /**
@@ -35,7 +45,9 @@ export interface TransportClient {
      */
     readonly status$: Observable<TransportStatus>;
     /**
-     * Access the underlying native client (e.g., KafkaJS Producer).
+     * Access the underlying native client (e.g. a KafkaJS `Producer`).
+     *
+     * @typeParam T - Caller-asserted native client shape.
      */
     unwrap<T>(): T;
 }