autotel 2.26.3 → 3.0.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 (144) hide show
  1. package/README.md +29 -19
  2. package/dist/attributes.d.cts +3 -3
  3. package/dist/attributes.d.ts +3 -3
  4. package/dist/business-baggage.d.cts +1 -1
  5. package/dist/business-baggage.d.ts +1 -1
  6. package/dist/{chunk-YN7USLHW.js → chunk-3QMFLJHJ.js} +11 -10
  7. package/dist/chunk-3QMFLJHJ.js.map +1 -0
  8. package/dist/{chunk-BJ2XPN77.js → chunk-4DAG3RFS.js} +4 -4
  9. package/dist/{chunk-BJ2XPN77.js.map → chunk-4DAG3RFS.js.map} +1 -1
  10. package/dist/chunk-4P6ZOARG.cjs +33 -0
  11. package/dist/chunk-4P6ZOARG.cjs.map +1 -0
  12. package/dist/{chunk-U54FTVFH.js → chunk-7HNQYHK4.js} +3 -3
  13. package/dist/{chunk-U54FTVFH.js.map → chunk-7HNQYHK4.js.map} +1 -1
  14. package/dist/chunk-CJ4PD2TZ.cjs +1207 -0
  15. package/dist/chunk-CJ4PD2TZ.cjs.map +1 -0
  16. package/dist/{chunk-HPUGKUMZ.js → chunk-DAAJLUTO.js} +13 -640
  17. package/dist/chunk-DAAJLUTO.js.map +1 -0
  18. package/dist/{chunk-B3ZHLLMP.js → chunk-DSMSIVTG.js} +2 -2
  19. package/dist/chunk-DSMSIVTG.js.map +1 -0
  20. package/dist/{chunk-6YGUN7IY.cjs → chunk-DWOBIBLY.cjs} +18 -17
  21. package/dist/chunk-DWOBIBLY.cjs.map +1 -0
  22. package/dist/{chunk-QC5MNKVF.js → chunk-IUDXKLS4.js} +13 -12
  23. package/dist/chunk-IUDXKLS4.js.map +1 -0
  24. package/dist/{chunk-OBWXM4NN.cjs → chunk-KHGA4OST.cjs} +15 -14
  25. package/dist/chunk-KHGA4OST.cjs.map +1 -0
  26. package/dist/chunk-KIL5CUN6.js +31 -0
  27. package/dist/chunk-KIL5CUN6.js.map +1 -0
  28. package/dist/{chunk-YEVCD6DR.cjs → chunk-L7JDUDJD.cjs} +7 -7
  29. package/dist/{chunk-YEVCD6DR.cjs.map → chunk-L7JDUDJD.cjs.map} +1 -1
  30. package/dist/{chunk-UTZR7P7E.cjs → chunk-MOK3E54E.cjs} +29 -659
  31. package/dist/chunk-MOK3E54E.cjs.map +1 -0
  32. package/dist/{chunk-GML3FBOT.cjs → chunk-NCSMD3TK.cjs} +2 -2
  33. package/dist/chunk-NCSMD3TK.cjs.map +1 -0
  34. package/dist/chunk-QG3U5ONP.js +1183 -0
  35. package/dist/chunk-QG3U5ONP.js.map +1 -0
  36. package/dist/chunk-SEO6NAQT.js +14 -0
  37. package/dist/chunk-SEO6NAQT.js.map +1 -0
  38. package/dist/chunk-VQTCQKHQ.cjs +17 -0
  39. package/dist/chunk-VQTCQKHQ.cjs.map +1 -0
  40. package/dist/{chunk-WZOKY3PW.cjs → chunk-ZSABTI3C.cjs} +8 -8
  41. package/dist/{chunk-WZOKY3PW.cjs.map → chunk-ZSABTI3C.cjs.map} +1 -1
  42. package/dist/correlation-id.cjs +22 -10
  43. package/dist/correlation-id.js +14 -2
  44. package/dist/decorators.cjs +5 -6
  45. package/dist/decorators.cjs.map +1 -1
  46. package/dist/decorators.d.cts +1 -1
  47. package/dist/decorators.d.ts +1 -1
  48. package/dist/decorators.js +4 -5
  49. package/dist/decorators.js.map +1 -1
  50. package/dist/event.cjs +6 -7
  51. package/dist/event.js +3 -4
  52. package/dist/functional.cjs +11 -12
  53. package/dist/functional.d.cts +1 -1
  54. package/dist/functional.d.ts +1 -1
  55. package/dist/functional.js +4 -5
  56. package/dist/http.cjs +13 -2
  57. package/dist/http.cjs.map +1 -1
  58. package/dist/http.js +12 -1
  59. package/dist/http.js.map +1 -1
  60. package/dist/index.cjs +134 -243
  61. package/dist/index.cjs.map +1 -1
  62. package/dist/index.d.cts +23 -8
  63. package/dist/index.d.ts +23 -8
  64. package/dist/index.js +52 -176
  65. package/dist/index.js.map +1 -1
  66. package/dist/messaging-adapters.d.cts +1 -1
  67. package/dist/messaging-adapters.d.ts +1 -1
  68. package/dist/messaging-testing.d.cts +1 -1
  69. package/dist/messaging-testing.d.ts +1 -1
  70. package/dist/messaging.cjs +9 -9
  71. package/dist/messaging.d.cts +1 -1
  72. package/dist/messaging.d.ts +1 -1
  73. package/dist/messaging.js +6 -6
  74. package/dist/semantic-helpers.cjs +9 -10
  75. package/dist/semantic-helpers.d.cts +1 -1
  76. package/dist/semantic-helpers.d.ts +1 -1
  77. package/dist/semantic-helpers.js +5 -6
  78. package/dist/{trace-context-t5X1AP-e.d.ts → trace-context-DbGKd1Rn.d.cts} +18 -5
  79. package/dist/{trace-context-t5X1AP-e.d.cts → trace-context-DbGKd1Rn.d.ts} +18 -5
  80. package/dist/trace-helpers.cjs +13 -13
  81. package/dist/trace-helpers.d.cts +2 -2
  82. package/dist/trace-helpers.d.ts +2 -2
  83. package/dist/trace-helpers.js +1 -1
  84. package/dist/{utils-CbUkl8r1.d.cts → utils-BahBCFtJ.d.cts} +1 -1
  85. package/dist/{utils-Buel3cj0.d.ts → utils-CLKwaUlG.d.ts} +1 -1
  86. package/dist/webhook.cjs +19 -10
  87. package/dist/webhook.cjs.map +1 -1
  88. package/dist/webhook.d.cts +1 -1
  89. package/dist/webhook.d.ts +1 -1
  90. package/dist/webhook.js +18 -9
  91. package/dist/webhook.js.map +1 -1
  92. package/dist/workflow-distributed.cjs +23 -19
  93. package/dist/workflow-distributed.cjs.map +1 -1
  94. package/dist/workflow-distributed.d.cts +1 -1
  95. package/dist/workflow-distributed.d.ts +1 -1
  96. package/dist/workflow-distributed.js +21 -17
  97. package/dist/workflow-distributed.js.map +1 -1
  98. package/dist/workflow.cjs +10 -10
  99. package/dist/workflow.d.cts +1 -1
  100. package/dist/workflow.d.ts +1 -1
  101. package/dist/workflow.js +6 -6
  102. package/package.json +1 -1
  103. package/skills/autotel-core/SKILL.md +2 -0
  104. package/skills/autotel-events/SKILL.md +2 -0
  105. package/skills/autotel-frameworks/SKILL.md +2 -0
  106. package/skills/autotel-instrumentation/SKILL.md +2 -0
  107. package/skills/autotel-request-logging/SKILL.md +2 -0
  108. package/skills/autotel-structured-errors/SKILL.md +2 -0
  109. package/src/correlated-events.test.ts +151 -0
  110. package/src/correlated-events.ts +47 -0
  111. package/src/functional.ts +2 -0
  112. package/src/gen-ai-events.ts +14 -5
  113. package/src/index.ts +20 -4
  114. package/src/messaging.ts +10 -9
  115. package/src/request-logger.ts +4 -3
  116. package/src/structured-error.test.ts +83 -1
  117. package/src/structured-error.ts +9 -2
  118. package/src/trace-context.ts +39 -11
  119. package/src/trace-helpers.ts +2 -2
  120. package/src/trace-hybrid.test.ts +42 -0
  121. package/src/trace-hybrid.ts +37 -0
  122. package/src/webhook.ts +16 -7
  123. package/src/workflow-distributed.ts +18 -13
  124. package/src/workflow.ts +7 -6
  125. package/dist/chunk-6YGUN7IY.cjs.map +0 -1
  126. package/dist/chunk-B3ZHLLMP.js.map +0 -1
  127. package/dist/chunk-BBBWDIYQ.js +0 -211
  128. package/dist/chunk-BBBWDIYQ.js.map +0 -1
  129. package/dist/chunk-D5LMF53P.cjs +0 -150
  130. package/dist/chunk-D5LMF53P.cjs.map +0 -1
  131. package/dist/chunk-GML3FBOT.cjs.map +0 -1
  132. package/dist/chunk-HPUGKUMZ.js.map +0 -1
  133. package/dist/chunk-HZ3FYBJG.cjs +0 -217
  134. package/dist/chunk-HZ3FYBJG.cjs.map +0 -1
  135. package/dist/chunk-JSNUWSBH.cjs +0 -62
  136. package/dist/chunk-JSNUWSBH.cjs.map +0 -1
  137. package/dist/chunk-OBWXM4NN.cjs.map +0 -1
  138. package/dist/chunk-QC5MNKVF.js.map +0 -1
  139. package/dist/chunk-S4OFEXLA.js +0 -53
  140. package/dist/chunk-S4OFEXLA.js.map +0 -1
  141. package/dist/chunk-UTZR7P7E.cjs.map +0 -1
  142. package/dist/chunk-WD4RP6IV.js +0 -146
  143. package/dist/chunk-WD4RP6IV.js.map +0 -1
  144. package/dist/chunk-YN7USLHW.js.map +0 -1
