@modainteract/moda-interact-shared 0.2.0 → 0.3.0

package/README.md

@@ -43,7 +43,8 @@ This package does **not** own:
 - Shopify or Meta SDK integration;
 - application recovery/business logic;
 - OpenTelemetry spans or application-specific metrics;
-- OTLP transport or observability backends;
+- OpenTelemetry tracing/metrics SDK bootstraps;
+- deployment OTLP endpoint/credential wiring or observability backends;
 - Render deployment configuration.
 
 Those capabilities remain in the repository that owns the corresponding
@@ -302,25 +303,289 @@ traces by default.
 Logging is best-effort: a logger sink or serialization failure must not alter
 the success/failure semantics of the business operation being logged.
 
-## Logging and OpenTelemetry are separate
+## Logging destinations
 
-The shared logger does **not** automatically create:
+Every call to the shared logger:
 
-- spans;
-- counters;
-- histograms;
-- OTLP exports.
+```ts
+logger.debug(...)
+logger.info(...)
+logger.warn(...)
+logger.error(...)
+```
+
+emits the same already-sanitized canonical record to up to three independent,
+best-effort destinations:
+
+1. canonical structured JSON to the configured sink (default: console);
+2. the OpenTelemetry Logs API via the global `LoggerProvider`, if one has been
+   installed;
+3. a direct Grafana Loki transport, if the Node process bootstrap has installed
+   the Loki emitter.
+
+Each destination is failure-isolated: a failure in one must not suppress
+another and must never affect application/business correctness.
+
+The OpenTelemetry API is a no-op when no provider is installed, so stdout
+logging continues to work in local/test environments without any backend.
+
+The heavy Node SDK/exporter and the Winston/winston-loki transport are isolated
+in:
+
+```text
+@modainteract/moda-interact-shared/logging/node
+```
+
+and must be imported and initialized only from the Node process bootstrap —
+never through Vite/application/browser bundles.
+
+```text
+application module
+    |
+    v
+@modainteract/moda-interact-shared/logging
+    |
+    +--> canonical JSON stdout
+    |
+    +--> @opentelemetry/api-logs
+    |        |
+    |        | global LoggerProvider
+    |        v
+    |   ./logging/node
+    |        |
+    |        +--> LoggerProvider
+    |        +--> BatchLogRecordProcessor
+    |        +--> OTLPLogExporter
+    |                 |
+    |                 v
+    |              /v1/logs
+    |
+    +--> lightweight Loki bridge (globalThis emitter)
+             |
+             v
+        ./logging/node
+             |
+             +--> Winston + winston-loki
+                      |
+                      v
+                  Grafana Loki
+```
+
+Winston and winston-loki exist **only** in the Node-only package graph. The
+normal `./logging` entry contains no Winston, winston-loki or Node networking
+imports.
+
+### Node bootstrap
+
+Process bootstrap code installs the optional destinations once:
+
+```ts
+import {
+  initNodeLokiLogging,
+  initNodeOpenTelemetryLogging,
+} from "@modainteract/moda-interact-shared/logging/node";
+
+initNodeLokiLogging({
+  serviceName: "moda-interact",
+  environment: "production",
+});
+
+initNodeOpenTelemetryLogging({
+  serviceName: "moda-interact",
+  environment: "production",
+});
+```
+
+Each destination is independently configurable, so a deployment may use:
+
+```text
+console only
+
+console + Loki
+
+console + OTel Logs
+
+console + Loki + OTel Logs
+```
+
+Either Node destination may be omitted entirely; without an installed
+provider/emitter the logger remains a safe stdout-only logger.
+
+The bootstrap supports the standard OpenTelemetry environment variables:
+
+```text
+OTEL_SDK_DISABLED
+
+OTEL_LOGS_EXPORTER
+
+OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
+OTEL_EXPORTER_OTLP_ENDPOINT
+
+OTEL_EXPORTER_OTLP_LOGS_HEADERS
+OTEL_EXPORTER_OTLP_HEADERS
+
+OTEL_BLRP_MAX_QUEUE_SIZE
+OTEL_BLRP_MAX_EXPORT_BATCH_SIZE
+OTEL_BLRP_SCHEDULE_DELAY
+OTEL_BLRP_EXPORT_TIMEOUT
+
+OTEL_LOG_EXPORT_CONCURRENCY_LIMIT
+```
 
-Service-specific OpenTelemetry remains in the owning runtime repository.
+Endpoint rules:
 
