autotel 4.2.0 → 4.2.1

package/dist/workflow.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.cjs","names":["AsyncLocalStorage","trace","getActiveSpan"],"sources":["../src/workflow.ts"],"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 { emitCorrelatedEvent } from './correlated-events';\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              emitCorrelatedEvent(ctx, '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              emitCorrelatedEvent(ctx, '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            emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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"],"mappings":"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"}
+{"version":3,"file":"workflow.cjs","names":["nodeAsyncHooks","trace","getActiveSpan"],"sources":["../src/workflow.ts"],"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\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeAsyncHooks from 'node:async_hooks';\nimport type { Attributes, Link, SpanContext } from '@opentelemetry/api';\nimport { emitCorrelatedEvent } from './correlated-events';\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 =\n  new nodeAsyncHooks.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              emitCorrelatedEvent(ctx, '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              emitCorrelatedEvent(ctx, '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            emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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"],"mappings":"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"}

package/dist/workflow.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.cts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;;KAqEY,cAAA;;;;KAYA,UAAA;;;;UAWK,cAAA;EAiDgB;EA/C/B,IAAA;EAqDA;;;;EA/CA,UAAA,gBAA0B,IAAA,EAAM,KAAA;EAqDlB;EAlDd,OAAA;EAqDiB;EAlDjB,UAAA,GAAa,UAAA;EAkDwB;EA/CrC,UAAA,IAAc,GAAA,EAAK,eAAA,EAAiB,MAAA;EA+CM;EA5C1C,QAAA,IAAY,GAAA,EAAK,eAAA,EAAiB,KAAA,EAAO,KAAA;EA+D1B;EA5Df,cAAA,IAAkB,GAAA,EAAK,eAAA;AAAA;;;;UAMR,UAAA;EAgFG;EA9ElB,IAAA;EAiF+D;EA9E/D,WAAA;EAiDuC;EA9CvC,KAAA;EA8CmD;EA3CnD,cAAA;EA6CA;EA1CA,MAAA;EAgDA;EA7CA,UAAA,GAAa,UAAA;EAgDb;EA7CA,UAAA,IAAc,KAAA,EAAO,KAAA,KAAU,OAAA;EAgD/B;EA7CA,UAAA;EA6CoC;EA1CpC,KAAA;IACE,WAAA;IACA,SAAA;EAAA;EAgDU;EA5CZ,UAAA,IAAc,GAAA,EAAK,WAAA;EA4CjB;EAzCF,QAAA,IAAY,GAAA,EAAK,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;;;;UAmBtB,eAAA,SAAwB,YAAA;EA6BF;EA3BrC,aAAA;EA2BuD;EAxBvD,eAAA;EA2B0B;EAxB1B,SAAA,IAAa,cAAA;EAwB2B;EArBxC,YAAA,CAAa,QAAA;EA2BE;EAxBf,eAAA,CAAgB,QAAA,YAAoB,WAAA;;EAGpC,iBAAA;EAqBmC;EAlBnC,oBAAA,CACE,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,KAAA,KAAU,OAAA;EAqB7B;EAjBA,UAAA,CAAW,KAAA,EAAO,KAAA,GAAQ,OAAA;EAuB1B;EApBA,kBAAA,CAAmB,QAAA,UAAkB,OAAA,WAAkB,KAAA,GAAQ,KAAA;EAuB/D;EApBA,iBAAA,CAAkB,MAAA,EAAQ,cAAA;AAAA;AAoBW;AA4DvC;;AA5DuC,UAdtB,WAAA,SAAoB,YAAY;EA2ExB;EAzEvB,WAAA;EA8EmB;EA3EnB,YAAA;EA2EmE;EAxEnE,QAAA;EAyEc;EAtEd,IAAA,CAAK,MAAA;EAsEmB;EAnExB,kBAAA,IAAsB,eAAA;AAAA;;;;;;;;;;;;;;;;;;AAmEiB;AA+FzC;;;;;;;;;iBAtGgB,aAAA,mCACd,MAAA,EAAQ,cAAA,CAAe,KAAA,KAKrB,SAAA,GAAY,GAAA,EAAK,eAAA,SAAwB,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC3D,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;;;;AAoGO;AAmZzC;;;;AAA4D;iBAxZ5C,SAAA,mCACd,MAAA,EAAQ,UAAA,IAGN,EAAA,MAAQ,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC1B,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;AA6ZN;;;iBAVZ,yBAAA,IAA6B,eAAe;;;;;;;iBAU5C,YAAA"}
+{"version":3,"file":"workflow.d.cts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;;KAsEY,cAAA;;;;KAYA,UAAA;;;;UAWK,cAAA;EAiDgB;EA/C/B,IAAA;EAqDA;;;;EA/CA,UAAA,gBAA0B,IAAA,EAAM,KAAA;EAqDlB;EAlDd,OAAA;EAqDiB;EAlDjB,UAAA,GAAa,UAAA;EAkDwB;EA/CrC,UAAA,IAAc,GAAA,EAAK,eAAA,EAAiB,MAAA;EA+CM;EA5C1C,QAAA,IAAY,GAAA,EAAK,eAAA,EAAiB,KAAA,EAAO,KAAA;EA+D1B;EA5Df,cAAA,IAAkB,GAAA,EAAK,eAAA;AAAA;;;;UAMR,UAAA;EAgFG;EA9ElB,IAAA;EAiF+D;EA9E/D,WAAA;EAiDuC;EA9CvC,KAAA;EA8CmD;EA3CnD,cAAA;EA6CA;EA1CA,MAAA;EAgDA;EA7CA,UAAA,GAAa,UAAA;EAgDb;EA7CA,UAAA,IAAc,KAAA,EAAO,KAAA,KAAU,OAAA;EAgD/B;EA7CA,UAAA;EA6CoC;EA1CpC,KAAA;IACE,WAAA;IACA,SAAA;EAAA;EAgDU;EA5CZ,UAAA,IAAc,GAAA,EAAK,WAAA;EA4CjB;EAzCF,QAAA,IAAY,GAAA,EAAK,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;;;;UAmBtB,eAAA,SAAwB,YAAA;EA6BF;EA3BrC,aAAA;EA2BuD;EAxBvD,eAAA;EA2B0B;EAxB1B,SAAA,IAAa,cAAA;EAwB2B;EArBxC,YAAA,CAAa,QAAA;EA2BE;EAxBf,eAAA,CAAgB,QAAA,YAAoB,WAAA;;EAGpC,iBAAA;EAqBmC;EAlBnC,oBAAA,CACE,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,KAAA,KAAU,OAAA;EAqB7B;EAjBA,UAAA,CAAW,KAAA,EAAO,KAAA,GAAQ,OAAA;EAuB1B;EApBA,kBAAA,CAAmB,QAAA,UAAkB,OAAA,WAAkB,KAAA,GAAQ,KAAA;EAuB/D;EApBA,iBAAA,CAAkB,MAAA,EAAQ,cAAA;AAAA;AAoBW;AA6DvC;;AA7DuC,UAdtB,WAAA,SAAoB,YAAY;EA4ExB;EA1EvB,WAAA;EA+EmB;EA5EnB,YAAA;EA4EmE;EAzEnE,QAAA;EA0Ec;EAvEd,IAAA,CAAK,MAAA;EAuEmB;EApExB,kBAAA,IAAsB,eAAA;AAAA;;;;;;;;;;;;;;;;;;AAoEiB;AA+FzC;;;;;;;;;iBAtGgB,aAAA,mCACd,MAAA,EAAQ,cAAA,CAAe,KAAA,KAKrB,SAAA,GAAY,GAAA,EAAK,eAAA,SAAwB,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC3D,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;;;;AAoGO;AAmZzC;;;;AAA4D;iBAxZ5C,SAAA,mCACd,MAAA,EAAQ,UAAA,IAGN,EAAA,MAAQ,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC1B,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;AA6ZN;;;iBAVZ,yBAAA,IAA6B,eAAe;;;;;;;iBAU5C,YAAA"}

