@mbc-cqrs-serverless/core 1.0.26 → 1.1.0

package/dist/integration/utilities/aws-mock-manager.js

@@ -0,0 +1,336 @@
+"use strict";
+/**
+ * AWS Mock Manager
+ *
+ * Provides standardized setup and teardown for AWS SDK mock clients
+ * in integration tests. This eliminates repetitive mock configuration
+ * across test files and ensures consistent mock behavior.
+ *
+ * Usage:
+ *   import { AWSMockManager, createDynamoDBMock } from './utilities/aws-mock-manager'
+ *
+ *   // Option 1: Use individual mock creators
+ *   const { mock, client, reset, restore } = createDynamoDBMock()
+ *
+ *   // Option 2: Use the manager for multiple services
+ *   const manager = new AWSMockManager()
+ *   const dynamoDB = manager.getDynamoDB()
+ *   const s3 = manager.getS3()
+ *
+ *   beforeEach(() => manager.resetAll())
+ *   afterAll(() => manager.restoreAll())
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AWSMockManager = void 0;
+exports.createDynamoDBMock = createDynamoDBMock;
+exports.createS3Mock = createS3Mock;
+exports.createSQSMock = createSQSMock;
+exports.createSNSMock = createSNSMock;
+exports.createSFNMock = createSFNMock;
+exports.createSESMock = createSESMock;
+exports.setupAWSMocks = setupAWSMocks;
+exports.createTestMocks = createTestMocks;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const client_sesv2_1 = require("@aws-sdk/client-sesv2");
+const client_sfn_1 = require("@aws-sdk/client-sfn");
+const client_sns_1 = require("@aws-sdk/client-sns");
+const client_sqs_1 = require("@aws-sdk/client-sqs");
+const aws_sdk_client_mock_1 = require("aws-sdk-client-mock");
+/**
+ * Default AWS region for test clients
+ */
+const DEFAULT_REGION = 'ap-northeast-1';
+// ============================================================================
+// Individual Mock Creators
+// ============================================================================
+/**
+ * Creates a mocked DynamoDB client
+ */
+function createDynamoDBMock(options = {}) {
+    const mock = (0, aws_sdk_client_mock_1.mockClient)(client_dynamodb_1.DynamoDBClient);
+    const client = new client_dynamodb_1.DynamoDBClient({
+        region: options.region || DEFAULT_REGION,
+        maxAttempts: options.maxAttempts,
+        retryMode: options.retryMode,
+    });
+    return {
+        mock,
+        client,
+        reset: () => mock.reset(),
+        restore: () => {
+            mock.restore();
+            client.destroy();
+        },
+    };
+}
+/**
+ * Creates a mocked S3 client
+ */
+function createS3Mock(options = {}) {
+    const mock = (0, aws_sdk_client_mock_1.mockClient)(client_s3_1.S3Client);
+    const client = new client_s3_1.S3Client({
+        region: options.region || DEFAULT_REGION,
+        maxAttempts: options.maxAttempts,
+        retryMode: options.retryMode,
+    });
+    return {
+        mock,
+        client,
+        reset: () => mock.reset(),
+        restore: () => {
+            mock.restore();
+            client.destroy();
+        },
+    };
+}
+/**
+ * Creates a mocked SQS client
+ */
+function createSQSMock(options = {}) {
+    const mock = (0, aws_sdk_client_mock_1.mockClient)(client_sqs_1.SQSClient);
+    const client = new client_sqs_1.SQSClient({
+        region: options.region || DEFAULT_REGION,
+        maxAttempts: options.maxAttempts,
+        retryMode: options.retryMode,
+    });
+    return {
+        mock,
+        client,
+        reset: () => mock.reset(),
+        restore: () => {
+            mock.restore();
+            client.destroy();
+        },
+    };
+}
+/**
+ * Creates a mocked SNS client
+ */
+function createSNSMock(options = {}) {
+    const mock = (0, aws_sdk_client_mock_1.mockClient)(client_sns_1.SNSClient);
+    const client = new client_sns_1.SNSClient({
+        region: options.region || DEFAULT_REGION,
+        maxAttempts: options.maxAttempts,
+        retryMode: options.retryMode,
+    });
+    return {
+        mock,
+        client,
+        reset: () => mock.reset(),
+        restore: () => {
+            mock.restore();
+            client.destroy();
+        },
+    };
+}
+/**
+ * Creates a mocked Step Functions client
+ */
+function createSFNMock(options = {}) {
+    const mock = (0, aws_sdk_client_mock_1.mockClient)(client_sfn_1.SFNClient);
+    const client = new client_sfn_1.SFNClient({
+        region: options.region || DEFAULT_REGION,
+        maxAttempts: options.maxAttempts,
+        retryMode: options.retryMode,
+    });
+    return {
+        mock,
+        client,
+        reset: () => mock.reset(),
+        restore: () => {
+            mock.restore();
+            client.destroy();
+        },
+    };
+}
+/**
+ * Creates a mocked SES v2 client
+ */
+function createSESMock(options = {}) {
+    const mock = (0, aws_sdk_client_mock_1.mockClient)(client_sesv2_1.SESv2Client);
+    const client = new client_sesv2_1.SESv2Client({
+        region: options.region || DEFAULT_REGION,
+        maxAttempts: options.maxAttempts,
+        retryMode: options.retryMode,
+    });
+    return {
+        mock,
+        client,
+        reset: () => mock.reset(),
+        restore: () => {
+            mock.restore();
+            client.destroy();
+        },
+    };
+}
+// ============================================================================
+// AWS Mock Manager Class
+// ============================================================================
+/**
+ * Manages multiple AWS mock clients for test suites
+ */
+class AWSMockManager {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Gets or creates the DynamoDB mock
+     */
+    getDynamoDB() {
+        if (!this.dynamoDB) {
+            this.dynamoDB = createDynamoDBMock(this.options);
+        }
+        return this.dynamoDB;
+    }
+    /**
+     * Gets or creates the S3 mock
+     */
+    getS3() {
+        if (!this.s3) {
+            this.s3 = createS3Mock(this.options);
+        }
+        return this.s3;
+    }
+    /**
+     * Gets or creates the SQS mock
+     */
+    getSQS() {
+        if (!this.sqs) {
+            this.sqs = createSQSMock(this.options);
+        }
+        return this.sqs;
+    }
+    /**
+     * Gets or creates the SNS mock
+     */
+    getSNS() {
+        if (!this.sns) {
+            this.sns = createSNSMock(this.options);
+        }
+        return this.sns;
+    }
+    /**
+     * Gets or creates the Step Functions mock
+     */
+    getSFN() {
+        if (!this.sfn) {
+            this.sfn = createSFNMock(this.options);
+        }
+        return this.sfn;
+    }
+    /**
+     * Gets or creates the SES mock
+     */
+    getSES() {
+        if (!this.ses) {
+            this.ses = createSESMock(this.options);
+        }
+        return this.ses;
+    }
+    /**
+     * Resets all active mocks
+     */
+    resetAll() {
+        this.dynamoDB?.reset();
+        this.s3?.reset();
+        this.sqs?.reset();
+        this.sns?.reset();
+        this.sfn?.reset();
+        this.ses?.reset();
+    }
+    /**
+     * Restores all mocks and destroys clients
+     */
+    restoreAll() {
+        this.dynamoDB?.restore();
+        this.s3?.restore();
+        this.sqs?.restore();
+        this.sns?.restore();
+        this.sfn?.restore();
+        this.ses?.restore();
+        this.dynamoDB = undefined;
+        this.s3 = undefined;
+        this.sqs = undefined;
+        this.sns = undefined;
+        this.sfn = undefined;
+        this.ses = undefined;
+    }
+}
+exports.AWSMockManager = AWSMockManager;
+// ============================================================================
+// Test Setup Helpers
+// ============================================================================
+/**
+ * Creates a standard test setup with beforeEach/afterAll hooks
+ * for use with Jest describe blocks
+ */
+function setupAWSMocks(services, options = {}) {
+    const manager = new AWSMockManager(options);
+    // Initialize requested services
+    services.forEach((service) => {
+        switch (service) {
+            case 'dynamodb':
+                manager.getDynamoDB();
+                break;
+            case 's3':
+                manager.getS3();
+                break;
+            case 'sqs':
+                manager.getSQS();
+                break;
+            case 'sns':
+                manager.getSNS();
+                break;
+            case 'sfn':
+                manager.getSFN();
+                break;
+            case 'ses':
+                manager.getSES();
+                break;
+        }
+    });
+    return {
+        manager,
+        beforeEachHook: () => manager.resetAll(),
+        afterAllHook: () => manager.restoreAll(),
+    };
+}
+/**
+ * Quick setup function that returns individual mocks for common patterns
+ */
+function createTestMocks(services, options = {}) {
+    const mocks = {};
+    services.forEach((service) => {
+        switch (service) {
+            case 'dynamodb':
+                mocks.dynamodb = createDynamoDBMock(options);
+                break;
+            case 's3':
+                mocks.s3 = createS3Mock(options);
+                break;
+            case 'sqs':
+                mocks.sqs = createSQSMock(options);
+                break;
+            case 'sns':
+                mocks.sns = createSNSMock(options);
+                break;
+            case 'sfn':
+                mocks.sfn = createSFNMock(options);
+                break;
+            case 'ses':
+                mocks.ses = createSESMock(options);
+                break;
+        }
+    });
+    return {
+        ...mocks,
+        resetAll: () => {
+            Object.values(mocks).forEach((m) => m.reset());
+        },
+        restoreAll: () => {
+            Object.values(mocks).forEach((m) => m.restore());
+        },
+    };
+}
+//# sourceMappingURL=aws-mock-manager.js.map

