@futurewindai/wotchi 0.1.0-beta.6 → 1.0.0

package/README.md

@@ -2,20 +2,21 @@
 
 > Low-noise error alerts for Node.js services.
 
-> **Status:** Public beta (`0.1.0-beta.6`). The API may evolve before the first stable release.
+> **Status:** Stable (`1.0.0`).
 
 [![CI](https://github.com/FutureWindAI/Wotchi/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/FutureWindAI/Wotchi/actions/workflows/ci.yml)
 [![CodeQL](https://github.com/FutureWindAI/Wotchi/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/FutureWindAI/Wotchi/actions/workflows/codeql.yml)
-[![npm](https://img.shields.io/npm/v/%40futurewindai%2Fwotchi?label=npm%20beta)](https://www.npmjs.com/package/@futurewindai/wotchi)
-[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/FutureWindAI/Wotchi/blob/v0.1.0-beta.6/LICENSE)
-[![Node.js 18–26](https://img.shields.io/badge/node-18%E2%80%9326-339933?logo=node.js&logoColor=white)](https://nodejs.org/en/about/previous-releases)
+[![npm](https://img.shields.io/npm/v/%40futurewindai%2Fwotchi?label=npm)](https://www.npmjs.com/package/@futurewindai/wotchi)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/LICENSE)
+[![Node.js 22.14+](https://img.shields.io/badge/node-%3E%3D22.14.0-339933?logo=node.js&logoColor=white)](https://nodejs.org/en/about/previous-releases)
 
+[Read the Wotchi story on Medium](https://medium.com/@alkazavr94/wotchi-low-noise-error-alerts-for-node-js-services-83cac7cf3f50)
 Wotchi captures application errors in-process, removes sensitive values, groups repeated failures, and delivers bounded console, Telegram, or HTTPS webhook alerts without changing framework response handling. It is a signal-conditioning layer, not a replacement for a full observability platform.
 
 ## Quick start
 
 ```bash
-npm install @futurewindai/wotchi@beta
+npm install @futurewindai/wotchi
 ```
 
 ```ts
@@ -61,7 +62,7 @@ notifier.
 | Bounded capture and queueing              | Repeated failures cannot create unbounded in-memory work.                                                      |
 | Redaction before processing               | Sensitive values are removed before grouping, logging, or transmission.                                        |
 | Grouping and cooldowns                    | Repeated failures produce a small number of useful alerts.                                                     |
-| Express 4/5 and NestJS 10/11 adapters     | Errors are observed while the framework keeps response ownership.                                              |
+| Express 4/5 and NestJS 10/11/12 adapters  | Errors are observed while the framework keeps response ownership.                                              |
 | ESM, CommonJS, and TypeScript types       | Use the package with common Node.js module setups.                                                             |
 | Console and optional Telegram notifiers   | Start locally or self-host delivery without a Wotchi control plane.                                            |
 | Generic HTTPS webhook notifier            | Route bounded JSON alerts to an existing internal alert destination.                                           |
@@ -81,12 +82,12 @@ durable incident history, cross-replica deduplication, dashboards, traces, or pa
 ## Performance evidence
 
 The package has zero direct runtime dependencies and keeps capture, grouping, and notification work
-bounded. On a Node.js 22/macOS arm64 benchmark run of beta.6, capture p95/p99 was
-`0.036 ms`/`0.036 ms`, duplicate-storm retained heap was `0.194 MiB`, and the packed artifact was
-`60,534 bytes`. Prometheus rendering p95 was `0.0048 ms`. The queue benchmark admitted `101` alerts while a notifier was blocked, capped
+bounded. On a Node.js 22.14/macOS arm64 stable-v1 reference run, capture p95/p99 was
+`0.0372 ms`/`0.0372 ms`, duplicate-storm retained heap was `0.192 MiB`, and the packed artifact was
+about `60.8 KB`. Prometheus rendering p95 was `0.0058 ms`. The queue benchmark admitted `101` alerts while a notifier was blocked, capped
 pending work at `100`, and kept Express and NestJS responses completing. These are reproducible local
 measurements, not production guarantees; repeat `npm run benchmark` and `npm run benchmark:queue`
-on your runtime and workload. See [performance evidence](docs/PERFORMANCE.md).
+on your runtime and workload. See [performance evidence](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/PERFORMANCE.md).
 
 The exporter does not open a server or send data. Attach it to a protected endpoint owned
 by the host application:
@@ -101,7 +102,7 @@ app.get("/metrics", (_request, response) => {
 });
 ```
 
-Beta.6 also supports opt-in admission control, notifier timeouts/circuits, graceful shutdown, and a
+Stable v1 also supports opt-in admission control, notifier timeouts/circuits, graceful shutdown, and a
 numeric-only runtime watcher.
 
 It emits only aggregate counters and queue/group gauges. Prometheus, Grafana, or another existing
@@ -162,9 +163,9 @@ export class AppModule {}
 ```
 
 For a custom dependency-injected `APP_FILTER`, keep its response and logging behavior, disable the
-automatic Wotchi filter, and wrap it with `withWotchiNestFilter`. See the [NestJS API](docs/API.md#nestjs-entry-point).
+automatic Wotchi filter, and wrap it with `withWotchiNestFilter`. See the [NestJS API](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/API.md#nestjs-entry-point).
 
-The package keeps compatibility with Node.js `>=18.18.0` and is tested across Node.js 18–26. Node.js 22 or 24 LTS is recommended for production. Express and NestJS adapters are optional subpath integrations, so applications only load the framework adapter they use.
+The package requires Node.js `>=22.14.0` and tests the Node.js 22, 24, and 26 release lines. Use a maintained LTS line—Node.js 22 or 24—for production. Express and NestJS adapters are optional subpath integrations, so applications only load the framework adapter they use.
 
 ## Telegram alerts
 
@@ -194,7 +195,7 @@ function requiredEnv(name: string): string {
 }
 ```
 
-Wotchi does not ship a shared bot token. Delivery is queued outside the request path and sends only the sanitized incident alert. See [configuration](https://github.com/FutureWindAI/Wotchi/blob/main/docs/CONFIGURATION.md) for notifier and security options.
+Wotchi does not ship a shared bot token. Delivery is queued outside the request path and sends only the sanitized incident alert. See [configuration](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/CONFIGURATION.md) for notifier and security options.
 
 ## HTTPS webhook alerts
 
@@ -260,7 +261,7 @@ Wotchi keeps grouping and cooldown state in one process. Replicas have independe
 reset groups, and a serverless instance can terminate before asynchronous delivery completes. An
 in-process SDK cannot reliably detect an OOM kill, frozen event loop, host failure, or unavailable
 network. Pair it with an external uptime monitor and keep graceful shutdown explicit; see the
-[production recipe](https://github.com/FutureWindAI/Wotchi/blob/main/examples/production-recipe/README.md).
+[production recipe](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/examples/production-recipe/README.md).
 
 ## Process monitoring
 
@@ -284,25 +285,25 @@ const monitor = registerWotchiProcessMonitor(wotchi);
 
 ## Documentation
 
-- [Getting started](https://github.com/FutureWindAI/Wotchi/blob/main/docs/GETTING_STARTED.md)
-- [Examples](https://github.com/FutureWindAI/Wotchi/blob/main/docs/EXAMPLES.md)
-- [API reference](https://github.com/FutureWindAI/Wotchi/blob/main/docs/API.md)
-- [Configuration](https://github.com/FutureWindAI/Wotchi/blob/main/docs/CONFIGURATION.md)
-- [Compatibility](https://github.com/FutureWindAI/Wotchi/blob/main/docs/COMPATIBILITY.md)
-- [Performance](https://github.com/FutureWindAI/Wotchi/blob/main/docs/PERFORMANCE.md)
-- [Architecture](https://github.com/FutureWindAI/Wotchi/blob/main/docs/ARCHITECTURE.md)
-- [Roadmap](https://github.com/FutureWindAI/Wotchi/blob/main/docs/ROADMAP.md)
-- [Troubleshooting](https://github.com/FutureWindAI/Wotchi/blob/main/docs/TROUBLESHOOTING.md)
-- [FAQ](https://github.com/FutureWindAI/Wotchi/blob/main/docs/FAQ.md)
-- [Security and privacy](https://github.com/FutureWindAI/Wotchi/blob/main/docs/SECURITY.md)
-- [Threat model](https://github.com/FutureWindAI/Wotchi/blob/main/docs/THREAT_MODEL.md)
-- [Contributing](https://github.com/FutureWindAI/Wotchi/blob/main/CONTRIBUTING.md)
-- [Changelog](https://github.com/FutureWindAI/Wotchi/blob/main/CHANGELOG.md)
+- [Getting started](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/GETTING_STARTED.md)
+- [Examples](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/EXAMPLES.md)
+- [API reference](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/API.md)
+- [Configuration](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/CONFIGURATION.md)
+- [Compatibility](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/COMPATIBILITY.md)
+- [Performance](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/PERFORMANCE.md)
+- [Architecture](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/ARCHITECTURE.md)
+- [Roadmap](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/ROADMAP.md)
+- [Troubleshooting](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/TROUBLESHOOTING.md)
+- [FAQ](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/FAQ.md)
+- [Security and privacy](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/SECURITY.md)
+- [Threat model](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/docs/THREAT_MODEL.md)
+- [Contributing](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/CONTRIBUTING.md)
+- [Changelog](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/CHANGELOG.md)
 - [GitHub releases](https://github.com/FutureWindAI/Wotchi/releases)
-- [Apache License 2.0](https://github.com/FutureWindAI/Wotchi/blob/main/LICENSE)
+- [Apache License 2.0](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/LICENSE)
 
 ## Security
 
-Do not include real secrets or customer error data in issues, examples, or test fixtures. Report security vulnerabilities privately using the [security policy](https://github.com/FutureWindAI/Wotchi/blob/main/SECURITY.md).
+Do not include real secrets or customer error data in issues, examples, or test fixtures. Report security vulnerabilities privately using the [security policy](https://github.com/FutureWindAI/Wotchi/blob/v1.0.0/SECURITY.md).
 
 Wotchi is open source and maintained by FutureWind AI.

package/SECURITY.md

@@ -2,9 +2,9 @@
 
 ## Supported Versions
 
-Wotchi targets applications running Node.js `>=18.18.0` and is built and tested across the Node.js 18–26 matrix. Node.js versions below 18.18 are not supported.
+Wotchi targets applications running Node.js `>=22.14.0` and tests the Node.js 22, 24, and 26 release lines. Node.js versions below 22.14 are not supported; use a maintained LTS line for production.
 
-The current package contains the framework-independent capture core, console, Telegram, and generic HTTPS webhook notifiers, Express 4/5 middleware, NestJS 10/11 exception-filter integration, optional HTTP status observation, and opt-in process monitoring. Supported runtime and framework combinations are documented after packed-tarball compatibility and release-security checks.
+The current package contains the framework-independent capture core, console, Telegram, and generic HTTPS webhook notifiers, Express 4/5 middleware, NestJS 10/11/12 exception-filter integration, optional HTTP status observation, and opt-in process monitoring. Supported runtime and framework combinations are documented after packed-tarball compatibility and release-security checks.
 
 ## Reporting a Vulnerability
 

package/dist/cjs/integrations/express/error-handler.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createExpressErrorHandler = createExpressErrorHandler;
-const request_context_js_1 = require("./request-context.js");
+const request_context_js_1 = require("../request-context.js");
+const request_context_js_2 = require("./request-context.js");
 const state_js_1 = require("./state.js");
 function createExpressErrorHandler(client, options) {
+    const normalizedOptions = (0, request_context_js_1.normalizeRequestContextOptions)(options);
     return (error, request, response, next) => {
         (0, state_js_1.markExpressErrorCaptured)(request);
         let captured = false;
@@ -15,7 +17,7 @@ function createExpressErrorHandler(client, options) {
             response.off("finish", captureAfterResponse);
             response.off("close", captureAfterResponse);
             try {
-                const requestContext = (0, request_context_js_1.getExpressRequestContext)(request, response, options);
+                const requestContext = (0, request_context_js_2.getExpressRequestContext)(request, response, normalizedOptions);
                 client.captureException(error, undefined, requestContext === undefined ? undefined : { request: requestContext });
             }
             catch {

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

@@ -2,29 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.markExpressErrorCaptured = markExpressErrorCaptured;
 exports.wasExpressErrorCaptured = wasExpressErrorCaptured;
-const WOTCHI_ERROR_CAPTURED = Symbol("wotchi.errorCaptured");
-const asMarkedRequest = (request) => typeof request === "object" && request !== null ? request : undefined;
+const capturedRequests = new WeakSet();
+const asRequestObject = (request) => typeof request === "object" && request !== null ? request : undefined;
 function markExpressErrorCaptured(request) {
-    const markedRequest = asMarkedRequest(request);
-    if (markedRequest === undefined) {
+    const requestObject = asRequestObject(request);
+    if (requestObject === undefined) {
         return;
     }
-    try {
-        markedRequest[WOTCHI_ERROR_CAPTURED] = true;
-    }
-    catch {
-        // A request object can be frozen by host middleware; the observer remains best-effort.
-    }
+    capturedRequests.add(requestObject);
 }
 function wasExpressErrorCaptured(request) {
-    const markedRequest = asMarkedRequest(request);
-    if (markedRequest === undefined) {
-        return false;
-    }
-    try {
-        return markedRequest[WOTCHI_ERROR_CAPTURED] === true;
-    }
-    catch {
-        return false;
-    }
+    const requestObject = asRequestObject(request);
+    return requestObject === undefined ? false : capturedRequests.has(requestObject);
 }

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wotchiStatusObserver = wotchiStatusObserver;
 const request_context_js_1 = require("./request-context.js");
+const request_context_js_2 = require("../request-context.js");
 const state_js_1 = require("./state.js");
 const DEFAULT_STATUS_CODES = [401, 403, 429];
 const DEFAULT_STATUS_CLASSES = ["5xx"];
@@ -38,16 +39,9 @@ const normalizeAlertThreshold = (value) => {
 };
 const normalizeOptions = (options) => {
     const alertThreshold = normalizeAlertThreshold(options?.alertThreshold);
+    const requestContextOptions = (0, request_context_js_2.normalizeRequestContextOptions)(options);
     return {
-        ...(options?.requestIdProperty === undefined
-            ? {}
-            : { requestIdProperty: options.requestIdProperty }),
-        ...(options?.correlationIdProperty === undefined
-            ? {}
-            : { correlationIdProperty: options.correlationIdProperty }),
-        ...(options?.traceContextProperty === undefined
-            ? {}
-            : { traceContextProperty: options.traceContextProperty }),
+        ...requestContextOptions,
         statusCodes: normalizeStatuses(options?.statusCodes, DEFAULT_STATUS_CODES),
         statusClasses: normalizeStatusClasses(options?.statusClasses),
         ignoreStatusCodes: normalizeStatuses(options?.ignoreStatusCodes, []),

package/dist/cjs/integrations/nest/exception-filter.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WotchiNestExceptionFilter = void 0;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
+const request_context_js_1 = require("../request-context.js");
 const capture_js_1 = require("./capture.js");
 const FILTER_CATCH_EXCEPTIONS = "__filterCatchExceptions__";
 const matchesException = (filter, exception) => {
@@ -27,8 +28,8 @@ let WotchiNestExceptionFilter = class WotchiNestExceptionFilter extends core_1.B
     constructor(client, applicationRef, options, previousGlobalFilters = []) {
         super(applicationRef);
         this.client = client;
-        this.options = options;
         this.previousGlobalFilters = previousGlobalFilters;
+        this.options = (0, request_context_js_1.normalizeRequestContextOptions)(options);
     }
     catch(exception, host) {
         (0, capture_js_1.captureWotchiNestException)(this.client, exception, host, this.options);

package/dist/cjs/integrations/nest/filter-wrapper.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withWotchiNestFilter = withWotchiNestFilter;
+const request_context_js_1 = require("../request-context.js");
 const capture_js_1 = require("./capture.js");
 function withWotchiNestFilter(client, filter, options) {
+    const normalizedOptions = (0, request_context_js_1.normalizeRequestContextOptions)(options);
     const wrapped = Object.create(filter);
     Object.defineProperty(wrapped, "catch", {
         configurable: false,
         enumerable: false,
         value: (exception, host) => {
-            (0, capture_js_1.captureWotchiNestException)(client, exception, host, options);
+            (0, capture_js_1.captureWotchiNestException)(client, exception, host, normalizedOptions);
             filter.catch(exception, host);
         },
         writable: false,

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerWotchiNest = registerWotchiNest;
 exports.registerWotchiNestStatusObserver = registerWotchiNestStatusObserver;
 const core_1 = require("@nestjs/core");
+const request_context_js_1 = require("../request-context.js");
 const exception_filter_js_1 = require("./exception-filter.js");
 const status_observer_js_1 = require("../express/status-observer.js");
 const isNestExceptionFilter = (value) => typeof value === "object" &&
@@ -20,12 +21,13 @@ const getPreviousGlobalFilters = (application) => {
         .reverse();
 };
 function registerWotchiNest(app, client, options) {
+    const normalizedOptions = (0, request_context_js_1.normalizeRequestContextOptions)(options);
     const application = app;
     const directAdapter = application.getHttpAdapter?.();
     const httpAdapter = directAdapter === undefined
         ? application.get(core_1.HttpAdapterHost).httpAdapter
         : directAdapter;
-    application.useGlobalFilters(new exception_filter_js_1.WotchiNestExceptionFilter(client, httpAdapter, options, getPreviousGlobalFilters(application)));
+    application.useGlobalFilters(new exception_filter_js_1.WotchiNestExceptionFilter(client, httpAdapter, normalizedOptions, getPreviousGlobalFilters(application)));
 }
 function registerWotchiNestStatusObserver(app, client, options) {
     const application = app;

package/dist/cjs/integrations/request-context.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeRoutePath = normalizeRoutePath;
+exports.normalizeRequestContextOptions = normalizeRequestContextOptions;
 exports.buildRequestContext = buildRequestContext;
 const MAX_ROUTE_LENGTH = 500;
 const MAX_REQUEST_ID_LENGTH = 200;
@@ -24,33 +25,25 @@ function normalizeRoutePath(value) {
     }
     return path.split("/").map(dynamicSegment).join("/").slice(0, MAX_ROUTE_LENGTH);
 }
-const normalizeRequestIdProperty = (property) => {
+const normalizePropertyName = (property, optionName) => {
     if (property === undefined) {
         return undefined;
     }
     if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(property)) {
-        throw new TypeError("requestIdProperty must be a simple property name");
-    }
-    return property;
-};
-const normalizeTraceContextProperty = (property) => {
-    if (property === undefined) {
-        return undefined;
-    }
-    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(property)) {
-        throw new TypeError("traceContextProperty must be a simple property name");
-    }
-    return property;
-};
-const normalizeCorrelationIdProperty = (property) => {
-    if (property === undefined) {
-        return undefined;
-    }
-    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(property)) {
-        throw new TypeError("correlationIdProperty must be a simple property name");
+        throw new TypeError(`${optionName} must be a simple property name`);
     }
     return property;
 };
+function normalizeRequestContextOptions(options) {
+    const requestIdProperty = normalizePropertyName(options?.requestIdProperty, "requestIdProperty");
+    const correlationIdProperty = normalizePropertyName(options?.correlationIdProperty, "correlationIdProperty");
+    const traceContextProperty = normalizePropertyName(options?.traceContextProperty, "traceContextProperty");
+    return Object.freeze({
+        ...(requestIdProperty === undefined ? {} : { requestIdProperty }),
+        ...(correlationIdProperty === undefined ? {} : { correlationIdProperty }),
+        ...(traceContextProperty === undefined ? {} : { traceContextProperty }),
+    });
+}
 const readRequestId = (request, property) => {
     if (property === undefined || !isRecord(request)) {
         return undefined;
@@ -108,9 +101,8 @@ const readCorrelationId = (request, property) => {
     }
 };
 function buildRequestContext(input) {
-    const requestIdProperty = normalizeRequestIdProperty(input.options?.requestIdProperty);
-    const correlationIdProperty = normalizeCorrelationIdProperty(input.options?.correlationIdProperty);
-    const traceContextProperty = normalizeTraceContextProperty(input.options?.traceContextProperty);
+    const options = normalizeRequestContextOptions(input.options);
+    const { requestIdProperty, correlationIdProperty, traceContextProperty } = options;
     let requestId;
     try {
         requestId = readRequestId(input.request, requestIdProperty);

package/dist/esm/integrations/express/error-handler.js

@@ -1,6 +1,8 @@
+import { normalizeRequestContextOptions } from "../request-context.js";
 import { getExpressRequestContext } from "./request-context.js";
 import { markExpressErrorCaptured } from "./state.js";
 export function createExpressErrorHandler(client, options) {
+    const normalizedOptions = normalizeRequestContextOptions(options);
     return (error, request, response, next) => {
         markExpressErrorCaptured(request);
         let captured = false;
@@ -12,7 +14,7 @@ export function createExpressErrorHandler(client, options) {
             response.off("finish", captureAfterResponse);
             response.off("close", captureAfterResponse);
             try {
-                const requestContext = getExpressRequestContext(request, response, options);
+                const requestContext = getExpressRequestContext(request, response, normalizedOptions);
                 client.captureException(error, undefined, requestContext === undefined ? undefined : { request: requestContext });
             }
             catch {

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

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

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

@@ -1,4 +1,5 @@
 import { getExpressRequestContext } from "./request-context.js";
+import { normalizeRequestContextOptions } from "../request-context.js";
 import { wasExpressErrorCaptured } from "./state.js";
 const DEFAULT_STATUS_CODES = [401, 403, 429];
 const DEFAULT_STATUS_CLASSES = ["5xx"];
@@ -35,16 +36,9 @@ const normalizeAlertThreshold = (value) => {
 };
 const normalizeOptions = (options) => {
     const alertThreshold = normalizeAlertThreshold(options?.alertThreshold);
+    const requestContextOptions = normalizeRequestContextOptions(options);
     return {
-        ...(options?.requestIdProperty === undefined
-            ? {}
-            : { requestIdProperty: options.requestIdProperty }),
-        ...(options?.correlationIdProperty === undefined
-            ? {}
-            : { correlationIdProperty: options.correlationIdProperty }),
-        ...(options?.traceContextProperty === undefined
-            ? {}
-            : { traceContextProperty: options.traceContextProperty }),
+        ...requestContextOptions,
         statusCodes: normalizeStatuses(options?.statusCodes, DEFAULT_STATUS_CODES),
         statusClasses: normalizeStatusClasses(options?.statusClasses),
         ignoreStatusCodes: normalizeStatuses(options?.ignoreStatusCodes, []),

package/dist/esm/integrations/nest/exception-filter.js

@@ -9,6 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { Catch, HttpException } from "@nestjs/common";
 import { BaseExceptionFilter } from "@nestjs/core";
+import { normalizeRequestContextOptions } from "../request-context.js";
 import { captureWotchiNestException } from "./capture.js";
 const FILTER_CATCH_EXCEPTIONS = "__filterCatchExceptions__";
 const matchesException = (filter, exception) => {
@@ -24,8 +25,8 @@ let WotchiNestExceptionFilter = class WotchiNestExceptionFilter extends BaseExce
     constructor(client, applicationRef, options, previousGlobalFilters = []) {
         super(applicationRef);
         this.client = client;
-        this.options = options;
         this.previousGlobalFilters = previousGlobalFilters;
+        this.options = normalizeRequestContextOptions(options);
     }
     catch(exception, host) {
         captureWotchiNestException(this.client, exception, host, this.options);

package/dist/esm/integrations/nest/filter-wrapper.js

@@ -1,11 +1,13 @@
+import { normalizeRequestContextOptions } from "../request-context.js";
 import { captureWotchiNestException } from "./capture.js";
 export function withWotchiNestFilter(client, filter, options) {
+    const normalizedOptions = normalizeRequestContextOptions(options);
     const wrapped = Object.create(filter);
     Object.defineProperty(wrapped, "catch", {
         configurable: false,
         enumerable: false,
         value: (exception, host) => {
-            captureWotchiNestException(client, exception, host, options);
+            captureWotchiNestException(client, exception, host, normalizedOptions);
             filter.catch(exception, host);
         },
         writable: false,

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

@@ -1,4 +1,5 @@
 import { HttpAdapterHost } from "@nestjs/core";
+import { normalizeRequestContextOptions } from "../request-context.js";
 import { WotchiNestExceptionFilter } from "./exception-filter.js";
 import { wotchiStatusObserver } from "../express/status-observer.js";
 const isNestExceptionFilter = (value) => typeof value === "object" &&
@@ -16,12 +17,13 @@ const getPreviousGlobalFilters = (application) => {
         .reverse();
 };
 export function registerWotchiNest(app, client, options) {
+    const normalizedOptions = normalizeRequestContextOptions(options);
     const application = app;
     const directAdapter = application.getHttpAdapter?.();
     const httpAdapter = directAdapter === undefined
         ? application.get(HttpAdapterHost).httpAdapter
         : directAdapter;
-    application.useGlobalFilters(new WotchiNestExceptionFilter(client, httpAdapter, options, getPreviousGlobalFilters(application)));
+    application.useGlobalFilters(new WotchiNestExceptionFilter(client, httpAdapter, normalizedOptions, getPreviousGlobalFilters(application)));
 }
 export function registerWotchiNestStatusObserver(app, client, options) {
     const application = app;

package/dist/esm/integrations/request-context.js

@@ -20,33 +20,25 @@ export function normalizeRoutePath(value) {
     }
     return path.split("/").map(dynamicSegment).join("/").slice(0, MAX_ROUTE_LENGTH);
 }
-const normalizeRequestIdProperty = (property) => {
+const normalizePropertyName = (property, optionName) => {
     if (property === undefined) {
         return undefined;
     }
     if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(property)) {
-        throw new TypeError("requestIdProperty must be a simple property name");
-    }
-    return property;
-};
-const normalizeTraceContextProperty = (property) => {
-    if (property === undefined) {
-        return undefined;
-    }
-    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(property)) {
-        throw new TypeError("traceContextProperty must be a simple property name");
-    }
-    return property;
-};
-const normalizeCorrelationIdProperty = (property) => {
-    if (property === undefined) {
-        return undefined;
-    }
-    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(property)) {
-        throw new TypeError("correlationIdProperty must be a simple property name");
+        throw new TypeError(`${optionName} must be a simple property name`);
     }
     return property;
 };
+export function normalizeRequestContextOptions(options) {
+    const requestIdProperty = normalizePropertyName(options?.requestIdProperty, "requestIdProperty");
+    const correlationIdProperty = normalizePropertyName(options?.correlationIdProperty, "correlationIdProperty");
+    const traceContextProperty = normalizePropertyName(options?.traceContextProperty, "traceContextProperty");
+    return Object.freeze({
+        ...(requestIdProperty === undefined ? {} : { requestIdProperty }),
+        ...(correlationIdProperty === undefined ? {} : { correlationIdProperty }),
+        ...(traceContextProperty === undefined ? {} : { traceContextProperty }),
+    });
+}
 const readRequestId = (request, property) => {
     if (property === undefined || !isRecord(request)) {
         return undefined;
@@ -104,9 +96,8 @@ const readCorrelationId = (request, property) => {
     }
 };
 export function buildRequestContext(input) {
-    const requestIdProperty = normalizeRequestIdProperty(input.options?.requestIdProperty);
-    const correlationIdProperty = normalizeCorrelationIdProperty(input.options?.correlationIdProperty);
-    const traceContextProperty = normalizeTraceContextProperty(input.options?.traceContextProperty);
+    const options = normalizeRequestContextOptions(input.options);
+    const { requestIdProperty, correlationIdProperty, traceContextProperty } = options;
     let requestId;
     try {
         requestId = readRequestId(input.request, requestIdProperty);

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/exception-filter.d.ts

@@ -5,9 +5,9 @@ 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?;
     private readonly previousGlobalFilters;
-    constructor(client: WotchiClient, applicationRef?: HttpServer, options?: NestWotchiOptions | undefined, previousGlobalFilters?: readonly NestExceptionFilterLike[]);
+    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/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/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;

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;

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,4 +1,4 @@
-import type { IncidentGroup, IncidentSeverity } from "./types.js";
+import type { IncidentGroup, IncidentSeverity } from "./types.cjs";
 export type IncidentEventKind = "error" | "manual" | "process-monitor" | "runtime-monitor";
 export interface IncidentPolicyInput {
     group: IncidentGroup;

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

@@ -1,4 +1,4 @@
-import type { IncidentAlert, WotchiNotifier } from "./types.js";
+import type { IncidentAlert, WotchiNotifier } from "./types.cjs";
 export interface NotificationQueueOptions {
     maxPendingAlerts: number;
     concurrency: 1;

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

@@ -1,4 +1,4 @@
-import type { WotchiClient } from "./types.js";
+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;

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

@@ -1,4 +1,4 @@
-import type { WotchiClient } from "./types.js";
+import type { WotchiClient } from "./types.cjs";
 export interface WotchiRuntimeWatcherOptions {
     intervalMs?: number;
     cpuPercent?: number;

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

@@ -1,15 +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";
+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

@@ -1,4 +1,4 @@
 import type { ArgumentsHost } from "@nestjs/common";
-import type { WotchiClient } from "../../core/types.js";
-import { type NestWotchiOptions } from "./request-context.js";
+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,13 +1,13 @@
 import { type ArgumentsHost, type HttpServer } from "@nestjs/common";
 import { BaseExceptionFilter } from "@nestjs/core";
-import type { WotchiClient } from "../../core/types.js";
-import type { NestExceptionFilterLike } from "./filter-wrapper.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?;
     private readonly previousGlobalFilters;
-    constructor(client: WotchiClient, applicationRef?: HttpServer, options?: NestWotchiOptions | undefined, previousGlobalFilters?: readonly NestExceptionFilterLike[]);
+    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

@@ -1,6 +1,6 @@
 import type { ArgumentsHost } from "@nestjs/common";
-import type { WotchiClient } from "../../core/types.js";
-import type { NestWotchiOptions } from "./request-context.js";
+import type { WotchiClient } from "../../core/types.cjs";
+import type { NestWotchiOptions } from "./request-context.cjs";
 export interface NestExceptionFilterLike {
     catch(exception: unknown, host: ArgumentsHost): void;
 }

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

@@ -1,9 +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";
+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

@@ -1,5 +1,5 @@
 import { type DynamicModule } from "@nestjs/common";
-import type { WotchiConfig } from "../../core/types.js";
+import type { WotchiConfig } from "../../core/types.cjs";
 export declare const WOTCHI_CLIENT: unique symbol;
 export interface WotchiNestModuleOptions {
     registerGlobalFilter?: boolean;

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

@@ -1,8 +1,8 @@
 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;

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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futurewindai/wotchi",
-  "version": "0.1.0-beta.6",
+  "version": "1.0.0",
   "description": "Low-noise error alerts for Node.js, Express, and NestJS applications",
   "keywords": [
     "nodejs",
@@ -17,7 +17,7 @@
   "license": "Apache-2.0",
   "type": "module",
   "engines": {
-    "node": ">=18.18.0"
+    "node": ">=22.14.0"
   },
   "sideEffects": false,
   "publishConfig": {
@@ -86,16 +86,16 @@
     "stand": "node scripts/start-test-stand.mjs",
     "stand:production": "node scripts/start-nest-production-stand.mjs",
     "typecheck": "tsc -p tsconfig.base.json --noEmit",
-    "lint": "eslint .",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
+    "lint": "eslint src test scripts examples eslint.config.mjs",
+    "format": "prettier --write .github CHANGELOG.md CODE_OF_CONDUCT.md CONTRIBUTING.md README.md SECURITY.md docs examples eslint.config.mjs package-lock.json package.json scripts src test tsconfig.base.json tsconfig.cjs.json tsconfig.esm.json tsconfig.test.json tsconfig.types.json",
+    "format:check": "prettier --check .github CHANGELOG.md CODE_OF_CONDUCT.md CONTRIBUTING.md README.md SECURITY.md docs examples eslint.config.mjs package-lock.json package.json scripts src test tsconfig.base.json tsconfig.cjs.json tsconfig.esm.json tsconfig.test.json tsconfig.types.json",
     "test:compile": "tsc -p tsconfig.test.json",
     "test": "npm run test:compile && node --test .test-dist/test/unit/*.test.js .test-dist/test/integration/express/*.test.js .test-dist/test/integration/nest/*.test.js .test-dist/test/security/*.test.js",
     "pack:dry-run": "npm run build && npm pack --dry-run --json",
     "verify:package": "npm run build && node scripts/verify-package.mjs",
     "verify:published-metadata": "node scripts/verify-published-metadata.mjs",
     "test:compat": "npm run build && node test/compatibility/package-exports.smoke.cjs && node test/compatibility/framework-isolation.cjs",
-    "test:compat:matrix": "npm run build && node scripts/run-compatibility-matrix.mjs",
+    "test:compat:matrix": "npm run build && node scripts/run-compatibility-matrix.mjs --framework all --module both",
     "benchmark": "npm run build && node --expose-gc scripts/run-benchmarks.mjs",
     "benchmark:queue": "npm run test:compile && node --test .test-dist/test/performance/queue-saturation.bench.js",
     "security:audit": "npm audit --audit-level=moderate",
@@ -103,8 +103,8 @@
     "security:all": "npm run security:audit && npm run security:osv"
   },
   "peerDependencies": {
-    "@nestjs/common": "^10.4.0 || ^11.0.0",
-    "@nestjs/core": "^10.4.0 || ^11.0.0",
+    "@nestjs/common": "^10.4.0 || ^11.0.0 || ^12.0.1",
+    "@nestjs/core": "^10.4.0 || ^11.0.0 || ^12.0.1",
     "express": "^4.18.0 || ^5.0.0",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.0"
@@ -128,11 +128,11 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@nestjs/common": "^11.1.28",
-    "@nestjs/core": "^11.1.28",
-    "@nestjs/platform-express": "^11.1.28",
+    "@nestjs/common": "^12.0.1",
+    "@nestjs/core": "^12.0.1",
+    "@nestjs/platform-express": "^12.0.1",
     "@types/express": "^5.0.6",
-    "@types/node": "^16.18.126",
+    "@types/node": "^22.20.1",
     "eslint": "^10.8.0",
     "express": "^5.2.1",
     "prettier": "^3.9.6",