@modainteract/moda-interact-shared 0.2.0 → 0.4.0

package/dist/chunk-5JNEZEKV.js

@@ -0,0 +1,374 @@
+import {
+  setLokiLogEmitter
+} from "./chunk-XU4XX7SD.js";
+
+// src/logging/node.ts
+import { logs } from "@opentelemetry/api-logs";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import {
+  BatchLogRecordProcessor,
+  LoggerProvider
+} from "@opentelemetry/sdk-logs";
+
+// src/logging/node/loki.ts
+import {
+  createLogger as createWinstonLogger,
+  format
+} from "winston";
+import LokiTransport from "winston-loki";
+var DEFAULT_SERVICE_NAMESPACE = "moda-interact";
+var runtime = null;
+function requireNonEmpty(value, field) {
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new Error(`${field} must be a non-empty string`);
+  }
+  return normalized;
+}
+function initNodeLokiLogging(options) {
+  if (runtime) {
+    return runtime;
+  }
+  const serviceName = requireNonEmpty(options.serviceName, "serviceName");
+  const environment = requireNonEmpty(options.environment, "environment");
+  const serviceNamespace = requireNonEmpty(
+    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,
+    "serviceNamespace"
+  );
+  const host = nonEmpty(options.host) ?? envString("LOKI_URL");
+  const enabled = options.forceEnable === true || envBool("LOKI_ENABLED") !== false && host !== void 0;
+  const labels = Object.freeze({
+    service_namespace: serviceNamespace,
+    service_name: serviceName,
+    environment
+  });
+  if (!enabled || !host) {
+    setLokiLogEmitter(null);
+    runtime = {
+      enabled: false,
+      host: null,
+      labels,
+      forceFlush: async () => {
+      },
+      shutdown: async () => {
+      }
+    };
+    return runtime;
+  }
+  const basicAuth = nonEmpty(options.basicAuth) ?? buildBasicAuth(
+    envString("LOKI_USERNAME"),
+    envString("LOKI_PASSWORD")
+  );
+  const transport = new LokiTransport({
+    host,
+    json: true,
+    batching: options.batching ?? envBool("LOKI_BATCHING") ?? true,
+    interval: options.intervalSeconds ?? envInt("LOKI_BATCH_INTERVAL_SECONDS", 5),
+    timeout: options.timeoutMs ?? envInt("LOKI_TIMEOUT_MS", 1e4),
+    // Prefer bounded loss to unbounded memory growth when the logging backend
+    // is unavailable. Loki must never become an application dependency.
+    clearOnError: options.clearOnError ?? envBool("LOKI_CLEAR_ON_ERROR") ?? true,
+    // Current winston-loki guidance recommends keeping timestamp replacement
+    // enabled unless there is a specific reason not to.
+    replaceTimestamp: true,
+    // Moda owns flush/shutdown explicitly from the process bootstrap.
+    gracefulShutdown: false,
+    // Critical cardinality rule: only these architecture-approved static
+    // labels may be indexed. Never promote Winston meta/data to labels.
+    labels,
+    useWinstonMetaAsLabels: false,
+    ...basicAuth ? { basicAuth } : {},
+    ...options.headers ? { headers: options.headers } : {},
+    // Do not recursively log Loki connection errors through the shared logger.
+    // Doing so could create a failure loop while Loki is unavailable.
+    onConnectionError: () => {
+    }
+  });
+  const lokiLogger = createWinstonLogger({
+    level: "debug",
+    format: format.json(),
+    transports: [transport],
+    exitOnError: false
+  });
+  setLokiLogEmitter((record) => {
+    writeCanonicalRecord(lokiLogger, record);
+  });
+  runtime = {
+    enabled: true,
+    host,
+    labels,
+    forceFlush: async () => {
+      await safeFlush(transport);
+    },
+    shutdown: async () => {
+      setLokiLogEmitter(null);
+      await safeFlush(transport);
+      await safeCloseTransport(transport);
+      try {
+        lokiLogger.close();
+      } catch {
+      }
+    }
+  };
+  return runtime;
+}
+function getNodeLokiLoggingRuntime() {
+  return runtime;
+}
+function writeCanonicalRecord(logger, record) {
+  try {
+    logger.log({
+      ...record,
+      level: record.level,
+      message: record.event
+    });
+  } catch {
+  }
+}
+async function safeFlush(transport) {
+  try {
+    await transport.flush();
+  } catch {
+  }
+}
+async function safeCloseTransport(transport) {
+  try {
+    const closeable = transport;
+    if (typeof closeable.close === "function") {
+      await Promise.resolve(closeable.close());
+    }
+  } catch {
+  }
+}
+function buildBasicAuth(username, password) {
+  if (!username || !password) {
+    return void 0;
+  }
+  return `${username}:${password}`;
+}
+function envString(name) {
+  return nonEmpty(process.env[name]);
+}
+function nonEmpty(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function envBool(name) {
+  const value = envString(name);
+  if (value === void 0) {
+    return void 0;
+  }
+  const normalized = value.toLowerCase();
+  if (["1", "true", "yes", "on"].includes(normalized)) {
+    return true;
+  }
+  if (["0", "false", "no", "off"].includes(normalized)) {
+    return false;
+  }
+  return void 0;
+}
+function envInt(name, fallback) {
+  const value = envString(name);
+  if (value === void 0) {
+    return fallback;
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
+}
+
+// src/logging/node.ts
+var DEFAULT_SERVICE_NAMESPACE2 = "moda-interact";
+var runtime2 = null;
+function requireNonEmpty2(value, field) {
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new Error(`${field} must be a non-empty string`);
+  }
+  return normalized;
+}
+function initNodeOpenTelemetryLogging(options) {
+  if (runtime2) {
+    return runtime2;
+  }
+  const serviceName = requireNonEmpty2(options.serviceName, "serviceName");
+  const environment = requireNonEmpty2(options.environment, "environment");
+  const serviceNamespace = requireNonEmpty2(
+    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE2,
+    "serviceNamespace"
+  );
+  const config = resolveLogsConfig(options);
+  if (!config.enabled || !config.endpoint) {
+    runtime2 = {
+      enabled: false,
+      endpoint: null,
+      forceFlush: async () => {
+      },
+      shutdown: async () => {
+      }
+    };
+    return runtime2;
+  }
+  const exporter = new OTLPLogExporter({
+    url: config.endpoint,
+    headers: config.headers,
+    concurrencyLimit: envInt2("OTEL_LOG_EXPORT_CONCURRENCY_LIMIT", 2)
+  });
+  const processor = new BatchLogRecordProcessor({
+    exporter,
+    maxQueueSize: envInt2("OTEL_BLRP_MAX_QUEUE_SIZE", 2048),
+    maxExportBatchSize: envInt2("OTEL_BLRP_MAX_EXPORT_BATCH_SIZE", 512),
+    scheduledDelayMillis: envInt2("OTEL_BLRP_SCHEDULE_DELAY", 1e3),
+    exportTimeoutMillis: envInt2("OTEL_BLRP_EXPORT_TIMEOUT", 3e4)
+  });
+  const provider = new LoggerProvider({
+    resource: resourceFromAttributes({
+      "service.namespace": serviceNamespace,
+      "service.name": serviceName,
+      "deployment.environment.name": environment
+    }),
+    processors: [processor],
+    logRecordLimits: {
+      attributeCountLimit: 64,
+      attributeValueLengthLimit: 4096
+    }
+  });
+  logs.setGlobalLoggerProvider(provider);
+  runtime2 = {
+    enabled: true,
+    endpoint: config.endpoint,
+    forceFlush: async () => {
+      try {
+        await provider.forceFlush();
+      } catch {
+      }
+    },
+    shutdown: async () => {
+      try {
+        await provider.shutdown();
+      } catch {
+      }
+    }
+  };
+  return runtime2;
+}
+function getNodeOpenTelemetryLoggingRuntime() {
+  return runtime2;
+}
+function resolveLogsEndpoint(explicitEndpoint) {
+  const explicit = nonEmpty2(explicitEndpoint);
+  if (explicit) {
+    return explicit;
+  }
+  const signalEndpoint = envString2("OTEL_EXPORTER_OTLP_LOGS_ENDPOINT");
+  if (signalEndpoint) {
+    return signalEndpoint;
+  }
+  const genericEndpoint = envString2("OTEL_EXPORTER_OTLP_ENDPOINT");
+  if (!genericEndpoint) {
+    return void 0;
+  }
+  const normalized = genericEndpoint.replace(/\/+$/, "");
+  if (normalized.endsWith("/v1/logs")) {
+    return normalized;
+  }
+  return `${normalized}/v1/logs`;
+}
+function parseOtlpHeaders(value) {
+  const raw = nonEmpty2(value);
+  if (!raw) {
+    return void 0;
+  }
+  const headers = {};
+  for (const part of raw.split(",")) {
+    const separator = part.indexOf("=");
+    if (separator <= 0) {
+      continue;
+    }
+    const rawKey = part.slice(0, separator).trim();
+    const rawValue = part.slice(separator + 1).trim();
+    if (!rawKey) {
+      continue;
+    }
+    headers[safeDecodeURIComponent(rawKey)] = safeDecodeURIComponent(rawValue);
+  }
+  return Object.keys(headers).length > 0 ? headers : void 0;
+}
+function resolveLogsConfig(options) {
+  if (!options.forceEnable && envBool2("OTEL_SDK_DISABLED") === true) {
+    return {
+      enabled: false,
+      endpoint: void 0,
+      headers: void 0
+    };
+  }
+  const exporterName = envString2("OTEL_LOGS_EXPORTER") ?? "otlp";
+  if (!options.forceEnable && exporterName !== "otlp") {
+    return {
+      enabled: false,
+      endpoint: void 0,
+      headers: void 0
+    };
+  }
+  const endpoint = resolveLogsEndpoint(options.endpoint);
+  if (!endpoint) {
+    return {
+      enabled: false,
+      endpoint: void 0,
+      headers: void 0
+    };
+  }
+  const headers = options.headers ?? parseOtlpHeaders(
+    envString2("OTEL_EXPORTER_OTLP_LOGS_HEADERS") ?? envString2("OTEL_EXPORTER_OTLP_HEADERS")
+  );
+  return {
+    enabled: true,
+    endpoint,
+    headers
+  };
+}
+function envString2(name) {
+  return nonEmpty2(process.env[name]);
+}
+function nonEmpty2(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function envBool2(name) {
+  const value = envString2(name);
+  if (value === void 0) {
+    return void 0;
+  }
+  return ["1", "true", "yes", "on"].includes(value.toLowerCase());
+}
+function envInt2(name, fallback) {
+  const value = envString2(name);
+  if (value === void 0) {
+    return fallback;
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
+}
+function safeDecodeURIComponent(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+
+export {
+  initNodeLokiLogging,
+  getNodeLokiLoggingRuntime,
+  initNodeOpenTelemetryLogging,
+  getNodeOpenTelemetryLoggingRuntime,
+  resolveLogsEndpoint,
+  parseOtlpHeaders
+};
+//# sourceMappingURL=chunk-5JNEZEKV.js.map

package/dist/chunk-5JNEZEKV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/node.ts","../src/logging/node/loki.ts"],"sourcesContent":["import { logs } from \"@opentelemetry/api-logs\";\nimport { OTLPLogExporter } from \"@opentelemetry/exporter-logs-otlp-http\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport {\n  BatchLogRecordProcessor,\n  LoggerProvider,\n} from \"@opentelemetry/sdk-logs\";\n\nexport {\n  getNodeLokiLoggingRuntime,\n  initNodeLokiLogging,\n} from \"./node/loki.js\";\nexport type {\n  NodeLokiLoggingOptions,\n  NodeLokiLoggingRuntime,\n} from \"./node/loki.js\";\n\nconst DEFAULT_SERVICE_NAMESPACE = \"moda-interact\";\n\nexport type NodeOpenTelemetryLoggingOptions = {\n  serviceName: string;\n  environment: string;\n  serviceNamespace?: string;\n\n  /**\n   * Explicit endpoint override. Intended mainly for tests.\n   *\n   * Production normally uses:\n   *   OTEL_EXPORTER_OTLP_LOGS_ENDPOINT\n   * or:\n   *   OTEL_EXPORTER_OTLP_ENDPOINT\n   */\n  endpoint?: string;\n\n  /** Optional explicit OTLP headers override. */\n  headers?: Record<string, string>;\n\n  /** Test-only switch. Production should rely on environment configuration. */\n  forceEnable?: boolean;\n};\n\nexport type NodeOpenTelemetryLoggingRuntime = {\n  enabled: boolean;\n  endpoint: string | null;\n  forceFlush: () => Promise<void>;\n  shutdown: () => Promise<void>;\n};\n\nlet runtime: NodeOpenTelemetryLoggingRuntime | null = null;\n\nfunction requireNonEmpty(value: string, field: string): string {\n  const normalized = value.trim();\n  if (!normalized) {\n    throw new Error(`${field} must be a non-empty string`);\n  }\n  return normalized;\n}\n\n/**\n * Installs the Node OpenTelemetry LoggerProvider exactly once for this process.\n *\n * IMPORTANT:\n * This module is Node-only. Import and initialize it from the process bootstrap\n * before framework/application modules are loaded. Do not import this module\n * through Vite/React/browser bundles.\n *\n * Application modules should import only:\n *\n *   @modainteract/moda-interact-shared/logging\n *\n * Once this provider is installed, createLogger(...) automatically fans safe\n * canonical log records out to stdout and the OpenTelemetry Logs API.\n *\n * Direct Loki delivery, when desired, is independently enabled with:\n *\n *   initNodeLokiLogging(...)\n *\n * from this same Node-only package entry.\n */\nexport function initNodeOpenTelemetryLogging(\n  options: NodeOpenTelemetryLoggingOptions,\n): NodeOpenTelemetryLoggingRuntime {\n  if (runtime) {\n    return runtime;\n  }\n\n  const serviceName = requireNonEmpty(options.serviceName, \"serviceName\");\n  const environment = requireNonEmpty(options.environment, \"environment\");\n  const serviceNamespace = requireNonEmpty(\n    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,\n    \"serviceNamespace\",\n  );\n\n  const config = resolveLogsConfig(options);\n\n  if (!config.enabled || !config.endpoint) {\n    runtime = {\n      enabled: false,\n      endpoint: null,\n      forceFlush: async () => {},\n      shutdown: async () => {},\n    };\n    return runtime;\n  }\n\n  const exporter = new OTLPLogExporter({\n    url: config.endpoint,\n    headers: config.headers,\n    concurrencyLimit: envInt(\"OTEL_LOG_EXPORT_CONCURRENCY_LIMIT\", 2),\n  });\n\n  const processor = new BatchLogRecordProcessor({\n    exporter,\n    maxQueueSize: envInt(\"OTEL_BLRP_MAX_QUEUE_SIZE\", 2048),\n    maxExportBatchSize: envInt(\"OTEL_BLRP_MAX_EXPORT_BATCH_SIZE\", 512),\n    scheduledDelayMillis: envInt(\"OTEL_BLRP_SCHEDULE_DELAY\", 1_000),\n    exportTimeoutMillis: envInt(\"OTEL_BLRP_EXPORT_TIMEOUT\", 30_000),\n  });\n\n  const provider = new LoggerProvider({\n    resource: resourceFromAttributes({\n      \"service.namespace\": serviceNamespace,\n      \"service.name\": serviceName,\n      \"deployment.environment.name\": environment,\n    }),\n    processors: [processor],\n    logRecordLimits: {\n      attributeCountLimit: 64,\n      attributeValueLengthLimit: 4096,\n    },\n  });\n\n  logs.setGlobalLoggerProvider(provider);\n\n  runtime = {\n    enabled: true,\n    endpoint: config.endpoint,\n    forceFlush: async () => {\n      try {\n        await provider.forceFlush();\n      } catch {\n        // Telemetry delivery is best-effort.\n      }\n    },\n    shutdown: async () => {\n      try {\n        await provider.shutdown();\n      } catch {\n        // Telemetry shutdown is best-effort.\n      }\n    },\n  };\n\n  return runtime;\n}\n\nexport function getNodeOpenTelemetryLoggingRuntime():\n  | NodeOpenTelemetryLoggingRuntime\n  | null {\n  return runtime;\n}\n\nexport function resolveLogsEndpoint(\n  explicitEndpoint?: string,\n): string | undefined {\n  const explicit = nonEmpty(explicitEndpoint);\n  if (explicit) {\n    return explicit;\n  }\n\n  const signalEndpoint = envString(\"OTEL_EXPORTER_OTLP_LOGS_ENDPOINT\");\n  if (signalEndpoint) {\n    return signalEndpoint;\n  }\n\n  const genericEndpoint = envString(\"OTEL_EXPORTER_OTLP_ENDPOINT\");\n  if (!genericEndpoint) {\n    return undefined;\n  }\n\n  const normalized = genericEndpoint.replace(/\\/+$/, \"\");\n  if (normalized.endsWith(\"/v1/logs\")) {\n    return normalized;\n  }\n  return `${normalized}/v1/logs`;\n}\n\nexport function parseOtlpHeaders(value: string | undefined):\n  | Record<string, string>\n  | undefined {\n  const raw = nonEmpty(value);\n  if (!raw) {\n    return undefined;\n  }\n\n  const headers: Record<string, string> = {};\n\n  for (const part of raw.split(\",\")) {\n    const separator = part.indexOf(\"=\");\n    if (separator <= 0) {\n      continue;\n    }\n\n    const rawKey = part.slice(0, separator).trim();\n    const rawValue = part.slice(separator + 1).trim();\n\n    if (!rawKey) {\n      continue;\n    }\n\n    headers[safeDecodeURIComponent(rawKey)] =\n      safeDecodeURIComponent(rawValue);\n  }\n\n  return Object.keys(headers).length > 0 ? headers : undefined;\n}\n\nfunction resolveLogsConfig(options: NodeOpenTelemetryLoggingOptions) {\n  if (!options.forceEnable && envBool(\"OTEL_SDK_DISABLED\") === true) {\n    return {\n      enabled: false,\n      endpoint: undefined,\n      headers: undefined,\n    };\n  }\n\n  const exporterName = envString(\"OTEL_LOGS_EXPORTER\") ?? \"otlp\";\n\n  if (!options.forceEnable && exporterName !== \"otlp\") {\n    return {\n      enabled: false,\n      endpoint: undefined,\n      headers: undefined,\n    };\n  }\n\n  const endpoint = resolveLogsEndpoint(options.endpoint);\n\n  if (!endpoint) {\n    return {\n      enabled: false,\n      endpoint: undefined,\n      headers: undefined,\n    };\n  }\n\n  const headers =\n    options.headers ??\n    parseOtlpHeaders(\n      envString(\"OTEL_EXPORTER_OTLP_LOGS_HEADERS\") ??\n        envString(\"OTEL_EXPORTER_OTLP_HEADERS\"),\n    );\n\n  return {\n    enabled: true,\n    endpoint,\n    headers,\n  };\n}\n\nfunction envString(name: string): string | undefined {\n  return nonEmpty(process.env[name]);\n}\n\nfunction nonEmpty(value: string | undefined): string | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction envBool(name: string): boolean | undefined {\n  const value = envString(name);\n  if (value === undefined) {\n    return undefined;\n  }\n  return [\"1\", \"true\", \"yes\", \"on\"].includes(value.toLowerCase());\n}\n\nfunction envInt(name: string, fallback: number): number {\n  const value = envString(name);\n  if (value === undefined) {\n    return fallback;\n  }\n\n  const parsed = Number(value);\n  return Number.isFinite(parsed) && parsed > 0\n    ? Math.floor(parsed)\n    : fallback;\n}\n\nfunction safeDecodeURIComponent(value: string): string {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return value;\n  }\n}\n","import {\n  createLogger as createWinstonLogger,\n  format,\n  type Logger as WinstonLogger,\n} from \"winston\";\nimport LokiTransport from \"winston-loki\";\nimport { setLokiLogEmitter } from \"../loki.js\";\nimport type { LogRecord } from \"../types.js\";\n\nconst DEFAULT_SERVICE_NAMESPACE = \"moda-interact\";\n\nexport type NodeLokiLoggingOptions = {\n  serviceName: string;\n  environment: string;\n  serviceNamespace?: string;\n\n  /**\n   * Explicit Loki base URL.\n   *\n   * Production normally supplies LOKI_URL.\n   */\n  host?: string;\n\n  /**\n   * Optional Basic Auth override in `username:password` format.\n   *\n   * Prefer separate LOKI_USERNAME/LOKI_PASSWORD environment variables in\n   * deployed services so the composed value never needs to be committed.\n   */\n  basicAuth?: string;\n\n  /**\n   * Optional additional static headers.\n   *\n   * Never include these in log payloads or error messages.\n   */\n  headers?: Record<string, string>;\n\n  batching?: boolean;\n  intervalSeconds?: number;\n  timeoutMs?: number;\n  clearOnError?: boolean;\n\n  /**\n   * Test-only override. In normal service bootstrap, the presence of a Loki\n   * host is sufficient to enable the transport.\n   */\n  forceEnable?: boolean;\n};\n\nexport type NodeLokiLoggingRuntime = {\n  enabled: boolean;\n  host: string | null;\n  labels: Readonly<Record<string, string>>;\n  forceFlush: () => Promise<void>;\n  shutdown: () => Promise<void>;\n};\n\nlet runtime: NodeLokiLoggingRuntime | null = null;\n\nfunction requireNonEmpty(value: string, field: string): string {\n  const normalized = value.trim();\n  if (!normalized) {\n    throw new Error(`${field} must be a non-empty string`);\n  }\n  return normalized;\n}\n\n/**\n * Installs the direct Grafana Loki destination exactly once per Node process.\n *\n * IMPORTANT:\n * - This module is Node-only.\n * - It is reached through @modainteract/moda-interact-shared/logging/node.\n * - Do not import it from Vite/browser/application module graphs.\n * - The normal ./logging entry contains no Winston/winston-loki imports.\n */\nexport function initNodeLokiLogging(\n  options: NodeLokiLoggingOptions,\n): NodeLokiLoggingRuntime {\n  if (runtime) {\n    return runtime;\n  }\n\n  const serviceName = requireNonEmpty(options.serviceName, \"serviceName\");\n  const environment = requireNonEmpty(options.environment, \"environment\");\n  const serviceNamespace = requireNonEmpty(\n    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,\n    \"serviceNamespace\",\n  );\n\n  const host = nonEmpty(options.host) ?? envString(\"LOKI_URL\");\n  const enabled =\n    options.forceEnable === true ||\n    (envBool(\"LOKI_ENABLED\") !== false && host !== undefined);\n\n  const labels = Object.freeze({\n    service_namespace: serviceNamespace,\n    service_name: serviceName,\n    environment,\n  });\n\n  if (!enabled || !host) {\n    setLokiLogEmitter(null);\n\n    runtime = {\n      enabled: false,\n      host: null,\n      labels,\n      forceFlush: async () => {},\n      shutdown: async () => {},\n    };\n\n    return runtime;\n  }\n\n  const basicAuth =\n    nonEmpty(options.basicAuth) ??\n    buildBasicAuth(\n      envString(\"LOKI_USERNAME\"),\n      envString(\"LOKI_PASSWORD\"),\n    );\n\n  const transport = new LokiTransport({\n    host,\n    json: true,\n    batching: options.batching ?? envBool(\"LOKI_BATCHING\") ?? true,\n    interval:\n      options.intervalSeconds ??\n      envInt(\"LOKI_BATCH_INTERVAL_SECONDS\", 5),\n    timeout:\n      options.timeoutMs ??\n      envInt(\"LOKI_TIMEOUT_MS\", 10_000),\n\n    // Prefer bounded loss to unbounded memory growth when the logging backend\n    // is unavailable. Loki must never become an application dependency.\n    clearOnError:\n      options.clearOnError ??\n      envBool(\"LOKI_CLEAR_ON_ERROR\") ??\n      true,\n\n    // Current winston-loki guidance recommends keeping timestamp replacement\n    // enabled unless there is a specific reason not to.\n    replaceTimestamp: true,\n\n    // Moda owns flush/shutdown explicitly from the process bootstrap.\n    gracefulShutdown: false,\n\n    // Critical cardinality rule: only these architecture-approved static\n    // labels may be indexed. Never promote Winston meta/data to labels.\n    labels,\n    useWinstonMetaAsLabels: false,\n\n    ...(basicAuth ? { basicAuth } : {}),\n    ...(options.headers ? { headers: options.headers } : {}),\n\n    // Do not recursively log Loki connection errors through the shared logger.\n    // Doing so could create a failure loop while Loki is unavailable.\n    onConnectionError: () => {},\n  });\n\n  const lokiLogger = createWinstonLogger({\n    level: \"debug\",\n    format: format.json(),\n    transports: [transport],\n    exitOnError: false,\n  });\n\n  setLokiLogEmitter((record) => {\n    writeCanonicalRecord(lokiLogger, record);\n  });\n\n  runtime = {\n    enabled: true,\n    host,\n    labels,\n    forceFlush: async () => {\n      await safeFlush(transport);\n    },\n    shutdown: async () => {\n      setLokiLogEmitter(null);\n      await safeFlush(transport);\n      await safeCloseTransport(transport);\n\n      try {\n        lokiLogger.close();\n      } catch {\n        // best-effort\n      }\n    },\n  };\n\n  return runtime;\n}\n\nexport function getNodeLokiLoggingRuntime():\n  | NodeLokiLoggingRuntime\n  | null {\n  return runtime;\n}\n\nfunction writeCanonicalRecord(\n  logger: WinstonLogger,\n  record: LogRecord,\n): void {\n  try {\n    // Winston requires a `message`; use the canonical event name.\n    //\n    // Every other value comes from the already-sanitized immutable Moda\n    // LogRecord. Because useWinstonMetaAsLabels=false, these values remain in\n    // the JSON log line rather than becoming Loki stream labels.\n    logger.log({\n      ...record,\n      level: record.level,\n      message: record.event,\n    });\n  } catch {\n    // Direct Loki emission must never escape to business code.\n  }\n}\n\nasync function safeFlush(transport: LokiTransport): Promise<void> {\n  try {\n    await transport.flush();\n  } catch {\n    // Logs may be dropped. Business processing must continue.\n  }\n}\n\nasync function safeCloseTransport(\n  transport: LokiTransport,\n): Promise<void> {\n  try {\n    const closeable = transport as LokiTransport & {\n      close?: () => unknown | Promise<unknown>;\n    };\n\n    if (typeof closeable.close === \"function\") {\n      await Promise.resolve(closeable.close());\n    }\n  } catch {\n    // best-effort shutdown\n  }\n}\n\nfunction buildBasicAuth(\n  username: string | undefined,\n  password: string | undefined,\n): string | undefined {\n  if (!username || !password) {\n    return undefined;\n  }\n\n  return `${username}:${password}`;\n}\n\nfunction envString(name: string): string | undefined {\n  return nonEmpty(process.env[name]);\n}\n\nfunction nonEmpty(value: string | undefined): string | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nfunction envBool(name: string): boolean | undefined {\n  const value = envString(name);\n\n  if (value === undefined) {\n    return undefined;\n  }\n\n  const normalized = value.toLowerCase();\n\n  if ([\"1\", \"true\", \"yes\", \"on\"].includes(normalized)) {\n    return true;\n  }\n\n  if ([\"0\", \"false\", \"no\", \"off\"].includes(normalized)) {\n    return false;\n  }\n\n  return undefined;\n}\n\nfunction envInt(name: string, fallback: number): number {\n  const value = envString(name);\n\n  if (value === undefined) {\n    return fallback;\n  }\n\n  const parsed = Number(value);\n\n  return Number.isFinite(parsed) && parsed > 0\n    ? Math.floor(parsed)\n    : fallback;\n}\n"],"mappings":"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","names":["DEFAULT_SERVICE_NAMESPACE","runtime","requireNonEmpty","envInt","nonEmpty","envString","envBool"]}

package/dist/chunk-XH6XHKXC.js

@@ -0,0 +1,34 @@
+// src/observability/index.ts
+import {
+  context,
+  SpanStatusCode,
+  trace
+} from "@opentelemetry/api";
+var TRACER_NAME = "@modainteract/moda-interact-shared/observability";
+function getActiveTraceId() {
+  return trace.getSpan(context.active())?.spanContext().traceId;
+}
+async function withObservedSpan(name, attributes, work) {
+  const tracer = trace.getTracer(TRACER_NAME);
+  return tracer.startActiveSpan(name, { attributes }, async (span) => {
+    try {
+      const result = await work();
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(
+        error instanceof Error ? error : new Error(String(error))
+      );
+      span.setStatus({ code: SpanStatusCode.ERROR });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+
+export {
+  getActiveTraceId,
+  withObservedSpan
+};
+//# sourceMappingURL=chunk-XH6XHKXC.js.map

package/dist/chunk-XH6XHKXC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability/index.ts"],"sourcesContent":["import {\n  context,\n  SpanStatusCode,\n  trace,\n  type Attributes,\n} from \"@opentelemetry/api\";\n\nconst TRACER_NAME = \"@modainteract/moda-interact-shared/observability\";\n\nexport function getActiveTraceId(): string | undefined {\n  return trace.getSpan(context.active())?.spanContext().traceId;\n}\n\nexport async function withObservedSpan<T>(\n  name: string,\n  attributes: Attributes,\n  work: () => Promise<T>,\n): Promise<T> {\n  const tracer = trace.getTracer(TRACER_NAME);\n\n  return tracer.startActiveSpan(name, { attributes }, async (span) => {\n    try {\n      const result = await work();\n      span.setStatus({ code: SpanStatusCode.OK });\n      return result;\n    } catch (error) {\n      span.recordException(\n        error instanceof Error ? error : new Error(String(error)),\n      );\n      span.setStatus({ code: SpanStatusCode.ERROR });\n      throw error;\n    } finally {\n      span.end();\n    }\n  });\n}"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,IAAM,cAAc;AAEb,SAAS,mBAAuC;AACrD,SAAO,MAAM,QAAQ,QAAQ,OAAO,CAAC,GAAG,YAAY,EAAE;AACxD;AAEA,eAAsB,iBACpB,MACA,YACA,MACY;AACZ,QAAM,SAAS,MAAM,UAAU,WAAW;AAE1C,SAAO,OAAO,gBAAgB,MAAM,EAAE,WAAW,GAAG,OAAO,SAAS;AAClE,QAAI;AACF,YAAM,SAAS,MAAM,KAAK;AAC1B,WAAK,UAAU,EAAE,MAAM,eAAe,GAAG,CAAC;AAC1C,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK;AAAA,QACH,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,MAC1D;AACA,WAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;AAC7C,YAAM;AAAA,IACR,UAAE;AACA,WAAK,IAAI;AAAA,IACX;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/chunk-XU4XX7SD.js

@@ -0,0 +1,27 @@
+// src/logging/loki.ts
+function globalState() {
+  return globalThis;
+}
+function setLokiLogEmitter(emitter) {
+  try {
+    const state = globalState();
+    if (emitter) {
+      state.__modaInteractLokiLogEmitterV1 = emitter;
+    } else {
+      delete state.__modaInteractLokiLogEmitterV1;
+    }
+  } catch {
+  }
+}
+function emitLokiLog(record) {
+  try {
+    globalState().__modaInteractLokiLogEmitterV1?.(record);
+  } catch {
+  }
+}
+
+export {
+  setLokiLogEmitter,
+  emitLokiLog
+};
+//# sourceMappingURL=chunk-XU4XX7SD.js.map

package/dist/chunk-XU4XX7SD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/loki.ts"],"sourcesContent":["import type { LogRecord } from \"./types.js\";\n\nexport type LokiLogEmitter = (record: LogRecord) => void;\n\ntype ModaLoggingGlobal = typeof globalThis & {\n  __modaInteractLokiLogEmitterV1?: LokiLogEmitter;\n};\n\nfunction globalState(): ModaLoggingGlobal {\n  return globalThis as ModaLoggingGlobal;\n}\n\n/**\n * Installs/removes the Node-owned direct Loki emitter.\n *\n * This bridge deliberately contains no Winston, Loki or Node networking\n * imports so it remains safe inside the normal ./logging entry.\n *\n * globalThis is required because tsup emits ./logging and ./logging/node as\n * independent bundles. A module-local variable would not be shared between\n * those package entry points.\n */\nexport function setLokiLogEmitter(emitter: LokiLogEmitter | null): void {\n  try {\n    const state = globalState();\n\n    if (emitter) {\n      state.__modaInteractLokiLogEmitterV1 = emitter;\n    } else {\n      delete state.__modaInteractLokiLogEmitterV1;\n    }\n  } catch {\n    // Logging configuration must never become a correctness dependency.\n  }\n}\n\n/**\n * Sends an already-sanitized canonical Moda log record to the optional Loki\n * emitter installed by ./logging/node.\n */\nexport function emitLokiLog(record: LogRecord): void {\n  try {\n    globalState().__modaInteractLokiLogEmitterV1?.(record);\n  } catch {\n    // Direct Loki delivery is always best-effort.\n  }\n}\n"],"mappings":";AAQA,SAAS,cAAiC;AACxC,SAAO;AACT;AAYO,SAAS,kBAAkB,SAAsC;AACtE,MAAI;AACF,UAAM,QAAQ,YAAY;AAE1B,QAAI,SAAS;AACX,YAAM,iCAAiC;AAAA,IACzC,OAAO;AACL,aAAO,MAAM;AAAA,IACf;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AAMO,SAAS,YAAY,QAAyB;AACnD,MAAI;AACF,gBAAY,EAAE,iCAAiC,MAAM;AAAA,EACvD,QAAQ;AAAA,EAER;AACF;","names":[]}

package/dist/logging/index.js

@@ -1,3 +1,38 @@
+import {
+  emitLokiLog
+} from "../chunk-XU4XX7SD.js";
+
+// src/logging/otel.ts
+import { logs, SeverityNumber } from "@opentelemetry/api-logs";
+var OTEL_LOGGER_SCOPE_NAME = "@modainteract/moda-interact-shared/logging";
+var SEVERITY_BY_LEVEL = Object.freeze({
+  debug: SeverityNumber.DEBUG,
+  info: SeverityNumber.INFO,
+  warn: SeverityNumber.WARN,
+  error: SeverityNumber.ERROR
+});
+function emitOpenTelemetryLog(record) {
+  try {
+    const logger = logs.getLogger(OTEL_LOGGER_SCOPE_NAME);
+    logger.emit({
+      eventName: record.event,
+      timestamp: new Date(record.timestamp),
+      severityNumber: SEVERITY_BY_LEVEL[record.level],
+      severityText: record.level.toUpperCase(),
+      // Keep the OTLP body identical to the structured stdout record.
+      body: JSON.stringify(record),
+      attributes: {
+        "event.name": record.event,
+        "log.level": record.level,
+        "service.namespace": record["service.namespace"],
+        "service.name": record["service.name"],
+        "deployment.environment.name": record["deployment.environment.name"]
+      }
+    });
+  } catch {
+  }
+}
+
 // src/logging/redaction.ts
 var REDACTED = "[REDACTED]";
 var CIRCULAR = "[Circular]";
@@ -156,10 +191,11 @@ function createLogger(options) {
   const initialBaseFields = { ...options.baseFields ?? {} };
   function buildLogger(baseFields) {
     function emit(level, event, fields = {}) {
+      let record;
       try {
         const eventName = event.trim() || "unknown";
         const sanitizedData = sanitizeLogFields({ ...baseFields, ...fields });
-        const record = Object.freeze({
+        record = Object.freeze({
           timestamp: safeTimestamp(now),
           level,
           event: eventName,
@@ -168,9 +204,15 @@ function createLogger(options) {
           "deployment.environment.name": environment,
           ...Object.keys(sanitizedData).length > 0 ? { data: sanitizedData } : {}
         });
+      } catch {
+        return;
+      }
+      try {
         sink(record);
       } catch {
       }
+      emitOpenTelemetryLog(record);
+      emitLokiLog(record);
     }
     return Object.freeze({
       debug: (event, fields) => emit("debug", event, fields),

package/dist/logging/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/logging/redaction.ts","../../src/logging/logger.ts","../../src/logging/types.ts"],"sourcesContent":["export const REDACTED = \"[REDACTED]\";\nexport const CIRCULAR = \"[Circular]\";\nexport const MAX_DEPTH_REACHED = \"[MaxDepth]\";\nexport const TRUNCATED = \"[Truncated]\";\n\nexport const LOG_VALUE_LIMITS = Object.freeze({\n  maxDepth: 6,\n  maxArrayItems: 50,\n  maxObjectKeys: 100,\n  maxStringLength: 4096,\n});\n\nconst SENSITIVE_EXACT_KEYS = new Set([\n  \"authorization\",\n  \"cookie\",\n  \"setcookie\",\n  \"password\",\n  \"passwd\",\n  \"apikey\",\n  \"privatekey\",\n  \"cvv\",\n  \"cvc\",\n  \"cardnumber\",\n  \"creditcard\",\n  \"firstname\",\n  \"lastname\",\n]);\n\nfunction normalizeKey(key: string): string {\n  return key.toLowerCase().replace(/[^a-z0-9]/g, \"\");\n}\n\nexport function isSensitiveLogKey(key: string): boolean {\n  const normalized = normalizeKey(key);\n\n  return (\n    SENSITIVE_EXACT_KEYS.has(normalized) ||\n    normalized.includes(\"secret\") ||\n    normalized.endsWith(\"token\") ||\n    normalized.includes(\"email\") ||\n    normalized.includes(\"phone\") ||\n    normalized.endsWith(\"address\")\n  );\n}\n\nfunction sanitizeString(value: string): string {\n  const scrubbed = value\n    .replace(/\\bBearer\\s+[^\\s,;]+/gi, `Bearer ${REDACTED}`)\n    .replace(\n      /([?&](?:access_token|refresh_token|verify_token|client_secret|api_key|token|password)=)[^&#\\s]*/gi,\n      `$1${REDACTED}`,\n    );\n\n  if (scrubbed.length <= LOG_VALUE_LIMITS.maxStringLength) {\n    return scrubbed;\n  }\n\n  return `${scrubbed.slice(0, LOG_VALUE_LIMITS.maxStringLength)}…${TRUNCATED}`;\n}\n\nfunction sanitizeError(error: Error): Record<string, unknown> {\n  return {\n    name: sanitizeString(error.name),\n    message: sanitizeString(error.message),\n  };\n}\n\nfunction sanitizeValue(\n  value: unknown,\n  depth: number,\n  activeObjects: WeakSet<object>,\n): unknown {\n  if (value === null || value === undefined) {\n    return value ?? null;\n  }\n\n  if (typeof value === \"string\") {\n    return sanitizeString(value);\n  }\n\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : String(value);\n  }\n\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n\n  if (typeof value === \"bigint\") {\n    return value.toString();\n  }\n\n  if (typeof value === \"symbol\" || typeof value === \"function\") {\n    return `[${typeof value}]`;\n  }\n\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? \"Invalid Date\" : value.toISOString();\n  }\n\n  if (value instanceof Error) {\n    return sanitizeError(value);\n  }\n\n  if (depth >= LOG_VALUE_LIMITS.maxDepth) {\n    return MAX_DEPTH_REACHED;\n  }\n\n  if (typeof value !== \"object\") {\n    return String(value);\n  }\n\n  if (activeObjects.has(value)) {\n    return CIRCULAR;\n  }\n\n  activeObjects.add(value);\n\n  try {\n    if (Array.isArray(value)) {\n      const result = value\n        .slice(0, LOG_VALUE_LIMITS.maxArrayItems)\n        .map((item) => sanitizeValue(item, depth + 1, activeObjects));\n\n      if (value.length > LOG_VALUE_LIMITS.maxArrayItems) {\n        result.push(TRUNCATED);\n      }\n\n      return result;\n    }\n\n    const result: Record<string, unknown> = {};\n    const entries = Object.entries(value).slice(0, LOG_VALUE_LIMITS.maxObjectKeys);\n\n    for (const [key, item] of entries) {\n      result[key] = isSensitiveLogKey(key)\n        ? REDACTED\n        : sanitizeValue(item, depth + 1, activeObjects);\n    }\n\n    if (Object.keys(value).length > LOG_VALUE_LIMITS.maxObjectKeys) {\n      result.__truncated__ = true;\n    }\n\n    return result;\n  } finally {\n    activeObjects.delete(value);\n  }\n}\n\nexport function sanitizeLogFields(\n  fields: Readonly<Record<string, unknown>>,\n): Record<string, unknown> {\n  return sanitizeValue(fields, 0, new WeakSet<object>()) as Record<string, unknown>;\n}\n","import { sanitizeLogFields } from \"./redaction.js\";\nimport type {\n  LogFields,\n  LogLevel,\n  LogRecord,\n  LogSink,\n  LoggerOptions,\n  StructuredLogger,\n} from \"./types.js\";\n\nconst DEFAULT_SERVICE_NAMESPACE = \"moda-interact\";\n\nfunction requireNonEmpty(value: string, field: string): string {\n  const normalized = value.trim();\n  if (!normalized) {\n    throw new Error(`${field} must be a non-empty string`);\n  }\n  return normalized;\n}\n\nfunction defaultSink(record: LogRecord): void {\n  const line = JSON.stringify(record);\n\n  switch (record.level) {\n    case \"debug\":\n      console.debug(line);\n      break;\n    case \"warn\":\n      console.warn(line);\n      break;\n    case \"error\":\n      console.error(line);\n      break;\n    case \"info\":\n    default:\n      console.info(line);\n      break;\n  }\n}\n\nfunction safeTimestamp(now: () => Date): string {\n  try {\n    const value = now();\n    if (value instanceof Date && !Number.isNaN(value.getTime())) {\n      return value.toISOString();\n    }\n  } catch {\n    // Logging must not become a correctness dependency.\n  }\n\n  return new Date().toISOString();\n}\n\nexport function createLogger(options: LoggerOptions): StructuredLogger {\n  const serviceName = requireNonEmpty(options.serviceName, \"serviceName\");\n  const environment = requireNonEmpty(options.environment, \"environment\");\n  const serviceNamespace = requireNonEmpty(\n    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,\n    \"serviceNamespace\",\n  );\n  const sink: LogSink = options.sink ?? defaultSink;\n  const now = options.now ?? (() => new Date());\n  const initialBaseFields = { ...(options.baseFields ?? {}) };\n\n  function buildLogger(baseFields: Record<string, unknown>): StructuredLogger {\n    function emit(level: LogLevel, event: string, fields: LogFields = {}): void {\n      try {\n        const eventName = event.trim() || \"unknown\";\n        const sanitizedData = sanitizeLogFields({ ...baseFields, ...fields });\n\n        const record: LogRecord = Object.freeze({\n          timestamp: safeTimestamp(now),\n          level,\n          event: eventName,\n          \"service.namespace\": serviceNamespace,\n          \"service.name\": serviceName,\n          \"deployment.environment.name\": environment,\n          ...(Object.keys(sanitizedData).length > 0 ? { data: sanitizedData } : {}),\n        });\n\n        sink(record);\n      } catch {\n        // Logging is best-effort and must never alter business correctness.\n      }\n    }\n\n    return Object.freeze({\n      debug: (event: string, fields?: LogFields) => emit(\"debug\", event, fields),\n      info: (event: string, fields?: LogFields) => emit(\"info\", event, fields),\n      warn: (event: string, fields?: LogFields) => emit(\"warn\", event, fields),\n      error: (event: string, fields?: LogFields) => emit(\"error\", event, fields),\n      child: (fields: LogFields) => buildLogger({ ...baseFields, ...fields }),\n    });\n  }\n\n  return buildLogger(initialBaseFields);\n}\n","export const LOG_LEVELS = [\"debug\", \"info\", \"warn\", \"error\"] as const;\n\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\nexport type LogFields = Readonly<Record<string, unknown>>;\n\nexport type LogRecord = Readonly<{\n  timestamp: string;\n  level: LogLevel;\n  event: string;\n  \"service.namespace\": string;\n  \"service.name\": string;\n  \"deployment.environment.name\": string;\n  data?: Readonly<Record<string, unknown>>;\n}>;\n\nexport type LogSink = (record: LogRecord) => void;\n\nexport type LoggerOptions = {\n  serviceName: string;\n  environment: string;\n  serviceNamespace?: string;\n  baseFields?: LogFields;\n  sink?: LogSink;\n  now?: () => Date;\n};\n\nexport interface StructuredLogger {\n  debug(event: string, fields?: LogFields): void;\n  info(event: string, fields?: LogFields): void;\n  warn(event: string, fields?: LogFields): void;\n  error(event: string, fields?: LogFields): void;\n  child(fields: LogFields): StructuredLogger;\n}\n"],"mappings":"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","names":["result"]}
+{"version":3,"sources":["../../src/logging/otel.ts","../../src/logging/redaction.ts","../../src/logging/logger.ts","../../src/logging/types.ts"],"sourcesContent":["import { logs, SeverityNumber } from \"@opentelemetry/api-logs\";\nimport type { LogLevel, LogRecord } from \"./types.js\";\n\nconst OTEL_LOGGER_SCOPE_NAME = \"@modainteract/moda-interact-shared/logging\";\n\nconst SEVERITY_BY_LEVEL: Readonly<Record<LogLevel, SeverityNumber>> = Object.freeze({\n  debug: SeverityNumber.DEBUG,\n  info: SeverityNumber.INFO,\n  warn: SeverityNumber.WARN,\n  error: SeverityNumber.ERROR,\n});\n\n/**\n * Emits the already-sanitized canonical Moda log record through the global\n * OpenTelemetry Logs API.\n *\n * If no LoggerProvider has been installed, the OpenTelemetry Logs API is a\n * no-op. This is intentional: stdout logging remains available in local/test\n * environments without an OTLP backend.\n *\n * The OpenTelemetry SDK automatically associates emitted records with the\n * active Context when a tracing context manager/provider is present. This is\n * how logs become trace/span-correlated without the shared logger depending on\n * a service-specific tracing SDK.\n */\nexport function emitOpenTelemetryLog(record: LogRecord): void {\n  try {\n    const logger = logs.getLogger(OTEL_LOGGER_SCOPE_NAME);\n\n    logger.emit({\n      eventName: record.event,\n      timestamp: new Date(record.timestamp),\n      severityNumber: SEVERITY_BY_LEVEL[record.level],\n      severityText: record.level.toUpperCase(),\n      // Keep the OTLP body identical to the structured stdout record.\n      body: JSON.stringify(record),\n      attributes: {\n        \"event.name\": record.event,\n        \"log.level\": record.level,\n        \"service.namespace\": record[\"service.namespace\"],\n        \"service.name\": record[\"service.name\"],\n        \"deployment.environment.name\":\n          record[\"deployment.environment.name\"],\n      },\n    });\n  } catch {\n    // OpenTelemetry is best-effort. It must never change business correctness.\n  }\n}\n","export const REDACTED = \"[REDACTED]\";\nexport const CIRCULAR = \"[Circular]\";\nexport const MAX_DEPTH_REACHED = \"[MaxDepth]\";\nexport const TRUNCATED = \"[Truncated]\";\n\nexport const LOG_VALUE_LIMITS = Object.freeze({\n  maxDepth: 6,\n  maxArrayItems: 50,\n  maxObjectKeys: 100,\n  maxStringLength: 4096,\n});\n\nconst SENSITIVE_EXACT_KEYS = new Set([\n  \"authorization\",\n  \"cookie\",\n  \"setcookie\",\n  \"password\",\n  \"passwd\",\n  \"apikey\",\n  \"privatekey\",\n  \"cvv\",\n  \"cvc\",\n  \"cardnumber\",\n  \"creditcard\",\n  \"firstname\",\n  \"lastname\",\n]);\n\nfunction normalizeKey(key: string): string {\n  return key.toLowerCase().replace(/[^a-z0-9]/g, \"\");\n}\n\nexport function isSensitiveLogKey(key: string): boolean {\n  const normalized = normalizeKey(key);\n\n  return (\n    SENSITIVE_EXACT_KEYS.has(normalized) ||\n    normalized.includes(\"secret\") ||\n    normalized.endsWith(\"token\") ||\n    normalized.includes(\"email\") ||\n    normalized.includes(\"phone\") ||\n    normalized.endsWith(\"address\")\n  );\n}\n\nfunction sanitizeString(value: string): string {\n  const scrubbed = value\n    .replace(/\\bBearer\\s+[^\\s,;]+/gi, `Bearer ${REDACTED}`)\n    .replace(\n      /([?&](?:access_token|refresh_token|verify_token|client_secret|api_key|token|password)=)[^&#\\s]*/gi,\n      `$1${REDACTED}`,\n    );\n\n  if (scrubbed.length <= LOG_VALUE_LIMITS.maxStringLength) {\n    return scrubbed;\n  }\n\n  return `${scrubbed.slice(0, LOG_VALUE_LIMITS.maxStringLength)}…${TRUNCATED}`;\n}\n\nfunction sanitizeError(error: Error): Record<string, unknown> {\n  return {\n    name: sanitizeString(error.name),\n    message: sanitizeString(error.message),\n  };\n}\n\nfunction sanitizeValue(\n  value: unknown,\n  depth: number,\n  activeObjects: WeakSet<object>,\n): unknown {\n  if (value === null || value === undefined) {\n    return value ?? null;\n  }\n\n  if (typeof value === \"string\") {\n    return sanitizeString(value);\n  }\n\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : String(value);\n  }\n\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n\n  if (typeof value === \"bigint\") {\n    return value.toString();\n  }\n\n  if (typeof value === \"symbol\" || typeof value === \"function\") {\n    return `[${typeof value}]`;\n  }\n\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? \"Invalid Date\" : value.toISOString();\n  }\n\n  if (value instanceof Error) {\n    return sanitizeError(value);\n  }\n\n  if (depth >= LOG_VALUE_LIMITS.maxDepth) {\n    return MAX_DEPTH_REACHED;\n  }\n\n  if (typeof value !== \"object\") {\n    return String(value);\n  }\n\n  if (activeObjects.has(value)) {\n    return CIRCULAR;\n  }\n\n  activeObjects.add(value);\n\n  try {\n    if (Array.isArray(value)) {\n      const result = value\n        .slice(0, LOG_VALUE_LIMITS.maxArrayItems)\n        .map((item) => sanitizeValue(item, depth + 1, activeObjects));\n\n      if (value.length > LOG_VALUE_LIMITS.maxArrayItems) {\n        result.push(TRUNCATED);\n      }\n\n      return result;\n    }\n\n    const result: Record<string, unknown> = {};\n    const entries = Object.entries(value).slice(0, LOG_VALUE_LIMITS.maxObjectKeys);\n\n    for (const [key, item] of entries) {\n      result[key] = isSensitiveLogKey(key)\n        ? REDACTED\n        : sanitizeValue(item, depth + 1, activeObjects);\n    }\n\n    if (Object.keys(value).length > LOG_VALUE_LIMITS.maxObjectKeys) {\n      result.__truncated__ = true;\n    }\n\n    return result;\n  } finally {\n    activeObjects.delete(value);\n  }\n}\n\nexport function sanitizeLogFields(\n  fields: Readonly<Record<string, unknown>>,\n): Record<string, unknown> {\n  return sanitizeValue(fields, 0, new WeakSet<object>()) as Record<string, unknown>;\n}\n","import { emitLokiLog } from \"./loki.js\";\nimport { emitOpenTelemetryLog } from \"./otel.js\";\nimport { sanitizeLogFields } from \"./redaction.js\";\nimport type {\n  LogFields,\n  LogLevel,\n  LogRecord,\n  LogSink,\n  LoggerOptions,\n  StructuredLogger,\n} from \"./types.js\";\n\nconst DEFAULT_SERVICE_NAMESPACE = \"moda-interact\";\n\nfunction requireNonEmpty(value: string, field: string): string {\n  const normalized = value.trim();\n  if (!normalized) {\n    throw new Error(`${field} must be a non-empty string`);\n  }\n  return normalized;\n}\n\nfunction defaultSink(record: LogRecord): void {\n  const line = JSON.stringify(record);\n\n  switch (record.level) {\n    case \"debug\":\n      console.debug(line);\n      break;\n    case \"warn\":\n      console.warn(line);\n      break;\n    case \"error\":\n      console.error(line);\n      break;\n    case \"info\":\n    default:\n      console.info(line);\n      break;\n  }\n}\n\nfunction safeTimestamp(now: () => Date): string {\n  try {\n    const value = now();\n    if (value instanceof Date && !Number.isNaN(value.getTime())) {\n      return value.toISOString();\n    }\n  } catch {\n    // Logging must not become a correctness dependency.\n  }\n\n  return new Date().toISOString();\n}\n\nexport function createLogger(options: LoggerOptions): StructuredLogger {\n  const serviceName = requireNonEmpty(options.serviceName, \"serviceName\");\n  const environment = requireNonEmpty(options.environment, \"environment\");\n  const serviceNamespace = requireNonEmpty(\n    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,\n    \"serviceNamespace\",\n  );\n  const sink: LogSink = options.sink ?? defaultSink;\n  const now = options.now ?? (() => new Date());\n  const initialBaseFields = { ...(options.baseFields ?? {}) };\n\n  function buildLogger(baseFields: Record<string, unknown>): StructuredLogger {\n    function emit(level: LogLevel, event: string, fields: LogFields = {}): void {\n      let record: LogRecord;\n\n      try {\n        const eventName = event.trim() || \"unknown\";\n        const sanitizedData = sanitizeLogFields({ ...baseFields, ...fields });\n\n        record = Object.freeze({\n          timestamp: safeTimestamp(now),\n          level,\n          event: eventName,\n          \"service.namespace\": serviceNamespace,\n          \"service.name\": serviceName,\n          \"deployment.environment.name\": environment,\n          ...(Object.keys(sanitizedData).length > 0\n            ? { data: sanitizedData }\n            : {}),\n        });\n      } catch {\n        // Sanitization/record construction must never affect business logic.\n        return;\n      }\n\n      // Each destination is deliberately isolated. Failure of one destination\n      // must not suppress another destination and must never escape to business\n      // code.\n      try {\n        sink(record);\n      } catch {\n        // best-effort stdout/custom sink\n      }\n\n      emitOpenTelemetryLog(record);\n      emitLokiLog(record);\n    }\n\n    return Object.freeze({\n      debug: (event: string, fields?: LogFields) => emit(\"debug\", event, fields),\n      info: (event: string, fields?: LogFields) => emit(\"info\", event, fields),\n      warn: (event: string, fields?: LogFields) => emit(\"warn\", event, fields),\n      error: (event: string, fields?: LogFields) => emit(\"error\", event, fields),\n      child: (fields: LogFields) => buildLogger({ ...baseFields, ...fields }),\n    });\n  }\n\n  return buildLogger(initialBaseFields);\n}\n","export const LOG_LEVELS = [\"debug\", \"info\", \"warn\", \"error\"] as const;\n\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\nexport type LogFields = Readonly<Record<string, unknown>>;\n\nexport type LogRecord = Readonly<{\n  timestamp: string;\n  level: LogLevel;\n  event: string;\n  \"service.namespace\": string;\n  \"service.name\": string;\n  \"deployment.environment.name\": string;\n  data?: Readonly<Record<string, unknown>>;\n}>;\n\nexport type LogSink = (record: LogRecord) => void;\n\nexport type LoggerOptions = {\n  serviceName: string;\n  environment: string;\n  serviceNamespace?: string;\n  baseFields?: LogFields;\n  sink?: LogSink;\n  now?: () => Date;\n};\n\nexport interface StructuredLogger {\n  debug(event: string, fields?: LogFields): void;\n  info(event: string, fields?: LogFields): void;\n  warn(event: string, fields?: LogFields): void;\n  error(event: string, fields?: LogFields): void;\n  child(fields: LogFields): StructuredLogger;\n}\n"],"mappings":"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","names":["result"]}