autotel 4.1.0 → 4.2.1

package/dist/{event-BhHREDJk.cjs.map → event-CcZYwp50.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"event-BhHREDJk.cjs","names":["getConfig","trace","getOperationContext","getEventsConfig","getOrCreateCorrelationId","context","propagation","validateEvent","getValidationConfig"],"sources":["../src/circuit-breaker.ts","../src/events-config.ts","../src/event.ts"],"sourcesContent":["/**\n * Circuit breaker for event subscribers\n *\n * Prevents cascading failures by fast-failing when an (subscriber) is unhealthy.\n * Uses the circuit breaker pattern with three states:\n * - CLOSED: Normal operation ((subscriber) working)\n * - OPEN: Fast-fail mode ((subscriber) down)\n * - HALF_OPEN: Testing if (subscriber) recovered\n */\n\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit (default: 5) */\n  failureThreshold: number;\n  /** Time to wait before trying again in ms (default: 30000 = 30s) */\n  resetTimeout: number;\n  /** Time window for counting failures in ms (default: 60000 = 1min) */\n  windowSize: number;\n}\n\nconst DEFAULT_CONFIG: CircuitBreakerConfig = {\n  failureThreshold: 5,\n  resetTimeout: 30_000, // 30 seconds\n  windowSize: 60_000, // 1 minute\n};\n\nexport type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';\n\nexport const CircuitState = {\n  CLOSED: 'CLOSED' as const, // Normal operation\n  OPEN: 'OPEN' as const, // Fast-fail mode\n  HALF_OPEN: 'HALF_OPEN' as const, // Testing recovery\n} as const;\n\ninterface FailureRecord {\n  timestamp: number;\n  error: string;\n}\n\n/**\n * Circuit breaker implementation\n *\n * Tracks failures and automatically opens the circuit to prevent\n * overwhelming failing subscribers.\n */\nexport class CircuitBreaker {\n  private state: CircuitState = CircuitState.CLOSED;\n  private failures: FailureRecord[] = [];\n  private lastFailureTime: number = 0;\n  private readonly config: CircuitBreakerConfig;\n  private readonly name: string;\n\n  constructor(name: string, config?: Partial<CircuitBreakerConfig>) {\n    this.name = name;\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Execute a function with circuit breaker protection\n   * Throws CircuitOpenError if circuit is open\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<T> {\n    // Check if circuit is open\n    if (this.state === CircuitState.OPEN) {\n      // Check if we should transition to half-open\n      const now = Date.now();\n      if (now - this.lastFailureTime >= this.config.resetTimeout) {\n        this.state = CircuitState.HALF_OPEN;\n      } else {\n        throw new CircuitOpenError(\n          `Circuit breaker is OPEN for ${this.name}. ` +\n            `Will retry in ${Math.ceil((this.config.resetTimeout - (now - this.lastFailureTime)) / 1000)}s`,\n        );\n      }\n    }\n\n    try {\n      const result = await fn();\n\n      // Success! Close circuit if it was half-open\n      if (this.state === CircuitState.HALF_OPEN) {\n        this.reset();\n      }\n\n      return result;\n    } catch (error) {\n      this.recordFailure(error);\n      throw error;\n    }\n  }\n\n  /**\n   * Record a failure and potentially open the circuit\n   */\n  private recordFailure(error: unknown): void {\n    const now = Date.now();\n\n    // Remove old failures outside the time window\n    this.failures = this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n\n    // Record new failure\n    this.failures.push({\n      timestamp: now,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    this.lastFailureTime = now;\n\n    // Check if we should open the circuit\n    if (this.failures.length >= this.config.failureThreshold) {\n      if (this.state === CircuitState.HALF_OPEN) {\n        // Failed during test - reopen circuit\n        this.state = CircuitState.OPEN;\n      } else if (this.state === CircuitState.CLOSED) {\n        // Too many failures - open circuit\n        this.state = CircuitState.OPEN;\n      }\n    }\n  }\n\n  /**\n   * Reset the circuit breaker (on success)\n   */\n  private reset(): void {\n    this.state = CircuitState.CLOSED;\n    this.failures = [];\n    this.lastFailureTime = 0;\n  }\n\n  /**\n   * Get current state (for monitoring)\n   */\n  getState(): CircuitState {\n    return this.state;\n  }\n\n  /**\n   * Get failure count in current window\n   */\n  getFailureCount(): number {\n    const now = Date.now();\n    // Clean up old failures\n    this.failures = this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n    return this.failures.length;\n  }\n\n  /**\n   * Get recent failures (for debugging)\n   */\n  getRecentFailures(): FailureRecord[] {\n    const now = Date.now();\n    return this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n  }\n\n  /**\n   * Manually reset the circuit breaker (for testing or manual intervention)\n   */\n  forceReset(): void {\n    this.reset();\n  }\n\n  /**\n   * Manually open the circuit (for testing or manual intervention)\n   */\n  forceOpen(): void {\n    this.state = CircuitState.OPEN;\n    this.lastFailureTime = Date.now();\n  }\n}\n\n/**\n * Error thrown when circuit is open\n */\nexport class CircuitOpenError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CircuitOpenError';\n  }\n}\n","/**\n * Events configuration types for trace context, correlation IDs, and enrichment\n *\n * @example Basic usage\n * ```typescript\n * import { init } from 'autotel';\n *\n * init({\n *   service: 'my-app',\n *   events: {\n *     includeTraceContext: true,\n *     traceUrl: (ctx) => `https://grafana.internal/explore?traceId=${ctx.traceId}`\n *   }\n * });\n * ```\n */\n\n/**\n * Context passed to the traceUrl function for generating clickable trace URLs\n */\nexport interface TraceUrlContext {\n  /** Trace ID (32 hex chars) - may be undefined outside a trace */\n  traceId?: string;\n  /** Span ID (16 hex chars) - may be undefined outside a trace */\n  spanId?: string;\n  /** Correlation ID (always present, 16 hex chars) */\n  correlationId: string;\n  /** Service name from init config */\n  serviceName: string;\n  /** Environment from init config */\n  environment?: string;\n}\n\n/**\n * Per-key transform options for baggage enrichment\n */\nexport type BaggageTransform = 'plain' | 'hash' | ((value: string) => string);\n\n/**\n * Baggage enrichment configuration with guardrails\n */\nexport interface EnrichFromBaggageConfig {\n  /**\n   * Allowlist of baggage keys to include in events\n   * Supports exact matches and patterns (e.g., 'tenant.*')\n   */\n  allow: string[];\n\n  /**\n   * Optional denylist of baggage keys to exclude\n   * Takes precedence over allow list\n   */\n  deny?: string[];\n\n  /**\n   * Optional prefix to add to all enriched keys\n   * @example 'ctx.' results in 'ctx.tenant.id'\n   */\n  prefix?: string;\n\n  /**\n   * Maximum number of keys to include (default: 10)\n   * Prevents payload bloat from excessive baggage\n   */\n  maxKeys?: number;\n\n  /**\n   * Maximum total bytes for enriched values (default: 1024)\n   * Prevents payload bloat from large baggage values\n   */\n  maxBytes?: number;\n\n  /**\n   * Per-key transform options\n   * - 'plain': Include value as-is\n   * - 'hash': Hash the value (for PII protection)\n   * - function: Custom transform function\n   *\n   * @example\n   * ```typescript\n   * transform: {\n   *   'user.id': 'hash',      // Hash user ID for privacy\n   *   'tenant.id': 'plain',   // Include tenant ID as-is\n   *   'session.id': (v) => v.slice(0, 8) // Custom truncation\n   * }\n   * ```\n   */\n  transform?: Record<string, BaggageTransform>;\n}\n\n/**\n * Events configuration for trace context and enrichment\n */\nexport interface EventsConfig {\n  /**\n   * Include trace context in events (default: false)\n   *\n   * When enabled, events automatically include:\n   * - autotel.trace_id (32 hex chars)\n   * - autotel.span_id (16 hex chars)\n   * - autotel.trace_flags (2 hex chars)\n   * - autotel.trace_state (raw tracestate string, if present)\n   * - autotel.correlation_id (always present, 16 hex chars)\n   *\n   * Subscribers map these to platform-specific names:\n   * - PostHog: $trace_id, $span_id\n   * - Mixpanel: trace_id, span_id\n   */\n  includeTraceContext?: boolean;\n\n  /**\n   * Include full array of linked trace IDs for batch/fan-in scenarios (default: false)\n   *\n   * When false (default), batch/fan-in events include:\n   * - autotel.linked_trace_id_count: Number of linked parents\n   * - autotel.linked_trace_id_hash: Stable hash of sorted IDs (keeps payload lean)\n   *\n   * When true, events also include:\n   * - autotel.linked_trace_ids: Full array of linked trace IDs\n   */\n  includeLinkedTraceIds?: boolean;\n\n  /**\n   * Generate clickable trace URL from context\n   *\n   * @param ctx - Trace context with traceId, spanId, correlationId, serviceName, environment\n   * @returns URL string or undefined to skip\n   *\n   * @example Grafana Tempo\n   * ```typescript\n   * traceUrl: (ctx) => ctx.traceId\n   *   ? `https://grafana.internal/explore?traceId=${ctx.traceId}`\n   *   : undefined\n   * ```\n   *\n   * @example Datadog\n   * ```typescript\n   * traceUrl: (ctx) => ctx.traceId\n   *   ? `https://app.datadoghq.com/apm/traces?traceId=${ctx.traceId}`\n   *   : undefined\n   * ```\n   *\n   * @example Jaeger\n   * ```typescript\n   * traceUrl: (ctx) => ctx.traceId\n   *   ? `https://jaeger.internal/trace/${ctx.traceId}`\n   *   : undefined\n   * ```\n   */\n  traceUrl?: (ctx: TraceUrlContext) => string | undefined;\n\n  /**\n   * Auto-enrich events from baggage with guardrails\n   *\n   * Automatically includes baggage entries in events without manual code.\n   * Apply allow/deny lists and per-key transforms for PII protection.\n   *\n   * @example Basic allowlist\n   * ```typescript\n   * enrichFromBaggage: {\n   *   allow: ['tenant.id', 'user.id', 'request.id']\n   * }\n   * // Events include: tenant.id, user.id, request.id from baggage\n   * ```\n   *\n   * @example With prefix and transforms\n   * ```typescript\n   * enrichFromBaggage: {\n   *   allow: ['tenant.id', 'user.id', 'user.email'],\n   *   deny: ['user.ssn'],\n   *   prefix: 'ctx.',\n   *   transform: {\n   *     'user.id': 'hash',\n   *     'user.email': 'hash'\n   *   }\n   * }\n   * // Events include: ctx.tenant.id, ctx.user.id (hashed), ctx.user.email (hashed)\n   * ```\n   */\n  enrichFromBaggage?: EnrichFromBaggageConfig;\n}\n\n/**\n * Autotel context object attached to event envelopes\n *\n * This structured object is attached to events and subscribers\n * decide how to map/flatten for their platform.\n */\nexport interface AutotelEventContext {\n  /** Trace ID (32 hex chars) - present when inside a trace */\n  trace_id?: string;\n  /** Span ID (16 hex chars) - present when inside a span */\n  span_id?: string;\n  /** Trace flags (2 hex chars, e.g., '01' for sampled) */\n  trace_flags?: string;\n  /** Raw tracestate string - present if tracestate exists */\n  trace_state?: string;\n  /** Clickable trace URL - present if traceUrl config is set */\n  trace_url?: string;\n  /** Correlation ID (always present, 16 hex chars) */\n  correlation_id: string;\n  /** Number of linked parent traces (batch/fan-in scenarios) */\n  linked_trace_id_count?: number;\n  /** Stable hash of linked trace IDs (default for batch/fan-in) */\n  linked_trace_id_hash?: string;\n  /** Full array of linked trace IDs (only if includeLinkedTraceIds: true) */\n  linked_trace_ids?: string[];\n}\n\n/**\n * Hash a string value for PII protection\n *\n * Uses a simple, fast hash function suitable for correlation.\n * NOT cryptographically secure - use for PII masking, not security.\n */\nexport function hashValue(value: string): string {\n  let hash = 0;\n  for (let i = 0; i < value.length; i++) {\n    const char = value.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  // Convert to positive hex string\n  return (hash >>> 0).toString(16).padStart(8, '0');\n}\n\n/**\n * Create a stable hash of an array of trace IDs\n *\n * Sorts the array first to ensure deterministic output regardless of order.\n */\nexport function hashLinkedTraceIds(traceIds: string[]): string {\n  const sorted = [...traceIds].sort();\n  return hashValue(sorted.join(','));\n}\n","/**\n * Events API for product events platforms\n *\n * Track user behavior, business events, and critical actions.\n * Sends to product events platforms (PostHog, Mixpanel, Amplitude) via subscribers.\n * For business people who think in events/funnels.\n *\n * For OpenTelemetry metrics (Prometheus/Grafana), use the Metrics class instead.\n *\n * @example Recommended: Configure subscribers in init(), use track() function\n * ```typescript\n * import { init, track } from 'autotel';\n * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n *\n * init({\n *   service: 'my-app',\n *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })]\n * });\n *\n * // Track events - uses subscribers from init()\n * track('application.submitted', { jobId: '123', userId: '456' });\n * ```\n *\n * @example Create Event instance (inherits subscribers from init)\n * ```typescript\n * import { Event } from 'autotel/event';\n *\n * // Uses subscribers configured in init()\n * const event = new Event('job-application');\n * event.trackEvent('application.submitted', { jobId: '123' });\n * ```\n *\n * @example Override subscribers for specific Event instance\n * ```typescript\n * import { Event } from 'autotel/event';\n * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n *\n * // Override: use different subscribers for this instance\n * const event = new Event('job-application', {\n *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_different_project' })]\n * });\n *\n * event.trackEvent('application.submitted', { jobId: '123' });\n * ```\n */\n\nimport { trace, propagation, context, TraceFlags } from '@opentelemetry/api';\nimport { type Logger } from './logger';\nimport {\n  getLogger,\n  getValidationConfig,\n  getConfig,\n  getEventsConfig,\n} from './init';\nimport {\n  type EventSubscriber,\n  type EventAttributes,\n  type EventAttributesInput,\n  type FunnelStatus,\n  type OutcomeStatus,\n  type AutotelEventContext,\n} from './event-subscriber';\nimport { type EventCollector } from './event-testing';\nimport { CircuitBreaker, CircuitOpenError } from './circuit-breaker';\nimport { validateEvent } from './validation';\nimport { getOperationContext } from './operation-context';\nimport {\n  type EnrichFromBaggageConfig,\n  hashValue,\n  hashLinkedTraceIds,\n} from './events-config';\nimport { getOrCreateCorrelationId } from './correlation-id';\n\n// Re-export types for convenience\nexport type {\n  EventAttributes,\n  EventAttributesInput,\n  FunnelStatus,\n  OutcomeStatus,\n} from './event-subscriber';\n\n/**\n * Events class for tracking user behavior and product events\n *\n * Track critical indicators such as:\n * - User events (signups, purchases, feature usage)\n * - Conversion funnels (signup → activation → purchase)\n * - Business outcomes (success/failure rates)\n * - Product metrics (revenue, engagement, retention)\n *\n * All events are sent to events platforms via subscribers (PostHog, Mixpanel, etc.).\n * For OpenTelemetry metrics, use the Metrics class instead.\n */\n/**\n * Events options\n */\nexport interface EventsOptions {\n  /** Optional logger for audit trail */\n  logger?: Logger;\n  /** Optional collector for testing (captures events in memory) */\n  collector?: EventCollector;\n  /**\n   * Optional subscribers to send events to other platforms\n   * (e.g., PostHog, Mixpanel, Amplitude)\n   *\n   * **Subscriber Resolution**:\n   * - If provided → uses these subscribers (instance override)\n   * - If not provided → falls back to subscribers from `init()` (global config)\n   * - If neither → no subscribers (events logged only)\n   *\n   * Install `autotel-subscribers` package for ready-made subscribers\n   */\n  subscribers?: EventSubscriber[];\n}\n\nexport class Event {\n  private serviceName: string;\n  private logger?: Logger;\n  private collector?: EventCollector;\n  private subscribers: EventSubscriber[];\n  private hasSubscribers: boolean; // Cached for performance\n  private circuitBreakers: Map<EventSubscriber, CircuitBreaker>; // One per subscriber\n\n  /**\n   * Create a new Event instance\n   *\n   * **Note**: Most users should use `init()` + `track()` instead of creating Event instances directly.\n   *\n   * **Subscriber Resolution**:\n   * - If `subscribers` provided in options → uses those (instance override)\n   * - If `subscribers` not provided → falls back to subscribers from `init()` (global config)\n   * - If neither → no subscribers (events logged only)\n   *\n   * @param serviceName - Service name for identifying events\n   * @param options - Optional configuration (logger, collector, subscribers)\n   *\n   * @example Recommended: Use track() with init()\n   * ```typescript\n   * import { init, track } from 'autotel';\n   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n   *\n   * init({\n   *   service: 'checkout',\n   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })]\n   * });\n   *\n   * track('purchase.completed', { amount: 99.99 });\n   * ```\n   *\n   * @example Inherit subscribers from init()\n   * ```typescript\n   * // Uses subscribers configured in init()\n   * const event = new Event('checkout');\n   * event.trackEvent('purchase.completed', { amount: 99.99 });\n   * ```\n   *\n   * @example Override subscribers for this instance\n   * ```typescript\n   * import { Event } from 'autotel/event';\n   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n   *\n   * // Override: use different subscribers for this instance only\n   * const event = new Event('checkout', {\n   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_different_project' })]\n   * });\n   * ```\n   */\n  constructor(serviceName: string, options: EventsOptions = {}) {\n    this.serviceName = serviceName;\n    this.logger = options.logger;\n    this.collector = options.collector;\n\n    // Subscriber resolution: instance-level overrides global init() config\n    // If subscribers provided to constructor, use those\n    // Otherwise, fall back to subscribers from init()\n    this.subscribers =\n      options.subscribers === undefined\n        ? getConfig()?.subscribers || []\n        : options.subscribers;\n\n    this.hasSubscribers = this.subscribers.length > 0; // Cache for hot path\n\n    // Create circuit breaker for each subscriber\n    this.circuitBreakers = new Map();\n    for (const subscriber of this.subscribers) {\n      const subscriberName = subscriber.name || 'Unknown';\n      this.circuitBreakers.set(\n        subscriber,\n        new CircuitBreaker(subscriberName, {\n          failureThreshold: 5,\n          resetTimeout: 30_000, // 30s\n          windowSize: 60_000, // 1min\n        }),\n      );\n    }\n  }\n\n  /**\n   * Automatically enrich attributes with all available telemetry context\n   *\n   * Auto-captures:\n   * - Resource attributes: service.version, deployment.environment\n   * - Trace context: traceId, spanId, correlationId\n   * - Operation context: operation.name\n   */\n  private enrichWithTelemetryContext(\n    attributes: EventAttributes = {},\n  ): EventAttributes {\n    const enriched: EventAttributes = {\n      service: this.serviceName,\n      ...attributes,\n    };\n\n    // 1. Resource attributes (service-level context)\n    const config = getConfig();\n    if (config) {\n      if (config.version) {\n        enriched['service.version'] = config.version;\n      }\n      if (config.environment) {\n        enriched['deployment.environment'] = config.environment;\n      }\n    }\n\n    // 2. Trace context (if inside a traced operation)\n    const span = trace.getActiveSpan();\n    const spanContext = span?.spanContext();\n    if (spanContext) {\n      enriched.traceId = spanContext.traceId;\n      enriched.spanId = spanContext.spanId;\n      // Add correlation ID (first 16 chars of trace ID) for easier log grouping\n      enriched.correlationId = spanContext.traceId.slice(0, 16);\n    }\n\n    // 3. Operation context (if inside a trace/span)\n    const operationContext = getOperationContext();\n    if (operationContext) {\n      enriched['operation.name'] = operationContext.name;\n    }\n\n    return enriched;\n  }\n\n  /**\n   * Build autotel event context for trace correlation\n   *\n   * Works in 4 contexts:\n   * 1. Inside a span → use current span's trace_id + span_id\n   * 2. Outside span but in AsyncLocalStorage context → use trace_id + correlation_id\n   * 3. Totally standalone → use correlation_id + service/env/version\n   * 4. Batch/fan-in (multiple linked parents) → use count + hash or full array\n   *\n   * @returns AutotelEventContext or undefined if trace context is disabled\n   */\n  private buildAutotelContext(): AutotelEventContext | undefined {\n    const eventsConfig = getEventsConfig();\n\n    // Return undefined if trace context is not enabled\n    if (!eventsConfig?.includeTraceContext) {\n      // Still generate correlation_id even without full trace context\n      // This provides a stable join key across events/logs/spans\n      return {\n        correlation_id: getOrCreateCorrelationId(),\n      };\n    }\n\n    const config = getConfig();\n    const span = trace.getActiveSpan();\n    const spanContext = span?.spanContext();\n\n    // Always generate a correlation_id\n    const correlationId = getOrCreateCorrelationId();\n\n    // Build base context\n    const autotelContext: AutotelEventContext = {\n      correlation_id: correlationId,\n    };\n\n    // Add trace context if inside a span\n    if (spanContext) {\n      autotelContext.trace_id = spanContext.traceId;\n      autotelContext.span_id = spanContext.spanId;\n\n      // Trace flags as 2-char hex string (canonical format)\n      autotelContext.trace_flags = spanContext.traceFlags\n        .toString(16)\n        .padStart(2, '0');\n\n      // Tracestate if present\n      const traceState = spanContext.traceState;\n      if (traceState) {\n        // Convert TraceState to string representation safely\n        let traceStateStr = '';\n        try {\n          if (typeof traceState.serialize === 'function') {\n            traceStateStr = traceState.serialize();\n          }\n        } catch {\n          // Silently ignore serialization errors - traceState is optional metadata\n        }\n        if (traceStateStr) {\n          autotelContext.trace_state = traceStateStr;\n        }\n      }\n\n      // Generate trace URL if configured\n      if (eventsConfig.traceUrl) {\n        const traceUrl = eventsConfig.traceUrl({\n          traceId: spanContext.traceId,\n          spanId: spanContext.spanId,\n          correlationId,\n          serviceName: config?.service || this.serviceName,\n          environment: config?.environment,\n        });\n        if (traceUrl) {\n          autotelContext.trace_url = traceUrl;\n        }\n      }\n\n      // Handle linked spans (batch/fan-in scenarios)\n      // Note: This would require access to span links which are not easily accessible\n      // from the public OpenTelemetry API. For now, we skip this unless we have\n      // explicit linked trace IDs passed in.\n    } else {\n      // Outside span but may still have trace URL generator\n      if (eventsConfig.traceUrl && config) {\n        const traceUrl = eventsConfig.traceUrl({\n          correlationId,\n          serviceName: config.service,\n          environment: config.environment,\n        });\n        if (traceUrl) {\n          autotelContext.trace_url = traceUrl;\n        }\n      }\n    }\n\n    return autotelContext;\n  }\n\n  /**\n   * Enrich event attributes from baggage with guardrails\n   *\n   * @param attributes - Current event attributes\n   * @returns Enriched attributes with baggage values\n   */\n  private enrichFromBaggage(attributes: EventAttributes): EventAttributes {\n    const eventsConfig = getEventsConfig();\n    const enrichConfig = eventsConfig?.enrichFromBaggage;\n\n    if (!enrichConfig) {\n      return attributes;\n    }\n\n    const enriched = { ...attributes };\n    const activeContext = context.active();\n    const baggage = propagation.getBaggage(activeContext);\n\n    if (!baggage) {\n      return enriched;\n    }\n\n    let keyCount = 0;\n    let byteCount = 0;\n    const maxKeys = enrichConfig.maxKeys ?? 10;\n    const maxBytes = enrichConfig.maxBytes ?? 1024;\n    const prefix = enrichConfig.prefix ?? '';\n\n    // Get all baggage entries\n    for (const [key, entry] of baggage.getAllEntries()) {\n      // Check if key is allowed\n      if (!this.isBaggageKeyAllowed(key, enrichConfig)) {\n        continue;\n      }\n\n      // Check limits\n      if (keyCount >= maxKeys) {\n        break;\n      }\n\n      const value = entry.value;\n\n      // Apply transform first so maxBytes is checked against transformed size (e.g. hash output)\n      const transform = enrichConfig.transform?.[key];\n      let transformedValue: string;\n\n      if (transform === 'hash') {\n        transformedValue = hashValue(value);\n      } else if (transform === 'plain' || !transform) {\n        transformedValue = value;\n      } else if (typeof transform === 'function') {\n        transformedValue = transform(value);\n      } else {\n        transformedValue = value;\n      }\n\n      const valueBytes = new TextEncoder().encode(transformedValue).length;\n\n      if (byteCount + valueBytes > maxBytes) {\n        continue; // Skip this entry if transformed value would exceed byte limit\n      }\n\n      // Add to enriched attributes with prefix\n      const enrichedKey = `${prefix}${key}`;\n      enriched[enrichedKey] = transformedValue;\n\n      keyCount++;\n      byteCount += valueBytes;\n    }\n\n    return enriched;\n  }\n\n  /**\n   * Check if a baggage key is allowed based on config\n   */\n  private isBaggageKeyAllowed(\n    key: string,\n    config: EnrichFromBaggageConfig,\n  ): boolean {\n    // Check deny list first (takes precedence)\n    if (config.deny) {\n      for (const pattern of config.deny) {\n        if (this.matchesBaggagePattern(key, pattern)) {\n          return false;\n        }\n      }\n    }\n\n    // Check allow list\n    for (const pattern of config.allow) {\n      if (this.matchesBaggagePattern(key, pattern)) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Check if a key matches a baggage pattern\n   * Supports exact matches and wildcard patterns (e.g., 'tenant.*')\n   */\n  private matchesBaggagePattern(key: string, pattern: string): boolean {\n    if (pattern.endsWith('.*')) {\n      const prefix = pattern.slice(0, -2);\n      return key.startsWith(prefix + '.');\n    }\n    return key === pattern;\n  }\n\n  /**\n   * Track a business event\n   *\n   * Use this for tracking user actions, business events, product usage:\n   * - \"user.signup\"\n   * - \"order.completed\"\n   * - \"feature.used\"\n   *\n   * Events are sent to configured subscribers (PostHog, Mixpanel, etc.).\n   *\n   * @example\n   * ```typescript\n   * // Track user signup\n   * events.trackEvent('user.signup', {\n   *   userId: '123',\n   *   plan: 'pro'\n   * })\n   *\n   * // Track order\n   * events.trackEvent('order.completed', {\n   *   orderId: 'ord_123',\n   *   amount: 99.99\n   * })\n   * ```\n   */\n  trackEvent(eventName: string, attributes?: EventAttributes): void {\n    // Validate and sanitize input (with custom config if provided)\n    const validationConfig = getValidationConfig();\n    const validated = validateEvent(\n      eventName,\n      attributes,\n      validationConfig || undefined,\n    );\n\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(\n      validated.attributes,\n    );\n\n    this.logger?.info(\n      {\n        event: validated.eventName,\n        attributes: enrichedAttributes,\n      },\n      'Event tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordEvent({\n      event: validated.eventName,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers (zero overhead if no subscribers)\n    // Run in background - don't block event recording\n    if (this.hasSubscribers) {\n      // Build autotel context for trace correlation\n      const autotelContext = this.buildAutotelContext();\n\n      // Enrich from baggage if configured\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackEvent(validated.eventName, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Notify all subscribers concurrently without blocking\n   * Uses circuit breakers to protect against failing subscribers\n   * Uses Promise.allSettled to prevent subscriber errors from affecting other subscribers\n   */\n  private async notifySubscribers(\n    fn: (subscriber: EventSubscriber) => Promise<void>,\n  ): Promise<void> {\n    const promises = this.subscribers.map(async (subscriber) => {\n      const circuitBreaker = this.circuitBreakers.get(subscriber);\n      if (!circuitBreaker) return; // Should never happen\n\n      try {\n        // Execute with circuit breaker protection\n        await circuitBreaker.execute(() => fn(subscriber));\n      } catch (error) {\n        // Handle circuit open errors (expected behavior when subscriber is down)\n        if (error instanceof CircuitOpenError) {\n          // Circuit is open - subscriber is down, log at warn level for visibility (same behavior in all environments)\n          getLogger().warn(\n            {\n              subscriberName: subscriber.name || 'Unknown',\n            },\n            `[Events] ${error.message}`,\n          );\n          return;\n        }\n\n        // Log other subscriber errors but don't throw - event failures shouldn't break business logic\n        getLogger().error(\n          {\n            err: error instanceof Error ? error : undefined,\n            subscriberName: subscriber.name || 'Unknown',\n          },\n          `[Events] Subscriber ${subscriber.name || 'Unknown'} failed`,\n        );\n      }\n    });\n\n    // Wait for all subscribers (success or failure)\n    await Promise.allSettled(promises);\n  }\n\n  /**\n   * Track conversion funnel steps\n   *\n   * Monitor where users drop off in multi-step processes.\n   *\n   * @example\n   * ```typescript\n   * // Track signup funnel\n   * events.trackFunnelStep('signup', 'started', { userId: '123' })\n   * events.trackFunnelStep('signup', 'email_verified', { userId: '123' })\n   * events.trackFunnelStep('signup', 'completed', { userId: '123' })\n   *\n   * // Track checkout flow\n   * events.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })\n   * events.trackFunnelStep('checkout', 'payment_info', { cartValue: 99.99 })\n   * events.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })\n   * ```\n   */\n  trackFunnelStep(\n    funnelName: string,\n    status: FunnelStatus,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info(\n      {\n        funnel: funnelName,\n        status,\n        attributes: enrichedAttributes,\n      },\n      'Funnel step tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordFunnelStep({\n      funnel: funnelName,\n      status,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackFunnelStep(funnelName, status, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Track outcomes (success/failure/partial)\n   *\n   * Monitor success rates of critical operations.\n   *\n   * @example\n   * ```typescript\n   * // Track email delivery\n   * events.trackOutcome('email.delivery', 'success', {\n   *   recipientType: 'user',\n   *   emailType: 'welcome'\n   * })\n   *\n   * events.trackOutcome('email.delivery', 'failure', {\n   *   recipientType: 'user',\n   *   errorCode: 'invalid_email'\n   * })\n   *\n   * // Track payment processing\n   * events.trackOutcome('payment.process', 'success', { amount: 99.99 })\n   * events.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })\n   * ```\n   */\n  trackOutcome(\n    operationName: string,\n    status: OutcomeStatus,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info(\n      {\n        operation: operationName,\n        status,\n        attributes: enrichedAttributes,\n      },\n      'Outcome tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordOutcome({\n      operation: operationName,\n      status,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackOutcome(operationName, status, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Track value metrics\n   *\n   * Record numerical values like revenue, transaction amounts,\n   * item counts, processing times, engagement scores, etc.\n   *\n   * @example\n   * ```typescript\n   * // Track revenue\n   * events.trackValue('order.revenue', 149.99, {\n   *   currency: 'USD',\n   *   productCategory: 'electronics'\n   * })\n   *\n   * // Track items per cart\n   * events.trackValue('cart.item_count', 5, {\n   *   userId: '123'\n   * })\n   *\n   * // Track processing time\n   * events.trackValue('api.response_time', 250, {\n   *   unit: 'ms',\n   *   endpoint: '/api/checkout'\n   * })\n   * ```\n   */\n  trackValue(\n    metricName: string,\n    value: number,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext({\n      metric: metricName,\n      ...attributes,\n    });\n\n    this.logger?.debug(\n      {\n        metric: metricName,\n        value,\n        attributes: enrichedAttributes,\n      },\n      'Value tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordValue({\n      metric: metricName,\n      value,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackValue(metricName, value, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Flush all subscribers and wait for pending events\n   *\n   * Call this before shutdown to ensure all events are delivered.\n   *\n   * @example\n   * ```typescript\n   * const event =new Event('app', { subscribers: [...] });\n   *\n   * // Before shutdown\n   * await events.flush();\n   * ```\n   */\n  async flush(): Promise<void> {\n    if (!this.hasSubscribers) return;\n\n    const shutdownPromises = this.subscribers.map(async (subscriber) => {\n      if (subscriber.shutdown) {\n        try {\n          await subscriber.shutdown();\n        } catch (error) {\n          getLogger().error(\n            {\n              err: error instanceof Error ? error : undefined,\n              subscriberName: subscriber.name || 'Unknown',\n            },\n            `[Events] Failed to shutdown subscriber ${subscriber.name || 'Unknown'}`,\n          );\n        }\n      }\n    });\n\n    await Promise.allSettled(shutdownPromises);\n  }\n\n  /**\n   * Shutdown the Event instance and all subscribers\n   *\n   * Unlike `flush()`, this method:\n   * - Shuts down all subscribers\n   * - Prevents further event tracking (hasSubscribers becomes false)\n   * - Should only be called once at application shutdown\n   *\n   * @example\n   * ```typescript\n   * // In Next.js API route with after()\n   * import { after } from 'next/server';\n   *\n   * export async function POST(req: Request) {\n   *   const event = new Event('checkout', { subscribers: [...] });\n   *   event.trackEvent('order.completed', { orderId: '123' });\n   *\n   *   after(async () => {\n   *     await event.shutdown();\n   *   });\n   *\n   *   return Response.json({ success: true });\n   * }\n   * ```\n   */\n  async shutdown(): Promise<void> {\n    if (!this.hasSubscribers) return;\n\n    await Promise.allSettled(\n      this.subscribers.map(async (subscriber) => {\n        if (subscriber.shutdown) {\n          try {\n            await subscriber.shutdown();\n          } catch (error) {\n            getLogger().error(\n              {\n                err: error instanceof Error ? error : undefined,\n                subscriberName: subscriber.name || 'Unknown',\n              },\n              `[Events] Failed to shutdown subscriber ${subscriber.name || 'Unknown'}`,\n            );\n          }\n        }\n      }),\n    );\n\n    // Prevent further tracking after shutdown\n    this.hasSubscribers = false;\n  }\n\n  /**\n   * Track funnel progression with custom step names\n   *\n   * Unlike trackFunnelStep which uses FunnelStatus enum values,\n   * this method allows any string as the step name for flexible funnel tracking.\n   *\n   * @param funnelName - Name of the funnel (e.g., \"checkout\", \"onboarding\")\n   * @param stepName - Custom step name (e.g., \"cart_viewed\", \"payment_entered\")\n   * @param stepNumber - Optional numeric position in the funnel\n   * @param attributes - Optional event attributes\n   *\n   * @example\n   * ```typescript\n   * // Track custom checkout steps\n   * event.trackFunnelProgression('checkout', 'cart_viewed', 1);\n   * event.trackFunnelProgression('checkout', 'shipping_selected', 2);\n   * event.trackFunnelProgression('checkout', 'payment_entered', 3);\n   * event.trackFunnelProgression('checkout', 'order_confirmed', 4);\n   * ```\n   */\n  trackFunnelProgression(\n    funnelName: string,\n    stepName: string,\n    stepNumber?: number,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info(\n      {\n        funnel: funnelName,\n        stepName,\n        stepNumber,\n        attributes: enrichedAttributes,\n      },\n      'Funnel progression tracked',\n    );\n\n    // Record for testing (as funnel step with custom name)\n    this.collector?.recordFunnelStep({\n      funnel: funnelName,\n      status: stepName as FunnelStatus, // Cast for testing collector\n      attributes: {\n        ...enrichedAttributes,\n        step_name: stepName,\n        ...(stepNumber === undefined ? {} : { step_number: stepNumber }),\n      },\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers that support trackFunnelProgression\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers(async (subscriber) => {\n        await (subscriber.trackFunnelProgression\n          ? subscriber.trackFunnelProgression(\n              funnelName,\n              stepName,\n              stepNumber,\n              finalAttributes,\n              { autotel: autotelContext },\n            )\n          : // Fall back to trackFunnelStep with step as custom name (cast)\n            subscriber.trackFunnelStep(\n              funnelName,\n              stepName as FunnelStatus,\n              {\n                ...finalAttributes,\n                step_name: stepName,\n                ...(stepNumber === undefined\n                  ? {}\n                  : { step_number: stepNumber }),\n              },\n              { autotel: autotelContext },\n            ));\n      });\n    }\n  }\n\n  /**\n   * Track multiple events in a batch\n   *\n   * Useful for bulk event tracking with consistent timestamps.\n   * Events are sent to subscribers individually but processed together.\n   *\n   * @param events - Array of events to track\n   *\n   * @example\n   * ```typescript\n   * event.trackBatch([\n   *   { name: 'item.viewed', attributes: { itemId: '1' } },\n   *   { name: 'item.viewed', attributes: { itemId: '2' } },\n   *   { name: 'cart.updated', attributes: { itemCount: 2 } },\n   * ]);\n   * ```\n   */\n  trackBatch(\n    events: Array<{ name: string; attributes?: EventAttributesInput }>,\n  ): void {\n    // Filter attributes and track each event\n    for (const event of events) {\n      // Filter undefined/null values from attributes\n      const filteredAttributes = event.attributes\n        ? (Object.fromEntries(\n            Object.entries(event.attributes).filter(\n              ([, v]) => v !== undefined && v !== null,\n            ),\n          ) as EventAttributes)\n        : undefined;\n\n      this.trackEvent(event.name, filteredAttributes);\n    }\n  }\n}\n\n/**\n * Global events instances (singleton pattern)\n */\nconst eventsInstances = new Map<string, Event>();\n\n/**\n * Get or create an Events instance for a service\n *\n * @param serviceName - Service name for identifying events\n * @param logger - Optional logger\n * @returns Events instance\n *\n * @example\n * ```typescript\n * const event =getEvents('job-application')\n * events.trackEvent('application.submitted', { jobId: '123' })\n * ```\n */\nexport function getEvents(serviceName: string, logger?: Logger): Event {\n  if (!eventsInstances.has(serviceName)) {\n    eventsInstances.set(serviceName, new Event(serviceName, { logger }));\n  }\n  return eventsInstances.get(serviceName)!;\n}\n\n/**\n * Reset all events instances (mainly for testing)\n */\nexport function resetEvents(): void {\n  eventsInstances.clear();\n}\n"],"mappings":"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"}
+{"version":3,"file":"event-CcZYwp50.cjs","names":["getConfig","trace","getOperationContext","getEventsConfig","getOrCreateCorrelationId","context","propagation","validateEvent","getValidationConfig"],"sources":["../src/circuit-breaker.ts","../src/events-config.ts","../src/event.ts"],"sourcesContent":["/**\n * Circuit breaker for event subscribers\n *\n * Prevents cascading failures by fast-failing when an (subscriber) is unhealthy.\n * Uses the circuit breaker pattern with three states:\n * - CLOSED: Normal operation ((subscriber) working)\n * - OPEN: Fast-fail mode ((subscriber) down)\n * - HALF_OPEN: Testing if (subscriber) recovered\n */\n\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit (default: 5) */\n  failureThreshold: number;\n  /** Time to wait before trying again in ms (default: 30000 = 30s) */\n  resetTimeout: number;\n  /** Time window for counting failures in ms (default: 60000 = 1min) */\n  windowSize: number;\n}\n\nconst DEFAULT_CONFIG: CircuitBreakerConfig = {\n  failureThreshold: 5,\n  resetTimeout: 30_000, // 30 seconds\n  windowSize: 60_000, // 1 minute\n};\n\nexport type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';\n\nexport const CircuitState = {\n  CLOSED: 'CLOSED' as const, // Normal operation\n  OPEN: 'OPEN' as const, // Fast-fail mode\n  HALF_OPEN: 'HALF_OPEN' as const, // Testing recovery\n} as const;\n\ninterface FailureRecord {\n  timestamp: number;\n  error: string;\n}\n\n/**\n * Circuit breaker implementation\n *\n * Tracks failures and automatically opens the circuit to prevent\n * overwhelming failing subscribers.\n */\nexport class CircuitBreaker {\n  private state: CircuitState = CircuitState.CLOSED;\n  private failures: FailureRecord[] = [];\n  private lastFailureTime: number = 0;\n  private readonly config: CircuitBreakerConfig;\n  private readonly name: string;\n\n  constructor(name: string, config?: Partial<CircuitBreakerConfig>) {\n    this.name = name;\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Execute a function with circuit breaker protection\n   * Throws CircuitOpenError if circuit is open\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<T> {\n    // Check if circuit is open\n    if (this.state === CircuitState.OPEN) {\n      // Check if we should transition to half-open\n      const now = Date.now();\n      if (now - this.lastFailureTime >= this.config.resetTimeout) {\n        this.state = CircuitState.HALF_OPEN;\n      } else {\n        throw new CircuitOpenError(\n          `Circuit breaker is OPEN for ${this.name}. ` +\n            `Will retry in ${Math.ceil((this.config.resetTimeout - (now - this.lastFailureTime)) / 1000)}s`,\n        );\n      }\n    }\n\n    try {\n      const result = await fn();\n\n      // Success! Close circuit if it was half-open\n      if (this.state === CircuitState.HALF_OPEN) {\n        this.reset();\n      }\n\n      return result;\n    } catch (error) {\n      this.recordFailure(error);\n      throw error;\n    }\n  }\n\n  /**\n   * Record a failure and potentially open the circuit\n   */\n  private recordFailure(error: unknown): void {\n    const now = Date.now();\n\n    // Remove old failures outside the time window\n    this.failures = this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n\n    // Record new failure\n    this.failures.push({\n      timestamp: now,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    this.lastFailureTime = now;\n\n    // Check if we should open the circuit\n    if (this.failures.length >= this.config.failureThreshold) {\n      if (this.state === CircuitState.HALF_OPEN) {\n        // Failed during test - reopen circuit\n        this.state = CircuitState.OPEN;\n      } else if (this.state === CircuitState.CLOSED) {\n        // Too many failures - open circuit\n        this.state = CircuitState.OPEN;\n      }\n    }\n  }\n\n  /**\n   * Reset the circuit breaker (on success)\n   */\n  private reset(): void {\n    this.state = CircuitState.CLOSED;\n    this.failures = [];\n    this.lastFailureTime = 0;\n  }\n\n  /**\n   * Get current state (for monitoring)\n   */\n  getState(): CircuitState {\n    return this.state;\n  }\n\n  /**\n   * Get failure count in current window\n   */\n  getFailureCount(): number {\n    const now = Date.now();\n    // Clean up old failures\n    this.failures = this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n    return this.failures.length;\n  }\n\n  /**\n   * Get recent failures (for debugging)\n   */\n  getRecentFailures(): FailureRecord[] {\n    const now = Date.now();\n    return this.failures.filter(\n      (f) => now - f.timestamp < this.config.windowSize,\n    );\n  }\n\n  /**\n   * Manually reset the circuit breaker (for testing or manual intervention)\n   */\n  forceReset(): void {\n    this.reset();\n  }\n\n  /**\n   * Manually open the circuit (for testing or manual intervention)\n   */\n  forceOpen(): void {\n    this.state = CircuitState.OPEN;\n    this.lastFailureTime = Date.now();\n  }\n}\n\n/**\n * Error thrown when circuit is open\n */\nexport class CircuitOpenError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CircuitOpenError';\n  }\n}\n","/**\n * Events configuration types for trace context, correlation IDs, and enrichment\n *\n * @example Basic usage\n * ```typescript\n * import { init } from 'autotel';\n *\n * init({\n *   service: 'my-app',\n *   events: {\n *     includeTraceContext: true,\n *     traceUrl: (ctx) => `https://grafana.internal/explore?traceId=${ctx.traceId}`\n *   }\n * });\n * ```\n */\n\n/**\n * Context passed to the traceUrl function for generating clickable trace URLs\n */\nexport interface TraceUrlContext {\n  /** Trace ID (32 hex chars) - may be undefined outside a trace */\n  traceId?: string;\n  /** Span ID (16 hex chars) - may be undefined outside a trace */\n  spanId?: string;\n  /** Correlation ID (always present, 16 hex chars) */\n  correlationId: string;\n  /** Service name from init config */\n  serviceName: string;\n  /** Environment from init config */\n  environment?: string;\n}\n\n/**\n * Per-key transform options for baggage enrichment\n */\nexport type BaggageTransform = 'plain' | 'hash' | ((value: string) => string);\n\n/**\n * Baggage enrichment configuration with guardrails\n */\nexport interface EnrichFromBaggageConfig {\n  /**\n   * Allowlist of baggage keys to include in events\n   * Supports exact matches and patterns (e.g., 'tenant.*')\n   */\n  allow: string[];\n\n  /**\n   * Optional denylist of baggage keys to exclude\n   * Takes precedence over allow list\n   */\n  deny?: string[];\n\n  /**\n   * Optional prefix to add to all enriched keys\n   * @example 'ctx.' results in 'ctx.tenant.id'\n   */\n  prefix?: string;\n\n  /**\n   * Maximum number of keys to include (default: 10)\n   * Prevents payload bloat from excessive baggage\n   */\n  maxKeys?: number;\n\n  /**\n   * Maximum total bytes for enriched values (default: 1024)\n   * Prevents payload bloat from large baggage values\n   */\n  maxBytes?: number;\n\n  /**\n   * Per-key transform options\n   * - 'plain': Include value as-is\n   * - 'hash': Hash the value (for PII protection)\n   * - function: Custom transform function\n   *\n   * @example\n   * ```typescript\n   * transform: {\n   *   'user.id': 'hash',      // Hash user ID for privacy\n   *   'tenant.id': 'plain',   // Include tenant ID as-is\n   *   'session.id': (v) => v.slice(0, 8) // Custom truncation\n   * }\n   * ```\n   */\n  transform?: Record<string, BaggageTransform>;\n}\n\n/**\n * Events configuration for trace context and enrichment\n */\nexport interface EventsConfig {\n  /**\n   * Include trace context in events (default: false)\n   *\n   * When enabled, events automatically include:\n   * - autotel.trace_id (32 hex chars)\n   * - autotel.span_id (16 hex chars)\n   * - autotel.trace_flags (2 hex chars)\n   * - autotel.trace_state (raw tracestate string, if present)\n   * - autotel.correlation_id (always present, 16 hex chars)\n   *\n   * Subscribers map these to platform-specific names:\n   * - PostHog: $trace_id, $span_id\n   * - Mixpanel: trace_id, span_id\n   */\n  includeTraceContext?: boolean;\n\n  /**\n   * Include full array of linked trace IDs for batch/fan-in scenarios (default: false)\n   *\n   * When false (default), batch/fan-in events include:\n   * - autotel.linked_trace_id_count: Number of linked parents\n   * - autotel.linked_trace_id_hash: Stable hash of sorted IDs (keeps payload lean)\n   *\n   * When true, events also include:\n   * - autotel.linked_trace_ids: Full array of linked trace IDs\n   */\n  includeLinkedTraceIds?: boolean;\n\n  /**\n   * Generate clickable trace URL from context\n   *\n   * @param ctx - Trace context with traceId, spanId, correlationId, serviceName, environment\n   * @returns URL string or undefined to skip\n   *\n   * @example Grafana Tempo\n   * ```typescript\n   * traceUrl: (ctx) => ctx.traceId\n   *   ? `https://grafana.internal/explore?traceId=${ctx.traceId}`\n   *   : undefined\n   * ```\n   *\n   * @example Datadog\n   * ```typescript\n   * traceUrl: (ctx) => ctx.traceId\n   *   ? `https://app.datadoghq.com/apm/traces?traceId=${ctx.traceId}`\n   *   : undefined\n   * ```\n   *\n   * @example Jaeger\n   * ```typescript\n   * traceUrl: (ctx) => ctx.traceId\n   *   ? `https://jaeger.internal/trace/${ctx.traceId}`\n   *   : undefined\n   * ```\n   */\n  traceUrl?: (ctx: TraceUrlContext) => string | undefined;\n\n  /**\n   * Auto-enrich events from baggage with guardrails\n   *\n   * Automatically includes baggage entries in events without manual code.\n   * Apply allow/deny lists and per-key transforms for PII protection.\n   *\n   * @example Basic allowlist\n   * ```typescript\n   * enrichFromBaggage: {\n   *   allow: ['tenant.id', 'user.id', 'request.id']\n   * }\n   * // Events include: tenant.id, user.id, request.id from baggage\n   * ```\n   *\n   * @example With prefix and transforms\n   * ```typescript\n   * enrichFromBaggage: {\n   *   allow: ['tenant.id', 'user.id', 'user.email'],\n   *   deny: ['user.ssn'],\n   *   prefix: 'ctx.',\n   *   transform: {\n   *     'user.id': 'hash',\n   *     'user.email': 'hash'\n   *   }\n   * }\n   * // Events include: ctx.tenant.id, ctx.user.id (hashed), ctx.user.email (hashed)\n   * ```\n   */\n  enrichFromBaggage?: EnrichFromBaggageConfig;\n}\n\n/**\n * Autotel context object attached to event envelopes\n *\n * This structured object is attached to events and subscribers\n * decide how to map/flatten for their platform.\n */\nexport interface AutotelEventContext {\n  /** Trace ID (32 hex chars) - present when inside a trace */\n  trace_id?: string;\n  /** Span ID (16 hex chars) - present when inside a span */\n  span_id?: string;\n  /** Trace flags (2 hex chars, e.g., '01' for sampled) */\n  trace_flags?: string;\n  /** Raw tracestate string - present if tracestate exists */\n  trace_state?: string;\n  /** Clickable trace URL - present if traceUrl config is set */\n  trace_url?: string;\n  /** Correlation ID (always present, 16 hex chars) */\n  correlation_id: string;\n  /** Number of linked parent traces (batch/fan-in scenarios) */\n  linked_trace_id_count?: number;\n  /** Stable hash of linked trace IDs (default for batch/fan-in) */\n  linked_trace_id_hash?: string;\n  /** Full array of linked trace IDs (only if includeLinkedTraceIds: true) */\n  linked_trace_ids?: string[];\n}\n\n/**\n * Hash a string value for PII protection\n *\n * Uses a simple, fast hash function suitable for correlation.\n * NOT cryptographically secure - use for PII masking, not security.\n */\nexport function hashValue(value: string): string {\n  let hash = 0;\n  for (let i = 0; i < value.length; i++) {\n    const char = value.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  // Convert to positive hex string\n  return (hash >>> 0).toString(16).padStart(8, '0');\n}\n\n/**\n * Create a stable hash of an array of trace IDs\n *\n * Sorts the array first to ensure deterministic output regardless of order.\n */\nexport function hashLinkedTraceIds(traceIds: string[]): string {\n  const sorted = [...traceIds].sort();\n  return hashValue(sorted.join(','));\n}\n","/**\n * Events API for product events platforms\n *\n * Track user behavior, business events, and critical actions.\n * Sends to product events platforms (PostHog, Mixpanel, Amplitude) via subscribers.\n * For business people who think in events/funnels.\n *\n * For OpenTelemetry metrics (Prometheus/Grafana), use the Metrics class instead.\n *\n * @example Recommended: Configure subscribers in init(), use track() function\n * ```typescript\n * import { init, track } from 'autotel';\n * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n *\n * init({\n *   service: 'my-app',\n *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })]\n * });\n *\n * // Track events - uses subscribers from init()\n * track('application.submitted', { jobId: '123', userId: '456' });\n * ```\n *\n * @example Create Event instance (inherits subscribers from init)\n * ```typescript\n * import { Event } from 'autotel/event';\n *\n * // Uses subscribers configured in init()\n * const event = new Event('job-application');\n * event.trackEvent('application.submitted', { jobId: '123' });\n * ```\n *\n * @example Override subscribers for specific Event instance\n * ```typescript\n * import { Event } from 'autotel/event';\n * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n *\n * // Override: use different subscribers for this instance\n * const event = new Event('job-application', {\n *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_different_project' })]\n * });\n *\n * event.trackEvent('application.submitted', { jobId: '123' });\n * ```\n */\n\nimport { trace, propagation, context, TraceFlags } from '@opentelemetry/api';\nimport { type Logger } from './logger';\nimport {\n  getLogger,\n  getValidationConfig,\n  getConfig,\n  getEventsConfig,\n} from './init';\nimport {\n  type EventSubscriber,\n  type EventAttributes,\n  type EventAttributesInput,\n  type FunnelStatus,\n  type OutcomeStatus,\n  type AutotelEventContext,\n} from './event-subscriber';\nimport { type EventCollector } from './event-testing';\nimport { CircuitBreaker, CircuitOpenError } from './circuit-breaker';\nimport { validateEvent } from './validation';\nimport { getOperationContext } from './operation-context';\nimport {\n  type EnrichFromBaggageConfig,\n  hashValue,\n  hashLinkedTraceIds,\n} from './events-config';\nimport { getOrCreateCorrelationId } from './correlation-id';\n\n// Re-export types for convenience\nexport type {\n  EventAttributes,\n  EventAttributesInput,\n  FunnelStatus,\n  OutcomeStatus,\n} from './event-subscriber';\n\n/**\n * Events class for tracking user behavior and product events\n *\n * Track critical indicators such as:\n * - User events (signups, purchases, feature usage)\n * - Conversion funnels (signup → activation → purchase)\n * - Business outcomes (success/failure rates)\n * - Product metrics (revenue, engagement, retention)\n *\n * All events are sent to events platforms via subscribers (PostHog, Mixpanel, etc.).\n * For OpenTelemetry metrics, use the Metrics class instead.\n */\n/**\n * Events options\n */\nexport interface EventsOptions {\n  /** Optional logger for audit trail */\n  logger?: Logger;\n  /** Optional collector for testing (captures events in memory) */\n  collector?: EventCollector;\n  /**\n   * Optional subscribers to send events to other platforms\n   * (e.g., PostHog, Mixpanel, Amplitude)\n   *\n   * **Subscriber Resolution**:\n   * - If provided → uses these subscribers (instance override)\n   * - If not provided → falls back to subscribers from `init()` (global config)\n   * - If neither → no subscribers (events logged only)\n   *\n   * Install `autotel-subscribers` package for ready-made subscribers\n   */\n  subscribers?: EventSubscriber[];\n}\n\nexport class Event {\n  private serviceName: string;\n  private logger?: Logger;\n  private collector?: EventCollector;\n  private subscribers: EventSubscriber[];\n  private hasSubscribers: boolean; // Cached for performance\n  private circuitBreakers: Map<EventSubscriber, CircuitBreaker>; // One per subscriber\n\n  /**\n   * Create a new Event instance\n   *\n   * **Note**: Most users should use `init()` + `track()` instead of creating Event instances directly.\n   *\n   * **Subscriber Resolution**:\n   * - If `subscribers` provided in options → uses those (instance override)\n   * - If `subscribers` not provided → falls back to subscribers from `init()` (global config)\n   * - If neither → no subscribers (events logged only)\n   *\n   * @param serviceName - Service name for identifying events\n   * @param options - Optional configuration (logger, collector, subscribers)\n   *\n   * @example Recommended: Use track() with init()\n   * ```typescript\n   * import { init, track } from 'autotel';\n   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n   *\n   * init({\n   *   service: 'checkout',\n   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })]\n   * });\n   *\n   * track('purchase.completed', { amount: 99.99 });\n   * ```\n   *\n   * @example Inherit subscribers from init()\n   * ```typescript\n   * // Uses subscribers configured in init()\n   * const event = new Event('checkout');\n   * event.trackEvent('purchase.completed', { amount: 99.99 });\n   * ```\n   *\n   * @example Override subscribers for this instance\n   * ```typescript\n   * import { Event } from 'autotel/event';\n   * import { PostHogSubscriber } from 'autotel-subscribers/posthog';\n   *\n   * // Override: use different subscribers for this instance only\n   * const event = new Event('checkout', {\n   *   subscribers: [new PostHogSubscriber({ apiKey: 'phc_different_project' })]\n   * });\n   * ```\n   */\n  constructor(serviceName: string, options: EventsOptions = {}) {\n    this.serviceName = serviceName;\n    this.logger = options.logger;\n    this.collector = options.collector;\n\n    // Subscriber resolution: instance-level overrides global init() config\n    // If subscribers provided to constructor, use those\n    // Otherwise, fall back to subscribers from init()\n    this.subscribers =\n      options.subscribers === undefined\n        ? getConfig()?.subscribers || []\n        : options.subscribers;\n\n    this.hasSubscribers = this.subscribers.length > 0; // Cache for hot path\n\n    // Create circuit breaker for each subscriber\n    this.circuitBreakers = new Map();\n    for (const subscriber of this.subscribers) {\n      const subscriberName = subscriber.name || 'Unknown';\n      this.circuitBreakers.set(\n        subscriber,\n        new CircuitBreaker(subscriberName, {\n          failureThreshold: 5,\n          resetTimeout: 30_000, // 30s\n          windowSize: 60_000, // 1min\n        }),\n      );\n    }\n  }\n\n  /**\n   * Automatically enrich attributes with all available telemetry context\n   *\n   * Auto-captures:\n   * - Resource attributes: service.version, deployment.environment\n   * - Trace context: traceId, spanId, correlationId\n   * - Operation context: operation.name\n   */\n  private enrichWithTelemetryContext(\n    attributes: EventAttributes = {},\n  ): EventAttributes {\n    const enriched: EventAttributes = {\n      service: this.serviceName,\n      ...attributes,\n    };\n\n    // 1. Resource attributes (service-level context)\n    const config = getConfig();\n    if (config) {\n      if (config.version) {\n        enriched['service.version'] = config.version;\n      }\n      if (config.environment) {\n        enriched['deployment.environment'] = config.environment;\n      }\n    }\n\n    // 2. Trace context (if inside a traced operation)\n    const span = trace.getActiveSpan();\n    const spanContext = span?.spanContext();\n    if (spanContext) {\n      enriched.traceId = spanContext.traceId;\n      enriched.spanId = spanContext.spanId;\n      // Add correlation ID (first 16 chars of trace ID) for easier log grouping\n      enriched.correlationId = spanContext.traceId.slice(0, 16);\n    }\n\n    // 3. Operation context (if inside a trace/span)\n    const operationContext = getOperationContext();\n    if (operationContext) {\n      enriched['operation.name'] = operationContext.name;\n    }\n\n    return enriched;\n  }\n\n  /**\n   * Build autotel event context for trace correlation\n   *\n   * Works in 4 contexts:\n   * 1. Inside a span → use current span's trace_id + span_id\n   * 2. Outside span but in AsyncLocalStorage context → use trace_id + correlation_id\n   * 3. Totally standalone → use correlation_id + service/env/version\n   * 4. Batch/fan-in (multiple linked parents) → use count + hash or full array\n   *\n   * @returns AutotelEventContext or undefined if trace context is disabled\n   */\n  private buildAutotelContext(): AutotelEventContext | undefined {\n    const eventsConfig = getEventsConfig();\n\n    // Return undefined if trace context is not enabled\n    if (!eventsConfig?.includeTraceContext) {\n      // Still generate correlation_id even without full trace context\n      // This provides a stable join key across events/logs/spans\n      return {\n        correlation_id: getOrCreateCorrelationId(),\n      };\n    }\n\n    const config = getConfig();\n    const span = trace.getActiveSpan();\n    const spanContext = span?.spanContext();\n\n    // Always generate a correlation_id\n    const correlationId = getOrCreateCorrelationId();\n\n    // Build base context\n    const autotelContext: AutotelEventContext = {\n      correlation_id: correlationId,\n    };\n\n    // Add trace context if inside a span\n    if (spanContext) {\n      autotelContext.trace_id = spanContext.traceId;\n      autotelContext.span_id = spanContext.spanId;\n\n      // Trace flags as 2-char hex string (canonical format)\n      autotelContext.trace_flags = spanContext.traceFlags\n        .toString(16)\n        .padStart(2, '0');\n\n      // Tracestate if present\n      const traceState = spanContext.traceState;\n      if (traceState) {\n        // Convert TraceState to string representation safely\n        let traceStateStr = '';\n        try {\n          if (typeof traceState.serialize === 'function') {\n            traceStateStr = traceState.serialize();\n          }\n        } catch {\n          // Silently ignore serialization errors - traceState is optional metadata\n        }\n        if (traceStateStr) {\n          autotelContext.trace_state = traceStateStr;\n        }\n      }\n\n      // Generate trace URL if configured\n      if (eventsConfig.traceUrl) {\n        const traceUrl = eventsConfig.traceUrl({\n          traceId: spanContext.traceId,\n          spanId: spanContext.spanId,\n          correlationId,\n          serviceName: config?.service || this.serviceName,\n          environment: config?.environment,\n        });\n        if (traceUrl) {\n          autotelContext.trace_url = traceUrl;\n        }\n      }\n\n      // Handle linked spans (batch/fan-in scenarios)\n      // Note: This would require access to span links which are not easily accessible\n      // from the public OpenTelemetry API. For now, we skip this unless we have\n      // explicit linked trace IDs passed in.\n    } else {\n      // Outside span but may still have trace URL generator\n      if (eventsConfig.traceUrl && config) {\n        const traceUrl = eventsConfig.traceUrl({\n          correlationId,\n          serviceName: config.service,\n          environment: config.environment,\n        });\n        if (traceUrl) {\n          autotelContext.trace_url = traceUrl;\n        }\n      }\n    }\n\n    return autotelContext;\n  }\n\n  /**\n   * Enrich event attributes from baggage with guardrails\n   *\n   * @param attributes - Current event attributes\n   * @returns Enriched attributes with baggage values\n   */\n  private enrichFromBaggage(attributes: EventAttributes): EventAttributes {\n    const eventsConfig = getEventsConfig();\n    const enrichConfig = eventsConfig?.enrichFromBaggage;\n\n    if (!enrichConfig) {\n      return attributes;\n    }\n\n    const enriched = { ...attributes };\n    const activeContext = context.active();\n    const baggage = propagation.getBaggage(activeContext);\n\n    if (!baggage) {\n      return enriched;\n    }\n\n    let keyCount = 0;\n    let byteCount = 0;\n    const maxKeys = enrichConfig.maxKeys ?? 10;\n    const maxBytes = enrichConfig.maxBytes ?? 1024;\n    const prefix = enrichConfig.prefix ?? '';\n\n    // Get all baggage entries\n    for (const [key, entry] of baggage.getAllEntries()) {\n      // Check if key is allowed\n      if (!this.isBaggageKeyAllowed(key, enrichConfig)) {\n        continue;\n      }\n\n      // Check limits\n      if (keyCount >= maxKeys) {\n        break;\n      }\n\n      const value = entry.value;\n\n      // Apply transform first so maxBytes is checked against transformed size (e.g. hash output)\n      const transform = enrichConfig.transform?.[key];\n      let transformedValue: string;\n\n      if (transform === 'hash') {\n        transformedValue = hashValue(value);\n      } else if (transform === 'plain' || !transform) {\n        transformedValue = value;\n      } else if (typeof transform === 'function') {\n        transformedValue = transform(value);\n      } else {\n        transformedValue = value;\n      }\n\n      const valueBytes = new TextEncoder().encode(transformedValue).length;\n\n      if (byteCount + valueBytes > maxBytes) {\n        continue; // Skip this entry if transformed value would exceed byte limit\n      }\n\n      // Add to enriched attributes with prefix\n      const enrichedKey = `${prefix}${key}`;\n      enriched[enrichedKey] = transformedValue;\n\n      keyCount++;\n      byteCount += valueBytes;\n    }\n\n    return enriched;\n  }\n\n  /**\n   * Check if a baggage key is allowed based on config\n   */\n  private isBaggageKeyAllowed(\n    key: string,\n    config: EnrichFromBaggageConfig,\n  ): boolean {\n    // Check deny list first (takes precedence)\n    if (config.deny) {\n      for (const pattern of config.deny) {\n        if (this.matchesBaggagePattern(key, pattern)) {\n          return false;\n        }\n      }\n    }\n\n    // Check allow list\n    for (const pattern of config.allow) {\n      if (this.matchesBaggagePattern(key, pattern)) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Check if a key matches a baggage pattern\n   * Supports exact matches and wildcard patterns (e.g., 'tenant.*')\n   */\n  private matchesBaggagePattern(key: string, pattern: string): boolean {\n    if (pattern.endsWith('.*')) {\n      const prefix = pattern.slice(0, -2);\n      return key.startsWith(prefix + '.');\n    }\n    return key === pattern;\n  }\n\n  /**\n   * Track a business event\n   *\n   * Use this for tracking user actions, business events, product usage:\n   * - \"user.signup\"\n   * - \"order.completed\"\n   * - \"feature.used\"\n   *\n   * Events are sent to configured subscribers (PostHog, Mixpanel, etc.).\n   *\n   * @example\n   * ```typescript\n   * // Track user signup\n   * events.trackEvent('user.signup', {\n   *   userId: '123',\n   *   plan: 'pro'\n   * })\n   *\n   * // Track order\n   * events.trackEvent('order.completed', {\n   *   orderId: 'ord_123',\n   *   amount: 99.99\n   * })\n   * ```\n   */\n  trackEvent(eventName: string, attributes?: EventAttributes): void {\n    // Validate and sanitize input (with custom config if provided)\n    const validationConfig = getValidationConfig();\n    const validated = validateEvent(\n      eventName,\n      attributes,\n      validationConfig || undefined,\n    );\n\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(\n      validated.attributes,\n    );\n\n    this.logger?.info(\n      {\n        event: validated.eventName,\n        attributes: enrichedAttributes,\n      },\n      'Event tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordEvent({\n      event: validated.eventName,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers (zero overhead if no subscribers)\n    // Run in background - don't block event recording\n    if (this.hasSubscribers) {\n      // Build autotel context for trace correlation\n      const autotelContext = this.buildAutotelContext();\n\n      // Enrich from baggage if configured\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackEvent(validated.eventName, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Notify all subscribers concurrently without blocking\n   * Uses circuit breakers to protect against failing subscribers\n   * Uses Promise.allSettled to prevent subscriber errors from affecting other subscribers\n   */\n  private async notifySubscribers(\n    fn: (subscriber: EventSubscriber) => Promise<void>,\n  ): Promise<void> {\n    const promises = this.subscribers.map(async (subscriber) => {\n      const circuitBreaker = this.circuitBreakers.get(subscriber);\n      if (!circuitBreaker) return; // Should never happen\n\n      try {\n        // Execute with circuit breaker protection\n        await circuitBreaker.execute(() => fn(subscriber));\n      } catch (error) {\n        // Handle circuit open errors (expected behavior when subscriber is down)\n        if (error instanceof CircuitOpenError) {\n          // Circuit is open - subscriber is down, log at warn level for visibility (same behavior in all environments)\n          getLogger().warn(\n            {\n              subscriberName: subscriber.name || 'Unknown',\n            },\n            `[Events] ${error.message}`,\n          );\n          return;\n        }\n\n        // Log other subscriber errors but don't throw - event failures shouldn't break business logic\n        getLogger().error(\n          {\n            err: error instanceof Error ? error : undefined,\n            subscriberName: subscriber.name || 'Unknown',\n          },\n          `[Events] Subscriber ${subscriber.name || 'Unknown'} failed`,\n        );\n      }\n    });\n\n    // Wait for all subscribers (success or failure)\n    await Promise.allSettled(promises);\n  }\n\n  /**\n   * Track conversion funnel steps\n   *\n   * Monitor where users drop off in multi-step processes.\n   *\n   * @example\n   * ```typescript\n   * // Track signup funnel\n   * events.trackFunnelStep('signup', 'started', { userId: '123' })\n   * events.trackFunnelStep('signup', 'email_verified', { userId: '123' })\n   * events.trackFunnelStep('signup', 'completed', { userId: '123' })\n   *\n   * // Track checkout flow\n   * events.trackFunnelStep('checkout', 'started', { cartValue: 99.99 })\n   * events.trackFunnelStep('checkout', 'payment_info', { cartValue: 99.99 })\n   * events.trackFunnelStep('checkout', 'completed', { cartValue: 99.99 })\n   * ```\n   */\n  trackFunnelStep(\n    funnelName: string,\n    status: FunnelStatus,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info(\n      {\n        funnel: funnelName,\n        status,\n        attributes: enrichedAttributes,\n      },\n      'Funnel step tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordFunnelStep({\n      funnel: funnelName,\n      status,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackFunnelStep(funnelName, status, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Track outcomes (success/failure/partial)\n   *\n   * Monitor success rates of critical operations.\n   *\n   * @example\n   * ```typescript\n   * // Track email delivery\n   * events.trackOutcome('email.delivery', 'success', {\n   *   recipientType: 'user',\n   *   emailType: 'welcome'\n   * })\n   *\n   * events.trackOutcome('email.delivery', 'failure', {\n   *   recipientType: 'user',\n   *   errorCode: 'invalid_email'\n   * })\n   *\n   * // Track payment processing\n   * events.trackOutcome('payment.process', 'success', { amount: 99.99 })\n   * events.trackOutcome('payment.process', 'failure', { error: 'insufficient_funds' })\n   * ```\n   */\n  trackOutcome(\n    operationName: string,\n    status: OutcomeStatus,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info(\n      {\n        operation: operationName,\n        status,\n        attributes: enrichedAttributes,\n      },\n      'Outcome tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordOutcome({\n      operation: operationName,\n      status,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackOutcome(operationName, status, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Track value metrics\n   *\n   * Record numerical values like revenue, transaction amounts,\n   * item counts, processing times, engagement scores, etc.\n   *\n   * @example\n   * ```typescript\n   * // Track revenue\n   * events.trackValue('order.revenue', 149.99, {\n   *   currency: 'USD',\n   *   productCategory: 'electronics'\n   * })\n   *\n   * // Track items per cart\n   * events.trackValue('cart.item_count', 5, {\n   *   userId: '123'\n   * })\n   *\n   * // Track processing time\n   * events.trackValue('api.response_time', 250, {\n   *   unit: 'ms',\n   *   endpoint: '/api/checkout'\n   * })\n   * ```\n   */\n  trackValue(\n    metricName: string,\n    value: number,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext({\n      metric: metricName,\n      ...attributes,\n    });\n\n    this.logger?.debug(\n      {\n        metric: metricName,\n        value,\n        attributes: enrichedAttributes,\n      },\n      'Value tracked',\n    );\n\n    // Record for testing\n    this.collector?.recordValue({\n      metric: metricName,\n      value,\n      attributes: enrichedAttributes,\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers((subscriber) =>\n        subscriber.trackValue(metricName, value, finalAttributes, {\n          autotel: autotelContext,\n        }),\n      );\n    }\n  }\n\n  /**\n   * Flush all subscribers and wait for pending events\n   *\n   * Call this before shutdown to ensure all events are delivered.\n   *\n   * @example\n   * ```typescript\n   * const event =new Event('app', { subscribers: [...] });\n   *\n   * // Before shutdown\n   * await events.flush();\n   * ```\n   */\n  async flush(): Promise<void> {\n    if (!this.hasSubscribers) return;\n\n    const shutdownPromises = this.subscribers.map(async (subscriber) => {\n      if (subscriber.shutdown) {\n        try {\n          await subscriber.shutdown();\n        } catch (error) {\n          getLogger().error(\n            {\n              err: error instanceof Error ? error : undefined,\n              subscriberName: subscriber.name || 'Unknown',\n            },\n            `[Events] Failed to shutdown subscriber ${subscriber.name || 'Unknown'}`,\n          );\n        }\n      }\n    });\n\n    await Promise.allSettled(shutdownPromises);\n  }\n\n  /**\n   * Shutdown the Event instance and all subscribers\n   *\n   * Unlike `flush()`, this method:\n   * - Shuts down all subscribers\n   * - Prevents further event tracking (hasSubscribers becomes false)\n   * - Should only be called once at application shutdown\n   *\n   * @example\n   * ```typescript\n   * // In Next.js API route with after()\n   * import { after } from 'next/server';\n   *\n   * export async function POST(req: Request) {\n   *   const event = new Event('checkout', { subscribers: [...] });\n   *   event.trackEvent('order.completed', { orderId: '123' });\n   *\n   *   after(async () => {\n   *     await event.shutdown();\n   *   });\n   *\n   *   return Response.json({ success: true });\n   * }\n   * ```\n   */\n  async shutdown(): Promise<void> {\n    if (!this.hasSubscribers) return;\n\n    await Promise.allSettled(\n      this.subscribers.map(async (subscriber) => {\n        if (subscriber.shutdown) {\n          try {\n            await subscriber.shutdown();\n          } catch (error) {\n            getLogger().error(\n              {\n                err: error instanceof Error ? error : undefined,\n                subscriberName: subscriber.name || 'Unknown',\n              },\n              `[Events] Failed to shutdown subscriber ${subscriber.name || 'Unknown'}`,\n            );\n          }\n        }\n      }),\n    );\n\n    // Prevent further tracking after shutdown\n    this.hasSubscribers = false;\n  }\n\n  /**\n   * Track funnel progression with custom step names\n   *\n   * Unlike trackFunnelStep which uses FunnelStatus enum values,\n   * this method allows any string as the step name for flexible funnel tracking.\n   *\n   * @param funnelName - Name of the funnel (e.g., \"checkout\", \"onboarding\")\n   * @param stepName - Custom step name (e.g., \"cart_viewed\", \"payment_entered\")\n   * @param stepNumber - Optional numeric position in the funnel\n   * @param attributes - Optional event attributes\n   *\n   * @example\n   * ```typescript\n   * // Track custom checkout steps\n   * event.trackFunnelProgression('checkout', 'cart_viewed', 1);\n   * event.trackFunnelProgression('checkout', 'shipping_selected', 2);\n   * event.trackFunnelProgression('checkout', 'payment_entered', 3);\n   * event.trackFunnelProgression('checkout', 'order_confirmed', 4);\n   * ```\n   */\n  trackFunnelProgression(\n    funnelName: string,\n    stepName: string,\n    stepNumber?: number,\n    attributes?: EventAttributes,\n  ): void {\n    // Auto-attach all available telemetry context\n    const enrichedAttributes = this.enrichWithTelemetryContext(attributes);\n\n    this.logger?.info(\n      {\n        funnel: funnelName,\n        stepName,\n        stepNumber,\n        attributes: enrichedAttributes,\n      },\n      'Funnel progression tracked',\n    );\n\n    // Record for testing (as funnel step with custom name)\n    this.collector?.recordFunnelStep({\n      funnel: funnelName,\n      status: stepName as FunnelStatus, // Cast for testing collector\n      attributes: {\n        ...enrichedAttributes,\n        step_name: stepName,\n        ...(stepNumber === undefined ? {} : { step_number: stepNumber }),\n      },\n      service: this.serviceName,\n      timestamp: Date.now(),\n    });\n\n    // Notify subscribers that support trackFunnelProgression\n    if (this.hasSubscribers) {\n      const autotelContext = this.buildAutotelContext();\n      const finalAttributes = this.enrichFromBaggage(enrichedAttributes);\n\n      void this.notifySubscribers(async (subscriber) => {\n        await (subscriber.trackFunnelProgression\n          ? subscriber.trackFunnelProgression(\n              funnelName,\n              stepName,\n              stepNumber,\n              finalAttributes,\n              { autotel: autotelContext },\n            )\n          : // Fall back to trackFunnelStep with step as custom name (cast)\n            subscriber.trackFunnelStep(\n              funnelName,\n              stepName as FunnelStatus,\n              {\n                ...finalAttributes,\n                step_name: stepName,\n                ...(stepNumber === undefined\n                  ? {}\n                  : { step_number: stepNumber }),\n              },\n              { autotel: autotelContext },\n            ));\n      });\n    }\n  }\n\n  /**\n   * Track multiple events in a batch\n   *\n   * Useful for bulk event tracking with consistent timestamps.\n   * Events are sent to subscribers individually but processed together.\n   *\n   * @param events - Array of events to track\n   *\n   * @example\n   * ```typescript\n   * event.trackBatch([\n   *   { name: 'item.viewed', attributes: { itemId: '1' } },\n   *   { name: 'item.viewed', attributes: { itemId: '2' } },\n   *   { name: 'cart.updated', attributes: { itemCount: 2 } },\n   * ]);\n   * ```\n   */\n  trackBatch(\n    events: Array<{ name: string; attributes?: EventAttributesInput }>,\n  ): void {\n    // Filter attributes and track each event\n    for (const event of events) {\n      // Filter undefined/null values from attributes\n      const filteredAttributes = event.attributes\n        ? (Object.fromEntries(\n            Object.entries(event.attributes).filter(\n              ([, v]) => v !== undefined && v !== null,\n            ),\n          ) as EventAttributes)\n        : undefined;\n\n      this.trackEvent(event.name, filteredAttributes);\n    }\n  }\n}\n\n/**\n * Global events instances (singleton pattern)\n */\nconst eventsInstances = new Map<string, Event>();\n\n/**\n * Get or create an Events instance for a service\n *\n * @param serviceName - Service name for identifying events\n * @param logger - Optional logger\n * @returns Events instance\n *\n * @example\n * ```typescript\n * const event =getEvents('job-application')\n * events.trackEvent('application.submitted', { jobId: '123' })\n * ```\n */\nexport function getEvents(serviceName: string, logger?: Logger): Event {\n  if (!eventsInstances.has(serviceName)) {\n    eventsInstances.set(serviceName, new Event(serviceName, { logger }));\n  }\n  return eventsInstances.get(serviceName)!;\n}\n\n/**\n * Reset all events instances (mainly for testing)\n */\nexport function resetEvents(): void {\n  eventsInstances.clear();\n}\n"],"mappings":"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"}

