autotel-plugins 0.19.25 → 0.19.27

package/dist/rabbitmq.d.ts

@@ -1,5 +1,19 @@
 import { SpanLink, Span, Context } from 'autotel';
-export { C as CORRELATION_ID_HEADER, t as SEMATTRS_LINKED_TRACE_ID_COUNT, u as SEMATTRS_LINKED_TRACE_ID_HASH, w as SEMATTRS_MESSAGING_CONSUMER_ID, x as SEMATTRS_MESSAGING_DESTINATION_NAME, I as SEMATTRS_MESSAGING_MESSAGE_CONVERSATION_ID, J as SEMATTRS_MESSAGING_MESSAGE_ID, L as SEMATTRS_MESSAGING_OPERATION_NAME, M as SEMATTRS_MESSAGING_RABBITMQ_ACK_RESULT, N as SEMATTRS_MESSAGING_RABBITMQ_DESTINATION_EXCHANGE, O as SEMATTRS_MESSAGING_RABBITMQ_DESTINATION_ROUTING_KEY, P as SEMATTRS_MESSAGING_RABBITMQ_REQUEUE, Q as SEMATTRS_MESSAGING_SYSTEM } from './constants-DKKe2D25.js';
+export {
+  C as CORRELATION_ID_HEADER,
+  t as SEMATTRS_LINKED_TRACE_ID_COUNT,
+  u as SEMATTRS_LINKED_TRACE_ID_HASH,
+  w as SEMATTRS_MESSAGING_CONSUMER_ID,
+  x as SEMATTRS_MESSAGING_DESTINATION_NAME,
+  I as SEMATTRS_MESSAGING_MESSAGE_CONVERSATION_ID,
+  J as SEMATTRS_MESSAGING_MESSAGE_ID,
+  L as SEMATTRS_MESSAGING_OPERATION_NAME,
+  M as SEMATTRS_MESSAGING_RABBITMQ_ACK_RESULT,
+  N as SEMATTRS_MESSAGING_RABBITMQ_DESTINATION_EXCHANGE,
+  O as SEMATTRS_MESSAGING_RABBITMQ_DESTINATION_ROUTING_KEY,
+  P as SEMATTRS_MESSAGING_RABBITMQ_REQUEUE,
+  Q as SEMATTRS_MESSAGING_SYSTEM,
+} from './constants-DKKe2D25.js';
 
 /**
  * RabbitMQ plugin types - Processing spans, ack tracking, and correlation
@@ -12,7 +26,9 @@ export { C as CORRELATION_ID_HEADER, t as SEMATTRS_LINKED_TRACE_ID_COUNT, u as S
  * Raw AMQP headers as provided by amqplib.
  * Values can be string, Buffer, number, boolean, or undefined.
  */
