@sentienguard/apm 1.0.8 → 1.0.9

package/src/errors.js

@@ -1,132 +1,132 @@
-/**
- * Error Capture
- * Captures unhandled exceptions and associates them with error counters.
- *
- * Stack traces are captured locally but NOT sent to backend in v1.
- * Only error counters are aggregated and sent.
- */
-
-import { getAggregator } from './aggregator.js';
-import { debug, warn } from './config.js';
-
-let isCapturing = false;
-let originalUncaughtException = null;
-let originalUnhandledRejection = null;
-
-/**
- * Handle uncaught exception
- */
-function handleUncaughtException(error) {
-  debug('Captured uncaught exception:', error.message);
-
-  const aggregator = getAggregator();
-  aggregator.recordError();
-
-  // Log locally but don't crash (let the original handler decide)
-  if (originalUncaughtException) {
-    // If there was a previous handler, call it
-    originalUncaughtException(error);
-  } else {
-    // Default behavior: log and continue
-    // We don't re-throw to avoid double handling
-    warn('Uncaught exception:', error.message);
-  }
-}
-
-/**
- * Handle unhandled promise rejection
- */
-function handleUnhandledRejection(reason, promise) {
-  const message = reason instanceof Error ? reason.message : String(reason);
-  debug('Captured unhandled rejection:', message);
-
-  const aggregator = getAggregator();
-  aggregator.recordError();
-
-  // Call previous handler if exists
-  if (originalUnhandledRejection) {
-    originalUnhandledRejection(reason, promise);
-  } else {
-    warn('Unhandled rejection:', message);
-  }
-}
-
-/**
- * Start capturing unhandled errors
- */
-export function startErrorCapture() {
-  if (isCapturing) {
-    debug('Error capture already active, skipping');
-    return;
-  }
-
-  // Store any existing handlers
-  const existingUncaught = process.listeners('uncaughtException');
-  const existingRejection = process.listeners('unhandledRejection');
-
-  if (existingUncaught.length > 0) {
-    originalUncaughtException = existingUncaught[existingUncaught.length - 1];
-  }
-  if (existingRejection.length > 0) {
-    originalUnhandledRejection = existingRejection[existingRejection.length - 1];
-  }
-
-  // Add our handlers
-  process.on('uncaughtException', handleUncaughtException);
-  process.on('unhandledRejection', handleUnhandledRejection);
-
-  isCapturing = true;
-  debug('Error capture enabled');
-}
-
-/**
- * Stop capturing errors (for cleanup/testing)
- */
-export function stopErrorCapture() {
-  if (!isCapturing) return;
-
-  process.removeListener('uncaughtException', handleUncaughtException);
-  process.removeListener('unhandledRejection', handleUnhandledRejection);
-
-  originalUncaughtException = null;
-  originalUnhandledRejection = null;
-
-  isCapturing = false;
-  debug('Error capture disabled');
-}
-
-/**
- * Create Express error middleware
- * Use this as the last middleware to capture Express errors
- */
-export function expressErrorMiddleware() {
-  return function sentienguardErrorMiddleware(err, req, res, next) {
-    debug('Captured Express error:', err.message);
-
-    const aggregator = getAggregator();
-    aggregator.recordError();
-
-    // Pass to next error handler
-    next(err);
-  };
-}
-
-/**
- * Create Fastify error handler hook
- */
-export function fastifyErrorHandler(error, request, reply) {
-  debug('Captured Fastify error:', error.message);
-
-  const aggregator = getAggregator();
-  aggregator.recordError();
-
-  // Re-throw to let Fastify handle it
-  throw error;
-}
-
-export default {
-  startErrorCapture,
-  stopErrorCapture,
-  expressErrorMiddleware,
-  fastifyErrorHandler
-};
+/**
+ * Error Capture
+ * Captures unhandled exceptions and associates them with error counters.
+ *
+ * Stack traces are captured locally but NOT sent to backend in v1.
+ * Only error counters are aggregated and sent.
+ */
+
+import { getAggregator } from './aggregator.js';
+import { debug, warn } from './config.js';
+
+let isCapturing = false;
+let originalUncaughtException = null;
+let originalUnhandledRejection = null;
+
+/**
+ * Handle uncaught exception
+ */
+function handleUncaughtException(error) {
+  debug('Captured uncaught exception:', error.message);
+
+  const aggregator = getAggregator();
+  aggregator.recordError();
+
+  // Log locally but don't crash (let the original handler decide)
+  if (originalUncaughtException) {
+    // If there was a previous handler, call it
+    originalUncaughtException(error);
+  } else {
+    // Default behavior: log and continue
+    // We don't re-throw to avoid double handling
+    warn('Uncaught exception:', error.message);
+  }
+}
+
+/**
+ * Handle unhandled promise rejection
+ */
+function handleUnhandledRejection(reason, promise) {
+  const message = reason instanceof Error ? reason.message : String(reason);
+  debug('Captured unhandled rejection:', message);
+
+  const aggregator = getAggregator();
+  aggregator.recordError();
+
+  // Call previous handler if exists
+  if (originalUnhandledRejection) {
+    originalUnhandledRejection(reason, promise);
+  } else {
+    warn('Unhandled rejection:', message);
+  }
+}
+
+/**
+ * Start capturing unhandled errors
+ */
+export function startErrorCapture() {
+  if (isCapturing) {
+    debug('Error capture already active, skipping');
+    return;
+  }
+
+  // Store any existing handlers
+  const existingUncaught = process.listeners('uncaughtException');
+  const existingRejection = process.listeners('unhandledRejection');
+
+  if (existingUncaught.length > 0) {
+    originalUncaughtException = existingUncaught[existingUncaught.length - 1];
+  }
+  if (existingRejection.length > 0) {
+    originalUnhandledRejection = existingRejection[existingRejection.length - 1];
+  }
+
+  // Add our handlers
+  process.on('uncaughtException', handleUncaughtException);
+  process.on('unhandledRejection', handleUnhandledRejection);
+
+  isCapturing = true;
+  debug('Error capture enabled');
+}
+
+/**
+ * Stop capturing errors (for cleanup/testing)
+ */
+export function stopErrorCapture() {
+  if (!isCapturing) return;
+
+  process.removeListener('uncaughtException', handleUncaughtException);
+  process.removeListener('unhandledRejection', handleUnhandledRejection);
+
+  originalUncaughtException = null;
+  originalUnhandledRejection = null;
+
+  isCapturing = false;
+  debug('Error capture disabled');
+}
+
+/**
+ * Create Express error middleware
+ * Use this as the last middleware to capture Express errors
+ */
+export function expressErrorMiddleware() {
+  return function sentienguardErrorMiddleware(err, req, res, next) {
+    debug('Captured Express error:', err.message);
+
+    const aggregator = getAggregator();
+    aggregator.recordError();
+
+    // Pass to next error handler
+    next(err);
+  };
+}
+
+/**
+ * Create Fastify error handler hook
+ */
+export function fastifyErrorHandler(error, request, reply) {
+  debug('Captured Fastify error:', error.message);
+
+  const aggregator = getAggregator();
+  aggregator.recordError();
+
+  // Re-throw to let Fastify handle it
+  throw error;
+}
+
+export default {
+  startErrorCapture,
+  stopErrorCapture,
+  expressErrorMiddleware,
+  fastifyErrorHandler
+};

package/src/index.d.ts

@@ -1,102 +1,113 @@
-/**
- * SentienGuard APM SDK TypeScript Declarations
- */
-
-// Configuration types
-export interface ApmConfig {
-  apiKey?: string;
-  service?: string;
-  environment?: string;
-  endpoint?: string;
-  flushInterval?: number;
-  maxRoutes?: number;
-  maxPayloadSize?: number;
-  enabled?: boolean;
-  debug?: boolean;
-}
-
-export interface BrowserApmConfig {
-  apiKey: string;
-  service: string;
-  endpoint?: string;
-  environment?: string;
-  flushInterval?: number;
-  debug?: boolean;
-}
-
-export interface ApmStatus {
-  enabled: boolean;
-  initialized: boolean;
-  config: {
-    service: string;
-    environment: string;
-    flushInterval: number;
-  };
-  stats: {
-    requestMetrics?: number;
-    dependencyMetrics?: number;
-    webVitals?: number;
-    jsErrors?: number;
-  };
-}
-
-// Core functions
-export function initialize(options?: BrowserApmConfig): void;
-export function init(options?: BrowserApmConfig): void;
-export function shutdown(): Promise<void>;
-export function getStatus(): ApmStatus;
-export function flush(): Promise<void>;
-export function getConfig(): ApmConfig;
-export function isEnabled(): boolean;
-
-// Express middleware (no-ops in browser)
-export function expressMiddleware(): (req: any, res: any, next: any) => void;
-export function expressErrorMiddleware(): (err: any, req: any, res: any, next: any) => void;
-
-// Fastify plugin (no-ops in browser)
-export function fastifyPlugin(): any;
-export function fastifyErrorHandler(): any;
-
-// Route utilities (no-ops in browser)
-export function normalizeRoute(route: string): string;
-export function extractRoute(req: any): string;
-export const RouteRegistry: any;
-
-// Aggregator
-export function getAggregator(): any;
-
-// MongoDB instrumentation (no-ops in browser)
-export function instrumentMongoDB(): void;
-
-// OpenAI instrumentation (no-ops in browser)
-export function instrumentOpenAI(): void;
-
-// Circuit breaker (no-ops in browser)
-export function createBreaker(fn: any): any;
-export function wrapMongoOperation(fn: any): any;
-export function getBreakerStats(): any;
-
-// Default export
-declare const SentienGuard: {
-  init: typeof init;
-  initialize: typeof initialize;
-  shutdown: typeof shutdown;
-  getStatus: typeof getStatus;
-  flush: typeof flush;
-  getConfig: typeof getConfig;
-  isEnabled: typeof isEnabled;
-  getAggregator: typeof getAggregator;
-  expressMiddleware: typeof expressMiddleware;
-  expressErrorMiddleware: typeof expressErrorMiddleware;
-  fastifyPlugin: typeof fastifyPlugin;
-  fastifyErrorHandler: typeof fastifyErrorHandler;
-  normalizeRoute: typeof normalizeRoute;
-  extractRoute: typeof extractRoute;
-  instrumentMongoDB: typeof instrumentMongoDB;
-  instrumentOpenAI: typeof instrumentOpenAI;
-  createBreaker: typeof createBreaker;
-  wrapMongoOperation: typeof wrapMongoOperation;
-  getBreakerStats: typeof getBreakerStats;
-};
-
-export default SentienGuard;
+/**
+ * SentienGuard APM SDK TypeScript Declarations
+ */
+
+// Configuration types
+export interface ApmConfig {
+  apiKey?: string;
+  service?: string;
+  environment?: string;
+  endpoint?: string;
+  flushInterval?: number;
+  maxRoutes?: number;
+  maxPayloadSize?: number;
+  enabled?: boolean;
+  debug?: boolean;
+  tracing?: {
+    enabled?: boolean;
+    traceLocalHttp?: boolean;
+    peerServiceMap?: Record<string, string>;
+  };
+}
+
+export interface BrowserApmConfig {
+  apiKey: string;
+  service: string;
+  endpoint?: string;
+  environment?: string;
+  flushInterval?: number;
+  debug?: boolean;
+}
+
+export interface ApmStatus {
+  enabled: boolean;
+  initialized: boolean;
+  /** True when OpenTelemetry tracing is active (W3C trace context) */
+  tracing?: boolean;
+  config: {
+    service: string;
+    environment: string;
+    flushInterval: number;
+  };
+  stats: {
+    requestMetrics?: number;
+    dependencyMetrics?: number;
+    webVitals?: number;
+    jsErrors?: number;
+  };
+}
+
+// Core functions
+export function initialize(options?: BrowserApmConfig): void;
+export function init(options?: BrowserApmConfig): void;
+export function shutdown(): Promise<void>;
+export function getStatus(): ApmStatus;
+export function flush(): Promise<void>;
+export function getConfig(): ApmConfig;
+export function isEnabled(): boolean;
+
+/** Active OpenTelemetry trace id (hex) for log correlation; undefined if none */
+export function getActiveTraceId(): string | undefined;
+
+// Express middleware (no-ops in browser)
+export function expressMiddleware(): (req: any, res: any, next: any) => void;
+export function expressErrorMiddleware(): (err: any, req: any, res: any, next: any) => void;
+
+// Fastify plugin (no-ops in browser)
+export function fastifyPlugin(): any;
+export function fastifyErrorHandler(): any;
+
+// Route utilities (no-ops in browser)
+export function normalizeRoute(route: string): string;
+export function extractRoute(req: any): string;
+export const RouteRegistry: any;
+
+// Aggregator
+export function getAggregator(): any;
+
+// MongoDB instrumentation (no-ops in browser)
+export function instrumentMongoDB(): void;
+
+// OpenAI instrumentation (no-ops in browser)
+export function instrumentOpenAI(): void;
+
+// Circuit breaker (no-ops in browser)
+export function createBreaker(fn: any): any;
+export function wrapMongoOperation(fn: any): any;
+export function getBreakerStats(): any;
+
+// Default export
+declare const SentienGuard: {
+  init: typeof init;
+  initialize: typeof initialize;
+  shutdown: typeof shutdown;
+  getStatus: typeof getStatus;
+  flush: typeof flush;
+  getConfig: typeof getConfig;
+  isEnabled: typeof isEnabled;
+  getAggregator: typeof getAggregator;
+  expressMiddleware: typeof expressMiddleware;
+  expressErrorMiddleware: typeof expressErrorMiddleware;
+  fastifyPlugin: typeof fastifyPlugin;
+  fastifyErrorHandler: typeof fastifyErrorHandler;
+  normalizeRoute: typeof normalizeRoute;
+  extractRoute: typeof extractRoute;
+  instrumentMongoDB: typeof instrumentMongoDB;
+  instrumentOpenAI: typeof instrumentOpenAI;
+  createBreaker: typeof createBreaker;
+  wrapMongoOperation: typeof wrapMongoOperation;
+  getBreakerStats: typeof getBreakerStats;
+  getActiveTraceId: typeof getActiveTraceId;
+};
+
+export default SentienGuard;