@nextage/era-lib 1.0.186 → 1.0.188

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

@@ -1,8 +1,20 @@
 import { Subjects } from './types/enums';
 import { EventMeta } from './types/event-envelope.interfaces';
 import { NxObject } from '@nextage/nx-frame-be';
+/**
+ * Minimal transport contract shared by both message-bus clients
+ * (`MsgClientManager` in-memory, `NatsClientManager` JetStream).
+ *
+ * `publish` is uniform across transports. `subscribe`/`unsubscribe` are
+ * **intentionally loose** (`any`): the two transports take genuinely different
+ * arguments — NATS `subscribe(subject, streamName, queueGroupName, opts)` →
+ * `Consumer` and `unsubscribe(subject, streamName, queueGroupName)`; the
+ * in-memory bus `subscribe(subject, queueGroupName?, opts)` → `EventSubscription`
+ * and `unsubscribe(sub)`. Each concrete listener (`NatsListener` / `MsgListener`)
+ * already knows its transport and calls the matching shape.
+ */
 export interface MsgClientInterface {
-    publish: (subject: string, payload: string, options?: NxObject) => Promise<any>;
+    publish: (subject: string, payload: string, options?: NxObject) => Promise<void>;
     subscribe: (...args: any[]) => any;
     unsubscribe: (...args: any[]) => any;
 }
@@ -21,6 +33,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;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,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"}

package/build/events/{msg-client-manager.js → transport/msg-client-manager.js}

@@ -1,29 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MsgClientManager = void 0;
-const ws_1 = require("ws");
+const node_events_1 = require("node:events");
 const nx_frame_be_1 = require("@nextage/nx-frame-be");
