autotel-aws 0.2.0

package/dist/config-C7zV8Zm6.d.cts

@@ -0,0 +1,125 @@
+import { A as AWSServiceConfig } from './types-3_ak5jhy.cjs';
+
+/**
+ * AWS configuration types and utilities
+ */
+
+/**
+ * AWS resource detector configuration
+ */
+interface AWSResourceDetectorConfig {
+    /**
+     * Auto-detect EC2 instance metadata
+     * @default true
+     */
+    ec2?: boolean;
+    /**
+     * Auto-detect ECS task metadata
+     * @default true
+     */
+    ecs?: boolean;
+    /**
+     * Auto-detect EKS cluster metadata
+     * @default true
+     */
+    eks?: boolean;
+    /**
+     * Auto-detect Lambda function metadata
+     * @default true
+     */
+    lambda?: boolean;
+}
+/**
+ * AWS initialization configuration
+ */
+interface AWSInitConfig {
+    /**
+     * Service name
+     */
+    service: string;
+    /**
+     * OTLP endpoint
+     */
+    endpoint?: string;
+    /**
+     * OTLP headers (e.g., authentication tokens)
+     */
+    headers?: Record<string, string>;
+    /**
+     * Auto-detect AWS resources
+     * @default false
+     */
+    autoDetectResources?: boolean | AWSResourceDetectorConfig;
+    /**
+     * AWS region
+     */
+    region?: string;
+    /**
+     * Additional resource attributes
+     */
+    resourceAttributes?: Record<string, string>;
+}
+/**
+ * Lambda instrumentation configuration
+ */
+interface LambdaInstrumentationConfig {
+    /**
+     * Capture response in span attributes
+     * @default false
+     */
+    captureResponse?: boolean;
+    /**
+     * Extract trace context from event
+     * @default true
+     */
+    extractTraceContext?: boolean;
+    /**
+     * Service name override
+     */
+    service?: string;
+}
+/**
+ * SDK instrumentation configuration
+ */
+interface SDKInstrumentationConfig {
+    /**
+     * Capture request payload
+     * @default false
+     */
+    captureRequest?: boolean;
+    /**
+     * Capture response payload
+     * @default false
+     */
+    captureResponse?: boolean;
+    /**
+     * Service name override
+     */
+    service?: string;
+}
+/**
+ * X-Ray configuration
+ */
+interface XRayConfig {
+    /**
+     * Enable X-Ray propagator
+     * @default false
+     */
+    propagator?: boolean;
+    /**
+     * Enable X-Ray remote sampling
+     * @default false
+     */
+    remoteSampling?: boolean;
+    /**
+     * Use X-Ray trace ID format
+     * @default false
+     */
+    idGenerator?: boolean;
+}
+/**
+ * Merge AWS service config with defaults
+ */
+declare function mergeServiceConfig(config?: AWSServiceConfig, defaults?: AWSServiceConfig): AWSServiceConfig;
+
+export { type AWSInitConfig as A, type LambdaInstrumentationConfig as L, type SDKInstrumentationConfig as S, type XRayConfig as X, type AWSResourceDetectorConfig as a, mergeServiceConfig as m };

package/dist/config-DxjTT8jd.d.ts

@@ -0,0 +1,125 @@
+import { A as AWSServiceConfig } from './types-3_ak5jhy.js';
+
+/**
+ * AWS configuration types and utilities
+ */
+
+/**
+ * AWS resource detector configuration
+ */
+interface AWSResourceDetectorConfig {
+    /**
+     * Auto-detect EC2 instance metadata
+     * @default true
+     */
+    ec2?: boolean;
+    /**
+     * Auto-detect ECS task metadata
+     * @default true
+     */
+    ecs?: boolean;
+    /**
+     * Auto-detect EKS cluster metadata
+     * @default true
+     */
+    eks?: boolean;
+    /**
+     * Auto-detect Lambda function metadata
+     * @default true
+     */
+    lambda?: boolean;
+}
+/**
+ * AWS initialization configuration
+ */
+interface AWSInitConfig {
+    /**
+     * Service name
+     */
+    service: string;
+    /**
+     * OTLP endpoint
+     */
+    endpoint?: string;
+    /**
+     * OTLP headers (e.g., authentication tokens)
+     */
+    headers?: Record<string, string>;
+    /**
+     * Auto-detect AWS resources
+     * @default false
+     */
+    autoDetectResources?: boolean | AWSResourceDetectorConfig;
+    /**
+     * AWS region
+     */
+    region?: string;
+    /**
+     * Additional resource attributes
+     */
+    resourceAttributes?: Record<string, string>;
+}
+/**
+ * Lambda instrumentation configuration
+ */
+interface LambdaInstrumentationConfig {
+    /**
+     * Capture response in span attributes
+     * @default false
+     */
+    captureResponse?: boolean;
+    /**
+     * Extract trace context from event
+     * @default true
+     */
+    extractTraceContext?: boolean;
+    /**
+     * Service name override
+     */
+    service?: string;
+}
+/**
+ * SDK instrumentation configuration
+ */
+interface SDKInstrumentationConfig {
+    /**
+     * Capture request payload
+     * @default false
+     */
+    captureRequest?: boolean;
+    /**
+     * Capture response payload
+     * @default false
+     */
+    captureResponse?: boolean;
+    /**
+     * Service name override
+     */
+    service?: string;
+}
+/**
+ * X-Ray configuration
+ */
+interface XRayConfig {
+    /**
+     * Enable X-Ray propagator
+     * @default false
+     */
+    propagator?: boolean;
+    /**
+     * Enable X-Ray remote sampling
+     * @default false
+     */
+    remoteSampling?: boolean;
+    /**
+     * Use X-Ray trace ID format
+     * @default false
+     */
+    idGenerator?: boolean;
+}
+/**
+ * Merge AWS service config with defaults
+ */
+declare function mergeServiceConfig(config?: AWSServiceConfig, defaults?: AWSServiceConfig): AWSServiceConfig;
+
+export { type AWSInitConfig as A, type LambdaInstrumentationConfig as L, type SDKInstrumentationConfig as S, type XRayConfig as X, type AWSResourceDetectorConfig as a, mergeServiceConfig as m };