-type RawAmqpHeaders = Record<string, string | Buffer | number | boolean | object | undefined> | undefined;
+type RawAmqpHeaders =
+  | Record<string, string | Buffer | number | boolean | object | undefined>
+  | undefined;
 /**
  * Context mode for processing spans.
  *
@@ -39,162 +55,158 @@ type AckOutcome = 'ack' | 'nack' | 'reject';
  * Controls for deferred ack tracking mode.
  */
 interface AckControls {
-    /**
-     * Acknowledge the message successfully. Ends the span with success.
-     */
-    ack(): void;
-    /**
-     * Negative acknowledge the message. Ends the span with the nack outcome.
-     * @param options - Options for nack behavior
-     */
-    nack(options?: {
-        requeue?: boolean;
-    }): void;
-    /**
-     * Reject the message. Ends the span with the reject outcome.
-     * @param options - Options for reject behavior
-     */
-    reject(options?: {
-        requeue?: boolean;
-    }): void;
+  /**
+   * Acknowledge the message successfully. Ends the span with success.
+   */
+  ack(): void;
+  /**
+   * Negative acknowledge the message. Ends the span with the nack outcome.
+   * @param options - Options for nack behavior
+   */
+  nack(options?: { requeue?: boolean }): void;
+  /**
+   * Reject the message. Ends the span with the reject outcome.
+   * @param options - Options for reject behavior
+   */
+  reject(options?: { requeue?: boolean }): void;
 }
 /**
  * Descriptor for creating a consume/processing span.
  */
 interface ConsumeDescriptor {
-    /**
-     * Name for the processing span (e.g., "order.process")
-     */
-    name: string;
-    /**
-     * AMQP message headers for context extraction.
-     */
-    headers: RawAmqpHeaders;
-    /**
-     * Context mode for relating to extracted remote context.
-     * @default 'inherit'
-     */
-    contextMode?: ContextMode;
-    /**
-     * Additional span links to include.
-     */
-    links?: SpanLink[];
-    /**
-     * Queue name. Sets `messaging.destination.name` attribute.
-     */
-    queue?: string;
-    /**
-     * Source exchange name. Sets `messaging.rabbitmq.destination.exchange` attribute.
-     */
-    exchange?: string;
-    /**
-     * Routing key. Sets `messaging.rabbitmq.destination.routing_key` attribute.
-     */
-    routingKey?: string;
-    /**
-     * AMQP message ID. Sets `messaging.message.id` attribute.
-     */
-    messageId?: string;
-    /**
-     * AMQP correlation ID. Sets `messaging.message.conversation_id` attribute.
-     */
-    correlationId?: string;
-    /**
-     * Consumer tag. Sets `messaging.consumer.id` attribute.
-     */
-    consumerTag?: string;
-    /**
-     * Defer span end until ack/nack/reject is called.
-     * When true, the callback receives AckControls and span ends when one is called.
-     * @default false
-     */
-    deferSpanEnd?: boolean;
-    /**
-     * Timeout in milliseconds for deferred span end.
-     * Required when `deferSpanEnd` is true.
-     */
-    ackTimeoutMs?: number;
+  /**
+   * Name for the processing span (e.g., "order.process")
+   */
+  name: string;
+  /**
+   * AMQP message headers for context extraction.
+   */
+  headers: RawAmqpHeaders;
+  /**
+   * Context mode for relating to extracted remote context.
+   * @default 'inherit'
+   */
+  contextMode?: ContextMode;
+  /**
+   * Additional span links to include.
+   */
+  links?: SpanLink[];
+  /**
+   * Queue name. Sets `messaging.destination.name` attribute.
+   */
+  queue?: string;
+  /**
+   * Source exchange name. Sets `messaging.rabbitmq.destination.exchange` attribute.
+   */
+  exchange?: string;
+  /**
+   * Routing key. Sets `messaging.rabbitmq.destination.routing_key` attribute.
+   */
+  routingKey?: string;
+  /**
+   * AMQP message ID. Sets `messaging.message.id` attribute.
+   */
+  messageId?: string;
+  /**
+   * AMQP correlation ID. Sets `messaging.message.conversation_id` attribute.
+   */
+  correlationId?: string;
+  /**
+   * Consumer tag. Sets `messaging.consumer.id` attribute.
+   */
+  consumerTag?: string;
+  /**
+   * Defer span end until ack/nack/reject is called.
+   * When true, the callback receives AckControls and span ends when one is called.
+   * @default false
+   */
+  deferSpanEnd?: boolean;
+  /**
+   * Timeout in milliseconds for deferred span end.
+   * Required when `deferSpanEnd` is true.
+   */
+  ackTimeoutMs?: number;
 }
 /**
  * Descriptor for creating a publish span.
  */
 interface PublishDescriptor {
-    /**
-     * Name for the publish span (e.g., "order.publish")
-     */
-    name: string;
-    /**
-     * Exchange name. Sets `messaging.destination.name` attribute.
-     * Defaults to 'amq.default' for default exchange.
-     */
-    exchange?: string;
-    /**
-     * Routing key. Sets `messaging.rabbitmq.destination.routing_key` attribute.
-     */
-    routingKey: string;
-    /**
-     * AMQP message ID. Sets `messaging.message.id` attribute.
-     */
-    messageId?: string;
-    /**
-     * AMQP correlation ID. Sets `messaging.message.conversation_id` attribute.
-     */
-    correlationId?: string;
-    /**
-     * Messaging system. Defaults to 'rabbitmq'.
-     */
-    system?: string;
+  /**
+   * Name for the publish span (e.g., "order.publish")
+   */
+  name: string;
+  /**
+   * Exchange name. Sets `messaging.destination.name` attribute.
+   * Defaults to 'amq.default' for default exchange.
+   */
+  exchange?: string;
+  /**
+   * Routing key. Sets `messaging.rabbitmq.destination.routing_key` attribute.
+   */
+  routingKey: string;
+  /**
+   * AMQP message ID. Sets `messaging.message.id` attribute.
+   */
+  messageId?: string;
+  /**
+   * AMQP correlation ID. Sets `messaging.message.conversation_id` attribute.
+   */
+  correlationId?: string;
+  /**
+   * Messaging system. Defaults to 'rabbitmq'.
+   */
+  system?: string;
 }
 /**
  * Options for injecting trace headers.
  */
 interface InjectOptions {
-    /**
-     * Explicit correlation ID to use. If not provided, derives from current context.
-     */
-    correlationId?: string;
-    /**
-     * Whether to include x-correlation-id header.
-     * @default true
-     */
-    includeCorrelationIdHeader?: boolean;
+  /**
+   * Explicit correlation ID to use. If not provided, derives from current context.
+   */
+  correlationId?: string;
+  /**
+   * Whether to include x-correlation-id header.
+   * @default true
+   */
+  includeCorrelationIdHeader?: boolean;
 }
 /**
  * Options for batch lineage extraction.
  */
 interface BatchLineageOptions {
-    /**
-     * Include raw trace IDs in the result.
-     * @default false (privacy consideration)
-     */
-    includeTraceIds?: boolean;
-    /**
-     * Maximum number of links to include.
-     * @default 128
-     */
-    maxLinks?: number;
+  /**
+   * Include raw trace IDs in the result.
+   * @default false (privacy consideration)
+   */
+  includeTraceIds?: boolean;
+  /**
+   * Maximum number of links to include.
+   * @default 128
+   */
+  maxLinks?: number;
 }
 /**
  * Result of batch lineage extraction.
  */
 interface BatchLineageResult {
-    /**
-     * Count of unique, linked trace IDs.
-     */
-    linked_trace_id_count: number;
-    /**
-     * Hash of sorted trace IDs (16 hex chars, 64-bit).
-     * Useful for comparing batches without exposing individual trace IDs.
-     */
-    linked_trace_id_hash: string;
-    /**
-     * Raw trace IDs, only if includeTraceIds was true.
-     */
-    trace_ids?: string[];
-    /**
-     * Valid SpanLinks from extracted contexts (capped at maxLinks).
-     */
-    links: SpanLink[];
+  /**
+   * Count of unique, linked trace IDs.
+   */
+  linked_trace_id_count: number;
+  /**
+   * Hash of sorted trace IDs (16 hex chars, 64-bit).
+   * Useful for comparing batches without exposing individual trace IDs.
+   */
+  linked_trace_id_hash: string;
+  /**
+   * Raw trace IDs, only if includeTraceIds was true.
+   */
+  trace_ids?: string[];
+  /**
+   * Valid SpanLinks from extracted contexts (capped at maxLinks).
+   */
+  links: SpanLink[];
 }
 /**
  * Type for the consume span callback function without deferred ack.
@@ -203,7 +215,10 @@ type ConsumeSpanCallback<T> = (span: Span) => Promise<T>;
 /**
  * Type for the consume span callback function with deferred ack controls.
  */