package/dist/integration/utilities/aws-mock-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-mock-manager.js","sourceRoot":"","sources":["../../../src/integration/utilities/aws-mock-manager.ts"],"names":[],"mappings":"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"}

package/dist/integration/utilities/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Integration Test Utilities
+ *
+ * This module provides shared utilities for integration tests:
+ *
+ * - aws-error-factory: Factory functions for creating AWS SDK errors
+ * - aws-mock-manager: Mock client setup and teardown helpers
+ * - test-assertions: Reusable assertion functions
+ * - test-data-builders: Test data generation utilities
+ *
+ * Usage:
+ *   import {
+ *     createDynamoDBError,
+ *     createDynamoDBMock,
+ *     assertIsRetriableError,
+ *     createTestItem
+ *   } from './utilities'
+ */
+export { type AWSError, type AWSErrorMetadata, type CreateAWSErrorOptions, createDynamoDBError, createHttpStatusError, createNetworkError, createS3Error, createSESError, createSFNError, createSNSError, createSQSError, createTimeoutError, type DynamoDBErrorName, isNetworkError, isRetriableAWSError, isThrottlingError, type NetworkErrorCode, type S3ErrorName, type SESErrorName, type SFNErrorName, type SNSErrorName, type SQSErrorName, } from './aws-error-factory';
+export { AWSMockManager, createDynamoDBMock, createS3Mock, createSESMock, createSFNMock, createSNSMock, createSQSMock, createTestMocks, type MockClientOptions, type MockClientResult, setupAWSMocks, } from './aws-mock-manager';
+export { assertAllMatch, assertArrayLength, assertCompletesWithin, assertDynamoDBResponseMetadata, assertErrorMetadata, assertHasRequestId, assertIsClientFault, assertIsNetworkError, assertIsNotRetriableError, assertIsRetriableError, assertIsServerFault, assertIsThrottlingError, assertIsTimeoutError, assertMemoryIncreaseLessThan, assertNoMemoryLeak, assertResponseStructure, assertTakesAtLeast, assertThrowsErrorMatching, assertThrowsErrorWithName, assertUniqueBy, forceGC, getHeapUsed, } from './test-assertions';
+export { createBatchGetRequest, createBatchWriteRequest, createKey, createKeys, createLargeTestData, createMarshalledItem, createMarshalledItems, createMixedTypeTestData, createNestedTestData, createRandomString, createS3Content, createS3Metadata, createSFNExecutionName, createSFNInput, createSNSMessage, createSQSBatchEntries, createSQSMessageBody, createTestItem, type CreateTestItemOptions, createTestItems, DYNAMODB_BATCH_SIZE, marshall, splitIntoBatches, type TestItem, unmarshall, unmarshallItem, unmarshallItems, } from './test-data-builders';

