@modainteract/moda-interact-shared 0.3.0 → 0.5.0

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-A3EK6N46.js

@@ -0,0 +1,73 @@
+// src/observability/index.ts
+import {
+  context,
+  SpanStatusCode,
+  trace
+} from "@opentelemetry/api";
+var TRACER_NAME = "@modainteract/moda-interact-shared/observability";
+var MAX_MAPPED_EXCEPTION_FIELD_LENGTH = 1024;
+function getActiveTraceId() {
+  return trace.getSpan(context.active())?.spanContext().traceId;
+}
+async function withObservedSpan(name, attributes, work, options = {}) {
+  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) {
+      if (options.mapException) {
+        try {
+          const mappedException = normalizeMappedException(
+            options.mapException(error)
+          );
+          if (mappedException !== void 0) {
+            span.recordException(mappedException);
+          }
+        } catch {
+        }
+      } else {
+        span.recordException(
+          error instanceof Error ? error : new Error(String(error))
+        );
+      }
+      span.setStatus({ code: SpanStatusCode.ERROR });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+function normalizeMappedException(exception) {
+  if (typeof exception === "string") {
+    return boundedExceptionField(exception);
+  }
+  if (!exception || typeof exception !== "object") {
+    return void 0;
+  }
+  const code = typeof exception.code === "number" ? exception.code : boundedExceptionField(exception.code);
+  const message = boundedExceptionField(exception.message);
+  const name = boundedExceptionField(exception.name);
+  const stack = boundedExceptionField(exception.stack);
+  if (code === void 0 && message === void 0 && name === void 0) {
+    return void 0;
+  }
+  return {
+    ...code !== void 0 ? { code } : {},
+    ...message !== void 0 ? { message } : {},
+    ...name !== void 0 ? { name } : {},
+    ...stack !== void 0 ? { stack } : {}
+  };
+}
+function boundedExceptionField(value) {
+  if (typeof value !== "string") return void 0;
+  const bounded = value.trim().slice(0, MAX_MAPPED_EXCEPTION_FIELD_LENGTH);
+  return bounded || void 0;
+}
+
+export {
+  getActiveTraceId,
+  withObservedSpan
+};
+//# sourceMappingURL=chunk-A3EK6N46.js.map

package/dist/chunk-A3EK6N46.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability/index.ts"],"sourcesContent":["import {\n  context,\n  SpanStatusCode,\n  trace,\n  type Attributes,\n  type Exception,\n} from \"@opentelemetry/api\";\n\nconst TRACER_NAME = \"@modainteract/moda-interact-shared/observability\";\nconst MAX_MAPPED_EXCEPTION_FIELD_LENGTH = 1_024;\n\nexport type SpanExceptionMapper = (error: unknown) => Exception | undefined;\n\nexport type ObservedSpanOptions = {\n  mapException?: SpanExceptionMapper;\n};\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  options: ObservedSpanOptions = {},\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      if (options.mapException) {\n        try {\n          const mappedException = normalizeMappedException(\n            options.mapException(error),\n          );\n          if (mappedException !== undefined) {\n            span.recordException(mappedException);\n          }\n        } catch {\n          // Never fall back to the original value after a mapper is supplied.\n        }\n      } else {\n        span.recordException(\n          error instanceof Error ? error : new Error(String(error)),\n        );\n      }\n      span.setStatus({ code: SpanStatusCode.ERROR });\n      throw error;\n    } finally {\n      span.end();\n    }\n  });\n}\n\nfunction normalizeMappedException(\n  exception: Exception | undefined,\n): Exception | undefined {\n  if (typeof exception === \"string\") {\n    return boundedExceptionField(exception);\n  }\n  if (!exception || typeof exception !== \"object\") {\n    return undefined;\n  }\n\n  const code = typeof exception.code === \"number\"\n    ? exception.code\n    : boundedExceptionField(exception.code);\n  const message = boundedExceptionField(exception.message);\n  const name = boundedExceptionField(exception.name);\n  const stack = boundedExceptionField(exception.stack);\n\n  if (code === undefined && message === undefined && name === undefined) {\n    return undefined;\n  }\n\n  return {\n    ...(code !== undefined ? { code } : {}),\n    ...(message !== undefined ? { message } : {}),\n    ...(name !== undefined ? { name } : {}),\n    ...(stack !== undefined ? { stack } : {}),\n  } as Exception;\n}\n\nfunction boundedExceptionField(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const bounded = value.trim().slice(0, MAX_MAPPED_EXCEPTION_FIELD_LENGTH);\n  return bounded || undefined;\n}"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,IAAM,cAAc;AACpB,IAAM,oCAAoC;AAQnC,SAAS,mBAAuC;AACrD,SAAO,MAAM,QAAQ,QAAQ,OAAO,CAAC,GAAG,YAAY,EAAE;AACxD;AAEA,eAAsB,iBACpB,MACA,YACA,MACA,UAA+B,CAAC,GACpB;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,UAAI,QAAQ,cAAc;AACxB,YAAI;AACF,gBAAM,kBAAkB;AAAA,YACtB,QAAQ,aAAa,KAAK;AAAA,UAC5B;AACA,cAAI,oBAAoB,QAAW;AACjC,iBAAK,gBAAgB,eAAe;AAAA,UACtC;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF,OAAO;AACL,aAAK;AAAA,UACH,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAC1D;AAAA,MACF;AACA,WAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;AAC7C,YAAM;AAAA,IACR,UAAE;AACA,WAAK,IAAI;AAAA,IACX;AAAA,EACF,CAAC;AACH;AAEA,SAAS,yBACP,WACuB;AACvB,MAAI,OAAO,cAAc,UAAU;AACjC,WAAO,sBAAsB,SAAS;AAAA,EACxC;AACA,MAAI,CAAC,aAAa,OAAO,cAAc,UAAU;AAC/C,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,OAAO,UAAU,SAAS,WACnC,UAAU,OACV,sBAAsB,UAAU,IAAI;AACxC,QAAM,UAAU,sBAAsB,UAAU,OAAO;AACvD,QAAM,OAAO,sBAAsB,UAAU,IAAI;AACjD,QAAM,QAAQ,sBAAsB,UAAU,KAAK;AAEnD,MAAI,SAAS,UAAa,YAAY,UAAa,SAAS,QAAW;AACrE,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC;AAAA,IACrC,GAAI,YAAY,SAAY,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC3C,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC;AAAA,IACrC,GAAI,UAAU,SAAY,EAAE,MAAM,IAAI,CAAC;AAAA,EACzC;AACF;AAEA,SAAS,sBAAsB,OAAoC;AACjE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK,EAAE,MAAM,GAAG,iCAAiC;AACvE,SAAO,WAAW;AACpB;","names":[]}

package/dist/logging/node.js

@@ -1,367 +1,12 @@
 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;
-  }
-}
+  getNodeLokiLoggingRuntime,
+  getNodeOpenTelemetryLoggingRuntime,
+  initNodeLokiLogging,
+  initNodeOpenTelemetryLogging,
+  parseOtlpHeaders,
+  resolveLogsEndpoint
+} from "../chunk-5JNEZEKV.js";
+import "../chunk-XU4XX7SD.js";
 export {
   getNodeLokiLoggingRuntime,
   getNodeOpenTelemetryLoggingRuntime,

package/dist/logging/node.js.map

@@ -1 +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"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/observability/bullmq.d.ts

@@ -0,0 +1,10 @@
+import { BullMQOtel } from 'bullmq-otel';
+
+type BullMQTelemetryOptions = {
+    serviceName: string;
+    version?: string;
+    enableMetrics?: boolean;
+};
+declare function createBullMQTelemetry(options: BullMQTelemetryOptions): BullMQOtel;
+
+export { type BullMQTelemetryOptions, createBullMQTelemetry };

package/dist/observability/bullmq.js

@@ -0,0 +1,14 @@
+// src/observability/bullmq.ts
+import { BullMQOtel } from "bullmq-otel";
+function createBullMQTelemetry(options) {
+  return new BullMQOtel({
+    tracerName: options.serviceName,
+    meterName: options.serviceName,
+    version: options.version ?? "unknown",
+    enableMetrics: options.enableMetrics ?? true
+  });
+}
+export {
+  createBullMQTelemetry
+};
+//# sourceMappingURL=bullmq.js.map

package/dist/observability/bullmq.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/observability/bullmq.ts"],"sourcesContent":["import { BullMQOtel } from \"bullmq-otel\";\n\nexport type BullMQTelemetryOptions = {\n  serviceName: string;\n  version?: string;\n  enableMetrics?: boolean;\n};\n\nexport function createBullMQTelemetry(\n  options: BullMQTelemetryOptions,\n): BullMQOtel {\n  return new BullMQOtel({\n    tracerName: options.serviceName,\n    meterName: options.serviceName,\n    version: options.version ?? \"unknown\",\n    enableMetrics: options.enableMetrics ?? true,\n  });\n}"],"mappings":";AAAA,SAAS,kBAAkB;AAQpB,SAAS,sBACd,SACY;AACZ,SAAO,IAAI,WAAW;AAAA,IACpB,YAAY,QAAQ;AAAA,IACpB,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ,WAAW;AAAA,IAC5B,eAAe,QAAQ,iBAAiB;AAAA,EAC1C,CAAC;AACH;","names":[]}

package/dist/observability/genai.d.ts

@@ -0,0 +1,17 @@
+import { ObservedSpanOptions } from './index.js';
+export { SpanExceptionMapper } from './index.js';
+import '@opentelemetry/api';
+
+type AgentObservation = {
+    agentName: string;
+    provider?: string;
+    model?: string;
+};
+type GenAIObservationOptions = ObservedSpanOptions & {
+    recordMetrics?: boolean;
+};
+declare function observeConversationTurn<T>(channel: "whatsapp" | "other", work: () => Promise<T>, options?: GenAIObservationOptions): Promise<T>;
+declare function observeAgentInvocation<T>(observation: AgentObservation, work: () => Promise<T>, options?: GenAIObservationOptions): Promise<T>;
+declare function observeAgentTool<T>(toolName: string, work: () => Promise<T>, options?: GenAIObservationOptions): Promise<T>;
+
+export { type AgentObservation, type GenAIObservationOptions, ObservedSpanOptions, observeAgentInvocation, observeAgentTool, observeConversationTurn };