autotel 4.3.0 → 6.0.0

package/dist/logger-thMPLpOG.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger-thMPLpOG.cjs","names":["api_context","trace","extra","getConfig","SpanStatusCode"],"sources":["../src/autotel-logger.ts","../src/logger.ts"],"sourcesContent":["/**\n * Zero-dependency structured logger for autotel\n *\n * This logger provides:\n * - Structured JSON logging (production) or pretty print (development)\n * - Auto trace context injection (traceId, spanId, correlationId)\n * - Dynamic log level control (per-request via OTel context)\n * - Level support (debug, info, warn, error, none)\n * - Zero additional dependencies (uses @opentelemetry/api, already a dep)\n *\n * Uses Pino-compatible signature supporting both patterns:\n * - `log.info('simple message')` - string-only\n * - `log.info({ userId: '123' }, 'message')` - object first with optional message\n *\n * Used as the default fallback when users don't provide Pino/Bunyan.\n * Can also be used directly: import { createBuiltinLogger } from 'autotel/logger'\n *\n * @example\n * ```typescript\n * import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';\n *\n * const log = createBuiltinLogger('my-service');\n *\n * // Simple message (no metadata)\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n * // Output: {\"level\":\"info\",\"service\":\"my-service\",\"msg\":\"User created\",\"userId\":\"123\",\"traceId\":\"...\"}\n *\n * // Dynamic log level per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will log even if default level is \"info\"');\n * });\n * ```\n */\n\nimport {\n  trace,\n  context as api_context,\n  createContextKey,\n} from '@opentelemetry/api';\nimport type { Logger } from './logger';\n\nexport type BuiltinLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';\n\n/**\n * Context key for storing active log level (enables per-request log levels)\n */\nconst LOG_LEVEL_KEY = createContextKey('autotel-log-level');\n\n/**\n * Get the active log level from context (if set)\n * Falls back to undefined if no log level is set in context\n */\nexport function getActiveLogLevel(): BuiltinLogLevel | undefined {\n  return api_context.active().getValue(LOG_LEVEL_KEY) as\n    | BuiltinLogLevel\n    | undefined;\n}\n\n/**\n * Run a function with a specific log level\n * The log level is stored in OpenTelemetry context and applies to all logger calls within the callback\n *\n * @example\n * ```typescript\n * // Enable debug logging for a specific request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will be logged');\n *   processRequest();\n * });\n *\n * // Disable logging temporarily\n * runWithLogLevel('none', () => {\n *   log.info('This will NOT be logged');\n * });\n * ```\n */\nexport function runWithLogLevel<T>(\n  level: BuiltinLogLevel,\n  callback: () => T,\n): T {\n  const ctx = api_context.active().setValue(LOG_LEVEL_KEY, level);\n  return api_context.with(ctx, callback);\n}\n\n/**\n * Get current trace context from active span\n * Returns null if no active span exists\n */\nfunction getTraceContextInternal(): {\n  traceId: string;\n  spanId: string;\n  correlationId: string;\n} | null {\n  const span = trace.getActiveSpan();\n  if (!span) return null;\n\n  const ctx = span.spanContext();\n  return {\n    traceId: ctx.traceId,\n    spanId: ctx.spanId,\n    correlationId: ctx.traceId.slice(0, 16), // First 16 chars for grouping\n  };\n}\n\n/**\n * Helper to get trace context (useful for BYOL - Bring Your Own Logger)\n *\n * @example\n * ```typescript\n * import bunyan from 'bunyan';\n * import { getTraceContext } from 'autotel/logger';\n *\n * const bunyanLogger = bunyan.createLogger({ name: 'myapp' });\n * const ctx = getTraceContext();\n * bunyanLogger.info({ ...ctx, email: 'test@example.com' }, 'Creating user');\n * ```\n */\nexport function getTraceContext() {\n  return getTraceContextInternal();\n}\n\nexport interface BuiltinLoggerOptions {\n  /** Minimum log level. Default: 'info' */\n  level?: BuiltinLogLevel;\n  /** Pretty print for development. Default: false (JSON output) */\n  pretty?: boolean;\n}\n\n/**\n * Create a lightweight structured logger\n *\n * @param service - Service name for logging\n * @param options - Optional configuration\n *\n * @example\n * ```typescript\n * const log = createBuiltinLogger('user-service');\n *\n * log.info('Creating user', { email: 'test@example.com' });\n * // Output: {\"level\":\"info\",\"service\":\"user-service\",\"msg\":\"Creating user\",\n * //          \"email\":\"test@example.com\",\"traceId\":\"...\",\"spanId\":\"...\"}\n *\n * // Dynamic log level control per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will be logged even if logger was created with level: \"info\"');\n * });\n * ```\n */\nexport function createBuiltinLogger(\n  service: string,\n  options?: BuiltinLoggerOptions,\n): Logger {\n  const defaultLevel = options?.level || 'info';\n  const pretty = options?.pretty || false;\n\n  const levelPriority: Record<BuiltinLogLevel, number> = {\n    none: -1,\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n  };\n\n  const shouldLog = (level: BuiltinLogLevel): boolean => {\n    // Priority: context level > options level > 'info' default\n    const activeLevel = getActiveLogLevel() ?? defaultLevel;\n\n    // 'none' means suppress all logging\n    if (activeLevel === 'none') return false;\n\n    return levelPriority[level] >= levelPriority[activeLevel];\n  };\n\n  const log = (\n    level: 'info' | 'error' | 'warn' | 'debug',\n    msg: string,\n    attrs?: Record<string, unknown>,\n  ) => {\n    if (!shouldLog(level)) return;\n\n    const ctx = getTraceContextInternal();\n    const logEntry: Record<string, unknown> = {\n      level,\n      service,\n      msg,\n      ...attrs,\n      ...ctx, // Auto-inject traceId, spanId, correlationId\n      timestamp: new Date().toISOString(),\n    };\n\n    if (pretty) {\n      // Pretty print for development\n      const traceInfo = ctx\n        ? ` [${ctx.traceId.slice(0, 8)}.../${ctx.spanId.slice(0, 8)}...]`\n        : '';\n      console.log(\n        `[${level.toUpperCase()}]${traceInfo} ${service}: ${msg}`,\n        attrs || '',\n      );\n    } else {\n      // Structured JSON for production\n      console.log(JSON.stringify(logEntry));\n    }\n  };\n\n  // Pino-compatible signature: supports both:\n  // - logger.info('message') - string-only\n  // - logger.info({ extra }, 'message') - Pino style with metadata\n  // Also auto-detects and handles legacy Winston-style: logger.info('message', { extra })\n  const createLogMethod = (level: 'info' | 'warn' | 'debug') => {\n    return (\n      extraOrMessage: Record<string, unknown> | string,\n      message?: string | Record<string, unknown>,\n    ) => {\n      if (typeof extraOrMessage === 'string') {\n        // First arg is string - could be:\n        // 1. String-only: logger.info('message')\n        // 2. Legacy Winston-style: logger.info('message', { extra })\n        if (message !== undefined && typeof message === 'object') {\n          // Legacy Winston-style detected - auto-swap for backward compatibility\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.${level}('message', metadata). ` +\n                `Autotel recommends Pino signature: logger.${level}({ ...metadata }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          // Swap: treat first arg as message, second as metadata\n          log(level, extraOrMessage, message as Record<string, unknown>);\n        } else {\n          // Pure string-only call: logger.info('message')\n          log(level, extraOrMessage);\n        }\n      } else {\n        // Pino style: logger.info({ extra }, 'message')\n        log(level, (message as string) || '', extraOrMessage);\n      }\n    };\n  };\n\n  return {\n    info: createLogMethod('info'),\n    warn: createLogMethod('warn'),\n    debug: createLogMethod('debug'),\n\n    error: (\n      extraOrMessage: Record<string, unknown> | string,\n      message?: string | Record<string, unknown> | Error,\n    ) => {\n      if (typeof extraOrMessage === 'string') {\n        // First arg is string - could be:\n        // 1. String-only: logger.error('message')\n        // 2. Legacy: logger.error('message', error) - Error as second arg\n        // 3. Legacy: logger.error('message', { extra }) - object as second arg\n\n        // Handle legacy logger.error('message', error) pattern\n        if (message instanceof Error) {\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.error('message', error). ` +\n                `Autotel recommends Pino signature: logger.error({ err: error }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          log('error', extraOrMessage, {\n            error: message.message,\n            stack: message.stack,\n            name: message.name,\n          });\n          return;\n        }\n\n        // Handle legacy logger.error('message', { extra }) pattern\n        if (message !== undefined && typeof message === 'object') {\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.error('message', metadata). ` +\n                `Autotel recommends Pino signature: logger.error({ ...metadata }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          // Swap: treat first arg as message, second as metadata (handle err extraction)\n          const extra = message as Record<string, unknown>;\n          const { err, ...rest } = extra as Record<string, unknown> & {\n            err?: unknown;\n          };\n          let errorAttrs: Record<string, unknown> = rest;\n          if (err instanceof Error) {\n            errorAttrs = {\n              error: err.message,\n              stack: err.stack,\n              name: err.name,\n              ...rest,\n            };\n          } else if (err !== undefined) {\n            errorAttrs = { err, ...rest };\n          }\n          log('error', extraOrMessage, errorAttrs);\n          return;\n        }\n\n        // Pure string-only call: logger.error('message')\n        log('error', extraOrMessage);\n        return;\n      }\n\n      // Pino style: logger.error({ err, ...extra }, 'message')\n      // Extract err from extra if present (Pino convention)\n      const { err, ...rest } = extraOrMessage as Record<string, unknown> & {\n        err?: unknown;\n      };\n      let errorAttrs: Record<string, unknown> = rest;\n      if (err instanceof Error) {\n        // err is an Error - extract message, stack, name for structured logging\n        errorAttrs = {\n          error: err.message,\n          stack: err.stack,\n          name: err.name,\n          ...rest,\n        };\n      } else if (err !== undefined) {\n        // err is not an Error but exists - preserve it as-is\n        errorAttrs = {\n          err,\n          ...rest,\n        };\n      }\n      log('error', (message as string) || '', errorAttrs);\n    },\n  };\n}\n\n/**\n * Pino-like factory function for creating an autotel logger\n *\n * @example\n * ```typescript\n * import { autotelLogger } from 'autotel/logger';\n *\n * const log = autotelLogger();\n *\n * // Simple message\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n *\n * // With options\n * const devLog = autotelLogger({ service: 'my-app', level: 'debug', pretty: true });\n * ```\n */\nexport function autotelLogger(options?: {\n  service?: string;\n  level?: BuiltinLogLevel;\n  pretty?: boolean;\n}): Logger {\n  return createBuiltinLogger(options?.service || 'app', {\n    level: options?.level,\n    pretty: options?.pretty,\n  });\n}\n","/**\n * Logger types and utilities for autotel\n *\n * **Zero-Config Option:** Don't provide a logger to `init()` and autotel uses\n * a built-in structured JSON logger with automatic trace context injection.\n *\n * **BYOL (Bring Your Own Logger):** Pass Pino or Bunyan to `init()` for\n * automatic instrumentation with trace context and OTLP log export.\n *\n * ## Logger Signature\n *\n * Autotel v2.10+ uses **Pino's signature**: `logger.info({ metadata }, 'message')`.\n *\n * ### Backward Compatibility\n *\n * The built-in logger auto-detects legacy Winston-style calls and swaps arguments:\n * ```typescript\n * // Legacy (auto-detected and handled)\n * logger.info('User created', { userId: '123' });\n * // → Internally treated as: logger.info({ userId: '123' }, 'User created')\n * // → Logs warning in development, works silently in production\n * ```\n *\n * ### Recommended Usage\n *\n * ```typescript\n * // ✅ Pino-style (preferred)\n * logger.info({ userId: '123' }, 'User created');\n *\n * // ✅ Simple message (no metadata)\n * logger.info('Server started');\n * ```\n *\n * **Note:** If you BYOL (bring your own logger), it must use Pino signature.\n * Winston and other `(message, meta)` loggers are NOT compatible.\n * For Winston, use `@opentelemetry/instrumentation-winston` instead.\n *\n * @example Zero-config (uses built-in logger)\n * ```typescript\n * import { init } from 'autotel';\n *\n * init({ service: 'my-app' });\n * // Internal logs: {\"level\":\"info\",\"service\":\"my-app\",\"msg\":\"...\",\"traceId\":\"...\"}\n * ```\n *\n * @example Using built-in logger directly\n * ```typescript\n * import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';\n *\n * const log = createBuiltinLogger('my-service');\n *\n * // Simple message (no metadata)\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n * // Output: {\"level\":\"info\",\"service\":\"my-service\",\"msg\":\"User created\",\"userId\":\"123\",\"traceId\":\"...\"}\n *\n * // Dynamic log level per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('Debug info for this request only');\n * });\n * ```\n *\n * @example Using Pino (recommended for production, auto-instrumented)\n * ```typescript\n * import pino from 'pino';  // npm install pino\n * import { init } from 'autotel';\n *\n * const logger = pino({ level: 'info' });\n * init({ service: 'my-app', logger });\n *\n * // Logs automatically include traceId/spanId and export via OTLP!\n * logger.info({ userId: '123' }, 'User created');\n * ```\n *\n * @example Using Bunyan (auto-instrumented, same signature as Pino)\n * ```typescript\n * import bunyan from 'bunyan';  // npm install bunyan @opentelemetry/instrumentation-bunyan\n * import { init } from 'autotel';\n * import { BunyanInstrumentation } from '@opentelemetry/instrumentation-bunyan';\n *\n * const logger = bunyan.createLogger({ name: 'my-app' });\n * init({\n *   service: 'my-app',\n *   logger,\n *   instrumentations: [new BunyanInstrumentation()]\n * });\n * ```\n *\n * @example Custom logger (MUST use Pino-compatible signature)\n * ```typescript\n * // ⚠️ Your custom logger MUST accept (object, message?) signature\n * const logger = {\n *   info: (extra, msg) => console.log(msg || '', extra),\n *   warn: (extra, msg) => console.warn(msg || '', extra),\n *   error: (extra, msg) => console.error(msg || '', extra),\n *   debug: (extra, msg) => console.debug(msg || '', extra),\n * };\n * init({ service: 'my-app', logger });\n * ```\n *\n * @example BYOL helper: inject trace context into any logger\n * ```typescript\n * import bunyan from 'bunyan';\n * import { getTraceContext } from 'autotel/logger';\n *\n * const bunyanLogger = bunyan.createLogger({ name: 'myapp' });\n * const ctx = getTraceContext();\n * bunyanLogger.info({ ...ctx, userId: '123' }, 'Creating user');\n * ```\n */\n\nimport { SpanStatusCode } from '@opentelemetry/api';\nimport { getConfig } from './config';\n\n// ============================================================================\n// Logger Types\n// ============================================================================\n\n/**\n * Log level constants\n */\nexport const LOG_LEVEL = {\n  DEBUG: 'debug',\n  INFO: 'info',\n  WARN: 'warn',\n  ERROR: 'error',\n} as const;\n\nexport type LogLevel = (typeof LOG_LEVEL)[keyof typeof LOG_LEVEL];\n\n/**\n * Logger configuration (for reference - not needed with BYOL approach)\n */\nexport interface LoggerConfig {\n  service: string;\n  level?: LogLevel;\n  pretty?: boolean;\n  redact?: string[] | false;\n}\n\n/**\n * Pino-compatible log function signature\n *\n * Matches Pino's actual LogFn type which supports:\n * - `(msg: string)` - simple string message\n * - `(obj: object, msg?: string)` - object first with optional message\n *\n * @example\n * ```typescript\n * logger.info('User logged in');\n * logger.info({ userId: '123' }, 'User created');\n * logger.error({ err: error }, 'Operation failed');\n * ```\n */\nexport interface LogFn {\n  (msg: string): void;\n  (obj: Record<string, unknown>, msg?: string): void;\n}\n\n/**\n * Simple logger interface - Pino/Bunyan-compatible\n *\n * Uses Pino's LogFn signature which supports both:\n * - `logger.info('message')` - simple string message\n * - `logger.info({ extra }, 'message')` - object first with optional message\n *\n * This is compatible with Pino, Bunyan, and any logger following this pattern.\n *\n * @example Using Pino (just works!)\n * ```typescript\n * import pino from 'pino';\n * const logger = pino({ level: 'info' });\n * init({ service: 'my-app', logger });\n * ```\n *\n * @example Direct usage\n * ```typescript\n * logger.info('Simple message');\n * logger.info({ userId: '123' }, 'User created');\n * logger.error({ err: error }, 'Operation failed');\n * ```\n */\nexport interface Logger {\n  info: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  debug: LogFn;\n}\n\n/**\n * Alias for Logger interface (backwards compatibility)\n * @deprecated Use Logger instead\n */\nexport type ILogger = Logger;\n\n/**\n * Pino logger type - re-exported for convenience\n *\n * Note: This is a type-only export. To use Pino, install it as a peer dependency:\n * `npm install pino`\n */\nexport type { Logger as PinoLogger } from 'pino';\n\n// ============================================================================\n// LoggedOperation Decorator\n// ============================================================================\n\nexport interface LoggedOperationOptions {\n  /** Operation name for tracing (e.g., 'user.createUser') */\n  operationName: string;\n}\n\n/**\n * TS5+ Standard Decorator for logging and tracing operations\n * Uses TC39 Stage 3 decorator syntax\n *\n * This is the traditional per-method decorator approach.\n * For zero-boilerplate solution, see @Instrumented class decorator.\n *\n * @example\n * // Simple usage (Pino-style: object first, message second)\n * class OrderService {\n *   constructor(private readonly deps: { log: Logger }) {}\n *\n *   @LoggedOperation('order.create')\n *   async createOrder(data: CreateOrderData) {\n *     // ✅ Correct Pino-style logging\n *     this.deps.log.info({ orderId: data.id }, 'Creating order');\n *   }\n * }\n *\n * // Advanced usage (future-proof for options)\n * @LoggedOperation({ operationName: 'order.create' })\n * async createOrder(data: CreateOrderData) { }\n */\nexport function LoggedOperation(\n  operationNameOrOptions: string | LoggedOperationOptions,\n) {\n  const operationName =\n    typeof operationNameOrOptions === 'string'\n      ? operationNameOrOptions\n      : operationNameOrOptions.operationName;\n\n  return function <This, Args extends unknown[], Return>(\n    originalMethod: (this: This, ...args: Args) => Promise<Return>,\n    context: ClassMethodDecoratorContext<\n      This,\n      (this: This, ...args: Args) => Promise<Return>\n    >,\n  ) {\n    const methodName = String(context.name);\n\n    return async function (this: This, ...args: Args): Promise<Return> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const log = (this as any).deps?.log;\n      const startTime = performance.now();\n\n      const config = getConfig();\n      const tracer = config.tracer;\n\n      return tracer.startActiveSpan(operationName, async (span) => {\n        try {\n          log?.info(\n            {\n              operation: operationName,\n              method: methodName,\n              args,\n            },\n            'Operation started',\n          );\n\n          const result = await originalMethod.apply(this, args);\n\n          const duration = performance.now() - startTime;\n          log?.info(\n            {\n              operation: operationName,\n              method: methodName,\n              duration,\n            },\n            'Operation completed',\n          );\n\n          span.setStatus({ code: SpanStatusCode.OK });\n          span.setAttributes({\n            'operation.name': operationName,\n            'operation.method': methodName,\n            'operation.duration': duration,\n            'operation.success': true,\n          });\n\n          return result;\n        } catch (error) {\n          const duration = performance.now() - startTime;\n          log?.error(\n            {\n              err: error instanceof Error ? error : undefined,\n              operation: operationName,\n              method: methodName,\n              duration,\n            },\n            'Operation failed',\n          );\n\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: error instanceof Error ? error.message : 'Unknown error',\n          });\n          span.setAttributes({\n            'operation.name': operationName,\n            'operation.method': methodName,\n            'operation.duration': duration,\n            'operation.success': false,\n            'error.type':\n              error instanceof Error ? error.constructor.name : 'Unknown',\n          });\n\n          throw error;\n        } finally {\n          span.end();\n        }\n      });\n    };\n  };\n}\n\n// ============================================================================\n// Built-in Logger (re-exports)\n// ============================================================================\n\nexport {\n  autotelLogger,\n  createBuiltinLogger,\n  runWithLogLevel,\n  getTraceContext,\n  getActiveLogLevel,\n  type BuiltinLogLevel,\n  type BuiltinLoggerOptions,\n} from './autotel-logger';\n"],"mappings":"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"}
+{"version":3,"file":"logger-thMPLpOG.cjs","names":["api_context","trace","extra","getConfig","SpanStatusCode"],"sources":["../src/autotel-logger.ts","../src/logger.ts"],"sourcesContent":["/**\n * Zero-dependency structured logger for autotel\n *\n * This logger provides:\n * - Structured JSON logging (production) or pretty print (development)\n * - Auto trace context injection (traceId, spanId, correlationId)\n * - Dynamic log level control (per-request via OTel context)\n * - Level support (debug, info, warn, error, none)\n * - Zero additional dependencies (uses @opentelemetry/api, already a dep)\n *\n * Uses Pino-compatible signature supporting both patterns:\n * - `log.info('simple message')` - string-only\n * - `log.info({ userId: '123' }, 'message')` - object first with optional message\n *\n * Used as the default fallback when users don't provide Pino/Bunyan.\n * Can also be used directly: import { createBuiltinLogger } from 'autotel/logger'\n *\n * @example\n * ```typescript\n * import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';\n *\n * const log = createBuiltinLogger('my-service');\n *\n * // Simple message (no metadata)\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n * // Output: {\"level\":\"info\",\"service\":\"my-service\",\"msg\":\"User created\",\"userId\":\"123\",\"traceId\":\"...\"}\n *\n * // Dynamic log level per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will log even if default level is \"info\"');\n * });\n * ```\n */\n\nimport {\n  trace,\n  context as api_context,\n  createContextKey,\n} from '@opentelemetry/api';\nimport type { Logger } from './logger';\n\nexport type BuiltinLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';\n\n/**\n * Context key for storing active log level (enables per-request log levels)\n */\nconst LOG_LEVEL_KEY = createContextKey('autotel-log-level');\n\n/**\n * Get the active log level from context (if set)\n * Falls back to undefined if no log level is set in context\n */\nexport function getActiveLogLevel(): BuiltinLogLevel | undefined {\n  return api_context.active().getValue(LOG_LEVEL_KEY) as\n    BuiltinLogLevel | undefined;\n}\n\n/**\n * Run a function with a specific log level\n * The log level is stored in OpenTelemetry context and applies to all logger calls within the callback\n *\n * @example\n * ```typescript\n * // Enable debug logging for a specific request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will be logged');\n *   processRequest();\n * });\n *\n * // Disable logging temporarily\n * runWithLogLevel('none', () => {\n *   log.info('This will NOT be logged');\n * });\n * ```\n */\nexport function runWithLogLevel<T>(\n  level: BuiltinLogLevel,\n  callback: () => T,\n): T {\n  const ctx = api_context.active().setValue(LOG_LEVEL_KEY, level);\n  return api_context.with(ctx, callback);\n}\n\n/**\n * Get current trace context from active span\n * Returns null if no active span exists\n */\nfunction getTraceContextInternal(): {\n  traceId: string;\n  spanId: string;\n  correlationId: string;\n} | null {\n  const span = trace.getActiveSpan();\n  if (!span) return null;\n\n  const ctx = span.spanContext();\n  return {\n    traceId: ctx.traceId,\n    spanId: ctx.spanId,\n    correlationId: ctx.traceId.slice(0, 16), // First 16 chars for grouping\n  };\n}\n\n/**\n * Helper to get trace context (useful for BYOL - Bring Your Own Logger)\n *\n * @example\n * ```typescript\n * import bunyan from 'bunyan';\n * import { getTraceContext } from 'autotel/logger';\n *\n * const bunyanLogger = bunyan.createLogger({ name: 'myapp' });\n * const ctx = getTraceContext();\n * bunyanLogger.info({ ...ctx, email: 'test@example.com' }, 'Creating user');\n * ```\n */\nexport function getTraceContext() {\n  return getTraceContextInternal();\n}\n\nexport interface BuiltinLoggerOptions {\n  /** Minimum log level. Default: 'info' */\n  level?: BuiltinLogLevel;\n  /** Pretty print for development. Default: false (JSON output) */\n  pretty?: boolean;\n}\n\n/**\n * Create a lightweight structured logger\n *\n * @param service - Service name for logging\n * @param options - Optional configuration\n *\n * @example\n * ```typescript\n * const log = createBuiltinLogger('user-service');\n *\n * log.info('Creating user', { email: 'test@example.com' });\n * // Output: {\"level\":\"info\",\"service\":\"user-service\",\"msg\":\"Creating user\",\n * //          \"email\":\"test@example.com\",\"traceId\":\"...\",\"spanId\":\"...\"}\n *\n * // Dynamic log level control per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('This will be logged even if logger was created with level: \"info\"');\n * });\n * ```\n */\nexport function createBuiltinLogger(\n  service: string,\n  options?: BuiltinLoggerOptions,\n): Logger {\n  const defaultLevel = options?.level || 'info';\n  const pretty = options?.pretty || false;\n\n  const levelPriority: Record<BuiltinLogLevel, number> = {\n    none: -1,\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n  };\n\n  const shouldLog = (level: BuiltinLogLevel): boolean => {\n    // Priority: context level > options level > 'info' default\n    const activeLevel = getActiveLogLevel() ?? defaultLevel;\n\n    // 'none' means suppress all logging\n    if (activeLevel === 'none') return false;\n\n    return levelPriority[level] >= levelPriority[activeLevel];\n  };\n\n  const log = (\n    level: 'info' | 'error' | 'warn' | 'debug',\n    msg: string,\n    attrs?: Record<string, unknown>,\n  ) => {\n    if (!shouldLog(level)) return;\n\n    const ctx = getTraceContextInternal();\n    const logEntry: Record<string, unknown> = {\n      level,\n      service,\n      msg,\n      ...attrs,\n      ...ctx, // Auto-inject traceId, spanId, correlationId\n      timestamp: new Date().toISOString(),\n    };\n\n    if (pretty) {\n      // Pretty print for development\n      const traceInfo = ctx\n        ? ` [${ctx.traceId.slice(0, 8)}.../${ctx.spanId.slice(0, 8)}...]`\n        : '';\n      console.log(\n        `[${level.toUpperCase()}]${traceInfo} ${service}: ${msg}`,\n        attrs || '',\n      );\n    } else {\n      // Structured JSON for production\n      console.log(JSON.stringify(logEntry));\n    }\n  };\n\n  // Pino-compatible signature: supports both:\n  // - logger.info('message') - string-only\n  // - logger.info({ extra }, 'message') - Pino style with metadata\n  // Also auto-detects and handles legacy Winston-style: logger.info('message', { extra })\n  const createLogMethod = (level: 'info' | 'warn' | 'debug') => {\n    return (\n      extraOrMessage: Record<string, unknown> | string,\n      message?: string | Record<string, unknown>,\n    ) => {\n      if (typeof extraOrMessage === 'string') {\n        // First arg is string - could be:\n        // 1. String-only: logger.info('message')\n        // 2. Legacy Winston-style: logger.info('message', { extra })\n        if (message !== undefined && typeof message === 'object') {\n          // Legacy Winston-style detected - auto-swap for backward compatibility\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.${level}('message', metadata). ` +\n                `Autotel recommends Pino signature: logger.${level}({ ...metadata }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          // Swap: treat first arg as message, second as metadata\n          log(level, extraOrMessage, message as Record<string, unknown>);\n        } else {\n          // Pure string-only call: logger.info('message')\n          log(level, extraOrMessage);\n        }\n      } else {\n        // Pino style: logger.info({ extra }, 'message')\n        log(level, (message as string) || '', extraOrMessage);\n      }\n    };\n  };\n\n  return {\n    info: createLogMethod('info'),\n    warn: createLogMethod('warn'),\n    debug: createLogMethod('debug'),\n\n    error: (\n      extraOrMessage: Record<string, unknown> | string,\n      message?: string | Record<string, unknown> | Error,\n    ) => {\n      if (typeof extraOrMessage === 'string') {\n        // First arg is string - could be:\n        // 1. String-only: logger.error('message')\n        // 2. Legacy: logger.error('message', error) - Error as second arg\n        // 3. Legacy: logger.error('message', { extra }) - object as second arg\n\n        // Handle legacy logger.error('message', error) pattern\n        if (message instanceof Error) {\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.error('message', error). ` +\n                `Autotel recommends Pino signature: logger.error({ err: error }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          log('error', extraOrMessage, {\n            error: message.message,\n            stack: message.stack,\n            name: message.name,\n          });\n          return;\n        }\n\n        // Handle legacy logger.error('message', { extra }) pattern\n        if (message !== undefined && typeof message === 'object') {\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[autotel] Legacy logger pattern detected: logger.error('message', metadata). ` +\n                `Autotel recommends Pino signature: logger.error({ ...metadata }, 'message'). ` +\n                `Auto-swapping arguments for compatibility.`,\n            );\n          }\n          // Swap: treat first arg as message, second as metadata (handle err extraction)\n          const extra = message as Record<string, unknown>;\n          const { err, ...rest } = extra as Record<string, unknown> & {\n            err?: unknown;\n          };\n          let errorAttrs: Record<string, unknown> = rest;\n          if (err instanceof Error) {\n            errorAttrs = {\n              error: err.message,\n              stack: err.stack,\n              name: err.name,\n              ...rest,\n            };\n          } else if (err !== undefined) {\n            errorAttrs = { err, ...rest };\n          }\n          log('error', extraOrMessage, errorAttrs);\n          return;\n        }\n\n        // Pure string-only call: logger.error('message')\n        log('error', extraOrMessage);\n        return;\n      }\n\n      // Pino style: logger.error({ err, ...extra }, 'message')\n      // Extract err from extra if present (Pino convention)\n      const { err, ...rest } = extraOrMessage as Record<string, unknown> & {\n        err?: unknown;\n      };\n      let errorAttrs: Record<string, unknown> = rest;\n      if (err instanceof Error) {\n        // err is an Error - extract message, stack, name for structured logging\n        errorAttrs = {\n          error: err.message,\n          stack: err.stack,\n          name: err.name,\n          ...rest,\n        };\n      } else if (err !== undefined) {\n        // err is not an Error but exists - preserve it as-is\n        errorAttrs = {\n          err,\n          ...rest,\n        };\n      }\n      log('error', (message as string) || '', errorAttrs);\n    },\n  };\n}\n\n/**\n * Pino-like factory function for creating an autotel logger\n *\n * @example\n * ```typescript\n * import { autotelLogger } from 'autotel/logger';\n *\n * const log = autotelLogger();\n *\n * // Simple message\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n *\n * // With options\n * const devLog = autotelLogger({ service: 'my-app', level: 'debug', pretty: true });\n * ```\n */\nexport function autotelLogger(options?: {\n  service?: string;\n  level?: BuiltinLogLevel;\n  pretty?: boolean;\n}): Logger {\n  return createBuiltinLogger(options?.service || 'app', {\n    level: options?.level,\n    pretty: options?.pretty,\n  });\n}\n","/**\n * Logger types and utilities for autotel\n *\n * **Zero-Config Option:** Don't provide a logger to `init()` and autotel uses\n * a built-in structured JSON logger with automatic trace context injection.\n *\n * **BYOL (Bring Your Own Logger):** Pass Pino or Bunyan to `init()` for\n * automatic instrumentation with trace context and OTLP log export.\n *\n * ## Logger Signature\n *\n * Autotel v2.10+ uses **Pino's signature**: `logger.info({ metadata }, 'message')`.\n *\n * ### Backward Compatibility\n *\n * The built-in logger auto-detects legacy Winston-style calls and swaps arguments:\n * ```typescript\n * // Legacy (auto-detected and handled)\n * logger.info('User created', { userId: '123' });\n * // → Internally treated as: logger.info({ userId: '123' }, 'User created')\n * // → Logs warning in development, works silently in production\n * ```\n *\n * ### Recommended Usage\n *\n * ```typescript\n * // ✅ Pino-style (preferred)\n * logger.info({ userId: '123' }, 'User created');\n *\n * // ✅ Simple message (no metadata)\n * logger.info('Server started');\n * ```\n *\n * **Note:** If you BYOL (bring your own logger), it must use Pino signature.\n * Winston and other `(message, meta)` loggers are NOT compatible.\n * For Winston, use `@opentelemetry/instrumentation-winston` instead.\n *\n * @example Zero-config (uses built-in logger)\n * ```typescript\n * import { init } from 'autotel';\n *\n * init({ service: 'my-app' });\n * // Internal logs: {\"level\":\"info\",\"service\":\"my-app\",\"msg\":\"...\",\"traceId\":\"...\"}\n * ```\n *\n * @example Using built-in logger directly\n * ```typescript\n * import { createBuiltinLogger, runWithLogLevel } from 'autotel/logger';\n *\n * const log = createBuiltinLogger('my-service');\n *\n * // Simple message (no metadata)\n * log.info('Server started');\n *\n * // With metadata (Pino-style: object first, message second)\n * log.info({ userId: '123' }, 'User created');\n * // Output: {\"level\":\"info\",\"service\":\"my-service\",\"msg\":\"User created\",\"userId\":\"123\",\"traceId\":\"...\"}\n *\n * // Dynamic log level per-request\n * runWithLogLevel('debug', () => {\n *   log.debug('Debug info for this request only');\n * });\n * ```\n *\n * @example Using Pino (recommended for production, auto-instrumented)\n * ```typescript\n * import pino from 'pino';  // npm install pino\n * import { init } from 'autotel';\n *\n * const logger = pino({ level: 'info' });\n * init({ service: 'my-app', logger });\n *\n * // Logs automatically include traceId/spanId and export via OTLP!\n * logger.info({ userId: '123' }, 'User created');\n * ```\n *\n * @example Using Bunyan (auto-instrumented, same signature as Pino)\n * ```typescript\n * import bunyan from 'bunyan';  // npm install bunyan @opentelemetry/instrumentation-bunyan\n * import { init } from 'autotel';\n * import { BunyanInstrumentation } from '@opentelemetry/instrumentation-bunyan';\n *\n * const logger = bunyan.createLogger({ name: 'my-app' });\n * init({\n *   service: 'my-app',\n *   logger,\n *   instrumentations: [new BunyanInstrumentation()]\n * });\n * ```\n *\n * @example Custom logger (MUST use Pino-compatible signature)\n * ```typescript\n * // ⚠️ Your custom logger MUST accept (object, message?) signature\n * const logger = {\n *   info: (extra, msg) => console.log(msg || '', extra),\n *   warn: (extra, msg) => console.warn(msg || '', extra),\n *   error: (extra, msg) => console.error(msg || '', extra),\n *   debug: (extra, msg) => console.debug(msg || '', extra),\n * };\n * init({ service: 'my-app', logger });\n * ```\n *\n * @example BYOL helper: inject trace context into any logger\n * ```typescript\n * import bunyan from 'bunyan';\n * import { getTraceContext } from 'autotel/logger';\n *\n * const bunyanLogger = bunyan.createLogger({ name: 'myapp' });\n * const ctx = getTraceContext();\n * bunyanLogger.info({ ...ctx, userId: '123' }, 'Creating user');\n * ```\n */\n\nimport { SpanStatusCode } from '@opentelemetry/api';\nimport { getConfig } from './config';\n\n// ============================================================================\n// Logger Types\n// ============================================================================\n\n/**\n * Log level constants\n */\nexport const LOG_LEVEL = {\n  DEBUG: 'debug',\n  INFO: 'info',\n  WARN: 'warn',\n  ERROR: 'error',\n} as const;\n\nexport type LogLevel = (typeof LOG_LEVEL)[keyof typeof LOG_LEVEL];\n\n/**\n * Logger configuration (for reference - not needed with BYOL approach)\n */\nexport interface LoggerConfig {\n  service: string;\n  level?: LogLevel;\n  pretty?: boolean;\n  redact?: string[] | false;\n}\n\n/**\n * Pino-compatible log function signature\n *\n * Matches Pino's actual LogFn type which supports:\n * - `(msg: string)` - simple string message\n * - `(obj: object, msg?: string)` - object first with optional message\n *\n * @example\n * ```typescript\n * logger.info('User logged in');\n * logger.info({ userId: '123' }, 'User created');\n * logger.error({ err: error }, 'Operation failed');\n * ```\n */\nexport interface LogFn {\n  (msg: string): void;\n  (obj: Record<string, unknown>, msg?: string): void;\n}\n\n/**\n * Simple logger interface - Pino/Bunyan-compatible\n *\n * Uses Pino's LogFn signature which supports both:\n * - `logger.info('message')` - simple string message\n * - `logger.info({ extra }, 'message')` - object first with optional message\n *\n * This is compatible with Pino, Bunyan, and any logger following this pattern.\n *\n * @example Using Pino (just works!)\n * ```typescript\n * import pino from 'pino';\n * const logger = pino({ level: 'info' });\n * init({ service: 'my-app', logger });\n * ```\n *\n * @example Direct usage\n * ```typescript\n * logger.info('Simple message');\n * logger.info({ userId: '123' }, 'User created');\n * logger.error({ err: error }, 'Operation failed');\n * ```\n */\nexport interface Logger {\n  info: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  debug: LogFn;\n}\n\n/**\n * Alias for Logger interface (backwards compatibility)\n * @deprecated Use Logger instead\n */\nexport type ILogger = Logger;\n\n/**\n * Pino logger type - re-exported for convenience\n *\n * Note: This is a type-only export. To use Pino, install it as a peer dependency:\n * `npm install pino`\n */\nexport type { Logger as PinoLogger } from 'pino';\n\n// ============================================================================\n// LoggedOperation Decorator\n// ============================================================================\n\nexport interface LoggedOperationOptions {\n  /** Operation name for tracing (e.g., 'user.createUser') */\n  operationName: string;\n}\n\n/**\n * TS5+ Standard Decorator for logging and tracing operations\n * Uses TC39 Stage 3 decorator syntax\n *\n * This is the traditional per-method decorator approach.\n * For zero-boilerplate solution, see @Instrumented class decorator.\n *\n * @example\n * // Simple usage (Pino-style: object first, message second)\n * class OrderService {\n *   constructor(private readonly deps: { log: Logger }) {}\n *\n *   @LoggedOperation('order.create')\n *   async createOrder(data: CreateOrderData) {\n *     // ✅ Correct Pino-style logging\n *     this.deps.log.info({ orderId: data.id }, 'Creating order');\n *   }\n * }\n *\n * // Advanced usage (future-proof for options)\n * @LoggedOperation({ operationName: 'order.create' })\n * async createOrder(data: CreateOrderData) { }\n */\nexport function LoggedOperation(\n  operationNameOrOptions: string | LoggedOperationOptions,\n) {\n  const operationName =\n    typeof operationNameOrOptions === 'string'\n      ? operationNameOrOptions\n      : operationNameOrOptions.operationName;\n\n  return function <This, Args extends unknown[], Return>(\n    originalMethod: (this: This, ...args: Args) => Promise<Return>,\n    context: ClassMethodDecoratorContext<\n      This,\n      (this: This, ...args: Args) => Promise<Return>\n    >,\n  ) {\n    const methodName = String(context.name);\n\n    return async function (this: This, ...args: Args): Promise<Return> {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const log = (this as any).deps?.log;\n      const startTime = performance.now();\n\n      const config = getConfig();\n      const tracer = config.tracer;\n\n      return tracer.startActiveSpan(operationName, async (span) => {\n        try {\n          log?.info(\n            {\n              operation: operationName,\n              method: methodName,\n              args,\n            },\n            'Operation started',\n          );\n\n          const result = await originalMethod.apply(this, args);\n\n          const duration = performance.now() - startTime;\n          log?.info(\n            {\n              operation: operationName,\n              method: methodName,\n              duration,\n            },\n            'Operation completed',\n          );\n\n          span.setStatus({ code: SpanStatusCode.OK });\n          span.setAttributes({\n            'operation.name': operationName,\n            'operation.method': methodName,\n            'operation.duration': duration,\n            'operation.success': true,\n          });\n\n          return result;\n        } catch (error) {\n          const duration = performance.now() - startTime;\n          log?.error(\n            {\n              err: error instanceof Error ? error : undefined,\n              operation: operationName,\n              method: methodName,\n              duration,\n            },\n            'Operation failed',\n          );\n\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: error instanceof Error ? error.message : 'Unknown error',\n          });\n          span.setAttributes({\n            'operation.name': operationName,\n            'operation.method': methodName,\n            'operation.duration': duration,\n            'operation.success': false,\n            'error.type':\n              error instanceof Error ? error.constructor.name : 'Unknown',\n          });\n\n          throw error;\n        } finally {\n          span.end();\n        }\n      });\n    };\n  };\n}\n\n// ============================================================================\n// Built-in Logger (re-exports)\n// ============================================================================\n\nexport {\n  autotelLogger,\n  createBuiltinLogger,\n  runWithLogLevel,\n  getTraceContext,\n  getActiveLogLevel,\n  type BuiltinLogLevel,\n  type BuiltinLoggerOptions,\n} from './autotel-logger';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,MAAM,yDAAiC,mBAAmB;;;;;AAM1D,SAAgB,oBAAiD;CAC/D,OAAOA,2BAAY,OAAO,CAAC,CAAC,SAAS,aAAa;AAEpD;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,gBACd,OACA,UACG;CACH,MAAM,MAAMA,2BAAY,OAAO,CAAC,CAAC,SAAS,eAAe,KAAK;CAC9D,OAAOA,2BAAY,KAAK,KAAK,QAAQ;AACvC;;;;;AAMA,SAAS,0BAIA;CACP,MAAM,OAAOC,yBAAM,cAAc;CACjC,IAAI,CAAC,MAAM,OAAO;CAElB,MAAM,MAAM,KAAK,YAAY;CAC7B,OAAO;EACL,SAAS,IAAI;EACb,QAAQ,IAAI;EACZ,eAAe,IAAI,QAAQ,MAAM,GAAG,EAAE;CACxC;AACF;;;;;;;;;;;;;;AAeA,SAAgB,kBAAkB;CAChC,OAAO,wBAAwB;AACjC;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,oBACd,SACA,SACQ;CACR,MAAM,eAAe,SAAS,SAAS;CACvC,MAAM,SAAS,SAAS,UAAU;CAElC,MAAM,gBAAiD;EACrD,MAAM;EACN,OAAO;EACP,MAAM;EACN,MAAM;EACN,OAAO;CACT;CAEA,MAAM,aAAa,UAAoC;EAErD,MAAM,cAAc,kBAAkB,KAAK;EAG3C,IAAI,gBAAgB,QAAQ,OAAO;EAEnC,OAAO,cAAc,UAAU,cAAc;CAC/C;CAEA,MAAM,OACJ,OACA,KACA,UACG;EACH,IAAI,CAAC,UAAU,KAAK,GAAG;EAEvB,MAAM,MAAM,wBAAwB;EACpC,MAAM,WAAoC;GACxC;GACA;GACA;GACA,GAAG;GACH,GAAG;GACH,4BAAW,IAAI,KAAK,EAAC,CAAC,YAAY;EACpC;EAEA,IAAI,QAAQ;GAEV,MAAM,YAAY,MACd,KAAK,IAAI,QAAQ,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,OAAO,MAAM,GAAG,CAAC,EAAE,QAC1D;GACJ,QAAQ,IACN,IAAI,MAAM,YAAY,EAAE,GAAG,UAAU,GAAG,QAAQ,IAAI,OACpD,SAAS,EACX;EACF,OAEE,QAAQ,IAAI,KAAK,UAAU,QAAQ,CAAC;CAExC;CAMA,MAAM,mBAAmB,UAAqC;EAC5D,QACE,gBACA,YACG;GACH,IAAI,OAAO,mBAAmB,UAI5B,IAAI,YAAY,UAAa,OAAO,YAAY,UAAU;IAExD,IAAI,QAAQ,IAAI,aAAa,cAC3B,QAAQ,KACN,oDAAoD,MAAM,mEACX,MAAM,yEAEvD;IAGF,IAAI,OAAO,gBAAgB,OAAkC;GAC/D,OAEE,IAAI,OAAO,cAAc;QAI3B,IAAI,OAAQ,WAAsB,IAAI,cAAc;EAExD;CACF;CAEA,OAAO;EACL,MAAM,gBAAgB,MAAM;EAC5B,MAAM,gBAAgB,MAAM;EAC5B,OAAO,gBAAgB,OAAO;EAE9B,QACE,gBACA,YACG;GACH,IAAI,OAAO,mBAAmB,UAAU;IAOtC,IAAI,mBAAmB,OAAO;KAC5B,IAAI,QAAQ,IAAI,aAAa,cAC3B,QAAQ,KACN,kMAGF;KAEF,IAAI,SAAS,gBAAgB;MAC3B,OAAO,QAAQ;MACf,OAAO,QAAQ;MACf,MAAM,QAAQ;KAChB,CAAC;KACD;IACF;IAGA,IAAI,YAAY,UAAa,OAAO,YAAY,UAAU;KACxD,IAAI,QAAQ,IAAI,aAAa,cAC3B,QAAQ,KACN,sMAGF;KAIF,MAAM,EAAE,KAAK,GAAG,SAASC;KAGzB,IAAI,aAAsC;KAC1C,IAAI,eAAe,OACjB,aAAa;MACX,OAAO,IAAI;MACX,OAAO,IAAI;MACX,MAAM,IAAI;MACV,GAAG;KACL;UACK,IAAI,QAAQ,QACjB,aAAa;MAAE;MAAK,GAAG;KAAK;KAE9B,IAAI,SAAS,gBAAgB,UAAU;KACvC;IACF;IAGA,IAAI,SAAS,cAAc;IAC3B;GACF;GAIA,MAAM,EAAE,KAAK,GAAG,SAAS;GAGzB,IAAI,aAAsC;GAC1C,IAAI,eAAe,OAEjB,aAAa;IACX,OAAO,IAAI;IACX,OAAO,IAAI;IACX,MAAM,IAAI;IACV,GAAG;GACL;QACK,IAAI,QAAQ,QAEjB,aAAa;IACX;IACA,GAAG;GACL;GAEF,IAAI,SAAU,WAAsB,IAAI,UAAU;EACpD;CACF;AACF;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cAAc,SAInB;CACT,OAAO,oBAAoB,SAAS,WAAW,OAAO;EACpD,OAAO,SAAS;EAChB,QAAQ,SAAS;CACnB,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC/OA,MAAa,YAAY;CACvB,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;AA6GA,SAAgB,gBACd,wBACA;CACA,MAAM,gBACJ,OAAO,2BAA2B,WAC9B,yBACA,uBAAuB;CAE7B,OAAO,SACL,gBACA,SAIA;EACA,MAAM,aAAa,OAAO,QAAQ,IAAI;EAEtC,OAAO,eAA4B,GAAG,MAA6B;GAEjE,MAAM,MAAO,KAAa,MAAM;GAChC,MAAM,YAAY,YAAY,IAAI;GAKlC,OAHeC,yBACK,CAAC,CAAC,OAER,gBAAgB,eAAe,OAAO,SAAS;IAC3D,IAAI;KACF,KAAK,KACH;MACE,WAAW;MACX,QAAQ;MACR;KACF,GACA,mBACF;KAEA,MAAM,SAAS,MAAM,eAAe,MAAM,MAAM,IAAI;KAEpD,MAAM,WAAW,YAAY,IAAI,IAAI;KACrC,KAAK,KACH;MACE,WAAW;MACX,QAAQ;MACR;KACF,GACA,qBACF;KAEA,KAAK,UAAU,EAAE,MAAMC,kCAAe,GAAG,CAAC;KAC1C,KAAK,cAAc;MACjB,kBAAkB;MAClB,oBAAoB;MACpB,sBAAsB;MACtB,qBAAqB;KACvB,CAAC;KAED,OAAO;IACT,SAAS,OAAO;KACd,MAAM,WAAW,YAAY,IAAI,IAAI;KACrC,KAAK,MACH;MACE,KAAK,iBAAiB,QAAQ,QAAQ;MACtC,WAAW;MACX,QAAQ;MACR;KACF,GACA,kBACF;KAEA,KAAK,UAAU;MACb,MAAMA,kCAAe;MACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;KACpD,CAAC;KACD,KAAK,cAAc;MACjB,kBAAkB;MAClB,oBAAoB;MACpB,sBAAsB;MACtB,qBAAqB;MACrB,cACE,iBAAiB,QAAQ,MAAM,YAAY,OAAO;KACtD,CAAC;KAED,MAAM;IACR,UAAU;KACR,KAAK,IAAI;IACX;GACF,CAAC;EACH;CACF;AACF"}

package/dist/logger.d.cts

@@ -1,2 +1,2 @@
-import { a as LoggedOperation, c as LoggerConfig, d as BuiltinLoggerOptions, f as autotelLogger, g as runWithLogLevel, h as getTraceContext, i as LogLevel, l as PinoLogger, m as getActiveLogLevel, n as LOG_LEVEL, o as LoggedOperationOptions, p as createBuiltinLogger, r as LogFn, s as Logger, t as ILogger, u as BuiltinLogLevel } from "./logger-BauSUhUv.cjs";
+import { a as LoggedOperation, c as LoggerConfig, d as BuiltinLoggerOptions, f as autotelLogger, g as runWithLogLevel, h as getTraceContext, i as LogLevel, l as PinoLogger, m as getActiveLogLevel, n as LOG_LEVEL, o as LoggedOperationOptions, p as createBuiltinLogger, r as LogFn, s as Logger, t as ILogger, u as BuiltinLogLevel } from "./logger-CN4xpzMd.cjs";
 export { type BuiltinLogLevel, type BuiltinLoggerOptions, ILogger, LOG_LEVEL, LogFn, LogLevel, LoggedOperation, LoggedOperationOptions, Logger, LoggerConfig, type PinoLogger, autotelLogger, createBuiltinLogger, getActiveLogLevel, getTraceContext, runWithLogLevel };

package/dist/logger.d.ts

@@ -1,2 +1,2 @@
-import { a as LoggedOperation, c as LoggerConfig, d as BuiltinLoggerOptions, f as autotelLogger, g as runWithLogLevel, h as getTraceContext, i as LogLevel, l as PinoLogger, m as getActiveLogLevel, n as LOG_LEVEL, o as LoggedOperationOptions, p as createBuiltinLogger, r as LogFn, s as Logger, t as ILogger, u as BuiltinLogLevel } from "./logger-BauSUhUv.js";
+import { a as LoggedOperation, c as LoggerConfig, d as BuiltinLoggerOptions, f as autotelLogger, g as runWithLogLevel, h as getTraceContext, i as LogLevel, l as PinoLogger, m as getActiveLogLevel, n as LOG_LEVEL, o as LoggedOperationOptions, p as createBuiltinLogger, r as LogFn, s as Logger, t as ILogger, u as BuiltinLogLevel } from "./logger-CN4xpzMd.js";
 export { type BuiltinLogLevel, type BuiltinLoggerOptions, ILogger, LOG_LEVEL, LogFn, LogLevel, LoggedOperation, LoggedOperationOptions, Logger, LoggerConfig, type PinoLogger, autotelLogger, createBuiltinLogger, getActiveLogLevel, getTraceContext, runWithLogLevel };

package/dist/messaging-adapters.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-adapters.cjs","names":["natsMsg","TraceFlags"],"sources":["../src/messaging-adapters.ts"],"sourcesContent":["/**\n * Pre-built adapter configurations for common messaging systems.\n *\n * These adapters provide ready-to-use hook configurations for systems\n * not explicitly supported by the core messaging module. Use them with\n * traceProducer/traceConsumer to get system-specific attributes.\n *\n * @example NATS consumer\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { natsAdapter } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg) => {\n *   // msg.subject, msg.info.stream are now captured as span attributes\n *   await handleOrder(msg.data);\n * });\n * ```\n *\n * @example Datadog context propagation\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { datadogContextExtractor } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Parent span from Datadog trace headers is linked\n * });\n * ```\n *\n * @module\n */\n\nimport type { AttributeValue, SpanContext } from '@opentelemetry/api';\nimport { TraceFlags } from '@opentelemetry/api';\nimport type { ProducerContext, ConsumerContext } from './messaging';\n\n// ============================================================================\n// Adapter Types\n// ============================================================================\n\n/**\n * Producer adapter configuration\n */\nexport interface ProducerAdapter {\n  /**\n   * Hook to add system-specific attributes to producer spans\n   */\n  customAttributes?: (\n    ctx: ProducerContext,\n    args: unknown[],\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to inject custom headers beyond W3C traceparent\n   */\n  customHeaders?: (ctx: ProducerContext) => Record<string, string>;\n}\n\n/**\n * Consumer adapter configuration\n */\nexport interface ConsumerAdapter {\n  /**\n   * Extract headers from the message for trace context propagation\n   */\n  headersFrom?: (msg: unknown) => Record<string, string> | undefined;\n\n  /**\n   * Hook to add system-specific attributes to consumer spans\n   */\n  customAttributes?: (\n    ctx: ConsumerContext,\n    msg: unknown,\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to extract parent span context from non-W3C header formats\n   */\n  customContextExtractor?: (\n    headers: Record<string, string>,\n  ) => SpanContext | null;\n}\n\n/**\n * Combined producer and consumer adapter\n */\nexport interface MessagingAdapter {\n  producer?: ProducerAdapter;\n  consumer?: ConsumerAdapter;\n}\n\n// ============================================================================\n// NATS JetStream Adapter\n// ============================================================================\n\n/**\n * NATS JetStream message type (for reference)\n *\n * @internal Not exported - users bring their own NATS types\n */\ninterface NatsJetStreamMsg {\n  subject: string;\n  reply?: string;\n  data: Uint8Array;\n  headers?: {\n    /** Convert headers to plain object (some NATS implementations) */\n    toJSON?: () => Record<string, string> | unknown;\n    /** Get a header value by key (Headers-like interface) */\n    get?: (key: string) => string | undefined;\n    /** Iterate over header entries */\n    entries?: () => Iterable<[string, string]>;\n  };\n  info?: {\n    stream: string;\n    consumer: string;\n    redeliveryCount?: number;\n    pending?: number;\n    timestampNanos?: bigint;\n  };\n}\n\n/**\n * NATS JetStream adapter\n *\n * Captures NATS-specific attributes following NATS observability conventions.\n *\n * @example Producer\n * ```typescript\n * const publishOrder = traceProducer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   ...natsAdapter.producer,\n * })(ctx => async (subject, payload, opts) => {\n *   const headers = ctx.getTraceHeaders();\n *   await nc.publish(subject, payload, { headers });\n * });\n * ```\n *\n * @example Consumer\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   consumerGroup: 'order-processor',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg: JsMsg) => {\n *   await handleOrder(msg.data);\n *   msg.ack();\n * });\n * ```\n */\nexport const natsAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const msg = args[0] as\n        | { subject?: string; replyTo?: string; stream?: string }\n        | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (msg?.subject) attrs['nats.subject'] = msg.subject;\n      if (msg?.replyTo) attrs['nats.reply_to'] = msg.replyTo;\n      if (msg?.stream) attrs['nats.stream'] = msg.stream;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    headersFrom: (msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const headers = natsMsg.headers;\n\n      if (!headers) return;\n\n      // Try toJSON() first (some NATS implementations)\n      if (typeof headers.toJSON === 'function') {\n        const json = headers.toJSON();\n        if (json && typeof json === 'object') {\n          return json as Record<string, string>;\n        }\n      }\n\n      // Fallback: use .get() for common trace headers\n      // This handles Headers-like objects that only expose .get()\n      if (typeof headers.get === 'function') {\n        const result: Record<string, string> = {};\n        const traceHeaders = [\n          'traceparent',\n          'tracestate',\n          'baggage',\n          'x-b3-traceid',\n          'x-b3-spanid',\n          'x-b3-sampled',\n          'b3',\n        ];\n        for (const key of traceHeaders) {\n          const value = headers.get(key);\n          if (value) {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      // Fallback: try to iterate if it's iterable (e.g., entries())\n      if (typeof headers.entries === 'function') {\n        const result: Record<string, string> = {};\n        for (const [key, value] of headers.entries()) {\n          if (typeof key === 'string' && typeof value === 'string') {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      return;\n    },\n    customAttributes: (_ctx, msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (natsMsg.subject) attrs['nats.subject'] = natsMsg.subject;\n      if (natsMsg.reply) attrs['nats.reply_to'] = natsMsg.reply;\n      if (natsMsg.info?.stream) attrs['nats.stream'] = natsMsg.info.stream;\n      if (natsMsg.info?.consumer)\n        attrs['nats.consumer'] = natsMsg.info.consumer;\n      if (natsMsg.info?.redeliveryCount !== undefined) {\n        attrs['nats.delivered_count'] = natsMsg.info.redeliveryCount;\n      }\n      if (natsMsg.info?.pending !== undefined) {\n        attrs['nats.pending'] = natsMsg.info.pending;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Temporal Adapter\n// ============================================================================\n\n/**\n * Temporal activity/workflow info type (for reference)\n *\n * @internal Not exported - users bring their own Temporal types\n */\ninterface TemporalActivityInfo {\n  workflowId?: string;\n  runId?: string;\n  activityId?: string;\n  taskQueue?: string;\n  attempt?: number;\n  workflowType?: string;\n  activityType?: string;\n  startToCloseTimeout?: string;\n  scheduleToCloseTimeout?: string;\n}\n\n/**\n * Temporal adapter\n *\n * Captures Temporal-specific attributes for workflow activities.\n * Use this when instrumenting Temporal activity handlers.\n *\n * @example Activity handler\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'temporal',\n *   destination: 'order-activities',\n *   ...temporalAdapter.consumer,\n * })(ctx => async (info: ActivityInfo, input: OrderInput) => {\n *   // Temporal attributes are captured automatically\n *   return processOrderLogic(input);\n * });\n * ```\n *\n * @example Workflow signal/query\n * ```typescript\n * const sendSignal = traceProducer({\n *   system: 'temporal',\n *   destination: 'order-signals',\n *   ...temporalAdapter.producer,\n * })(ctx => async (workflowId, signalName, payload) => {\n *   await client.workflow.signal(workflowId, signalName, payload);\n * });\n * ```\n */\nexport const temporalAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const info = args[0] as TemporalActivityInfo | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info?.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info?.runId) attrs['temporal.run_id'] = info.runId;\n      if (info?.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info?.workflowType)\n        attrs['temporal.workflow_type'] = info.workflowType;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const info = msg as TemporalActivityInfo;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info.runId) attrs['temporal.run_id'] = info.runId;\n      if (info.activityId) attrs['temporal.activity_id'] = info.activityId;\n      if (info.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info.attempt !== undefined) attrs['temporal.attempt'] = info.attempt;\n      if (info.activityType)\n        attrs['temporal.activity_type'] = info.activityType;\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Cloudflare Queues Adapter\n// ============================================================================\n\n/**\n * Cloudflare Queue message type (for reference)\n *\n * @internal Not exported - users bring their own Cloudflare types\n */\ninterface CloudflareQueueMessage {\n  id: string;\n  timestamp: Date;\n  body: unknown;\n  attempts: number;\n}\n\n/**\n * Cloudflare Queues adapter\n *\n * Captures Cloudflare Queue-specific attributes.\n *\n * @example Queue consumer\n * ```typescript\n * export default {\n *   async queue(batch: MessageBatch, env: Env) {\n *     for (const msg of batch.messages) {\n *       await processMessage(msg);\n *     }\n *   },\n * };\n *\n * const processMessage = traceConsumer({\n *   system: 'cloudflare_queues',\n *   destination: 'my-queue',\n *   ...cloudflareQueuesAdapter.consumer,\n * })(ctx => async (msg: Message) => {\n *   await handleMessage(msg.body);\n *   msg.ack();\n * });\n * ```\n */\nexport const cloudflareQueuesAdapter: MessagingAdapter = {\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const cfMsg = msg as CloudflareQueueMessage;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (cfMsg.id) attrs['cloudflare.queue.message_id'] = cfMsg.id;\n      if (cfMsg.timestamp) {\n        attrs['cloudflare.queue.timestamp_ms'] = cfMsg.timestamp.getTime();\n      }\n      if (cfMsg.attempts !== undefined) {\n        attrs['cloudflare.queue.attempts'] = cfMsg.attempts;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Context Extractors for Non-W3C Formats\n// ============================================================================\n\n/**\n * Datadog trace context extractor\n *\n * Extracts parent span context from Datadog-format trace headers.\n * Converts Datadog's decimal IDs to OpenTelemetry's hex format.\n *\n * Note: Datadog sends trace/span IDs as decimal strings, not hex.\n * This extractor converts decimal -> hex before formatting for OTel.\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Datadog span automatically\n * });\n * ```\n */\nexport function datadogContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const traceIdDecimal = headers['x-datadog-trace-id'];\n  const spanIdDecimal = headers['x-datadog-parent-id'];\n  const samplingPriority = headers['x-datadog-sampling-priority'];\n\n  if (!traceIdDecimal || !spanIdDecimal) return null;\n\n  // Datadog sends IDs as decimal strings - convert to hex\n  // Use BigInt for 64-bit values that exceed Number.MAX_SAFE_INTEGER\n  let otelTraceId: string;\n  let otelSpanId: string;\n\n  try {\n    // Convert decimal to hex and pad to OTel format\n    // OTel trace IDs are 32 hex chars (128-bit), Datadog uses 64-bit\n    otelTraceId = BigInt(traceIdDecimal).toString(16).padStart(32, '0');\n    // OTel span IDs are 16 hex chars (64-bit)\n    otelSpanId = BigInt(spanIdDecimal).toString(16).padStart(16, '0');\n  } catch {\n    // Invalid decimal string\n    return null;\n  }\n\n  // Sampling priority > 0 means sampled\n  const sampled = samplingPriority\n    ? Number.parseInt(samplingPriority, 10) > 0\n    : true;\n\n  return {\n    traceId: otelTraceId,\n    spanId: otelSpanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * B3 (Zipkin) trace context extractor\n *\n * Extracts parent span context from B3 format headers.\n * Supports both single-header (b3) and multi-header formats.\n *\n * @see https://github.com/openzipkin/b3-propagation\n *\n * @example Single-header format\n * ```typescript\n * // Header: b3: 80f198ee56343ba864fe8b2a57d3eff7-e457b5a2e4d86bd1-1\n * const processMessage = traceConsumer({\n *   system: 'rabbitmq',\n *   destination: 'events',\n *   customContextExtractor: b3ContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Zipkin span\n * });\n * ```\n *\n * @example Multi-header format\n * ```typescript\n * // Headers: X-B3-TraceId, X-B3-SpanId, X-B3-Sampled\n * ```\n */\nexport function b3ContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  // Try single-header format first: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}\n  const b3Single = headers['b3'] || headers['B3'];\n  if (b3Single) {\n    // Handle \"0\" (not sampled, no trace) case\n    if (b3Single === '0') return null;\n\n    const parts = b3Single.split('-');\n    const traceId = parts[0];\n    const spanId = parts[1];\n    const sampledFlag = parts[2];\n\n    if (traceId && spanId) {\n      const sampled = sampledFlag !== '0' && sampledFlag !== 'd';\n\n      return {\n        traceId: traceId.padStart(32, '0'),\n        spanId: spanId.padStart(16, '0'),\n        traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n        isRemote: true,\n      };\n    }\n  }\n\n  // Fall back to multi-header format\n  const traceId =\n    headers['x-b3-traceid'] ||\n    headers['X-B3-TraceId'] ||\n    headers['X-B3-Traceid'];\n  const spanId =\n    headers['x-b3-spanid'] || headers['X-B3-SpanId'] || headers['X-B3-Spanid'];\n  const sampledHeader =\n    headers['x-b3-sampled'] ||\n    headers['X-B3-Sampled'] ||\n    headers['x-b3-flags'] ||\n    headers['X-B3-Flags'];\n\n  if (!traceId || !spanId) return null;\n\n  // x-b3-sampled: \"1\" or \"true\" = sampled, \"0\" or \"false\" = not sampled\n  // x-b3-flags: \"1\" = debug (implies sampled)\n  const sampled =\n    sampledHeader === '1' ||\n    sampledHeader === 'true' ||\n    sampledHeader === undefined; // Default to sampled if not specified\n\n  return {\n    traceId: traceId.padStart(32, '0'),\n    spanId: spanId.padStart(16, '0'),\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * AWS X-Ray trace context extractor\n *\n * Extracts parent span context from AWS X-Ray trace header.\n * Format: Root=1-{timestamp}-{random};Parent={parent-id};Sampled={0|1}\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'sqs',\n *   destination: 'my-queue',\n *   customContextExtractor: xrayContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent X-Ray trace\n * });\n * ```\n */\nexport function xrayContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const xrayHeader = headers['x-amzn-trace-id'] || headers['X-Amzn-Trace-Id'];\n\n  if (!xrayHeader) return null;\n\n  // Parse: Root=1-{8-char-timestamp}-{24-char-random};Parent={16-char-parent};Sampled=1\n  const rootMatch = xrayHeader.match(/Root=1-([a-f0-9]{8})-([a-f0-9]{24})/i);\n  const parentMatch = xrayHeader.match(/Parent=([a-f0-9]{16})/i);\n  const sampledMatch = xrayHeader.match(/Sampled=([01])/);\n\n  if (!rootMatch || !parentMatch) return null;\n\n  // X-Ray trace ID format: 1-{timestamp}-{random} -> OTel: {timestamp}{random}\n  const timestamp = rootMatch[1];\n  const random = rootMatch[2];\n  const parentId = parentMatch[1];\n\n  if (!timestamp || !random || !parentId) return null;\n\n  const traceId = `${timestamp}${random}`;\n  const spanId = parentId;\n  const sampled = sampledMatch ? sampledMatch[1] === '1' : true;\n\n  return {\n    traceId,\n    spanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"messaging-adapters.cjs","names":["natsMsg","TraceFlags"],"sources":["../src/messaging-adapters.ts"],"sourcesContent":["/**\n * Pre-built adapter configurations for common messaging systems.\n *\n * These adapters provide ready-to-use hook configurations for systems\n * not explicitly supported by the core messaging module. Use them with\n * traceProducer/traceConsumer to get system-specific attributes.\n *\n * @example NATS consumer\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { natsAdapter } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg) => {\n *   // msg.subject, msg.info.stream are now captured as span attributes\n *   await handleOrder(msg.data);\n * });\n * ```\n *\n * @example Datadog context propagation\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { datadogContextExtractor } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Parent span from Datadog trace headers is linked\n * });\n * ```\n *\n * @module\n */\n\nimport type { AttributeValue, SpanContext } from '@opentelemetry/api';\nimport { TraceFlags } from '@opentelemetry/api';\nimport type { ProducerContext, ConsumerContext } from './messaging';\n\n// ============================================================================\n// Adapter Types\n// ============================================================================\n\n/**\n * Producer adapter configuration\n */\nexport interface ProducerAdapter {\n  /**\n   * Hook to add system-specific attributes to producer spans\n   */\n  customAttributes?: (\n    ctx: ProducerContext,\n    args: unknown[],\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to inject custom headers beyond W3C traceparent\n   */\n  customHeaders?: (ctx: ProducerContext) => Record<string, string>;\n}\n\n/**\n * Consumer adapter configuration\n */\nexport interface ConsumerAdapter {\n  /**\n   * Extract headers from the message for trace context propagation\n   */\n  headersFrom?: (msg: unknown) => Record<string, string> | undefined;\n\n  /**\n   * Hook to add system-specific attributes to consumer spans\n   */\n  customAttributes?: (\n    ctx: ConsumerContext,\n    msg: unknown,\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to extract parent span context from non-W3C header formats\n   */\n  customContextExtractor?: (\n    headers: Record<string, string>,\n  ) => SpanContext | null;\n}\n\n/**\n * Combined producer and consumer adapter\n */\nexport interface MessagingAdapter {\n  producer?: ProducerAdapter;\n  consumer?: ConsumerAdapter;\n}\n\n// ============================================================================\n// NATS JetStream Adapter\n// ============================================================================\n\n/**\n * NATS JetStream message type (for reference)\n *\n * @internal Not exported - users bring their own NATS types\n */\ninterface NatsJetStreamMsg {\n  subject: string;\n  reply?: string;\n  data: Uint8Array;\n  headers?: {\n    /** Convert headers to plain object (some NATS implementations) */\n    toJSON?: () => Record<string, string> | unknown;\n    /** Get a header value by key (Headers-like interface) */\n    get?: (key: string) => string | undefined;\n    /** Iterate over header entries */\n    entries?: () => Iterable<[string, string]>;\n  };\n  info?: {\n    stream: string;\n    consumer: string;\n    redeliveryCount?: number;\n    pending?: number;\n    timestampNanos?: bigint;\n  };\n}\n\n/**\n * NATS JetStream adapter\n *\n * Captures NATS-specific attributes following NATS observability conventions.\n *\n * @example Producer\n * ```typescript\n * const publishOrder = traceProducer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   ...natsAdapter.producer,\n * })(ctx => async (subject, payload, opts) => {\n *   const headers = ctx.getTraceHeaders();\n *   await nc.publish(subject, payload, { headers });\n * });\n * ```\n *\n * @example Consumer\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   consumerGroup: 'order-processor',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg: JsMsg) => {\n *   await handleOrder(msg.data);\n *   msg.ack();\n * });\n * ```\n */\nexport const natsAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const msg = args[0] as\n        { subject?: string; replyTo?: string; stream?: string } | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (msg?.subject) attrs['nats.subject'] = msg.subject;\n      if (msg?.replyTo) attrs['nats.reply_to'] = msg.replyTo;\n      if (msg?.stream) attrs['nats.stream'] = msg.stream;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    headersFrom: (msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const headers = natsMsg.headers;\n\n      if (!headers) return;\n\n      // Try toJSON() first (some NATS implementations)\n      if (typeof headers.toJSON === 'function') {\n        const json = headers.toJSON();\n        if (json && typeof json === 'object') {\n          return json as Record<string, string>;\n        }\n      }\n\n      // Fallback: use .get() for common trace headers\n      // This handles Headers-like objects that only expose .get()\n      if (typeof headers.get === 'function') {\n        const result: Record<string, string> = {};\n        const traceHeaders = [\n          'traceparent',\n          'tracestate',\n          'baggage',\n          'x-b3-traceid',\n          'x-b3-spanid',\n          'x-b3-sampled',\n          'b3',\n        ];\n        for (const key of traceHeaders) {\n          const value = headers.get(key);\n          if (value) {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      // Fallback: try to iterate if it's iterable (e.g., entries())\n      if (typeof headers.entries === 'function') {\n        const result: Record<string, string> = {};\n        for (const [key, value] of headers.entries()) {\n          if (typeof key === 'string' && typeof value === 'string') {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      return;\n    },\n    customAttributes: (_ctx, msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (natsMsg.subject) attrs['nats.subject'] = natsMsg.subject;\n      if (natsMsg.reply) attrs['nats.reply_to'] = natsMsg.reply;\n      if (natsMsg.info?.stream) attrs['nats.stream'] = natsMsg.info.stream;\n      if (natsMsg.info?.consumer)\n        attrs['nats.consumer'] = natsMsg.info.consumer;\n      if (natsMsg.info?.redeliveryCount !== undefined) {\n        attrs['nats.delivered_count'] = natsMsg.info.redeliveryCount;\n      }\n      if (natsMsg.info?.pending !== undefined) {\n        attrs['nats.pending'] = natsMsg.info.pending;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Temporal Adapter\n// ============================================================================\n\n/**\n * Temporal activity/workflow info type (for reference)\n *\n * @internal Not exported - users bring their own Temporal types\n */\ninterface TemporalActivityInfo {\n  workflowId?: string;\n  runId?: string;\n  activityId?: string;\n  taskQueue?: string;\n  attempt?: number;\n  workflowType?: string;\n  activityType?: string;\n  startToCloseTimeout?: string;\n  scheduleToCloseTimeout?: string;\n}\n\n/**\n * Temporal adapter\n *\n * Captures Temporal-specific attributes for workflow activities.\n * Use this when instrumenting Temporal activity handlers.\n *\n * @example Activity handler\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'temporal',\n *   destination: 'order-activities',\n *   ...temporalAdapter.consumer,\n * })(ctx => async (info: ActivityInfo, input: OrderInput) => {\n *   // Temporal attributes are captured automatically\n *   return processOrderLogic(input);\n * });\n * ```\n *\n * @example Workflow signal/query\n * ```typescript\n * const sendSignal = traceProducer({\n *   system: 'temporal',\n *   destination: 'order-signals',\n *   ...temporalAdapter.producer,\n * })(ctx => async (workflowId, signalName, payload) => {\n *   await client.workflow.signal(workflowId, signalName, payload);\n * });\n * ```\n */\nexport const temporalAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const info = args[0] as TemporalActivityInfo | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info?.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info?.runId) attrs['temporal.run_id'] = info.runId;\n      if (info?.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info?.workflowType)\n        attrs['temporal.workflow_type'] = info.workflowType;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const info = msg as TemporalActivityInfo;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info.runId) attrs['temporal.run_id'] = info.runId;\n      if (info.activityId) attrs['temporal.activity_id'] = info.activityId;\n      if (info.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info.attempt !== undefined) attrs['temporal.attempt'] = info.attempt;\n      if (info.activityType)\n        attrs['temporal.activity_type'] = info.activityType;\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Cloudflare Queues Adapter\n// ============================================================================\n\n/**\n * Cloudflare Queue message type (for reference)\n *\n * @internal Not exported - users bring their own Cloudflare types\n */\ninterface CloudflareQueueMessage {\n  id: string;\n  timestamp: Date;\n  body: unknown;\n  attempts: number;\n}\n\n/**\n * Cloudflare Queues adapter\n *\n * Captures Cloudflare Queue-specific attributes.\n *\n * @example Queue consumer\n * ```typescript\n * export default {\n *   async queue(batch: MessageBatch, env: Env) {\n *     for (const msg of batch.messages) {\n *       await processMessage(msg);\n *     }\n *   },\n * };\n *\n * const processMessage = traceConsumer({\n *   system: 'cloudflare_queues',\n *   destination: 'my-queue',\n *   ...cloudflareQueuesAdapter.consumer,\n * })(ctx => async (msg: Message) => {\n *   await handleMessage(msg.body);\n *   msg.ack();\n * });\n * ```\n */\nexport const cloudflareQueuesAdapter: MessagingAdapter = {\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const cfMsg = msg as CloudflareQueueMessage;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (cfMsg.id) attrs['cloudflare.queue.message_id'] = cfMsg.id;\n      if (cfMsg.timestamp) {\n        attrs['cloudflare.queue.timestamp_ms'] = cfMsg.timestamp.getTime();\n      }\n      if (cfMsg.attempts !== undefined) {\n        attrs['cloudflare.queue.attempts'] = cfMsg.attempts;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Context Extractors for Non-W3C Formats\n// ============================================================================\n\n/**\n * Datadog trace context extractor\n *\n * Extracts parent span context from Datadog-format trace headers.\n * Converts Datadog's decimal IDs to OpenTelemetry's hex format.\n *\n * Note: Datadog sends trace/span IDs as decimal strings, not hex.\n * This extractor converts decimal -> hex before formatting for OTel.\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Datadog span automatically\n * });\n * ```\n */\nexport function datadogContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const traceIdDecimal = headers['x-datadog-trace-id'];\n  const spanIdDecimal = headers['x-datadog-parent-id'];\n  const samplingPriority = headers['x-datadog-sampling-priority'];\n\n  if (!traceIdDecimal || !spanIdDecimal) return null;\n\n  // Datadog sends IDs as decimal strings - convert to hex\n  // Use BigInt for 64-bit values that exceed Number.MAX_SAFE_INTEGER\n  let otelTraceId: string;\n  let otelSpanId: string;\n\n  try {\n    // Convert decimal to hex and pad to OTel format\n    // OTel trace IDs are 32 hex chars (128-bit), Datadog uses 64-bit\n    otelTraceId = BigInt(traceIdDecimal).toString(16).padStart(32, '0');\n    // OTel span IDs are 16 hex chars (64-bit)\n    otelSpanId = BigInt(spanIdDecimal).toString(16).padStart(16, '0');\n  } catch {\n    // Invalid decimal string\n    return null;\n  }\n\n  // Sampling priority > 0 means sampled\n  const sampled = samplingPriority\n    ? Number.parseInt(samplingPriority, 10) > 0\n    : true;\n\n  return {\n    traceId: otelTraceId,\n    spanId: otelSpanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * B3 (Zipkin) trace context extractor\n *\n * Extracts parent span context from B3 format headers.\n * Supports both single-header (b3) and multi-header formats.\n *\n * @see https://github.com/openzipkin/b3-propagation\n *\n * @example Single-header format\n * ```typescript\n * // Header: b3: 80f198ee56343ba864fe8b2a57d3eff7-e457b5a2e4d86bd1-1\n * const processMessage = traceConsumer({\n *   system: 'rabbitmq',\n *   destination: 'events',\n *   customContextExtractor: b3ContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Zipkin span\n * });\n * ```\n *\n * @example Multi-header format\n * ```typescript\n * // Headers: X-B3-TraceId, X-B3-SpanId, X-B3-Sampled\n * ```\n */\nexport function b3ContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  // Try single-header format first: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}\n  const b3Single = headers['b3'] || headers['B3'];\n  if (b3Single) {\n    // Handle \"0\" (not sampled, no trace) case\n    if (b3Single === '0') return null;\n\n    const parts = b3Single.split('-');\n    const traceId = parts[0];\n    const spanId = parts[1];\n    const sampledFlag = parts[2];\n\n    if (traceId && spanId) {\n      const sampled = sampledFlag !== '0' && sampledFlag !== 'd';\n\n      return {\n        traceId: traceId.padStart(32, '0'),\n        spanId: spanId.padStart(16, '0'),\n        traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n        isRemote: true,\n      };\n    }\n  }\n\n  // Fall back to multi-header format\n  const traceId =\n    headers['x-b3-traceid'] ||\n    headers['X-B3-TraceId'] ||\n    headers['X-B3-Traceid'];\n  const spanId =\n    headers['x-b3-spanid'] || headers['X-B3-SpanId'] || headers['X-B3-Spanid'];\n  const sampledHeader =\n    headers['x-b3-sampled'] ||\n    headers['X-B3-Sampled'] ||\n    headers['x-b3-flags'] ||\n    headers['X-B3-Flags'];\n\n  if (!traceId || !spanId) return null;\n\n  // x-b3-sampled: \"1\" or \"true\" = sampled, \"0\" or \"false\" = not sampled\n  // x-b3-flags: \"1\" = debug (implies sampled)\n  const sampled =\n    sampledHeader === '1' ||\n    sampledHeader === 'true' ||\n    sampledHeader === undefined; // Default to sampled if not specified\n\n  return {\n    traceId: traceId.padStart(32, '0'),\n    spanId: spanId.padStart(16, '0'),\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * AWS X-Ray trace context extractor\n *\n * Extracts parent span context from AWS X-Ray trace header.\n * Format: Root=1-{timestamp}-{random};Parent={parent-id};Sampled={0|1}\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'sqs',\n *   destination: 'my-queue',\n *   customContextExtractor: xrayContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent X-Ray trace\n * });\n * ```\n */\nexport function xrayContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const xrayHeader = headers['x-amzn-trace-id'] || headers['X-Amzn-Trace-Id'];\n\n  if (!xrayHeader) return null;\n\n  // Parse: Root=1-{8-char-timestamp}-{24-char-random};Parent={16-char-parent};Sampled=1\n  const rootMatch = xrayHeader.match(/Root=1-([a-f0-9]{8})-([a-f0-9]{24})/i);\n  const parentMatch = xrayHeader.match(/Parent=([a-f0-9]{16})/i);\n  const sampledMatch = xrayHeader.match(/Sampled=([01])/);\n\n  if (!rootMatch || !parentMatch) return null;\n\n  // X-Ray trace ID format: 1-{timestamp}-{random} -> OTel: {timestamp}{random}\n  const timestamp = rootMatch[1];\n  const random = rootMatch[2];\n  const parentId = parentMatch[1];\n\n  if (!timestamp || !random || !parentId) return null;\n\n  const traceId = `${timestamp}${random}`;\n  const spanId = parentId;\n  const sampled = sampledMatch ? sampledMatch[1] === '1' : true;\n\n  return {\n    traceId,\n    spanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n"],"mappings":"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"}

package/dist/messaging-adapters.d.cts

@@ -1,6 +1,5 @@
 import { ConsumerContext, ProducerContext } from "./messaging.cjs";
 import { AttributeValue, SpanContext } from "@opentelemetry/api";
-
 //#region src/messaging-adapters.d.ts
 /**
  * Producer adapter configuration

package/dist/messaging-adapters.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-adapters.d.cts","names":[],"sources":["../src/messaging-adapters.ts"],"mappings":";;;;;;;UAkDiB,eAAA;EA8BV;;;EA1BL,gBAAA,IACE,GAAA,EAAK,eAAA,EACL,IAAA,gBACG,MAAA,SAAe,cAAA;EA6BlB;;;EAxBF,aAAA,IAAiB,GAAA,EAAK,eAAA,KAAoB,MAAA;AAAA;;;;UAM3B,eAAA;EA0BJ;;;EAtBX,WAAA,IAAe,GAAA,cAAiB,MAAA;EAuBN;AA+D5B;;EAjFE,gBAAA,IACE,GAAA,EAAK,eAAA,EACL,GAAA,cACG,MAAA,SAAe,cAAA;EAsKrB;AAAA;AAoDD;EArNE,sBAAA,IACE,OAAA,EAAS,MAAA,qBACN,WAAA;AAAA;;AAkPN;AA2CD;UAvRiB,gBAAA;EACf,QAAA,GAAW,eAAA;EACX,QAAA,GAAW,eAAe;AAAA;AAgU5B;;;;;;;;AAEc;AA6Dd;;;;;;;;AAEc;AAuEd;;;;;;;;AAEc;;;;AA1Id,cAjQa,WAAA,EAAa,gBAwFzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoDY,eAAA,EAAiB,gBA+B7B;;;;;;;;;;;;;;;;;;;;;;;;;;cA2CY,uBAAA,EAAyB,gBAiBrC;;;;;;;;;;;;;;;;;;;;;iBA0Be,uBAAA,CACd,OAAA,EAAS,MAAA,mBACR,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DE,kBAAA,CACd,OAAA,EAAS,MAAA,mBACR,WAAW;;;;;;;;;;;;;;;;;;iBAuEE,oBAAA,CACd,OAAA,EAAS,MAAA,mBACR,WAAW"}
+{"version":3,"file":"messaging-adapters.d.cts","names":[],"sources":["../src/messaging-adapters.ts"],"mappings":";;;;;;UAkDiB;;;;EAIf,oBACE,KAAK,iBACL,oBACG,eAAe;;;;EAKpB,iBAAiB,KAAK,oBAAoB;;;;;UAM3B;;;;EAIf,eAAe,iBAAiB;;;;EAKhC,oBACE,KAAK,iBACL,iBACG,eAAe;;;;EAKpB,0BACE,SAAS,2BACN;;;;;UAMU;EACf,WAAW;EACX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+DA,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2Ib,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;cA0EjB,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBA2CtB,wBACd,SAAS,yBACR;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6Da,mBACd,SAAS,yBACR;;;;;;;;;;;;;;;;;;iBAuEa,qBACd,SAAS,yBACR"}

package/dist/messaging-adapters.d.ts

@@ -1,6 +1,5 @@
 import { ConsumerContext, ProducerContext } from "./messaging.js";
 import { AttributeValue, SpanContext } from "@opentelemetry/api";
-
 //#region src/messaging-adapters.d.ts
 /**
  * Producer adapter configuration

package/dist/messaging-adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-adapters.d.ts","names":[],"sources":["../src/messaging-adapters.ts"],"mappings":";;;;;;;UAkDiB,eAAA;EA8BV;;;EA1BL,gBAAA,IACE,GAAA,EAAK,eAAA,EACL,IAAA,gBACG,MAAA,SAAe,cAAA;EA6BlB;;;EAxBF,aAAA,IAAiB,GAAA,EAAK,eAAA,KAAoB,MAAA;AAAA;;;;UAM3B,eAAA;EA0BJ;;;EAtBX,WAAA,IAAe,GAAA,cAAiB,MAAA;EAuBN;AA+D5B;;EAjFE,gBAAA,IACE,GAAA,EAAK,eAAA,EACL,GAAA,cACG,MAAA,SAAe,cAAA;EAsKrB;AAAA;AAoDD;EArNE,sBAAA,IACE,OAAA,EAAS,MAAA,qBACN,WAAA;AAAA;;AAkPN;AA2CD;UAvRiB,gBAAA;EACf,QAAA,GAAW,eAAA;EACX,QAAA,GAAW,eAAe;AAAA;AAgU5B;;;;;;;;AAEc;AA6Dd;;;;;;;;AAEc;AAuEd;;;;;;;;AAEc;;;;AA1Id,cAjQa,WAAA,EAAa,gBAwFzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoDY,eAAA,EAAiB,gBA+B7B;;;;;;;;;;;;;;;;;;;;;;;;;;cA2CY,uBAAA,EAAyB,gBAiBrC;;;;;;;;;;;;;;;;;;;;;iBA0Be,uBAAA,CACd,OAAA,EAAS,MAAA,mBACR,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DE,kBAAA,CACd,OAAA,EAAS,MAAA,mBACR,WAAW;;;;;;;;;;;;;;;;;;iBAuEE,oBAAA,CACd,OAAA,EAAS,MAAA,mBACR,WAAW"}
+{"version":3,"file":"messaging-adapters.d.ts","names":[],"sources":["../src/messaging-adapters.ts"],"mappings":";;;;;;UAkDiB;;;;EAIf,oBACE,KAAK,iBACL,oBACG,eAAe;;;;EAKpB,iBAAiB,KAAK,oBAAoB;;;;;UAM3B;;;;EAIf,eAAe,iBAAiB;;;;EAKhC,oBACE,KAAK,iBACL,iBACG,eAAe;;;;EAKpB,0BACE,SAAS,2BACN;;;;;UAMU;EACf,WAAW;EACX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+DA,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2Ib,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;cA0EjB,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBA2CtB,wBACd,SAAS,yBACR;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6Da,mBACd,SAAS,yBACR;;;;;;;;;;;;;;;;;;iBAuEa,qBACd,SAAS,yBACR"}

package/dist/messaging-adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-adapters.js","names":["natsMsg"],"sources":["../src/messaging-adapters.ts"],"sourcesContent":["/**\n * Pre-built adapter configurations for common messaging systems.\n *\n * These adapters provide ready-to-use hook configurations for systems\n * not explicitly supported by the core messaging module. Use them with\n * traceProducer/traceConsumer to get system-specific attributes.\n *\n * @example NATS consumer\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { natsAdapter } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg) => {\n *   // msg.subject, msg.info.stream are now captured as span attributes\n *   await handleOrder(msg.data);\n * });\n * ```\n *\n * @example Datadog context propagation\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { datadogContextExtractor } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Parent span from Datadog trace headers is linked\n * });\n * ```\n *\n * @module\n */\n\nimport type { AttributeValue, SpanContext } from '@opentelemetry/api';\nimport { TraceFlags } from '@opentelemetry/api';\nimport type { ProducerContext, ConsumerContext } from './messaging';\n\n// ============================================================================\n// Adapter Types\n// ============================================================================\n\n/**\n * Producer adapter configuration\n */\nexport interface ProducerAdapter {\n  /**\n   * Hook to add system-specific attributes to producer spans\n   */\n  customAttributes?: (\n    ctx: ProducerContext,\n    args: unknown[],\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to inject custom headers beyond W3C traceparent\n   */\n  customHeaders?: (ctx: ProducerContext) => Record<string, string>;\n}\n\n/**\n * Consumer adapter configuration\n */\nexport interface ConsumerAdapter {\n  /**\n   * Extract headers from the message for trace context propagation\n   */\n  headersFrom?: (msg: unknown) => Record<string, string> | undefined;\n\n  /**\n   * Hook to add system-specific attributes to consumer spans\n   */\n  customAttributes?: (\n    ctx: ConsumerContext,\n    msg: unknown,\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to extract parent span context from non-W3C header formats\n   */\n  customContextExtractor?: (\n    headers: Record<string, string>,\n  ) => SpanContext | null;\n}\n\n/**\n * Combined producer and consumer adapter\n */\nexport interface MessagingAdapter {\n  producer?: ProducerAdapter;\n  consumer?: ConsumerAdapter;\n}\n\n// ============================================================================\n// NATS JetStream Adapter\n// ============================================================================\n\n/**\n * NATS JetStream message type (for reference)\n *\n * @internal Not exported - users bring their own NATS types\n */\ninterface NatsJetStreamMsg {\n  subject: string;\n  reply?: string;\n  data: Uint8Array;\n  headers?: {\n    /** Convert headers to plain object (some NATS implementations) */\n    toJSON?: () => Record<string, string> | unknown;\n    /** Get a header value by key (Headers-like interface) */\n    get?: (key: string) => string | undefined;\n    /** Iterate over header entries */\n    entries?: () => Iterable<[string, string]>;\n  };\n  info?: {\n    stream: string;\n    consumer: string;\n    redeliveryCount?: number;\n    pending?: number;\n    timestampNanos?: bigint;\n  };\n}\n\n/**\n * NATS JetStream adapter\n *\n * Captures NATS-specific attributes following NATS observability conventions.\n *\n * @example Producer\n * ```typescript\n * const publishOrder = traceProducer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   ...natsAdapter.producer,\n * })(ctx => async (subject, payload, opts) => {\n *   const headers = ctx.getTraceHeaders();\n *   await nc.publish(subject, payload, { headers });\n * });\n * ```\n *\n * @example Consumer\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   consumerGroup: 'order-processor',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg: JsMsg) => {\n *   await handleOrder(msg.data);\n *   msg.ack();\n * });\n * ```\n */\nexport const natsAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const msg = args[0] as\n        | { subject?: string; replyTo?: string; stream?: string }\n        | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (msg?.subject) attrs['nats.subject'] = msg.subject;\n      if (msg?.replyTo) attrs['nats.reply_to'] = msg.replyTo;\n      if (msg?.stream) attrs['nats.stream'] = msg.stream;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    headersFrom: (msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const headers = natsMsg.headers;\n\n      if (!headers) return;\n\n      // Try toJSON() first (some NATS implementations)\n      if (typeof headers.toJSON === 'function') {\n        const json = headers.toJSON();\n        if (json && typeof json === 'object') {\n          return json as Record<string, string>;\n        }\n      }\n\n      // Fallback: use .get() for common trace headers\n      // This handles Headers-like objects that only expose .get()\n      if (typeof headers.get === 'function') {\n        const result: Record<string, string> = {};\n        const traceHeaders = [\n          'traceparent',\n          'tracestate',\n          'baggage',\n          'x-b3-traceid',\n          'x-b3-spanid',\n          'x-b3-sampled',\n          'b3',\n        ];\n        for (const key of traceHeaders) {\n          const value = headers.get(key);\n          if (value) {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      // Fallback: try to iterate if it's iterable (e.g., entries())\n      if (typeof headers.entries === 'function') {\n        const result: Record<string, string> = {};\n        for (const [key, value] of headers.entries()) {\n          if (typeof key === 'string' && typeof value === 'string') {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      return;\n    },\n    customAttributes: (_ctx, msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (natsMsg.subject) attrs['nats.subject'] = natsMsg.subject;\n      if (natsMsg.reply) attrs['nats.reply_to'] = natsMsg.reply;\n      if (natsMsg.info?.stream) attrs['nats.stream'] = natsMsg.info.stream;\n      if (natsMsg.info?.consumer)\n        attrs['nats.consumer'] = natsMsg.info.consumer;\n      if (natsMsg.info?.redeliveryCount !== undefined) {\n        attrs['nats.delivered_count'] = natsMsg.info.redeliveryCount;\n      }\n      if (natsMsg.info?.pending !== undefined) {\n        attrs['nats.pending'] = natsMsg.info.pending;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Temporal Adapter\n// ============================================================================\n\n/**\n * Temporal activity/workflow info type (for reference)\n *\n * @internal Not exported - users bring their own Temporal types\n */\ninterface TemporalActivityInfo {\n  workflowId?: string;\n  runId?: string;\n  activityId?: string;\n  taskQueue?: string;\n  attempt?: number;\n  workflowType?: string;\n  activityType?: string;\n  startToCloseTimeout?: string;\n  scheduleToCloseTimeout?: string;\n}\n\n/**\n * Temporal adapter\n *\n * Captures Temporal-specific attributes for workflow activities.\n * Use this when instrumenting Temporal activity handlers.\n *\n * @example Activity handler\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'temporal',\n *   destination: 'order-activities',\n *   ...temporalAdapter.consumer,\n * })(ctx => async (info: ActivityInfo, input: OrderInput) => {\n *   // Temporal attributes are captured automatically\n *   return processOrderLogic(input);\n * });\n * ```\n *\n * @example Workflow signal/query\n * ```typescript\n * const sendSignal = traceProducer({\n *   system: 'temporal',\n *   destination: 'order-signals',\n *   ...temporalAdapter.producer,\n * })(ctx => async (workflowId, signalName, payload) => {\n *   await client.workflow.signal(workflowId, signalName, payload);\n * });\n * ```\n */\nexport const temporalAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const info = args[0] as TemporalActivityInfo | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info?.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info?.runId) attrs['temporal.run_id'] = info.runId;\n      if (info?.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info?.workflowType)\n        attrs['temporal.workflow_type'] = info.workflowType;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const info = msg as TemporalActivityInfo;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info.runId) attrs['temporal.run_id'] = info.runId;\n      if (info.activityId) attrs['temporal.activity_id'] = info.activityId;\n      if (info.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info.attempt !== undefined) attrs['temporal.attempt'] = info.attempt;\n      if (info.activityType)\n        attrs['temporal.activity_type'] = info.activityType;\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Cloudflare Queues Adapter\n// ============================================================================\n\n/**\n * Cloudflare Queue message type (for reference)\n *\n * @internal Not exported - users bring their own Cloudflare types\n */\ninterface CloudflareQueueMessage {\n  id: string;\n  timestamp: Date;\n  body: unknown;\n  attempts: number;\n}\n\n/**\n * Cloudflare Queues adapter\n *\n * Captures Cloudflare Queue-specific attributes.\n *\n * @example Queue consumer\n * ```typescript\n * export default {\n *   async queue(batch: MessageBatch, env: Env) {\n *     for (const msg of batch.messages) {\n *       await processMessage(msg);\n *     }\n *   },\n * };\n *\n * const processMessage = traceConsumer({\n *   system: 'cloudflare_queues',\n *   destination: 'my-queue',\n *   ...cloudflareQueuesAdapter.consumer,\n * })(ctx => async (msg: Message) => {\n *   await handleMessage(msg.body);\n *   msg.ack();\n * });\n * ```\n */\nexport const cloudflareQueuesAdapter: MessagingAdapter = {\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const cfMsg = msg as CloudflareQueueMessage;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (cfMsg.id) attrs['cloudflare.queue.message_id'] = cfMsg.id;\n      if (cfMsg.timestamp) {\n        attrs['cloudflare.queue.timestamp_ms'] = cfMsg.timestamp.getTime();\n      }\n      if (cfMsg.attempts !== undefined) {\n        attrs['cloudflare.queue.attempts'] = cfMsg.attempts;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Context Extractors for Non-W3C Formats\n// ============================================================================\n\n/**\n * Datadog trace context extractor\n *\n * Extracts parent span context from Datadog-format trace headers.\n * Converts Datadog's decimal IDs to OpenTelemetry's hex format.\n *\n * Note: Datadog sends trace/span IDs as decimal strings, not hex.\n * This extractor converts decimal -> hex before formatting for OTel.\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Datadog span automatically\n * });\n * ```\n */\nexport function datadogContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const traceIdDecimal = headers['x-datadog-trace-id'];\n  const spanIdDecimal = headers['x-datadog-parent-id'];\n  const samplingPriority = headers['x-datadog-sampling-priority'];\n\n  if (!traceIdDecimal || !spanIdDecimal) return null;\n\n  // Datadog sends IDs as decimal strings - convert to hex\n  // Use BigInt for 64-bit values that exceed Number.MAX_SAFE_INTEGER\n  let otelTraceId: string;\n  let otelSpanId: string;\n\n  try {\n    // Convert decimal to hex and pad to OTel format\n    // OTel trace IDs are 32 hex chars (128-bit), Datadog uses 64-bit\n    otelTraceId = BigInt(traceIdDecimal).toString(16).padStart(32, '0');\n    // OTel span IDs are 16 hex chars (64-bit)\n    otelSpanId = BigInt(spanIdDecimal).toString(16).padStart(16, '0');\n  } catch {\n    // Invalid decimal string\n    return null;\n  }\n\n  // Sampling priority > 0 means sampled\n  const sampled = samplingPriority\n    ? Number.parseInt(samplingPriority, 10) > 0\n    : true;\n\n  return {\n    traceId: otelTraceId,\n    spanId: otelSpanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * B3 (Zipkin) trace context extractor\n *\n * Extracts parent span context from B3 format headers.\n * Supports both single-header (b3) and multi-header formats.\n *\n * @see https://github.com/openzipkin/b3-propagation\n *\n * @example Single-header format\n * ```typescript\n * // Header: b3: 80f198ee56343ba864fe8b2a57d3eff7-e457b5a2e4d86bd1-1\n * const processMessage = traceConsumer({\n *   system: 'rabbitmq',\n *   destination: 'events',\n *   customContextExtractor: b3ContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Zipkin span\n * });\n * ```\n *\n * @example Multi-header format\n * ```typescript\n * // Headers: X-B3-TraceId, X-B3-SpanId, X-B3-Sampled\n * ```\n */\nexport function b3ContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  // Try single-header format first: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}\n  const b3Single = headers['b3'] || headers['B3'];\n  if (b3Single) {\n    // Handle \"0\" (not sampled, no trace) case\n    if (b3Single === '0') return null;\n\n    const parts = b3Single.split('-');\n    const traceId = parts[0];\n    const spanId = parts[1];\n    const sampledFlag = parts[2];\n\n    if (traceId && spanId) {\n      const sampled = sampledFlag !== '0' && sampledFlag !== 'd';\n\n      return {\n        traceId: traceId.padStart(32, '0'),\n        spanId: spanId.padStart(16, '0'),\n        traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n        isRemote: true,\n      };\n    }\n  }\n\n  // Fall back to multi-header format\n  const traceId =\n    headers['x-b3-traceid'] ||\n    headers['X-B3-TraceId'] ||\n    headers['X-B3-Traceid'];\n  const spanId =\n    headers['x-b3-spanid'] || headers['X-B3-SpanId'] || headers['X-B3-Spanid'];\n  const sampledHeader =\n    headers['x-b3-sampled'] ||\n    headers['X-B3-Sampled'] ||\n    headers['x-b3-flags'] ||\n    headers['X-B3-Flags'];\n\n  if (!traceId || !spanId) return null;\n\n  // x-b3-sampled: \"1\" or \"true\" = sampled, \"0\" or \"false\" = not sampled\n  // x-b3-flags: \"1\" = debug (implies sampled)\n  const sampled =\n    sampledHeader === '1' ||\n    sampledHeader === 'true' ||\n    sampledHeader === undefined; // Default to sampled if not specified\n\n  return {\n    traceId: traceId.padStart(32, '0'),\n    spanId: spanId.padStart(16, '0'),\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * AWS X-Ray trace context extractor\n *\n * Extracts parent span context from AWS X-Ray trace header.\n * Format: Root=1-{timestamp}-{random};Parent={parent-id};Sampled={0|1}\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'sqs',\n *   destination: 'my-queue',\n *   customContextExtractor: xrayContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent X-Ray trace\n * });\n * ```\n */\nexport function xrayContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const xrayHeader = headers['x-amzn-trace-id'] || headers['X-Amzn-Trace-Id'];\n\n  if (!xrayHeader) return null;\n\n  // Parse: Root=1-{8-char-timestamp}-{24-char-random};Parent={16-char-parent};Sampled=1\n  const rootMatch = xrayHeader.match(/Root=1-([a-f0-9]{8})-([a-f0-9]{24})/i);\n  const parentMatch = xrayHeader.match(/Parent=([a-f0-9]{16})/i);\n  const sampledMatch = xrayHeader.match(/Sampled=([01])/);\n\n  if (!rootMatch || !parentMatch) return null;\n\n  // X-Ray trace ID format: 1-{timestamp}-{random} -> OTel: {timestamp}{random}\n  const timestamp = rootMatch[1];\n  const random = rootMatch[2];\n  const parentId = parentMatch[1];\n\n  if (!timestamp || !random || !parentId) return null;\n\n  const traceId = `${timestamp}${random}`;\n  const spanId = parentId;\n  const sampled = sampledMatch ? sampledMatch[1] === '1' : true;\n\n  return {\n    traceId,\n    spanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"messaging-adapters.js","names":["natsMsg"],"sources":["../src/messaging-adapters.ts"],"sourcesContent":["/**\n * Pre-built adapter configurations for common messaging systems.\n *\n * These adapters provide ready-to-use hook configurations for systems\n * not explicitly supported by the core messaging module. Use them with\n * traceProducer/traceConsumer to get system-specific attributes.\n *\n * @example NATS consumer\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { natsAdapter } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg) => {\n *   // msg.subject, msg.info.stream are now captured as span attributes\n *   await handleOrder(msg.data);\n * });\n * ```\n *\n * @example Datadog context propagation\n * ```typescript\n * import { traceConsumer } from 'autotel/messaging';\n * import { datadogContextExtractor } from 'autotel/messaging/adapters';\n *\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Parent span from Datadog trace headers is linked\n * });\n * ```\n *\n * @module\n */\n\nimport type { AttributeValue, SpanContext } from '@opentelemetry/api';\nimport { TraceFlags } from '@opentelemetry/api';\nimport type { ProducerContext, ConsumerContext } from './messaging';\n\n// ============================================================================\n// Adapter Types\n// ============================================================================\n\n/**\n * Producer adapter configuration\n */\nexport interface ProducerAdapter {\n  /**\n   * Hook to add system-specific attributes to producer spans\n   */\n  customAttributes?: (\n    ctx: ProducerContext,\n    args: unknown[],\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to inject custom headers beyond W3C traceparent\n   */\n  customHeaders?: (ctx: ProducerContext) => Record<string, string>;\n}\n\n/**\n * Consumer adapter configuration\n */\nexport interface ConsumerAdapter {\n  /**\n   * Extract headers from the message for trace context propagation\n   */\n  headersFrom?: (msg: unknown) => Record<string, string> | undefined;\n\n  /**\n   * Hook to add system-specific attributes to consumer spans\n   */\n  customAttributes?: (\n    ctx: ConsumerContext,\n    msg: unknown,\n  ) => Record<string, AttributeValue>;\n\n  /**\n   * Hook to extract parent span context from non-W3C header formats\n   */\n  customContextExtractor?: (\n    headers: Record<string, string>,\n  ) => SpanContext | null;\n}\n\n/**\n * Combined producer and consumer adapter\n */\nexport interface MessagingAdapter {\n  producer?: ProducerAdapter;\n  consumer?: ConsumerAdapter;\n}\n\n// ============================================================================\n// NATS JetStream Adapter\n// ============================================================================\n\n/**\n * NATS JetStream message type (for reference)\n *\n * @internal Not exported - users bring their own NATS types\n */\ninterface NatsJetStreamMsg {\n  subject: string;\n  reply?: string;\n  data: Uint8Array;\n  headers?: {\n    /** Convert headers to plain object (some NATS implementations) */\n    toJSON?: () => Record<string, string> | unknown;\n    /** Get a header value by key (Headers-like interface) */\n    get?: (key: string) => string | undefined;\n    /** Iterate over header entries */\n    entries?: () => Iterable<[string, string]>;\n  };\n  info?: {\n    stream: string;\n    consumer: string;\n    redeliveryCount?: number;\n    pending?: number;\n    timestampNanos?: bigint;\n  };\n}\n\n/**\n * NATS JetStream adapter\n *\n * Captures NATS-specific attributes following NATS observability conventions.\n *\n * @example Producer\n * ```typescript\n * const publishOrder = traceProducer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   ...natsAdapter.producer,\n * })(ctx => async (subject, payload, opts) => {\n *   const headers = ctx.getTraceHeaders();\n *   await nc.publish(subject, payload, { headers });\n * });\n * ```\n *\n * @example Consumer\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'nats',\n *   destination: 'orders.created',\n *   consumerGroup: 'order-processor',\n *   ...natsAdapter.consumer,\n * })(ctx => async (msg: JsMsg) => {\n *   await handleOrder(msg.data);\n *   msg.ack();\n * });\n * ```\n */\nexport const natsAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const msg = args[0] as\n        { subject?: string; replyTo?: string; stream?: string } | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (msg?.subject) attrs['nats.subject'] = msg.subject;\n      if (msg?.replyTo) attrs['nats.reply_to'] = msg.replyTo;\n      if (msg?.stream) attrs['nats.stream'] = msg.stream;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    headersFrom: (msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const headers = natsMsg.headers;\n\n      if (!headers) return;\n\n      // Try toJSON() first (some NATS implementations)\n      if (typeof headers.toJSON === 'function') {\n        const json = headers.toJSON();\n        if (json && typeof json === 'object') {\n          return json as Record<string, string>;\n        }\n      }\n\n      // Fallback: use .get() for common trace headers\n      // This handles Headers-like objects that only expose .get()\n      if (typeof headers.get === 'function') {\n        const result: Record<string, string> = {};\n        const traceHeaders = [\n          'traceparent',\n          'tracestate',\n          'baggage',\n          'x-b3-traceid',\n          'x-b3-spanid',\n          'x-b3-sampled',\n          'b3',\n        ];\n        for (const key of traceHeaders) {\n          const value = headers.get(key);\n          if (value) {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      // Fallback: try to iterate if it's iterable (e.g., entries())\n      if (typeof headers.entries === 'function') {\n        const result: Record<string, string> = {};\n        for (const [key, value] of headers.entries()) {\n          if (typeof key === 'string' && typeof value === 'string') {\n            result[key] = value;\n          }\n        }\n        if (Object.keys(result).length > 0) {\n          return result;\n        }\n      }\n\n      return;\n    },\n    customAttributes: (_ctx, msg) => {\n      const natsMsg = msg as NatsJetStreamMsg;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (natsMsg.subject) attrs['nats.subject'] = natsMsg.subject;\n      if (natsMsg.reply) attrs['nats.reply_to'] = natsMsg.reply;\n      if (natsMsg.info?.stream) attrs['nats.stream'] = natsMsg.info.stream;\n      if (natsMsg.info?.consumer)\n        attrs['nats.consumer'] = natsMsg.info.consumer;\n      if (natsMsg.info?.redeliveryCount !== undefined) {\n        attrs['nats.delivered_count'] = natsMsg.info.redeliveryCount;\n      }\n      if (natsMsg.info?.pending !== undefined) {\n        attrs['nats.pending'] = natsMsg.info.pending;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Temporal Adapter\n// ============================================================================\n\n/**\n * Temporal activity/workflow info type (for reference)\n *\n * @internal Not exported - users bring their own Temporal types\n */\ninterface TemporalActivityInfo {\n  workflowId?: string;\n  runId?: string;\n  activityId?: string;\n  taskQueue?: string;\n  attempt?: number;\n  workflowType?: string;\n  activityType?: string;\n  startToCloseTimeout?: string;\n  scheduleToCloseTimeout?: string;\n}\n\n/**\n * Temporal adapter\n *\n * Captures Temporal-specific attributes for workflow activities.\n * Use this when instrumenting Temporal activity handlers.\n *\n * @example Activity handler\n * ```typescript\n * const processOrder = traceConsumer({\n *   system: 'temporal',\n *   destination: 'order-activities',\n *   ...temporalAdapter.consumer,\n * })(ctx => async (info: ActivityInfo, input: OrderInput) => {\n *   // Temporal attributes are captured automatically\n *   return processOrderLogic(input);\n * });\n * ```\n *\n * @example Workflow signal/query\n * ```typescript\n * const sendSignal = traceProducer({\n *   system: 'temporal',\n *   destination: 'order-signals',\n *   ...temporalAdapter.producer,\n * })(ctx => async (workflowId, signalName, payload) => {\n *   await client.workflow.signal(workflowId, signalName, payload);\n * });\n * ```\n */\nexport const temporalAdapter: MessagingAdapter = {\n  producer: {\n    customAttributes: (_ctx, args) => {\n      const info = args[0] as TemporalActivityInfo | undefined;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info?.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info?.runId) attrs['temporal.run_id'] = info.runId;\n      if (info?.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info?.workflowType)\n        attrs['temporal.workflow_type'] = info.workflowType;\n\n      return attrs;\n    },\n  },\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const info = msg as TemporalActivityInfo;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (info.workflowId) attrs['temporal.workflow_id'] = info.workflowId;\n      if (info.runId) attrs['temporal.run_id'] = info.runId;\n      if (info.activityId) attrs['temporal.activity_id'] = info.activityId;\n      if (info.taskQueue) attrs['temporal.task_queue'] = info.taskQueue;\n      if (info.attempt !== undefined) attrs['temporal.attempt'] = info.attempt;\n      if (info.activityType)\n        attrs['temporal.activity_type'] = info.activityType;\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Cloudflare Queues Adapter\n// ============================================================================\n\n/**\n * Cloudflare Queue message type (for reference)\n *\n * @internal Not exported - users bring their own Cloudflare types\n */\ninterface CloudflareQueueMessage {\n  id: string;\n  timestamp: Date;\n  body: unknown;\n  attempts: number;\n}\n\n/**\n * Cloudflare Queues adapter\n *\n * Captures Cloudflare Queue-specific attributes.\n *\n * @example Queue consumer\n * ```typescript\n * export default {\n *   async queue(batch: MessageBatch, env: Env) {\n *     for (const msg of batch.messages) {\n *       await processMessage(msg);\n *     }\n *   },\n * };\n *\n * const processMessage = traceConsumer({\n *   system: 'cloudflare_queues',\n *   destination: 'my-queue',\n *   ...cloudflareQueuesAdapter.consumer,\n * })(ctx => async (msg: Message) => {\n *   await handleMessage(msg.body);\n *   msg.ack();\n * });\n * ```\n */\nexport const cloudflareQueuesAdapter: MessagingAdapter = {\n  consumer: {\n    customAttributes: (_ctx, msg) => {\n      const cfMsg = msg as CloudflareQueueMessage;\n      const attrs: Record<string, AttributeValue> = {};\n\n      if (cfMsg.id) attrs['cloudflare.queue.message_id'] = cfMsg.id;\n      if (cfMsg.timestamp) {\n        attrs['cloudflare.queue.timestamp_ms'] = cfMsg.timestamp.getTime();\n      }\n      if (cfMsg.attempts !== undefined) {\n        attrs['cloudflare.queue.attempts'] = cfMsg.attempts;\n      }\n\n      return attrs;\n    },\n  },\n};\n\n// ============================================================================\n// Context Extractors for Non-W3C Formats\n// ============================================================================\n\n/**\n * Datadog trace context extractor\n *\n * Extracts parent span context from Datadog-format trace headers.\n * Converts Datadog's decimal IDs to OpenTelemetry's hex format.\n *\n * Note: Datadog sends trace/span IDs as decimal strings, not hex.\n * This extractor converts decimal -> hex before formatting for OTel.\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'kafka',\n *   destination: 'events',\n *   customContextExtractor: datadogContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Datadog span automatically\n * });\n * ```\n */\nexport function datadogContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const traceIdDecimal = headers['x-datadog-trace-id'];\n  const spanIdDecimal = headers['x-datadog-parent-id'];\n  const samplingPriority = headers['x-datadog-sampling-priority'];\n\n  if (!traceIdDecimal || !spanIdDecimal) return null;\n\n  // Datadog sends IDs as decimal strings - convert to hex\n  // Use BigInt for 64-bit values that exceed Number.MAX_SAFE_INTEGER\n  let otelTraceId: string;\n  let otelSpanId: string;\n\n  try {\n    // Convert decimal to hex and pad to OTel format\n    // OTel trace IDs are 32 hex chars (128-bit), Datadog uses 64-bit\n    otelTraceId = BigInt(traceIdDecimal).toString(16).padStart(32, '0');\n    // OTel span IDs are 16 hex chars (64-bit)\n    otelSpanId = BigInt(spanIdDecimal).toString(16).padStart(16, '0');\n  } catch {\n    // Invalid decimal string\n    return null;\n  }\n\n  // Sampling priority > 0 means sampled\n  const sampled = samplingPriority\n    ? Number.parseInt(samplingPriority, 10) > 0\n    : true;\n\n  return {\n    traceId: otelTraceId,\n    spanId: otelSpanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * B3 (Zipkin) trace context extractor\n *\n * Extracts parent span context from B3 format headers.\n * Supports both single-header (b3) and multi-header formats.\n *\n * @see https://github.com/openzipkin/b3-propagation\n *\n * @example Single-header format\n * ```typescript\n * // Header: b3: 80f198ee56343ba864fe8b2a57d3eff7-e457b5a2e4d86bd1-1\n * const processMessage = traceConsumer({\n *   system: 'rabbitmq',\n *   destination: 'events',\n *   customContextExtractor: b3ContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent Zipkin span\n * });\n * ```\n *\n * @example Multi-header format\n * ```typescript\n * // Headers: X-B3-TraceId, X-B3-SpanId, X-B3-Sampled\n * ```\n */\nexport function b3ContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  // Try single-header format first: {TraceId}-{SpanId}-{SamplingState}-{ParentSpanId}\n  const b3Single = headers['b3'] || headers['B3'];\n  if (b3Single) {\n    // Handle \"0\" (not sampled, no trace) case\n    if (b3Single === '0') return null;\n\n    const parts = b3Single.split('-');\n    const traceId = parts[0];\n    const spanId = parts[1];\n    const sampledFlag = parts[2];\n\n    if (traceId && spanId) {\n      const sampled = sampledFlag !== '0' && sampledFlag !== 'd';\n\n      return {\n        traceId: traceId.padStart(32, '0'),\n        spanId: spanId.padStart(16, '0'),\n        traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n        isRemote: true,\n      };\n    }\n  }\n\n  // Fall back to multi-header format\n  const traceId =\n    headers['x-b3-traceid'] ||\n    headers['X-B3-TraceId'] ||\n    headers['X-B3-Traceid'];\n  const spanId =\n    headers['x-b3-spanid'] || headers['X-B3-SpanId'] || headers['X-B3-Spanid'];\n  const sampledHeader =\n    headers['x-b3-sampled'] ||\n    headers['X-B3-Sampled'] ||\n    headers['x-b3-flags'] ||\n    headers['X-B3-Flags'];\n\n  if (!traceId || !spanId) return null;\n\n  // x-b3-sampled: \"1\" or \"true\" = sampled, \"0\" or \"false\" = not sampled\n  // x-b3-flags: \"1\" = debug (implies sampled)\n  const sampled =\n    sampledHeader === '1' ||\n    sampledHeader === 'true' ||\n    sampledHeader === undefined; // Default to sampled if not specified\n\n  return {\n    traceId: traceId.padStart(32, '0'),\n    spanId: spanId.padStart(16, '0'),\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n\n/**\n * AWS X-Ray trace context extractor\n *\n * Extracts parent span context from AWS X-Ray trace header.\n * Format: Root=1-{timestamp}-{random};Parent={parent-id};Sampled={0|1}\n *\n * @example\n * ```typescript\n * const processMessage = traceConsumer({\n *   system: 'sqs',\n *   destination: 'my-queue',\n *   customContextExtractor: xrayContextExtractor,\n * })(ctx => async (msg) => {\n *   // Links to parent X-Ray trace\n * });\n * ```\n */\nexport function xrayContextExtractor(\n  headers: Record<string, string>,\n): SpanContext | null {\n  const xrayHeader = headers['x-amzn-trace-id'] || headers['X-Amzn-Trace-Id'];\n\n  if (!xrayHeader) return null;\n\n  // Parse: Root=1-{8-char-timestamp}-{24-char-random};Parent={16-char-parent};Sampled=1\n  const rootMatch = xrayHeader.match(/Root=1-([a-f0-9]{8})-([a-f0-9]{24})/i);\n  const parentMatch = xrayHeader.match(/Parent=([a-f0-9]{16})/i);\n  const sampledMatch = xrayHeader.match(/Sampled=([01])/);\n\n  if (!rootMatch || !parentMatch) return null;\n\n  // X-Ray trace ID format: 1-{timestamp}-{random} -> OTel: {timestamp}{random}\n  const timestamp = rootMatch[1];\n  const random = rootMatch[2];\n  const parentId = parentMatch[1];\n\n  if (!timestamp || !random || !parentId) return null;\n\n  const traceId = `${timestamp}${random}`;\n  const spanId = parentId;\n  const sampled = sampledMatch ? sampledMatch[1] === '1' : true;\n\n  return {\n    traceId,\n    spanId,\n    traceFlags: sampled ? TraceFlags.SAMPLED : TraceFlags.NONE,\n    isRemote: true,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8JA,MAAa,cAAgC;CAC3C,UAAU,EACR,mBAAmB,MAAM,SAAS;EAChC,MAAM,MAAM,KAAK;EAEjB,MAAM,QAAwC,CAAC;EAE/C,IAAI,KAAK,SAAS,MAAM,kBAAkB,IAAI;EAC9C,IAAI,KAAK,SAAS,MAAM,mBAAmB,IAAI;EAC/C,IAAI,KAAK,QAAQ,MAAM,iBAAiB,IAAI;EAE5C,OAAO;CACT,EACF;CACA,UAAU;EACR,cAAc,QAAQ;GAEpB,MAAM,UAAUA,IAAQ;GAExB,IAAI,CAAC,SAAS;GAGd,IAAI,OAAO,QAAQ,WAAW,YAAY;IACxC,MAAM,OAAO,QAAQ,OAAO;IAC5B,IAAI,QAAQ,OAAO,SAAS,UAC1B,OAAO;GAEX;GAIA,IAAI,OAAO,QAAQ,QAAQ,YAAY;IACrC,MAAM,SAAiC,CAAC;IAUxC,KAAK,MAAM,OAAO;KARhB;KACA;KACA;KACA;KACA;KACA;KACA;IAE2B,GAAG;KAC9B,MAAM,QAAQ,QAAQ,IAAI,GAAG;KAC7B,IAAI,OACF,OAAO,OAAO;IAElB;IACA,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GAC/B,OAAO;GAEX;GAGA,IAAI,OAAO,QAAQ,YAAY,YAAY;IACzC,MAAM,SAAiC,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,UAAU,QAAQ,QAAQ,GACzC,IAAI,OAAO,QAAQ,YAAY,OAAO,UAAU,UAC9C,OAAO,OAAO;IAGlB,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GAC/B,OAAO;GAEX;EAGF;EACA,mBAAmB,MAAM,QAAQ;GAC/B,MAAM,UAAU;GAChB,MAAM,QAAwC,CAAC;GAE/C,IAAI,QAAQ,SAAS,MAAM,kBAAkB,QAAQ;GACrD,IAAI,QAAQ,OAAO,MAAM,mBAAmB,QAAQ;GACpD,IAAI,QAAQ,MAAM,QAAQ,MAAM,iBAAiB,QAAQ,KAAK;GAC9D,IAAI,QAAQ,MAAM,UAChB,MAAM,mBAAmB,QAAQ,KAAK;GACxC,IAAI,QAAQ,MAAM,oBAAoB,QACpC,MAAM,0BAA0B,QAAQ,KAAK;GAE/C,IAAI,QAAQ,MAAM,YAAY,QAC5B,MAAM,kBAAkB,QAAQ,KAAK;GAGvC,OAAO;EACT;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,MAAa,kBAAoC;CAC/C,UAAU,EACR,mBAAmB,MAAM,SAAS;EAChC,MAAM,OAAO,KAAK;EAClB,MAAM,QAAwC,CAAC;EAE/C,IAAI,MAAM,YAAY,MAAM,0BAA0B,KAAK;EAC3D,IAAI,MAAM,OAAO,MAAM,qBAAqB,KAAK;EACjD,IAAI,MAAM,WAAW,MAAM,yBAAyB,KAAK;EACzD,IAAI,MAAM,cACR,MAAM,4BAA4B,KAAK;EAEzC,OAAO;CACT,EACF;CACA,UAAU,EACR,mBAAmB,MAAM,QAAQ;EAC/B,MAAM,OAAO;EACb,MAAM,QAAwC,CAAC;EAE/C,IAAI,KAAK,YAAY,MAAM,0BAA0B,KAAK;EAC1D,IAAI,KAAK,OAAO,MAAM,qBAAqB,KAAK;EAChD,IAAI,KAAK,YAAY,MAAM,0BAA0B,KAAK;EAC1D,IAAI,KAAK,WAAW,MAAM,yBAAyB,KAAK;EACxD,IAAI,KAAK,YAAY,QAAW,MAAM,sBAAsB,KAAK;EACjE,IAAI,KAAK,cACP,MAAM,4BAA4B,KAAK;EAEzC,OAAO;CACT,EACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,0BAA4C,EACvD,UAAU,EACR,mBAAmB,MAAM,QAAQ;CAC/B,MAAM,QAAQ;CACd,MAAM,QAAwC,CAAC;CAE/C,IAAI,MAAM,IAAI,MAAM,iCAAiC,MAAM;CAC3D,IAAI,MAAM,WACR,MAAM,mCAAmC,MAAM,UAAU,QAAQ;CAEnE,IAAI,MAAM,aAAa,QACrB,MAAM,+BAA+B,MAAM;CAG7C,OAAO;AACT,EACF,EACF;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,wBACd,SACoB;CACpB,MAAM,iBAAiB,QAAQ;CAC/B,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,mBAAmB,QAAQ;CAEjC,IAAI,CAAC,kBAAkB,CAAC,eAAe,OAAO;CAI9C,IAAI;CACJ,IAAI;CAEJ,IAAI;EAGF,cAAc,OAAO,cAAc,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,GAAG;EAElE,aAAa,OAAO,aAAa,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,GAAG;CAClE,QAAQ;EAEN,OAAO;CACT;CAOA,OAAO;EACL,SAAS;EACT,QAAQ;EACR,aAPc,mBACZ,OAAO,SAAS,kBAAkB,EAAE,IAAI,IACxC,QAKoB,WAAW,UAAU,WAAW;EACtD,UAAU;CACZ;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,mBACd,SACoB;CAEpB,MAAM,WAAW,QAAQ,SAAS,QAAQ;CAC1C,IAAI,UAAU;EAEZ,IAAI,aAAa,KAAK,OAAO;EAE7B,MAAM,QAAQ,SAAS,MAAM,GAAG;EAChC,MAAM,UAAU,MAAM;EACtB,MAAM,SAAS,MAAM;EACrB,MAAM,cAAc,MAAM;EAE1B,IAAI,WAAW,QAAQ;GACrB,MAAM,UAAU,gBAAgB,OAAO,gBAAgB;GAEvD,OAAO;IACL,SAAS,QAAQ,SAAS,IAAI,GAAG;IACjC,QAAQ,OAAO,SAAS,IAAI,GAAG;IAC/B,YAAY,UAAU,WAAW,UAAU,WAAW;IACtD,UAAU;GACZ;EACF;CACF;CAGA,MAAM,UACJ,QAAQ,mBACR,QAAQ,mBACR,QAAQ;CACV,MAAM,SACJ,QAAQ,kBAAkB,QAAQ,kBAAkB,QAAQ;CAC9D,MAAM,gBACJ,QAAQ,mBACR,QAAQ,mBACR,QAAQ,iBACR,QAAQ;CAEV,IAAI,CAAC,WAAW,CAAC,QAAQ,OAAO;CAIhC,MAAM,UACJ,kBAAkB,OAClB,kBAAkB,UAClB,kBAAkB;CAEpB,OAAO;EACL,SAAS,QAAQ,SAAS,IAAI,GAAG;EACjC,QAAQ,OAAO,SAAS,IAAI,GAAG;EAC/B,YAAY,UAAU,WAAW,UAAU,WAAW;EACtD,UAAU;CACZ;AACF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,qBACd,SACoB;CACpB,MAAM,aAAa,QAAQ,sBAAsB,QAAQ;CAEzD,IAAI,CAAC,YAAY,OAAO;CAGxB,MAAM,YAAY,WAAW,MAAM,sCAAsC;CACzE,MAAM,cAAc,WAAW,MAAM,wBAAwB;CAC7D,MAAM,eAAe,WAAW,MAAM,gBAAgB;CAEtD,IAAI,CAAC,aAAa,CAAC,aAAa,OAAO;CAGvC,MAAM,YAAY,UAAU;CAC5B,MAAM,SAAS,UAAU;CACzB,MAAM,WAAW,YAAY;CAE7B,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,UAAU,OAAO;CAM/C,OAAO;EACL,YALiB,YAAY;EAM7B;EACA,aALc,eAAe,aAAa,OAAO,MAAM,QAKjC,WAAW,UAAU,WAAW;EACtD,UAAU;CACZ;AACF"}

package/dist/messaging-testing.d.cts

@@ -1,6 +1,5 @@
 import { OutOfOrderInfo, RebalanceEvent } from "./messaging.cjs";
 import { Link, SpanContext } from "@opentelemetry/api";
-
 //#region src/messaging-testing.d.ts
 /**
  * Recorded producer call

package/dist/messaging-testing.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-testing.d.cts","names":[],"sources":["../src/messaging-testing.ts"],"mappings":"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"}
+{"version":3,"file":"messaging-testing.d.cts","names":[],"sources":["../src/messaging-testing.ts"],"mappings":";;;;;;UA4CiB;;EAEf;;EAGA;;EAGA;;EAGA,SAAS;;EAGT;;EAGA;;EAGA;;;;;UAMe;;EAEf;;EAGA;;EAGA;;EAGA;;EAGA,UAAU;;EAGV;;EAGA,eAAe;;EAGf;;EAGA,gBAAgB;;EAGhB;;EAGA;;;;;UAMe,+BAA+B;;EAE9C;;EAGA;;;;;UAMe,YAAY;;EAE3B,SAAS;;EAGT,UAAU;;EAGV;;EAGA;;EAGA;;EAGA;;EAGA;;;;;UAMe;;EAEf;;EAGA;;EAGA;;EAGA,kBAAkB;;EAGlB;;;;;UAMe;;EAEf;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA;;;;;UAMe;;EAEf,eAAe;;EAGf,eAAe;;EAGf,iBAAiB;;;;EAKjB,mBAAmB,MAAM,KAAK;;;;EAK9B,mBAAmB,MAAM,KAAK;;;;EAK9B,qBAAqB,OAAO;;;;EAK5B,kBAAkB,GAChB,SAAS,GACT,UAAU,QAAQ,YAAY,MAC7B,YAAY;;;;EAKf,uBACE,kBACA,kBACC;;;;EAKH,qBACE,qBACA,UAAU;;;;EAMZ,wBAAwB;;;;EAKxB,wBACE,qBACA,UAAU;;;;EAMZ,wBAAwB;;;;EAKxB,wBACE,qBACA,MAAM,wBACN;;;;EAMF,iBAAiB,uBAAuB;;;;EAKxC,iBAAiB,uBAAuB;;;;EAKxC,oBAAoB,uBAAuB;;;;EAK3C,oBAAoB,uBAAuB;;;;EAK3C;;;;EAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Cc,8BAA8B;;;;UA2S7B;;EAEf,QAAQ,YAAY;;;;EAKpB,QAAQ,eAAe,SAAS;;;;EAKhC,QAAQ,eAAe,iBAAiB;;;;EAKxC,KAAK,eAAe,iBAAiB;;;;EAKrC,gBAAgB;;;;EAKhB,MAAM;;;;EAKN,YAAY;;;;EAKZ,YAAY;;;;EAKZ;;;;;;;;;;;;;;;;;;;;iBAqBc,2BAA2B;;;;iBAsE3B,yBAAyB;;;;iBAWzB,wBAAwB;;;;iBAWxB,sBACd,kBACA,kBACC;;;;iBAYa,uBACd,kBACA,kBACC;;;;iBAgBa,uBAAuB,GACrC,UAAU,KACV;EACE;EACA;EACA;EACA;IAED,YAAY;;;;iBAoBC,wBACd,eACA,uBACA;EAEA,aAAa;EACb,aAAa;;;;;iBA+BC,yBAAyB,GACvC,UAAU,KACV,8BACC,YAAY;;;;iBAqBC,wBAAwB,GACtC,UAAU,KACV,6BACC,YAAY"}

package/dist/messaging-testing.d.ts

@@ -1,6 +1,5 @@
 import { OutOfOrderInfo, RebalanceEvent } from "./messaging.js";
 import { Link, SpanContext } from "@opentelemetry/api";
-
 //#region src/messaging-testing.d.ts
 /**
  * Recorded producer call

package/dist/messaging-testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging-testing.d.ts","names":[],"sources":["../src/messaging-testing.ts"],"mappings":"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"}
+{"version":3,"file":"messaging-testing.d.ts","names":[],"sources":["../src/messaging-testing.ts"],"mappings":";;;;;;UA4CiB;;EAEf;;EAGA;;EAGA;;EAGA,SAAS;;EAGT;;EAGA;;EAGA;;;;;UAMe;;EAEf;;EAGA;;EAGA;;EAGA;;EAGA,UAAU;;EAGV;;EAGA,eAAe;;EAGf;;EAGA,gBAAgB;;EAGhB;;EAGA;;;;;UAMe,+BAA+B;;EAE9C;;EAGA;;;;;UAMe,YAAY;;EAE3B,SAAS;;EAGT,UAAU;;EAGV;;EAGA;;EAGA;;EAGA;;EAGA;;;;;UAMe;;EAEf;;EAGA;;EAGA;;EAGA,kBAAkB;;EAGlB;;;;;UAMe;;EAEf;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA;;;;;UAMe;;EAEf,eAAe;;EAGf,eAAe;;EAGf,iBAAiB;;;;EAKjB,mBAAmB,MAAM,KAAK;;;;EAK9B,mBAAmB,MAAM,KAAK;;;;EAK9B,qBAAqB,OAAO;;;;EAK5B,kBAAkB,GAChB,SAAS,GACT,UAAU,QAAQ,YAAY,MAC7B,YAAY;;;;EAKf,uBACE,kBACA,kBACC;;;;EAKH,qBACE,qBACA,UAAU;;;;EAMZ,wBAAwB;;;;EAKxB,wBACE,qBACA,UAAU;;;;EAMZ,wBAAwB;;;;EAKxB,wBACE,qBACA,MAAM,wBACN;;;;EAMF,iBAAiB,uBAAuB;;;;EAKxC,iBAAiB,uBAAuB;;;;EAKxC,oBAAoB,uBAAuB;;;;EAK3C,oBAAoB,uBAAuB;;;;EAK3C;;;;EAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Cc,8BAA8B;;;;UA2S7B;;EAEf,QAAQ,YAAY;;;;EAKpB,QAAQ,eAAe,SAAS;;;;EAKhC,QAAQ,eAAe,iBAAiB;;;;EAKxC,KAAK,eAAe,iBAAiB;;;;EAKrC,gBAAgB;;;;EAKhB,MAAM;;;;EAKN,YAAY;;;;EAKZ,YAAY;;;;EAKZ;;;;;;;;;;;;;;;;;;;;iBAqBc,2BAA2B;;;;iBAsE3B,yBAAyB;;;;iBAWzB,wBAAwB;;;;iBAWxB,sBACd,kBACA,kBACC;;;;iBAYa,uBACd,kBACA,kBACC;;;;iBAgBa,uBAAuB,GACrC,UAAU,KACV;EACE;EACA;EACA;EACA;IAED,YAAY;;;;iBAoBC,wBACd,eACA,uBACA;EAEA,aAAa;EACb,aAAa;;;;;iBA+BC,yBAAyB,GACvC,UAAU,KACV,8BACC,YAAY;;;;iBAqBC,wBAAwB,GACtC,UAAU,KACV,6BACC,YAAY"}

package/dist/messaging.cjs

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_sampling = require('./sampling.cjs');
-const require_functional = require('./functional-CwsPyc4l.cjs');
+const require_functional = require('./functional-DcLBuCPz.cjs');
 const require_correlated_events = require('./correlated-events-kSwLo3mi.cjs');
+const require_trace_factory_validation = require('./trace-factory-validation-Dc8epn87.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/messaging.ts
@@ -91,12 +92,16 @@ let _opentelemetry_api = require("@opentelemetry/api");
 * ```
 */
 function traceProducer(config) {
-	const spanName = `${config.system}.publish ${config.destination}`;
+	if (!config || typeof config !== "object") throw new TypeError("traceProducer: config must be an object");
+	if (typeof config.system !== "string" || config.system.trim() === "") throw new TypeError("traceProducer: config.system must be a non-empty string");
+	if (typeof config.destination !== "string" || config.destination.trim() === "") throw new TypeError("traceProducer: config.destination must be a non-empty string");
+	const spanName = `publish ${config.destination}`;
 	return (fnFactory) => {
-		return require_functional.trace({
+		require_trace_factory_validation.assertTraceFactory("traceProducer", fnFactory);
+		return require_functional.withTracing({
 			name: spanName,
 			spanKind: _opentelemetry_api.SpanKind.PRODUCER
-		}, (baseCtx) => {
+		})((baseCtx) => {
 			const ctx = extendContextForProducer(baseCtx, config);
 			setProducerAttributes(ctx, config);
 			return (...args) => {
@@ -106,7 +111,9 @@ function traceProducer(config) {
 					for (const [key, value] of Object.entries(customAttrs)) if (value !== void 0 && value !== null) ctx.setAttribute(key, value);
 				}
 				if (config.beforeSend) config.beforeSend(ctx, args);
-				return fnFactory(ctx)(...args).catch((error) => {
+				const userFn = fnFactory(ctx);
+				require_trace_factory_validation.assertTraceFactory("traceProducer", userFn, "result");
+				return Promise.resolve(userFn(...args)).catch((error) => {
 					if (config.onError) config.onError(error, ctx);
 					throw error;
 				});
@@ -183,13 +190,16 @@ function traceProducer(config) {
 * ```
 */
 function traceConsumer(config) {
-	const operation = config.batchMode ? "receive" : "process";
-	const spanName = `${config.system}.${operation} ${config.destination}`;
+	if (!config || typeof config !== "object") throw new TypeError("traceConsumer: config must be an object");
+	if (typeof config.system !== "string" || config.system.trim() === "") throw new TypeError("traceConsumer: config.system must be a non-empty string");
+	if (typeof config.destination !== "string" || config.destination.trim() === "") throw new TypeError("traceConsumer: config.destination must be a non-empty string");
+	const spanName = `${config.batchMode ? "receive" : "process"} ${config.destination}`;
 	return (fnFactory) => {
-		return require_functional.trace({
+		require_trace_factory_validation.assertTraceFactory("traceConsumer", fnFactory);
+		return require_functional.withTracing({
 			name: spanName,
 			spanKind: _opentelemetry_api.SpanKind.CONSUMER
-		}, (baseCtx) => {
+		})((baseCtx) => {
 			const linkStorage = { links: [] };
 			const orderingState = {
 				sequenceNumber: null,
@@ -221,7 +231,9 @@ function traceConsumer(config) {
 						for (const [key, value] of Object.entries(customAttrs)) if (value !== void 0 && value !== null) ctx.setAttribute(key, value);
 					}
 				}
-				return fnFactory(ctx)(...args).catch((error) => {
+				const userFn = fnFactory(ctx);
+				require_trace_factory_validation.assertTraceFactory("traceConsumer", userFn, "result");
+				return Promise.resolve(userFn(...args)).catch((error) => {
 					if (config.onError) config.onError(error, ctx);
 					throw error;
 				});
@@ -457,6 +469,8 @@ function extendContextForConsumer(baseCtx, config, linkStorage, orderingState, g
 */
 function setProducerAttributes(ctx, config) {
 	ctx.setAttribute("messaging.system", config.system);
+	ctx.setAttribute("messaging.operation.name", "publish");
+	ctx.setAttribute("messaging.operation.type", "send");
 	ctx.setAttribute("messaging.operation", "publish");
 	ctx.setAttribute("messaging.destination.name", config.destination);
 	if (config.system === "kafka") ctx.setAttribute("messaging.kafka.destination.topic", config.destination);
@@ -484,9 +498,12 @@ function setDynamicProducerAttributes(ctx, config, args) {
 */
 function setConsumerAttributes(ctx, config) {
 	ctx.setAttribute("messaging.system", config.system);
+	ctx.setAttribute("messaging.operation.name", config.batchMode ? "receive" : "process");
+	ctx.setAttribute("messaging.operation.type", config.batchMode ? "receive" : "process");
 	ctx.setAttribute("messaging.operation", config.batchMode ? "receive" : "process");
 	ctx.setAttribute("messaging.destination.name", config.destination);
 	if (config.consumerGroup) {
+		ctx.setAttribute("messaging.consumer.group.name", config.consumerGroup);
 		ctx.setAttribute("messaging.consumer.group", config.consumerGroup);
 		if (config.system === "kafka") ctx.setAttribute("messaging.kafka.consumer.group", config.consumerGroup);
 	}