-type DeferredConsumeSpanCallback<T> = (span: Span, controls: AckControls) => Promise<T>;
+type DeferredConsumeSpanCallback<T> = (
+  span: Span,
+  controls: AckControls,
+) => Promise<T>;
 /**
  * Type for the publish span callback function.
  */
@@ -212,7 +227,7 @@ type PublishSpanCallback<T> = (span: Span) => Promise<T>;
  * Item with optional headers for batch lineage extraction.
  */
 interface BatchItem {
-    headers?: RawAmqpHeaders;
+  headers?: RawAmqpHeaders;
 }
 
 /**
@@ -248,7 +263,9 @@ interface BatchItem {
  * // { traceparent: '00-abc...', 'content-type': 'application/json', retryCount: '3' }
  * ```
  */
-declare function normalizeHeaders(headers?: RawAmqpHeaders): Record<string, string>;
+declare function normalizeHeaders(
+  headers?: RawAmqpHeaders,
+): Record<string, string>;
 /**
  * Extract trace context from normalized headers using OTel propagators.
  *
@@ -332,7 +349,10 @@ declare function deriveCorrelationId(): string;
  * }
  * ```
  */
-declare function extractCorrelationId(headers: Record<string, string>, amqpCorrelationId?: string): string | undefined;
+declare function extractCorrelationId(
+  headers: Record<string, string>,
+  amqpCorrelationId?: string,
+): string | undefined;
 /**
  * Inject trace headers into outgoing message headers.
  *
@@ -362,7 +382,10 @@ declare function extractCorrelationId(headers: Record<string, string>, amqpCorre
  * });
  * ```
  */
-declare function injectTraceHeaders(base?: Record<string, string>, options?: InjectOptions): Record<string, string>;
+declare function injectTraceHeaders(
+  base?: Record<string, string>,
+  options?: InjectOptions,
+): Record<string, string>;
 
 /**
  * Processing span wrapper for RabbitMQ message handling.
@@ -427,14 +450,23 @@ declare function injectTraceHeaders(base?: Record<string, string>, options?: Inj
  * });
  * ```
  */
