@incloodsolutions/devkit 0.0.1 → 0.0.3

package/dist/aws/cdk/constructs/api-gateway-v2-construct.d.ts

@@ -0,0 +1,55 @@
+import { Construct } from 'constructs';
+import { Function } from 'aws-cdk-lib/aws-lambda';
+import { HttpApi, HttpApiProps, AddRoutesOptions } from 'aws-cdk-lib/aws-apigatewayv2';
+import { IBaseConstruct, IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseApiGatewayV2Construct };

package/dist/aws/cdk/constructs/api-gateway-v2-construct.js

@@ -0,0 +1,75 @@
+import { Construct } from 'constructs';
+import { RemovalPolicy, CfnOutput } from 'aws-cdk-lib';
+import { HttpLambdaIntegration } from 'aws-cdk-lib/aws-apigatewayv2-integrations';
+import { HttpApi, CorsHttpMethod } from 'aws-cdk-lib/aws-apigatewayv2';
+import { CustomException } from '@incloodsolutions/toolkit';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseApiGatewayV2Construct = class extends Construct {
+  static {
+    __name(this, "BaseApiGatewayV2Construct");
+  }
+  /** The created HTTP API instance */
+  api;
+  /** Enables debug logging (if used externally) */
+  enableDebug = false;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for API, routes, and handlers
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.enableDebug = props.enableDebug;
+    this.api = new HttpApi(this, id, {
+      ...props?.options?.gatewayOptions,
+      /** Default API description if not provided */
+      description: props?.options?.gatewayOptions?.description || "This is an Http API using CDK",
+      /**
+       * CORS configuration
+       * Falls back to allowing all methods and standard headers if not explicitly defined
+       */
+      corsPreflight: {
+        ...props.options?.gatewayOptions?.corsPreflight,
+        /** Allow all HTTP methods by default */
+        allowMethods: props.options?.gatewayOptions?.corsPreflight?.allowMethods || Object.values(CorsHttpMethod),
+        /** Merge default headers with user-defined headers */
+        allowHeaders: [
+          "Content-Type",
+          "Accept",
+          "X-Amz-Date",
+          "Authorization",
+          "X-Api-Key",
+          "X-Amz-Security-Token",
+          "X-Amz-User-Agent",
+          ...props.options?.gatewayOptions?.corsPreflight?.allowHeaders || []
+        ]
+      }
+    });
+    if (!props?.handlerFunctions?.length) {
+      throw new CustomException("Construct requires atleast one function");
+    }
+    if (props?.options?.routeOptions?.length) {
+      props.handlerFunctions.forEach((handlerFunc) => {
+        props?.options?.routeOptions.forEach((route) => {
+          this.api.addRoutes({
+            ...route,
+            /**
+             * Lambda integration for each route
+             */
+            integration: new HttpLambdaIntegration("routes", handlerFunc)
+          });
+        });
+      });
+    }
+    this.api.applyRemovalPolicy(RemovalPolicy.DESTROY);
+    new CfnOutput(this, "ApiGatewayV2", {
+      value: this.api.url
+    });
+  }
+};
+
+export { BaseApiGatewayV2Construct };
+//# sourceMappingURL=api-gateway-v2-construct.js.map
+//# sourceMappingURL=api-gateway-v2-construct.js.map

