@nextage/era-lib 1.0.181 → 1.0.183

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

@@ -0,0 +1,57 @@
+import { NatsClientManager } from './nats-client-manager';
+import { DlqDepth, DlqInspectItem } from './types/dlq.interfaces';
+import { DlqInspectOptions, DlqManagerOptions } from './types/dlq.interfaces';
+import { DlqReplayOptions, DlqReplayResult } from './types/dlq.interfaces';
+export declare class DlqManager {
+    private readonly client;
+    private readonly alertThreshold;
+    private readonly monitorIntervalMs;
+    private readonly onAlert;
+    private timer?;
+    private checking;
+    constructor(client: NatsClientManager, opts?: DlqManagerOptions);
+    /**
+     * Current DLQ depth. `total` is the message count across the whole stream
+     * (or the count for `subject` when given); `bySubject` breaks it down per
+     * `dlq.<subject>` so an operator sees which consumer is failing.
+     *
+     * @param subject original subject (without the `dlq.` prefix); omit for all.
+     */
+    depth(subject?: string): Promise<DlqDepth>;
+    /**
+     * Sample the depth once and fire `onAlert` (default: WARN log) when it exceeds
+     * the threshold. Returns the sampled depth; `-1` if a sample is already in
+     * flight (re-entrancy guard for the periodic timer).
+     */
+    checkDepth(): Promise<number>;
+    /**
+     * Start the periodic depth monitor. Idempotent. The timer is `unref`ed so it
+     * never keeps the process alive on shutdown.
+     */
+    startMonitor(): void;
+    /** Stop the periodic depth monitor (idempotent). */
+    stopMonitor(): void;
+    /**
+     * Read up to `limit` parked messages WITHOUT removing them, so an operator can
+     * inspect payloads and errors before deciding to replay. Malformed envelopes
+     * are skipped. Idempotent: `Limits` retention means reading never deletes.
+     */
+    inspect(opts?: DlqInspectOptions): Promise<DlqInspectItem[]>;
+    /**
+     * Replay up to `limit` parked messages: re-publish each envelope's original
+     * payload to its original subject, then delete it from the DLQ by stream
+     * sequence. A message whose re-publish fails is left parked (`nak`) and
+     * reported in `failures`; the batch continues.
+     */
+    replay(opts?: DlqReplayOptions): Promise<DlqReplayResult>;
+    /**
+     * Create a short-lived, explicit-ack pull consumer over the DLQ stream filtered
+     * to `filter`. `deliver_policy: All` scans from the oldest parked message;
+     * `inactive_threshold` is a server-side safety net that reaps the consumer if
+     * this process dies mid-operation.
+     */
+    private ephemeralConsumer;
+    private deleteConsumer;
+    private originalSubjectOf;
+}
+//# sourceMappingURL=dlq-manager.d.ts.map

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

@@ -0,0 +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"}

package/build/events/dlq-manager.js