-For example:
+```text
+OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
+    exact signal endpoint; do not append /v1/logs
+
+OTEL_EXPORTER_OTLP_ENDPOINT
+    generic endpoint; append /v1/logs
+```
+
+Moda deliberately does **not** export to the OpenTelemetry default localhost
+endpoint. Without an explicitly configured endpoint the logger remains
+stdout-only.
+
+### Direct Loki transport
+
+The direct Loki transport is a lightweight bridge: the normal `./logging` entry
+stores an emitter on `globalThis` and the Node bootstrap installs it. Records
+still pass through the same shared redaction/sanitization used for stdout and
+OpenTelemetry.
+
+The Loki environment contract is:
+
+```text
+LOKI_ENABLED
+
+LOKI_URL
+
+LOKI_USERNAME
+LOKI_PASSWORD
+
+LOKI_BATCHING
+LOKI_BATCH_INTERVAL_SECONDS
+LOKI_TIMEOUT_MS
+LOKI_CLEAR_ON_ERROR
+```
+
+Rules:
+
+```text
+no LOKI_URL
+    -> direct Loki disabled
+
+LOKI_ENABLED=false
+    -> direct Loki disabled
+
+LOKI_URL present
+    -> direct Loki enabled by default
+```
+
+Credentials are Node-bootstrap configuration only. Never log `LOKI_URL`
+credentials, `LOKI_USERNAME`, `LOKI_PASSWORD`, Basic Auth values or connection
+headers.
+
+Default transport behavior:
+
+```text
+batching=true
+bounded timeout (LOKI_TIMEOUT_MS)
+clearOnError=true
+replaceTimestamp=true
+gracefulShutdown=false
+```
+
+The owning process bootstrap is responsible for explicit flush/shutdown via the
+returned runtime (`forceFlush`/`shutdown`). If Loki is unavailable, log records
+may be dropped but application processing must continue. Connection errors are
+not recursively written back through the shared logger.
+
+### Loki labels and cardinality
+
+The only default Loki labels are the canonical low-cardinality identity:
+
+```text
+service_namespace
+service_name
+environment
+```
+
+Dynamic/high-cardinality identifiers must **not** be promoted to Loki stream
+labels. The implementation explicitly retains
+`useWinstonMetaAsLabels: false`. In particular, do not label by:
+
+```text
+traceId
+spanId
+requestId
+jobId
+deliveryId
+eventId
+recoveryId
+checkoutToken
+cartToken
+shop
+shopDomain
+customerId
+phone
+email
+```
+
+Safe high-cardinality operational identifiers may remain in the sanitized JSON
+log body where justified, but they must never become indexed stream labels.
+
+### Duplicate-delivery warning
+
+Do not route the OpenTelemetry Logs destination back into the same Loki
+instance while direct Loki is also enabled, unless duplicate storage is
+intentional:
+
+```text
+direct Loki ON
++
+OTel Logs ultimately routed to same Loki
+=
+duplicate log storage
+```
+
+The library does not guess backend topology; deployment configuration owns this
+choice.
+
+### Log-signal data safety and correlation
+
+- The OpenTelemetry log body is `JSON.stringify` of the same canonical
+  sanitized `LogRecord` written to stdout, so the same redaction boundary
+  applies to both destinations.
+- Queryable OTel attributes are limited to:
+
+  ```text
+  event.name
+  log.level
+  service.namespace
+  service.name
+  deployment.environment.name
+  ```
+
+- The shared logger never manufactures trace IDs. If an active
+  trace/span context exists, the OpenTelemetry Logs SDK associates the emitted
+  record with that active context automatically.
+- stdout and OpenTelemetry emission are isolated and best-effort: a failure in
+  either must not change application/business correctness.
+
+### Tracing/metrics remain service-specific
+
+The shared logger does **not** create spans, counters or histograms.
+
+Service-specific OpenTelemetry tracing and metrics remain in the owning runtime
+repository, for example:
 
 ```text
 Shopify operation
     |
-    +--> shared structured logger
+    +--> shared structured logger (stdout + OTel Logs)
     |
-    +--> Shopify-specific OpenTelemetry
+    +--> Shopify-specific OpenTelemetry (spans/metrics)
 ```
 
 This separation is intentional. Fields that are useful in diagnostic logs can
@@ -344,6 +609,12 @@ The public package exposes independent entry points.
 
 @modainteract/moda-interact-shared/logging
     reusable structured logging API