package/dist/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;;KAqEY,cAAA;;;;KAYA,UAAA;;;;UAWK,cAAA;EAiDgB;EA/C/B,IAAA;EAqDA;;;;EA/CA,UAAA,gBAA0B,IAAA,EAAM,KAAA;EAqDlB;EAlDd,OAAA;EAqDiB;EAlDjB,UAAA,GAAa,UAAA;EAkDwB;EA/CrC,UAAA,IAAc,GAAA,EAAK,eAAA,EAAiB,MAAA;EA+CM;EA5C1C,QAAA,IAAY,GAAA,EAAK,eAAA,EAAiB,KAAA,EAAO,KAAA;EA+D1B;EA5Df,cAAA,IAAkB,GAAA,EAAK,eAAA;AAAA;;;;UAMR,UAAA;EAgFG;EA9ElB,IAAA;EAiF+D;EA9E/D,WAAA;EAiDuC;EA9CvC,KAAA;EA8CmD;EA3CnD,cAAA;EA6CA;EA1CA,MAAA;EAgDA;EA7CA,UAAA,GAAa,UAAA;EAgDb;EA7CA,UAAA,IAAc,KAAA,EAAO,KAAA,KAAU,OAAA;EAgD/B;EA7CA,UAAA;EA6CoC;EA1CpC,KAAA;IACE,WAAA;IACA,SAAA;EAAA;EAgDU;EA5CZ,UAAA,IAAc,GAAA,EAAK,WAAA;EA4CjB;EAzCF,QAAA,IAAY,GAAA,EAAK,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;;;;UAmBtB,eAAA,SAAwB,YAAA;EA6BF;EA3BrC,aAAA;EA2BuD;EAxBvD,eAAA;EA2B0B;EAxB1B,SAAA,IAAa,cAAA;EAwB2B;EArBxC,YAAA,CAAa,QAAA;EA2BE;EAxBf,eAAA,CAAgB,QAAA,YAAoB,WAAA;;EAGpC,iBAAA;EAqBmC;EAlBnC,oBAAA,CACE,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,KAAA,KAAU,OAAA;EAqB7B;EAjBA,UAAA,CAAW,KAAA,EAAO,KAAA,GAAQ,OAAA;EAuB1B;EApBA,kBAAA,CAAmB,QAAA,UAAkB,OAAA,WAAkB,KAAA,GAAQ,KAAA;EAuB/D;EApBA,iBAAA,CAAkB,MAAA,EAAQ,cAAA;AAAA;AAoBW;AA4DvC;;AA5DuC,UAdtB,WAAA,SAAoB,YAAY;EA2ExB;EAzEvB,WAAA;EA8EmB;EA3EnB,YAAA;EA2EmE;EAxEnE,QAAA;EAyEc;EAtEd,IAAA,CAAK,MAAA;EAsEmB;EAnExB,kBAAA,IAAsB,eAAA;AAAA;;;;;;;;;;;;;;;;;;AAmEiB;AA+FzC;;;;;;;;;iBAtGgB,aAAA,mCACd,MAAA,EAAQ,cAAA,CAAe,KAAA,KAKrB,SAAA,GAAY,GAAA,EAAK,eAAA,SAAwB,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC3D,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;;;;AAoGO;AAmZzC;;;;AAA4D;iBAxZ5C,SAAA,mCACd,MAAA,EAAQ,UAAA,IAGN,EAAA,MAAQ,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC1B,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;AA6ZN;;;iBAVZ,yBAAA,IAA6B,eAAe;;;;;;;iBAU5C,YAAA"}
+{"version":3,"file":"workflow.d.ts","names":[],"sources":["../src/workflow.ts"],"mappings":";;;;;;;KAsEY,cAAA;;;;KAYA,UAAA;;;;UAWK,cAAA;EAiDgB;EA/C/B,IAAA;EAqDA;;;;EA/CA,UAAA,gBAA0B,IAAA,EAAM,KAAA;EAqDlB;EAlDd,OAAA;EAqDiB;EAlDjB,UAAA,GAAa,UAAA;EAkDwB;EA/CrC,UAAA,IAAc,GAAA,EAAK,eAAA,EAAiB,MAAA;EA+CM;EA5C1C,QAAA,IAAY,GAAA,EAAK,eAAA,EAAiB,KAAA,EAAO,KAAA;EA+D1B;EA5Df,cAAA,IAAkB,GAAA,EAAK,eAAA;AAAA;;;;UAMR,UAAA;EAgFG;EA9ElB,IAAA;EAiF+D;EA9E/D,WAAA;EAiDuC;EA9CvC,KAAA;EA8CmD;EA3CnD,cAAA;EA6CA;EA1CA,MAAA;EAgDA;EA7CA,UAAA,GAAa,UAAA;EAgDb;EA7CA,UAAA,IAAc,KAAA,EAAO,KAAA,KAAU,OAAA;EAgD/B;EA7CA,UAAA;EA6CoC;EA1CpC,KAAA;IACE,WAAA;IACA,SAAA;EAAA;EAgDU;EA5CZ,UAAA,IAAc,GAAA,EAAK,WAAA;EA4CjB;EAzCF,QAAA,IAAY,GAAA,EAAK,WAAA,EAAa,KAAA,EAAO,KAAA;AAAA;;;;UAmBtB,eAAA,SAAwB,YAAA;EA6BF;EA3BrC,aAAA;EA2BuD;EAxBvD,eAAA;EA2B0B;EAxB1B,SAAA,IAAa,cAAA;EAwB2B;EArBxC,YAAA,CAAa,QAAA;EA2BE;EAxBf,eAAA,CAAgB,QAAA,YAAoB,WAAA;;EAGpC,iBAAA;EAqBmC;EAlBnC,oBAAA,CACE,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,KAAA,KAAU,OAAA;EAqB7B;EAjBA,UAAA,CAAW,KAAA,EAAO,KAAA,GAAQ,OAAA;EAuB1B;EApBA,kBAAA,CAAmB,QAAA,UAAkB,OAAA,WAAkB,KAAA,GAAQ,KAAA;EAuB/D;EApBA,iBAAA,CAAkB,MAAA,EAAQ,cAAA;AAAA;AAoBW;AA6DvC;;AA7DuC,UAdtB,WAAA,SAAoB,YAAY;EA4ExB;EA1EvB,WAAA;EA+EmB;EA5EnB,YAAA;EA4EmE;EAzEnE,QAAA;EA0Ec;EAvEd,IAAA,CAAK,MAAA;EAuEmB;EApExB,kBAAA,IAAsB,eAAA;AAAA;;;;;;;;;;;;;;;;;;AAoEiB;AA+FzC;;;;;;;;;iBAtGgB,aAAA,mCACd,MAAA,EAAQ,cAAA,CAAe,KAAA,KAKrB,SAAA,GAAY,GAAA,EAAK,eAAA,SAAwB,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC3D,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;;;;;;;;;;;;;;AAoGO;AAmZzC;;;;AAA4D;iBAxZ5C,SAAA,mCACd,MAAA,EAAQ,UAAA,IAGN,EAAA,MAAQ,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,WAC1B,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA;;;;AA6ZN;;;iBAVZ,yBAAA,IAA6B,eAAe;;;;;;;iBAU5C,YAAA"}