package/dist/aws/cdk/constructs/api-gateway-v2-construct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/api-gateway-v2-construct.ts"],"names":[],"mappings":";;;;;;;;AA+CO,IAAM,yBAAA,GAAN,cAAwC,SAAA,CAAoC;AAAA,EA/CnF;AA+CmF,IAAA,MAAA,CAAA,IAAA,EAAA,2BAAA,CAAA;AAAA;AAAA;AAAA,EAEzE,GAAA;AAAA;AAAA,EAGT,WAAA,GAAc,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOd,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAoC;AAC7E,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,cAAc,KAAA,CAAM,WAAA;AAEzB,IAAA,IAAA,CAAK,GAAA,GAAM,IAAI,OAAA,CAAQ,IAAA,EAAM,EAAA,EAAI;AAAA,MAChC,GAAG,OAAO,OAAA,EAAS,cAAA;AAAA;AAAA,MAGnB,WAAA,EAAa,KAAA,EAAO,OAAA,EAAS,cAAA,EAAgB,WAAA,IAAe,+BAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAM5D,aAAA,EAAe;AAAA,QACd,GAAG,KAAA,CAAM,OAAA,EAAS,cAAA,EAAgB,aAAA;AAAA;AAAA,QAGlC,YAAA,EAAc,MAAM,OAAA,EAAS,cAAA,EAAgB,eAAe,YAAA,IAAgB,MAAA,CAAO,OAAO,cAAc,CAAA;AAAA;AAAA,QAGxG,YAAA,EAAc;AAAA,UACb,cAAA;AAAA,UACA,QAAA;AAAA,UACA,YAAA;AAAA,UACA,eAAA;AAAA,UACA,WAAA;AAAA,UACA,sBAAA;AAAA,UACA,kBAAA;AAAA,UACA,GAAG,KAAA,CAAM,OAAA,EAAS,cAAA,EAAgB,aAAA,EAAe,gBAAgB;AAAC;AACnE;AACD,KACA,CAAA;AAKD,IAAA,IAAI,CAAC,KAAA,EAAO,gBAAA,EAAkB,MAAA,EAAQ;AACrC,MAAA,MAAM,IAAI,gBAAgB,yCAAyC,CAAA;AAAA,IACpE;AAKA,IAAA,IAAI,KAAA,EAAO,OAAA,EAAS,YAAA,EAAc,MAAA,EAAQ;AACzC,MAAA,KAAA,CAAM,gBAAA,CAAiB,QAAQ,CAAA,WAAA,KAAe;AAC7C,QAAA,KAAA,EAAO,OAAA,EAAS,YAAA,CAAa,OAAA,CAAQ,CAAA,KAAA,KAAS;AAC7C,UAAA,IAAA,CAAK,IAAI,SAAA,CAAU;AAAA,YAClB,GAAG,KAAA;AAAA;AAAA;AAAA;AAAA,YAKH,WAAA,EAAa,IAAI,qBAAA,CAAsB,QAAA,EAAU,WAAW;AAAA,WACxC,CAAA;AAAA,QACtB,CAAC,CAAA;AAAA,MACF,CAAC,CAAA;AAAA,IACF;AAKA,IAAA,IAAA,CAAK,GAAA,CAAI,kBAAA,CAAmB,aAAA,CAAc,OAAO,CAAA;AAKjD,IAAA,IAAI,SAAA,CAAU,MAAM,cAAA,EAAgB;AAAA,MACnC,KAAA,EAAO,KAAK,GAAA,CAAI;AAAA,KAChB,CAAA;AAAA,EACF;AACD","file":"api-gateway-v2-construct.js","sourcesContent":["import { Construct } from 'constructs';\nimport { Function } from 'aws-cdk-lib/aws-lambda';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { HttpLambdaIntegration } from 'aws-cdk-lib/aws-apigatewayv2-integrations';\nimport { AddRoutesOptions, CorsHttpMethod, HttpApi, HttpApiProps } from 'aws-cdk-lib/aws-apigatewayv2';\n\nimport { CustomException } from '@incloodsolutions/toolkit';\nimport { IBaseCdkConstructProps, IBaseConstruct } from '../../types';\n\n/**\n * Properties for configuring the API Gateway v2 construct\n *\n * Extends base CDK construct props and provides configuration for:\n * - HTTP API (Api Gateway v2)\n * - Route definitions\n * - Lambda handlers\n */\ninterface IApiGatewayV2ConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** HTTP API configuration options */\n\treadonly gatewayOptions: HttpApiProps;\n\n\t/** Route definitions passed directly to `addRoutes` */\n\treadonly routeOptions: Partial<AddRoutesOptions>[];\n}>, 'appName' | 'stage' | 'stackName'> {\n\t/**\n\t * Lambda functions used as route handlers\n\t *\n\t * Note:\n\t * Each handler is paired with each route during route creation\n\t */\n\treadonly handlerFunctions: Function[];\n}\n\n\n/**\n * CDK construct for creating an API Gateway v2 (HTTP API)\n *\n * Responsibilities:\n * - Creates an HTTP API with optional custom configuration\n * - Applies default CORS configuration when not provided\n * - Attaches routes with Lambda integrations\n * - Exposes API URL as a CloudFormation output\n *\n * Behaviour:\n * - Each route is registered for every provided handler function\n * - Throws if no handler functions are supplied\n */\nexport class BaseApiGatewayV2Construct extends Construct implements IBaseConstruct {\n\t/** The created HTTP API instance */\n\treadonly api: HttpApi;\n\n\t/** Enables debug logging (if used externally) */\n\tenableDebug = false;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for API, routes, and handlers\n\t */\n\tconstructor(scope: Construct, id: string, props: IApiGatewayV2ConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.enableDebug = props.enableDebug;\n\n\t\tthis.api = new HttpApi(this, id, {\n\t\t\t...props?.options?.gatewayOptions,\n\n\t\t\t/** Default API description if not provided */\n\t\t\tdescription: props?.options?.gatewayOptions?.description || 'This is an Http API using CDK',\n\n\t\t\t/**\n\t\t\t * CORS configuration\n\t\t\t * Falls back to allowing all methods and standard headers if not explicitly defined\n\t\t\t */\n\t\t\tcorsPreflight: {\n\t\t\t\t...props.options?.gatewayOptions?.corsPreflight,\n\n\t\t\t\t/** Allow all HTTP methods by default */\n\t\t\t\tallowMethods: props.options?.gatewayOptions?.corsPreflight?.allowMethods || Object.values(CorsHttpMethod),\n\n\t\t\t\t/** Merge default headers with user-defined headers */\n\t\t\t\tallowHeaders: [\n\t\t\t\t\t'Content-Type',\n\t\t\t\t\t'Accept',\n\t\t\t\t\t'X-Amz-Date',\n\t\t\t\t\t'Authorization',\n\t\t\t\t\t'X-Api-Key',\n\t\t\t\t\t'X-Amz-Security-Token',\n\t\t\t\t\t'X-Amz-User-Agent',\n\t\t\t\t\t...props.options?.gatewayOptions?.corsPreflight?.allowHeaders || []\n\t\t\t\t]\n\t\t\t}\n\t\t});\n\n\t\t/**\n\t\t * Ensure at least one handler function is provided\n\t\t */\n\t\tif (!props?.handlerFunctions?.length) {\n\t\t\tthrow new CustomException('Construct requires atleast one function');\n\t\t}\n\n\t\t/**\n\t\t * Register routes with Lambda integrations\n\t\t */\n\t\tif (props?.options?.routeOptions?.length) {\n\t\t\tprops.handlerFunctions.forEach(handlerFunc => {\n\t\t\t\tprops?.options?.routeOptions.forEach(route => {\n\t\t\t\t\tthis.api.addRoutes({\n\t\t\t\t\t\t...route,\n\n\t\t\t\t\t\t/**\n\t\t\t\t\t\t * Lambda integration for each route\n\t\t\t\t\t\t */\n\t\t\t\t\t\tintegration: new HttpLambdaIntegration('routes', handlerFunc)\n\t\t\t\t\t} as AddRoutesOptions);\n\t\t\t\t});\n\t\t\t});\n\t\t}\n\n\t\t/**\n\t\t * Apply removal policy (useful for non-production environments)\n\t\t */\n\t\tthis.api.applyRemovalPolicy(RemovalPolicy.DESTROY);\n\n\t\t/**\n\t\t * CloudFormation output exposing the API base URL\n\t\t */\n\t\tnew CfnOutput(this, 'ApiGatewayV2', {\n\t\t\tvalue: this.api.url,\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/api-gateway-websocket-construct.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsApigatewayv2Integrations = require('aws-cdk-lib/aws-apigatewayv2-integrations');
+var awsApigatewayv2 = require('aws-cdk-lib/aws-apigatewayv2');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseApiGatewayWebSocketConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseApiGatewayWebSocketConstruct");
+  }
+  /** The created WebSocket API instance */
+  socketApi;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for API, stage, and route handlers
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.socketApi = new awsApigatewayv2.WebSocketApi(this, id, {
+      ...props.options.webSocketApiOptions,
+      /**
+       * Route for connection establishment ($connect)
+       */
+      connectRouteOptions: {
+        ...props.handlers.connect?.option,
+        integration: new awsApigatewayv2Integrations.WebSocketLambdaIntegration("connectIntegration", props.handlers.connect.function)
+      },
+      /**
+       * Route for disconnection events ($disconnect)
+       */
+      disconnectRouteOptions: {
+        ...props.handlers.disconnect?.option,
+        integration: new awsApigatewayv2Integrations.WebSocketLambdaIntegration("disconnectIntegration", props.handlers.disconnect.function)
+      },
+      /**
+       * Default route for unmatched messages ($default)
+       */
+      defaultRouteOptions: {
+        ...props.handlers.default?.option,
+        integration: new awsApigatewayv2Integrations.WebSocketLambdaIntegration("defaultIntegration", props.handlers.default.function)
+      }
+    });
+    this.socketApi.addRoute("notifications", {
+      ...props.handlers.message?.option,
+      /** Lambda integration for message handling */
+      integration: new awsApigatewayv2Integrations.WebSocketLambdaIntegration("routes", props.handlers.message.function)
+    });
+    const webSocketStage = new awsApigatewayv2.WebSocketStage(this, `${id}_stage`, {
+      ...props.options?.webSocketStageOptions,
+      webSocketApi: this.socketApi,
+      autoDeploy: true
+    });
+    new awsCdkLib.CfnOutput(this, "WebSocketURL", {
+      value: webSocketStage.url
+    });
+  }
+};
+
+exports.BaseApiGatewayWebSocketConstruct = BaseApiGatewayWebSocketConstruct;
+//# sourceMappingURL=api-gateway-websocket-construct.cjs.map
+//# sourceMappingURL=api-gateway-websocket-construct.cjs.map

package/dist/aws/cdk/constructs/api-gateway-websocket-construct.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/api-gateway-websocket-construct.ts"],"names":["Construct","WebSocketApi","WebSocketLambdaIntegration","WebSocketStage","CfnOutput"],"mappings":";;;;;;;;;AAoEO,IAAM,gCAAA,GAAN,cAA+CA,oBAAA,CAAU;AAAA,EApEhE;AAoEgE,IAAA,MAAA,CAAA,IAAA,EAAA,kCAAA,CAAA;AAAA;AAAA;AAAA,EAEtD,SAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA2C;AACpF,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,4BAAA,CAAa,IAAA,EAAM,EAAA,EAAI;AAAA,MAC3C,GAAG,MAAM,OAAA,CAAQ,mBAAA;AAAA;AAAA;AAAA;AAAA,MAKjB,mBAAA,EAAqB;AAAA,QACpB,GAAG,KAAA,CAAM,QAAA,CAAS,OAAA,EAAS,MAAA;AAAA,QAC3B,aAAa,IAAIC,sDAAA,CAA2B,sBAAsB,KAAA,CAAM,QAAA,CAAS,QAAQ,QAAQ;AAAA,OAClG;AAAA;AAAA;AAAA;AAAA,MAKA,sBAAA,EAAwB;AAAA,QACvB,GAAG,KAAA,CAAM,QAAA,CAAS,UAAA,EAAY,MAAA;AAAA,QAC9B,aAAa,IAAIA,sDAAA,CAA2B,yBAAyB,KAAA,CAAM,QAAA,CAAS,WAAW,QAAQ;AAAA,OACxG;AAAA;AAAA;AAAA;AAAA,MAKA,mBAAA,EAAqB;AAAA,QACpB,GAAG,KAAA,CAAM,QAAA,CAAS,OAAA,EAAS,MAAA;AAAA,QAC3B,aAAa,IAAIA,sDAAA,CAA2B,sBAAsB,KAAA,CAAM,QAAA,CAAS,QAAQ,QAAQ;AAAA;AAClG,KACA,CAAA;AAKD,IAAA,IAAA,CAAK,SAAA,CAAU,SAAS,eAAA,EAAiB;AAAA,MACxC,GAAG,KAAA,CAAM,QAAA,CAAS,OAAA,EAAS,MAAA;AAAA;AAAA,MAG3B,aAAa,IAAIA,sDAAA,CAA2B,UAAU,KAAA,CAAM,QAAA,CAAS,QAAQ,QAAQ;AAAA,KACrF,CAAA;AAMD,IAAA,MAAM,iBAAiB,IAAIC,8BAAA,CAAe,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,MAAA,CAAA,EAAU;AAAA,MAC9D,GAAG,MAAM,OAAA,EAAS,qBAAA;AAAA,MAClB,cAAc,IAAA,CAAK,SAAA;AAAA,MACnB,UAAA,EAAY;AAAA,KACZ,CAAA;AAKD,IAAA,IAAIC,mBAAA,CAAU,MAAM,cAAA,EAAgB;AAAA,MACnC,OAAO,cAAA,CAAe;AAAA,KACtB,CAAA;AAAA,EACF;AACD","file":"api-gateway-websocket-construct.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { Function } from 'aws-cdk-lib/aws-lambda';\nimport { WebSocketLambdaIntegration } from 'aws-cdk-lib/aws-apigatewayv2-integrations';\nimport { WebSocketApi, WebSocketApiProps, WebSocketRouteOptions, WebSocketStage, WebSocketStageProps } from 'aws-cdk-lib/aws-apigatewayv2';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseApiGatewayWebSocketConstruct\n *\n * Provides configuration for:\n * - WebSocket API (API Gateway v2)\n * - WebSocket stage\n * - Route handlers for lifecycle events\n */\ninterface IApiGatewayWebsocketConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** WebSocket API configuration options */\n\treadonly webSocketApiOptions: WebSocketApiProps;\n\n\t/** WebSocket stage configuration options */\n\treadonly webSocketStageOptions: WebSocketStageProps;\n}>, 'appName' | 'stage' | 'stackName'> {\n\t/**\n\t * Lambda handlers mapped to WebSocket lifecycle routes\n\t *\n\t * Includes:\n\t * - $connect\n\t * - $disconnect\n\t * - $default\n\t * - custom message route\n\t */\n\treadonly handlers: {\n\t\t/** Handler for connection establishment ($connect) */\n\t\treadonly connect: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\n\t\t/** Handler for unmatched routes ($default) */\n\t\treadonly default: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\n\t\t/** Handler for custom message route (e.g. 'notifications') */\n\t\treadonly message: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\n\t\t/** Handler for disconnection events ($disconnect) */\n\t\treadonly disconnect: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\t}\n}\n\n/**\n * CDK construct for WebSocket API Gateway\n *\n * Responsibilities:\n * - Creates a WebSocket API with lifecycle route integrations\n * - Registers a custom message route\n * - Deploys a stage with auto-deploy enabled\n * - Exposes WebSocket endpoint URL as a CloudFormation output\n */\nexport class BaseApiGatewayWebSocketConstruct extends Construct {\n\t/** The created WebSocket API instance */\n\treadonly socketApi: WebSocketApi;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for API, stage, and route handlers\n\t */\n\tconstructor(scope: Construct, id: string, props: IApiGatewayWebsocketConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.socketApi = new WebSocketApi(this, id, {\n\t\t\t...props.options.webSocketApiOptions,\n\n\t\t\t/**\n\t\t\t * Route for connection establishment ($connect)\n\t\t\t */\n\t\t\tconnectRouteOptions: {\n\t\t\t\t...props.handlers.connect?.option,\n\t\t\t\tintegration: new WebSocketLambdaIntegration('connectIntegration', props.handlers.connect.function),\n\t\t\t},\n\n\t\t\t/**\n\t\t\t * Route for disconnection events ($disconnect)\n\t\t\t */\n\t\t\tdisconnectRouteOptions: {\n\t\t\t\t...props.handlers.disconnect?.option,\n\t\t\t\tintegration: new WebSocketLambdaIntegration('disconnectIntegration', props.handlers.disconnect.function)\n\t\t\t},\n\n\t\t\t/**\n\t\t\t * Default route for unmatched messages ($default)\n\t\t\t */\n\t\t\tdefaultRouteOptions: {\n\t\t\t\t...props.handlers.default?.option,\n\t\t\t\tintegration: new WebSocketLambdaIntegration('defaultIntegration', props.handlers.default.function)\n\t\t\t},\n\t\t});\n\n\t\t/**\n\t\t * Custom message route (e.g. \"notifications\")\n\t\t */\n\t\tthis.socketApi.addRoute(\"notifications\", {\n\t\t\t...props.handlers.message?.option,\n\n\t\t\t/** Lambda integration for message handling */\n\t\t\tintegration: new WebSocketLambdaIntegration('routes', props.handlers.message.function),\n\t\t});\n\n\t\t/**\n\t\t * WebSocket stage deployment\n\t\t * Auto-deploy ensures changes are immediately available\n\t\t */\n\t\tconst webSocketStage = new WebSocketStage(this, `${id}_stage`, {\n\t\t\t...props.options?.webSocketStageOptions,\n\t\t\twebSocketApi: this.socketApi,\n\t\t\tautoDeploy: true\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing WebSocket endpoint URL\n\t\t */\n\t\tnew CfnOutput(this, 'WebSocketURL', {\n\t\t\tvalue: webSocketStage.url,\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/api-gateway-websocket-construct.d.cts

@@ -0,0 +1,73 @@
+import { Construct } from 'constructs';
+import { Function } from 'aws-cdk-lib/aws-lambda';
+import { WebSocketApi, WebSocketApiProps, WebSocketStageProps, WebSocketRouteOptions } from 'aws-cdk-lib/aws-apigatewayv2';
+import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseApiGatewayWebSocketConstruct };

package/dist/aws/cdk/constructs/api-gateway-websocket-construct.d.ts

@@ -0,0 +1,73 @@
+import { Construct } from 'constructs';
+import { Function } from 'aws-cdk-lib/aws-lambda';
+import { WebSocketApi, WebSocketApiProps, WebSocketStageProps, WebSocketRouteOptions } from 'aws-cdk-lib/aws-apigatewayv2';
+import { IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseApiGatewayWebSocketConstruct };

package/dist/aws/cdk/constructs/api-gateway-websocket-construct.js

@@ -0,0 +1,63 @@
+import { Construct } from 'constructs';
+import { CfnOutput } from 'aws-cdk-lib';
+import { WebSocketLambdaIntegration } from 'aws-cdk-lib/aws-apigatewayv2-integrations';
+import { WebSocketApi, WebSocketStage } from 'aws-cdk-lib/aws-apigatewayv2';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseApiGatewayWebSocketConstruct = class extends Construct {
+  static {
+    __name(this, "BaseApiGatewayWebSocketConstruct");
+  }
+  /** The created WebSocket API instance */
+  socketApi;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for API, stage, and route handlers
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.socketApi = new WebSocketApi(this, id, {
+      ...props.options.webSocketApiOptions,
+      /**
+       * Route for connection establishment ($connect)
+       */
+      connectRouteOptions: {
+        ...props.handlers.connect?.option,
+        integration: new WebSocketLambdaIntegration("connectIntegration", props.handlers.connect.function)
+      },
+      /**
+       * Route for disconnection events ($disconnect)
+       */
+      disconnectRouteOptions: {
+        ...props.handlers.disconnect?.option,
+        integration: new WebSocketLambdaIntegration("disconnectIntegration", props.handlers.disconnect.function)
+      },
+      /**
+       * Default route for unmatched messages ($default)
+       */
+      defaultRouteOptions: {
+        ...props.handlers.default?.option,
+        integration: new WebSocketLambdaIntegration("defaultIntegration", props.handlers.default.function)
+      }
+    });
+    this.socketApi.addRoute("notifications", {
+      ...props.handlers.message?.option,
+      /** Lambda integration for message handling */
+      integration: new WebSocketLambdaIntegration("routes", props.handlers.message.function)
+    });
+    const webSocketStage = new WebSocketStage(this, `${id}_stage`, {
+      ...props.options?.webSocketStageOptions,
+      webSocketApi: this.socketApi,
+      autoDeploy: true
+    });
+    new CfnOutput(this, "WebSocketURL", {
+      value: webSocketStage.url
+    });
+  }
+};
+
+export { BaseApiGatewayWebSocketConstruct };
+//# sourceMappingURL=api-gateway-websocket-construct.js.map
+//# sourceMappingURL=api-gateway-websocket-construct.js.map

package/dist/aws/cdk/constructs/api-gateway-websocket-construct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/api-gateway-websocket-construct.ts"],"names":[],"mappings":";;;;;;;AAoEO,IAAM,gCAAA,GAAN,cAA+C,SAAA,CAAU;AAAA,EApEhE;AAoEgE,IAAA,MAAA,CAAA,IAAA,EAAA,kCAAA,CAAA;AAAA;AAAA;AAAA,EAEtD,SAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA2C;AACpF,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,YAAA,CAAa,IAAA,EAAM,EAAA,EAAI;AAAA,MAC3C,GAAG,MAAM,OAAA,CAAQ,mBAAA;AAAA;AAAA;AAAA;AAAA,MAKjB,mBAAA,EAAqB;AAAA,QACpB,GAAG,KAAA,CAAM,QAAA,CAAS,OAAA,EAAS,MAAA;AAAA,QAC3B,aAAa,IAAI,0BAAA,CAA2B,sBAAsB,KAAA,CAAM,QAAA,CAAS,QAAQ,QAAQ;AAAA,OAClG;AAAA;AAAA;AAAA;AAAA,MAKA,sBAAA,EAAwB;AAAA,QACvB,GAAG,KAAA,CAAM,QAAA,CAAS,UAAA,EAAY,MAAA;AAAA,QAC9B,aAAa,IAAI,0BAAA,CAA2B,yBAAyB,KAAA,CAAM,QAAA,CAAS,WAAW,QAAQ;AAAA,OACxG;AAAA;AAAA;AAAA;AAAA,MAKA,mBAAA,EAAqB;AAAA,QACpB,GAAG,KAAA,CAAM,QAAA,CAAS,OAAA,EAAS,MAAA;AAAA,QAC3B,aAAa,IAAI,0BAAA,CAA2B,sBAAsB,KAAA,CAAM,QAAA,CAAS,QAAQ,QAAQ;AAAA;AAClG,KACA,CAAA;AAKD,IAAA,IAAA,CAAK,SAAA,CAAU,SAAS,eAAA,EAAiB;AAAA,MACxC,GAAG,KAAA,CAAM,QAAA,CAAS,OAAA,EAAS,MAAA;AAAA;AAAA,MAG3B,aAAa,IAAI,0BAAA,CAA2B,UAAU,KAAA,CAAM,QAAA,CAAS,QAAQ,QAAQ;AAAA,KACrF,CAAA;AAMD,IAAA,MAAM,iBAAiB,IAAI,cAAA,CAAe,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,MAAA,CAAA,EAAU;AAAA,MAC9D,GAAG,MAAM,OAAA,EAAS,qBAAA;AAAA,MAClB,cAAc,IAAA,CAAK,SAAA;AAAA,MACnB,UAAA,EAAY;AAAA,KACZ,CAAA;AAKD,IAAA,IAAI,SAAA,CAAU,MAAM,cAAA,EAAgB;AAAA,MACnC,OAAO,cAAA,CAAe;AAAA,KACtB,CAAA;AAAA,EACF;AACD","file":"api-gateway-websocket-construct.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { Function } from 'aws-cdk-lib/aws-lambda';\nimport { WebSocketLambdaIntegration } from 'aws-cdk-lib/aws-apigatewayv2-integrations';\nimport { WebSocketApi, WebSocketApiProps, WebSocketRouteOptions, WebSocketStage, WebSocketStageProps } from 'aws-cdk-lib/aws-apigatewayv2';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseApiGatewayWebSocketConstruct\n *\n * Provides configuration for:\n * - WebSocket API (API Gateway v2)\n * - WebSocket stage\n * - Route handlers for lifecycle events\n */\ninterface IApiGatewayWebsocketConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** WebSocket API configuration options */\n\treadonly webSocketApiOptions: WebSocketApiProps;\n\n\t/** WebSocket stage configuration options */\n\treadonly webSocketStageOptions: WebSocketStageProps;\n}>, 'appName' | 'stage' | 'stackName'> {\n\t/**\n\t * Lambda handlers mapped to WebSocket lifecycle routes\n\t *\n\t * Includes:\n\t * - $connect\n\t * - $disconnect\n\t * - $default\n\t * - custom message route\n\t */\n\treadonly handlers: {\n\t\t/** Handler for connection establishment ($connect) */\n\t\treadonly connect: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\n\t\t/** Handler for unmatched routes ($default) */\n\t\treadonly default: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\n\t\t/** Handler for custom message route (e.g. 'notifications') */\n\t\treadonly message: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\n\t\t/** Handler for disconnection events ($disconnect) */\n\t\treadonly disconnect: {\n\t\t\toption: WebSocketRouteOptions;\n\t\t\tfunction: Function;\n\t\t};\n\t}\n}\n\n/**\n * CDK construct for WebSocket API Gateway\n *\n * Responsibilities:\n * - Creates a WebSocket API with lifecycle route integrations\n * - Registers a custom message route\n * - Deploys a stage with auto-deploy enabled\n * - Exposes WebSocket endpoint URL as a CloudFormation output\n */\nexport class BaseApiGatewayWebSocketConstruct extends Construct {\n\t/** The created WebSocket API instance */\n\treadonly socketApi: WebSocketApi;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for API, stage, and route handlers\n\t */\n\tconstructor(scope: Construct, id: string, props: IApiGatewayWebsocketConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.socketApi = new WebSocketApi(this, id, {\n\t\t\t...props.options.webSocketApiOptions,\n\n\t\t\t/**\n\t\t\t * Route for connection establishment ($connect)\n\t\t\t */\n\t\t\tconnectRouteOptions: {\n\t\t\t\t...props.handlers.connect?.option,\n\t\t\t\tintegration: new WebSocketLambdaIntegration('connectIntegration', props.handlers.connect.function),\n\t\t\t},\n\n\t\t\t/**\n\t\t\t * Route for disconnection events ($disconnect)\n\t\t\t */\n\t\t\tdisconnectRouteOptions: {\n\t\t\t\t...props.handlers.disconnect?.option,\n\t\t\t\tintegration: new WebSocketLambdaIntegration('disconnectIntegration', props.handlers.disconnect.function)\n\t\t\t},\n\n\t\t\t/**\n\t\t\t * Default route for unmatched messages ($default)\n\t\t\t */\n\t\t\tdefaultRouteOptions: {\n\t\t\t\t...props.handlers.default?.option,\n\t\t\t\tintegration: new WebSocketLambdaIntegration('defaultIntegration', props.handlers.default.function)\n\t\t\t},\n\t\t});\n\n\t\t/**\n\t\t * Custom message route (e.g. \"notifications\")\n\t\t */\n\t\tthis.socketApi.addRoute(\"notifications\", {\n\t\t\t...props.handlers.message?.option,\n\n\t\t\t/** Lambda integration for message handling */\n\t\t\tintegration: new WebSocketLambdaIntegration('routes', props.handlers.message.function),\n\t\t});\n\n\t\t/**\n\t\t * WebSocket stage deployment\n\t\t * Auto-deploy ensures changes are immediately available\n\t\t */\n\t\tconst webSocketStage = new WebSocketStage(this, `${id}_stage`, {\n\t\t\t...props.options?.webSocketStageOptions,\n\t\t\twebSocketApi: this.socketApi,\n\t\t\tautoDeploy: true\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing WebSocket endpoint URL\n\t\t */\n\t\tnew CfnOutput(this, 'WebSocketURL', {\n\t\t\tvalue: webSocketStage.url,\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/cloudfront-construct.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsCloudfront = require('aws-cdk-lib/aws-cloudfront');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseCloudfrontConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseCloudfrontConstruct");
+  }
+  /** The created CloudFront distribution instance */
+  distribution;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for CloudFront distribution
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.distribution = new awsCloudfront.Distribution(this, id, {
+      ...props.options?.cloudfrontOptions,
+      /**
+       * Default behaviour configuration
+       * Enforces HTTPS if not explicitly defined
+       */
+      defaultBehavior: {
+        ...props.options?.cloudfrontOptions?.defaultBehavior,
+        viewerProtocolPolicy: props.options?.cloudfrontOptions?.defaultBehavior?.viewerProtocolPolicy || awsCloudfront.ViewerProtocolPolicy.REDIRECT_TO_HTTPS
+      },
+      /**
+       * Error response configuration
+       *
+       * Adds SPA-friendly fallbacks:
+       * - 400, 403, 404 responses are redirected to index.html
+       */
+      errorResponses: [
+        ...props.options?.cloudfrontOptions?.errorResponses || [],
+        /** Handle 400 errors */
+        {
+          httpStatus: 400,
+          responseHttpStatus: 200,
+          responsePagePath: "/index.html",
+          ttl: awsCdkLib.Duration.days(1)
+        },
+        /** Handle 403 errors */
+        {
+          httpStatus: 403,
+          responseHttpStatus: 200,
+          responsePagePath: "/index.html",
+          ttl: awsCdkLib.Duration.days(1)
+        },
+        /** Handle 404 errors */
+        {
+          httpStatus: 404,
+          responseHttpStatus: 200,
+          responsePagePath: "/index.html",
+          ttl: awsCdkLib.Duration.days(1)
+        }
+      ]
+    });
+  }
+};
+
+exports.BaseCloudfrontConstruct = BaseCloudfrontConstruct;
+//# sourceMappingURL=cloudfront-construct.cjs.map
+//# sourceMappingURL=cloudfront-construct.cjs.map

