autotel 6.1.0 → 6.2.1

package/dist/init-XzXzrarP.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"init-XzXzrarP.d.cts","names":[],"sources":["../src/validation.ts","../src/redact-values.ts","../src/events-config.ts","../src/devtools.ts","../src/process-handlers.ts","../src/init.ts"],"mappings":"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"}

package/dist/instrumentation.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"instrumentation.cjs","names":["processDetector","hostDetector","safeRequire","ATTR_SERVICE_NAME","ATTR_SERVICE_VERSION","requireModule","TailSamplingSpanProcessor","BatchSpanProcessor","OTLPTraceExporter","NodeSDK","PeriodicExportingMetricReader","OTLPMetricExporter","BatchLogRecordProcessor","OTLPLogExporter"],"sources":["../src/instrumentation.ts"],"sourcesContent":["import { NodeSDK } from '@opentelemetry/sdk-node';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';\nimport { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';\nimport { TailSamplingSpanProcessor } from './tail-sampling-processor';\nimport { getLogger } from './init';\nimport {\n  resourceFromAttributes,\n  detectResources,\n  processDetector,\n  hostDetector,\n  type Resource,\n  type ResourceDetector,\n} from '@opentelemetry/resources';\nimport {\n  ATTR_SERVICE_NAME,\n  ATTR_SERVICE_VERSION,\n} from '@opentelemetry/semantic-conventions/incubating';\nimport { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';\nimport { PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';\nimport { requireModule, safeRequire } from './node-require';\n\n/**\n * Parse OTLP headers string into object format\n * @param headersString - Headers as \"key1=value1,key2=value2\" or \"Authorization=Basic ...\"\n * @returns Headers object for OTLP exporters\n */\nfunction parseOtlpHeaders(headersString?: string): Record<string, string> {\n  if (!headersString) return {};\n\n  const headers: Record<string, string> = {};\n  const pairs = headersString.split(',');\n\n  for (const pair of pairs) {\n    const [key, ...valueParts] = pair.split('=');\n    if (key && valueParts.length > 0) {\n      headers[key.trim()] = valueParts.join('=').trim();\n    }\n  }\n\n  return headers;\n}\n\n/**\n * Parse resource attributes string into object format\n * @param attributesString - Attributes as \"key1=value1,key2=value2\"\n * @returns Resource attributes object\n */\nfunction parseResourceAttributes(\n  attributesString?: string,\n): Record<string, string> {\n  if (!attributesString) return {};\n\n  const attributes: Record<string, string> = {};\n  const pairs = attributesString.split(',');\n\n  for (const pair of pairs) {\n    const [key, ...valueParts] = pair.split('=');\n    if (key && valueParts.length > 0) {\n      attributes[key.trim()] = valueParts.join('=').trim();\n    }\n  }\n\n  return attributes;\n}\n\nexport interface InstrumentationConfig {\n  serviceName: string;\n  serviceVersion?: string;\n  deploymentEnvironment?: string;\n  otlpEndpoint?: string;\n  /** Headers for authentication (e.g., Grafana Cloud, Honeycomb) */\n  headers?: string;\n  /** Resource attributes as comma-separated key=value pairs */\n  resourceAttributes?: string;\n  /** Enable async resource detection for process/host info (default: false) */\n  detectResources?: boolean;\n  /**\n   * Use selective instrumentation instead of full auto-instrumentation\n   * **Default: true** (performance-first)\n   *\n   * When true, auto-instrumentation is disabled. You can manually add\n   * specific instrumentations via the `instrumentations` field.\n   * This reduces overhead from ~81% to near-zero based on Platformatic benchmarks.\n   *\n   * Set to false to enable full auto-instrumentation (not recommended for production).\n   *\n   * @see https://blogger.platformatic.dev/the-hidden-cost-of-context\n   */\n  selectiveInstrumentation?: boolean;\n\n  /**\n   * Custom instrumentations to use (only when selectiveInstrumentation is true)\n   * @example\n   * ```typescript\n   * import { HttpInstrumentation } from '@opentelemetry/instrumentation-http'\n   *\n   * initInstrumentation({\n   *   serviceName: 'api',\n   *   selectiveInstrumentation: true,\n   *   instrumentations: [new HttpInstrumentation()]\n   * })\n   * ```\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  instrumentations?: any[];\n}\n\n/**\n * Initialize OpenTelemetry instrumentation with OTLP exporters\n *\n * This sets up:\n * - Traces (OTLP HTTP)\n * - Metrics (OTLP HTTP)\n * - Logs (OTLP HTTP)\n * - Auto-instrumentation for common Node.js libraries\n *\n * @example\n * // Call this at the very start of your application\n * import { initInstrumentation } from '@your-org/otel-decorators'\n *\n * initInstrumentation({\n *   serviceName: 'my-service' }\n *   serviceVersion: '1.0.0',\n *   deploymentEnvironment: 'production',\n *   otlpEndpoint: 'http://localhost:4318'\n * })\n *\n * // Or with async resource detection (top-level await required)\n * await initInstrumentation({\n *   serviceName: 'my-service' }\n *   detectResources: true\n * })\n */\n// Enables graceful shutdown and prevents SDK leaks on hot-reload\nlet currentSDK: NodeSDK | null = null;\nlet shutdownHandlerRegistered = false;\n\n/**\n * Shutdown the OpenTelemetry SDK gracefully\n * Call this before process exit or during hot-reloads\n */\nexport async function shutdownInstrumentation(sdk?: NodeSDK): Promise<void> {\n  const sdkToShutdown = sdk || currentSDK;\n  if (!sdkToShutdown) {\n    getLogger().warn({}, 'No SDK to shutdown');\n    return;\n  }\n\n  try {\n    await sdkToShutdown.shutdown();\n    getLogger().info({}, 'OpenTelemetry terminated successfully');\n    if (sdkToShutdown === currentSDK) {\n      currentSDK = null;\n    }\n  } catch (error) {\n    getLogger().error(\n      {\n        err: error instanceof Error ? error : undefined,\n      },\n      'Error terminating OpenTelemetry',\n    );\n    throw error;\n  }\n}\n\nexport async function initInstrumentation(\n  config: InstrumentationConfig,\n): Promise<NodeSDK> {\n  // Prevents resource leaks on hot-reload or multiple init calls\n  if (currentSDK) {\n    getLogger().info(\n      {},\n      'Shutting down existing OpenTelemetry SDK before reinitializing...',\n    );\n    await shutdownInstrumentation(currentSDK);\n  }\n\n  // Parse headers and resource attributes\n  const otlpHeaders = parseOtlpHeaders(config.headers);\n  const customResourceAttributes = parseResourceAttributes(\n    config.resourceAttributes,\n  );\n\n  let resource: Resource;\n\n  // Optional resource detectors: absent unless the host installed them.\n  // safeRequire returns undefined for a missing module and rethrows anything\n  // else, so a broken install still surfaces instead of being swallowed.\n  const detectors: ResourceDetector[] = [processDetector, hostDetector];\n\n  const awsDetectors = safeRequire<{\n    awsEc2Detector: ResourceDetector;\n    awsEcsDetector: ResourceDetector;\n    awsEksDetector: ResourceDetector;\n  }>('@opentelemetry/resource-detector-aws');\n  if (awsDetectors) {\n    detectors.push(\n      awsDetectors.awsEc2Detector,\n      awsDetectors.awsEcsDetector,\n      awsDetectors.awsEksDetector,\n    );\n  }\n\n  const gcpDetectors = safeRequire<{ gcpDetector: ResourceDetector }>(\n    '@opentelemetry/resource-detector-gcp',\n  );\n  if (gcpDetectors) {\n    detectors.push(gcpDetectors.gcpDetector);\n  }\n\n  const containerDetectors = safeRequire<{\n    containerDetector: ResourceDetector;\n  }>('@opentelemetry/resource-detector-container');\n  if (containerDetectors) {\n    detectors.push(containerDetectors.containerDetector);\n  }\n\n  if (config.detectResources) {\n    const detectedResource = await detectResources({\n      detectors,\n    });\n\n    resource = detectedResource.merge(\n      resourceFromAttributes({\n        [ATTR_SERVICE_NAME]: config.serviceName,\n        [ATTR_SERVICE_VERSION]: config.serviceVersion || '1.0.0',\n        'deployment.environment': config.deploymentEnvironment || 'development',\n        ...customResourceAttributes, // Merge custom resource attributes\n      }),\n    );\n  } else {\n    resource = resourceFromAttributes({\n      [ATTR_SERVICE_NAME]: config.serviceName,\n      [ATTR_SERVICE_VERSION]: config.serviceVersion || '1.0.0',\n      'deployment.environment': config.deploymentEnvironment || 'development',\n      ...customResourceAttributes, // Merge custom resource attributes\n    });\n  }\n\n  // Default to selective (near-zero overhead) vs full auto (~81% overhead)\n  // Lazy-load to avoid importing ~40+ packages at module evaluation time\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let instrumentations: any[] = config.instrumentations || [];\n  if (config.selectiveInstrumentation === false) {\n    const mod = requireModule<{\n      getNodeAutoInstrumentations: () => unknown[];\n    }>('@opentelemetry/auto-instrumentations-node');\n    instrumentations = [mod.getNodeAutoInstrumentations()];\n  }\n\n  const traceExporter = new OTLPTraceExporter({\n    url: `${config.otlpEndpoint || 'http://localhost:4318'}/v1/traces`,\n    headers: otlpHeaders,\n  });\n\n  // Enables tail sampling via autotel.sampling.tail.keep attribute\n  const spanProcessor = new TailSamplingSpanProcessor(\n    new BatchSpanProcessor(traceExporter),\n  );\n\n  const sdk = new NodeSDK({\n    resource,\n    spanProcessor, // Use our wrapped processor instead of traceExporter directly\n    metricReader: new PeriodicExportingMetricReader({\n      exporter: new OTLPMetricExporter({\n        url: `${config.otlpEndpoint || 'http://localhost:4318'}/v1/metrics`,\n        headers: otlpHeaders,\n      }),\n    }),\n    logRecordProcessors: [\n      new BatchLogRecordProcessor({\n        exporter: new OTLPLogExporter({\n          url: `${config.otlpEndpoint || 'http://localhost:4318'}/v1/logs`,\n          headers: otlpHeaders,\n        }),\n      }),\n    ],\n    instrumentations,\n  });\n\n  try {\n    await sdk.start();\n    getLogger().info({}, 'OpenTelemetry instrumentation started successfully');\n  } catch (error) {\n    getLogger().error(\n      {\n        err: error instanceof Error ? error : undefined,\n      },\n      'Failed to start OpenTelemetry SDK',\n    );\n    throw error;\n  }\n\n  // Track current SDK for shutdown handler\n  currentSDK = sdk;\n\n  if (!shutdownHandlerRegistered) {\n    shutdownHandlerRegistered = true;\n\n    const shutdownHandler = () => {\n      shutdownInstrumentation()\n        .then(() => {\n          // eslint-disable-next-line unicorn/no-process-exit\n          process.exit(0);\n        })\n        .catch((error) => {\n          getLogger().error(\n            {\n              err: error instanceof Error ? error : undefined,\n            },\n            'Shutdown error',\n          );\n          // eslint-disable-next-line unicorn/no-process-exit\n          process.exit(1);\n        });\n    };\n\n    process.on('SIGTERM', shutdownHandler);\n    process.on('SIGINT', shutdownHandler);\n  }\n\n  return sdk;\n}\n"],"mappings":"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"}

