autotel-aws 0.2.0

package/dist/chunk-NQ65Y5AI.cjs

@@ -0,0 +1,195 @@
+'use strict';
+
+var chunkUZEJV2YD_cjs = require('./chunk-UZEJV2YD.cjs');
+var chunkQ3DMMQ7K_cjs = require('./chunk-Q3DMMQ7K.cjs');
+var autotel = require('autotel');
+var api = require('@opentelemetry/api');
+
+function traceSNS(config) {
+  const operation = config.operation ?? "publish";
+  return function wrapper(fn) {
+    return autotel.trace(
+      `sns.${operation}`,
+      (ctx) => async (...args) => {
+        ctx.setAttributes(chunkQ3DMMQ7K_cjs.buildSNSAttributes({ topicArn: config.topicArn }));
+        const handler = fn(ctx);
+        return handler(...args);
+      }
+    );
+  };
+}
+var SNSPublisher = class {
+  client;
+  config;
+  topicName;
+  constructor(client, config) {
+    this.client = chunkUZEJV2YD_cjs.wrapSDKClient(client, config.service);
+    this.config = {
+      injectTraceContext: true,
+      ...config
+    };
+    this.topicName = config.topicArn.split(":").pop() || "unknown";
+  }
+  /**
+   * Inject trace context into message attributes
+   */
+  injectContext(attributes) {
+    if (!this.config.injectTraceContext) {
+      return attributes || {};
+    }
+    const carrier = {};
+    api.propagation.inject(api.context.active(), carrier);
+    const result = { ...attributes };
+    if (carrier.traceparent) {
+      result.traceparent = { StringValue: carrier.traceparent, DataType: "String" };
+    }
+    if (carrier.tracestate) {
+      result.tracestate = { StringValue: carrier.tracestate, DataType: "String" };
+    }
+    if (carrier.baggage) {
+      result.baggage = { StringValue: carrier.baggage, DataType: "String" };
+    }
+    return result;
+  }
+  /**
+   * Publish a message to the topic
+   *
+   * @param message - Message to publish
+   * @returns Promise with message ID and sequence number
+   */
+  async publish(message) {
+    return autotel.trace(`sns.publish`, async (ctx) => {
+      ctx.setAttributes(chunkQ3DMMQ7K_cjs.buildSNSAttributes({ topicArn: this.config.topicArn }));
+      ctx.setAttribute("messaging.destination.name", this.topicName);
+      const input = {
+        TopicArn: message.targetArn ? void 0 : this.config.topicArn,
+        TargetArn: message.targetArn,
+        PhoneNumber: message.phoneNumber,
+        Message: message.message,
+        Subject: message.subject,
+        MessageAttributes: this.injectContext(message.attributes),
+        MessageStructure: message.messageStructure,
+        ...message.messageGroupId && { MessageGroupId: message.messageGroupId },
+        ...message.messageDeduplicationId && {
+          MessageDeduplicationId: message.messageDeduplicationId
+        }
+      };
+      try {
+        const { PublishCommand } = await import('@aws-sdk/client-sns');
+        const result = await this.client.send(new PublishCommand(input));
+        if (result.MessageId) {
+          ctx.setAttribute("messaging.message.id", result.MessageId);
+        }
+        ctx.setStatus({ code: api.SpanStatusCode.OK });
+        return {
+          messageId: result.MessageId,
+          sequenceNumber: result.SequenceNumber
+        };
+      } catch (error) {
+        ctx.setStatus({
+          code: api.SpanStatusCode.ERROR,
+          message: error instanceof Error ? error.message : "Publish failed"
+        });
+        throw error;
+      }
+    });
+  }
+  /**
+   * Publish multiple messages in a batch
+   *
+   * @param messages - Array of messages to publish (max 10)
+   * @returns Promise with successful and failed message results
+   */
+  async publishBatch(messages) {
+    return autotel.trace(`sns.publishBatch`, async (ctx) => {
+      ctx.setAttributes(chunkQ3DMMQ7K_cjs.buildSNSAttributes({ topicArn: this.config.topicArn }));
+      ctx.setAttribute("messaging.batch.message_count", messages.length);
+      const entries = messages.map((msg, index) => ({
+        Id: String(index),
+        Message: msg.message,
+        Subject: msg.subject,
+        MessageAttributes: this.injectContext(msg.attributes),
+        MessageStructure: msg.messageStructure,
+        ...msg.messageGroupId && { MessageGroupId: msg.messageGroupId },
+        ...msg.messageDeduplicationId && {
+          MessageDeduplicationId: msg.messageDeduplicationId
+        }
+      }));
+      try {
+        const { PublishBatchCommand } = await import('@aws-sdk/client-sns');
+        const result = await this.client.send(
+          new PublishBatchCommand({
+            TopicArn: this.config.topicArn,
+            PublishBatchRequestEntries: entries
+          })
+        );
+        const successful = result.Successful?.map((s) => ({
+          id: s.Id,
+          messageId: s.MessageId,
+          sequenceNumber: s.SequenceNumber
+        })) || [];
+        const failed = result.Failed?.map((f) => ({
+          id: f.Id,
+          code: f.Code,
+          message: f.Message
+        })) || [];
+        ctx.setAttribute("messaging.sns.successful_count", successful.length);
+        ctx.setAttribute("messaging.sns.failed_count", failed.length);
+        if (failed.length > 0) {
+          ctx.setStatus({
+            code: api.SpanStatusCode.ERROR,
+            message: `${failed.length} messages failed`
+          });
+        } else {
+          ctx.setStatus({ code: api.SpanStatusCode.OK });
+        }
+        return { successful, failed };
+      } catch (error) {
+        ctx.setStatus({
+          code: api.SpanStatusCode.ERROR,
+          message: error instanceof Error ? error.message : "Batch publish failed"
+        });
+        throw error;
+      }
+    });
+  }
+  /**
+   * Publish to a specific endpoint (mobile push, etc.)
+   *
+   * @param message - Message with targetArn set
+   * @returns Promise with message ID
+   */
+  async publishToEndpoint(message) {
+    return autotel.trace(`sns.publishToEndpoint`, async (ctx) => {
+      ctx.setAttribute("messaging.system", "aws_sns");
+      ctx.setAttribute("aws.sns.target_arn", message.targetArn);
+      const input = {
+        TargetArn: message.targetArn,
+        Message: message.message,
+        Subject: message.subject,
+        MessageAttributes: this.injectContext(message.attributes),
+        MessageStructure: message.messageStructure
+      };
+      try {
+        const { PublishCommand } = await import('@aws-sdk/client-sns');
+        const result = await this.client.send(new PublishCommand(input));
+        if (result.MessageId) {
+          ctx.setAttribute("messaging.message.id", result.MessageId);
+        }
+        ctx.setStatus({ code: api.SpanStatusCode.OK });
+        return { messageId: result.MessageId };
+      } catch (error) {
+        ctx.setStatus({
+          code: api.SpanStatusCode.ERROR,
+          message: error instanceof Error ? error.message : "Endpoint publish failed"
+        });
+        throw error;
+      }
+    });
+  }
+};
+
+exports.SNSPublisher = SNSPublisher;
+exports.traceSNS = traceSNS;
+//# sourceMappingURL=chunk-NQ65Y5AI.cjs.map
+//# sourceMappingURL=chunk-NQ65Y5AI.cjs.map

