@superblocksteam/telemetry 2.0.83-next.1

package/dist-esm/node/traced-socket.js

@@ -0,0 +1,257 @@
+/**
+ * TracedSocket for WebSocket connections with OpenTelemetry tracing.
+ *
+ * This is a generic implementation that can be used across services.
+ * Server-specific behavior (like error handling) is injected via callbacks.
+ */
+import { ROOT_CONTEXT, SpanKind, SpanStatusCode, context as otelCtx, propagation, trace, } from "@opentelemetry/api";
+import { SEMATTRS_MESSAGING_DESTINATION_KIND, SEMATTRS_MESSAGING_SYSTEM, } from "@opentelemetry/semantic-conventions";
+import { ISocket, OBS_TAG_HTTP_ROUTE, OBS_TAG_APPLICATION_ID, OBS_TAG_BRANCH, OBS_TAG_API_ID, OBS_TAG_COMMIT_ID, OBS_TAG_HTTP_STATUS_CODE, OBS_SOCKET_STATUS_CODE, OBS_TAG_USER_EMAIL, OBS_TAG_ORG_ID, OBS_TAG_USER_TYPE, sanitizeError, } from "@superblocksteam/shared";
+// Helper to cast ISocket's logger to pino-compatible logger
+const asPinoLogger = (logger) => logger;
+// Helper to check if a value is a Promise
+const isPromise = (value) => {
+    return (value !== null &&
+        typeof value === "object" &&
+        "then" in value &&
+        typeof value.then === "function");
+};
+// End span with proper error handling
+const endSpan = (traced, span, logger, setHttpStatusFromError) => {
+    try {
+        const result = traced();
+        if (isPromise(result)) {
+            return Promise.resolve(result)
+                .catch((err) => {
+                setHttpStatusFromError(span, typeof err === "string" ? new Error(err) : err, logger);
+                throw err;
+            })
+                .finally(() => span.end());
+        }
+        else {
+            span.end();
+            return result;
+        }
+    }
+    catch (error) {
+        setHttpStatusFromError(span, error, logger);
+        span.end();
+        throw error;
+    }
+};
+/**
+ * TracedSocket extends ISocket to add OpenTelemetry tracing capabilities.
+ *
+ * It manages spans for WebSocket handler calls to provide detailed tracing information.
+ */
+export class TracedSocket extends ISocket {
+    activeSpanByRequestId = new Map();
+    middlewareSpanByReqId = new Map();
+    lastActiveSpan;
+    requestHeaders;
+    tracer;
+    setHttpStatusFromError;
+    constructor(ws, requestHandlers, globalMiddlewares, config, options) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        super(ws, requestHandlers, globalMiddlewares, options);
+        this.requestHeaders = config.requestHeaders;
+        this.tracer = trace.getTracer("superblocks-server");
+        // Create error handler function
+        this.setHttpStatusFromError = (span, error, logger) => {
+            let status = 500;
+            if (config.getResponseMetaByError) {
+                const respMeta = config.getResponseMetaByError(error, logger);
+                status = respMeta.status;
+            }
+            span.setAttribute(OBS_TAG_HTTP_STATUS_CODE, status);
+            span.recordException(sanitizeError(error));
+            span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        };
+        // Log WebSocket connection establishment
+        asPinoLogger(this.logger).info({
+            "ws.event": "connection_established",
+            "ws.host": config.requestHeaders["host"] || "unknown",
+        }, "WebSocket connection established");
+    }
+    async callHandler(handler, params, ctx, client, next) {
+        let currentContext = otelCtx.active();
+        const middleWareSpan = this.middlewareSpanByReqId.get(ctx.requestId);
+        const activeSpan = this.activeSpanByRequestId.get(ctx.requestId);
+        // End middleware span since callHandler is called recursively
+        if (middleWareSpan) {
+            middleWareSpan.end();
+            if (activeSpan) {
+                currentContext = trace.setSpan(otelCtx.active(), activeSpan);
+            }
+        }
+        // After first (authHandler) these values will be set
+        const src = ctx;
+        const user = src.user;
+        const organization = src.organization;
+        if (this.lastActiveSpan && (user || organization)) {
+            this.lastActiveSpan.setAttribute(OBS_TAG_USER_EMAIL, user?.email ?? "");
+            this.lastActiveSpan.setAttribute(OBS_TAG_USER_TYPE, user?.getUserType?.() ?? "");
+            this.lastActiveSpan.setAttribute(OBS_TAG_ORG_ID, organization?.id ?? "");
+        }
+        let result;
+        const paramsObj = params;
+        await otelCtx.with(currentContext, async () => {
+            await this.tracer.startActiveSpan(`WS HANDLER ${handler.name === "" ? ctx.method : handler.name}`, {
+                attributes: {
+                    [SEMATTRS_MESSAGING_SYSTEM]: "ws",
+                    [SEMATTRS_MESSAGING_DESTINATION_KIND]: "websocket",
+                    [OBS_TAG_USER_EMAIL]: src.user?.email ?? "",
+                    [OBS_TAG_ORG_ID]: src.organization?.id ?? "",
+                    [OBS_TAG_APPLICATION_ID]: String(paramsObj?.["applicationId"] ?? src.jwtClaims?.app_id ?? ""),
+                    [OBS_TAG_API_ID]: String(paramsObj?.["apiId"] ?? ""),
+                    [OBS_TAG_BRANCH]: String(paramsObj?.["branch"] ?? paramsObj?.["branchName"] ?? ""),
+                    [OBS_TAG_COMMIT_ID]: String(paramsObj?.["commitId"] ?? ""),
+                },
+                kind: SpanKind.SERVER,
+            }, async (span) => {
+                this.middlewareSpanByReqId.set(ctx.requestId, span);
+                result = (await endSpan(() => super.callHandler(handler, params, ctx, client, next), span, asPinoLogger(this.logger), this.setHttpStatusFromError));
+                this.middlewareSpanByReqId.delete(ctx.requestId);
+            });
+        });
+        return result;
+    }
+    async handleMessage(message) {
+        if (message.request) {
+            const spanName = message.request.method;
+            const requestId = message.request.id;
+            const payload = message.request.payload;
+            const logData = {
+                "ws.event": "request_received",
+                "ws.method": spanName,
+                "ws.request_id": requestId,
+                "ws.host": this.requestHeaders["host"] || "unknown",
+            };
+            if (payload?.["applicationId"]) {
+                logData[OBS_TAG_APPLICATION_ID] = String(payload["applicationId"]);
+            }
+            if (payload?.["apiId"]) {
+                logData[OBS_TAG_API_ID] = String(payload["apiId"]);
+            }
+            if (payload?.["branch"] || payload?.["branchName"]) {
+                logData[OBS_TAG_BRANCH] = String(payload["branch"] ?? payload["branchName"]);
+            }
+            if (payload?.["commitId"]) {
+                logData[OBS_TAG_COMMIT_ID] = String(payload["commitId"]);
+            }
+            asPinoLogger(this.logger).info(logData, `WebSocket request: ${spanName}`);
+            await otelCtx.with(propagation.extract(ROOT_CONTEXT, message.request), async () => await this.tracer.startActiveSpan(`WS SERVER ${spanName}`, {
+                attributes: (() => {
+                    const attrs = {
+                        [SEMATTRS_MESSAGING_SYSTEM]: "ws",
+                        [SEMATTRS_MESSAGING_DESTINATION_KIND]: "websocket",
+                        [OBS_TAG_HTTP_ROUTE]: spanName,
+                    };
+                    if (payload?.["applicationId"]) {
+                        attrs[OBS_TAG_APPLICATION_ID] = String(payload["applicationId"]);
+                    }
+                    if (payload?.["apiId"]) {
+                        attrs[OBS_TAG_API_ID] = String(payload["apiId"]);
+                    }
+                    if (payload?.["branch"] || payload?.["branchName"]) {
+                        attrs[OBS_TAG_BRANCH] = String(payload["branch"] ?? payload["branchName"]);
+                    }
+                    if (payload?.["commitId"]) {
+                        attrs[OBS_TAG_COMMIT_ID] = String(payload["commitId"]);
+                    }
+                    return attrs;
+                })(),
+                kind: SpanKind.SERVER,
+            }, async (span) => {
+                this.lastActiveSpan = span;
+                this.activeSpanByRequestId.set(requestId, span);
+                const result = await endSpan(() => super.handleMessage(message), span, asPinoLogger(this.logger), this.setHttpStatusFromError);
+                this.activeSpanByRequestId.delete(requestId);
+                return result;
+            }));
+        }
+        else if (message.response) {
+            this.addEvent("ws.received-response", {
+                ["ws.response.id"]: message.response.id,
+            });
+            return await super.handleMessage(message);
+        }
+    }
+    request(method, params, authorization) {
+        return this.tracer.startActiveSpan(`WS CLIENT ${method}`, (span) => {
+            this.addEvent("ws.send-request", {
+                ["ws.request.method"]: method,
+                ["ws.request.id"]: this.nxtRequestId,
+            });
+            const result = super.request(method, params, authorization);
+            span.end();
+            return result;
+        });
+    }
+    respond(requestId, result) {
+        this.addEvent("ws.send-response", { ["ws.response.id"]: requestId });
+        // Using http status codes so that our existing monitors can work with minimum change
+        const resultObj = result;
+        if (this.lastActiveSpan &&
+            resultObj["responseMeta"]?.status !== undefined) {
+            this.lastActiveSpan.setAttribute(OBS_TAG_HTTP_STATUS_CODE, resultObj["responseMeta"].status);
+        }
+        // Log successful WebSocket response
+        asPinoLogger(this.logger).info({
+            "ws.event": "response_sent",
+            "ws.request_id": requestId,
+            "ws.status": resultObj["responseMeta"]?.status || 200,
+            "ws.response_size": (() => {
+                try {
+                    return JSON.stringify(result).length;
+                }
+                catch {
+                    return -1;
+                }
+            })(),
+            "ws.host": this.requestHeaders["host"] || "unknown",
+        }, `WebSocket response sent for request ${requestId}`);
+        return super.respond(requestId, result);
+    }
+    respondError(requestId, error, exception) {
+        this.addEvent("ws.send-error", { ["ws.response.id"]: requestId });
+        if (this.lastActiveSpan) {
+            this.setHttpStatusFromError(this.lastActiveSpan, exception ?? new Error(error.message), asPinoLogger(this.logger));
+            this.lastActiveSpan.setAttribute(OBS_SOCKET_STATUS_CODE, error.code);
+        }
+        asPinoLogger(this.logger).error({
+            "ws.event": "error_response",
+            "ws.request_id": requestId,
+            "ws.error_code": error.code,
+            "ws.error_message": error.message,
+            "ws.exception_type": exception?.constructor.name,
+            "ws.exception_message": exception?.message,
+            "ws.host": this.requestHeaders["host"] || "unknown",
+            error: exception || error,
+        }, `WebSocket error for request ${requestId}: ${error.message}`);
+        return super.respondError(requestId, error, exception);
+    }
+    addEvent(eventName, attributes) {
+        if (this.lastActiveSpan) {
+            this.lastActiveSpan.addEvent(eventName, attributes, new Date());
+        }
+    }
+    close(reason) {
+        asPinoLogger(this.logger).info({
+            "ws.event": "connection_closed",
+            "ws.close_reason": reason || "normal",
+            "ws.host": this.requestHeaders["host"] || "unknown",
+        }, `WebSocket connection closed: ${reason || "normal"}`);
+        for (const span of this.middlewareSpanByReqId.values()) {
+            span.end();
+        }
+        this.middlewareSpanByReqId = new Map();
+        for (const span of this.activeSpanByRequestId.values()) {
+            span.end();
+        }
+        this.activeSpanByRequestId = new Map();
+        this.lastActiveSpan = undefined;
+        super.close(reason);
+    }
+}
+//# sourceMappingURL=traced-socket.js.map

