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

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 state_js_1 = require("../express/state.js");
 const request_context_js_1 = require("./request-context.js");
 let WotchiNestExceptionFilter = class WotchiNestExceptionFilter extends core_1.BaseExceptionFilter {
     constructor(client, applicationRef, options) {
@@ -21,7 +22,14 @@ let WotchiNestExceptionFilter = class WotchiNestExceptionFilter extends core_1.B
     }
     catch(exception, host) {
         try {
-            this.client.captureException(exception, (0, request_context_js_1.getNestRequestContext)(host, exception, this.options));
+            (0, state_js_1.markExpressErrorCaptured)(host.switchToHttp().getRequest());
+        }
+        catch {
+            // Non-HTTP NestJS contexts do not expose an Express request to mark.
+        }
+        try {
+            const requestContext = (0, request_context_js_1.getNestRequestContext)(host, exception, this.options);
+            this.client.captureException(exception, undefined, requestContext === undefined ? undefined : { request: requestContext });
         }
         catch {
             // A capture failure must never change NestJS exception handling.

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

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerWotchiNestStatusObserver = exports.registerWotchiNest = exports.telegramNotifier = exports.createWotchi = exports.consoleNotifier = void 0;
+exports.registerWotchiNestStatusObserver = exports.registerWotchiNest = exports.webhookNotifier = exports.telegramNotifier = exports.createWotchi = exports.consoleNotifier = void 0;
 var index_js_1 = require("../../index.js");
 Object.defineProperty(exports, "consoleNotifier", { enumerable: true, get: function () { return index_js_1.consoleNotifier; } });
 Object.defineProperty(exports, "createWotchi", { enumerable: true, get: function () { return index_js_1.createWotchi; } });
 Object.defineProperty(exports, "telegramNotifier", { enumerable: true, get: function () { return index_js_1.telegramNotifier; } });
+Object.defineProperty(exports, "webhookNotifier", { enumerable: true, get: function () { return index_js_1.webhookNotifier; } });
 var register_js_1 = require("./register.js");
 Object.defineProperty(exports, "registerWotchiNest", { enumerable: true, get: function () { return register_js_1.registerWotchiNest; } });
 Object.defineProperty(exports, "registerWotchiNestStatusObserver", { enumerable: true, get: function () { return register_js_1.registerWotchiNestStatusObserver; } });

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

@@ -4,6 +4,7 @@ exports.normalizeRoutePath = normalizeRoutePath;
 exports.buildRequestContext = buildRequestContext;
 const MAX_ROUTE_LENGTH = 500;
 const MAX_REQUEST_ID_LENGTH = 200;
+const MAX_CORRELATION_ID_LENGTH = 200;
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const HEX_PATTERN = /^[0-9a-f]{8,}$/i;
 const isRecord = (value) => typeof value === "object" && value !== null;
@@ -32,6 +33,24 @@ const normalizeRequestIdProperty = (property) => {
     }
     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");
+    }
+    return property;
+};
 const readRequestId = (request, property) => {
     if (property === undefined || !isRecord(request)) {
         return undefined;
@@ -47,8 +66,51 @@ const readRequestId = (request, property) => {
         return undefined;
     }
 };
+const readTraceContext = (request, property) => {
+    if (property === undefined || !isRecord(request)) {
+        return undefined;
+    }
+    try {
+        if (!Object.prototype.hasOwnProperty.call(request, property)) {
+            return undefined;
+        }
+        const value = request[property];
+        if (!isRecord(value)) {
+            return undefined;
+        }
+        const traceId = typeof value.traceId === "string" ? value.traceId.slice(0, 128) : undefined;
+        const spanId = typeof value.spanId === "string" ? value.spanId.slice(0, 128) : undefined;
+        if (traceId === undefined && spanId === undefined) {
+            return undefined;
+        }
+        return {
+            ...(traceId === undefined ? {} : { traceId }),
+            ...(spanId === undefined ? {} : { spanId }),
+        };
+    }
+    catch {
+        return undefined;
+    }
+};
+const readCorrelationId = (request, property) => {
+    if (property === undefined || !isRecord(request)) {
+        return undefined;
+    }
+    try {
+        if (!Object.prototype.hasOwnProperty.call(request, property)) {
+            return undefined;
+        }
+        const value = request[property];
+        return typeof value === "string" ? value.slice(0, MAX_CORRELATION_ID_LENGTH) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
 function buildRequestContext(input) {
     const requestIdProperty = normalizeRequestIdProperty(input.options?.requestIdProperty);
+    const correlationIdProperty = normalizeCorrelationIdProperty(input.options?.correlationIdProperty);
+    const traceContextProperty = normalizeTraceContextProperty(input.options?.traceContextProperty);
     let requestId;
     try {
         requestId = readRequestId(input.request, requestIdProperty);
@@ -56,6 +118,22 @@ function buildRequestContext(input) {
     catch {
         requestId = undefined;
     }
+    let correlationId;
+    try {
+        correlationId = readCorrelationId(input.request, correlationIdProperty);
+    }
+    catch {
+        correlationId = undefined;
+    }
+    let trace;
+    try {
+        const explicitTrace = input.trace;
+        trace = readTraceContext({ trace: explicitTrace }, "trace");
+        trace ??= readTraceContext(input.request, traceContextProperty);
+    }
+    catch {
+        trace = undefined;
+    }
     const method = typeof input.method === "string" ? input.method.slice(0, 16) : undefined;
     const route = normalizeRoutePath(input.route);
     const statusCode = typeof input.statusCode === "number" && Number.isSafeInteger(input.statusCode)
@@ -64,7 +142,9 @@ function buildRequestContext(input) {
     if (method === undefined &&
         route === undefined &&
         statusCode === undefined &&
-        requestId === undefined) {
+        requestId === undefined &&
+        correlationId === undefined &&
+        trace === undefined) {
         return undefined;
     }
     return {
@@ -72,5 +152,7 @@ function buildRequestContext(input) {
         ...(route === undefined ? {} : { route }),
         ...(statusCode === undefined ? {} : { statusCode }),
         ...(requestId === undefined ? {} : { requestId }),
+        ...(correlationId === undefined ? {} : { correlationId }),
+        ...(trace === undefined ? {} : { trace }),
     };
 }

package/dist/cjs/notifiers/alert-payload.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBoundedPayload = toBoundedPayload;
+exports.toBoundedAlertPayload = toBoundedAlertPayload;
+const redact_js_1 = require("../core/redact.js");
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function toBoundedPayload(value) {
+    const redacted = (0, redact_js_1.redactValue)(value, {
+        maxDepth: 6,
+        maxKeys: 100,
+        maxStringLength: 1_000,
+        maxStackLength: 4_000,
+    });
+    return isRecord(redacted)
+        ? redacted
+        : { title: "Wotchi alert", summary: "Incident details were unavailable." };
+}
+function toBoundedAlertPayload(alert) {
+    return toBoundedPayload(alert);
+}

package/dist/cjs/notifiers/console.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatConsoleAlert = formatConsoleAlert;
 exports.consoleNotifier = consoleNotifier;
 const redact_js_1 = require("../core/redact.js");
+const alert_payload_js_1 = require("./alert-payload.js");
 const MAX_FIELD_LENGTH = 1_000;
 const MAX_ACTIONS = 5;
 const limit = (value, maxLength = MAX_FIELD_LENGTH) => value.slice(0, maxLength);
@@ -10,26 +11,94 @@ const safeText = (value, maxLength = MAX_FIELD_LENGTH) => {
     const redacted = (0, redact_js_1.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) => 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),
-});
+const safeJson = (value) => {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return "[unreadable value]";
+    }
+};
+const boundedAlert = (alert) => {
+    const payload = (0, alert_payload_js_1.toBoundedAlertPayload)(alert);
+    return {
+        ...payload,
+        title: safeText(typeof payload.title === "string" ? payload.title : alert.title),
+        fingerprint: safeText(typeof payload.fingerprint === "string" ? payload.fingerprint : alert.fingerprint),
+        severity: alert.severity,
+        summary: safeText(typeof payload.summary === "string" ? payload.summary : alert.summary),
+        suggestedActions: alert.suggestedActions
+            .slice(0, MAX_ACTIONS)
+            .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),
+    };
+};
+const textDetails = (alert) => {
+    const lines = [];
+    if (alert.release !== undefined) {
+        lines.push(`Release: ${safeText(alert.release, 200)}`);
+    }
+    if (alert.instance !== undefined) {
+        lines.push(`Instance: ${safeText(alert.instance, 200)}`);
+    }
+    if (alert.operation !== undefined) {
+        lines.push(`Operation: ${safeText(alert.operation, 200)}`);
+    }
+    if (alert.job !== undefined) {
+        lines.push(`Job: ${safeText(alert.job, 200)}`);
+    }
+    if (alert.correlationId !== undefined) {
+        lines.push(`Correlation ID: ${safeText(alert.correlationId, 200)}`);
+    }
+    if (alert.tags !== undefined) {
+        lines.push(`Tags: ${safeText(safeJson(alert.tags), 600)}`);
+    }
+    if (alert.error !== undefined) {
+        lines.push(`Error: ${safeText(alert.error.name, 300)} — ${safeText(alert.error.message, 600)}`);
+        if (alert.error.applicationFrame !== undefined) {
+            lines.push(`Application frame: ${safeText(alert.error.applicationFrame, 500)}`);
+        }
+    }
+    if (alert.request !== undefined) {
+        const request = [alert.request.method, alert.request.route].filter((value) => typeof value === "string");
+        if (alert.request.statusCode !== undefined) {
+            request.push(`status ${alert.request.statusCode}`);
+        }
+        if (request.length > 0) {
+            lines.push(`Request: ${request.join(" ")}`);
+        }
+        if (alert.request.requestId !== undefined) {
+            lines.push(`Request ID: ${safeText(alert.request.requestId, 200)}`);
+        }
+        if (alert.request.correlationId !== undefined) {
+            lines.push(`Correlation ID: ${safeText(alert.request.correlationId, 200)}`);
+        }
+    }
+    const trace = alert.trace ?? alert.request?.trace;
+    if (trace?.traceId !== undefined || trace?.spanId !== undefined) {
+        lines.push(`Trace: ${safeText(trace.traceId ?? "", 128)}${trace.spanId === undefined ? "" : ` span ${safeText(trace.spanId, 128)}`}`);
+    }
+    if (alert.context !== undefined) {
+        lines.push(`Context: ${safeText(safeJson(alert.context), 1_000)}`);
+    }
+    if (alert.links !== undefined) {
+        lines.push(`Links: ${safeText(safeJson(alert.links), 600)}`);
+    }
+    return lines;
+};
 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");
+    const actions = alert.suggestedActions
+        .slice(0, MAX_ACTIONS)
+        .map((action) => `- ${safeText(action, 300)}`)
+        .join("\n");
     return [
         bounded.title,
         `Service: ${bounded.service}`,
@@ -38,6 +107,7 @@ function formatConsoleAlert(alert, format = "text") {
         `Occurrences: ${bounded.occurrences}`,
         `First seen: ${bounded.firstSeenAt}`,
         `Last seen: ${bounded.lastSeenAt}`,
+        ...textDetails(alert),
         "Suggested checks:",
         actions,
     ].join("\n");

package/dist/cjs/notifiers/telegram-format.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatTelegramAlert = formatTelegramAlert;
+const redact_js_1 = require("../core/redact.js");
 const MAX_MESSAGE_LENGTH = 4_096;
 const MAX_ACTIONS = 5;
 const MAX_TITLE_LENGTH = 300;
@@ -8,9 +9,76 @@ const MAX_SERVICE_LENGTH = 300;
 const MAX_ENVIRONMENT_LENGTH = 300;
 const MAX_SUMMARY_LENGTH = 2_000;
 const MAX_ACTION_LENGTH = 600;
+const MAX_DETAIL_LENGTH = 900;
 const escapeHtml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 const limit = (value, maxLength) => value.slice(0, maxLength);
-const render = (title, service, environment, summary, actions, firstSeenAt, lastSeenAt, occurrences) => {
+const safeText = (value, maxLength) => {
+    const redacted = (0, redact_js_1.redactValue)(value, { maxStringLength: maxLength });
+    return typeof redacted === "string" ? limit(redacted, maxLength) : "[unreadable value]";
+};
+const safeJson = (value) => {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return "[unreadable value]";
+    }
+};
+const details = (alert) => {
+    const lines = [];
+    if (alert.release !== undefined) {
+        lines.push(`Release: ${safeText(alert.release, 200)}`);
+    }
+    if (alert.instance !== undefined) {
+        lines.push(`Instance: ${safeText(alert.instance, 200)}`);
+    }
+    if (alert.operation !== undefined) {
+        lines.push(`Operation: ${safeText(alert.operation, 200)}`);
+    }
+    if (alert.job !== undefined) {
+        lines.push(`Job: ${safeText(alert.job, 200)}`);
+    }
+    if (alert.correlationId !== undefined) {
+        lines.push(`Correlation ID: ${safeText(alert.correlationId, 200)}`);
+    }
+    if (alert.tags !== undefined) {
+        lines.push(`Tags: ${safeText(safeJson(alert.tags), MAX_DETAIL_LENGTH)}`);
+    }
+    if (alert.error !== undefined) {
+        lines.push(`Error: ${safeText(alert.error.name, 250)} — ${safeText(alert.error.message, 500)}`);
+        if (alert.error.applicationFrame !== undefined) {
+            lines.push(`Application frame: ${safeText(alert.error.applicationFrame, 500)}`);
+        }
+    }
+    if (alert.request !== undefined) {
+        const request = [alert.request.method, alert.request.route].filter((value) => typeof value === "string");
+        if (alert.request.statusCode !== undefined) {
+            request.push(`status ${alert.request.statusCode}`);
+        }
+        if (request.length > 0) {
+            lines.push(`Request: ${request.join(" ")}`);
+        }
+        if (alert.request.requestId !== undefined) {
+            lines.push(`Request ID: ${safeText(alert.request.requestId, 200)}`);
+        }
+        if (alert.request.correlationId !== undefined) {
+            lines.push(`Correlation ID: ${safeText(alert.request.correlationId, 200)}`);
+        }
+    }
+    const trace = alert.trace ?? alert.request?.trace;
+    if (trace?.traceId !== undefined || trace?.spanId !== undefined) {
+        lines.push(`Trace: ${safeText(trace.traceId ?? "", 128)}${trace.spanId === undefined ? "" : ` span ${safeText(trace.spanId, 128)}`}`);
+    }
+    if (alert.context !== undefined) {
+        const redacted = (0, redact_js_1.redactValue)(alert.context, { maxDepth: 4, maxKeys: 40, maxStringLength: 300 });
+        lines.push(`Context: ${safeText(safeJson(redacted), MAX_DETAIL_LENGTH)}`);
+    }
+    if (alert.links !== undefined) {
+        lines.push(`Links: ${safeText(safeJson(alert.links), MAX_DETAIL_LENGTH)}`);
+    }
+    return lines.map((line) => limit(line, MAX_DETAIL_LENGTH));
+};
+const render = (title, service, environment, summary, actions, context, firstSeenAt, lastSeenAt, occurrences) => {
     const actionText = actions.length === 0
         ? "- No suggested checks."
         : actions.map((action) => `- ${escapeHtml(action)}`).join("\n");
@@ -22,6 +90,7 @@ const render = (title, service, environment, summary, actions, firstSeenAt, last
         `Occurrences: ${occurrences}`,
         `First seen: ${escapeHtml(firstSeenAt)}`,
         `Last seen: ${escapeHtml(lastSeenAt)}`,
+        ...context.map((line) => escapeHtml(line)),
         "Suggested checks:",
         actionText,
     ].join("\n");
@@ -36,17 +105,18 @@ function formatTelegramAlert(alert) {
     let actions = alert.suggestedActions
         .slice(0, MAX_ACTIONS)
         .map((action) => limit(action, MAX_ACTION_LENGTH));
-    let formatted = render(title, service, environment, summary, actions, firstSeenAt, lastSeenAt, alert.occurrences);
+    const context = details(alert);
+    let formatted = render(title, service, environment, summary, actions, context, firstSeenAt, lastSeenAt, alert.occurrences);
     while (formatted.length > MAX_MESSAGE_LENGTH && actions.length > 0) {
         actions = actions.slice(0, -1);
-        formatted = render(title, service, environment, summary, actions, firstSeenAt, lastSeenAt, alert.occurrences);
+        formatted = render(title, service, environment, summary, actions, context, firstSeenAt, lastSeenAt, alert.occurrences);
     }
     while (formatted.length > MAX_MESSAGE_LENGTH && summary.length > 0) {
         summary = summary.slice(0, Math.max(0, summary.length - 200));
-        formatted = render(title, service, environment, summary, actions, firstSeenAt, lastSeenAt, alert.occurrences);
+        formatted = render(title, service, environment, summary, actions, context, firstSeenAt, lastSeenAt, alert.occurrences);
     }
     if (formatted.length > MAX_MESSAGE_LENGTH) {
-        formatted = render(limit(title, 100), limit(service, 100), limit(environment, 100), "Incident details were truncated.", [], firstSeenAt, lastSeenAt, alert.occurrences);
+        formatted = render(limit(title, 100), limit(service, 100), limit(environment, 100), "Incident details were truncated.", [], [], firstSeenAt, lastSeenAt, alert.occurrences);
     }
     return formatted;
 }