@dex-monit/observability-sdk-node 1.0.9 → 1.0.11

package/dist/lib/error-capture.interceptor.d.ts

@@ -13,6 +13,9 @@ export declare class ErrorCaptureInterceptor implements NestInterceptor {
     constructor(monitoringClient?: MonitoringClient | undefined);
     intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
     private captureError;
+    private getFullUrl;
     private sanitizeHeaders;
+    private sanitizeBody;
+    private sanitizeCookies;
 }
 //# sourceMappingURL=error-capture.interceptor.d.ts.map

package/dist/lib/error-capture.interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-capture.interceptor.d.ts","sourceRoot":"","sources":["../../src/lib/error-capture.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;GAMG;AACH,qBACa,uBAAwB,YAAW,eAAe;IAE3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAAjB,gBAAgB,CAAC,EAAE,gBAAgB,YAAA;IAGtD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IAY5E,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,eAAe;CAcxB"}
+{"version":3,"file":"error-capture.interceptor.d.ts","sourceRoot":"","sources":["../../src/lib/error-capture.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAI9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;GAMG;AACH,qBACa,uBAAwB,YAAW,eAAe;IAE3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAAjB,gBAAgB,CAAC,EAAE,gBAAgB,YAAA;IAGtD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IAY5E,OAAO,CAAC,YAAY;IAkEpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,eAAe;CASxB"}

package/dist/lib/error-capture.interceptor.js

@@ -2,6 +2,7 @@ import { __esDecorate, __runInitializers } from "tslib";
 import { Injectable, } from '@nestjs/common';
 import { throwError } from 'rxjs';
 import { catchError } from 'rxjs/operators';
+import * as os from 'os';
 /**
  * Error Capture Interceptor
  *
@@ -46,11 +47,44 @@ let ErrorCaptureInterceptor = (() => {
                 console.log('[DEX SDK] Sending error to monitoring...');
                 this.monitoringClient
                     .captureException(errorObj, {
+                    // Full request context like Sentry
                     request: {
-                        url: request?.url,
+                        url: this.getFullUrl(request),
                         method: request?.method,
                         headers: this.sanitizeHeaders(request?.headers || {}),
                         query: request?.query,
+                        body: this.sanitizeBody(request?.body),
+                        cookies: this.sanitizeCookies(request?.cookies),
+                    },
+                    // OS context
+                    context: {
+                        os: {
+                            name: os.platform(),
+                            version: os.release(),
+                            kernelVersion: os.release(),
+                        },
+                        runtime: {
+                            name: 'node',
+                            version: process.version,
+                        },
+                        device: {
+                            arch: os.arch(),
+                            memory: os.totalmem(),
+                            cpus: os.cpus().length,
+                            hostname: os.hostname(),
+                        },
+                        app: {
+                            startTime: process.uptime(),
+                            memoryUsage: process.memoryUsage(),
+                        },
+                    },
+                    // Tags for filtering
+                    tags: {
+                        'http.method': request?.method || 'unknown',
+                        'http.status_code': '500',
+                        'runtime': 'node',
+                        'runtime.version': process.version,
+                        'os': os.platform(),
                     },
                 })
                     .then(() => {
@@ -64,12 +98,20 @@ let ErrorCaptureInterceptor = (() => {
                 console.log('[DEX SDK] No monitoring client configured');
             }
         }
+        getFullUrl(request) {
+            if (!request)
+                return 'unknown';
+            const protocol = request.protocol || 'http';
+            const host = request.get?.('host') || request.hostname || 'localhost';
+            const path = request.originalUrl || request.url || '/';
+            return `${protocol}://${host}${path}`;
+        }
         sanitizeHeaders(headers) {
-            const sensitiveHeaders = ['authorization', 'cookie', 'x-api-key', 'x-dex-key'];
+            const sensitiveHeaders = ['authorization', 'cookie', 'x-api-key', 'x-dex-key', 'x-auth-token'];
             const sanitized = {};
             for (const [key, value] of Object.entries(headers)) {
                 if (sensitiveHeaders.includes(key.toLowerCase())) {
-                    sanitized[key] = '[REDACTED]';
+                    sanitized[key] = '[Filtered]';
                 }
                 else if (typeof value === 'string') {
                     sanitized[key] = value;
@@ -77,6 +119,30 @@ let ErrorCaptureInterceptor = (() => {
             }
             return sanitized;
         }
+        sanitizeBody(body) {
+            if (!body || typeof body !== 'object')
+                return undefined;
+            const sensitiveKeys = ['password', 'token', 'secret', 'apiKey', 'api_key', 'credit_card', 'cvv'];
+            const sanitized = {};
+            for (const [key, value] of Object.entries(body)) {
+                if (sensitiveKeys.some(k => key.toLowerCase().includes(k.toLowerCase()))) {
+                    sanitized[key] = '[Filtered]';
+                }
+                else {
+                    sanitized[key] = value;
+                }
+            }
+            return sanitized;
+        }
+        sanitizeCookies(cookies) {
+            if (!cookies || typeof cookies !== 'object')
+                return undefined;
+            const sanitized = {};
+            for (const key of Object.keys(cookies)) {
+                sanitized[key] = '[Filtered]';
+            }
+            return sanitized;
+        }
     };
     return ErrorCaptureInterceptor = _classThis;
 })();

package/dist/lib/monitoring-client.d.ts

@@ -1,4 +1,4 @@
-import { ErrorEvent, EventContext, Severity } from '@dex-monit/observability-contracts';
+import { ErrorEvent, EventContext, Severity, Breadcrumb } from '@dex-monit/observability-contracts';
 import { ScrubberOptions } from '@dex-monit/observability-scrubber';
 /**
  * Monitoring client configuration
@@ -100,4 +100,29 @@ export declare class MonitoringClient {
  * Create a monitoring client instance
  */
 export declare function createMonitoringClient(config: MonitoringClientConfig): MonitoringClient;
+/**
+ * Add a breadcrumb to the global breadcrumb trail
+ */
+export declare function addBreadcrumb(breadcrumb: Omit<Breadcrumb, 'timestamp'>): void;
+/**
+ * Get current breadcrumbs
+ */
+export declare function getBreadcrumbs(): Breadcrumb[];
+/**
+ * Clear all breadcrumbs
+ */
+export declare function clearBreadcrumbs(): void;
+/**
+ * Add an HTTP breadcrumb (convenience function)
+ */
+export declare function addHttpBreadcrumb(data: {
+    url: string;
+    method: string;
+    statusCode?: number;
+    duration?: number;
+}): void;
+/**
+ * Add a console breadcrumb (convenience function)
+ */
+export declare function addConsoleBreadcrumb(level: Severity, message: string, data?: Record<string, unknown>): void;
 //# sourceMappingURL=monitoring-client.d.ts.map

package/dist/lib/monitoring-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"monitoring-client.d.ts","sourceRoot":"","sources":["../../src/lib/monitoring-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"monitoring-client.d.ts","sourceRoot":"","sources":["../../src/lib/monitoring-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/monitoring-client.js

@@ -1,10 +1,70 @@
 import { v4 as uuidv4 } from 'uuid';
+import * as fs from 'fs';
 import { RequestContextService } from '@dex-monit/observability-request-context';
-import { scrubSensitiveData } from '@dex-monit/observability-scrubber';
+import { scrubSensitiveData, } from '@dex-monit/observability-scrubber';
+// Cache for source files to avoid re-reading
+const sourceFileCache = new Map();
+const MAX_CACHE_SIZE = 100;
 /**
- * Parse stack trace into structured frames
+ * Read source file and return lines array
  */
-function parseStackTrace(stack) {
+function readSourceFile(filename) {
+    // Check cache first
+    if (sourceFileCache.has(filename)) {
+        return sourceFileCache.get(filename) || null;
+    }
+    try {
+        // Skip node_modules and non-local files
+        if (filename.includes('node_modules') ||
+            filename.startsWith('node:') ||
+            !filename.startsWith('/')) {
+            return null;
+        }
+        // Check if file exists
+        if (!fs.existsSync(filename)) {
+            return null;
+        }
+        const content = fs.readFileSync(filename, 'utf-8');
+        const lines = content.split('\n');
+        // Manage cache size
+        if (sourceFileCache.size >= MAX_CACHE_SIZE) {
+            const firstKey = sourceFileCache.keys().next().value;
+            if (firstKey)
+                sourceFileCache.delete(firstKey);
+        }
+        sourceFileCache.set(filename, lines);
+        return lines;
+    }
+    catch {
+        sourceFileCache.set(filename, null);
+        return null;
+    }
+}
+/**
+ * Get source code context around a specific line
+ */
+function getSourceContext(filename, lineno, contextLines = 5) {
+    const lines = readSourceFile(filename);
+    if (!lines || lineno <= 0)
+        return undefined;
+    const start = Math.max(0, lineno - contextLines - 1);
+    const end = Math.min(lines.length, lineno + contextLines);
+    // Format lines with line numbers
+    const context = [];
+    for (let i = start; i < end; i++) {
+        const lineNum = i + 1;
+        const prefix = lineNum === lineno ? '>' : ' ';
+        context.push(`${prefix} ${lineNum.toString().padStart(4)} | ${lines[i]}`);
+    }
+    return context;
+}
+// Global breadcrumb storage
+const MAX_BREADCRUMBS = 100;
+let globalBreadcrumbs = [];
+/**
+ * Parse stack trace into structured frames with source code context
+ */
+function parseStackTrace(stack, includeContext = true) {
     if (!stack)
         return [];
     const lines = stack.split('\n').slice(1); // Skip first line (error message)
@@ -12,12 +72,22 @@ function parseStackTrace(stack) {
     for (const line of lines) {
         const match = line.match(/at\s+(?:(.+?)\s+\()?(?:(.+?):(\d+):(\d+))\)?/);
         if (match) {
-            frames.push({
+            const filename = match[2] || '<unknown>';
+            const lineno = parseInt(match[3] || '0', 10);
+            const frame = {
                 function: match[1] || '<anonymous>',
-                filename: match[2] || '<unknown>',
-                lineno: parseInt(match[3] || '0', 10),
+                filename,
+                lineno,
                 colno: parseInt(match[4] || '0', 10),
-            });
+            };
+            // Add source code context for app frames (not node_modules)
+            if (includeContext && !filename.includes('node_modules')) {
+                const context = getSourceContext(filename, lineno, 5);
+                if (context) {
+                    frame.context = context;
+                }
+            }
+            frames.push(frame);
         }
     }
     return frames;
@@ -86,6 +156,8 @@ export class MonitoringClient {
                 value: error.message,
                 stacktrace: parseStackTrace(error.stack),
             },
+            // Include breadcrumbs (events leading up to the error)
+            breadcrumbs: getBreadcrumbs(),
             requestId: requestContext?.requestId,
             transactionId: requestContext?.transactionId,
             fingerprint: options.fingerprint || generateFingerprint(error),
@@ -191,7 +263,9 @@ export class MonitoringClient {
             serverName: this.config.serverName,
             requestId: requestContext?.requestId,
             transactionId: requestContext?.transactionId,
-            data: data ? scrubSensitiveData(data, this.config.scrubberOptions) : undefined,
+            data: data
+                ? scrubSensitiveData(data, this.config.scrubberOptions)
+                : undefined,
             tags,
         };
         try {
@@ -210,7 +284,7 @@ export class MonitoringClient {
             return;
         }
         const requestContext = RequestContextService.get();
-        const logEvents = logs.map(log => ({
+        const logEvents = logs.map((log) => ({
             id: uuidv4(),
             timestamp: log.timestamp || new Date().toISOString(),
             level: log.level,
@@ -220,7 +294,9 @@ export class MonitoringClient {
             serverName: this.config.serverName,
             requestId: requestContext?.requestId,
             transactionId: requestContext?.transactionId,
-            data: log.data ? scrubSensitiveData(log.data, this.config.scrubberOptions) : undefined,
+            data: log.data
+                ? scrubSensitiveData(log.data, this.config.scrubberOptions)
+                : undefined,
             tags: log.tags,
         }));
         try {
@@ -331,3 +407,58 @@ export class MonitoringClient {
 export function createMonitoringClient(config) {
     return new MonitoringClient(config);
 }
+/**
+ * Add a breadcrumb to the global breadcrumb trail
+ */
+export function addBreadcrumb(breadcrumb) {
+    const crumb = {
+        timestamp: new Date().toISOString(),
+        ...breadcrumb,
+    };
+    globalBreadcrumbs.push(crumb);
+    // Keep only the last MAX_BREADCRUMBS
+    if (globalBreadcrumbs.length > MAX_BREADCRUMBS) {
+        globalBreadcrumbs = globalBreadcrumbs.slice(-MAX_BREADCRUMBS);
+    }
+}
+/**
+ * Get current breadcrumbs
+ */
+export function getBreadcrumbs() {
+    return [...globalBreadcrumbs];
+}
+/**
+ * Clear all breadcrumbs
+ */
+export function clearBreadcrumbs() {
+    globalBreadcrumbs = [];
+}
+/**
+ * Add an HTTP breadcrumb (convenience function)
+ */
+export function addHttpBreadcrumb(data) {
+    addBreadcrumb({
+        category: 'http',
+        type: 'http',
+        level: data.statusCode && data.statusCode >= 400 ? 'error' : 'info',
+        message: `${data.method} ${data.url}`,
+        data: {
+            url: data.url,
+            method: data.method,
+            status_code: data.statusCode,
+            duration_ms: data.duration,
+        },
+    });
+}
+/**
+ * Add a console breadcrumb (convenience function)
+ */
+export function addConsoleBreadcrumb(level, message, data) {
+    addBreadcrumb({
+        category: 'console',
+        type: 'debug',
+        level,
+        message,
+        data,
+    });
+}