@lambda-kata/cdk 0.1.4 → 0.1.6

package/out/tsc/src/mock-licensing.d.ts

@@ -1,218 +0,0 @@
-/**
- * Mock Licensing Service for Lambda Kata CDK Integration Testing
- *
- * This module provides a mock implementation of the LicensingService interface
- * for testing the kata() wrapper without making real network calls.
- *
- * @module mock-licensing
- */
-import { LicensingService, LicenseCheckParams } from './licensing';
-import { LicensingResponse } from './types';
-/**
- * Mock implementation of the LicensingService interface for testing.
- *
- * This class allows programmatic control over entitlement status,
- * enabling comprehensive testing of the kata() wrapper behavior
- * for both entitled and non-entitled accounts.
- *
- * @example
- * ```typescript
- * const mockService = new MockLicensingService();
- *
- * // Set up an entitled account
- * mockService.setEntitled('123456789012', 'arn:aws:lambda:us-east-1:999999999999:layer:LambdaKata:1');
- *
- * // Check entitlement
- * const response = await mockService.checkEntitlement('123456789012');
- * console.log(response.entitled); // true
- * console.log(response.layerArn); // 'arn:aws:lambda:us-east-1:999999999999:layer:LambdaKata:1'
- *
- * // Non-entitled account
- * const response2 = await mockService.checkEntitlement('000000000000');
- * console.log(response2.entitled); // false
- * ```
- *
- * @remarks
- * Validates: Requirements 3.2, 3.3
- * - 3.2: Provides mock validation of account entitlements
- * - 3.3: Returns customer-specific Layer_ARN for entitled accounts
- */
-export declare class MockLicensingService implements LicensingService {
-    /**
-     * Map of AWS account IDs to their entitled Layer ARNs.
-     * Accounts not in this map are considered non-entitled.
-     */
-    private entitlements;
-    /**
-     * Map of AWS account IDs to custom messages (for non-entitled accounts).
-     */
-    private customMessages;
-    /**
-     * Optional custom message to return for entitled accounts.
-     */
-    private entitledMessage;
-    /**
-     * Optional custom message to return for non-entitled accounts.
-     * Default matches the expected warning message from Requirement 6.4.
-     */
-    private notEntitledMessage;
-    /**
-     * Optional expiration date for entitlements.
-     */
-    private expiresAt?;
-    /**
-     * Flag to simulate service unavailability.
-     */
-    private simulateServiceError;
-    /**
-     * Custom error message when simulating service errors.
-     */
-    private serviceErrorMessage;
-    /**
-     * Flag to simulate entitled response without layerArn (service issue).
-     */
-    private simulateEntitledWithoutLayerArn;
-    /**
-     * Sets an account as entitled with a specific Layer ARN.
-     *
-     * @param accountId - The AWS account ID (12-digit string)
-     * @param layerArn - The customer-specific Lambda Layer ARN
-     *
-     * @example
-     * ```typescript
-     * mockService.setEntitled('123456789012', 'arn:aws:lambda:us-east-1:999999999999:layer:LambdaKata:1');
-     * ```
-     */
-    setEntitled(accountId: string, layerArn: string): void;
-    /**
-     * Removes entitlement for an account.
-     *
-     * @param accountId - The AWS account ID to remove entitlement for
-     *
-     * @example
-     * ```typescript
-     * mockService.removeEntitlement('123456789012');
-     * ```
-     */
-    removeEntitlement(accountId: string): void;
-    /**
-     * Clears all entitlements.
-     *
-     * @example
-     * ```typescript
-     * mockService.clearEntitlements();
-     * ```
-     */
-    clearEntitlements(): void;
-    /**
-     * Sets a custom message for entitled accounts.
-     *
-     * @param message - The message to return for entitled accounts
-     */
-    setEntitledMessage(message: string): void;
-    /**
-     * Sets a custom message for non-entitled accounts.
-     *
-     * @param message - The message to return for non-entitled accounts
-     */
-    setNotEntitledMessage(message: string): void;
-    /**
-     * Sets a custom message for a specific non-entitled account.
-     * This allows testing per-account custom error messages from the licensing service.
-     *
-     * @param accountId - The AWS account ID
-     * @param message - The custom message to return for this account
-     *
-     * @example
-     * ```typescript
-     * mockService.setCustomMessage('123456789012', 'Custom licensing error: Account suspended');
-     * ```
-     */
-    setCustomMessage(accountId: string, message: string): void;
-    /**
-     * Sets the expiration date for entitlements.
-     *
-     * @param expiresAt - ISO 8601 formatted expiration date
-     */
-    setExpiresAt(expiresAt: string): void;
-    /**
-     * Configures the mock to simulate service unavailability.
-     *
-     * @param simulate - Whether to simulate service errors
-     * @param errorMessage - Optional custom error message
-     *
-     * @example
-     * ```typescript
-     * // Simulate service being down
-     * mockService.setSimulateServiceError(true);
-     *
-     * // With custom error message
-     * mockService.setSimulateServiceError(true, 'Connection refused');
-     * ```
-     */
-    setSimulateServiceError(simulate: boolean, errorMessage?: string): void;
-    /**
-     * Configures the mock to simulate entitled response without layerArn.
-     * This simulates a licensing service issue where the account is entitled
-     * but the service fails to return the layer ARN.
-     *
-     * @param simulate - Whether to simulate entitled without layerArn
-     *
-     * @example
-     * ```typescript
-     * // Simulate service returning entitled: true but no layerArn
-     * mockService.setSimulateEntitledWithoutLayerArn(true);
-     * ```
-     */
-    setSimulateEntitledWithoutLayerArn(simulate: boolean): void;
-    /**
-     * Check if an AWS account is entitled to use Lambda Kata.
-     *
-     * This mock implementation returns entitlement status based on
-     * accounts configured via setEntitled().
-     *
-     * @param params - License check parameters or accountId string for backward compatibility
-     * @returns Promise resolving to entitlement status and Layer ARN if entitled
-     *
-     * @remarks
-     * Validates: Requirements 3.2, 3.3
-     * - 3.2: Validates the account's entitlement based on configured entitlements
-     * - 3.3: Returns the customer-specific Layer_ARN if entitled
-     */
-    checkEntitlement(params: LicenseCheckParams | string): Promise<LicensingResponse>;
-    /**
-     * Returns the number of entitled accounts.
-     *
-     * @returns The count of entitled accounts
-     */
-    getEntitlementCount(): number;
-    /**
-     * Checks if a specific account is entitled (without async).
-     *
-     * @param accountId - The AWS account ID to check
-     * @returns true if the account is entitled
-     */
-    isEntitled(accountId: string): boolean;
-    /**
-     * Gets the Layer ARN for an entitled account (without async).
-     *
-     * @param accountId - The AWS account ID
-     * @returns The Layer ARN if entitled, undefined otherwise
-     */
-    getLayerArn(accountId: string): string | undefined;
-}
-/**
- * Creates a MockLicensingService with pre-configured entitlements.
- *
- * @param entitlements - Map of account IDs to Layer ARNs
- * @returns A new MockLicensingService instance with the specified entitlements
- *
- * @example
- * ```typescript
- * const mockService = createMockLicensingService({
- *   '123456789012': 'arn:aws:lambda:us-east-1:999999999999:layer:LambdaKata:1',
- *   '987654321098': 'arn:aws:lambda:us-west-2:999999999999:layer:LambdaKata:2',
- * });
- * ```
- */
-export declare function createMockLicensingService(entitlements?: Record<string, string>): MockLicensingService;