@modainteract/moda-interact-shared 0.3.0 → 0.5.0

package/dist/observability/genai.js

@@ -0,0 +1,121 @@
+import {
+  withObservedSpan
+} from "../chunk-A3EK6N46.js";
+
+// src/observability/genai.ts
+import { metrics } from "@opentelemetry/api";
+var MAX_ATTRIBUTE_LENGTH = 80;
+var meter = metrics.getMeter(
+  "@modainteract/moda-interact-shared/observability/genai"
+);
+var agentDuration = meter.createHistogram(
+  "moda.agent.invocation.duration_ms",
+  { unit: "ms" }
+);
+var agentOperations = meter.createCounter("moda.agent.invocation.operations");
+var toolDuration = meter.createHistogram("moda.agent.tool.duration_ms", {
+  unit: "ms"
+});
+var toolOperations = meter.createCounter("moda.agent.tool.operations");
+var turnDuration = meter.createHistogram(
+  "moda.conversation.turn.duration_ms",
+  { unit: "ms" }
+);
+var turnOperations = meter.createCounter("moda.conversation.turn.operations");
+async function observeConversationTurn(channel, work, options = {}) {
+  const observeSpan = () => withObservedSpan(
+    `conversation.turn ${channel}`,
+    { "moda.messaging.channel": channel },
+    work,
+    options
+  );
+  return observeGenAIOperation(
+    turnDuration,
+    turnOperations,
+    { channel },
+    observeSpan,
+    options
+  );
+}
+async function observeAgentInvocation(observation, work, options = {}) {
+  const agentName = boundedSpanValue(observation.agentName) ?? "unknown";
+  const observeSpan = () => withObservedSpan(
+    `invoke_agent ${agentName}`,
+    compact({
+      "gen_ai.operation.name": "invoke_agent",
+      "gen_ai.agent.name": agentName,
+      "gen_ai.provider.name": boundedSpanValue(observation.provider),
+      "gen_ai.request.model": boundedSpanValue(observation.model)
+    }),
+    work,
+    options
+  );
+  return observeGenAIOperation(
+    agentDuration,
+    agentOperations,
+    {},
+    observeSpan,
+    options
+  );
+}
+async function observeAgentTool(toolName, work, options = {}) {
+  const safeToolName = boundedSpanValue(toolName) ?? "unknown";
+  const observeSpan = () => withObservedSpan(
+    `execute_tool ${safeToolName}`,
+    {
+      "gen_ai.operation.name": "execute_tool",
+      "gen_ai.tool.name": safeToolName
+    },
+    work,
+    options
+  );
+  return observeGenAIOperation(
+    toolDuration,
+    toolOperations,
+    {},
+    observeSpan,
+    options
+  );
+}
+function observeGenAIOperation(duration, operations, attributes, work, options) {
+  return options.recordMetrics === false ? work() : observeOperation(duration, operations, attributes, work);
+}
+async function observeOperation(duration, operations, attributes, work) {
+  const started = performance.now();
+  let outcome = "error";
+  try {
+    const result = await work();
+    outcome = "success";
+    return result;
+  } finally {
+    recordMetrics(duration, operations, performance.now() - started, {
+      ...attributes,
+      outcome
+    });
+  }
+}
+function recordMetrics(duration, operations, elapsedMilliseconds, attributes) {
+  try {
+    duration.record(elapsedMilliseconds, attributes);
+    operations.add(1, attributes);
+  } catch {
+  }
+}
+function boundedSpanValue(value) {
+  if (value === void 0) return void 0;
+  const bounded = value.trim().slice(0, MAX_ATTRIBUTE_LENGTH);
+  return bounded || void 0;
+}
+function compact(attributes) {
+  return Object.fromEntries(
+    Object.entries(attributes).filter(
+      (entry) => entry[1] !== void 0
+    )
+  );
+}
+export {
+  observeAgentInvocation,
+  observeAgentTool,
+  observeConversationTurn
+};
+//# sourceMappingURL=genai.js.map