package/dist/event.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_event = require('./event-BhHREDJk.cjs');
+const require_event = require('./event-CcZYwp50.cjs');
 
 exports.Event = require_event.Event;
 exports.getEvents = require_event.getEvents;

package/dist/event.js

@@ -1,3 +1,3 @@
-import { n as getEvents, r as resetEvents, t as Event } from "./event-ByBTV9M2.js";
+import { n as getEvents, r as resetEvents, t as Event } from "./event-531asIM6.js";
 
 export { Event, getEvents, resetEvents };

package/dist/{functional-zpzNLhky.cjs → functional-C8B0Qa7o.cjs}

@@ -1,12 +1,15 @@
-const require_config = require('./config.cjs');
+const require_chunk = require('./chunk-C_NdSu1c.cjs');
 const require_sampling = require('./sampling.cjs');
-const require_init = require('./init-BX7AmFRl.cjs');
-const require_track = require('./track-D59FfpL0.cjs');
+const require_init = require('./init-BXiuPK6j.cjs');
+const require_config = require('./config.cjs');
+const require_track = require('./track-Cb3Q4QmS.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
-const require_operation_context = require('./operation-context-n4_obUwq.cjs');
+const require_operation_context = require('./operation-context-D6LDf4W_.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs, 1);
 let node_url = require("node:url");
+node_url = require_chunk.__toESM(node_url, 1);
 
 //#region src/variable-name-inference.ts
 /**
@@ -55,7 +58,7 @@ function parseCallLocation(stack) {
 		if (match) {
 			let filePath = match[1].trim();
 			if (filePath.startsWith("file://")) try {
-				filePath = (0, node_url.fileURLToPath)(filePath);
+				filePath = node_url.fileURLToPath(filePath);
 			} catch {
 				continue;
 			}
@@ -77,7 +80,7 @@ function parseCallLocation(stack) {
 function readSourceLine(filePath, lineNumber) {
 	try {
 		if (typeof node_fs.readFileSync !== "function") return;
-		return (0, node_fs.readFileSync)(filePath, "utf8").split("\n")[lineNumber - 1];
+		return node_fs.readFileSync(filePath, "utf8").split("\n")[lineNumber - 1];
 	} catch {
 		return;
 	}
@@ -1309,4 +1312,4 @@ Object.defineProperty(exports, 'withTracing', {
     return withTracing;
   }
 });
-//# sourceMappingURL=functional-zpzNLhky.cjs.map
+//# sourceMappingURL=functional-C8B0Qa7o.cjs.map

package/dist/functional-C8B0Qa7o.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"functional-C8B0Qa7o.cjs","names":["nodeUrl","nodeFs","otelTrace","createTraceContext","getConfig","AlwaysSampler","getInitConfig","getEventQueue","getSdk","getActiveContextWithBaggage","runInOperationContext","context","getContextStorage","AUTOTEL_SAMPLING_TAIL_KEEP","AUTOTEL_SAMPLING_TAIL_EVALUATED","SpanStatusCode","propagation"],"sources":["../src/variable-name-inference.ts","../src/functional.ts"],"sourcesContent":["/**\n * Variable Name Inference Utility\n *\n * Attempts to infer variable names from const/export const assignments\n * by analyzing the call stack and parsing source code.\n *\n * This is a best-effort approach with graceful degradation - if inference\n * fails for any reason, it returns undefined without breaking the application.\n */\n\n// namespace imports for browser-bundler compat — see node-require.ts\nimport * as nodeFs from 'node:fs';\nimport * as nodeUrl from 'node:url';\n\ninterface CallLocation {\n  file: string;\n  line: number;\n  column: number;\n}\n\n/**\n * LRU Cache for inferred variable names\n * Key: \"file:line\" (e.g., \"/path/to/file.ts:42\")\n * Value: inferred variable name or undefined\n */\nconst inferenceCache = new Map<string, string | undefined>();\nconst MAX_CACHE_SIZE = 50;\n\n/**\n * Captures the current call stack\n */\nfunction captureStackTrace(): string {\n  const originalStackTraceLimit = Error.stackTraceLimit;\n  Error.stackTraceLimit = 10; // Only need first few frames\n\n  const err = new Error('Stack trace capture');\n  const stack = err.stack || '';\n\n  Error.stackTraceLimit = originalStackTraceLimit;\n  return stack;\n}\n\n/**\n * Parses the stack trace to find where trace() was called\n *\n * Stack trace format (Node.js):\n *   at functionName (file:line:column)\n *   at file:line:column\n *\n * We skip frames until we find one that's NOT in functional.ts or this file.\n * We also need to skip one additional frame (the trace/span/instrument function itself)\n * to get to the actual user code.\n */\nfunction parseCallLocation(stack: string): CallLocation | undefined {\n  const lines = stack.split('\\n');\n  let skippedExternalFrame = false;\n\n  for (const line of lines) {\n    // Skip if line contains this file or functional.ts (internal frames)\n    // Be specific about the filename to avoid matching test files\n    if (\n      line.includes('variable-name-inference.ts') ||\n      line.includes('variable-name-inference.js') ||\n      line.includes('functional.ts') ||\n      line.includes('functional.js')\n    ) {\n      continue;\n    }\n\n    // Match various stack trace formats\n    // Format 1: at functionName (file:line:column)\n    // Format 2: at file:line:column\n    const match =\n      line.match(/at\\s+(?:.*\\s+)?\\(?([^:]+):(\\d+):(\\d+)\\)?/) ||\n      line.match(/^.*?([^:]+):(\\d+):(\\d+)/);\n\n    if (match) {\n      let filePath = match[1]!.trim();\n\n      // Handle file:// URLs (convert to paths)\n      if (filePath.startsWith('file://')) {\n        try {\n          filePath = nodeUrl.fileURLToPath(filePath);\n        } catch {\n          continue;\n        }\n      }\n\n      // Skip the first external frame (the trace/span function itself)\n      // We want the frame where the user CALLS trace(), not inside trace()\n      if (!skippedExternalFrame) {\n        skippedExternalFrame = true;\n        continue;\n      }\n\n      return {\n        file: filePath,\n        line: Number.parseInt(match[2]!, 10),\n        column: Number.parseInt(match[3]!, 10),\n      };\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Reads a specific line from a source file\n */\nfunction readSourceLine(\n  filePath: string,\n  lineNumber: number,\n): string | undefined {\n  try {\n    // Check if we can access the file system (not available in edge runtimes)\n    if (typeof nodeFs.readFileSync !== 'function') {\n      return undefined;\n    }\n\n    const content = nodeFs.readFileSync(filePath, 'utf8');\n    const lines = content.split('\\n');\n\n    // Line numbers are 1-based\n    return lines[lineNumber - 1];\n  } catch {\n    // File doesn't exist, permission denied, or other error\n    return undefined;\n  }\n}\n\n/**\n * Extracts variable name from source code line using regex patterns\n *\n * Supported patterns:\n * - const varName = anyFunction(\n * - export const varName = anyFunction(\n * - let varName = anyFunction(\n * - var varName = anyFunction(\n *\n * Note: This won't work with destructuring assignments or complex patterns\n */\nfunction extractVariableName(sourceLine: string): string | undefined {\n  // Remove leading/trailing whitespace\n  const trimmed = sourceLine.trim();\n\n  // Pattern: (export)? (const|let|var) varName = anyFunctionCall(\n  // We match any function call, not just trace(), to support wrapper functions\n  const patterns = [\n    // export const varName = anyFunction(\n    /export\\s+const\\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*=\\s*[a-zA-Z_$][a-zA-Z0-9_$]*\\s*\\(/,\n    // const varName = anyFunction(\n    /const\\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*=\\s*[a-zA-Z_$][a-zA-Z0-9_$]*\\s*\\(/,\n    // export let varName = anyFunction(\n    /export\\s+let\\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*=\\s*[a-zA-Z_$][a-zA-Z0-9_$]*\\s*\\(/,\n    // let varName = anyFunction(\n    /let\\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*=\\s*[a-zA-Z_$][a-zA-Z0-9_$]*\\s*\\(/,\n    // export var varName = anyFunction(\n    /export\\s+var\\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*=\\s*[a-zA-Z_$][a-zA-Z0-9_$]*\\s*\\(/,\n    // var varName = anyFunction(\n    /var\\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*=\\s*[a-zA-Z_$][a-zA-Z0-9_$]*\\s*\\(/,\n  ];\n\n  for (const pattern of patterns) {\n    const match = trimmed.match(pattern);\n    if (match && match[1]) {\n      return match[1];\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Adds an entry to the cache with LRU eviction\n */\nfunction cacheInference(key: string, value: string | undefined): void {\n  // If cache is full, remove oldest entry (first entry in Map)\n  if (inferenceCache.size >= MAX_CACHE_SIZE) {\n    const firstKey = inferenceCache.keys().next().value;\n    if (firstKey) {\n      inferenceCache.delete(firstKey);\n    }\n  }\n\n  inferenceCache.set(key, value);\n}\n\n/**\n * Main entry point: Attempts to infer the variable name from the call stack\n *\n * This function:\n * 1. Captures the call stack\n * 2. Parses it to find where trace() was called (file + line)\n * 3. Reads that line from the source file\n * 4. Extracts the variable name using regex\n *\n * Returns undefined if inference fails at any step (graceful degradation).\n * Results are cached to avoid repeated file I/O.\n *\n * @returns The inferred variable name, or undefined if inference failed\n */\nexport function inferVariableNameFromCallStack(): string | undefined {\n  try {\n    // Capture stack trace\n    const stack = captureStackTrace();\n\n    // Parse stack to find trace() call location\n    const callLocation = parseCallLocation(stack);\n    if (!callLocation) {\n      return undefined;\n    }\n\n    // Check cache\n    const cacheKey = `${callLocation.file}:${callLocation.line}`;\n    if (inferenceCache.has(cacheKey)) {\n      return inferenceCache.get(cacheKey);\n    }\n\n    // Read source line\n    const sourceLine = readSourceLine(callLocation.file, callLocation.line);\n    if (!sourceLine) {\n      return undefined;\n    }\n\n    // Extract variable name\n    const variableName = extractVariableName(sourceLine);\n\n    // Cache result (even if undefined, to avoid repeated failed attempts)\n    cacheInference(cacheKey, variableName);\n\n    return variableName;\n  } catch {\n    // Graceful degradation - don't break the app if inference fails\n    return undefined;\n  }\n}\n\n/**\n * Clears the inference cache (useful for testing)\n */\nexport function clearInferenceCache(): void {\n  inferenceCache.clear();\n}\n","/**\n * Functional API for non-class code\n *\n * Three approaches for different use cases:\n * 1. trace() - Zero-ceremony HOF for single functions\n * 2. withTracing() - Middleware-style composable wrapper\n * 3. instrument() - Batch auto-instrumentation for modules\n *\n * @example trace() - Single function\n * ```typescript\n * export const createUser = trace(ctx => async (data) => {\n *   ctx.setAttribute('user.id', data.id)\n *   return await db.users.create(data)\n * })\n * ```\n *\n * @example withTracing() - Composable middleware\n * ```typescript\n * export const createUser = withTracing({\n *   name: 'user.create'\n * })(ctx => async (data) => {\n *   ctx.setAttribute('user.id', data.id)\n *   return await db.users.create(data)\n * })\n * ```\n *\n * @example instrument() - Batch instrumentation\n * ```typescript\n * export default instrument({\n *   createUser: async (data) => { },\n *   updateUser: async (id, data) => { }\n * }, { serviceName: 'user' })\n * ```\n */\n\nimport {\n  SpanStatusCode,\n  trace as otelTrace,\n  context,\n  propagation,\n  type Span,\n} from '@opentelemetry/api';\nimport { getConfig } from './config';\nimport { getConfig as getInitConfig, getSdk } from './init';\nimport {\n  type Sampler,\n  type SamplingContext,\n  AlwaysSampler,\n  AUTOTEL_SAMPLING_TAIL_KEEP,\n  AUTOTEL_SAMPLING_TAIL_EVALUATED,\n} from './sampling';\nimport { getEventQueue } from './track';\nimport type { TraceContext } from './trace-context';\nimport {\n  createTraceContext,\n  enterOrRun,\n  getActiveContextWithBaggage,\n  getContextStorage,\n} from './trace-context';\nimport { setSpanName } from './trace-helpers';\nimport { runInOperationContext } from './operation-context';\nimport { inferVariableNameFromCallStack } from './variable-name-inference';\n\n/**\n * Complete trace context containing trace identifiers and span methods\n *\n * The ctx parameter in trace() functions provides:\n * - traceId, spanId, correlationId from the active span\n * - Span manipulation methods (setAttribute, setAttributes, setStatus, recordException)\n *\n * For custom context, access it directly in your functions (standard OpenTelemetry pattern).\n *\n * @example\n * ```typescript\n * import { trace } from 'autotel'\n *\n * export const createUser = trace(ctx => async (data: CreateUserData) => {\n *   // Get custom context directly (standard OTel approach)\n *   const userId = getCurrentUserId()\n *   const tenantId = getCurrentTenant()\n *\n *   // Use ctx for span operations and trace IDs\n *   ctx.setAttribute('user.id', data.id)\n *   ctx.setAttribute('user.tenant', tenantId)\n *   console.log(ctx.traceId)  // Trace IDs available\n * })\n * ```\n */\nexport type { TraceContext } from './trace-context';\n\n/**\n * Helper type to extract function signature from factory pattern\n * This helps TypeScript infer types correctly for factory functions\n */\ntype ExtractFunctionSignature<T> = T extends (ctx: TraceContext) => infer F\n  ? F extends (...args: infer Args) => infer Return\n    ? (...args: Args) => Return\n    : never\n  : never;\n\n/**\n * Helper type to exclude functions that return functions from immediate execution overloads\n */\ntype ExcludeFactoryReturn<T> = T extends (ctx: TraceContext) => infer F\n  ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    F extends (...args: any[]) => any\n    ? never\n    : T\n  : T;\n\ntype GenericFunction = (...args: unknown[]) => unknown;\n\nconst FACTORY_NAME_HINTS = new Set([\n  'ctx',\n  '_ctx',\n  'context',\n  'tracecontext',\n  'tracectx',\n]);\nconst TRACE_FACTORY_SET = new WeakSet<object>();\n\nconst SINGLE_LINE_COMMENT_REGEX = /\\/\\/.*$/gm;\nconst MULTI_LINE_COMMENT_REGEX = /\\/\\*[\\s\\S]*?\\*\\//gm;\nconst PARAM_TOKEN_SANITIZE_REGEX = new RegExp(String.raw`[{}\\[\\]\\s]`, 'g');\n\nfunction markAsTraceFactory(fn: object): void {\n  TRACE_FACTORY_SET.add(fn);\n}\n\nfunction hasFactoryMark(fn: object): boolean {\n  return TRACE_FACTORY_SET.has(fn);\n}\n\nfunction sanitizeParameterToken(token: string): string {\n  const [firstToken] = token.split('=');\n  return (firstToken ?? '').replaceAll(PARAM_TOKEN_SANITIZE_REGEX, '').trim();\n}\n\nfunction getFirstParameterToken(fn: GenericFunction): string | null {\n  let source = Function.prototype.toString.call(fn);\n  source = source\n    .replaceAll(MULTI_LINE_COMMENT_REGEX, '')\n    .replaceAll(SINGLE_LINE_COMMENT_REGEX, '')\n    .trim();\n\n  // Arrow functions\n  const arrowMatch = source.match(\n    /^(?:async\\s*)?(?:\\(([^)]*)\\)|([^=()]+))\\s*=>/,\n  );\n  if (arrowMatch) {\n    const params = (arrowMatch[1] ?? arrowMatch[2] ?? '').split(',');\n    const first = params[0]?.trim();\n    if (first) {\n      return sanitizeParameterToken(first);\n    }\n    return null;\n  }\n\n  // Function declarations/expressions\n  const functionMatch = source.match(/^[^(]*\\(([^)]*)\\)/);\n  if (functionMatch) {\n    const params = functionMatch[1]?.split(',');\n    const first = params?.[0]?.trim();\n    if (first) {\n      return sanitizeParameterToken(first);\n    }\n  }\n\n  return null;\n}\n\n/**\n * Symbol that explicitly marks a function as immediate-execution-with-ctx\n * (`(ctx) => result`), bypassing parameter-name introspection. Library\n * authors who wrap user handlers — like `autotel-aws/lambda`'s `wrapHandler`\n * — should mark their inner trace function with this so dispatch survives\n * downstream bundlers that minify parameter names.\n */\nconst IMMEDIATE_EXECUTION_SYMBOL = Symbol.for('autotel.immediate-execution');\n\ntype ImmediateExecutionFlag = {\n  [IMMEDIATE_EXECUTION_SYMBOL]?: true;\n};\n\nfunction hasImmediateExecutionMark(fn: unknown): boolean {\n  return (\n    typeof fn === 'function' &&\n    (fn as ImmediateExecutionFlag)[IMMEDIATE_EXECUTION_SYMBOL] === true\n  );\n}\n\n/**\n * Mark a function as immediate-execution-with-ctx so `trace(name, fn)`\n * dispatch doesn't depend on the first parameter being named `ctx`.\n *\n * Necessary when the function will be bundled by a minifier (esbuild,\n * terser, etc.) that renames identifiers. The name-allowlist heuristic in\n * `looksLikeTraceFactory` cannot recover from that; the marker can.\n *\n * @example\n * ```ts\n * import { markAsImmediate, trace } from 'autotel';\n *\n * const inner = markAsImmediate(async (ctx) => {\n *   ctx.setAttribute('user.id', '123');\n *   return { ok: true };\n * });\n * const result = await trace('user.read', inner);\n * ```\n */\nexport function markAsImmediate<F>(fn: F): F {\n  if (typeof fn === 'function') {\n    (fn as unknown as ImmediateExecutionFlag)[IMMEDIATE_EXECUTION_SYMBOL] =\n      true;\n  }\n  return fn;\n}\n\nfunction looksLikeTraceFactory(fn: GenericFunction): boolean {\n  if (hasFactoryMark(fn)) {\n    return true;\n  }\n  if (hasImmediateExecutionMark(fn)) {\n    return true;\n  }\n\n  if (fn.length === 0) {\n    if (!isAsyncFunction(fn)) {\n      try {\n        const result = fn();\n        return typeof result === 'function';\n      } catch {\n        return false;\n      }\n    }\n    return false;\n  }\n\n  const firstParam = getFirstParameterToken(fn);\n  if (!firstParam) {\n    return false;\n  }\n\n  const normalized = firstParam.toLowerCase();\n  if (\n    FACTORY_NAME_HINTS.has(normalized) ||\n    normalized.startsWith('ctx') ||\n    normalized.startsWith('_ctx') ||\n    normalized.startsWith('trace') ||\n    normalized.endsWith('ctx') || // Match baseCtx, spanCtx, etc.\n    normalized.includes('context') // Match traceContext, spanContext, etc.\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Check if a function that takes ctx returns another function (factory pattern)\n * vs returning a value directly (immediate execution pattern)\n *\n * IMPORTANT: For async functions, we skip probing entirely and assume immediate execution.\n * This is because:\n * - Factory pattern: `(ctx) => async (...args) => result` - outer function is SYNC\n * - Immediate execution: `async (ctx) => result` - function itself is ASYNC\n *\n * Probing async functions by executing them causes side effects (like creating orphan spans)\n * because the async function starts executing synchronously until the first await.\n */\nfunction isFactoryReturningFunction(\n  fnWithCtx: (ctx: TraceContext) => unknown,\n): boolean {\n  // Async functions with ctx parameter are always immediate execution\n  // because factory patterns have a sync outer function that returns the async inner\n  if (isAsyncFunction(fnWithCtx)) {\n    return false;\n  }\n\n  try {\n    const result = fnWithCtx(createDummyCtx());\n    return typeof result === 'function';\n  } catch {\n    // If the function throws when called with dummy ctx, assume it's immediate execution\n    // since factory functions typically just return a function and don't execute logic\n    return false;\n  }\n}\n\nfunction isTraceFactoryFunction<TArgs extends unknown[], TReturn>(\n  fn:\n    | ((...args: TArgs) => TReturn)\n    | ((ctx: TraceContext) => (...args: TArgs) => TReturn),\n): fn is (ctx: TraceContext) => (...args: TArgs) => TReturn {\n  if (typeof fn !== 'function') {\n    return false;\n  }\n\n  if (hasFactoryMark(fn)) {\n    return true;\n  }\n\n  if (looksLikeTraceFactory(fn as GenericFunction)) {\n    markAsTraceFactory(fn);\n    return true;\n  }\n\n  return false;\n}\n\nfunction ensureTraceFactory<TArgs extends unknown[], TReturn>(\n  fnOrFactory:\n    | ((...args: TArgs) => TReturn | Promise<TReturn>)\n    | ((ctx: TraceContext) => (...args: TArgs) => TReturn | Promise<TReturn>),\n): (ctx: TraceContext) => (...args: TArgs) => TReturn | Promise<TReturn> {\n  if (isTraceFactoryFunction(fnOrFactory)) {\n    return fnOrFactory;\n  }\n\n  const plainFn = fnOrFactory as (...args: TArgs) => TReturn | Promise<TReturn>;\n  const factory = (ctx: TraceContext) => {\n    void ctx;\n    return plainFn;\n  };\n  markAsTraceFactory(factory);\n  return factory;\n}\n\ntype WrappedFunction<TArgs extends unknown[], TReturn> = (\n  ...args: TArgs\n) => TReturn | Promise<TReturn>;\n\nfunction wrapFactoryWithTracing<TArgs extends unknown[], TReturn>(\n  fnOrFactory:\n    | ((...args: TArgs) => TReturn | Promise<TReturn>)\n    | ((ctx: TraceContext) => (...args: TArgs) => TReturn | Promise<TReturn>),\n  options: TracingOptions<TArgs, TReturn>,\n  variableName?: string,\n): WrappedFunction<TArgs, TReturn> {\n  const factory = ensureTraceFactory(fnOrFactory);\n\n  // Get the inner function (the actual function being traced)\n  const sampleFn = factory(createDummyCtx());\n\n  // Infer function name with priority:\n  // 1. Explicit variable name (from instrument() or explicit name parameter)\n  // 2. Inner function name (named function expressions - e.g., \"async function createUser\")\n  // 3. Variable name from call stack (inferred from const assignment, for arrow functions)\n  // 4. Factory function name (for cases where factory itself is named)\n  const innerFunctionName = inferFunctionName(\n    sampleFn as InstrumentableFunction,\n  );\n  const callStackVariableName = innerFunctionName\n    ? undefined\n    : inferVariableNameFromCallStack(); // Only infer from call stack if no inner function name\n  const factoryName = inferFunctionName(factory as InstrumentableFunction);\n  const effectiveVariableName =\n    variableName || innerFunctionName || callStackVariableName || factoryName;\n\n  const useAsyncWrapper = isAsyncFunction(sampleFn);\n\n  if (useAsyncWrapper) {\n    return wrapWithTracing(\n      factory as (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n      options,\n      effectiveVariableName,\n    ) as WrappedFunction<TArgs, TReturn>;\n  }\n\n  return wrapWithTracingSync(\n    factory as (ctx: TraceContext) => (...args: TArgs) => TReturn,\n    options,\n    effectiveVariableName,\n  ) as WrappedFunction<TArgs, TReturn>;\n}\n\n/**\n * Common options for functional tracing\n */\nexport interface TracingOptions<\n  TArgs extends unknown[] = unknown[],\n  TReturn = unknown,\n> {\n  /**\n   * Span name (highest priority)\n   * If provided, this is used as the span name\n   */\n  name?: string;\n\n  /**\n   * Service name (used to compose final span name)\n   * If name not provided, span name becomes: ${serviceName}.${functionName}\n   */\n  serviceName?: string;\n\n  /**\n   * Sampling strategy\n   * @default AlwaysSampler\n   */\n  sampler?: Sampler;\n\n  /**\n   * Enable metrics collection (counter, histogram)\n   * @default false\n   */\n  withMetrics?: boolean;\n\n  /**\n   * Extract attributes from function arguments\n   */\n  attributesFromArgs?: (args: TArgs) => Record<string, unknown>;\n\n  /**\n   * Extract attributes from function result\n   */\n  attributesFromResult?: (result: TReturn) => Record<string, unknown>;\n\n  /**\n   * Capture the function arguments onto the span as `autotel.input`\n   * (JSON, truncated). One arg is captured directly; multiple are captured as\n   * an array. Off by default — opt in per call. Tools (visualizers, devtools)\n   * read this alongside `ai.toolCall.args` to show function I/O uniformly.\n   * Avoid on args with secrets/PII, or pair with a redacting processor.\n   */\n  captureInput?: boolean;\n\n  /**\n   * Capture the function return value onto the span as `autotel.output`\n   * (JSON, truncated). Off by default. Same caveats as {@link captureInput}.\n   */\n  captureOutput?: boolean;\n\n  /**\n   * Start a new root span instead of creating a child\n   * Useful for serverless entry points\n   * @default false\n   */\n  startNewRoot?: boolean;\n\n  /**\n   * Flush events queue when span ends\n   * Only flushes on root spans (to avoid excessive flushing)\n   * @default true\n   */\n  flushOnRootSpanEnd?: boolean;\n\n  /**\n   * Span kind for semantic convention compliance\n   * Used for messaging (PRODUCER/CONSUMER), HTTP (CLIENT/SERVER), etc.\n   * @default SpanKind.INTERNAL\n   */\n  spanKind?: import('@opentelemetry/api').SpanKind;\n}\n\n/**\n * Options for instrument() batch instrumentation\n */\nexport interface InstrumentOptions<\n  T extends Record<string, InstrumentableFunction> = Record<\n    string,\n    InstrumentableFunction\n  >,\n> extends TracingOptions {\n  /** Functions to instrument */\n  functions: T;\n  /**\n   * Per-function configuration overrides\n   */\n  overrides?: Record<string, Partial<TracingOptions>>;\n\n  /**\n   * Functions to skip (won't be instrumented)\n   * Supports:\n   * - String keys: 'functionName'\n   * - RegExp: /^_internal/\n   * - Predicate: (key, fn) => boolean\n   *\n   * By default, functions starting with _ are skipped\n   */\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  skip?: (string | RegExp | ((key: string, fn: Function) => boolean))[];\n}\n\n// Maximum error message length to prevent span bloat\nconst MAX_ERROR_MESSAGE_LENGTH = 500;\n\nfunction createDummyCtx<\n  TBaggage extends Record<string, unknown> | undefined = undefined,\n>(): TraceContext<TBaggage> {\n  // `recordException` / `addEvent` are no-op shims kept for the same\n  // compatibility window as `createTraceContext` (see trace-context.ts).\n  return {\n    traceId: '',\n    spanId: '',\n    correlationId: '',\n    setAttribute: () => {},\n    setAttributes: () => {},\n    setStatus: () => {},\n    recordException: () => {},\n    addEvent: () => {},\n    addLink: () => {},\n    addLinks: () => {},\n    updateName: () => {},\n    isRecording: () => false,\n    getBaggage: () => {},\n    setBaggage: () => '',\n    deleteBaggage: () => {},\n    getAllBaggage: () => new Map(),\n  } as unknown as TraceContext<TBaggage>;\n}\n\n/** Attribute keys for opt-in function I/O capture (see TracingOptions). */\nconst AUTOTEL_INPUT_ATTR = 'autotel.input';\nconst AUTOTEL_OUTPUT_ATTR = 'autotel.output';\nconst CAPTURE_MAX_CHARS = 4096;\n\n/** JSON-serialize a captured value, defensively (truncate, swallow cycles). */\nfunction serializeCapture(value: unknown): string | undefined {\n  if (value === undefined) return undefined;\n  try {\n    const json = typeof value === 'string' ? value : JSON.stringify(value);\n    if (json === undefined) return undefined;\n    return json.length > CAPTURE_MAX_CHARS\n      ? `${json.slice(0, CAPTURE_MAX_CHARS)}…[truncated]`\n      : json;\n  } catch {\n    return undefined;\n  }\n}\n\n/** `autotel.input` from args (single arg captured directly, else the array). */\nfunction captureInputAttrs(\n  args: unknown[],\n  enabled?: boolean,\n): Record<string, unknown> {\n  if (!enabled) return {};\n  const s = serializeCapture(args.length === 1 ? args[0] : args);\n  return s === undefined ? {} : { [AUTOTEL_INPUT_ATTR]: s };\n}\n\n/** `autotel.output` from the return value. */\nfunction captureOutputAttrs(\n  result: unknown,\n  enabled?: boolean,\n): Record<string, unknown> {\n  if (!enabled) return {};\n  const s = serializeCapture(result);\n  return s === undefined ? {} : { [AUTOTEL_OUTPUT_ATTR]: s };\n}\n\nfunction isAsyncFunction(fn: unknown): boolean {\n  return typeof fn === 'function' && fn.constructor?.name === 'AsyncFunction';\n}\n\n// Symbol to prevent double-instrumentation (idempotency flag)\nconst INSTRUMENTED_SYMBOL = Symbol.for('autotel.functional.instrumented');\n\ntype InstrumentedFlag = {\n  [INSTRUMENTED_SYMBOL]?: true;\n};\n\nfunction hasInstrumentationFlag(value: unknown): value is InstrumentedFlag {\n  return (\n    (typeof value === 'function' || typeof value === 'object') &&\n    value !== null &&\n    Boolean((value as InstrumentedFlag)[INSTRUMENTED_SYMBOL])\n  );\n}\n\n/**\n * Truncate error message to prevent span bloat\n */\nfunction truncateErrorMessage(message: string): string {\n  if (message.length <= MAX_ERROR_MESSAGE_LENGTH) {\n    return message;\n  }\n  return `${message.slice(0, MAX_ERROR_MESSAGE_LENGTH)}... (truncated)`;\n}\n\ntype InstrumentableFunction<\n  TArgs extends unknown[] = unknown[],\n  TReturn = unknown,\n> = ((...args: TArgs) => TReturn | Promise<TReturn>) & {\n  displayName?: string;\n  name?: string;\n};\n\n/**\n * Try to infer function name from function properties\n * Checks for displayName, name, or other metadata that might be set\n */\nfunction inferFunctionName<\n  TArgs extends unknown[] = unknown[],\n  TReturn = unknown,\n>(fn: InstrumentableFunction<TArgs, TReturn>): string | undefined {\n  // Check for displayName property (sometimes set by bundlers)\n  const displayName = (fn as { displayName?: string }).displayName;\n  if (displayName) {\n    return displayName;\n  }\n\n  // Check function.name (works for named functions and modern arrow function assignment)\n  // Note: Empty string is falsy, so this handles both undefined and ''\n  if (fn.name && fn.name !== 'anonymous' && fn.name !== '') {\n    return fn.name;\n  }\n\n  // Try to extract name from function source (for function declarations)\n  const source = Function.prototype.toString.call(fn);\n  const match = source.match(/function\\s+([^(\\s]+)/);\n  if (match && match[1] && match[1] !== 'anonymous') {\n    return match[1];\n  }\n\n  return undefined;\n}\n\n/**\n * Determine span name using priority:\n * 1. Explicit name option\n * 2. serviceName + functionName\n * 3. Inferred from function/variable name (including stack trace fallback)\n * 4. Fallback to 'unknown'\n */\nfunction getSpanName<TArgs extends unknown[], TReturn>(\n  options: TracingOptions<TArgs, TReturn>,\n  fn: InstrumentableFunction<TArgs, TReturn>,\n  variableName?: string,\n): string {\n  // 1. Explicit name\n  if (options.name) {\n    return options.name;\n  }\n\n  // 2. Try variable name, function name, or function properties\n  let fnName = variableName || inferFunctionName(fn);\n\n  // Default to 'anonymous' if still no name\n  fnName = fnName || 'anonymous';\n\n  // 2. serviceName + functionName\n  if (options.serviceName) {\n    return `${options.serviceName}.${fnName}`;\n  }\n\n  // 3. Inferred from function name\n  if (fnName && fnName !== 'anonymous') {\n    return fnName;\n  }\n\n  // 4. Fallback\n  return 'unknown';\n}\n\n/**\n * Check if function should be skipped\n */\nfunction shouldSkip(\n  key: string,\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  fn: Function,\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  skip?: (string | RegExp | ((key: string, fn: Function) => boolean))[],\n): boolean {\n  // Default: skip functions starting with _\n  if (key.startsWith('_')) {\n    return true;\n  }\n\n  if (!skip || skip.length === 0) {\n    return false;\n  }\n\n  for (const rule of skip) {\n    if (typeof rule === 'string' && key === rule) {\n      return true;\n    } else if (rule instanceof RegExp && rule.test(key)) {\n      return true;\n    } else if (typeof rule === 'function' && rule(key, fn)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Get current trace context value (internal helper)\n *\n * Returns base context (trace IDs) + span methods from the active span.\n */\nfunction getCtxValue<\n  TBaggage extends Record<string, unknown> | undefined = undefined,\n>(): TraceContext<TBaggage> | null {\n  const activeSpan = otelTrace.getActiveSpan();\n  if (!activeSpan) return null;\n\n  // Use shared utility to create trace context\n  return createTraceContext<TBaggage>(activeSpan);\n}\n\n/**\n * Context object that lazily evaluates the active span on property access\n *\n * Access trace context directly without function call syntax.\n *\n * @example\n * ```typescript\n * import { trace, ctx } from 'autotel'\n *\n * export const createUser = trace(async (data) => {\n *   // Direct property access - no function call!\n *   if (ctx.traceId) {\n *     ctx.setAttribute('user.id', data.id)\n *     console.log('Trace:', ctx.traceId)\n *   }\n * })\n * ```\n */\nexport const ctx = new Proxy(\n  {},\n  {\n    get(_target, prop) {\n      const ctxValue = getCtxValue();\n      if (!ctxValue) {\n        return;\n      }\n      return ctxValue[prop as keyof typeof ctxValue];\n    },\n\n    has(_target, prop) {\n      const ctxValue = getCtxValue();\n      if (!ctxValue) {\n        return false;\n      }\n      return prop in ctxValue;\n    },\n\n    ownKeys() {\n      const ctxValue = getCtxValue();\n      if (!ctxValue) {\n        return [];\n      }\n      return Object.keys(ctxValue);\n    },\n\n    getOwnPropertyDescriptor(_target, prop) {\n      const ctxValue = getCtxValue();\n      if (!ctxValue) {\n        return;\n      }\n      return Object.getOwnPropertyDescriptor(ctxValue, prop);\n    },\n  },\n);\n\n/**\n * Core tracing wrapper for async functions (internal implementation)\n */\nfunction wrapWithTracing<TArgs extends unknown[], TReturn>(\n  fnFactory: (\n    ctx: TraceContext,\n  ) => (...args: TArgs) => TReturn | Promise<TReturn>,\n  options: TracingOptions<TArgs, TReturn>,\n  variableName?: string,\n): (...args: TArgs) => Promise<TReturn> {\n  // Idempotency check: if already instrumented, return as-is\n  if (hasInstrumentationFlag(fnFactory)) {\n    // Already instrumented - proceed\n  }\n\n  const config = getConfig();\n  const tracer = config.tracer;\n  const meter = config.meter;\n  const sampler = options.sampler || new AlwaysSampler();\n\n  const tempFn = fnFactory(createDummyCtx());\n  const spanName = getSpanName(options, tempFn, variableName);\n\n  const callCounter = options.withMetrics\n    ? meter.createCounter(`${spanName}.calls`, {\n        description: `Call count for ${spanName}`,\n        unit: '1',\n      })\n    : undefined;\n\n  const durationHistogram = options.withMetrics\n    ? meter.createHistogram(`${spanName}.duration`, {\n        description: `Duration for ${spanName}`,\n        unit: 'ms',\n      })\n    : undefined;\n\n  const wrappedFunction = async function wrappedFunction(\n    this: unknown,\n    ...args: TArgs\n  ): Promise<TReturn> {\n    const samplingContext: SamplingContext = {\n      operationName: spanName,\n      args,\n      metadata: {},\n    };\n\n    const shouldSample = sampler.shouldSample(samplingContext);\n    const needsTailSampling =\n      'needsTailSampling' in sampler &&\n      typeof sampler.needsTailSampling === 'function'\n        ? sampler.needsTailSampling()\n        : false;\n\n    if (!shouldSample && !needsTailSampling) {\n      const fn = fnFactory(createDummyCtx());\n      return await fn.call(this, ...args);\n    }\n\n    const startTime = performance.now();\n    const isRootSpan =\n      options.startNewRoot || otelTrace.getActiveSpan() === undefined;\n    const shouldAutoFlush =\n      options.flushOnRootSpanEnd ?? getInitConfig()?.flushOnRootSpanEnd ?? true;\n    const shouldAutoFlushSpans = getInitConfig()?.forceFlushOnShutdown ?? false;\n\n    const flushIfNeeded = async () => {\n      if (!shouldAutoFlush || !isRootSpan) return;\n\n      try {\n        // Flush events queue\n        const queue = getEventQueue();\n        if (queue && queue.size() > 0) {\n          await queue.flush();\n        }\n\n        // Flush OpenTelemetry spans if enabled\n        if (shouldAutoFlushSpans) {\n          const sdk = getSdk();\n          if (sdk) {\n            try {\n              // Type assertion needed as getTracerProvider is not in the public NodeSDK interface\n              // eslint-disable-next-line @typescript-eslint/no-explicit-any\n              const sdkAny = sdk as any;\n              if (typeof sdkAny.getTracerProvider === 'function') {\n                const tracerProvider = sdkAny.getTracerProvider();\n                if (\n                  tracerProvider &&\n                  typeof tracerProvider.forceFlush === 'function'\n                ) {\n                  await tracerProvider.forceFlush();\n                }\n              }\n            } catch {\n              // Ignore errors when accessing tracer provider (may not be available in test mocks)\n            }\n          }\n        }\n      } catch (error) {\n        const initConfig = getInitConfig();\n        const logger = initConfig?.logger;\n        if (logger?.error) {\n          logger.error(\n            {\n              err: error instanceof Error ? error : undefined,\n            },\n            `[autotel] Auto-flush failed${error instanceof Error ? '' : `: ${String(error)}`}`,\n          );\n        }\n      }\n    };\n\n    // Build span options including root and kind\n    const spanOptions: import('@opentelemetry/api').SpanOptions = {};\n    if (options.startNewRoot) {\n      spanOptions.root = true;\n    }\n    if (options.spanKind !== undefined) {\n      spanOptions.kind = options.spanKind;\n    }\n\n    const parentContext = getActiveContextWithBaggage();\n    return tracer.startActiveSpan(\n      spanName,\n      spanOptions,\n      parentContext,\n      async (span) => {\n        // Run within operation context so events can auto-capture operation.name\n        return runInOperationContext(spanName, async () => {\n          let shouldKeepSpan = true;\n\n          setSpanName(span, spanName);\n\n          // Initialize context storage with the active context BEFORE creating trace context\n          const initialContext = context.active();\n          const contextStorage = getContextStorage();\n          if (!contextStorage.getStore()) {\n            enterOrRun(contextStorage, initialContext);\n          }\n\n          const ctxValue = createTraceContext(span);\n          const fn = fnFactory(ctxValue);\n          const argsAttributes = {\n            ...captureInputAttrs(args, options.captureInput),\n            ...(options.attributesFromArgs\n              ? options.attributesFromArgs(args)\n              : {}),\n          };\n\n          const handleTailSampling = (\n            success: boolean,\n            duration: number,\n            error?: unknown,\n          ) => {\n            if (\n              needsTailSampling &&\n              'shouldKeepTrace' in sampler &&\n              typeof sampler.shouldKeepTrace === 'function'\n            ) {\n              shouldKeepSpan = sampler.shouldKeepTrace(samplingContext, {\n                success,\n                duration,\n                error,\n              });\n              span.setAttribute(AUTOTEL_SAMPLING_TAIL_KEEP, shouldKeepSpan);\n              span.setAttribute(AUTOTEL_SAMPLING_TAIL_EVALUATED, true);\n            }\n          };\n\n          const onSuccess = async (result: TReturn) => {\n            const duration = performance.now() - startTime;\n\n            callCounter?.add(1, {\n              operation: spanName,\n              status: 'success',\n            });\n\n            durationHistogram?.record(duration, {\n              operation: spanName,\n              status: 'success',\n            });\n\n            const resultAttributes = {\n              ...captureOutputAttrs(result, options.captureOutput),\n              ...(options.attributesFromResult\n                ? options.attributesFromResult(result)\n                : {}),\n            };\n\n            span.setStatus({ code: SpanStatusCode.OK });\n            span.setAttributes({\n              ...argsAttributes,\n              ...resultAttributes,\n              'operation.name': spanName,\n              'code.function': spanName,\n              'operation.duration': duration,\n              'operation.success': true,\n            });\n\n            handleTailSampling(true, duration);\n\n            span.end();\n            await flushIfNeeded();\n            return result;\n          };\n\n          const onError = async (error: unknown): Promise<never> => {\n            const duration = performance.now() - startTime;\n\n            callCounter?.add(1, {\n              operation: spanName,\n              status: 'error',\n            });\n\n            durationHistogram?.record(duration, {\n              operation: spanName,\n              status: 'error',\n            });\n\n            const errorMessage =\n              error instanceof Error ? error.message : 'Unknown error';\n            const truncatedMessage = truncateErrorMessage(errorMessage);\n\n            span.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: truncatedMessage,\n            });\n\n            span.setAttributes({\n              ...argsAttributes,\n              'operation.name': spanName,\n              'code.function': spanName,\n              'operation.duration': duration,\n              'operation.success': false,\n              error: true,\n              'exception.type':\n                error instanceof Error ? error.constructor.name : 'Error',\n              'exception.message': truncatedMessage,\n            });\n\n            if (error instanceof Error && error.stack) {\n              span.setAttribute(\n                'exception.stack',\n                error.stack.slice(0, MAX_ERROR_MESSAGE_LENGTH),\n              );\n            }\n\n            span.recordException(\n              error instanceof Error ? error : new Error(String(error)),\n            );\n\n            handleTailSampling(false, duration, error);\n\n            span.end();\n            await flushIfNeeded();\n            throw error;\n          };\n\n          try {\n            callCounter?.add(1, {\n              operation: spanName,\n              status: 'started',\n            });\n\n            // Execute the user's function with the updated context\n            // This ensures ctx.setBaggage() changes are visible to OpenTelemetry operations\n            // (like BaggageSpanProcessor, child spans, etc.)\n            // We use getActiveContextWithBaggage() which checks the stored context,\n            // so if baggage is set during execution, it will be picked up\n            const executeWithContext = async () => {\n              // Get the current context (may have been updated by ctx.setBaggage())\n              const currentContext = getActiveContextWithBaggage();\n              // Establish the context in OpenTelemetry's context manager\n              return context.with(currentContext, async () => {\n                return fn.call(this, ...args);\n              });\n            };\n            const result = await executeWithContext();\n\n            return await onSuccess(result);\n          } catch (error) {\n            await onError(error);\n            throw error;\n          }\n        });\n      },\n    );\n  };\n\n  // Mark as instrumented to prevent double-wrapping\n  (wrappedFunction as InstrumentedFlag)[INSTRUMENTED_SYMBOL] = true;\n\n  Object.defineProperty(wrappedFunction, 'name', {\n    value: tempFn.name || 'trace',\n    configurable: true,\n  });\n\n  return wrappedFunction;\n}\n\n/**\n * Core tracing wrapper for sync functions (internal implementation)\n */\nfunction wrapWithTracingSync<TArgs extends unknown[], TReturn>(\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn,\n  options: TracingOptions<TArgs, TReturn>,\n  variableName?: string,\n): (...args: TArgs) => TReturn {\n  // Idempotency check: if already instrumented, return as-is\n  if (hasInstrumentationFlag(fnFactory)) {\n    // If already instrumented, we need to extract the original factory\n    // For now, we'll just proceed - this edge case is handled by the wrapped function check\n  }\n\n  const config = getConfig();\n  const tracer = config.tracer;\n  const meter = config.meter;\n  const sampler = options.sampler || new AlwaysSampler();\n\n  // We need to get a reference function name for span naming\n  // Create a minimal dummy context just for extracting the function name\n  // This won't affect actual tracing - we use the real context inside the span\n  const tempFn = fnFactory(createDummyCtx());\n  const spanName = getSpanName(options, tempFn, variableName);\n\n  // Metrics setup (if enabled)\n  const callCounter = options.withMetrics\n    ? meter.createCounter(`${spanName}.calls`, {\n        description: `Call count for ${spanName}`,\n        unit: '1',\n      })\n    : undefined;\n\n  const durationHistogram = options.withMetrics\n    ? meter.createHistogram(`${spanName}.duration`, {\n        description: `Duration for ${spanName}`,\n        unit: 'ms',\n      })\n    : undefined;\n\n  // Return wrapped function\n  function wrappedFunction(\n    this: unknown,\n    ...args: TArgs\n  ): TReturn | Promise<TReturn> {\n    const samplingContext: SamplingContext = {\n      operationName: spanName,\n      args,\n      metadata: {},\n    };\n\n    const shouldSample = sampler.shouldSample(samplingContext);\n    const needsTailSampling =\n      'needsTailSampling' in sampler &&\n      typeof sampler.needsTailSampling === 'function'\n        ? sampler.needsTailSampling()\n        : false;\n\n    // If not sampling and no tail sampling, execute without tracing\n    if (!shouldSample && !needsTailSampling) {\n      const fn = fnFactory(createDummyCtx());\n      return fn.call(this, ...args);\n    }\n\n    const startTime = performance.now();\n\n    // Track if this is a root span for auto-flush\n    const isRootSpan =\n      options.startNewRoot || otelTrace.getActiveSpan() === undefined;\n    const shouldAutoFlush =\n      options.flushOnRootSpanEnd ?? getInitConfig()?.flushOnRootSpanEnd ?? true;\n    const shouldAutoFlushSpans = getInitConfig()?.forceFlushOnShutdown ?? false;\n\n    // Note: This is intentionally fire-and-forget (void) for synchronous functions.\n    // Synchronous functions cannot await flush completion without blocking execution.\n    // The forceFlushOnShutdown guarantee only applies to async functions.\n    const flushIfNeeded = () => {\n      if (!shouldAutoFlush || !isRootSpan) return;\n\n      // Flush events queue\n      const queue = getEventQueue();\n      if (queue && queue.size() > 0) {\n        void queue.flush().catch((error) => {\n          const initConfig = getInitConfig();\n          const logger = initConfig?.logger;\n          if (logger?.error) {\n            logger.error(\n              {\n                err: error instanceof Error ? error : undefined,\n              },\n              `[autotel] Auto-flush failed${error instanceof Error ? '' : `: ${String(error)}`}`,\n            );\n          }\n        });\n      }\n\n      // Flush OpenTelemetry spans if enabled\n      if (shouldAutoFlushSpans) {\n        const sdk = getSdk();\n        if (sdk) {\n          try {\n            // Type assertion needed as getTracerProvider is not in the public NodeSDK interface\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            const sdkAny = sdk as any;\n            if (typeof sdkAny.getTracerProvider === 'function') {\n              const tracerProvider = sdkAny.getTracerProvider();\n              if (\n                tracerProvider &&\n                typeof tracerProvider.forceFlush === 'function'\n              ) {\n                void tracerProvider.forceFlush().catch((error: unknown) => {\n                  const initConfig = getInitConfig();\n                  const logger = initConfig?.logger;\n                  if (logger?.error) {\n                    logger.error(\n                      {\n                        err: error instanceof Error ? error : undefined,\n                      },\n                      `[autotel] Span flush failed${error instanceof Error ? '' : `: ${String(error)}`}`,\n                    );\n                  }\n                });\n              }\n            }\n          } catch {\n            // Ignore errors when accessing tracer provider (may not be available in test mocks)\n          }\n        }\n      }\n    };\n\n    // Build span options including root and kind\n    const spanOptions: import('@opentelemetry/api').SpanOptions = {};\n    if (options.startNewRoot) {\n      spanOptions.root = true;\n    }\n    if (options.spanKind !== undefined) {\n      spanOptions.kind = options.spanKind;\n    }\n\n    const parentContext = getActiveContextWithBaggage();\n    return tracer.startActiveSpan(\n      spanName,\n      spanOptions,\n      parentContext,\n      (span) => {\n        // Run within operation context so events can auto-capture operation.name\n        return runInOperationContext(spanName, () => {\n          let shouldKeepSpan = true;\n\n          // Store span name for trace context helpers\n          setSpanName(span, spanName);\n\n          // Create trace context for this span using shared utility\n          const ctxValue = createTraceContext(span);\n\n          // Get the actual function from the factory\n          const fn = fnFactory(ctxValue);\n\n          // Extract attributes only when actually tracing\n          // This avoids expensive preprocessing when sampling rejects the trace\n          const argsAttributes = {\n            ...captureInputAttrs(args, options.captureInput),\n            ...(options.attributesFromArgs\n              ? options.attributesFromArgs(args)\n              : {}),\n          };\n\n          const handleTailSampling = (\n            success: boolean,\n            duration: number,\n            error?: unknown,\n          ) => {\n            if (\n              needsTailSampling &&\n              'shouldKeepTrace' in sampler &&\n              typeof sampler.shouldKeepTrace === 'function'\n            ) {\n              shouldKeepSpan = sampler.shouldKeepTrace(samplingContext, {\n                success,\n                duration,\n                error,\n              });\n              span.setAttribute(AUTOTEL_SAMPLING_TAIL_KEEP, shouldKeepSpan);\n              span.setAttribute(AUTOTEL_SAMPLING_TAIL_EVALUATED, true);\n            }\n          };\n\n          const onSuccess = (result: TReturn) => {\n            const duration = performance.now() - startTime;\n\n            callCounter?.add(1, {\n              operation: spanName,\n              status: 'success',\n            });\n\n            durationHistogram?.record(duration, {\n              operation: spanName,\n              status: 'success',\n            });\n\n            const resultAttributes = {\n              ...captureOutputAttrs(result, options.captureOutput),\n              ...(options.attributesFromResult\n                ? options.attributesFromResult(result)\n                : {}),\n            };\n\n            span.setStatus({ code: SpanStatusCode.OK });\n            span.setAttributes({\n              ...argsAttributes,\n              ...resultAttributes,\n              'operation.name': spanName,\n              'code.function': spanName,\n              'operation.duration': duration,\n              'operation.success': true,\n            });\n\n            handleTailSampling(true, duration);\n\n            span.end();\n            void flushIfNeeded();\n            return result;\n          };\n\n          const onError = (error: unknown): never => {\n            const duration = performance.now() - startTime;\n\n            callCounter?.add(1, {\n              operation: spanName,\n              status: 'error',\n            });\n\n            durationHistogram?.record(duration, {\n              operation: spanName,\n              status: 'error',\n            });\n\n            const errorMessage =\n              error instanceof Error ? error.message : 'Unknown error';\n            const truncatedMessage = truncateErrorMessage(errorMessage);\n\n            span.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: truncatedMessage,\n            });\n\n            span.setAttributes({\n              ...argsAttributes,\n              'operation.name': spanName,\n              'code.function': spanName,\n              'operation.duration': duration,\n              'operation.success': false,\n              error: true,\n              'exception.type':\n                error instanceof Error ? error.constructor.name : 'Error',\n              'exception.message': truncatedMessage,\n            });\n\n            span.recordException(\n              error instanceof Error ? error : new Error(String(error)),\n            );\n\n            handleTailSampling(false, duration, error);\n\n            span.end();\n            void flushIfNeeded();\n            throw error;\n          };\n\n          try {\n            callCounter?.add(1, {\n              operation: spanName,\n              status: 'started',\n            });\n\n            const result = fn.call(this, ...args);\n\n            if (result instanceof Promise) {\n              return result.then(onSuccess, onError);\n            }\n\n            return onSuccess(result);\n          } catch (error) {\n            return onError(error);\n          }\n        });\n      },\n    );\n  }\n\n  // Mark as instrumented to prevent double-wrapping\n  (wrappedFunction as InstrumentedFlag)[INSTRUMENTED_SYMBOL] = true;\n\n  // Preserve function name for better debugging\n  // Use the same tempFn we created earlier for span naming\n  Object.defineProperty(wrappedFunction, 'name', {\n    value: tempFn.name || 'trace',\n    configurable: true,\n  });\n\n  return wrappedFunction as unknown as (...args: TArgs) => TReturn;\n}\n\n/**\n * Execute a function immediately within a trace span\n * Used for the immediate execution pattern: trace((ctx) => result)\n */\nfunction executeImmediately<TReturn = unknown>(\n  fn: (ctx: TraceContext) => TReturn | Promise<TReturn>,\n  options: TracingOptions<unknown[], unknown>,\n): TReturn | Promise<TReturn> {\n  const config = getConfig();\n  const tracer = config.tracer;\n  const meter = config.meter;\n  const sampler = options.sampler || new AlwaysSampler();\n\n  // Get span name from options or use 'anonymous'\n  const spanName = options.name || 'anonymous';\n\n  const samplingContext: SamplingContext = {\n    operationName: spanName,\n    args: [],\n    metadata: {},\n  };\n\n  const shouldSample = sampler.shouldSample(samplingContext);\n  const needsTailSampling =\n    'needsTailSampling' in sampler &&\n    typeof sampler.needsTailSampling === 'function'\n      ? sampler.needsTailSampling()\n      : false;\n\n  if (!shouldSample && !needsTailSampling) {\n    return fn(createDummyCtx());\n  }\n\n  const startTime = performance.now();\n  const isRootSpan =\n    options.startNewRoot || otelTrace.getActiveSpan() === undefined;\n  const shouldAutoFlush =\n    options.flushOnRootSpanEnd ?? getInitConfig()?.flushOnRootSpanEnd ?? true;\n  const shouldAutoFlushSpans = getInitConfig()?.forceFlushOnShutdown ?? false;\n\n  const callCounter = options.withMetrics\n    ? meter.createCounter(`${spanName}.calls`, {\n        description: `Call count for ${spanName}`,\n        unit: '1',\n      })\n    : undefined;\n\n  const durationHistogram = options.withMetrics\n    ? meter.createHistogram(`${spanName}.duration`, {\n        description: `Duration for ${spanName}`,\n        unit: 'ms',\n      })\n    : undefined;\n\n  const flushIfNeeded = async () => {\n    if (!shouldAutoFlush || !isRootSpan) return;\n\n    try {\n      // Flush events queue\n      const queue = getEventQueue();\n      if (queue && queue.size() > 0) {\n        await queue.flush();\n      }\n\n      // Flush OpenTelemetry spans if enabled\n      if (shouldAutoFlushSpans) {\n        const sdk = getSdk();\n        if (sdk) {\n          try {\n            // Type assertion needed as getTracerProvider is not in the public NodeSDK interface\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            const sdkAny = sdk as any;\n            if (typeof sdkAny.getTracerProvider === 'function') {\n              const tracerProvider = sdkAny.getTracerProvider();\n              if (\n                tracerProvider &&\n                typeof tracerProvider.forceFlush === 'function'\n              ) {\n                await tracerProvider.forceFlush();\n              }\n            }\n          } catch {\n            // Ignore errors when accessing tracer provider (may not be available in test mocks)\n          }\n        }\n      }\n    } catch (error) {\n      const initConfig = getInitConfig();\n      const logger = initConfig?.logger;\n      if (logger?.error) {\n        logger.error(\n          {\n            err: error instanceof Error ? error : undefined,\n          },\n          `[autotel] Auto-flush failed${error instanceof Error ? '' : `: ${String(error)}`}`,\n        );\n      }\n    }\n  };\n\n  // Build span options including root and kind\n  const spanOptions: import('@opentelemetry/api').SpanOptions = {};\n  if (options.startNewRoot) {\n    spanOptions.root = true;\n  }\n  if (options.spanKind !== undefined) {\n    spanOptions.kind = options.spanKind;\n  }\n\n  const parentContext = getActiveContextWithBaggage();\n  return tracer.startActiveSpan(\n    spanName,\n    spanOptions,\n    parentContext,\n    (span) => {\n      return runInOperationContext(spanName, () => {\n        let shouldKeepSpan = true;\n\n        setSpanName(span, spanName);\n        const ctxValue = createTraceContext(span);\n\n        const handleTailSampling = (\n          success: boolean,\n          duration: number,\n          error?: unknown,\n        ) => {\n          if (\n            needsTailSampling &&\n            'shouldKeepTrace' in sampler &&\n            typeof sampler.shouldKeepTrace === 'function'\n          ) {\n            shouldKeepSpan = sampler.shouldKeepTrace(samplingContext, {\n              success,\n              duration,\n              error,\n            });\n            span.setAttribute(AUTOTEL_SAMPLING_TAIL_KEEP, shouldKeepSpan);\n            span.setAttribute(AUTOTEL_SAMPLING_TAIL_EVALUATED, true);\n          }\n        };\n\n        // Sync handlers for synchronous results (can't await)\n        // NOTE: forceFlushOnShutdown will NOT block for synchronous trace() calls\n        // Flush is fire-and-forget, so spans may be dropped if process exits immediately\n        const onSuccessSync = (result: TReturn) => {\n          const duration = performance.now() - startTime;\n\n          callCounter?.add(1, {\n            operation: spanName,\n            status: 'success',\n          });\n\n          durationHistogram?.record(duration, {\n            operation: spanName,\n            status: 'success',\n          });\n\n          span.setStatus({ code: SpanStatusCode.OK });\n          span.setAttributes({\n            'operation.name': spanName,\n            'code.function': spanName,\n            'operation.duration': duration,\n            'operation.success': true,\n          });\n\n          handleTailSampling(true, duration);\n\n          span.end();\n          void flushIfNeeded();\n          return result;\n        };\n\n        const onErrorSync = (error: unknown): never => {\n          const duration = performance.now() - startTime;\n\n          callCounter?.add(1, {\n            operation: spanName,\n            status: 'error',\n          });\n\n          durationHistogram?.record(duration, {\n            operation: spanName,\n            status: 'error',\n          });\n\n          const errorMessage =\n            error instanceof Error ? error.message : 'Unknown error';\n          const truncatedMessage = truncateErrorMessage(errorMessage);\n\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: truncatedMessage,\n          });\n\n          span.setAttributes({\n            'operation.name': spanName,\n            'code.function': spanName,\n            'operation.duration': duration,\n            'operation.success': false,\n            error: true,\n            'exception.type':\n              error instanceof Error ? error.constructor.name : 'Error',\n            'exception.message': truncatedMessage,\n          });\n\n          if (error instanceof Error && error.stack) {\n            span.setAttribute(\n              'exception.stack',\n              error.stack.slice(0, MAX_ERROR_MESSAGE_LENGTH),\n            );\n          }\n\n          span.recordException(\n            error instanceof Error ? error : new Error(String(error)),\n          );\n\n          handleTailSampling(false, duration, error);\n\n          span.end();\n          void flushIfNeeded();\n          throw error;\n        };\n\n        // Async handlers for Promise results (await flush)\n        const onSuccessAsync = async (result: TReturn) => {\n          const duration = performance.now() - startTime;\n\n          callCounter?.add(1, {\n            operation: spanName,\n            status: 'success',\n          });\n\n          durationHistogram?.record(duration, {\n            operation: spanName,\n            status: 'success',\n          });\n\n          span.setStatus({ code: SpanStatusCode.OK });\n          span.setAttributes({\n            'operation.name': spanName,\n            'code.function': spanName,\n            'operation.duration': duration,\n            'operation.success': true,\n          });\n\n          handleTailSampling(true, duration);\n\n          span.end();\n          await flushIfNeeded();\n          return result;\n        };\n\n        const onErrorAsync = async (error: unknown): Promise<never> => {\n          const duration = performance.now() - startTime;\n\n          callCounter?.add(1, {\n            operation: spanName,\n            status: 'error',\n          });\n\n          durationHistogram?.record(duration, {\n            operation: spanName,\n            status: 'error',\n          });\n\n          const errorMessage =\n            error instanceof Error ? error.message : 'Unknown error';\n          const truncatedMessage = truncateErrorMessage(errorMessage);\n\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: truncatedMessage,\n          });\n\n          span.setAttributes({\n            'operation.name': spanName,\n            'code.function': spanName,\n            'operation.duration': duration,\n            'operation.success': false,\n            error: true,\n            'exception.type':\n              error instanceof Error ? error.constructor.name : 'Error',\n            'exception.message': truncatedMessage,\n          });\n\n          if (error instanceof Error && error.stack) {\n            span.setAttribute(\n              'exception.stack',\n              error.stack.slice(0, MAX_ERROR_MESSAGE_LENGTH),\n            );\n          }\n\n          span.recordException(\n            error instanceof Error ? error : new Error(String(error)),\n          );\n\n          handleTailSampling(false, duration, error);\n\n          span.end();\n          await flushIfNeeded();\n          throw error;\n        };\n\n        try {\n          callCounter?.add(1, {\n            operation: spanName,\n            status: 'started',\n          });\n\n          const result = fn(ctxValue);\n\n          // Check if result is a Promise - use async handlers to await flush\n          if (result instanceof Promise) {\n            return result.then(onSuccessAsync, onErrorAsync);\n          }\n\n          // Synchronous result - use sync handlers\n          return onSuccessSync(result);\n        } catch (error) {\n          return onErrorSync(error);\n        }\n      });\n    },\n  );\n}\n\n/**\n * Approach 1: trace() - Zero-ceremony HOF\n *\n * Wrap a single function with automatic tracing.\n * The function receives a context object as the first parameter.\n *\n * Supports two patterns:\n * 1. **Factory pattern** - Returns a traced function: `trace(ctx => (...args) => result)`\n * 2. **Immediate execution** - Executes immediately with tracing: `trace(ctx => result)`\n *\n * @example Auto-inferred name - Plain function\n * ```typescript\n * export const createUser = trace(async (data) => {\n *   return await db.users.create(data)\n * })\n * // → Traced as \"createUser\"\n * ```\n *\n * @example Auto-inferred name - Factory pattern (with ctx access)\n * ```typescript\n * export const createUser = trace(ctx => async (data) => {\n *   ctx.setAttribute('user.id', data.id)\n *   return await db.users.create(data)\n * })\n * // → Traced as \"createUser\", returns wrapped function\n * ```\n *\n * @example Immediate execution - Execute once with tracing\n * ```typescript\n * // Wraps an existing function and executes immediately\n * function timed<T>(fn: () => Promise<T>): Promise<T> {\n *   return trace(async (ctx) => {\n *     ctx.setAttribute('operation', 'timed')\n *     return await fn()\n *   })\n * }\n * // → Executes immediately, returns result directly\n * ```\n *\n * @example Custom name - Plain function\n * ```typescript\n * export const createUser = trace('user.create', async (data) => {\n *   return await db.users.create(data)\n * })\n * // → Traced as \"user.create\"\n * ```\n *\n * @example Custom name - Factory pattern\n * ```typescript\n * export const createUser = trace('user.create', ctx => async (data) => {\n *   ctx.setAttribute('user.id', data.id)\n *   return await db.users.create(data)\n * })\n * // → Traced as \"user.create\"\n * ```\n *\n * @example Custom name - Immediate execution\n * ```typescript\n * const result = trace('fetch.user', async (ctx) => {\n *   ctx.setAttribute('userId', '123')\n *   return await fetchUser('123')\n * })\n * // → Executes immediately with span name \"fetch.user\"\n * ```\n *\n * @example Full options - Plain function\n * ```typescript\n * export const createUser = trace({\n *   name: 'user.create',\n *   sampler: new AdaptiveSampler(),\n *   withMetrics: true\n * }, async (data) => {\n *   return await db.users.create(data)\n * })\n * ```\n *\n * @example Full options - Factory pattern\n * ```typescript\n * export const createUser = trace({\n *   name: 'user.create',\n *   sampler: new AdaptiveSampler(),\n *   withMetrics: true\n * }, ctx => async (data) => {\n *   ctx.setAttribute('user.id', data.id)\n *   return await db.users.create(data)\n * })\n * ```\n */\n// Sync overloads - Ordered from most specific to most generic for better type inference\n\n// Single argument - Specific overloads with TraceContext first\n// Overload 1a: Immediate execution - sync function with context\nexport function trace<\n  TBaggage extends Record<string, unknown> | undefined = undefined,\n  TReturn = unknown,\n>(fn: (ctx: TraceContext<TBaggage>) => TReturn): TReturn;\n// Overload 1b: Factory sync function with no args - non-generic for type inference\nexport function trace<\n  TBaggage extends Record<string, unknown> | undefined = undefined,\n>(fnFactory: (ctx: TraceContext<TBaggage>) => () => unknown): () => unknown;\n// Overload 1c: Factory sync function - non-generic for type inference\nexport function trace<\n  TBaggage extends Record<string, unknown> | undefined = undefined,\n  TArgs extends unknown[] = unknown[],\n  TReturn = unknown,\n>(\n  fnFactory: (ctx: TraceContext<TBaggage>) => (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n// Overload 1d: Factory sync function with no args returning explicit type (typed generic)\nexport function trace<TReturn = unknown>(\n  fnFactory: (ctx: TraceContext) => () => TReturn,\n): () => TReturn;\n// Overload 1e: Factory sync function - use conditional type to extract signature\n// This overload is more specific and helps TypeScript infer types from factory functions\nexport function trace<\n  TFactory extends (ctx: TraceContext) => (...args: unknown[]) => unknown,\n>(fnFactory: TFactory): ExtractFunctionSignature<TFactory>;\n// Overload 1f: Generic factory sync function (fallback)\nexport function trace<TArgs extends unknown[], TReturn = unknown>(\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n\n// Single argument - Plain function overloads (no ctx parameter)\n// Overload 1g: Plain sync function with no args\nexport function trace<TReturn = unknown>(fn: () => TReturn): () => TReturn;\n// Overload 1h: Plain sync function (generic fallback)\nexport function trace<TArgs extends unknown[], TReturn = unknown>(\n  fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n\n// Two arguments - name + function - Specific overloads with TraceContext first\n// Overload 2a: Name + immediate execution sync with context\n// This overload only matches functions that DON'T return functions (factories)\nexport function trace<TReturn = unknown>(\n  name: string,\n  fn: ExcludeFactoryReturn<(ctx: TraceContext) => TReturn>,\n): TReturn;\n// Overload 2b: Name + factory sync function with no args\nexport function trace<TReturn = unknown>(\n  name: string,\n  fnFactory: (ctx: TraceContext) => () => TReturn,\n): () => TReturn;\n// Overload 2c: Name + factory sync function - non-generic for type inference\nexport function trace<TArgs extends unknown[], TReturn>(\n  name: string,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n// Overload 2d: Name + factory sync function - use conditional type to extract signature\n// This overload allows TypeScript to infer types from the factory function parameter\nexport function trace<\n  TFactory extends (ctx: TraceContext) => (...args: unknown[]) => unknown,\n>(name: string, fnFactory: TFactory): ExtractFunctionSignature<TFactory>;\n// Overload 2e: Name + factory sync function (fallback)\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  name: string,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n\n// Two arguments - name + function - Plain function overloads\n// Overload 2f: Name + plain sync function\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  name: string,\n  fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n\n// Two arguments - options + function - Specific overloads with TraceContext first\n// Overload 3a: Options + immediate execution sync with context\nexport function trace<TReturn = unknown>(\n  options: TracingOptions<[], TReturn>,\n  fn: (ctx: TraceContext) => TReturn,\n): TReturn;\n// Overload 3b: Options + factory sync function with no args\nexport function trace<TReturn = unknown>(\n  options: TracingOptions<[], TReturn>,\n  fnFactory: (ctx: TraceContext) => () => TReturn,\n): () => TReturn;\n// Overload 3c: Options + factory sync function - non-generic for type inference\nexport function trace<TArgs extends unknown[], TReturn>(\n  options: TracingOptions<TArgs, TReturn>,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n// Overload 3d: Options + factory sync function (fallback)\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  options: TracingOptions<TArgs, TReturn>,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n\n// Two arguments - options + function - Plain function overloads\n// Overload 3e: Options + plain sync function\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  options: TracingOptions<TArgs, TReturn>,\n  fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\n\n// Async overloads - Ordered from most specific to most generic\n\n// Single argument - Specific async overloads with TraceContext first\n// Overload 4a: Immediate execution - async function with context\nexport function trace<TReturn = unknown>(\n  fn: (ctx: TraceContext) => Promise<TReturn>,\n): Promise<TReturn>;\n// Overload 4b: Factory async function with no args - non-generic for type inference\nexport function trace(\n  fnFactory: (ctx: TraceContext) => () => Promise<unknown>,\n): () => Promise<unknown>;\n// Overload 4c: Factory async function - non-generic for type inference\nexport function trace<TArgs extends unknown[], TReturn>(\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n// Overload 4d: Factory async function with no args (typed generic)\nexport function trace<TReturn = unknown>(\n  fnFactory: (ctx: TraceContext) => () => Promise<TReturn>,\n): () => Promise<TReturn>;\n// Overload 4e: Factory async function - use conditional type to extract signature\nexport function trace<\n  TFactory extends (\n    ctx: TraceContext,\n  ) => (...args: unknown[]) => Promise<unknown>,\n>(fnFactory: TFactory): ExtractFunctionSignature<TFactory>;\n// Overload 4f: Generic factory async function (fallback)\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n\n// Single argument - Plain async function overloads (no ctx parameter)\n// Overload 4g: Plain async function with no args\nexport function trace<TReturn = unknown>(\n  fn: () => Promise<TReturn>,\n): () => Promise<TReturn>;\n// Overload 4h: Plain async function (generic fallback)\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  fn: (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n\n// Two arguments - name + async function - Specific overloads with TraceContext first\n// Overload 5a: Name + immediate execution async with context\n// This overload only matches functions that DON'T return functions (factories)\nexport function trace<TReturn = unknown>(\n  name: string,\n  fn: ExcludeFactoryReturn<(ctx: TraceContext) => Promise<TReturn>>,\n): Promise<TReturn>;\n// Overload 5b: Name + factory async function with no args\nexport function trace<TReturn = unknown>(\n  name: string,\n  fnFactory: (ctx: TraceContext) => () => Promise<TReturn>,\n): () => Promise<TReturn>;\n// Overload 5c: Name + factory async function - non-generic for type inference\nexport function trace<TArgs extends unknown[], TReturn>(\n  name: string,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n// Overload 5d: Name + factory async function - use conditional type to extract signature\n// This overload allows TypeScript to infer types from the factory function parameter\nexport function trace<\n  TFactory extends (\n    ctx: TraceContext,\n  ) => (...args: unknown[]) => Promise<unknown>,\n>(name: string, fnFactory: TFactory): ExtractFunctionSignature<TFactory>;\n// Overload 5e: Name + factory async function (fallback)\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  name: string,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n\n// Two arguments - name + async function - Plain function overloads\n// Overload 5f: Name + plain async function\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  name: string,\n  fn: (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n\n// Two arguments - options + async function - Specific overloads with TraceContext first\n// Overload 6a: Options + immediate execution async with context\nexport function trace<TReturn = unknown>(\n  options: TracingOptions<[], TReturn>,\n  fn: (ctx: TraceContext) => Promise<TReturn>,\n): Promise<TReturn>;\n// Overload 6b: Options + factory async function with no args\nexport function trace<TReturn = unknown>(\n  options: TracingOptions<[], TReturn>,\n  fnFactory: (ctx: TraceContext) => () => Promise<TReturn>,\n): () => Promise<TReturn>;\n// Overload 6c: Options + factory async function - non-generic for type inference\nexport function trace<TArgs extends unknown[], TReturn>(\n  options: TracingOptions<TArgs, TReturn>,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n// Overload 6d: Options + factory async function (fallback)\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  options: TracingOptions<TArgs, TReturn>,\n  fnFactory: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n\n// Two arguments - options + async function - Plain function overloads\n// Overload 6e: Options + plain async function\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  options: TracingOptions<TArgs, TReturn>,\n  fn: (...args: TArgs) => Promise<TReturn>,\n): (...args: TArgs) => Promise<TReturn>;\n\n// Implementation\nexport function trace<TArgs extends unknown[] = unknown[], TReturn = unknown>(\n  fnOrNameOrOptions:\n    | ((...args: TArgs) => TReturn)\n    | ((...args: TArgs) => Promise<TReturn>)\n    | ((ctx: TraceContext) => (...args: TArgs) => TReturn)\n    | ((ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>)\n    | ((ctx: TraceContext) => TReturn)\n    | ((ctx: TraceContext) => Promise<TReturn>)\n    | string\n    | TracingOptions<TArgs, TReturn>,\n  maybeFn?:\n    | ((...args: TArgs) => TReturn)\n    | ((...args: TArgs) => Promise<TReturn>)\n    | ((ctx: TraceContext) => (...args: TArgs) => TReturn)\n    | ((ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>)\n    | ((ctx: TraceContext) => TReturn)\n    | ((ctx: TraceContext) => Promise<TReturn>),\n): WrappedFunction<TArgs, TReturn> | TReturn | Promise<TReturn> {\n  // Handle: trace(fn) - single argument\n  if (typeof fnOrNameOrOptions === 'function') {\n    // Check if it's immediate execution pattern: (ctx) => result\n    if (\n      looksLikeTraceFactory(fnOrNameOrOptions as GenericFunction) &&\n      !isFactoryReturningFunction(\n        fnOrNameOrOptions as (ctx: TraceContext) => unknown,\n      )\n    ) {\n      // Immediate execution pattern\n      return executeImmediately(\n        fnOrNameOrOptions as (ctx: TraceContext) => TReturn | Promise<TReturn>,\n        {},\n      ) as WrappedFunction<TArgs, TReturn> | TReturn | Promise<TReturn>;\n    }\n    // Factory pattern or plain function\n    return wrapFactoryWithTracing(\n      fnOrNameOrOptions as (...args: TArgs) => TReturn,\n      {} as TracingOptions<TArgs, TReturn>,\n    );\n  }\n\n  // Handle: trace(name, fn) or trace(options, fn) - two arguments\n  if (typeof fnOrNameOrOptions === 'string') {\n    if (!maybeFn) {\n      throw new Error('trace(name, fn): fn is required');\n    }\n    // Check if it's immediate execution pattern\n    if (\n      looksLikeTraceFactory(maybeFn as GenericFunction) &&\n      !isFactoryReturningFunction(maybeFn as (ctx: TraceContext) => unknown)\n    ) {\n      // Immediate execution pattern with name\n      return executeImmediately(\n        maybeFn as (ctx: TraceContext) => TReturn | Promise<TReturn>,\n        { name: fnOrNameOrOptions },\n      ) as WrappedFunction<TArgs, TReturn> | TReturn | Promise<TReturn>;\n    }\n    return wrapFactoryWithTracing(\n      maybeFn as (...args: TArgs) => TReturn,\n      { name: fnOrNameOrOptions } as TracingOptions<TArgs, TReturn>,\n    );\n  }\n\n  // Handle: trace(options, fn)\n  if (!maybeFn) {\n    throw new Error('trace(options, fn): fn is required');\n  }\n\n  // Check if it's immediate execution pattern\n  if (\n    looksLikeTraceFactory(maybeFn as GenericFunction) &&\n    !isFactoryReturningFunction(maybeFn as (ctx: TraceContext) => unknown)\n  ) {\n    // Immediate execution pattern with options\n    return executeImmediately(\n      maybeFn as (ctx: TraceContext) => TReturn | Promise<TReturn>,\n      fnOrNameOrOptions as TracingOptions<unknown[], unknown>,\n    ) as WrappedFunction<TArgs, TReturn> | TReturn | Promise<TReturn>;\n  }\n\n  return wrapFactoryWithTracing(\n    maybeFn as (...args: TArgs) => TReturn,\n    fnOrNameOrOptions as TracingOptions<TArgs, TReturn>,\n  );\n}\n\n/**\n * Approach 2: withTracing() - Middleware-style composable wrapper\n *\n * Returns a HOF that wraps functions with tracing.\n * Perfect for composition and reusable configuration.\n *\n * @example Standard usage\n * ```typescript\n * export const createUser = withTracing({\n *   name: 'user.create'\n * })(ctx => async (data) => {\n *   ctx.setAttribute('user.id', data.id)\n *   return await db.users.create(data)\n * })\n * ```\n *\n * @example Composable\n * ```typescript\n * const trace = withTracing({ serviceName: 'user' })\n *\n * export const createUser = trace(ctx => async (data) => { })\n * export const updateUser = trace(ctx => async (id, data) => { })\n * ```\n *\n * @example With other middleware\n * ```typescript\n * export const createUser = compose(\n *   withAuth({ role: 'admin' }),\n *   withTracing({ name: 'user.create' }),\n *   withRateLimit({ max: 100 })\n * )(ctx => async (data) => { })\n * ```\n */\nexport function withTracing<\n  TArgs extends unknown[] = unknown[],\n  TReturn = unknown,\n>(\n  options: TracingOptions<TArgs, TReturn> = {},\n): (\n  fnFactory: (\n    ctx: TraceContext,\n  ) => (...args: TArgs) => TReturn | Promise<TReturn>,\n) => (...args: TArgs) => TReturn | Promise<TReturn> {\n  return (\n    fnFactory: (\n      ctx: TraceContext,\n    ) => (...args: TArgs) => TReturn | Promise<TReturn>,\n  ): WrappedFunction<TArgs, TReturn> =>\n    wrapFactoryWithTracing<TArgs, TReturn>(fnFactory, options);\n}\n\n/**\n * Approach 3: instrument() - Batch auto-instrumentation\n *\n * Instrument an entire module/object at once.\n * Closest to @Instrumented decorator pattern.\n *\n * @example Basic usage\n * ```typescript\n * export default instrument({\n *   functions: {\n *     createUser: async (data) => { },\n *     updateUser: async (id, data) => { },\n *     deleteUser: async (id) => { }\n *   },\n *   serviceName: 'user',\n *   sampler: new AdaptiveSampler()\n * })\n * // → Traced as \"user.createUser\", \"user.updateUser\", \"user.deleteUser\"\n * ```\n *\n * @example Per-function overrides\n * ```typescript\n * export default instrument({\n *   functions: {\n *     createUser: async (data) => { },\n *     deleteUser: async (id) => { }\n *   },\n *   serviceName: 'user',\n *   overrides: {\n *     deleteUser: {\n *       sampler: new AlwaysSampler(),\n *       withMetrics: true\n *     }\n *   }\n * })\n * ```\n *\n * @example Skip functions\n * ```typescript\n * export default instrument({\n *   functions: {\n *     createUser: async (data) => { },\n *     _internal: async () => { }, // Auto-skipped (_-prefix)\n *     deleteUser: async (id) => { }\n *   },\n *   serviceName: 'user',\n *   skip: [/^test/, (key) => key.includes('debug')]\n * })\n * ```\n */\nexport function instrument<T extends Record<string, InstrumentableFunction>>(\n  options: InstrumentOptions<T>,\n): T {\n  const { functions, ...tracingOptions } = options;\n  const instrumented: Partial<T> = {};\n\n  for (const key of Object.keys(functions)) {\n    const typedKey = key as keyof T;\n    const fn = functions[typedKey];\n\n    // Skip if not a function or undefined - just pass through the value\n    if (!fn || typeof fn !== 'function') {\n      instrumented[typedKey] = fn as T[typeof typedKey];\n      continue;\n    }\n\n    // Only instrument own enumerable async functions\n    // Check if should skip\n    if (shouldSkip(key, fn, tracingOptions.skip)) {\n      instrumented[typedKey] = fn as T[typeof typedKey];\n      continue;\n    }\n\n    // Merge base options with per-function overrides\n    const fnOptions: TracingOptions = {\n      ...tracingOptions,\n      ...tracingOptions.overrides?.[key],\n      // If no explicit name, use key as function name\n      name: tracingOptions.overrides?.[key]?.name,\n    };\n\n    // Bind function to original object to preserve 'this' context\n    // This ensures methods can access state on the original object\n    const boundFn = fn.bind(functions);\n\n    // Convert plain function to factory pattern for trace()\n    // For instrument(), we create a factory that ignores ctx and returns the original function\n    const fnFactory = (ctx: TraceContext) => {\n      void ctx;\n      return boundFn;\n    };\n\n    // Wrap with tracing (sync or async based on implementation)\n    instrumented[typedKey] = wrapFactoryWithTracing(\n      fnFactory,\n      fnOptions,\n      key,\n    ) as T[typeof typedKey];\n  }\n\n  return instrumented as T;\n}\n\n/**\n * Options for span() function\n */\nexport interface SpanOptions {\n  /** Span name */\n  name: string;\n  /** Attributes to set on the span */\n  attributes?: Record<string, string | number | boolean>;\n}\n\n/**\n * Execute a function within a named span\n *\n * Useful for adding tracing to specific code blocks without wrapping\n * the entire function. Supports both synchronous and asynchronous functions.\n *\n * Mirrors `trace()`: pass a span name as the first argument for the common\n * case, or full `SpanOptions` when you need to attach attributes.\n *\n * @example\n * ```typescript\n * // Name shorthand\n * await span('payment.charge', async (span) => {\n *   await chargeCustomer(order);\n * })\n *\n * // Full options when attributes are needed\n * await span(\n *   { name: 'payment.charge', attributes: { amount: order.total } },\n *   async (span) => {\n *     await chargeCustomer(order);\n *   },\n * )\n *\n * // Sync\n * const total = span('calculateTotal', (span) => {\n *   return items.reduce((sum, item) => sum + item.price, 0);\n * })\n * ```\n */\n// Overloads — sync first (more specific match), then async.\n// Each shape is offered with a string name OR a full SpanOptions object so\n// span() aligns with trace()'s argument flexibility.\nexport function span<T = unknown>(name: string, fn: (span: Span) => T): T;\nexport function span<T = unknown>(\n  name: string,\n  fn: (span: Span) => Promise<T>,\n): Promise<T>;\nexport function span<T = unknown>(\n  options: SpanOptions,\n  fn: (span: Span) => T,\n): T;\nexport function span<T = unknown>(\n  options: SpanOptions,\n  fn: (span: Span) => Promise<T>,\n): Promise<T>;\n// Implementation\nexport function span<T = unknown>(\n  nameOrOptions: string | SpanOptions,\n  fn: (span: Span) => T | Promise<T>,\n): T | Promise<T> {\n  const options: SpanOptions =\n    typeof nameOrOptions === 'string' ? { name: nameOrOptions } : nameOrOptions;\n  const config = getConfig();\n  const tracer = config.tracer;\n  const { name, attributes } = options;\n\n  const executeSpan = (span: Span) => {\n    // Run within operation context so events can auto-capture operation.name\n    return runInOperationContext(name, () => {\n      try {\n        // Set attributes\n        if (attributes) {\n          for (const [key, value] of Object.entries(attributes)) {\n            span.setAttribute(key, value);\n          }\n        }\n\n        const result = fn(span);\n\n        // Check if result is a Promise\n        if (result instanceof Promise) {\n          return result\n            .then((resolved) => {\n              span.setStatus({ code: SpanStatusCode.OK });\n              span.end();\n              return resolved;\n            })\n            .catch((error) => {\n              const errorMessage =\n                error instanceof Error\n                  ? error.message.slice(0, MAX_ERROR_MESSAGE_LENGTH)\n                  : String(error).slice(0, MAX_ERROR_MESSAGE_LENGTH);\n\n              span.setAttribute('error.message', errorMessage);\n              span.setStatus({\n                code: SpanStatusCode.ERROR,\n                message: errorMessage,\n              });\n\n              span.recordException(\n                error instanceof Error ? error : new Error(String(error)),\n              );\n              span.end();\n              throw error;\n            });\n        } else {\n          // Synchronous function\n          span.setStatus({ code: SpanStatusCode.OK });\n          span.end();\n          return result;\n        }\n      } catch (error) {\n        // Synchronous error handling\n        const errorMessage =\n          error instanceof Error\n            ? error.message.slice(0, MAX_ERROR_MESSAGE_LENGTH)\n            : String(error).slice(0, MAX_ERROR_MESSAGE_LENGTH);\n\n        span.setAttribute('error.message', errorMessage);\n        span.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: errorMessage,\n        });\n\n        span.recordException(\n          error instanceof Error ? error : new Error(String(error)),\n        );\n        span.end();\n        throw error;\n      }\n    });\n  };\n\n  const parentContext = getActiveContextWithBaggage();\n  const result = tracer.startActiveSpan(name, {}, parentContext, executeSpan);\n\n  // tracer.startActiveSpan might return a Promise even for sync callbacks\n  // Check if it's a Promise and handle accordingly\n  if (result instanceof Promise) {\n    return result;\n  }\n\n  return result as T;\n}\n\n/**\n * Options for withNewContext() function\n */\nexport interface WithNewContextOptions<T = unknown> {\n  /** Function to execute in new root context */\n  fn: () => Promise<T>;\n}\n\n/**\n * Execute a function in a new root context (prevents span propagation)\n *\n * Useful when you want to start a completely new trace without\n * parent-child relationships.\n *\n * @example\n * ```typescript\n * async function handleWebhook(payload: WebhookPayload) {\n *   // This creates a new root trace, not connected to the HTTP request trace\n *   await withNewContext({\n *     fn: async () => {\n *       await trace(ctx => async () => {\n *         await processWebhookPayload(payload)\n *       })()\n *     }\n *   })\n * }\n * ```\n */\nexport async function withNewContext<T = unknown>(\n  options: WithNewContextOptions<T>,\n): Promise<T> {\n  const { fn } = options;\n  const config = getConfig();\n  const tracer = config.tracer;\n\n  // Start a new root span (breaks trace propagation)\n  return tracer.startActiveSpan('root', { root: true }, async (span) => {\n    try {\n      const result = await fn();\n      span.setStatus({ code: SpanStatusCode.OK });\n      return result;\n    } catch (error) {\n      span.recordException(\n        error instanceof Error ? error : new Error(String(error)),\n      );\n      span.setStatus({ code: SpanStatusCode.ERROR });\n      throw error;\n    } finally {\n      span.end();\n    }\n  });\n}\n\n/**\n * Options for withBaggage() function\n */\nexport interface WithBaggageOptions<T = unknown> {\n  /** Baggage entries to set (key-value pairs) */\n  baggage: Record<string, string>;\n  /** Function to execute with the updated baggage */\n  fn: () => T | Promise<T>;\n}\n\n/**\n * Execute a function with updated baggage entries\n *\n * Baggage is immutable in OpenTelemetry, so this helper creates a new context\n * with the specified baggage entries and runs the function within that context.\n * All child spans created within the function will inherit the baggage.\n *\n * @example Setting baggage for downstream services\n * ```typescript\n * import { trace, withBaggage } from 'autotel';\n *\n * export const createOrder = trace((ctx) => async (order: Order) => {\n *   // Set baggage that will be propagated to downstream HTTP calls\n *   return await withBaggage({\n *     baggage: {\n *       'tenant.id': order.tenantId,\n *       'user.id': order.userId,\n *     },\n *     fn: async () => {\n *       // This HTTP call will include the baggage in headers\n *       await fetch('/api/charge', {\n *         method: 'POST',\n *         body: JSON.stringify(order),\n *       });\n *     },\n *   });\n * });\n * ```\n *\n * @example Using with existing baggage\n * ```typescript\n * export const processOrder = trace((ctx) => async (order: Order) => {\n *   // Read existing baggage\n *   const tenantId = ctx.getBaggage('tenant.id');\n *\n *   // Add additional baggage entries\n *   return await withBaggage({\n *     baggage: {\n *       'order.id': order.id,\n *       'order.amount': String(order.amount),\n *     },\n *     fn: async () => {\n *       await charge(order);\n *     },\n *   });\n * });\n * ```\n */\nexport function withBaggage<T = unknown>(\n  options: WithBaggageOptions<T>,\n): T | Promise<T> {\n  const { baggage: baggageEntries, fn } = options;\n  const currentContext = context.active();\n\n  // Get existing baggage or create new\n  let updatedBaggage =\n    propagation.getBaggage(currentContext) ?? propagation.createBaggage();\n\n  // Set all baggage entries\n  for (const [key, value] of Object.entries(baggageEntries)) {\n    updatedBaggage = updatedBaggage.setEntry(key, { value });\n  }\n\n  // Create new context with updated baggage\n  const newContext = propagation.setBaggage(currentContext, updatedBaggage);\n\n  // Sync contextStorage so nested traces (via getActiveContextWithBaggage) see the baggage.\n  // Use run() instead of enterWith() to properly scope the context changes.\n  const ctxStorage = getContextStorage();\n  const previousStored = ctxStorage.getStore();\n  const baggageEnrichedStored = previousStored\n    ? { value: propagation.setBaggage(previousStored.value, updatedBaggage) }\n    : { value: newContext };\n\n  // Run the function within the new context, scoped properly\n  const result = previousStored\n    ? ctxStorage.run(baggageEnrichedStored, () => context.with(newContext, fn))\n    : context.with(newContext, fn);\n\n  if (result instanceof Promise) {\n    // For async operations, ensure context is restored after the promise settles\n    return result.then(\n      (value) => {\n        // Restore original context before resolving\n        if (previousStored) {\n          return ctxStorage.run(previousStored, () => value);\n        }\n        return value;\n      },\n      (error) => {\n        // Restore original context before rejecting\n        if (previousStored) {\n          return ctxStorage.run(previousStored, () => {\n            throw error;\n          });\n        }\n        throw error;\n      },\n    );\n  }\n\n  // Sync function - context automatically restored when scope exits\n  return result;\n}\n"],"mappings":"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"}