@mbc-cqrs-serverless/core 1.0.26 → 1.1.0

package/dist/integration/utilities/aws-error-factory.d.ts

@@ -0,0 +1,141 @@
+/**
+ * AWS Error Factory
+ *
+ * Provides standardized factory functions for creating AWS SDK errors
+ * used in integration tests. This eliminates code duplication across
+ * test files and ensures consistent error structure.
+ *
+ * Usage:
+ *   import { createDynamoDBError, createS3Error } from './utilities/aws-error-factory'
+ *
+ *   const error = createDynamoDBError('ProvisionedThroughputExceededException', {
+ *     message: 'Rate exceeded',
+ *     httpStatusCode: 400,
+ *     throttling: true,
+ *   })
+ */
+/**
+ * Base AWS error structure used across all AWS SDK errors
+ */
+export interface AWSErrorMetadata {
+    httpStatusCode?: number;
+    requestId?: string;
+    extendedRequestId?: string;
+    cfId?: string;
+    attempts?: number;
+    totalRetryDelay?: number;
+}
+/**
+ * Extended error type that matches AWS SDK v3 error structure
+ */
+export interface AWSError extends Error {
+    name: string;
+    $metadata: AWSErrorMetadata;
+    $fault?: 'client' | 'server';
+    $retryable?: {
+        throttling?: boolean;
+    };
+    $service?: string;
+    code?: string;
+    retryAfterSeconds?: number;
+    time?: Date;
+}
+/**
+ * Options for creating AWS errors
+ */
+export interface CreateAWSErrorOptions {
+    message?: string;
+    httpStatusCode?: number;
+    requestId?: string;
+    throttling?: boolean;
+    fault?: 'client' | 'server';
+    retryAfterSeconds?: number;
+    code?: string;
+}
+/**
+ * Common DynamoDB error names
+ */
+export type DynamoDBErrorName = 'ProvisionedThroughputExceededException' | 'ResourceNotFoundException' | 'ConditionalCheckFailedException' | 'ValidationException' | 'TransactionCanceledException' | 'TransactionConflictException' | 'ItemCollectionSizeLimitExceededException' | 'RequestLimitExceeded' | 'InternalServerError' | 'ServiceUnavailable' | 'ThrottlingException' | 'AccessDeniedException';
+/**
+ * Creates a DynamoDB-specific error
+ */
+export declare function createDynamoDBError(name: DynamoDBErrorName, options?: CreateAWSErrorOptions): AWSError;
+/**
+ * Common S3 error names
+ */
+export type S3ErrorName = 'NoSuchKey' | 'NoSuchBucket' | 'BucketNotEmpty' | 'BucketAlreadyExists' | 'BucketAlreadyOwnedByYou' | 'AccessDenied' | 'InvalidAccessKeyId' | 'SignatureDoesNotMatch' | 'EntityTooLarge' | 'EntityTooSmall' | 'InvalidPart' | 'InvalidPartOrder' | 'NoSuchUpload' | 'SlowDown' | 'InternalError' | 'ServiceUnavailable';
+/**
+ * Creates an S3-specific error
+ */
+export declare function createS3Error(name: S3ErrorName, options?: CreateAWSErrorOptions): AWSError;
+/**
+ * Common SQS error names
+ */
+export type SQSErrorName = 'QueueDoesNotExist' | 'QueueDeletedRecently' | 'QueueNameExists' | 'InvalidMessageContents' | 'MessageNotInflight' | 'ReceiptHandleIsInvalid' | 'PurgeQueueInProgress' | 'BatchEntryIdsNotDistinct' | 'BatchRequestTooLong' | 'EmptyBatchRequest' | 'InvalidBatchEntryId' | 'TooManyEntriesInBatchRequest' | 'OverLimit' | 'ThrottlingException' | 'AccessDeniedException';
+/**
+ * Creates an SQS-specific error
+ */
+export declare function createSQSError(name: SQSErrorName, options?: CreateAWSErrorOptions): AWSError;
+/**
+ * Common SNS error names
+ */
+export type SNSErrorName = 'NotFoundException' | 'TopicLimitExceededException' | 'SubscriptionLimitExceededException' | 'InvalidParameterException' | 'InvalidParameterValueException' | 'EndpointDisabledException' | 'PlatformApplicationDisabledException' | 'AuthorizationErrorException' | 'ThrottledException' | 'InternalErrorException';
+/**
+ * Creates an SNS-specific error
+ */
+export declare function createSNSError(name: SNSErrorName, options?: CreateAWSErrorOptions): AWSError;
+/**
+ * Common Step Functions error names
+ */
+export type SFNErrorName = 'ExecutionDoesNotExist' | 'ExecutionAlreadyExists' | 'ExecutionLimitExceeded' | 'InvalidArn' | 'InvalidDefinition' | 'InvalidExecutionInput' | 'InvalidName' | 'InvalidToken' | 'StateMachineDoesNotExist' | 'StateMachineLimitExceeded' | 'TaskDoesNotExist' | 'TaskTimedOut' | 'ActivityDoesNotExist' | 'ActivityLimitExceeded' | 'ResourceNotFound' | 'ThrottlingException' | 'ServiceQuotaExceededException';
+/**
+ * Creates a Step Functions-specific error
+ */
+export declare function createSFNError(name: SFNErrorName, options?: CreateAWSErrorOptions): AWSError;
+/**
+ * Common SES error names
+ */
+export type SESErrorName = 'MessageRejected' | 'MailFromDomainNotVerifiedException' | 'ConfigurationSetDoesNotExistException' | 'AccountSendingPausedException' | 'LimitExceededException' | 'NotFoundException' | 'TooManyRequestsException' | 'BadRequestException';
+/**
+ * Creates an SES-specific error
+ */
+export declare function createSESError(name: SESErrorName, options?: CreateAWSErrorOptions): AWSError;
+/**
+ * Network error codes
+ */
+export type NetworkErrorCode = 'ECONNRESET' | 'ECONNREFUSED' | 'ETIMEDOUT' | 'ENETUNREACH' | 'ENOTFOUND' | 'EPIPE' | 'EAI_AGAIN';
+/**
+ * Creates a network-level error
+ */
+export declare function createNetworkError(code: NetworkErrorCode, message?: string): Error & {
+    code: string;
+};
+/**
+ * Creates a timeout error
+ */
+export declare function createTimeoutError(message?: string): Error & {
+    name: string;
+    code?: string;
+};
+/**
+ * Creates an error for a specific HTTP status code
+ */
+export declare function createHttpStatusError(statusCode: number, options?: {
+    name?: string;
+    message?: string;
+    requestId?: string;
+}): AWSError;
+/**
+ * Checks if an error is retriable based on AWS SDK v3 patterns
+ */
+export declare function isRetriableAWSError(error: AWSError): boolean;
+/**
+ * Checks if an error is a throttling error
+ */
+export declare function isThrottlingError(error: AWSError): boolean;
+/**
+ * Checks if an error is a network error
+ */
+export declare function isNetworkError(error: Error & {
+    code?: string;
+}): boolean;