package/dist/instrumentation.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"instrumentation.d.cts","names":[],"sources":["../src/instrumentation.ts"],"mappings":";;UAmEiB;EACf;EACA;EACA;EACA;;EAEA;;EAEA;;EAEA;;;;;;;;;;;;;EAaA;;;;;;;;;;;;;;EAgBA;;;;;;iBAqCoB,wBAAwB,MAAM,UAAU;iBAwBxC,oBACpB,QAAQ,wBACP,QAAQ"}

package/dist/instrumentation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"instrumentation.d.ts","names":[],"sources":["../src/instrumentation.ts"],"mappings":";;UAmEiB;EACf;EACA;EACA;EACA;;EAEA;;EAEA;;EAEA;;;;;;;;;;;;;EAaA;;;;;;;;;;;;;;EAgBA;;;;;;iBAqCoB,wBAAwB,MAAM,UAAU;iBAwBxC,oBACpB,QAAQ,wBACP,QAAQ"}

package/dist/instrumentation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"instrumentation.js","names":[],"sources":["../src/instrumentation.ts"],"sourcesContent":["import { NodeSDK } from '@opentelemetry/sdk-node';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';\nimport { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';\nimport { TailSamplingSpanProcessor } from './tail-sampling-processor';\nimport { getLogger } from './init';\nimport {\n  resourceFromAttributes,\n  detectResources,\n  processDetector,\n  hostDetector,\n  type Resource,\n  type ResourceDetector,\n} from '@opentelemetry/resources';\nimport {\n  ATTR_SERVICE_NAME,\n  ATTR_SERVICE_VERSION,\n} from '@opentelemetry/semantic-conventions/incubating';\nimport { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';\nimport { PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';\nimport { requireModule, safeRequire } from './node-require';\n\n/**\n * Parse OTLP headers string into object format\n * @param headersString - Headers as \"key1=value1,key2=value2\" or \"Authorization=Basic ...\"\n * @returns Headers object for OTLP exporters\n */\nfunction parseOtlpHeaders(headersString?: string): Record<string, string> {\n  if (!headersString) return {};\n\n  const headers: Record<string, string> = {};\n  const pairs = headersString.split(',');\n\n  for (const pair of pairs) {\n    const [key, ...valueParts] = pair.split('=');\n    if (key && valueParts.length > 0) {\n      headers[key.trim()] = valueParts.join('=').trim();\n    }\n  }\n\n  return headers;\n}\n\n/**\n * Parse resource attributes string into object format\n * @param attributesString - Attributes as \"key1=value1,key2=value2\"\n * @returns Resource attributes object\n */\nfunction parseResourceAttributes(\n  attributesString?: string,\n): Record<string, string> {\n  if (!attributesString) return {};\n\n  const attributes: Record<string, string> = {};\n  const pairs = attributesString.split(',');\n\n  for (const pair of pairs) {\n    const [key, ...valueParts] = pair.split('=');\n    if (key && valueParts.length > 0) {\n      attributes[key.trim()] = valueParts.join('=').trim();\n    }\n  }\n\n  return attributes;\n}\n\nexport interface InstrumentationConfig {\n  serviceName: string;\n  serviceVersion?: string;\n  deploymentEnvironment?: string;\n  otlpEndpoint?: string;\n  /** Headers for authentication (e.g., Grafana Cloud, Honeycomb) */\n  headers?: string;\n  /** Resource attributes as comma-separated key=value pairs */\n  resourceAttributes?: string;\n  /** Enable async resource detection for process/host info (default: false) */\n  detectResources?: boolean;\n  /**\n   * Use selective instrumentation instead of full auto-instrumentation\n   * **Default: true** (performance-first)\n   *\n   * When true, auto-instrumentation is disabled. You can manually add\n   * specific instrumentations via the `instrumentations` field.\n   * This reduces overhead from ~81% to near-zero based on Platformatic benchmarks.\n   *\n   * Set to false to enable full auto-instrumentation (not recommended for production).\n   *\n   * @see https://blogger.platformatic.dev/the-hidden-cost-of-context\n   */\n  selectiveInstrumentation?: boolean;\n\n  /**\n   * Custom instrumentations to use (only when selectiveInstrumentation is true)\n   * @example\n   * ```typescript\n   * import { HttpInstrumentation } from '@opentelemetry/instrumentation-http'\n   *\n   * initInstrumentation({\n   *   serviceName: 'api',\n   *   selectiveInstrumentation: true,\n   *   instrumentations: [new HttpInstrumentation()]\n   * })\n   * ```\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  instrumentations?: any[];\n}\n\n/**\n * Initialize OpenTelemetry instrumentation with OTLP exporters\n *\n * This sets up:\n * - Traces (OTLP HTTP)\n * - Metrics (OTLP HTTP)\n * - Logs (OTLP HTTP)\n * - Auto-instrumentation for common Node.js libraries\n *\n * @example\n * // Call this at the very start of your application\n * import { initInstrumentation } from '@your-org/otel-decorators'\n *\n * initInstrumentation({\n *   serviceName: 'my-service' }\n *   serviceVersion: '1.0.0',\n *   deploymentEnvironment: 'production',\n *   otlpEndpoint: 'http://localhost:4318'\n * })\n *\n * // Or with async resource detection (top-level await required)\n * await initInstrumentation({\n *   serviceName: 'my-service' }\n *   detectResources: true\n * })\n */\n// Enables graceful shutdown and prevents SDK leaks on hot-reload\nlet currentSDK: NodeSDK | null = null;\nlet shutdownHandlerRegistered = false;\n\n/**\n * Shutdown the OpenTelemetry SDK gracefully\n * Call this before process exit or during hot-reloads\n */\nexport async function shutdownInstrumentation(sdk?: NodeSDK): Promise<void> {\n  const sdkToShutdown = sdk || currentSDK;\n  if (!sdkToShutdown) {\n    getLogger().warn({}, 'No SDK to shutdown');\n    return;\n  }\n\n  try {\n    await sdkToShutdown.shutdown();\n    getLogger().info({}, 'OpenTelemetry terminated successfully');\n    if (sdkToShutdown === currentSDK) {\n      currentSDK = null;\n    }\n  } catch (error) {\n    getLogger().error(\n      {\n        err: error instanceof Error ? error : undefined,\n      },\n      'Error terminating OpenTelemetry',\n    );\n    throw error;\n  }\n}\n\nexport async function initInstrumentation(\n  config: InstrumentationConfig,\n): Promise<NodeSDK> {\n  // Prevents resource leaks on hot-reload or multiple init calls\n  if (currentSDK) {\n    getLogger().info(\n      {},\n      'Shutting down existing OpenTelemetry SDK before reinitializing...',\n    );\n    await shutdownInstrumentation(currentSDK);\n  }\n\n  // Parse headers and resource attributes\n  const otlpHeaders = parseOtlpHeaders(config.headers);\n  const customResourceAttributes = parseResourceAttributes(\n    config.resourceAttributes,\n  );\n\n  let resource: Resource;\n\n  // Optional resource detectors: absent unless the host installed them.\n  // safeRequire returns undefined for a missing module and rethrows anything\n  // else, so a broken install still surfaces instead of being swallowed.\n  const detectors: ResourceDetector[] = [processDetector, hostDetector];\n\n  const awsDetectors = safeRequire<{\n    awsEc2Detector: ResourceDetector;\n    awsEcsDetector: ResourceDetector;\n    awsEksDetector: ResourceDetector;\n  }>('@opentelemetry/resource-detector-aws');\n  if (awsDetectors) {\n    detectors.push(\n      awsDetectors.awsEc2Detector,\n      awsDetectors.awsEcsDetector,\n      awsDetectors.awsEksDetector,\n    );\n  }\n\n  const gcpDetectors = safeRequire<{ gcpDetector: ResourceDetector }>(\n    '@opentelemetry/resource-detector-gcp',\n  );\n  if (gcpDetectors) {\n    detectors.push(gcpDetectors.gcpDetector);\n  }\n\n  const containerDetectors = safeRequire<{\n    containerDetector: ResourceDetector;\n  }>('@opentelemetry/resource-detector-container');\n  if (containerDetectors) {\n    detectors.push(containerDetectors.containerDetector);\n  }\n\n  if (config.detectResources) {\n    const detectedResource = await detectResources({\n      detectors,\n    });\n\n    resource = detectedResource.merge(\n      resourceFromAttributes({\n        [ATTR_SERVICE_NAME]: config.serviceName,\n        [ATTR_SERVICE_VERSION]: config.serviceVersion || '1.0.0',\n        'deployment.environment': config.deploymentEnvironment || 'development',\n        ...customResourceAttributes, // Merge custom resource attributes\n      }),\n    );\n  } else {\n    resource = resourceFromAttributes({\n      [ATTR_SERVICE_NAME]: config.serviceName,\n      [ATTR_SERVICE_VERSION]: config.serviceVersion || '1.0.0',\n      'deployment.environment': config.deploymentEnvironment || 'development',\n      ...customResourceAttributes, // Merge custom resource attributes\n    });\n  }\n\n  // Default to selective (near-zero overhead) vs full auto (~81% overhead)\n  // Lazy-load to avoid importing ~40+ packages at module evaluation time\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let instrumentations: any[] = config.instrumentations || [];\n  if (config.selectiveInstrumentation === false) {\n    const mod = requireModule<{\n      getNodeAutoInstrumentations: () => unknown[];\n    }>('@opentelemetry/auto-instrumentations-node');\n    instrumentations = [mod.getNodeAutoInstrumentations()];\n  }\n\n  const traceExporter = new OTLPTraceExporter({\n    url: `${config.otlpEndpoint || 'http://localhost:4318'}/v1/traces`,\n    headers: otlpHeaders,\n  });\n\n  // Enables tail sampling via autotel.sampling.tail.keep attribute\n  const spanProcessor = new TailSamplingSpanProcessor(\n    new BatchSpanProcessor(traceExporter),\n  );\n\n  const sdk = new NodeSDK({\n    resource,\n    spanProcessor, // Use our wrapped processor instead of traceExporter directly\n    metricReader: new PeriodicExportingMetricReader({\n      exporter: new OTLPMetricExporter({\n        url: `${config.otlpEndpoint || 'http://localhost:4318'}/v1/metrics`,\n        headers: otlpHeaders,\n      }),\n    }),\n    logRecordProcessors: [\n      new BatchLogRecordProcessor({\n        exporter: new OTLPLogExporter({\n          url: `${config.otlpEndpoint || 'http://localhost:4318'}/v1/logs`,\n          headers: otlpHeaders,\n        }),\n      }),\n    ],\n    instrumentations,\n  });\n\n  try {\n    await sdk.start();\n    getLogger().info({}, 'OpenTelemetry instrumentation started successfully');\n  } catch (error) {\n    getLogger().error(\n      {\n        err: error instanceof Error ? error : undefined,\n      },\n      'Failed to start OpenTelemetry SDK',\n    );\n    throw error;\n  }\n\n  // Track current SDK for shutdown handler\n  currentSDK = sdk;\n\n  if (!shutdownHandlerRegistered) {\n    shutdownHandlerRegistered = true;\n\n    const shutdownHandler = () => {\n      shutdownInstrumentation()\n        .then(() => {\n          // eslint-disable-next-line unicorn/no-process-exit\n          process.exit(0);\n        })\n        .catch((error) => {\n          getLogger().error(\n            {\n              err: error instanceof Error ? error : undefined,\n            },\n            'Shutdown error',\n          );\n          // eslint-disable-next-line unicorn/no-process-exit\n          process.exit(1);\n        });\n    };\n\n    process.on('SIGTERM', shutdownHandler);\n    process.on('SIGINT', shutdownHandler);\n  }\n\n  return sdk;\n}\n"],"mappings":"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"}