package/dist/observability/genai.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/observability/genai.ts"],"sourcesContent":["import { metrics, type Attributes, type Counter, type Histogram } from \"@opentelemetry/api\";\nimport {\n  withObservedSpan,\n  type ObservedSpanOptions,\n} from \"./index.js\";\n\nexport type {\n  ObservedSpanOptions,\n  SpanExceptionMapper,\n} from \"./index.js\";\n\nconst MAX_ATTRIBUTE_LENGTH = 80;\nconst meter = metrics.getMeter(\n  \"@modainteract/moda-interact-shared/observability/genai\",\n);\nconst agentDuration = meter.createHistogram(\n  \"moda.agent.invocation.duration_ms\",\n  { unit: \"ms\" },\n);\nconst agentOperations = meter.createCounter(\"moda.agent.invocation.operations\");\nconst toolDuration = meter.createHistogram(\"moda.agent.tool.duration_ms\", {\n  unit: \"ms\",\n});\nconst toolOperations = meter.createCounter(\"moda.agent.tool.operations\");\nconst turnDuration = meter.createHistogram(\n  \"moda.conversation.turn.duration_ms\",\n  { unit: \"ms\" },\n);\nconst turnOperations = meter.createCounter(\"moda.conversation.turn.operations\");\n\ntype Outcome = \"success\" | \"error\";\n\nexport type AgentObservation = {\n  agentName: string;\n  provider?: string;\n  model?: string;\n};\n\nexport type GenAIObservationOptions = ObservedSpanOptions & {\n  recordMetrics?: boolean;\n};\n\nexport async function observeConversationTurn<T>(\n  channel: \"whatsapp\" | \"other\",\n  work: () => Promise<T>,\n  options: GenAIObservationOptions = {},\n): Promise<T> {\n  const observeSpan = () => withObservedSpan(\n    `conversation.turn ${channel}`,\n    { \"moda.messaging.channel\": channel },\n    work,\n    options,\n  );\n\n  return observeGenAIOperation(\n    turnDuration,\n    turnOperations,\n    { channel },\n    observeSpan,\n    options,\n  );\n}\n\nexport async function observeAgentInvocation<T>(\n  observation: AgentObservation,\n  work: () => Promise<T>,\n  options: GenAIObservationOptions = {},\n): Promise<T> {\n  const agentName = boundedSpanValue(observation.agentName) ?? \"unknown\";\n\n  const observeSpan = () => withObservedSpan(\n    `invoke_agent ${agentName}`,\n    compact({\n      \"gen_ai.operation.name\": \"invoke_agent\",\n      \"gen_ai.agent.name\": agentName,\n      \"gen_ai.provider.name\": boundedSpanValue(observation.provider),\n      \"gen_ai.request.model\": boundedSpanValue(observation.model),\n    }),\n    work,\n    options,\n  );\n\n  return observeGenAIOperation(\n    agentDuration,\n    agentOperations,\n    {},\n    observeSpan,\n    options,\n  );\n}\n\nexport async function observeAgentTool<T>(\n  toolName: string,\n  work: () => Promise<T>,\n  options: GenAIObservationOptions = {},\n): Promise<T> {\n  const safeToolName = boundedSpanValue(toolName) ?? \"unknown\";\n\n  const observeSpan = () => withObservedSpan(\n    `execute_tool ${safeToolName}`,\n    {\n      \"gen_ai.operation.name\": \"execute_tool\",\n      \"gen_ai.tool.name\": safeToolName,\n    },\n    work,\n    options,\n  );\n\n  return observeGenAIOperation(\n    toolDuration,\n    toolOperations,\n    {},\n    observeSpan,\n    options,\n  );\n}\n\nfunction observeGenAIOperation<T>(\n  duration: Histogram,\n  operations: Counter,\n  attributes: Attributes,\n  work: () => Promise<T>,\n  options: GenAIObservationOptions,\n): Promise<T> {\n  return options.recordMetrics === false\n    ? work()\n    : observeOperation(duration, operations, attributes, work);\n}\n\nasync function observeOperation<T>(\n  duration: Histogram,\n  operations: Counter,\n  attributes: Attributes,\n  work: () => Promise<T>,\n): Promise<T> {\n  const started = performance.now();\n  let outcome: Outcome = \"error\";\n\n  try {\n    const result = await work();\n    outcome = \"success\";\n    return result;\n  } finally {\n    recordMetrics(duration, operations, performance.now() - started, {\n      ...attributes,\n      outcome,\n    });\n  }\n}\n\nfunction recordMetrics(\n  duration: Histogram,\n  operations: Counter,\n  elapsedMilliseconds: number,\n  attributes: Attributes,\n): void {\n  try {\n    duration.record(elapsedMilliseconds, attributes);\n    operations.add(1, attributes);\n  } catch {\n    // Telemetry must not replace an application result or error.\n  }\n}\n\nfunction boundedSpanValue(value: string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  const bounded = value.trim().slice(0, MAX_ATTRIBUTE_LENGTH);\n  return bounded || undefined;\n}\n\nfunction compact(\n  attributes: Record<string, string | undefined>,\n): Record<string, string> {\n  return Object.fromEntries(\n    Object.entries(attributes).filter((entry): entry is [string, string] =>\n      entry[1] !== undefined\n    ),\n  );\n}"],"mappings":";;;;;AAAA,SAAS,eAA8D;AAWvE,IAAM,uBAAuB;AAC7B,IAAM,QAAQ,QAAQ;AAAA,EACpB;AACF;AACA,IAAM,gBAAgB,MAAM;AAAA,EAC1B;AAAA,EACA,EAAE,MAAM,KAAK;AACf;AACA,IAAM,kBAAkB,MAAM,cAAc,kCAAkC;AAC9E,IAAM,eAAe,MAAM,gBAAgB,+BAA+B;AAAA,EACxE,MAAM;AACR,CAAC;AACD,IAAM,iBAAiB,MAAM,cAAc,4BAA4B;AACvE,IAAM,eAAe,MAAM;AAAA,EACzB;AAAA,EACA,EAAE,MAAM,KAAK;AACf;AACA,IAAM,iBAAiB,MAAM,cAAc,mCAAmC;AAc9E,eAAsB,wBACpB,SACA,MACA,UAAmC,CAAC,GACxB;AACZ,QAAM,cAAc,MAAM;AAAA,IACxB,qBAAqB,OAAO;AAAA,IAC5B,EAAE,0BAA0B,QAAQ;AAAA,IACpC;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,EAAE,QAAQ;AAAA,IACV;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAsB,uBACpB,aACA,MACA,UAAmC,CAAC,GACxB;AACZ,QAAM,YAAY,iBAAiB,YAAY,SAAS,KAAK;AAE7D,QAAM,cAAc,MAAM;AAAA,IACxB,gBAAgB,SAAS;AAAA,IACzB,QAAQ;AAAA,MACN,yBAAyB;AAAA,MACzB,qBAAqB;AAAA,MACrB,wBAAwB,iBAAiB,YAAY,QAAQ;AAAA,MAC7D,wBAAwB,iBAAiB,YAAY,KAAK;AAAA,IAC5D,CAAC;AAAA,IACD;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC;AAAA,IACD;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAsB,iBACpB,UACA,MACA,UAAmC,CAAC,GACxB;AACZ,QAAM,eAAe,iBAAiB,QAAQ,KAAK;AAEnD,QAAM,cAAc,MAAM;AAAA,IACxB,gBAAgB,YAAY;AAAA,IAC5B;AAAA,MACE,yBAAyB;AAAA,MACzB,oBAAoB;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC;AAAA,IACD;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,sBACP,UACA,YACA,YACA,MACA,SACY;AACZ,SAAO,QAAQ,kBAAkB,QAC7B,KAAK,IACL,iBAAiB,UAAU,YAAY,YAAY,IAAI;AAC7D;AAEA,eAAe,iBACb,UACA,YACA,YACA,MACY;AACZ,QAAM,UAAU,YAAY,IAAI;AAChC,MAAI,UAAmB;AAEvB,MAAI;AACF,UAAM,SAAS,MAAM,KAAK;AAC1B,cAAU;AACV,WAAO;AAAA,EACT,UAAE;AACA,kBAAc,UAAU,YAAY,YAAY,IAAI,IAAI,SAAS;AAAA,MAC/D,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEA,SAAS,cACP,UACA,YACA,qBACA,YACM;AACN,MAAI;AACF,aAAS,OAAO,qBAAqB,UAAU;AAC/C,eAAW,IAAI,GAAG,UAAU;AAAA,EAC9B,QAAQ;AAAA,EAER;AACF;AAEA,SAAS,iBAAiB,OAA+C;AACvE,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,UAAU,MAAM,KAAK,EAAE,MAAM,GAAG,oBAAoB;AAC1D,SAAO,WAAW;AACpB;AAEA,SAAS,QACP,YACwB;AACxB,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,UAAU,EAAE;AAAA,MAAO,CAAC,UACjC,MAAM,CAAC,MAAM;AAAA,IACf;AAAA,EACF;AACF;","names":[]}