package/dist/workflow.js

@@ -1,7 +1,7 @@
 import { getActiveSpan } from "./trace-helpers.js";
-import { a as trace } from "./functional-DtI0u4vx.js";
+import { a as trace } from "./functional-r-AUIRy_.js";
 import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
-import { AsyncLocalStorage } from "node:async_hooks";
+import * as nodeAsyncHooks from "node:async_hooks";
 
 //#region src/workflow.ts
 /**
@@ -66,7 +66,7 @@ const workflowStates = /* @__PURE__ */ new WeakMap();
 * concurrent workflows. AsyncLocalStorage ensures each async execution chain
 * has its own isolated workflow context.
 */
-const workflowContextStorage = new AsyncLocalStorage();
+const workflowContextStorage = new nodeAsyncHooks.AsyncLocalStorage();
 /**
 * Create a traced workflow function
 *

package/dist/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","names":[],"sources":["../src/workflow.ts"],"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 { emitCorrelatedEvent } from './correlated-events';\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              emitCorrelatedEvent(ctx, '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              emitCorrelatedEvent(ctx, '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            emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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"],"mappings":"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"}
+{"version":3,"file":"workflow.js","names":[],"sources":["../src/workflow.ts"],"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\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeAsyncHooks from 'node:async_hooks';\nimport type { Attributes, Link, SpanContext } from '@opentelemetry/api';\nimport { emitCorrelatedEvent } from './correlated-events';\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 =\n  new nodeAsyncHooks.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              emitCorrelatedEvent(ctx, '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              emitCorrelatedEvent(ctx, '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            emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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      emitCorrelatedEvent(baseCtx, '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"],"mappings":"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"}

package/dist/yaml-config.cjs

@@ -1,6 +1,235 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_yaml_config = require('./yaml-config-Ck2uB0Dp.cjs');
+const require_chunk = require('./chunk-C_NdSu1c.cjs');
+const require_sampling = require('./sampling.cjs');
+const require_node_require = require('./node-require-CZ_PU448.cjs');
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path, 1);
 
-exports.hasYamlConfig = require_yaml_config.hasYamlConfig;
-exports.loadYamlConfig = require_yaml_config.loadYamlConfig;
-exports.loadYamlConfigFromFile = require_yaml_config.loadYamlConfigFromFile;
+//#region src/yaml-config.ts
+/**
+* YAML configuration loader for autotel
+*
+* Supports:
+* - Auto-discovery of autotel.yaml in cwd
+* - AUTOTEL_CONFIG_FILE env var override
+* - Environment variable substitution: ${env:VAR} and ${env:VAR:-default}
+*
+* @example Auto-discovery
+* ```yaml
+* # autotel.yaml in project root
+* service:
+*   name: my-service
+* exporter:
+*   endpoint: ${env:OTEL_EXPORTER_OTLP_ENDPOINT:-http://localhost:4318}
+* ```
+*
+* @example Explicit path
+* ```bash
+* AUTOTEL_CONFIG_FILE=./config/otel.yaml tsx --import autotel/auto src/index.ts
+* ```
+*/
+/**
+* Lazy-load yaml parser (optional peer dependency)
+* Only loads when a YAML config file is actually found
+*/
+function loadYamlParser() {
+	try {
+		return require_node_require.requireModule("yaml").parse;
+	} catch {
+		throw new Error("YAML parser not found. Install with: pnpm add yaml");
+	}
+}
+/**
+* Environment variable substitution regex
+* Matches ${env:VAR_NAME} and ${env:VAR_NAME:-default}
+*/
+const ENV_VAR_PATTERN = /\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\}/g;
+/**
+* Substitute ${env:VAR} and ${env:VAR:-default} in a string
+*
+* @param value - String potentially containing env var references
+* @returns String with env vars substituted
+*
+* @example
+* substituteEnvVars('${env:NODE_ENV:-development}')
+* // Returns 'production' if NODE_ENV=production, else 'development'
+*/
+function substituteEnvVars(value) {
+	return value.replaceAll(ENV_VAR_PATTERN, (_match, varName, defaultValue) => {
+		const envValue = process.env[varName];
+		if (envValue !== void 0) return envValue;
+		if (defaultValue !== void 0) return defaultValue;
+		console.warn(`[autotel] Environment variable ${varName} not set and no default provided`);
+		return "";
+	});
+}
+/**
+* Recursively substitute env vars in an object
+*
+* @param obj - Object to process
+* @returns Object with all string values having env vars substituted
+*/
+function substituteEnvVarsDeep(obj) {
+	if (typeof obj === "string") return substituteEnvVars(obj);
+	if (Array.isArray(obj)) return obj.map((item) => substituteEnvVarsDeep(item));
+	if (obj && typeof obj === "object") {
+		const result = {};
+		for (const [key, value] of Object.entries(obj)) result[key] = substituteEnvVarsDeep(value);
+		return result;
+	}
+	return obj;
+}
+/**
+* Find YAML config file path
+*
+* Priority:
+* 1. AUTOTEL_CONFIG_FILE env var (explicit path)
+* 2. autotel.yaml in cwd (convention)
+* 3. autotel.yml in cwd (alternative extension)
+*
+* @returns File path if found, null otherwise
+*/
+function findConfigFile() {
+	const envPath = process.env.AUTOTEL_CONFIG_FILE;
+	if (envPath) {
+		const resolved = node_path.default.resolve(envPath);
+		if (node_fs.existsSync(resolved)) return resolved;
+		console.warn(`[autotel] Config file not found: ${envPath}`);
+		return null;
+	}
+	const conventionPath = node_path.default.resolve(process.cwd(), "autotel.yaml");
+	if (node_fs.existsSync(conventionPath)) return conventionPath;
+	const altPath = node_path.default.resolve(process.cwd(), "autotel.yml");
+	if (node_fs.existsSync(altPath)) return altPath;
+	return null;
+}
+/**
+* Convert YAML config structure to AutotelConfig
+*
+* @param yaml - Parsed and env-substituted YAML config
+* @returns Partial AutotelConfig ready for merging
+*/
+function yamlToAutotelConfig(yaml) {
+	const config = {};
+	if (yaml.service?.name) config.service = yaml.service.name;
+	if (yaml.service?.version) config.version = yaml.service.version;
+	if (yaml.service?.environment) config.environment = yaml.service.environment;
+	if (yaml.exporter?.endpoint) config.endpoint = yaml.exporter.endpoint;
+	if (yaml.exporter?.protocol) config.protocol = yaml.exporter.protocol;
+	if (yaml.exporter?.headers) config.headers = yaml.exporter.headers;
+	if (yaml.exporter?.destinations) config.destinations = yaml.exporter.destinations;
+	if (yaml.resource) config.resourceAttributes = yaml.resource;
+	if (yaml.autoInstrumentations) config.autoInstrumentations = yaml.autoInstrumentations;
+	if (yaml.debug !== void 0) config.debug = yaml.debug;
+	if (yaml.sampling?.preset) {
+		warnOnIgnoredPresetOverrides(yaml.sampling);
+		config.sampling = yaml.sampling.preset;
+	} else {
+		const sampler = createSamplerFromYaml(yaml.sampling);
+		if (sampler) config.sampler = sampler;
+	}
+	return config;
+}
+function createSamplerFromYaml(sampling) {
+	if (!sampling) return void 0;
+	if (sampling.preset) return void 0;
+	const type = sampling.type ?? "adaptive";
+	try {
+		switch (type) {
+			case "adaptive": return new require_sampling.AdaptiveSampler({
+				baselineSampleRate: sampling.baseline_rate,
+				alwaysSampleErrors: sampling.always_sample_errors,
+				alwaysSampleSlow: sampling.always_sample_slow,
+				slowThresholdMs: sampling.slow_threshold_ms
+			});
+			case "always_on": return new require_sampling.AlwaysSampler();
+			case "always_off": return new require_sampling.NeverSampler();
+			case "ratio":
+				if (sampling.ratio === void 0) {
+					console.warn("[autotel] sampling.ratio missing in YAML sampling config. Falling back to adaptive sampler.");
+					return new require_sampling.AdaptiveSampler();
+				}
+				return new require_sampling.RandomSampler(sampling.ratio);
+			default:
+				console.warn(`[autotel] Unknown sampling type "${type}" in YAML config. Falling back to defaults.`);
+				return;
+		}
+	} catch (error) {
+		console.warn(`[autotel] Failed to configure sampling from YAML: ${error instanceof Error ? error.message : String(error)}`);
+		return;
+	}
+}
+function warnOnIgnoredPresetOverrides(sampling) {
+	const ignoredFields = [
+		"type",
+		"ratio",
+		"baseline_rate",
+		"always_sample_errors",
+		"always_sample_slow",
+		"slow_threshold_ms"
+	].filter((field) => sampling[field] !== void 0);
+	if (ignoredFields.length === 0) return;
+	console.warn(`[autotel] sampling.preset="${sampling.preset}" ignores these YAML fields: ${ignoredFields.join(", ")}. Use the programmatic API with sampler or samplingPresets.*(...) for tuned presets.`);
+}
+/**
+* Load and parse YAML config file (auto-discovery)
+*
+* Automatically finds and loads autotel.yaml or uses AUTOTEL_CONFIG_FILE.
+* Returns null if no config file found (not an error - YAML config is optional).
+*
+* @returns Partial AutotelConfig or null if no config file found
+*
+* @example
+* const yamlConfig = loadYamlConfig();
+* if (yamlConfig) {
+*   init({ ...yamlConfig, debug: true });
+* }
+*/
+function loadYamlConfig() {
+	const filePath = findConfigFile();
+	if (!filePath) return null;
+	try {
+		const content = node_fs.readFileSync(filePath, "utf8");
+		return yamlToAutotelConfig(substituteEnvVarsDeep(loadYamlParser()(content)));
+	} catch (error) {
+		console.error(`[autotel] Failed to load YAML config from ${filePath}:`, error);
+		return null;
+	}
+}
+/**
+* Load YAML config from a specific file path
+*
+* Unlike loadYamlConfig(), this throws if the file cannot be read.
+*
+* @param filePath - Path to YAML config file
+* @returns Partial AutotelConfig
+* @throws Error if file cannot be read or parsed
+*
+* @example
+* import { loadYamlConfigFromFile } from 'autotel/yaml';
+* import { init } from 'autotel';
+*
+* const config = loadYamlConfigFromFile('./config/otel.yaml');
+* init({ ...config, debug: true });
+*/
+function loadYamlConfigFromFile(filePath) {
+	const resolved = node_path.default.resolve(filePath);
+	const content = node_fs.readFileSync(resolved, "utf8");
+	return yamlToAutotelConfig(substituteEnvVarsDeep(loadYamlParser()(content)));
+}
+/**
+* Check if a YAML config file exists (without loading it)
+*
+* @returns true if a config file would be found by loadYamlConfig()
+*/
+function hasYamlConfig() {
+	return findConfigFile() !== null;
+}
+
+//#endregion
+exports.hasYamlConfig = hasYamlConfig;
+exports.loadYamlConfig = loadYamlConfig;
+exports.loadYamlConfigFromFile = loadYamlConfigFromFile;
+//# sourceMappingURL=yaml-config.cjs.map