package/dist/logger-CN4xpzMd.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger-CN4xpzMd.d.cts","names":[],"sources":["../src/autotel-logger.ts","../src/logger.ts"],"mappings":";;KA4CY;;;;;iBAWI,qBAAqB;;;;;;;;;;;;;;;;;;;iBAuBrB,gBAAgB,GAC9B,OAAO,iBACP,gBAAgB,IACf;;;;;;;;;;;;;;iBAsCa;EA5BL;EACD;EACO;;UA8BA;;EAEf,QAAQ;;EAER;;;;;;;;;;;;;;;;;;;;;;iBAuBc,oBACd,iBACA,UAAU,uBACT;;;;;;;;;;;;;;;;;;;;iBAwMa,cAAc;EAC5B;EACA,QAAQ;EACR;IACE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cC1OS;;;;;;KAOD,mBAAmB,wBAAwB;;;;UAKtC;EACf;EACA,QAAQ;EACR;EACA;;;;;;;;;;;;;;;;UAiBe;GACd;GACA,KAAK,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;UA0BhB;EACf,MAAM;EACN,MAAM;EACN,OAAO;EACP,OAAO;;;;;;KAOG,UAAU;UAcL;;EAEf;;;;;;;;;;;;;;;;;;;;;;;;;iBA0Bc,gBACd,iCAAiC,0BAOhB,MAAM,wBAAwB,QAC7C,iBAAiB,MAAM,SAAS,MAAM,SAAS,QAAQ,SACvD,SAAS,4BACP,OACC,MAAM,SAAS,MAAM,SAAS,QAAQ,cAKlB,MAAM,SAAS,MAAM,SAAO,QAAQ"}

package/dist/logger-CN4xpzMd.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger-CN4xpzMd.d.ts","names":[],"sources":["../src/autotel-logger.ts","../src/logger.ts"],"mappings":";;KA4CY;;;;;iBAWI,qBAAqB;;;;;;;;;;;;;;;;;;;iBAuBrB,gBAAgB,GAC9B,OAAO,iBACP,gBAAgB,IACf;;;;;;;;;;;;;;iBAsCa;EA5BL;EACD;EACO;;UA8BA;;EAEf,QAAQ;;EAER;;;;;;;;;;;;;;;;;;;;;;iBAuBc,oBACd,iBACA,UAAU,uBACT;;;;;;;;;;;;;;;;;;;;iBAwMa,cAAc;EAC5B;EACA,QAAQ;EACR;IACE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cC1OS;;;;;;KAOD,mBAAmB,wBAAwB;;;;UAKtC;EACf;EACA,QAAQ;EACR;EACA;;;;;;;;;;;;;;;;UAiBe;GACd;GACA,KAAK,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;UA0BhB;EACf,MAAM;EACN,MAAM;EACN,OAAO;EACP,OAAO;;;;;;KAOG,UAAU;UAcL;;EAEf;;;;;;;;;;;;;;;;;;;;;;;;;iBA0Bc,gBACd,iCAAiC,0BAOhB,MAAM,wBAAwB,QAC7C,iBAAiB,MAAM,SAAS,MAAM,SAAS,QAAQ,SACvD,SAAS,4BACP,OACC,MAAM,SAAS,MAAM,SAAS,QAAQ,cAKlB,MAAM,SAAS,MAAM,SAAO,QAAQ"}

package/dist/logger-D3Ej3DII.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger-D3Ej3DII.js","names":["api_context","extra"],"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":"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"}

package/dist/logger-thMPLpOG.cjs.map

@@ -1 +0,0 @@
-{"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":"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"}

package/dist/messaging-adapters.cjs.map

@@ -1 +0,0 @@
-{"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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,QAKoBC,8BAAW,UAAUA,8BAAW;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,UAAUA,8BAAW,UAAUA,8BAAW;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,UAAUA,8BAAW,UAAUA,8BAAW;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,QAKjCA,8BAAW,UAAUA,8BAAW;EACtD,UAAU;CACZ;AACF"}

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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 +0,0 @@
-{"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":"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"}

