@futurewindai/wotchi 0.1.0-beta.5 → 1.0.0-rc.1

package/dist/types/index.d.ts

@@ -1,11 +1,15 @@
 import { createWotchi } from "./core/client.js";
 import { registerWotchiProcessMonitor } from "./core/process-monitor.js";
+import { createWotchiPrometheusExporter, PROMETHEUS_CONTENT_TYPE } from "./core/prometheus.js";
+import { registerWotchiRuntimeWatcher } from "./core/runtime-monitor.js";
 import { consoleNotifier } from "./notifiers/console.js";
 import { telegramNotifier } from "./notifiers/telegram.js";
 import { webhookNotifier } from "./notifiers/webhook.js";
 export { WotchiConfigurationError } from "./core/errors.js";
 export type { ProcessMonitorHandle } from "./core/process-monitor.js";
 export type { NormalizedWotchiConfig } from "./core/config.js";
+export type { WotchiPrometheusExporter } from "./core/prometheus.js";
+export type { WotchiRuntimeWatcherHandle, WotchiRuntimeWatcherOptions, } from "./core/runtime-monitor.js";
 export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiEventKind, WotchiFingerprintOverride, WotchiFingerprintCallback, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "./core/types.js";
 export type { WebhookRequestFunction, WebhookRequestOptions, WebhookResponse, } from "./notifiers/webhook-http.js";
-export { consoleNotifier, createWotchi, registerWotchiProcessMonitor, telegramNotifier, webhookNotifier, };
+export { consoleNotifier, createWotchi, createWotchiPrometheusExporter, PROMETHEUS_CONTENT_TYPE, registerWotchiProcessMonitor, registerWotchiRuntimeWatcher, telegramNotifier, webhookNotifier, };

package/dist/types/integrations/express/status-observer.d.ts

@@ -1,6 +1,6 @@
 import type { RequestHandler } from "express";
 import type { WotchiClient } from "../../core/types.js";