-const event_message_1 = require("./event-message");
-const event_subscription_1 = require("./event-subscription");
-class MsgClientManager extends ws_1.EventEmitter {
-    constructor(clientId, opts) {
+const event_message_1 = require("../event-message");
+const event_subscription_1 = require("../event-subscription");
+class MsgClientManager extends node_events_1.EventEmitter {
+    constructor(clientId) {
         super();
         this.subs = {};
-        this.opts = {};
         this.clientId = clientId;
-        this.opts = opts ?? {};
     }
     /**
-     *
+     * No real connection to establish for the in-memory bus; logs readiness so the
+     * transport lifecycle stays symmetric with the NATS client.
      */
     async connect() {
         nx_frame_be_1.APP.logger.info(`✅ Connected to Event Client Manager`);
-        //setTimeout(() => this.emit('connect', true), 500);
     }
     /**
+     * Register a subscription for `subject` and return it so the caller can attach a
+     * `message` handler.
      *
-     * @param {*} key
-     * @param {*} method
+     * @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, queueGroupName, options) {
         var _a;
@@ -34,17 +35,14 @@ class MsgClientManager extends ws_1.EventEmitter {
         return sub;
     }
     /**
-     *
-     * @param {*} key
-     * @param {*} data
+     * 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.
      */
     async publish(subject, data, options) {
         if (!this.subs[subject]) {
             nx_frame_be_1.APP.logger.info(`❌ Data won't be published, no subscription for subject: ${subject}`, (0, nx_frame_be_1.logClassCtx)(this));
             return;
         }
-        //throw new Error('MsgClientManager : subject does not exist');
-        //this.subs[subject] ??= [];
         this.subs[subject].forEach(sub => {
             const message = new event_message_1.Message(data);
             sub.emit('message', message);
@@ -52,36 +50,17 @@ class MsgClientManager extends ws_1.EventEmitter {
         });
     }
     /**
-     *
-     * @param {*} id
+     * Detach `cb` from `sub` and drop it from the subscription list.
      */
     unsubscribe(sub, cb = () => { }) {
         sub.off('message', cb);
-        const subs = this.getSubscriptions(sub.subject) || [];
-        const idx = this.getSubscriptions(sub.subject).findIndex(s => s.id === sub.id);
+        const subs = this.getSubscriptions(sub.subject);
+        const idx = subs.findIndex(s => s.id === sub.id);
         if (idx >= 0)
             subs.splice(idx, 1);
     }
-    // /**
-    //  * 
-    //  * @param data 
-    //  * @returns 
-    //  */
-    // encodeData(data: string): string | Uint8Array {
-    //   return data;
-    // }
-    // /**
-    //  * 
-    //  * @param data 
-    //  * @returns 
-    //  */
-    // decodeData(data: string | Uint8Array): string {
-    //   return data as string;
-    // }
     /**
-     *
-     * @param sub
-     * @returns
+     * Return the subscription list for `subject`, throwing if none exists.
      */
     getSubscriptions(subject) {
         if (!this.subs[subject])

package/build/events/transport/msg-client-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-client-manager.js","sourceRoot":"","sources":["../../../src/events/transport/msg-client-manager.ts"],"names":[],"mappings":";;;AAAA,6CAAuE;AACvE,sDAAgF;AAChF,oDAA4E;AAC5E,8DAAiF;AAGjF,MAAa,gBAAiB,SAAQ,0BAAY;IAMhD,YAAY,QAAiB;QAE3B,KAAK,EAAE,CAAC;QANV,SAAI,GAAsC,EAAE,CAAC;QAO3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QAEX,iBAAG,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,OAAe,EAAE,cAAuB,EAAE,OAAyB;;QAE3E,MAAM,GAAG,GAAG,IAAI,sCAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QAEpE,MAAA,IAAI,CAAC,IAAI,EAAC,OAAO,SAAP,OAAO,IAAM,EAAE,EAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE7B,iBAAG,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,OAAO,MAAM,cAAc,EAAE,EAAE,IAAA,yBAAW,EAAC,IAAI,CAAC,CAAC,CAAC;QACzF,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,IAA0C,EAAE,OAAkB;QAE3F,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAExB,iBAAG,CAAC,MAAM,CAAC,IAAI,CAAC,2DAA2D,OAAO,EAAE,EAAE,IAAA,yBAAW,EAAC,IAAI,CAAC,CAAC,CAAC;YACzG,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAE/B,MAAM,OAAO,GAAG,IAAI,uBAAO,CAAC,IAAI,CAAC,CAAC;YAClC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAE7B,iBAAG,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,OAAO,EAAE,EAAE,IAAA,yBAAW,EAAC,IAAI,CAAC,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,GAAsB,EAAE,KAA+B,GAAG,EAAE,GAAE,CAAC;QAEzE,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,GAAG,GAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAElD,IAAI,GAAG,IAAI,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAe;QAEtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAE/D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;CACF;AArFD,4CAqFC"}

package/build/events/transport/msg-wrapper.d.ts

@@ -0,0 +1,15 @@
+import { AppMessages } from '@nextage/nx-frame-be';
+import { MsgClientManager } from './msg-client-manager';
+import { ClientWrapper } from './base-client-wrapper';
+/**
+ * In-memory message bus wrapper. Emulates a queue client (NATS) for best-effort
+ * intra-service delivery, so publishers/listeners share the same contract across
+ * transports.
+ */
+declare class MsgWrapper extends ClientWrapper<MsgClientManager, AppMessages> {
+    constructor();
+    connect({ clientId }?: AppMessages): Promise<void>;
+}
+export declare const msgWrapper: MsgWrapper;
+export {};
+//# sourceMappingURL=msg-wrapper.d.ts.map

package/build/events/transport/msg-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-wrapper.d.ts","sourceRoot":"","sources":["../../../src/events/transport/msg-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAU,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAS,uBAAuB,CAAC;AAEzD;;;;GAIG;AACH,cAAM,UAAW,SAAQ,aAAa,CAAC,gBAAgB,EAAE,WAAW,CAAC;;IAO7D,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAU7D;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/build/events/transport/msg-wrapper.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.msgWrapper = void 0;
+const msg_client_manager_1 = require("./msg-client-manager");
+const base_client_wrapper_1 = require("./base-client-wrapper");
+/**
+ * In-memory message bus wrapper. Emulates a queue client (NATS) for best-effort
+ * intra-service delivery, so publishers/listeners share the same contract across
+ * transports.
+ */
+class MsgWrapper extends base_client_wrapper_1.ClientWrapper {
+    constructor() {
+        super('Event');
+    }
+    async connect({ clientId } = {}) {
+        // Reconnect guard: tear down a previous client before replacing it.
+        if (this._client)
+            await this.disconnect();
+        this._client = new msg_client_manager_1.MsgClientManager(clientId);
+        await this._client.connect();
+    }
+}
+exports.msgWrapper = new MsgWrapper();
+//# sourceMappingURL=msg-wrapper.js.map