package/dist/dynamodb.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+var chunkVZHQH75L_cjs = require('./chunk-VZHQH75L.cjs');
+require('./chunk-Q3DMMQ7K.cjs');
+require('./chunk-JEQ2X3Z6.cjs');
+
+
+
+Object.defineProperty(exports, "traceDynamoDB", {
+  enumerable: true,
+  get: function () { return chunkVZHQH75L_cjs.traceDynamoDB; }
+});
+//# sourceMappingURL=dynamodb.cjs.map
+//# sourceMappingURL=dynamodb.cjs.map

package/dist/dynamodb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"dynamodb.cjs"}

package/dist/dynamodb.d.cts

@@ -0,0 +1,93 @@
+import { TraceContext } from 'autotel';
+
+/**
+ * DynamoDB-specific instrumentation
+ *
+ * Provides semantic helpers for tracing DynamoDB operations with proper OpenTelemetry
+ * semantic conventions. Automatically sets `db.*` and `aws.dynamodb.*` attributes.
+ *
+ * @example Basic usage with factory pattern
+ * ```typescript
+ * import { traceDynamoDB } from 'autotel-aws/dynamodb';
+ * import { DynamoDBClient, GetItemCommand } from '@aws-sdk/client-dynamodb';
+ *
+ * const dynamodb = new DynamoDBClient({});
+ *
+ * export const getUser = traceDynamoDB({
+ *   operation: 'GetItem',
+ *   table: 'users'
+ * })(ctx => async (userId: string) => {
+ *   ctx.setAttribute('db.statement', 'GetItem WHERE id = :id');
+ *   return await dynamodb.send(new GetItemCommand({
+ *     TableName: 'users',
+ *     Key: { id: { S: userId } }
+ *   }));
+ * });
+ *
+ * // Usage: await getUser('user-123');
+ * ```
+ *
+ * @example Query with consumed capacity tracking
+ * ```typescript
+ * export const queryOrders = traceDynamoDB({
+ *   operation: 'Query',
+ *   table: 'orders'
+ * })(ctx => async (customerId: string, limit: number) => {
+ *   const result = await dynamodb.send(new QueryCommand({
+ *     TableName: 'orders',
+ *     KeyConditionExpression: 'customerId = :cid',
+ *     ExpressionAttributeValues: { ':cid': { S: customerId } },
+ *     Limit: limit,
+ *     ReturnConsumedCapacity: 'TOTAL'
+ *   }));
+ *
+ *   if (result.ConsumedCapacity?.CapacityUnits) {
+ *     ctx.setAttribute('aws.dynamodb.consumed_capacity', result.ConsumedCapacity.CapacityUnits);
+ *   }
+ *
+ *   return result.Items;
+ * });
+ * ```
+ */
+
+/**
+ * DynamoDB operation configuration
+ */
+interface TraceDynamoDBConfig {
+    /**
+     * DynamoDB operation name (e.g., 'GetItem', 'PutItem', 'Query', 'Scan')
+     * Used to generate the span name: `dynamodb.{operation}`
+     */
+    operation: string;
+    /**
+     * DynamoDB table name.
+     * Sets `db.name` and `aws.dynamodb.table_names` attributes.
+     */
+    table: string;
+}
+/**
+ * Trace DynamoDB operations with semantic attributes
+ *
+ * Creates a traced function that automatically sets DynamoDB semantic attributes
+ * following OpenTelemetry database semantic conventions.
+ *
+ * @param config - DynamoDB operation configuration
+ * @returns A higher-order function that wraps your DynamoDB operation with tracing
+ *
+ * @remarks
+ * Semantic attributes set automatically:
+ * - `db.system` - 'dynamodb'
+ * - `db.operation` - The operation name (GetItem, PutItem, etc.)
+ * - `db.name` - Table name
+ * - `aws.dynamodb.table_names` - Array containing the table name
+ *
+ * Additional attributes you should set in your handler:
+ * - `db.statement` - Query/operation description
+ * - `aws.dynamodb.consumed_capacity` - Consumed capacity units
+ * - `aws.dynamodb.index_name` - GSI/LSI name if applicable
+ *
+ * @see https://opentelemetry.io/docs/specs/semconv/database/dynamodb/
+ */
+declare function traceDynamoDB(config: TraceDynamoDBConfig): <TArgs extends unknown[], TReturn>(fn: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>) => (...args: TArgs) => Promise<TReturn>;
+
+export { type TraceDynamoDBConfig, traceDynamoDB };