@@ -0,0 +1,206 @@
+"use strict";
+/* ────────────────────────────────────────────────────────────────────────────
+ * DLQ MANAGER — dead-letter observability & replay (Step 3.9)
+ *
+ * The failure path (Step 3.2) already parks poison messages on the `DLQ_EVENTS`
+ * stream: a message failing on `<subject>` is stored on `dlq.<subject>` as a
+ * `DeadLetterEnvelope` (original subject/stream/queue, delivery count, error,
+ * raw payload, timestamp) and dropped from its source stream. Until now the DLQ
+ * was only inspectable manually via the NATS CLI. This manager adds:
+ *
+ *   • observability → periodic depth sampling that WARNs when parked messages
+ *     pile up beyond a threshold, plus on-demand depth/inspect for an operator;
+ *   • replay        → re-publish a parked message's ORIGINAL payload back to its
+ *     ORIGINAL subject once the bug is fixed, then delete it from the DLQ.
+ *
+ * Replay is safe: the re-published event re-enters the normal, version-guarded
+ * (Step 3.3) consumer path, so a duplicate delivery is idempotent. The DLQ
+ * stream uses `Limits` retention (ack does NOT delete), so replay removes a
+ * message EXPLICITLY by its stream sequence only AFTER the re-publish succeeds —
+ * a failed re-publish leaves the message parked (no loss).
+ * ──────────────────────────────────────────────────────────────────────────── */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DlqManager = void 0;
+const nats_1 = require("nats");
+const node_crypto_1 = require("node:crypto");
+const nx_frame_be_1 = require("@nextage/nx-frame-be");
+const dlq_constants_1 = require("./types/dlq.constants");
+const dlq_constants_2 = require("./types/dlq.constants");
+const dlq_constants_3 = require("./types/dlq.constants");
+const dlq_constants_4 = require("./types/dlq.constants");
+class DlqManager {
+    constructor(client, opts = {}) {
+        this.client = client;
+        this.checking = false;
+        this.alertThreshold = opts.alertThreshold ?? dlq_constants_2.DEFAULT_DLQ_ALERT_THRESHOLD;
+        this.monitorIntervalMs = opts.monitorIntervalMs ?? dlq_constants_3.DEFAULT_DLQ_MONITOR_INTERVAL_MS;
+        this.onAlert = opts.onAlert ?? ((depth, threshold) => nx_frame_be_1.APP.logger.warn(`⚠️ DLQ '${dlq_constants_1.DLQ_STREAM}' depth ${depth} exceeds threshold ${threshold} — inspect and replay once fixed`));
+    }
+    /**
+     * Current DLQ depth. `total` is the message count across the whole stream
+     * (or the count for `subject` when given); `bySubject` breaks it down per
+     * `dlq.<subject>` so an operator sees which consumer is failing.
+     *
+     * @param subject original subject (without the `dlq.` prefix); omit for all.
+     */
+    async depth(subject) {
+        const filter = subject ? `${dlq_constants_1.DLQ_SUBJECT_PREFIX}${subject}` : dlq_constants_1.DLQ_SUBJECT_FILTER;
+        const info = await this.client.jetStreamManager.streams.info(dlq_constants_1.DLQ_STREAM, { subjects_filter: filter });
+        const bySubject = info.state.subjects ?? {};
+        const total = subject
+            ? Object.values(bySubject).reduce((acc, n) => acc + n, 0)
+            : info.state.messages;
+        return { total, bySubject };
+    }
+    /**
+     * Sample the depth once and fire `onAlert` (default: WARN log) when it exceeds
+     * the threshold. Returns the sampled depth; `-1` if a sample is already in
+     * flight (re-entrancy guard for the periodic timer).
+     */
+    async checkDepth() {
+        if (this.checking)
+            return -1;
+        this.checking = true;
+        try {
+            const { total } = await this.depth();
+            if (total > this.alertThreshold)
+                this.onAlert(total, this.alertThreshold);
+            return total;
+        }
+        finally {
+            this.checking = false;
+        }
+    }
+    /**
+     * Start the periodic depth monitor. Idempotent. The timer is `unref`ed so it
+     * never keeps the process alive on shutdown.
+     */
+    startMonitor() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.checkDepth().catch(err => nx_frame_be_1.APP.logger.error('❌ DLQ depth monitor failed: %o', err));
+        }, this.monitorIntervalMs);
+        this.timer.unref?.();
+        nx_frame_be_1.APP.logger.info(`🩺 DLQ monitor started (every ${this.monitorIntervalMs}ms, threshold ${this.alertThreshold})`);
+    }
+    /** Stop the periodic depth monitor (idempotent). */
+    stopMonitor() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    /**
+     * Read up to `limit` parked messages WITHOUT removing them, so an operator can
+     * inspect payloads and errors before deciding to replay. Malformed envelopes
+     * are skipped. Idempotent: `Limits` retention means reading never deletes.
+     */
+    async inspect(opts = {}) {
+        const limit = opts.limit ?? dlq_constants_4.DEFAULT_DLQ_REPLAY_LIMIT;
+        const filter = opts.subject ? `${dlq_constants_1.DLQ_SUBJECT_PREFIX}${opts.subject}` : dlq_constants_1.DLQ_SUBJECT_FILTER;
+        const items = [];
+        const { consumer, name } = await this.ephemeralConsumer(filter);
+        try {
+            const iter = await consumer.fetch({ max_messages: limit, expires: 5000 });
+            for await (const msg of iter) {
+                try {
+                    const env = msg.json();
+                    items.push({
+                        streamSequence: msg.seq,
+                        originalSubject: env.originalSubject,
+                        deliveryCount: env.deliveryCount,
+                        error: env.error,
+                        timestamp: env.timestamp,
+                        data: env.data,
+                    });
+                }
+                catch { /* skip a malformed envelope but keep scanning */ }
+                // Ack keeps the ephemeral consumer tidy; with `Limits` retention it does
+                // NOT delete the stream message, so inspect stays non-destructive.
+                msg.ack();
+            }
+        }
+        finally {
+            await this.deleteConsumer(name);
+        }
+        return items;
+    }
+    /**
+     * Replay up to `limit` parked messages: re-publish each envelope's original
+     * payload to its original subject, then delete it from the DLQ by stream
+     * sequence. A message whose re-publish fails is left parked (`nak`) and
+     * reported in `failures`; the batch continues.
+     */
+    async replay(opts = {}) {
+        const limit = opts.limit ?? dlq_constants_4.DEFAULT_DLQ_REPLAY_LIMIT;
+        const filter = opts.subject ? `${dlq_constants_1.DLQ_SUBJECT_PREFIX}${opts.subject}` : dlq_constants_1.DLQ_SUBJECT_FILTER;
+        const result = { replayed: 0, failed: 0, failures: [] };
+        const { consumer, name } = await this.ephemeralConsumer(filter);
+        try {
+            const iter = await consumer.fetch({ max_messages: limit, expires: 5000 });
+            for await (const msg of iter) {
+                const seq = msg.seq;
+                try {
+                    const env = msg.json();
+                    // Re-publish FIRST; only remove from the DLQ once it is safely back on
+                    // the source subject (delete-after-publish → no loss on failure).
+                    await this.client.publish(env.originalSubject, env.data);
+                    await this.client.jetStreamManager.streams.deleteMessage(dlq_constants_1.DLQ_STREAM, seq);
+                    msg.ack();
+                    result.replayed++;
+                }
+                catch (err) {
+                    msg.nak(); // leave it parked for a later attempt
+                    result.failed++;
+                    result.failures.push({
+                        streamSequence: seq,
+                        originalSubject: this.originalSubjectOf(msg.subject),
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+        finally {
+            await this.deleteConsumer(name);
+        }
+        if (result.replayed) {
+            const scope = opts.subject ? ` for '${opts.subject}'` : '';
+            nx_frame_be_1.APP.logger.info(`♻️ DLQ replay: ${result.replayed} message(s) re-published${scope}, ${result.failed} failed`);
+        }
+        return result;
+    }
+    // ── internals ────────────────────────────────────────────────────────────────
+    /**
+     * Create a short-lived, explicit-ack pull consumer over the DLQ stream filtered
+     * to `filter`. `deliver_policy: All` scans from the oldest parked message;
+     * `inactive_threshold` is a server-side safety net that reaps the consumer if
+     * this process dies mid-operation.
+     */
+    async ephemeralConsumer(filter) {
+        const name = `dlq_admin_${process.pid}_${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+        const config = {
+            name,
+            ack_policy: nats_1.AckPolicy.Explicit,
+            filter_subject: filter,
+            deliver_policy: nats_1.DeliverPolicy.All,
+            inactive_threshold: 30 * 1000000000, // 30s in ns → auto-reap on crash
+        };
+        await this.client.jetStreamManager.consumers.add(dlq_constants_1.DLQ_STREAM, config);
+        const consumer = await this.client.jetStream.consumers.get(dlq_constants_1.DLQ_STREAM, name);
+        return { consumer, name };
+    }
+    async deleteConsumer(name) {
+        try {
+            await this.client.jetStreamManager.consumers.delete(dlq_constants_1.DLQ_STREAM, name);
+        }
+        catch { /* already reaped by the server — nothing to do */ }
+    }
+    originalSubjectOf(dlqSubject) {
+        return dlqSubject.startsWith(dlq_constants_1.DLQ_SUBJECT_PREFIX)
+            ? dlqSubject.slice(dlq_constants_1.DLQ_SUBJECT_PREFIX.length)
+            : dlqSubject;
+    }
+}
+exports.DlqManager = DlqManager;
+//# sourceMappingURL=dlq-manager.js.map

package/build/events/dlq-manager.js.map

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

package/build/events/index.d.ts

@@ -18,6 +18,7 @@ export * from './nats-client-manager';
 export * from './nats-wrapper';
 export * from './base-nats-listener';
 export * from './base-nats-publisher';
+export * from './dlq-manager';
 export * from './organization';
 export * from './user';
 export * from './analysis-type';

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;AAGtC,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,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

@@ -36,6 +36,7 @@ __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("./dlq-manager"), exports);
 // admin-mng
 __exportStar(require("./organization"), exports);
 __exportStar(require("./user"), 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;AAEtC,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,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/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;IAwBrB,OAAO,CAAC,MAAM;IAkBd,yDAAyD;IACnD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW5B"}
+{"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"}

package/build/events/revocation-listener.js

@@ -49,10 +49,16 @@ class RevocationListener {
             }
         }
         catch (err) {
+            // A failure raised while we are tearing down (`stop()` already set
+            // `listening = false`) is the expected consequence of the closing NATS
+            // connection (CONNECTION_CLOSED) — not a fault. Stay silent and do not
+            // reschedule. Only surface/retry errors that happen while we still intend
+            // to listen (e.g. a broker hiccup during normal operation).
+            if (!this.listening)
+                return;
             this.onError(err);
             // Best-effort: retry the consume loop after a short delay while listening.
-            if (this.listening)
-                setTimeout(() => void this.consume(), 5000);
+            setTimeout(() => void this.consume(), 5000);
         }
     }
     handle(msg) {
@@ -71,12 +77,13 @@ class RevocationListener {
     /** Stop draining (graceful shutdown / test teardown). */
     async stop() {
         this.listening = false;
+        // Best-effort delete: during graceful shutdown the NATS connection may already
+        // be closing (CONNECTION_CLOSED) — harmless, the ephemeral consumer is reaped
+        // by its `inactive_threshold` anyway. A teardown error is never surfaced.
         try {
             await this.consumer?.delete();
         }
-        catch (err) {
-            this.onError(err);
-        }
+        catch { /* teardown — ignore */ }
         this.consumer = undefined;
         nx_frame_be_1.APP.logger.info('🔒 Revocation listener stopped');
     }

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

@@ -1 +1 @@
-{"version":3,"file":"revocation-listener.js","sourceRoot":"","sources":["../../src/events/revocation-listener.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;kFAakF;;;AAElF,sDAAoE;AAIpE,uCAAyD;AACzD,+DAAqE;AAGrE,uEAA4E;AAC5E,yCAA6D;AAQ7D,MAAa,kBAAkB;IAQ7B,YAA6B,QAAsB,EAAE,OAAkC,EAAE;QAA5D,aAAQ,GAAR,QAAQ,CAAc;QAL3C,cAAS,GAAI,KAAK,CAAC;QAOzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAM,IAAI,CAAC,OAAO,IAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QAEV,IAAI,CAAC,QAAQ,GAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC,gBAAQ,CAAC,aAAa,EAAE,oCAAa,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACvI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,OAAO;QAEnB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,IAAI,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAE/C,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAEjC,IAAI,CAAC,IAAI,CAAC,SAAS;oBAAE,MAAM;gBAE3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,EAAE,CAAC;YAEX,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAElB,2EAA2E;YAC3E,IAAI,IAAI,CAAC,SAAS;gBAAE,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,GAAU;QAEvB,IAAI,CAAC;YAEH,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,wBAAc,EAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEnG,IAAI,IAAI,EAAE,GAAG;gBAAE,wCAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAE1D,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,EAAE,CAAC;YAEX,sEAAsE;YACtE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClB,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,IAAI;QAER,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,IAAI,CAAC;YAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC;QACtC,OAAO,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAElC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAE1B,iBAAG,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;CACF;AAjFD,gDAiFC"}
+{"version":3,"file":"revocation-listener.js","sourceRoot":"","sources":["../../src/events/revocation-listener.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;kFAakF;;;AAElF,sDAAoE;AAIpE,uCAAyD;AACzD,+DAAqE;AAGrE,uEAA4E;AAC5E,yCAA6D;AAQ7D,MAAa,kBAAkB;IAQ7B,YAA6B,QAAsB,EAAE,OAAkC,EAAE;QAA5D,aAAQ,GAAR,QAAQ,CAAc;QAL3C,cAAS,GAAI,KAAK,CAAC;QAOzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAM,IAAI,CAAC,OAAO,IAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QAEV,IAAI,CAAC,QAAQ,GAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC,gBAAQ,CAAC,aAAa,EAAE,oCAAa,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACvI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,OAAO;QAEnB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,IAAI,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAE/C,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAEjC,IAAI,CAAC,IAAI,CAAC,SAAS;oBAAE,MAAM;gBAE3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,EAAE,CAAC;YAEX,mEAAmE;YACnE,uEAAuE;YACvE,uEAAuE;YACvE,0EAA0E;YAC1E,4DAA4D;YAC5D,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAElB,2EAA2E;YAC3E,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,GAAU;QAEvB,IAAI,CAAC;YAEH,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,wBAAc,EAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEnG,IAAI,IAAI,EAAE,GAAG;gBAAE,wCAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAE1D,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,EAAE,CAAC;YAEX,sEAAsE;YACtE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClB,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,IAAI;QAER,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,+EAA+E;QAC/E,8EAA8E;QAC9E,0EAA0E;QAC1E,IAAI,CAAC;YAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC;QACtC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAEjC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAE1B,iBAAG,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;CACF;AA3FD,gDA2FC"}

package/build/events/types/dlq.constants.d.ts

@@ -1,4 +1,7 @@
 export declare const DLQ_STREAM = "DLQ_EVENTS";
 export declare const DLQ_SUBJECT_PREFIX = "dlq.";
 export declare const DLQ_SUBJECT_FILTER = "dlq.>";
+export declare const DEFAULT_DLQ_ALERT_THRESHOLD = 50;
+export declare const DEFAULT_DLQ_MONITOR_INTERVAL_MS = 60000;
+export declare const DEFAULT_DLQ_REPLAY_LIMIT = 100;
 //# sourceMappingURL=dlq.constants.d.ts.map

package/build/events/types/dlq.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dlq.constants.d.ts","sourceRoot":"","sources":["../../../src/events/types/dlq.constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU,eAAuB,CAAC;AAC/C,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,kBAAkB,UAAU,CAAC"}
+{"version":3,"file":"dlq.constants.d.ts","sourceRoot":"","sources":["../../../src/events/types/dlq.constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU,eAAuB,CAAC;AAC/C,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAK1C,eAAO,MAAM,2BAA2B,KAAS,CAAC;AAClD,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD,eAAO,MAAM,wBAAwB,MAAa,CAAC"}

package/build/events/types/dlq.constants.js

@@ -4,8 +4,14 @@
 // provisions the DLQ stream. Kept here so producer and stream config cannot
 // drift apart.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DLQ_SUBJECT_FILTER = exports.DLQ_SUBJECT_PREFIX = exports.DLQ_STREAM = void 0;
+exports.DEFAULT_DLQ_REPLAY_LIMIT = exports.DEFAULT_DLQ_MONITOR_INTERVAL_MS = exports.DEFAULT_DLQ_ALERT_THRESHOLD = exports.DLQ_SUBJECT_FILTER = exports.DLQ_SUBJECT_PREFIX = exports.DLQ_STREAM = void 0;
 exports.DLQ_STREAM = 'DLQ_EVENTS';
 exports.DLQ_SUBJECT_PREFIX = 'dlq.'; // a failed `<subject>` parks on `dlq.<subject>`
 exports.DLQ_SUBJECT_FILTER = 'dlq.>'; // wildcard binding every `dlq.*` to the stream
+// DLQ observability & replay (step 3.9). The manager periodically samples the
+// stream depth and warns when parked messages pile up, and replays parked
+// messages back to their original subject once the underlying bug is fixed.
+exports.DEFAULT_DLQ_ALERT_THRESHOLD = 50; // WARN once depth exceeds this
+exports.DEFAULT_DLQ_MONITOR_INTERVAL_MS = 60000; // 60s periodic depth sample
+exports.DEFAULT_DLQ_REPLAY_LIMIT = 100; // max messages handled per replay/inspect call
 //# sourceMappingURL=dlq.constants.js.map

package/build/events/types/dlq.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"dlq.constants.js","sourceRoot":"","sources":["../../../src/events/types/dlq.constants.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,wEAAwE;AACxE,4EAA4E;AAC5E,eAAe;;;AAEF,QAAA,UAAU,GAAW,YAAY,CAAC;AAClC,QAAA,kBAAkB,GAAG,MAAM,CAAC,CAAG,gDAAgD;AAC/E,QAAA,kBAAkB,GAAG,OAAO,CAAC,CAAE,+CAA+C"}
+{"version":3,"file":"dlq.constants.js","sourceRoot":"","sources":["../../../src/events/types/dlq.constants.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,wEAAwE;AACxE,4EAA4E;AAC5E,eAAe;;;AAEF,QAAA,UAAU,GAAW,YAAY,CAAC;AAClC,QAAA,kBAAkB,GAAG,MAAM,CAAC,CAAG,gDAAgD;AAC/E,QAAA,kBAAkB,GAAG,OAAO,CAAC,CAAE,+CAA+C;AAE3F,8EAA8E;AAC9E,0EAA0E;AAC1E,4EAA4E;AAC/D,QAAA,2BAA2B,GAAO,EAAE,CAAC,CAAK,+BAA+B;AACzE,QAAA,+BAA+B,GAAG,KAAM,CAAC,CAAC,4BAA4B;AACtE,QAAA,wBAAwB,GAAU,GAAG,CAAC,CAAI,+CAA+C"}

package/build/events/types/dlq.interfaces.d.ts

@@ -7,4 +7,39 @@ export interface DeadLetterEnvelope {
     data: string;
     timestamp: string;
 }
+export interface DlqDepth {
+    total: number;
+    bySubject: Record<string, number>;
+}
+export interface DlqReplayOptions {
+    subject?: string;
+    limit?: number;
+}
+export interface DlqInspectOptions {
+    subject?: string;
+    limit?: number;
+}
+export interface DlqInspectItem {
+    streamSequence: number;
+    originalSubject: string;
+    deliveryCount: number;
+    error: string;
+    timestamp: string;
+    data: string;
+}
+export interface DlqReplayFailure {
+    streamSequence: number;
+    originalSubject: string;
+    error: string;
+}
+export interface DlqReplayResult {
+    replayed: number;
+    failed: number;
+    failures: DlqReplayFailure[];
+}
+export interface DlqManagerOptions {
+    alertThreshold?: number;
+    monitorIntervalMs?: number;
+    onAlert?: (depth: number, threshold: number) => void;
+}
 //# sourceMappingURL=dlq.interfaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dlq.interfaces.d.ts","sourceRoot":"","sources":["../../../src/events/types/dlq.interfaces.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAO,MAAM,CAAC;IACxB,cAAc,EAAG,MAAM,CAAC;IACxB,aAAa,EAAI,MAAM,CAAC;IACxB,KAAK,EAAY,MAAM,CAAC;IACxB,IAAI,EAAa,MAAM,CAAC;IACxB,SAAS,EAAQ,MAAM,CAAC;CACzB"}
+{"version":3,"file":"dlq.interfaces.d.ts","sourceRoot":"","sources":["../../../src/events/types/dlq.interfaces.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAO,MAAM,CAAC;IACxB,cAAc,EAAG,MAAM,CAAC;IACxB,aAAa,EAAI,MAAM,CAAC;IACxB,KAAK,EAAY,MAAM,CAAC;IACxB,IAAI,EAAa,MAAM,CAAC;IACxB,SAAS,EAAQ,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAM,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAI,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAI,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAG,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAI,MAAM,CAAC;IACxB,KAAK,EAAY,MAAM,CAAC;IACxB,SAAS,EAAQ,MAAM,CAAC;IACxB,IAAI,EAAa,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAG,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAY,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAI,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAK,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAChE"}

package/package.json

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