@mbc-cqrs-serverless/core 1.1.0-beta.0 → 1.1.0

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;

package/dist/integration/utilities/test-assertions.js

@@ -0,0 +1,345 @@
+"use strict";
+/**
+ * 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)
+ *   })
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertIsRetriableError = assertIsRetriableError;
+exports.assertIsNotRetriableError = assertIsNotRetriableError;
+exports.assertIsThrottlingError = assertIsThrottlingError;
+exports.assertIsNetworkError = assertIsNetworkError;
+exports.assertIsTimeoutError = assertIsTimeoutError;
+exports.assertErrorMetadata = assertErrorMetadata;
+exports.assertHasRequestId = assertHasRequestId;
+exports.assertIsClientFault = assertIsClientFault;
+exports.assertIsServerFault = assertIsServerFault;
+exports.assertResponseStructure = assertResponseStructure;
+exports.assertDynamoDBResponseMetadata = assertDynamoDBResponseMetadata;
+exports.assertThrowsErrorWithName = assertThrowsErrorWithName;
+exports.assertThrowsErrorMatching = assertThrowsErrorMatching;
+exports.assertCompletesWithin = assertCompletesWithin;
+exports.assertTakesAtLeast = assertTakesAtLeast;
+exports.forceGC = forceGC;
+exports.getHeapUsed = getHeapUsed;
+exports.assertMemoryIncreaseLessThan = assertMemoryIncreaseLessThan;
+exports.assertNoMemoryLeak = assertNoMemoryLeak;
+exports.assertArrayLength = assertArrayLength;
+exports.assertAllMatch = assertAllMatch;
+exports.assertUniqueBy = assertUniqueBy;
+// ============================================================================
+// Error Type Assertions
+// ============================================================================
+/**
+ * Asserts that an error is retriable based on AWS SDK v3 patterns
+ */
+function assertIsRetriableError(error) {
+    const awsError = error;
+    const isRetriable = awsError.$retryable !== undefined ||
+        (awsError.$metadata?.httpStatusCode &&
+            awsError.$metadata.httpStatusCode >= 500) ||
+        awsError.$metadata?.httpStatusCode === 429 ||
+        [
+            'ProvisionedThroughputExceededException',
+            'ThrottlingException',
+            'InternalServerError',
+            'ServiceUnavailable',
+            'RequestLimitExceeded',
+            'SlowDown',
+            'TooManyRequestsException',
+        ].includes(awsError.name);
+    if (!isRetriable) {
+        throw new Error(`Expected error to be retriable, but got: ${awsError.name} (status: ${awsError.$metadata?.httpStatusCode})`);
+    }
+}
+/**
+ * Asserts that an error is NOT retriable
+ */
+function assertIsNotRetriableError(error) {
+    const awsError = error;
+    const nonRetriablePatterns = !awsError.$retryable &&
+        awsError.$metadata?.httpStatusCode !== undefined &&
+        awsError.$metadata.httpStatusCode < 500 &&
+        awsError.$metadata.httpStatusCode !== 429;
+    if (!nonRetriablePatterns) {
+        throw new Error(`Expected error to NOT be retriable, but got: ${awsError.name} (status: ${awsError.$metadata?.httpStatusCode}, $retryable: ${JSON.stringify(awsError.$retryable)})`);
+    }
+}
+/**
+ * Asserts that an error is a throttling error
+ */
+function assertIsThrottlingError(error) {
+    const awsError = error;
+    if (awsError.$retryable?.throttling !== true) {
+        throw new Error(`Expected throttling error, but got: ${awsError.name} ($retryable: ${JSON.stringify(awsError.$retryable)})`);
+    }
+}
+/**
+ * Asserts that an error is a network error
+ */
+function assertIsNetworkError(error) {
+    const err = error;
+    const networkErrorCodes = [
+        'ECONNRESET',
+        'ECONNREFUSED',
+        'ETIMEDOUT',
+        'ENETUNREACH',
+        'ENOTFOUND',
+        'EPIPE',
+        'EAI_AGAIN',
+    ];
+    const isNetwork = (err.code && networkErrorCodes.includes(err.code)) ||
+        err.message.toLowerCase().includes('socket hang up') ||
+        err.message.toLowerCase().includes('network error') ||
+        err.message.toLowerCase().includes('connection reset') ||
+        err.message.toLowerCase().includes('connection refused');
+    if (!isNetwork) {
+        throw new Error(`Expected network error, but got: ${err.message} (code: ${err.code})`);
+    }
+}
+/**
+ * Asserts that an error is a timeout error
+ */
+function assertIsTimeoutError(error) {
+    const err = error;
+    const isTimeout = err.code === 'ETIMEDOUT' ||
+        err.name === 'TimeoutError' ||
+        err.message.toLowerCase().includes('timeout') ||
+        err.message.toLowerCase().includes('timed out');
+    if (!isTimeout) {
+        throw new Error(`Expected timeout error, but got: ${err.message} (name: ${err.name}, code: ${err.code})`);
+    }
+}
+// ============================================================================
+// Error Metadata Assertions
+// ============================================================================
+/**
+ * Asserts that an error has the expected metadata
+ */
+function assertErrorMetadata(error, expected) {
+    const awsError = error;
+    if (expected.httpStatusCode !== undefined) {
+        if (awsError.$metadata?.httpStatusCode !== expected.httpStatusCode) {
+            throw new Error(`Expected httpStatusCode ${expected.httpStatusCode}, but got ${awsError.$metadata?.httpStatusCode}`);
+        }
+    }
+    if (expected.requestId !== undefined) {
+        if (awsError.$metadata?.requestId !== expected.requestId) {
+            throw new Error(`Expected requestId ${expected.requestId}, but got ${awsError.$metadata?.requestId}`);
+        }
+    }
+    if (expected.name !== undefined) {
+        if (awsError.name !== expected.name) {
+            throw new Error(`Expected error name ${expected.name}, but got ${awsError.name}`);
+        }
+    }
+    if (expected.fault !== undefined) {
+        if (awsError.$fault !== expected.fault) {
+            throw new Error(`Expected fault ${expected.fault}, but got ${awsError.$fault}`);
+        }
+    }
+}
+/**
+ * Asserts that an error has a valid request ID
+ */
+function assertHasRequestId(error) {
+    const awsError = error;
+    if (!awsError.$metadata?.requestId) {
+        throw new Error('Expected error to have a requestId in $metadata');
+    }
+}
+/**
+ * Asserts that an error is a client fault (4xx)
+ */
+function assertIsClientFault(error) {
+    const awsError = error;
+    if (awsError.$fault !== 'client') {
+        throw new Error(`Expected client fault, but got ${awsError.$fault}`);
+    }
+}
+/**
+ * Asserts that an error is a server fault (5xx)
+ */
+function assertIsServerFault(error) {
+    const awsError = error;
+    if (awsError.$fault !== 'server') {
+        throw new Error(`Expected server fault, but got ${awsError.$fault}`);
+    }
+}
+// ============================================================================
+// Response Assertions
+// ============================================================================
+/**
+ * Asserts that a response has the expected structure
+ */
+function assertResponseStructure(response, expectedKeys) {
+    if (typeof response !== 'object' || response === null) {
+        throw new Error(`Expected object response, but got ${typeof response}`);
+    }
+    const missingKeys = expectedKeys.filter((key) => !(key in response));
+    if (missingKeys.length > 0) {
+        throw new Error(`Response missing expected keys: ${missingKeys.join(', ')}. Got keys: ${Object.keys(response).join(', ')}`);
+    }
+}
+/**
+ * Asserts that a DynamoDB response has valid metadata
+ */
+function assertDynamoDBResponseMetadata(response) {
+    const resp = response;
+    if (!resp.$metadata) {
+        throw new Error('Expected $metadata in DynamoDB response');
+    }
+    if (resp.$metadata.httpStatusCode !== 200) {
+        throw new Error(`Expected httpStatusCode 200, but got ${resp.$metadata.httpStatusCode}`);
+    }
+}
+// ============================================================================
+// Async Assertions
+// ============================================================================
+/**
+ * Asserts that an async function throws an error with the expected name
+ */
+async function assertThrowsErrorWithName(fn, expectedName) {
+    try {
+        await fn();
+        throw new Error(`Expected function to throw ${expectedName}, but it did not throw`);
+    }
+    catch (error) {
+        if (error.name !== expectedName) {
+            throw new Error(`Expected error name ${expectedName}, but got ${error.name}`);
+        }
+    }
+}
+/**
+ * Asserts that an async function throws an error matching a predicate
+ */
+async function assertThrowsErrorMatching(fn, predicate, description = 'custom predicate') {
+    try {
+        await fn();
+        throw new Error(`Expected function to throw error matching ${description}, but it did not throw`);
+    }
+    catch (error) {
+        if (!predicate(error)) {
+            throw new Error(`Error did not match ${description}: ${error.message}`);
+        }
+    }
+}
+// ============================================================================
+// Timing Assertions
+// ============================================================================
+/**
+ * Asserts that an async operation completes within a time limit
+ */
+async function assertCompletesWithin(fn, timeoutMs) {
+    const start = Date.now();
+    const result = await fn();
+    const duration = Date.now() - start;
+    if (duration > timeoutMs) {
+        throw new Error(`Expected operation to complete within ${timeoutMs}ms, but took ${duration}ms`);
+    }
+    return result;
+}
+/**
+ * Asserts that an async operation takes at least a minimum time
+ * (useful for testing retry delays)
+ */
+async function assertTakesAtLeast(fn, minMs) {
+    const start = Date.now();
+    const result = await fn();
+    const duration = Date.now() - start;
+    if (duration < minMs) {
+        throw new Error(`Expected operation to take at least ${minMs}ms, but took ${duration}ms`);
+    }
+    return result;
+}
+// ============================================================================
+// Memory Assertions
+// ============================================================================
+/**
+ * Forces garbage collection if available (requires --expose-gc flag)
+ */
+function forceGC() {
+    if (global.gc) {
+        global.gc();
+    }
+}
+/**
+ * Gets current heap memory usage in bytes
+ */
+function getHeapUsed() {
+    return process.memoryUsage().heapUsed;
+}
+/**
+ * Asserts that memory increase is within acceptable limits
+ */
+function assertMemoryIncreaseLessThan(initialMemory, maxIncreaseBytes) {
+    forceGC();
+    const currentMemory = getHeapUsed();
+    const increase = currentMemory - initialMemory;
+    if (increase > maxIncreaseBytes) {
+        const increaseMB = (increase / 1024 / 1024).toFixed(2);
+        const maxMB = (maxIncreaseBytes / 1024 / 1024).toFixed(2);
+        throw new Error(`Memory increased by ${increaseMB}MB, which exceeds limit of ${maxMB}MB`);
+    }
+}
+/**
+ * Runs a function and asserts memory usage stays within limits
+ */
+async function assertNoMemoryLeak(fn, maxIncreaseBytes = 50 * 1024 * 1024) {
+    forceGC();
+    const initialMemory = getHeapUsed();
+    const result = await fn();
+    assertMemoryIncreaseLessThan(initialMemory, maxIncreaseBytes);
+    return result;
+}
+// ============================================================================
+// Array/Collection Assertions
+// ============================================================================
+/**
+ * Asserts that an array has the expected length
+ */
+function assertArrayLength(array, expectedLength) {
+    if (array.length !== expectedLength) {
+        throw new Error(`Expected array length ${expectedLength}, but got ${array.length}`);
+    }
+}
+/**
+ * Asserts that all items in an array match a predicate
+ */
+function assertAllMatch(array, predicate, description = 'predicate') {
+    const failingIndex = array.findIndex((item) => !predicate(item));
+    if (failingIndex !== -1) {
+        throw new Error(`Item at index ${failingIndex} did not match ${description}`);
+    }
+}
+/**
+ * Asserts that an array contains unique items based on a key function
+ */
+function assertUniqueBy(array, keyFn) {
+    const seen = new Set();
+    const duplicates = [];
+    array.forEach((item) => {
+        const key = keyFn(item);
+        if (seen.has(key)) {
+            duplicates.push(key);
+        }
+        seen.add(key);
+    });
+    if (duplicates.length > 0) {
+        throw new Error(`Found duplicate keys: ${duplicates.join(', ')}`);
+    }
+}
+//# sourceMappingURL=test-assertions.js.map