package/dist/integration/utilities/index.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Integration Test Utilities
+ *
+ * This module provides shared utilities for integration tests:
+ *
+ * - aws-error-factory: Factory functions for creating AWS SDK errors
+ * - aws-mock-manager: Mock client setup and teardown helpers
+ * - test-assertions: Reusable assertion functions
+ * - test-data-builders: Test data generation utilities
+ *
+ * Usage:
+ *   import {
+ *     createDynamoDBError,
+ *     createDynamoDBMock,
+ *     assertIsRetriableError,
+ *     createTestItem
+ *   } from './utilities'
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMarshalledItems = exports.createMarshalledItem = exports.createLargeTestData = exports.createKeys = exports.createKey = exports.createBatchWriteRequest = exports.createBatchGetRequest = exports.getHeapUsed = exports.forceGC = exports.assertUniqueBy = exports.assertThrowsErrorWithName = exports.assertThrowsErrorMatching = exports.assertTakesAtLeast = exports.assertResponseStructure = exports.assertNoMemoryLeak = exports.assertMemoryIncreaseLessThan = exports.assertIsTimeoutError = exports.assertIsThrottlingError = exports.assertIsServerFault = exports.assertIsRetriableError = exports.assertIsNotRetriableError = exports.assertIsNetworkError = exports.assertIsClientFault = exports.assertHasRequestId = exports.assertErrorMetadata = exports.assertDynamoDBResponseMetadata = exports.assertCompletesWithin = exports.assertArrayLength = exports.assertAllMatch = exports.setupAWSMocks = exports.createTestMocks = exports.createSQSMock = exports.createSNSMock = exports.createSFNMock = exports.createSESMock = exports.createS3Mock = exports.createDynamoDBMock = exports.AWSMockManager = exports.isThrottlingError = exports.isRetriableAWSError = exports.isNetworkError = exports.createTimeoutError = exports.createSQSError = exports.createSNSError = exports.createSFNError = exports.createSESError = exports.createS3Error = exports.createNetworkError = exports.createHttpStatusError = exports.createDynamoDBError = void 0;
+exports.unmarshallItems = exports.unmarshallItem = exports.unmarshall = exports.splitIntoBatches = exports.marshall = exports.DYNAMODB_BATCH_SIZE = exports.createTestItems = exports.createTestItem = exports.createSQSMessageBody = exports.createSQSBatchEntries = exports.createSNSMessage = exports.createSFNInput = exports.createSFNExecutionName = exports.createS3Metadata = exports.createS3Content = exports.createRandomString = exports.createNestedTestData = exports.createMixedTypeTestData = void 0;
+// AWS Error Factory
+var aws_error_factory_1 = require("./aws-error-factory");
+Object.defineProperty(exports, "createDynamoDBError", { enumerable: true, get: function () { return aws_error_factory_1.createDynamoDBError; } });
+Object.defineProperty(exports, "createHttpStatusError", { enumerable: true, get: function () { return aws_error_factory_1.createHttpStatusError; } });
+Object.defineProperty(exports, "createNetworkError", { enumerable: true, get: function () { return aws_error_factory_1.createNetworkError; } });
+Object.defineProperty(exports, "createS3Error", { enumerable: true, get: function () { return aws_error_factory_1.createS3Error; } });
+Object.defineProperty(exports, "createSESError", { enumerable: true, get: function () { return aws_error_factory_1.createSESError; } });
+Object.defineProperty(exports, "createSFNError", { enumerable: true, get: function () { return aws_error_factory_1.createSFNError; } });
+Object.defineProperty(exports, "createSNSError", { enumerable: true, get: function () { return aws_error_factory_1.createSNSError; } });
+Object.defineProperty(exports, "createSQSError", { enumerable: true, get: function () { return aws_error_factory_1.createSQSError; } });
+Object.defineProperty(exports, "createTimeoutError", { enumerable: true, get: function () { return aws_error_factory_1.createTimeoutError; } });
+Object.defineProperty(exports, "isNetworkError", { enumerable: true, get: function () { return aws_error_factory_1.isNetworkError; } });
+Object.defineProperty(exports, "isRetriableAWSError", { enumerable: true, get: function () { return aws_error_factory_1.isRetriableAWSError; } });
+Object.defineProperty(exports, "isThrottlingError", { enumerable: true, get: function () { return aws_error_factory_1.isThrottlingError; } });
+// AWS Mock Manager
+var aws_mock_manager_1 = require("./aws-mock-manager");
+Object.defineProperty(exports, "AWSMockManager", { enumerable: true, get: function () { return aws_mock_manager_1.AWSMockManager; } });
+Object.defineProperty(exports, "createDynamoDBMock", { enumerable: true, get: function () { return aws_mock_manager_1.createDynamoDBMock; } });
+Object.defineProperty(exports, "createS3Mock", { enumerable: true, get: function () { return aws_mock_manager_1.createS3Mock; } });
+Object.defineProperty(exports, "createSESMock", { enumerable: true, get: function () { return aws_mock_manager_1.createSESMock; } });
+Object.defineProperty(exports, "createSFNMock", { enumerable: true, get: function () { return aws_mock_manager_1.createSFNMock; } });
+Object.defineProperty(exports, "createSNSMock", { enumerable: true, get: function () { return aws_mock_manager_1.createSNSMock; } });
+Object.defineProperty(exports, "createSQSMock", { enumerable: true, get: function () { return aws_mock_manager_1.createSQSMock; } });
+Object.defineProperty(exports, "createTestMocks", { enumerable: true, get: function () { return aws_mock_manager_1.createTestMocks; } });
+Object.defineProperty(exports, "setupAWSMocks", { enumerable: true, get: function () { return aws_mock_manager_1.setupAWSMocks; } });
+// Test Assertions
+var test_assertions_1 = require("./test-assertions");
+Object.defineProperty(exports, "assertAllMatch", { enumerable: true, get: function () { return test_assertions_1.assertAllMatch; } });
+Object.defineProperty(exports, "assertArrayLength", { enumerable: true, get: function () { return test_assertions_1.assertArrayLength; } });
+Object.defineProperty(exports, "assertCompletesWithin", { enumerable: true, get: function () { return test_assertions_1.assertCompletesWithin; } });
+Object.defineProperty(exports, "assertDynamoDBResponseMetadata", { enumerable: true, get: function () { return test_assertions_1.assertDynamoDBResponseMetadata; } });
+Object.defineProperty(exports, "assertErrorMetadata", { enumerable: true, get: function () { return test_assertions_1.assertErrorMetadata; } });
+Object.defineProperty(exports, "assertHasRequestId", { enumerable: true, get: function () { return test_assertions_1.assertHasRequestId; } });
+Object.defineProperty(exports, "assertIsClientFault", { enumerable: true, get: function () { return test_assertions_1.assertIsClientFault; } });
+Object.defineProperty(exports, "assertIsNetworkError", { enumerable: true, get: function () { return test_assertions_1.assertIsNetworkError; } });
+Object.defineProperty(exports, "assertIsNotRetriableError", { enumerable: true, get: function () { return test_assertions_1.assertIsNotRetriableError; } });
+Object.defineProperty(exports, "assertIsRetriableError", { enumerable: true, get: function () { return test_assertions_1.assertIsRetriableError; } });
+Object.defineProperty(exports, "assertIsServerFault", { enumerable: true, get: function () { return test_assertions_1.assertIsServerFault; } });
+Object.defineProperty(exports, "assertIsThrottlingError", { enumerable: true, get: function () { return test_assertions_1.assertIsThrottlingError; } });
+Object.defineProperty(exports, "assertIsTimeoutError", { enumerable: true, get: function () { return test_assertions_1.assertIsTimeoutError; } });
+Object.defineProperty(exports, "assertMemoryIncreaseLessThan", { enumerable: true, get: function () { return test_assertions_1.assertMemoryIncreaseLessThan; } });
+Object.defineProperty(exports, "assertNoMemoryLeak", { enumerable: true, get: function () { return test_assertions_1.assertNoMemoryLeak; } });
+Object.defineProperty(exports, "assertResponseStructure", { enumerable: true, get: function () { return test_assertions_1.assertResponseStructure; } });
+Object.defineProperty(exports, "assertTakesAtLeast", { enumerable: true, get: function () { return test_assertions_1.assertTakesAtLeast; } });
+Object.defineProperty(exports, "assertThrowsErrorMatching", { enumerable: true, get: function () { return test_assertions_1.assertThrowsErrorMatching; } });
+Object.defineProperty(exports, "assertThrowsErrorWithName", { enumerable: true, get: function () { return test_assertions_1.assertThrowsErrorWithName; } });
+Object.defineProperty(exports, "assertUniqueBy", { enumerable: true, get: function () { return test_assertions_1.assertUniqueBy; } });
+Object.defineProperty(exports, "forceGC", { enumerable: true, get: function () { return test_assertions_1.forceGC; } });
+Object.defineProperty(exports, "getHeapUsed", { enumerable: true, get: function () { return test_assertions_1.getHeapUsed; } });
+// Test Data Builders
+var test_data_builders_1 = require("./test-data-builders");
+Object.defineProperty(exports, "createBatchGetRequest", { enumerable: true, get: function () { return test_data_builders_1.createBatchGetRequest; } });
+Object.defineProperty(exports, "createBatchWriteRequest", { enumerable: true, get: function () { return test_data_builders_1.createBatchWriteRequest; } });
+Object.defineProperty(exports, "createKey", { enumerable: true, get: function () { return test_data_builders_1.createKey; } });
+Object.defineProperty(exports, "createKeys", { enumerable: true, get: function () { return test_data_builders_1.createKeys; } });
+Object.defineProperty(exports, "createLargeTestData", { enumerable: true, get: function () { return test_data_builders_1.createLargeTestData; } });
+Object.defineProperty(exports, "createMarshalledItem", { enumerable: true, get: function () { return test_data_builders_1.createMarshalledItem; } });
+Object.defineProperty(exports, "createMarshalledItems", { enumerable: true, get: function () { return test_data_builders_1.createMarshalledItems; } });
+Object.defineProperty(exports, "createMixedTypeTestData", { enumerable: true, get: function () { return test_data_builders_1.createMixedTypeTestData; } });
+Object.defineProperty(exports, "createNestedTestData", { enumerable: true, get: function () { return test_data_builders_1.createNestedTestData; } });
+Object.defineProperty(exports, "createRandomString", { enumerable: true, get: function () { return test_data_builders_1.createRandomString; } });
+Object.defineProperty(exports, "createS3Content", { enumerable: true, get: function () { return test_data_builders_1.createS3Content; } });
+Object.defineProperty(exports, "createS3Metadata", { enumerable: true, get: function () { return test_data_builders_1.createS3Metadata; } });
+Object.defineProperty(exports, "createSFNExecutionName", { enumerable: true, get: function () { return test_data_builders_1.createSFNExecutionName; } });
+Object.defineProperty(exports, "createSFNInput", { enumerable: true, get: function () { return test_data_builders_1.createSFNInput; } });
+Object.defineProperty(exports, "createSNSMessage", { enumerable: true, get: function () { return test_data_builders_1.createSNSMessage; } });
+Object.defineProperty(exports, "createSQSBatchEntries", { enumerable: true, get: function () { return test_data_builders_1.createSQSBatchEntries; } });
+Object.defineProperty(exports, "createSQSMessageBody", { enumerable: true, get: function () { return test_data_builders_1.createSQSMessageBody; } });
+Object.defineProperty(exports, "createTestItem", { enumerable: true, get: function () { return test_data_builders_1.createTestItem; } });
+Object.defineProperty(exports, "createTestItems", { enumerable: true, get: function () { return test_data_builders_1.createTestItems; } });
+Object.defineProperty(exports, "DYNAMODB_BATCH_SIZE", { enumerable: true, get: function () { return test_data_builders_1.DYNAMODB_BATCH_SIZE; } });
+Object.defineProperty(exports, "marshall", { enumerable: true, get: function () { return test_data_builders_1.marshall; } });
+Object.defineProperty(exports, "splitIntoBatches", { enumerable: true, get: function () { return test_data_builders_1.splitIntoBatches; } });
+Object.defineProperty(exports, "unmarshall", { enumerable: true, get: function () { return test_data_builders_1.unmarshall; } });
+Object.defineProperty(exports, "unmarshallItem", { enumerable: true, get: function () { return test_data_builders_1.unmarshallItem; } });
+Object.defineProperty(exports, "unmarshallItems", { enumerable: true, get: function () { return test_data_builders_1.unmarshallItems; } });
+//# sourceMappingURL=index.js.map