+    (stdout + OTel Logs + direct Loki fan-out)
+
+@modainteract/moda-interact-shared/logging/node
+    Node-only logging bootstrap
+    (OpenTelemetry LoggerProvider, batching, OTLP HTTP exporter;
+     Winston + winston-loki direct transport)
 ```
 
 Consumers should prefer the narrowest appropriate subpath.

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"]}

package/dist/logging/node.d.ts

@@ -0,0 +1,103 @@
+type NodeLokiLoggingOptions = {
+    serviceName: string;
+    environment: string;
+    serviceNamespace?: string;
+    /**
+     * Explicit Loki base URL.
+     *
+     * Production normally supplies LOKI_URL.
+     */
+    host?: string;
+    /**
+     * Optional Basic Auth override in `username:password` format.
+     *
+     * Prefer separate LOKI_USERNAME/LOKI_PASSWORD environment variables in
+     * deployed services so the composed value never needs to be committed.
+     */
+    basicAuth?: string;
+    /**
+     * Optional additional static headers.
+     *
+     * Never include these in log payloads or error messages.
+     */
+    headers?: Record<string, string>;
+    batching?: boolean;
+    intervalSeconds?: number;
+    timeoutMs?: number;
+    clearOnError?: boolean;
+    /**
+     * Test-only override. In normal service bootstrap, the presence of a Loki
+     * host is sufficient to enable the transport.
+     */
+    forceEnable?: boolean;
+};
+type NodeLokiLoggingRuntime = {
+    enabled: boolean;
+    host: string | null;
+    labels: Readonly<Record<string, string>>;
+    forceFlush: () => Promise<void>;
+    shutdown: () => Promise<void>;
+};
+/**
+ * Installs the direct Grafana Loki destination exactly once per Node process.
+ *
+ * IMPORTANT:
+ * - This module is Node-only.
+ * - It is reached through @modainteract/moda-interact-shared/logging/node.
+ * - Do not import it from Vite/browser/application module graphs.
+ * - The normal ./logging entry contains no Winston/winston-loki imports.
+ */
+declare function initNodeLokiLogging(options: NodeLokiLoggingOptions): NodeLokiLoggingRuntime;
+declare function getNodeLokiLoggingRuntime(): NodeLokiLoggingRuntime | null;
+
+type NodeOpenTelemetryLoggingOptions = {
+    serviceName: string;
+    environment: string;
+    serviceNamespace?: string;
+    /**
+     * Explicit endpoint override. Intended mainly for tests.
+     *
+     * Production normally uses:
+     *   OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
+     * or:
+     *   OTEL_EXPORTER_OTLP_ENDPOINT
+     */
+    endpoint?: string;
+    /** Optional explicit OTLP headers override. */
+    headers?: Record<string, string>;
+    /** Test-only switch. Production should rely on environment configuration. */
+    forceEnable?: boolean;
+};
+type NodeOpenTelemetryLoggingRuntime = {
+    enabled: boolean;
+    endpoint: string | null;
+    forceFlush: () => Promise<void>;
+    shutdown: () => Promise<void>;
+};
+/**
+ * Installs the Node OpenTelemetry LoggerProvider exactly once for this process.
+ *
+ * IMPORTANT:
+ * This module is Node-only. Import and initialize it from the process bootstrap
+ * before framework/application modules are loaded. Do not import this module
+ * through Vite/React/browser bundles.
+ *
+ * Application modules should import only:
+ *
+ *   @modainteract/moda-interact-shared/logging
+ *
+ * Once this provider is installed, createLogger(...) automatically fans safe
+ * canonical log records out to stdout and the OpenTelemetry Logs API.
+ *
+ * Direct Loki delivery, when desired, is independently enabled with:
+ *
+ *   initNodeLokiLogging(...)
+ *
+ * from this same Node-only package entry.
+ */
+declare function initNodeOpenTelemetryLogging(options: NodeOpenTelemetryLoggingOptions): NodeOpenTelemetryLoggingRuntime;
+declare function getNodeOpenTelemetryLoggingRuntime(): NodeOpenTelemetryLoggingRuntime | null;
+declare function resolveLogsEndpoint(explicitEndpoint?: string): string | undefined;
+declare function parseOtlpHeaders(value: string | undefined): Record<string, string> | undefined;
+
+export { type NodeLokiLoggingOptions, type NodeLokiLoggingRuntime, type NodeOpenTelemetryLoggingOptions, type NodeOpenTelemetryLoggingRuntime, getNodeLokiLoggingRuntime, getNodeOpenTelemetryLoggingRuntime, initNodeLokiLogging, initNodeOpenTelemetryLogging, parseOtlpHeaders, resolveLogsEndpoint };

package/dist/logging/node.js

@@ -0,0 +1,373 @@
+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 {
+  getNodeLokiLoggingRuntime,
+  getNodeOpenTelemetryLoggingRuntime,
+  initNodeLokiLogging,
+  initNodeOpenTelemetryLogging,
+  parseOtlpHeaders,
+  resolveLogsEndpoint
+};
+//# sourceMappingURL=node.js.map

package/dist/logging/node.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -23,6 +23,10 @@
     "./logging": {
       "types": "./dist/logging/index.d.ts",
       "import": "./dist/logging/index.js"
+    },
+    "./logging/node": {
+      "types": "./dist/logging/node.d.ts",
+      "import": "./dist/logging/node.js"
     }
   },
   "files": [
@@ -31,10 +35,17 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "test": "tsx --test src/**/*.test.ts",
+    "test": "tsx --test \"src/**/*.test.ts\"",
     "prepack": "npm run build"
   },
   "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": "0.221.0",
+    "@opentelemetry/exporter-logs-otlp-http": "0.221.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-logs": "0.221.0",
+    "winston": "3.19.0",
+    "winston-loki": "6.1.7",
     "zod": "^4.0.0"
   },
   "devDependencies": {