-declare function withConsumeSpan<T>(descriptor: ConsumeDescriptor & {
+declare function withConsumeSpan<T>(
+  descriptor: ConsumeDescriptor & {
     deferSpanEnd: true;
     ackTimeoutMs: number;
-}, fn: DeferredConsumeSpanCallback<T>): Promise<T>;
-declare function withConsumeSpan<T>(descriptor: ConsumeDescriptor & {
+  },
+  fn: DeferredConsumeSpanCallback<T>,
+): Promise<T>;
+declare function withConsumeSpan<T>(
+  descriptor: ConsumeDescriptor & {
     deferSpanEnd?: false;
-}, fn: ConsumeSpanCallback<T>): Promise<T>;
-declare function withConsumeSpan<T>(descriptor: ConsumeDescriptor, fn: ConsumeSpanCallback<T> | DeferredConsumeSpanCallback<T>): Promise<T>;
+  },
+  fn: ConsumeSpanCallback<T>,
+): Promise<T>;
+declare function withConsumeSpan<T>(
+  descriptor: ConsumeDescriptor,
+  fn: ConsumeSpanCallback<T> | DeferredConsumeSpanCallback<T>,
+): Promise<T>;
 
 /**
  * Publish span wrapper for RabbitMQ message publishing.
@@ -495,7 +527,10 @@ declare function withConsumeSpan<T>(descriptor: ConsumeDescriptor, fn: ConsumeSp
  * });
  * ```
  */
-declare function withPublishSpan<T>(descriptor: PublishDescriptor, fn: PublishSpanCallback<T>): Promise<T>;
+declare function withPublishSpan<T>(
+  descriptor: PublishDescriptor,
+  fn: PublishSpanCallback<T>,
+): Promise<T>;
 
 /**
  * Batch lineage utilities for fan-in trace correlation.
@@ -545,7 +580,10 @@ declare function withPublishSpan<T>(descriptor: PublishDescriptor, fn: PublishSp
  * });
  * ```
  */
-declare function extractBatchLineage(items: BatchItem[], options?: BatchLineageOptions): BatchLineageResult;
+declare function extractBatchLineage(
+  items: BatchItem[],
+  options?: BatchLineageOptions,
+): BatchLineageResult;
 
 /**
  * Ack tracking utilities for RabbitMQ message processing.
@@ -562,10 +600,10 @@ type AckResult = 'ack' | 'nack' | 'reject';
  * Options for recording ack results.
  */
 interface RecordAckOptions {
-    /**
-     * Whether the message will be requeued (for nack/reject).
-     */
-    requeue?: boolean;
+  /**
+   * Whether the message will be requeued (for nack/reject).
+   */
+  requeue?: boolean;
 }
 /**
  * Record an ack result on a span.
@@ -598,6 +636,35 @@ interface RecordAckOptions {
  * });
  * ```
  */
-declare function recordAckResult(span: Span, result: AckResult, options?: RecordAckOptions): void;
+declare function recordAckResult(
+  span: Span,
+  result: AckResult,
+  options?: RecordAckOptions,
+): void;
 
-export { type AckControls, type AckOutcome, type AckResult, type BatchItem, type BatchLineageOptions, type BatchLineageResult, type ConsumeDescriptor, type ConsumeSpanCallback, type ContextMode, type DeferredConsumeSpanCallback, type InjectOptions, type PublishDescriptor, type PublishSpanCallback, type RawAmqpHeaders, type RecordAckOptions, deriveCorrelationId, extractBatchLineage, extractCorrelationId, extractTraceContext, injectTraceHeaders, normalizeHeaders, recordAckResult, withConsumeSpan, withPublishSpan };
+export {
+  type AckControls,
+  type AckOutcome,
+  type AckResult,
+  type BatchItem,
+  type BatchLineageOptions,
+  type BatchLineageResult,
+  type ConsumeDescriptor,
+  type ConsumeSpanCallback,
+  type ContextMode,
+  type DeferredConsumeSpanCallback,
+  type InjectOptions,
+  type PublishDescriptor,
+  type PublishSpanCallback,
+  type RawAmqpHeaders,
+  type RecordAckOptions,
+  deriveCorrelationId,
+  extractBatchLineage,
+  extractCorrelationId,
+  extractTraceContext,
+  injectTraceHeaders,
+  normalizeHeaders,
+  recordAckResult,
+  withConsumeSpan,
+  withPublishSpan,
+};