@modainteract/moda-interact-shared 0.1.0 → 0.3.0

package/dist/logging/index.js

@@ -0,0 +1,241 @@
+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]";
+var MAX_DEPTH_REACHED = "[MaxDepth]";
+var TRUNCATED = "[Truncated]";
+var LOG_VALUE_LIMITS = Object.freeze({
+  maxDepth: 6,
+  maxArrayItems: 50,
+  maxObjectKeys: 100,
+  maxStringLength: 4096
+});
+var SENSITIVE_EXACT_KEYS = /* @__PURE__ */ new Set([
+  "authorization",
+  "cookie",
+  "setcookie",
+  "password",
+  "passwd",
+  "apikey",
+  "privatekey",
+  "cvv",
+  "cvc",
+  "cardnumber",
+  "creditcard",
+  "firstname",
+  "lastname"
+]);
+function normalizeKey(key) {
+  return key.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function isSensitiveLogKey(key) {
+  const normalized = normalizeKey(key);
+  return SENSITIVE_EXACT_KEYS.has(normalized) || normalized.includes("secret") || normalized.endsWith("token") || normalized.includes("email") || normalized.includes("phone") || normalized.endsWith("address");
+}
+function sanitizeString(value) {
+  const scrubbed = value.replace(/\bBearer\s+[^\s,;]+/gi, `Bearer ${REDACTED}`).replace(
+    /([?&](?:access_token|refresh_token|verify_token|client_secret|api_key|token|password)=)[^&#\s]*/gi,
+    `$1${REDACTED}`
+  );
+  if (scrubbed.length <= LOG_VALUE_LIMITS.maxStringLength) {
+    return scrubbed;
+  }
+  return `${scrubbed.slice(0, LOG_VALUE_LIMITS.maxStringLength)}\u2026${TRUNCATED}`;
+}
+function sanitizeError(error) {
+  return {
+    name: sanitizeString(error.name),
+    message: sanitizeString(error.message)
+  };
+}
+function sanitizeValue(value, depth, activeObjects) {
+  if (value === null || value === void 0) {
+    return value ?? null;
+  }
+  if (typeof value === "string") {
+    return sanitizeString(value);
+  }
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : String(value);
+  }
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "symbol" || typeof value === "function") {
+    return `[${typeof value}]`;
+  }
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? "Invalid Date" : value.toISOString();
+  }
+  if (value instanceof Error) {
+    return sanitizeError(value);
+  }
+  if (depth >= LOG_VALUE_LIMITS.maxDepth) {
+    return MAX_DEPTH_REACHED;
+  }
+  if (typeof value !== "object") {
+    return String(value);
+  }
+  if (activeObjects.has(value)) {
+    return CIRCULAR;
+  }
+  activeObjects.add(value);
+  try {
+    if (Array.isArray(value)) {
+      const result2 = value.slice(0, LOG_VALUE_LIMITS.maxArrayItems).map((item) => sanitizeValue(item, depth + 1, activeObjects));
+      if (value.length > LOG_VALUE_LIMITS.maxArrayItems) {
+        result2.push(TRUNCATED);
+      }
+      return result2;
+    }
+    const result = {};
+    const entries = Object.entries(value).slice(0, LOG_VALUE_LIMITS.maxObjectKeys);
+    for (const [key, item] of entries) {
+      result[key] = isSensitiveLogKey(key) ? REDACTED : sanitizeValue(item, depth + 1, activeObjects);
+    }
+    if (Object.keys(value).length > LOG_VALUE_LIMITS.maxObjectKeys) {
+      result.__truncated__ = true;
+    }
+    return result;
+  } finally {
+    activeObjects.delete(value);
+  }
+}
+function sanitizeLogFields(fields) {
+  return sanitizeValue(fields, 0, /* @__PURE__ */ new WeakSet());
+}
+
+// src/logging/logger.ts
+var DEFAULT_SERVICE_NAMESPACE = "moda-interact";
+function requireNonEmpty(value, field) {
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new Error(`${field} must be a non-empty string`);
+  }
+  return normalized;
+}
+function defaultSink(record) {
+  const line = JSON.stringify(record);
+  switch (record.level) {
+    case "debug":
+      console.debug(line);
+      break;
+    case "warn":
+      console.warn(line);
+      break;
+    case "error":
+      console.error(line);
+      break;
+    case "info":
+    default:
+      console.info(line);
+      break;
+  }
+}
+function safeTimestamp(now) {
+  try {
+    const value = now();
+    if (value instanceof Date && !Number.isNaN(value.getTime())) {
+      return value.toISOString();
+    }
+  } catch {
+  }
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function createLogger(options) {
+  const serviceName = requireNonEmpty(options.serviceName, "serviceName");
+  const environment = requireNonEmpty(options.environment, "environment");
+  const serviceNamespace = requireNonEmpty(
+    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,
+    "serviceNamespace"
+  );
+  const sink = options.sink ?? defaultSink;
+  const now = options.now ?? (() => /* @__PURE__ */ new Date());
+  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 });
+        record = Object.freeze({
+          timestamp: safeTimestamp(now),
+          level,
+          event: eventName,
+          "service.namespace": serviceNamespace,
+          "service.name": serviceName,
+          "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),
+      info: (event, fields) => emit("info", event, fields),
+      warn: (event, fields) => emit("warn", event, fields),
+      error: (event, fields) => emit("error", event, fields),
+      child: (fields) => buildLogger({ ...baseFields, ...fields })
+    });
+  }
+  return buildLogger(initialBaseFields);
+}
+
+// src/logging/types.ts
+var LOG_LEVELS = ["debug", "info", "warn", "error"];
+export {
+  CIRCULAR,
+  LOG_LEVELS,
+  LOG_VALUE_LIMITS,
+  MAX_DEPTH_REACHED,
+  REDACTED,
+  TRUNCATED,
+  createLogger,
+  isSensitiveLogKey,
+  sanitizeLogFields
+};
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"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 };