@nextage/era-lib 1.0.184 → 1.0.186

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

@@ -1,49 +1,79 @@
 import { NxContext } from '@nextage/nx-frame-be';
-import { Message } from './event-message';
-import { ClientProvider, Event, EventSubOptions } from './interfaces';
+import { Event } from './interfaces';
 import { EventContext, IncomingEventRef } from './types/event-envelope.interfaces';
+import { SyncRefArrayCtrl, SyncRefArrayParams } from './base-listener.interfaces';
+/**
+ * Abstract base shared by every listener, regardless of transport.
+ *
+ * It owns the transport-agnostic concerns:
+ *  - identity (`subject` / `queueGroupName`) and the in-flight event reference,
+ *  - cascade-context propagation (`nextContext`),
+ *  - standardized structured logging (`logReceived` / `logUpdateResult`),
+ *  - the shared "mirror" denormalization helper (`syncRefArray`).
+ *
+ * Transport-specific concerns (subscription lifecycle, ack/nak/DLQ, the
+ * `onMessage` signature) live in the concrete subclasses:
+ *  - `MsgListener`  — in-memory, best-effort intra-service delivery,
+ *  - `NatsListener` — durable inter-service delivery (JetStream) with retry/DLQ.
+ */
 export declare abstract class Listener<T extends Event> {
     abstract subject: T['subject'];
     abstract queueGroupName: string;
-    abstract onMessage(data: T['data'], msg: Message): Promise<void>;
-    private readonly provider;
-    private subscription;
-    private messageStack;
-    private wait;
     protected _incoming: IncomingEventRef | undefined;
-    protected ackWait: number;
-    constructor(provider: ClientProvider);
-    private get client();
-    subscriptionOptions(): EventSubOptions;
-    listen(): Promise<void>;
     /**
-     *
-     * @returns
+     * Short transport tag used as the log line prefix (`MEM` / `NATS`). Overridden
+     * by the concrete subclass so a log line tells at a glance which bus it came from.
      */
-    checkMessages(): Promise<void>;
+    protected transportNameForLog(): string;
     /**
-     * Process a single message: unwrap the envelope, apply the cascade loop-guard,
-     * then dispatch to `onMessage`. A guard violation (runaway depth or revisited
-     * subject) is skipped — the in-memory bus has no ack/redelivery to fight — and
-     * the in-flight reference is always cleared so `nextContext` never leaks the
-     * previous event.
+     * Durable-stream name for the log line/context, when the transport has one
+     * (JetStream). In-memory listeners have no stream, so this is `undefined`.
      */
-    protected handleMessage(msg: Message): Promise<void>;
+    protected streamNameForLog(): string | undefined;
     /**
-     * Build a child context carrying the in-flight event reference, so any event
-     * this listener republishes inherits the correlation and advances the cascade
-     * depth / visited lineage. Returns a fresh object (never mutates `base`).
+     * Base structured logging context (class + method + arbitrary extra fields),
+     * so log aggregators can filter by `eventSubject`, `eventId`, `modelName`, etc.
      */
-    protected nextContext(base?: NxContext): EventContext;
+    protected loggerCtx(method?: string, data?: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Standardized "event received" log, shared by every listener. Emits both a
+     * human-readable line and a structured context payload.
+     */
+    protected logReceived(data: {
+        id?: string;
+        code?: string;
+    }, method?: string): void;
+    /**
+     * Standardized "mutation result" log, shared by every listener. Reports how many
+     * items a denormalization touched, split by action (created / updated / deleted),
+     * plus any extra structured fields (tenantId, assetId, ...) so aggregators can
+     * query them instead of parsing the message. Only the actions actually provided
+     * in `counts` appear in the human-readable line; a run that touched nothing logs
+     * a single "no <model> changed" line.
+     */
+    protected logMutationResult(modelName: string, dataId: string | undefined, counts: {
+        created?: number;
+        updated?: number;
+        deleted?: number;
+    }, method?: string, extra?: Record<string, unknown>): void;
+    /**
+     * Update-only sugar over `logMutationResult`, kept because the guarded "mirror"
+     * denormalization (`syncRefArray`) and most listeners only ever update copies.
+     */
+    protected logUpdateResult(modelName: string, dataId: string | undefined, updateCount: number, method?: string): void;
     /**
-     *
+     * Shared "mirror" denormalization strategy: update the copies of an entity that
+     * live embedded in the `arrayPath` array of many documents, guarded by the
+     * nested item version so a stale event never overwrites a newer copy.
+     * Returns the number of documents actually modified.
      */
-    stop(): Promise<void>;
+    protected syncRefArray(ctrl: SyncRefArrayCtrl, params: SyncRefArrayParams): Promise<number>;
     /**
-     *
-     * @param msg
-     * @returns
+     * Build a child context carrying the in-flight event reference, so any event
+     * this listener republishes inherits the correlation and advances the cascade
+     * depth / visited lineage. Returns a fresh object (never mutates `base`). At the
+     * root — or when no event is in flight — it is just a copy of `base`.
      */
-    private parseMessage;
+    protected nextContext(base?: NxContext): EventContext;
 }
 //# sourceMappingURL=base-listener.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"base-listener.d.ts","sourceRoot":"","sources":["../../src/events/base-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,MAAqC,sBAAsB,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,MAAyD,iBAAiB,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,KAAK,EAAsB,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAkC,mCAAmC,CAAC;AAG/G,8BAAsB,QAAQ,CAAC,CAAC,SAAS,KAAK;IAE5C,QAAQ,CAAC,OAAO,EAAS,CAAC,CAAC,SAAS,CAAC,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,YAAY,CAAmC;IAEvD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,IAAI,CAA+B;IAI3C,SAAS,CAAC,SAAS,EAAM,gBAAgB,GAAG,SAAS,CAAC;IAEtD,SAAS,CAAC,OAAO,EAAQ,MAAM,CAAe;gBAEjC,QAAQ,EAAE,cAAc;IAMrC,OAAO,KAAK,MAAM,GAEjB;IAED,mBAAmB,IAAI,eAAe;IAKhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB7B;;;OAGG;IACG,aAAa;IAsBnB;;;;;;OAMG;cACa,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1D;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,GAAE,SAAc,GAAG,YAAY;IAKzD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAKrB"}
+{"version":3,"file":"base-listener.d.ts","sourceRoot":"","sources":["../../src/events/base-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,MAAmB,sBAAsB,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,MAA0C,cAAc,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAiB,mCAAmC,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAW,4BAA4B,CAAC;AAEvF;;;;;;;;;;;;;GAaG;AACH,8BAAsB,QAAQ,CAAC,CAAC,SAAS,KAAK;IAE5C,QAAQ,CAAC,OAAO,EAAS,CAAC,CAAC,SAAS,CAAC,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAKhC,SAAS,CAAC,SAAS,EAAM,gBAAgB,GAAG,SAAS,CAAC;IAEtD;;;OAGG;IACH,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAKvC;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAKhD;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKjG;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBlF;;;;;;;OAOG;IACH,SAAS,CAAC,iBAAiB,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAK,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAK;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EACnE,MAAM,CAAC,EAAI,MAAM,EACjB,KAAK,GAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACtC,IAAI;IA8BP;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpH;;;;;OAKG;cACa,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBjG;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,GAAE,SAAc,GAAG,YAAY;CAI1D"}

package/build/events/base-listener.interfaces.d.ts

@@ -0,0 +1,23 @@
+export interface SyncRefArrayResult {
+    modifiedCount?: number;
+}
+export interface SyncRefArrayModel {
+    name: string;
+    updateArrayItemManyNative(filter: Record<string, unknown>, update: {
+        arrayPath: string;
+        arrayFilter: Record<string, unknown>;
+        item: Record<string, unknown>;
+    }, options: Record<string, unknown>): Promise<SyncRefArrayResult>;
+}
+export interface SyncRefArrayCtrl {
+    model: SyncRefArrayModel;
+}
+export interface SyncRefArrayParams {
+    arrayPath: string;
+    itemId: string;
+    version: number;
+    item: Record<string, unknown>;
+    filter?: Record<string, unknown>;
+    method?: string;
+}
+//# sourceMappingURL=base-listener.interfaces.d.ts.map

package/build/events/base-listener.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-listener.interfaces.d.ts","sourceRoot":"","sources":["../../src/events/base-listener.interfaces.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IAEjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAEhC,IAAI,EAAE,MAAM,CAAC;IAEb,yBAAyB,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE;QACN,SAAS,EAAI,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,EAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,EACD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAE/B,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAEjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAK,MAAM,CAAC;IAClB,OAAO,EAAI,MAAM,CAAC;IAClB,IAAI,EAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAI,MAAM,CAAC;CACnB"}

package/build/events/base-listener.interfaces.js

@@ -0,0 +1,10 @@
+"use strict";
+// ────────────────────────────────────────────────────────────────────────────
+// Shared typings for the listener base class (`Listener`).
+//
+// These describe the minimal surface the denormalization helpers rely on, so the
+// base can stay transport-agnostic and free of `any`. They intentionally model
+// only what `syncRefArray` needs from a controller/model, not the full BaseModel.
+// ────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-listener.interfaces.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-listener.interfaces.js","sourceRoot":"","sources":["../../src/events/base-listener.interfaces.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,kFAAkF;AAClF,+EAA+E"}

package/build/events/base-listener.js

@@ -2,97 +2,125 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Listener = void 0;
 const nx_frame_be_1 = require("@nextage/nx-frame-be");
-const cascade_1 = require("./cascade");
+/**
+ * Abstract base shared by every listener, regardless of transport.
+ *
+ * It owns the transport-agnostic concerns:
+ *  - identity (`subject` / `queueGroupName`) and the in-flight event reference,
+ *  - cascade-context propagation (`nextContext`),
+ *  - standardized structured logging (`logReceived` / `logUpdateResult`),
+ *  - the shared "mirror" denormalization helper (`syncRefArray`).
+ *
+ * Transport-specific concerns (subscription lifecycle, ack/nak/DLQ, the
+ * `onMessage` signature) live in the concrete subclasses:
+ *  - `MsgListener`  — in-memory, best-effort intra-service delivery,
+ *  - `NatsListener` — durable inter-service delivery (JetStream) with retry/DLQ.
+ */
 class Listener {
-    constructor(provider) {
-        this.messageStack = [];
-        this.wait = false;
-        this.ackWait = 5 * 1000;
-        this.provider = provider;
-    }
-    // Resolve the client only at listen/stop time, so the transport may be
-    // connected AFTER this listener is constructed (finding B8).
-    get client() {
-        return this.provider.client;
+    /**
+     * Short transport tag used as the log line prefix (`MEM` / `NATS`). Overridden
+     * by the concrete subclass so a log line tells at a glance which bus it came from.
+     */
+    transportNameForLog() {
+        return 'MSG';
     }
-    subscriptionOptions() {
-        return {};
+    /**
+     * Durable-stream name for the log line/context, when the transport has one
+     * (JetStream). In-memory listeners have no stream, so this is `undefined`.
+     */
+    streamNameForLog() {
+        return undefined;
     }
-    async listen() {
-        this.subscription = await this.client.subscribe(this.subject, this.queueGroupName, this.subscriptionOptions());
-        this.subscription?.on('message', (msg) => {
-            nx_frame_be_1.APP.logger.info(`📥 Received message on: ${this.subject} / ${this.queueGroupName}`, (0, nx_frame_be_1.logClassCtx)(this));
-            this.messageStack.push(msg);
-            this.checkMessages();
-            // const parsedData = this.parseMessage(msg);
-            // this.onMessage(parsedData, msg);
-        });
+    /**
+     * Base structured logging context (class + method + arbitrary extra fields),
+     * so log aggregators can filter by `eventSubject`, `eventId`, `modelName`, etc.
+     */
+    loggerCtx(method, data = {}) {
+        return { ...((0, nx_frame_be_1.logClassCtx)(this, method) ?? {}), ...data };
     }
     /**
-     *
-     * @returns
+     * Standardized "event received" log, shared by every listener. Emits both a
+     * human-readable line and a structured context payload.
      */
-    async checkMessages() {
-        if (this.wait || !this.messageStack.length)
-            return;
-        const msg = this.messageStack.shift();
-        if (!msg)
-            return;
-        this.wait = true;
-        try {
-            await this.handleMessage(msg);
-        }
-        finally {
-            this.wait = false;
-        }
-        await this.checkMessages();
+    logReceived(data, method) {
+        const stream = this.streamNameForLog();
+        nx_frame_be_1.APP.logger.info(`${this.transportNameForLog()} ${this.subject} ${this.queueGroupName}${stream ? ` ${stream}` : ''} - received event ${data?.id ?? '?'} ${data?.code ?? ''}`.trimEnd(), this.loggerCtx(method, {
+            event: 'received',
+            eventId: data?.id,
+            eventCode: data?.code,
+            eventSubject: this.subject,
+            queueGroupName: this.queueGroupName,
+            streamName: stream,
+        }));
     }
     /**
-     * Process a single message: unwrap the envelope, apply the cascade loop-guard,
-     * then dispatch to `onMessage`. A guard violation (runaway depth or revisited
-     * subject) is skipped — the in-memory bus has no ack/redelivery to fight — and
-     * the in-flight reference is always cleared so `nextContext` never leaks the
-     * previous event.
+     * Standardized "mutation result" log, shared by every listener. Reports how many
+     * items a denormalization touched, split by action (created / updated / deleted),
+     * plus any extra structured fields (tenantId, assetId, ...) so aggregators can
+     * query them instead of parsing the message. Only the actions actually provided
+     * in `counts` appear in the human-readable line; a run that touched nothing logs
+     * a single "no <model> changed" line.
      */
-    async handleMessage(msg) {
-        try {
-            const { id, data, meta } = (0, cascade_1.unwrapEnvelope)(this.parseMessage(msg));
-            const violation = (0, cascade_1.cascadeViolation)(meta, this.subject);
-            if (violation) {
-                nx_frame_be_1.APP.logger.warn(`🔁 Cascade guard tripped on '${this.subject}': ${violation}`, (0, nx_frame_be_1.logClassCtx)(this));
-            }
-            else {
-                this._incoming = { id, subject: this.subject, meta };
-                await this.onMessage(data, msg);
-            }
-        }
-        finally {
-            this._incoming = undefined;
-        }
+    logMutationResult(modelName, dataId, counts, method, extra = {}) {
+        const created = counts.created ?? 0;
+        const updated = counts.updated ?? 0;
+        const deleted = counts.deleted ?? 0;
+        const total = created + updated + deleted;
+        const parts = [];
+        if (counts.created !== undefined)
+            parts.push(`created ${created}`);
+        if (counts.updated !== undefined)
+            parts.push(`updated ${updated}`);
+        if (counts.deleted !== undefined)
+            parts.push(`deleted ${deleted}`);
+        const line = total === 0
+            ? `${this.subject} - no ${modelName} changed (item ${dataId ?? '?'} not found or already up to date)`
+            : `${this.subject} - ${parts.join(', ')} ${modelName} item(s)`;
+        nx_frame_be_1.APP.logger.info(line, this.loggerCtx(method, {
+            event: 'mutation-result',
+            eventId: dataId,
+            eventSubject: this.subject,
+            queueGroupName: this.queueGroupName,
+            streamName: this.streamNameForLog(),
+            modelName,
+            created,
+            updated,
+            deleted,
+            ...extra,
+        }));
     }
     /**
-     * Build a child context carrying the in-flight event reference, so any event
-     * this listener republishes inherits the correlation and advances the cascade
-     * depth / visited lineage. Returns a fresh object (never mutates `base`).
+     * Update-only sugar over `logMutationResult`, kept because the guarded "mirror"
+     * denormalization (`syncRefArray`) and most listeners only ever update copies.
      */
-    nextContext(base = {}) {
-        return this._incoming ? { ...base, _event: this._incoming } : { ...base };
+    logUpdateResult(modelName, dataId, updateCount, method) {
+        this.logMutationResult(modelName, dataId, { updated: updateCount }, method);
     }
     /**
-     *
+     * Shared "mirror" denormalization strategy: update the copies of an entity that
+     * live embedded in the `arrayPath` array of many documents, guarded by the
+     * nested item version so a stale event never overwrites a newer copy.
+     * Returns the number of documents actually modified.
      */
-    async stop() {
-        if (this.subscription)
-            this.client.unsubscribe(this.subscription);
+    async syncRefArray(ctrl, params) {
+        const model = ctrl.model;
+        const res = await model.updateArrayItemManyNative(params.filter ?? {}, {
+            arrayPath: params.arrayPath,
+            arrayFilter: { id: params.itemId, version: { $lt: params.version } },
+            item: params.item
+        }, {});
+        const updateCount = res.modifiedCount ?? 0;
+        this.logUpdateResult(model.name, params.itemId, updateCount, params.method);
+        return updateCount;
     }
     /**
-     *
-     * @param msg
-     * @returns
+     * Build a child context carrying the in-flight event reference, so any event
+     * this listener republishes inherits the correlation and advances the cascade
+     * depth / visited lineage. Returns a fresh object (never mutates `base`). At the
+     * root — or when no event is in flight — it is just a copy of `base`.
      */
-    parseMessage(msg) {
-        const data = msg.getData();
-        return typeof data === 'string' ? JSON.parse(data) : JSON.parse(data.toString('utf8'));
+    nextContext(base = {}) {
+        return this._incoming ? { ...base, _event: this._incoming } : { ...base };
     }
 }
 exports.Listener = Listener;

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

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

package/build/events/base-msg-listener.d.ts

@@ -0,0 +1,46 @@
+import { Message } from './event-message';
+import { ClientProvider, Event, EventSubOptions } from './interfaces';
+import { Listener } from './base-listener';
+/**
+ * In-memory listener: best-effort intra-service dispatch over the in-process
+ * message bus. No broker ack/nak/DLQ — a cascade-guard violation is simply
+ * skipped (there is no redelivery to fight). Use `NatsListener` for durable,
+ * inter-service delivery with retry/DLQ semantics.
+ */
+export declare abstract class MsgListener<T extends Event> extends Listener<T> {
+    abstract onMessage(data: T['data'], msg: Message): Promise<void>;
+    private readonly provider;
+    private subscription;
+    private messageStack;
+    private wait;
+    protected ackWait: number;
+    constructor(provider: ClientProvider);
+    protected transportNameForLog(): string;
+    private get client();
+    subscriptionOptions(): EventSubOptions;
+    listen(): Promise<void>;
+    /**
+     *
+     * @returns
+     */
+    checkMessages(): Promise<void>;
+    /**
+     * Process a single message: unwrap the envelope, apply the cascade loop-guard,
+     * then dispatch to `onMessage`. A guard violation (runaway depth or revisited
+     * subject) is skipped — the in-memory bus has no ack/redelivery to fight — and
+     * the in-flight reference is always cleared so `nextContext` never leaks the
+     * previous event.
+     */
+    protected handleMessage(msg: Message): Promise<void>;
+    /**
+     *
+     */
+    stop(): Promise<void>;
+    /**
+     *
+     * @param msg
+     * @returns
+     */
+    private parseMessage;
+}
+//# sourceMappingURL=base-msg-listener.d.ts.map

package/build/events/base-msg-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-msg-listener.d.ts","sourceRoot":"","sources":["../../src/events/base-msg-listener.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAyD,iBAAiB,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,KAAK,EAAsB,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAwD,iBAAiB,CAAC;AAG7F;;;;;GAKG;AACH,8BAAsB,WAAW,CAAC,CAAC,SAAS,KAAK,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAEpE,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,YAAY,CAAqC;IAEzD,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,IAAI,CAAiC;IAE7C,SAAS,CAAC,OAAO,EAAU,MAAM,CAAe;gBAEnC,QAAQ,EAAE,cAAc;cAMlB,mBAAmB,IAAI,MAAM;IAOhD,OAAO,KAAK,MAAM,GAGjB;IAED,mBAAmB,IAAI,eAAe;IAKhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB7B;;;OAGG;IACG,aAAa;IAsBnB;;;;;;OAMG;cACa,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAKrB"}

package/build/events/base-msg-listener.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MsgListener = void 0;
+const nx_frame_be_1 = require("@nextage/nx-frame-be");
+const base_listener_1 = require("./base-listener");
+const cascade_1 = require("./cascade");
+/**
+ * In-memory listener: best-effort intra-service dispatch over the in-process
+ * message bus. No broker ack/nak/DLQ — a cascade-guard violation is simply
+ * skipped (there is no redelivery to fight). Use `NatsListener` for durable,
+ * inter-service delivery with retry/DLQ semantics.
+ */
+class MsgListener extends base_listener_1.Listener {
+    constructor(provider) {
+        super();
+        this.messageStack = [];
+        this.wait = false;
+        this.ackWait = 5 * 1000;
+        this.provider = provider;
+    }
+    transportNameForLog() {
+        return 'MEM';
+    }
+    // Resolve the client only at listen/stop time, so the transport may be
+    // connected AFTER this listener is constructed (finding B8).
+    get client() {
+        return this.provider.client;
+    }
+    subscriptionOptions() {
+        return {};
+    }
+    async listen() {
+        this.subscription = await this.client.subscribe(this.subject, this.queueGroupName, this.subscriptionOptions());
+        this.subscription?.on('message', (msg) => {
+            nx_frame_be_1.APP.logger.info(`📥 Received message on: ${this.subject} / ${this.queueGroupName}`, (0, nx_frame_be_1.logClassCtx)(this));
+            this.messageStack.push(msg);
+            this.checkMessages();
+        });
+    }
+    /**
+     *
+     * @returns
+     */
+    async checkMessages() {
+        if (this.wait || !this.messageStack.length)
+            return;
+        const msg = this.messageStack.shift();
+        if (!msg)
+            return;
+        this.wait = true;
+        try {
+            await this.handleMessage(msg);
+        }
+        finally {
+            this.wait = false;
+        }
+        await this.checkMessages();
+    }
+    /**
+     * Process a single message: unwrap the envelope, apply the cascade loop-guard,
+     * then dispatch to `onMessage`. A guard violation (runaway depth or revisited
+     * subject) is skipped — the in-memory bus has no ack/redelivery to fight — and
+     * the in-flight reference is always cleared so `nextContext` never leaks the
+     * previous event.
+     */
+    async handleMessage(msg) {
+        try {
+            const { id, data, meta } = (0, cascade_1.unwrapEnvelope)(this.parseMessage(msg));
+            const violation = (0, cascade_1.cascadeViolation)(meta, this.subject);
+            if (violation) {
+                nx_frame_be_1.APP.logger.warn(`🔁 Cascade guard tripped on '${this.subject}': ${violation}`, (0, nx_frame_be_1.logClassCtx)(this));
+            }
+            else {
+                this._incoming = { id, subject: this.subject, meta };
+                await this.onMessage(data, msg);
+            }
+        }
+        finally {
+            this._incoming = undefined;
+        }
+    }
+    /**
+     *
+     */
+    async stop() {
+        if (this.subscription)
+            this.client.unsubscribe(this.subscription);
+    }
+    /**
+     *
+     * @param msg
+     * @returns
+     */
+    parseMessage(msg) {
+        const data = msg.getData();
+        return typeof data === 'string' ? JSON.parse(data) : JSON.parse(data.toString('utf8'));
+    }
+}
+exports.MsgListener = MsgListener;
+//# sourceMappingURL=base-msg-listener.js.map

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

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

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

@@ -1,20 +1,22 @@
-import { NxContext } from '@nextage/nx-frame-be';
 import { ClientProvider, Event, EventSubOptions } from './interfaces';
-import { EventContext, IncomingEventRef } from './types/event-envelope.interfaces';
+import { Listener } from './base-listener';
 import { JsMsg } from 'nats';
-export declare abstract class NatsListener<T extends Event> {
+/**
+ * Durable inter-service listener (JetStream): owns the per-message ack/nak/term
+ * and DLQ policy. Keep `onMessage` idempotent so redelivery is always safe.
+ */
+export declare abstract class NatsListener<T extends Event> extends Listener<T> {
     private readonly provider;
-    abstract subject: T['subject'];
-    abstract queueGroupName: string;
     abstract streamName: string;
     private consumer?;
     private isListening;
-    protected _incoming?: IncomingEventRef;
     protected ackWait: number;
     protected maxDeliver: number;
     protected nakBackoffMs: number[];
     abstract onMessage(data: T['data'], msg: JsMsg): Promise<void>;
     constructor(provider: ClientProvider);
+    protected transportNameForLog(): string;
+    protected streamNameForLog(): string | undefined;
     private get client();
     /**
      *
@@ -47,14 +49,6 @@ export declare abstract class NatsListener<T extends Event> {
      * unreachable, so a loop is never silently lost.
      */
     protected dropCascadeViolation(msg: JsMsg, reason: string): Promise<void>;
-    /**
-     * Build a child context carrying the in-flight event reference, so any event
-     * this listener republishes inherits the correlation, is marked as caused by
-     * the current event, and advances the cascade depth / visited lineage. Returns
-     * a fresh object (never mutates the shared base context). At the root — or when
-     * no event is in flight — it is just a copy of `base`.
-     */
-    protected nextContext(base?: NxContext): EventContext;
     /**
      * Parks a failed message on the DLQ stream. Returns `true` on success so the
      * caller can safely `term()` the original; returns `false` if the DLQ could

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

@@ -1 +1 @@
-{"version":3,"file":"base-nats-listener.d.ts","sourceRoot":"","sources":["../../src/events/base-nats-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,SAAS,EAAE,MAAkD,sBAAsB,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,KAAK,EAAsB,eAAe,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAkC,mCAAmC,CAAC;AAE/G,OAAO,EAAY,KAAK,EAAE,MAAiD,MAAM,CAAC;AAElF,8BAAsB,YAAY,CAAC,CAAC,SAAS,KAAK;IA2BnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAzBtC,QAAQ,CAAC,OAAO,EAAS,CAAC,CAAC,SAAS,CAAC,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAM,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,WAAW,CAAsB;IAMzC,SAAS,CAAC,SAAS,CAAC,EAAK,gBAAgB,CAAC;IAE1C,SAAS,CAAC,OAAO,EAAQ,MAAM,CAAuB;IACtD,SAAS,CAAC,UAAU,EAAK,MAAM,CAAK;IAMpC,SAAS,CAAC,YAAY,EAAG,MAAM,EAAE,CAAuB;IAGxD,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;gBAEhC,QAAQ,EAAE,cAAc;IAItD,OAAO,KAAK,MAAM,GAGjB;IAED;;;OAGG;IACH,mBAAmB,IAAI,eAAe;IAKtC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB7B;;;;OAIG;YACW,eAAe;IAqB7B;;;;;;;;OAQG;cACa,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDxD;;;;OAIG;cACa,oBAAoB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/E;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,GAAE,SAAc,GAAG,YAAY;IAKzD;;;;OAIG;cACa,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB9E;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAKd;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAYrB"}
+{"version":3,"file":"base-nats-listener.d.ts","sourceRoot":"","sources":["../../src/events/base-nats-listener.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,EAAsB,eAAe,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAE,QAAQ,EAAE,MAAwD,iBAAiB,CAAC;AAE7F,OAAO,EAAY,KAAK,EAAE,MAAiD,MAAM,CAAC;AAElF;;;GAGG;AACH,8BAAsB,YAAY,CAAC,CAAC,SAAS,KAAK,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAkBxD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAhBtC,QAAQ,CAAC,UAAU,EAAM,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,WAAW,CAAsB;IAEzC,SAAS,CAAC,OAAO,EAAQ,MAAM,CAAuB;IACtD,SAAS,CAAC,UAAU,EAAK,MAAM,CAAK;IAMpC,SAAS,CAAC,YAAY,EAAG,MAAM,EAAE,CAAuB;IAExD,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;gBAEhC,QAAQ,EAAE,cAAc;cAKnC,mBAAmB,IAAI,MAAM;cAK7B,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAOzD,OAAO,KAAK,MAAM,GAGjB;IAED;;;OAGG;IACH,mBAAmB,IAAI,eAAe;IAKtC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB7B;;;;OAIG;YACW,eAAe;IAqB7B;;;;;;;;OAQG;cACa,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDxD;;;;OAIG;cACa,oBAAoB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/E;;;;OAIG;cACa,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB9E;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAKd;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAYrB"}

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

@@ -3,9 +3,15 @@ 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 base_listener_1 = require("./base-listener");
 const cascade_1 = require("./cascade");
-class NatsListener {
+/**
+ * Durable inter-service listener (JetStream): owns the per-message ack/nak/term
+ * and DLQ policy. Keep `onMessage` idempotent so redelivery is always safe.
+ */
+class NatsListener extends base_listener_1.Listener {
     constructor(provider) {
+        super();
         this.provider = provider;
         this.isListening = false;
         this.ackWait = 30 * 1000 * 1000000; // 30 secondi in nanosecondi;
@@ -16,6 +22,12 @@ class NatsListener {
         // maxDeliver = 3).
         this.nakBackoffMs = [1000, 5000, 15000];
     }
+    transportNameForLog() {
+        return 'NATS';
+    }
+    streamNameForLog() {
+        return this.streamName;
+    }
     // Resolve the client only at listen/DLQ/stop time, so the transport may be
     // connected AFTER this listener is constructed (finding B8).
     get client() {
@@ -128,16 +140,6 @@ class NatsListener {
         else
             msg.nak(this.backoffFor(this.deliveryAttempt(msg)));
     }
-    /**
-     * Build a child context carrying the in-flight event reference, so any event
-     * this listener republishes inherits the correlation, is marked as caused by
-     * the current event, and advances the cascade depth / visited lineage. Returns
-     * a fresh object (never mutates the shared base context). At the root — or when
-     * no event is in flight — it is just a copy of `base`.
-     */
-    nextContext(base = {}) {
-        return this._incoming ? { ...base, _event: this._incoming } : { ...base };
-    }
     /**
      * Parks a failed message on the DLQ stream. Returns `true` on success so the
      * caller can safely `term()` the original; returns `false` if the DLQ could

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

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

package/build/events/index.d.ts

@@ -13,6 +13,8 @@ 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';

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,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,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"}

package/build/events/index.js

@@ -30,6 +30,8 @@ __exportStar(require("./access-revoked-publisher"), exports);
 __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);
 // messages on nats
 __exportStar(require("./nats-client-manager"), 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,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,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextage/era-lib",
-  "version": "1.0.184",
+  "version": "1.0.186",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "files": [