autotel-aws 0.13.13 → 0.13.14

package/dist/chunk-CIGXV6HA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/sns/index.ts"],"names":[],"mappings":"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","file":"chunk-CIGXV6HA.js","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-DGUM43GV.js

@@ -1,10 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-export { __require };
-//# sourceMappingURL=chunk-DGUM43GV.js.map
-//# sourceMappingURL=chunk-DGUM43GV.js.map

package/dist/chunk-DGUM43GV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-DGUM43GV.js"}

package/dist/chunk-DHHLKZHI.cjs

@@ -1,23 +0,0 @@
-'use strict';
-
-var chunkQ3DMMQ7K_cjs = require('./chunk-Q3DMMQ7K.cjs');
-var autotel = require('autotel');
-
-function traceS3(config) {
-  return function wrapper(fn) {
-    return autotel.trace(
-      `s3.${config.operation}`,
-      (ctx) => async (...args) => {
-        if (config.bucket) {
-          ctx.setAttributes(chunkQ3DMMQ7K_cjs.buildS3Attributes({ bucket: config.bucket }));
-        }
-        const handler = fn(ctx);
-        return handler(...args);
-      }
-    );
-  };
-}
-
-exports.traceS3 = traceS3;
-//# sourceMappingURL=chunk-DHHLKZHI.cjs.map
-//# sourceMappingURL=chunk-DHHLKZHI.cjs.map