package/dist/chunk-NQ65Y5AI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sns/index.ts"],"names":["trace","buildSNSAttributes","wrapSDKClient","propagation","context","SpanStatusCode"],"mappings":"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","file":"chunk-NQ65Y5AI.cjs","sourcesContent":["/**\n * SNS-specific instrumentation\n *\n * Provides semantic helpers for tracing SNS operations with proper OpenTelemetry\n * messaging semantic conventions. Automatically sets `messaging.*` attributes.\n *\n * @example Publish to topic\n * ```typescript\n * import { traceSNS } from 'autotel-aws/sns';\n * import { SNSClient, PublishCommand } from '@aws-sdk/client-sns';\n *\n * const sns = new SNSClient({});\n *\n * export const publishNotification = traceSNS({\n *   topicArn: 'arn:aws:sns:us-east-1:123456789:notifications'\n * })(ctx => async (message: string, subject?: string) => {\n *   const result = await sns.send(new PublishCommand({\n *     TopicArn: 'arn:aws:sns:us-east-1:123456789:notifications',\n *     Message: message,\n *     Subject: subject\n *   }));\n *\n *   if (result.MessageId) {\n *     ctx.setAttribute('messaging.message.id', result.MessageId);\n *   }\n *\n *   return result;\n * });\n *\n * // Usage: await publishNotification('User signed up', 'New User');\n * ```\n *\n * @example Publish to mobile endpoint\n * ```typescript\n * export const sendPushNotification = traceSNS({\n *   operation: 'publish',\n *   topicArn: 'arn:aws:sns:us-east-1:123456789:app/APNS/my-app'\n * })(ctx => async (endpointArn: string, payload: object) => {\n *   ctx.setAttribute('aws.sns.target_arn', endpointArn);\n *   return await sns.send(new PublishCommand({\n *     TargetArn: endpointArn,\n *     Message: JSON.stringify(payload),\n *     MessageStructure: 'json'\n *   }));\n * });\n * ```\n */\n\nimport { trace, type TraceContext } from 'autotel';\nimport { context, propagation, SpanStatusCode } from '@opentelemetry/api';\nimport { buildSNSAttributes } from '../attributes';\nimport { wrapSDKClient } from '../common/sdk-wrapper';\n\n/**\n * SNS operation configuration\n */\nexport interface TraceSNSConfig {\n  /**\n   * SNS topic ARN\n   * Sets `messaging.destination.name` attribute.\n   */\n  topicArn: string;\n\n  /**\n   * Operation type (defaults to 'publish')\n   */\n  operation?: 'publish' | 'subscribe' | 'unsubscribe';\n}\n\n/**\n * Trace SNS operations with semantic attributes\n *\n * Creates a traced function that automatically sets SNS messaging semantic attributes\n * following OpenTelemetry conventions.\n *\n * @param config - SNS operation configuration\n * @returns A higher-order function that wraps your SNS operation with tracing\n *\n * @remarks\n * Semantic attributes set automatically:\n * - `messaging.system` - 'aws_sns'\n * - `messaging.destination.name` - Topic ARN\n * - `messaging.operation` - 'publish'\n *\n * Additional attributes you should set in your handler:\n * - `messaging.message.id` - Message ID from response\n * - `aws.sns.target_arn` - Target ARN for direct publishing\n *\n * @see https://opentelemetry.io/docs/specs/semconv/messaging/aws-sns/\n */\nexport function traceSNS(config: TraceSNSConfig) {\n  const operation = config.operation ?? 'publish';\n\n  return function wrapper<TArgs extends unknown[], TReturn>(\n    fn: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n  ): (...args: TArgs) => Promise<TReturn> {\n    // Use autotel's trace() which properly handles the factory pattern\n    return trace(\n      `sns.${operation}`,\n      (ctx: TraceContext) =>\n        async (...args: TArgs): Promise<TReturn> => {\n          // Set SNS semantic attributes\n          ctx.setAttributes(buildSNSAttributes({ topicArn: config.topicArn }));\n\n          // Get the user's handler and execute with forwarded arguments\n          const handler = fn(ctx);\n          return handler(...args);\n        },\n    );\n  };\n}\n\n// ============================================================================\n// SNS Publisher - Publishes messages with automatic trace context injection\n// ============================================================================\n\n/**\n * Configuration for SNS Publisher\n */\nexport interface SNSPublisherConfig {\n  /**\n   * SNS Topic ARN\n   */\n  topicArn: string;\n\n  /**\n   * Inject W3C Trace Context into message attributes\n   * Enables distributed tracing to SNS subscribers (e.g., Lambda, SQS)\n   * @default true\n   */\n  injectTraceContext?: boolean;\n\n  /**\n   * Optional service name for tracing\n   */\n  service?: string;\n}\n\n/**\n * Message to publish via SNS Publisher\n */\nexport interface SNSPublishMessage {\n  /**\n   * Message body (string or JSON for message structure)\n   */\n  message: string;\n\n  /**\n   * Optional subject (for email/SMS subscriptions)\n   */\n  subject?: string;\n\n  /**\n   * Optional message attributes\n   */\n  attributes?: Record<string, { StringValue: string; DataType: string }>;\n\n  /**\n   * Optional target ARN for direct endpoint publishing\n   */\n  targetArn?: string;\n\n  /**\n   * Optional phone number for SMS\n   */\n  phoneNumber?: string;\n\n  /**\n   * Optional message structure ('json' for platform-specific messages)\n   */\n  messageStructure?: 'json';\n\n  /**\n   * Optional message group ID (for FIFO topics)\n   */\n  messageGroupId?: string;\n\n  /**\n   * Optional deduplication ID (for FIFO topics)\n   */\n  messageDeduplicationId?: string;\n}\n\n/**\n * SNS Publisher with automatic trace context injection\n *\n * Wraps an SNS client to automatically:\n * - Create spans for publish operations\n * - Inject W3C Trace Context into message attributes\n * - Set proper semantic attributes\n *\n * @example Basic usage\n * ```typescript\n * import { SNSPublisher } from 'autotel-aws/sns';\n * import { SNSClient } from '@aws-sdk/client-sns';\n *\n * const sns = new SNSClient({ region: 'us-east-1' });\n * const publisher = new SNSPublisher(sns, {\n *   topicArn: 'arn:aws:sns:us-east-1:123456789:my-topic'\n * });\n *\n * // Publish with automatic trace context\n * const result = await publisher.publish({\n *   message: 'Order completed',\n *   subject: 'Order #12345'\n * });\n * console.log('Message ID:', result.messageId);\n * ```\n *\n * @example With custom attributes\n * ```typescript\n * await publisher.publish({\n *   message: JSON.stringify({ orderId: '12345', status: 'completed' }),\n *   attributes: {\n *     'eventType': { StringValue: 'ORDER_COMPLETED', DataType: 'String' },\n *     'priority': { StringValue: 'high', DataType: 'String' }\n *   }\n * });\n * ```\n *\n * @example Batch publish\n * ```typescript\n * const results = await publisher.publishBatch([\n *   { message: 'Event 1' },\n *   { message: 'Event 2' },\n *   { message: 'Event 3' }\n * ]);\n * console.log(`Published ${results.successful.length} messages`);\n * ```\n *\n * @example Direct endpoint publish\n * ```typescript\n * await publisher.publishToEndpoint({\n *   targetArn: 'arn:aws:sns:us-east-1:123456789:endpoint/APNS/my-app/device-token',\n *   message: JSON.stringify({\n *     APNS: JSON.stringify({ aps: { alert: 'Hello!' } })\n *   }),\n *   messageStructure: 'json'\n * });\n * ```\n */\nexport class SNSPublisher<\n   \n  TClient extends { send: (command: any) => Promise<any> } = any,\n> {\n  private client: TClient;\n  private config: Required<Pick<SNSPublisherConfig, 'topicArn'>> & SNSPublisherConfig;\n  private topicName: string;\n\n  constructor(client: TClient, config: SNSPublisherConfig) {\n    this.client = wrapSDKClient(client as any, config.service) as TClient;\n    this.config = {\n      injectTraceContext: true,\n      ...config,\n    };\n    // Extract topic name from ARN (last segment)\n    this.topicName = config.topicArn.split(':').pop() || 'unknown';\n  }\n\n  /**\n   * Inject trace context into message attributes\n   */\n  private injectContext(\n    attributes?: Record<string, { StringValue: string; DataType: string }>,\n  ): Record<string, { StringValue: string; DataType: string }> {\n    if (!this.config.injectTraceContext) {\n      return attributes || {};\n    }\n\n    const carrier: Record<string, string> = {};\n    propagation.inject(context.active(), carrier);\n\n    const result = { ...attributes };\n\n    if (carrier.traceparent) {\n      result.traceparent = { StringValue: carrier.traceparent, DataType: 'String' };\n    }\n    if (carrier.tracestate) {\n      result.tracestate = { StringValue: carrier.tracestate, DataType: 'String' };\n    }\n    if (carrier.baggage) {\n      result.baggage = { StringValue: carrier.baggage, DataType: 'String' };\n    }\n\n    return result;\n  }\n\n  /**\n   * Publish a message to the topic\n   *\n   * @param message - Message to publish\n   * @returns Promise with message ID and sequence number\n   */\n  async publish(message: SNSPublishMessage): Promise<{\n    messageId?: string;\n    sequenceNumber?: string;\n  }> {\n    return trace(`sns.publish`, async (ctx: TraceContext) => {\n      ctx.setAttributes(buildSNSAttributes({ topicArn: this.config.topicArn }));\n      ctx.setAttribute('messaging.destination.name', this.topicName);\n\n      const input = {\n        TopicArn: message.targetArn ? undefined : this.config.topicArn,\n        TargetArn: message.targetArn,\n        PhoneNumber: message.phoneNumber,\n        Message: message.message,\n        Subject: message.subject,\n        MessageAttributes: this.injectContext(message.attributes),\n        MessageStructure: message.messageStructure,\n        ...(message.messageGroupId && { MessageGroupId: message.messageGroupId }),\n        ...(message.messageDeduplicationId && {\n          MessageDeduplicationId: message.messageDeduplicationId,\n        }),\n      };\n\n      try {\n        const { PublishCommand } = await import('@aws-sdk/client-sns');\n        const result = await this.client.send(new PublishCommand(input));\n\n        if (result.MessageId) {\n          ctx.setAttribute('messaging.message.id', result.MessageId);\n        }\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return {\n          messageId: result.MessageId,\n          sequenceNumber: result.SequenceNumber,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Publish failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Publish multiple messages in a batch\n   *\n   * @param messages - Array of messages to publish (max 10)\n   * @returns Promise with successful and failed message results\n   */\n  async publishBatch(messages: SNSPublishMessage[]): Promise<{\n    successful: Array<{ id: string; messageId?: string; sequenceNumber?: string }>;\n    failed: Array<{ id: string; code?: string; message?: string }>;\n  }> {\n    return trace(`sns.publishBatch`, async (ctx: TraceContext) => {\n      ctx.setAttributes(buildSNSAttributes({ topicArn: this.config.topicArn }));\n      ctx.setAttribute('messaging.batch.message_count', messages.length);\n\n      const entries = messages.map((msg, index) => ({\n        Id: String(index),\n        Message: msg.message,\n        Subject: msg.subject,\n        MessageAttributes: this.injectContext(msg.attributes),\n        MessageStructure: msg.messageStructure,\n        ...(msg.messageGroupId && { MessageGroupId: msg.messageGroupId }),\n        ...(msg.messageDeduplicationId && {\n          MessageDeduplicationId: msg.messageDeduplicationId,\n        }),\n      }));\n\n      try {\n        const { PublishBatchCommand } = await import('@aws-sdk/client-sns');\n        const result = await this.client.send(\n          new PublishBatchCommand({\n            TopicArn: this.config.topicArn,\n            PublishBatchRequestEntries: entries,\n          }),\n        );\n\n        const successful =\n          result.Successful?.map((s: { Id?: string; MessageId?: string; SequenceNumber?: string }) => ({\n            id: s.Id!,\n            messageId: s.MessageId,\n            sequenceNumber: s.SequenceNumber,\n          })) || [];\n\n        const failed =\n          result.Failed?.map((f: { Id?: string; Code?: string; Message?: string }) => ({\n            id: f.Id!,\n            code: f.Code,\n            message: f.Message,\n          })) || [];\n\n        ctx.setAttribute('messaging.sns.successful_count', successful.length);\n        ctx.setAttribute('messaging.sns.failed_count', failed.length);\n\n        if (failed.length > 0) {\n          ctx.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: `${failed.length} messages failed`,\n          });\n        } else {\n          ctx.setStatus({ code: SpanStatusCode.OK });\n        }\n\n        return { successful, failed };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Batch publish failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Publish to a specific endpoint (mobile push, etc.)\n   *\n   * @param message - Message with targetArn set\n   * @returns Promise with message ID\n   */\n  async publishToEndpoint(\n    message: Omit<SNSPublishMessage, 'targetArn'> & { targetArn: string },\n  ): Promise<{ messageId?: string }> {\n    return trace(`sns.publishToEndpoint`, async (ctx: TraceContext) => {\n      ctx.setAttribute('messaging.system', 'aws_sns');\n      ctx.setAttribute('aws.sns.target_arn', message.targetArn);\n\n      const input = {\n        TargetArn: message.targetArn,\n        Message: message.message,\n        Subject: message.subject,\n        MessageAttributes: this.injectContext(message.attributes),\n        MessageStructure: message.messageStructure,\n      };\n\n      try {\n        const { PublishCommand } = await import('@aws-sdk/client-sns');\n        const result = await this.client.send(new PublishCommand(input));\n\n        if (result.MessageId) {\n          ctx.setAttribute('messaging.message.id', result.MessageId);\n        }\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return { messageId: result.MessageId };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Endpoint publish failed',\n        });\n        throw error;\n      }\n    });\n  }\n}\n"]}

package/dist/chunk-OB4XTAVK.cjs

@@ -0,0 +1,345 @@
+'use strict';
+
+var chunkUZEJV2YD_cjs = require('./chunk-UZEJV2YD.cjs');
+var chunkQ3DMMQ7K_cjs = require('./chunk-Q3DMMQ7K.cjs');
+var autotel = require('autotel');
+var api = require('@opentelemetry/api');
+
+function traceSQS(config) {
+  return function wrapper(fn) {
+    return autotel.trace(
+      `sqs.${config.operation}`,
+      (ctx) => async (...args) => {
+        ctx.setAttributes(
+          chunkQ3DMMQ7K_cjs.buildSQSAttributes({
+            queueName: config.queueName,
+            queueUrl: config.queueUrl,
+            operation: config.operation
+          })
+        );
+        const handler = fn(ctx);
+        return handler(...args);
+      }
+    );
+  };
+}
+var SQSProducer = class {
+  client;
+  config;
+  queueName;
+  constructor(client, config) {
+    this.client = chunkUZEJV2YD_cjs.wrapSDKClient(client, config.service);
+    this.config = {
+      injectTraceContext: true,
+      ...config
+    };
+    this.queueName = config.queueUrl.split("/").pop() || "unknown";
+  }
+  /**
+   * Inject trace context into message attributes
+   */
+  injectContext(attributes) {
+    if (!this.config.injectTraceContext) {
+      return attributes || {};
+    }
+    const carrier = {};
+    api.propagation.inject(api.context.active(), carrier);
+    const result = { ...attributes };
+    if (carrier.traceparent) {
+      result.traceparent = { StringValue: carrier.traceparent, DataType: "String" };
+    }
+    if (carrier.tracestate) {
+      result.tracestate = { StringValue: carrier.tracestate, DataType: "String" };
+    }
+    if (carrier.baggage) {
+      result.baggage = { StringValue: carrier.baggage, DataType: "String" };
+    }
+    return result;
+  }
+  /**
+   * Send a single message to the queue
+   *
+   * @param message - Message to send
+   * @returns Promise with message ID and other metadata
+   */
+  async send(message) {
+    return autotel.trace(`sqs.send`, async (ctx) => {
+      ctx.setAttributes(
+        chunkQ3DMMQ7K_cjs.buildSQSAttributes({
+          queueName: this.queueName,
+          queueUrl: this.config.queueUrl,
+          operation: "send"
+        })
+      );
+      const input = {
+        QueueUrl: this.config.queueUrl,
+        MessageBody: message.body,
+        MessageAttributes: this.injectContext(message.attributes),
+        ...message.messageGroupId && { MessageGroupId: message.messageGroupId },
+        ...message.messageDeduplicationId && {
+          MessageDeduplicationId: message.messageDeduplicationId
+        },
+        ...message.delaySeconds !== void 0 && { DelaySeconds: message.delaySeconds }
+      };
+      try {
+        const { SendMessageCommand } = await import('@aws-sdk/client-sqs');
+        const result = await this.client.send(new SendMessageCommand(input));
+        if (result.MessageId) {
+          ctx.setAttribute("messaging.message.id", result.MessageId);
+        }
+        ctx.setStatus({ code: api.SpanStatusCode.OK });
+        return {
+          messageId: result.MessageId,
+          sequenceNumber: result.SequenceNumber,
+          md5OfMessageBody: result.MD5OfMessageBody
+        };
+      } catch (error) {
+        ctx.setStatus({
+          code: api.SpanStatusCode.ERROR,
+          message: error instanceof Error ? error.message : "Send failed"
+        });
+        throw error;
+      }
+    });
+  }
+  /**
+   * Send multiple messages in a batch
+   *
+   * @param messages - Array of messages to send (max 10)
+   * @returns Promise with successful and failed message results
+   */
+  async sendBatch(messages) {
+    return autotel.trace(`sqs.sendBatch`, async (ctx) => {
+      ctx.setAttributes(
+        chunkQ3DMMQ7K_cjs.buildSQSAttributes({
+          queueName: this.queueName,
+          queueUrl: this.config.queueUrl,
+          operation: "send"
+        })
+      );
+      ctx.setAttribute("messaging.batch.message_count", messages.length);
+      const entries = messages.map((message, index) => ({
+        Id: String(index),
+        MessageBody: message.body,
+        MessageAttributes: this.injectContext(message.attributes),
+        ...message.messageGroupId && { MessageGroupId: message.messageGroupId },
+        ...message.messageDeduplicationId && {
+          MessageDeduplicationId: message.messageDeduplicationId
+        },
+        ...message.delaySeconds !== void 0 && { DelaySeconds: message.delaySeconds }
+      }));
+      try {
+        const { SendMessageBatchCommand } = await import('@aws-sdk/client-sqs');
+        const result = await this.client.send(
+          new SendMessageBatchCommand({
+            QueueUrl: this.config.queueUrl,
+            Entries: entries
+          })
+        );
+        const successful = result.Successful?.map((s) => ({
+          id: s.Id,
+          messageId: s.MessageId,
+          sequenceNumber: s.SequenceNumber
+        })) || [];
+        const failed = result.Failed?.map((f) => ({
+          id: f.Id,
+          code: f.Code,
+          message: f.Message
+        })) || [];
+        ctx.setAttribute("messaging.sqs.successful_count", successful.length);
+        ctx.setAttribute("messaging.sqs.failed_count", failed.length);
+        if (failed.length > 0) {
+          ctx.setStatus({
+            code: api.SpanStatusCode.ERROR,
+            message: `${failed.length} messages failed`
+          });
+        } else {
+          ctx.setStatus({ code: api.SpanStatusCode.OK });
+        }
+        return { successful, failed };
+      } catch (error) {
+        ctx.setStatus({
+          code: api.SpanStatusCode.ERROR,
+          message: error instanceof Error ? error.message : "Batch send failed"
+        });
+        throw error;
+      }
+    });
+  }
+};
+var SQSConsumer = class {
+  client;
+  config;
+  queueName;
+  constructor(client, config) {
+    this.client = chunkUZEJV2YD_cjs.wrapSDKClient(client, config.service);
+    this.config = {
+      extractTraceContext: true,
+      maxMessages: 10,
+      visibilityTimeout: 30,
+      waitTimeSeconds: 20,
+      ...config
+    };
+    this.queueName = config.queueUrl.split("/").pop() || "unknown";
+  }
+  /**
+   * Extract trace context from message attributes
+   */
+  extractContext(messageAttributes) {
+    if (!this.config.extractTraceContext || !messageAttributes) {
+      return void 0;
+    }
+    const carrier = {};
+    if (messageAttributes.traceparent?.StringValue) {
+      carrier.traceparent = messageAttributes.traceparent.StringValue;
+    }
+    if (messageAttributes.tracestate?.StringValue) {
+      carrier.tracestate = messageAttributes.tracestate.StringValue;
+    }
+    if (messageAttributes.baggage?.StringValue) {
+      carrier.baggage = messageAttributes.baggage.StringValue;
+    }
+    return Object.keys(carrier).length > 0 ? carrier : void 0;
+  }
+  /**
+   * Parse AWS SDK message into our format
+   */
+  parseMessage(message) {
+    const attributes = {};
+    if (message.MessageAttributes) {
+      for (const [key, value] of Object.entries(message.MessageAttributes)) {
+        attributes[key] = value.StringValue || "";
+      }
+    }
+    return {
+      messageId: message.MessageId || "",
+      receiptHandle: message.ReceiptHandle || "",
+      body: message.Body || "",
+      attributes,
+      systemAttributes: message.Attributes || {},
+      raw: message
+    };
+  }
+  /**
+   * Receive messages from the queue
+   *
+   * @returns Array of received messages
+   */
+  async receive() {
+    return autotel.trace(`sqs.receive`, async (ctx) => {
+      ctx.setAttributes(
+        chunkQ3DMMQ7K_cjs.buildSQSAttributes({
+          queueName: this.queueName,
+          queueUrl: this.config.queueUrl,
+          operation: "receive"
+        })
+      );
+      try {
+        const { ReceiveMessageCommand } = await import('@aws-sdk/client-sqs');
+        const result = await this.client.send(
+          new ReceiveMessageCommand({
+            QueueUrl: this.config.queueUrl,
+            MaxNumberOfMessages: this.config.maxMessages,
+            VisibilityTimeout: this.config.visibilityTimeout,
+            WaitTimeSeconds: this.config.waitTimeSeconds,
+            MessageAttributeNames: ["All"],
+            AttributeNames: ["All"]
+          })
+        );
+        const messages = (result.Messages || []).map((m) => this.parseMessage(m));
+        ctx.setAttribute("messaging.batch.message_count", messages.length);
+        ctx.setStatus({ code: api.SpanStatusCode.OK });
+        return messages;
+      } catch (error) {
+        ctx.setStatus({
+          code: api.SpanStatusCode.ERROR,
+          message: error instanceof Error ? error.message : "Receive failed"
+        });
+        throw error;
+      }
+    });
+  }
+  /**
+   * Delete a message from the queue
+   *
+   * @param receiptHandle - Receipt handle of the message to delete
+   */
+  async delete(receiptHandle) {
+    const { DeleteMessageCommand } = await import('@aws-sdk/client-sqs');
+    await this.client.send(
+      new DeleteMessageCommand({
+        QueueUrl: this.config.queueUrl,
+        ReceiptHandle: receiptHandle
+      })
+    );
+  }
+  /**
+   * Process messages with automatic trace context extraction
+   *
+   * Receives messages, processes each with the provided handler,
+   * and deletes successfully processed messages.
+   *
+   * @param processor - Function to process each message
+   * @returns Number of messages processed
+   */
+  async processMessages(processor) {
+    const messages = await this.receive();
+    let processed = 0;
+    for (const message of messages) {
+      const carrier = this.extractContext(message.raw.MessageAttributes);
+      const processMessage = async () => {
+        return autotel.trace(`sqs.process`, async (ctx) => {
+          ctx.setAttributes(
+            chunkQ3DMMQ7K_cjs.buildSQSAttributes({
+              queueName: this.queueName,
+              queueUrl: this.config.queueUrl,
+              operation: "receive"
+            })
+          );
+          ctx.setAttribute("messaging.message.id", message.messageId);
+          try {
+            await processor(message, ctx);
+            await this.delete(message.receiptHandle);
+            processed++;
+            ctx.setStatus({ code: api.SpanStatusCode.OK });
+          } catch (error) {
+            ctx.setStatus({
+              code: api.SpanStatusCode.ERROR,
+              message: error instanceof Error ? error.message : "Processing failed"
+            });
+            throw error;
+          }
+        });
+      };
+      if (carrier) {
+        const extractedContext = api.propagation.extract(api.context.active(), carrier);
+        await api.context.with(extractedContext, processMessage);
+      } else {
+        await processMessage();
+      }
+    }
+    return processed;
+  }
+  /**
+   * Start continuous polling loop
+   *
+   * @param processor - Function to process each message
+   * @param options - Polling options including abort signal
+   */
+  async poll(processor, options) {
+    while (!options?.signal?.aborted) {
+      try {
+        await this.processMessages(processor);
+      } catch (error) {
+        console.error("[SQSConsumer] Error processing messages:", error);
+        await new Promise((resolve) => setTimeout(resolve, 1e3));
+      }
+    }
+  }
+};
+
+exports.SQSConsumer = SQSConsumer;
+exports.SQSProducer = SQSProducer;
+exports.traceSQS = traceSQS;
+//# sourceMappingURL=chunk-OB4XTAVK.cjs.map
+//# sourceMappingURL=chunk-OB4XTAVK.cjs.map

package/dist/chunk-OB4XTAVK.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sqs/index.ts"],"names":["trace","buildSQSAttributes","wrapSDKClient","propagation","context","SpanStatusCode"],"mappings":"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","file":"chunk-OB4XTAVK.cjs","sourcesContent":["/**\n * SQS-specific instrumentation\n *\n * Provides semantic helpers for tracing SQS operations with proper OpenTelemetry\n * messaging semantic conventions. Automatically sets `messaging.*` and `aws.sqs.*` attributes.\n *\n * @example Send message\n * ```typescript\n * import { traceSQS } from 'autotel-aws/sqs';\n * import { SQSClient, SendMessageCommand } from '@aws-sdk/client-sqs';\n *\n * const sqs = new SQSClient({});\n *\n * export const sendMessage = traceSQS({\n *   operation: 'send',\n *   queueName: 'my-queue',\n *   queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue'\n * })(ctx => async (body: string, attributes?: Record<string, string>) => {\n *   const result = await sqs.send(new SendMessageCommand({\n *     QueueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',\n *     MessageBody: body,\n *     MessageAttributes: attributes\n *   }));\n *\n *   if (result.MessageId) {\n *     ctx.setAttribute('messaging.message.id', result.MessageId);\n *   }\n *\n *   return result;\n * });\n *\n * // Usage: await sendMessage('Hello!', { correlationId: { StringValue: '123', DataType: 'String' } });\n * ```\n *\n * @example Receive and process messages\n * ```typescript\n * export const receiveMessages = traceSQS({\n *   operation: 'receive',\n *   queueName: 'my-queue'\n * })(ctx => async (maxMessages: number) => {\n *   const result = await sqs.send(new ReceiveMessageCommand({\n *     QueueUrl: 'https://sqs.../my-queue',\n *     MaxNumberOfMessages: maxMessages\n *   }));\n *\n *   ctx.setAttribute('messaging.batch.message_count', result.Messages?.length ?? 0);\n *   return result.Messages;\n * });\n * ```\n */\n\nimport { trace, type TraceContext } from 'autotel';\nimport { context, propagation, SpanStatusCode } from '@opentelemetry/api';\nimport { buildSQSAttributes } from '../attributes';\nimport { wrapSDKClient } from '../common/sdk-wrapper';\n\n/**\n * SQS operation configuration\n */\nexport interface TraceSQSConfig {\n  /**\n   * SQS operation type\n   * - 'send' - SendMessage, SendMessageBatch\n   * - 'receive' - ReceiveMessage\n   */\n  operation: 'send' | 'receive';\n\n  /**\n   * Queue name (last segment of queue URL)\n   * Sets `messaging.destination.name` attribute.\n   */\n  queueName: string;\n\n  /**\n   * Full queue URL\n   * Sets `aws.sqs.queue_url` attribute.\n   */\n  queueUrl?: string;\n}\n\n/**\n * Trace SQS operations with semantic attributes\n *\n * Creates a traced function that automatically sets SQS messaging semantic attributes\n * following OpenTelemetry conventions.\n *\n * @param config - SQS operation configuration\n * @returns A higher-order function that wraps your SQS operation with tracing\n *\n * @remarks\n * Semantic attributes set automatically:\n * - `messaging.system` - 'aws_sqs'\n * - `messaging.destination.name` - Queue name\n * - `messaging.operation` - 'send' or 'receive'\n * - `aws.sqs.queue_url` - Full queue URL (if provided)\n *\n * Additional attributes you should set in your handler:\n * - `messaging.message.id` - Message ID from response\n * - `messaging.batch.message_count` - Number of messages in batch\n *\n * @see https://opentelemetry.io/docs/specs/semconv/messaging/aws-sqs/\n */\nexport function traceSQS(config: TraceSQSConfig) {\n  return function wrapper<TArgs extends unknown[], TReturn>(\n    fn: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n  ): (...args: TArgs) => Promise<TReturn> {\n    // Use autotel's trace() which properly handles the factory pattern\n    return trace(\n      `sqs.${config.operation}`,\n      (ctx: TraceContext) =>\n        async (...args: TArgs): Promise<TReturn> => {\n          // Set SQS semantic attributes\n          ctx.setAttributes(\n            buildSQSAttributes({\n              queueName: config.queueName,\n              queueUrl: config.queueUrl,\n              operation: config.operation,\n            }),\n          );\n\n          // Get the user's handler and execute with forwarded arguments\n          const handler = fn(ctx);\n          return handler(...args);\n        },\n    );\n  };\n}\n\n// ============================================================================\n// SQS Producer - Sends messages with automatic trace context injection\n// ============================================================================\n\n/**\n * Configuration for SQS Producer\n */\nexport interface SQSProducerConfig {\n  /**\n   * Full SQS queue URL\n   */\n  queueUrl: string;\n\n  /**\n   * Inject W3C Trace Context into message attributes\n   * Enables distributed tracing across producer/consumer\n   * @default true\n   */\n  injectTraceContext?: boolean;\n\n  /**\n   * Optional service name for tracing\n   */\n  service?: string;\n}\n\n/**\n * Message to send via SQS Producer\n */\nexport interface SQSMessage {\n  /**\n   * Message body (string)\n   */\n  body: string;\n\n  /**\n   * Optional message attributes\n   */\n  attributes?: Record<string, { StringValue: string; DataType: string }>;\n\n  /**\n   * Optional message group ID (for FIFO queues)\n   */\n  messageGroupId?: string;\n\n  /**\n   * Optional deduplication ID (for FIFO queues)\n   */\n  messageDeduplicationId?: string;\n\n  /**\n   * Optional delay in seconds (0-900)\n   */\n  delaySeconds?: number;\n}\n\n/**\n * SQS Producer with automatic trace context injection\n *\n * Wraps an SQS client to automatically:\n * - Create spans for send operations\n * - Inject W3C Trace Context into message attributes\n * - Set proper semantic attributes\n *\n * @example Basic usage\n * ```typescript\n * import { SQSProducer } from 'autotel-aws/sqs';\n * import { SQSClient } from '@aws-sdk/client-sqs';\n *\n * const sqs = new SQSClient({ region: 'us-east-1' });\n * const producer = new SQSProducer(sqs, {\n *   queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue'\n * });\n *\n * // Send with automatic trace context\n * const result = await producer.send({ body: 'Hello!' });\n * console.log('Message ID:', result.messageId);\n * ```\n *\n * @example With custom attributes\n * ```typescript\n * await producer.send({\n *   body: JSON.stringify({ orderId: '12345' }),\n *   attributes: {\n *     'correlationId': { StringValue: 'abc-123', DataType: 'String' },\n *     'eventType': { StringValue: 'ORDER_CREATED', DataType: 'String' }\n *   }\n * });\n * ```\n *\n * @example Batch send\n * ```typescript\n * const results = await producer.sendBatch([\n *   { body: 'Message 1' },\n *   { body: 'Message 2' },\n *   { body: 'Message 3' }\n * ]);\n * console.log(`Sent ${results.successful.length} messages`);\n * ```\n */\nexport class SQSProducer<\n   \n  TClient extends { send: (command: any) => Promise<any> } = any,\n> {\n  private client: TClient;\n  private config: Required<Pick<SQSProducerConfig, 'queueUrl'>> & SQSProducerConfig;\n  private queueName: string;\n\n  constructor(client: TClient, config: SQSProducerConfig) {\n    // Wrap the client for basic tracing if not already wrapped\n    this.client = wrapSDKClient(client as any, config.service) as TClient;\n    this.config = {\n      injectTraceContext: true,\n      ...config,\n    };\n    // Extract queue name from URL\n    this.queueName = config.queueUrl.split('/').pop() || 'unknown';\n  }\n\n  /**\n   * Inject trace context into message attributes\n   */\n  private injectContext(\n    attributes?: Record<string, { StringValue: string; DataType: string }>,\n  ): Record<string, { StringValue: string; DataType: string }> {\n    if (!this.config.injectTraceContext) {\n      return attributes || {};\n    }\n\n    const carrier: Record<string, string> = {};\n    propagation.inject(context.active(), carrier);\n\n    const result = { ...attributes };\n\n    if (carrier.traceparent) {\n      result.traceparent = { StringValue: carrier.traceparent, DataType: 'String' };\n    }\n    if (carrier.tracestate) {\n      result.tracestate = { StringValue: carrier.tracestate, DataType: 'String' };\n    }\n    if (carrier.baggage) {\n      result.baggage = { StringValue: carrier.baggage, DataType: 'String' };\n    }\n\n    return result;\n  }\n\n  /**\n   * Send a single message to the queue\n   *\n   * @param message - Message to send\n   * @returns Promise with message ID and other metadata\n   */\n  async send(message: SQSMessage): Promise<{\n    messageId?: string;\n    sequenceNumber?: string;\n    md5OfMessageBody?: string;\n  }> {\n    return trace(`sqs.send`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildSQSAttributes({\n          queueName: this.queueName,\n          queueUrl: this.config.queueUrl,\n          operation: 'send',\n        }),\n      );\n\n      // Build command input\n      const input = {\n        QueueUrl: this.config.queueUrl,\n        MessageBody: message.body,\n        MessageAttributes: this.injectContext(message.attributes),\n        ...(message.messageGroupId && { MessageGroupId: message.messageGroupId }),\n        ...(message.messageDeduplicationId && {\n          MessageDeduplicationId: message.messageDeduplicationId,\n        }),\n        ...(message.delaySeconds !== undefined && { DelaySeconds: message.delaySeconds }),\n      };\n\n      // Dynamically import the command to avoid requiring @aws-sdk/client-sqs at load time\n      try {\n        const { SendMessageCommand } = await import('@aws-sdk/client-sqs');\n        const result = await this.client.send(new SendMessageCommand(input));\n\n        if (result.MessageId) {\n          ctx.setAttribute('messaging.message.id', result.MessageId);\n        }\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return {\n          messageId: result.MessageId,\n          sequenceNumber: result.SequenceNumber,\n          md5OfMessageBody: result.MD5OfMessageBody,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Send failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Send multiple messages in a batch\n   *\n   * @param messages - Array of messages to send (max 10)\n   * @returns Promise with successful and failed message results\n   */\n  async sendBatch(messages: SQSMessage[]): Promise<{\n    successful: Array<{ id: string; messageId?: string; sequenceNumber?: string }>;\n    failed: Array<{ id: string; code?: string; message?: string }>;\n  }> {\n    return trace(`sqs.sendBatch`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildSQSAttributes({\n          queueName: this.queueName,\n          queueUrl: this.config.queueUrl,\n          operation: 'send',\n        }),\n      );\n      ctx.setAttribute('messaging.batch.message_count', messages.length);\n\n      // Build batch entries\n      const entries = messages.map((message, index) => ({\n        Id: String(index),\n        MessageBody: message.body,\n        MessageAttributes: this.injectContext(message.attributes),\n        ...(message.messageGroupId && { MessageGroupId: message.messageGroupId }),\n        ...(message.messageDeduplicationId && {\n          MessageDeduplicationId: message.messageDeduplicationId,\n        }),\n        ...(message.delaySeconds !== undefined && { DelaySeconds: message.delaySeconds }),\n      }));\n\n      try {\n        const { SendMessageBatchCommand } = await import('@aws-sdk/client-sqs');\n        const result = await this.client.send(\n          new SendMessageBatchCommand({\n            QueueUrl: this.config.queueUrl,\n            Entries: entries,\n          }),\n        );\n\n        const successful =\n          result.Successful?.map((s: { Id?: string; MessageId?: string; SequenceNumber?: string }) => ({\n            id: s.Id!,\n            messageId: s.MessageId,\n            sequenceNumber: s.SequenceNumber,\n          })) || [];\n\n        const failed =\n          result.Failed?.map((f: { Id?: string; Code?: string; Message?: string }) => ({\n            id: f.Id!,\n            code: f.Code,\n            message: f.Message,\n          })) || [];\n\n        ctx.setAttribute('messaging.sqs.successful_count', successful.length);\n        ctx.setAttribute('messaging.sqs.failed_count', failed.length);\n\n        if (failed.length > 0) {\n          ctx.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: `${failed.length} messages failed`,\n          });\n        } else {\n          ctx.setStatus({ code: SpanStatusCode.OK });\n        }\n\n        return { successful, failed };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Batch send failed',\n        });\n        throw error;\n      }\n    });\n  }\n}\n\n// ============================================================================\n// SQS Consumer - Receives and processes messages with trace context extraction\n// ============================================================================\n\n/**\n * Configuration for SQS Consumer\n */\nexport interface SQSConsumerConfig {\n  /**\n   * Full SQS queue URL\n   */\n  queueUrl: string;\n\n  /**\n   * Extract W3C Trace Context from message attributes\n   * Creates child spans linked to the producer\n   * @default true\n   */\n  extractTraceContext?: boolean;\n\n  /**\n   * Maximum number of messages to receive per poll\n   * @default 10\n   */\n  maxMessages?: number;\n\n  /**\n   * Visibility timeout in seconds\n   * @default 30\n   */\n  visibilityTimeout?: number;\n\n  /**\n   * Wait time for long polling in seconds (0-20)\n   * @default 20\n   */\n  waitTimeSeconds?: number;\n\n  /**\n   * Optional service name for tracing\n   */\n  service?: string;\n}\n\n/**\n * Received SQS message with parsed attributes\n */\nexport interface ReceivedSQSMessage {\n  /**\n   * Message ID\n   */\n  messageId: string;\n\n  /**\n   * Receipt handle for deletion\n   */\n  receiptHandle: string;\n\n  /**\n   * Message body (string)\n   */\n  body: string;\n\n  /**\n   * Parsed message attributes\n   */\n  attributes: Record<string, string>;\n\n  /**\n   * System attributes (ApproximateReceiveCount, etc.)\n   */\n  systemAttributes: Record<string, string>;\n\n  /**\n   * Original AWS SDK message object\n   */\n   \n  raw: any;\n}\n\n/**\n * Message processor function type\n */\nexport type MessageProcessor = (\n  message: ReceivedSQSMessage,\n  ctx: TraceContext,\n) => Promise<void>;\n\n/**\n * SQS Consumer with automatic trace context extraction\n *\n * Wraps an SQS client to automatically:\n * - Create spans for receive/process operations\n * - Extract W3C Trace Context from message attributes\n * - Link consumer spans to producer spans\n * - Delete messages after successful processing\n *\n * @example Basic usage\n * ```typescript\n * import { SQSConsumer } from 'autotel-aws/sqs';\n * import { SQSClient } from '@aws-sdk/client-sqs';\n *\n * const sqs = new SQSClient({ region: 'us-east-1' });\n * const consumer = new SQSConsumer(sqs, {\n *   queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue'\n * });\n *\n * // Process messages with automatic tracing\n * await consumer.processMessages(async (message, ctx) => {\n *   ctx.setAttribute('order.id', JSON.parse(message.body).orderId);\n *   await handleOrder(message.body);\n * });\n * ```\n *\n * @example With polling loop\n * ```typescript\n * // Start continuous polling\n * const controller = new AbortController();\n *\n * consumer.poll(async (message, ctx) => {\n *   await processMessage(message);\n * }, { signal: controller.signal });\n *\n * // Stop polling gracefully\n * controller.abort();\n * ```\n */\nexport class SQSConsumer<\n   \n  TClient extends { send: (command: any) => Promise<any> } = any,\n> {\n  private client: TClient;\n  private config: Required<\n    Pick<SQSConsumerConfig, 'queueUrl' | 'maxMessages' | 'visibilityTimeout' | 'waitTimeSeconds'>\n  > &\n    SQSConsumerConfig;\n  private queueName: string;\n\n  constructor(client: TClient, config: SQSConsumerConfig) {\n    this.client = wrapSDKClient(client as any, config.service) as TClient;\n    this.config = {\n      extractTraceContext: true,\n      maxMessages: 10,\n      visibilityTimeout: 30,\n      waitTimeSeconds: 20,\n      ...config,\n    };\n    this.queueName = config.queueUrl.split('/').pop() || 'unknown';\n  }\n\n  /**\n   * Extract trace context from message attributes\n   */\n   \n  private extractContext(messageAttributes: any): Record<string, string> | undefined {\n    if (!this.config.extractTraceContext || !messageAttributes) {\n      return undefined;\n    }\n\n    const carrier: Record<string, string> = {};\n\n    if (messageAttributes.traceparent?.StringValue) {\n      carrier.traceparent = messageAttributes.traceparent.StringValue;\n    }\n    if (messageAttributes.tracestate?.StringValue) {\n      carrier.tracestate = messageAttributes.tracestate.StringValue;\n    }\n    if (messageAttributes.baggage?.StringValue) {\n      carrier.baggage = messageAttributes.baggage.StringValue;\n    }\n\n    return Object.keys(carrier).length > 0 ? carrier : undefined;\n  }\n\n  /**\n   * Parse AWS SDK message into our format\n   */\n   \n  private parseMessage(message: any): ReceivedSQSMessage {\n    const attributes: Record<string, string> = {};\n    if (message.MessageAttributes) {\n      for (const [key, value] of Object.entries(message.MessageAttributes)) {\n         \n        attributes[key] = (value as any).StringValue || '';\n      }\n    }\n\n    return {\n      messageId: message.MessageId || '',\n      receiptHandle: message.ReceiptHandle || '',\n      body: message.Body || '',\n      attributes,\n      systemAttributes: message.Attributes || {},\n      raw: message,\n    };\n  }\n\n  /**\n   * Receive messages from the queue\n   *\n   * @returns Array of received messages\n   */\n  async receive(): Promise<ReceivedSQSMessage[]> {\n    return trace(`sqs.receive`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildSQSAttributes({\n          queueName: this.queueName,\n          queueUrl: this.config.queueUrl,\n          operation: 'receive',\n        }),\n      );\n\n      try {\n        const { ReceiveMessageCommand } = await import('@aws-sdk/client-sqs');\n        const result = await this.client.send(\n          new ReceiveMessageCommand({\n            QueueUrl: this.config.queueUrl,\n            MaxNumberOfMessages: this.config.maxMessages,\n            VisibilityTimeout: this.config.visibilityTimeout,\n            WaitTimeSeconds: this.config.waitTimeSeconds,\n            MessageAttributeNames: ['All'],\n            AttributeNames: ['All'],\n          }),\n        );\n\n         \n        const messages = (result.Messages || []).map((m: any) => this.parseMessage(m));\n        ctx.setAttribute('messaging.batch.message_count', messages.length);\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return messages;\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Receive failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Delete a message from the queue\n   *\n   * @param receiptHandle - Receipt handle of the message to delete\n   */\n  async delete(receiptHandle: string): Promise<void> {\n    const { DeleteMessageCommand } = await import('@aws-sdk/client-sqs');\n    await this.client.send(\n      new DeleteMessageCommand({\n        QueueUrl: this.config.queueUrl,\n        ReceiptHandle: receiptHandle,\n      }),\n    );\n  }\n\n  /**\n   * Process messages with automatic trace context extraction\n   *\n   * Receives messages, processes each with the provided handler,\n   * and deletes successfully processed messages.\n   *\n   * @param processor - Function to process each message\n   * @returns Number of messages processed\n   */\n  async processMessages(processor: MessageProcessor): Promise<number> {\n    const messages = await this.receive();\n    let processed = 0;\n\n    for (const message of messages) {\n      // Extract trace context from message attributes\n      const carrier = this.extractContext(message.raw.MessageAttributes);\n\n      // Create processing span, optionally linked to producer\n      const processMessage = async () => {\n        return trace(`sqs.process`, async (ctx: TraceContext) => {\n          ctx.setAttributes(\n            buildSQSAttributes({\n              queueName: this.queueName,\n              queueUrl: this.config.queueUrl,\n              operation: 'receive',\n            }),\n          );\n          ctx.setAttribute('messaging.message.id', message.messageId);\n\n          try {\n            await processor(message, ctx);\n            await this.delete(message.receiptHandle);\n            processed++;\n            ctx.setStatus({ code: SpanStatusCode.OK });\n          } catch (error) {\n            ctx.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: error instanceof Error ? error.message : 'Processing failed',\n            });\n            throw error;\n          }\n        });\n      };\n\n      // Run with extracted context if available\n      if (carrier) {\n        const extractedContext = propagation.extract(context.active(), carrier);\n        await context.with(extractedContext, processMessage);\n      } else {\n        await processMessage();\n      }\n    }\n\n    return processed;\n  }\n\n  /**\n   * Start continuous polling loop\n   *\n   * @param processor - Function to process each message\n   * @param options - Polling options including abort signal\n   */\n  async poll(\n    processor: MessageProcessor,\n    options?: { signal?: AbortSignal },\n  ): Promise<void> {\n    while (!options?.signal?.aborted) {\n      try {\n        await this.processMessages(processor);\n      } catch (error) {\n        // Log error but continue polling\n        console.error('[SQSConsumer] Error processing messages:', error);\n        // Small delay before retrying on error\n        await new Promise((resolve) => setTimeout(resolve, 1000));\n      }\n    }\n  }\n}\n"]}