package/dist/yaml-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-config.cjs","names":["requireModule","path","nodeFs","AdaptiveSampler","AlwaysSampler","NeverSampler","RandomSampler"],"sources":["../src/yaml-config.ts"],"sourcesContent":["/**\n * YAML configuration loader for autotel\n *\n * Supports:\n * - Auto-discovery of autotel.yaml in cwd\n * - AUTOTEL_CONFIG_FILE env var override\n * - Environment variable substitution: ${env:VAR} and ${env:VAR:-default}\n *\n * @example Auto-discovery\n * ```yaml\n * # autotel.yaml in project root\n * service:\n *   name: my-service\n * exporter:\n *   endpoint: ${env:OTEL_EXPORTER_OTLP_ENDPOINT:-http://localhost:4318}\n * ```\n *\n * @example Explicit path\n * ```bash\n * AUTOTEL_CONFIG_FILE=./config/otel.yaml tsx --import autotel/auto src/index.ts\n * ```\n */\n\n// namespace import for browser-bundler compat — see node-require.ts\nimport * as nodeFs from 'node:fs';\nimport path from 'node:path';\nimport type { AutotelConfig, OtlpSignal } from './init';\nimport {\n  AdaptiveSampler,\n  AlwaysSampler,\n  NeverSampler,\n  RandomSampler,\n  type SamplingPreset,\n} from './sampling';\n\n/**\n * Lazy-load yaml parser (optional peer dependency)\n * Only loads when a YAML config file is actually found\n */\nimport { requireModule } from './node-require';\n\nfunction loadYamlParser(): (content: string) => unknown {\n  try {\n    const mod = requireModule<{ parse: (content: string) => unknown }>('yaml');\n    return mod.parse;\n  } catch {\n    throw new Error('YAML parser not found. Install with: pnpm add yaml');\n  }\n}\n\n/**\n * YAML config structure\n * Maps to AutotelConfig with user-friendly naming\n */\nexport interface YamlConfig {\n  service?: {\n    name?: string;\n    version?: string;\n    environment?: string;\n  };\n  exporter?: {\n    endpoint?: string;\n    protocol?: 'http' | 'grpc';\n    headers?: Record<string, string>;\n    destinations?: Array<{\n      endpoint: string;\n      protocol?: 'http' | 'grpc';\n      headers?: Record<string, string>;\n      signals?: OtlpSignal[];\n    }>;\n  };\n  resource?: Record<string, string | number | boolean>;\n  sampling?: {\n    preset?: SamplingPreset;\n    type?: 'adaptive' | 'always_on' | 'always_off' | 'ratio';\n    ratio?: number;\n    baseline_rate?: number;\n    always_sample_errors?: boolean;\n    always_sample_slow?: boolean;\n    slow_threshold_ms?: number;\n  };\n  autoInstrumentations?: string[] | Record<string, { enabled?: boolean }>;\n  debug?: boolean;\n}\n\n/**\n * Environment variable substitution regex\n * Matches ${env:VAR_NAME} and ${env:VAR_NAME:-default}\n */\nconst ENV_VAR_PATTERN = /\\$\\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\\}/g;\n\n/**\n * Substitute ${env:VAR} and ${env:VAR:-default} in a string\n *\n * @param value - String potentially containing env var references\n * @returns String with env vars substituted\n *\n * @example\n * substituteEnvVars('${env:NODE_ENV:-development}')\n * // Returns 'production' if NODE_ENV=production, else 'development'\n */\nfunction substituteEnvVars(value: string): string {\n  return value.replaceAll(\n    ENV_VAR_PATTERN,\n    (_match, varName: string, defaultValue?: string) => {\n      const envValue = process.env[varName];\n      if (envValue !== undefined) return envValue;\n      if (defaultValue !== undefined) return defaultValue;\n      console.warn(\n        `[autotel] Environment variable ${varName} not set and no default provided`,\n      );\n      return '';\n    },\n  );\n}\n\n/**\n * Recursively substitute env vars in an object\n *\n * @param obj - Object to process\n * @returns Object with all string values having env vars substituted\n */\nfunction substituteEnvVarsDeep(obj: unknown): unknown {\n  if (typeof obj === 'string') {\n    return substituteEnvVars(obj);\n  }\n  if (Array.isArray(obj)) {\n    return obj.map((item) => substituteEnvVarsDeep(item));\n  }\n  if (obj && typeof obj === 'object') {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      result[key] = substituteEnvVarsDeep(value);\n    }\n    return result;\n  }\n  return obj;\n}\n\n/**\n * Find YAML config file path\n *\n * Priority:\n * 1. AUTOTEL_CONFIG_FILE env var (explicit path)\n * 2. autotel.yaml in cwd (convention)\n * 3. autotel.yml in cwd (alternative extension)\n *\n * @returns File path if found, null otherwise\n */\nfunction findConfigFile(): string | null {\n  // Check env var first (explicit takes priority)\n  const envPath = process.env.AUTOTEL_CONFIG_FILE;\n  if (envPath) {\n    const resolved = path.resolve(envPath);\n    if (nodeFs.existsSync(resolved)) return resolved;\n    console.warn(`[autotel] Config file not found: ${envPath}`);\n    return null;\n  }\n\n  // Auto-discover autotel.yaml in cwd\n  const conventionPath = path.resolve(process.cwd(), 'autotel.yaml');\n  if (nodeFs.existsSync(conventionPath)) return conventionPath;\n\n  // Also check .yml extension\n  const altPath = path.resolve(process.cwd(), 'autotel.yml');\n  if (nodeFs.existsSync(altPath)) return altPath;\n\n  return null;\n}\n\n/**\n * Convert YAML config structure to AutotelConfig\n *\n * @param yaml - Parsed and env-substituted YAML config\n * @returns Partial AutotelConfig ready for merging\n */\nfunction yamlToAutotelConfig(yaml: YamlConfig): Partial<AutotelConfig> {\n  const config: Partial<AutotelConfig> = {};\n\n  // Service configuration\n  if (yaml.service?.name) config.service = yaml.service.name;\n  if (yaml.service?.version) config.version = yaml.service.version;\n  if (yaml.service?.environment) config.environment = yaml.service.environment;\n\n  // Exporter configuration\n  if (yaml.exporter?.endpoint) config.endpoint = yaml.exporter.endpoint;\n  if (yaml.exporter?.protocol) config.protocol = yaml.exporter.protocol;\n  if (yaml.exporter?.headers) config.headers = yaml.exporter.headers;\n  if (yaml.exporter?.destinations) {\n    config.destinations = yaml.exporter.destinations;\n  }\n\n  // Resource attributes (flattened)\n  if (yaml.resource) config.resourceAttributes = yaml.resource;\n\n  // Integrations\n  if (yaml.autoInstrumentations)\n    config.autoInstrumentations = yaml.autoInstrumentations;\n\n  // Debug mode\n  if (yaml.debug !== undefined) config.debug = yaml.debug;\n\n  // Sampling configuration\n  if (yaml.sampling?.preset) {\n    warnOnIgnoredPresetOverrides(yaml.sampling);\n    config.sampling = yaml.sampling.preset;\n  } else {\n    const sampler = createSamplerFromYaml(yaml.sampling);\n    if (sampler) config.sampler = sampler;\n  }\n\n  return config;\n}\n\nfunction createSamplerFromYaml(\n  sampling?: YamlConfig['sampling'],\n): AutotelConfig['sampler'] {\n  if (!sampling) return undefined;\n  if (sampling.preset) return undefined;\n\n  const type = sampling.type ?? 'adaptive';\n\n  try {\n    switch (type) {\n      case 'adaptive': {\n        return new AdaptiveSampler({\n          baselineSampleRate: sampling.baseline_rate,\n          alwaysSampleErrors: sampling.always_sample_errors,\n          alwaysSampleSlow: sampling.always_sample_slow,\n          slowThresholdMs: sampling.slow_threshold_ms,\n        });\n      }\n      case 'always_on': {\n        return new AlwaysSampler();\n      }\n      case 'always_off': {\n        return new NeverSampler();\n      }\n      case 'ratio': {\n        if (sampling.ratio === undefined) {\n          console.warn(\n            '[autotel] sampling.ratio missing in YAML sampling config. Falling back to adaptive sampler.',\n          );\n          return new AdaptiveSampler();\n        }\n        return new RandomSampler(sampling.ratio);\n      }\n      default: {\n        console.warn(\n          `[autotel] Unknown sampling type \"${type}\" in YAML config. Falling back to defaults.`,\n        );\n        return undefined;\n      }\n    }\n  } catch (error) {\n    console.warn(\n      `[autotel] Failed to configure sampling from YAML: ${error instanceof Error ? error.message : String(error)}`,\n    );\n    return undefined;\n  }\n}\n\nfunction warnOnIgnoredPresetOverrides(\n  sampling: NonNullable<YamlConfig['sampling']>,\n): void {\n  const ignoredFields = [\n    'type',\n    'ratio',\n    'baseline_rate',\n    'always_sample_errors',\n    'always_sample_slow',\n    'slow_threshold_ms',\n  ].filter((field) => sampling[field as keyof typeof sampling] !== undefined);\n\n  if (ignoredFields.length === 0) {\n    return;\n  }\n\n  console.warn(\n    `[autotel] sampling.preset=\"${sampling.preset}\" ignores these YAML fields: ${ignoredFields.join(', ')}. ` +\n      'Use the programmatic API with sampler or samplingPresets.*(...) for tuned presets.',\n  );\n}\n\n/**\n * Load and parse YAML config file (auto-discovery)\n *\n * Automatically finds and loads autotel.yaml or uses AUTOTEL_CONFIG_FILE.\n * Returns null if no config file found (not an error - YAML config is optional).\n *\n * @returns Partial AutotelConfig or null if no config file found\n *\n * @example\n * const yamlConfig = loadYamlConfig();\n * if (yamlConfig) {\n *   init({ ...yamlConfig, debug: true });\n * }\n */\nexport function loadYamlConfig(): Partial<AutotelConfig> | null {\n  const filePath = findConfigFile();\n  if (!filePath) return null;\n\n  try {\n    const content = nodeFs.readFileSync(filePath, 'utf8');\n    const parseYaml = loadYamlParser();\n    const rawYaml = parseYaml(content) as YamlConfig;\n    const substituted = substituteEnvVarsDeep(rawYaml) as YamlConfig;\n    return yamlToAutotelConfig(substituted);\n  } catch (error) {\n    console.error(\n      `[autotel] Failed to load YAML config from ${filePath}:`,\n      error,\n    );\n    return null;\n  }\n}\n\n/**\n * Load YAML config from a specific file path\n *\n * Unlike loadYamlConfig(), this throws if the file cannot be read.\n *\n * @param filePath - Path to YAML config file\n * @returns Partial AutotelConfig\n * @throws Error if file cannot be read or parsed\n *\n * @example\n * import { loadYamlConfigFromFile } from 'autotel/yaml';\n * import { init } from 'autotel';\n *\n * const config = loadYamlConfigFromFile('./config/otel.yaml');\n * init({ ...config, debug: true });\n */\nexport function loadYamlConfigFromFile(\n  filePath: string,\n): Partial<AutotelConfig> {\n  const resolved = path.resolve(filePath);\n  const content = nodeFs.readFileSync(resolved, 'utf8');\n  const parseYaml = loadYamlParser();\n  const rawYaml = parseYaml(content) as YamlConfig;\n  const substituted = substituteEnvVarsDeep(rawYaml) as YamlConfig;\n  return yamlToAutotelConfig(substituted);\n}\n\n/**\n * Check if a YAML config file exists (without loading it)\n *\n * @returns true if a config file would be found by loadYamlConfig()\n */\nexport function hasYamlConfig(): boolean {\n  return findConfigFile() !== null;\n}\n"],"mappings":"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"}

