@nextage/era-lib 1.0.185 → 1.0.187

package/build/events/{base-nats-listener.js → base/base-nats-listener.js}

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NatsListener = void 0;
 const nx_frame_be_1 = require("@nextage/nx-frame-be");
-const dlq_constants_1 = require("./types/dlq.constants");
+const dlq_constants_1 = require("../types/dlq.constants");
 const base_listener_1 = require("./base-listener");
-const cascade_1 = require("./cascade");
+const cascade_1 = require("../cascade");
 /**
  * Durable inter-service listener (JetStream): owns the per-message ack/nak/term
  * and DLQ policy. Keep `onMessage` idempotent so redelivery is always safe.
@@ -34,14 +34,17 @@ class NatsListener extends base_listener_1.Listener {
         return this.provider.client;
     }
     /**
+     * Per-subject subscription tuning; override in a subclass to customise the
+     * JetStream consumer options. The base returns no overrides.
      *
-     * @returns
+     * @returns the {@link EventSubOptions} for this consumer
      */
     subscriptionOptions() {
         return {};
     }
     /**
-     *
+     * Creates the JetStream durable consumer for this subject and starts the
+     * consume loop. Safe to call after the transport connects (finding B8).
      */
     async listen() {
         try {
@@ -166,8 +169,8 @@ class NatsListener extends base_listener_1.Listener {
         }
     }
     /**
-     *
-     * @returns
+     * Stops the consume loop and deletes the consumer, releasing its JetStream
+     * resources on shutdown. A best-effort unsubscribe never throws.
      */
     async stop() {
         this.isListening = false;
@@ -196,17 +199,19 @@ class NatsListener extends base_listener_1.Listener {
         return this.nakBackoffMs[idx];
     }
     /**
+     * Decodes the raw message bytes to a UTF-8 string.
      *
-     * @param msg
-     * @returns
+     * @param msg the JetStream message
+     * @returns the decoded payload string
      */
     decode(msg) {
         return new TextDecoder().decode(msg.data);
     }
     /**
+     * Decodes and JSON-parses a message into the in-band event envelope.
      *
-     * @param msg
-     * @returns
+     * @param msg the JetStream message
+     * @returns the parsed {@link Event} envelope (unwrapped by the caller)
      */
     parseMessage(msg) {
         try {

package/build/events/base/base-nats-listener.js.map

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

package/build/events/base/base-nats-publisher.d.ts

@@ -0,0 +1,23 @@
+import { JetStreamPublishOptions } from 'nats';
+import { Event, IPublisher } from '../interfaces';
+import { EventMeta } from '../types/event-envelope.interfaces';
+import { Publisher } from './base-publisher';
+/**
+ * Durable (JetStream) publisher: inter-service delivery with retry/DLQ semantics
+ * on the consumer side.
+ *
+ * Emits the event wrapped in the shared in-band envelope (built by the abstract
+ * {@link Publisher}) and accepts optional JetStream publish options. The
+ * counterpart of {@link NatsListener}.
+ */
+export declare abstract class NatsPublisher<T extends Event> extends Publisher<T> implements IPublisher<T, Partial<JetStreamPublishOptions>> {
+    /**
+     * Publish the event on the durable JetStream bus.
+     *
+     * @param data    the event payload
+     * @param meta    optional cascade metadata (correlation / causation / depth)
+     * @param options optional JetStream publish options (msgID, expectations, ...)
+     */
+    publish(data: T['data'], meta?: EventMeta, options?: Partial<JetStreamPublishOptions>): Promise<void>;
+}
+//# sourceMappingURL=base-nats-publisher.d.ts.map

package/build/events/base/base-nats-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-nats-publisher.d.ts","sourceRoot":"","sources":["../../../src/events/base/base-nats-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAY,eAAe,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAoB,oCAAoC,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAoB,kBAAkB,CAAC;AAE3D;;;;;;;GAOG;AACH,8BAAsB,aAAa,CAAC,CAAC,SAAS,KAAK,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAE,YAAW,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAElI;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAW5G"}

package/build/events/base/base-nats-publisher.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsPublisher = void 0;
+const base_publisher_1 = require("./base-publisher");
+/**
+ * Durable (JetStream) publisher: inter-service delivery with retry/DLQ semantics
+ * on the consumer side.
+ *
+ * Emits the event wrapped in the shared in-band envelope (built by the abstract
+ * {@link Publisher}) and accepts optional JetStream publish options. The
+ * counterpart of {@link NatsListener}.
+ */
+class NatsPublisher extends base_publisher_1.Publisher {
+    /**
+     * Publish the event on the durable JetStream bus.
+     *
+     * @param data    the event payload
+     * @param meta    optional cascade metadata (correlation / causation / depth)
+     * @param options optional JetStream publish options (msgID, expectations, ...)
+     */
+    async publish(data, meta, options) {
+        try {
+            await this.client.publish(this.subject, JSON.stringify(this.envelope(data, meta)), options);
+        }
+        catch (error) {
+            console.error(`❌ Failed to publish to '${this.subject}':`, error);
+            throw error;
+        }
+    }
+}
+exports.NatsPublisher = NatsPublisher;
+//# sourceMappingURL=base-nats-publisher.js.map

package/build/events/base/base-nats-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-nats-publisher.js","sourceRoot":"","sources":["../../../src/events/base/base-nats-publisher.ts"],"names":[],"mappings":";;;AAGA,qDAA2D;AAE3D;;;;;;;GAOG;AACH,MAAsB,aAA+B,SAAQ,0BAAY;IAEvE;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,IAAe,EAAE,IAAgB,EAAE,OAA0C;QAEzF,IAAI,CAAC;YAEH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAE9F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,OAAO,IAAI,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AApBD,sCAoBC"}

package/build/events/base/base-publisher.d.ts

@@ -0,0 +1,34 @@
+import { ClientProvider, Event, MsgClientInterface } from '../interfaces';
+import { EventMeta, EventEnvelope } from '../types/event-envelope.interfaces';
+/**
+ * Abstract base shared by every publisher, regardless of transport.
+ *
+ * It owns the transport-agnostic concerns:
+ *  - identity (`subject`),
+ *  - lazy client resolution (`client`), so the transport may be connected AFTER
+ *    this publisher (and its owning controller) is constructed,
+ *  - the shared in-band envelope construction (`envelope`), so both buses carry
+ *    the same cascade metadata (transport-agnostic tracing).
+ *
+ * Transport-specific concerns (the concrete `publish` signature, JetStream
+ * options, error handling) live in the concrete subclasses:
+ *  - `MsgPublisher`  — in-memory, best-effort intra-service delivery,
+ *  - `NatsPublisher` — durable inter-service delivery (JetStream) with options.
+ */
+export declare abstract class Publisher<T extends Event> {
+    private readonly provider;
+    abstract subject: T['subject'];
+    constructor(provider: ClientProvider);
+    /**
+     * Resolve the client only when actually publishing, so the transport may be
+     * connected AFTER this publisher (and its owning controller) is constructed.
+     */
+    protected get client(): MsgClientInterface;
+    /**
+     * Wrap the event in the shared in-band envelope (id / subject / data /
+     * timestamp / cascade meta), so the metadata rides in the payload and loop-guard
+     * and causation tracing stay transport agnostic.
+     */
+    protected envelope(data: T['data'], meta?: EventMeta): EventEnvelope;
+}
+//# sourceMappingURL=base-publisher.d.ts.map

package/build/events/base/base-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-publisher.d.ts","sourceRoot":"","sources":["../../../src/events/base/base-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAuB,oCAAoC,CAAC;AAG/F;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,SAAS,CAAC,CAAC,SAAS,KAAK;IAIjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;gBAEF,QAAQ,EAAE,cAAc;IAErD;;;OAGG;IACH,SAAS,KAAK,MAAM,IAAI,kBAAkB,CAGzC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,aAAa;CAIrE"}

package/build/events/base/base-publisher.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Publisher = void 0;
+const cascade_1 = require("../cascade");
+/**
+ * Abstract base shared by every publisher, regardless of transport.
+ *
+ * It owns the transport-agnostic concerns:
+ *  - identity (`subject`),
+ *  - lazy client resolution (`client`), so the transport may be connected AFTER
+ *    this publisher (and its owning controller) is constructed,
+ *  - the shared in-band envelope construction (`envelope`), so both buses carry
+ *    the same cascade metadata (transport-agnostic tracing).
+ *
+ * Transport-specific concerns (the concrete `publish` signature, JetStream
+ * options, error handling) live in the concrete subclasses:
+ *  - `MsgPublisher`  — in-memory, best-effort intra-service delivery,
+ *  - `NatsPublisher` — durable inter-service delivery (JetStream) with options.
+ */
+class Publisher {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    /**
+     * Resolve the client only when actually publishing, so the transport may be
+     * connected AFTER this publisher (and its owning controller) is constructed.
+     */
+    get client() {
+        return this.provider.client;
+    }
+    /**
+     * Wrap the event in the shared in-band envelope (id / subject / data /
+     * timestamp / cascade meta), so the metadata rides in the payload and loop-guard
+     * and causation tracing stay transport agnostic.
+     */
+    envelope(data, meta) {
+        return (0, cascade_1.buildEnvelope)(this.subject, data, meta);
+    }
+}
+exports.Publisher = Publisher;
+//# sourceMappingURL=base-publisher.js.map

package/build/events/base/base-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-publisher.js","sourceRoot":"","sources":["../../../src/events/base/base-publisher.ts"],"names":[],"mappings":";;;AAEA,wCAAuE;AAEvE;;;;;;;;;;;;;;GAcG;AACH,MAAsB,SAAS;IAI7B,YAA6B,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEzD;;;OAGG;IACH,IAAc,MAAM;QAElB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACO,QAAQ,CAAC,IAAe,EAAE,IAAgB;QAElD,OAAO,IAAA,uBAAa,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;CACF;AAxBD,8BAwBC"}

package/build/events/dlq-manager.d.ts

@@ -1,4 +1,4 @@
-import { NatsClientManager } from './nats-client-manager';
+import { NatsClientManager } from './transport/nats-client-manager';
 import { DlqDepth, DlqInspectItem } from './types/dlq.interfaces';
 import { DlqInspectOptions, DlqManagerOptions } from './types/dlq.interfaces';
 import { DlqReplayOptions, DlqReplayResult } from './types/dlq.interfaces';

package/build/events/dlq-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dlq-manager.d.ts","sourceRoot":"","sources":["../../src/events/dlq-manager.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,iBAAiB,EAAE,MAAuC,uBAAuB,CAAC;AAC3F,OAAO,EAAsB,QAAQ,EAAE,cAAc,EAAE,MAAY,wBAAwB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAoB,wBAAwB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAuB,wBAAwB,CAAC;AAM5F,qBAAa,UAAU;IAST,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuD;IAE/E,OAAO,CAAC,KAAK,CAAC,CAAmC;IACjD,OAAO,CAAC,QAAQ,CAAS;gBAEI,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,iBAAsB;IAQpF;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYhD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAenC;;;OAGG;IACH,YAAY,IAAI,IAAI;IAapB,oDAAoD;IACpD,WAAW,IAAI,IAAI;IAOnB;;;;OAIG;IACG,OAAO,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsCtE;;;;;OAKG;IACG,MAAM,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDnE;;;;;OAKG;YACW,iBAAiB;YAkBjB,cAAc;IAQ5B,OAAO,CAAC,iBAAiB;CAM1B"}
+{"version":3,"file":"dlq-manager.d.ts","sourceRoot":"","sources":["../../src/events/dlq-manager.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,iBAAiB,EAAE,MAAuC,iCAAiC,CAAC;AACrG,OAAO,EAAsB,QAAQ,EAAE,cAAc,EAAE,MAAY,wBAAwB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAoB,wBAAwB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAuB,wBAAwB,CAAC;AAM5F,qBAAa,UAAU;IAST,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuD;IAE/E,OAAO,CAAC,KAAK,CAAC,CAAmC;IACjD,OAAO,CAAC,QAAQ,CAAS;gBAEI,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,iBAAsB;IAQpF;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYhD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAenC;;;OAGG;IACH,YAAY,IAAI,IAAI;IAapB,oDAAoD;IACpD,WAAW,IAAI,IAAI;IAOnB;;;;OAIG;IACG,OAAO,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsCtE;;;;;OAKG;IACG,MAAM,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDnE;;;;;OAKG;YACW,iBAAiB;YAkBjB,cAAc;IAQ5B,OAAO,CAAC,iBAAiB;CAM1B"}

package/build/events/event-subscription.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter } from 'ws';
+import { EventEmitter } from 'node:events';
 import { EventSubOptions } from './interfaces';
 export declare class EventSubscription extends EventEmitter {
     id: string;

package/build/events/event-subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-subscription.d.ts","sourceRoot":"","sources":["../../src/events/event-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAS,IAAI,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,qBAAa,iBAAkB,SAAQ,YAAY;IAEjD,EAAE,EAAe,MAAM,CAAC;IACxB,OAAO,EAAU,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAU,eAAe,CAAC;gBAErB,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe;CAQjE"}
+{"version":3,"file":"event-subscription.d.ts","sourceRoot":"","sources":["../../src/events/event-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAS,aAAa,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,qBAAa,iBAAkB,SAAQ,YAAY;IAEjD,EAAE,EAAe,MAAM,CAAC;IACxB,OAAO,EAAU,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAU,eAAe,CAAC;gBAErB,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe;CAQjE"}

package/build/events/event-subscription.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventSubscription = void 0;
-const ws_1 = require("ws");
+const node_events_1 = require("node:events");
 const nx_frame_be_1 = require("@nextage/nx-frame-be");
-class EventSubscription extends ws_1.EventEmitter {
+class EventSubscription extends node_events_1.EventEmitter {
     constructor(sub, qgName, opts) {
         super();
         this.id = (0, nx_frame_be_1.uuid)();

package/build/events/event-subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-subscription.js","sourceRoot":"","sources":["../../src/events/event-subscription.ts"],"names":[],"mappings":";;;AAAA,2BAAqC;AACrC,sDAAuD;AAGvD,MAAa,iBAAkB,SAAQ,iBAAY;IAOjD,YAAY,GAAW,EAAE,MAAe,EAAE,IAAsB;QAE9D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAe,IAAA,kBAAI,GAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAU,GAAG,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAU,IAAI,IAAI,EAAE,CAAC;IACnC,CAAC;CACF;AAfD,8CAeC"}
+{"version":3,"file":"event-subscription.js","sourceRoot":"","sources":["../../src/events/event-subscription.ts"],"names":[],"mappings":";;;AAAA,6CAA8C;AAC9C,sDAAuD;AAGvD,MAAa,iBAAkB,SAAQ,0BAAY;IAOjD,YAAY,GAAW,EAAE,MAAe,EAAE,IAAsB;QAE9D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAe,IAAA,kBAAI,GAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAU,GAAG,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAU,IAAI,IAAI,EAAE,CAAC;IACnC,CAAC;CACF;AAfD,8CAeC"}

package/build/events/index.d.ts

@@ -1,7 +1,7 @@
 export * from './types/enums';
 export * from './interfaces';
 export * from './types';
-export * from './base-event.controller';
+export * from './base/base-event.controller';
 export * from './cascade';
 export * from './event-relay';
 export * from './field-map';
@@ -10,16 +10,18 @@ export * from './publisher-registry';
 export * from './revocation-denylist';
 export * from './revocation-listener';
 export * from './access-revoked-publisher';
-export * from './msg-client-manager';
-export * from './msg-wrapper';
-export * from './base-listener';
-export * from './base-listener.interfaces';
-export * from './base-msg-listener';
-export * from './base-publisher';
-export * from './nats-client-manager';
-export * from './nats-wrapper';
-export * from './base-nats-listener';
-export * from './base-nats-publisher';
+export * from './transport/base-client-wrapper';
+export * from './transport/msg-client-manager';
+export * from './transport/msg-wrapper';
+export * from './base/base-listener';
+export * from './base/base-listener.interfaces';
+export * from './base/base-msg-listener';
+export * from './base/base-publisher';
+export * from './base/base-msg-publisher';
+export * from './transport/nats-client-manager';
+export * from './transport/nats-wrapper';
+export * from './base/base-nats-listener';
+export * from './base/base-nats-publisher';
 export * from './dlq-manager';
 export * from './organization';
 export * from './user';

package/build/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAExB,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAG9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AAGvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAExB,cAAc,8BAA8B,CAAC;AAC7C,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAG9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AAGvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/build/events/index.js

@@ -17,7 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types/enums"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./types"), exports);
-__exportStar(require("./base-event.controller"), exports);
+__exportStar(require("./base/base-event.controller"), exports);
 __exportStar(require("./cascade"), exports);
 __exportStar(require("./event-relay"), exports);
 __exportStar(require("./field-map"), exports);
@@ -26,18 +26,21 @@ __exportStar(require("./publisher-registry"), exports);
 __exportStar(require("./revocation-denylist"), exports);
 __exportStar(require("./revocation-listener"), exports);
 __exportStar(require("./access-revoked-publisher"), exports);
+// shared transport-agnostic base
+__exportStar(require("./transport/base-client-wrapper"), exports);
 // messages on memory
-__exportStar(require("./msg-client-manager"), exports);
-__exportStar(require("./msg-wrapper"), exports);
-__exportStar(require("./base-listener"), exports);
-__exportStar(require("./base-listener.interfaces"), exports);
-__exportStar(require("./base-msg-listener"), exports);
-__exportStar(require("./base-publisher"), exports);
+__exportStar(require("./transport/msg-client-manager"), exports);
+__exportStar(require("./transport/msg-wrapper"), exports);
+__exportStar(require("./base/base-listener"), exports);
+__exportStar(require("./base/base-listener.interfaces"), exports);
+__exportStar(require("./base/base-msg-listener"), exports);
+__exportStar(require("./base/base-publisher"), exports);
+__exportStar(require("./base/base-msg-publisher"), exports);
 // messages on nats
-__exportStar(require("./nats-client-manager"), exports);
-__exportStar(require("./nats-wrapper"), exports);
-__exportStar(require("./base-nats-listener"), exports);
-__exportStar(require("./base-nats-publisher"), exports);
+__exportStar(require("./transport/nats-client-manager"), exports);
+__exportStar(require("./transport/nats-wrapper"), exports);
+__exportStar(require("./base/base-nats-listener"), exports);
+__exportStar(require("./base/base-nats-publisher"), exports);
 __exportStar(require("./dlq-manager"), exports);
 // admin-mng
 __exportStar(require("./organization"), exports);

package/build/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,+CAA6B;AAC7B,0CAAwB;AAExB,0DAAwC;AACxC,4CAA0B;AAC1B,gDAA8B;AAC9B,8CAA4B;AAC5B,2CAAyB;AACzB,uDAAqC;AACrC,wDAAsC;AACtC,wDAAsC;AACtC,6DAA2C;AAE3C,qBAAqB;AACrB,uDAAqC;AACrC,gDAA8B;AAC9B,kDAAgC;AAChC,6DAA2C;AAC3C,sDAAoC;AACpC,mDAAiC;AAEjC,mBAAmB;AACnB,wDAAsC;AACtC,iDAA+B;AAC/B,uDAAqC;AACrC,wDAAsC;AACtC,gDAA8B;AAE9B,YAAY;AACZ,iDAA+B;AAC/B,yCAAuB;AAEvB,aAAa;AACb,kDAAgC;AAChC,gDAA8B;AAC9B,6CAA2B;AAC3B,mDAAiC;AACjC,iDAA+B;AAC/B,4CAA0B;AAC1B,sDAAoC;AACpC,2CAAyB;AACzB,kDAAgC;AAEhC,cAAc;AACd,4CAA0B;AAC1B,kDAAgC;AAChC,oDAAkC;AAClC,qDAAmC;AACnC,qDAAmC;AACnC,oDAAkC;AAClC,iDAA+B;AAC/B,mDAAiC;AAEjC,oBAAoB;AACpB,kDAAgC;AAChC,+CAA6B;AAE7B,kBAAkB;AAClB,mCAAmC;AAEnC,cAAc"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,+CAA6B;AAC7B,0CAAwB;AAExB,+DAA6C;AAC7C,4CAA0B;AAC1B,gDAA8B;AAC9B,8CAA4B;AAC5B,2CAAyB;AACzB,uDAAqC;AACrC,wDAAsC;AACtC,wDAAsC;AACtC,6DAA2C;AAE3C,iCAAiC;AACjC,kEAAgD;AAEhD,qBAAqB;AACrB,iEAA+C;AAC/C,0DAAwC;AACxC,uDAAqC;AACrC,kEAAgD;AAChD,2DAAyC;AACzC,wDAAsC;AACtC,4DAA0C;AAE1C,mBAAmB;AACnB,kEAAgD;AAChD,2DAAyC;AACzC,4DAA0C;AAC1C,6DAA2C;AAC3C,gDAA8B;AAE9B,YAAY;AACZ,iDAA+B;AAC/B,yCAAuB;AAEvB,aAAa;AACb,kDAAgC;AAChC,gDAA8B;AAC9B,6CAA2B;AAC3B,mDAAiC;AACjC,iDAA+B;AAC/B,4CAA0B;AAC1B,sDAAoC;AACpC,2CAAyB;AACzB,kDAAgC;AAEhC,cAAc;AACd,4CAA0B;AAC1B,kDAAgC;AAChC,oDAAkC;AAClC,qDAAmC;AACnC,qDAAmC;AACnC,oDAAkC;AAClC,iDAA+B;AAC/B,mDAAiC;AAEjC,oBAAoB;AACpB,kDAAgC;AAChC,+CAA6B;AAE7B,kBAAkB;AAClB,mCAAmC;AAEnC,cAAc"}

package/build/events/interfaces.d.ts

@@ -21,6 +21,15 @@ export interface EventSubOptions {
     maxDeliver?: number;
     ackWait?: number;
 }
+/**
+ * Connection config consumed by the NATS wrapper. Centralised here (instead of
+ * an inline shape in `nats-wrapper.ts`) so the transport config lives beside the
+ * other event contracts.
+ */
+export interface NatsWrapperConfig {
+    servers: string[] | string;
+    clientName?: string;
+}
 export interface Event {
     subject: Subjects;
     data: any;

package/build/events/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/events/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAO,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAO,sBAAsB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IACnF,SAAS,EAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACrC,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAK,GAAG,CAAC;CACd;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,GAAG,SAAS;IACxD,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IACtB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/events/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAO,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAO,sBAAsB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IACnF,SAAS,EAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACrC,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAM,MAAM,EAAE,GAAG,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAK,GAAG,CAAC;CACd;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,GAAG,SAAS;IACxD,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IACtB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE"}

package/build/events/revocation-listener.d.ts

@@ -1,5 +1,5 @@
 import { ClientProvider } from './interfaces';
-import { NatsClientManager } from './nats-client-manager';
+import { NatsClientManager } from './transport/nats-client-manager';
 import { RevocationListenerOptions } from './types/revocation.interfaces';
 interface NatsProvider extends ClientProvider {
     readonly client: NatsClientManager;

package/build/events/revocation-listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"revocation-listener.d.ts","sourceRoot":"","sources":["../../src/events/revocation-listener.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAoB,cAAc,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAiB,uBAAuB,CAAC;AAIrE,OAAO,EAAE,yBAAyB,EAAE,MAAS,+BAA+B,CAAC;AAM7E,UAAU,YAAa,SAAQ,cAAc;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED,qBAAa,kBAAkB;IAQjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAEvB,QAAQ,EAAE,YAAY,EAAE,IAAI,GAAE,yBAA8B;IAMzF;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAQf,OAAO;IA+BrB,OAAO,CAAC,MAAM;IAkBd,yDAAyD;IACnD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAc5B"}
+{"version":3,"file":"revocation-listener.d.ts","sourceRoot":"","sources":["../../src/events/revocation-listener.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAoB,cAAc,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAiB,iCAAiC,CAAC;AAI/E,OAAO,EAAE,yBAAyB,EAAE,MAAS,+BAA+B,CAAC;AAM7E,UAAU,YAAa,SAAQ,cAAc;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED,qBAAa,kBAAkB;IAQjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAEvB,QAAQ,EAAE,YAAY,EAAE,IAAI,GAAE,yBAA8B;IAMzF;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAQf,OAAO;IA+BrB,OAAO,CAAC,MAAM;IAkBd,yDAAyD;IACnD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAc5B"}

package/build/events/transport/base-client-wrapper.d.ts

@@ -0,0 +1,44 @@
+import { ClientProvider, MsgClientInterface } from '../interfaces';
+/**
+ * Abstract base shared by every message-bus wrapper, regardless of transport.
+ *
+ * A wrapper is a lazy singleton holder for the underlying client manager: it is
+ * constructed at import time but only resolves a real client on `connect`, so
+ * publishers/listeners (and their controllers) can be built BEFORE the transport
+ * is connected without tripping the "client before connecting" guard (finding B8).
+ *
+ * By implementing {@link ClientProvider}, every concrete wrapper is a valid
+ * provider for publishers/listeners (compile-time check).
+ *
+ * Transport-specific concerns (how the client is built and connected) live in
+ * the concrete subclasses:
+ *  - `MsgWrapper`  — in-memory bus (best-effort intra-service delivery),
+ *  - `NatsWrapper` — NATS JetStream (durable inter-service delivery).
+ *
+ * @typeParam TClient  concrete client manager exposed by `client`
+ * @typeParam TConfig  transport-specific connection config accepted by `connect`
+ */
+export declare abstract class ClientWrapper<TClient extends MsgClientInterface, TConfig> implements ClientProvider {
+    private readonly label;
+    protected _client?: TClient;
+    constructor(label: string);
+    /**
+     * Resolve the client, guarding against access before `connect`. Concrete
+     * subclasses widen the return type to their client manager so callers keep
+     * access to transport-specific methods (e.g. `natsWrapper.client.createStream`).
+     */
+    get client(): TClient;
+    /**
+     * Connect the transport and populate `client`. Concrete subclasses build the
+     * client manager from their own config shape. Reconnecting an already-connected
+     * wrapper first tears down the previous client (see the concrete guard) so we
+     * never orphan a live connection.
+     */
+    abstract connect(config: TConfig): Promise<void>;
+    /**
+     * Tear down the transport. Default is a no-op so shutdown stays symmetric
+     * across wrappers; transports with a real connection (NATS) override it.
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=base-client-wrapper.d.ts.map

package/build/events/transport/base-client-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client-wrapper.d.ts","sourceRoot":"","sources":["../../../src/events/transport/base-client-wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,aAAa,CAAC,OAAO,SAAS,kBAAkB,EAAE,OAAO,CAC7E,YAAW,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEC,KAAK,EAAE,MAAM;IAE1C;;;;OAIG;IACH,IAAI,MAAM,IAAI,OAAO,CAMpB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}

package/build/events/transport/base-client-wrapper.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientWrapper = void 0;
+const nx_frame_be_1 = require("@nextage/nx-frame-be");
+/**
+ * Abstract base shared by every message-bus wrapper, regardless of transport.
+ *
+ * A wrapper is a lazy singleton holder for the underlying client manager: it is
+ * constructed at import time but only resolves a real client on `connect`, so
+ * publishers/listeners (and their controllers) can be built BEFORE the transport
+ * is connected without tripping the "client before connecting" guard (finding B8).
+ *
+ * By implementing {@link ClientProvider}, every concrete wrapper is a valid
+ * provider for publishers/listeners (compile-time check).
+ *
+ * Transport-specific concerns (how the client is built and connected) live in
+ * the concrete subclasses:
+ *  - `MsgWrapper`  — in-memory bus (best-effort intra-service delivery),
+ *  - `NatsWrapper` — NATS JetStream (durable inter-service delivery).
+ *
+ * @typeParam TClient  concrete client manager exposed by `client`
+ * @typeParam TConfig  transport-specific connection config accepted by `connect`
+ */
+class ClientWrapper {
+    constructor(label) {
+        this.label = label;
+    }
+    /**
+     * Resolve the client, guarding against access before `connect`. Concrete
+     * subclasses widen the return type to their client manager so callers keep
+     * access to transport-specific methods (e.g. `natsWrapper.client.createStream`).
+     */
+    get client() {
+        if (!this._client)
+            throw new Error(`Cannot access ${this.label} client before connecting`);
+        return this._client;
+    }
+    /**
+     * Tear down the transport. Default is a no-op so shutdown stays symmetric
+     * across wrappers; transports with a real connection (NATS) override it.
+     */
+    async disconnect() {
+        nx_frame_be_1.APP.logger.info(`📪 ${this.label} client disconnected`);
+    }
+}
+exports.ClientWrapper = ClientWrapper;
+//# sourceMappingURL=base-client-wrapper.js.map

package/build/events/transport/base-client-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client-wrapper.js","sourceRoot":"","sources":["../../../src/events/transport/base-client-wrapper.ts"],"names":[],"mappings":";;;AAAA,sDAAsE;AAGtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAsB,aAAa;IAKjC,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C;;;;OAIG;IACH,IAAI,MAAM;QAER,IAAI,CAAC,IAAI,CAAC,OAAO;YACf,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,KAAK,2BAA2B,CAAC,CAAC;QAE1E,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAUD;;;OAGG;IACH,KAAK,CAAC,UAAU;QAEd,iBAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,sBAAsB,CAAC,CAAC;IAC1D,CAAC;CACF;AApCD,sCAoCC"}

package/build/events/transport/msg-client-manager.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from 'node:events';
+import { NxObject, NxTypeObject } from '@nextage/nx-frame-be';
+import { EventSubscription } from '../event-subscription';
+import { MsgClientInterface, EventSubOptions } from '../interfaces';
+export declare class MsgClientManager extends EventEmitter implements MsgClientInterface {
+    subs: NxTypeObject<EventSubscription[]>;
+    private readonly clientId?;
+    constructor(clientId?: string);
+    /**
+     * No real connection to establish for the in-memory bus; logs readiness so the
+     * transport lifecycle stays symmetric with the NATS client.
+     */
+    connect(): Promise<void>;
+    /**
+     * Register a subscription for `subject` and return it so the caller can attach a
+     * `message` handler.
+     *
+     * @param subject         subject to listen on
+     * @param queueGroupName  optional group label (informational for the in-memory bus)
+     * @param options         optional `maxDeliver` / `ackWait` (unused in-memory)
+     */
+    subscribe(subject: string, queueGroupName?: string, options?: EventSubOptions): EventSubscription;
+    /**
+     * Fan out `data` to every subscriber of `subject`; a no-op (with a log) when
+     * there is no subscription — the in-memory bus is best-effort.
+     */
+    publish(subject: string, data: string | Uint8Array<ArrayBufferLike>, options?: NxObject): Promise<void>;
+    /**
+     * Detach `cb` from `sub` and drop it from the subscription list.
+     */
+    unsubscribe(sub: EventSubscription, cb?: (...args: any[]) => void): void;
+    /**
+     * Return the subscription list for `subject`, throwing if none exists.
+     */
+    private getSubscriptions;
+}
+//# sourceMappingURL=msg-client-manager.d.ts.map

package/build/events/transport/msg-client-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-client-manager.d.ts","sourceRoot":"","sources":["../../../src/events/transport/msg-client-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAkC,aAAa,CAAC;AACvE,OAAO,EAAoB,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAA6B,uBAAuB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAW,eAAe,CAAC;AAEzE,qBAAa,gBAAiB,SAAQ,YAAa,YAAW,kBAAkB;IAE9E,IAAI,EAAE,YAAY,CAAC,iBAAiB,EAAE,CAAC,CAAM;IAE7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,QAAQ,CAAC,EAAE,MAAM;IAM7B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB;IAWjG;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7G;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,iBAAiB,EAAE,EAAE,GAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAe,GAAG,IAAI;IAWlF;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}