package/src/workflow.ts CHANGED
@@ -55,6 +55,7 @@
55
55
 
56
56
  import { AsyncLocalStorage } from 'node:async_hooks';
57
57
  import type { Attributes, Link, SpanContext } from '@opentelemetry/api';
58
+ import { emitCorrelatedEvent } from './correlated-events';
58
59
  import { trace } from './functional';
59
60
  import type { TraceContext } from './trace-context';
60
61
  import { getActiveSpan } from './trace-helpers';
@@ -440,7 +441,7 @@ export function traceStep<TArgs extends unknown[], TReturn>(
440
441
  try {
441
442
  if (attempt > 1) {
442
443
  ctx.setAttribute('workflow.step.retry_attempt', attempt);
443
- ctx.addEvent('step_retry', {
444
+ emitCorrelatedEvent(ctx, 'step_retry', {
444
445
  'workflow.step.attempt': attempt,
445
446
  'workflow.step.max_attempts': maxAttempts,
446
447
  });
@@ -463,7 +464,7 @@ export function traceStep<TArgs extends unknown[], TReturn>(
463
464
  lastError = error as Error;
464
465
 
465
466
  if (attempt < maxAttempts) {
466
- ctx.addEvent('step_retry_scheduled', {
467
+ emitCorrelatedEvent(ctx, 'step_retry_scheduled', {
467
468
  'workflow.step.error': String(error),
468
469
  'workflow.step.attempt': attempt,
469
470
  });
@@ -595,7 +596,7 @@ function createWorkflowContext(
595
596
  const step = state.steps.get(stepName);
596
597
  if (step && step.status === 'completed') {
597
598
  try {
598
- baseCtx.addEvent('compensation_started', {
599
+ emitCorrelatedEvent(baseCtx, 'compensation_started', {
599
600
  'workflow.step.name': stepName,
600
601
  });
601
602
 
@@ -620,7 +621,7 @@ function createWorkflowContext(
620
621
  success: boolean,
621
622
  error?: Error,
622
623
  ): void {
623
- baseCtx.addEvent('compensation_completed', {
624
+ emitCorrelatedEvent(baseCtx, 'compensation_completed', {
624
625
  'workflow.step.name': stepName,
625
626
  'workflow.compensation.success': success,
626
627
  ...(error && { 'workflow.compensation.error': String(error) }),
@@ -636,7 +637,7 @@ function createWorkflowContext(
636
637
  state.status = status;
637
638
  baseCtx.setAttribute('workflow.status', status);
638
639
 
639
- baseCtx.addEvent('workflow_status_changed', {
640
+ emitCorrelatedEvent(baseCtx, 'workflow_status_changed', {
640
641
  'workflow.status': status,
641
642
  });
642
643
  },
@@ -702,7 +703,7 @@ function createStepContext(
702
703
  if (reason) {
703
704
  baseCtx.setAttribute('workflow.step.skip_reason', reason);
704
705
  }
705
- baseCtx.addEvent('step_skipped', {
706
+ emitCorrelatedEvent(baseCtx, 'step_skipped', {
706
707
  'workflow.step.name': config.name,
707
708
  ...(reason && { 'workflow.step.skip_reason': reason }),
708
709
  });
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/workflow.ts"],"names":["AsyncLocalStorage","trace","getActiveSpan"],"mappings":"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","file":"chunk-6YGUN7IY.cjs","sourcesContent":["/**\n * Workflow and Saga tracing helpers\n *\n * Provides specialized tracing for multi-step workflows and sagas with\n * automatic step linking, compensation tracking, and workflow correlation.\n *\n * @example Simple workflow\n * ```typescript\n * import { traceWorkflow, traceStep } from 'autotel/workflow';\n *\n * export const processOrder = traceWorkflow({\n * name: 'OrderFulfillment',\n * workflowId: (order) => order.id,\n * })(ctx => async (order: Order) => {\n * await validateOrder(order);\n * await chargePayment(order);\n * await shipOrder(order);\n * });\n * ```\n *\n * @example Saga with compensation\n * ```typescript\n * import { traceWorkflow, traceStep } from 'autotel/workflow';\n *\n * export const orderSaga = traceWorkflow({\n * name: 'OrderSaga',\n * workflowId: () => generateUUID(),\n * })(ctx => async (order: Order) => {\n *\n * const reserveStep = traceStep({\n * name: 'ReserveInventory',\n * compensate: async () => {\n * await releaseInventory(order.items);\n * },\n * })(async () => {\n * await inventoryService.reserve(order.items);\n * });\n * await reserveStep();\n *\n * const paymentStep = traceStep({\n * name: 'ProcessPayment',\n * linkToPrevious: true,\n * compensate: async () => {\n * await refundPayment(order.paymentId);\n * },\n * })(async () => {\n * await paymentService.charge(order);\n * });\n * await paymentStep();\n * });\n * ```\n *\n * @module\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Attributes, Link, SpanContext } from '@opentelemetry/api';\nimport { trace } from './functional';\nimport type { TraceContext } from './trace-context';\nimport { getActiveSpan } from './trace-helpers';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Workflow status\n */\nexport type WorkflowStatus =\n | 'pending'\n | 'running'\n | 'completed'\n | 'failed'\n | 'compensating'\n | 'compensated'\n | 'compensation_failed';\n\n/**\n * Step status\n */\nexport type StepStatus =\n | 'pending'\n | 'running'\n | 'completed'\n | 'failed'\n | 'skipped'\n | 'compensated';\n\n/**\n * Configuration for workflow tracing\n */\nexport interface WorkflowConfig<TArgs extends unknown[] = unknown[]> {\n /** Workflow name (e.g., 'OrderFulfillment', 'UserOnboarding') */\n name: string;\n\n /**\n * Function to extract or generate workflow ID\n * Can be static string, function of args, or generator\n */\n workflowId: string | ((...args: TArgs) => string);\n\n /** Optional workflow version */\n version?: string;\n\n /** Additional attributes */\n attributes?: Attributes;\n\n /** Callback on workflow completion */\n onComplete?: (ctx: WorkflowContext, result: unknown) => void;\n\n /** Callback on workflow failure */\n onFailed?: (ctx: WorkflowContext, error: Error) => void;\n\n /** Callback on compensation start */\n onCompensating?: (ctx: WorkflowContext) => void;\n}\n\n/**\n * Configuration for workflow step tracing\n */\nexport interface StepConfig {\n /** Step name */\n name: string;\n\n /** Optional step description */\n description?: string;\n\n /** Step index (auto-assigned if not provided) */\n index?: number;\n\n /** Link to previous step span */\n linkToPrevious?: boolean;\n\n /** Link to specific step(s) by name */\n linkTo?: string | string[];\n\n /** Additional attributes */\n attributes?: Attributes;\n\n /** Compensation handler for saga rollback */\n compensate?: (error: Error) => Promise<void> | void;\n\n /** Whether this step is idempotent */\n idempotent?: boolean;\n\n /** Retry configuration */\n retry?: {\n maxAttempts: number;\n backoffMs?: number;\n };\n\n /** Callback on step completion */\n onComplete?: (ctx: StepContext) => void;\n\n /** Callback on step failure */\n onFailed?: (ctx: StepContext, error: Error) => void;\n}\n\n/**\n * Step metadata stored for linking and compensation\n */\ninterface StepMetadata {\n name: string;\n index: number;\n status: StepStatus;\n spanContext?: SpanContext;\n compensate?: (error: Error) => Promise<void> | void;\n startTime: number;\n endTime?: number;\n}\n\n/**\n * Extended trace context for workflows\n */\nexport interface WorkflowContext extends TraceContext {\n /** Get the workflow ID */\n getWorkflowId(): string;\n\n /** Get workflow name */\n getWorkflowName(): string;\n\n /** Get current workflow status */\n getStatus(): WorkflowStatus;\n\n /** Mark step as completed and store for linking */\n completeStep(stepName: string): void;\n\n /** Get previous step's span context for linking */\n getPreviousStep(stepName?: string): SpanContext | null;\n\n /** Get all completed steps */\n getCompletedSteps(): string[];\n\n /** Register a compensation handler */\n registerCompensation(\n stepName: string,\n handler: (error: Error) => Promise<void> | void,\n ): void;\n\n /** Trigger compensation for all registered steps */\n compensate(error: Error): Promise<void>;\n\n /** Record compensation result */\n recordCompensation(stepName: string, success: boolean, error?: Error): void;\n\n /** Set workflow status */\n setWorkflowStatus(status: WorkflowStatus): void;\n}\n\n/**\n * Extended trace context for workflow steps\n */\nexport interface StepContext extends TraceContext {\n /** Get step name */\n getStepName(): string;\n\n /** Get step index */\n getStepIndex(): number;\n\n /** Mark this step as completed */\n complete(): void;\n\n /** Skip this step */\n skip(reason?: string): void;\n\n /** Get workflow context */\n getWorkflowContext(): WorkflowContext | null;\n}\n\n// ============================================================================\n// Storage\n// ============================================================================\n\n// Store workflow state in a WeakMap keyed by span\nconst workflowStates = new WeakMap<\n object,\n {\n workflowId: string;\n workflowName: string;\n status: WorkflowStatus;\n steps: Map<string, StepMetadata>;\n stepCounter: number;\n compensations: Map<string, (error: Error) => Promise<void> | void>;\n }\n>();\n\n/**\n * AsyncLocalStorage for workflow context (async-safe)\n *\n * This replaces the previous module-level variable which was NOT safe for\n * concurrent workflows. AsyncLocalStorage ensures each async execution chain\n * has its own isolated workflow context.\n */\nconst workflowContextStorage = new AsyncLocalStorage<WorkflowContext>();\n\n// ============================================================================\n// Workflow Helper\n// ============================================================================\n\n/**\n * Create a traced workflow function\n *\n * Wraps business logic in a workflow span with automatic step tracking,\n * correlation via workflow ID, and compensation support.\n *\n * @param config - Workflow configuration\n * @returns Factory function that wraps your workflow logic\n *\n * @example Order fulfillment workflow\n * ```typescript\n * export const fulfillOrder = traceWorkflow({\n * name: 'OrderFulfillment',\n * workflowId: (order) => order.id,\n * version: '2.0',\n * })(ctx => async (order: Order) => {\n * ctx.setAttribute('order.total', order.total);\n *\n * await validateOrder(order);\n * await processPayment(order);\n * await fulfillItems(order);\n * await notifyCustomer(order);\n *\n * return { success: true, orderId: order.id };\n * });\n * ```\n */\nexport function traceWorkflow<TArgs extends unknown[], TReturn>(\n config: WorkflowConfig<TArgs>,\n) {\n const spanName = `workflow.${config.name}`;\n\n return (\n fnFactory: (ctx: WorkflowContext) => (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n return trace<TArgs, TReturn>(spanName, (baseCtx) => {\n return async (...args: TArgs) => {\n // Generate or extract workflow ID\n const workflowId =\n typeof config.workflowId === 'function'\n ? config.workflowId(...args)\n : config.workflowId;\n\n // Create workflow context\n const ctx = createWorkflowContext(baseCtx, config.name, workflowId);\n\n // Set workflow attributes\n ctx.setAttribute('workflow.name', config.name);\n ctx.setAttribute('workflow.id', workflowId);\n if (config.version) {\n ctx.setAttribute('workflow.version', config.version);\n }\n ctx.setAttribute('workflow.status', 'running');\n\n // Set custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined) {\n ctx.setAttribute(key, value as string | number | boolean);\n }\n }\n }\n\n // Run workflow in AsyncLocalStorage context for async-safety\n // This ensures concurrent workflows have isolated contexts\n return workflowContextStorage.run(ctx, async () => {\n try {\n // Execute workflow\n const userFn = fnFactory(ctx);\n const result = await userFn(...args);\n\n // Mark as completed\n ctx.setWorkflowStatus('completed');\n config.onComplete?.(ctx, result);\n\n return result;\n } catch (error) {\n // Mark as failed\n ctx.setWorkflowStatus('failed');\n config.onFailed?.(ctx, error as Error);\n\n // Check if we have compensations to run\n const state = getWorkflowState();\n if (state && state.compensations.size > 0) {\n ctx.setWorkflowStatus('compensating');\n config.onCompensating?.(ctx);\n\n try {\n await ctx.compensate(error as Error);\n ctx.setWorkflowStatus('compensated');\n } catch (compensationError) {\n ctx.setWorkflowStatus('compensation_failed');\n ctx.setAttribute(\n 'workflow.compensation.error',\n String(compensationError),\n );\n }\n }\n\n throw error;\n }\n });\n };\n });\n };\n}\n\n/**\n * Create a traced workflow step\n *\n * Wraps step logic with automatic linking to previous steps,\n * compensation registration, and status tracking.\n *\n * @param config - Step configuration\n * @returns Factory function that wraps your step logic\n *\n * @example Step with compensation\n * ```typescript\n * const chargePayment = traceStep({\n * name: 'ChargePayment',\n * linkToPrevious: true,\n * compensate: async (error) => {\n * await paymentService.refund(paymentId);\n * },\n * })(async (amount: number) => {\n * return await paymentService.charge(amount);\n * });\n * ```\n */\nexport function traceStep<TArgs extends unknown[], TReturn>(\n config: StepConfig,\n) {\n return (\n fn: (...args: TArgs) => Promise<TReturn>,\n ): ((...args: TArgs) => Promise<TReturn>) => {\n const spanName = `step.${config.name}`;\n\n return trace<TArgs, TReturn>(spanName, (baseCtx) => {\n return async (...args: TArgs) => {\n // Get workflow context from AsyncLocalStorage (async-safe)\n const workflowCtx = workflowContextStorage.getStore() ?? null;\n\n // Create step context\n const ctx = createStepContext(baseCtx, config, workflowCtx);\n\n // Set step attributes\n ctx.setAttribute('workflow.step.name', config.name);\n ctx.setAttribute('workflow.step.index', ctx.getStepIndex());\n ctx.setAttribute('workflow.step.status', 'running');\n\n if (config.description) {\n ctx.setAttribute('workflow.step.description', config.description);\n }\n\n if (config.idempotent) {\n ctx.setAttribute('workflow.step.idempotent', true);\n }\n\n // Set custom attributes\n if (config.attributes) {\n for (const [key, value] of Object.entries(config.attributes)) {\n if (value !== undefined) {\n ctx.setAttribute(key, value as string | number | boolean);\n }\n }\n }\n\n // Link to previous steps\n await addStepLinks(ctx, config, workflowCtx);\n\n // Register compensation if provided\n if (config.compensate && workflowCtx) {\n workflowCtx.registerCompensation(config.name, config.compensate);\n }\n\n // Execute with optional retry\n let lastError: Error | undefined;\n const maxAttempts = config.retry?.maxAttempts ?? 1;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n try {\n if (attempt > 1) {\n ctx.setAttribute('workflow.step.retry_attempt', attempt);\n ctx.addEvent('step_retry', {\n 'workflow.step.attempt': attempt,\n 'workflow.step.max_attempts': maxAttempts,\n });\n\n // Backoff\n if (config.retry?.backoffMs) {\n await sleep(config.retry.backoffMs * attempt);\n }\n }\n\n const result = await fn(...args);\n\n // Mark as completed\n ctx.setAttribute('workflow.step.status', 'completed');\n ctx.complete();\n config.onComplete?.(ctx);\n\n return result;\n } catch (error) {\n lastError = error as Error;\n\n if (attempt < maxAttempts) {\n ctx.addEvent('step_retry_scheduled', {\n 'workflow.step.error': String(error),\n 'workflow.step.attempt': attempt,\n });\n }\n }\n }\n\n // All attempts failed\n ctx.setAttribute('workflow.step.status', 'failed');\n ctx.setAttribute('workflow.step.error', String(lastError));\n config.onFailed?.(ctx, lastError!);\n\n throw lastError;\n };\n });\n };\n}\n\n// ============================================================================\n// Context Creation\n// ============================================================================\n\n/**\n * Create workflow-extended context\n */\nfunction createWorkflowContext(\n baseCtx: TraceContext,\n workflowName: string,\n workflowId: string,\n): WorkflowContext {\n // Initialize state\n const span = getActiveSpan();\n const state = {\n workflowId,\n workflowName,\n status: 'running' as WorkflowStatus,\n steps: new Map<string, StepMetadata>(),\n stepCounter: 0,\n compensations: new Map<string, (error: Error) => Promise<void> | void>(),\n };\n\n if (span) {\n workflowStates.set(span, state);\n }\n\n return {\n ...baseCtx,\n\n getWorkflowId(): string {\n return workflowId;\n },\n\n getWorkflowName(): string {\n return workflowName;\n },\n\n getStatus(): WorkflowStatus {\n return state.status;\n },\n\n completeStep(stepName: string): void {\n let step = state.steps.get(stepName);\n if (!step) {\n // Auto-create step entry for manually managed steps\n // (when using registerCompensation without traceStep)\n step = {\n name: stepName,\n index: state.stepCounter++,\n status: 'pending',\n startTime: Date.now(),\n };\n state.steps.set(stepName, step);\n }\n step.status = 'completed';\n step.endTime = Date.now();\n\n // Capture span context for linking\n const currentSpan = getActiveSpan();\n if (currentSpan) {\n step.spanContext = currentSpan.spanContext();\n }\n },\n\n getPreviousStep(stepName?: string): SpanContext | null {\n if (stepName) {\n const step = state.steps.get(stepName);\n return step?.spanContext ?? null;\n }\n\n // Get last completed step\n let lastStep: StepMetadata | null = null;\n for (const step of state.steps.values()) {\n if (\n step.status === 'completed' &&\n (!lastStep || step.index > lastStep.index)\n ) {\n lastStep = step;\n }\n }\n\n return lastStep?.spanContext ?? null;\n },\n\n getCompletedSteps(): string[] {\n const completed: string[] = [];\n for (const [name, step] of state.steps) {\n if (step.status === 'completed') {\n completed.push(name);\n }\n }\n return completed.toSorted(\n (a, b) =>\n (state.steps.get(a)?.index ?? 0) - (state.steps.get(b)?.index ?? 0),\n );\n },\n\n registerCompensation(\n stepName: string,\n handler: (error: Error) => Promise<void> | void,\n ): void {\n state.compensations.set(stepName, handler);\n },\n\n async compensate(error: Error): Promise<void> {\n // Execute compensations in reverse order\n const compensationOrder = [...state.compensations.entries()].toReversed();\n\n for (const [stepName, handler] of compensationOrder) {\n const step = state.steps.get(stepName);\n if (step && step.status === 'completed') {\n try {\n baseCtx.addEvent('compensation_started', {\n 'workflow.step.name': stepName,\n });\n\n await Promise.resolve(handler(error));\n\n this.recordCompensation(stepName, true);\n step.status = 'compensated';\n } catch (compensationError) {\n this.recordCompensation(\n stepName,\n false,\n compensationError as Error,\n );\n throw compensationError;\n }\n }\n }\n },\n\n recordCompensation(\n stepName: string,\n success: boolean,\n error?: Error,\n ): void {\n baseCtx.addEvent('compensation_completed', {\n 'workflow.step.name': stepName,\n 'workflow.compensation.success': success,\n ...(error && { 'workflow.compensation.error': String(error) }),\n });\n\n baseCtx.setAttribute(\n `workflow.compensation.${stepName}`,\n success ? 'success' : 'failed',\n );\n },\n\n setWorkflowStatus(status: WorkflowStatus): void {\n state.status = status;\n baseCtx.setAttribute('workflow.status', status);\n\n baseCtx.addEvent('workflow_status_changed', {\n 'workflow.status': status,\n });\n },\n };\n}\n\n/**\n * Create step-extended context\n */\nfunction createStepContext(\n baseCtx: TraceContext,\n config: StepConfig,\n workflowCtx: WorkflowContext | null,\n): StepContext {\n // Determine step index\n let stepIndex = config.index ?? 0;\n if (workflowCtx) {\n const span = getActiveSpan();\n if (span) {\n const state = workflowStates.get(span);\n if (state) {\n stepIndex = config.index ?? state.stepCounter++;\n }\n }\n }\n\n // Register step metadata\n if (workflowCtx) {\n const wfSpan = getActiveSpan();\n if (wfSpan) {\n const state = workflowStates.get(wfSpan);\n if (state) {\n state.steps.set(config.name, {\n name: config.name,\n index: stepIndex,\n status: 'running',\n startTime: Date.now(),\n compensate: config.compensate,\n });\n }\n }\n }\n\n return {\n ...baseCtx,\n\n getStepName(): string {\n return config.name;\n },\n\n getStepIndex(): number {\n return stepIndex;\n },\n\n complete(): void {\n if (workflowCtx) {\n workflowCtx.completeStep(config.name);\n }\n },\n\n skip(reason?: string): void {\n baseCtx.setAttribute('workflow.step.status', 'skipped');\n if (reason) {\n baseCtx.setAttribute('workflow.step.skip_reason', reason);\n }\n baseCtx.addEvent('step_skipped', {\n 'workflow.step.name': config.name,\n ...(reason && { 'workflow.step.skip_reason': reason }),\n });\n },\n\n getWorkflowContext(): WorkflowContext | null {\n return workflowCtx;\n },\n };\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Get workflow state from context\n */\nfunction getWorkflowState() {\n const span = getActiveSpan();\n return span ? workflowStates.get(span) : null;\n}\n\n/**\n * Add links to previous steps\n */\nasync function addStepLinks(\n ctx: StepContext,\n config: StepConfig,\n workflowCtx: WorkflowContext | null,\n): Promise<void> {\n if (!workflowCtx) return;\n\n const links: Link[] = [];\n\n // Link to previous step\n if (config.linkToPrevious) {\n const prevSpanContext = workflowCtx.getPreviousStep();\n if (prevSpanContext) {\n links.push({\n context: prevSpanContext,\n attributes: {\n 'workflow.link.type': 'sequence',\n },\n });\n }\n }\n\n // Link to specific steps\n if (config.linkTo) {\n const stepNames = Array.isArray(config.linkTo)\n ? config.linkTo\n : [config.linkTo];\n\n for (const stepName of stepNames) {\n const spanContext = workflowCtx.getPreviousStep(stepName);\n if (spanContext) {\n links.push({\n context: spanContext,\n attributes: {\n 'workflow.link.type': 'dependency',\n 'workflow.link.step': stepName,\n },\n });\n }\n }\n }\n\n // Add all links\n if (links.length > 0) {\n ctx.addLinks(links);\n }\n}\n\n/**\n * Sleep utility for retry backoff\n */\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// ============================================================================\n// Convenience Exports\n// ============================================================================\n\n/**\n * Get current workflow context (if inside a workflow)\n *\n * Uses AsyncLocalStorage to ensure async-safety when multiple\n * workflows are running concurrently.\n */\nexport function getCurrentWorkflowContext(): WorkflowContext | null {\n return workflowContextStorage.getStore() ?? null;\n}\n\n/**\n * Check if currently executing inside a workflow\n *\n * Uses AsyncLocalStorage to ensure async-safety when multiple\n * workflows are running concurrently.\n */\nexport function isInWorkflow(): boolean {\n return workflowContextStorage.getStore() !== undefined;\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/trace-helpers.ts"],"names":["context"],"mappings":"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","file":"chunk-B3ZHLLMP.js","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';\nimport { requireModule } from './node-require';\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 const { getActiveContextWithBaggage } = requireModule<{\n getActiveContextWithBaggage: () => Context;\n }>('./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 */\n/**\n * Resolve a trace URL from a template string and trace ID.\n *\n * Templates use `{traceId}` as placeholder. Falls back to `OTEL_TRACE_URL_TEMPLATE` env var.\n *\n * @example\n * resolveTraceUrl('https://grafana.example.com/explore?traceId={traceId}', 'abc123')\n * // => 'https://grafana.example.com/explore?traceId=abc123'\n */\nexport function resolveTraceUrl(\n template: string | undefined,\n traceId: string,\n): string | undefined {\n const t = template ?? process.env.OTEL_TRACE_URL_TEMPLATE;\n if (!t) return undefined;\n return t.replace(/\\{traceId\\}/g, traceId);\n}\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"]}
@@ -1,211 +0,0 @@
1
- import { context, propagation } from '@opentelemetry/api';
2
- import { AsyncLocalStorage } from 'async_hooks';
3
-
4
- // src/trace-context.ts
5
- var contextStorage = new AsyncLocalStorage();
6
- function getContextStorage() {
7
- return contextStorage;
8
- }
9
- function getActiveContextWithBaggage() {
10
- const stored = contextStorage.getStore()?.value;
11
- return stored ?? context.active();
12
- }
13
- function enterOrRun(storage, value) {
14
- const existingStore = storage.getStore();
15
- if (existingStore) {
16
- existingStore.value = value;
17
- return;
18
- }
19
- const boxedValue = { value };
20
- try {
21
- storage.enterWith(boxedValue);
22
- } catch {
23
- storage.run(boxedValue, () => {
24
- });
25
- }
26
- }
27
- function updateActiveContext(newContext) {
28
- enterOrRun(contextStorage, newContext);
29
- const contextWithManager = context;
30
- const manager = contextWithManager._getContextManager?.();
31
- if (!manager) return;
32
- const asyncLocal = manager._asyncLocalStorage ?? void 0;
33
- if (asyncLocal?.enterWith) {
34
- asyncLocal.enterWith(newContext);
35
- return;
36
- }
37
- if (typeof manager.with === "function") {
38
- manager.with(newContext, () => {
39
- });
40
- }
41
- }
42
- function createTraceContext(span) {
43
- const spanContext = span.spanContext();
44
- const existingStored = contextStorage.getStore()?.value;
45
- if (!existingStored) {
46
- const activeContext = context.active();
47
- enterOrRun(contextStorage, activeContext);
48
- }
49
- const baggageHelpers = {
50
- getBaggage(key) {
51
- const activeCtx = context.active();
52
- let baggage = propagation.getBaggage(activeCtx);
53
- if (!baggage) {
54
- const storedContext = contextStorage.getStore()?.value;
55
- if (storedContext) {
56
- baggage = propagation.getBaggage(storedContext);
57
- }
58
- }
59
- return baggage?.getEntry(key)?.value;
60
- },
61
- setBaggage(key, value) {
62
- const activeCtx = context.active();
63
- const storedContext = contextStorage.getStore()?.value;
64
- const currentContext = storedContext ?? activeCtx;
65
- const baggage = propagation.getBaggage(currentContext) ?? propagation.createBaggage();
66
- const updated = baggage.setEntry(key, { value });
67
- const newContext = propagation.setBaggage(currentContext, updated);
68
- updateActiveContext(newContext);
69
- return value;
70
- },
71
- deleteBaggage(key) {
72
- const activeCtx = context.active();
73
- const storedContext = contextStorage.getStore()?.value;
74
- const currentContext = storedContext ?? activeCtx;
75
- const baggage = propagation.getBaggage(currentContext);
76
- if (baggage) {
77
- const updated = baggage.removeEntry(key);
78
- const newContext = propagation.setBaggage(currentContext, updated);
79
- updateActiveContext(newContext);
80
- }
81
- },
82
- getAllBaggage() {
83
- const activeCtx = context.active();
84
- let baggage = propagation.getBaggage(activeCtx);
85
- if (!baggage) {
86
- const storedContext = contextStorage.getStore()?.value;
87
- if (storedContext) {
88
- baggage = propagation.getBaggage(storedContext);
89
- }
90
- }
91
- if (!baggage) {
92
- return /* @__PURE__ */ new Map();
93
- }
94
- const entries = /* @__PURE__ */ new Map();
95
- for (const [key, entry] of baggage.getAllEntries()) {
96
- entries.set(key, entry);
97
- }
98
- return entries;
99
- },
100
- // Typed baggage helpers (used by defineBaggageSchema)
101
- getTypedBaggage: ((namespace) => {
102
- const activeCtx = context.active();
103
- let baggage = propagation.getBaggage(activeCtx);
104
- if (!baggage) {
105
- const storedContext = contextStorage.getStore()?.value;
106
- if (storedContext) {
107
- baggage = propagation.getBaggage(storedContext);
108
- }
109
- }
110
- if (!baggage) return;
111
- const prefix = namespace ? `${namespace}.` : "";
112
- const result = {};
113
- for (const [key, entry] of baggage.getAllEntries()) {
114
- if (namespace && key.startsWith(prefix)) {
115
- const fieldName = key.slice(prefix.length);
116
- result[fieldName] = entry.value;
117
- } else if (!namespace) {
118
- result[key] = entry.value;
119
- }
120
- }
121
- return Object.keys(result).length > 0 ? result : void 0;
122
- }),
123
- setTypedBaggage: ((namespace, value) => {
124
- const activeCtx = context.active();
125
- const storedContext = contextStorage.getStore()?.value;
126
- const currentContext = storedContext ?? activeCtx;
127
- let baggage = propagation.getBaggage(currentContext) ?? propagation.createBaggage();
128
- const prefix = namespace ? `${namespace}.` : "";
129
- for (const [key, val] of Object.entries(value)) {
130
- if (val !== void 0) {
131
- const baggageKey = `${prefix}${key}`;
132
- baggage = baggage.setEntry(baggageKey, { value: String(val) });
133
- }
134
- }
135
- const newContext = propagation.setBaggage(currentContext, baggage);
136
- updateActiveContext(newContext);
137
- })
138
- };
139
- return {
140
- traceId: spanContext.traceId,
141
- spanId: spanContext.spanId,
142
- correlationId: spanContext.traceId.slice(0, 16),
143
- setAttribute: span.setAttribute.bind(span),
144
- setAttributes: span.setAttributes.bind(span),
145
- setStatus: span.setStatus.bind(span),
146
- recordException: span.recordException.bind(span),
147
- addEvent: span.addEvent.bind(span),
148
- addLink: span.addLink.bind(span),
149
- addLinks: span.addLinks.bind(span),
150
- updateName: span.updateName.bind(span),
151
- isRecording: span.isRecording.bind(span),
152
- ...baggageHelpers
153
- };
154
- }
155
- function defineBaggageSchema(namespace) {
156
- return {
157
- /**
158
- * Get typed baggage from context
159
- * @param ctx - Trace context
160
- * @returns Partial baggage object or undefined if no baggage is set
161
- */
162
- get: (ctx) => {
163
- if (!ctx.getTypedBaggage) return void 0;
164
- return ctx.getTypedBaggage(namespace);
165
- },
166
- /**
167
- * Set typed baggage in context
168
- *
169
- * Note: For proper scoping across async boundaries, use the `with` method instead
170
- *
171
- * @param ctx - Trace context
172
- * @param value - Partial baggage object to set
173
- */
174
- set: (ctx, value) => {
175
- if (!ctx.setTypedBaggage) return;
176
- ctx.setTypedBaggage(namespace, value);
177
- },
178
- /**
179
- * Run a function with typed baggage properly scoped
180
- *
181
- * This is the recommended way to set baggage as it ensures proper
182
- * scoping across async boundaries.
183
- *
184
- * @param ctx - Trace context (can be omitted, will use active context)
185
- * @param value - Partial baggage object to set
186
- * @param fn - Function to execute with the baggage
187
- */
188
- with: (ctxOrValue, valueOrFn, maybeFn) => {
189
- const value = maybeFn ? valueOrFn : ctxOrValue;
190
- const fn = maybeFn || valueOrFn;
191
- const prefix = namespace ? `${namespace}.` : "";
192
- const flatBaggage = {};
193
- for (const [key, val] of Object.entries(value)) {
194
- if (val !== void 0) {
195
- flatBaggage[`${prefix}${key}`] = String(val);
196
- }
197
- }
198
- const currentContext = context.active();
199
- let baggage = propagation.getBaggage(currentContext) ?? propagation.createBaggage();
200
- for (const [key, val] of Object.entries(flatBaggage)) {
201
- baggage = baggage.setEntry(key, { value: val });
202
- }
203
- const newContext = propagation.setBaggage(currentContext, baggage);
204
- return context.with(newContext, fn);
205
- }
206
- };
207
- }
208
-
209
- export { createTraceContext, defineBaggageSchema, enterOrRun, getActiveContextWithBaggage, getContextStorage };
210
- //# sourceMappingURL=chunk-BBBWDIYQ.js.map
211
- //# sourceMappingURL=chunk-BBBWDIYQ.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/trace-context.ts"],"names":[],"mappings":"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","file":"chunk-BBBWDIYQ.js","sourcesContent":["/**\n * Trace context types and utilities\n */\n\nimport type {\n Span,\n SpanStatusCode,\n BaggageEntry,\n Context,\n Link,\n TimeInput,\n} from '@opentelemetry/api';\nimport { context, propagation } from '@opentelemetry/api';\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\ntype AsyncLocalBox<T> = {\n value: T;\n};\n\n/**\n * AsyncLocalStorage for storing the active context with baggage\n * This allows setters to update the context and have it persist\n */\nconst contextStorage = new AsyncLocalStorage<AsyncLocalBox<Context>>();\n\n/**\n * Get the context storage instance (for initialization in functional.ts)\n */\nexport function getContextStorage(): AsyncLocalStorage<AsyncLocalBox<Context>> {\n return contextStorage;\n}\n\n/**\n * Get the active context, checking our stored context first\n * This ensures baggage setters work with OpenTelemetry's propagation\n */\nexport function getActiveContextWithBaggage(): Context {\n // Check stored context first (from setters), then fall back to active context\n // This ensures ctx.setBaggage() changes are visible to OpenTelemetry operations\n const stored = contextStorage.getStore()?.value;\n return stored ?? context.active();\n}\n\n/**\n * Set a value in AsyncLocalStorage, preferring enterWith() when available\n * (Node.js) and falling back to run() for environments that only support\n * run() (e.g. Cloudflare Workers).\n *\n * On runtimes without enterWith() we mutate the existing run() scope when one\n * exists. This is what allows baggage/correlation updates to remain visible\n * for the rest of the traced callback in Workers.\n */\nexport function enterOrRun<T>(\n storage: AsyncLocalStorage<AsyncLocalBox<T>>,\n value: T,\n): void {\n const existingStore = storage.getStore();\n if (existingStore) {\n existingStore.value = value;\n return;\n }\n\n const boxedValue = { value };\n try {\n storage.enterWith(boxedValue);\n } catch {\n // Cloudflare Workers define enterWith but throw at runtime\n storage.run(boxedValue, () => {});\n }\n}\n\n/**\n * Try to keep OpenTelemetry's context manager in sync with baggage updates\n */\ntype ContextManagerLike = {\n with?: (ctx: Context, fn: () => void) => void;\n _asyncLocalStorage?: { enterWith?: (ctx: Context) => void };\n};\n\nfunction updateActiveContext(newContext: Context): void {\n // Update our storage first so any helper reads see the new context\n enterOrRun(contextStorage, newContext);\n\n const contextWithManager = context as unknown as {\n _getContextManager?: () => ContextManagerLike;\n };\n\n const manager = contextWithManager._getContextManager?.();\n if (!manager) return;\n\n const asyncLocal =\n (manager as { _asyncLocalStorage?: { enterWith?: (ctx: Context) => void } })\n ._asyncLocalStorage ?? undefined;\n if (asyncLocal?.enterWith) {\n asyncLocal.enterWith(newContext);\n return;\n }\n\n if (typeof manager.with === 'function') {\n manager.with(newContext, () => {});\n }\n}\n\n/**\n * Base trace context containing trace identifiers\n */\nexport interface TraceContextBase {\n traceId: string;\n spanId: string;\n correlationId: string;\n}\n\n/**\n * Attribute value types following OpenTelemetry specification.\n * Supports primitive values and arrays of homogeneous primitives.\n */\nexport type AttributeValue =\n | string\n | number\n | boolean\n | string[]\n | number[]\n | boolean[];\n\n/**\n * Span methods available on trace context\n */\nexport interface SpanMethods {\n /** Set a single attribute on the span */\n setAttribute(key: string, value: AttributeValue): void;\n /** Set multiple attributes on the span */\n setAttributes(attrs: Record<string, AttributeValue>): void;\n /** Set the status of the span */\n setStatus(status: { code: SpanStatusCode; message?: string }): void;\n /** Record an exception on the span */\n recordException(exception: Error, time?: TimeInput): void;\n /** Add an event to the span (for logging milestones/checkpoints) */\n addEvent(\n name: string,\n attributesOrStartTime?: Record<string, AttributeValue> | TimeInput,\n startTime?: TimeInput,\n ): void;\n /** Add a link to another span */\n addLink(link: Link): void;\n /** Add multiple links to other spans */\n addLinks(links: Link[]): void;\n /** Update the span name dynamically */\n updateName(name: string): void;\n /** Check if the span is recording */\n isRecording(): boolean;\n}\n\n/**\n * Baggage methods available on trace context\n *\n * @template TBaggage - Optional type for typed baggage (defaults to undefined for untyped)\n */\nexport interface BaggageMethods<\n TBaggage extends Record<string, unknown> | undefined = undefined,\n> {\n /**\n * Get a baggage entry by key\n * @param key - Baggage key\n * @returns Baggage entry value or undefined\n */\n getBaggage(key: string): string | undefined;\n\n /**\n * Set a baggage entry\n *\n * Note: OpenTelemetry contexts are immutable. For proper scoping across async\n * boundaries, use withBaggage() instead. This method updates baggage in the\n * current context which may not propagate to all child operations.\n *\n * @param key - Baggage key\n * @param value - Baggage value\n * @returns The baggage value that was set (for chaining)\n *\n * @example Using withBaggage() (recommended)\n * ```typescript\n * await withBaggage({ baggage: { 'key': 'value' }, fn: async () => {\n * // Baggage is available here and in child spans\n * });\n * ```\n */\n setBaggage(key: string, value: string): string;\n\n /**\n * Delete a baggage entry\n *\n * Note: OpenTelemetry contexts are immutable. For proper scoping across async\n * boundaries, use withBaggage() with only the entries you want instead.\n *\n * @param key - Baggage key\n */\n deleteBaggage(key: string): void;\n\n /**\n * Get all baggage entries\n * @returns Map of all baggage entries\n */\n getAllBaggage(): Map<string, BaggageEntry>;\n\n /**\n * Get typed baggage (only available when TBaggage is defined)\n * This is used internally by defineBaggageSchema()\n *\n * @internal\n */\n getTypedBaggage?: TBaggage extends Record<string, unknown>\n ? <T extends TBaggage>(namespace?: string) => Partial<T> | undefined\n : never;\n\n /**\n * Set typed baggage (only available when TBaggage is defined)\n * This is used internally by defineBaggageSchema()\n *\n * @internal\n */\n setTypedBaggage?: TBaggage extends Record<string, unknown>\n ? <T extends TBaggage>(\n namespace: string | undefined,\n value: Partial<T>,\n ) => void\n : never;\n}\n\n/**\n * Complete trace context that merges base context, span methods, and baggage methods\n *\n * This is the ctx parameter passed to factory functions in trace().\n * It provides access to trace IDs, span manipulation methods, and baggage operations.\n *\n * @template TBaggage - Optional type for typed baggage support\n *\n * @example Untyped (default)\n * ```typescript\n * export const handler = trace((ctx) => async () => {\n * ctx.getBaggage('key'); // returns string | undefined\n * });\n * ```\n *\n * @example Typed baggage\n * ```typescript\n * type TenantBaggage = { tenantId: string; region?: string };\n *\n * export const handler = trace<TenantBaggage>((ctx) => async () => {\n * // Use typed schema helper for type-safe access\n * const schema = defineBaggageSchema<TenantBaggage>('tenant');\n * const tenant = schema.get(ctx); // Partial<TenantBaggage> | undefined\n * });\n * ```\n */\nexport type TraceContext<\n TBaggage extends Record<string, unknown> | undefined = undefined,\n> = TraceContextBase & SpanMethods & BaggageMethods<TBaggage>;\n\n/**\n * Create a TraceContext from an OpenTelemetry Span\n *\n * This utility extracts trace context information from a span\n * and provides span manipulation methods and baggage operations in a consistent format.\n *\n * Note: Baggage methods always operate on the currently active context,\n * which may differ from the context when createTraceContext was called.\n */\nexport function createTraceContext<\n TBaggage extends Record<string, unknown> | undefined = undefined,\n>(span: Span): TraceContext<TBaggage> {\n const spanContext = span.spanContext();\n\n // Store the current active context in AsyncLocalStorage so baggage setters can update it\n // This ensures ctx.setBaggage() changes persist and are visible to OpenTelemetry operations\n // IMPORTANT: Only initialize if not already set (preserve baggage updates from parent spans)\n const existingStored = contextStorage.getStore()?.value;\n if (!existingStored) {\n const activeContext = context.active();\n enterOrRun(contextStorage, activeContext);\n }\n\n // Baggage helpers that always use the current active context\n // This ensures baggage operations work correctly even if context changes\n const baggageHelpers: BaggageMethods<TBaggage> = {\n getBaggage(key: string): string | undefined {\n // Check active context first (from withBaggage, context.with, etc.)\n // Then check stored context (from setters)\n // This ensures both withBaggage() and ctx.setBaggage() work correctly\n const activeCtx = context.active();\n let baggage = propagation.getBaggage(activeCtx);\n if (!baggage) {\n const storedContext = contextStorage.getStore()?.value;\n if (storedContext) {\n baggage = propagation.getBaggage(storedContext);\n }\n }\n return baggage?.getEntry(key)?.value;\n },\n\n setBaggage(key: string, value: string): string {\n // OpenTelemetry contexts are immutable, so we create a new context with updated baggage\n // Check active context first (may have baggage from withBaggage), then stored context\n const activeCtx = context.active();\n const storedContext = contextStorage.getStore()?.value;\n const currentContext = storedContext ?? activeCtx;\n const baggage =\n propagation.getBaggage(currentContext) ?? propagation.createBaggage();\n const updated = baggage.setEntry(key, { value });\n const newContext = propagation.setBaggage(currentContext, updated);\n\n updateActiveContext(newContext);\n\n return value;\n },\n\n deleteBaggage(key: string): void {\n // Check active context first, then stored context\n const activeCtx = context.active();\n const storedContext = contextStorage.getStore()?.value;\n const currentContext = storedContext ?? activeCtx;\n const baggage = propagation.getBaggage(currentContext);\n if (baggage) {\n const updated = baggage.removeEntry(key);\n const newContext = propagation.setBaggage(currentContext, updated);\n\n updateActiveContext(newContext);\n }\n },\n\n getAllBaggage(): Map<string, BaggageEntry> {\n // Check active context first, then stored context\n const activeCtx = context.active();\n let baggage = propagation.getBaggage(activeCtx);\n if (!baggage) {\n const storedContext = contextStorage.getStore()?.value;\n if (storedContext) {\n baggage = propagation.getBaggage(storedContext);\n }\n }\n if (!baggage) {\n return new Map();\n }\n\n // Convert baggage entries to a Map\n const entries = new Map<string, BaggageEntry>();\n for (const [key, entry] of baggage.getAllEntries()) {\n entries.set(key, entry);\n }\n return entries;\n },\n\n // Typed baggage helpers (used by defineBaggageSchema)\n getTypedBaggage: (<T extends Record<string, unknown>>(\n namespace?: string,\n ) => {\n // Check active context first, then stored context\n const activeCtx = context.active();\n let baggage = propagation.getBaggage(activeCtx);\n if (!baggage) {\n const storedContext = contextStorage.getStore()?.value;\n if (storedContext) {\n baggage = propagation.getBaggage(storedContext);\n }\n }\n if (!baggage) return;\n\n const prefix = namespace ? `${namespace}.` : '';\n const result: Record<string, unknown> = {};\n\n for (const [key, entry] of baggage.getAllEntries()) {\n if (namespace && key.startsWith(prefix)) {\n const fieldName = key.slice(prefix.length);\n result[fieldName] = entry.value;\n } else if (!namespace) {\n result[key] = entry.value;\n }\n }\n\n return Object.keys(result).length > 0\n ? (result as Partial<T>)\n : undefined;\n }) as TBaggage extends Record<string, unknown>\n ? <T extends TBaggage>(namespace?: string) => Partial<T> | undefined\n : never,\n\n setTypedBaggage: (<T extends Record<string, unknown>>(\n namespace: string | undefined,\n value: Partial<T>,\n ) => {\n // Check active context first, then stored context\n const activeCtx = context.active();\n const storedContext = contextStorage.getStore()?.value;\n const currentContext = storedContext ?? activeCtx;\n let baggage =\n propagation.getBaggage(currentContext) ?? propagation.createBaggage();\n\n const prefix = namespace ? `${namespace}.` : '';\n for (const [key, val] of Object.entries(value)) {\n if (val !== undefined) {\n const baggageKey = `${prefix}${key}`;\n baggage = baggage.setEntry(baggageKey, { value: String(val) });\n }\n }\n\n const newContext = propagation.setBaggage(currentContext, baggage);\n updateActiveContext(newContext);\n }) as TBaggage extends Record<string, unknown>\n ? <T extends TBaggage>(\n namespace: string | undefined,\n value: Partial<T>,\n ) => void\n : never,\n };\n\n return {\n traceId: spanContext.traceId,\n spanId: spanContext.spanId,\n correlationId: spanContext.traceId.slice(0, 16),\n setAttribute: span.setAttribute.bind(span),\n setAttributes: span.setAttributes.bind(span),\n setStatus: span.setStatus.bind(span),\n recordException: span.recordException.bind(span),\n addEvent: span.addEvent.bind(span),\n addLink: span.addLink.bind(span),\n addLinks: span.addLinks.bind(span),\n updateName: span.updateName.bind(span),\n isRecording: span.isRecording.bind(span),\n ...baggageHelpers,\n };\n}\n\n/**\n * Define a typed baggage schema for type-safe baggage operations\n *\n * This helper provides a type-safe API for working with baggage entries.\n * The namespace parameter is optional and prefixes all keys to avoid collisions.\n *\n * @template T - The baggage schema type (all fields are treated as optional)\n * @param namespace - Optional namespace to prefix baggage keys\n *\n * @example Basic usage\n * ```typescript\n * type TenantBaggage = { tenantId: string; region?: string };\n * const tenantBaggage = defineBaggageSchema<TenantBaggage>('tenant');\n *\n * export const handler = trace<TenantBaggage>((ctx) => async () => {\n * // Get typed baggage\n * const tenant = tenantBaggage.get(ctx);\n * if (tenant?.tenantId) {\n * console.log('Tenant:', tenant.tenantId);\n * }\n *\n * // Set typed baggage\n * tenantBaggage.set(ctx, { tenantId: 't1', region: 'us-east-1' });\n * });\n * ```\n *\n * @example With withBaggage helper\n * ```typescript\n * const tenantBaggage = defineBaggageSchema<TenantBaggage>('tenant');\n *\n * export const handler = trace<TenantBaggage>((ctx) => async () => {\n * return await tenantBaggage.with(ctx, { tenantId: 't1' }, async () => {\n * // Baggage is available here and in child spans\n * const tenant = tenantBaggage.get(ctx);\n * });\n * });\n * ```\n */\nexport function defineBaggageSchema<T extends Record<string, unknown>>(\n namespace?: string,\n) {\n return {\n /**\n * Get typed baggage from context\n * @param ctx - Trace context\n * @returns Partial baggage object or undefined if no baggage is set\n */\n get: (ctx: TraceContext<T>): Partial<T> | undefined => {\n if (!ctx.getTypedBaggage) return undefined;\n return ctx.getTypedBaggage<T>(namespace);\n },\n\n /**\n * Set typed baggage in context\n *\n * Note: For proper scoping across async boundaries, use the `with` method instead\n *\n * @param ctx - Trace context\n * @param value - Partial baggage object to set\n */\n set: (ctx: TraceContext<T>, value: Partial<T>): void => {\n if (!ctx.setTypedBaggage) return;\n ctx.setTypedBaggage<T>(namespace, value);\n },\n\n /**\n * Run a function with typed baggage properly scoped\n *\n * This is the recommended way to set baggage as it ensures proper\n * scoping across async boundaries.\n *\n * @param ctx - Trace context (can be omitted, will use active context)\n * @param value - Partial baggage object to set\n * @param fn - Function to execute with the baggage\n */\n with: <R>(\n ctxOrValue: TraceContext<T> | Partial<T>,\n valueOrFn: Partial<T> | (() => R | Promise<R>),\n maybeFn?: () => R | Promise<R>,\n ): R | Promise<R> => {\n // Support both with(ctx, value, fn) and with(value, fn)\n const value = maybeFn\n ? (valueOrFn as Partial<T>)\n : (ctxOrValue as Partial<T>);\n const fn = maybeFn || (valueOrFn as () => R | Promise<R>);\n\n // Serialize typed baggage to flat key-value pairs\n const prefix = namespace ? `${namespace}.` : '';\n const flatBaggage: Record<string, string> = {};\n for (const [key, val] of Object.entries(value)) {\n if (val !== undefined) {\n flatBaggage[`${prefix}${key}`] = String(val);\n }\n }\n\n // Use the existing withBaggage helper\n const currentContext = context.active();\n let baggage =\n propagation.getBaggage(currentContext) ?? propagation.createBaggage();\n\n for (const [key, val] of Object.entries(flatBaggage)) {\n baggage = baggage.setEntry(key, { value: val });\n }\n\n const newContext = propagation.setBaggage(currentContext, baggage);\n return context.with(newContext, fn);\n },\n };\n}\n"]}
@@ -1,150 +0,0 @@
1
- 'use strict';
2
-
3
- var async_hooks = require('async_hooks');
4
-
5
- // src/validation.ts
6
- var DEFAULT_CONFIG = {
7
- maxEventNameLength: 100,
8
- maxAttributeKeyLength: 100,
9
- maxAttributeValueLength: 1e3,
10
- maxAttributeCount: 50,
11
- maxNestingDepth: 3,
12
- sensitivePatterns: [
13
- /password/i,
14
- /secret/i,
15
- /token/i,
16
- /api[_-]?key/i,
17
- /access[_-]?key/i,
18
- /private[_-]?key/i,
19
- /auth/i,
20
- /credential/i,
21
- /ssn/i,
22
- /credit[_-]?card/i
23
- ]
24
- };
25
- var ValidationError = class extends Error {
26
- constructor(message) {
27
- super(message);
28
- this.name = "ValidationError";
29
- }
30
- };
31
- function validateEventName(eventName, config = DEFAULT_CONFIG) {
32
- if (typeof eventName !== "string") {
33
- throw new ValidationError(
34
- `Event name must be a string, got ${typeof eventName}`
35
- );
36
- }
37
- const trimmed = eventName.trim();
38
- if (trimmed.length === 0) {
39
- throw new ValidationError("Event name cannot be empty");
40
- }
41
- if (trimmed.length > config.maxEventNameLength) {
42
- throw new ValidationError(
43
- `Event name too long (${trimmed.length} chars). Max: ${config.maxEventNameLength}`
44
- );
45
- }
46
- if (!/^[a-zA-Z0-9._-]+$/.test(trimmed)) {
47
- throw new ValidationError(
48
- `Event name contains invalid characters: "${trimmed}". Use only letters, numbers, dots, underscores, and hyphens.`
49
- );
50
- }
51
- return trimmed;
52
- }
53
- function validateAttributes(attributes, config = DEFAULT_CONFIG) {
54
- if (attributes === void 0 || attributes === null) {
55
- return void 0;
56
- }
57
- if (typeof attributes !== "object" || Array.isArray(attributes)) {
58
- throw new ValidationError("Attributes must be an object");
59
- }
60
- const keys = Object.keys(attributes);
61
- if (keys.length > config.maxAttributeCount) {
62
- throw new ValidationError(
63
- `Too many attributes (${keys.length}). Max: ${config.maxAttributeCount}`
64
- );
65
- }
66
- const sanitized = {};
67
- for (const key of keys) {
68
- if (key.length > config.maxAttributeKeyLength) {
69
- throw new ValidationError(
70
- `Attribute key too long: "${key.slice(0, 20)}..." (${key.length} chars). Max: ${config.maxAttributeKeyLength}`
71
- );
72
- }
73
- const isSensitive = config.sensitivePatterns.some(
74
- (pattern) => pattern.test(key)
75
- );
76
- if (isSensitive) {
77
- sanitized[key] = "[REDACTED]";
78
- continue;
79
- }
80
- const value = attributes[key];
81
- sanitized[key] = sanitizeValue(value, config, 1);
82
- }
83
- return sanitized;
84
- }
85
- function sanitizeValue(value, config, depth) {
86
- if (depth > config.maxNestingDepth) {
87
- return "[MAX_DEPTH_EXCEEDED]";
88
- }
89
- if (value === null || value === void 0) {
90
- return value;
91
- }
92
- if (typeof value === "string") {
93
- if (value.length > config.maxAttributeValueLength) {
94
- return value.slice(0, config.maxAttributeValueLength) + "...";
95
- }
96
- return value;
97
- }
98
- if (typeof value === "number" || typeof value === "boolean") {
99
- return value;
100
- }
101
- if (Array.isArray(value)) {
102
- return value.map((item) => sanitizeValue(item, config, depth + 1));
103
- }
104
- if (typeof value === "object") {
105
- try {
106
- JSON.stringify(value);
107
- const sanitized = {};
108
- for (const key in value) {
109
- if (Object.prototype.hasOwnProperty.call(value, key)) {
110
- const isSensitive = config.sensitivePatterns.some(
111
- (pattern) => pattern.test(key)
112
- );
113
- if (isSensitive) {
114
- sanitized[key] = "[REDACTED]";
115
- } else {
116
- sanitized[key] = sanitizeValue(
117
- value[key],
118
- config,
119
- depth + 1
120
- );
121
- }
122
- }
123
- }
124
- return sanitized;
125
- } catch {
126
- return "[CIRCULAR]";
127
- }
128
- }
129
- return `[${typeof value}]`;
130
- }
131
- function validateEvent(eventName, attributes, config) {
132
- const fullConfig = { ...DEFAULT_CONFIG, ...config };
133
- return {
134
- eventName: validateEventName(eventName, fullConfig),
135
- attributes: validateAttributes(attributes, fullConfig)
136
- };
137
- }
138
- var operationStorage = new async_hooks.AsyncLocalStorage();
139
- function getOperationContext() {
140
- return operationStorage.getStore();
141
- }
142
- function runInOperationContext(name, fn) {
143
- return operationStorage.run({ name }, fn);
144
- }
145
-
146
- exports.getOperationContext = getOperationContext;
147
- exports.runInOperationContext = runInOperationContext;
148
- exports.validateEvent = validateEvent;
149
- //# sourceMappingURL=chunk-D5LMF53P.cjs.map
150
- //# sourceMappingURL=chunk-D5LMF53P.cjs.map