apitally 1.0.0-beta.2 → 1.0.0-beta.3

package/README.md

@@ -286,8 +286,13 @@ The top-level `apitally` package provides functions you can call from anywhere i
 ```javascript
 import { setConsumer, setRequestAttribute, captureException } from "apitally";
 
-// Associate the current request with an API consumer
-setConsumer({ identifier: user.identifier, name: user.name, group: user.group });
+// Associate the current request with an API consumer, with custom attributes
+setConsumer({
+  identifier: user.identifier,
+  name: user.name,
+  group: user.group,
+  attributes: { plan: user.plan },
+});
 
 // Attach a custom attribute to the current request
 setRequestAttribute("tenant", tenantId);

package/dist/activation.cjs

@@ -196,6 +196,7 @@ function startPipelines(startupEventInfo) {
 		spanPipeline,
 		tracerProvider,
 		loggerProvider,
+		consumerUpdateHashes: /* @__PURE__ */ new Map(),
 		metricsPipeline,
 		spool,
 		worker,

package/dist/activation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"activation.cjs","names":["setConfig","Spool","ExportWorker","VALIDATION_ERROR_EVENT_NAME","drainValidationErrors","SERVER_ERROR_EVENT_NAME","drainServerErrors","ROOT_CONTEXT","getDistroVersion","getConfig","isApitallySpanProcessorDeclared","resolveEnvAndCreateResource","ApitallySpanExporter","Redaction","BatchSpanProcessor","SpanPipeline","setupTracerProvider","BatchLogRecordProcessor","ApitallyLogRecordExporter","ApitallyLogRecordProcessor","createLoggerProvider","MetricsPipeline","UndiciInstrumentation","isMainThread"],"sources":["../src/activation.ts"],"sourcesContent":["import { isMainThread } from \"node:worker_threads\";\nimport { ROOT_CONTEXT } from \"@opentelemetry/api\";\nimport type { AnyValueMap } from \"@opentelemetry/api-logs\";\nimport { UndiciInstrumentation } from \"@opentelemetry/instrumentation-undici\";\nimport { BatchLogRecordProcessor, type LoggerProvider } from \"@opentelemetry/sdk-logs\";\nimport { BatchSpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport type { NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\nimport { type ApitallyConfig, type ApitallyOptions, getConfig, setConfig } from \"./config.js\";\nimport { ExportWorker, type ExportWorkerOptions } from \"./exportWorker.js\";\nimport {\n  installConsoleCapture,\n  installNestLoggerCapture,\n  installPinoCapture,\n  installWinstonCapture,\n} from \"./logCapture.js\";\nimport { logDebug, logError, logWarning } from \"./logger.js\";\nimport { ApitallyLogRecordExporter } from \"./logRecordExporter.js\";\nimport { ApitallyLogRecordProcessor } from \"./logRecordProcessor.js\";\nimport { MetricsPipeline } from \"./metrics.js\";\nimport { getDistroVersion } from \"./packageVersion.js\";\nimport {\n  createLoggerProvider,\n  resolveEnvAndCreateResource,\n  setupTracerProvider,\n} from \"./providers.js\";\nimport { Redaction } from \"./redaction.js\";\nimport { installSentryEventIdRecording } from \"./sentry.js\";\nimport { drainServerErrors, resetServerErrors, SERVER_ERROR_EVENT_NAME } from \"./serverErrors.js\";\nimport { ApitallySpanExporter } from \"./spanExporter.js\";\nimport {\n  isApitallySpanProcessorDeclared,\n  SpanPipeline,\n  setActiveSpanPipeline,\n  setServerSpanActivationCallback,\n} from \"./spanProcessor.js\";\nimport { Spool } from \"./spool.js\";\nimport { emitStartupEvent, type StartupEventInfo } from \"./startup.js\";\nimport {\n  drainValidationErrors,\n  resetValidationErrors,\n  VALIDATION_ERROR_EVENT_NAME,\n} from \"./validationErrors.js\";\n\n// The worker sends every 15 seconds, so batches only need to reach the spool\n// within that interval.\nconst BATCH_SCHEDULE_DELAY_MILLIS = 1_000;\nconst BATCH_EXPORT_TIMEOUT_MILLIS = 30_000;\nconst BATCH_MAX_QUEUE_SIZE = 2_048;\nconst BATCH_MAX_EXPORT_BATCH_SIZE = 512;\nconst BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE = 32;\nconst SIGNAL_FLUSH_TIMEOUT_MILLIS = 5_000;\n\ntype TerminationSignal = \"SIGTERM\" | \"SIGINT\";\ntype SignalListeners = Record<TerminationSignal, () => void>;\n\n// The ESM and CJS builds can load together, so a Symbol.for key gives both\n// copies the same activation state.\nconst ACTIVATION_STATE_KEY = Symbol.for(\"apitally.activation\");\n\ninterface ActivationState {\n  sdkVersion: string;\n  activationAttempted: boolean;\n  startupEventInfo?: StartupEventInfo;\n  handles?: ActivationHandles;\n  runShutdown?: () => Promise<void>;\n  shutdownPromise?: Promise<void>;\n  beforeExitListener?: () => void;\n  signalListeners?: SignalListeners;\n  signalDrainPromise?: Promise<void>;\n}\n\ninterface ActivationHandles {\n  spanPipeline: SpanPipeline;\n  tracerProvider?: NodeTracerProvider;\n  loggerProvider: LoggerProvider;\n  metricsPipeline: MetricsPipeline;\n  spool: Spool;\n  worker: ExportWorker;\n  undiciInstrumentation?: UndiciInstrumentation;\n}\n\n// Configuration stays synchronous; activate() defers timers and I/O.\nexport function configure(options: ApitallyOptions = {}): ApitallyConfig {\n  const config = setConfig(options);\n  // User instrumentations read this at initialization. `http/dup` adds stable\n  // HTTP attributes alongside legacy ones; a user-set value takes precedence.\n  if (!config.disabled && process.env.OTEL_SEMCONV_STABILITY_OPT_IN === undefined) {\n    process.env.OTEL_SEMCONV_STABILITY_OPT_IN = \"http/dup\";\n  }\n  setServerSpanActivationCallback(activate);\n  return config;\n}\n\n// The first integration registration wins so one process emits one startup event.\nexport function registerStartupEventInfo(info: StartupEventInfo): void {\n  const activationState = getActivationState();\n  activationState.startupEventInfo ??= info;\n}\n\n// Activation is synchronous and attempted once, so concurrent first requests\n// observe either no activation or completed activation.\nexport function activate(): void {\n  const activationState = getActivationState();\n  if (activationState.activationAttempted) {\n    return;\n  }\n  activationState.activationAttempted = true;\n  if (shouldSkipActivation()) {\n    return;\n  }\n  try {\n    const handles = startPipelines(activationState.startupEventInfo);\n    activationState.handles = handles;\n    activationState.runShutdown = () => drainAndStop(handles);\n    installBeforeExitHook(activationState);\n    installSignalHooks(activationState);\n  } catch (error) {\n    logError(`Apitally activation failed: ${String(error)}`);\n  }\n}\n\nexport function isActivated(): boolean {\n  return getActivationState().handles !== undefined;\n}\n\nexport function getActivationHandles(): ActivationHandles | undefined {\n  return getActivationState().handles;\n}\n\nexport async function flushTelemetry(): Promise<void> {\n  try {\n    await getActivationState().handles?.worker.runCycle();\n  } catch (error) {\n    logDebug(`Error flushing telemetry: ${String(error)}`);\n  }\n}\n\n// Concurrent calls and lifecycle hooks share one final drain; calls before\n// activation are no-ops.\nexport function shutdown(): Promise<void> {\n  const activationState = getActivationState();\n  const handles = activationState.handles;\n  const runShutdown = activationState.runShutdown;\n  if (!handles || !runShutdown) {\n    return Promise.resolve();\n  }\n  if (!activationState.shutdownPromise) {\n    removeLifecycleHooks(activationState);\n    const signalDrainPromise = activationState.signalDrainPromise;\n    activationState.shutdownPromise = (\n      signalDrainPromise\n        ? signalDrainPromise.then(() => handles.worker.waitForIdle())\n        : Promise.resolve()\n    ).then(runShutdown);\n  }\n  return activationState.shutdownPromise;\n}\n\n// Tests replace these factories to isolate spool files and worker timing.\nexport const activationFactories = {\n  createSpool: (): Spool => new Spool(),\n  createExportWorker: (options: ExportWorkerOptions): ExportWorker => new ExportWorker(options),\n};\nconst defaultFactories = { ...activationFactories };\n\n// Tests reset process-global activation and its side effects between cases.\nexport async function resetActivation(): Promise<void> {\n  Object.assign(activationFactories, defaultFactories);\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const activationState = holder[ACTIVATION_STATE_KEY];\n  delete holder[ACTIVATION_STATE_KEY];\n  hasWarnedAboutVersionSkew = false;\n  resetValidationErrors();\n  resetServerErrors();\n  if (!activationState) {\n    return;\n  }\n  removeLifecycleHooks(activationState);\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  handles.undiciInstrumentation?.disable();\n  await handles.worker.stop();\n  await handles.spanPipeline.shutdown();\n  await handles.loggerProvider.shutdown();\n  await handles.spool.clear();\n}\n\nlet hasWarnedAboutVersionSkew = false;\n\n// One root-context record per aggregate group, drained right before the log\n// processor flush so the records leave with the same export cycle.\nfunction emitErrorEvents(loggerProvider: LoggerProvider): void {\n  const logger = loggerProvider.getLogger(\"apitally\");\n  const events: [string, AnyValueMap[]][] = [\n    [VALIDATION_ERROR_EVENT_NAME, drainValidationErrors()],\n    [SERVER_ERROR_EVENT_NAME, drainServerErrors()],\n  ];\n  for (const [eventName, bodies] of events) {\n    for (const body of bodies) {\n      logger.emit({ timestamp: Date.now(), context: ROOT_CONTEXT, eventName, body });\n    }\n  }\n}\n\nfunction getActivationState(): ActivationState {\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const existing = holder[ACTIVATION_STATE_KEY];\n  if (existing) {\n    if (!hasWarnedAboutVersionSkew && existing.sdkVersion !== getDistroVersion()) {\n      hasWarnedAboutVersionSkew = true;\n      logWarning(\n        `Two copies of the apitally package with different versions (${existing.sdkVersion} and ${getDistroVersion()}) are loaded in this process; version ${existing.sdkVersion} stays active. To resolve this, deduplicate the apitally installation.`,\n      );\n    }\n    return existing;\n  }\n  const activationState: ActivationState = {\n    sdkVersion: getDistroVersion(),\n    activationAttempted: false,\n  };\n  holder[ACTIVATION_STATE_KEY] = activationState;\n  return activationState;\n}\n\nfunction shouldSkipActivation(): boolean {\n  return (\n    Boolean(process.env.JEST_WORKER_ID) ||\n    Boolean(process.env.VITEST) ||\n    process.env.NODE_ENV === \"test\" ||\n    getConfig().disabled\n  );\n}\n\nfunction startPipelines(startupEventInfo: StartupEventInfo | undefined): ActivationHandles {\n  const config = getConfig();\n  let hasUserProvider = isApitallySpanProcessorDeclared();\n  const { env, resource } = resolveEnvAndCreateResource();\n  const instanceId = resource.attributes[\"service.instance.id\"] as string;\n  const spool = activationFactories.createSpool();\n  const spanExporter = new ApitallySpanExporter({\n    redaction: new Redaction(),\n    env,\n    instanceId,\n    spool,\n    maskRequestBody: config.maskRequestBody,\n    maskResponseBody: config.maskResponseBody,\n  });\n  // Concrete options prevent OTel environment variables from changing batch\n  // behavior. Each processor gets a fresh object because its config is mutated.\n  const batchSpanProcessor = new BatchSpanProcessor(spanExporter, {\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize:\n      config.captureRequestBody || config.captureResponseBody\n        ? BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE\n        : BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const spanPipeline = new SpanPipeline(batchSpanProcessor, () => spanExporter.forceFlush());\n  let tracerProvider: NodeTracerProvider | undefined;\n  if (!hasUserProvider) {\n    tracerProvider = setupTracerProvider(resource, [spanPipeline]);\n    if (!tracerProvider) {\n      hasUserProvider = true;\n      logWarning(\n        \"Apitally could not register its OpenTelemetry tracer provider because another provider is already registered. Only metrics and the startup event are sent to Apitally until you add ApitallySpanProcessor (exported by the apitally package) to your tracer provider's spanProcessors constructor option or the NodeSDK spanProcessors option.\",\n      );\n    }\n  }\n  setActiveSpanPipeline(spanPipeline);\n  // BatchLogRecordProcessor requires its single-options-object form; positional\n  // arguments create a broken processor.\n  const batchLogProcessor = new BatchLogRecordProcessor({\n    exporter: new ApitallyLogRecordExporter(spool),\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize: BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const logRecordProcessor = new ApitallyLogRecordProcessor(\n    batchLogProcessor,\n    spanPipeline,\n    config.maskLogRecord,\n  );\n  const loggerProvider = createLoggerProvider(resource, [logRecordProcessor]);\n  const metricsPipeline = new MetricsPipeline(resource, spool);\n  spanPipeline.metricsRecorder = (record) => metricsPipeline.recordFromRequest(record);\n  const worker = activationFactories.createExportWorker({\n    spool,\n    otlpEndpoint: config.otlpEndpoint,\n    writeToken: config.writeToken,\n    env,\n  });\n  worker.flushCallbacks.push(\n    () => metricsPipeline.collectAndExport(),\n    () => spanPipeline.forceFlush(),\n    () => emitErrorEvents(loggerProvider),\n    () => batchLogProcessor.forceFlush(),\n  );\n  if (config.captureLogs) {\n    installConsoleCapture(loggerProvider);\n    installNestLoggerCapture(loggerProvider);\n    installWinstonCapture(loggerProvider);\n    installPinoCapture(loggerProvider);\n  }\n  installSentryEventIdRecording();\n  let undiciInstrumentation: UndiciInstrumentation | undefined;\n  if (!hasUserProvider) {\n    undiciInstrumentation = createUndiciInstrumentation(config.otlpEndpoint);\n  }\n  worker.start();\n  if (startupEventInfo) {\n    emitStartupEvent(loggerProvider, startupEventInfo);\n  }\n  return {\n    spanPipeline,\n    tracerProvider,\n    loggerProvider,\n    metricsPipeline,\n    spool,\n    worker,\n    undiciInstrumentation,\n  };\n}\n\n// ignoreRequestHook prevents telemetry for export POSTs. The request origin can\n// be a string or URL at runtime despite its string type.\nfunction createUndiciInstrumentation(otlpEndpoint: string): UndiciInstrumentation {\n  const endpointOrigin = new URL(otlpEndpoint).origin;\n  return new UndiciInstrumentation({\n    ignoreRequestHook: (request) => {\n      try {\n        return new URL(String(request.origin)).origin === endpointOrigin;\n      } catch {\n        return false;\n      }\n    },\n  });\n}\n\nasync function drainAndStop(handles: ActivationHandles): Promise<void> {\n  try {\n    await handles.spanPipeline.shutdown();\n    await handles.worker.finalDrain();\n    await handles.loggerProvider.shutdown();\n    await handles.worker.stop();\n  } catch (error) {\n    logWarning(`Error draining telemetry on shutdown: ${String(error)}`);\n  }\n}\n\nfunction installSignalHooks(activationState: ActivationState): void {\n  if (process.platform === \"win32\" || !isMainThread) {\n    return;\n  }\n  let listeners: SignalListeners;\n  listeners = {\n    SIGTERM: () => handleTerminationSignal(activationState, listeners, \"SIGTERM\"),\n    SIGINT: () => handleTerminationSignal(activationState, listeners, \"SIGINT\"),\n  };\n  activationState.signalListeners = listeners;\n  try {\n    process.prependOnceListener(\"SIGTERM\", listeners.SIGTERM);\n    process.prependOnceListener(\"SIGINT\", listeners.SIGINT);\n  } catch (error) {\n    removeSignalHooks(activationState, listeners);\n    logWarning(`Unable to install Apitally signal handlers: ${String(error)}`);\n  }\n}\n\nfunction handleTerminationSignal(\n  activationState: ActivationState,\n  listeners: SignalListeners,\n  signal: TerminationSignal,\n): void {\n  const hasApplicationListener = process\n    .listeners(signal)\n    .some((listener) => listener !== listeners[signal]);\n  removeSignalHooks(activationState, listeners);\n  const drainPromise = flushAfterTerminationSignal(activationState, signal, hasApplicationListener);\n  activationState.signalDrainPromise = drainPromise;\n  void drainPromise.catch((error: unknown) => {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  });\n}\n\nasync function flushAfterTerminationSignal(\n  activationState: ActivationState,\n  signal: TerminationSignal,\n  hasApplicationListener: boolean,\n): Promise<void> {\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  try {\n    if (activationState.shutdownPromise) {\n      await waitForSignalDeadline(activationState.shutdownPromise);\n    } else {\n      await handles.worker.finalDrain(SIGNAL_FLUSH_TIMEOUT_MILLIS);\n    }\n  } catch (error) {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  }\n  if (hasApplicationListener || process.listeners(signal).length > 0) {\n    return;\n  }\n  const exitCode = signal === \"SIGTERM\" ? 143 : 130;\n  if (process.platform === \"linux\" && process.pid === 1) {\n    process.exit(exitCode);\n  }\n  try {\n    process.kill(process.pid, signal);\n  } catch {\n    process.exit(exitCode);\n  }\n}\n\nasync function waitForSignalDeadline(promise: Promise<void>): Promise<void> {\n  let deadlineTimer: NodeJS.Timeout | undefined;\n  const deadlineReached = new Promise<void>((resolve) => {\n    deadlineTimer = setTimeout(resolve, SIGNAL_FLUSH_TIMEOUT_MILLIS);\n  });\n  try {\n    await Promise.race([promise, deadlineReached]);\n  } finally {\n    if (deadlineTimer) {\n      clearTimeout(deadlineTimer);\n    }\n  }\n}\n\nfunction removeSignalHooks(\n  activationState: ActivationState,\n  listeners = activationState.signalListeners,\n): void {\n  if (!listeners) {\n    return;\n  }\n  process.removeListener(\"SIGTERM\", listeners.SIGTERM);\n  process.removeListener(\"SIGINT\", listeners.SIGINT);\n  if (activationState.signalListeners === listeners) {\n    activationState.signalListeners = undefined;\n  }\n}\n\nfunction removeLifecycleHooks(activationState: ActivationState): void {\n  removeSignalHooks(activationState);\n  if (activationState.beforeExitListener) {\n    process.removeListener(\"beforeExit\", activationState.beforeExitListener);\n    activationState.beforeExitListener = undefined;\n  }\n}\n\nfunction installBeforeExitHook(activationState: ActivationState): void {\n  const listener = () => {\n    // The drain keeps the event loop alive until shutdown settles.\n    void shutdown().catch((error: unknown) => {\n      logDebug(`Error draining telemetry on shutdown: ${String(error)}`);\n    });\n  };\n  activationState.beforeExitListener = listener;\n  process.on(\"beforeExit\", listener);\n}\n"],"mappings":"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"}
+{"version":3,"file":"activation.cjs","names":["setConfig","Spool","ExportWorker","VALIDATION_ERROR_EVENT_NAME","drainValidationErrors","SERVER_ERROR_EVENT_NAME","drainServerErrors","ROOT_CONTEXT","getDistroVersion","getConfig","isApitallySpanProcessorDeclared","resolveEnvAndCreateResource","ApitallySpanExporter","Redaction","BatchSpanProcessor","SpanPipeline","setupTracerProvider","BatchLogRecordProcessor","ApitallyLogRecordExporter","ApitallyLogRecordProcessor","createLoggerProvider","MetricsPipeline","UndiciInstrumentation","isMainThread"],"sources":["../src/activation.ts"],"sourcesContent":["import { isMainThread } from \"node:worker_threads\";\nimport { ROOT_CONTEXT } from \"@opentelemetry/api\";\nimport type { AnyValueMap } from \"@opentelemetry/api-logs\";\nimport { UndiciInstrumentation } from \"@opentelemetry/instrumentation-undici\";\nimport { BatchLogRecordProcessor, type LoggerProvider } from \"@opentelemetry/sdk-logs\";\nimport { BatchSpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport type { NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\nimport { type ApitallyConfig, type ApitallyOptions, getConfig, setConfig } from \"./config.js\";\nimport { ExportWorker, type ExportWorkerOptions } from \"./exportWorker.js\";\nimport {\n  installConsoleCapture,\n  installNestLoggerCapture,\n  installPinoCapture,\n  installWinstonCapture,\n} from \"./logCapture.js\";\nimport { logDebug, logError, logWarning } from \"./logger.js\";\nimport { ApitallyLogRecordExporter } from \"./logRecordExporter.js\";\nimport { ApitallyLogRecordProcessor } from \"./logRecordProcessor.js\";\nimport { MetricsPipeline } from \"./metrics.js\";\nimport { getDistroVersion } from \"./packageVersion.js\";\nimport {\n  createLoggerProvider,\n  resolveEnvAndCreateResource,\n  setupTracerProvider,\n} from \"./providers.js\";\nimport { Redaction } from \"./redaction.js\";\nimport { installSentryEventIdRecording } from \"./sentry.js\";\nimport { drainServerErrors, resetServerErrors, SERVER_ERROR_EVENT_NAME } from \"./serverErrors.js\";\nimport { ApitallySpanExporter } from \"./spanExporter.js\";\nimport {\n  isApitallySpanProcessorDeclared,\n  SpanPipeline,\n  setActiveSpanPipeline,\n  setServerSpanActivationCallback,\n} from \"./spanProcessor.js\";\nimport { Spool } from \"./spool.js\";\nimport { emitStartupEvent, type StartupEventInfo } from \"./startup.js\";\nimport {\n  drainValidationErrors,\n  resetValidationErrors,\n  VALIDATION_ERROR_EVENT_NAME,\n} from \"./validationErrors.js\";\n\n// The worker sends every 15 seconds, so batches only need to reach the spool\n// within that interval.\nconst BATCH_SCHEDULE_DELAY_MILLIS = 1_000;\nconst BATCH_EXPORT_TIMEOUT_MILLIS = 30_000;\nconst BATCH_MAX_QUEUE_SIZE = 2_048;\nconst BATCH_MAX_EXPORT_BATCH_SIZE = 512;\nconst BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE = 32;\nconst SIGNAL_FLUSH_TIMEOUT_MILLIS = 5_000;\n\ntype TerminationSignal = \"SIGTERM\" | \"SIGINT\";\ntype SignalListeners = Record<TerminationSignal, () => void>;\n\n// The ESM and CJS builds can load together, so a Symbol.for key gives both\n// copies the same activation state.\nconst ACTIVATION_STATE_KEY = Symbol.for(\"apitally.activation\");\n\ninterface ActivationState {\n  sdkVersion: string;\n  activationAttempted: boolean;\n  startupEventInfo?: StartupEventInfo;\n  handles?: ActivationHandles;\n  runShutdown?: () => Promise<void>;\n  shutdownPromise?: Promise<void>;\n  beforeExitListener?: () => void;\n  signalListeners?: SignalListeners;\n  signalDrainPromise?: Promise<void>;\n}\n\ninterface ActivationHandles {\n  spanPipeline: SpanPipeline;\n  tracerProvider?: NodeTracerProvider;\n  loggerProvider: LoggerProvider;\n  // Consumer identifier to the hash of its last emitted consumer update, in LRU order.\n  consumerUpdateHashes: Map<string, string>;\n  metricsPipeline: MetricsPipeline;\n  spool: Spool;\n  worker: ExportWorker;\n  undiciInstrumentation?: UndiciInstrumentation;\n}\n\n// Configuration stays synchronous; activate() defers timers and I/O.\nexport function configure(options: ApitallyOptions = {}): ApitallyConfig {\n  const config = setConfig(options);\n  // User instrumentations read this at initialization. `http/dup` adds stable\n  // HTTP attributes alongside legacy ones; a user-set value takes precedence.\n  if (!config.disabled && process.env.OTEL_SEMCONV_STABILITY_OPT_IN === undefined) {\n    process.env.OTEL_SEMCONV_STABILITY_OPT_IN = \"http/dup\";\n  }\n  setServerSpanActivationCallback(activate);\n  return config;\n}\n\n// The first integration registration wins so one process emits one startup event.\nexport function registerStartupEventInfo(info: StartupEventInfo): void {\n  const activationState = getActivationState();\n  activationState.startupEventInfo ??= info;\n}\n\n// Activation is synchronous and attempted once, so concurrent first requests\n// observe either no activation or completed activation.\nexport function activate(): void {\n  const activationState = getActivationState();\n  if (activationState.activationAttempted) {\n    return;\n  }\n  activationState.activationAttempted = true;\n  if (shouldSkipActivation()) {\n    return;\n  }\n  try {\n    const handles = startPipelines(activationState.startupEventInfo);\n    activationState.handles = handles;\n    activationState.runShutdown = () => drainAndStop(handles);\n    installBeforeExitHook(activationState);\n    installSignalHooks(activationState);\n  } catch (error) {\n    logError(`Apitally activation failed: ${String(error)}`);\n  }\n}\n\nexport function isActivated(): boolean {\n  return getActivationState().handles !== undefined;\n}\n\nexport function getActivationHandles(): ActivationHandles | undefined {\n  return getActivationState().handles;\n}\n\nexport async function flushTelemetry(): Promise<void> {\n  try {\n    await getActivationState().handles?.worker.runCycle();\n  } catch (error) {\n    logDebug(`Error flushing telemetry: ${String(error)}`);\n  }\n}\n\n// Concurrent calls and lifecycle hooks share one final drain; calls before\n// activation are no-ops.\nexport function shutdown(): Promise<void> {\n  const activationState = getActivationState();\n  const handles = activationState.handles;\n  const runShutdown = activationState.runShutdown;\n  if (!handles || !runShutdown) {\n    return Promise.resolve();\n  }\n  if (!activationState.shutdownPromise) {\n    removeLifecycleHooks(activationState);\n    const signalDrainPromise = activationState.signalDrainPromise;\n    activationState.shutdownPromise = (\n      signalDrainPromise\n        ? signalDrainPromise.then(() => handles.worker.waitForIdle())\n        : Promise.resolve()\n    ).then(runShutdown);\n  }\n  return activationState.shutdownPromise;\n}\n\n// Tests replace these factories to isolate spool files and worker timing.\nexport const activationFactories = {\n  createSpool: (): Spool => new Spool(),\n  createExportWorker: (options: ExportWorkerOptions): ExportWorker => new ExportWorker(options),\n};\nconst defaultFactories = { ...activationFactories };\n\n// Tests reset process-global activation and its side effects between cases.\nexport async function resetActivation(): Promise<void> {\n  Object.assign(activationFactories, defaultFactories);\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const activationState = holder[ACTIVATION_STATE_KEY];\n  delete holder[ACTIVATION_STATE_KEY];\n  hasWarnedAboutVersionSkew = false;\n  resetValidationErrors();\n  resetServerErrors();\n  if (!activationState) {\n    return;\n  }\n  removeLifecycleHooks(activationState);\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  handles.undiciInstrumentation?.disable();\n  await handles.worker.stop();\n  await handles.spanPipeline.shutdown();\n  await handles.loggerProvider.shutdown();\n  await handles.spool.clear();\n}\n\nlet hasWarnedAboutVersionSkew = false;\n\n// One root-context record per aggregate group, drained right before the log\n// processor flush so the records leave with the same export cycle.\nfunction emitErrorEvents(loggerProvider: LoggerProvider): void {\n  const logger = loggerProvider.getLogger(\"apitally\");\n  const events: [string, AnyValueMap[]][] = [\n    [VALIDATION_ERROR_EVENT_NAME, drainValidationErrors()],\n    [SERVER_ERROR_EVENT_NAME, drainServerErrors()],\n  ];\n  for (const [eventName, bodies] of events) {\n    for (const body of bodies) {\n      logger.emit({ timestamp: Date.now(), context: ROOT_CONTEXT, eventName, body });\n    }\n  }\n}\n\nfunction getActivationState(): ActivationState {\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const existing = holder[ACTIVATION_STATE_KEY];\n  if (existing) {\n    if (!hasWarnedAboutVersionSkew && existing.sdkVersion !== getDistroVersion()) {\n      hasWarnedAboutVersionSkew = true;\n      logWarning(\n        `Two copies of the apitally package with different versions (${existing.sdkVersion} and ${getDistroVersion()}) are loaded in this process; version ${existing.sdkVersion} stays active. To resolve this, deduplicate the apitally installation.`,\n      );\n    }\n    return existing;\n  }\n  const activationState: ActivationState = {\n    sdkVersion: getDistroVersion(),\n    activationAttempted: false,\n  };\n  holder[ACTIVATION_STATE_KEY] = activationState;\n  return activationState;\n}\n\nfunction shouldSkipActivation(): boolean {\n  return (\n    Boolean(process.env.JEST_WORKER_ID) ||\n    Boolean(process.env.VITEST) ||\n    process.env.NODE_ENV === \"test\" ||\n    getConfig().disabled\n  );\n}\n\nfunction startPipelines(startupEventInfo: StartupEventInfo | undefined): ActivationHandles {\n  const config = getConfig();\n  let hasUserProvider = isApitallySpanProcessorDeclared();\n  const { env, resource } = resolveEnvAndCreateResource();\n  const instanceId = resource.attributes[\"service.instance.id\"] as string;\n  const spool = activationFactories.createSpool();\n  const spanExporter = new ApitallySpanExporter({\n    redaction: new Redaction(),\n    env,\n    instanceId,\n    spool,\n    maskRequestBody: config.maskRequestBody,\n    maskResponseBody: config.maskResponseBody,\n  });\n  // Concrete options prevent OTel environment variables from changing batch\n  // behavior. Each processor gets a fresh object because its config is mutated.\n  const batchSpanProcessor = new BatchSpanProcessor(spanExporter, {\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize:\n      config.captureRequestBody || config.captureResponseBody\n        ? BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE\n        : BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const spanPipeline = new SpanPipeline(batchSpanProcessor, () => spanExporter.forceFlush());\n  let tracerProvider: NodeTracerProvider | undefined;\n  if (!hasUserProvider) {\n    tracerProvider = setupTracerProvider(resource, [spanPipeline]);\n    if (!tracerProvider) {\n      hasUserProvider = true;\n      logWarning(\n        \"Apitally could not register its OpenTelemetry tracer provider because another provider is already registered. Only metrics and the startup event are sent to Apitally until you add ApitallySpanProcessor (exported by the apitally package) to your tracer provider's spanProcessors constructor option or the NodeSDK spanProcessors option.\",\n      );\n    }\n  }\n  setActiveSpanPipeline(spanPipeline);\n  // BatchLogRecordProcessor requires its single-options-object form; positional\n  // arguments create a broken processor.\n  const batchLogProcessor = new BatchLogRecordProcessor({\n    exporter: new ApitallyLogRecordExporter(spool),\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize: BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const logRecordProcessor = new ApitallyLogRecordProcessor(\n    batchLogProcessor,\n    spanPipeline,\n    config.maskLogRecord,\n  );\n  const loggerProvider = createLoggerProvider(resource, [logRecordProcessor]);\n  const metricsPipeline = new MetricsPipeline(resource, spool);\n  spanPipeline.metricsRecorder = (record) => metricsPipeline.recordFromRequest(record);\n  const worker = activationFactories.createExportWorker({\n    spool,\n    otlpEndpoint: config.otlpEndpoint,\n    writeToken: config.writeToken,\n    env,\n  });\n  worker.flushCallbacks.push(\n    () => metricsPipeline.collectAndExport(),\n    () => spanPipeline.forceFlush(),\n    () => emitErrorEvents(loggerProvider),\n    () => batchLogProcessor.forceFlush(),\n  );\n  if (config.captureLogs) {\n    installConsoleCapture(loggerProvider);\n    installNestLoggerCapture(loggerProvider);\n    installWinstonCapture(loggerProvider);\n    installPinoCapture(loggerProvider);\n  }\n  installSentryEventIdRecording();\n  let undiciInstrumentation: UndiciInstrumentation | undefined;\n  if (!hasUserProvider) {\n    undiciInstrumentation = createUndiciInstrumentation(config.otlpEndpoint);\n  }\n  worker.start();\n  if (startupEventInfo) {\n    emitStartupEvent(loggerProvider, startupEventInfo);\n  }\n  return {\n    spanPipeline,\n    tracerProvider,\n    loggerProvider,\n    consumerUpdateHashes: new Map(),\n    metricsPipeline,\n    spool,\n    worker,\n    undiciInstrumentation,\n  };\n}\n\n// ignoreRequestHook prevents telemetry for export POSTs. The request origin can\n// be a string or URL at runtime despite its string type.\nfunction createUndiciInstrumentation(otlpEndpoint: string): UndiciInstrumentation {\n  const endpointOrigin = new URL(otlpEndpoint).origin;\n  return new UndiciInstrumentation({\n    ignoreRequestHook: (request) => {\n      try {\n        return new URL(String(request.origin)).origin === endpointOrigin;\n      } catch {\n        return false;\n      }\n    },\n  });\n}\n\nasync function drainAndStop(handles: ActivationHandles): Promise<void> {\n  try {\n    await handles.spanPipeline.shutdown();\n    await handles.worker.finalDrain();\n    await handles.loggerProvider.shutdown();\n    await handles.worker.stop();\n  } catch (error) {\n    logWarning(`Error draining telemetry on shutdown: ${String(error)}`);\n  }\n}\n\nfunction installSignalHooks(activationState: ActivationState): void {\n  if (process.platform === \"win32\" || !isMainThread) {\n    return;\n  }\n  let listeners: SignalListeners;\n  listeners = {\n    SIGTERM: () => handleTerminationSignal(activationState, listeners, \"SIGTERM\"),\n    SIGINT: () => handleTerminationSignal(activationState, listeners, \"SIGINT\"),\n  };\n  activationState.signalListeners = listeners;\n  try {\n    process.prependOnceListener(\"SIGTERM\", listeners.SIGTERM);\n    process.prependOnceListener(\"SIGINT\", listeners.SIGINT);\n  } catch (error) {\n    removeSignalHooks(activationState, listeners);\n    logWarning(`Unable to install Apitally signal handlers: ${String(error)}`);\n  }\n}\n\nfunction handleTerminationSignal(\n  activationState: ActivationState,\n  listeners: SignalListeners,\n  signal: TerminationSignal,\n): void {\n  const hasApplicationListener = process\n    .listeners(signal)\n    .some((listener) => listener !== listeners[signal]);\n  removeSignalHooks(activationState, listeners);\n  const drainPromise = flushAfterTerminationSignal(activationState, signal, hasApplicationListener);\n  activationState.signalDrainPromise = drainPromise;\n  void drainPromise.catch((error: unknown) => {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  });\n}\n\nasync function flushAfterTerminationSignal(\n  activationState: ActivationState,\n  signal: TerminationSignal,\n  hasApplicationListener: boolean,\n): Promise<void> {\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  try {\n    if (activationState.shutdownPromise) {\n      await waitForSignalDeadline(activationState.shutdownPromise);\n    } else {\n      await handles.worker.finalDrain(SIGNAL_FLUSH_TIMEOUT_MILLIS);\n    }\n  } catch (error) {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  }\n  if (hasApplicationListener || process.listeners(signal).length > 0) {\n    return;\n  }\n  const exitCode = signal === \"SIGTERM\" ? 143 : 130;\n  if (process.platform === \"linux\" && process.pid === 1) {\n    process.exit(exitCode);\n  }\n  try {\n    process.kill(process.pid, signal);\n  } catch {\n    process.exit(exitCode);\n  }\n}\n\nasync function waitForSignalDeadline(promise: Promise<void>): Promise<void> {\n  let deadlineTimer: NodeJS.Timeout | undefined;\n  const deadlineReached = new Promise<void>((resolve) => {\n    deadlineTimer = setTimeout(resolve, SIGNAL_FLUSH_TIMEOUT_MILLIS);\n  });\n  try {\n    await Promise.race([promise, deadlineReached]);\n  } finally {\n    if (deadlineTimer) {\n      clearTimeout(deadlineTimer);\n    }\n  }\n}\n\nfunction removeSignalHooks(\n  activationState: ActivationState,\n  listeners = activationState.signalListeners,\n): void {\n  if (!listeners) {\n    return;\n  }\n  process.removeListener(\"SIGTERM\", listeners.SIGTERM);\n  process.removeListener(\"SIGINT\", listeners.SIGINT);\n  if (activationState.signalListeners === listeners) {\n    activationState.signalListeners = undefined;\n  }\n}\n\nfunction removeLifecycleHooks(activationState: ActivationState): void {\n  removeSignalHooks(activationState);\n  if (activationState.beforeExitListener) {\n    process.removeListener(\"beforeExit\", activationState.beforeExitListener);\n    activationState.beforeExitListener = undefined;\n  }\n}\n\nfunction installBeforeExitHook(activationState: ActivationState): void {\n  const listener = () => {\n    // The drain keeps the event loop alive until shutdown settles.\n    void shutdown().catch((error: unknown) => {\n      logDebug(`Error draining telemetry on shutdown: ${String(error)}`);\n    });\n  };\n  activationState.beforeExitListener = listener;\n  process.on(\"beforeExit\", listener);\n}\n"],"mappings":"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"}

package/dist/activation.d.cts

@@ -12,6 +12,7 @@ interface ActivationHandles {
   spanPipeline: SpanPipeline;
   tracerProvider?: NodeTracerProvider;
   loggerProvider: LoggerProvider;
+  consumerUpdateHashes: Map<string, string>;
   metricsPipeline: MetricsPipeline;
   spool: Spool;
   worker: ExportWorker;

package/dist/activation.d.ts

@@ -12,6 +12,7 @@ interface ActivationHandles {
   spanPipeline: SpanPipeline;
   tracerProvider?: NodeTracerProvider;
   loggerProvider: LoggerProvider;
+  consumerUpdateHashes: Map<string, string>;
   metricsPipeline: MetricsPipeline;
   spool: Spool;
   worker: ExportWorker;

package/dist/activation.js

@@ -195,6 +195,7 @@ function startPipelines(startupEventInfo) {
 		spanPipeline,
 		tracerProvider,
 		loggerProvider,
+		consumerUpdateHashes: /* @__PURE__ */ new Map(),
 		metricsPipeline,
 		spool,
 		worker,

package/dist/activation.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation.js","names":[],"sources":["../src/activation.ts"],"sourcesContent":["import { isMainThread } from \"node:worker_threads\";\nimport { ROOT_CONTEXT } from \"@opentelemetry/api\";\nimport type { AnyValueMap } from \"@opentelemetry/api-logs\";\nimport { UndiciInstrumentation } from \"@opentelemetry/instrumentation-undici\";\nimport { BatchLogRecordProcessor, type LoggerProvider } from \"@opentelemetry/sdk-logs\";\nimport { BatchSpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport type { NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\nimport { type ApitallyConfig, type ApitallyOptions, getConfig, setConfig } from \"./config.js\";\nimport { ExportWorker, type ExportWorkerOptions } from \"./exportWorker.js\";\nimport {\n  installConsoleCapture,\n  installNestLoggerCapture,\n  installPinoCapture,\n  installWinstonCapture,\n} from \"./logCapture.js\";\nimport { logDebug, logError, logWarning } from \"./logger.js\";\nimport { ApitallyLogRecordExporter } from \"./logRecordExporter.js\";\nimport { ApitallyLogRecordProcessor } from \"./logRecordProcessor.js\";\nimport { MetricsPipeline } from \"./metrics.js\";\nimport { getDistroVersion } from \"./packageVersion.js\";\nimport {\n  createLoggerProvider,\n  resolveEnvAndCreateResource,\n  setupTracerProvider,\n} from \"./providers.js\";\nimport { Redaction } from \"./redaction.js\";\nimport { installSentryEventIdRecording } from \"./sentry.js\";\nimport { drainServerErrors, resetServerErrors, SERVER_ERROR_EVENT_NAME } from \"./serverErrors.js\";\nimport { ApitallySpanExporter } from \"./spanExporter.js\";\nimport {\n  isApitallySpanProcessorDeclared,\n  SpanPipeline,\n  setActiveSpanPipeline,\n  setServerSpanActivationCallback,\n} from \"./spanProcessor.js\";\nimport { Spool } from \"./spool.js\";\nimport { emitStartupEvent, type StartupEventInfo } from \"./startup.js\";\nimport {\n  drainValidationErrors,\n  resetValidationErrors,\n  VALIDATION_ERROR_EVENT_NAME,\n} from \"./validationErrors.js\";\n\n// The worker sends every 15 seconds, so batches only need to reach the spool\n// within that interval.\nconst BATCH_SCHEDULE_DELAY_MILLIS = 1_000;\nconst BATCH_EXPORT_TIMEOUT_MILLIS = 30_000;\nconst BATCH_MAX_QUEUE_SIZE = 2_048;\nconst BATCH_MAX_EXPORT_BATCH_SIZE = 512;\nconst BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE = 32;\nconst SIGNAL_FLUSH_TIMEOUT_MILLIS = 5_000;\n\ntype TerminationSignal = \"SIGTERM\" | \"SIGINT\";\ntype SignalListeners = Record<TerminationSignal, () => void>;\n\n// The ESM and CJS builds can load together, so a Symbol.for key gives both\n// copies the same activation state.\nconst ACTIVATION_STATE_KEY = Symbol.for(\"apitally.activation\");\n\ninterface ActivationState {\n  sdkVersion: string;\n  activationAttempted: boolean;\n  startupEventInfo?: StartupEventInfo;\n  handles?: ActivationHandles;\n  runShutdown?: () => Promise<void>;\n  shutdownPromise?: Promise<void>;\n  beforeExitListener?: () => void;\n  signalListeners?: SignalListeners;\n  signalDrainPromise?: Promise<void>;\n}\n\ninterface ActivationHandles {\n  spanPipeline: SpanPipeline;\n  tracerProvider?: NodeTracerProvider;\n  loggerProvider: LoggerProvider;\n  metricsPipeline: MetricsPipeline;\n  spool: Spool;\n  worker: ExportWorker;\n  undiciInstrumentation?: UndiciInstrumentation;\n}\n\n// Configuration stays synchronous; activate() defers timers and I/O.\nexport function configure(options: ApitallyOptions = {}): ApitallyConfig {\n  const config = setConfig(options);\n  // User instrumentations read this at initialization. `http/dup` adds stable\n  // HTTP attributes alongside legacy ones; a user-set value takes precedence.\n  if (!config.disabled && process.env.OTEL_SEMCONV_STABILITY_OPT_IN === undefined) {\n    process.env.OTEL_SEMCONV_STABILITY_OPT_IN = \"http/dup\";\n  }\n  setServerSpanActivationCallback(activate);\n  return config;\n}\n\n// The first integration registration wins so one process emits one startup event.\nexport function registerStartupEventInfo(info: StartupEventInfo): void {\n  const activationState = getActivationState();\n  activationState.startupEventInfo ??= info;\n}\n\n// Activation is synchronous and attempted once, so concurrent first requests\n// observe either no activation or completed activation.\nexport function activate(): void {\n  const activationState = getActivationState();\n  if (activationState.activationAttempted) {\n    return;\n  }\n  activationState.activationAttempted = true;\n  if (shouldSkipActivation()) {\n    return;\n  }\n  try {\n    const handles = startPipelines(activationState.startupEventInfo);\n    activationState.handles = handles;\n    activationState.runShutdown = () => drainAndStop(handles);\n    installBeforeExitHook(activationState);\n    installSignalHooks(activationState);\n  } catch (error) {\n    logError(`Apitally activation failed: ${String(error)}`);\n  }\n}\n\nexport function isActivated(): boolean {\n  return getActivationState().handles !== undefined;\n}\n\nexport function getActivationHandles(): ActivationHandles | undefined {\n  return getActivationState().handles;\n}\n\nexport async function flushTelemetry(): Promise<void> {\n  try {\n    await getActivationState().handles?.worker.runCycle();\n  } catch (error) {\n    logDebug(`Error flushing telemetry: ${String(error)}`);\n  }\n}\n\n// Concurrent calls and lifecycle hooks share one final drain; calls before\n// activation are no-ops.\nexport function shutdown(): Promise<void> {\n  const activationState = getActivationState();\n  const handles = activationState.handles;\n  const runShutdown = activationState.runShutdown;\n  if (!handles || !runShutdown) {\n    return Promise.resolve();\n  }\n  if (!activationState.shutdownPromise) {\n    removeLifecycleHooks(activationState);\n    const signalDrainPromise = activationState.signalDrainPromise;\n    activationState.shutdownPromise = (\n      signalDrainPromise\n        ? signalDrainPromise.then(() => handles.worker.waitForIdle())\n        : Promise.resolve()\n    ).then(runShutdown);\n  }\n  return activationState.shutdownPromise;\n}\n\n// Tests replace these factories to isolate spool files and worker timing.\nexport const activationFactories = {\n  createSpool: (): Spool => new Spool(),\n  createExportWorker: (options: ExportWorkerOptions): ExportWorker => new ExportWorker(options),\n};\nconst defaultFactories = { ...activationFactories };\n\n// Tests reset process-global activation and its side effects between cases.\nexport async function resetActivation(): Promise<void> {\n  Object.assign(activationFactories, defaultFactories);\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const activationState = holder[ACTIVATION_STATE_KEY];\n  delete holder[ACTIVATION_STATE_KEY];\n  hasWarnedAboutVersionSkew = false;\n  resetValidationErrors();\n  resetServerErrors();\n  if (!activationState) {\n    return;\n  }\n  removeLifecycleHooks(activationState);\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  handles.undiciInstrumentation?.disable();\n  await handles.worker.stop();\n  await handles.spanPipeline.shutdown();\n  await handles.loggerProvider.shutdown();\n  await handles.spool.clear();\n}\n\nlet hasWarnedAboutVersionSkew = false;\n\n// One root-context record per aggregate group, drained right before the log\n// processor flush so the records leave with the same export cycle.\nfunction emitErrorEvents(loggerProvider: LoggerProvider): void {\n  const logger = loggerProvider.getLogger(\"apitally\");\n  const events: [string, AnyValueMap[]][] = [\n    [VALIDATION_ERROR_EVENT_NAME, drainValidationErrors()],\n    [SERVER_ERROR_EVENT_NAME, drainServerErrors()],\n  ];\n  for (const [eventName, bodies] of events) {\n    for (const body of bodies) {\n      logger.emit({ timestamp: Date.now(), context: ROOT_CONTEXT, eventName, body });\n    }\n  }\n}\n\nfunction getActivationState(): ActivationState {\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const existing = holder[ACTIVATION_STATE_KEY];\n  if (existing) {\n    if (!hasWarnedAboutVersionSkew && existing.sdkVersion !== getDistroVersion()) {\n      hasWarnedAboutVersionSkew = true;\n      logWarning(\n        `Two copies of the apitally package with different versions (${existing.sdkVersion} and ${getDistroVersion()}) are loaded in this process; version ${existing.sdkVersion} stays active. To resolve this, deduplicate the apitally installation.`,\n      );\n    }\n    return existing;\n  }\n  const activationState: ActivationState = {\n    sdkVersion: getDistroVersion(),\n    activationAttempted: false,\n  };\n  holder[ACTIVATION_STATE_KEY] = activationState;\n  return activationState;\n}\n\nfunction shouldSkipActivation(): boolean {\n  return (\n    Boolean(process.env.JEST_WORKER_ID) ||\n    Boolean(process.env.VITEST) ||\n    process.env.NODE_ENV === \"test\" ||\n    getConfig().disabled\n  );\n}\n\nfunction startPipelines(startupEventInfo: StartupEventInfo | undefined): ActivationHandles {\n  const config = getConfig();\n  let hasUserProvider = isApitallySpanProcessorDeclared();\n  const { env, resource } = resolveEnvAndCreateResource();\n  const instanceId = resource.attributes[\"service.instance.id\"] as string;\n  const spool = activationFactories.createSpool();\n  const spanExporter = new ApitallySpanExporter({\n    redaction: new Redaction(),\n    env,\n    instanceId,\n    spool,\n    maskRequestBody: config.maskRequestBody,\n    maskResponseBody: config.maskResponseBody,\n  });\n  // Concrete options prevent OTel environment variables from changing batch\n  // behavior. Each processor gets a fresh object because its config is mutated.\n  const batchSpanProcessor = new BatchSpanProcessor(spanExporter, {\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize:\n      config.captureRequestBody || config.captureResponseBody\n        ? BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE\n        : BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const spanPipeline = new SpanPipeline(batchSpanProcessor, () => spanExporter.forceFlush());\n  let tracerProvider: NodeTracerProvider | undefined;\n  if (!hasUserProvider) {\n    tracerProvider = setupTracerProvider(resource, [spanPipeline]);\n    if (!tracerProvider) {\n      hasUserProvider = true;\n      logWarning(\n        \"Apitally could not register its OpenTelemetry tracer provider because another provider is already registered. Only metrics and the startup event are sent to Apitally until you add ApitallySpanProcessor (exported by the apitally package) to your tracer provider's spanProcessors constructor option or the NodeSDK spanProcessors option.\",\n      );\n    }\n  }\n  setActiveSpanPipeline(spanPipeline);\n  // BatchLogRecordProcessor requires its single-options-object form; positional\n  // arguments create a broken processor.\n  const batchLogProcessor = new BatchLogRecordProcessor({\n    exporter: new ApitallyLogRecordExporter(spool),\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize: BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const logRecordProcessor = new ApitallyLogRecordProcessor(\n    batchLogProcessor,\n    spanPipeline,\n    config.maskLogRecord,\n  );\n  const loggerProvider = createLoggerProvider(resource, [logRecordProcessor]);\n  const metricsPipeline = new MetricsPipeline(resource, spool);\n  spanPipeline.metricsRecorder = (record) => metricsPipeline.recordFromRequest(record);\n  const worker = activationFactories.createExportWorker({\n    spool,\n    otlpEndpoint: config.otlpEndpoint,\n    writeToken: config.writeToken,\n    env,\n  });\n  worker.flushCallbacks.push(\n    () => metricsPipeline.collectAndExport(),\n    () => spanPipeline.forceFlush(),\n    () => emitErrorEvents(loggerProvider),\n    () => batchLogProcessor.forceFlush(),\n  );\n  if (config.captureLogs) {\n    installConsoleCapture(loggerProvider);\n    installNestLoggerCapture(loggerProvider);\n    installWinstonCapture(loggerProvider);\n    installPinoCapture(loggerProvider);\n  }\n  installSentryEventIdRecording();\n  let undiciInstrumentation: UndiciInstrumentation | undefined;\n  if (!hasUserProvider) {\n    undiciInstrumentation = createUndiciInstrumentation(config.otlpEndpoint);\n  }\n  worker.start();\n  if (startupEventInfo) {\n    emitStartupEvent(loggerProvider, startupEventInfo);\n  }\n  return {\n    spanPipeline,\n    tracerProvider,\n    loggerProvider,\n    metricsPipeline,\n    spool,\n    worker,\n    undiciInstrumentation,\n  };\n}\n\n// ignoreRequestHook prevents telemetry for export POSTs. The request origin can\n// be a string or URL at runtime despite its string type.\nfunction createUndiciInstrumentation(otlpEndpoint: string): UndiciInstrumentation {\n  const endpointOrigin = new URL(otlpEndpoint).origin;\n  return new UndiciInstrumentation({\n    ignoreRequestHook: (request) => {\n      try {\n        return new URL(String(request.origin)).origin === endpointOrigin;\n      } catch {\n        return false;\n      }\n    },\n  });\n}\n\nasync function drainAndStop(handles: ActivationHandles): Promise<void> {\n  try {\n    await handles.spanPipeline.shutdown();\n    await handles.worker.finalDrain();\n    await handles.loggerProvider.shutdown();\n    await handles.worker.stop();\n  } catch (error) {\n    logWarning(`Error draining telemetry on shutdown: ${String(error)}`);\n  }\n}\n\nfunction installSignalHooks(activationState: ActivationState): void {\n  if (process.platform === \"win32\" || !isMainThread) {\n    return;\n  }\n  let listeners: SignalListeners;\n  listeners = {\n    SIGTERM: () => handleTerminationSignal(activationState, listeners, \"SIGTERM\"),\n    SIGINT: () => handleTerminationSignal(activationState, listeners, \"SIGINT\"),\n  };\n  activationState.signalListeners = listeners;\n  try {\n    process.prependOnceListener(\"SIGTERM\", listeners.SIGTERM);\n    process.prependOnceListener(\"SIGINT\", listeners.SIGINT);\n  } catch (error) {\n    removeSignalHooks(activationState, listeners);\n    logWarning(`Unable to install Apitally signal handlers: ${String(error)}`);\n  }\n}\n\nfunction handleTerminationSignal(\n  activationState: ActivationState,\n  listeners: SignalListeners,\n  signal: TerminationSignal,\n): void {\n  const hasApplicationListener = process\n    .listeners(signal)\n    .some((listener) => listener !== listeners[signal]);\n  removeSignalHooks(activationState, listeners);\n  const drainPromise = flushAfterTerminationSignal(activationState, signal, hasApplicationListener);\n  activationState.signalDrainPromise = drainPromise;\n  void drainPromise.catch((error: unknown) => {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  });\n}\n\nasync function flushAfterTerminationSignal(\n  activationState: ActivationState,\n  signal: TerminationSignal,\n  hasApplicationListener: boolean,\n): Promise<void> {\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  try {\n    if (activationState.shutdownPromise) {\n      await waitForSignalDeadline(activationState.shutdownPromise);\n    } else {\n      await handles.worker.finalDrain(SIGNAL_FLUSH_TIMEOUT_MILLIS);\n    }\n  } catch (error) {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  }\n  if (hasApplicationListener || process.listeners(signal).length > 0) {\n    return;\n  }\n  const exitCode = signal === \"SIGTERM\" ? 143 : 130;\n  if (process.platform === \"linux\" && process.pid === 1) {\n    process.exit(exitCode);\n  }\n  try {\n    process.kill(process.pid, signal);\n  } catch {\n    process.exit(exitCode);\n  }\n}\n\nasync function waitForSignalDeadline(promise: Promise<void>): Promise<void> {\n  let deadlineTimer: NodeJS.Timeout | undefined;\n  const deadlineReached = new Promise<void>((resolve) => {\n    deadlineTimer = setTimeout(resolve, SIGNAL_FLUSH_TIMEOUT_MILLIS);\n  });\n  try {\n    await Promise.race([promise, deadlineReached]);\n  } finally {\n    if (deadlineTimer) {\n      clearTimeout(deadlineTimer);\n    }\n  }\n}\n\nfunction removeSignalHooks(\n  activationState: ActivationState,\n  listeners = activationState.signalListeners,\n): void {\n  if (!listeners) {\n    return;\n  }\n  process.removeListener(\"SIGTERM\", listeners.SIGTERM);\n  process.removeListener(\"SIGINT\", listeners.SIGINT);\n  if (activationState.signalListeners === listeners) {\n    activationState.signalListeners = undefined;\n  }\n}\n\nfunction removeLifecycleHooks(activationState: ActivationState): void {\n  removeSignalHooks(activationState);\n  if (activationState.beforeExitListener) {\n    process.removeListener(\"beforeExit\", activationState.beforeExitListener);\n    activationState.beforeExitListener = undefined;\n  }\n}\n\nfunction installBeforeExitHook(activationState: ActivationState): void {\n  const listener = () => {\n    // The drain keeps the event loop alive until shutdown settles.\n    void shutdown().catch((error: unknown) => {\n      logDebug(`Error draining telemetry on shutdown: ${String(error)}`);\n    });\n  };\n  activationState.beforeExitListener = listener;\n  process.on(\"beforeExit\", listener);\n}\n"],"mappings":"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"}
+{"version":3,"file":"activation.js","names":[],"sources":["../src/activation.ts"],"sourcesContent":["import { isMainThread } from \"node:worker_threads\";\nimport { ROOT_CONTEXT } from \"@opentelemetry/api\";\nimport type { AnyValueMap } from \"@opentelemetry/api-logs\";\nimport { UndiciInstrumentation } from \"@opentelemetry/instrumentation-undici\";\nimport { BatchLogRecordProcessor, type LoggerProvider } from \"@opentelemetry/sdk-logs\";\nimport { BatchSpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport type { NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\nimport { type ApitallyConfig, type ApitallyOptions, getConfig, setConfig } from \"./config.js\";\nimport { ExportWorker, type ExportWorkerOptions } from \"./exportWorker.js\";\nimport {\n  installConsoleCapture,\n  installNestLoggerCapture,\n  installPinoCapture,\n  installWinstonCapture,\n} from \"./logCapture.js\";\nimport { logDebug, logError, logWarning } from \"./logger.js\";\nimport { ApitallyLogRecordExporter } from \"./logRecordExporter.js\";\nimport { ApitallyLogRecordProcessor } from \"./logRecordProcessor.js\";\nimport { MetricsPipeline } from \"./metrics.js\";\nimport { getDistroVersion } from \"./packageVersion.js\";\nimport {\n  createLoggerProvider,\n  resolveEnvAndCreateResource,\n  setupTracerProvider,\n} from \"./providers.js\";\nimport { Redaction } from \"./redaction.js\";\nimport { installSentryEventIdRecording } from \"./sentry.js\";\nimport { drainServerErrors, resetServerErrors, SERVER_ERROR_EVENT_NAME } from \"./serverErrors.js\";\nimport { ApitallySpanExporter } from \"./spanExporter.js\";\nimport {\n  isApitallySpanProcessorDeclared,\n  SpanPipeline,\n  setActiveSpanPipeline,\n  setServerSpanActivationCallback,\n} from \"./spanProcessor.js\";\nimport { Spool } from \"./spool.js\";\nimport { emitStartupEvent, type StartupEventInfo } from \"./startup.js\";\nimport {\n  drainValidationErrors,\n  resetValidationErrors,\n  VALIDATION_ERROR_EVENT_NAME,\n} from \"./validationErrors.js\";\n\n// The worker sends every 15 seconds, so batches only need to reach the spool\n// within that interval.\nconst BATCH_SCHEDULE_DELAY_MILLIS = 1_000;\nconst BATCH_EXPORT_TIMEOUT_MILLIS = 30_000;\nconst BATCH_MAX_QUEUE_SIZE = 2_048;\nconst BATCH_MAX_EXPORT_BATCH_SIZE = 512;\nconst BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE = 32;\nconst SIGNAL_FLUSH_TIMEOUT_MILLIS = 5_000;\n\ntype TerminationSignal = \"SIGTERM\" | \"SIGINT\";\ntype SignalListeners = Record<TerminationSignal, () => void>;\n\n// The ESM and CJS builds can load together, so a Symbol.for key gives both\n// copies the same activation state.\nconst ACTIVATION_STATE_KEY = Symbol.for(\"apitally.activation\");\n\ninterface ActivationState {\n  sdkVersion: string;\n  activationAttempted: boolean;\n  startupEventInfo?: StartupEventInfo;\n  handles?: ActivationHandles;\n  runShutdown?: () => Promise<void>;\n  shutdownPromise?: Promise<void>;\n  beforeExitListener?: () => void;\n  signalListeners?: SignalListeners;\n  signalDrainPromise?: Promise<void>;\n}\n\ninterface ActivationHandles {\n  spanPipeline: SpanPipeline;\n  tracerProvider?: NodeTracerProvider;\n  loggerProvider: LoggerProvider;\n  // Consumer identifier to the hash of its last emitted consumer update, in LRU order.\n  consumerUpdateHashes: Map<string, string>;\n  metricsPipeline: MetricsPipeline;\n  spool: Spool;\n  worker: ExportWorker;\n  undiciInstrumentation?: UndiciInstrumentation;\n}\n\n// Configuration stays synchronous; activate() defers timers and I/O.\nexport function configure(options: ApitallyOptions = {}): ApitallyConfig {\n  const config = setConfig(options);\n  // User instrumentations read this at initialization. `http/dup` adds stable\n  // HTTP attributes alongside legacy ones; a user-set value takes precedence.\n  if (!config.disabled && process.env.OTEL_SEMCONV_STABILITY_OPT_IN === undefined) {\n    process.env.OTEL_SEMCONV_STABILITY_OPT_IN = \"http/dup\";\n  }\n  setServerSpanActivationCallback(activate);\n  return config;\n}\n\n// The first integration registration wins so one process emits one startup event.\nexport function registerStartupEventInfo(info: StartupEventInfo): void {\n  const activationState = getActivationState();\n  activationState.startupEventInfo ??= info;\n}\n\n// Activation is synchronous and attempted once, so concurrent first requests\n// observe either no activation or completed activation.\nexport function activate(): void {\n  const activationState = getActivationState();\n  if (activationState.activationAttempted) {\n    return;\n  }\n  activationState.activationAttempted = true;\n  if (shouldSkipActivation()) {\n    return;\n  }\n  try {\n    const handles = startPipelines(activationState.startupEventInfo);\n    activationState.handles = handles;\n    activationState.runShutdown = () => drainAndStop(handles);\n    installBeforeExitHook(activationState);\n    installSignalHooks(activationState);\n  } catch (error) {\n    logError(`Apitally activation failed: ${String(error)}`);\n  }\n}\n\nexport function isActivated(): boolean {\n  return getActivationState().handles !== undefined;\n}\n\nexport function getActivationHandles(): ActivationHandles | undefined {\n  return getActivationState().handles;\n}\n\nexport async function flushTelemetry(): Promise<void> {\n  try {\n    await getActivationState().handles?.worker.runCycle();\n  } catch (error) {\n    logDebug(`Error flushing telemetry: ${String(error)}`);\n  }\n}\n\n// Concurrent calls and lifecycle hooks share one final drain; calls before\n// activation are no-ops.\nexport function shutdown(): Promise<void> {\n  const activationState = getActivationState();\n  const handles = activationState.handles;\n  const runShutdown = activationState.runShutdown;\n  if (!handles || !runShutdown) {\n    return Promise.resolve();\n  }\n  if (!activationState.shutdownPromise) {\n    removeLifecycleHooks(activationState);\n    const signalDrainPromise = activationState.signalDrainPromise;\n    activationState.shutdownPromise = (\n      signalDrainPromise\n        ? signalDrainPromise.then(() => handles.worker.waitForIdle())\n        : Promise.resolve()\n    ).then(runShutdown);\n  }\n  return activationState.shutdownPromise;\n}\n\n// Tests replace these factories to isolate spool files and worker timing.\nexport const activationFactories = {\n  createSpool: (): Spool => new Spool(),\n  createExportWorker: (options: ExportWorkerOptions): ExportWorker => new ExportWorker(options),\n};\nconst defaultFactories = { ...activationFactories };\n\n// Tests reset process-global activation and its side effects between cases.\nexport async function resetActivation(): Promise<void> {\n  Object.assign(activationFactories, defaultFactories);\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const activationState = holder[ACTIVATION_STATE_KEY];\n  delete holder[ACTIVATION_STATE_KEY];\n  hasWarnedAboutVersionSkew = false;\n  resetValidationErrors();\n  resetServerErrors();\n  if (!activationState) {\n    return;\n  }\n  removeLifecycleHooks(activationState);\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  handles.undiciInstrumentation?.disable();\n  await handles.worker.stop();\n  await handles.spanPipeline.shutdown();\n  await handles.loggerProvider.shutdown();\n  await handles.spool.clear();\n}\n\nlet hasWarnedAboutVersionSkew = false;\n\n// One root-context record per aggregate group, drained right before the log\n// processor flush so the records leave with the same export cycle.\nfunction emitErrorEvents(loggerProvider: LoggerProvider): void {\n  const logger = loggerProvider.getLogger(\"apitally\");\n  const events: [string, AnyValueMap[]][] = [\n    [VALIDATION_ERROR_EVENT_NAME, drainValidationErrors()],\n    [SERVER_ERROR_EVENT_NAME, drainServerErrors()],\n  ];\n  for (const [eventName, bodies] of events) {\n    for (const body of bodies) {\n      logger.emit({ timestamp: Date.now(), context: ROOT_CONTEXT, eventName, body });\n    }\n  }\n}\n\nfunction getActivationState(): ActivationState {\n  const holder = globalThis as Record<symbol, ActivationState | undefined>;\n  const existing = holder[ACTIVATION_STATE_KEY];\n  if (existing) {\n    if (!hasWarnedAboutVersionSkew && existing.sdkVersion !== getDistroVersion()) {\n      hasWarnedAboutVersionSkew = true;\n      logWarning(\n        `Two copies of the apitally package with different versions (${existing.sdkVersion} and ${getDistroVersion()}) are loaded in this process; version ${existing.sdkVersion} stays active. To resolve this, deduplicate the apitally installation.`,\n      );\n    }\n    return existing;\n  }\n  const activationState: ActivationState = {\n    sdkVersion: getDistroVersion(),\n    activationAttempted: false,\n  };\n  holder[ACTIVATION_STATE_KEY] = activationState;\n  return activationState;\n}\n\nfunction shouldSkipActivation(): boolean {\n  return (\n    Boolean(process.env.JEST_WORKER_ID) ||\n    Boolean(process.env.VITEST) ||\n    process.env.NODE_ENV === \"test\" ||\n    getConfig().disabled\n  );\n}\n\nfunction startPipelines(startupEventInfo: StartupEventInfo | undefined): ActivationHandles {\n  const config = getConfig();\n  let hasUserProvider = isApitallySpanProcessorDeclared();\n  const { env, resource } = resolveEnvAndCreateResource();\n  const instanceId = resource.attributes[\"service.instance.id\"] as string;\n  const spool = activationFactories.createSpool();\n  const spanExporter = new ApitallySpanExporter({\n    redaction: new Redaction(),\n    env,\n    instanceId,\n    spool,\n    maskRequestBody: config.maskRequestBody,\n    maskResponseBody: config.maskResponseBody,\n  });\n  // Concrete options prevent OTel environment variables from changing batch\n  // behavior. Each processor gets a fresh object because its config is mutated.\n  const batchSpanProcessor = new BatchSpanProcessor(spanExporter, {\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize:\n      config.captureRequestBody || config.captureResponseBody\n        ? BATCH_MAX_EXPORT_BATCH_SIZE_WITH_BODY_CAPTURE\n        : BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const spanPipeline = new SpanPipeline(batchSpanProcessor, () => spanExporter.forceFlush());\n  let tracerProvider: NodeTracerProvider | undefined;\n  if (!hasUserProvider) {\n    tracerProvider = setupTracerProvider(resource, [spanPipeline]);\n    if (!tracerProvider) {\n      hasUserProvider = true;\n      logWarning(\n        \"Apitally could not register its OpenTelemetry tracer provider because another provider is already registered. Only metrics and the startup event are sent to Apitally until you add ApitallySpanProcessor (exported by the apitally package) to your tracer provider's spanProcessors constructor option or the NodeSDK spanProcessors option.\",\n      );\n    }\n  }\n  setActiveSpanPipeline(spanPipeline);\n  // BatchLogRecordProcessor requires its single-options-object form; positional\n  // arguments create a broken processor.\n  const batchLogProcessor = new BatchLogRecordProcessor({\n    exporter: new ApitallyLogRecordExporter(spool),\n    scheduledDelayMillis: BATCH_SCHEDULE_DELAY_MILLIS,\n    exportTimeoutMillis: BATCH_EXPORT_TIMEOUT_MILLIS,\n    maxQueueSize: BATCH_MAX_QUEUE_SIZE,\n    maxExportBatchSize: BATCH_MAX_EXPORT_BATCH_SIZE,\n  });\n  const logRecordProcessor = new ApitallyLogRecordProcessor(\n    batchLogProcessor,\n    spanPipeline,\n    config.maskLogRecord,\n  );\n  const loggerProvider = createLoggerProvider(resource, [logRecordProcessor]);\n  const metricsPipeline = new MetricsPipeline(resource, spool);\n  spanPipeline.metricsRecorder = (record) => metricsPipeline.recordFromRequest(record);\n  const worker = activationFactories.createExportWorker({\n    spool,\n    otlpEndpoint: config.otlpEndpoint,\n    writeToken: config.writeToken,\n    env,\n  });\n  worker.flushCallbacks.push(\n    () => metricsPipeline.collectAndExport(),\n    () => spanPipeline.forceFlush(),\n    () => emitErrorEvents(loggerProvider),\n    () => batchLogProcessor.forceFlush(),\n  );\n  if (config.captureLogs) {\n    installConsoleCapture(loggerProvider);\n    installNestLoggerCapture(loggerProvider);\n    installWinstonCapture(loggerProvider);\n    installPinoCapture(loggerProvider);\n  }\n  installSentryEventIdRecording();\n  let undiciInstrumentation: UndiciInstrumentation | undefined;\n  if (!hasUserProvider) {\n    undiciInstrumentation = createUndiciInstrumentation(config.otlpEndpoint);\n  }\n  worker.start();\n  if (startupEventInfo) {\n    emitStartupEvent(loggerProvider, startupEventInfo);\n  }\n  return {\n    spanPipeline,\n    tracerProvider,\n    loggerProvider,\n    consumerUpdateHashes: new Map(),\n    metricsPipeline,\n    spool,\n    worker,\n    undiciInstrumentation,\n  };\n}\n\n// ignoreRequestHook prevents telemetry for export POSTs. The request origin can\n// be a string or URL at runtime despite its string type.\nfunction createUndiciInstrumentation(otlpEndpoint: string): UndiciInstrumentation {\n  const endpointOrigin = new URL(otlpEndpoint).origin;\n  return new UndiciInstrumentation({\n    ignoreRequestHook: (request) => {\n      try {\n        return new URL(String(request.origin)).origin === endpointOrigin;\n      } catch {\n        return false;\n      }\n    },\n  });\n}\n\nasync function drainAndStop(handles: ActivationHandles): Promise<void> {\n  try {\n    await handles.spanPipeline.shutdown();\n    await handles.worker.finalDrain();\n    await handles.loggerProvider.shutdown();\n    await handles.worker.stop();\n  } catch (error) {\n    logWarning(`Error draining telemetry on shutdown: ${String(error)}`);\n  }\n}\n\nfunction installSignalHooks(activationState: ActivationState): void {\n  if (process.platform === \"win32\" || !isMainThread) {\n    return;\n  }\n  let listeners: SignalListeners;\n  listeners = {\n    SIGTERM: () => handleTerminationSignal(activationState, listeners, \"SIGTERM\"),\n    SIGINT: () => handleTerminationSignal(activationState, listeners, \"SIGINT\"),\n  };\n  activationState.signalListeners = listeners;\n  try {\n    process.prependOnceListener(\"SIGTERM\", listeners.SIGTERM);\n    process.prependOnceListener(\"SIGINT\", listeners.SIGINT);\n  } catch (error) {\n    removeSignalHooks(activationState, listeners);\n    logWarning(`Unable to install Apitally signal handlers: ${String(error)}`);\n  }\n}\n\nfunction handleTerminationSignal(\n  activationState: ActivationState,\n  listeners: SignalListeners,\n  signal: TerminationSignal,\n): void {\n  const hasApplicationListener = process\n    .listeners(signal)\n    .some((listener) => listener !== listeners[signal]);\n  removeSignalHooks(activationState, listeners);\n  const drainPromise = flushAfterTerminationSignal(activationState, signal, hasApplicationListener);\n  activationState.signalDrainPromise = drainPromise;\n  void drainPromise.catch((error: unknown) => {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  });\n}\n\nasync function flushAfterTerminationSignal(\n  activationState: ActivationState,\n  signal: TerminationSignal,\n  hasApplicationListener: boolean,\n): Promise<void> {\n  const handles = activationState.handles;\n  if (!handles) {\n    return;\n  }\n  try {\n    if (activationState.shutdownPromise) {\n      await waitForSignalDeadline(activationState.shutdownPromise);\n    } else {\n      await handles.worker.finalDrain(SIGNAL_FLUSH_TIMEOUT_MILLIS);\n    }\n  } catch (error) {\n    logDebug(`Error flushing telemetry on ${signal}: ${String(error)}`);\n  }\n  if (hasApplicationListener || process.listeners(signal).length > 0) {\n    return;\n  }\n  const exitCode = signal === \"SIGTERM\" ? 143 : 130;\n  if (process.platform === \"linux\" && process.pid === 1) {\n    process.exit(exitCode);\n  }\n  try {\n    process.kill(process.pid, signal);\n  } catch {\n    process.exit(exitCode);\n  }\n}\n\nasync function waitForSignalDeadline(promise: Promise<void>): Promise<void> {\n  let deadlineTimer: NodeJS.Timeout | undefined;\n  const deadlineReached = new Promise<void>((resolve) => {\n    deadlineTimer = setTimeout(resolve, SIGNAL_FLUSH_TIMEOUT_MILLIS);\n  });\n  try {\n    await Promise.race([promise, deadlineReached]);\n  } finally {\n    if (deadlineTimer) {\n      clearTimeout(deadlineTimer);\n    }\n  }\n}\n\nfunction removeSignalHooks(\n  activationState: ActivationState,\n  listeners = activationState.signalListeners,\n): void {\n  if (!listeners) {\n    return;\n  }\n  process.removeListener(\"SIGTERM\", listeners.SIGTERM);\n  process.removeListener(\"SIGINT\", listeners.SIGINT);\n  if (activationState.signalListeners === listeners) {\n    activationState.signalListeners = undefined;\n  }\n}\n\nfunction removeLifecycleHooks(activationState: ActivationState): void {\n  removeSignalHooks(activationState);\n  if (activationState.beforeExitListener) {\n    process.removeListener(\"beforeExit\", activationState.beforeExitListener);\n    activationState.beforeExitListener = undefined;\n  }\n}\n\nfunction installBeforeExitHook(activationState: ActivationState): void {\n  const listener = () => {\n    // The drain keeps the event loop alive until shutdown settles.\n    void shutdown().catch((error: unknown) => {\n      logDebug(`Error draining telemetry on shutdown: ${String(error)}`);\n    });\n  };\n  activationState.beforeExitListener = listener;\n  process.on(\"beforeExit\", listener);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA6CA,MAAM,8BAA8B;AACpC,MAAM,8BAA8B;AACpC,MAAM,uBAAuB;AAC7B,MAAM,8BAA8B;AACpC,MAAM,gDAAgD;AACtD,MAAM,8BAA8B;AAOpC,MAAM,uBAAuB,OAAO,IAAI,qBAAqB;AA2B7D,SAAgB,UAAU,UAA2B,CAAC,GAAmB;CACvE,MAAM,SAAS,UAAU,OAAO;CAGhC,IAAI,CAAC,OAAO,YAAY,QAAQ,IAAI,kCAAkC,KAAA,GACpE,QAAQ,IAAI,gCAAgC;CAE9C,gCAAgC,QAAQ;CACxC,OAAO;AACT;AAGA,SAAgB,yBAAyB,MAA8B;CACrE,MAAM,kBAAkB,mBAAmB;CAC3C,gBAAgB,qBAAqB;AACvC;AAIA,SAAgB,WAAiB;CAC/B,MAAM,kBAAkB,mBAAmB;CAC3C,IAAI,gBAAgB,qBAClB;CAEF,gBAAgB,sBAAsB;CACtC,IAAI,qBAAqB,GACvB;CAEF,IAAI;EACF,MAAM,UAAU,eAAe,gBAAgB,gBAAgB;EAC/D,gBAAgB,UAAU;EAC1B,gBAAgB,oBAAoB,aAAa,OAAO;EACxD,sBAAsB,eAAe;EACrC,mBAAmB,eAAe;CACpC,SAAS,OAAO;EACd,SAAS,+BAA+B,OAAO,KAAK,GAAG;CACzD;AACF;AAEA,SAAgB,cAAuB;CACrC,OAAO,mBAAmB,CAAC,CAAC,YAAY,KAAA;AAC1C;AAEA,SAAgB,uBAAsD;CACpE,OAAO,mBAAmB,CAAC,CAAC;AAC9B;AAEA,eAAsB,iBAAgC;CACpD,IAAI;EACF,MAAM,mBAAmB,CAAC,CAAC,SAAS,OAAO,SAAS;CACtD,SAAS,OAAO;EACd,SAAS,6BAA6B,OAAO,KAAK,GAAG;CACvD;AACF;AAIA,SAAgB,WAA0B;CACxC,MAAM,kBAAkB,mBAAmB;CAC3C,MAAM,UAAU,gBAAgB;CAChC,MAAM,cAAc,gBAAgB;CACpC,IAAI,CAAC,WAAW,CAAC,aACf,OAAO,QAAQ,QAAQ;CAEzB,IAAI,CAAC,gBAAgB,iBAAiB;EACpC,qBAAqB,eAAe;EACpC,MAAM,qBAAqB,gBAAgB;EAC3C,gBAAgB,mBACd,qBACI,mBAAmB,WAAW,QAAQ,OAAO,YAAY,CAAC,IAC1D,QAAQ,QAAQ,EAAA,CACpB,KAAK,WAAW;CACpB;CACA,OAAO,gBAAgB;AACzB;AAGA,MAAa,sBAAsB;CACjC,mBAA0B,IAAI,MAAM;CACpC,qBAAqB,YAA+C,IAAI,aAAa,OAAO;AAC9F;AACA,MAAM,mBAAmB,EAAE,GAAG,oBAAoB;AAGlD,eAAsB,kBAAiC;CACrD,OAAO,OAAO,qBAAqB,gBAAgB;CACnD,MAAM,SAAS;CACf,MAAM,kBAAkB,OAAO;CAC/B,OAAO,OAAO;CACd,4BAA4B;CAC5B,sBAAsB;CACtB,kBAAkB;CAClB,IAAI,CAAC,iBACH;CAEF,qBAAqB,eAAe;CACpC,MAAM,UAAU,gBAAgB;CAChC,IAAI,CAAC,SACH;CAEF,QAAQ,uBAAuB,QAAQ;CACvC,MAAM,QAAQ,OAAO,KAAK;CAC1B,MAAM,QAAQ,aAAa,SAAS;CACpC,MAAM,QAAQ,eAAe,SAAS;CACtC,MAAM,QAAQ,MAAM,MAAM;AAC5B;AAEA,IAAI,4BAA4B;AAIhC,SAAS,gBAAgB,gBAAsC;CAC7D,MAAM,SAAS,eAAe,UAAU,UAAU;CAClD,MAAM,SAAoC,CACxC,CAAC,6BAA6B,sBAAsB,CAAC,GACrD,CAAC,yBAAyB,kBAAkB,CAAC,CAC/C;CACA,KAAK,MAAM,CAAC,WAAW,WAAW,QAChC,KAAK,MAAM,QAAQ,QACjB,OAAO,KAAK;EAAE,WAAW,KAAK,IAAI;EAAG,SAAS;EAAc;EAAW;CAAK,CAAC;AAGnF;AAEA,SAAS,qBAAsC;CAC7C,MAAM,SAAS;CACf,MAAM,WAAW,OAAO;CACxB,IAAI,UAAU;EACZ,IAAI,CAAC,6BAA6B,SAAS,eAAe,iBAAiB,GAAG;GAC5E,4BAA4B;GAC5B,WACE,+DAA+D,SAAS,WAAW,OAAO,iBAAiB,EAAE,wCAAwC,SAAS,WAAW,uEAC3K;EACF;EACA,OAAO;CACT;CACA,MAAM,kBAAmC;EACvC,YAAY,iBAAiB;EAC7B,qBAAqB;CACvB;CACA,OAAO,wBAAwB;CAC/B,OAAO;AACT;AAEA,SAAS,uBAAgC;CACvC,OACE,QAAQ,QAAQ,IAAI,cAAc,KAClC,QAAQ,QAAQ,IAAI,MAAM,KAC1B,QAAQ,IAAI,aAAa,UACzB,UAAU,CAAC,CAAC;AAEhB;AAEA,SAAS,eAAe,kBAAmE;CACzF,MAAM,SAAS,UAAU;CACzB,IAAI,kBAAkB,gCAAgC;CACtD,MAAM,EAAE,KAAK,aAAa,4BAA4B;CACtD,MAAM,aAAa,SAAS,WAAW;CACvC,MAAM,QAAQ,oBAAoB,YAAY;CAC9C,MAAM,eAAe,IAAI,qBAAqB;EAC5C,WAAW,IAAI,UAAU;EACzB;EACA;EACA;EACA,iBAAiB,OAAO;EACxB,kBAAkB,OAAO;CAC3B,CAAC;CAGD,MAAM,qBAAqB,IAAI,mBAAmB,cAAc;EAC9D,sBAAsB;EACtB,qBAAqB;EACrB,cAAc;EACd,oBACE,OAAO,sBAAsB,OAAO,sBAChC,gDACA;CACR,CAAC;CACD,MAAM,eAAe,IAAI,aAAa,0BAA0B,aAAa,WAAW,CAAC;CACzF,IAAI;CACJ,IAAI,CAAC,iBAAiB;EACpB,iBAAiB,oBAAoB,UAAU,CAAC,YAAY,CAAC;EAC7D,IAAI,CAAC,gBAAgB;GACnB,kBAAkB;GAClB,WACE,gVACF;EACF;CACF;CACA,sBAAsB,YAAY;CAGlC,MAAM,oBAAoB,IAAI,wBAAwB;EACpD,UAAU,IAAI,0BAA0B,KAAK;EAC7C,sBAAsB;EACtB,qBAAqB;EACrB,cAAc;EACd,oBAAoB;CACtB,CAAC;CACD,MAAM,qBAAqB,IAAI,2BAC7B,mBACA,cACA,OAAO,aACT;CACA,MAAM,iBAAiB,qBAAqB,UAAU,CAAC,kBAAkB,CAAC;CAC1E,MAAM,kBAAkB,IAAI,gBAAgB,UAAU,KAAK;CAC3D,aAAa,mBAAmB,WAAW,gBAAgB,kBAAkB,MAAM;CACnF,MAAM,SAAS,oBAAoB,mBAAmB;EACpD;EACA,cAAc,OAAO;EACrB,YAAY,OAAO;EACnB;CACF,CAAC;CACD,OAAO,eAAe,WACd,gBAAgB,iBAAiB,SACjC,aAAa,WAAW,SACxB,gBAAgB,cAAc,SAC9B,kBAAkB,WAAW,CACrC;CACA,IAAI,OAAO,aAAa;EACtB,sBAAsB,cAAc;EACpC,yBAAyB,cAAc;EACvC,sBAAsB,cAAc;EACpC,mBAAmB,cAAc;CACnC;CACA,8BAA8B;CAC9B,IAAI;CACJ,IAAI,CAAC,iBACH,wBAAwB,4BAA4B,OAAO,YAAY;CAEzE,OAAO,MAAM;CACb,IAAI,kBACF,iBAAiB,gBAAgB,gBAAgB;CAEnD,OAAO;EACL;EACA;EACA;EACA,sCAAsB,IAAI,IAAI;EAC9B;EACA;EACA;EACA;CACF;AACF;AAIA,SAAS,4BAA4B,cAA6C;CAChF,MAAM,iBAAiB,IAAI,IAAI,YAAY,CAAC,CAAC;CAC7C,OAAO,IAAI,sBAAsB,EAC/B,oBAAoB,YAAY;EAC9B,IAAI;GACF,OAAO,IAAI,IAAI,OAAO,QAAQ,MAAM,CAAC,CAAC,CAAC,WAAW;EACpD,QAAQ;GACN,OAAO;EACT;CACF,EACF,CAAC;AACH;AAEA,eAAe,aAAa,SAA2C;CACrE,IAAI;EACF,MAAM,QAAQ,aAAa,SAAS;EACpC,MAAM,QAAQ,OAAO,WAAW;EAChC,MAAM,QAAQ,eAAe,SAAS;EACtC,MAAM,QAAQ,OAAO,KAAK;CAC5B,SAAS,OAAO;EACd,WAAW,yCAAyC,OAAO,KAAK,GAAG;CACrE;AACF;AAEA,SAAS,mBAAmB,iBAAwC;CAClE,IAAI,QAAQ,aAAa,WAAW,CAAC,cACnC;CAEF,IAAI,YACQ;EACV,eAAe,wBAAwB,iBAAiB,WAAW,SAAS;EAC5E,cAAc,wBAAwB,iBAAiB,WAAW,QAAQ;CAC5E;CACA,gBAAgB,kBAAkB;CAClC,IAAI;EACF,QAAQ,oBAAoB,WAAW,UAAU,OAAO;EACxD,QAAQ,oBAAoB,UAAU,UAAU,MAAM;CACxD,SAAS,OAAO;EACd,kBAAkB,iBAAiB,SAAS;EAC5C,WAAW,+CAA+C,OAAO,KAAK,GAAG;CAC3E;AACF;AAEA,SAAS,wBACP,iBACA,WACA,QACM;CACN,MAAM,yBAAyB,QAC5B,UAAU,MAAM,CAAC,CACjB,MAAM,aAAa,aAAa,UAAU,OAAO;CACpD,kBAAkB,iBAAiB,SAAS;CAC5C,MAAM,eAAe,4BAA4B,iBAAiB,QAAQ,sBAAsB;CAChG,gBAAgB,qBAAqB;CACrC,aAAkB,OAAO,UAAmB;EAC1C,SAAS,+BAA+B,OAAO,IAAI,OAAO,KAAK,GAAG;CACpE,CAAC;AACH;AAEA,eAAe,4BACb,iBACA,QACA,wBACe;CACf,MAAM,UAAU,gBAAgB;CAChC,IAAI,CAAC,SACH;CAEF,IAAI;EACF,IAAI,gBAAgB,iBAClB,MAAM,sBAAsB,gBAAgB,eAAe;OAE3D,MAAM,QAAQ,OAAO,WAAW,2BAA2B;CAE/D,SAAS,OAAO;EACd,SAAS,+BAA+B,OAAO,IAAI,OAAO,KAAK,GAAG;CACpE;CACA,IAAI,0BAA0B,QAAQ,UAAU,MAAM,CAAC,CAAC,SAAS,GAC/D;CAEF,MAAM,WAAW,WAAW,YAAY,MAAM;CAC9C,IAAI,QAAQ,aAAa,WAAW,QAAQ,QAAQ,GAClD,QAAQ,KAAK,QAAQ;CAEvB,IAAI;EACF,QAAQ,KAAK,QAAQ,KAAK,MAAM;CAClC,QAAQ;EACN,QAAQ,KAAK,QAAQ;CACvB;AACF;AAEA,eAAe,sBAAsB,SAAuC;CAC1E,IAAI;CACJ,MAAM,kBAAkB,IAAI,SAAe,YAAY;EACrD,gBAAgB,WAAW,SAAS,2BAA2B;CACjE,CAAC;CACD,IAAI;EACF,MAAM,QAAQ,KAAK,CAAC,SAAS,eAAe,CAAC;CAC/C,UAAU;EACR,IAAI,eACF,aAAa,aAAa;CAE9B;AACF;AAEA,SAAS,kBACP,iBACA,YAAY,gBAAgB,iBACtB;CACN,IAAI,CAAC,WACH;CAEF,QAAQ,eAAe,WAAW,UAAU,OAAO;CACnD,QAAQ,eAAe,UAAU,UAAU,MAAM;CACjD,IAAI,gBAAgB,oBAAoB,WACtC,gBAAgB,kBAAkB,KAAA;AAEtC;AAEA,SAAS,qBAAqB,iBAAwC;CACpE,kBAAkB,eAAe;CACjC,IAAI,gBAAgB,oBAAoB;EACtC,QAAQ,eAAe,cAAc,gBAAgB,kBAAkB;EACvE,gBAAgB,qBAAqB,KAAA;CACvC;AACF;AAEA,SAAS,sBAAsB,iBAAwC;CACrE,MAAM,iBAAiB;EAErB,SAAc,CAAC,CAAC,OAAO,UAAmB;GACxC,SAAS,yCAAyC,OAAO,KAAK,GAAG;EACnE,CAAC;CACH;CACA,gBAAgB,qBAAqB;CACrC,QAAQ,GAAG,cAAc,QAAQ;AACnC"}

package/dist/consumers.cjs

@@ -0,0 +1,96 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_logger = require("./logger.cjs");
+const require_context = require("./context.cjs");
+const require_requestAttributes = require("./requestAttributes.cjs");
+const require_activation = require("./activation.cjs");
+let _opentelemetry_api = require("@opentelemetry/api");
+let node_crypto = require("node:crypto");
+//#region src/consumers.ts
+const MAX_CACHED_CONSUMERS = 1e4;
+const CONSUMER_IDENTIFIER_ATTRIBUTE = "apitally.consumer.identifier";
+const CONSUMER_UPDATE_EVENT_NAME = "apitally.consumer.update";
+const MAX_ATTRIBUTES_PER_UPDATE = 10;
+function setConsumer(consumer) {
+	try {
+		const record = require_context.getRequestRecord();
+		const normalized = normalizeConsumer(consumer);
+		if (!record || !normalized) return;
+		const { identifier } = normalized;
+		const current = record.consumer?.identifier === identifier ? record.consumer : {
+			identifier,
+			attributes: /* @__PURE__ */ new Map()
+		};
+		record.consumer = current;
+		current.name = normalized.name ?? current.name;
+		current.group = normalized.group ?? current.group;
+		if (typeof consumer === "object" && consumer?.attributes) for (const [rawKey, rawValue] of Object.entries(consumer.attributes)) {
+			if (rawValue !== null && typeof rawValue !== "string" && typeof rawValue !== "number" && typeof rawValue !== "boolean") continue;
+			const key = rawKey.trim();
+			const value = rawValue === null ? null : String(rawValue).trim() || null;
+			if (key.length > 0 && key.length <= 64 && (value?.length ?? 0) <= 1024) current.attributes.set(key, value);
+		}
+		require_requestAttributes.writeRequestAttribute(require_context.getServerSpan(), record, CONSUMER_IDENTIFIER_ATTRIBUTE, identifier);
+	} catch (error) {
+		require_logger.logDebug(`Error setting consumer: ${String(error)}`);
+	}
+}
+function emitConsumerUpdateIfChanged(record) {
+	try {
+		const consumer = record.consumer;
+		if (!consumer || !consumer.name && !consumer.group && consumer.attributes.size === 0) return;
+		const handles = require_activation.getActivationHandles();
+		if (!handles) return;
+		const attributes = [...consumer.attributes].slice(0, MAX_ATTRIBUTES_PER_UPDATE);
+		const sortedAttributes = [...attributes].sort(([a], [b]) => a < b ? -1 : 1);
+		const hash = (0, node_crypto.createHash)("sha256").update(JSON.stringify([
+			consumer.name ?? null,
+			consumer.group ?? null,
+			sortedAttributes
+		])).digest("base64");
+		const hashes = handles.consumerUpdateHashes;
+		const previousHash = hashes.get(consumer.identifier);
+		hashes.delete(consumer.identifier);
+		hashes.set(consumer.identifier, hash);
+		if (hashes.size > 1e4) hashes.delete(hashes.keys().next().value);
+		if (hash === previousHash) return;
+		const body = { identifier: consumer.identifier };
+		if (consumer.name) body.name = consumer.name;
+		if (consumer.group) body.group = consumer.group;
+		if (attributes.length > 0) body.attributes = Object.fromEntries(attributes);
+		handles.loggerProvider.getLogger("apitally").emit({
+			timestamp: Date.now(),
+			context: _opentelemetry_api.ROOT_CONTEXT,
+			eventName: CONSUMER_UPDATE_EVENT_NAME,
+			body
+		});
+	} catch (error) {
+		require_logger.logDebug(`Error emitting consumer update: ${String(error)}`);
+	}
+}
+function normalizeConsumer(consumer) {
+	if (typeof consumer === "object" && consumer !== null) {
+		const identifier = trimAndCap(consumer.identifier, 128);
+		if (!identifier) return;
+		return {
+			identifier,
+			name: trimAndCap(consumer.name, 64),
+			group: trimAndCap(consumer.group, 64)
+		};
+	}
+	const identifier = trimAndCap(consumer, 128);
+	return identifier ? {
+		identifier,
+		name: void 0,
+		group: void 0
+	} : void 0;
+}
+function trimAndCap(value, maxLength) {
+	if (typeof value !== "string" && typeof value !== "number") return;
+	return String(value).trim().slice(0, maxLength) || void 0;
+}
+//#endregion
+exports.MAX_CACHED_CONSUMERS = MAX_CACHED_CONSUMERS;
+exports.emitConsumerUpdateIfChanged = emitConsumerUpdateIfChanged;
+exports.setConsumer = setConsumer;
+
+//# sourceMappingURL=consumers.cjs.map

package/dist/consumers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumers.cjs","names":["getRequestRecord","getServerSpan","getActivationHandles","createHash","ROOT_CONTEXT"],"sources":["../src/consumers.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { ROOT_CONTEXT } from \"@opentelemetry/api\";\nimport type { AnyValueMap } from \"@opentelemetry/api-logs\";\nimport { getActivationHandles } from \"./activation.js\";\nimport { getRequestRecord, getServerSpan, type RequestRecord } from \"./context.js\";\nimport { logDebug } from \"./logger.js\";\nimport { writeRequestAttribute } from \"./requestAttributes.js\";\n\nexport interface ApitallyConsumer {\n  identifier: string;\n  name?: string | null;\n  group?: string | null;\n  // A partial update: null deletes a key, and undefined leaves it unchanged.\n  attributes?: Record<string, string | number | boolean | null | undefined>;\n}\n\nexport const MAX_CACHED_CONSUMERS = 10_000;\n\nconst CONSUMER_IDENTIFIER_ATTRIBUTE = \"apitally.consumer.identifier\";\nconst CONSUMER_UPDATE_EVENT_NAME = \"apitally.consumer.update\";\nconst MAX_ATTRIBUTES_PER_UPDATE = 10;\n\n// Repeated calls for the same identifier merge; a different identifier starts over.\nexport function setConsumer(consumer: ApitallyConsumer | string | null | undefined): void {\n  try {\n    const record = getRequestRecord();\n    const normalized = normalizeConsumer(consumer);\n    if (!record || !normalized) {\n      return;\n    }\n    const { identifier } = normalized;\n    const current =\n      record.consumer?.identifier === identifier\n        ? record.consumer\n        : { identifier, attributes: new Map<string, string | null>() };\n    record.consumer = current;\n    current.name = normalized.name ?? current.name;\n    current.group = normalized.group ?? current.group;\n    if (typeof consumer === \"object\" && consumer?.attributes) {\n      for (const [rawKey, rawValue] of Object.entries(consumer.attributes)) {\n        if (\n          rawValue !== null &&\n          typeof rawValue !== \"string\" &&\n          typeof rawValue !== \"number\" &&\n          typeof rawValue !== \"boolean\"\n        ) {\n          continue;\n        }\n        const key = rawKey.trim();\n        const value = rawValue === null ? null : String(rawValue).trim() || null;\n        if (key.length > 0 && key.length <= 64 && (value?.length ?? 0) <= 1_024) {\n          current.attributes.set(key, value);\n        }\n      }\n    }\n    writeRequestAttribute(getServerSpan(), record, CONSUMER_IDENTIFIER_ATTRIBUTE, identifier);\n  } catch (error) {\n    logDebug(`Error setting consumer: ${String(error)}`);\n  }\n}\n\n// Consumer updates are emitted for every observed request, independent of\n// trace sampling and exclusion; an update identical to the last one sent is skipped.\nexport function emitConsumerUpdateIfChanged(record: RequestRecord): void {\n  try {\n    const consumer = record.consumer;\n    if (!consumer || (!consumer.name && !consumer.group && consumer.attributes.size === 0)) {\n      return;\n    }\n    const handles = getActivationHandles();\n    if (!handles) {\n      return;\n    }\n    const attributes = [...consumer.attributes].slice(0, MAX_ATTRIBUTES_PER_UPDATE);\n    const sortedAttributes = [...attributes].sort(([a], [b]) => (a < b ? -1 : 1));\n    const hash = createHash(\"sha256\")\n      .update(JSON.stringify([consumer.name ?? null, consumer.group ?? null, sortedAttributes]))\n      .digest(\"base64\");\n    // Map iteration follows insertion order, so re-inserting keeps the least\n    // recently used identifier first.\n    const hashes = handles.consumerUpdateHashes;\n    const previousHash = hashes.get(consumer.identifier);\n    hashes.delete(consumer.identifier);\n    hashes.set(consumer.identifier, hash);\n    if (hashes.size > MAX_CACHED_CONSUMERS) {\n      hashes.delete(hashes.keys().next().value as string);\n    }\n    if (hash === previousHash) {\n      return;\n    }\n    const body: AnyValueMap = { identifier: consumer.identifier };\n    if (consumer.name) {\n      body.name = consumer.name;\n    }\n    if (consumer.group) {\n      body.group = consumer.group;\n    }\n    if (attributes.length > 0) {\n      body.attributes = Object.fromEntries(attributes);\n    }\n    handles.loggerProvider.getLogger(\"apitally\").emit({\n      timestamp: Date.now(),\n      context: ROOT_CONTEXT,\n      eventName: CONSUMER_UPDATE_EVENT_NAME,\n      body,\n    });\n  } catch (error) {\n    logDebug(`Error emitting consumer update: ${String(error)}`);\n  }\n}\n\nfunction normalizeConsumer(consumer: ApitallyConsumer | string | number | null | undefined) {\n  if (typeof consumer === \"object\" && consumer !== null) {\n    const identifier = trimAndCap(consumer.identifier, 128);\n    if (!identifier) {\n      return undefined;\n    }\n    return {\n      identifier,\n      name: trimAndCap(consumer.name, 64),\n      group: trimAndCap(consumer.group, 64),\n    };\n  }\n  const identifier = trimAndCap(consumer, 128);\n  return identifier ? { identifier, name: undefined, group: undefined } : undefined;\n}\n\nfunction trimAndCap(value: unknown, maxLength: number): string | undefined {\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    return undefined;\n  }\n  return String(value).trim().slice(0, maxLength) || undefined;\n}\n"],"mappings":"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"}

package/dist/consumers.d.cts

@@ -0,0 +1,13 @@
+import { RequestRecord } from "./context.cjs";
+//#region src/consumers.d.ts
+export interface ApitallyConsumer {
+  identifier: string;
+  name?: string | null;
+  group?: string | null;
+  attributes?: Record<string, string | number | boolean | null | undefined>;
+}
+export declare const MAX_CACHED_CONSUMERS = 10000;
+export declare function setConsumer(consumer: ApitallyConsumer | string | null | undefined): void;
+export declare function emitConsumerUpdateIfChanged(record: RequestRecord): void;
+//#endregion
+//# sourceMappingURL=consumers.d.cts.map

package/dist/consumers.d.ts

@@ -0,0 +1,13 @@
+import { RequestRecord } from "./context.js";
+//#region src/consumers.d.ts
+export interface ApitallyConsumer {
+  identifier: string;
+  name?: string | null;
+  group?: string | null;
+  attributes?: Record<string, string | number | boolean | null | undefined>;
+}
+export declare const MAX_CACHED_CONSUMERS = 10000;
+export declare function setConsumer(consumer: ApitallyConsumer | string | null | undefined): void;
+export declare function emitConsumerUpdateIfChanged(record: RequestRecord): void;
+//#endregion
+//# sourceMappingURL=consumers.d.ts.map

package/dist/consumers.js

@@ -0,0 +1,93 @@
+import { logDebug } from "./logger.js";
+import { getRequestRecord, getServerSpan } from "./context.js";
+import { writeRequestAttribute } from "./requestAttributes.js";
+import { getActivationHandles } from "./activation.js";
+import { ROOT_CONTEXT } from "@opentelemetry/api";
+import { createHash } from "node:crypto";
+//#region src/consumers.ts
+const MAX_CACHED_CONSUMERS = 1e4;
+const CONSUMER_IDENTIFIER_ATTRIBUTE = "apitally.consumer.identifier";
+const CONSUMER_UPDATE_EVENT_NAME = "apitally.consumer.update";
+const MAX_ATTRIBUTES_PER_UPDATE = 10;
+function setConsumer(consumer) {
+	try {
+		const record = getRequestRecord();
+		const normalized = normalizeConsumer(consumer);
+		if (!record || !normalized) return;
+		const { identifier } = normalized;
+		const current = record.consumer?.identifier === identifier ? record.consumer : {
+			identifier,
+			attributes: /* @__PURE__ */ new Map()
+		};
+		record.consumer = current;
+		current.name = normalized.name ?? current.name;
+		current.group = normalized.group ?? current.group;
+		if (typeof consumer === "object" && consumer?.attributes) for (const [rawKey, rawValue] of Object.entries(consumer.attributes)) {
+			if (rawValue !== null && typeof rawValue !== "string" && typeof rawValue !== "number" && typeof rawValue !== "boolean") continue;
+			const key = rawKey.trim();
+			const value = rawValue === null ? null : String(rawValue).trim() || null;
+			if (key.length > 0 && key.length <= 64 && (value?.length ?? 0) <= 1024) current.attributes.set(key, value);
+		}
+		writeRequestAttribute(getServerSpan(), record, CONSUMER_IDENTIFIER_ATTRIBUTE, identifier);
+	} catch (error) {
+		logDebug(`Error setting consumer: ${String(error)}`);
+	}
+}
+function emitConsumerUpdateIfChanged(record) {
+	try {
+		const consumer = record.consumer;
+		if (!consumer || !consumer.name && !consumer.group && consumer.attributes.size === 0) return;
+		const handles = getActivationHandles();
+		if (!handles) return;
+		const attributes = [...consumer.attributes].slice(0, MAX_ATTRIBUTES_PER_UPDATE);
+		const sortedAttributes = [...attributes].sort(([a], [b]) => a < b ? -1 : 1);
+		const hash = createHash("sha256").update(JSON.stringify([
+			consumer.name ?? null,
+			consumer.group ?? null,
+			sortedAttributes
+		])).digest("base64");
+		const hashes = handles.consumerUpdateHashes;
+		const previousHash = hashes.get(consumer.identifier);
+		hashes.delete(consumer.identifier);
+		hashes.set(consumer.identifier, hash);
+		if (hashes.size > 1e4) hashes.delete(hashes.keys().next().value);
+		if (hash === previousHash) return;
+		const body = { identifier: consumer.identifier };
+		if (consumer.name) body.name = consumer.name;
+		if (consumer.group) body.group = consumer.group;
+		if (attributes.length > 0) body.attributes = Object.fromEntries(attributes);
+		handles.loggerProvider.getLogger("apitally").emit({
+			timestamp: Date.now(),
+			context: ROOT_CONTEXT,
+			eventName: CONSUMER_UPDATE_EVENT_NAME,
+			body
+		});
+	} catch (error) {
+		logDebug(`Error emitting consumer update: ${String(error)}`);
+	}
+}
+function normalizeConsumer(consumer) {
+	if (typeof consumer === "object" && consumer !== null) {
+		const identifier = trimAndCap(consumer.identifier, 128);
+		if (!identifier) return;
+		return {
+			identifier,
+			name: trimAndCap(consumer.name, 64),
+			group: trimAndCap(consumer.group, 64)
+		};
+	}
+	const identifier = trimAndCap(consumer, 128);
+	return identifier ? {
+		identifier,
+		name: void 0,
+		group: void 0
+	} : void 0;
+}
+function trimAndCap(value, maxLength) {
+	if (typeof value !== "string" && typeof value !== "number") return;
+	return String(value).trim().slice(0, maxLength) || void 0;
+}
+//#endregion
+export { MAX_CACHED_CONSUMERS, emitConsumerUpdateIfChanged, setConsumer };
+
+//# sourceMappingURL=consumers.js.map

package/dist/consumers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumers.js","names":[],"sources":["../src/consumers.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { ROOT_CONTEXT } from \"@opentelemetry/api\";\nimport type { AnyValueMap } from \"@opentelemetry/api-logs\";\nimport { getActivationHandles } from \"./activation.js\";\nimport { getRequestRecord, getServerSpan, type RequestRecord } from \"./context.js\";\nimport { logDebug } from \"./logger.js\";\nimport { writeRequestAttribute } from \"./requestAttributes.js\";\n\nexport interface ApitallyConsumer {\n  identifier: string;\n  name?: string | null;\n  group?: string | null;\n  // A partial update: null deletes a key, and undefined leaves it unchanged.\n  attributes?: Record<string, string | number | boolean | null | undefined>;\n}\n\nexport const MAX_CACHED_CONSUMERS = 10_000;\n\nconst CONSUMER_IDENTIFIER_ATTRIBUTE = \"apitally.consumer.identifier\";\nconst CONSUMER_UPDATE_EVENT_NAME = \"apitally.consumer.update\";\nconst MAX_ATTRIBUTES_PER_UPDATE = 10;\n\n// Repeated calls for the same identifier merge; a different identifier starts over.\nexport function setConsumer(consumer: ApitallyConsumer | string | null | undefined): void {\n  try {\n    const record = getRequestRecord();\n    const normalized = normalizeConsumer(consumer);\n    if (!record || !normalized) {\n      return;\n    }\n    const { identifier } = normalized;\n    const current =\n      record.consumer?.identifier === identifier\n        ? record.consumer\n        : { identifier, attributes: new Map<string, string | null>() };\n    record.consumer = current;\n    current.name = normalized.name ?? current.name;\n    current.group = normalized.group ?? current.group;\n    if (typeof consumer === \"object\" && consumer?.attributes) {\n      for (const [rawKey, rawValue] of Object.entries(consumer.attributes)) {\n        if (\n          rawValue !== null &&\n          typeof rawValue !== \"string\" &&\n          typeof rawValue !== \"number\" &&\n          typeof rawValue !== \"boolean\"\n        ) {\n          continue;\n        }\n        const key = rawKey.trim();\n        const value = rawValue === null ? null : String(rawValue).trim() || null;\n        if (key.length > 0 && key.length <= 64 && (value?.length ?? 0) <= 1_024) {\n          current.attributes.set(key, value);\n        }\n      }\n    }\n    writeRequestAttribute(getServerSpan(), record, CONSUMER_IDENTIFIER_ATTRIBUTE, identifier);\n  } catch (error) {\n    logDebug(`Error setting consumer: ${String(error)}`);\n  }\n}\n\n// Consumer updates are emitted for every observed request, independent of\n// trace sampling and exclusion; an update identical to the last one sent is skipped.\nexport function emitConsumerUpdateIfChanged(record: RequestRecord): void {\n  try {\n    const consumer = record.consumer;\n    if (!consumer || (!consumer.name && !consumer.group && consumer.attributes.size === 0)) {\n      return;\n    }\n    const handles = getActivationHandles();\n    if (!handles) {\n      return;\n    }\n    const attributes = [...consumer.attributes].slice(0, MAX_ATTRIBUTES_PER_UPDATE);\n    const sortedAttributes = [...attributes].sort(([a], [b]) => (a < b ? -1 : 1));\n    const hash = createHash(\"sha256\")\n      .update(JSON.stringify([consumer.name ?? null, consumer.group ?? null, sortedAttributes]))\n      .digest(\"base64\");\n    // Map iteration follows insertion order, so re-inserting keeps the least\n    // recently used identifier first.\n    const hashes = handles.consumerUpdateHashes;\n    const previousHash = hashes.get(consumer.identifier);\n    hashes.delete(consumer.identifier);\n    hashes.set(consumer.identifier, hash);\n    if (hashes.size > MAX_CACHED_CONSUMERS) {\n      hashes.delete(hashes.keys().next().value as string);\n    }\n    if (hash === previousHash) {\n      return;\n    }\n    const body: AnyValueMap = { identifier: consumer.identifier };\n    if (consumer.name) {\n      body.name = consumer.name;\n    }\n    if (consumer.group) {\n      body.group = consumer.group;\n    }\n    if (attributes.length > 0) {\n      body.attributes = Object.fromEntries(attributes);\n    }\n    handles.loggerProvider.getLogger(\"apitally\").emit({\n      timestamp: Date.now(),\n      context: ROOT_CONTEXT,\n      eventName: CONSUMER_UPDATE_EVENT_NAME,\n      body,\n    });\n  } catch (error) {\n    logDebug(`Error emitting consumer update: ${String(error)}`);\n  }\n}\n\nfunction normalizeConsumer(consumer: ApitallyConsumer | string | number | null | undefined) {\n  if (typeof consumer === \"object\" && consumer !== null) {\n    const identifier = trimAndCap(consumer.identifier, 128);\n    if (!identifier) {\n      return undefined;\n    }\n    return {\n      identifier,\n      name: trimAndCap(consumer.name, 64),\n      group: trimAndCap(consumer.group, 64),\n    };\n  }\n  const identifier = trimAndCap(consumer, 128);\n  return identifier ? { identifier, name: undefined, group: undefined } : undefined;\n}\n\nfunction trimAndCap(value: unknown, maxLength: number): string | undefined {\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    return undefined;\n  }\n  return String(value).trim().slice(0, maxLength) || undefined;\n}\n"],"mappings":"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"}

package/dist/context.cjs

@@ -4,10 +4,9 @@ let _opentelemetry_core = require("@opentelemetry/core");
 //#region src/context.ts
 const SPAN_HANDLE_KEY = (0, _opentelemetry_api.createContextKey)("apitally-span-handle");
 const REQUEST_RECORD_KEY = (0, _opentelemetry_api.createContextKey)("apitally-request-record");
-const CONSUMER_HOLDER_KEY = (0, _opentelemetry_api.createContextKey)("apitally-consumer-holder");
 const RPC_REQUEST_RECORD_KEY = Symbol.for("apitally.rpcRequestRecord");
-function withRequestHolders(baseContext, spanHandle, record, consumerHolder) {
-	return baseContext.setValue(SPAN_HANDLE_KEY, spanHandle).setValue(REQUEST_RECORD_KEY, record).setValue(CONSUMER_HOLDER_KEY, consumerHolder);
+function withRequestHolders(baseContext, spanHandle, record) {
+	return baseContext.setValue(SPAN_HANDLE_KEY, spanHandle).setValue(REQUEST_RECORD_KEY, record);
 }
 function attachRequestRecordToRpcMetadata(rpcMetadata, record) {
 	if (rpcMetadata) rpcMetadata[RPC_REQUEST_RECORD_KEY] = record;
@@ -21,15 +20,10 @@ function getRequestRecord(activeContext = _opentelemetry_api.context.active()) {
 	const rpcMetadata = (0, _opentelemetry_core.getRPCMetadata)(activeContext);
 	return activeContext.getValue(REQUEST_RECORD_KEY) ?? rpcMetadata?.[RPC_REQUEST_RECORD_KEY];
 }
-function getConsumerHolder(activeContext = _opentelemetry_api.context.active()) {
-	return activeContext.getValue(CONSUMER_HOLDER_KEY);
-}
 //#endregion
-exports.CONSUMER_HOLDER_KEY = CONSUMER_HOLDER_KEY;
 exports.REQUEST_RECORD_KEY = REQUEST_RECORD_KEY;
 exports.SPAN_HANDLE_KEY = SPAN_HANDLE_KEY;
 exports.attachRequestRecordToRpcMetadata = attachRequestRecordToRpcMetadata;
-exports.getConsumerHolder = getConsumerHolder;
 exports.getRequestRecord = getRequestRecord;
 exports.getServerSpan = getServerSpan;
 exports.withRequestHolders = withRequestHolders;

package/dist/context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"context.cjs","names":["createContextKey","context","getRPCMetadata","RPCType"],"sources":["../src/context.ts"],"sourcesContent":["import {\n  type Attributes,\n  type Context,\n  context,\n  createContextKey,\n  type Span,\n} from \"@opentelemetry/api\";\nimport { getRPCMetadata, type RPCMetadata, RPCType } from \"@opentelemetry/core\";\nimport type { ValidationErrorDetail } from \"./validationErrors.js\";\n\n// Write sites resolve the request's SERVER span through this handle: under a child\n// span, the active span is not the SERVER span, and OTel has no public upward walk.\nexport interface SpanHandle {\n  span?: Span;\n  // This set-once reference preserves lifecycle ownership if span later changes.\n  ownSpan?: Span;\n}\n\nexport interface ConsumerHolder {\n  identifier?: string;\n  name?: string;\n  group?: string;\n}\n\n// Requests dropped for these reasons are still counted in request metrics,\n// except preflight and websocket requests, which are never recorded.\nexport type RequestDropReason = \"excluded\" | \"method\" | \"scheme\" | \"sampled-out\";\n\n// Transport attributes are applied to exported spans last and used for metrics,\n// so transport values take precedence.\nexport interface RequestRecord {\n  attributes: Attributes;\n  serverSpanId?: string;\n  // Transport-measured request duration, set at completion; the duration\n  // histogram records it independent of span timing.\n  durationSeconds?: number;\n  dropReason?: RequestDropReason;\n  // Error state for the validation and server error events; it exists\n  // independently of the SERVER span and of the drop decision.\n  exception?: unknown;\n  validationErrors?: ValidationErrorDetail[];\n}\n\nexport const SPAN_HANDLE_KEY = createContextKey(\"apitally-span-handle\");\nexport const REQUEST_RECORD_KEY = createContextKey(\"apitally-request-record\");\nexport const CONSUMER_HOLDER_KEY = createContextKey(\"apitally-consumer-holder\");\n\nconst RPC_REQUEST_RECORD_KEY = Symbol.for(\"apitally.rpcRequestRecord\");\n\ntype RPCMetadataWithRequestRecord = RPCMetadata & {\n  [RPC_REQUEST_RECORD_KEY]?: RequestRecord;\n};\n\n// Mutable holders carry changing request state because OTel contexts are immutable.\nexport function withRequestHolders(\n  baseContext: Context,\n  spanHandle: SpanHandle,\n  record: RequestRecord,\n  consumerHolder: ConsumerHolder,\n): Context {\n  return baseContext\n    .setValue(SPAN_HANDLE_KEY, spanHandle)\n    .setValue(REQUEST_RECORD_KEY, record)\n    .setValue(CONSUMER_HOLDER_KEY, consumerHolder);\n}\n\nexport function attachRequestRecordToRpcMetadata(\n  rpcMetadata: RPCMetadata | undefined,\n  record: RequestRecord,\n): void {\n  if (rpcMetadata) {\n    (rpcMetadata as RPCMetadataWithRequestRecord)[RPC_REQUEST_RECORD_KEY] = record;\n  }\n}\n\nexport function getServerSpan(activeContext: Context = context.active()): Span | undefined {\n  const spanHandle = activeContext.getValue(SPAN_HANDLE_KEY) as SpanHandle | undefined;\n  const rpcMetadata = getRPCMetadata(activeContext) as RPCMetadataWithRequestRecord | undefined;\n  return (\n    spanHandle?.span ??\n    (rpcMetadata?.type === RPCType.HTTP && rpcMetadata[RPC_REQUEST_RECORD_KEY]\n      ? rpcMetadata.span\n      : undefined)\n  );\n}\n\nexport function getRequestRecord(\n  activeContext: Context = context.active(),\n): RequestRecord | undefined {\n  const rpcMetadata = getRPCMetadata(activeContext) as RPCMetadataWithRequestRecord | undefined;\n  return (\n    (activeContext.getValue(REQUEST_RECORD_KEY) as RequestRecord | undefined) ??\n    rpcMetadata?.[RPC_REQUEST_RECORD_KEY]\n  );\n}\n\nexport function getConsumerHolder(\n  activeContext: Context = context.active(),\n): ConsumerHolder | undefined {\n  return activeContext.getValue(CONSUMER_HOLDER_KEY) as ConsumerHolder | undefined;\n}\n"],"mappings":";;;;AA2CA,MAAa,mBAAA,GAAkBA,mBAAAA,iBAAAA,CAAiB,sBAAsB;AACtE,MAAa,sBAAA,GAAqBA,mBAAAA,iBAAAA,CAAiB,yBAAyB;AAC5E,MAAa,uBAAA,GAAsBA,mBAAAA,iBAAAA,CAAiB,0BAA0B;AAE9E,MAAM,yBAAyB,OAAO,IAAI,2BAA2B;AAOrE,SAAgB,mBACd,aACA,YACA,QACA,gBACS;CACT,OAAO,YACJ,SAAS,iBAAiB,UAAU,CAAC,CACrC,SAAS,oBAAoB,MAAM,CAAC,CACpC,SAAS,qBAAqB,cAAc;AACjD;AAEA,SAAgB,iCACd,aACA,QACM;CACN,IAAI,aACF,YAA8C,0BAA0B;AAE5E;AAEA,SAAgB,cAAc,gBAAyBC,mBAAAA,QAAQ,OAAO,GAAqB;CACzF,MAAM,aAAa,cAAc,SAAS,eAAe;CACzD,MAAM,eAAA,GAAcC,oBAAAA,eAAAA,CAAe,aAAa;CAChD,OACE,YAAY,SACX,aAAa,SAASC,oBAAAA,QAAQ,QAAQ,YAAY,0BAC/C,YAAY,OACZ,KAAA;AAER;AAEA,SAAgB,iBACd,gBAAyBF,mBAAAA,QAAQ,OAAO,GACb;CAC3B,MAAM,eAAA,GAAcC,oBAAAA,eAAAA,CAAe,aAAa;CAChD,OACG,cAAc,SAAS,kBAAkB,KAC1C,cAAc;AAElB;AAEA,SAAgB,kBACd,gBAAyBD,mBAAAA,QAAQ,OAAO,GACZ;CAC5B,OAAO,cAAc,SAAS,mBAAmB;AACnD"}
+{"version":3,"file":"context.cjs","names":["createContextKey","context","getRPCMetadata","RPCType"],"sources":["../src/context.ts"],"sourcesContent":["import {\n  type Attributes,\n  type Context,\n  context,\n  createContextKey,\n  type Span,\n} from \"@opentelemetry/api\";\nimport { getRPCMetadata, type RPCMetadata, RPCType } from \"@opentelemetry/core\";\nimport type { ValidationErrorDetail } from \"./validationErrors.js\";\n\n// Write sites resolve the request's SERVER span through this handle: under a child\n// span, the active span is not the SERVER span, and OTel has no public upward walk.\nexport interface SpanHandle {\n  span?: Span;\n  // This set-once reference preserves lifecycle ownership if span later changes.\n  ownSpan?: Span;\n}\n\nexport interface RequestConsumer {\n  identifier: string;\n  name?: string;\n  group?: string;\n  attributes: Map<string, string | null>;\n}\n\n// Requests dropped for these reasons are still counted in request metrics,\n// except preflight and websocket requests, which are never recorded.\nexport type RequestDropReason = \"excluded\" | \"method\" | \"scheme\" | \"sampled-out\";\n\n// Transport attributes are applied to exported spans last and used for metrics,\n// so transport values take precedence.\nexport interface RequestRecord {\n  attributes: Attributes;\n  serverSpanId?: string;\n  // Transport-measured request duration, set at completion; the duration\n  // histogram records it independent of span timing.\n  durationSeconds?: number;\n  dropReason?: RequestDropReason;\n  // Error state for the validation and server error events; it exists\n  // independently of the SERVER span and of the drop decision.\n  exception?: unknown;\n  validationErrors?: ValidationErrorDetail[];\n  // Consumer metadata for the consumer update event emitted at completion.\n  consumer?: RequestConsumer;\n}\n\nexport const SPAN_HANDLE_KEY = createContextKey(\"apitally-span-handle\");\nexport const REQUEST_RECORD_KEY = createContextKey(\"apitally-request-record\");\n\nconst RPC_REQUEST_RECORD_KEY = Symbol.for(\"apitally.rpcRequestRecord\");\n\ntype RPCMetadataWithRequestRecord = RPCMetadata & {\n  [RPC_REQUEST_RECORD_KEY]?: RequestRecord;\n};\n\n// Mutable holders carry changing request state because OTel contexts are immutable.\nexport function withRequestHolders(\n  baseContext: Context,\n  spanHandle: SpanHandle,\n  record: RequestRecord,\n): Context {\n  return baseContext.setValue(SPAN_HANDLE_KEY, spanHandle).setValue(REQUEST_RECORD_KEY, record);\n}\n\nexport function attachRequestRecordToRpcMetadata(\n  rpcMetadata: RPCMetadata | undefined,\n  record: RequestRecord,\n): void {\n  if (rpcMetadata) {\n    (rpcMetadata as RPCMetadataWithRequestRecord)[RPC_REQUEST_RECORD_KEY] = record;\n  }\n}\n\nexport function getServerSpan(activeContext: Context = context.active()): Span | undefined {\n  const spanHandle = activeContext.getValue(SPAN_HANDLE_KEY) as SpanHandle | undefined;\n  const rpcMetadata = getRPCMetadata(activeContext) as RPCMetadataWithRequestRecord | undefined;\n  return (\n    spanHandle?.span ??\n    (rpcMetadata?.type === RPCType.HTTP && rpcMetadata[RPC_REQUEST_RECORD_KEY]\n      ? rpcMetadata.span\n      : undefined)\n  );\n}\n\nexport function getRequestRecord(\n  activeContext: Context = context.active(),\n): RequestRecord | undefined {\n  const rpcMetadata = getRPCMetadata(activeContext) as RPCMetadataWithRequestRecord | undefined;\n  return (\n    (activeContext.getValue(REQUEST_RECORD_KEY) as RequestRecord | undefined) ??\n    rpcMetadata?.[RPC_REQUEST_RECORD_KEY]\n  );\n}\n"],"mappings":";;;;AA8CA,MAAa,mBAAA,GAAkBA,mBAAAA,iBAAAA,CAAiB,sBAAsB;AACtE,MAAa,sBAAA,GAAqBA,mBAAAA,iBAAAA,CAAiB,yBAAyB;AAE5E,MAAM,yBAAyB,OAAO,IAAI,2BAA2B;AAOrE,SAAgB,mBACd,aACA,YACA,QACS;CACT,OAAO,YAAY,SAAS,iBAAiB,UAAU,CAAC,CAAC,SAAS,oBAAoB,MAAM;AAC9F;AAEA,SAAgB,iCACd,aACA,QACM;CACN,IAAI,aACF,YAA8C,0BAA0B;AAE5E;AAEA,SAAgB,cAAc,gBAAyBC,mBAAAA,QAAQ,OAAO,GAAqB;CACzF,MAAM,aAAa,cAAc,SAAS,eAAe;CACzD,MAAM,eAAA,GAAcC,oBAAAA,eAAAA,CAAe,aAAa;CAChD,OACE,YAAY,SACX,aAAa,SAASC,oBAAAA,QAAQ,QAAQ,YAAY,0BAC/C,YAAY,OACZ,KAAA;AAER;AAEA,SAAgB,iBACd,gBAAyBF,mBAAAA,QAAQ,OAAO,GACb;CAC3B,MAAM,eAAA,GAAcC,oBAAAA,eAAAA,CAAe,aAAa;CAChD,OACG,cAAc,SAAS,kBAAkB,KAC1C,cAAc;AAElB"}