autotel 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (272) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1946 -0
  3. package/dist/chunk-2LNRY4QK.js +273 -0
  4. package/dist/chunk-2LNRY4QK.js.map +1 -0
  5. package/dist/chunk-3HENGDW2.js +587 -0
  6. package/dist/chunk-3HENGDW2.js.map +1 -0
  7. package/dist/chunk-4OAT42CA.cjs +73 -0
  8. package/dist/chunk-4OAT42CA.cjs.map +1 -0
  9. package/dist/chunk-5GWX5LFW.js +70 -0
  10. package/dist/chunk-5GWX5LFW.js.map +1 -0
  11. package/dist/chunk-5R2M36QB.js +195 -0
  12. package/dist/chunk-5R2M36QB.js.map +1 -0
  13. package/dist/chunk-5ZN622AO.js +73 -0
  14. package/dist/chunk-5ZN622AO.js.map +1 -0
  15. package/dist/chunk-77MSMAUQ.cjs +498 -0
  16. package/dist/chunk-77MSMAUQ.cjs.map +1 -0
  17. package/dist/chunk-ABPEQ6RK.cjs +596 -0
  18. package/dist/chunk-ABPEQ6RK.cjs.map +1 -0
  19. package/dist/chunk-BWYGJKRB.js +95 -0
  20. package/dist/chunk-BWYGJKRB.js.map +1 -0
  21. package/dist/chunk-BZHG5IZ4.js +73 -0
  22. package/dist/chunk-BZHG5IZ4.js.map +1 -0
  23. package/dist/chunk-G7VZBCD6.cjs +35 -0
  24. package/dist/chunk-G7VZBCD6.cjs.map +1 -0
  25. package/dist/chunk-GVLK7YUU.cjs +30 -0
  26. package/dist/chunk-GVLK7YUU.cjs.map +1 -0
  27. package/dist/chunk-HCCXC7XG.js +205 -0
  28. package/dist/chunk-HCCXC7XG.js.map +1 -0
  29. package/dist/chunk-HE6T6FIX.cjs +203 -0
  30. package/dist/chunk-HE6T6FIX.cjs.map +1 -0
  31. package/dist/chunk-KIXWPOCO.cjs +100 -0
  32. package/dist/chunk-KIXWPOCO.cjs.map +1 -0
  33. package/dist/chunk-KVGNW3FC.js +87 -0
  34. package/dist/chunk-KVGNW3FC.js.map +1 -0
  35. package/dist/chunk-LITNXTTT.js +3 -0
  36. package/dist/chunk-LITNXTTT.js.map +1 -0
  37. package/dist/chunk-M4ANN7RL.js +114 -0
  38. package/dist/chunk-M4ANN7RL.js.map +1 -0
  39. package/dist/chunk-NC52UBR2.cjs +32 -0
  40. package/dist/chunk-NC52UBR2.cjs.map +1 -0
  41. package/dist/chunk-NHCNRQD3.cjs +212 -0
  42. package/dist/chunk-NHCNRQD3.cjs.map +1 -0
  43. package/dist/chunk-NZ72VDNY.cjs +4 -0
  44. package/dist/chunk-NZ72VDNY.cjs.map +1 -0
  45. package/dist/chunk-P6JUDYNO.js +57 -0
  46. package/dist/chunk-P6JUDYNO.js.map +1 -0
  47. package/dist/chunk-RJYY7BWX.js +1349 -0
  48. package/dist/chunk-RJYY7BWX.js.map +1 -0
  49. package/dist/chunk-TRI4V5BF.cjs +126 -0
  50. package/dist/chunk-TRI4V5BF.cjs.map +1 -0
  51. package/dist/chunk-UL33I6IS.js +139 -0
  52. package/dist/chunk-UL33I6IS.js.map +1 -0
  53. package/dist/chunk-URRW6M2C.cjs +61 -0
  54. package/dist/chunk-URRW6M2C.cjs.map +1 -0
  55. package/dist/chunk-UY3UYPBZ.cjs +77 -0
  56. package/dist/chunk-UY3UYPBZ.cjs.map +1 -0
  57. package/dist/chunk-W3253FGB.cjs +277 -0
  58. package/dist/chunk-W3253FGB.cjs.map +1 -0
  59. package/dist/chunk-W7LHZVQF.js +26 -0
  60. package/dist/chunk-W7LHZVQF.js.map +1 -0
  61. package/dist/chunk-WBWNM6LB.cjs +1360 -0
  62. package/dist/chunk-WBWNM6LB.cjs.map +1 -0
  63. package/dist/chunk-WFJ7L2RV.js +494 -0
  64. package/dist/chunk-WFJ7L2RV.js.map +1 -0
  65. package/dist/chunk-X4RMFFMR.js +28 -0
  66. package/dist/chunk-X4RMFFMR.js.map +1 -0
  67. package/dist/chunk-Y4Y2S7BM.cjs +92 -0
  68. package/dist/chunk-Y4Y2S7BM.cjs.map +1 -0
  69. package/dist/chunk-YLPNXZFI.cjs +143 -0
  70. package/dist/chunk-YLPNXZFI.cjs.map +1 -0
  71. package/dist/chunk-YTXEZ4SD.cjs +77 -0
  72. package/dist/chunk-YTXEZ4SD.cjs.map +1 -0
  73. package/dist/chunk-Z6ZWNWWR.js +30 -0
  74. package/dist/chunk-Z6ZWNWWR.js.map +1 -0
  75. package/dist/config.cjs +26 -0
  76. package/dist/config.cjs.map +1 -0
  77. package/dist/config.d.cts +75 -0
  78. package/dist/config.d.ts +75 -0
  79. package/dist/config.js +5 -0
  80. package/dist/config.js.map +1 -0
  81. package/dist/db.cjs +233 -0
  82. package/dist/db.cjs.map +1 -0
  83. package/dist/db.d.cts +123 -0
  84. package/dist/db.d.ts +123 -0
  85. package/dist/db.js +228 -0
  86. package/dist/db.js.map +1 -0
  87. package/dist/decorators.cjs +67 -0
  88. package/dist/decorators.cjs.map +1 -0
  89. package/dist/decorators.d.cts +91 -0
  90. package/dist/decorators.d.ts +91 -0
  91. package/dist/decorators.js +65 -0
  92. package/dist/decorators.js.map +1 -0
  93. package/dist/event-subscriber.cjs +6 -0
  94. package/dist/event-subscriber.cjs.map +1 -0
  95. package/dist/event-subscriber.d.cts +116 -0
  96. package/dist/event-subscriber.d.ts +116 -0
  97. package/dist/event-subscriber.js +3 -0
  98. package/dist/event-subscriber.js.map +1 -0
  99. package/dist/event-testing.cjs +21 -0
  100. package/dist/event-testing.cjs.map +1 -0
  101. package/dist/event-testing.d.cts +110 -0
  102. package/dist/event-testing.d.ts +110 -0
  103. package/dist/event-testing.js +4 -0
  104. package/dist/event-testing.js.map +1 -0
  105. package/dist/event.cjs +30 -0
  106. package/dist/event.cjs.map +1 -0
  107. package/dist/event.d.cts +282 -0
  108. package/dist/event.d.ts +282 -0
  109. package/dist/event.js +13 -0
  110. package/dist/event.js.map +1 -0
  111. package/dist/exporters.cjs +17 -0
  112. package/dist/exporters.cjs.map +1 -0
  113. package/dist/exporters.d.cts +1 -0
  114. package/dist/exporters.d.ts +1 -0
  115. package/dist/exporters.js +4 -0
  116. package/dist/exporters.js.map +1 -0
  117. package/dist/functional.cjs +46 -0
  118. package/dist/functional.cjs.map +1 -0
  119. package/dist/functional.d.cts +478 -0
  120. package/dist/functional.d.ts +478 -0
  121. package/dist/functional.js +13 -0
  122. package/dist/functional.js.map +1 -0
  123. package/dist/http.cjs +189 -0
  124. package/dist/http.cjs.map +1 -0
  125. package/dist/http.d.cts +169 -0
  126. package/dist/http.d.ts +169 -0
  127. package/dist/http.js +184 -0
  128. package/dist/http.js.map +1 -0
  129. package/dist/index.cjs +333 -0
  130. package/dist/index.cjs.map +1 -0
  131. package/dist/index.d.cts +758 -0
  132. package/dist/index.d.ts +758 -0
  133. package/dist/index.js +143 -0
  134. package/dist/index.js.map +1 -0
  135. package/dist/instrumentation.cjs +182 -0
  136. package/dist/instrumentation.cjs.map +1 -0
  137. package/dist/instrumentation.d.cts +49 -0
  138. package/dist/instrumentation.d.ts +49 -0
  139. package/dist/instrumentation.js +179 -0
  140. package/dist/instrumentation.js.map +1 -0
  141. package/dist/logger.cjs +19 -0
  142. package/dist/logger.cjs.map +1 -0
  143. package/dist/logger.d.cts +146 -0
  144. package/dist/logger.d.ts +146 -0
  145. package/dist/logger.js +6 -0
  146. package/dist/logger.js.map +1 -0
  147. package/dist/metric-helpers.cjs +31 -0
  148. package/dist/metric-helpers.cjs.map +1 -0
  149. package/dist/metric-helpers.d.cts +13 -0
  150. package/dist/metric-helpers.d.ts +13 -0
  151. package/dist/metric-helpers.js +6 -0
  152. package/dist/metric-helpers.js.map +1 -0
  153. package/dist/metric-testing.cjs +21 -0
  154. package/dist/metric-testing.cjs.map +1 -0
  155. package/dist/metric-testing.d.cts +110 -0
  156. package/dist/metric-testing.d.ts +110 -0
  157. package/dist/metric-testing.js +4 -0
  158. package/dist/metric-testing.js.map +1 -0
  159. package/dist/metric.cjs +26 -0
  160. package/dist/metric.cjs.map +1 -0
  161. package/dist/metric.d.cts +240 -0
  162. package/dist/metric.d.ts +240 -0
  163. package/dist/metric.js +9 -0
  164. package/dist/metric.js.map +1 -0
  165. package/dist/processors.cjs +17 -0
  166. package/dist/processors.cjs.map +1 -0
  167. package/dist/processors.d.cts +1 -0
  168. package/dist/processors.d.ts +1 -0
  169. package/dist/processors.js +4 -0
  170. package/dist/processors.js.map +1 -0
  171. package/dist/sampling.cjs +40 -0
  172. package/dist/sampling.cjs.map +1 -0
  173. package/dist/sampling.d.cts +260 -0
  174. package/dist/sampling.d.ts +260 -0
  175. package/dist/sampling.js +7 -0
  176. package/dist/sampling.js.map +1 -0
  177. package/dist/semantic-helpers.cjs +35 -0
  178. package/dist/semantic-helpers.cjs.map +1 -0
  179. package/dist/semantic-helpers.d.cts +442 -0
  180. package/dist/semantic-helpers.d.ts +442 -0
  181. package/dist/semantic-helpers.js +14 -0
  182. package/dist/semantic-helpers.js.map +1 -0
  183. package/dist/tail-sampling-processor.cjs +13 -0
  184. package/dist/tail-sampling-processor.cjs.map +1 -0
  185. package/dist/tail-sampling-processor.d.cts +27 -0
  186. package/dist/tail-sampling-processor.d.ts +27 -0
  187. package/dist/tail-sampling-processor.js +4 -0
  188. package/dist/tail-sampling-processor.js.map +1 -0
  189. package/dist/testing.cjs +286 -0
  190. package/dist/testing.cjs.map +1 -0
  191. package/dist/testing.d.cts +291 -0
  192. package/dist/testing.d.ts +291 -0
  193. package/dist/testing.js +263 -0
  194. package/dist/testing.js.map +1 -0
  195. package/dist/trace-context-DRZdUvVY.d.cts +181 -0
  196. package/dist/trace-context-DRZdUvVY.d.ts +181 -0
  197. package/dist/trace-helpers.cjs +54 -0
  198. package/dist/trace-helpers.cjs.map +1 -0
  199. package/dist/trace-helpers.d.cts +524 -0
  200. package/dist/trace-helpers.d.ts +524 -0
  201. package/dist/trace-helpers.js +5 -0
  202. package/dist/trace-helpers.js.map +1 -0
  203. package/dist/tracer-provider.cjs +21 -0
  204. package/dist/tracer-provider.cjs.map +1 -0
  205. package/dist/tracer-provider.d.cts +169 -0
  206. package/dist/tracer-provider.d.ts +169 -0
  207. package/dist/tracer-provider.js +4 -0
  208. package/dist/tracer-provider.js.map +1 -0
  209. package/package.json +280 -0
  210. package/src/baggage-span-processor.test.ts +202 -0
  211. package/src/baggage-span-processor.ts +98 -0
  212. package/src/circuit-breaker.test.ts +341 -0
  213. package/src/circuit-breaker.ts +184 -0
  214. package/src/config.test.ts +94 -0
  215. package/src/config.ts +169 -0
  216. package/src/db.test.ts +252 -0
  217. package/src/db.ts +447 -0
  218. package/src/decorators.test.ts +203 -0
  219. package/src/decorators.ts +188 -0
  220. package/src/env-config.test.ts +246 -0
  221. package/src/env-config.ts +158 -0
  222. package/src/event-queue.test.ts +222 -0
  223. package/src/event-queue.ts +203 -0
  224. package/src/event-subscriber.ts +136 -0
  225. package/src/event-testing.ts +197 -0
  226. package/src/event.test.ts +718 -0
  227. package/src/event.ts +556 -0
  228. package/src/exporters.ts +96 -0
  229. package/src/functional.test.ts +1059 -0
  230. package/src/functional.ts +2295 -0
  231. package/src/http.test.ts +487 -0
  232. package/src/http.ts +424 -0
  233. package/src/index.ts +158 -0
  234. package/src/init.customization.test.ts +210 -0
  235. package/src/init.integrations.test.ts +366 -0
  236. package/src/init.openllmetry.test.ts +282 -0
  237. package/src/init.protocol.test.ts +215 -0
  238. package/src/init.ts +1426 -0
  239. package/src/instrumentation.test.ts +108 -0
  240. package/src/instrumentation.ts +308 -0
  241. package/src/logger.test.ts +117 -0
  242. package/src/logger.ts +246 -0
  243. package/src/metric-helpers.ts +47 -0
  244. package/src/metric-testing.ts +197 -0
  245. package/src/metric.ts +434 -0
  246. package/src/metrics.test.ts +205 -0
  247. package/src/operation-context.ts +93 -0
  248. package/src/processors.ts +106 -0
  249. package/src/rate-limiter.test.ts +199 -0
  250. package/src/rate-limiter.ts +98 -0
  251. package/src/sampling.test.ts +513 -0
  252. package/src/sampling.ts +428 -0
  253. package/src/semantic-helpers.test.ts +311 -0
  254. package/src/semantic-helpers.ts +584 -0
  255. package/src/shutdown.test.ts +311 -0
  256. package/src/shutdown.ts +222 -0
  257. package/src/stub.integration.test.ts +361 -0
  258. package/src/tail-sampling-processor.test.ts +226 -0
  259. package/src/tail-sampling-processor.ts +51 -0
  260. package/src/testing.ts +670 -0
  261. package/src/trace-context.ts +470 -0
  262. package/src/trace-helpers.new.test.ts +278 -0
  263. package/src/trace-helpers.test.ts +242 -0
  264. package/src/trace-helpers.ts +690 -0
  265. package/src/tracer-provider.test.ts +183 -0
  266. package/src/tracer-provider.ts +266 -0
  267. package/src/track.test.ts +153 -0
  268. package/src/track.ts +120 -0
  269. package/src/validation.test.ts +306 -0
  270. package/src/validation.ts +239 -0
  271. package/src/variable-name-inference.test.ts +178 -0
  272. package/src/variable-name-inference.ts +242 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rate-limiter.ts","../src/event-queue.ts","../src/track.ts","../src/functional.ts","../src/variable-name-inference.ts"],"names":["getConfig","span","ctx","otelTrace","wrappedFunction","trace","result"],"mappings":"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","file":"chunk-RJYY7BWX.js","sourcesContent":["/**\n * Token bucket rate limiter for event subscribers\n *\n * Prevents overwhelming downstream events platforms with too many events.\n * Uses token bucket algorithm for smooth rate limiting with burst capacity.\n */\n\nexport interface RateLimiterConfig {\n /** Maximum events per second (default: 100) */\n maxEventsPerSecond: number;\n /** Burst capacity - max events in a single burst (default: 2x rate) */\n burstCapacity?: number;\n}\n\n/**\n * Token bucket rate limiter\n *\n * Allows bursts up to burstCapacity, then smooths to maxEventsPerSecond.\n * Thread-safe for async operations.\n */\nexport class TokenBucketRateLimiter {\n private tokens: number;\n private readonly maxTokens: number;\n private readonly refillRate: number; // tokens per millisecond\n private lastRefill: number;\n\n constructor(config: RateLimiterConfig) {\n this.maxTokens = config.burstCapacity || config.maxEventsPerSecond * 2;\n this.tokens = this.maxTokens; // Start with full bucket\n this.refillRate = config.maxEventsPerSecond / 1000; // Convert to per-ms\n this.lastRefill = Date.now();\n }\n\n /**\n * Try to consume a token (allow an event)\n * Returns true if allowed, false if rate limit exceeded\n */\n tryConsume(count = 1): boolean {\n this.refill();\n\n if (this.tokens >= count) {\n this.tokens -= count;\n return true;\n }\n\n return false;\n }\n\n /**\n * Wait until a token is available (async rate limiting)\n * Returns a promise that resolves when the event can be processed\n */\n async waitForToken(count = 1): Promise<void> {\n this.refill();\n\n if (this.tokens >= count) {\n this.tokens -= count;\n return;\n }\n\n // Calculate wait time until we have enough tokens\n const tokensNeeded = count - this.tokens;\n const waitMs = Math.ceil(tokensNeeded / this.refillRate);\n\n await new Promise((resolve) => setTimeout(resolve, waitMs));\n\n // After waiting, try again (recursive)\n return this.waitForToken(count);\n }\n\n /**\n * Refill tokens based on elapsed time\n */\n private refill(): void {\n const now = Date.now();\n const elapsed = now - this.lastRefill;\n const tokensToAdd = elapsed * this.refillRate;\n\n this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);\n this.lastRefill = now;\n }\n\n /**\n * Get current available tokens (for testing/debugging)\n */\n getAvailableTokens(): number {\n this.refill();\n return Math.floor(this.tokens);\n }\n\n /**\n * Reset the rate limiter (for testing)\n */\n reset(): void {\n this.tokens = this.maxTokens;\n this.lastRefill = Date.now();\n }\n}\n","/**\n * Events event queue with batching, backpressure, retry logic, and rate limiting\n */\n\nimport type { EventSubscriber, EventAttributes } from './event-subscriber';\nimport { getLogger } from './init';\nimport { TokenBucketRateLimiter, type RateLimiterConfig } from './rate-limiter';\n\nexport interface EventData {\n name: string;\n attributes?: EventAttributes;\n timestamp: number;\n}\n\nexport interface QueueConfig {\n maxSize: number; // Max events in queue (default: 50,000)\n batchSize: number; // Events per batch (default: 100)\n flushInterval: number; // Flush interval in ms (default: 10,000)\n maxRetries: number; // Max retry attempts (default: 3)\n rateLimit?: RateLimiterConfig; // Optional rate limiting (default: 100 events/sec)\n}\n\nconst DEFAULT_CONFIG: QueueConfig = {\n maxSize: 50_000,\n batchSize: 100,\n flushInterval: 10_000,\n maxRetries: 3,\n rateLimit: {\n maxEventsPerSecond: 100,\n burstCapacity: 200,\n },\n};\n\n/**\n * Events queue with batching and backpressure\n *\n * Features:\n * - Batches events for efficient sending\n * - Bounded queue with drop-oldest policy (prod) or blocking (dev)\n * - Exponential backoff retry\n * - Rate limiting to prevent overwhelming subscribers\n * - Graceful flush on shutdown\n */\nexport class EventQueue {\n private queue: EventData[] = [];\n private flushTimer: NodeJS.Timeout | null = null;\n private readonly config: QueueConfig;\n private readonly subscribers: EventSubscriber[];\n private readonly rateLimiter: TokenBucketRateLimiter | null;\n private flushing = false;\n\n constructor(subscribers: EventSubscriber[], config?: Partial<QueueConfig>) {\n this.subscribers = subscribers;\n this.config = { ...DEFAULT_CONFIG, ...config };\n\n // Initialize rate limiter if configured\n this.rateLimiter = this.config.rateLimit\n ? new TokenBucketRateLimiter(this.config.rateLimit)\n : null;\n }\n\n /**\n * Enqueue an event for sending\n *\n * Backpressure policy:\n * - Drops oldest event and logs warning if queue is full (same behavior in all environments)\n */\n enqueue(event: EventData): void {\n // Check queue size\n if (this.queue.length >= this.config.maxSize) {\n // Drop oldest event and log warning (same behavior in all environments)\n const droppedEvent = this.queue.shift();\n getLogger().warn(\n `[autotel] Events queue full (${this.config.maxSize} events). ` +\n 'Dropping oldest event. Events are being produced faster than they can be sent. ' +\n 'Check your subscribers or reduce tracking frequency.',\n { droppedEvent: droppedEvent?.name },\n );\n }\n\n this.queue.push(event);\n this.scheduleBatchFlush();\n }\n\n /**\n * Schedule a batch flush if not already scheduled\n */\n private scheduleBatchFlush(): void {\n if (this.flushTimer || this.flushing) return;\n\n this.flushTimer = setTimeout(() => {\n this.flushTimer = null;\n void this.flushBatch();\n }, this.config.flushInterval);\n }\n\n /**\n * Flush a batch of events\n */\n private async flushBatch(): Promise<void> {\n if (this.queue.length === 0 || this.flushing) return;\n\n this.flushing = true;\n\n try {\n const batch = this.queue.splice(0, this.config.batchSize);\n await this.sendWithRetry(batch, this.config.maxRetries);\n } finally {\n this.flushing = false;\n\n // Schedule next flush if more events\n if (this.queue.length > 0) {\n this.scheduleBatchFlush();\n }\n }\n }\n\n /**\n * Send events with exponential backoff retry\n */\n private async sendWithRetry(\n events: EventData[],\n retriesLeft: number,\n ): Promise<void> {\n try {\n await this.sendToSubscribers(events);\n } catch (error) {\n if (retriesLeft > 0) {\n // Exponential backoff: 1s, 2s, 4s\n const delay = Math.pow(2, this.config.maxRetries - retriesLeft) * 1000;\n await new Promise((resolve) => setTimeout(resolve, delay));\n return this.sendWithRetry(events, retriesLeft - 1);\n } else {\n // Give up after max retries\n // Always log failed retries to maintain visibility (same behavior in all environments)\n getLogger().error(\n '[autotel] Failed to send events after retries',\n error instanceof Error ? error : undefined,\n { retriesAttempted: this.config.maxRetries },\n );\n }\n }\n }\n\n /**\n * Send events to all configured subscribers with rate limiting\n */\n private async sendToSubscribers(events: EventData[]): Promise<void> {\n // If rate limiting is disabled, send all at once\n if (!this.rateLimiter) {\n const promises = events.map((event) =>\n Promise.all(\n this.subscribers.map((subscriber) =>\n subscriber.trackEvent(event.name, event.attributes),\n ),\n ),\n );\n await Promise.all(promises);\n return;\n }\n\n // With rate limiting: wait for token before sending each event\n for (const event of events) {\n // Wait for rate limiter token (smooth traffic)\n await this.rateLimiter.waitForToken();\n\n // Send to all subscribers concurrently\n await Promise.all(\n this.subscribers.map((subscriber) =>\n subscriber.trackEvent(event.name, event.attributes),\n ),\n );\n }\n }\n\n /**\n * Flush all remaining events (for shutdown)\n */\n async flush(): Promise<void> {\n // Cancel any pending timer\n if (this.flushTimer) {\n clearTimeout(this.flushTimer);\n this.flushTimer = null;\n }\n\n // Wait for any in-progress flush to complete\n while (this.flushing) {\n await new Promise((resolve) => setTimeout(resolve, 10));\n }\n\n // Flush all batches\n while (this.queue.length > 0) {\n await this.flushBatch();\n }\n }\n\n /**\n * Get queue size (for testing/debugging)\n */\n size(): number {\n return this.queue.length;\n }\n}\n","/**\n * Global track() function for business events\n *\n * Simple, no instantiation needed, auto-attaches trace context\n */\n\nimport { trace } from '@opentelemetry/api';\nimport { EventQueue } from './event-queue';\nimport {\n getConfig,\n warnIfNotInitialized,\n isInitialized,\n getValidationConfig,\n} from './init';\nimport { validateEvent } from './validation';\n\n// Global events queue (initialized on first track call)\nlet eventsQueue: EventQueue | null = null;\n\n/**\n * Initialize events queue lazily\n */\nfunction getOrCreateQueue(): EventQueue | null {\n if (!isInitialized()) {\n warnIfNotInitialized('track()');\n return null;\n }\n\n if (!eventsQueue) {\n const config = getConfig();\n if (!config?.subscribers || config.subscribers.length === 0) {\n // No subscribers configured - no-op\n return null;\n }\n\n eventsQueue = new EventQueue(config.subscribers);\n }\n\n return eventsQueue;\n}\n\n/**\n * Track a business events event\n *\n * Features:\n * - Auto-attaches traceId and spanId if in active span\n * - Batched sending with retry\n * - Type-safe with optional generic\n * - No-op if init() not called or no subscribers configured\n *\n * @example Basic usage\n * ```typescript\n * track('user.signup', { userId: '123', plan: 'pro' })\n * ```\n *\n * @example With type safety\n * ```typescript\n * interface EventDatas {\n * 'user.signup': { userId: string; plan: string }\n * 'plan.upgraded': { userId: string; revenue: number }\n * }\n *\n * track<EventDatas>('user.signup', { userId: '123', plan: 'pro' })\n * ```\n *\n * @example Trace correlation (automatic)\n * ```typescript\n * @Instrumented()\n * class UserService {\n * async createUser(data: CreateUserData) {\n * // This track call automatically includes traceId + spanId\n * track('user.signup', { userId: data.id })\n * }\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function track<Events extends Record<string, any> = Record<string, any>>(\n event: keyof Events & string,\n data?: Events[typeof event],\n): void {\n const queue = getOrCreateQueue();\n if (!queue) return; // No-op if not initialized or no subscribers\n\n // Validate and sanitize input (with custom config if provided)\n const validationConfig = getValidationConfig();\n const validated = validateEvent(event, data, validationConfig || undefined);\n\n // Auto-attach trace context if available (free win!)\n const span = trace.getActiveSpan();\n const enrichedData = span\n ? {\n ...validated.attributes,\n traceId: span.spanContext().traceId,\n spanId: span.spanContext().spanId,\n }\n : validated.attributes;\n\n queue.enqueue({\n name: validated.eventName,\n attributes: enrichedData,\n timestamp: Date.now(),\n });\n}\n\n/**\n * Get events queue (for flush/shutdown)\n * @internal\n */\nexport function getEventQueue(): EventQueue | null {\n return eventsQueue;\n}\n\n/**\n * Reset events queue (for shutdown/cleanup)\n * @internal\n */\nexport function resetEventQueue(): void {\n eventsQueue = null;\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 { type Sampler, type SamplingContext, AlwaysSampler } from './sampling';\nimport { getEventQueue } from './track';\nimport type { TraceContext } from './trace-context';\nimport {\n createTraceContext,\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\nfunction looksLikeTraceFactory(fn: GenericFunction): boolean {\n if (hasFactoryMark(fn)) {\n return true;\n }\n\n if (fn.length === 0) {\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 ) {\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 */\nfunction isFactoryReturningFunction(\n fnWithCtx: (ctx: TraceContext) => unknown,\n): boolean {\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 * 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 * Automatically flush events queue when span ends\n * Only flushes on root spans (to avoid excessive flushing)\n * @default true\n */\n autoFlushEvents?: boolean;\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 return {\n traceId: '',\n spanId: '',\n correlationId: '',\n setAttribute: () => {},\n setAttributes: () => {},\n setStatus: () => {},\n recordException: () => {},\n getBaggage: () => {},\n setBaggage: () => '',\n deleteBaggage: () => {},\n getAllBaggage: () => new Map(),\n } as unknown as TraceContext<TBaggage>;\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({} as TraceContext, {\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}) as TraceContext;\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.autoFlushEvents ?? getInitConfig()?.autoFlushEvents ?? true;\n const shouldAutoFlushSpans = getInitConfig()?.autoFlush ?? 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 if (error instanceof Error) {\n logger.error('[autotel] Auto-flush failed', error);\n } else {\n logger.error(`[autotel] Auto-flush failed: ${String(error)}`);\n }\n }\n }\n };\n\n return tracer.startActiveSpan(\n spanName,\n options.startNewRoot ? { root: true } : {},\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 contextStorage.enterWith(initialContext);\n }\n\n const ctxValue = createTraceContext(span);\n const fn = fnFactory(ctxValue);\n const argsAttributes = options.attributesFromArgs\n ? options.attributesFromArgs(args)\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('sampling.tail.keep', shouldKeepSpan);\n span.setAttribute('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 = options.attributesFromResult\n ? options.attributesFromResult(result)\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.autoFlushEvents ?? getInitConfig()?.autoFlushEvents ?? true;\n const shouldAutoFlushSpans = getInitConfig()?.autoFlush ?? 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 autoFlush 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 if (error instanceof Error) {\n logger.error('[autotel] Auto-flush failed', error);\n } else {\n logger.error(`[autotel] Auto-flush failed: ${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 if (error instanceof Error) {\n logger.error('[autotel] Span flush failed', error);\n } else {\n logger.error(\n `[autotel] Span flush failed: ${String(error)}`,\n );\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 return tracer.startActiveSpan(\n spanName,\n options.startNewRoot ? { root: true } : {},\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 = options.attributesFromArgs\n ? options.attributesFromArgs(args)\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('sampling.tail.keep', shouldKeepSpan);\n span.setAttribute('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 = options.attributesFromResult\n ? options.attributesFromResult(result)\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.autoFlushEvents ?? getInitConfig()?.autoFlushEvents ?? true;\n const shouldAutoFlushSpans = getInitConfig()?.autoFlush ?? 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 if (error instanceof Error) {\n logger.error('[autotel] Auto-flush failed', error);\n } else {\n logger.error(`[autotel] Auto-flush failed: ${String(error)}`);\n }\n }\n }\n };\n\n return tracer.startActiveSpan(\n spanName,\n options.startNewRoot ? { root: true } : {},\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('sampling.tail.keep', shouldKeepSpan);\n span.setAttribute('sampling.tail.evaluated', true);\n }\n };\n\n // Sync handlers for synchronous results (can't await)\n // NOTE: autoFlush 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 - non-generic for type inference\nexport function trace(\n name: string,\n fnFactory: (ctx: TraceContext) => () => unknown,\n): () => unknown;\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 - non-generic for type inference\nexport function trace(\n options: TracingOptions,\n fnFactory: (ctx: TraceContext) => () => unknown,\n): () => unknown;\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 - non-generic for type inference\nexport function trace(\n name: string,\n fnFactory: (ctx: TraceContext) => () => Promise<unknown>,\n): () => Promise<unknown>;\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 - non-generic for type inference\nexport function trace(\n options: TracingOptions,\n fnFactory: (ctx: TraceContext) => () => Promise<unknown>,\n): () => Promise<unknown>;\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 * @example\n * ```typescript\n * // Async function\n * async function processOrder(order: Order) {\n * await span({\n * name: 'payment.charge',\n * attributes: { amount: order.total }\n * }, async (span) => {\n * await chargeCustomer(order);\n * })\n * }\n *\n * // Sync function\n * function calculateTotal(items: Item[]) {\n * return span({\n * name: 'calculateTotal',\n * attributes: { itemCount: items.length }\n * }, (span) => {\n * return items.reduce((sum, item) => sum + item.price, 0);\n * })\n * }\n * ```\n */\n// Overload for sync functions (more specific - should come first)\nexport function span<T = unknown>(\n options: SpanOptions,\n fn: (span: Span) => T,\n): T;\n// Overload for async functions\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 options: SpanOptions,\n fn: (span: Span) => T | Promise<T>,\n): T | Promise<T> {\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 result = tracer.startActiveSpan(name, 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 // Run the function within the new context\n return context.with(newContext, fn);\n}\n","/**\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\nimport { readFileSync } from 'node:fs';\nimport { fileURLToPath } 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 = 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 readFileSync !== 'function') {\n return undefined;\n }\n\n const content = 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"]}
@@ -0,0 +1,126 @@
1
+ 'use strict';
2
+
3
+ var chunkNHCNRQD3_cjs = require('./chunk-NHCNRQD3.cjs');
4
+ var chunkG7VZBCD6_cjs = require('./chunk-G7VZBCD6.cjs');
5
+ var api = require('@opentelemetry/api');
6
+
7
+ var spanNameMap = /* @__PURE__ */ new WeakMap();
8
+ function setSpanName(span, name) {
9
+ spanNameMap.set(span, name);
10
+ }
11
+ function hexToDecimal(hex) {
12
+ return BigInt("0x" + hex).toString(10);
13
+ }
14
+ function getTraceContext() {
15
+ const span = api.trace.getActiveSpan();
16
+ if (!span) return null;
17
+ const spanContext = span.spanContext();
18
+ const traceId = spanContext.traceId;
19
+ const spanId = spanContext.spanId;
20
+ const spanName = spanNameMap.get(span);
21
+ const traceIdLower64 = traceId.slice(-16);
22
+ const ddTraceId = hexToDecimal(traceIdLower64);
23
+ const ddSpanId = hexToDecimal(spanId);
24
+ return {
25
+ traceId,
26
+ spanId,
27
+ correlationId: traceId.slice(0, 16),
28
+ ...spanName && { "code.function": spanName },
29
+ // Datadog-specific fields for log-trace correlation
30
+ "dd.trace_id": ddTraceId,
31
+ "dd.span_id": ddSpanId
32
+ };
33
+ }
34
+ function enrichWithTraceContext(obj) {
35
+ const context2 = getTraceContext();
36
+ return context2 ? { ...obj, ...context2 } : obj;
37
+ }
38
+ function isTracing() {
39
+ return api.trace.getActiveSpan() !== void 0;
40
+ }
41
+ function getTracer(name, version) {
42
+ return api.trace.getTracer(name, version);
43
+ }
44
+ function getActiveSpan() {
45
+ return api.trace.getActiveSpan();
46
+ }
47
+ function getActiveContext() {
48
+ try {
49
+ const { getActiveContextWithBaggage } = (chunkNHCNRQD3_cjs.init_trace_context(), chunkG7VZBCD6_cjs.__toCommonJS(chunkNHCNRQD3_cjs.trace_context_exports));
50
+ return getActiveContextWithBaggage();
51
+ } catch {
52
+ return api.context.active();
53
+ }
54
+ }
55
+ function runWithSpan(span, fn) {
56
+ const ctx = api.trace.setSpan(api.context.active(), span);
57
+ return api.context.with(ctx, fn);
58
+ }
59
+ function finalizeSpan(span, error) {
60
+ if (error) {
61
+ if (error instanceof Error) {
62
+ span.recordException(error);
63
+ } else {
64
+ span.recordException(new Error(String(error)));
65
+ }
66
+ span.setStatus({ code: api.SpanStatusCode.ERROR });
67
+ } else {
68
+ span.setStatus({ code: api.SpanStatusCode.OK });
69
+ }
70
+ span.end();
71
+ }
72
+ async function createDeterministicTraceId(seed) {
73
+ const encoder = new TextEncoder();
74
+ const data = encoder.encode(seed);
75
+ const hashBuffer = await crypto.subtle.digest("SHA-256", data);
76
+ const hashArray = new Uint8Array(hashBuffer);
77
+ return [...hashArray].map((byte) => byte.toString(16).padStart(2, "0")).join("").slice(0, 32);
78
+ }
79
+ function flattenMetadata(metadata, prefix = "metadata") {
80
+ const flattened = {};
81
+ const seen = /* @__PURE__ */ new WeakSet();
82
+ function flatten(obj, currentPrefix) {
83
+ for (const [key, value] of Object.entries(obj)) {
84
+ if (value == null) continue;
85
+ const attributeKey = `${currentPrefix}.${key}`;
86
+ if (typeof value === "string") {
87
+ flattened[attributeKey] = value;
88
+ continue;
89
+ }
90
+ if (typeof value === "number" || typeof value === "boolean") {
91
+ flattened[attributeKey] = String(value);
92
+ continue;
93
+ }
94
+ if (typeof value === "object" && value !== null && value.constructor === Object) {
95
+ if (seen.has(value)) {
96
+ flattened[attributeKey] = "<circular-reference>";
97
+ continue;
98
+ }
99
+ seen.add(value);
100
+ flatten(value, attributeKey);
101
+ continue;
102
+ }
103
+ try {
104
+ flattened[attributeKey] = JSON.stringify(value);
105
+ } catch {
106
+ flattened[attributeKey] = "<serialization-failed>";
107
+ }
108
+ }
109
+ }
110
+ flatten(metadata, prefix);
111
+ return flattened;
112
+ }
113
+
114
+ exports.createDeterministicTraceId = createDeterministicTraceId;
115
+ exports.enrichWithTraceContext = enrichWithTraceContext;
116
+ exports.finalizeSpan = finalizeSpan;
117
+ exports.flattenMetadata = flattenMetadata;
118
+ exports.getActiveContext = getActiveContext;
119
+ exports.getActiveSpan = getActiveSpan;
120
+ exports.getTraceContext = getTraceContext;
121
+ exports.getTracer = getTracer;
122
+ exports.isTracing = isTracing;
123
+ exports.runWithSpan = runWithSpan;
124
+ exports.setSpanName = setSpanName;
125
+ //# sourceMappingURL=chunk-TRI4V5BF.cjs.map
126
+ //# sourceMappingURL=chunk-TRI4V5BF.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/trace-helpers.ts"],"names":["trace","context","init_trace_context","__toCommonJS","trace_context_exports","SpanStatusCode"],"mappings":"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","file":"chunk-TRI4V5BF.cjs","sourcesContent":["/**\n * Trace context helpers - Core primitives for trace correlation\n *\n * These are the building blocks that allow users to bring their own logger\n * (bunyan, log4js, custom, etc.) and add trace correlation.\n *\n * @example Using with bunyan\n * ```typescript\n * import bunyan from 'bunyan';\n * import { enrichWithTraceContext } from 'autotel/trace-helpers';\n *\n * const bunyanLogger = bunyan.createLogger({ name: 'myapp' });\n *\n * const logger = {\n * info: (msg: string, extra?: object) => {\n * bunyanLogger.info(enrichWithTraceContext(extra || {}), msg);\n * }\n * };\n * ```\n *\n * @example Using with log4js\n * ```typescript\n * import log4js from 'log4js';\n * import { getTraceContext } from 'autotel/trace-helpers';\n *\n * const log4jsLogger = log4js.getLogger();\n *\n * function logWithTrace(level: string, msg: string, extra?: object) {\n * const context = getTraceContext();\n * log4jsLogger[level](msg, { ...extra, ...context });\n * }\n * ```\n */\n\nimport { trace, context, SpanStatusCode } from '@opentelemetry/api';\nimport type { Span, Tracer, Context } from '@opentelemetry/api';\n\n/**\n * WeakMap to store span names for active spans\n * This allows us to retrieve the span name even though OpenTelemetry\n * doesn't expose it through the public API\n */\nconst spanNameMap = new WeakMap<Span, string>();\n\n/**\n * Store span name for a given span\n * Called internally when spans are created\n */\nexport function setSpanName(span: Span, name: string): void {\n spanNameMap.set(span, name);\n}\n\n/**\n * Trace context extracted from active span\n */\nexport interface TraceContext {\n /** Full 32-character hex trace ID */\n traceId: string;\n /** 16-character hex span ID */\n spanId: string;\n /** First 16 characters of trace ID (for log grouping/correlation) */\n correlationId: string;\n /** Function/operation name (OpenTelemetry semantic convention: code.function) */\n 'code.function'?: string;\n /** Datadog trace ID in decimal format (lower 64 bits) for log-trace correlation */\n 'dd.trace_id'?: string;\n /** Datadog span ID in decimal format for log-trace correlation */\n 'dd.span_id'?: string;\n}\n\n/**\n * Convert hex string to decimal string representation\n * Handles 64-bit unsigned integers for Datadog correlation\n *\n * @param hex - Hex string (up to 16 characters for 64-bit)\n * @returns Decimal string representation\n */\nfunction hexToDecimal(hex: string): string {\n // For 64-bit values, use BigInt to avoid precision loss\n return BigInt('0x' + hex).toString(10);\n}\n\n/**\n * Get current trace context from active span\n *\n * Returns null if no span is active (e.g., outside of trace operation)\n *\n * Includes both OpenTelemetry standard fields (hex) and Datadog-specific\n * fields (decimal) for maximum compatibility.\n *\n * @returns Trace context with traceId, spanId, correlationId, and Datadog decimal IDs, or null\n *\n * @example\n * ```typescript\n * import { getTraceContext } from 'autotel/trace-helpers';\n *\n * const context = getTraceContext();\n * if (context) {\n * console.log('Current trace:', context.traceId);\n * // Current trace: 4bf92f3577b34da6a3ce929d0e0e4736\n * console.log('Datadog trace ID:', context['dd.trace_id']);\n * // Datadog trace ID: 12007117331170166582 (decimal for log correlation)\n * }\n * ```\n */\nexport function getTraceContext(): TraceContext | null {\n const span = trace.getActiveSpan();\n if (!span) return null;\n\n const spanContext = span.spanContext();\n const traceId = spanContext.traceId;\n const spanId = spanContext.spanId;\n\n // Get span name from WeakMap (set when span is created)\n // Map to OpenTelemetry semantic convention: code.function\n const spanName = spanNameMap.get(span);\n\n // Datadog uses the lower 64 bits of the 128-bit OpenTelemetry trace ID\n // Convert from hex to decimal for Datadog's log-trace correlation\n const traceIdLower64 = traceId.slice(-16); // Last 16 hex chars = lower 64 bits\n const ddTraceId = hexToDecimal(traceIdLower64);\n const ddSpanId = hexToDecimal(spanId);\n\n return {\n traceId,\n spanId,\n correlationId: traceId.slice(0, 16),\n ...(spanName && { 'code.function': spanName }),\n // Datadog-specific fields for log-trace correlation\n 'dd.trace_id': ddTraceId,\n 'dd.span_id': ddSpanId,\n };\n}\n\n/**\n * Enrich object with trace context (traceId, spanId, correlationId, and Datadog fields)\n *\n * If no span is active, returns the object unchanged.\n * This prevents \"undefined\" or \"null\" values in logs.\n *\n * Automatically adds both OpenTelemetry standard fields (hex) and Datadog-specific\n * fields (decimal) for maximum compatibility with observability backends.\n *\n * @param obj - Object to enrich (e.g., log metadata)\n * @returns Object with trace context merged in, or unchanged if no active span\n *\n * @example\n * ```typescript\n * import { enrichWithTraceContext } from 'autotel/trace-helpers';\n *\n * // Inside a trace operation:\n * const enriched = enrichWithTraceContext({ userId: '123' });\n * // {\n * // userId: '123',\n * // traceId: '4bf92f3577b34da6a3ce929d0e0e4736',\n * // spanId: '00f067aa0ba902b7',\n * // correlationId: '4bf92f3577b34da6',\n * // 'dd.trace_id': '12007117331170166582', // Datadog decimal format\n * // 'dd.span_id': '67667974448284583' // Datadog decimal format\n * // }\n *\n * // Outside trace operation:\n * const unchanged = enrichWithTraceContext({ userId: '123' });\n * // { userId: '123' } - no trace fields added\n * ```\n */\nexport function enrichWithTraceContext<T extends Record<string, unknown>>(\n obj: T,\n): T {\n const context = getTraceContext();\n return context ? ({ ...obj, ...context } as T) : obj;\n}\n\n/**\n * Check if currently in a trace context\n *\n * Useful for conditional logic based on trace presence\n *\n * @returns true if active span exists, false otherwise\n *\n * @example\n * ```typescript\n * import { isTracing } from 'autotel/trace-helpers';\n *\n * if (isTracing()) {\n * // Add expensive debug metadata only when tracing\n * logger.debug('Detailed context', expensiveDebugData());\n * }\n * ```\n */\nexport function isTracing(): boolean {\n return trace.getActiveSpan() !== undefined;\n}\n\n/**\n * Get a tracer instance for creating custom spans\n *\n * Use this when you need low-level control over span lifecycle.\n * For most use cases, prefer trace(), span(), or instrument() instead.\n *\n * @param name - Tracer name (usually your service or module name)\n * @param version - Optional version string\n * @returns OpenTelemetry Tracer instance\n *\n * @example Basic usage\n * ```typescript\n * import { getTracer } from 'autotel';\n *\n * const tracer = getTracer('my-service');\n * const span = tracer.startSpan('custom.operation');\n * try {\n * // Your logic\n * span.setAttribute('key', 'value');\n * } finally {\n * span.end();\n * }\n * ```\n *\n * @example With AI SDK\n * ```typescript\n * import { getTracer } from 'autotel';\n * import { generateText } from 'ai';\n *\n * const tracer = getTracer('ai-agent');\n * const result = await generateText({\n * model: myModel,\n * prompt: 'Hello',\n * experimental_telemetry: {\n * isEnabled: true,\n * tracer,\n * },\n * });\n * ```\n */\nexport function getTracer(name: string, version?: string): Tracer {\n return trace.getTracer(name, version);\n}\n\n/**\n * Get the currently active span\n *\n * Returns undefined if no span is currently active.\n * Useful for adding attributes or events to the current span.\n *\n * @returns Active span or undefined\n *\n * @example Adding attributes to active span\n * ```typescript\n * import { getActiveSpan } from 'autotel';\n *\n * const span = getActiveSpan();\n * if (span) {\n * span.setAttribute('user.id', userId);\n * span.addEvent('User action', { action: 'click' });\n * }\n * ```\n *\n * @example Checking span status\n * ```typescript\n * import { getActiveSpan, SpanStatusCode } from 'autotel';\n *\n * const span = getActiveSpan();\n * if (span?.isRecording()) {\n * span.setStatus({ code: SpanStatusCode.OK });\n * }\n * ```\n */\nexport function getActiveSpan(): Span | undefined {\n return trace.getActiveSpan();\n}\n\n/**\n * Get the currently active OpenTelemetry context\n *\n * The context contains the active span and any baggage.\n * Useful for context propagation and custom instrumentation.\n *\n * @returns Current active context\n *\n * @example Propagating context\n * ```typescript\n * import { getActiveContext } from 'autotel';\n *\n * const currentContext = getActiveContext();\n * // Pass context to another function or service\n * ```\n *\n * @example With context injection\n * ```typescript\n * import { getActiveContext, injectTraceContext } from 'autotel';\n *\n * const headers = {};\n * injectTraceContext(headers);\n * // Headers now contain trace propagation data\n * ```\n */\nexport function getActiveContext(): Context {\n // Check stored context first (from baggage setters), then fall back to active context\n // This ensures ctx.setBaggage() changes are visible to OpenTelemetry operations\n try {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n const { getActiveContextWithBaggage } = require('./trace-context');\n return getActiveContextWithBaggage();\n } catch {\n // Fallback if trace-context isn't available\n return context.active();\n }\n}\n\n/**\n * Run a function with a specific span set as active\n *\n * This is a convenience wrapper around the two-step process of\n * setting a span in context and running code within that context.\n *\n * @param span - The span to set as active\n * @param fn - Function to execute with the span active\n * @returns The return value of the function\n *\n * @example Running code with a custom span\n * ```typescript\n * import { getTracer, runWithSpan } from 'autotel';\n *\n * const tracer = getTracer('my-service');\n * const span = tracer.startSpan('background.job');\n *\n * try {\n * const result = await runWithSpan(span, async () => {\n * // Any spans created here will be children of 'background.job'\n * await processData();\n * return { success: true };\n * });\n * console.log(result);\n * } finally {\n * span.end();\n * }\n * ```\n *\n * @example Testing with custom spans\n * ```typescript\n * import { runWithSpan, otelTrace } from 'autotel';\n *\n * const tracer = otelTrace.getTracer('test');\n * const span = tracer.startSpan('test.operation');\n *\n * const result = runWithSpan(span, () => {\n * // Code under test runs with this span as active\n * return myFunction();\n * });\n *\n * span.end();\n * ```\n */\nexport function runWithSpan<T>(span: Span, fn: () => T): T {\n const ctx = trace.setSpan(context.active(), span);\n return context.with(ctx, fn);\n}\n\n/**\n * Finalize a span with appropriate status and optional error recording\n *\n * This is a convenience function that:\n * - Records exceptions if an error is provided\n * - Sets span status to ERROR if error exists, OK otherwise\n * - Ends the span\n *\n * @param span - The span to finalize\n * @param error - Optional error to record\n *\n * @example Without error (success case)\n * ```typescript\n * import { getTracer, finalizeSpan } from 'autotel';\n *\n * const tracer = getTracer('my-service');\n * const span = tracer.startSpan('operation');\n *\n * try {\n * await doWork();\n * finalizeSpan(span);\n * } catch (error) {\n * finalizeSpan(span, error);\n * throw error;\n * }\n * ```\n *\n * @example With error\n * ```typescript\n * import { getTracer, finalizeSpan } from 'autotel';\n *\n * const tracer = getTracer('my-service');\n * const span = tracer.startSpan('operation');\n *\n * try {\n * await riskyOperation();\n * finalizeSpan(span);\n * } catch (error) {\n * finalizeSpan(span, error); // Records exception and sets ERROR status\n * throw error;\n * }\n * ```\n *\n * @example In instrumentation\n * ```typescript\n * import { getTracer, runWithSpan, finalizeSpan } from 'autotel';\n *\n * function instrumentedQuery(query: string) {\n * const tracer = getTracer('db');\n * const span = tracer.startSpan('db.query');\n *\n * return runWithSpan(span, () => {\n * try {\n * const result = executeQuery(query);\n * finalizeSpan(span);\n * return result;\n * } catch (error) {\n * finalizeSpan(span, error);\n * throw error;\n * }\n * });\n * }\n * ```\n */\nexport function finalizeSpan(span: Span, error?: unknown): void {\n if (error) {\n if (error instanceof Error) {\n span.recordException(error);\n } else {\n span.recordException(new Error(String(error)));\n }\n span.setStatus({ code: SpanStatusCode.ERROR });\n } else {\n span.setStatus({ code: SpanStatusCode.OK });\n }\n span.end();\n}\n\n/**\n * Creates a deterministic trace ID from a seed string.\n *\n * Generates a consistent 128-bit trace ID (32 hex characters) from an input seed\n * using SHA-256 hashing. Useful for correlating external system IDs (request IDs,\n * order IDs, session IDs) with OpenTelemetry trace IDs.\n *\n * **Use Cases:**\n * - Correlate external request IDs with traces\n * - Link customer support tickets to trace data\n * - Associate business entities (orders, sessions) with observability data\n * - Debug specific user flows by deterministic trace lookup\n *\n * **Important:** Only use this when you need deterministic trace IDs for correlation.\n * For normal tracing, let OpenTelemetry generate random trace IDs automatically.\n *\n * **Runtime Support:**\n * - Node.js 15+ (native crypto.subtle)\n * - All modern browsers\n * - Edge runtimes (Cloudflare Workers, Deno, etc.)\n *\n * @param seed - Input string to generate trace ID from (e.g., request ID, order ID)\n * @returns Promise resolving to a 32-character hex trace ID (128 bits)\n *\n * @example Correlate external request ID with trace\n * ```typescript\n * import { createDeterministicTraceId } from 'autotel/trace-helpers'\n * import { trace, context } from '@opentelemetry/api'\n *\n * // In middleware or request handler\n * const requestId = req.headers['x-request-id']\n * const traceId = await createDeterministicTraceId(requestId)\n *\n * // Use with manual span creation (advanced - not needed with trace/span functions)\n * const tracer = trace.getTracer('my-service')\n * const spanContext = {\n * traceId,\n * spanId: '0123456789abcdef', // Still random\n * traceFlags: 1\n * }\n * ```\n *\n * @example Link customer support tickets to traces\n * ```typescript\n * import { createDeterministicTraceId } from 'autotel/trace-helpers'\n *\n * // Support dashboard integration\n * const ticketId = 'TICKET-12345'\n * const traceId = await createDeterministicTraceId(ticketId)\n *\n * // Generate direct link to traces in observability backend\n * const traceUrl = `https://your-otel-backend.com/traces/${traceId}`\n * console.log(`View related traces: ${traceUrl}`)\n * ```\n *\n * @example Session-based correlation\n * ```typescript\n * import { createDeterministicTraceId } from 'autotel/trace-helpers'\n *\n * // Track all operations for a user session\n * const sessionId = req.session.id\n * const traceId = await createDeterministicTraceId(sessionId)\n *\n * // All operations in this session share the same trace ID\n * // Makes it easy to find all activity for a specific session\n * ```\n *\n * @public\n */\nexport async function createDeterministicTraceId(\n seed: string,\n): Promise<string> {\n // Encode seed string to bytes\n const encoder = new TextEncoder();\n const data = encoder.encode(seed);\n\n // Generate SHA-256 hash (256 bits)\n const hashBuffer = await crypto.subtle.digest('SHA-256', data);\n\n // Convert to hex string and truncate to 32 characters (128 bits)\n // OpenTelemetry trace IDs are 128 bits (16 bytes, 32 hex characters)\n const hashArray = new Uint8Array(hashBuffer);\n return [...hashArray]\n .map((byte) => byte.toString(16).padStart(2, '0'))\n .join('')\n .slice(0, 32);\n}\n\n/**\n * Flattens nested metadata objects into dot-notation span attributes.\n *\n * Converts complex nested objects into flat key-value pairs suitable for\n * OpenTelemetry span attributes. Non-string values are JSON serialized.\n * Handles serialization failures gracefully with a fallback value.\n *\n * **Use Cases:**\n * - Structured metadata with nested objects\n * - User context with multiple properties\n * - Request/response metadata\n * - Business entity attributes\n *\n * **Note:** Filters out null/undefined values automatically to keep spans clean.\n *\n * @param metadata - Nested metadata object to flatten\n * @param prefix - Prefix for all attribute keys (default: 'metadata')\n * @returns Flattened attributes as { [key: string]: string }\n *\n * @example Basic metadata flattening\n * ```typescript\n * import { flattenMetadata } from 'autotel/trace-helpers'\n * import { trace } from 'autotel'\n *\n * export const processOrder = trace(ctx => async (orderId: string) => {\n * const order = await getOrder(orderId)\n *\n * // Flatten complex order metadata\n * const flattened = flattenMetadata({\n * user: { id: order.userId, tier: 'premium' },\n * payment: { method: 'card', processor: 'stripe' },\n * items: order.items.length\n * })\n *\n * ctx.setAttributes(flattened)\n * // Results in:\n * // {\n * // 'metadata.user.id': 'user-123',\n * // 'metadata.user.tier': 'premium',\n * // 'metadata.payment.method': 'card',\n * // 'metadata.payment.processor': 'stripe',\n * // 'metadata.items': '5'\n * // }\n * })\n * ```\n *\n * @example Custom prefix for semantic conventions\n * ```typescript\n * import { flattenMetadata } from 'autotel/trace-helpers'\n * import { trace } from 'autotel'\n *\n * export const fetchUser = trace(ctx => async (userId: string) => {\n * const user = await db.users.findOne({ id: userId })\n *\n * // Use semantic convention prefix\n * const userAttrs = flattenMetadata(\n * {\n * id: user.id,\n * email: user.email,\n * plan: user.subscription.plan\n * },\n * 'user' // Custom prefix\n * )\n *\n * ctx.setAttributes(userAttrs)\n * // Results in:\n * // {\n * // 'user.id': 'user-123',\n * // 'user.email': 'user@example.com',\n * // 'user.plan': 'enterprise'\n * // }\n * })\n * ```\n *\n * @example With complex objects (auto-serialized)\n * ```typescript\n * import { flattenMetadata } from 'autotel/trace-helpers'\n * import { trace } from 'autotel'\n *\n * export const analyzeRequest = trace(ctx => async (req: Request) => {\n * const metadata = flattenMetadata({\n * headers: req.headers, // Object - will be JSON serialized\n * query: req.query, // Object - will be JSON serialized\n * timestamp: new Date() // Non-string - will be JSON serialized\n * })\n *\n * ctx.setAttributes(metadata)\n * // Results in:\n * // {\n * // 'metadata.headers': '{\"accept\":\"application/json\",...}',\n * // 'metadata.query': '{\"page\":\"1\",\"limit\":\"10\"}',\n * // 'metadata.timestamp': '\"2024-01-15T12:00:00.000Z\"'\n * // }\n * })\n * ```\n *\n * @example Error handling\n * ```typescript\n * import { flattenMetadata } from 'autotel/trace-helpers'\n *\n * // Objects with circular references are handled gracefully\n * const circular: any = { a: 1 }\n * circular.self = circular\n *\n * const flattened = flattenMetadata({ data: circular })\n * // Results in:\n * // { 'metadata.data': '<serialization-failed>' }\n * ```\n *\n * @public\n */\nexport function flattenMetadata(\n metadata: Record<string, unknown>,\n prefix = 'metadata',\n): Record<string, string> {\n const flattened: Record<string, string> = {};\n const seen = new WeakSet<object>(); // Track visited objects to detect cycles\n\n function flatten(obj: Record<string, unknown>, currentPrefix: string): void {\n for (const [key, value] of Object.entries(obj)) {\n // Skip null/undefined values\n if (value == null) continue;\n\n const attributeKey = `${currentPrefix}.${key}`;\n\n // Handle primitives directly (string, number, boolean)\n if (typeof value === 'string') {\n flattened[attributeKey] = value;\n continue;\n }\n if (typeof value === 'number' || typeof value === 'boolean') {\n flattened[attributeKey] = String(value);\n continue;\n }\n\n // Recursively flatten plain objects (with cycle detection)\n if (\n typeof value === 'object' &&\n value !== null &&\n value.constructor === Object\n ) {\n // Detect circular references\n if (seen.has(value)) {\n flattened[attributeKey] = '<circular-reference>';\n continue;\n }\n\n // Mark as visited and recursively flatten\n seen.add(value);\n flatten(value as Record<string, unknown>, attributeKey);\n continue;\n }\n\n // Serialize arrays and other non-plain objects to JSON\n try {\n flattened[attributeKey] = JSON.stringify(value);\n } catch {\n // Handle circular references or non-serializable objects\n flattened[attributeKey] = '<serialization-failed>';\n }\n }\n }\n\n flatten(metadata, prefix);\n return flattened;\n}\n"]}