package/dist/yaml-config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-config.d.cts","names":[],"sources":["../src/yaml-config.ts"],"mappings":";;;;;;;;UAqDiB,UAAA;EACf,OAAA;IACE,IAAA;IACA,OAAA;IACA,WAAA;EAAA;EAEF,QAAA;IACE,QAAA;IACA,QAAA;IACA,OAAA,GAAU,MAAA;IACV,YAAA,GAAe,KAAA;MACb,QAAA;MACA,QAAA;MACA,OAAA,GAAU,MAAA;MACV,OAAA,GAAU,UAAA;IAAA;EAAA;EAGd,QAAA,GAAW,MAAA;EACX,QAAA;IACE,MAAA,GAAS,cAAA;IACT,IAAA;IACA,KAAA;IACA,aAAA;IACA,oBAAA;IACA,kBAAA;IACA,iBAAA;EAAA;EAEF,oBAAA,cAAkC,MAAA;IAAiB,OAAA;EAAA;EACnD,KAAA;AAAA;;;;AA6PsB;AAcxB;;;;AAA6B;;;;;;iBAnDb,cAAA,IAAkB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;iBAmC1B,sBAAA,CACd,QAAA,WACC,OAAO,CAAC,aAAA;;;;;;iBAcK,aAAA"}
+{"version":3,"file":"yaml-config.d.cts","names":[],"sources":["../src/yaml-config.ts"],"mappings":";;;;;;;;UAsDiB,UAAA;EACf,OAAA;IACE,IAAA;IACA,OAAA;IACA,WAAA;EAAA;EAEF,QAAA;IACE,QAAA;IACA,QAAA;IACA,OAAA,GAAU,MAAA;IACV,YAAA,GAAe,KAAA;MACb,QAAA;MACA,QAAA;MACA,OAAA,GAAU,MAAA;MACV,OAAA,GAAU,UAAA;IAAA;EAAA;EAGd,QAAA,GAAW,MAAA;EACX,QAAA;IACE,MAAA,GAAS,cAAA;IACT,IAAA;IACA,KAAA;IACA,aAAA;IACA,oBAAA;IACA,kBAAA;IACA,iBAAA;EAAA;EAEF,oBAAA,cAAkC,MAAA;IAAiB,OAAA;EAAA;EACnD,KAAA;AAAA;;;;AA6PsB;AAcxB;;;;AAA6B;;;;;;iBAnDb,cAAA,IAAkB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;iBAmC1B,sBAAA,CACd,QAAA,WACC,OAAO,CAAC,aAAA;;;;;;iBAcK,aAAA"}