package/dist/dynamodb.d.ts

@@ -0,0 +1,93 @@
+import { TraceContext } from 'autotel';
+
+/**
+ * DynamoDB-specific instrumentation
+ *
+ * Provides semantic helpers for tracing DynamoDB operations with proper OpenTelemetry
+ * semantic conventions. Automatically sets `db.*` and `aws.dynamodb.*` attributes.
+ *
+ * @example Basic usage with factory pattern
+ * ```typescript
+ * import { traceDynamoDB } from 'autotel-aws/dynamodb';
+ * import { DynamoDBClient, GetItemCommand } from '@aws-sdk/client-dynamodb';
+ *
+ * const dynamodb = new DynamoDBClient({});
+ *
+ * export const getUser = traceDynamoDB({
+ *   operation: 'GetItem',
+ *   table: 'users'
+ * })(ctx => async (userId: string) => {
+ *   ctx.setAttribute('db.statement', 'GetItem WHERE id = :id');
+ *   return await dynamodb.send(new GetItemCommand({
+ *     TableName: 'users',
+ *     Key: { id: { S: userId } }
+ *   }));
+ * });
+ *
+ * // Usage: await getUser('user-123');
+ * ```
+ *
+ * @example Query with consumed capacity tracking
+ * ```typescript
+ * export const queryOrders = traceDynamoDB({
+ *   operation: 'Query',
+ *   table: 'orders'
+ * })(ctx => async (customerId: string, limit: number) => {
+ *   const result = await dynamodb.send(new QueryCommand({
+ *     TableName: 'orders',
+ *     KeyConditionExpression: 'customerId = :cid',
+ *     ExpressionAttributeValues: { ':cid': { S: customerId } },
+ *     Limit: limit,
+ *     ReturnConsumedCapacity: 'TOTAL'
+ *   }));
+ *
+ *   if (result.ConsumedCapacity?.CapacityUnits) {
+ *     ctx.setAttribute('aws.dynamodb.consumed_capacity', result.ConsumedCapacity.CapacityUnits);
+ *   }
+ *
+ *   return result.Items;
+ * });
+ * ```
+ */
+
+/**
+ * DynamoDB operation configuration
+ */
+interface TraceDynamoDBConfig {
+    /**
+     * DynamoDB operation name (e.g., 'GetItem', 'PutItem', 'Query', 'Scan')
+     * Used to generate the span name: `dynamodb.{operation}`
+     */
+    operation: string;
+    /**
+     * DynamoDB table name.
+     * Sets `db.name` and `aws.dynamodb.table_names` attributes.
+     */
+    table: string;
+}
+/**
+ * Trace DynamoDB operations with semantic attributes
+ *
+ * Creates a traced function that automatically sets DynamoDB semantic attributes
+ * following OpenTelemetry database semantic conventions.
+ *
+ * @param config - DynamoDB operation configuration
+ * @returns A higher-order function that wraps your DynamoDB operation with tracing
+ *
+ * @remarks
+ * Semantic attributes set automatically:
+ * - `db.system` - 'dynamodb'
+ * - `db.operation` - The operation name (GetItem, PutItem, etc.)
+ * - `db.name` - Table name
+ * - `aws.dynamodb.table_names` - Array containing the table name
+ *
+ * Additional attributes you should set in your handler:
+ * - `db.statement` - Query/operation description
+ * - `aws.dynamodb.consumed_capacity` - Consumed capacity units
+ * - `aws.dynamodb.index_name` - GSI/LSI name if applicable
+ *
+ * @see https://opentelemetry.io/docs/specs/semconv/database/dynamodb/
+ */
+declare function traceDynamoDB(config: TraceDynamoDBConfig): <TArgs extends unknown[], TReturn>(fn: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>) => (...args: TArgs) => Promise<TReturn>;
+
+export { type TraceDynamoDBConfig, traceDynamoDB };

package/dist/dynamodb.js

@@ -0,0 +1,5 @@
+export { traceDynamoDB } from './chunk-JMSFE6FJ.js';
+import './chunk-I4CKQ4RD.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=dynamodb.js.map
+//# sourceMappingURL=dynamodb.js.map

package/dist/dynamodb.js.map

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