autotel-aws 0.13.13 → 0.13.14

package/dist/dynamodb.d.ts

@@ -1,69 +1,20 @@
-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;
- * });
- * ```
- */
+import { TraceContext } from "autotel";
 
+//#region src/dynamodb/index.d.ts
 /**
  * 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;
+  /**
+   * 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
@@ -89,5 +40,6 @@ interface TraceDynamoDBConfig {
  * @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 };
+//#endregion
+export { TraceDynamoDBConfig, traceDynamoDB };
+//# sourceMappingURL=dynamodb.d.ts.map

package/dist/dynamodb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.d.ts","names":[],"sources":["../src/dynamodb/index.ts"],"mappings":";;;;;;UAwDiB,mBAAA;;;;;EAKf,SAAA;;;;;EAMA,KAAK;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA0BS,aAAA,CAAc,MAAA,EAAQ,mBAAA,sCAElC,EAAA,GAAK,GAAA,EAAK,YAAA,SAAqB,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA,UAClD,IAAA,EAAM,KAAA,KAAU,OAAA,CAAQ,OAAA"}

package/dist/dynamodb.js

@@ -1,5 +1,91 @@
-export { traceDynamoDB } from './chunk-JMSFE6FJ.js';
-import './chunk-I4CKQ4RD.js';
-import './chunk-DGUM43GV.js';
-//# sourceMappingURL=dynamodb.js.map
+import { buildDynamoDBAttributes } from "./attributes.js";
+import { trace } from "autotel";
+
+//#region src/dynamodb/index.ts
+/**
+* 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;
+* });
+* ```
+*/
+/**
+* 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/
+*/
+function traceDynamoDB(config) {
+	return function wrapper(fn) {
+		return trace(`dynamodb.${config.operation}`, (ctx) => async (...args) => {
+			ctx.setAttributes(buildDynamoDBAttributes({
+				tableName: config.table,
+				operation: config.operation
+			}));
+			return fn(ctx)(...args);
+		});
+	};
+}
+
+//#endregion
+export { traceDynamoDB };
 //# sourceMappingURL=dynamodb.js.map

package/dist/dynamodb.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"dynamodb.js"}
+{"version":3,"file":"dynamodb.js","names":[],"sources":["../src/dynamodb/index.ts"],"sourcesContent":["/**\n * DynamoDB-specific instrumentation\n *\n * Provides semantic helpers for tracing DynamoDB operations with proper OpenTelemetry\n * semantic conventions. Automatically sets `db.*` and `aws.dynamodb.*` attributes.\n *\n * @example Basic usage with factory pattern\n * ```typescript\n * import { traceDynamoDB } from 'autotel-aws/dynamodb';\n * import { DynamoDBClient, GetItemCommand } from '@aws-sdk/client-dynamodb';\n *\n * const dynamodb = new DynamoDBClient({});\n *\n * export const getUser = traceDynamoDB({\n *   operation: 'GetItem',\n *   table: 'users'\n * })(ctx => async (userId: string) => {\n *   ctx.setAttribute('db.statement', 'GetItem WHERE id = :id');\n *   return await dynamodb.send(new GetItemCommand({\n *     TableName: 'users',\n *     Key: { id: { S: userId } }\n *   }));\n * });\n *\n * // Usage: await getUser('user-123');\n * ```\n *\n * @example Query with consumed capacity tracking\n * ```typescript\n * export const queryOrders = traceDynamoDB({\n *   operation: 'Query',\n *   table: 'orders'\n * })(ctx => async (customerId: string, limit: number) => {\n *   const result = await dynamodb.send(new QueryCommand({\n *     TableName: 'orders',\n *     KeyConditionExpression: 'customerId = :cid',\n *     ExpressionAttributeValues: { ':cid': { S: customerId } },\n *     Limit: limit,\n *     ReturnConsumedCapacity: 'TOTAL'\n *   }));\n *\n *   if (result.ConsumedCapacity?.CapacityUnits) {\n *     ctx.setAttribute('aws.dynamodb.consumed_capacity', result.ConsumedCapacity.CapacityUnits);\n *   }\n *\n *   return result.Items;\n * });\n * ```\n */\n\nimport { trace, type TraceContext } from 'autotel';\nimport { buildDynamoDBAttributes } from '../attributes';\n\n/**\n * DynamoDB operation configuration\n */\nexport interface TraceDynamoDBConfig {\n  /**\n   * DynamoDB operation name (e.g., 'GetItem', 'PutItem', 'Query', 'Scan')\n   * Used to generate the span name: `dynamodb.{operation}`\n   */\n  operation: string;\n\n  /**\n   * DynamoDB table name.\n   * Sets `db.name` and `aws.dynamodb.table_names` attributes.\n   */\n  table: string;\n}\n\n/**\n * Trace DynamoDB operations with semantic attributes\n *\n * Creates a traced function that automatically sets DynamoDB semantic attributes\n * following OpenTelemetry database semantic conventions.\n *\n * @param config - DynamoDB operation configuration\n * @returns A higher-order function that wraps your DynamoDB operation with tracing\n *\n * @remarks\n * Semantic attributes set automatically:\n * - `db.system` - 'dynamodb'\n * - `db.operation` - The operation name (GetItem, PutItem, etc.)\n * - `db.name` - Table name\n * - `aws.dynamodb.table_names` - Array containing the table name\n *\n * Additional attributes you should set in your handler:\n * - `db.statement` - Query/operation description\n * - `aws.dynamodb.consumed_capacity` - Consumed capacity units\n * - `aws.dynamodb.index_name` - GSI/LSI name if applicable\n *\n * @see https://opentelemetry.io/docs/specs/semconv/database/dynamodb/\n */\nexport function traceDynamoDB(config: TraceDynamoDBConfig) {\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      `dynamodb.${config.operation}`,\n      (ctx: TraceContext) =>\n        async (...args: TArgs): Promise<TReturn> => {\n          // Set DynamoDB semantic attributes\n          ctx.setAttributes(\n            buildDynamoDBAttributes({\n              tableName: config.table,\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6FA,SAAgB,cAAc,QAA6B;CACzD,OAAO,SAAS,QACd,IACsC;EAEtC,OAAO,MACL,YAAY,OAAO,cAClB,QACC,OAAO,GAAG,SAAkC;GAE1C,IAAI,cACF,wBAAwB;IACtB,WAAW,OAAO;IAClB,WAAW,OAAO;GACpB,CAAC,CACH;GAIA,OADgB,GAAG,GACN,CAAC,CAAC,GAAG,IAAI;EACxB,CACJ;CACF;AACF"}