package/dist-esm/node/traced-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-socket.js","sourceRoot":"","sources":["../../src/node/traced-socket.ts"],"names":[],"mappings":"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"}

package/dist-esm/testing/in-memory-exporter.d.ts

@@ -0,0 +1,179 @@
+/**
+ * In-Memory Exporters for Testing
+ *
+ * These exporters capture telemetry data in memory for assertion in tests.
+ * No external connections are made.
+ */
+import type { SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { ExportResult } from '@opentelemetry/core';
+/**
+ * In-memory span exporter for testing.
+ * Captures all exported spans for assertion.
+ */
+export declare class InMemorySpanExporter implements SpanExporter {
+    private spans;
+    private stopped;
+    /**
+     * Export spans to in-memory storage.
+     */
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+    /**
+     * Shutdown the exporter.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush (no-op for in-memory).
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Get all captured spans.
+     */
+    getSpans(): ReadableSpan[];
+    /**
+     * Get the number of captured spans.
+     */
+    getSpanCount(): number;
+    /**
+     * Clear captured spans.
+     */
+    reset(): void;
+    /**
+     * Find spans by name.
+     *
+     * @param name - Span name to search for
+     * @returns Matching spans
+     */
+    findSpansByName(name: string): ReadableSpan[];
+    /**
+     * Find spans by name pattern (regex).
+     *
+     * @param pattern - Regex pattern to match span names
+     * @returns Matching spans
+     */
+    findSpansByPattern(pattern: RegExp): ReadableSpan[];
+    /**
+     * Find spans with a specific attribute value.
+     *
+     * @param key - Attribute key
+     * @param value - Attribute value (or regex for pattern matching)
+     * @returns Matching spans
+     */
+    findSpansByAttribute(key: string, value: string | RegExp): ReadableSpan[];
+    /**
+     * Assert no spans have a specific attribute value.
+     * Useful for ensuring Tier 1 data doesn't leak.
+     *
+     * @param key - Attribute key
+     * @param value - Forbidden attribute value (or regex pattern)
+     * @throws Error if forbidden attribute is found
+     */
+    assertNoAttribute(key: string, value: string | RegExp): void;
+    /**
+     * Assert all spans have a required attribute.
+     *
+     * @param key - Attribute key
+     * @throws Error if any span is missing the attribute
+     */
+    assertAllHaveAttribute(key: string): void;
+    /**
+     * Get span names for debugging.
+     */
+    getSpanNames(): string[];
+}
+/**
+ * Metric data point captured by in-memory exporter.
+ */
+export interface CapturedMetric {
+    name: string;
+    description?: string;
+    unit?: string;
+    type: 'counter' | 'gauge' | 'histogram' | 'observable';
+    dataPoints: Array<{
+        value: number;
+        attributes: Record<string, unknown>;
+        timestamp: number;
+    }>;
+}
+/**
+ * In-memory metric exporter for testing.
+ */
+export declare class InMemoryMetricExporter {
+    private metrics;
+    /**
+     * Export metrics to in-memory storage.
+     */
+    export(metrics: CapturedMetric[]): void;
+    /**
+     * Get all captured metrics.
+     */
+    getMetrics(): CapturedMetric[];
+    /**
+     * Find metrics by name.
+     *
+     * @param name - Metric name
+     * @returns Matching metrics
+     */
+    findMetricsByName(name: string): CapturedMetric[];
+    /**
+     * Clear captured metrics.
+     */
+    reset(): void;
+    /**
+     * Assert no metrics have a specific label value.
+     *
+     * @param labelKey - Label key
+     * @param value - Forbidden value
+     * @throws Error if forbidden label is found
+     */
+    assertNoLabel(labelKey: string, value: string | RegExp): void;
+}
+/**
+ * Log record captured by in-memory exporter.
+ */
+export interface CapturedLogRecord {
+    timestamp: number;
+    severityNumber: number;
+    severityText?: string;
+    body?: unknown;
+    attributes: Record<string, unknown>;
+}
+/**
+ * In-memory log exporter for testing.
+ */
+export declare class InMemoryLogExporter {
+    private logs;
+    /**
+     * Export logs to in-memory storage.
+     */
+    export(logs: CapturedLogRecord[]): void;
+    /**
+     * Get all captured logs.
+     */
+    getLogs(): CapturedLogRecord[];
+    /**
+     * Find logs by severity.
+     *
+     * @param severityNumber - Severity level (e.g., 9 for INFO, 13 for WARN, 17 for ERROR)
+     * @returns Matching logs
+     */
+    findLogsBySeverity(severityNumber: number): CapturedLogRecord[];
+    /**
+     * Find logs containing text.
+     *
+     * @param text - Text to search for in log body
+     * @returns Matching logs
+     */
+    findLogsContaining(text: string | RegExp): CapturedLogRecord[];
+    /**
+     * Clear captured logs.
+     */
+    reset(): void;
+    /**
+     * Assert no logs contain sensitive data.
+     *
+     * @param pattern - Pattern to check for (forbidden content)
+     * @throws Error if forbidden content is found
+     */
+    assertNoLogContains(pattern: RegExp): void;
+}
+//# sourceMappingURL=in-memory-exporter.d.ts.map

package/dist-esm/testing/in-memory-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-exporter.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-exporter.ts"],"names":[],"mappings":"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"}