package/dist/integration/utilities/test-assertions.js.map

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

package/dist/integration/utilities/test-data-builders.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Test Data Builders
+ *
+ * Provides factory functions for creating test data used across
+ * integration tests. This eliminates repetitive data creation and
+ * ensures consistent test fixtures.
+ *
+ * Usage:
+ *   import {
+ *     createTestItem,
+ *     createTestItems,
+ *     createBatchWriteRequest
+ *   } from './utilities/test-data-builders'
+ *
+ *   const item = createTestItem({ pk: 'user-1', sk: 'profile' })
+ *   const items = createTestItems(100)
+ */
+import type { AttributeValue } from '@aws-sdk/client-dynamodb';
+/**
+ * Basic DynamoDB item structure
+ */
+export interface TestItem {
+    pk: string;
+    sk: string;
+    [key: string]: unknown;
+}
+/**
+ * Options for creating test items
+ */
+export interface CreateTestItemOptions {
+    pk?: string;
+    sk?: string;
+    data?: Record<string, unknown>;
+    withTimestamp?: boolean;
+    withVersion?: number;
+}
+/**
+ * Creates a single test item
+ */
+export declare function createTestItem(options?: CreateTestItemOptions): TestItem;
+/**
+ * Creates multiple test items with sequential IDs
+ */
+export declare function createTestItems(count: number, options?: {
+    pkPrefix?: string;
+    skPrefix?: string;
+    dataGenerator?: (index: number) => Record<string, unknown>;
+    withTimestamp?: boolean;
+    withVersion?: boolean;
+}): TestItem[];
+/**
+ * Creates a marshalled DynamoDB item
+ */
+export declare function createMarshalledItem(options?: CreateTestItemOptions): Record<string, AttributeValue>;
+/**
+ * Creates multiple marshalled DynamoDB items
+ */
+export declare function createMarshalledItems(count: number, options?: Parameters<typeof createTestItems>[1]): Record<string, AttributeValue>[];
+/**
+ * Creates a DynamoDB key object
+ */
+export declare function createKey(pk: string, sk: string): Record<string, AttributeValue>;
+/**
+ * Creates multiple DynamoDB keys
+ */
+export declare function createKeys(items: Array<{
+    pk: string;
+    sk: string;
+}>): Record<string, AttributeValue>[];
+/**
+ * DynamoDB batch size limit
+ */
+export declare const DYNAMODB_BATCH_SIZE = 25;
+/**
+ * Creates a BatchWriteItem request structure for DynamoDB
+ */
+export declare function createBatchWriteRequest(tableName: string, items: TestItem[]): {
+    RequestItems: {
+        [tableName: string]: Array<{
+            PutRequest: {
+                Item: Record<string, AttributeValue>;
+            };
+        }>;
+    };
+};
+/**
+ * Creates a BatchGetItem request structure for DynamoDB
+ */
+export declare function createBatchGetRequest(tableName: string, keys: Array<{
+    pk: string;
+    sk: string;
+}>): {
+    RequestItems: {
+        [tableName: string]: {
+            Keys: Record<string, AttributeValue>[];
+        };
+    };
+};
+/**
+ * Splits items into batches of the specified size
+ */
+export declare function splitIntoBatches<T>(items: T[], batchSize?: number): T[][];
+/**
+ * Creates test content for S3 objects
+ */
+export declare function createS3Content(options?: {
+    type?: 'text' | 'json' | 'binary';
+    size?: number;
+    data?: unknown;
+}): Buffer;
+/**
+ * Creates S3 object metadata
+ */
+export declare function createS3Metadata(options?: {
+    contentType?: string;
+    customMetadata?: Record<string, string>;
+}): {
+    ContentType: string;
+    Metadata?: Record<string, string>;
+};
+/**
+ * Creates an SQS message body
+ */
+export declare function createSQSMessageBody<T = Record<string, unknown>>(data: T): string;
+/**
+ * Creates multiple SQS message entries for batch operations
+ */
+export declare function createSQSBatchEntries(messages: Array<{
+    id: string;
+    body: unknown;
+    delaySeconds?: number;
+    messageAttributes?: Record<string, {
+        DataType: string;
+        StringValue?: string;
+    }>;
+}>): Array<{
+    Id: string;
+    MessageBody: string;
+    DelaySeconds?: number;
+    MessageAttributes?: Record<string, {
+        DataType: string;
+        StringValue?: string;
+    }>;
+}>;
+/**
+ * Creates an SNS message for publishing
+ */
+export declare function createSNSMessage(options: {
+    subject?: string;
+    message: unknown;
+    messageAttributes?: Record<string, {
+        DataType: string;
+        StringValue?: string;
+    }>;
+}): {
+    Subject?: string;
+    Message: string;
+    MessageAttributes?: Record<string, {
+        DataType: string;
+        StringValue?: string;
+    }>;
+};
+/**
+ * Creates Step Functions execution input
+ */
+export declare function createSFNInput<T = Record<string, unknown>>(data: T): string;
+/**
+ * Creates a Step Functions execution name
+ */
+export declare function createSFNExecutionName(prefix?: string): string;
+/**
+ * Creates a random string of specified length
+ */
+export declare function createRandomString(length: number): string;
+/**
+ * Creates test data with nested structures
+ */
+export declare function createNestedTestData(depth: number, breadth?: number): Record<string, unknown>;
+/**
+ * Creates test data with various JavaScript types
+ */
+export declare function createMixedTypeTestData(): Record<string, unknown>;
+/**
+ * Creates large test data for performance/memory tests
+ */
+export declare function createLargeTestData(options?: {
+    itemCount?: number;
+    stringLength?: number;
+    includeNested?: boolean;
+}): Record<string, unknown>;
+/**
+ * Unmarshalls a DynamoDB item to a plain JavaScript object
+ */
+export declare function unmarshallItem<T = Record<string, unknown>>(item: Record<string, AttributeValue>): T;
+/**
+ * Unmarshalls multiple DynamoDB items
+ */
+export declare function unmarshallItems<T = Record<string, unknown>>(items: Record<string, AttributeValue>[]): T[];
+/**
+ * Re-export for convenience
+ */
+export { marshall, unmarshall } from '@aws-sdk/util-dynamodb';