@aligent/aws-wrappers 0.0.1 → 0.1.1

package/cjs/index.d.ts

@@ -0,0 +1 @@
+export * from "./src/index";

package/cjs/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@aligent/aws-wrappers",
+  "version": "0.1.1",
+  "description": "Opinionated AWS SDK wrappers with Powertools logging and X-Ray tracing",
+  "main": "./index.cjs.js",
+  "module": "./esm/index.mjs",
+  "types": "./cjs/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./esm/src/index.d.ts",
+        "default": "./esm/index.mjs"
+      },
+      "require": {
+        "types": "./cjs/src/index.d.ts",
+        "default": "./cjs/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "cjs",
+    "esm",
+    "README.md",
+    "docs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aligent/microservice-development-utilities.git",
+    "directory": "packages/aws-wrappers"
+  },
+  "dependencies": {
+    "@aws-lambda-powertools/logger": "^2.33.0",
+    "@aws-sdk/client-dynamodb": "^3.1045.0",
+    "@aws-sdk/client-s3": "^3.1045.0",
+    "@aws-sdk/client-secrets-manager": "^3.1045.0",
+    "@aws-sdk/client-sfn": "^3.1045.0",
+    "@aws-sdk/client-sns": "^3.1045.0",
+    "@aws-sdk/client-sqs": "^3.1045.0",
+    "@aws-sdk/client-ssm": "^3.1045.0",
+    "@aws-sdk/lib-dynamodb": "^3.1045.0",
+    "@aws-sdk/s3-request-presigner": "^3.1045.0",
+    "aws-xray-sdk-core": "^3.12.0"
+  },
+  "author": "Aligent",
+  "license": "MIT",
+  "devDependencies": {
+    "aws-sdk-client-mock": "^4.1.0"
+  },
+  "type": "commonjs"
+}

package/{src → cjs/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/cjs/src/index.d.ts

@@ -0,0 +1,7 @@
+export { DynamoDBService } from './dynamodb/dynamodb.js';
+export { S3Service } from './s3/s3.js';
+export { SecretsManagerService } from './secrets-manager/secrets-manager.js';
+export { StepFunctionsService } from './sfn/sfn.js';
+export { SNSService } from './sns/sns.js';
+export { SQSService } from './sqs/sqs.js';
+export { SSMService } from './ssm/ssm.js';

package/{src → cjs/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 → cjs/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 → cjs/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 → cjs/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 → cjs/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 → cjs/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 → cjs/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>;

package/esm/index.d.ts

@@ -0,0 +1 @@
+export * from "./src/index";