package/dist/integration/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integration/utilities/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;AAEH,oBAAoB;AACpB,yDAuB4B;AAnB1B,wHAAA,mBAAmB,OAAA;AACnB,0HAAA,qBAAqB,OAAA;AACrB,uHAAA,kBAAkB,OAAA;AAClB,kHAAA,aAAa,OAAA;AACb,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AACd,uHAAA,kBAAkB,OAAA;AAElB,mHAAA,cAAc,OAAA;AACd,wHAAA,mBAAmB,OAAA;AACnB,sHAAA,iBAAiB,OAAA;AASnB,mBAAmB;AACnB,uDAY2B;AAXzB,kHAAA,cAAc,OAAA;AACd,sHAAA,kBAAkB,OAAA;AAClB,gHAAA,YAAY,OAAA;AACZ,iHAAA,aAAa,OAAA;AACb,iHAAA,aAAa,OAAA;AACb,iHAAA,aAAa,OAAA;AACb,iHAAA,aAAa,OAAA;AACb,mHAAA,eAAe,OAAA;AAGf,iHAAA,aAAa,OAAA;AAGf,kBAAkB;AAClB,qDAuB0B;AAtBxB,iHAAA,cAAc,OAAA;AACd,oHAAA,iBAAiB,OAAA;AACjB,wHAAA,qBAAqB,OAAA;AACrB,iIAAA,8BAA8B,OAAA;AAC9B,sHAAA,mBAAmB,OAAA;AACnB,qHAAA,kBAAkB,OAAA;AAClB,sHAAA,mBAAmB,OAAA;AACnB,uHAAA,oBAAoB,OAAA;AACpB,4HAAA,yBAAyB,OAAA;AACzB,yHAAA,sBAAsB,OAAA;AACtB,sHAAA,mBAAmB,OAAA;AACnB,0HAAA,uBAAuB,OAAA;AACvB,uHAAA,oBAAoB,OAAA;AACpB,+HAAA,4BAA4B,OAAA;AAC5B,qHAAA,kBAAkB,OAAA;AAClB,0HAAA,uBAAuB,OAAA;AACvB,qHAAA,kBAAkB,OAAA;AAClB,4HAAA,yBAAyB,OAAA;AACzB,4HAAA,yBAAyB,OAAA;AACzB,iHAAA,cAAc,OAAA;AACd,0GAAA,OAAO,OAAA;AACP,8GAAA,WAAW,OAAA;AAGb,qBAAqB;AACrB,2DA4B6B;AA3B3B,2HAAA,qBAAqB,OAAA;AACrB,6HAAA,uBAAuB,OAAA;AACvB,+GAAA,SAAS,OAAA;AACT,gHAAA,UAAU,OAAA;AACV,yHAAA,mBAAmB,OAAA;AACnB,0HAAA,oBAAoB,OAAA;AACpB,2HAAA,qBAAqB,OAAA;AACrB,6HAAA,uBAAuB,OAAA;AACvB,0HAAA,oBAAoB,OAAA;AACpB,wHAAA,kBAAkB,OAAA;AAClB,qHAAA,eAAe,OAAA;AACf,sHAAA,gBAAgB,OAAA;AAChB,4HAAA,sBAAsB,OAAA;AACtB,oHAAA,cAAc,OAAA;AACd,sHAAA,gBAAgB,OAAA;AAChB,2HAAA,qBAAqB,OAAA;AACrB,0HAAA,oBAAoB,OAAA;AACpB,oHAAA,cAAc,OAAA;AAEd,qHAAA,eAAe,OAAA;AACf,yHAAA,mBAAmB,OAAA;AACnB,8GAAA,QAAQ,OAAA;AACR,sHAAA,gBAAgB,OAAA;AAEhB,gHAAA,UAAU,OAAA;AACV,oHAAA,cAAc,OAAA;AACd,qHAAA,eAAe,OAAA"}

package/dist/integration/utilities/test-assertions.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Test Assertions
+ *
+ * Provides reusable assertion functions for AWS SDK error patterns
+ * and common test scenarios. These helpers ensure consistent
+ * validation across integration tests.
+ *
+ * Usage:
+ *   import {
+ *     assertIsRetriableError,
+ *     assertIsThrottlingError,
+ *     assertErrorMetadata
+ *   } from './utilities/test-assertions'
+ *
+ *   it('should be retriable', () => {
+ *     assertIsRetriableError(error)
+ *   })
+ */
+/**
+ * Asserts that an error is retriable based on AWS SDK v3 patterns
+ */
+export declare function assertIsRetriableError(error: unknown): void;
+/**
+ * Asserts that an error is NOT retriable
+ */
+export declare function assertIsNotRetriableError(error: unknown): void;
+/**
+ * Asserts that an error is a throttling error
+ */
+export declare function assertIsThrottlingError(error: unknown): void;
+/**
+ * Asserts that an error is a network error
+ */
+export declare function assertIsNetworkError(error: unknown): void;
+/**
+ * Asserts that an error is a timeout error
+ */
+export declare function assertIsTimeoutError(error: unknown): void;
+/**
+ * Asserts that an error has the expected metadata
+ */
+export declare function assertErrorMetadata(error: unknown, expected: {
+    httpStatusCode?: number;
+    requestId?: string;
+    name?: string;
+    fault?: 'client' | 'server';
+}): void;
+/**
+ * Asserts that an error has a valid request ID
+ */
+export declare function assertHasRequestId(error: unknown): void;
+/**
+ * Asserts that an error is a client fault (4xx)
+ */
+export declare function assertIsClientFault(error: unknown): void;
+/**
+ * Asserts that an error is a server fault (5xx)
+ */
+export declare function assertIsServerFault(error: unknown): void;
+/**
+ * Asserts that a response has the expected structure
+ */
+export declare function assertResponseStructure<T extends object>(response: unknown, expectedKeys: Array<keyof T>): void;
+/**
+ * Asserts that a DynamoDB response has valid metadata
+ */
+export declare function assertDynamoDBResponseMetadata(response: unknown): void;
+/**
+ * Asserts that an async function throws an error with the expected name
+ */
+export declare function assertThrowsErrorWithName(fn: () => Promise<unknown>, expectedName: string): Promise<void>;
+/**
+ * Asserts that an async function throws an error matching a predicate
+ */
+export declare function assertThrowsErrorMatching(fn: () => Promise<unknown>, predicate: (error: unknown) => boolean, description?: string): Promise<void>;
+/**
+ * Asserts that an async operation completes within a time limit
+ */
+export declare function assertCompletesWithin<T>(fn: () => Promise<T>, timeoutMs: number): Promise<T>;
+/**
+ * Asserts that an async operation takes at least a minimum time
+ * (useful for testing retry delays)
+ */
+export declare function assertTakesAtLeast<T>(fn: () => Promise<T>, minMs: number): Promise<T>;
+/**
+ * Forces garbage collection if available (requires --expose-gc flag)
+ */
+export declare function forceGC(): void;
+/**
+ * Gets current heap memory usage in bytes
+ */
+export declare function getHeapUsed(): number;
+/**
+ * Asserts that memory increase is within acceptable limits
+ */
+export declare function assertMemoryIncreaseLessThan(initialMemory: number, maxIncreaseBytes: number): void;
+/**
+ * Runs a function and asserts memory usage stays within limits
+ */
+export declare function assertNoMemoryLeak<T>(fn: () => Promise<T>, maxIncreaseBytes?: number): Promise<T>;
+/**
+ * Asserts that an array has the expected length
+ */
+export declare function assertArrayLength<T>(array: T[], expectedLength: number): void;
+/**
+ * Asserts that all items in an array match a predicate
+ */
+export declare function assertAllMatch<T>(array: T[], predicate: (item: T) => boolean, description?: string): void;
+/**
+ * Asserts that an array contains unique items based on a key function
+ */
+export declare function assertUniqueBy<T, K>(array: T[], keyFn: (item: T) => K): void;