package/dist/aws/cdk/constructs/cloudfront-construct.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/cloudfront-construct.ts"],"names":["Construct","Distribution","ViewerProtocolPolicy","Duration"],"mappings":";;;;;;;;AAyBO,IAAM,uBAAA,GAAN,cAAsCA,oBAAA,CAAU;AAAA,EAzBvD;AAyBuD,IAAA,MAAA,CAAA,IAAA,EAAA,yBAAA,CAAA;AAAA;AAAA;AAAA,EAE7C,YAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAkC;AAC3E,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,YAAA,GAAe,IAAIC,0BAAA,CAAa,IAAA,EAAM,EAAA,EAAI;AAAA,MAC9C,GAAG,MAAM,OAAA,EAAS,iBAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMlB,eAAA,EAAiB;AAAA,QAChB,GAAG,KAAA,CAAM,OAAA,EAAS,iBAAA,EAAmB,eAAA;AAAA,QACrC,sBACC,KAAA,CAAM,OAAA,EAAS,iBAAA,EAAmB,eAAA,EAAiB,wBAChDC,kCAAA,CAAqB;AAAA,OAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQA,cAAA,EAAgB;AAAA,QACf,GAAG,KAAA,CAAM,OAAA,EAAS,iBAAA,EAAmB,kBAAkB,EAAC;AAAA;AAAA,QAGxD;AAAA,UACC,UAAA,EAAY,GAAA;AAAA,UACZ,kBAAA,EAAoB,GAAA;AAAA,UACpB,gBAAA,EAAkB,aAAA;AAAA,UAClB,GAAA,EAAKC,kBAAA,CAAS,IAAA,CAAK,CAAC;AAAA,SACrB;AAAA;AAAA,QAGA;AAAA,UACC,UAAA,EAAY,GAAA;AAAA,UACZ,kBAAA,EAAoB,GAAA;AAAA,UACpB,gBAAA,EAAkB,aAAA;AAAA,UAClB,GAAA,EAAKA,kBAAA,CAAS,IAAA,CAAK,CAAC;AAAA,SACrB;AAAA;AAAA,QAGA;AAAA,UACC,UAAA,EAAY,GAAA;AAAA,UACZ,kBAAA,EAAoB,GAAA;AAAA,UACpB,gBAAA,EAAkB,aAAA;AAAA,UAClB,GAAA,EAAKA,kBAAA,CAAS,IAAA,CAAK,CAAC;AAAA;AACrB;AACD,KACA,CAAA;AAAA,EACF;AACD","file":"cloudfront-construct.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { Duration } from 'aws-cdk-lib';\nimport { Distribution, DistributionProps, ViewerProtocolPolicy } from 'aws-cdk-lib/aws-cloudfront';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseCloudfrontConstruct\n *\n * Provides configuration for creating a CloudFront distribution\n * with optional overrides for default behaviour and error handling.\n */\ninterface ICloudfrontConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** Partial configuration for the CloudFront distribution */\n\treadonly cloudfrontOptions: Partial<DistributionProps>;\n}>, 'appName' | 'stage' | 'stackName'> { }\n\n/**\n * CDK construct for CloudFront distribution\n *\n * Responsibilities:\n * - Creates a CloudFront distribution with configurable options\n * - Enforces HTTPS redirection by default\n * - Adds fallback error responses for SPA routing (400, 403, 404 → index.html)\n */\nexport class BaseCloudfrontConstruct extends Construct {\n\t/** The created CloudFront distribution instance */\n\treadonly distribution: Distribution;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for CloudFront distribution\n\t */\n\tconstructor(scope: Construct, id: string, props: ICloudfrontConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.distribution = new Distribution(this, id, {\n\t\t\t...props.options?.cloudfrontOptions,\n\n\t\t\t/**\n\t\t\t * Default behaviour configuration\n\t\t\t * Enforces HTTPS if not explicitly defined\n\t\t\t */\n\t\t\tdefaultBehavior: {\n\t\t\t\t...props.options?.cloudfrontOptions?.defaultBehavior,\n\t\t\t\tviewerProtocolPolicy:\n\t\t\t\t\tprops.options?.cloudfrontOptions?.defaultBehavior?.viewerProtocolPolicy\n\t\t\t\t\t|| ViewerProtocolPolicy.REDIRECT_TO_HTTPS\n\t\t\t},\n\n\t\t\t/**\n\t\t\t * Error response configuration\n\t\t\t *\n\t\t\t * Adds SPA-friendly fallbacks:\n\t\t\t * - 400, 403, 404 responses are redirected to index.html\n\t\t\t */\n\t\t\terrorResponses: [\n\t\t\t\t...props.options?.cloudfrontOptions?.errorResponses || [],\n\n\t\t\t\t/** Handle 400 errors */\n\t\t\t\t{\n\t\t\t\t\thttpStatus: 400,\n\t\t\t\t\tresponseHttpStatus: 200,\n\t\t\t\t\tresponsePagePath: '/index.html',\n\t\t\t\t\tttl: Duration.days(1)\n\t\t\t\t},\n\n\t\t\t\t/** Handle 403 errors */\n\t\t\t\t{\n\t\t\t\t\thttpStatus: 403,\n\t\t\t\t\tresponseHttpStatus: 200,\n\t\t\t\t\tresponsePagePath: '/index.html',\n\t\t\t\t\tttl: Duration.days(1)\n\t\t\t\t},\n\n\t\t\t\t/** Handle 404 errors */\n\t\t\t\t{\n\t\t\t\t\thttpStatus: 404,\n\t\t\t\t\tresponseHttpStatus: 200,\n\t\t\t\t\tresponsePagePath: '/index.html',\n\t\t\t\t\tttl: Duration.days(1)\n\t\t\t\t},\n\t\t\t],\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/cloudfront-construct.d.cts

@@ -0,0 +1,36 @@
+import { Construct } from 'constructs';
+import { Distribution, DistributionProps } from 'aws-cdk-lib/aws-cloudfront';
+import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseCloudfrontConstruct };

package/dist/aws/cdk/constructs/cloudfront-construct.d.ts

@@ -0,0 +1,36 @@
+import { Construct } from 'constructs';
+import { Distribution, DistributionProps } from 'aws-cdk-lib/aws-cloudfront';
+import { IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseCloudfrontConstruct };