@sentienguard/apm 1.0.19 → 1.0.20

package/src/config.js

@@ -1,179 +1,179 @@
-/**
- * SDK Configuration
- * Environment-driven configuration with sensible defaults.
- * No config → SDK disables itself silently.
- *
- * Config is loaded lazily (at initialize() time, not import time)
- * so that dotenv or other env loaders can run first.
- */
-
-let configLoaded = false;
-
-const config = {
-  apiKey: '',
-  service: '',
-  environment: 'production',
-  endpoint: 'https://sentienguard-dev.the-algo.com/api/v1/apm/ingest',
-  tracesEndpoint: '',
-  flushInterval: 10,
-  maxRoutes: 100,
-  maxPayloadSize: 1024 * 1024,
-  enabled: true,
-  debug: false,
-  mongodb: {
-    enabled: true,
-    slowQueryMs: 100,
-    poolStatsInterval: 10000
-  },
-  circuitBreaker: {
-    enabled: false,
-    timeout: 3000,
-    errorThresholdPercentage: 50,
-    resetTimeout: 30000,
-    volumeThreshold: 5
-  },
-  openai: {
-    enabled: true,
-    trackTokens: true,
-    trackCosts: true,
-    slowCallMs: 5000
-  },
-  /** OpenTelemetry + W3C trace context; set SENTIENGUARD_TRACING=false for legacy HTTP patches only */
-  tracing: {
-    enabled: true,
-    /** When true, outgoing HTTP to localhost is traced (for multi-service dev). Default false. */
-    traceLocalHttp: false,
-    /** Port -> display name for local peers, from SENTIENGUARD_PEER_SERVICE_MAP */
-    peerServiceMap: {},
-    /** Sampling rate for exporting raw spans (0..1). Parent-based. */
-    sampleRate: 0.05,
-    /** Span export queue + batch sizes (drop-on-pressure). */
-    maxQueueSize: 2048,
-    maxBatchSize: 256
-  }
-};
-
-/**
- * Load configuration from environment variables.
- * Called lazily on first use (e.g., from initialize() or isEnabled()).
- * Safe to call multiple times — only reads env vars once.
- */
-export function loadConfig({ force = false } = {}) {
-  if (configLoaded && !force) return;
-  configLoaded = true;
-
-  config.apiKey = process.env.SENTIENGUARD_APM_KEY || '';
-  config.service = process.env.SENTIENGUARD_SERVICE || '';
-  config.environment = process.env.SENTIENGUARD_ENV || 'production';
-  config.endpoint = process.env.SENTIENGUARD_ENDPOINT || 'https://sentienguard-dev.the-algo.com/api/v1/apm/ingest';
-  config.tracesEndpoint =
-    process.env.SENTIENGUARD_TRACES_ENDPOINT ||
-    deriveTracesEndpoint(config.endpoint) ||
-    'https://sentienguard-dev.the-algo.com/api/v1/apm/traces';
-  config.flushInterval = parseInt(process.env.SENTIENGUARD_FLUSH_INTERVAL, 10) || 10;
-  config.maxRoutes = parseInt(process.env.SENTIENGUARD_MAX_ROUTES, 10) || 100;
-  config.maxPayloadSize = parseInt(process.env.SENTIENGUARD_MAX_PAYLOAD_SIZE, 10) || 1024 * 1024;
-  config.enabled = process.env.SENTIENGUARD_ENABLED !== 'false';
-  config.debug = process.env.SENTIENGUARD_DEBUG === 'true';
-
-  config.mongodb.enabled = process.env.SENTIENGUARD_MONGODB_ENABLED !== 'false';
-  config.mongodb.slowQueryMs = parseInt(process.env.SENTIENGUARD_MONGODB_SLOW_QUERY_MS, 10) || 100;
-  config.mongodb.poolStatsInterval = parseInt(process.env.SENTIENGUARD_MONGODB_POOL_INTERVAL, 10) || 10000;
-
-  config.circuitBreaker.enabled = process.env.SENTIENGUARD_CIRCUIT_BREAKER_ENABLED === 'true';
-  config.circuitBreaker.timeout = parseInt(process.env.SENTIENGUARD_CIRCUIT_TIMEOUT_MS, 10) || 3000;
-  config.circuitBreaker.errorThresholdPercentage = parseInt(process.env.SENTIENGUARD_CIRCUIT_ERROR_THRESHOLD, 10) || 50;
-  config.circuitBreaker.resetTimeout = parseInt(process.env.SENTIENGUARD_CIRCUIT_RESET_TIMEOUT, 10) || 30000;
-  config.circuitBreaker.volumeThreshold = parseInt(process.env.SENTIENGUARD_CIRCUIT_VOLUME_THRESHOLD, 10) || 5;
-
-  config.openai.enabled = process.env.SENTIENGUARD_OPENAI_ENABLED !== 'false';
-  config.openai.trackTokens = process.env.SENTIENGUARD_OPENAI_TRACK_TOKENS !== 'false';
-  config.openai.trackCosts = process.env.SENTIENGUARD_OPENAI_TRACK_COSTS !== 'false';
-  config.openai.slowCallMs = parseInt(process.env.SENTIENGUARD_OPENAI_SLOW_CALL_MS, 10) || 5000;
-
-  config.tracing.enabled = process.env.SENTIENGUARD_TRACING !== 'false';
-  const sampleRaw = process.env.SENTIENGUARD_TRACE_SAMPLE_RATE;
-  const sample = sampleRaw != null ? Number(sampleRaw) : NaN;
-  if (!Number.isNaN(sample) && sample >= 0 && sample <= 1) {
-    config.tracing.sampleRate = sample;
-  }
-  config.tracing.maxQueueSize = parseInt(process.env.SENTIENGUARD_TRACE_MAX_QUEUE_SIZE, 10) || config.tracing.maxQueueSize;
-  config.tracing.maxBatchSize = parseInt(process.env.SENTIENGUARD_TRACE_MAX_BATCH_SIZE, 10) || config.tracing.maxBatchSize;
-  // Default behavior:
-  // - production: do NOT record localhost dependency edges (noise + self-calls)
-  // - non-production: DO record localhost edges (local multi-service dev "just works")
-  // Can always be overridden explicitly via SENTIENGUARD_TRACE_LOCAL_HTTP=true/false.
-  const explicitLocal =
-    process.env.SENTIENGUARD_TRACE_LOCAL_HTTP === 'true'
-      ? true
-      : process.env.SENTIENGUARD_TRACE_LOCAL_HTTP === 'false'
-        ? false
-        : undefined;
-  const isProd = (config.environment || '').toLowerCase() === 'production' ||
-                 (process.env.NODE_ENV || '').toLowerCase() === 'production';
-  config.tracing.traceLocalHttp = explicitLocal ?? !isProd;
-  config.tracing.peerServiceMap = parsePeerServiceMap(process.env.SENTIENGUARD_PEER_SERVICE_MAP || '');
-}
-
-/** "3001:payments-api,3002:auth-api" -> { "3001": "payments-api", ... } */
-function parsePeerServiceMap(raw) {
-  const map = Object.create(null);
-  if (!raw || typeof raw !== 'string') return map;
-  for (const part of raw.split(',')) {
-    const trimmed = part.trim();
-    if (!trimmed) continue;
-    const idx = trimmed.indexOf(':');
-    if (idx === -1) continue;
-    const port = trimmed.slice(0, idx).trim();
-    const name = trimmed.slice(idx + 1).trim();
-    if (port && name) map[port] = name;
-  }
-  return map;
-}
-
-function deriveTracesEndpoint(ingestEndpoint) {
-  try {
-    const u = new URL(String(ingestEndpoint));
-    // Common default: /api/v1/apm/ingest -> /api/v1/apm/traces
-    u.pathname = u.pathname.replace(/\/apm\/ingest\/?$/i, '/apm/traces');
-    return u.toString();
-  } catch {
-    return '';
-  }
-}
-
-/**
- * Check if SDK is properly configured and should be active.
- * Triggers lazy config load if not yet loaded.
- */
-export function isEnabled() {
-  loadConfig();
-  return config.enabled && !!config.apiKey && !!config.service;
-}
-
-/**
- * Get validated configuration.
- * Triggers lazy config load if not yet loaded.
- */
-export function getConfig() {
-  loadConfig();
-  return { ...config };
-}
-
-/**
- * Log debug message if debug mode is enabled
- */
-export function debug(...args) {
-  if (config.debug) {
-    console.log('[SentienGuard APM]', ...args);
-  }
-}
-
-/**
- * Log warning (always shown)
- */
-export function warn(...args) {
-  console.warn('[SentienGuard APM]', ...args);
-}
-
-export default config;
+/**
+ * SDK Configuration
+ * Environment-driven configuration with sensible defaults.
+ * No config → SDK disables itself silently.
+ *
+ * Config is loaded lazily (at initialize() time, not import time)
+ * so that dotenv or other env loaders can run first.
+ */
+
+let configLoaded = false;
+
+const config = {
+  apiKey: '',
+  service: '',
+  environment: 'production',
+  endpoint: 'https://sentienguard-dev.the-algo.com/api/v1/apm/ingest',
+  tracesEndpoint: '',
+  flushInterval: 10,
+  maxRoutes: 100,
+  maxPayloadSize: 1024 * 1024,
+  enabled: true,
+  debug: false,
+  mongodb: {
+    enabled: true,
+    slowQueryMs: 100,
+    poolStatsInterval: 10000
+  },
+  circuitBreaker: {
+    enabled: false,
+    timeout: 3000,
+    errorThresholdPercentage: 50,
+    resetTimeout: 30000,
+    volumeThreshold: 5
+  },
+  openai: {
+    enabled: true,
+    trackTokens: true,
+    trackCosts: true,
+    slowCallMs: 5000
+  },
+  /** OpenTelemetry + W3C trace context; set SENTIENGUARD_TRACING=false for legacy HTTP patches only */
+  tracing: {
+    enabled: true,
+    /** When true, outgoing HTTP to localhost is traced (for multi-service dev). Default false. */
+    traceLocalHttp: false,
+    /** Port -> display name for local peers, from SENTIENGUARD_PEER_SERVICE_MAP */
+    peerServiceMap: {},
+    /** Sampling rate for exporting raw spans (0..1). Parent-based. */
+    sampleRate: 0.05,
+    /** Span export queue + batch sizes (drop-on-pressure). */
+    maxQueueSize: 2048,
+    maxBatchSize: 256
+  }
+};
+
+/**
+ * Load configuration from environment variables.
+ * Called lazily on first use (e.g., from initialize() or isEnabled()).
+ * Safe to call multiple times — only reads env vars once.
+ */
+export function loadConfig({ force = false } = {}) {
+  if (configLoaded && !force) return;
+  configLoaded = true;
+
+  config.apiKey = process.env.SENTIENGUARD_APM_KEY || '';
+  config.service = process.env.SENTIENGUARD_SERVICE || '';
+  config.environment = process.env.SENTIENGUARD_ENV || 'production';
+  config.endpoint = process.env.SENTIENGUARD_ENDPOINT || 'https://sentienguard-dev.the-algo.com/api/v1/apm/ingest';
+  config.tracesEndpoint =
+    process.env.SENTIENGUARD_TRACES_ENDPOINT ||
+    deriveTracesEndpoint(config.endpoint) ||
+    'https://sentienguard-dev.the-algo.com/api/v1/apm/traces';
+  config.flushInterval = parseInt(process.env.SENTIENGUARD_FLUSH_INTERVAL, 10) || 10;
+  config.maxRoutes = parseInt(process.env.SENTIENGUARD_MAX_ROUTES, 10) || 100;
+  config.maxPayloadSize = parseInt(process.env.SENTIENGUARD_MAX_PAYLOAD_SIZE, 10) || 1024 * 1024;
+  config.enabled = process.env.SENTIENGUARD_ENABLED !== 'false';
+  config.debug = process.env.SENTIENGUARD_DEBUG === 'true';
+
+  config.mongodb.enabled = process.env.SENTIENGUARD_MONGODB_ENABLED !== 'false';
+  config.mongodb.slowQueryMs = parseInt(process.env.SENTIENGUARD_MONGODB_SLOW_QUERY_MS, 10) || 100;
+  config.mongodb.poolStatsInterval = parseInt(process.env.SENTIENGUARD_MONGODB_POOL_INTERVAL, 10) || 10000;
+
+  config.circuitBreaker.enabled = process.env.SENTIENGUARD_CIRCUIT_BREAKER_ENABLED === 'true';
+  config.circuitBreaker.timeout = parseInt(process.env.SENTIENGUARD_CIRCUIT_TIMEOUT_MS, 10) || 3000;
+  config.circuitBreaker.errorThresholdPercentage = parseInt(process.env.SENTIENGUARD_CIRCUIT_ERROR_THRESHOLD, 10) || 50;
+  config.circuitBreaker.resetTimeout = parseInt(process.env.SENTIENGUARD_CIRCUIT_RESET_TIMEOUT, 10) || 30000;
+  config.circuitBreaker.volumeThreshold = parseInt(process.env.SENTIENGUARD_CIRCUIT_VOLUME_THRESHOLD, 10) || 5;
+
+  config.openai.enabled = process.env.SENTIENGUARD_OPENAI_ENABLED !== 'false';
+  config.openai.trackTokens = process.env.SENTIENGUARD_OPENAI_TRACK_TOKENS !== 'false';
+  config.openai.trackCosts = process.env.SENTIENGUARD_OPENAI_TRACK_COSTS !== 'false';
+  config.openai.slowCallMs = parseInt(process.env.SENTIENGUARD_OPENAI_SLOW_CALL_MS, 10) || 5000;
+
+  config.tracing.enabled = process.env.SENTIENGUARD_TRACING !== 'false';
+  const sampleRaw = process.env.SENTIENGUARD_TRACE_SAMPLE_RATE;
+  const sample = sampleRaw != null ? Number(sampleRaw) : NaN;
+  if (!Number.isNaN(sample) && sample >= 0 && sample <= 1) {
+    config.tracing.sampleRate = sample;
+  }
+  config.tracing.maxQueueSize = parseInt(process.env.SENTIENGUARD_TRACE_MAX_QUEUE_SIZE, 10) || config.tracing.maxQueueSize;
+  config.tracing.maxBatchSize = parseInt(process.env.SENTIENGUARD_TRACE_MAX_BATCH_SIZE, 10) || config.tracing.maxBatchSize;
+  // Default behavior:
+  // - production: do NOT record localhost dependency edges (noise + self-calls)
+  // - non-production: DO record localhost edges (local multi-service dev "just works")
+  // Can always be overridden explicitly via SENTIENGUARD_TRACE_LOCAL_HTTP=true/false.
+  const explicitLocal =
+    process.env.SENTIENGUARD_TRACE_LOCAL_HTTP === 'true'
+      ? true
+      : process.env.SENTIENGUARD_TRACE_LOCAL_HTTP === 'false'
+        ? false
+        : undefined;
+  const isProd = (config.environment || '').toLowerCase() === 'production' ||
+                 (process.env.NODE_ENV || '').toLowerCase() === 'production';
+  config.tracing.traceLocalHttp = explicitLocal ?? !isProd;
+  config.tracing.peerServiceMap = parsePeerServiceMap(process.env.SENTIENGUARD_PEER_SERVICE_MAP || '');
+}
+
+/** "3001:payments-api,3002:auth-api" -> { "3001": "payments-api", ... } */
+function parsePeerServiceMap(raw) {
+  const map = Object.create(null);
+  if (!raw || typeof raw !== 'string') return map;
+  for (const part of raw.split(',')) {
+    const trimmed = part.trim();
+    if (!trimmed) continue;
+    const idx = trimmed.indexOf(':');
+    if (idx === -1) continue;
+    const port = trimmed.slice(0, idx).trim();
+    const name = trimmed.slice(idx + 1).trim();
+    if (port && name) map[port] = name;
+  }
+  return map;
+}
+
+function deriveTracesEndpoint(ingestEndpoint) {
+  try {
+    const u = new URL(String(ingestEndpoint));
+    // Common default: /api/v1/apm/ingest -> /api/v1/apm/traces
+    u.pathname = u.pathname.replace(/\/apm\/ingest\/?$/i, '/apm/traces');
+    return u.toString();
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * Check if SDK is properly configured and should be active.
+ * Triggers lazy config load if not yet loaded.
+ */
+export function isEnabled() {
+  loadConfig();
+  return config.enabled && !!config.apiKey && !!config.service;
+}
+
+/**
+ * Get validated configuration.
+ * Triggers lazy config load if not yet loaded.
+ */
+export function getConfig() {
+  loadConfig();
+  return { ...config };
+}
+
+/**
+ * Log debug message if debug mode is enabled
+ */
+export function debug(...args) {
+  if (config.debug) {
+    console.log('[SentienGuard APM]', ...args);
+  }
+}
+
+/**
+ * Log warning (always shown)
+ */
+export function warn(...args) {
+  console.warn('[SentienGuard APM]', ...args);
+}
+
+export default config;