package/dist/messaging-testing.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"messaging-testing.cjs","names":[],"sources":["../src/messaging-testing.ts"],"sourcesContent":["/**\n * Testing utilities for messaging instrumentation\n *\n * Provides mock producers, consumers, and assertion helpers\n * for testing event-driven code with Autotel's messaging module.\n *\n * @example Basic test setup\n * ```typescript\n * import { createMessagingTestHarness } from 'autotel/messaging-testing';\n *\n * describe('Order processing', () => {\n *   const harness = createMessagingTestHarness();\n *\n *   beforeEach(() => harness.reset());\n *   afterAll(() => harness.shutdown());\n *\n *   it('should process order and publish event', async () => {\n *     await processOrder({ id: 'order-123' });\n *\n *     harness.assertProducerCalled('orders', {\n *       messageCount: 1,\n *       hasTraceHeaders: true,\n *     });\n *   });\n * });\n * ```\n *\n * @module\n */\n\nimport type { Link, SpanContext } from '@opentelemetry/api';\nimport type {\n  RebalanceEvent,\n  PartitionAssignment,\n  OutOfOrderInfo,\n} from './messaging';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Recorded producer call\n */\nexport interface RecordedProducerCall {\n  /** Destination (topic/queue) */\n  destination: string;\n\n  /** System (kafka, sqs, etc.) */\n  system: string;\n\n  /** Message payload */\n  payload: unknown;\n\n  /** Headers injected */\n  headers: Record<string, string>;\n\n  /** Timestamp of call */\n  timestamp: number;\n\n  /** Trace ID from headers */\n  traceId?: string;\n\n  /** Span ID from headers */\n  spanId?: string;\n}\n\n/**\n * Recorded consumer call\n */\nexport interface RecordedConsumerCall {\n  /** Destination (topic/queue) */\n  destination: string;\n\n  /** System (kafka, sqs, etc.) */\n  system: string;\n\n  /** Consumer group */\n  consumerGroup?: string;\n\n  /** Message payload */\n  payload: unknown;\n\n  /** Headers extracted */\n  headers?: Record<string, string>;\n\n  /** Timestamp of call */\n  timestamp: number;\n\n  /** Producer links extracted */\n  producerLinks: Link[];\n\n  /** Whether message was duplicate */\n  isDuplicate: boolean;\n\n  /** Out of order info if detected */\n  outOfOrderInfo: OutOfOrderInfo | null;\n\n  /** DLQ reason if routed to DLQ */\n  dlqReason?: string;\n\n  /** Retry attempt number */\n  retryAttempt?: number;\n}\n\n/**\n * Recorded rebalance event\n */\nexport interface RecordedRebalanceEvent extends RebalanceEvent {\n  /** Destination (topic) */\n  destination: string;\n\n  /** Consumer group */\n  consumerGroup: string;\n}\n\n/**\n * Mock message for testing\n */\nexport interface MockMessage<T = unknown> {\n  /** Message payload */\n  payload: T;\n\n  /** Headers */\n  headers?: Record<string, string>;\n\n  /** Offset/sequence number */\n  offset?: number;\n\n  /** Partition */\n  partition?: number;\n\n  /** Key */\n  key?: string;\n\n  /** Message ID */\n  messageId?: string;\n\n  /** Timestamp */\n  timestamp?: number;\n}\n\n/**\n * Producer assertion options\n */\nexport interface ProducerAssertionOptions {\n  /** Expected number of messages */\n  messageCount?: number;\n\n  /** Whether trace headers should be present */\n  hasTraceHeaders?: boolean;\n\n  /** Expected destination */\n  destination?: string;\n\n  /** Custom matcher for payload */\n  payloadMatcher?: (payload: unknown) => boolean;\n\n  /** Expected trace ID */\n  traceId?: string;\n}\n\n/**\n * Consumer assertion options\n */\nexport interface ConsumerAssertionOptions {\n  /** Expected number of messages processed */\n  messageCount?: number;\n\n  /** Whether producer links should be present */\n  hasProducerLinks?: boolean;\n\n  /** Expected destination */\n  destination?: string;\n\n  /** Expected consumer group */\n  consumerGroup?: string;\n\n  /** Whether any messages were duplicates */\n  hasDuplicates?: boolean;\n\n  /** Whether any messages were out of order */\n  hasOutOfOrder?: boolean;\n\n  /** Whether any messages went to DLQ */\n  hasDLQ?: boolean;\n}\n\n/**\n * Messaging test harness\n */\nexport interface MessagingTestHarness {\n  /** All recorded producer calls */\n  producerCalls: RecordedProducerCall[];\n\n  /** All recorded consumer calls */\n  consumerCalls: RecordedConsumerCall[];\n\n  /** All recorded rebalance events */\n  rebalanceEvents: RecordedRebalanceEvent[];\n\n  /**\n   * Record a producer call\n   */\n  recordProducerCall(call: Omit<RecordedProducerCall, 'timestamp'>): void;\n\n  /**\n   * Record a consumer call\n   */\n  recordConsumerCall(call: Omit<RecordedConsumerCall, 'timestamp'>): void;\n\n  /**\n   * Record a rebalance event\n   */\n  recordRebalanceEvent(event: RecordedRebalanceEvent): void;\n\n  /**\n   * Create a mock message with trace headers\n   */\n  createMockMessage<T>(\n    payload: T,\n    options?: Partial<MockMessage<T>>,\n  ): MockMessage<T>;\n\n  /**\n   * Create mock trace headers\n   */\n  createMockTraceHeaders(\n    traceId?: string,\n    spanId?: string,\n  ): Record<string, string>;\n\n  /**\n   * Assert producer was called with expected options\n   */\n  assertProducerCalled(\n    destination: string,\n    options?: ProducerAssertionOptions,\n  ): void;\n\n  /**\n   * Assert producer was not called\n   */\n  assertProducerNotCalled(destination?: string): void;\n\n  /**\n   * Assert consumer processed messages with expected options\n   */\n  assertConsumerProcessed(\n    destination: string,\n    options?: ConsumerAssertionOptions,\n  ): void;\n\n  /**\n   * Assert consumer was not called\n   */\n  assertConsumerNotCalled(destination?: string): void;\n\n  /**\n   * Assert rebalance occurred\n   */\n  assertRebalanceOccurred(\n    destination: string,\n    type: RebalanceEvent['type'],\n    partitionCount?: number,\n  ): void;\n\n  /**\n   * Get producer calls for destination\n   */\n  getProducerCalls(destination?: string): RecordedProducerCall[];\n\n  /**\n   * Get consumer calls for destination\n   */\n  getConsumerCalls(destination?: string): RecordedConsumerCall[];\n\n  /**\n   * Get the last producer call\n   */\n  getLastProducerCall(destination?: string): RecordedProducerCall | undefined;\n\n  /**\n   * Get the last consumer call\n   */\n  getLastConsumerCall(destination?: string): RecordedConsumerCall | undefined;\n\n  /**\n   * Reset all recorded calls\n   */\n  reset(): void;\n\n  /**\n   * Shutdown the harness\n   */\n  shutdown(): void;\n}\n\n// ============================================================================\n// Implementation\n// ============================================================================\n\n/**\n * Generate a random hex string\n */\nfunction randomHex(length: number): string {\n  let result = '';\n  const chars = '0123456789abcdef';\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n\n/**\n * Create a messaging test harness\n *\n * Provides utilities for recording and asserting on producer/consumer calls\n * during testing.\n *\n * @example\n * ```typescript\n * const harness = createMessagingTestHarness();\n *\n * // In your test setup\n * beforeEach(() => harness.reset());\n *\n * // In your tests\n * it('should publish order event', async () => {\n *   await orderService.createOrder({ id: '123' });\n *\n *   harness.assertProducerCalled('orders', {\n *     messageCount: 1,\n *     hasTraceHeaders: true,\n *   });\n *\n *   const lastCall = harness.getLastProducerCall('orders');\n *   expect(lastCall?.payload).toMatchObject({ orderId: '123' });\n * });\n * ```\n */\nexport function createMessagingTestHarness(): MessagingTestHarness {\n  const producerCalls: RecordedProducerCall[] = [];\n  const consumerCalls: RecordedConsumerCall[] = [];\n  const rebalanceEvents: RecordedRebalanceEvent[] = [];\n\n  return {\n    producerCalls,\n    consumerCalls,\n    rebalanceEvents,\n\n    recordProducerCall(call) {\n      producerCalls.push({\n        ...call,\n        timestamp: Date.now(),\n      });\n    },\n\n    recordConsumerCall(call) {\n      consumerCalls.push({\n        ...call,\n        timestamp: Date.now(),\n      });\n    },\n\n    recordRebalanceEvent(event) {\n      rebalanceEvents.push(event);\n    },\n\n    createMockMessage<T>(\n      payload: T,\n      options: Partial<MockMessage<T>> = {},\n    ): MockMessage<T> {\n      return {\n        payload,\n        headers: options.headers ?? this.createMockTraceHeaders(),\n        offset: options.offset ?? Math.floor(Math.random() * 10_000),\n        partition: options.partition ?? 0,\n        key: options.key,\n        messageId: options.messageId ?? `msg-${randomHex(8)}`,\n        timestamp: options.timestamp ?? Date.now(),\n      };\n    },\n\n    createMockTraceHeaders(\n      traceId?: string,\n      spanId?: string,\n    ): Record<string, string> {\n      const tid = traceId ?? randomHex(32);\n      const sid = spanId ?? randomHex(16);\n      return {\n        traceparent: `00-${tid}-${sid}-01`,\n      };\n    },\n\n    assertProducerCalled(\n      destination: string,\n      options: ProducerAssertionOptions = {},\n    ) {\n      const calls = producerCalls.filter((c) => c.destination === destination);\n\n      if (calls.length === 0) {\n        throw new Error(\n          `Expected producer to be called for destination '${destination}', but it was not called`,\n        );\n      }\n\n      if (\n        options.messageCount !== undefined &&\n        calls.length !== options.messageCount\n      ) {\n        throw new Error(\n          `Expected ${options.messageCount} producer calls for '${destination}', got ${calls.length}`,\n        );\n      }\n\n      if (options.hasTraceHeaders) {\n        const withoutHeaders = calls.filter((c) => !c.headers?.traceparent);\n        if (withoutHeaders.length > 0) {\n          throw new Error(\n            `Expected all producer calls for '${destination}' to have trace headers, but ${withoutHeaders.length} did not`,\n          );\n        }\n      }\n\n      if (options.traceId) {\n        const matchingTraceId = calls.filter(\n          (c) => c.traceId === options.traceId,\n        );\n        if (matchingTraceId.length === 0) {\n          throw new Error(\n            `Expected producer call for '${destination}' with traceId '${options.traceId}', but none found`,\n          );\n        }\n      }\n\n      if (options.payloadMatcher) {\n        const matching = calls.filter((c) =>\n          options.payloadMatcher!(c.payload),\n        );\n        if (matching.length === 0) {\n          throw new Error(\n            `Expected producer call for '${destination}' to match payload matcher, but none did`,\n          );\n        }\n      }\n    },\n\n    assertProducerNotCalled(destination?: string) {\n      if (destination) {\n        const calls = producerCalls.filter(\n          (c) => c.destination === destination,\n        );\n        if (calls.length > 0) {\n          throw new Error(\n            `Expected producer not to be called for '${destination}', but it was called ${calls.length} times`,\n          );\n        }\n      } else {\n        if (producerCalls.length > 0) {\n          throw new Error(\n            `Expected no producer calls, but ${producerCalls.length} calls were made`,\n          );\n        }\n      }\n    },\n\n    assertConsumerProcessed(\n      destination: string,\n      options: ConsumerAssertionOptions = {},\n    ) {\n      const calls = consumerCalls.filter((c) => c.destination === destination);\n\n      if (calls.length === 0) {\n        throw new Error(\n          `Expected consumer to process messages for destination '${destination}', but none were processed`,\n        );\n      }\n\n      if (\n        options.messageCount !== undefined &&\n        calls.length !== options.messageCount\n      ) {\n        throw new Error(\n          `Expected ${options.messageCount} consumer calls for '${destination}', got ${calls.length}`,\n        );\n      }\n\n      if (options.consumerGroup) {\n        const wrongGroup = calls.filter(\n          (c) => c.consumerGroup !== options.consumerGroup,\n        );\n        if (wrongGroup.length > 0) {\n          throw new Error(\n            `Expected consumer group '${options.consumerGroup}' for '${destination}', but found different groups`,\n          );\n        }\n      }\n\n      if (options.hasProducerLinks) {\n        const withoutLinks = calls.filter((c) => c.producerLinks.length === 0);\n        if (withoutLinks.length > 0) {\n          throw new Error(\n            `Expected all consumer calls for '${destination}' to have producer links, but ${withoutLinks.length} did not`,\n          );\n        }\n      }\n\n      if (options.hasDuplicates !== undefined) {\n        const duplicates = calls.filter((c) => c.isDuplicate);\n        if (options.hasDuplicates && duplicates.length === 0) {\n          throw new Error(\n            `Expected duplicate messages for '${destination}', but none were detected`,\n          );\n        }\n        if (!options.hasDuplicates && duplicates.length > 0) {\n          throw new Error(\n            `Expected no duplicate messages for '${destination}', but ${duplicates.length} were detected`,\n          );\n        }\n      }\n\n      if (options.hasOutOfOrder !== undefined) {\n        const outOfOrder = calls.filter((c) => c.outOfOrderInfo !== null);\n        if (options.hasOutOfOrder && outOfOrder.length === 0) {\n          throw new Error(\n            `Expected out-of-order messages for '${destination}', but none were detected`,\n          );\n        }\n        if (!options.hasOutOfOrder && outOfOrder.length > 0) {\n          throw new Error(\n            `Expected no out-of-order messages for '${destination}', but ${outOfOrder.length} were detected`,\n          );\n        }\n      }\n\n      if (options.hasDLQ !== undefined) {\n        const dlqCalls = calls.filter((c) => c.dlqReason !== undefined);\n        if (options.hasDLQ && dlqCalls.length === 0) {\n          throw new Error(\n            `Expected DLQ routing for '${destination}', but none occurred`,\n          );\n        }\n        if (!options.hasDLQ && dlqCalls.length > 0) {\n          throw new Error(\n            `Expected no DLQ routing for '${destination}', but ${dlqCalls.length} occurred`,\n          );\n        }\n      }\n    },\n\n    assertConsumerNotCalled(destination?: string) {\n      if (destination) {\n        const calls = consumerCalls.filter(\n          (c) => c.destination === destination,\n        );\n        if (calls.length > 0) {\n          throw new Error(\n            `Expected consumer not to be called for '${destination}', but it processed ${calls.length} messages`,\n          );\n        }\n      } else {\n        if (consumerCalls.length > 0) {\n          throw new Error(\n            `Expected no consumer calls, but ${consumerCalls.length} messages were processed`,\n          );\n        }\n      }\n    },\n\n    assertRebalanceOccurred(\n      destination: string,\n      type: RebalanceEvent['type'],\n      partitionCount?: number,\n    ) {\n      const events = rebalanceEvents.filter(\n        (e) => e.destination === destination && e.type === type,\n      );\n\n      if (events.length === 0) {\n        throw new Error(\n          `Expected rebalance '${type}' for '${destination}', but none occurred`,\n        );\n      }\n\n      if (partitionCount !== undefined) {\n        const matching = events.filter(\n          (e) => e.partitions.length === partitionCount,\n        );\n        if (matching.length === 0) {\n          throw new Error(\n            `Expected rebalance '${type}' for '${destination}' with ${partitionCount} partitions, but none matched`,\n          );\n        }\n      }\n    },\n\n    getProducerCalls(destination?: string) {\n      if (destination) {\n        return producerCalls.filter((c) => c.destination === destination);\n      }\n      return [...producerCalls];\n    },\n\n    getConsumerCalls(destination?: string) {\n      if (destination) {\n        return consumerCalls.filter((c) => c.destination === destination);\n      }\n      return [...consumerCalls];\n    },\n\n    getLastProducerCall(destination?: string) {\n      const calls = this.getProducerCalls(destination);\n      return calls.at(-1);\n    },\n\n    getLastConsumerCall(destination?: string) {\n      const calls = this.getConsumerCalls(destination);\n      return calls.at(-1);\n    },\n\n    reset() {\n      producerCalls.length = 0;\n      consumerCalls.length = 0;\n      rebalanceEvents.length = 0;\n    },\n\n    shutdown() {\n      this.reset();\n    },\n  };\n}\n\n// ============================================================================\n// Mock Broker\n// ============================================================================\n\n/**\n * Mock message broker for testing\n */\nexport interface MockMessageBroker {\n  /** Topics/queues in the broker */\n  topics: Map<string, MockMessage[]>;\n\n  /**\n   * Publish a message to a topic\n   */\n  publish(topic: string, message: MockMessage): void;\n\n  /**\n   * Consume messages from a topic\n   */\n  consume(topic: string, count?: number): MockMessage[];\n\n  /**\n   * Peek at messages without consuming\n   */\n  peek(topic: string, count?: number): MockMessage[];\n\n  /**\n   * Get message count for topic\n   */\n  getMessageCount(topic: string): number;\n\n  /**\n   * Clear all messages\n   */\n  clear(topic?: string): void;\n\n  /**\n   * Create a topic\n   */\n  createTopic(topic: string): void;\n\n  /**\n   * Delete a topic\n   */\n  deleteTopic(topic: string): void;\n\n  /**\n   * List all topics\n   */\n  listTopics(): string[];\n}\n\n/**\n * Create a mock message broker for testing\n *\n * Simulates a message broker (Kafka, SQS, RabbitMQ, etc.) for unit testing.\n *\n * @example\n * ```typescript\n * const broker = createMockMessageBroker();\n *\n * // Producer publishes\n * broker.publish('orders', { payload: { orderId: '123' }, headers: {} });\n *\n * // Consumer receives\n * const messages = broker.consume('orders');\n * expect(messages).toHaveLength(1);\n * expect(messages[0].payload).toEqual({ orderId: '123' });\n * ```\n */\nexport function createMockMessageBroker(): MockMessageBroker {\n  const topics = new Map<string, MockMessage[]>();\n\n  return {\n    topics,\n\n    publish(topic: string, message: MockMessage) {\n      if (!topics.has(topic)) {\n        topics.set(topic, []);\n      }\n      topics.get(topic)!.push({\n        ...message,\n        timestamp: message.timestamp ?? Date.now(),\n        offset: message.offset ?? topics.get(topic)!.length,\n      });\n    },\n\n    consume(topic: string, count?: number) {\n      const messages = topics.get(topic) ?? [];\n      if (count === undefined) {\n        const all = [...messages];\n        messages.length = 0;\n        return all;\n      }\n      return messages.splice(0, count);\n    },\n\n    peek(topic: string, count?: number) {\n      const messages = topics.get(topic) ?? [];\n      if (count === undefined) {\n        return [...messages];\n      }\n      return messages.slice(0, count);\n    },\n\n    getMessageCount(topic: string) {\n      return topics.get(topic)?.length ?? 0;\n    },\n\n    clear(topic?: string) {\n      if (topic) {\n        topics.set(topic, []);\n      } else {\n        topics.clear();\n      }\n    },\n\n    createTopic(topic: string) {\n      if (!topics.has(topic)) {\n        topics.set(topic, []);\n      }\n    },\n\n    deleteTopic(topic: string) {\n      topics.delete(topic);\n    },\n\n    listTopics() {\n      return [...topics.keys()];\n    },\n  };\n}\n\n// ============================================================================\n// Context Propagation Helpers\n// ============================================================================\n\n/**\n * Extract trace ID from traceparent header\n */\nexport function extractTraceIdFromHeader(traceparent: string): string | null {\n  const parts = traceparent.split('-');\n  if (parts.length >= 3 && parts[1] !== undefined) {\n    return parts[1];\n  }\n  return null;\n}\n\n/**\n * Extract span ID from traceparent header\n */\nexport function extractSpanIdFromHeader(traceparent: string): string | null {\n  const parts = traceparent.split('-');\n  if (parts.length >= 4 && parts[2] !== undefined) {\n    return parts[2];\n  }\n  return null;\n}\n\n/**\n * Create a mock span context\n */\nexport function createMockSpanContext(\n  traceId?: string,\n  spanId?: string,\n): SpanContext {\n  return {\n    traceId: traceId ?? randomHex(32),\n    spanId: spanId ?? randomHex(16),\n    traceFlags: 1,\n    isRemote: true,\n  };\n}\n\n/**\n * Create a mock link to a producer span\n */\nexport function createMockProducerLink(\n  traceId?: string,\n  spanId?: string,\n): Link {\n  return {\n    context: createMockSpanContext(traceId, spanId),\n    attributes: {\n      'messaging.link.source': 'producer',\n    },\n  };\n}\n\n// ============================================================================\n// Scenario Builders\n// ============================================================================\n\n/**\n * Create a batch of mock messages\n */\nexport function createMockMessageBatch<T>(\n  payloads: T[],\n  options: {\n    startOffset?: number;\n    partition?: number;\n    addTraceHeaders?: boolean;\n    traceId?: string;\n  } = {},\n): MockMessage<T>[] {\n  const startOffset = options.startOffset ?? 0;\n  const addTraceHeaders = options.addTraceHeaders ?? true;\n  const traceId = options.traceId ?? randomHex(32);\n\n  return payloads.map((payload, index) => ({\n    payload,\n    headers: addTraceHeaders\n      ? { traceparent: `00-${traceId}-${randomHex(16)}-01` }\n      : undefined,\n    offset: startOffset + index,\n    partition: options.partition ?? 0,\n    messageId: `msg-${randomHex(8)}`,\n    timestamp: Date.now() + index,\n  }));\n}\n\n/**\n * Create a rebalance scenario\n */\nexport function createRebalanceScenario(\n  topic: string,\n  consumerGroup: string,\n  partitions: number[],\n): {\n  assignEvent: RecordedRebalanceEvent;\n  revokeEvent: RecordedRebalanceEvent;\n} {\n  const assignments: PartitionAssignment[] = partitions.map((p) => ({\n    topic,\n    partition: p,\n    offset: 0,\n  }));\n\n  return {\n    assignEvent: {\n      type: 'assigned',\n      partitions: assignments,\n      timestamp: Date.now(),\n      generation: 1,\n      destination: topic,\n      consumerGroup,\n    },\n    revokeEvent: {\n      type: 'revoked',\n      partitions: assignments,\n      timestamp: Date.now() + 1000,\n      generation: 2,\n      destination: topic,\n      consumerGroup,\n    },\n  };\n}\n\n/**\n * Create an out-of-order scenario\n */\nexport function createOutOfOrderScenario<T>(\n  payloads: T[],\n  outOfOrderIndices: number[],\n): MockMessage<T>[] {\n  const messages = createMockMessageBatch(payloads, { addTraceHeaders: true });\n\n  // Shuffle specified indices to create out-of-order scenario\n  const shuffled = [...messages];\n  for (const index of outOfOrderIndices) {\n    if (index > 0 && index < shuffled.length) {\n      // Swap with previous to create out-of-order\n      const prev = shuffled[index - 1]!;\n      const curr = shuffled[index]!;\n      shuffled[index - 1] = curr;\n      shuffled[index] = prev;\n    }\n  }\n\n  return shuffled;\n}\n\n/**\n * Create a duplicate message scenario\n */\nexport function createDuplicateScenario<T>(\n  payloads: T[],\n  duplicateIndices: number[],\n): MockMessage<T>[] {\n  const messages = createMockMessageBatch(payloads, { addTraceHeaders: true });\n  const result = [...messages];\n\n  for (const index of duplicateIndices) {\n    const originalMessage = messages[index];\n    if (index >= 0 && index < messages.length && originalMessage) {\n      // Insert duplicate after the original\n      result.splice(index + 1, 0, { ...originalMessage });\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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"}

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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-testing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"messaging-testing.js","names":[],"sources":["../src/messaging-testing.ts"],"sourcesContent":["/**\n * Testing utilities for messaging instrumentation\n *\n * Provides mock producers, consumers, and assertion helpers\n * for testing event-driven code with Autotel's messaging module.\n *\n * @example Basic test setup\n * ```typescript\n * import { createMessagingTestHarness } from 'autotel/messaging-testing';\n *\n * describe('Order processing', () => {\n *   const harness = createMessagingTestHarness();\n *\n *   beforeEach(() => harness.reset());\n *   afterAll(() => harness.shutdown());\n *\n *   it('should process order and publish event', async () => {\n *     await processOrder({ id: 'order-123' });\n *\n *     harness.assertProducerCalled('orders', {\n *       messageCount: 1,\n *       hasTraceHeaders: true,\n *     });\n *   });\n * });\n * ```\n *\n * @module\n */\n\nimport type { Link, SpanContext } from '@opentelemetry/api';\nimport type {\n  RebalanceEvent,\n  PartitionAssignment,\n  OutOfOrderInfo,\n} from './messaging';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Recorded producer call\n */\nexport interface RecordedProducerCall {\n  /** Destination (topic/queue) */\n  destination: string;\n\n  /** System (kafka, sqs, etc.) */\n  system: string;\n\n  /** Message payload */\n  payload: unknown;\n\n  /** Headers injected */\n  headers: Record<string, string>;\n\n  /** Timestamp of call */\n  timestamp: number;\n\n  /** Trace ID from headers */\n  traceId?: string;\n\n  /** Span ID from headers */\n  spanId?: string;\n}\n\n/**\n * Recorded consumer call\n */\nexport interface RecordedConsumerCall {\n  /** Destination (topic/queue) */\n  destination: string;\n\n  /** System (kafka, sqs, etc.) */\n  system: string;\n\n  /** Consumer group */\n  consumerGroup?: string;\n\n  /** Message payload */\n  payload: unknown;\n\n  /** Headers extracted */\n  headers?: Record<string, string>;\n\n  /** Timestamp of call */\n  timestamp: number;\n\n  /** Producer links extracted */\n  producerLinks: Link[];\n\n  /** Whether message was duplicate */\n  isDuplicate: boolean;\n\n  /** Out of order info if detected */\n  outOfOrderInfo: OutOfOrderInfo | null;\n\n  /** DLQ reason if routed to DLQ */\n  dlqReason?: string;\n\n  /** Retry attempt number */\n  retryAttempt?: number;\n}\n\n/**\n * Recorded rebalance event\n */\nexport interface RecordedRebalanceEvent extends RebalanceEvent {\n  /** Destination (topic) */\n  destination: string;\n\n  /** Consumer group */\n  consumerGroup: string;\n}\n\n/**\n * Mock message for testing\n */\nexport interface MockMessage<T = unknown> {\n  /** Message payload */\n  payload: T;\n\n  /** Headers */\n  headers?: Record<string, string>;\n\n  /** Offset/sequence number */\n  offset?: number;\n\n  /** Partition */\n  partition?: number;\n\n  /** Key */\n  key?: string;\n\n  /** Message ID */\n  messageId?: string;\n\n  /** Timestamp */\n  timestamp?: number;\n}\n\n/**\n * Producer assertion options\n */\nexport interface ProducerAssertionOptions {\n  /** Expected number of messages */\n  messageCount?: number;\n\n  /** Whether trace headers should be present */\n  hasTraceHeaders?: boolean;\n\n  /** Expected destination */\n  destination?: string;\n\n  /** Custom matcher for payload */\n  payloadMatcher?: (payload: unknown) => boolean;\n\n  /** Expected trace ID */\n  traceId?: string;\n}\n\n/**\n * Consumer assertion options\n */\nexport interface ConsumerAssertionOptions {\n  /** Expected number of messages processed */\n  messageCount?: number;\n\n  /** Whether producer links should be present */\n  hasProducerLinks?: boolean;\n\n  /** Expected destination */\n  destination?: string;\n\n  /** Expected consumer group */\n  consumerGroup?: string;\n\n  /** Whether any messages were duplicates */\n  hasDuplicates?: boolean;\n\n  /** Whether any messages were out of order */\n  hasOutOfOrder?: boolean;\n\n  /** Whether any messages went to DLQ */\n  hasDLQ?: boolean;\n}\n\n/**\n * Messaging test harness\n */\nexport interface MessagingTestHarness {\n  /** All recorded producer calls */\n  producerCalls: RecordedProducerCall[];\n\n  /** All recorded consumer calls */\n  consumerCalls: RecordedConsumerCall[];\n\n  /** All recorded rebalance events */\n  rebalanceEvents: RecordedRebalanceEvent[];\n\n  /**\n   * Record a producer call\n   */\n  recordProducerCall(call: Omit<RecordedProducerCall, 'timestamp'>): void;\n\n  /**\n   * Record a consumer call\n   */\n  recordConsumerCall(call: Omit<RecordedConsumerCall, 'timestamp'>): void;\n\n  /**\n   * Record a rebalance event\n   */\n  recordRebalanceEvent(event: RecordedRebalanceEvent): void;\n\n  /**\n   * Create a mock message with trace headers\n   */\n  createMockMessage<T>(\n    payload: T,\n    options?: Partial<MockMessage<T>>,\n  ): MockMessage<T>;\n\n  /**\n   * Create mock trace headers\n   */\n  createMockTraceHeaders(\n    traceId?: string,\n    spanId?: string,\n  ): Record<string, string>;\n\n  /**\n   * Assert producer was called with expected options\n   */\n  assertProducerCalled(\n    destination: string,\n    options?: ProducerAssertionOptions,\n  ): void;\n\n  /**\n   * Assert producer was not called\n   */\n  assertProducerNotCalled(destination?: string): void;\n\n  /**\n   * Assert consumer processed messages with expected options\n   */\n  assertConsumerProcessed(\n    destination: string,\n    options?: ConsumerAssertionOptions,\n  ): void;\n\n  /**\n   * Assert consumer was not called\n   */\n  assertConsumerNotCalled(destination?: string): void;\n\n  /**\n   * Assert rebalance occurred\n   */\n  assertRebalanceOccurred(\n    destination: string,\n    type: RebalanceEvent['type'],\n    partitionCount?: number,\n  ): void;\n\n  /**\n   * Get producer calls for destination\n   */\n  getProducerCalls(destination?: string): RecordedProducerCall[];\n\n  /**\n   * Get consumer calls for destination\n   */\n  getConsumerCalls(destination?: string): RecordedConsumerCall[];\n\n  /**\n   * Get the last producer call\n   */\n  getLastProducerCall(destination?: string): RecordedProducerCall | undefined;\n\n  /**\n   * Get the last consumer call\n   */\n  getLastConsumerCall(destination?: string): RecordedConsumerCall | undefined;\n\n  /**\n   * Reset all recorded calls\n   */\n  reset(): void;\n\n  /**\n   * Shutdown the harness\n   */\n  shutdown(): void;\n}\n\n// ============================================================================\n// Implementation\n// ============================================================================\n\n/**\n * Generate a random hex string\n */\nfunction randomHex(length: number): string {\n  let result = '';\n  const chars = '0123456789abcdef';\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n\n/**\n * Create a messaging test harness\n *\n * Provides utilities for recording and asserting on producer/consumer calls\n * during testing.\n *\n * @example\n * ```typescript\n * const harness = createMessagingTestHarness();\n *\n * // In your test setup\n * beforeEach(() => harness.reset());\n *\n * // In your tests\n * it('should publish order event', async () => {\n *   await orderService.createOrder({ id: '123' });\n *\n *   harness.assertProducerCalled('orders', {\n *     messageCount: 1,\n *     hasTraceHeaders: true,\n *   });\n *\n *   const lastCall = harness.getLastProducerCall('orders');\n *   expect(lastCall?.payload).toMatchObject({ orderId: '123' });\n * });\n * ```\n */\nexport function createMessagingTestHarness(): MessagingTestHarness {\n  const producerCalls: RecordedProducerCall[] = [];\n  const consumerCalls: RecordedConsumerCall[] = [];\n  const rebalanceEvents: RecordedRebalanceEvent[] = [];\n\n  return {\n    producerCalls,\n    consumerCalls,\n    rebalanceEvents,\n\n    recordProducerCall(call) {\n      producerCalls.push({\n        ...call,\n        timestamp: Date.now(),\n      });\n    },\n\n    recordConsumerCall(call) {\n      consumerCalls.push({\n        ...call,\n        timestamp: Date.now(),\n      });\n    },\n\n    recordRebalanceEvent(event) {\n      rebalanceEvents.push(event);\n    },\n\n    createMockMessage<T>(\n      payload: T,\n      options: Partial<MockMessage<T>> = {},\n    ): MockMessage<T> {\n      return {\n        payload,\n        headers: options.headers ?? this.createMockTraceHeaders(),\n        offset: options.offset ?? Math.floor(Math.random() * 10_000),\n        partition: options.partition ?? 0,\n        key: options.key,\n        messageId: options.messageId ?? `msg-${randomHex(8)}`,\n        timestamp: options.timestamp ?? Date.now(),\n      };\n    },\n\n    createMockTraceHeaders(\n      traceId?: string,\n      spanId?: string,\n    ): Record<string, string> {\n      const tid = traceId ?? randomHex(32);\n      const sid = spanId ?? randomHex(16);\n      return {\n        traceparent: `00-${tid}-${sid}-01`,\n      };\n    },\n\n    assertProducerCalled(\n      destination: string,\n      options: ProducerAssertionOptions = {},\n    ) {\n      const calls = producerCalls.filter((c) => c.destination === destination);\n\n      if (calls.length === 0) {\n        throw new Error(\n          `Expected producer to be called for destination '${destination}', but it was not called`,\n        );\n      }\n\n      if (\n        options.messageCount !== undefined &&\n        calls.length !== options.messageCount\n      ) {\n        throw new Error(\n          `Expected ${options.messageCount} producer calls for '${destination}', got ${calls.length}`,\n        );\n      }\n\n      if (options.hasTraceHeaders) {\n        const withoutHeaders = calls.filter((c) => !c.headers?.traceparent);\n        if (withoutHeaders.length > 0) {\n          throw new Error(\n            `Expected all producer calls for '${destination}' to have trace headers, but ${withoutHeaders.length} did not`,\n          );\n        }\n      }\n\n      if (options.traceId) {\n        const matchingTraceId = calls.filter(\n          (c) => c.traceId === options.traceId,\n        );\n        if (matchingTraceId.length === 0) {\n          throw new Error(\n            `Expected producer call for '${destination}' with traceId '${options.traceId}', but none found`,\n          );\n        }\n      }\n\n      if (options.payloadMatcher) {\n        const matching = calls.filter((c) =>\n          options.payloadMatcher!(c.payload),\n        );\n        if (matching.length === 0) {\n          throw new Error(\n            `Expected producer call for '${destination}' to match payload matcher, but none did`,\n          );\n        }\n      }\n    },\n\n    assertProducerNotCalled(destination?: string) {\n      if (destination) {\n        const calls = producerCalls.filter(\n          (c) => c.destination === destination,\n        );\n        if (calls.length > 0) {\n          throw new Error(\n            `Expected producer not to be called for '${destination}', but it was called ${calls.length} times`,\n          );\n        }\n      } else {\n        if (producerCalls.length > 0) {\n          throw new Error(\n            `Expected no producer calls, but ${producerCalls.length} calls were made`,\n          );\n        }\n      }\n    },\n\n    assertConsumerProcessed(\n      destination: string,\n      options: ConsumerAssertionOptions = {},\n    ) {\n      const calls = consumerCalls.filter((c) => c.destination === destination);\n\n      if (calls.length === 0) {\n        throw new Error(\n          `Expected consumer to process messages for destination '${destination}', but none were processed`,\n        );\n      }\n\n      if (\n        options.messageCount !== undefined &&\n        calls.length !== options.messageCount\n      ) {\n        throw new Error(\n          `Expected ${options.messageCount} consumer calls for '${destination}', got ${calls.length}`,\n        );\n      }\n\n      if (options.consumerGroup) {\n        const wrongGroup = calls.filter(\n          (c) => c.consumerGroup !== options.consumerGroup,\n        );\n        if (wrongGroup.length > 0) {\n          throw new Error(\n            `Expected consumer group '${options.consumerGroup}' for '${destination}', but found different groups`,\n          );\n        }\n      }\n\n      if (options.hasProducerLinks) {\n        const withoutLinks = calls.filter((c) => c.producerLinks.length === 0);\n        if (withoutLinks.length > 0) {\n          throw new Error(\n            `Expected all consumer calls for '${destination}' to have producer links, but ${withoutLinks.length} did not`,\n          );\n        }\n      }\n\n      if (options.hasDuplicates !== undefined) {\n        const duplicates = calls.filter((c) => c.isDuplicate);\n        if (options.hasDuplicates && duplicates.length === 0) {\n          throw new Error(\n            `Expected duplicate messages for '${destination}', but none were detected`,\n          );\n        }\n        if (!options.hasDuplicates && duplicates.length > 0) {\n          throw new Error(\n            `Expected no duplicate messages for '${destination}', but ${duplicates.length} were detected`,\n          );\n        }\n      }\n\n      if (options.hasOutOfOrder !== undefined) {\n        const outOfOrder = calls.filter((c) => c.outOfOrderInfo !== null);\n        if (options.hasOutOfOrder && outOfOrder.length === 0) {\n          throw new Error(\n            `Expected out-of-order messages for '${destination}', but none were detected`,\n          );\n        }\n        if (!options.hasOutOfOrder && outOfOrder.length > 0) {\n          throw new Error(\n            `Expected no out-of-order messages for '${destination}', but ${outOfOrder.length} were detected`,\n          );\n        }\n      }\n\n      if (options.hasDLQ !== undefined) {\n        const dlqCalls = calls.filter((c) => c.dlqReason !== undefined);\n        if (options.hasDLQ && dlqCalls.length === 0) {\n          throw new Error(\n            `Expected DLQ routing for '${destination}', but none occurred`,\n          );\n        }\n        if (!options.hasDLQ && dlqCalls.length > 0) {\n          throw new Error(\n            `Expected no DLQ routing for '${destination}', but ${dlqCalls.length} occurred`,\n          );\n        }\n      }\n    },\n\n    assertConsumerNotCalled(destination?: string) {\n      if (destination) {\n        const calls = consumerCalls.filter(\n          (c) => c.destination === destination,\n        );\n        if (calls.length > 0) {\n          throw new Error(\n            `Expected consumer not to be called for '${destination}', but it processed ${calls.length} messages`,\n          );\n        }\n      } else {\n        if (consumerCalls.length > 0) {\n          throw new Error(\n            `Expected no consumer calls, but ${consumerCalls.length} messages were processed`,\n          );\n        }\n      }\n    },\n\n    assertRebalanceOccurred(\n      destination: string,\n      type: RebalanceEvent['type'],\n      partitionCount?: number,\n    ) {\n      const events = rebalanceEvents.filter(\n        (e) => e.destination === destination && e.type === type,\n      );\n\n      if (events.length === 0) {\n        throw new Error(\n          `Expected rebalance '${type}' for '${destination}', but none occurred`,\n        );\n      }\n\n      if (partitionCount !== undefined) {\n        const matching = events.filter(\n          (e) => e.partitions.length === partitionCount,\n        );\n        if (matching.length === 0) {\n          throw new Error(\n            `Expected rebalance '${type}' for '${destination}' with ${partitionCount} partitions, but none matched`,\n          );\n        }\n      }\n    },\n\n    getProducerCalls(destination?: string) {\n      if (destination) {\n        return producerCalls.filter((c) => c.destination === destination);\n      }\n      return [...producerCalls];\n    },\n\n    getConsumerCalls(destination?: string) {\n      if (destination) {\n        return consumerCalls.filter((c) => c.destination === destination);\n      }\n      return [...consumerCalls];\n    },\n\n    getLastProducerCall(destination?: string) {\n      const calls = this.getProducerCalls(destination);\n      return calls.at(-1);\n    },\n\n    getLastConsumerCall(destination?: string) {\n      const calls = this.getConsumerCalls(destination);\n      return calls.at(-1);\n    },\n\n    reset() {\n      producerCalls.length = 0;\n      consumerCalls.length = 0;\n      rebalanceEvents.length = 0;\n    },\n\n    shutdown() {\n      this.reset();\n    },\n  };\n}\n\n// ============================================================================\n// Mock Broker\n// ============================================================================\n\n/**\n * Mock message broker for testing\n */\nexport interface MockMessageBroker {\n  /** Topics/queues in the broker */\n  topics: Map<string, MockMessage[]>;\n\n  /**\n   * Publish a message to a topic\n   */\n  publish(topic: string, message: MockMessage): void;\n\n  /**\n   * Consume messages from a topic\n   */\n  consume(topic: string, count?: number): MockMessage[];\n\n  /**\n   * Peek at messages without consuming\n   */\n  peek(topic: string, count?: number): MockMessage[];\n\n  /**\n   * Get message count for topic\n   */\n  getMessageCount(topic: string): number;\n\n  /**\n   * Clear all messages\n   */\n  clear(topic?: string): void;\n\n  /**\n   * Create a topic\n   */\n  createTopic(topic: string): void;\n\n  /**\n   * Delete a topic\n   */\n  deleteTopic(topic: string): void;\n\n  /**\n   * List all topics\n   */\n  listTopics(): string[];\n}\n\n/**\n * Create a mock message broker for testing\n *\n * Simulates a message broker (Kafka, SQS, RabbitMQ, etc.) for unit testing.\n *\n * @example\n * ```typescript\n * const broker = createMockMessageBroker();\n *\n * // Producer publishes\n * broker.publish('orders', { payload: { orderId: '123' }, headers: {} });\n *\n * // Consumer receives\n * const messages = broker.consume('orders');\n * expect(messages).toHaveLength(1);\n * expect(messages[0].payload).toEqual({ orderId: '123' });\n * ```\n */\nexport function createMockMessageBroker(): MockMessageBroker {\n  const topics = new Map<string, MockMessage[]>();\n\n  return {\n    topics,\n\n    publish(topic: string, message: MockMessage) {\n      if (!topics.has(topic)) {\n        topics.set(topic, []);\n      }\n      topics.get(topic)!.push({\n        ...message,\n        timestamp: message.timestamp ?? Date.now(),\n        offset: message.offset ?? topics.get(topic)!.length,\n      });\n    },\n\n    consume(topic: string, count?: number) {\n      const messages = topics.get(topic) ?? [];\n      if (count === undefined) {\n        const all = [...messages];\n        messages.length = 0;\n        return all;\n      }\n      return messages.splice(0, count);\n    },\n\n    peek(topic: string, count?: number) {\n      const messages = topics.get(topic) ?? [];\n      if (count === undefined) {\n        return [...messages];\n      }\n      return messages.slice(0, count);\n    },\n\n    getMessageCount(topic: string) {\n      return topics.get(topic)?.length ?? 0;\n    },\n\n    clear(topic?: string) {\n      if (topic) {\n        topics.set(topic, []);\n      } else {\n        topics.clear();\n      }\n    },\n\n    createTopic(topic: string) {\n      if (!topics.has(topic)) {\n        topics.set(topic, []);\n      }\n    },\n\n    deleteTopic(topic: string) {\n      topics.delete(topic);\n    },\n\n    listTopics() {\n      return [...topics.keys()];\n    },\n  };\n}\n\n// ============================================================================\n// Context Propagation Helpers\n// ============================================================================\n\n/**\n * Extract trace ID from traceparent header\n */\nexport function extractTraceIdFromHeader(traceparent: string): string | null {\n  const parts = traceparent.split('-');\n  if (parts.length >= 3 && parts[1] !== undefined) {\n    return parts[1];\n  }\n  return null;\n}\n\n/**\n * Extract span ID from traceparent header\n */\nexport function extractSpanIdFromHeader(traceparent: string): string | null {\n  const parts = traceparent.split('-');\n  if (parts.length >= 4 && parts[2] !== undefined) {\n    return parts[2];\n  }\n  return null;\n}\n\n/**\n * Create a mock span context\n */\nexport function createMockSpanContext(\n  traceId?: string,\n  spanId?: string,\n): SpanContext {\n  return {\n    traceId: traceId ?? randomHex(32),\n    spanId: spanId ?? randomHex(16),\n    traceFlags: 1,\n    isRemote: true,\n  };\n}\n\n/**\n * Create a mock link to a producer span\n */\nexport function createMockProducerLink(\n  traceId?: string,\n  spanId?: string,\n): Link {\n  return {\n    context: createMockSpanContext(traceId, spanId),\n    attributes: {\n      'messaging.link.source': 'producer',\n    },\n  };\n}\n\n// ============================================================================\n// Scenario Builders\n// ============================================================================\n\n/**\n * Create a batch of mock messages\n */\nexport function createMockMessageBatch<T>(\n  payloads: T[],\n  options: {\n    startOffset?: number;\n    partition?: number;\n    addTraceHeaders?: boolean;\n    traceId?: string;\n  } = {},\n): MockMessage<T>[] {\n  const startOffset = options.startOffset ?? 0;\n  const addTraceHeaders = options.addTraceHeaders ?? true;\n  const traceId = options.traceId ?? randomHex(32);\n\n  return payloads.map((payload, index) => ({\n    payload,\n    headers: addTraceHeaders\n      ? { traceparent: `00-${traceId}-${randomHex(16)}-01` }\n      : undefined,\n    offset: startOffset + index,\n    partition: options.partition ?? 0,\n    messageId: `msg-${randomHex(8)}`,\n    timestamp: Date.now() + index,\n  }));\n}\n\n/**\n * Create a rebalance scenario\n */\nexport function createRebalanceScenario(\n  topic: string,\n  consumerGroup: string,\n  partitions: number[],\n): {\n  assignEvent: RecordedRebalanceEvent;\n  revokeEvent: RecordedRebalanceEvent;\n} {\n  const assignments: PartitionAssignment[] = partitions.map((p) => ({\n    topic,\n    partition: p,\n    offset: 0,\n  }));\n\n  return {\n    assignEvent: {\n      type: 'assigned',\n      partitions: assignments,\n      timestamp: Date.now(),\n      generation: 1,\n      destination: topic,\n      consumerGroup,\n    },\n    revokeEvent: {\n      type: 'revoked',\n      partitions: assignments,\n      timestamp: Date.now() + 1000,\n      generation: 2,\n      destination: topic,\n      consumerGroup,\n    },\n  };\n}\n\n/**\n * Create an out-of-order scenario\n */\nexport function createOutOfOrderScenario<T>(\n  payloads: T[],\n  outOfOrderIndices: number[],\n): MockMessage<T>[] {\n  const messages = createMockMessageBatch(payloads, { addTraceHeaders: true });\n\n  // Shuffle specified indices to create out-of-order scenario\n  const shuffled = [...messages];\n  for (const index of outOfOrderIndices) {\n    if (index > 0 && index < shuffled.length) {\n      // Swap with previous to create out-of-order\n      const prev = shuffled[index - 1]!;\n      const curr = shuffled[index]!;\n      shuffled[index - 1] = curr;\n      shuffled[index] = prev;\n    }\n  }\n\n  return shuffled;\n}\n\n/**\n * Create a duplicate message scenario\n */\nexport function createDuplicateScenario<T>(\n  payloads: T[],\n  duplicateIndices: number[],\n): MockMessage<T>[] {\n  const messages = createMockMessageBatch(payloads, { addTraceHeaders: true });\n  const result = [...messages];\n\n  for (const index of duplicateIndices) {\n    const originalMessage = messages[index];\n    if (index >= 0 && index < messages.length && originalMessage) {\n      // Insert duplicate after the original\n      result.splice(index + 1, 0, { ...originalMessage });\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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"}