@futurewindai/wotchi 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/esm/integrations/express/index.js

@@ -1,5 +1,6 @@
 import { createExpressErrorHandler } from "./error-handler.js";
 export { consoleNotifier, createWotchi, telegramNotifier } from "../../index.js";
+export { wotchiStatusObserver } from "./status-observer.js";
 export function wotchiErrorHandler(client, options) {
     return createExpressErrorHandler(client, options);
 }

package/dist/esm/integrations/express/state.js

@@ -0,0 +1,26 @@
+const WOTCHI_ERROR_CAPTURED = Symbol("wotchi.errorCaptured");
+const asMarkedRequest = (request) => typeof request === "object" && request !== null ? request : undefined;
+export function markExpressErrorCaptured(request) {
+    const markedRequest = asMarkedRequest(request);
+    if (markedRequest === undefined) {
+        return;
+    }
+    try {
+        markedRequest[WOTCHI_ERROR_CAPTURED] = true;
+    }
+    catch {
+        // A request object can be frozen by host middleware; the observer remains best-effort.
+    }
+}
+export function wasExpressErrorCaptured(request) {
+    const markedRequest = asMarkedRequest(request);
+    if (markedRequest === undefined) {
+        return false;
+    }
+    try {
+        return markedRequest[WOTCHI_ERROR_CAPTURED] === true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/esm/integrations/express/status-observer.js

@@ -0,0 +1,77 @@
+import { getExpressRequestContext } from "./request-context.js";
+import { wasExpressErrorCaptured } from "./state.js";
+const DEFAULT_STATUS_CODES = [401, 403, 429];
+const DEFAULT_STATUS_CLASSES = ["5xx"];
+const MAX_STATUS_CODES = 100;
+const normalizeStatuses = (values, defaults) => {
+    const selected = values ?? defaults;
+    if (selected.length > MAX_STATUS_CODES) {
+        throw new TypeError("statusCodes must contain at most 100 values");
+    }
+    for (const status of selected) {
+        if (!Number.isSafeInteger(status) || status < 100 || status > 599) {
+            throw new TypeError("statusCodes must contain HTTP status codes from 100 through 599");
+        }
+    }
+    return new Set(selected);
+};
+const normalizeStatusClasses = (values) => {
+    const selected = values ?? DEFAULT_STATUS_CLASSES;
+    for (const statusClass of selected) {
+        if (statusClass !== "4xx" && statusClass !== "5xx") {
+            throw new TypeError('statusClasses must contain only "4xx" or "5xx"');
+        }
+    }
+    return new Set(selected);
+};
+const normalizeAlertThreshold = (value) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isSafeInteger(value) || value <= 0 || value > 1_000_000) {
+        throw new TypeError("alertThreshold must be a positive integer no greater than 1000000");
+    }
+    return value;
+};
+const normalizeOptions = (options) => {
+    const alertThreshold = normalizeAlertThreshold(options?.alertThreshold);
+    return {
+        ...(options?.requestIdProperty === undefined
+            ? {}
+            : { requestIdProperty: options.requestIdProperty }),
+        statusCodes: normalizeStatuses(options?.statusCodes, DEFAULT_STATUS_CODES),
+        statusClasses: normalizeStatusClasses(options?.statusClasses),
+        ignoreStatusCodes: normalizeStatuses(options?.ignoreStatusCodes, []),
+        ...(alertThreshold === undefined ? {} : { alertThreshold }),
+    };
+};
+const isObservedStatus = (statusCode, options) => !options.ignoreStatusCodes.has(statusCode) &&
+    (options.statusCodes.has(statusCode) ||
+        (statusCode >= 400 && statusCode < 500 && options.statusClasses.has("4xx")) ||
+        (statusCode >= 500 && statusCode < 600 && options.statusClasses.has("5xx")));
+export function wotchiStatusObserver(client, options) {
+    const normalizedOptions = normalizeOptions(options);
+    return (request, response, next) => {
+        response.once("finish", () => {
+            const statusCode = response.statusCode;
+            if (wasExpressErrorCaptured(request) || !isObservedStatus(statusCode, normalizedOptions)) {
+                return;
+            }
+            try {
+                const requestContext = getExpressRequestContext(request, response, normalizedOptions);
+                client.captureEvent({
+                    level: "error",
+                    message: `HTTP ${statusCode} response`,
+                    ...(normalizedOptions.alertThreshold === undefined
+                        ? {}
+                        : { alertThreshold: normalizedOptions.alertThreshold }),
+                    ...(requestContext === undefined ? {} : { request: requestContext }),
+                });
+            }
+            catch {
+                // Status observation must never change the host response lifecycle.
+            }
+        });
+        next();
+    };
+}

