@aligent/aws-wrappers 0.0.1 → 0.1.0

package/CLAUDE.md

@@ -31,9 +31,10 @@ These are non-negotiable across every service in the package — change them onl
 ### Constructor
 
 ```ts
-constructor(opts?: { logger?: Logger; client?: <ServiceClient> })
+constructor(opts?: { logger?: LoggerInterface; client?: <ServiceClient> })
 ```
 
+- `logger` is typed as `LoggerInterface` (from `@aws-lambda-powertools/logger/types`), **not** the concrete `Logger` class. This avoids the dual-package hazard for ESM consumers — TS treats the ESM and CJS builds of the `Logger` class as nominally distinct (each has its own `#private` field), but `LoggerInterface` is a structural type alias so both builds are mutually assignable. The wrapper still defaults to `new Logger()` internally; only the public type widens.
 - `logger` defaults to `new Logger()`, which picks up `POWERTOOLS_SERVICE_NAME` from the environment. Do **not** pass `serviceName` in the default — env-driven service naming is the Powertools convention.
 - `client` defaults to `captureAWSv3Client(new <ServiceClient>())`. When the caller supplies a client, the wrapper does **not** apply X-Ray instrumentation — that's the caller's call.
 - No `clientConfig` / `region` / `endpoint` options. Callers needing those construct their own client and pass it via `client`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligent/aws-wrappers",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Opinionated AWS SDK wrappers with Powertools logging and X-Ray tracing",
   "type": "commonjs",
   "main": "./src/index.js",

package/src/dynamodb/dynamodb.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 import { BatchGetCommandInput, BatchGetCommandOutput, BatchWriteCommandInput, BatchWriteCommandOutput, DeleteCommandInput, DeleteCommandOutput, DynamoDBDocumentClient, GetCommandInput, PutCommandInput, PutCommandOutput, QueryCommandInput, QueryCommandOutput, ScanCommandInput, ScanCommandOutput, UpdateCommandInput, UpdateCommandOutput } from '@aws-sdk/lib-dynamodb';
 /**
  * DynamoDB command input with a typed `Key`. Used to thread a caller-defined
@@ -27,7 +27,7 @@ export declare class DynamoDBService {
      * tracing captures every DynamoDB call.
      */
     constructor(opts?: {
-        logger?: Logger;
+        logger?: LoggerInterface;
         client?: DynamoDBDocumentClient;
     });
     /**

package/src/s3/s3.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 import { CopyObjectCommandInput, CopyObjectCommandOutput, DeleteObjectCommandInput, DeleteObjectCommandOutput, DeleteObjectsCommandOutput, GetObjectCommandInput, GetObjectCommandOutput, HeadObjectCommandInput, HeadObjectCommandOutput, PutObjectCommandInput, PutObjectCommandOutput, S3Client } from '@aws-sdk/client-s3';
 /** Tight wrapper input type for `putObject`. */
 type PutObjectInput = Required<Pick<PutObjectCommandInput, 'Bucket' | 'Key' | 'Body'>>;
@@ -27,7 +27,7 @@ export declare class S3Service {
      * the wrapper does not apply X-Ray instrumentation.
      */
     constructor(opts?: {
-        logger?: Logger;
+        logger?: LoggerInterface;
         client?: S3Client;
     });
     /**

package/src/secrets-manager/secrets-manager.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 import { CreateSecretCommandInput, CreateSecretCommandOutput, DeleteSecretCommandInput, DeleteSecretCommandOutput, PutSecretValueCommandInput, PutSecretValueCommandOutput, SecretsManagerClient, UpdateSecretCommandInput, UpdateSecretCommandOutput } from '@aws-sdk/client-secrets-manager';
 /**
  * Wrapper around the AWS Secrets Manager client providing structured
@@ -22,7 +22,7 @@ export declare class SecretsManagerService {
      * owns that decision.
      */
     constructor(opts?: {
-        logger?: Logger;
+        logger?: LoggerInterface;
         client?: SecretsManagerClient;
     });
     /**

package/src/sfn/sfn.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 import { DescribeExecutionCommandInput, DescribeExecutionCommandOutput, ExecutionListItem, ListExecutionsCommandInput, SFNClient, StartExecutionCommandInput, StartExecutionCommandOutput, StopExecutionCommandInput, StopExecutionCommandOutput } from '@aws-sdk/client-sfn';
 /**
  * Wrapper around the AWS Step Functions client providing structured
@@ -14,7 +14,7 @@ export declare class StepFunctionsService {
      * the wrapper does not apply X-Ray instrumentation.
      */
     constructor(opts?: {
-        logger?: Logger;
+        logger?: LoggerInterface;
         client?: SFNClient;
     });
     /**

package/src/sns/sns.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 import { PublishBatchCommandInput, PublishBatchCommandOutput, PublishCommandInput, PublishCommandOutput, SNSClient } from '@aws-sdk/client-sns';
 /**
  * Wrapper around the AWS SNS client providing structured Powertools logging
@@ -20,7 +20,7 @@ export declare class SNSService {
      * its own `truncate` option.
      */
     constructor(opts?: {
-        logger?: Logger;
+        logger?: LoggerInterface;
         client?: SNSClient;
         truncate?: boolean;
     });

package/src/sqs/sqs.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 import { DeleteMessageBatchCommandInput, DeleteMessageBatchCommandOutput, DeleteMessageCommandInput, DeleteMessageCommandOutput, Message, ReceiveMessageCommandInput, SendMessageBatchCommandInput, SendMessageBatchCommandOutput, SendMessageCommandInput, SendMessageCommandOutput, SQSClient } from '@aws-sdk/client-sqs';
 /**
  * Wrapper around the AWS SQS client providing structured Powertools logging
@@ -19,7 +19,7 @@ export declare class SQSService {
      * option.
      */
     constructor(opts?: {
-        logger?: Logger;
+        logger?: LoggerInterface;
         client?: SQSClient;
         truncate?: boolean;
     });

package/src/ssm/ssm.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 import { Parameter, PutParameterCommandInput, PutParameterCommandOutput, SSMClient } from '@aws-sdk/client-ssm';
 /**
  * Wrapper around the AWS SSM Parameter Store client providing structured
@@ -22,7 +22,7 @@ export declare class SSMService {
      * the wrapper does not apply X-Ray instrumentation.
      */
     constructor(opts?: {
-        logger?: Logger;
+        logger?: LoggerInterface;
         client?: SSMClient;
     });
     /**

package/src/util/redact.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@aws-lambda-powertools/logger';
+import type { LoggerInterface } from '@aws-lambda-powertools/logger/types';
 /**
  * Return a log-safe projection of `input` based on the logger's configured level.
  *
@@ -15,4 +15,4 @@ import { Logger } from '@aws-lambda-powertools/logger';
  * lives in one place. See `packages/aws-wrappers/CLAUDE.md` ("Logging") for
  * the design rationale and conventions on building the safe-field lists.
  */
-export declare function filterFieldsForLogLevel<T extends object, K extends keyof T>(logger: Logger, input: T, safeFields: readonly K[]): T | Pick<T, K>;
+export declare function filterFieldsForLogLevel<T extends object, K extends keyof T>(logger: LoggerInterface, input: T, safeFields: readonly K[]): T | Pick<T, K>;