package/dist/integration/utilities/aws-error-factory.js

@@ -0,0 +1,392 @@
+"use strict";
+/**
+ * AWS Error Factory
+ *
+ * Provides standardized factory functions for creating AWS SDK errors
+ * used in integration tests. This eliminates code duplication across
+ * test files and ensures consistent error structure.
+ *
+ * Usage:
+ *   import { createDynamoDBError, createS3Error } from './utilities/aws-error-factory'
+ *
+ *   const error = createDynamoDBError('ProvisionedThroughputExceededException', {
+ *     message: 'Rate exceeded',
+ *     httpStatusCode: 400,
+ *     throttling: true,
+ *   })
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDynamoDBError = createDynamoDBError;
+exports.createS3Error = createS3Error;
+exports.createSQSError = createSQSError;
+exports.createSNSError = createSNSError;
+exports.createSFNError = createSFNError;
+exports.createSESError = createSESError;
+exports.createNetworkError = createNetworkError;
+exports.createTimeoutError = createTimeoutError;
+exports.createHttpStatusError = createHttpStatusError;
+exports.isRetriableAWSError = isRetriableAWSError;
+exports.isThrottlingError = isThrottlingError;
+exports.isNetworkError = isNetworkError;
+/**
+ * Creates a base AWS error with the standard structure
+ */
+function createBaseAWSError(name, options = {}) {
+    const { message = name, httpStatusCode = 400, requestId = `test-request-${Date.now()}`, throttling, fault = httpStatusCode >= 500 ? 'server' : 'client', retryAfterSeconds, code, } = options;
+    const error = new Error(message);
+    error.name = name;
+    error.$metadata = {
+        httpStatusCode,
+        requestId,
+    };
+    error.$fault = fault;
+    if (throttling !== undefined) {
+        error.$retryable = { throttling };
+    }
+    if (retryAfterSeconds !== undefined) {
+        error.retryAfterSeconds = retryAfterSeconds;
+    }
+    if (code !== undefined) {
+        error.code = code;
+    }
+    return error;
+}
+/**
+ * Creates a DynamoDB-specific error
+ */
+function createDynamoDBError(name, options = {}) {
+    const defaultOptions = {};
+    // Set default properties based on error type
+    switch (name) {
+        case 'ProvisionedThroughputExceededException':
+        case 'ThrottlingException':
+        case 'RequestLimitExceeded':
+            defaultOptions.throttling = true;
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'InternalServerError':
+            defaultOptions.httpStatusCode = 500;
+            defaultOptions.fault = 'server';
+            break;
+        case 'ServiceUnavailable':
+            defaultOptions.httpStatusCode = 503;
+            defaultOptions.fault = 'server';
+            break;
+        case 'ValidationException':
+        case 'ConditionalCheckFailedException':
+        case 'ResourceNotFoundException':
+            defaultOptions.httpStatusCode = 400;
+            defaultOptions.fault = 'client';
+            break;
+        case 'TransactionCanceledException':
+        case 'TransactionConflictException':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'ItemCollectionSizeLimitExceededException':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'AccessDeniedException':
+            defaultOptions.httpStatusCode = 403;
+            break;
+    }
+    const error = createBaseAWSError(name, { ...defaultOptions, ...options });
+    error.$service = 'DynamoDB';
+    return error;
+}
+/**
+ * Creates an S3-specific error
+ */
+function createS3Error(name, options = {}) {
+    const defaultOptions = {};
+    switch (name) {
+        case 'NoSuchKey':
+        case 'NoSuchBucket':
+        case 'NoSuchUpload':
+            defaultOptions.httpStatusCode = 404;
+            break;
+        case 'AccessDenied':
+        case 'InvalidAccessKeyId':
+        case 'SignatureDoesNotMatch':
+            defaultOptions.httpStatusCode = 403;
+            break;
+        case 'EntityTooLarge':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'SlowDown':
+            defaultOptions.httpStatusCode = 503;
+            defaultOptions.throttling = true;
+            break;
+        case 'InternalError':
+            defaultOptions.httpStatusCode = 500;
+            defaultOptions.fault = 'server';
+            break;
+        case 'ServiceUnavailable':
+            defaultOptions.httpStatusCode = 503;
+            defaultOptions.fault = 'server';
+            break;
+        case 'BucketNotEmpty':
+        case 'BucketAlreadyExists':
+        case 'BucketAlreadyOwnedByYou':
+            defaultOptions.httpStatusCode = 409;
+            break;
+    }
+    const error = createBaseAWSError(name, { ...defaultOptions, ...options });
+    error.$service = 'S3';
+    return error;
+}
+/**
+ * Creates an SQS-specific error
+ */
+function createSQSError(name, options = {}) {
+    const defaultOptions = {};
+    switch (name) {
+        case 'QueueDoesNotExist':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'ThrottlingException':
+        case 'OverLimit':
+            defaultOptions.throttling = true;
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'AccessDeniedException':
+            defaultOptions.httpStatusCode = 403;
+            break;
+        case 'InvalidMessageContents':
+        case 'BatchEntryIdsNotDistinct':
+        case 'BatchRequestTooLong':
+        case 'EmptyBatchRequest':
+        case 'InvalidBatchEntryId':
+        case 'TooManyEntriesInBatchRequest':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'MessageNotInflight':
+        case 'ReceiptHandleIsInvalid':
+            defaultOptions.httpStatusCode = 400;
+            break;
+    }
+    const error = createBaseAWSError(name, { ...defaultOptions, ...options });
+    error.$service = 'SQS';
+    return error;
+}
+/**
+ * Creates an SNS-specific error
+ */
+function createSNSError(name, options = {}) {
+    const defaultOptions = {};
+    switch (name) {
+        case 'NotFoundException':
+            defaultOptions.httpStatusCode = 404;
+            break;
+        case 'TopicLimitExceededException':
+        case 'SubscriptionLimitExceededException':
+        case 'ThrottledException':
+            defaultOptions.throttling = true;
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'AuthorizationErrorException':
+            defaultOptions.httpStatusCode = 403;
+            break;
+        case 'InternalErrorException':
+            defaultOptions.httpStatusCode = 500;
+            defaultOptions.fault = 'server';
+            break;
+        case 'InvalidParameterException':
+        case 'InvalidParameterValueException':
+            defaultOptions.httpStatusCode = 400;
+            break;
+    }
+    const error = createBaseAWSError(name, { ...defaultOptions, ...options });
+    error.$service = 'SNS';
+    return error;
+}
+/**
+ * Creates a Step Functions-specific error
+ */
+function createSFNError(name, options = {}) {
+    const defaultOptions = {};
+    switch (name) {
+        case 'ExecutionDoesNotExist':
+        case 'StateMachineDoesNotExist':
+        case 'TaskDoesNotExist':
+        case 'ActivityDoesNotExist':
+        case 'ResourceNotFound':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'ExecutionAlreadyExists':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'ThrottlingException':
+        case 'ExecutionLimitExceeded':
+        case 'StateMachineLimitExceeded':
+        case 'ActivityLimitExceeded':
+        case 'ServiceQuotaExceededException':
+            defaultOptions.throttling = true;
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'InvalidArn':
+        case 'InvalidDefinition':
+        case 'InvalidExecutionInput':
+        case 'InvalidName':
+        case 'InvalidToken':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'TaskTimedOut':
+            defaultOptions.httpStatusCode = 400;
+            break;
+    }
+    const error = createBaseAWSError(name, { ...defaultOptions, ...options });
+    error.$service = 'StepFunctions';
+    return error;
+}
+/**
+ * Creates an SES-specific error
+ */
+function createSESError(name, options = {}) {
+    const defaultOptions = {};
+    switch (name) {
+        case 'MessageRejected':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'MailFromDomainNotVerifiedException':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'ConfigurationSetDoesNotExistException':
+        case 'NotFoundException':
+            defaultOptions.httpStatusCode = 404;
+            break;
+        case 'AccountSendingPausedException':
+            defaultOptions.httpStatusCode = 400;
+            break;
+        case 'LimitExceededException':
+        case 'TooManyRequestsException':
+            defaultOptions.throttling = true;
+            defaultOptions.httpStatusCode = 429;
+            break;
+        case 'BadRequestException':
+            defaultOptions.httpStatusCode = 400;
+            break;
+    }
+    const error = createBaseAWSError(name, { ...defaultOptions, ...options });
+    error.$service = 'SES';
+    return error;
+}
+/**
+ * Creates a network-level error
+ */
+function createNetworkError(code, message) {
+    const defaultMessages = {
+        ECONNRESET: 'read ECONNRESET',
+        ECONNREFUSED: 'connect ECONNREFUSED',
+        ETIMEDOUT: 'connect ETIMEDOUT',
+        ENETUNREACH: 'network unreachable',
+        ENOTFOUND: 'getaddrinfo ENOTFOUND',
+        EPIPE: 'write EPIPE',
+        EAI_AGAIN: 'getaddrinfo EAI_AGAIN',
+    };
+    const error = new Error(message || defaultMessages[code]);
+    error.code = code;
+    return error;
+}
+/**
+ * Creates a timeout error
+ */
+function createTimeoutError(message = 'Request timeout') {
+    const error = new Error(message);
+    error.name = 'TimeoutError';
+    error.code = 'ETIMEDOUT';
+    return error;
+}
+// ============================================================================
+// Generic HTTP Status Errors
+// ============================================================================
+/**
+ * Creates an error for a specific HTTP status code
+ */
+function createHttpStatusError(statusCode, options = {}) {
+    const statusMessages = {
+        400: 'Bad Request',
+        401: 'Unauthorized',
+        403: 'Forbidden',
+        404: 'Not Found',
+        408: 'Request Timeout',
+        429: 'Too Many Requests',
+        500: 'Internal Server Error',
+        502: 'Bad Gateway',
+        503: 'Service Unavailable',
+        504: 'Gateway Timeout',
+    };
+    const name = options.name || statusMessages[statusCode] || 'UnknownError';
+    const message = options.message || statusMessages[statusCode] || 'Error';
+    return createBaseAWSError(name, {
+        message,
+        httpStatusCode: statusCode,
+        requestId: options.requestId,
+        fault: statusCode >= 500 ? 'server' : 'client',
+        throttling: statusCode === 429,
+    });
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Checks if an error is retriable based on AWS SDK v3 patterns
+ */
+function isRetriableAWSError(error) {
+    // Check $retryable flag
+    if (error.$retryable) {
+        return true;
+    }
+    // Check HTTP status codes
+    const statusCode = error.$metadata?.httpStatusCode;
+    if (statusCode) {
+        // 5xx errors are retriable
+        if (statusCode >= 500 && statusCode < 600) {
+            return true;
+        }
+        // 429 Too Many Requests
+        if (statusCode === 429) {
+            return true;
+        }
+    }
+    // Check error names
+    const retriableErrorNames = [
+        'ProvisionedThroughputExceededException',
+        'ThrottlingException',
+        'InternalServerError',
+        'ServiceUnavailable',
+        'RequestLimitExceeded',
+        'SlowDown',
+        'TooManyRequestsException',
+    ];
+    return retriableErrorNames.includes(error.name);
+}
+/**
+ * Checks if an error is a throttling error
+ */
+function isThrottlingError(error) {
+    return error.$retryable?.throttling === true;
+}
+/**
+ * Checks if an error is a network error
+ */
+function isNetworkError(error) {
+    const networkErrorCodes = [
+        'ECONNRESET',
+        'ECONNREFUSED',
+        'ETIMEDOUT',
+        'ENETUNREACH',
+        'ENOTFOUND',
+        'EPIPE',
+        'EAI_AGAIN',
+    ];
+    if (error.code &&
+        networkErrorCodes.includes(error.code)) {
+        return true;
+    }
+    const message = error.message.toLowerCase();
+    return (message.includes('socket hang up') ||
+        message.includes('network error') ||
+        message.includes('connection reset') ||
+        message.includes('connection refused'));
+}
+//# sourceMappingURL=aws-error-factory.js.map

package/dist/integration/utilities/aws-error-factory.js.map

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

package/dist/integration/utilities/aws-mock-manager.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 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())
+ */
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { S3Client } from '@aws-sdk/client-s3';
+import { SESv2Client } from '@aws-sdk/client-sesv2';
+import { SFNClient } from '@aws-sdk/client-sfn';
+import { SNSClient } from '@aws-sdk/client-sns';
+import { SQSClient } from '@aws-sdk/client-sqs';
+import { AwsClientStub } from 'aws-sdk-client-mock';
+/**
+ * Configuration options for mock clients
+ */
+export interface MockClientOptions {
+    region?: string;
+    maxAttempts?: number;
+    retryMode?: 'standard' | 'adaptive';
+}
+/**
+ * Result from creating a mock client
+ */
+export interface MockClientResult<TClient> {
+    /** The mock client stub for configuring responses */
+    mock: AwsClientStub<TClient>;
+    /** The actual client instance configured with the mock */
+    client: TClient;
+    /** Reset the mock to clear all configured behaviors */
+    reset: () => void;
+    /** Restore the mock and destroy the client */
+    restore: () => void;
+}
+/**
+ * Creates a mocked DynamoDB client
+ */
+export declare function createDynamoDBMock(options?: MockClientOptions): MockClientResult<DynamoDBClient>;
+/**
+ * Creates a mocked S3 client
+ */
+export declare function createS3Mock(options?: MockClientOptions): MockClientResult<S3Client>;
+/**
+ * Creates a mocked SQS client
+ */
+export declare function createSQSMock(options?: MockClientOptions): MockClientResult<SQSClient>;
+/**
+ * Creates a mocked SNS client
+ */
+export declare function createSNSMock(options?: MockClientOptions): MockClientResult<SNSClient>;
+/**
+ * Creates a mocked Step Functions client
+ */
+export declare function createSFNMock(options?: MockClientOptions): MockClientResult<SFNClient>;
+/**
+ * Creates a mocked SES v2 client
+ */
+export declare function createSESMock(options?: MockClientOptions): MockClientResult<SESv2Client>;
+/**
+ * Manages multiple AWS mock clients for test suites
+ */
+export declare class AWSMockManager {
+    private dynamoDB?;
+    private s3?;
+    private sqs?;
+    private sns?;
+    private sfn?;
+    private ses?;
+    private options;
+    constructor(options?: MockClientOptions);
+    /**
+     * Gets or creates the DynamoDB mock
+     */
+    getDynamoDB(): MockClientResult<DynamoDBClient>;
+    /**
+     * Gets or creates the S3 mock
+     */
+    getS3(): MockClientResult<S3Client>;
+    /**
+     * Gets or creates the SQS mock
+     */
+    getSQS(): MockClientResult<SQSClient>;
+    /**
+     * Gets or creates the SNS mock
+     */
+    getSNS(): MockClientResult<SNSClient>;
+    /**
+     * Gets or creates the Step Functions mock
+     */
+    getSFN(): MockClientResult<SFNClient>;
+    /**
+     * Gets or creates the SES mock
+     */
+    getSES(): MockClientResult<SESv2Client>;
+    /**
+     * Resets all active mocks
+     */
+    resetAll(): void;
+    /**
+     * Restores all mocks and destroys clients
+     */
+    restoreAll(): void;
+}
+/**
+ * Creates a standard test setup with beforeEach/afterAll hooks
+ * for use with Jest describe blocks
+ */
+export declare function setupAWSMocks(services: Array<'dynamodb' | 's3' | 'sqs' | 'sns' | 'sfn' | 'ses'>, options?: MockClientOptions): {
+    manager: AWSMockManager;
+    beforeEachHook: () => void;
+    afterAllHook: () => void;
+};
+/**
+ * Quick setup function that returns individual mocks for common patterns
+ */
+export declare function createTestMocks<T extends Array<'dynamodb' | 's3' | 'sqs' | 'sns' | 'sfn' | 'ses'>>(services: T, options?: MockClientOptions): {
+    [K in T[number]]: K extends 'dynamodb' ? MockClientResult<DynamoDBClient> : K extends 's3' ? MockClientResult<S3Client> : K extends 'sqs' ? MockClientResult<SQSClient> : K extends 'sns' ? MockClientResult<SNSClient> : K extends 'sfn' ? MockClientResult<SFNClient> : K extends 'ses' ? MockClientResult<SESv2Client> : never;
+} & {
+    resetAll: () => void;
+    restoreAll: () => void;
+};