package/dist/observability/index.d.ts

@@ -0,0 +1,10 @@
+import { Exception, Attributes } from '@opentelemetry/api';
+
+type SpanExceptionMapper = (error: unknown) => Exception | undefined;
+type ObservedSpanOptions = {
+    mapException?: SpanExceptionMapper;
+};
+declare function getActiveTraceId(): string | undefined;
+declare function withObservedSpan<T>(name: string, attributes: Attributes, work: () => Promise<T>, options?: ObservedSpanOptions): Promise<T>;
+
+export { type ObservedSpanOptions, type SpanExceptionMapper, getActiveTraceId, withObservedSpan };

package/dist/observability/index.js

@@ -0,0 +1,9 @@
+import {
+  getActiveTraceId,
+  withObservedSpan
+} from "../chunk-A3EK6N46.js";
+export {
+  getActiveTraceId,
+  withObservedSpan
+};
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/observability/node.d.ts

@@ -0,0 +1,29 @@
+import { Sampler } from '@opentelemetry/sdk-trace-base';
+
+type NodeInstrumentProfile = {
+    http?: boolean;
+    fetch?: boolean;
+    prisma?: boolean;
+};
+type NodeObservabilityOptions = {
+    serviceName: string;
+    environment?: string;
+    serviceNamespace?: string;
+    instrument?: NodeInstrumentProfile;
+    traceSampleRatio?: number;
+    forceEnable?: boolean;
+};
+type NodeObservabilityRuntime = {
+    enabled: boolean;
+    serviceName: string;
+    environment: string;
+    error?: string;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+};
+declare function resolveDeploymentEnvironmentName(): string;
+declare function initNodeObservability(options: NodeObservabilityOptions): NodeObservabilityRuntime;
+declare function getNodeObservabilityRuntime(): NodeObservabilityRuntime | undefined;
+declare function resolveSampler(explicitRatio: number | undefined, environment: string): Sampler;
+
+export { type NodeInstrumentProfile, type NodeObservabilityOptions, type NodeObservabilityRuntime, getNodeObservabilityRuntime, initNodeObservability, resolveDeploymentEnvironmentName, resolveSampler };

package/dist/observability/node.js

