@dudousxd/nestjs-diagnostics 0.8.0 → 0.9.0

package/dist/nestjs/diagnostics.explorer.js

@@ -10,96 +10,252 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
+import { randomUUID } from 'node:crypto';
 import diagnostics_channel from 'node:diagnostics_channel';
-import { Inject, Injectable, Logger, } from '@nestjs/common';
-import { DiscoveryService, MetadataScanner } from '@nestjs/core';
+import { Inject, Injectable, Logger, Optional, } from '@nestjs/common';
+import { DiscoveryService, MetadataScanner, ModuleRef } from '@nestjs/core';
 import { CHANNEL_PREFIX, channelName } from '../channel.js';
 import { onChannelRegistered, registeredChannels } from '../registry.js';
+import { isRelayed } from '../relayed.js';
+import { DIAGNOSTICS_OPTIONS } from './diagnostics.options.js';
 import { ON_DIAGNOSTIC_META } from './on-diagnostic.decorator.js';
+import { resolveRole } from './role.js';
+/** Thrown by the listener invoker for a listener id this process does not know. */
+export class UnknownDiagnosticListenerError extends Error {
+    listenerId;
+    code = 'E_UNKNOWN_DIAGNOSTICS_LISTENER';
+    constructor(listenerId) {
+        super(`@dudousxd/nestjs-diagnostics: no listener "${listenerId}" is registered in this process. Every process that runs deliveries must register the same listeners.`);
+        this.listenerId = listenerId;
+    }
+}
+function matches(meta, lib, event) {
+    if (meta.lib !== lib)
+        return false;
+    const matcher = meta.event;
+    if (matcher === undefined)
+        return true;
+    if (typeof matcher === 'string')
+        return matcher === event;
+    matcher.lastIndex = 0;
+    return matcher.test(event);
+}
+/** A diagnostics POINT event (from `emit`). Span phase events from `trace` are never dispatched. */
+function isPointEvent(msg) {
+    if (typeof msg !== 'object' || msg === null)
+        return false;
+    const env = msg;
+    if (typeof env.lib !== 'string' || typeof env.event !== 'string')
+        return false;
+    return env.phase === undefined || env.spanId === undefined;
+}
+function libOf(name) {
+    if (!name.startsWith(`${CHANNEL_PREFIX}:`))
+        return undefined;
+    const rest = name.slice(CHANNEL_PREFIX.length + 1);
+    const idx = rest.indexOf(':');
+    return idx > 0 ? rest.slice(0, idx) : undefined;
+}
+/**
+ * Discovers `@OnDiagnostic` methods, starts the `default` transport and routes every matching
+ * event: to the delivering transport (only in the emitting process), or straight to the handler.
+ */
 let DiagnosticsExplorer = class DiagnosticsExplorer {
     discovery;
     scanner;
+    moduleRef;
     logger = new Logger('DiagnosticsExplorer');
-    subscriptions = [];
-    wildcards = [];
+    listeners = new Map();
+    matchCache = new Map();
+    subscribed = new Set();
+    wildcardLibs = new Set();
+    pending = [];
+    scheduled = null;
     offChannelRegistered = null;
-    constructor(discovery, scanner) {
+    transport = null;
+    deliver = null;
+    role = 'all';
+    options;
+    constructor(discovery, scanner, moduleRef, options) {
         this.discovery = discovery;
         this.scanner = scanner;
+        this.moduleRef = moduleRef;
+        this.options = options ?? {};
+    }
+    /**
+     * Run listener `listenerId` for `envelope` in this process. The handler is called synchronously;
+     * the promise rejects with its error.
+     */
+    invoke = (listenerId, envelope) => {
+        const listener = this.listeners.get(listenerId);
+        if (!listener)
+            return Promise.reject(new UnknownDiagnosticListenerError(listenerId));
+        try {
+            const fn = listener.instance[listener.method];
+            return Promise.resolve(fn.call(listener.instance, envelope)).then(() => undefined);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    };
+    /** Every listener discovered in this process. */
+    registeredListeners() {
+        return [...this.listeners.values()];
+    }
+    async onApplicationBootstrap() {
+        this.role = resolveRole(this.options.role, this.options.default);
+        this.discover();
+        const name = this.options.default;
+        if (name) {
+            const provider = this.options.transports?.[name];
+            if (!provider) {
+                throw new Error(`@dudousxd/nestjs-diagnostics: default is "${name}", but transports.${name} is not defined`);
+            }
+            const listeners = this.registeredListeners();
+            this.transport = await provider({
+                moduleRef: this.moduleRef,
+                role: this.role,
+                nodeId: this.options.nodeId ?? randomUUID(),
+                listenerLibs: [...new Set(listeners.flatMap((l) => l.matchers.map((m) => m.lib)))],
+                listenerIds: listeners.map((l) => l.id),
+                invoke: this.invoke,
+                logger: this.logger,
+            });
+            this.deliver = this.transport.deliver?.bind(this.transport) ?? null;
+        }
+        // An 'api' process without a delivering transport has nothing to do with its listeners.
+        if (this.role === 'api' && !this.deliver)
+            return;
+        this.subscribeListeners();
     }
-    onApplicationBootstrap() {
+    async onApplicationShutdown() {
+        await this.flush();
+        this.offChannelRegistered?.();
+        this.offChannelRegistered = null;
+        for (const name of this.subscribed)
+            diagnostics_channel.channel(name).unsubscribe(this.onEvent);
+        this.subscribed.clear();
+        this.wildcardLibs.clear();
+        const transport = this.transport;
+        this.transport = null;
+        this.deliver = null;
+        try {
+            await transport?.stop?.();
+        }
+        catch (error) {
+            this.logger.error(`failed to stop the diagnostics transport: ${messageOf(error)}`);
+        }
+    }
+    discover() {
         for (const wrapper of this.discovery.getProviders()) {
             const instance = wrapper.instance;
             if (!instance || typeof instance !== 'object')
                 continue;
             const proto = Object.getPrototypeOf(instance);
-            for (const methodName of this.scanner.getAllMethodNames(proto)) {
-                const metas = Reflect.getMetadata(ON_DIAGNOSTIC_META, proto, methodName);
+            for (const method of this.scanner.getAllMethodNames(proto)) {
+                const metas = Reflect.getMetadata(ON_DIAGNOSTIC_META, proto, method);
                 if (!metas?.length)
                     continue;
-                for (const meta of metas) {
-                    const invoke = (event) => this.safeInvoke(instance, methodName, event);
-                    if (meta.event !== undefined) {
-                        this.subscribe(channelName(meta.lib, meta.event), invoke);
-                    }
-                    else {
-                        const prefix = `${CHANNEL_PREFIX}:${meta.lib}:`;
-                        this.wildcards.push({ prefix, invoke });
-                        for (const name of registeredChannels()) {
-                            if (name.startsWith(prefix))
-                                this.subscribe(name, invoke);
-                        }
+                const id = `${instance.constructor.name}#${method}`;
+                const existing = this.listeners.get(id);
+                if (existing) {
+                    if (existing.instance.constructor === instance.constructor)
+                        continue;
+                    throw new Error(`@dudousxd/nestjs-diagnostics: two listeners share the id "${id}". Listener ids are <ClassName>#<method> and must be unique; rename one class.`);
+                }
+                this.listeners.set(id, { id, matchers: metas, instance, method });
+            }
+        }
+        this.matchCache.clear();
+    }
+    /** The listeners that receive an event on `aviary:<lib>:<event>`. */
+    listenersFor(lib, event) {
+        const key = `${lib}\0${event}`;
+        let hit = this.matchCache.get(key);
+        if (hit === undefined) {
+            hit = this.registeredListeners().filter((l) => l.matchers.some((m) => matches(m, lib, event)));
+            this.matchCache.set(key, hit);
+        }
+        return hit;
+    }
+    subscribeListeners() {
+        for (const listener of this.listeners.values()) {
+            for (const meta of listener.matchers) {
+                if (typeof meta.event === 'string') {
+                    this.subscribe(channelName(meta.lib, meta.event));
+                }
+                else if (!this.wildcardLibs.has(meta.lib)) {
+                    this.wildcardLibs.add(meta.lib);
+                    for (const name of registeredChannels()) {
+                        if (libOf(name) === meta.lib)
+                            this.subscribe(name);
                     }
                 }
             }
         }
         this.offChannelRegistered = onChannelRegistered((name) => {
-            for (const w of this.wildcards) {
-                if (name.startsWith(w.prefix))
-                    this.subscribe(name, w.invoke);
-            }
+            const lib = libOf(name);
+            if (lib !== undefined && this.wildcardLibs.has(lib))
+                this.subscribe(name);
         });
     }
-    onApplicationShutdown() {
-        this.offChannelRegistered?.();
-        this.offChannelRegistered = null;
-        for (const { name, listener } of this.subscriptions) {
-            diagnostics_channel.channel(name).unsubscribe(listener);
-        }
-        this.subscriptions.length = 0;
-        this.wildcards.length = 0;
-    }
-    /** Subscribe once to `name`; the listener fans the envelope into `invoke`. */
-    subscribe(name, invoke) {
-        const listener = (msg) => invoke(msg);
-        diagnostics_channel.channel(name).subscribe(listener);
-        this.subscriptions.push({ name, listener });
+    subscribe(name) {
+        if (this.subscribed.has(name))
+            return;
+        diagnostics_channel.channel(name).subscribe(this.onEvent);
+        this.subscribed.add(name);
     }
-    /** Invoke a handler, swallowing sync throws and async rejections so a buggy
-     *  reaction can never break the synchronous `emit()` that triggered it. */
-    safeInvoke(instance, methodName, event) {
+    onEvent = (msg) => {
+        if (!isPointEvent(msg))
+            return;
+        const matched = this.listenersFor(msg.lib, msg.event);
+        if (matched.length === 0)
+            return;
+        if (this.deliver) {
+            // Delivery happens once, at the origin. A relayed copy was already handed over there.
+            if (isRelayed(msg))
+                return;
+            const envelope = (typeof msg.id === 'string' ? msg : { ...msg, id: randomUUID() });
+            for (const listener of matched)
+                this.pending.push({ listenerId: listener.id, envelope });
+            this.scheduled ??= setImmediate(() => void this.flush());
+            return;
+        }
+        for (const listener of matched) {
+            this.invoke(listener.id, msg).catch((error) => this.logger.error(`@OnDiagnostic ${listener.id} handler failed: ${messageOf(error)}`));
+        }
+    };
+    /** Hand this turn's deliveries to the transport, in emit order. Settles once they are handed over. */
+    async flush() {
+        if (this.scheduled !== null) {
+            clearImmediate(this.scheduled);
+            this.scheduled = null;
+        }
+        if (this.pending.length === 0 || !this.deliver)
+            return;
+        const deliveries = this.pending.splice(0);
+        const report = (error) => this.logger.error(`failed to hand ${deliveries.length} diagnostics deliveries to the transport: ${messageOf(error)}`);
         try {
-            const fn = instance[methodName];
-            const result = fn.call(instance, event);
-            if (result != null && typeof result.then === 'function') {
-                result.catch((err) => this.logError(methodName, err));
-            }
+            await this.deliver(deliveries);
         }
-        catch (err) {
-            this.logError(methodName, err);
+        catch (error) {
+            report(error);
         }
     }
-    logError(methodName, err) {
-        const message = err instanceof Error ? err.message : String(err);
-        this.logger.error(`@OnDiagnostic ${methodName} handler failed: ${message}`);
-    }
 };
 DiagnosticsExplorer = __decorate([
     Injectable(),
     __param(0, Inject(DiscoveryService)),
     __param(1, Inject(MetadataScanner)),
+    __param(2, Inject(ModuleRef)),
+    __param(3, Optional()),
+    __param(3, Inject(DIAGNOSTICS_OPTIONS)),
     __metadata("design:paramtypes", [DiscoveryService,
-        MetadataScanner])
+        MetadataScanner,
+        ModuleRef, Object])
 ], DiagnosticsExplorer);
 export { DiagnosticsExplorer };
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
 //# sourceMappingURL=diagnostics.explorer.js.map

package/dist/nestjs/diagnostics.explorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.explorer.js","sourceRoot":"","sources":["../../src/nestjs/diagnostics.explorer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostics.explorer.js","sourceRoot":"","sources":["../../src/nestjs/diagnostics.explorer.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,MAAM,EACN,UAAU,EACV,MAAM,EAGN,QAAQ,GACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAE,mBAAmB,EAAiC,MAAM,0BAA0B,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAyB,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAwB,WAAW,EAAE,MAAM,WAAW,CAAC;AAG9D,mFAAmF;AACnF,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAElC;IADZ,IAAI,GAAG,gCAAgC,CAAC;IACjD,YAAqB,UAAkB;QACrC,KAAK,CACH,8CAA8C,UAAU,uGAAuG,CAChK,CAAC;QAHiB,eAAU,GAAV,UAAU,CAAQ;IAIvC,CAAC;CACF;AAYD,SAAS,OAAO,CAAC,IAAsB,EAAE,GAAW,EAAE,KAAa;IACjE,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,KAAK,KAAK,CAAC;IAC1D,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,oGAAoG;AACpG,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,GAAG,GAAG,GAAuE,CAAC;IACpF,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC/E,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC;AAC7D,CAAC;AAED,SAAS,KAAK,CAAC,IAAY;IACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;;GAGG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAee;IACD;IACN;IAhBrB,MAAM,GAAG,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC3C,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClD,UAAU,GAAG,IAAI,GAAG,EAAgC,CAAC;IACrD,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,OAAO,GAAuB,EAAE,CAAC;IAC1C,SAAS,GAA2C,IAAI,CAAC;IACzD,oBAAoB,GAAwB,IAAI,CAAC;IACjD,SAAS,GAA2B,IAAI,CAAC;IACzC,OAAO,GAAsC,IAAI,CAAC;IAClD,IAAI,GAAoB,KAAK,CAAC;IACrB,OAAO,CAA2B;IAEnD,YAC6C,SAA2B,EAC5B,OAAwB,EAC9B,SAAoB,EACf,OAAkC;QAHhC,cAAS,GAAT,SAAS,CAAkB;QAC5B,YAAO,GAAP,OAAO,CAAiB;QAC9B,cAAS,GAAT,SAAS,CAAW;QAGxD,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACM,MAAM,GAAoB,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,8BAA8B,CAAC,UAAU,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAoC,CAAC;YACjF,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;IAEF,iDAAiD;IACjD,mBAAmB;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,qBAAqB,IAAI,iBAAiB,CAC5F,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7C,IAAI,CAAC,SAAS,GAAG,MAAM,QAAQ,CAAC;gBAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE;gBAC3C,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClF,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QACtE,CAAC;QAED,wFAAwF;QACxF,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QACjD,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC9B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU;YAAE,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAEO,QAAQ;QACd,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAA+C,CAAC;YACzE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBAAE,SAAS;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAW,CAAC;YACxD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,CAEtD,CAAC;gBACd,IAAI,CAAC,KAAK,EAAE,MAAM;oBAAE,SAAS;gBAC7B,MAAM,EAAE,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxC,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;wBAAE,SAAS;oBACrE,MAAM,IAAI,KAAK,CACb,6DAA6D,EAAE,gFAAgF,CAChJ,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,qEAAqE;IAC7D,YAAY,CAAC,GAAW,EAAE,KAAa;QAC7C,MAAM,GAAG,GAAG,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC;QAC/B,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5C,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAC/C,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,kBAAkB;QACxB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACrC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACnC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpD,CAAC;qBAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAChC,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,EAAE,CAAC;wBACxC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG;4BAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,oBAAoB,GAAG,mBAAmB,CAAC,CAAC,IAAI,EAAE,EAAE;YACvD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,SAAS,CAAC,IAAY;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QACtC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEgB,OAAO,GAAG,CAAC,GAAY,EAAQ,EAAE;QAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;YAAE,OAAO;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,sFAAsF;YACtF,IAAI,SAAS,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC3B,MAAM,QAAQ,GAAG,CACf,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,CAC9C,CAAC;YACpB,KAAK,MAAM,QAAQ,IAAI,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzF,IAAI,CAAC,SAAS,KAAK,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CACrD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,QAAQ,CAAC,EAAE,oBAAoB,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CACtF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,sGAAsG;IAC9F,KAAK,CAAC,KAAK;QACjB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE,CAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,kBAAkB,UAAU,CAAC,MAAM,6CAA6C,SAAS,CAAC,KAAK,CAAC,EAAE,CACnG,CAAC;QACJ,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;CACF,CAAA;AA/LY,mBAAmB;IAD/B,UAAU,EAAE;IAgBR,WAAA,MAAM,CAAC,gBAAgB,CAAC,CAAA;IACxB,WAAA,MAAM,CAAC,eAAe,CAAC,CAAA;IACvB,WAAA,MAAM,CAAC,SAAS,CAAC,CAAA;IACjB,WAAA,QAAQ,EAAE,CAAA;IAAE,WAAA,MAAM,CAAC,mBAAmB,CAAC,CAAA;qCAHc,gBAAgB;QACnB,eAAe;QACnB,SAAS;GAjB/C,mBAAmB,CA+L/B;;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/nestjs/diagnostics.module.d.ts

@@ -1,6 +1,13 @@
 import { type DynamicModule } from '@nestjs/common';
+import { type DiagnosticsModuleAsyncOptions, type DiagnosticsModuleOptions } from './diagnostics.options.js';
+import type { TransportProvider } from './transports.js';
 export declare class DiagnosticsModule {
-    /** Register once at the app root; enables `@OnDiagnostic` on any provider. */
-    static forRoot(): DynamicModule;
+    /**
+     * Register once at the app root; enables `@OnDiagnostic` on any provider. Pick a `default`
+     * transport to run listeners across processes.
+     */
+    static forRoot<TTransports extends Record<string, TransportProvider>>(options?: DiagnosticsModuleOptions<TTransports>): DynamicModule;
+    /** Like {@link forRoot}, with options built from injected providers. */
+    static forRootAsync(options: DiagnosticsModuleAsyncOptions): DynamicModule;
 }
 //# sourceMappingURL=diagnostics.module.d.ts.map

package/dist/nestjs/diagnostics.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.module.d.ts","sourceRoot":"","sources":["../../src/nestjs/diagnostics.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAI5D,qBACa,iBAAiB;IAC5B,8EAA8E;IAC9E,MAAM,CAAC,OAAO,IAAI,aAAa;CAQhC"}
+{"version":3,"file":"diagnostics.module.d.ts","sourceRoot":"","sources":["../../src/nestjs/diagnostics.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAG5D,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,qBACa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAClE,OAAO,GAAE,wBAAwB,CAAC,WAAW,CAAM,GAClD,aAAa;IAShB,wEAAwE;IACxE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,6BAA6B,GAAG,aAAa;CAe3E"}

package/dist/nestjs/diagnostics.module.js

@@ -8,14 +8,34 @@ var DiagnosticsModule_1;
 import { Module } from '@nestjs/common';
 import { DiscoveryModule } from '@nestjs/core';
 import { DiagnosticsExplorer } from './diagnostics.explorer.js';
+import { DIAGNOSTICS_OPTIONS, } from './diagnostics.options.js';
 let DiagnosticsModule = DiagnosticsModule_1 = class DiagnosticsModule {
-    /** Register once at the app root; enables `@OnDiagnostic` on any provider. */
-    static forRoot() {
+    /**
+     * Register once at the app root; enables `@OnDiagnostic` on any provider. Pick a `default`
+     * transport to run listeners across processes.
+     */
+    static forRoot(options = {}) {
         return {
             module: DiagnosticsModule_1,
             global: true,
             imports: [DiscoveryModule],
-            providers: [DiagnosticsExplorer],
+            providers: [{ provide: DIAGNOSTICS_OPTIONS, useValue: options }, DiagnosticsExplorer],
+        };
+    }
+    /** Like {@link forRoot}, with options built from injected providers. */
+    static forRootAsync(options) {
+        return {
+            module: DiagnosticsModule_1,
+            global: true,
+            imports: [DiscoveryModule, ...(options.imports ?? [])],
+            providers: [
+                {
+                    provide: DIAGNOSTICS_OPTIONS,
+                    useFactory: options.useFactory,
+                    inject: (options.inject ?? []),
+                },
+                DiagnosticsExplorer,
+            ],
         };
     }
 };

package/dist/nestjs/diagnostics.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.module.js","sourceRoot":"","sources":["../../src/nestjs/diagnostics.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGzD,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B,8EAA8E;IAC9E,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,CAAC,eAAe,CAAC;YAC1B,SAAS,EAAE,CAAC,mBAAmB,CAAC;SACjC,CAAC;IACJ,CAAC;CACF,CAAA;AAVY,iBAAiB;IAD7B,MAAM,CAAC,EAAE,CAAC;GACE,iBAAiB,CAU7B"}
+{"version":3,"file":"diagnostics.module.js","sourceRoot":"","sources":["../../src/nestjs/diagnostics.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAI3B,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,OAAO,CACZ,UAAiD,EAAE;QAEnD,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,CAAC,eAAe,CAAC;YAC1B,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,mBAAmB,CAAC;SACtF,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,YAAY,CAAC,OAAsC;QACxD,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,CAAC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACtD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,mBAAmB;oBAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAU;iBACxC;gBACD,mBAAmB;aACpB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAhCY,iBAAiB;IAD7B,MAAM,CAAC,EAAE,CAAC;GACE,iBAAiB,CAgC7B"}

package/dist/nestjs/diagnostics.options.d.ts

@@ -0,0 +1,31 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { DiagnosticsRole } from './role.js';
+import type { TransportProvider } from './transports.js';
+/** Injection token of the {@link DiagnosticsModuleOptions}. */
+export declare const DIAGNOSTICS_OPTIONS: unique symbol;
+/**
+ * Options of `DiagnosticsModule.forRoot()`. Without a `default` transport, listeners run in the
+ * emitting process (local).
+ */
+export interface DiagnosticsModuleOptions<TTransports extends Record<string, TransportProvider> = Record<string, TransportProvider>> {
+    /**
+     * Which half of a split deployment this process is: `'all'` (default), `'api'` (emits and hands
+     * work to the transport, never consumes or runs listeners) or `'worker'` (consumes and runs
+     * listeners). `'api'` and `'worker'` need a `default` transport.
+     */
+    role?: DiagnosticsRole;
+    /** Name of the transport (a key of `transports`) that starts at bootstrap. */
+    default?: keyof TTransports & string;
+    /** Named transports, built with the `transports` factory. Only `default` starts. */
+    transports?: TTransports;
+    /** Unique id of THIS process, for echo suppression. Default a random id. */
+    nodeId?: string;
+}
+/** Async configuration: build the options (and your Redis clients) from DI. */
+export interface DiagnosticsModuleAsyncOptions {
+    /** Modules whose exported providers the factory injects. */
+    imports?: DynamicModule['imports'];
+    inject?: unknown[];
+    useFactory: (...args: never[]) => Promise<DiagnosticsModuleOptions> | DiagnosticsModuleOptions;
+}
+//# sourceMappingURL=diagnostics.options.d.ts.map

package/dist/nestjs/diagnostics.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.options.d.ts","sourceRoot":"","sources":["../../src/nestjs/diagnostics.options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,eAAqD,CAAC;AAEtF;;;GAGG;AACH,MAAM,WAAW,wBAAwB,CACvC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEzF;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,CAAC;IACrC,oFAAoF;IACpF,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,6BAA6B;IAC5C,4DAA4D;IAC5D,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;CAChG"}

package/dist/nestjs/diagnostics.options.js

@@ -0,0 +1,3 @@
+/** Injection token of the {@link DiagnosticsModuleOptions}. */
+export const DIAGNOSTICS_OPTIONS = Symbol.for('@dudousxd/nestjs-diagnostics:options');
+//# sourceMappingURL=diagnostics.options.js.map

package/dist/nestjs/diagnostics.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.options.js","sourceRoot":"","sources":["../../src/nestjs/diagnostics.options.ts"],"names":[],"mappings":"AAIA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC"}

package/dist/nestjs/index.d.ts

@@ -1,6 +1,9 @@
-export { ON_DIAGNOSTIC_META, OnDiagnostic } from './on-diagnostic.decorator.js';
-export type { OnDiagnosticMeta } from './on-diagnostic.decorator.js';
+export { type DiagnosticEventOf, type ListenerEventMatcher, type ListenerMethodDecorator, ON_DIAGNOSTIC_META, OnDiagnostic, type OnDiagnosticMeta, } from './on-diagnostic.decorator.js';
 export { DiagnosticsModule } from './diagnostics.module.js';
-export { DiagnosticsExplorer } from './diagnostics.explorer.js';
+export { DIAGNOSTICS_OPTIONS, type DiagnosticsModuleAsyncOptions, type DiagnosticsModuleOptions, } from './diagnostics.options.js';
+export { DiagnosticsExplorer, type RegisteredListener, UnknownDiagnosticListenerError, } from './diagnostics.explorer.js';
+export type { DiagnosticsRole } from './role.js';
+export type { DeliveredEvent, DeliveryTransportContext, DurableDiagnosticsDeliveryModule, DurableTransportConfig, ListenerDelivery, ListenerDeliveryTransport, ListenerInvoker, } from './delivery.js';
+export { type QueueTransportConfig, type RedisTransportConfig, type TransportContext, type TransportHandle, type TransportProvider, transports, } from './transports.js';
 export { InjectCapability } from '../inject-capability.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/nestjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,YAAY,EACZ,KAAK,gBAAgB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,mBAAmB,EACnB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,gCAAgC,EAChC,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/nestjs/index.js

@@ -1,5 +1,7 @@
-export { ON_DIAGNOSTIC_META, OnDiagnostic } from './on-diagnostic.decorator.js';
+export { ON_DIAGNOSTIC_META, OnDiagnostic, } from './on-diagnostic.decorator.js';
 export { DiagnosticsModule } from './diagnostics.module.js';
-export { DiagnosticsExplorer } from './diagnostics.explorer.js';
+export { DIAGNOSTICS_OPTIONS, } from './diagnostics.options.js';
+export { DiagnosticsExplorer, UnknownDiagnosticListenerError, } from './diagnostics.explorer.js';
+export { transports, } from './transports.js';
 export { InjectCapability } from '../inject-capability.js';
 //# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,YAAY,GAEb,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EAEnB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAWnC,OAAO,EAML,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/nestjs/on-diagnostic.decorator.d.ts

@@ -1,18 +1,44 @@
+import type { DiagnosticEvent, EventOf, LibOf, PayloadOf } from '../types.js';
 /** Metadata key under which a method's @OnDiagnostic subscriptions accumulate. */
 export declare const ON_DIAGNOSTIC_META: unique symbol;
+/** Which events of a lib a listener receives: one exact name, a pattern, or every event. */
+export type ListenerEventMatcher = string | RegExp | undefined;
 /** One subscription declared on a method. `event` omitted = every event of `lib`. */
 export interface OnDiagnosticMeta {
     lib: string;
-    event?: string;
+    event?: string | RegExp;
 }
+/** The envelope a listener for `(TLib, TEvent)` receives, typed from the `ChannelRegistry`. */
+export type DiagnosticEventOf<TLib extends string, TEvent extends string> = DiagnosticEvent<PayloadOf<TLib, TEvent>>;
 /**
- * Subscribe a provider method to a diagnostics channel. Requires
- * `DiagnosticsModule.forRoot()` to be imported so the explorer wires it up.
+ * What a listener's parameter must accept: the registered envelope for a channel declared in the
+ * `ChannelRegistry`; any envelope otherwise, so handlers on untyped channels keep annotating their
+ * own payload type.
+ */
+type AnyEvent = DiagnosticEvent<any>;
+type ListenerEventOf<TLib extends string, TEvent extends string> = unknown extends PayloadOf<TLib, TEvent> ? AnyEvent : DiagnosticEventOf<TLib, TEvent>;
+type ListenerMethod<TEvent> = (event: TEvent) => unknown;
+/**
+ * The decorator {@link OnDiagnostic} returns. The decorated method's parameter must accept
+ * `TEvent`, so a channel declared in the `ChannelRegistry` checks the handler's payload type.
+ */
+export type ListenerMethodDecorator<TEvent> = <M extends ListenerMethod<TEvent>>(target: object, key: string | symbol, descriptor: TypedPropertyDescriptor<M>) => void;
+/**
+ * Make a provider method a diagnostics listener. Requires `DiagnosticsModule.forRoot()`.
+ *
+ * - `@OnDiagnostic('resilience', 'circuit-opened')`: the exact channel.
+ * - `@OnDiagnostic('durable', /^run\./)`: every event of the lib whose name matches.
+ * - `@OnDiagnostic('resilience')`: every `aviary:resilience:*` channel (current and future).
  *
- * - `@OnDiagnostic('resilience', 'circuit-opened')` — the exact channel.
- * - `@OnDiagnostic('resilience')` — every `aviary:resilience:*` channel (current + future).
+ * The listener id is `<ClassName>#<method>`. Delivering transports route work by it, so keep it
+ * stable while deliveries may be pending. Stackable: one method can listen to several channels
+ * and keeps one id.
  *
- * Stackable: apply more than once to react to several channels with one method.
+ * For a channel declared in the `ChannelRegistry`, the handler's parameter is checked against
+ * {@link DiagnosticEventOf}.
  */
-export declare function OnDiagnostic(lib: string, event?: string): MethodDecorator;
+export declare function OnDiagnostic<TLib extends LibOf>(lib: TLib): ListenerMethodDecorator<AnyEvent>;
+export declare function OnDiagnostic<TLib extends LibOf, TEvent extends EventOf<TLib>>(lib: TLib, event: TEvent): ListenerMethodDecorator<ListenerEventOf<TLib, TEvent>>;
+export declare function OnDiagnostic<TLib extends LibOf>(lib: TLib, event: RegExp): ListenerMethodDecorator<AnyEvent>;
+export {};
 //# sourceMappingURL=on-diagnostic.decorator.d.ts.map

package/dist/nestjs/on-diagnostic.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"on-diagnostic.decorator.d.ts","sourceRoot":"","sources":["../../src/nestjs/on-diagnostic.decorator.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,eAA2B,CAAC;AAE3D,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQzE"}
+{"version":3,"file":"on-diagnostic.decorator.d.ts","sourceRoot":"","sources":["../../src/nestjs/on-diagnostic.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9E,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,eAA2B,CAAC;AAE3D,4FAA4F;AAC5F,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/D,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,+FAA+F;AAC/F,MAAM,MAAM,iBAAiB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,eAAe,CACzF,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CACxB,CAAC;AAEF;;;;GAIG;AAEH,KAAK,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;AACrC,KAAK,eAAe,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,OAAO,SAAS,SAAS,CAC1F,IAAI,EACJ,MAAM,CACP,GACG,QAAQ,GACR,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAEpC,KAAK,cAAc,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,uBAAuB,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,EAC7E,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,UAAU,EAAE,uBAAuB,CAAC,CAAC,CAAC,KACnC,IAAI,CAAC;AAEV;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,KAAK,EAAE,GAAG,EAAE,IAAI,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAC/F,wBAAgB,YAAY,CAAC,IAAI,SAAS,KAAK,EAAE,MAAM,SAAS,OAAO,CAAC,IAAI,CAAC,EAC3E,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,MAAM,GACZ,uBAAuB,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1D,wBAAgB,YAAY,CAAC,IAAI,SAAS,KAAK,EAC7C,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,MAAM,GACZ,uBAAuB,CAAC,QAAQ,CAAC,CAAC"}

package/dist/nestjs/on-diagnostic.decorator.js

@@ -1,14 +1,5 @@
 /** Metadata key under which a method's @OnDiagnostic subscriptions accumulate. */
 export const ON_DIAGNOSTIC_META = Symbol('diagnostics:on');
-/**
- * Subscribe a provider method to a diagnostics channel. Requires
- * `DiagnosticsModule.forRoot()` to be imported so the explorer wires it up.
- *
- * - `@OnDiagnostic('resilience', 'circuit-opened')` — the exact channel.
- * - `@OnDiagnostic('resilience')` — every `aviary:resilience:*` channel (current + future).
- *
- * Stackable: apply more than once to react to several channels with one method.
- */
 export function OnDiagnostic(lib, event) {
     return (target, key) => {
         const existing = Reflect.getMetadata(ON_DIAGNOSTIC_META, target, key) ??

package/dist/nestjs/on-diagnostic.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"on-diagnostic.decorator.js","sourceRoot":"","sources":["../../src/nestjs/on-diagnostic.decorator.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAQ3D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAc;IACtD,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,QAAQ,GACX,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,CAAoC;YACxF,EAAE,CAAC;QACL,MAAM,IAAI,GAAqB,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAClF,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"on-diagnostic.decorator.js","sourceRoot":"","sources":["../../src/nestjs/on-diagnostic.decorator.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAiE3D,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,KAAuB;IAEvB,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,QAAQ,GACX,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,CAAoC;YACxF,EAAE,CAAC;QACL,MAAM,IAAI,GAAqB,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAClF,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC"}