package/dist/yaml-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-config.d.ts","names":[],"sources":["../src/yaml-config.ts"],"mappings":";;;;;;;;UAqDiB,UAAA;EACf,OAAA;IACE,IAAA;IACA,OAAA;IACA,WAAA;EAAA;EAEF,QAAA;IACE,QAAA;IACA,QAAA;IACA,OAAA,GAAU,MAAA;IACV,YAAA,GAAe,KAAA;MACb,QAAA;MACA,QAAA;MACA,OAAA,GAAU,MAAA;MACV,OAAA,GAAU,UAAA;IAAA;EAAA;EAGd,QAAA,GAAW,MAAA;EACX,QAAA;IACE,MAAA,GAAS,cAAA;IACT,IAAA;IACA,KAAA;IACA,aAAA;IACA,oBAAA;IACA,kBAAA;IACA,iBAAA;EAAA;EAEF,oBAAA,cAAkC,MAAA;IAAiB,OAAA;EAAA;EACnD,KAAA;AAAA;;;;AA6PsB;AAcxB;;;;AAA6B;;;;;;iBAnDb,cAAA,IAAkB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;iBAmC1B,sBAAA,CACd,QAAA,WACC,OAAO,CAAC,aAAA;;;;;;iBAcK,aAAA"}
+{"version":3,"file":"yaml-config.d.ts","names":[],"sources":["../src/yaml-config.ts"],"mappings":";;;;;;;;UAsDiB,UAAA;EACf,OAAA;IACE,IAAA;IACA,OAAA;IACA,WAAA;EAAA;EAEF,QAAA;IACE,QAAA;IACA,QAAA;IACA,OAAA,GAAU,MAAA;IACV,YAAA,GAAe,KAAA;MACb,QAAA;MACA,QAAA;MACA,OAAA,GAAU,MAAA;MACV,OAAA,GAAU,UAAA;IAAA;EAAA;EAGd,QAAA,GAAW,MAAA;EACX,QAAA;IACE,MAAA,GAAS,cAAA;IACT,IAAA;IACA,KAAA;IACA,aAAA;IACA,oBAAA;IACA,kBAAA;IACA,iBAAA;EAAA;EAEF,oBAAA,cAAkC,MAAA;IAAiB,OAAA;EAAA;EACnD,KAAA;AAAA;;;;AA6PsB;AAcxB;;;;AAA6B;;;;;;iBAnDb,cAAA,IAAkB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;iBAmC1B,sBAAA,CACd,QAAA,WACC,OAAO,CAAC,aAAA;;;;;;iBAcK,aAAA"}