@@ -0,0 +1,352 @@
+import {
+  initNodeLokiLogging,
+  initNodeOpenTelemetryLogging
+} from "../chunk-5JNEZEKV.js";
+import "../chunk-XU4XX7SD.js";
+
+// src/observability/node.ts
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { PrismaInstrumentation } from "@prisma/instrumentation";
+import { HttpInstrumentation } from "@opentelemetry/instrumentation-http";
+import { UndiciInstrumentation } from "@opentelemetry/instrumentation-undici";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import {
+  AlwaysOffSampler,
+  AlwaysOnSampler,
+  BatchSpanProcessor,
+  ParentBasedSampler,
+  TraceIdRatioBasedSampler
+} from "@opentelemetry/sdk-trace-base";
+var DEFAULT_NAMESPACE = "moda-interact";
+var configurationWarnings = /* @__PURE__ */ new Set();
+var runtime;
+function resolveDeploymentEnvironmentName() {
+  return nonEmpty(process.env.DEPLOYMENT_ENVIRONMENT_NAME) ?? nonEmpty(process.env.OTEL_DEPLOYMENT_ENVIRONMENT) ?? nonEmpty(process.env.NODE_ENV) ?? "development";
+}
+function initNodeObservability(options) {
+  if (runtime) {
+    return runtime;
+  }
+  const serviceName = nonEmpty(options?.serviceName) ?? "unknown-service";
+  const environment = nonEmpty(options?.environment) ?? resolveDeploymentEnvironmentName();
+  const serviceNamespace = nonEmpty(options?.serviceNamespace) ?? DEFAULT_NAMESPACE;
+  if (!nonEmpty(options?.serviceName)) {
+    warnConfigurationOnce(
+      "service-name",
+      "observability disabled: serviceName must be non-empty"
+    );
+    runtime = disabledRuntime(serviceName, environment);
+    return runtime;
+  }
+  const otelLogs = safeInitLogging(() => initNodeOpenTelemetryLogging({
+    serviceName,
+    environment,
+    serviceNamespace
+  }), "OpenTelemetry Logs");
+  const loki = safeInitLogging(() => initNodeLokiLogging({
+    serviceName,
+    environment,
+    serviceNamespace
+  }), "Loki");
+  if (!options.forceEnable && envBool("OTEL_SDK_DISABLED") === true) {
+    runtime = disabledRuntime(serviceName, environment, otelLogs, loki);
+    return runtime;
+  }
+  const traceEndpoint = signalEndpoint("TRACES", "traces");
+  const metricEndpoint = signalEndpoint("METRICS", "metrics");
+  if (!options.forceEnable && !traceEndpoint && !metricEndpoint) {
+    runtime = disabledRuntime(serviceName, environment, otelLogs, loki);
+    return runtime;
+  }
+  try {
+    const resource = resourceFromAttributes({
+      "service.namespace": serviceNamespace,
+      "service.name": serviceName,
+      "deployment.environment.name": environment
+    });
+    const profile = options.instrument ?? {};
+    const instrumentations = [
+      ...profile.http ? [new HttpInstrumentation({
+        requestHook: (span, request) => {
+          const path = "path" in request ? request.path : request.url;
+          setSanitizedUrlAttributes(span, path);
+          if ("protocol" in request && "host" in request && typeof request.protocol === "string" && typeof request.host === "string") {
+            span.setAttribute(
+              "url.full",
+              `${request.protocol}//${request.host}${sanitizedPath(path ?? "/")}`
+            );
+          }
+        }
+      })] : [],
+      ...profile.fetch ? [new UndiciInstrumentation({
+        requestHook: (span, request) => {
+          const path = sanitizedPath(request.path);
+          span.setAttribute("url.path", path);
+          span.setAttribute("url.full", `${request.origin}${path}`);
+          span.setAttribute("url.query", "");
+        }
+      })] : [],
+      ...profile.prisma ? [new PrismaInstrumentation()] : []
+    ];
+    const traceProcessor = createTraceProcessor(traceEndpoint);
+    const metricReader = createMetricReader(metricEndpoint);
+    if (!traceProcessor && !metricReader) {
+      runtime = {
+        ...disabledRuntime(serviceName, environment, otelLogs, loki),
+        error: "observability-exporters-unavailable"
+      };
+      return runtime;
+    }
+    const sdk = new NodeSDK({
+      resource,
+      autoDetectResources: false,
+      sampler: resolveSampler(options.traceSampleRatio, environment),
+      spanProcessors: traceProcessor ? [traceProcessor] : [],
+      ...metricReader ? { metricReader } : {},
+      instrumentations
+    });
+    sdk.start();
+    let shutdownPromise;
+    runtime = {
+      enabled: true,
+      serviceName,
+      environment,
+      forceFlush: async () => {
+        await Promise.allSettled([
+          traceProcessor?.forceFlush(),
+          metricReader?.forceFlush(),
+          otelLogs?.forceFlush(),
+          loki?.forceFlush()
+        ]);
+      },
+      shutdown: () => {
+        shutdownPromise ??= settleAll([
+          Promise.resolve(sdk.shutdown()),
+          otelLogs?.shutdown(),
+          loki?.shutdown()
+        ]);
+        return shutdownPromise;
+      }
+    };
+    return runtime;
+  } catch (error) {
+    warnConfigurationOnce(
+      "runtime-init",
+      "observability disabled: Node runtime initialization failed"
+    );
+    runtime = {
+      ...disabledRuntime(serviceName, environment, otelLogs, loki),
+      error: boundedError(error)
+    };
+    return runtime;
+  }
+}
+function getNodeObservabilityRuntime() {
+  return runtime;
+}
+function resolveSampler(explicitRatio, environment) {
+  const fallbackRatio = environment === "test" ? 1 : 0.1;
+  if (explicitRatio !== void 0) {
+    if (!Number.isFinite(explicitRatio) || explicitRatio < 0 || explicitRatio > 1) {
+      warnConfigurationOnce(
+        "explicit-sampler-ratio",
+        "invalid traceSampleRatio; using the Moda environment fallback"
+      );
+      return parentBasedRatio(fallbackRatio);
+    }
+    return parentBasedRatio(explicitRatio);
+  }
+  const requested = nonEmpty(process.env.OTEL_TRACES_SAMPLER)?.toLowerCase();
+  if (!requested) {
+    return parentBasedRatio(fallbackRatio);
+  }
+  switch (requested) {
+    case "always_on":
+      return new AlwaysOnSampler();
+    case "always_off":
+      return new AlwaysOffSampler();
+    case "traceidratio":
+      return new TraceIdRatioBasedSampler(samplerRatioArg(fallbackRatio));
+    case "parentbased_always_on":
+      return new ParentBasedSampler({ root: new AlwaysOnSampler() });
+    case "parentbased_always_off":
+      return new ParentBasedSampler({ root: new AlwaysOffSampler() });
+    case "parentbased_traceidratio":
+      return parentBasedRatio(samplerRatioArg(fallbackRatio));
+    default:
+      warnConfigurationOnce(
+        "unsupported-sampler",
+        "unsupported OTEL_TRACES_SAMPLER; using the Moda environment fallback"
+      );
+      return parentBasedRatio(fallbackRatio);
+  }
+}
+function createTraceProcessor(endpoint) {
+  if (!endpoint) {
+    return void 0;
+  }
+  try {
+    return new BatchSpanProcessor(
+      new OTLPTraceExporter({
+        url: endpoint,
+        concurrencyLimit: positiveInt("OTEL_EXPORTER_OTLP_TRACES_CONCURRENCY_LIMIT", 2)
+      }),
+      {
+        maxQueueSize: positiveInt("OTEL_BSP_MAX_QUEUE_SIZE", 2048),
+        maxExportBatchSize: positiveInt("OTEL_BSP_MAX_EXPORT_BATCH_SIZE", 512),
+        scheduledDelayMillis: positiveInt("OTEL_BSP_SCHEDULE_DELAY", 5e3),
+        exportTimeoutMillis: positiveInt("OTEL_BSP_EXPORT_TIMEOUT", 3e4)
+      }
+    );
+  } catch {
+    warnConfigurationOnce(
+      "trace-exporter",
+      "trace exporter unavailable; trace export disabled"
+    );
+    return void 0;
+  }
+}
+function createMetricReader(endpoint) {
+  if (!endpoint) {
+    return void 0;
+  }
+  try {
+    const interval = positiveInt("OTEL_METRIC_EXPORT_INTERVAL", 6e4);
+    const timeout = Math.min(
+      positiveInt("OTEL_METRIC_EXPORT_TIMEOUT", 3e4),
+      interval
+    );
+    return new PeriodicExportingMetricReader({
+      exporter: new OTLPMetricExporter({
+        url: endpoint,
+        concurrencyLimit: positiveInt("OTEL_EXPORTER_OTLP_METRICS_CONCURRENCY_LIMIT", 2)
+      }),
+      exportIntervalMillis: interval,
+      exportTimeoutMillis: timeout
+    });
+  } catch {
+    warnConfigurationOnce(
+      "metric-exporter",
+      "metric exporter unavailable; metric export disabled"
+    );
+    return void 0;
+  }
+}
+function samplerRatioArg(fallback) {
+  const raw = nonEmpty(process.env.OTEL_TRACES_SAMPLER_ARG);
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  if (!Number.isFinite(value) || value < 0 || value > 1) {
+    warnConfigurationOnce(
+      "sampler-ratio-arg",
+      "invalid OTEL_TRACES_SAMPLER_ARG; using the Moda environment fallback"
+    );
+    return fallback;
+  }
+  return value;
+}
+function parentBasedRatio(ratio) {
+  return new ParentBasedSampler({ root: new TraceIdRatioBasedSampler(ratio) });
+}
+function disabledRuntime(serviceName, environment, otelLogs, loki) {
+  let shutdownPromise;
+  return {
+    enabled: false,
+    serviceName,
+    environment,
+    forceFlush: () => settleAll([
+      otelLogs?.forceFlush(),
+      loki?.forceFlush()
+    ]),
+    shutdown: () => {
+      shutdownPromise ??= settleAll([
+        otelLogs?.shutdown(),
+        loki?.shutdown()
+      ]);
+      return shutdownPromise;
+    }
+  };
+}
+function safeInitLogging(fn, destination) {
+  try {
+    return fn();
+  } catch {
+    warnConfigurationOnce(
+      `logging-${destination}`,
+      `${destination} initialization failed; destination disabled`
+    );
+    return void 0;
+  }
+}
+async function settleAll(operations) {
+  await Promise.allSettled(operations);
+}
+function warnConfigurationOnce(key, message) {
+  if (configurationWarnings.has(key)) {
+    return;
+  }
+  configurationWarnings.add(key);
+  try {
+    console.warn(`[moda-observability] ${message.slice(0, 240)}`);
+  } catch {
+  }
+}
+function boundedError(error) {
+  return error instanceof Error ? error.message.slice(0, 300) : "observability-init-failed";
+}
+function setSanitizedUrlAttributes(span, requestPath) {
+  if (!requestPath) {
+    return;
+  }
+  span.setAttribute("url.path", sanitizedPath(requestPath));
+  span.setAttribute("url.query", "");
+}
+function sanitizedPath(value) {
+  return value.split(/[?#]/, 1)[0] || "/";
+}
+function nonEmpty(value) {
+  const normalized = value?.trim();
+  return normalized ? normalized : void 0;
+}
+function envBool(name) {
+  const value = nonEmpty(process.env[name])?.toLowerCase();
+  if (["true", "1", "yes", "on"].includes(value ?? "")) {
+    return true;
+  }
+  if (["false", "0", "no", "off"].includes(value ?? "")) {
+    return false;
+  }
+  return void 0;
+}
+function positiveInt(name, fallback) {
+  const raw = nonEmpty(process.env[name]);
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+}
+function signalEndpoint(signal, suffix) {
+  const exporter = nonEmpty(process.env[`OTEL_${signal}_EXPORTER`]);
+  if (exporter && exporter.toLowerCase() !== "otlp") {
+    return void 0;
+  }
+  const exact = nonEmpty(process.env[`OTEL_EXPORTER_OTLP_${signal}_ENDPOINT`]);
+  if (exact) {
+    return exact;
+  }
+  const base = nonEmpty(process.env.OTEL_EXPORTER_OTLP_ENDPOINT)?.replace(/\/+$/, "");
+  return base ? `${base}/v1/${suffix}` : void 0;
+}
+export {
+  getNodeObservabilityRuntime,
+  initNodeObservability,
+  resolveDeploymentEnvironmentName,
+  resolveSampler
+};
+//# sourceMappingURL=node.js.map

package/dist/observability/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/observability/node.ts"],"sourcesContent":["import { OTLPMetricExporter } from \"@opentelemetry/exporter-metrics-otlp-http\";\nimport { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport { PrismaInstrumentation } from \"@prisma/instrumentation\";\nimport { HttpInstrumentation } from \"@opentelemetry/instrumentation-http\";\nimport { UndiciInstrumentation } from \"@opentelemetry/instrumentation-undici\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport { PeriodicExportingMetricReader } from \"@opentelemetry/sdk-metrics\";\nimport { NodeSDK } from \"@opentelemetry/sdk-node\";\nimport {\n  AlwaysOffSampler,\n  AlwaysOnSampler,\n  BatchSpanProcessor,\n  ParentBasedSampler,\n  TraceIdRatioBasedSampler,\n  type Sampler,\n} from \"@opentelemetry/sdk-trace-base\";\nimport {\n  initNodeLokiLogging,\n  initNodeOpenTelemetryLogging,\n  type NodeLokiLoggingRuntime,\n  type NodeOpenTelemetryLoggingRuntime,\n} from \"../logging/node.js\";\n\nconst DEFAULT_NAMESPACE = \"moda-interact\";\nconst configurationWarnings = new Set<string>();\n\nexport type NodeInstrumentProfile = {\n  http?: boolean;\n  fetch?: boolean;\n  prisma?: boolean;\n};\n\nexport type NodeObservabilityOptions = {\n  serviceName: string;\n  environment?: string;\n  serviceNamespace?: string;\n  instrument?: NodeInstrumentProfile;\n  traceSampleRatio?: number;\n  forceEnable?: boolean;\n};\n\nexport type NodeObservabilityRuntime = {\n  enabled: boolean;\n  serviceName: string;\n  environment: string;\n  error?: string;\n  forceFlush(): Promise<void>;\n  shutdown(): Promise<void>;\n};\n\nlet runtime: NodeObservabilityRuntime | undefined;\n\nexport function resolveDeploymentEnvironmentName(): string {\n  return nonEmpty(process.env.DEPLOYMENT_ENVIRONMENT_NAME)\n    ?? nonEmpty(process.env.OTEL_DEPLOYMENT_ENVIRONMENT)\n    ?? nonEmpty(process.env.NODE_ENV)\n    ?? \"development\";\n}\n\nexport function initNodeObservability(\n  options: NodeObservabilityOptions,\n): NodeObservabilityRuntime {\n  if (runtime) {\n    return runtime;\n  }\n\n  const serviceName = nonEmpty(options?.serviceName) ?? \"unknown-service\";\n  const environment = nonEmpty(options?.environment)\n    ?? resolveDeploymentEnvironmentName();\n  const serviceNamespace = nonEmpty(options?.serviceNamespace)\n    ?? DEFAULT_NAMESPACE;\n\n  if (!nonEmpty(options?.serviceName)) {\n    warnConfigurationOnce(\n      \"service-name\",\n      \"observability disabled: serviceName must be non-empty\",\n    );\n    runtime = disabledRuntime(serviceName, environment);\n    return runtime;\n  }\n\n  const otelLogs = safeInitLogging(() => initNodeOpenTelemetryLogging({\n    serviceName,\n    environment,\n    serviceNamespace,\n  }), \"OpenTelemetry Logs\");\n  const loki = safeInitLogging(() => initNodeLokiLogging({\n    serviceName,\n    environment,\n    serviceNamespace,\n  }), \"Loki\");\n\n  if (!options.forceEnable && envBool(\"OTEL_SDK_DISABLED\") === true) {\n    runtime = disabledRuntime(serviceName, environment, otelLogs, loki);\n    return runtime;\n  }\n\n  const traceEndpoint = signalEndpoint(\"TRACES\", \"traces\");\n  const metricEndpoint = signalEndpoint(\"METRICS\", \"metrics\");\n\n  if (!options.forceEnable && !traceEndpoint && !metricEndpoint) {\n    runtime = disabledRuntime(serviceName, environment, otelLogs, loki);\n    return runtime;\n  }\n\n  try {\n    const resource = resourceFromAttributes({\n      \"service.namespace\": serviceNamespace,\n      \"service.name\": serviceName,\n      \"deployment.environment.name\": environment,\n    });\n    const profile = options.instrument ?? {};\n    const instrumentations = [\n      ...(profile.http ? [new HttpInstrumentation({\n        requestHook: (span, request) => {\n          const path = \"path\" in request ? request.path : request.url;\n          setSanitizedUrlAttributes(span, path);\n          if (\n            \"protocol\" in request\n            && \"host\" in request\n            && typeof request.protocol === \"string\"\n            && typeof request.host === \"string\"\n          ) {\n            span.setAttribute(\n              \"url.full\",\n              `${request.protocol}//${request.host}${sanitizedPath(path ?? \"/\")}`,\n            );\n          }\n        },\n      })] : []),\n      ...(profile.fetch ? [new UndiciInstrumentation({\n        requestHook: (span, request) => {\n          const path = sanitizedPath(request.path);\n          span.setAttribute(\"url.path\", path);\n          span.setAttribute(\"url.full\", `${request.origin}${path}`);\n          span.setAttribute(\"url.query\", \"\");\n        },\n      })] : []),\n      ...(profile.prisma ? [new PrismaInstrumentation()] : []),\n    ];\n\n    const traceProcessor = createTraceProcessor(traceEndpoint);\n    const metricReader = createMetricReader(metricEndpoint);\n\n    if (!traceProcessor && !metricReader) {\n      runtime = {\n        ...disabledRuntime(serviceName, environment, otelLogs, loki),\n        error: \"observability-exporters-unavailable\",\n      };\n      return runtime;\n    }\n\n    const sdk = new NodeSDK({\n      resource,\n      autoDetectResources: false,\n      sampler: resolveSampler(options.traceSampleRatio, environment),\n      spanProcessors: traceProcessor ? [traceProcessor] : [],\n      ...(metricReader ? { metricReader } : {}),\n      instrumentations,\n    });\n\n    sdk.start();\n\n    let shutdownPromise: Promise<void> | undefined;\n    runtime = {\n      enabled: true,\n      serviceName,\n      environment,\n      forceFlush: async () => {\n        await Promise.allSettled([\n          traceProcessor?.forceFlush(),\n          metricReader?.forceFlush(),\n          otelLogs?.forceFlush(),\n          loki?.forceFlush(),\n        ]);\n      },\n      shutdown: () => {\n        shutdownPromise ??= settleAll([\n          Promise.resolve(sdk.shutdown()),\n          otelLogs?.shutdown(),\n          loki?.shutdown(),\n        ]);\n        return shutdownPromise;\n      },\n    };\n    return runtime;\n  } catch (error) {\n    warnConfigurationOnce(\n      \"runtime-init\",\n      \"observability disabled: Node runtime initialization failed\",\n    );\n    runtime = {\n      ...disabledRuntime(serviceName, environment, otelLogs, loki),\n      error: boundedError(error),\n    };\n    return runtime;\n  }\n}\n\nexport function getNodeObservabilityRuntime():\n  | NodeObservabilityRuntime\n  | undefined {\n  return runtime;\n}\n\nexport function resolveSampler(\n  explicitRatio: number | undefined,\n  environment: string,\n): Sampler {\n  const fallbackRatio = environment === \"test\" ? 1 : 0.1;\n\n  if (explicitRatio !== undefined) {\n    if (!Number.isFinite(explicitRatio) || explicitRatio < 0 || explicitRatio > 1) {\n      warnConfigurationOnce(\n        \"explicit-sampler-ratio\",\n        \"invalid traceSampleRatio; using the Moda environment fallback\",\n      );\n      return parentBasedRatio(fallbackRatio);\n    }\n    return parentBasedRatio(explicitRatio);\n  }\n\n  const requested = nonEmpty(process.env.OTEL_TRACES_SAMPLER)?.toLowerCase();\n  if (!requested) {\n    return parentBasedRatio(fallbackRatio);\n  }\n\n  switch (requested) {\n    case \"always_on\":\n      return new AlwaysOnSampler();\n    case \"always_off\":\n      return new AlwaysOffSampler();\n    case \"traceidratio\":\n      return new TraceIdRatioBasedSampler(samplerRatioArg(fallbackRatio));\n    case \"parentbased_always_on\":\n      return new ParentBasedSampler({ root: new AlwaysOnSampler() });\n    case \"parentbased_always_off\":\n      return new ParentBasedSampler({ root: new AlwaysOffSampler() });\n    case \"parentbased_traceidratio\":\n      return parentBasedRatio(samplerRatioArg(fallbackRatio));\n    default:\n      warnConfigurationOnce(\n        \"unsupported-sampler\",\n        \"unsupported OTEL_TRACES_SAMPLER; using the Moda environment fallback\",\n      );\n      return parentBasedRatio(fallbackRatio);\n  }\n}\n\nfunction createTraceProcessor(\n  endpoint: string | undefined,\n): BatchSpanProcessor | undefined {\n  if (!endpoint) {\n    return undefined;\n  }\n\n  try {\n    return new BatchSpanProcessor(\n      new OTLPTraceExporter({\n        url: endpoint,\n        concurrencyLimit: positiveInt(\"OTEL_EXPORTER_OTLP_TRACES_CONCURRENCY_LIMIT\", 2),\n      }),\n      {\n        maxQueueSize: positiveInt(\"OTEL_BSP_MAX_QUEUE_SIZE\", 2048),\n        maxExportBatchSize: positiveInt(\"OTEL_BSP_MAX_EXPORT_BATCH_SIZE\", 512),\n        scheduledDelayMillis: positiveInt(\"OTEL_BSP_SCHEDULE_DELAY\", 5_000),\n        exportTimeoutMillis: positiveInt(\"OTEL_BSP_EXPORT_TIMEOUT\", 30_000),\n      },\n    );\n  } catch {\n    warnConfigurationOnce(\n      \"trace-exporter\",\n      \"trace exporter unavailable; trace export disabled\",\n    );\n    return undefined;\n  }\n}\n\nfunction createMetricReader(\n  endpoint: string | undefined,\n): PeriodicExportingMetricReader | undefined {\n  if (!endpoint) {\n    return undefined;\n  }\n\n  try {\n    const interval = positiveInt(\"OTEL_METRIC_EXPORT_INTERVAL\", 60_000);\n    const timeout = Math.min(\n      positiveInt(\"OTEL_METRIC_EXPORT_TIMEOUT\", 30_000),\n      interval,\n    );\n\n    return new PeriodicExportingMetricReader({\n      exporter: new OTLPMetricExporter({\n        url: endpoint,\n        concurrencyLimit: positiveInt(\"OTEL_EXPORTER_OTLP_METRICS_CONCURRENCY_LIMIT\", 2),\n      }),\n      exportIntervalMillis: interval,\n      exportTimeoutMillis: timeout,\n    });\n  } catch {\n    warnConfigurationOnce(\n      \"metric-exporter\",\n      \"metric exporter unavailable; metric export disabled\",\n    );\n    return undefined;\n  }\n}\n\nfunction samplerRatioArg(fallback: number): number {\n  const raw = nonEmpty(process.env.OTEL_TRACES_SAMPLER_ARG);\n  if (!raw) {\n    return fallback;\n  }\n\n  const value = Number(raw);\n  if (!Number.isFinite(value) || value < 0 || value > 1) {\n    warnConfigurationOnce(\n      \"sampler-ratio-arg\",\n      \"invalid OTEL_TRACES_SAMPLER_ARG; using the Moda environment fallback\",\n    );\n    return fallback;\n  }\n  return value;\n}\n\nfunction parentBasedRatio(ratio: number): ParentBasedSampler {\n  return new ParentBasedSampler({ root: new TraceIdRatioBasedSampler(ratio) });\n}\n\nfunction disabledRuntime(\n  serviceName: string,\n  environment: string,\n  otelLogs?: NodeOpenTelemetryLoggingRuntime,\n  loki?: NodeLokiLoggingRuntime,\n): NodeObservabilityRuntime {\n  let shutdownPromise: Promise<void> | undefined;\n\n  return {\n    enabled: false,\n    serviceName,\n    environment,\n    forceFlush: () => settleAll([\n      otelLogs?.forceFlush(),\n      loki?.forceFlush(),\n    ]),\n    shutdown: () => {\n      shutdownPromise ??= settleAll([\n        otelLogs?.shutdown(),\n        loki?.shutdown(),\n      ]);\n      return shutdownPromise;\n    },\n  };\n}\n\nfunction safeInitLogging<T>(fn: () => T, destination: string): T | undefined {\n  try {\n    return fn();\n  } catch {\n    warnConfigurationOnce(\n      `logging-${destination}`,\n      `${destination} initialization failed; destination disabled`,\n    );\n    return undefined;\n  }\n}\n\nasync function settleAll(\n  operations: Array<Promise<unknown> | undefined>,\n): Promise<void> {\n  await Promise.allSettled(operations);\n}\n\nfunction warnConfigurationOnce(key: string, message: string): void {\n  if (configurationWarnings.has(key)) {\n    return;\n  }\n  configurationWarnings.add(key);\n\n  try {\n    console.warn(`[moda-observability] ${message.slice(0, 240)}`);\n  } catch {\n    // Configuration diagnostics must not affect application startup.\n  }\n}\n\nfunction boundedError(error: unknown): string {\n  return error instanceof Error\n    ? error.message.slice(0, 300)\n    : \"observability-init-failed\";\n}\n\nfunction setSanitizedUrlAttributes(\n  span: Span,\n  requestPath: string | undefined,\n): void {\n  if (!requestPath) {\n    return;\n  }\n  span.setAttribute(\"url.path\", sanitizedPath(requestPath));\n  span.setAttribute(\"url.query\", \"\");\n}\n\nfunction sanitizedPath(value: string): string {\n  return value.split(/[?#]/, 1)[0] || \"/\";\n}\n\nfunction nonEmpty(value: string | undefined): string | undefined {\n  const normalized = value?.trim();\n  return normalized ? normalized : undefined;\n}\n\nfunction envBool(name: string): boolean | undefined {\n  const value = nonEmpty(process.env[name])?.toLowerCase();\n  if ([\"true\", \"1\", \"yes\", \"on\"].includes(value ?? \"\")) {\n    return true;\n  }\n  if ([\"false\", \"0\", \"no\", \"off\"].includes(value ?? \"\")) {\n    return false;\n  }\n  return undefined;\n}\n\nfunction positiveInt(name: string, fallback: number): number {\n  const raw = nonEmpty(process.env[name]);\n  if (!raw) {\n    return fallback;\n  }\n  const value = Number(raw);\n  return Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;\n}\n\nfunction signalEndpoint(\n  signal: \"TRACES\" | \"METRICS\",\n  suffix: string,\n): string | undefined {\n  const exporter = nonEmpty(process.env[`OTEL_${signal}_EXPORTER`]);\n  if (exporter && exporter.toLowerCase() !== \"otlp\") {\n    return undefined;\n  }\n\n  const exact = nonEmpty(process.env[`OTEL_EXPORTER_OTLP_${signal}_ENDPOINT`]);\n  if (exact) {\n    return exact;\n  }\n\n  const base = nonEmpty(process.env.OTEL_EXPORTER_OTLP_ENDPOINT)\n    ?.replace(/\\/+$/, \"\");\n  return base ? `${base}/v1/${suffix}` : undefined;\n}"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,6 +27,22 @@
     "./logging/node": {
       "types": "./dist/logging/node.d.ts",
       "import": "./dist/logging/node.js"
+    },
+    "./observability": {
+      "types": "./dist/observability/index.d.ts",
+      "import": "./dist/observability/index.js"
+    },
+    "./observability/node": {
+      "types": "./dist/observability/node.d.ts",
+      "import": "./dist/observability/node.js"
+    },
+    "./observability/bullmq": {
+      "types": "./dist/observability/bullmq.d.ts",
+      "import": "./dist/observability/bullmq.js"
+    },
+    "./observability/genai": {
+      "types": "./dist/observability/genai.d.ts",
+      "import": "./dist/observability/genai.js"
     }
   },
   "files": [
@@ -41,15 +57,27 @@
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/api-logs": "0.221.0",
+    "@opentelemetry/context-async-hooks": "^2.10.0",
     "@opentelemetry/exporter-logs-otlp-http": "0.221.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "0.221.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.221.0",
+    "@opentelemetry/instrumentation-http": "0.221.0",
+    "@opentelemetry/instrumentation-undici": "0.31.0",
     "@opentelemetry/resources": "^2.10.0",
     "@opentelemetry/sdk-logs": "0.221.0",
+    "@opentelemetry/sdk-metrics": "^2.10.0",
+    "@opentelemetry/sdk-node": "0.221.0",
+    "@opentelemetry/sdk-trace-base": "^2.10.0",
+    "@prisma/instrumentation": "^6.19.3",
+    "bullmq-otel": "^2.0.1",
     "winston": "3.19.0",
     "winston-loki": "6.1.7",
     "zod": "^4.0.0"
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
+    "bullmq": "^6.3.1",
+    "ioredis": "^6.0.0",
     "tsup": "^8.0.0",
     "tsx": "^4.23.12",
     "typescript": "^5.0.0"