@incloodsolutions/devkit 0.0.2 → 0.0.4

package/dist/index.d.ts

@@ -1,755 +1,34 @@
-import { Construct } from 'constructs';
-import { Function, FunctionProps, LayerVersion, ILayerVersion, LayerVersionProps, Runtime, EventSourceMappingProps } from 'aws-cdk-lib/aws-lambda';
-import { HttpMethod, HttpApi, HttpApiProps, AddRoutesOptions, WebSocketApi, WebSocketApiProps, WebSocketStageProps, WebSocketRouteOptions } from 'aws-cdk-lib/aws-apigatewayv2';
-import { RestApi, RestApiProps, TokenAuthorizer, TokenAuthorizerProps } from 'aws-cdk-lib/aws-apigateway';
-import { IBaseEnableDebug, ObjectType, AppEnvironmentType } from '@incloodsolutions/toolkit';
-import { Distribution, DistributionProps, BehaviorOptions } from 'aws-cdk-lib/aws-cloudfront';
-import { LogGroup, LogGroupProps } from 'aws-cdk-lib/aws-logs';
-import { Table, ITable, TableProps, TableAttributes, GlobalSecondaryIndexProps, LocalSecondaryIndexProps } from 'aws-cdk-lib/aws-dynamodb';
-import { Rule, RuleProps } from 'aws-cdk-lib/aws-events';
-import { HttpLambdaAuthorizer, HttpLambdaAuthorizerProps } from 'aws-cdk-lib/aws-apigatewayv2-authorizers';
-import { Role, RoleProps, PolicyStatementProps } from 'aws-cdk-lib/aws-iam';
-import { Bucket, BucketProps } from 'aws-cdk-lib/aws-s3';
-import { BucketDeployment, BucketDeploymentProps } from 'aws-cdk-lib/aws-s3-deployment';
-import { Topic, TopicProps } from 'aws-cdk-lib/aws-sns';
-import { Queue, QueueProps } from 'aws-cdk-lib/aws-sqs';
-import { Vpc, VpcProps } from 'aws-cdk-lib/aws-ec2';
-
-/** Base interface that enables debugging features */
-interface IBaseConstruct extends IBaseEnableDebug {
-}
-/** Base interface for CDK construct configuration */
-interface IBaseCdkConstructProps<TOptions extends ObjectType = any> extends Readonly<Partial<IBaseEnableDebug>> {
-    /** Deployment stage/environment */
-    readonly stage?: AppEnvironmentType;
-    /** Additional construct options */
-    readonly options?: TOptions;
-    /** Optional stack name */
-    readonly stackName?: string;
-    /** Optional application name */
-    readonly appName?: string;
-}
-
-/**
- * Route definition for API Gateway resources
- *
- * Supports hierarchical route structures using `children`
- */
-interface IRouteOption {
-    /** Path segment (e.g. 'users', 'orders') */
-    name: string;
-    /** HTTP method for the route */
-    method: `${HttpMethod}`;
-    /** Nested routes under this path */
-    children?: IRouteOption[];
-}
-/**
- * Props for BaseApiGatewayConstruct
- *
- * Provides configuration for:
- * - REST API (API Gateway v1)
- * - Route definitions
- * - Lambda handler
- */
-interface IApiGatewayConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** REST API configuration options */
-    readonly gatewayOptions: RestApiProps;
-    /** Route definitions used to build API resources */
-    readonly routeOptions: IRouteOption[];
-}>, 'appName' | 'stage' | 'stackName'> {
-    /**
-     * Lambda function handling all API routes
-     *
-     * Note:
-     * A single Lambda integration is reused across all routes
-     */
-    readonly handlerFunction: Function;
-}
-/**
- * CDK construct for REST API Gateway with Lambda integration
- *
- * Responsibilities:
- * - Creates a REST API with configurable options
- * - Applies default CORS and compression settings when not provided
- * - Recursively builds API resources from route definitions
- * - Exposes API base URL as a CloudFormation output
- */
-declare class BaseApiGatewayConstruct extends Construct implements IBaseConstruct {
-    /** The created REST API instance */
-    readonly api: RestApi;
-    /** Enables debug logging for route creation */
-    enableDebug: boolean;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for API, routes, and Lambda handler
-     */
-    constructor(scope: Construct, id: string, props: IApiGatewayConstructProps);
-    /**
-     * Recursively attaches routes to the API Gateway
-     *
-     * Behaviour:
-     * - Creates a resource for each route segment
-     * - Attaches method + Lambda integration
-     * - Traverses child routes for nested paths
-     *
-     * @param parent Parent API resource
-     * @param routes Route definitions
-     * @param integration Lambda integration applied to each route
-     * @param previousPath Accumulated path (used for debug logging)
-     * @private
-     */
-    private addRoutes;
-}
-
-/**
- * Properties for configuring the API Gateway v2 construct
- *
- * Extends base CDK construct props and provides configuration for:
- * - HTTP API (Api Gateway v2)
- * - Route definitions
- * - Lambda handlers
- */
-interface IApiGatewayV2ConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** HTTP API configuration options */
-    readonly gatewayOptions: HttpApiProps;
-    /** Route definitions passed directly to `addRoutes` */
-    readonly routeOptions: Partial<AddRoutesOptions>[];
-}>, 'appName' | 'stage' | 'stackName'> {
-    /**
-     * Lambda functions used as route handlers
-     *
-     * Note:
-     * Each handler is paired with each route during route creation
-     */
-    readonly handlerFunctions: Function[];
-}
-/**
- * CDK construct for creating an API Gateway v2 (HTTP API)
- *
- * Responsibilities:
- * - Creates an HTTP API with optional custom configuration
- * - Applies default CORS configuration when not provided
- * - Attaches routes with Lambda integrations
- * - Exposes API URL as a CloudFormation output
- *
- * Behaviour:
- * - Each route is registered for every provided handler function
- * - Throws if no handler functions are supplied
- */
-declare class BaseApiGatewayV2Construct extends Construct implements IBaseConstruct {
-    /** The created HTTP API instance */
-    readonly api: HttpApi;
-    /** Enables debug logging (if used externally) */
-    enableDebug: boolean;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for API, routes, and handlers
-     */
-    constructor(scope: Construct, id: string, props: IApiGatewayV2ConstructProps);
-}
-
-/**
- * Props for BaseApiGatewayWebSocketConstruct
- *
- * Provides configuration for:
- * - WebSocket API (API Gateway v2)
- * - WebSocket stage
- * - Route handlers for lifecycle events
- */
-interface IApiGatewayWebsocketConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** WebSocket API configuration options */
-    readonly webSocketApiOptions: WebSocketApiProps;
-    /** WebSocket stage configuration options */
-    readonly webSocketStageOptions: WebSocketStageProps;
-}>, 'appName' | 'stage' | 'stackName'> {
-    /**
-     * Lambda handlers mapped to WebSocket lifecycle routes
-     *
-     * Includes:
-     * - $connect
-     * - $disconnect
-     * - $default
-     * - custom message route
-     */
-    readonly handlers: {
-        /** Handler for connection establishment ($connect) */
-        readonly connect: {
-            option: WebSocketRouteOptions;
-            function: Function;
-        };
-        /** Handler for unmatched routes ($default) */
-        readonly default: {
-            option: WebSocketRouteOptions;
-            function: Function;
-        };
-        /** Handler for custom message route (e.g. 'notifications') */
-        readonly message: {
-            option: WebSocketRouteOptions;
-            function: Function;
-        };
-        /** Handler for disconnection events ($disconnect) */
-        readonly disconnect: {
-            option: WebSocketRouteOptions;
-            function: Function;
-        };
-    };
-}
-/**
- * CDK construct for WebSocket API Gateway
- *
- * Responsibilities:
- * - Creates a WebSocket API with lifecycle route integrations
- * - Registers a custom message route
- * - Deploys a stage with auto-deploy enabled
- * - Exposes WebSocket endpoint URL as a CloudFormation output
- */
-declare class BaseApiGatewayWebSocketConstruct extends Construct {
-    /** The created WebSocket API instance */
-    readonly socketApi: WebSocketApi;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for API, stage, and route handlers
-     */
-    constructor(scope: Construct, id: string, props: IApiGatewayWebsocketConstructProps);
-}
-
-/**
- * Props for BaseCloudfrontConstruct
- *
- * Provides configuration for creating a CloudFront distribution
- * with optional overrides for default behaviour and error handling.
- */
-interface ICloudfrontConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** Partial configuration for the CloudFront distribution */
-    readonly cloudfrontOptions: Partial<DistributionProps>;
-}>, 'appName' | 'stage' | 'stackName'> {
-}
-/**
- * CDK construct for CloudFront distribution
- *
- * Responsibilities:
- * - Creates a CloudFront distribution with configurable options
- * - Enforces HTTPS redirection by default
- * - Adds fallback error responses for SPA routing (400, 403, 404 → index.html)
- */
-declare class BaseCloudfrontConstruct extends Construct {
-    /** The created CloudFront distribution instance */
-    readonly distribution: Distribution;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for CloudFront distribution
-     */
-    constructor(scope: Construct, id: string, props: ICloudfrontConstructProps);
-}
-
-/**
- * Props for BaseCloudwatchLogGroupConstruct
- *
- * Provides configuration for creating a CloudWatch Log Group
- * with optional overrides for retention and removal policy.
- */
-interface ILogGroupConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** Log Group configuration options */
-    readonly logGroupOptions: LogGroupProps;
-}>, 'appName' | 'stage' | 'stackName'> {
-}
-/**
- * CDK construct for CloudWatch Log Group
- *
- * Responsibilities:
- * - Creates a log group with configurable options
- * - Applies default removal policy and retention if not provided
- * - Exposes the log group ARN as a CloudFormation output
- */
-declare class BaseCloudwatchLogGroupConstruct extends Construct {
-    /** The created CloudWatch Log Group instance */
-    readonly logGroup: LogGroup;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for the log group
-     */
-    constructor(scope: Construct, id: string, props: ILogGroupConstructProps);
-}
-
-/**
- * Props for BaseDynamoDBConstruct
- *
- * Provides configuration for:
- * - Creating a new DynamoDB table
- * - Importing an existing table (by name, ARN, or attributes)
- * - Defining Global Secondary Indexes (GSI) and Local Secondary Indexes (LSI)
- */
-interface IDynamoDBConstructProps$1 extends Omit<IBaseCdkConstructProps<{
-    /** Configuration for creating a new table */
-    readonly tableOptions?: TableProps;
-    /** Import an existing table by ARN */
-    readonly fromExistingTableArn?: string;
-    /** Import an existing table by name */
-    readonly fromExistingTableName?: string;
-    /** Import an existing table using attributes */
-    readonly fromExistingTableAttributes?: TableAttributes;
-    /** Global Secondary Index definitions */
-    readonly globalSecondaryIndexes?: GlobalSecondaryIndexProps[];
-    /** Local Secondary Index definitions */
-    readonly localSecondaryIndexes?: LocalSecondaryIndexProps[];
-}>, 'appName' | 'stackName'> {
-}
-/**
- * CDK construct for DynamoDB table management
- *
- * Responsibilities:
- * - Creates a new DynamoDB table or imports an existing one
- * - Applies default billing mode and deletion protection
- * - Attaches optional GSIs and LSIs
- * - Exposes table ARN as a CloudFormation output
- */
-declare class BaseDynamoDBConstruct extends Construct implements IBaseConstruct {
-    /** Newly created DynamoDB table (null if importing existing table) */
-    readonly table: Table;
-    /** Imported DynamoDB table reference (null if creating new table) */
-    readonly existingTable: ITable;
-    /** Enables debug logging */
-    enableDebug: boolean;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for table creation or import
-     */
-    constructor(scope: Construct, id: string, props: IDynamoDBConstructProps$1);
-}
-
-/**
- * Props for BaseEventBridgeConstruct
- *
- * Provides configuration for:
- * - EventBridge rule creation
- * - Target Lambda functions
- */
-interface IEventBridgeConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** Lambda functions to be triggered by the rule */
-    readonly targetFunctions: Function[];
-    /** EventBridge rule configuration */
-    readonly eventBridgeOptions: RuleProps;
-}>, 'appName' | 'stage' | 'stackName'> {
-}
-/**
- * CDK construct for EventBridge rule
- *
- * Responsibilities:
- * - Creates an EventBridge rule with configurable options
- * - Attaches one or more Lambda targets
- * - Applies a removal policy
- * - Exposes the rule ARN as a CloudFormation output
- */
-declare class BaseEventBridgeConstruct extends Construct {
-    /** The created EventBridge rule instance */
-    readonly eventSchedule: Rule;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for rule and target functions
-     */
-    constructor(scope: Construct, id: string, props: IEventBridgeConstructProps);
-}
-
-/**
- * Props for BaseLambdaAuthoriserConstruct
- *
- * Provides configuration for:
- * - Lambda token authorizer
- * - Authorizer behaviour and settings
- */
-interface ILambdaAuthoriserConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** Token authorizer configuration options */
-    readonly authorizerOptions: TokenAuthorizerProps;
-}>, 'appName' | 'stage' | 'stackName'> {
-    /**
-     * Lambda function used as the authorizer handler
-     *
-     * This function is invoked to validate incoming requests
-     */
-    readonly handlerFunction: Function;
-}
-/**
- * CDK construct for Lambda Token Authorizer (API Gateway v1)
- *
- * Responsibilities:
- * - Creates a Token Authorizer backed by a Lambda function
- * - Applies optional configuration overrides
- * - Exposes the authorizer ARN as a CloudFormation output
- */
-declare class BaseLambdaAuthoriserConstruct extends Construct {
-    /** The created Token Authorizer instance */
-    readonly authoriser: TokenAuthorizer;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for authorizer and handler function
-     */
-    constructor(scope: Construct, id: string, props: ILambdaAuthoriserConstructProps);
-}
-
-/**
- * Props for BaseLambdaAuthoriserV2Construct
- *
- * Provides configuration for:
- * - HTTP API Lambda authorizer (API Gateway v2)
- * - Authorizer behaviour and identity sources
- */
-interface ILambdaAuthoriserV2ConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** HTTP Lambda authorizer configuration options */
-    readonly authorizerOptions: HttpLambdaAuthorizerProps;
-}>, 'appName' | 'stage' | 'stackName'> {
-    /**
-     * Lambda function used as the authorizer handler
-     *
-     * This function is invoked to validate incoming HTTP requests
-     */
-    readonly handlerFunction: Function;
-}
-/**
- * CDK construct for Lambda Authorizer (API Gateway v2 - HTTP API)
- *
- * Responsibilities:
- * - Creates an HTTP Lambda authorizer
- * - Applies default identity sources (Cookie and Authorization headers)
- * - Supports multiple response types (IAM and SIMPLE by default)
- * - Exposes the authorizer ID as a CloudFormation output
- */
-declare class BaseLambdaAuthoriserV2Construct extends Construct {
-    /** The created HTTP Lambda Authorizer instance */
-    readonly authoriser: HttpLambdaAuthorizer;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for authorizer and handler function
-     */
-    constructor(scope: Construct, id: string, props: ILambdaAuthoriserV2ConstructProps);
-}
-
-/**
- * Props for BaseLambdaConstruct
- *
- * Provides configuration for creating a Lambda function
- * with optional overrides for runtime, memory, timeout, and environment.
- */
-interface ILambdaConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** Partial Lambda configuration options */
-    readonly lambdaOptions: Partial<FunctionProps>;
-}>, 'appName'> {
-}
-/**
- * CDK construct for AWS Lambda function
- *
- * Responsibilities:
- * - Creates a Lambda function with sensible defaults
- * - Merges and validates environment variables
- * - Applies stage-based configuration (e.g. timeout)
- * - Exposes the function ARN as a CloudFormation output
- */
-declare class BaseLambdaConstruct extends Construct {
-    /** The created Lambda function instance */
-    readonly function: Function;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for Lambda function
-     */
-    constructor(scope: Construct, id: string, props: ILambdaConstructProps);
-}
-
-/**
- * Props for BaseLambdaLayerConstruct
- *
- * Provides configuration for:
- * - Creating a new Lambda Layer
- * - Importing an existing layer by ARN or attributes
- */
-interface ILambdaLayerConstructProps extends Omit<IBaseCdkConstructProps<{
-    /**
-     * Configuration for creating a new Lambda layer
-     *
-     * Note:
-     * - `layerVersionName` is required
-     * - `compatibleArchitectures` is managed internally
-     */
-    readonly layerOptions?: Partial<Omit<LayerVersionProps, 'layerVersionName' | 'compatibleArchitectures'>> & Required<Pick<LayerVersionProps, 'layerVersionName'>>;
-    /** Import an existing layer by ARN */
-    readonly fromExistingLayerArn?: string;
-    /** Import an existing layer using attributes */
-    readonly fromExistingLayerAttribute?: {
-        readonly layerVersionArn: string;
-        readonly compatibleRuntimes?: Runtime[];
-    };
-}>, 'appName' | 'stage' | 'stackName'> {
-}
-/**
- * CDK construct for Lambda Layer
- *
- * Responsibilities:
- * - Creates a new Lambda layer or imports an existing one
- * - Applies default runtime and architecture compatibility
- * - Exposes the layer ARN as a CloudFormation output
- */
-declare class BaseLambdaLayerConstruct extends Construct {
-    /** Newly created Lambda Layer (null if importing existing layer) */
-    readonly layer: LayerVersion;
-    /** Imported Lambda Layer reference (null if creating new layer) */
-    readonly existingLayer: ILayerVersion;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for layer creation or import
-     */
-    constructor(scope: Construct, id: string, props?: ILambdaLayerConstructProps);
-}
-
-/**
- * Props for BaseRolePolicyConstruct
- *
- * Provides configuration for:
- * - IAM role creation
- * - Inline policy statements
- */
-interface IDynamoDBConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** IAM Role configuration options */
-    readonly roleOptions: RoleProps;
-}>, 'appName' | 'stage' | 'stackName'> {
-    /**
-     * Additional inline policies to attach to the role
-     *
-     * Each entry is converted into a PolicyStatement
-     */
-    readonly policies?: PolicyStatementProps[];
-}
-/**
- * CDK construct for IAM Role with policies
- *
- * Responsibilities:
- * - Creates an IAM role with configurable options
- * - Applies a default AWS managed policy if none is provided
- * - Attaches optional inline policy statements
- * - Exposes the role ARN as a CloudFormation output
- */
-declare class BaseRolePolicyConstruct extends Construct {
-    /** The created IAM Role instance */
-    readonly role: Role;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for role and policies
-     */
-    constructor(scope: Construct, id: string, props: IDynamoDBConstructProps);
-}
-
-/**
- * Props for BaseS3Construct
- *
- * Provides configuration for creating an S3 bucket
- * with optional overrides for bucket properties.
- */
-interface IS3DeploymentConstructProps$1 extends Omit<IBaseCdkConstructProps<{
-    /** Configuration options for the S3 bucket */
-    readonly bucketOptions?: BucketProps;
-}>, 'appName' | 'stackName'> {
-}
-/**
- * CDK construct for S3 bucket
- *
- * Responsibilities:
- * - Creates an S3 bucket with configurable options
- * - Applies a default removal policy if not provided
- * - Exposes the bucket ARN as a CloudFormation output
- */
-declare class BaseS3Construct extends Construct {
-    /** The created S3 bucket instance */
-    readonly bucket: Bucket;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for S3 bucket
-     */
-    constructor(scope: Construct, id: string, props: IS3DeploymentConstructProps$1);
-}
-
-/**
- * Props for BaseS3DeploymentConstruct
- *
- * Provides configuration for:
- * - Optional S3 bucket creation
- * - Optional CloudFront distribution
- * - S3 bucket deployment
- */
-interface IS3DeploymentConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** Configuration options for S3 bucket */
-    readonly bucketOptions?: BucketProps;
-    /**
-     * Configuration options for CloudFront distribution
-     *
-     * Note:
-     * - `additionalBehaviors` supports dynamic route mappings
-     * - Origins are automatically resolved if not provided
-     */
-    readonly cloudfrontOptions?: Partial<Omit<DistributionProps, 'additionalBehaviors'>> & {
-        readonly additionalBehaviors?: ObjectType<Partial<BehaviorOptions>, string>;
-    };
-    /**
-     * Configuration for S3 bucket deployment
-     *
-     * Note:
-     * - `sources` is required
-     * - `destinationBucket` can be auto-resolved
-     */
-    readonly bucketDeploymentOptions: Omit<Partial<BucketDeploymentProps>, 'sources'> & Pick<BucketDeploymentProps, 'sources'>;
-}>, 'appName' | 'stackName'> {
-    /** Whether to create a new S3 bucket */
-    readonly withS3Bucket?: boolean;
-    /** Whether to create a CloudFront distribution */
-    readonly withCloudfront?: boolean;
-}
-/**
- * CDK construct for S3 deployment with optional CloudFront integration
- *
- * Responsibilities:
- * - Optionally creates an S3 bucket
- * - Optionally creates a CloudFront distribution with S3 origin
- * - Deploys assets to S3 bucket
- * - Configures CloudFront invalidation paths
- *
- * Behaviour:
- * - Automatically links S3 bucket as CloudFront origin when enabled
- * - Resolves destination bucket and distribution if not explicitly provided
- * - Throws when required dependencies are missing
- */
-declare class BaseS3DeploymentConstruct extends Construct {
-    /** The created or provided S3 bucket */
-    readonly bucket: Bucket;
-    /** The created CloudFront distribution */
-    readonly distribution: Distribution;
-    /** S3 bucket deployment instance */
-    readonly bucketDeployment: BucketDeployment;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for bucket, distribution, and deployment
-     */
-    constructor(scope: Construct, id: string, props: IS3DeploymentConstructProps);
-}
-
-/**
- * Props for BaseSnsConstruct
- *
- * Provides configuration for:
- * - SNS topic creation
- * - Lambda subscriptions
- */
-interface ISnsConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** SNS topic configuration options */
-    readonly topicOptions: TopicProps;
-    /**
-     * Lambda functions to subscribe to the topic
-     *
-     * Each function will receive messages published to the topic
-     */
-    readonly targetFunctions: Function[];
-}>, 'appName' | 'stage' | 'stackName'> {
-}
-/**
- * CDK construct for SNS topic with Lambda subscriptions
- *
- * Responsibilities:
- * - Creates an SNS topic with configurable options
- * - Subscribes one or more Lambda functions to the topic
- * - Applies a removal policy
- * - Exposes the topic ARN as a CloudFormation output
- */
-declare class BaseSnsConstruct extends Construct {
-    /** The created SNS topic instance */
-    readonly topic: Topic;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for topic and subscriptions
-     */
-    constructor(scope: Construct, id: string, props: ISnsConstructProps);
-}
-
-/**
- * Props for BaseSqsConstruct
- *
- * Provides configuration for:
- * - SQS queue creation
- * - Lambda event source mappings
- */
-interface ISqsConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** Configuration options for the SQS queue */
-    readonly queueOptions?: QueueProps;
-    /**
-     * Configuration for Lambda event source mapping
-     *
-     * Note:
-     * `eventSourceArn` and `target` are managed internally
-     */
-    readonly eventSourceMappingOptions?: Omit<EventSourceMappingProps, 'eventSourceArn' | 'target'>;
-}>, 'appName' | 'stage' | 'stackName'> {
-    /**
-     * Lambda functions to be triggered by SQS messages
-     *
-     * Each function will be connected via an event source mapping
-     */
-    readonly targetFunctions?: Function[];
-}
-/**
- * CDK construct for SQS queue with Lambda integration
- *
- * Responsibilities:
- * - Creates an SQS queue with configurable options
- * - Attaches one or more Lambda consumers via event source mappings
- * - Applies default retry behaviour
- * - Exposes the queue ARN as a CloudFormation output
- */
-declare class BaseSqsConstruct extends Construct {
-    /** The created SQS queue instance */
-    readonly queue: Queue;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for queue and Lambda consumers
-     */
-    constructor(scope: Construct, id: string, props: ISqsConstructProps);
-}
-
-/**
- * Props for BaseVpcConstruct
- *
- * Provides configuration for creating a VPC.
- */
-interface IVpcConstructProps extends Omit<IBaseCdkConstructProps<{
-    /** VPC configuration options */
-    readonly vpcOptions: VpcProps;
-}>, 'appName' | 'stage' | 'stackName'> {
-}
-/**
- * CDK construct for Virtual Private Cloud (VPC)
- *
- * Responsibilities:
- * - Creates a VPC with configurable options
- * - Exposes the VPC ARN as a CloudFormation output
- */
-declare class BaseVpcConstruct extends Construct {
-    /** The created VPC instance */
-    readonly vpc: Vpc;
-    /**
-     * @param scope Parent construct
-     * @param id Unique construct identifier
-     * @param props Configuration for VPC
-     */
-    constructor(scope: Construct, id: string, props: IVpcConstructProps);
-}
-
-export { BaseApiGatewayConstruct, BaseApiGatewayV2Construct, BaseApiGatewayWebSocketConstruct, BaseCloudfrontConstruct, BaseCloudwatchLogGroupConstruct, BaseDynamoDBConstruct, BaseEventBridgeConstruct, BaseLambdaAuthoriserConstruct, BaseLambdaAuthoriserV2Construct, BaseLambdaConstruct, BaseLambdaLayerConstruct, BaseRolePolicyConstruct, BaseS3Construct, BaseS3DeploymentConstruct, BaseSnsConstruct, BaseSqsConstruct, BaseVpcConstruct, type IBaseCdkConstructProps, type IBaseConstruct };
+export { BaseApiGatewayConstruct } from './aws-cdk/api-gateway.js';
+export { BaseApiGatewayV2Construct } from './aws-cdk/api-gateway-v2.js';
+export { BaseApiGatewayWebSocketConstruct } from './aws-cdk/api-gateway-websocket.js';
+export { BaseCloudfrontConstruct } from './aws-cdk/cloudfront.js';
+export { BaseCloudwatchLogGroupConstruct } from './aws-cdk/cloudwatch.js';
+export { BaseDynamoDBConstruct } from './aws-cdk/dynamo-db.js';
+export { BaseEventBridgeConstruct } from './aws-cdk/event-bridge.js';
+export { BaseLambdaAuthoriserConstruct } from './aws-cdk/lambda-authorizer.js';
+export { BaseLambdaAuthoriserV2Construct } from './aws-cdk/lambda-authorizer-v2.js';
+export { BaseLambdaConstruct } from './aws-cdk/lambda.js';
+export { BaseLambdaLayerConstruct } from './aws-cdk/lambda-layer.js';
+export { BaseRolePolicyConstruct } from './aws-cdk/role-policy.js';
+export { BaseS3Construct } from './aws-cdk/s3.js';
+export { BaseS3DeploymentConstruct } from './aws-cdk/s3-deployment.js';
+export { BaseSnsConstruct } from './aws-cdk/sns.js';
+export { BaseSqsConstruct } from './aws-cdk/sqs.js';
+export { BaseVpcConstruct } from './aws-cdk/vpc.js';
+export { IBaseCdkConstructProps, IBaseConstruct } from './aws-types.js';
+import 'constructs';
+import 'aws-cdk-lib/aws-lambda';
+import 'aws-cdk-lib/aws-apigatewayv2';
+import 'aws-cdk-lib/aws-apigateway';
+import '@incloodsolutions/toolkit';
+import 'aws-cdk-lib/aws-cloudfront';
+import 'aws-cdk-lib/aws-logs';
+import 'aws-cdk-lib/aws-dynamodb';
+import 'aws-cdk-lib/aws-events';
+import 'aws-cdk-lib/aws-apigatewayv2-authorizers';
+import 'aws-cdk-lib/aws-iam';
+import 'aws-cdk-lib/aws-s3';
+import 'aws-cdk-lib/aws-s3-deployment';
+import 'aws-cdk-lib/aws-sns';
+import 'aws-cdk-lib/aws-sqs';
+import 'aws-cdk-lib/aws-ec2';