-import type { RequestContextOptions } from "../request-context.js";
+import { type RequestContextOptions } from "../request-context.js";
 export type WotchiStatusClass = "4xx" | "5xx";
 export interface WotchiStatusObserverOptions extends RequestContextOptions {
     statusCodes?: readonly number[];

package/dist/types/integrations/nest/capture.d.ts

@@ -0,0 +1,4 @@
+import type { ArgumentsHost } from "@nestjs/common";
+import type { WotchiClient } from "../../core/types.js";
+import { type NestWotchiOptions } from "./request-context.js";
+export declare const captureWotchiNestException: (client: WotchiClient, exception: unknown, host: ArgumentsHost, options?: NestWotchiOptions) => void;

package/dist/types/integrations/nest/exception-filter.d.ts

@@ -1,10 +1,14 @@
 import { type ArgumentsHost, type HttpServer } from "@nestjs/common";
 import { BaseExceptionFilter } from "@nestjs/core";
 import type { WotchiClient } from "../../core/types.js";
-import { type NestWotchiOptions } from "./request-context.js";
+import type { NestExceptionFilterLike } from "./filter-wrapper.js";
+import type { NestWotchiOptions } from "./request-context.js";
 export declare class WotchiNestExceptionFilter extends BaseExceptionFilter<unknown> {
     private readonly client;
-    private readonly options?;
-    constructor(client: WotchiClient, applicationRef: HttpServer, options?: NestWotchiOptions | undefined);
+    private readonly previousGlobalFilters;
+    private readonly options;
+    constructor(client: WotchiClient, applicationRef?: HttpServer, options?: NestWotchiOptions, previousGlobalFilters?: readonly NestExceptionFilterLike[]);
     catch(exception: unknown, host: ArgumentsHost): void;
+    private respondWithoutLoggingRawUnknownException;
+    private respondThroughExpressAdapter;
 }

package/dist/types/integrations/nest/filter-wrapper.d.ts

@@ -0,0 +1,7 @@
+import type { ArgumentsHost } from "@nestjs/common";
+import type { WotchiClient } from "../../core/types.js";
+import type { NestWotchiOptions } from "./request-context.js";
+export interface NestExceptionFilterLike {
+    catch(exception: unknown, host: ArgumentsHost): void;
+}
+export declare function withWotchiNestFilter<TFilter extends NestExceptionFilterLike>(client: WotchiClient, filter: TFilter, options?: NestWotchiOptions): TFilter;

package/dist/types/integrations/nest/index.d.ts

@@ -1,5 +1,9 @@
 export { consoleNotifier, createWotchi, telegramNotifier, webhookNotifier } from "../../index.js";
+export { withWotchiNestFilter } from "./filter-wrapper.js";
+export { WotchiModule, WOTCHI_CLIENT } from "./module.js";
 export { registerWotchiNest, registerWotchiNestStatusObserver } from "./register.js";
 export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiFingerprintCallback, WotchiFingerprintOverride, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "../../index.js";
 export type { NestWotchiApplication, NestWotchiOptions } from "./register.js";
+export type { NestExceptionFilterLike } from "./filter-wrapper.js";
+export type { WotchiNestModuleOptions } from "./module.js";
 export type { WotchiStatusClass, WotchiStatusObserverOptions } from "../express/status-observer.js";

package/dist/types/integrations/nest/module.d.ts

@@ -0,0 +1,9 @@
+import { type DynamicModule } from "@nestjs/common";
+import type { WotchiConfig } from "../../core/types.js";
+export declare const WOTCHI_CLIENT: unique symbol;
+export interface WotchiNestModuleOptions {
+    registerGlobalFilter?: boolean;
+}
+export declare class WotchiModule {
+    static forRoot(config: WotchiConfig, options?: WotchiNestModuleOptions): DynamicModule;
+}

package/dist/types/integrations/nest/register.d.ts

@@ -8,6 +8,9 @@ export interface NestWotchiApplication {
     getHttpAdapter?: () => unknown;
     use?: (...middleware: unknown[]) => unknown;
     useGlobalFilters(...filters: unknown[]): unknown;
+    config?: {
+        getGlobalFilters?: () => unknown[];
+    };
 }
 export declare function registerWotchiNest(app: unknown, client: WotchiClient, options?: NestWotchiOptions): void;
 export declare function registerWotchiNestStatusObserver(app: unknown, client: WotchiClient, options?: WotchiStatusObserverOptions): void;

package/dist/types/integrations/request-context.d.ts

@@ -5,6 +5,7 @@ export interface RequestContextOptions {
     traceContextProperty?: string;
 }
 export declare function normalizeRoutePath(value: unknown): string | undefined;
+export declare function normalizeRequestContextOptions(options?: RequestContextOptions): Readonly<RequestContextOptions>;
 export interface RequestContextInput {
     request?: unknown;
     method?: unknown;

package/dist/types-cjs/core/admission.d.cts

@@ -0,0 +1,10 @@
+export interface CaptureAdmissionOptions {
+    maxEventsPerSecond: number;
+    burst: number;
+    now?: () => number;
+}
+export interface CaptureAdmission {
+    tryAcquire(): boolean;
+}
+/** A small token bucket used before normalization to bound overload work. */
+export declare function createCaptureAdmission(options: CaptureAdmissionOptions): CaptureAdmission;

package/dist/types-cjs/core/client.d.cts

@@ -1,2 +1,2 @@
-import type { WotchiClient, WotchiConfig } from "./types.js";
+import type { WotchiClient, WotchiConfig } from "./types.cjs";
 export declare function createWotchi(config: WotchiConfig): WotchiClient;

package/dist/types-cjs/core/config.d.cts

@@ -1,5 +1,5 @@
-import type { WotchiConfig, WotchiIncidentRule, WotchiLinkTemplates, WotchiNotifier } from "./types.js";
-import { WotchiConfigurationError } from "./errors.js";
+import type { WotchiConfig, WotchiIncidentRule, WotchiLinkTemplates, WotchiNotifier } from "./types.cjs";
+import { WotchiConfigurationError } from "./errors.cjs";
 export { WotchiConfigurationError };
 export interface NormalizedWotchiConfig {
     readonly service: string;
@@ -22,6 +22,16 @@ export interface NormalizedWotchiConfig {
     readonly queue: {
         readonly maxPendingAlerts: number;
         readonly concurrency: 1;
+        readonly notifierTimeoutMs: number;
+        readonly notifierCircuitBreaker: {
+            readonly failureThreshold: number;
+            readonly cooldownMs: number;
+        };
+    };
+    readonly overload?: {
+        readonly maxEventsPerSecond: number;
+        readonly burst: number;
+        readonly alertCooldownMs: number;
     };
     readonly privacy: {
         readonly redactKeys: readonly string[];

package/dist/types-cjs/core/diagnostics.d.cts

@@ -1,4 +1,4 @@
-import type { WotchiDiagnostics } from "./types.js";
+import type { WotchiDiagnostics } from "./types.cjs";
 export interface DiagnosticsState {
     capturedEvents: number;
     captureFailures: number;
@@ -6,6 +6,8 @@ export interface DiagnosticsState {
     filterFailures: number;
     beforeSendFailures: number;
     eventsSuppressed: number;
+    eventsDroppedOverload: number;
+    capturesAfterShutdown: number;
 }
 export declare function createDiagnosticsState(): DiagnosticsState;
-export declare function snapshotDiagnostics(state: DiagnosticsState, values: Omit<WotchiDiagnostics, "capturedEvents" | "captureFailures" | "fingerprintCallbackFailures" | "filterFailures" | "beforeSendFailures" | "eventsSuppressed">): Readonly<WotchiDiagnostics>;
+export declare function snapshotDiagnostics(state: DiagnosticsState, values: Omit<WotchiDiagnostics, "capturedEvents" | "captureFailures" | "fingerprintCallbackFailures" | "filterFailures" | "beforeSendFailures" | "eventsSuppressed" | "eventsDroppedOverload" | "capturesAfterShutdown">): Readonly<WotchiDiagnostics>;

package/dist/types-cjs/core/fingerprint.d.cts

@@ -1,3 +1,3 @@
-import type { SafeErrorEvent } from "./types.js";
+import type { SafeErrorEvent } from "./types.cjs";
 export declare function normalizeDynamicSegments(value: string): string;
 export declare function fingerprintSafeErrorEvent(event: SafeErrorEvent): string;

package/dist/types-cjs/core/group-store.d.cts

@@ -1,4 +1,4 @@
-import type { IncidentGroup, IncidentSeverity, SafeErrorEvent } from "./types.js";
+import type { IncidentGroup, IncidentSeverity, SafeErrorEvent } from "./types.cjs";
 export interface GroupStoreOptions {
     maxGroups: number;
     maxEventsPerWindow: number;

package/dist/types-cjs/core/incident-builder.d.cts

@@ -1,3 +1,3 @@
-import type { IncidentAlert, IncidentGroup } from "./types.js";
-import type { IncidentPolicyDecision } from "./incident-policy.js";
+import type { IncidentAlert, IncidentGroup } from "./types.cjs";
+import type { IncidentPolicyDecision } from "./incident-policy.cjs";
 export declare function buildIncidentAlert(group: IncidentGroup, decision: IncidentPolicyDecision): IncidentAlert;

package/dist/types-cjs/core/incident-policy.d.cts

@@ -1,5 +1,5 @@
-import type { IncidentGroup, IncidentSeverity } from "./types.js";
-export type IncidentEventKind = "error" | "manual" | "process-monitor";
+import type { IncidentGroup, IncidentSeverity } from "./types.cjs";
+export type IncidentEventKind = "error" | "manual" | "process-monitor" | "runtime-monitor";
 export interface IncidentPolicyInput {
     group: IncidentGroup;
     now: number;

package/dist/types-cjs/core/limits.d.cts

@@ -4,6 +4,10 @@ export declare const MAX_PENDING_ALERTS = 10000;
 export declare const MAX_WINDOW_MS: number;
 export declare const MAX_ALERT_THRESHOLD = 1000000;
 export declare const MAX_COOLDOWN_MS: number;
+export declare const MAX_CAPTURE_RATE = 1000000;
+export declare const MAX_NOTIFIER_TIMEOUT_MS = 60000;
+export declare const MAX_CIRCUIT_BREAKER_COOLDOWN_MS: number;
+export declare const MAX_CIRCUIT_BREAKER_FAILURES = 100;
 export declare const MAX_NORMALIZATION_DEPTH = 20;
 export declare const MAX_NORMALIZATION_KEYS = 10000;
 export declare const MAX_NORMALIZATION_STRING_LENGTH = 32768;

package/dist/types-cjs/core/notification-queue.d.cts

@@ -1,7 +1,12 @@
-import type { IncidentAlert, WotchiNotifier } from "./types.js";
+import type { IncidentAlert, WotchiNotifier } from "./types.cjs";
 export interface NotificationQueueOptions {
     maxPendingAlerts: number;
     concurrency: 1;
+    notifierTimeoutMs?: number;
+    notifierCircuitBreaker?: {
+        failureThreshold: number;
+        cooldownMs: number;
+    };
     onNotifierError?: (error: unknown, notifier: WotchiNotifier) => void;
 }
 export interface NotificationJobResult {
@@ -11,10 +16,14 @@ export interface NotificationJobResult {
 export interface NotificationQueue {
     enqueue(alert: IncidentAlert, notifiers: readonly WotchiNotifier[], onComplete?: (result: NotificationJobResult) => void): boolean;
     flush(timeoutMs?: number): Promise<void>;
+    close(timeoutMs?: number): Promise<void>;
+    isClosed(): boolean;
     pending(): number;
     alertsQueued(): number;
     alertsDropped(): number;
     alertsSent(): number;
     notifierFailures(): number;
+    notifierTimeouts(): number;
+    notifierCircuitOpenSkips(): number;
 }
 export declare function createNotificationQueue(options: NotificationQueueOptions): NotificationQueue;

package/dist/types-cjs/core/process-monitor.d.cts

@@ -1,4 +1,4 @@
-import type { WotchiClient } from "./types.js";
+import type { WotchiClient } from "./types.cjs";
 export interface ProcessMonitorHandle {
     unregister(): void;
 }

package/dist/types-cjs/core/prometheus.d.cts

@@ -0,0 +1,7 @@
+import type { WotchiClient } from "./types.cjs";
+export declare const PROMETHEUS_CONTENT_TYPE = "text/plain; version=0.0.4; charset=utf-8";
+export interface WotchiPrometheusExporter {
+    readonly contentType: typeof PROMETHEUS_CONTENT_TYPE;
+    render(): string;
+}
+export declare function createWotchiPrometheusExporter(client: Pick<WotchiClient, "getDiagnostics">): WotchiPrometheusExporter;

package/dist/types-cjs/core/redact.d.cts

@@ -1,4 +1,4 @@
-import type { NormalizedError, SafeNormalizedValue } from "./normalize.js";
+import type { NormalizedError, SafeNormalizedValue } from "./normalize.cjs";
 export declare const REDACTED = "[REDACTED]";
 export interface RedactionOptions {
     redactKeys?: readonly string[];

package/dist/types-cjs/core/runtime-monitor.d.cts

@@ -0,0 +1,15 @@
+import type { WotchiClient } from "./types.cjs";
+export interface WotchiRuntimeWatcherOptions {
+    intervalMs?: number;
+    cpuPercent?: number;
+    rssBytes?: number;
+    heapUsedBytes?: number;
+    eventLoopDelayMs?: number;
+    pendingAlerts?: number;
+    notifierFailures?: number;
+    alertThreshold?: number;
+}
+export interface WotchiRuntimeWatcherHandle {
+    unregister(): void;
+}
+export declare function registerWotchiRuntimeWatcher(client: Pick<WotchiClient, "captureEvent" | "getDiagnostics">, options?: WotchiRuntimeWatcherOptions): WotchiRuntimeWatcherHandle;

package/dist/types-cjs/core/types.d.cts

@@ -1,5 +1,5 @@
 export type IncidentSeverity = "low" | "medium" | "high" | "critical";
-export type WotchiEventKind = "error" | "manual" | "process-monitor";
+export type WotchiEventKind = "error" | "manual" | "process-monitor" | "runtime-monitor";
 export interface WotchiTraceContext {
     traceId?: string;
     spanId?: string;
@@ -160,6 +160,16 @@ export interface WotchiConfig {
     queue?: {
         maxPendingAlerts?: number;
         concurrency?: 1;
+        notifierTimeoutMs?: number;
+        notifierCircuitBreaker?: {
+            failureThreshold?: number;
+            cooldownMs?: number;
+        };
+    };
+    overload?: {
+        maxEventsPerSecond?: number;
+        burst?: number;
+        alertCooldownMs?: number;
     };
     privacy?: {
         redactKeys?: string[];
@@ -182,8 +192,12 @@ export interface WotchiDiagnostics {
     filterFailures: number;
     beforeSendFailures: number;
     eventsSuppressed: number;
+    eventsDroppedOverload: number;
+    capturesAfterShutdown: number;
     activeGroups: number;
     pendingAlerts: number;
+    notifierTimeouts: number;
+    notifierCircuitOpenSkips: number;
 }
 export type WotchiTestAlertStatus = "sent" | "queue-full" | "timeout" | "notifier-failed";
 export interface WotchiTestAlertResult {
@@ -201,5 +215,6 @@ export interface WotchiClient {
     captureEvent(event: WotchiEventInput): void;
     testAlert(): Promise<WotchiTestAlertResult>;
     flush(timeoutMs?: number): Promise<void>;
+    shutdown(timeoutMs?: number): Promise<void>;
     getDiagnostics(): Readonly<WotchiDiagnostics>;
 }

package/dist/types-cjs/index.d.cts

@@ -1,11 +1,15 @@
-import { createWotchi } from "./core/client.js";
-import { registerWotchiProcessMonitor } from "./core/process-monitor.js";
-import { consoleNotifier } from "./notifiers/console.js";
-import { telegramNotifier } from "./notifiers/telegram.js";
-import { webhookNotifier } from "./notifiers/webhook.js";
-export { WotchiConfigurationError } from "./core/errors.js";
-export type { ProcessMonitorHandle } from "./core/process-monitor.js";
-export type { NormalizedWotchiConfig } from "./core/config.js";
-export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiEventKind, WotchiFingerprintOverride, WotchiFingerprintCallback, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "./core/types.js";
-export type { WebhookRequestFunction, WebhookRequestOptions, WebhookResponse, } from "./notifiers/webhook-http.js";
-export { consoleNotifier, createWotchi, registerWotchiProcessMonitor, telegramNotifier, webhookNotifier, };
+import { createWotchi } from "./core/client.cjs";
+import { registerWotchiProcessMonitor } from "./core/process-monitor.cjs";
+import { createWotchiPrometheusExporter, PROMETHEUS_CONTENT_TYPE } from "./core/prometheus.cjs";
+import { registerWotchiRuntimeWatcher } from "./core/runtime-monitor.cjs";
+import { consoleNotifier } from "./notifiers/console.cjs";
+import { telegramNotifier } from "./notifiers/telegram.cjs";
+import { webhookNotifier } from "./notifiers/webhook.cjs";
+export { WotchiConfigurationError } from "./core/errors.cjs";
+export type { ProcessMonitorHandle } from "./core/process-monitor.cjs";
+export type { NormalizedWotchiConfig } from "./core/config.cjs";
+export type { WotchiPrometheusExporter } from "./core/prometheus.cjs";
+export type { WotchiRuntimeWatcherHandle, WotchiRuntimeWatcherOptions, } from "./core/runtime-monitor.cjs";
+export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiEventKind, WotchiFingerprintOverride, WotchiFingerprintCallback, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "./core/types.cjs";
+export type { WebhookRequestFunction, WebhookRequestOptions, WebhookResponse, } from "./notifiers/webhook-http.cjs";
+export { consoleNotifier, createWotchi, createWotchiPrometheusExporter, PROMETHEUS_CONTENT_TYPE, registerWotchiProcessMonitor, registerWotchiRuntimeWatcher, telegramNotifier, webhookNotifier, };

package/dist/types-cjs/integrations/express/error-handler.d.cts

@@ -1,4 +1,4 @@
 import type { ErrorRequestHandler } from "express";
-import type { WotchiClient } from "../../core/types.js";
-import { type ExpressWotchiOptions } from "./request-context.js";
+import type { WotchiClient } from "../../core/types.cjs";
+import { type ExpressWotchiOptions } from "./request-context.cjs";
 export declare function createExpressErrorHandler(client: WotchiClient, options?: ExpressWotchiOptions): ErrorRequestHandler;

package/dist/types-cjs/integrations/express/index.d.cts

@@ -1,9 +1,9 @@
-import type { WotchiClient } from "../../core/types.js";
-import { createExpressErrorHandler } from "./error-handler.js";
-import type { ExpressWotchiOptions } from "./request-context.js";
-export { consoleNotifier, createWotchi, telegramNotifier, webhookNotifier } from "../../index.js";
-export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiFingerprintCallback, WotchiFingerprintOverride, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "../../index.js";
-export type { ExpressWotchiOptions } from "./request-context.js";
-export type { WotchiStatusClass, WotchiStatusObserverOptions } from "./status-observer.js";
-export { wotchiStatusObserver } from "./status-observer.js";
+import type { WotchiClient } from "../../core/types.cjs";
+import { createExpressErrorHandler } from "./error-handler.cjs";
+import type { ExpressWotchiOptions } from "./request-context.cjs";
+export { consoleNotifier, createWotchi, telegramNotifier, webhookNotifier } from "../../index.cjs";
+export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiFingerprintCallback, WotchiFingerprintOverride, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "../../index.cjs";
+export type { ExpressWotchiOptions } from "./request-context.cjs";
+export type { WotchiStatusClass, WotchiStatusObserverOptions } from "./status-observer.cjs";
+export { wotchiStatusObserver } from "./status-observer.cjs";
 export declare function wotchiErrorHandler(client: WotchiClient, options?: ExpressWotchiOptions): ReturnType<typeof createExpressErrorHandler>;

package/dist/types-cjs/integrations/express/request-context.d.cts

@@ -1,5 +1,5 @@
 import type { Request, Response } from "express";
-import { type RequestContextOptions } from "../request-context.js";
-import type { WotchiRequestContext } from "../../core/types.js";
+import { type RequestContextOptions } from "../request-context.cjs";
+import type { WotchiRequestContext } from "../../core/types.cjs";
 export type ExpressWotchiOptions = RequestContextOptions;
 export declare function getExpressRequestContext(request: Request, response: Response, options?: ExpressWotchiOptions): WotchiRequestContext | undefined;

package/dist/types-cjs/integrations/express/status-observer.d.cts

@@ -1,6 +1,6 @@
 import type { RequestHandler } from "express";
-import type { WotchiClient } from "../../core/types.js";
-import type { RequestContextOptions } from "../request-context.js";
+import type { WotchiClient } from "../../core/types.cjs";
+import { type RequestContextOptions } from "../request-context.cjs";
 export type WotchiStatusClass = "4xx" | "5xx";
 export interface WotchiStatusObserverOptions extends RequestContextOptions {
     statusCodes?: readonly number[];

package/dist/types-cjs/integrations/nest/capture.d.cts

@@ -0,0 +1,4 @@
+import type { ArgumentsHost } from "@nestjs/common";
+import type { WotchiClient } from "../../core/types.cjs";
+import { type NestWotchiOptions } from "./request-context.cjs";
+export declare const captureWotchiNestException: (client: WotchiClient, exception: unknown, host: ArgumentsHost, options?: NestWotchiOptions) => void;

package/dist/types-cjs/integrations/nest/exception-filter.d.cts

@@ -1,10 +1,14 @@
 import { type ArgumentsHost, type HttpServer } from "@nestjs/common";
 import { BaseExceptionFilter } from "@nestjs/core";
-import type { WotchiClient } from "../../core/types.js";
-import { type NestWotchiOptions } from "./request-context.js";
+import type { WotchiClient } from "../../core/types.cjs";
+import type { NestExceptionFilterLike } from "./filter-wrapper.cjs";
+import type { NestWotchiOptions } from "./request-context.cjs";
 export declare class WotchiNestExceptionFilter extends BaseExceptionFilter<unknown> {
     private readonly client;
-    private readonly options?;
-    constructor(client: WotchiClient, applicationRef: HttpServer, options?: NestWotchiOptions | undefined);
+    private readonly previousGlobalFilters;
+    private readonly options;
+    constructor(client: WotchiClient, applicationRef?: HttpServer, options?: NestWotchiOptions, previousGlobalFilters?: readonly NestExceptionFilterLike[]);
     catch(exception: unknown, host: ArgumentsHost): void;
+    private respondWithoutLoggingRawUnknownException;
+    private respondThroughExpressAdapter;
 }

package/dist/types-cjs/integrations/nest/filter-wrapper.d.cts

@@ -0,0 +1,7 @@
+import type { ArgumentsHost } from "@nestjs/common";
+import type { WotchiClient } from "../../core/types.cjs";
+import type { NestWotchiOptions } from "./request-context.cjs";
+export interface NestExceptionFilterLike {
+    catch(exception: unknown, host: ArgumentsHost): void;
+}
+export declare function withWotchiNestFilter<TFilter extends NestExceptionFilterLike>(client: WotchiClient, filter: TFilter, options?: NestWotchiOptions): TFilter;

package/dist/types-cjs/integrations/nest/index.d.cts

@@ -1,5 +1,9 @@
-export { consoleNotifier, createWotchi, telegramNotifier, webhookNotifier } from "../../index.js";
-export { registerWotchiNest, registerWotchiNestStatusObserver } from "./register.js";
-export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiFingerprintCallback, WotchiFingerprintOverride, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "../../index.js";
-export type { NestWotchiApplication, NestWotchiOptions } from "./register.js";
-export type { WotchiStatusClass, WotchiStatusObserverOptions } from "../express/status-observer.js";
+export { consoleNotifier, createWotchi, telegramNotifier, webhookNotifier } from "../../index.cjs";
+export { withWotchiNestFilter } from "./filter-wrapper.cjs";
+export { WotchiModule, WOTCHI_CLIENT } from "./module.cjs";
+export { registerWotchiNest, registerWotchiNestStatusObserver } from "./register.cjs";
+export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WebhookNotifierOptions, WotchiBeforeSend, WotchiCaptureOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventFilter, WotchiEventInput, WotchiFingerprintCallback, WotchiFingerprintOverride, WotchiIncidentRule, WotchiLinkTemplates, WotchiLinks, WotchiNotifier, WotchiRequestContext, WotchiTags, WotchiTestAlertResult, WotchiTestAlertStatus, WotchiTraceContext, } from "../../index.cjs";
+export type { NestWotchiApplication, NestWotchiOptions } from "./register.cjs";
+export type { NestExceptionFilterLike } from "./filter-wrapper.cjs";
+export type { WotchiNestModuleOptions } from "./module.cjs";
+export type { WotchiStatusClass, WotchiStatusObserverOptions } from "../express/status-observer.cjs";

package/dist/types-cjs/integrations/nest/module.d.cts

@@ -0,0 +1,9 @@
+import { type DynamicModule } from "@nestjs/common";
+import type { WotchiConfig } from "../../core/types.cjs";
+export declare const WOTCHI_CLIENT: unique symbol;
+export interface WotchiNestModuleOptions {
+    registerGlobalFilter?: boolean;
+}
+export declare class WotchiModule {
+    static forRoot(config: WotchiConfig, options?: WotchiNestModuleOptions): DynamicModule;
+}

package/dist/types-cjs/integrations/nest/register.d.cts

@@ -1,13 +1,16 @@
 import { HttpAdapterHost } from "@nestjs/core";
-import type { WotchiClient } from "../../core/types.js";
-import type { NestWotchiOptions } from "./request-context.js";
-import type { WotchiStatusObserverOptions } from "../express/status-observer.js";
-export type { NestWotchiOptions } from "./request-context.js";
+import type { WotchiClient } from "../../core/types.cjs";
+import type { NestWotchiOptions } from "./request-context.cjs";
+import type { WotchiStatusObserverOptions } from "../express/status-observer.cjs";
+export type { NestWotchiOptions } from "./request-context.cjs";
 export interface NestWotchiApplication {
     get(token: typeof HttpAdapterHost): InstanceType<typeof HttpAdapterHost>;
     getHttpAdapter?: () => unknown;
     use?: (...middleware: unknown[]) => unknown;
     useGlobalFilters(...filters: unknown[]): unknown;
+    config?: {
+        getGlobalFilters?: () => unknown[];
+    };
 }
 export declare function registerWotchiNest(app: unknown, client: WotchiClient, options?: NestWotchiOptions): void;
 export declare function registerWotchiNestStatusObserver(app: unknown, client: WotchiClient, options?: WotchiStatusObserverOptions): void;

package/dist/types-cjs/integrations/nest/request-context.d.cts

@@ -1,5 +1,5 @@
 import type { ArgumentsHost } from "@nestjs/common";
-import { type RequestContextOptions } from "../request-context.js";
-import type { WotchiRequestContext } from "../../core/types.js";
+import { type RequestContextOptions } from "../request-context.cjs";
+import type { WotchiRequestContext } from "../../core/types.cjs";
 export type NestWotchiOptions = RequestContextOptions;
 export declare function getNestRequestContext(host: ArgumentsHost, exception: unknown, options?: NestWotchiOptions): WotchiRequestContext | undefined;

package/dist/types-cjs/integrations/request-context.d.cts

@@ -1,10 +1,11 @@
-import type { WotchiRequestContext } from "../core/types.js";
+import type { WotchiRequestContext } from "../core/types.cjs";
 export interface RequestContextOptions {
     requestIdProperty?: string;
     correlationIdProperty?: string;
     traceContextProperty?: string;
 }
 export declare function normalizeRoutePath(value: unknown): string | undefined;
+export declare function normalizeRequestContextOptions(options?: RequestContextOptions): Readonly<RequestContextOptions>;
 export interface RequestContextInput {
     request?: unknown;
     method?: unknown;

package/dist/types-cjs/notifiers/alert-payload.d.cts

@@ -1,5 +1,5 @@
-import type { SafeNormalizedValue } from "../core/normalize.js";
-import type { IncidentAlert } from "../core/types.js";
+import type { SafeNormalizedValue } from "../core/normalize.cjs";
+import type { IncidentAlert } from "../core/types.cjs";
 export type BoundedAlertPayload = Record<string, SafeNormalizedValue>;
 export declare function toBoundedPayload(value: unknown): BoundedAlertPayload;
 export declare function toBoundedAlertPayload(alert: IncidentAlert): BoundedAlertPayload;

package/dist/types-cjs/notifiers/console.d.cts

@@ -1,3 +1,3 @@
-import type { ConsoleNotifierOptions, IncidentAlert, WotchiNotifier } from "../core/types.js";
+import type { ConsoleNotifierOptions, IncidentAlert, WotchiNotifier } from "../core/types.cjs";
 export declare function formatConsoleAlert(alert: IncidentAlert, format?: "text" | "json"): string;
 export declare function consoleNotifier(options?: ConsoleNotifierOptions): WotchiNotifier;

package/dist/types-cjs/notifiers/telegram-format.d.cts

@@ -1,2 +1,2 @@
-import type { IncidentAlert } from "../core/types.js";
+import type { IncidentAlert } from "../core/types.cjs";
 export declare function formatTelegramAlert(alert: IncidentAlert): string;

package/dist/types-cjs/notifiers/telegram.d.cts

@@ -1,4 +1,4 @@
-import type { TelegramNotifierOptions, WotchiNotifier } from "../core/types.js";
-import { type TelegramRequestFunction } from "./telegram-http.js";
+import type { TelegramNotifierOptions, WotchiNotifier } from "../core/types.cjs";
+import { type TelegramRequestFunction } from "./telegram-http.cjs";
 export declare function createTelegramNotifier(options: TelegramNotifierOptions, request?: TelegramRequestFunction): WotchiNotifier;
 export declare function telegramNotifier(options: TelegramNotifierOptions): WotchiNotifier;

package/dist/types-cjs/notifiers/webhook-http.d.cts

@@ -1,4 +1,4 @@
-import type { IncidentAlert, WebhookNotifierOptions } from "../core/types.js";
+import type { IncidentAlert, WebhookNotifierOptions } from "../core/types.cjs";
 export interface WebhookRequestOptions {
     protocol: "http:" | "https:";
     hostname: string;

package/dist/types-cjs/notifiers/webhook.d.cts

@@ -1,4 +1,4 @@
-import type { WebhookNotifierOptions, WotchiNotifier } from "../core/types.js";
-import { type WebhookRequestFunction } from "./webhook-http.js";
+import type { WebhookNotifierOptions, WotchiNotifier } from "../core/types.cjs";
+import { type WebhookRequestFunction } from "./webhook-http.cjs";
 export declare function createWebhookNotifier(options: WebhookNotifierOptions, request?: WebhookRequestFunction): WotchiNotifier;
 export declare function webhookNotifier(options: WebhookNotifierOptions): WotchiNotifier;