package/dist/esm/integrations/nest/index.js

@@ -1,2 +1,2 @@
 export { consoleNotifier, createWotchi, telegramNotifier } from "../../index.js";
-export { registerWotchiNest } from "./register.js";
+export { registerWotchiNest, registerWotchiNestStatusObserver } from "./register.js";

package/dist/esm/integrations/nest/register.js

@@ -1,5 +1,6 @@
 import { HttpAdapterHost } from "@nestjs/core";
 import { WotchiNestExceptionFilter } from "./exception-filter.js";
+import { wotchiStatusObserver } from "../express/status-observer.js";
 export function registerWotchiNest(app, client, options) {
     const application = app;
     const directAdapter = application.getHttpAdapter?.();
@@ -8,3 +9,10 @@ export function registerWotchiNest(app, client, options) {
         : directAdapter;
     application.useGlobalFilters(new WotchiNestExceptionFilter(client, httpAdapter, options));
 }
+export function registerWotchiNestStatusObserver(app, client, options) {
+    const application = app;
+    if (typeof application.use !== "function") {
+        throw new TypeError("Nest application does not expose use(); an Express-based adapter is required");
+    }
+    application.use(wotchiStatusObserver(client, options));
+}

package/dist/esm/notifiers/console.js

@@ -1,19 +1,39 @@
+import { redactValue } from "../core/redact.js";
 const MAX_FIELD_LENGTH = 1_000;
 const MAX_ACTIONS = 5;
 const limit = (value, maxLength = MAX_FIELD_LENGTH) => value.slice(0, maxLength);
-export function formatConsoleAlert(alert) {
-    const actions = alert.suggestedActions
+const safeText = (value, maxLength = MAX_FIELD_LENGTH) => {
+    const redacted = redactValue(value, { maxStringLength: maxLength });
+    return typeof redacted === "string" ? limit(redacted, maxLength) : "[unreadable value]";
+};
+const boundedAlert = (alert) => ({
+    title: safeText(alert.title),
+    fingerprint: safeText(alert.fingerprint),
+    severity: alert.severity,
+    summary: safeText(alert.summary),
+    suggestedActions: alert.suggestedActions
         .slice(0, MAX_ACTIONS)
-        .map((action) => `- ${limit(action, 300)}`)
-        .join("\n");
+        .map((action) => safeText(action, 300)),
+    firstSeenAt: safeText(alert.firstSeenAt, 100),
+    lastSeenAt: safeText(alert.lastSeenAt, 100),
+    occurrences: Number.isSafeInteger(alert.occurrences) && alert.occurrences >= 0 ? alert.occurrences : 0,
+    service: safeText(alert.service, 300),
+    environment: safeText(alert.environment, 300),
+});
+export function formatConsoleAlert(alert, format = "text") {
+    const bounded = boundedAlert(alert);
+    if (format === "json") {
+        return JSON.stringify(bounded);
+    }
+    const actions = bounded.suggestedActions.map((action) => `- ${action}`).join("\n");
     return [
-        limit(alert.title),
-        `Service: ${limit(alert.service, 300)}`,
-        `Environment: ${limit(alert.environment, 300)}`,
-        `Summary: ${limit(alert.summary)}`,
-        `Occurrences: ${alert.occurrences}`,
-        `First seen: ${limit(alert.firstSeenAt, 100)}`,
-        `Last seen: ${limit(alert.lastSeenAt, 100)}`,
+        bounded.title,
+        `Service: ${bounded.service}`,
+        `Environment: ${bounded.environment}`,
+        `Summary: ${bounded.summary}`,
+        `Occurrences: ${bounded.occurrences}`,
+        `First seen: ${bounded.firstSeenAt}`,
+        `Last seen: ${bounded.lastSeenAt}`,
         "Suggested checks:",
         actions,
     ].join("\n");
@@ -23,7 +43,7 @@ export function consoleNotifier(options) {
     return {
         name: "console",
         async send(alert) {
-            write(formatConsoleAlert(alert));
+            write(formatConsoleAlert(alert, options?.format ?? "text"));
         },
     };
 }

package/dist/types/core/types.d.ts

@@ -11,6 +11,7 @@ export interface WotchiEventInput {
     kind?: WotchiEventKind;
     message: string;
     error?: unknown;
+    alertThreshold?: number;
     metadata?: Record<string, unknown>;
     context?: Record<string, unknown>;
     request?: WotchiRequestContext;
@@ -59,6 +60,7 @@ export interface WotchiNotifier {
 }
 export interface ConsoleNotifierOptions {
     write?: (line: string) => void;
+    format?: "text" | "json";
 }
 export interface TelegramNotifierOptions {
     botToken: string;

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

@@ -4,4 +4,6 @@ import type { ExpressWotchiOptions } from "./request-context.js";
 export { consoleNotifier, createWotchi, telegramNotifier } from "../../index.js";
 export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventInput, WotchiNotifier, WotchiRequestContext, } from "../../index.js";
 export type { ExpressWotchiOptions } from "./request-context.js";
+export type { WotchiStatusClass, WotchiStatusObserverOptions } from "./status-observer.js";
+export { wotchiStatusObserver } from "./status-observer.js";
 export declare function wotchiErrorHandler(client: WotchiClient, options?: ExpressWotchiOptions): ReturnType<typeof createExpressErrorHandler>;

package/dist/types/integrations/express/state.d.ts

@@ -0,0 +1,2 @@
+export declare function markExpressErrorCaptured(request: unknown): void;
+export declare function wasExpressErrorCaptured(request: unknown): boolean;

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

@@ -0,0 +1,11 @@
+import type { RequestHandler } from "express";
+import type { WotchiClient } from "../../core/types.js";
+import type { RequestContextOptions } from "../request-context.js";
+export type WotchiStatusClass = "4xx" | "5xx";
+export interface WotchiStatusObserverOptions extends RequestContextOptions {
+    statusCodes?: readonly number[];
+    statusClasses?: readonly WotchiStatusClass[];
+    ignoreStatusCodes?: readonly number[];
+    alertThreshold?: number;
+}
+export declare function wotchiStatusObserver(client: WotchiClient, options?: WotchiStatusObserverOptions): RequestHandler;

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

@@ -1,4 +1,5 @@
 export { consoleNotifier, createWotchi, telegramNotifier } from "../../index.js";
-export { registerWotchiNest } from "./register.js";
+export { registerWotchiNest, registerWotchiNestStatusObserver } from "./register.js";
 export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventInput, WotchiNotifier, WotchiRequestContext, } from "../../index.js";
 export type { NestWotchiApplication, NestWotchiOptions } from "./register.js";
+export type { WotchiStatusClass, WotchiStatusObserverOptions } from "../express/status-observer.js";

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

@@ -1,10 +1,13 @@
 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";
 export interface NestWotchiApplication {
     get(token: typeof HttpAdapterHost): InstanceType<typeof HttpAdapterHost>;
     getHttpAdapter?: () => unknown;
+    use?: (...middleware: unknown[]) => unknown;
     useGlobalFilters(...filters: unknown[]): 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/notifiers/console.d.ts

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

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

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

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

@@ -0,0 +1,29 @@
+import type { WotchiConfig, WotchiNotifier } from "./types.js";
+import { WotchiConfigurationError } from "./errors.js";
+export { WotchiConfigurationError };
+export interface NormalizedWotchiConfig {
+    readonly service: string;
+    readonly environment: string;
+    readonly release?: string;
+    readonly enabled: boolean;
+    readonly grouping: {
+        readonly windowMs: number;
+        readonly alertThreshold: number;
+        readonly cooldownMs: number;
+        readonly maxGroups: number;
+        readonly maxEventsPerWindow: number;
+    };
+    readonly queue: {
+        readonly maxPendingAlerts: number;
+        readonly concurrency: 1;
+    };
+    readonly privacy: {
+        readonly redactKeys: readonly string[];
+        readonly maxDepth: number;
+        readonly maxKeys: number;
+        readonly maxStringLength: number;
+        readonly maxStackLength: number;
+    };
+    readonly notifiers: readonly WotchiNotifier[];
+}
+export declare function validateConfig(config: WotchiConfig): Readonly<NormalizedWotchiConfig>;

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

@@ -0,0 +1,7 @@
+import type { WotchiDiagnostics } from "./types.js";
+export interface DiagnosticsState {
+    capturedEvents: number;
+    captureFailures: number;
+}
+export declare function createDiagnosticsState(): DiagnosticsState;
+export declare function snapshotDiagnostics(state: DiagnosticsState, values: Omit<WotchiDiagnostics, "capturedEvents" | "captureFailures">): Readonly<WotchiDiagnostics>;

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

@@ -0,0 +1,3 @@
+export declare class WotchiConfigurationError extends Error {
+    constructor(message: string);
+}

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

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

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

@@ -0,0 +1,15 @@
+import type { IncidentGroup, IncidentSeverity, SafeErrorEvent } from "./types.js";
+export interface GroupStoreOptions {
+    maxGroups: number;
+    maxEventsPerWindow: number;
+    windowMs: number;
+    now?: () => number;
+}
+export interface GroupStore {
+    record(fingerprint: string, event: SafeErrorEvent, severity?: IncidentSeverity): IncidentGroup;
+    get(fingerprint: string): IncidentGroup | undefined;
+    markAlerted(fingerprint: string, timestamp?: number): IncidentGroup | undefined;
+    size(): number;
+    groupsEvicted(): number;
+}
+export declare function createGroupStore(options: GroupStoreOptions): GroupStore;

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

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

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

@@ -0,0 +1,15 @@
+import type { IncidentGroup, IncidentSeverity } from "./types.js";
+export type IncidentEventKind = "error" | "manual" | "process-monitor";
+export interface IncidentPolicyInput {
+    group: IncidentGroup;
+    now: number;
+    alertThreshold: number;
+    cooldownMs: number;
+    eventKind?: IncidentEventKind;
+    manualSeverity?: IncidentSeverity;
+}
+export interface IncidentPolicyDecision {
+    shouldAlert: boolean;
+    severity: IncidentSeverity;
+}
+export declare function evaluateIncidentPolicy(input: IncidentPolicyInput): IncidentPolicyDecision;

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

@@ -0,0 +1,17 @@
+export interface NormalizationLimits {
+    maxDepth: number;
+    maxKeys: number;
+    maxStringLength: number;
+    maxStackLength: number;
+}
+export type SafeNormalizedValue = null | boolean | number | string | SafeNormalizedValue[] | {
+    [key: string]: SafeNormalizedValue;
+};
+export interface NormalizedError {
+    name: string;
+    message: string;
+    stack?: string;
+    code?: string;
+}
+export declare function normalizeUnknown(value: unknown, limits?: Partial<NormalizationLimits>): SafeNormalizedValue;
+export declare function normalizeError(error: unknown, limits?: Partial<NormalizationLimits>): NormalizedError;

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

@@ -0,0 +1,16 @@
+import type { IncidentAlert, WotchiNotifier } from "./types.js";
+export interface NotificationQueueOptions {
+    maxPendingAlerts: number;
+    concurrency: 1;
+    onNotifierError?: (error: unknown, notifier: WotchiNotifier) => void;
+}
+export interface NotificationQueue {
+    enqueue(alert: IncidentAlert, notifiers: readonly WotchiNotifier[]): boolean;
+    flush(timeoutMs?: number): Promise<void>;
+    pending(): number;
+    alertsQueued(): number;
+    alertsDropped(): number;
+    alertsSent(): number;
+    notifierFailures(): number;
+}
+export declare function createNotificationQueue(options: NotificationQueueOptions): NotificationQueue;

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

@@ -0,0 +1,5 @@
+import type { WotchiClient } from "./types.js";
+export interface ProcessMonitorHandle {
+    unregister(): void;
+}
+export declare function registerWotchiProcessMonitor(client: WotchiClient): ProcessMonitorHandle;

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

@@ -0,0 +1,11 @@
+import type { NormalizedError, SafeNormalizedValue } from "./normalize.js";
+export declare const REDACTED = "[REDACTED]";
+export interface RedactionOptions {
+    redactKeys?: readonly string[];
+    maxDepth?: number;
+    maxKeys?: number;
+    maxStringLength?: number;
+    maxStackLength?: number;
+}
+export declare function redactValue(value: unknown, options?: RedactionOptions): SafeNormalizedValue;
+export declare function redactError(error: NormalizedError, options?: RedactionOptions): NormalizedError;

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

@@ -0,0 +1,12 @@
+export interface RollingWindowOptions {
+    maxEvents: number;
+    windowMs: number;
+    now?: () => number;
+}
+export interface RollingWindow {
+    add(timestamp?: number): void;
+    count(timestamp?: number): number;
+    size(timestamp?: number): number;
+    timestamps(timestamp?: number): readonly number[];
+}
+export declare function createRollingWindow(options: RollingWindowOptions): RollingWindow;

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

@@ -0,0 +1,2 @@
+export declare function normalizeStackFrame(frame: string): string;
+export declare function selectApplicationFrame(stack?: string): string | undefined;

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

@@ -0,0 +1,111 @@
+export type IncidentSeverity = "low" | "medium" | "high" | "critical";
+export type WotchiEventKind = "error" | "manual" | "process-monitor";
+export interface WotchiRequestContext extends Record<string, unknown> {
+    method?: string;
+    route?: string;
+    statusCode?: number;
+    requestId?: string;
+}
+export interface WotchiEventInput {
+    level: "error";
+    kind?: WotchiEventKind;
+    message: string;
+    error?: unknown;
+    alertThreshold?: number;
+    metadata?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    request?: WotchiRequestContext;
+}
+export interface SafeErrorEvent {
+    id: string;
+    timestamp: string;
+    service: string;
+    environment: string;
+    release?: string;
+    error: {
+        name: string;
+        message: string;
+        stack?: string;
+        code?: string;
+    };
+    request?: WotchiRequestContext;
+    context?: Record<string, unknown>;
+}
+export interface IncidentGroup {
+    fingerprint: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    totalCount: number;
+    windowCount: number;
+    sample: SafeErrorEvent;
+    lastAlertedAt?: string;
+    severity: IncidentSeverity;
+}
+export interface IncidentAlert {
+    id: string;
+    fingerprint: string;
+    title: string;
+    severity: IncidentSeverity;
+    summary: string;
+    suggestedActions: string[];
+    firstSeenAt: string;
+    lastSeenAt: string;
+    occurrences: number;
+    service: string;
+    environment: string;
+}
+export interface WotchiNotifier {
+    readonly name: string;
+    send(alert: IncidentAlert): Promise<void>;
+}
+export interface ConsoleNotifierOptions {
+    write?: (line: string) => void;
+    format?: "text" | "json";
+}
+export interface TelegramNotifierOptions {
+    botToken: string;
+    chatId: string;
+    timeoutMs?: number;
+}
+export interface WotchiConfig {
+    service: string;
+    environment: string;
+    release?: string;
+    enabled?: boolean;
+    grouping?: {
+        windowMs?: number;
+        alertThreshold?: number;
+        cooldownMs?: number;
+        maxGroups?: number;
+        maxEventsPerWindow?: number;
+    };
+    queue?: {
+        maxPendingAlerts?: number;
+        concurrency?: 1;
+    };
+    privacy?: {
+        redactKeys?: string[];
+        maxDepth?: number;
+        maxKeys?: number;
+        maxStringLength?: number;
+        maxStackLength?: number;
+    };
+    notifiers: WotchiNotifier[];
+}
+export interface WotchiDiagnostics {
+    capturedEvents: number;
+    captureFailures: number;
+    groupsEvicted: number;
+    alertsQueued: number;
+    alertsDropped: number;
+    alertsSent: number;
+    notifierFailures: number;
+    activeGroups: number;
+    pendingAlerts: number;
+}
+export interface WotchiClient {
+    captureException(error: unknown, context?: Record<string, unknown>): void;
+    captureEvent(event: WotchiEventInput): void;
+    flush(timeoutMs?: number): Promise<void>;
+    getDiagnostics(): Readonly<WotchiDiagnostics>;
+}

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

@@ -0,0 +1,9 @@
+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";
+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, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventInput, WotchiEventKind, WotchiNotifier, WotchiRequestContext, } from "./core/types.js";
+export { consoleNotifier, createWotchi, registerWotchiProcessMonitor, telegramNotifier };

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

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

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

@@ -0,0 +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 } from "../../index.js";
+export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventInput, WotchiNotifier, WotchiRequestContext, } from "../../index.js";
+export type { ExpressWotchiOptions } from "./request-context.js";
+export type { WotchiStatusClass, WotchiStatusObserverOptions } from "./status-observer.js";
+export { wotchiStatusObserver } from "./status-observer.js";
+export declare function wotchiErrorHandler(client: WotchiClient, options?: ExpressWotchiOptions): ReturnType<typeof createExpressErrorHandler>;

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

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

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

@@ -0,0 +1,2 @@
+export declare function markExpressErrorCaptured(request: unknown): void;
+export declare function wasExpressErrorCaptured(request: unknown): boolean;

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

@@ -0,0 +1,11 @@
+import type { RequestHandler } from "express";
+import type { WotchiClient } from "../../core/types.js";
+import type { RequestContextOptions } from "../request-context.js";
+export type WotchiStatusClass = "4xx" | "5xx";
+export interface WotchiStatusObserverOptions extends RequestContextOptions {
+    statusCodes?: readonly number[];
+    statusClasses?: readonly WotchiStatusClass[];
+    ignoreStatusCodes?: readonly number[];
+    alertThreshold?: number;
+}
+export declare function wotchiStatusObserver(client: WotchiClient, options?: WotchiStatusObserverOptions): RequestHandler;

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

@@ -0,0 +1,10 @@
+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";
+export declare class WotchiNestExceptionFilter extends BaseExceptionFilter<unknown> {
+    private readonly client;
+    private readonly options?;
+    constructor(client: WotchiClient, applicationRef: HttpServer, options?: NestWotchiOptions | undefined);
+    catch(exception: unknown, host: ArgumentsHost): void;
+}

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

@@ -0,0 +1,5 @@
+export { consoleNotifier, createWotchi, telegramNotifier } from "../../index.js";
+export { registerWotchiNest, registerWotchiNestStatusObserver } from "./register.js";
+export type { ConsoleNotifierOptions, IncidentAlert, IncidentGroup, IncidentSeverity, SafeErrorEvent, TelegramNotifierOptions, WotchiClient, WotchiConfig, WotchiDiagnostics, WotchiEventInput, WotchiNotifier, WotchiRequestContext, } from "../../index.js";
+export type { NestWotchiApplication, NestWotchiOptions } from "./register.js";
+export type { WotchiStatusClass, WotchiStatusObserverOptions } from "../express/status-observer.js";

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

@@ -0,0 +1,13 @@
+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";
+export interface NestWotchiApplication {
+    get(token: typeof HttpAdapterHost): InstanceType<typeof HttpAdapterHost>;
+    getHttpAdapter?: () => unknown;
+    use?: (...middleware: unknown[]) => unknown;
+    useGlobalFilters(...filters: unknown[]): 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

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