package/dist/chunk-DHHLKZHI.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/s3/index.ts"],"names":["trace","buildS3Attributes"],"mappings":";;;;;AA6EO,SAAS,QAAQ,MAAA,EAAuB;AAC7C,EAAA,OAAO,SAAS,QACd,EAAA,EACsC;AAEtC,IAAA,OAAOA,aAAA;AAAA,MACL,CAAA,GAAA,EAAM,OAAO,SAAS,CAAA,CAAA;AAAA,MACtB,CAAC,GAAA,KACC,OAAA,GAAU,IAAA,KAAkC;AAE1C,QAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,UAAA,GAAA,CAAI,cAAcC,mCAAA,CAAkB,EAAE,QAAQ,MAAA,CAAO,MAAA,EAAQ,CAAC,CAAA;AAAA,QAChE;AAGA,QAAA,MAAM,OAAA,GAAU,GAAG,GAAG,CAAA;AACtB,QAAA,OAAO,OAAA,CAAQ,GAAG,IAAI,CAAA;AAAA,MACxB;AAAA,KACJ;AAAA,EACF,CAAA;AACF","file":"chunk-DHHLKZHI.cjs","sourcesContent":["/**\n * S3-specific instrumentation\n *\n * Provides semantic helpers for tracing S3 operations with proper OpenTelemetry\n * semantic conventions. Automatically sets `aws.s3.*` attributes.\n *\n * @example Basic usage with factory pattern\n * ```typescript\n * import { traceS3 } from 'autotel-aws/s3';\n * import { S3Client, GetObjectCommand } from '@aws-sdk/client-s3';\n *\n * const s3 = new S3Client({});\n *\n * export const getFile = traceS3({\n *   operation: 'GetObject',\n *   bucket: 'my-bucket'\n * })(ctx => async (key: string) => {\n *   ctx.setAttribute('aws.s3.key', key);\n *   return await s3.send(new GetObjectCommand({ Bucket: 'my-bucket', Key: key }));\n * });\n *\n * // Usage: await getFile('path/to/file.txt');\n * ```\n *\n * @example Dynamic bucket\n * ```typescript\n * export const getObject = traceS3({\n *   operation: 'GetObject',\n * })(ctx => async (bucket: string, key: string) => {\n *   ctx.setAttribute('aws.s3.bucket', bucket);\n *   ctx.setAttribute('aws.s3.key', key);\n *   return await s3.send(new GetObjectCommand({ Bucket: bucket, Key: key }));\n * });\n *\n * // Usage: await getObject('my-bucket', 'file.txt');\n * ```\n */\n\nimport { trace, type TraceContext } from 'autotel';\nimport { buildS3Attributes } from '../attributes';\n\n/**\n * S3 operation configuration\n */\nexport interface TraceS3Config {\n  /**\n   * S3 operation name (e.g., 'GetObject', 'PutObject', 'DeleteObject')\n   * Used to generate the span name: `s3.{operation}`\n   */\n  operation: string;\n\n  /**\n   * Default bucket name for static configurations.\n   * Can be overridden by setting `aws.s3.bucket` attribute in the handler.\n   */\n  bucket?: string;\n}\n\n/**\n * Trace S3 operations with semantic attributes\n *\n * Creates a traced function that automatically sets S3 semantic attributes\n * following OpenTelemetry conventions.\n *\n * @param config - S3 operation configuration\n * @returns A higher-order function that wraps your S3 operation with tracing\n *\n * @remarks\n * Semantic attributes set automatically:\n * - `aws.s3.bucket` - S3 bucket name (if provided in config)\n *\n * Additional attributes you should set in your handler:\n * - `aws.s3.key` - Object key\n * - `aws.s3.copy_source` - Source for copy operations\n *\n * @see https://opentelemetry.io/docs/specs/semconv/object-stores/s3/\n */\nexport function traceS3(config: TraceS3Config) {\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      `s3.${config.operation}`,\n      (ctx: TraceContext) =>\n        async (...args: TArgs): Promise<TReturn> => {\n          // Set S3 semantic attributes\n          if (config.bucket) {\n            ctx.setAttributes(buildS3Attributes({ bucket: config.bucket }));\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"]}

package/dist/chunk-HMTKKKKP.cjs

@@ -1,390 +0,0 @@
-'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 traceKinesis(config) {
-  return function wrapper(fn) {
-    return autotel.trace(
-      `kinesis.${config.operation}`,
-      (ctx) => async (...args) => {
-        ctx.setAttributes(
-          chunkQ3DMMQ7K_cjs.buildKinesisAttributes({
-            streamName: config.streamName,
-            shardId: config.shardId,
-            operation: config.operation
-          })
-        );
-        const handler = fn(ctx);
-        return handler(...args);
-      }
-    );
-  };
-}
-var KinesisProducer = class {
-  client;
-  config;
-  constructor(client, config) {
-    this.client = chunkUZEJV2YD_cjs.wrapSDKClient(client, config.service);
-    this.config = {
-      injectTraceContext: true,
-      ...config
-    };
-  }
-  /**
-   * Inject trace context into record data
-   */
-  injectContext(data) {
-    let payload;
-    if (typeof data === "string") {
-      try {
-        payload = JSON.parse(data);
-      } catch {
-        payload = { _data: data };
-      }
-    } else {
-      payload = data;
-    }
-    if (this.config.injectTraceContext) {
-      const carrier = {};
-      api.propagation.inject(api.context.active(), carrier);
-      if (carrier.traceparent) {
-        payload = {
-          ...payload,
-          _traceContext: {
-            traceparent: carrier.traceparent,
-            tracestate: carrier.tracestate,
-            baggage: carrier.baggage
-          }
-        };
-      }
-    }
-    return Buffer.from(JSON.stringify(payload));
-  }
-  /**
-   * Put a single record to the stream
-   *
-   * @param record - Record to put
-   * @returns Promise with shard ID and sequence number
-   */
-  async putRecord(record) {
-    return autotel.trace(`kinesis.put`, async (ctx) => {
-      ctx.setAttributes(
-        chunkQ3DMMQ7K_cjs.buildKinesisAttributes({
-          streamName: this.config.streamName,
-          operation: "put"
-        })
-      );
-      const input = {
-        StreamName: this.config.streamName,
-        Data: this.injectContext(record.data),
-        PartitionKey: record.partitionKey,
-        ...record.explicitHashKey && { ExplicitHashKey: record.explicitHashKey },
-        ...record.sequenceNumberForOrdering && {
-          SequenceNumberForOrdering: record.sequenceNumberForOrdering
-        }
-      };
-      try {
-        const { PutRecordCommand } = await import('@aws-sdk/client-kinesis');
-        const result = await this.client.send(new PutRecordCommand(input));
-        if (result.ShardId) {
-          ctx.setAttribute("aws.kinesis.shard_id", result.ShardId);
-        }
-        if (result.SequenceNumber) {
-          ctx.setAttribute("aws.kinesis.sequence_number", result.SequenceNumber);
-        }
-        ctx.setStatus({ code: api.SpanStatusCode.OK });
-        return {
-          shardId: result.ShardId,
-          sequenceNumber: result.SequenceNumber,
-          encryptionType: result.EncryptionType
-        };
-      } catch (error) {
-        ctx.setStatus({
-          code: api.SpanStatusCode.ERROR,
-          message: error instanceof Error ? error.message : "Put failed"
-        });
-        throw error;
-      }
-    });
-  }
-  /**
-   * Put multiple records in a batch
-   *
-   * @param records - Array of records to put (max 500)
-   * @returns Promise with successful and failed record results
-   */
-  async putRecords(records) {
-    return autotel.trace(`kinesis.putBatch`, async (ctx) => {
-      ctx.setAttributes(
-        chunkQ3DMMQ7K_cjs.buildKinesisAttributes({
-          streamName: this.config.streamName,
-          operation: "put"
-        })
-      );
-      ctx.setAttribute("messaging.batch.message_count", records.length);
-      const entries = records.map((record) => ({
-        Data: this.injectContext(record.data),
-        PartitionKey: record.partitionKey,
-        ...record.explicitHashKey && { ExplicitHashKey: record.explicitHashKey }
-      }));
-      try {
-        const { PutRecordsCommand } = await import('@aws-sdk/client-kinesis');
-        const result = await this.client.send(
-          new PutRecordsCommand({
-            StreamName: this.config.streamName,
-            Records: entries
-          })
-        );
-        const successful = [];
-        const failed = [];
-        if (result.Records) {
-          for (const r of result.Records) {
-            const record = r;
-            if (record.ErrorCode) {
-              failed.push({ errorCode: record.ErrorCode, errorMessage: record.ErrorMessage });
-            } else {
-              successful.push({ shardId: record.ShardId, sequenceNumber: record.SequenceNumber });
-            }
-          }
-        }
-        ctx.setAttribute("messaging.kinesis.successful_count", successful.length);
-        ctx.setAttribute("messaging.kinesis.failed_count", result.FailedRecordCount || 0);
-        if (result.FailedRecordCount && result.FailedRecordCount > 0) {
-          ctx.setStatus({
-            code: api.SpanStatusCode.ERROR,
-            message: `${result.FailedRecordCount} records failed`
-          });
-        } else {
-          ctx.setStatus({ code: api.SpanStatusCode.OK });
-        }
-        return {
-          successful,
-          failed,
-          failedRecordCount: result.FailedRecordCount || 0
-        };
-      } catch (error) {
-        ctx.setStatus({
-          code: api.SpanStatusCode.ERROR,
-          message: error instanceof Error ? error.message : "Batch put failed"
-        });
-        throw error;
-      }
-    });
-  }
-};
-var KinesisConsumer = class {
-  client;
-  config;
-  constructor(client, config) {
-    this.client = chunkUZEJV2YD_cjs.wrapSDKClient(client, config.service);
-    this.config = {
-      extractTraceContext: true,
-      ...config
-    };
-  }
-  /**
-   * Extract trace context from record data
-   */
-  extractContext(data) {
-    if (!this.config.extractTraceContext || !data?._traceContext) {
-      return void 0;
-    }
-    const tc = data._traceContext;
-    const carrier = {};
-    if (tc.traceparent) carrier.traceparent = tc.traceparent;
-    if (tc.tracestate) carrier.tracestate = tc.tracestate;
-    if (tc.baggage) carrier.baggage = tc.baggage;
-    return Object.keys(carrier).length > 0 ? carrier : void 0;
-  }
-  /**
-   * Parse raw record data
-   */
-  parseRecord(record) {
-    const rawData = record.Data ? Buffer.from(record.Data).toString("utf8") : "";
-    let data;
-    try {
-      data = JSON.parse(rawData);
-    } catch {
-      data = rawData;
-    }
-    return {
-      sequenceNumber: record.SequenceNumber || "",
-      approximateArrivalTimestamp: record.ApproximateArrivalTimestamp,
-      data,
-      rawData,
-      partitionKey: record.PartitionKey || "",
-      encryptionType: record.EncryptionType,
-      raw: record
-    };
-  }
-  /**
-   * Get a shard iterator
-   *
-   * @param shardId - Shard ID
-   * @param type - Iterator type
-   * @param startingSequenceNumber - Starting sequence number (for AT_SEQUENCE_NUMBER, AFTER_SEQUENCE_NUMBER)
-   * @param timestamp - Starting timestamp (for AT_TIMESTAMP)
-   * @returns Shard iterator string
-   */
-  async getShardIterator(shardId, type, startingSequenceNumber, timestamp) {
-    return autotel.trace(`kinesis.getShardIterator`, async (ctx) => {
-      ctx.setAttributes(
-        chunkQ3DMMQ7K_cjs.buildKinesisAttributes({
-          streamName: this.config.streamName,
-          shardId,
-          operation: "get"
-        })
-      );
-      try {
-        const { GetShardIteratorCommand } = await import('@aws-sdk/client-kinesis');
-        const result = await this.client.send(
-          new GetShardIteratorCommand({
-            StreamName: this.config.streamName,
-            ShardId: shardId,
-            ShardIteratorType: type,
-            ...startingSequenceNumber && { StartingSequenceNumber: startingSequenceNumber },
-            ...timestamp && { Timestamp: timestamp }
-          })
-        );
-        ctx.setStatus({ code: api.SpanStatusCode.OK });
-        return result.ShardIterator || "";
-      } catch (error) {
-        ctx.setStatus({
-          code: api.SpanStatusCode.ERROR,
-          message: error instanceof Error ? error.message : "GetShardIterator failed"
-        });
-        throw error;
-      }
-    });
-  }
-  /**
-   * Get records from a shard iterator
-   *
-   * @param shardIterator - Shard iterator
-   * @param limit - Maximum records to return (max 10000)
-   * @returns Records and next shard iterator
-   */
-  async getRecords(shardIterator, limit) {
-    return autotel.trace(`kinesis.get`, async (ctx) => {
-      ctx.setAttributes(
-        chunkQ3DMMQ7K_cjs.buildKinesisAttributes({
-          streamName: this.config.streamName,
-          operation: "get"
-        })
-      );
-      try {
-        const { GetRecordsCommand } = await import('@aws-sdk/client-kinesis');
-        const result = await this.client.send(
-          new GetRecordsCommand({
-            ShardIterator: shardIterator,
-            ...limit && { Limit: limit }
-          })
-        );
-        const records = (result.Records || []).map((r) => this.parseRecord(r));
-        ctx.setAttribute("messaging.batch.message_count", records.length);
-        if (result.MillisBehindLatest !== void 0) {
-          ctx.setAttribute("aws.kinesis.millis_behind_latest", result.MillisBehindLatest);
-        }
-        ctx.setStatus({ code: api.SpanStatusCode.OK });
-        return {
-          records,
-          nextIterator: result.NextShardIterator,
-          millisBehindLatest: result.MillisBehindLatest
-        };
-      } catch (error) {
-        ctx.setStatus({
-          code: api.SpanStatusCode.ERROR,
-          message: error instanceof Error ? error.message : "GetRecords failed"
-        });
-        throw error;
-      }
-    });
-  }
-  /**
-   * Process records with automatic trace context extraction
-   *
-   * @param shardIterator - Shard iterator
-   * @param processor - Function to process each record
-   * @param limit - Maximum records to process
-   * @returns Next shard iterator and count of processed records
-   */
-  async processRecords(shardIterator, processor, limit) {
-    const { records, nextIterator } = await this.getRecords(shardIterator, limit);
-    let processedCount = 0;
-    for (const record of records) {
-      const carrier = this.extractContext(record.data);
-      const processRecord = async () => {
-        return autotel.trace(`kinesis.process`, async (ctx) => {
-          ctx.setAttributes(
-            chunkQ3DMMQ7K_cjs.buildKinesisAttributes({
-              streamName: this.config.streamName,
-              operation: "get"
-            })
-          );
-          ctx.setAttribute("aws.kinesis.sequence_number", record.sequenceNumber);
-          ctx.setAttribute("aws.kinesis.partition_key", record.partitionKey);
-          try {
-            await processor(record, ctx);
-            processedCount++;
-            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, processRecord);
-      } else {
-        await processRecord();
-      }
-    }
-    return { nextIterator, processedCount };
-  }
-  /**
-   * List shards for the stream
-   *
-   * @returns Array of shard IDs
-   */
-  async listShards() {
-    return autotel.trace(`kinesis.listShards`, async (ctx) => {
-      ctx.setAttributes(
-        chunkQ3DMMQ7K_cjs.buildKinesisAttributes({
-          streamName: this.config.streamName,
-          operation: "get"
-        })
-      );
-      try {
-        const { ListShardsCommand } = await import('@aws-sdk/client-kinesis');
-        const result = await this.client.send(
-          new ListShardsCommand({
-            StreamName: this.config.streamName
-          })
-        );
-        const shardIds = result.Shards?.map((s) => s.ShardId || "") || [];
-        ctx.setAttribute("aws.kinesis.shard_count", shardIds.length);
-        ctx.setStatus({ code: api.SpanStatusCode.OK });
-        return shardIds;
-      } catch (error) {
-        ctx.setStatus({
-          code: api.SpanStatusCode.ERROR,
-          message: error instanceof Error ? error.message : "ListShards failed"
-        });
-        throw error;
-      }
-    });
-  }
-};
-
-exports.KinesisConsumer = KinesisConsumer;
-exports.KinesisProducer = KinesisProducer;
-exports.traceKinesis = traceKinesis;
-//# sourceMappingURL=chunk-HMTKKKKP.cjs.map
-//# sourceMappingURL=chunk-HMTKKKKP.cjs.map

package/dist/chunk-HMTKKKKP.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/kinesis/index.ts"],"names":["trace","buildKinesisAttributes","wrapSDKClient","propagation","context","SpanStatusCode"],"mappings":"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","file":"chunk-HMTKKKKP.cjs","sourcesContent":["/**\n * Kinesis-specific instrumentation\n *\n * Provides semantic helpers for tracing Kinesis Data Streams operations with proper\n * OpenTelemetry messaging semantic conventions.\n *\n * @example Put record to stream\n * ```typescript\n * import { traceKinesis } from 'autotel-aws/kinesis';\n * import { KinesisClient, PutRecordCommand } from '@aws-sdk/client-kinesis';\n *\n * const kinesis = new KinesisClient({});\n *\n * export const putRecord = traceKinesis({\n *   operation: 'put',\n *   streamName: 'my-stream'\n * })(ctx => async (data: object, partitionKey: string) => {\n *   const result = await kinesis.send(new PutRecordCommand({\n *     StreamName: 'my-stream',\n *     Data: Buffer.from(JSON.stringify(data)),\n *     PartitionKey: partitionKey\n *   }));\n *\n *   ctx.setAttribute('aws.kinesis.shard_id', result.ShardId ?? '');\n *   ctx.setAttribute('aws.kinesis.sequence_number', result.SequenceNumber ?? '');\n *\n *   return result;\n * });\n *\n * // Usage: await putRecord({ event: 'click' }, 'user-123');\n * ```\n *\n * @example Get records from shard\n * ```typescript\n * export const getRecords = traceKinesis({\n *   operation: 'get',\n *   streamName: 'my-stream'\n * })(ctx => async (shardIterator: string, limit: number) => {\n *   const result = await kinesis.send(new GetRecordsCommand({\n *     ShardIterator: shardIterator,\n *     Limit: limit\n *   }));\n *\n *   ctx.setAttribute('messaging.batch.message_count', result.Records?.length ?? 0);\n *   return result;\n * });\n * ```\n */\n\nimport { trace, type TraceContext } from 'autotel';\nimport { context, propagation, SpanStatusCode } from '@opentelemetry/api';\nimport { buildKinesisAttributes } from '../attributes';\nimport { wrapSDKClient } from '../common/sdk-wrapper';\n\n/**\n * Kinesis operation configuration\n */\nexport interface TraceKinesisConfig {\n  /**\n   * Kinesis operation type\n   * - 'put' - PutRecord, PutRecords\n   * - 'get' - GetRecords, GetShardIterator\n   */\n  operation: 'put' | 'get';\n\n  /**\n   * Kinesis stream name\n   * Sets `messaging.destination.name` attribute.\n   */\n  streamName: string;\n\n  /**\n   * Shard ID (if known at configuration time)\n   * Sets `aws.kinesis.shard_id` attribute.\n   */\n  shardId?: string;\n}\n\n/**\n * Trace Kinesis operations with semantic attributes\n *\n * Creates a traced function that automatically sets Kinesis messaging semantic attributes\n * following OpenTelemetry conventions.\n *\n * @param config - Kinesis operation configuration\n * @returns A higher-order function that wraps your Kinesis operation with tracing\n *\n * @remarks\n * Semantic attributes set automatically:\n * - `messaging.system` - 'aws_kinesis'\n * - `messaging.destination.name` - Stream name\n * - `messaging.operation` - 'put' or 'get'\n * - `aws.kinesis.shard_id` - Shard ID (if provided)\n *\n * Additional attributes you should set in your handler:\n * - `aws.kinesis.sequence_number` - Record sequence number\n * - `messaging.batch.message_count` - Number of records in batch\n *\n * @see https://opentelemetry.io/docs/specs/semconv/messaging/aws-kinesis/\n */\nexport function traceKinesis(config: TraceKinesisConfig) {\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      `kinesis.${config.operation}`,\n      (ctx: TraceContext) =>\n        async (...args: TArgs): Promise<TReturn> => {\n          // Set Kinesis semantic attributes\n          ctx.setAttributes(\n            buildKinesisAttributes({\n              streamName: config.streamName,\n              shardId: config.shardId,\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// Kinesis Producer - Puts records with automatic trace context injection\n// ============================================================================\n\n/**\n * Configuration for Kinesis Producer\n */\nexport interface KinesisProducerConfig {\n  /**\n   * Kinesis stream name or ARN\n   */\n  streamName: string;\n\n  /**\n   * Inject W3C Trace Context into record data\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 * Record to put via Kinesis Producer\n */\nexport interface KinesisRecord {\n  /**\n   * Record data (will be serialized to JSON if object)\n   */\n  data: string | object;\n\n  /**\n   * Partition key for sharding\n   */\n  partitionKey: string;\n\n  /**\n   * Optional explicit hash key\n   */\n  explicitHashKey?: string;\n\n  /**\n   * Optional sequence number for ordering\n   */\n  sequenceNumberForOrdering?: string;\n}\n\n/**\n * Kinesis Producer with automatic trace context injection\n *\n * Wraps a Kinesis client to automatically:\n * - Create spans for put operations\n * - Inject W3C Trace Context into record data\n * - Set proper semantic attributes\n *\n * @example Basic usage\n * ```typescript\n * import { KinesisProducer } from 'autotel-aws/kinesis';\n * import { KinesisClient } from '@aws-sdk/client-kinesis';\n *\n * const kinesis = new KinesisClient({ region: 'us-east-1' });\n * const producer = new KinesisProducer(kinesis, {\n *   streamName: 'my-stream'\n * });\n *\n * // Put with automatic trace context\n * const result = await producer.putRecord({\n *   data: { event: 'click', userId: '123' },\n *   partitionKey: 'user-123'\n * });\n * console.log('Sequence:', result.sequenceNumber);\n * ```\n *\n * @example Batch put\n * ```typescript\n * const results = await producer.putRecords([\n *   { data: { event: 'click' }, partitionKey: 'user-1' },\n *   { data: { event: 'view' }, partitionKey: 'user-2' },\n *   { data: { event: 'scroll' }, partitionKey: 'user-3' }\n * ]);\n * console.log(`Put ${results.successful.length} records`);\n * ```\n */\nexport class KinesisProducer<\n   \n  TClient extends { send: (command: any) => Promise<any> } = any,\n> {\n  private client: TClient;\n  private config: Required<Pick<KinesisProducerConfig, 'streamName'>> & KinesisProducerConfig;\n\n  constructor(client: TClient, config: KinesisProducerConfig) {\n    this.client = wrapSDKClient(client as any, config.service) as TClient;\n    this.config = {\n      injectTraceContext: true,\n      ...config,\n    };\n  }\n\n  /**\n   * Inject trace context into record data\n   */\n  private injectContext(data: string | object): Buffer {\n    let payload: object;\n\n    if (typeof data === 'string') {\n      try {\n        payload = JSON.parse(data);\n      } catch {\n        // If not valid JSON, wrap in object\n        payload = { _data: data };\n      }\n    } else {\n      payload = data;\n    }\n\n    if (this.config.injectTraceContext) {\n      const carrier: Record<string, string> = {};\n      propagation.inject(context.active(), carrier);\n\n      if (carrier.traceparent) {\n        payload = {\n          ...payload,\n          _traceContext: {\n            traceparent: carrier.traceparent,\n            tracestate: carrier.tracestate,\n            baggage: carrier.baggage,\n          },\n        };\n      }\n    }\n\n    return Buffer.from(JSON.stringify(payload));\n  }\n\n  /**\n   * Put a single record to the stream\n   *\n   * @param record - Record to put\n   * @returns Promise with shard ID and sequence number\n   */\n  async putRecord(record: KinesisRecord): Promise<{\n    shardId?: string;\n    sequenceNumber?: string;\n    encryptionType?: string;\n  }> {\n    return trace(`kinesis.put`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildKinesisAttributes({\n          streamName: this.config.streamName,\n          operation: 'put',\n        }),\n      );\n\n      const input = {\n        StreamName: this.config.streamName,\n        Data: this.injectContext(record.data),\n        PartitionKey: record.partitionKey,\n        ...(record.explicitHashKey && { ExplicitHashKey: record.explicitHashKey }),\n        ...(record.sequenceNumberForOrdering && {\n          SequenceNumberForOrdering: record.sequenceNumberForOrdering,\n        }),\n      };\n\n      try {\n        const { PutRecordCommand } = await import('@aws-sdk/client-kinesis');\n        const result = await this.client.send(new PutRecordCommand(input));\n\n        if (result.ShardId) {\n          ctx.setAttribute('aws.kinesis.shard_id', result.ShardId);\n        }\n        if (result.SequenceNumber) {\n          ctx.setAttribute('aws.kinesis.sequence_number', result.SequenceNumber);\n        }\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return {\n          shardId: result.ShardId,\n          sequenceNumber: result.SequenceNumber,\n          encryptionType: result.EncryptionType,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Put failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Put multiple records in a batch\n   *\n   * @param records - Array of records to put (max 500)\n   * @returns Promise with successful and failed record results\n   */\n  async putRecords(records: KinesisRecord[]): Promise<{\n    successful: Array<{ shardId?: string; sequenceNumber?: string }>;\n    failed: Array<{ errorCode?: string; errorMessage?: string }>;\n    failedRecordCount: number;\n  }> {\n    return trace(`kinesis.putBatch`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildKinesisAttributes({\n          streamName: this.config.streamName,\n          operation: 'put',\n        }),\n      );\n      ctx.setAttribute('messaging.batch.message_count', records.length);\n\n      const entries = records.map((record) => ({\n        Data: this.injectContext(record.data),\n        PartitionKey: record.partitionKey,\n        ...(record.explicitHashKey && { ExplicitHashKey: record.explicitHashKey }),\n      }));\n\n      try {\n        const { PutRecordsCommand } = await import('@aws-sdk/client-kinesis');\n        const result = await this.client.send(\n          new PutRecordsCommand({\n            StreamName: this.config.streamName,\n            Records: entries,\n          }),\n        );\n\n        const successful: Array<{ shardId?: string; sequenceNumber?: string }> = [];\n        const failed: Array<{ errorCode?: string; errorMessage?: string }> = [];\n\n        if (result.Records) {\n          for (const r of result.Records) {\n            const record = r as { ShardId?: string; SequenceNumber?: string; ErrorCode?: string; ErrorMessage?: string };\n            if (record.ErrorCode) {\n              failed.push({ errorCode: record.ErrorCode, errorMessage: record.ErrorMessage });\n            } else {\n              successful.push({ shardId: record.ShardId, sequenceNumber: record.SequenceNumber });\n            }\n          }\n        }\n\n        ctx.setAttribute('messaging.kinesis.successful_count', successful.length);\n        ctx.setAttribute('messaging.kinesis.failed_count', result.FailedRecordCount || 0);\n\n        if (result.FailedRecordCount && result.FailedRecordCount > 0) {\n          ctx.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: `${result.FailedRecordCount} records failed`,\n          });\n        } else {\n          ctx.setStatus({ code: SpanStatusCode.OK });\n        }\n\n        return {\n          successful,\n          failed,\n          failedRecordCount: result.FailedRecordCount || 0,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Batch put failed',\n        });\n        throw error;\n      }\n    });\n  }\n}\n\n// ============================================================================\n// Kinesis Consumer - Gets records with trace context extraction\n// ============================================================================\n\n/**\n * Configuration for Kinesis Consumer\n */\nexport interface KinesisConsumerConfig {\n  /**\n   * Kinesis stream name or ARN\n   */\n  streamName: string;\n\n  /**\n   * Extract W3C Trace Context from record data\n   * Creates child spans linked to the producer\n   * @default true\n   */\n  extractTraceContext?: boolean;\n\n  /**\n   * Optional service name for tracing\n   */\n  service?: string;\n}\n\n/**\n * Received Kinesis record with parsed data\n */\nexport interface ReceivedKinesisRecord {\n  /**\n   * Sequence number\n   */\n  sequenceNumber: string;\n\n  /**\n   * Approximate arrival timestamp\n   */\n  approximateArrivalTimestamp?: Date;\n\n  /**\n   * Parsed data (JSON parsed if possible)\n   */\n   \n  data: any;\n\n  /**\n   * Raw data as string\n   */\n  rawData: string;\n\n  /**\n   * Partition key\n   */\n  partitionKey: string;\n\n  /**\n   * Encryption type\n   */\n  encryptionType?: string;\n\n  /**\n   * Original AWS SDK record object\n   */\n   \n  raw: any;\n}\n\n/**\n * Record processor function type\n */\nexport type KinesisRecordProcessor = (\n  record: ReceivedKinesisRecord,\n  ctx: TraceContext,\n) => Promise<void>;\n\n/**\n * Kinesis Consumer with automatic trace context extraction\n *\n * Wraps a Kinesis client to automatically:\n * - Create spans for get operations\n * - Extract W3C Trace Context from record data\n * - Link consumer spans to producer spans\n *\n * @example Basic usage\n * ```typescript\n * import { KinesisConsumer } from 'autotel-aws/kinesis';\n * import { KinesisClient } from '@aws-sdk/client-kinesis';\n *\n * const kinesis = new KinesisClient({ region: 'us-east-1' });\n * const consumer = new KinesisConsumer(kinesis, {\n *   streamName: 'my-stream'\n * });\n *\n * // Get shard iterator first\n * const iterator = await consumer.getShardIterator('shardId-000000000000', 'LATEST');\n *\n * // Process records with automatic tracing\n * const { nextIterator, records } = await consumer.getRecords(iterator, 100);\n *\n * for (const record of records) {\n *   console.log('Record:', record.data);\n * }\n * ```\n *\n * @example With processor function\n * ```typescript\n * await consumer.processRecords(iterator, async (record, ctx) => {\n *   ctx.setAttribute('event.type', record.data.event);\n *   await handleEvent(record.data);\n * });\n * ```\n */\nexport class KinesisConsumer<\n   \n  TClient extends { send: (command: any) => Promise<any> } = any,\n> {\n  private client: TClient;\n  private config: Required<Pick<KinesisConsumerConfig, 'streamName'>> & KinesisConsumerConfig;\n\n  constructor(client: TClient, config: KinesisConsumerConfig) {\n    this.client = wrapSDKClient(client as any, config.service) as TClient;\n    this.config = {\n      extractTraceContext: true,\n      ...config,\n    };\n  }\n\n  /**\n   * Extract trace context from record data\n   */\n   \n  private extractContext(data: any): Record<string, string> | undefined {\n    if (!this.config.extractTraceContext || !data?._traceContext) {\n      return undefined;\n    }\n\n    const tc = data._traceContext;\n    const carrier: Record<string, string> = {};\n\n    if (tc.traceparent) carrier.traceparent = tc.traceparent;\n    if (tc.tracestate) carrier.tracestate = tc.tracestate;\n    if (tc.baggage) carrier.baggage = tc.baggage;\n\n    return Object.keys(carrier).length > 0 ? carrier : undefined;\n  }\n\n  /**\n   * Parse raw record data\n   */\n   \n  private parseRecord(record: any): ReceivedKinesisRecord {\n    const rawData = record.Data ? Buffer.from(record.Data).toString('utf8') : '';\n     \n    let data: any;\n\n    try {\n      data = JSON.parse(rawData);\n    } catch {\n      data = rawData;\n    }\n\n    return {\n      sequenceNumber: record.SequenceNumber || '',\n      approximateArrivalTimestamp: record.ApproximateArrivalTimestamp,\n      data,\n      rawData,\n      partitionKey: record.PartitionKey || '',\n      encryptionType: record.EncryptionType,\n      raw: record,\n    };\n  }\n\n  /**\n   * Get a shard iterator\n   *\n   * @param shardId - Shard ID\n   * @param type - Iterator type\n   * @param startingSequenceNumber - Starting sequence number (for AT_SEQUENCE_NUMBER, AFTER_SEQUENCE_NUMBER)\n   * @param timestamp - Starting timestamp (for AT_TIMESTAMP)\n   * @returns Shard iterator string\n   */\n  async getShardIterator(\n    shardId: string,\n    type: 'AT_SEQUENCE_NUMBER' | 'AFTER_SEQUENCE_NUMBER' | 'TRIM_HORIZON' | 'LATEST' | 'AT_TIMESTAMP',\n    startingSequenceNumber?: string,\n    timestamp?: Date,\n  ): Promise<string> {\n    return trace(`kinesis.getShardIterator`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildKinesisAttributes({\n          streamName: this.config.streamName,\n          shardId,\n          operation: 'get',\n        }),\n      );\n\n      try {\n        const { GetShardIteratorCommand } = await import('@aws-sdk/client-kinesis');\n        const result = await this.client.send(\n          new GetShardIteratorCommand({\n            StreamName: this.config.streamName,\n            ShardId: shardId,\n            ShardIteratorType: type,\n            ...(startingSequenceNumber && { StartingSequenceNumber: startingSequenceNumber }),\n            ...(timestamp && { Timestamp: timestamp }),\n          }),\n        );\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n        return result.ShardIterator || '';\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'GetShardIterator failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Get records from a shard iterator\n   *\n   * @param shardIterator - Shard iterator\n   * @param limit - Maximum records to return (max 10000)\n   * @returns Records and next shard iterator\n   */\n  async getRecords(\n    shardIterator: string,\n    limit?: number,\n  ): Promise<{\n    records: ReceivedKinesisRecord[];\n    nextIterator?: string;\n    millisBehindLatest?: number;\n  }> {\n    return trace(`kinesis.get`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildKinesisAttributes({\n          streamName: this.config.streamName,\n          operation: 'get',\n        }),\n      );\n\n      try {\n        const { GetRecordsCommand } = await import('@aws-sdk/client-kinesis');\n        const result = await this.client.send(\n          new GetRecordsCommand({\n            ShardIterator: shardIterator,\n            ...(limit && { Limit: limit }),\n          }),\n        );\n\n         \n        const records = (result.Records || []).map((r: any) => this.parseRecord(r));\n        ctx.setAttribute('messaging.batch.message_count', records.length);\n\n        if (result.MillisBehindLatest !== undefined) {\n          ctx.setAttribute('aws.kinesis.millis_behind_latest', result.MillisBehindLatest);\n        }\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return {\n          records,\n          nextIterator: result.NextShardIterator,\n          millisBehindLatest: result.MillisBehindLatest,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'GetRecords failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Process records with automatic trace context extraction\n   *\n   * @param shardIterator - Shard iterator\n   * @param processor - Function to process each record\n   * @param limit - Maximum records to process\n   * @returns Next shard iterator and count of processed records\n   */\n  async processRecords(\n    shardIterator: string,\n    processor: KinesisRecordProcessor,\n    limit?: number,\n  ): Promise<{ nextIterator?: string; processedCount: number }> {\n    const { records, nextIterator } = await this.getRecords(shardIterator, limit);\n    let processedCount = 0;\n\n    for (const record of records) {\n      // Extract trace context from record data\n      const carrier = this.extractContext(record.data);\n\n      // Create processing span, optionally linked to producer\n      const processRecord = async () => {\n        return trace(`kinesis.process`, async (ctx: TraceContext) => {\n          ctx.setAttributes(\n            buildKinesisAttributes({\n              streamName: this.config.streamName,\n              operation: 'get',\n            }),\n          );\n          ctx.setAttribute('aws.kinesis.sequence_number', record.sequenceNumber);\n          ctx.setAttribute('aws.kinesis.partition_key', record.partitionKey);\n\n          try {\n            await processor(record, ctx);\n            processedCount++;\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, processRecord);\n      } else {\n        await processRecord();\n      }\n    }\n\n    return { nextIterator, processedCount };\n  }\n\n  /**\n   * List shards for the stream\n   *\n   * @returns Array of shard IDs\n   */\n  async listShards(): Promise<string[]> {\n    return trace(`kinesis.listShards`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildKinesisAttributes({\n          streamName: this.config.streamName,\n          operation: 'get',\n        }),\n      );\n\n      try {\n        const { ListShardsCommand } = await import('@aws-sdk/client-kinesis');\n        const result = await this.client.send(\n          new ListShardsCommand({\n            StreamName: this.config.streamName,\n          }),\n        );\n\n        const shardIds = result.Shards?.map((s: { ShardId?: string }) => s.ShardId || '') || [];\n        ctx.setAttribute('aws.kinesis.shard_count', shardIds.length);\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return shardIds;\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'ListShards failed',\n        });\n        throw error;\n      }\n    });\n  }\n}\n"]}