@incloodsolutions/devkit 0.0.3 → 0.0.5

package/dist/aws-cdk/stacks/lambda-api.js

@@ -0,0 +1,250 @@
+import { RemovalPolicy, CfnOutput, Duration, Stack } from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import { HttpLambdaIntegration } from 'aws-cdk-lib/aws-apigatewayv2-integrations';
+import { HttpApi, CorsHttpMethod, HttpMethod } from 'aws-cdk-lib/aws-apigatewayv2';
+import { CustomException, detectDuplicateProperties, AppEnvironmentEnum } from '@incloodsolutions/toolkit';
+import { Function, Architecture, Runtime, Code, LayerVersion } from 'aws-cdk-lib/aws-lambda';
+
+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
+    });
+  }
+};
+var BaseLambdaConstruct = class extends Construct {
+  static {
+    __name(this, "BaseLambdaConstruct");
+  }
+  /** The created Lambda function instance */
+  function;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for Lambda function
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    const environment = {
+      ...props.options?.lambdaOptions?.environment,
+      NODE_ENV: props.stage,
+      NODE_OPTIONS: "--enable-source-maps",
+      AWS_NODEJS_CONNECTION_REUSE_ENABLED: "1"
+    };
+    detectDuplicateProperties({ data: environment });
+    this.function = new Function(this, id, {
+      ...props?.options?.lambdaOptions,
+      /**
+       * Lambda function name
+       * Defaults to "<stackName>" if not provided
+       */
+      functionName: `${props?.options?.lambdaOptions?.functionName || props?.stackName}`,
+      /**
+       * Function description
+       */
+      description: props?.options?.lambdaOptions?.description || "A lambda function",
+      /**
+       * Entry handler for the Lambda function
+       */
+      handler: props?.options?.lambdaOptions?.handler || "lambda.handler",
+      /**
+       * Runtime environment
+       */
+      runtime: props?.options?.lambdaOptions?.runtime || Runtime.NODEJS_24_X,
+      /**
+       * Execution timeout
+       * - 30 seconds in production
+       * - 15 seconds otherwise
+       */
+      timeout: props?.options?.lambdaOptions?.timeout || Duration.seconds(
+        props.stage === AppEnvironmentEnum.PRODUCTION ? 30 : 15
+      ),
+      /**
+       * Memory allocation (in MB)
+       */
+      memorySize: props?.options?.lambdaOptions?.memorySize || 1024,
+      /**
+       * CPU architecture
+       */
+      architecture: props?.options?.lambdaOptions?.architecture || Architecture.ARM_64,
+      /**
+       * Lambda deployment package source
+       */
+      code: props?.options?.lambdaOptions?.code || Code.fromAsset("dist"),
+      /**
+       * Final merged environment variables
+       */
+      environment
+    });
+    new CfnOutput(this, "LambdaFunctionArn", {
+      value: this.function.functionArn
+    });
+  }
+};
+var BaseLambdaLayerConstruct = class extends Construct {
+  static {
+    __name(this, "BaseLambdaLayerConstruct");
+  }
+  /** Newly created Lambda Layer (null if importing existing layer) */
+  layer;
+  /** Imported Lambda Layer reference (null if creating new layer) */
+  existingLayer;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for layer creation or import
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    if (props?.options?.fromExistingLayerArn) {
+      this.existingLayer = LayerVersion.fromLayerVersionArn(
+        this,
+        `${id}-Arn`,
+        props?.options?.fromExistingLayerArn
+      );
+    } else if (props?.options?.fromExistingLayerAttribute) {
+      this.existingLayer = LayerVersion.fromLayerVersionAttributes(
+        this,
+        `${id}-Attribute`,
+        props?.options?.fromExistingLayerAttribute
+      );
+    } else {
+      this.layer = new LayerVersion(this, id, {
+        ...props.options?.layerOptions,
+        /**
+         * Default layer code asset
+         */
+        code: props?.options?.layerOptions?.code || Code.fromAsset("./dist-layer"),
+        /**
+         * Layer description
+         */
+        description: props?.options?.layerOptions?.description || "Lambda Layer written in NodeJS, NestJS, NodeJS-express, serverless-express",
+        /**
+         * Supported CPU architectures
+         */
+        compatibleArchitectures: [Architecture.ARM_64, Architecture.X86_64],
+        /**
+         * Supported runtimes
+         */
+        compatibleRuntimes: [
+          Runtime.NODEJS_22_X,
+          Runtime.NODEJS_24_X,
+          Runtime.NODEJS_LATEST
+        ]
+      });
+    }
+    new CfnOutput(this, "LambdaLayerArn", {
+      value: props.options?.fromExistingLayerArn || props.options?.fromExistingLayerAttribute ? this.existingLayer.layerVersionArn : this.layer.layerVersionArn
+    });
+  }
+};
+var BaseLambdaApiStack = class extends Stack {
+  static {
+    __name(this, "BaseLambdaApiStack");
+  }
+  constructor(scope, id, props) {
+    super(scope, id, props);
+    let layers = [];
+    if (props?.stackOptions?.layerOptions) {
+      if (!props.stackOptions?.layerOptions?.name || !props.stackOptions?.layerOptions?.version) {
+        throw new CustomException("Invalid layer options provided! Both layer 'name' and 'version' are required.");
+      }
+      const { existingLayer } = new BaseLambdaLayerConstruct(
+        this,
+        "layer",
+        {
+          options: {
+            fromExistingLayerArn: `arn:aws:lambda:${props.env?.region}:${props.env?.account}:layer:${props.stackOptions?.layerOptions?.name}:${props.stackOptions?.layerOptions?.version}`
+          }
+        }
+      );
+      layers.push(existingLayer);
+    }
+    const { function: lambdaFunction } = new BaseLambdaConstruct(this, "lambda", {
+      stage: props.stackOptions?.stage,
+      stackName: props.stackName,
+      options: {
+        lambdaOptions: { layers }
+      }
+    });
+    new BaseApiGatewayV2Construct(this, "apiGateway", {
+      handlerFunctions: [lambdaFunction],
+      options: {
+        gatewayOptions: {
+          apiName: props.stackName,
+          corsPreflight: {
+            allowOrigins: ["*"]
+          }
+        },
+        routeOptions: [
+          {
+            path: "/{proxy+}",
+            methods: [HttpMethod.ANY]
+          }
+        ]
+      }
+    });
+  }
+};
+
+export { BaseLambdaApiStack };
+//# sourceMappingURL=lambda-api.js.map
+//# sourceMappingURL=lambda-api.js.map

package/dist/aws-cdk/stacks/lambda-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/api-gateway-v2-construct.ts","../../../src/aws/cdk/constructs/lambda-construct.ts","../../../src/aws/cdk/constructs/lambda-layer-construct.ts","../../../src/aws/cdk/stacks/lambda-api-stack.ts"],"names":["Construct","CfnOutput","Code","Architecture","Runtime","CustomException"],"mappings":"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","file":"lambda-api.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 {\n\tAddRoutesOptions,\n\tCorsHttpMethod,\n\tHttpApi,\n\tHttpApiProps,\n} 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<\n\tIBaseCdkConstructProps<{\n\t\t/** HTTP API configuration options */\n\t\treadonly gatewayOptions: HttpApiProps;\n\n\t\t/** Route definitions passed directly to `addRoutes` */\n\t\treadonly routeOptions: Partial<AddRoutesOptions>[];\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {\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 * 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\n\textends Construct\n\timplements IBaseConstruct\n{\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(\n\t\tscope: Construct,\n\t\tid: string,\n\t\tprops: IApiGatewayV2ConstructProps,\n\t) {\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:\n\t\t\t\tprops?.options?.gatewayOptions?.description ||\n\t\t\t\t'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:\n\t\t\t\t\tprops.options?.gatewayOptions?.corsPreflight?.allowMethods ||\n\t\t\t\t\tObject.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}\n","import { Construct } from 'constructs';\nimport { CfnOutput, Duration } from 'aws-cdk-lib';\nimport {\n\tArchitecture,\n\tCode,\n\tFunction,\n\tFunctionProps,\n\tRuntime,\n} from 'aws-cdk-lib/aws-lambda';\n\nimport {\n\tdetectDuplicateProperties,\n\tAppEnvironmentEnum,\n} from '@incloodsolutions/toolkit';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseLambdaConstruct\n *\n * Provides configuration for creating a Lambda function\n * with optional overrides for runtime, memory, timeout, and environment.\n */\ninterface ILambdaConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** Partial Lambda configuration options */\n\t\treadonly lambdaOptions: Partial<FunctionProps>;\n\t}>,\n\t'appName'\n> {}\n\n/**\n * CDK construct for AWS Lambda function\n *\n * Responsibilities:\n * - Creates a Lambda function with sensible defaults\n * - Merges and validates environment variables\n * - Applies stage-based configuration (e.g. timeout)\n * - Exposes the function ARN as a CloudFormation output\n */\nexport class BaseLambdaConstruct extends Construct {\n\t/** The created Lambda function instance */\n\treadonly function: Function;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for Lambda function\n\t */\n\tconstructor(scope: Construct, id: string, props: ILambdaConstructProps) {\n\t\tsuper(scope, id);\n\n\t\t/**\n\t\t * Environment variables for the Lambda function\n\t\t *\n\t\t * Includes:\n\t\t * - User-defined variables\n\t\t * - NODE_ENV derived from stage\n\t\t * - Node.js runtime optimisations\n\t\t */\n\t\tconst environment = {\n\t\t\t...props.options?.lambdaOptions?.environment,\n\t\t\tNODE_ENV: props.stage,\n\t\t\tNODE_OPTIONS: '--enable-source-maps',\n\t\t\tAWS_NODEJS_CONNECTION_REUSE_ENABLED: '1',\n\t\t};\n\n\t\t/**\n\t\t * Validate environment variables for duplicate keys\n\t\t */\n\t\tdetectDuplicateProperties({ data: environment });\n\n\t\tthis.function = new Function(this, id, {\n\t\t\t...props?.options?.lambdaOptions,\n\n\t\t\t/**\n\t\t\t * Lambda function name\n\t\t\t * Defaults to \"<stackName>\" if not provided\n\t\t\t */\n\t\t\tfunctionName: `${props?.options?.lambdaOptions?.functionName || props?.stackName}`,\n\n\t\t\t/**\n\t\t\t * Function description\n\t\t\t */\n\t\t\tdescription:\n\t\t\t\tprops?.options?.lambdaOptions?.description || 'A lambda function',\n\n\t\t\t/**\n\t\t\t * Entry handler for the Lambda function\n\t\t\t */\n\t\t\thandler: props?.options?.lambdaOptions?.handler || 'lambda.handler',\n\n\t\t\t/**\n\t\t\t * Runtime environment\n\t\t\t */\n\t\t\truntime: props?.options?.lambdaOptions?.runtime || Runtime.NODEJS_24_X,\n\n\t\t\t/**\n\t\t\t * Execution timeout\n\t\t\t * - 30 seconds in production\n\t\t\t * - 15 seconds otherwise\n\t\t\t */\n\t\t\ttimeout:\n\t\t\t\tprops?.options?.lambdaOptions?.timeout ||\n\t\t\t\tDuration.seconds(\n\t\t\t\t\tprops.stage === AppEnvironmentEnum.PRODUCTION ? 30 : 15,\n\t\t\t\t),\n\n\t\t\t/**\n\t\t\t * Memory allocation (in MB)\n\t\t\t */\n\t\t\tmemorySize: props?.options?.lambdaOptions?.memorySize || 1024,\n\n\t\t\t/**\n\t\t\t * CPU architecture\n\t\t\t */\n\t\t\tarchitecture:\n\t\t\t\tprops?.options?.lambdaOptions?.architecture || Architecture.ARM_64,\n\n\t\t\t/**\n\t\t\t * Lambda deployment package source\n\t\t\t */\n\t\t\tcode: props?.options?.lambdaOptions?.code || Code.fromAsset('dist'),\n\n\t\t\t/**\n\t\t\t * Final merged environment variables\n\t\t\t */\n\t\t\tenvironment,\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the Lambda function ARN\n\t\t */\n\t\tnew CfnOutput(this, 'LambdaFunctionArn', {\n\t\t\tvalue: this.function.functionArn,\n\t\t});\n\t}\n}\n","import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport {\n\tArchitecture,\n\tCode,\n\tILayerVersion,\n\tLayerVersion,\n\tLayerVersionProps,\n\tRuntime,\n} from 'aws-cdk-lib/aws-lambda';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseLambdaLayerConstruct\n *\n * Provides configuration for:\n * - Creating a new Lambda Layer\n * - Importing an existing layer by ARN or attributes\n */\ninterface ILambdaLayerConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/**\n\t\t * Configuration for creating a new Lambda layer\n\t\t *\n\t\t * Note:\n\t\t * - `layerVersionName` is required\n\t\t * - `compatibleArchitectures` is managed internally\n\t\t */\n\t\treadonly layerOptions?: Partial<\n\t\t\tOmit<LayerVersionProps, 'layerVersionName' | 'compatibleArchitectures'>\n\t\t> &\n\t\t\tRequired<Pick<LayerVersionProps, 'layerVersionName'>>;\n\n\t\t/** Import an existing layer by ARN */\n\t\treadonly fromExistingLayerArn?: string;\n\n\t\t/** Import an existing layer using attributes */\n\t\treadonly fromExistingLayerAttribute?: {\n\t\t\treadonly layerVersionArn: string;\n\t\t\treadonly compatibleRuntimes?: Runtime[];\n\t\t};\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {}\n\n/**\n * CDK construct for Lambda Layer\n *\n * Responsibilities:\n * - Creates a new Lambda layer or imports an existing one\n * - Applies default runtime and architecture compatibility\n * - Exposes the layer ARN as a CloudFormation output\n */\nexport class BaseLambdaLayerConstruct extends Construct {\n\t/** Newly created Lambda Layer (null if importing existing layer) */\n\treadonly layer: LayerVersion;\n\n\t/** Imported Lambda Layer reference (null if creating new layer) */\n\treadonly existingLayer: ILayerVersion;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for layer creation or import\n\t */\n\tconstructor(\n\t\tscope: Construct,\n\t\tid: string,\n\t\tprops?: ILambdaLayerConstructProps,\n\t) {\n\t\tsuper(scope, id);\n\n\t\t/**\n\t\t * Import layer by ARN\n\t\t */\n\t\tif (props?.options?.fromExistingLayerArn) {\n\t\t\tthis.existingLayer = LayerVersion.fromLayerVersionArn(\n\t\t\t\tthis,\n\t\t\t\t`${id}-Arn`,\n\t\t\t\tprops?.options?.fromExistingLayerArn,\n\t\t\t);\n\n\t\t\t/**\n\t\t\t * Import layer using attributes\n\t\t\t */\n\t\t} else if (props?.options?.fromExistingLayerAttribute) {\n\t\t\tthis.existingLayer = LayerVersion.fromLayerVersionAttributes(\n\t\t\t\tthis,\n\t\t\t\t`${id}-Attribute`,\n\t\t\t\tprops?.options?.fromExistingLayerAttribute,\n\t\t\t);\n\n\t\t\t/**\n\t\t\t * Create new Lambda layer\n\t\t\t */\n\t\t} else {\n\t\t\tthis.layer = new LayerVersion(this, id, {\n\t\t\t\t...props.options?.layerOptions,\n\n\t\t\t\t/**\n\t\t\t\t * Default layer code asset\n\t\t\t\t */\n\t\t\t\tcode:\n\t\t\t\t\tprops?.options?.layerOptions?.code || Code.fromAsset('./dist-layer'),\n\n\t\t\t\t/**\n\t\t\t\t * Layer description\n\t\t\t\t */\n\t\t\t\tdescription:\n\t\t\t\t\tprops?.options?.layerOptions?.description ||\n\t\t\t\t\t'Lambda Layer written in NodeJS, NestJS, NodeJS-express, serverless-express',\n\n\t\t\t\t/**\n\t\t\t\t * Supported CPU architectures\n\t\t\t\t */\n\t\t\t\tcompatibleArchitectures: [Architecture.ARM_64, Architecture.X86_64],\n\n\t\t\t\t/**\n\t\t\t\t * Supported runtimes\n\t\t\t\t */\n\t\t\t\tcompatibleRuntimes: [\n\t\t\t\t\tRuntime.NODEJS_22_X,\n\t\t\t\t\tRuntime.NODEJS_24_X,\n\t\t\t\t\tRuntime.NODEJS_LATEST,\n\t\t\t\t],\n\t\t\t} as LayerVersionProps);\n\t\t}\n\n\t\t/**\n\t\t * CloudFormation output exposing the layer ARN\n\t\t * Resolves to either created or imported layer\n\t\t */\n\t\tnew CfnOutput(this, 'LambdaLayerArn', {\n\t\t\tvalue:\n\t\t\t\tprops.options?.fromExistingLayerArn ||\n\t\t\t\tprops.options?.fromExistingLayerAttribute\n\t\t\t\t\t? this.existingLayer.layerVersionArn\n\t\t\t\t\t: this.layer.layerVersionArn,\n\t\t});\n\t}\n}\n","import { App, Stack } from \"aws-cdk-lib\";\n\nimport { IBaseStackProps } from \"../../types\";\nimport { BaseApiGatewayV2Construct, BaseLambdaConstruct, BaseLambdaLayerConstruct } from \"../constructs\";\nimport { CustomException } from \"@incloodsolutions/toolkit\";\nimport { ILayerVersion } from \"aws-cdk-lib/aws-lambda\";\nimport { HttpMethod } from \"aws-cdk-lib/aws-apigatewayv2\";\n\nexport class BaseLambdaApiStack extends Stack {\n\tconstructor(scope: App, id: string, props: IBaseStackProps<{\n\t\tlayerOptions?: {\n\t\t\tname: string;\n\t\t\tversion: number;\n\t\t};\n\t\tlambdaOptions?: {};\n\t\tapiGatewayOptions?: {};\n\t}>) {\n\t\tsuper(scope, id, props);\n\t\tlet layers: ILayerVersion[] = [];\n\n\t\tif (props?.stackOptions?.layerOptions) {\n\t\t\tif (!props.stackOptions?.layerOptions?.name || !props.stackOptions?.layerOptions?.version) {\n\t\t\t\tthrow new CustomException(\"Invalid layer options provided! Both layer 'name' and 'version' are required.\");\n\t\t\t}\n\t\t\tconst { existingLayer } = new BaseLambdaLayerConstruct(\n\t\t\t\tthis,\n\t\t\t\t'layer',\n\t\t\t\t{\n\t\t\t\t\toptions: {\n\t\t\t\t\t\tfromExistingLayerArn: `arn:aws:lambda:${props.env?.region}:${props.env?.account}:layer:${props.stackOptions?.layerOptions?.name}:${props.stackOptions?.layerOptions?.version}`,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t);\n\t\t\tlayers.push(existingLayer);\n\t\t}\n\n\t\tconst { function: lambdaFunction } = new BaseLambdaConstruct(this, 'lambda', {\n\t\t\tstage: props.stackOptions?.stage,\n\t\t\tstackName: props.stackName,\n\t\t\toptions: {\n\t\t\t\tlambdaOptions: { layers },\n\t\t\t},\n\t\t});\n\n\t\tnew BaseApiGatewayV2Construct(this, 'apiGateway', {\n\t\t\thandlerFunctions: [lambdaFunction],\n\t\t\toptions: {\n\t\t\t\tgatewayOptions: {\n\t\t\t\t\tapiName: props.stackName,\n\t\t\t\t\tcorsPreflight: {\n\t\t\t\t\t\tallowOrigins: ['*'],\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\trouteOptions: [\n\t\t\t\t\t{\n\t\t\t\t\t\tpath: '/{proxy+}',\n\t\t\t\t\t\tmethods: [HttpMethod.ANY],\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t});\n\n\t}\n}\n"]}

package/dist/aws-cdk/stacks/lambda-sns.cjs

@@ -0,0 +1,211 @@
+'use strict';
+
+var awsCdkLib = require('aws-cdk-lib');
+var constructs = require('constructs');
+var awsLambda = require('aws-cdk-lib/aws-lambda');
+var toolkit = require('@incloodsolutions/toolkit');
+var awsSns = require('aws-cdk-lib/aws-sns');
+var awsSnsSubscriptions = require('aws-cdk-lib/aws-sns-subscriptions');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseLambdaConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseLambdaConstruct");
+  }
+  /** The created Lambda function instance */
+  function;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for Lambda function
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    const environment = {
+      ...props.options?.lambdaOptions?.environment,
+      NODE_ENV: props.stage,
+      NODE_OPTIONS: "--enable-source-maps",
+      AWS_NODEJS_CONNECTION_REUSE_ENABLED: "1"
+    };
+    toolkit.detectDuplicateProperties({ data: environment });
+    this.function = new awsLambda.Function(this, id, {
+      ...props?.options?.lambdaOptions,
+      /**
+       * Lambda function name
+       * Defaults to "<stackName>" if not provided
+       */
+      functionName: `${props?.options?.lambdaOptions?.functionName || props?.stackName}`,
+      /**
+       * Function description
+       */
+      description: props?.options?.lambdaOptions?.description || "A lambda function",
+      /**
+       * Entry handler for the Lambda function
+       */
+      handler: props?.options?.lambdaOptions?.handler || "lambda.handler",
+      /**
+       * Runtime environment
+       */
+      runtime: props?.options?.lambdaOptions?.runtime || awsLambda.Runtime.NODEJS_24_X,
+      /**
+       * Execution timeout
+       * - 30 seconds in production
+       * - 15 seconds otherwise
+       */
+      timeout: props?.options?.lambdaOptions?.timeout || awsCdkLib.Duration.seconds(
+        props.stage === toolkit.AppEnvironmentEnum.PRODUCTION ? 30 : 15
+      ),
+      /**
+       * Memory allocation (in MB)
+       */
+      memorySize: props?.options?.lambdaOptions?.memorySize || 1024,
+      /**
+       * CPU architecture
+       */
+      architecture: props?.options?.lambdaOptions?.architecture || awsLambda.Architecture.ARM_64,
+      /**
+       * Lambda deployment package source
+       */
+      code: props?.options?.lambdaOptions?.code || awsLambda.Code.fromAsset("dist"),
+      /**
+       * Final merged environment variables
+       */
+      environment
+    });
+    new awsCdkLib.CfnOutput(this, "LambdaFunctionArn", {
+      value: this.function.functionArn
+    });
+  }
+};
+var BaseLambdaLayerConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseLambdaLayerConstruct");
+  }
+  /** Newly created Lambda Layer (null if importing existing layer) */
+  layer;
+  /** Imported Lambda Layer reference (null if creating new layer) */
+  existingLayer;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for layer creation or import
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    if (props?.options?.fromExistingLayerArn) {
+      this.existingLayer = awsLambda.LayerVersion.fromLayerVersionArn(
+        this,
+        `${id}-Arn`,
+        props?.options?.fromExistingLayerArn
+      );
+    } else if (props?.options?.fromExistingLayerAttribute) {
+      this.existingLayer = awsLambda.LayerVersion.fromLayerVersionAttributes(
+        this,
+        `${id}-Attribute`,
+        props?.options?.fromExistingLayerAttribute
+      );
+    } else {
+      this.layer = new awsLambda.LayerVersion(this, id, {
+        ...props.options?.layerOptions,
+        /**
+         * Default layer code asset
+         */
+        code: props?.options?.layerOptions?.code || awsLambda.Code.fromAsset("./dist-layer"),
+        /**
+         * Layer description
+         */
+        description: props?.options?.layerOptions?.description || "Lambda Layer written in NodeJS, NestJS, NodeJS-express, serverless-express",
+        /**
+         * Supported CPU architectures
+         */
+        compatibleArchitectures: [awsLambda.Architecture.ARM_64, awsLambda.Architecture.X86_64],
+        /**
+         * Supported runtimes
+         */
+        compatibleRuntimes: [
+          awsLambda.Runtime.NODEJS_22_X,
+          awsLambda.Runtime.NODEJS_24_X,
+          awsLambda.Runtime.NODEJS_LATEST
+        ]
+      });
+    }
+    new awsCdkLib.CfnOutput(this, "LambdaLayerArn", {
+      value: props.options?.fromExistingLayerArn || props.options?.fromExistingLayerAttribute ? this.existingLayer.layerVersionArn : this.layer.layerVersionArn
+    });
+  }
+};
+var BaseSnsConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseSnsConstruct");
+  }
+  /** The created SNS topic instance */
+  topic;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for topic and subscriptions
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.topic = new awsSns.Topic(this, id, props.options?.topicOptions);
+    if (props.options?.targetFunctions?.length) {
+      props.options.targetFunctions.forEach((targetFunction) => {
+        this.topic.addSubscription(
+          /**
+           * Lambda subscription target
+           */
+          new awsSnsSubscriptions.LambdaSubscription(targetFunction)
+        );
+      });
+    }
+    this.topic.applyRemovalPolicy(awsCdkLib.RemovalPolicy.DESTROY);
+    new awsCdkLib.CfnOutput(this, "SnsTopicArn", {
+      value: this.topic.topicArn
+    });
+  }
+};
+var BaseLambdaSnsStack = class extends awsCdkLib.Stack {
+  static {
+    __name(this, "BaseLambdaSnsStack");
+  }
+  constructor(scope, id, props) {
+    super(scope, id, props);
+    let layers = [];
+    if (props?.stackOptions?.layerOptions) {
+      if (!props.stackOptions?.layerOptions?.name || !props.stackOptions?.layerOptions?.version) {
+        throw new toolkit.CustomException("Invalid layer options provided");
+      }
+      const { existingLayer } = new BaseLambdaLayerConstruct(
+        this,
+        "layer",
+        {
+          options: {
+            fromExistingLayerArn: `arn:aws:lambda:${props.env?.region}:${props.env?.account}:layer:${props.stackOptions?.layerOptions?.name}:${props.stackOptions?.layerOptions?.version}`
+          }
+        }
+      );
+      layers.push(existingLayer);
+    }
+    const { function: lambdaFunction } = new BaseLambdaConstruct(this, "lambda", {
+      stage: props.stackOptions?.stage,
+      stackName: props.stackName,
+      options: {
+        lambdaOptions: { layers }
+      }
+    });
+    new BaseSnsConstruct(this, "sns", {
+      options: {
+        targetFunctions: [lambdaFunction],
+        topicOptions: {
+          ...props?.stackOptions?.topicOptions,
+          topicName: props?.stackOptions?.topicOptions?.topicName || props.stackName
+        }
+      }
+    });
+  }
+};
+
+exports.BaseLambdaSnsStack = BaseLambdaSnsStack;
+//# sourceMappingURL=lambda-sns.cjs.map
+//# sourceMappingURL=lambda-sns.cjs.map

package/dist/aws-cdk/stacks/lambda-sns.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/lambda-construct.ts","../../../src/aws/cdk/constructs/lambda-layer-construct.ts","../../../src/aws/cdk/constructs/sns-construct.ts","../../../src/aws/cdk/stacks/lambda-sns-stack.ts"],"names":["Construct","detectDuplicateProperties","Function","Runtime","Duration","AppEnvironmentEnum","Architecture","Code","CfnOutput","LayerVersion","Topic","LambdaSubscription","RemovalPolicy","Stack","CustomException"],"mappings":";;;;;;;;;;;AAwCO,IAAM,mBAAA,GAAN,cAAkCA,oBAAA,CAAU;AAAA,EAxCnD;AAwCmD,IAAA,MAAA,CAAA,IAAA,EAAA,qBAAA,CAAA;AAAA;AAAA;AAAA,EAEzC,QAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA8B;AACvE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAUf,IAAA,MAAM,WAAA,GAAc;AAAA,MACnB,GAAG,KAAA,CAAM,OAAA,EAAS,aAAA,EAAe,WAAA;AAAA,MACjC,UAAU,KAAA,CAAM,KAAA;AAAA,MAChB,YAAA,EAAc,sBAAA;AAAA,MACd,mCAAA,EAAqC;AAAA,KACtC;AAKA,IAAAC,iCAAA,CAA0B,EAAE,IAAA,EAAM,WAAA,EAAa,CAAA;AAE/C,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kBAAA,CAAS,IAAA,EAAM,EAAA,EAAI;AAAA,MACtC,GAAG,OAAO,OAAA,EAAS,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMnB,cAAc,CAAA,EAAG,KAAA,EAAO,SAAS,aAAA,EAAe,YAAA,IAAgB,OAAO,SAAS,CAAA,CAAA;AAAA;AAAA;AAAA;AAAA,MAKhF,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAAA,IAAe,mBAAA;AAAA;AAAA;AAAA;AAAA,MAK/C,OAAA,EAAS,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,OAAA,IAAW,gBAAA;AAAA;AAAA;AAAA;AAAA,MAKnD,OAAA,EAAS,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAAWC,iBAAA,CAAQ,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAO3D,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAC/BC,kBAAA,CAAS,OAAA;AAAA,QACR,KAAA,CAAM,KAAA,KAAUC,0BAAA,CAAmB,UAAA,GAAa,EAAA,GAAK;AAAA,OACtD;AAAA;AAAA;AAAA;AAAA,MAKD,UAAA,EAAY,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,UAAA,IAAc,IAAA;AAAA;AAAA;AAAA;AAAA,MAKzD,YAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,gBAAgBC,sBAAA,CAAa,MAAA;AAAA;AAAA;AAAA;AAAA,MAK7D,MAAM,KAAA,EAAO,OAAA,EAAS,eAAe,IAAA,IAAQC,cAAA,CAAK,UAAU,MAAM,CAAA;AAAA;AAAA;AAAA;AAAA,MAKlE;AAAA,KACA,CAAA;AAKD,IAAA,IAAIC,mBAAA,CAAU,MAAM,mBAAA,EAAqB;AAAA,MACxC,KAAA,EAAO,KAAK,QAAA,CAAS;AAAA,KACrB,CAAA;AAAA,EACF;AACD,CAAA;ACnFO,IAAM,wBAAA,GAAN,cAAuCR,oBAAAA,CAAU;AAAA,EAtDxD;AAsDwD,IAAA,MAAA,CAAA,IAAA,EAAA,0BAAA,CAAA;AAAA;AAAA;AAAA,EAE9C,KAAA;AAAA;AAAA,EAGA,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CACC,KAAA,EACA,EAAA,EACA,KAAA,EACC;AACD,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAKf,IAAA,IAAI,KAAA,EAAO,SAAS,oBAAA,EAAsB;AACzC,MAAA,IAAA,CAAK,gBAAgBS,sBAAA,CAAa,mBAAA;AAAA,QACjC,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,IAAA,CAAA;AAAA,QACL,OAAO,OAAA,EAAS;AAAA,OACjB;AAAA,IAKD,CAAA,MAAA,IAAW,KAAA,EAAO,OAAA,EAAS,0BAAA,EAA4B;AACtD,MAAA,IAAA,CAAK,gBAAgBA,sBAAA,CAAa,0BAAA;AAAA,QACjC,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,UAAA,CAAA;AAAA,QACL,OAAO,OAAA,EAAS;AAAA,OACjB;AAAA,IAKD,CAAA,MAAO;AACN,MAAA,IAAA,CAAK,KAAA,GAAQ,IAAIA,sBAAA,CAAa,IAAA,EAAM,EAAA,EAAI;AAAA,QACvC,GAAG,MAAM,OAAA,EAAS,YAAA;AAAA;AAAA;AAAA;AAAA,QAKlB,MACC,KAAA,EAAO,OAAA,EAAS,cAAc,IAAA,IAAQF,cAAAA,CAAK,UAAU,cAAc,CAAA;AAAA;AAAA;AAAA;AAAA,QAKpE,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,YAAA,EAAc,WAAA,IAC9B,4EAAA;AAAA;AAAA;AAAA;AAAA,QAKD,uBAAA,EAAyB,CAACD,sBAAAA,CAAa,MAAA,EAAQA,uBAAa,MAAM,CAAA;AAAA;AAAA;AAAA;AAAA,QAKlE,kBAAA,EAAoB;AAAA,UACnBH,iBAAAA,CAAQ,WAAA;AAAA,UACRA,iBAAAA,CAAQ,WAAA;AAAA,UACRA,iBAAAA,CAAQ;AAAA;AACT,OACqB,CAAA;AAAA,IACvB;AAMA,IAAA,IAAIK,mBAAAA,CAAU,MAAM,gBAAA,EAAkB;AAAA,MACrC,KAAA,EACC,KAAA,CAAM,OAAA,EAAS,oBAAA,IACf,KAAA,CAAM,OAAA,EAAS,0BAAA,GACZ,IAAA,CAAK,aAAA,CAAc,eAAA,GACnB,IAAA,CAAK,KAAA,CAAM;AAAA,KACf,CAAA;AAAA,EACF;AACD,CAAA;ACtGO,IAAM,gBAAA,GAAN,cAA+BR,oBAAAA,CAAU;AAAA,EAvChD;AAuCgD,IAAA,MAAA,CAAA,IAAA,EAAA,kBAAA,CAAA;AAAA;AAAA;AAAA,EAEtC,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA2B;AACpE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,QAAQ,IAAIU,YAAA,CAAM,MAAM,EAAA,EAAI,KAAA,CAAM,SAAS,YAAY,CAAA;AAK5D,IAAA,IAAI,KAAA,CAAM,OAAA,EAAS,eAAA,EAAiB,MAAA,EAAQ;AAC3C,MAAA,KAAA,CAAM,OAAA,CAAQ,eAAA,CAAgB,OAAA,CAAQ,CAAC,cAAA,KAAmB;AACzD,QAAA,IAAA,CAAK,KAAA,CAAM,eAAA;AAAA;AAAA;AAAA;AAAA,UAIV,IAAIC,uCAAmB,cAAc;AAAA,SACtC;AAAA,MACD,CAAC,CAAA;AAAA,IACF;AAKA,IAAA,IAAA,CAAK,KAAA,CAAM,kBAAA,CAAmBC,uBAAA,CAAc,OAAO,CAAA;AAKnD,IAAA,IAAIJ,mBAAAA,CAAU,MAAM,aAAA,EAAe;AAAA,MAClC,KAAA,EAAO,KAAK,KAAA,CAAM;AAAA,KAClB,CAAA;AAAA,EACF;AACD,CAAA;ACvEO,IAAM,kBAAA,GAAN,cAAiCK,eAAA,CAAM;AAAA,EAR9C;AAQ8C,IAAA,MAAA,CAAA,IAAA,EAAA,oBAAA,CAAA;AAAA;AAAA,EAC7C,WAAA,CAAY,KAAA,EAAY,EAAA,EAAY,KAAA,EAOhC;AACH,IAAA,KAAA,CAAM,KAAA,EAAO,IAAI,KAAK,CAAA;AACtB,IAAA,IAAI,SAA0B,EAAC;AAE/B,IAAA,IAAI,KAAA,EAAO,cAAc,YAAA,EAAc;AACtC,MAAA,IAAI,CAAC,MAAM,YAAA,EAAc,YAAA,EAAc,QAAQ,CAAC,KAAA,CAAM,YAAA,EAAc,YAAA,EAAc,OAAA,EAAS;AAC1F,QAAA,MAAM,IAAIC,wBAAgB,gCAAgC,CAAA;AAAA,MAC3D;AACA,MAAA,MAAM,EAAE,aAAA,EAAc,GAAI,IAAI,wBAAA;AAAA,QAC7B,IAAA;AAAA,QACA,OAAA;AAAA,QACA;AAAA,UACC,OAAA,EAAS;AAAA,YACR,sBAAsB,CAAA,eAAA,EAAkB,KAAA,CAAM,KAAK,MAAM,CAAA,CAAA,EAAI,MAAM,GAAA,EAAK,OAAO,CAAA,OAAA,EAAU,KAAA,CAAM,cAAc,YAAA,EAAc,IAAI,IAAI,KAAA,CAAM,YAAA,EAAc,cAAc,OAAO,CAAA;AAAA;AAC7K;AACD,OACD;AACA,MAAA,MAAA,CAAO,KAAK,aAAa,CAAA;AAAA,IAC1B;AAEA,IAAA,MAAM,EAAE,QAAA,EAAU,cAAA,KAAmB,IAAI,mBAAA,CAAoB,MAAM,QAAA,EAAU;AAAA,MAC5E,KAAA,EAAO,MAAM,YAAA,EAAc,KAAA;AAAA,MAC3B,WAAW,KAAA,CAAM,SAAA;AAAA,MACjB,OAAA,EAAS;AAAA,QACR,aAAA,EAAe,EAAE,MAAA;AAAO;AACzB,KACA,CAAA;AAED,IAAA,IAAI,gBAAA,CAAiB,MAAM,KAAA,EAAO;AAAA,MACjC,OAAA,EAAS;AAAA,QACR,eAAA,EAAiB,CAAC,cAAc,CAAA;AAAA,QAChC,YAAA,EAAc;AAAA,UACb,GAAG,OAAO,YAAA,EAAc,YAAA;AAAA,UACxB,SAAA,EAAW,KAAA,EAAO,YAAA,EAAc,YAAA,EAAc,aAAa,KAAA,CAAM;AAAA;AAClE;AACD,KACA,CAAA;AAAA,EAEF;AACD","file":"lambda-sns.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, Duration } from 'aws-cdk-lib';\nimport {\n\tArchitecture,\n\tCode,\n\tFunction,\n\tFunctionProps,\n\tRuntime,\n} from 'aws-cdk-lib/aws-lambda';\n\nimport {\n\tdetectDuplicateProperties,\n\tAppEnvironmentEnum,\n} from '@incloodsolutions/toolkit';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseLambdaConstruct\n *\n * Provides configuration for creating a Lambda function\n * with optional overrides for runtime, memory, timeout, and environment.\n */\ninterface ILambdaConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** Partial Lambda configuration options */\n\t\treadonly lambdaOptions: Partial<FunctionProps>;\n\t}>,\n\t'appName'\n> {}\n\n/**\n * CDK construct for AWS Lambda function\n *\n * Responsibilities:\n * - Creates a Lambda function with sensible defaults\n * - Merges and validates environment variables\n * - Applies stage-based configuration (e.g. timeout)\n * - Exposes the function ARN as a CloudFormation output\n */\nexport class BaseLambdaConstruct extends Construct {\n\t/** The created Lambda function instance */\n\treadonly function: Function;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for Lambda function\n\t */\n\tconstructor(scope: Construct, id: string, props: ILambdaConstructProps) {\n\t\tsuper(scope, id);\n\n\t\t/**\n\t\t * Environment variables for the Lambda function\n\t\t *\n\t\t * Includes:\n\t\t * - User-defined variables\n\t\t * - NODE_ENV derived from stage\n\t\t * - Node.js runtime optimisations\n\t\t */\n\t\tconst environment = {\n\t\t\t...props.options?.lambdaOptions?.environment,\n\t\t\tNODE_ENV: props.stage,\n\t\t\tNODE_OPTIONS: '--enable-source-maps',\n\t\t\tAWS_NODEJS_CONNECTION_REUSE_ENABLED: '1',\n\t\t};\n\n\t\t/**\n\t\t * Validate environment variables for duplicate keys\n\t\t */\n\t\tdetectDuplicateProperties({ data: environment });\n\n\t\tthis.function = new Function(this, id, {\n\t\t\t...props?.options?.lambdaOptions,\n\n\t\t\t/**\n\t\t\t * Lambda function name\n\t\t\t * Defaults to \"<stackName>\" if not provided\n\t\t\t */\n\t\t\tfunctionName: `${props?.options?.lambdaOptions?.functionName || props?.stackName}`,\n\n\t\t\t/**\n\t\t\t * Function description\n\t\t\t */\n\t\t\tdescription:\n\t\t\t\tprops?.options?.lambdaOptions?.description || 'A lambda function',\n\n\t\t\t/**\n\t\t\t * Entry handler for the Lambda function\n\t\t\t */\n\t\t\thandler: props?.options?.lambdaOptions?.handler || 'lambda.handler',\n\n\t\t\t/**\n\t\t\t * Runtime environment\n\t\t\t */\n\t\t\truntime: props?.options?.lambdaOptions?.runtime || Runtime.NODEJS_24_X,\n\n\t\t\t/**\n\t\t\t * Execution timeout\n\t\t\t * - 30 seconds in production\n\t\t\t * - 15 seconds otherwise\n\t\t\t */\n\t\t\ttimeout:\n\t\t\t\tprops?.options?.lambdaOptions?.timeout ||\n\t\t\t\tDuration.seconds(\n\t\t\t\t\tprops.stage === AppEnvironmentEnum.PRODUCTION ? 30 : 15,\n\t\t\t\t),\n\n\t\t\t/**\n\t\t\t * Memory allocation (in MB)\n\t\t\t */\n\t\t\tmemorySize: props?.options?.lambdaOptions?.memorySize || 1024,\n\n\t\t\t/**\n\t\t\t * CPU architecture\n\t\t\t */\n\t\t\tarchitecture:\n\t\t\t\tprops?.options?.lambdaOptions?.architecture || Architecture.ARM_64,\n\n\t\t\t/**\n\t\t\t * Lambda deployment package source\n\t\t\t */\n\t\t\tcode: props?.options?.lambdaOptions?.code || Code.fromAsset('dist'),\n\n\t\t\t/**\n\t\t\t * Final merged environment variables\n\t\t\t */\n\t\t\tenvironment,\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the Lambda function ARN\n\t\t */\n\t\tnew CfnOutput(this, 'LambdaFunctionArn', {\n\t\t\tvalue: this.function.functionArn,\n\t\t});\n\t}\n}\n","import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport {\n\tArchitecture,\n\tCode,\n\tILayerVersion,\n\tLayerVersion,\n\tLayerVersionProps,\n\tRuntime,\n} from 'aws-cdk-lib/aws-lambda';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseLambdaLayerConstruct\n *\n * Provides configuration for:\n * - Creating a new Lambda Layer\n * - Importing an existing layer by ARN or attributes\n */\ninterface ILambdaLayerConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/**\n\t\t * Configuration for creating a new Lambda layer\n\t\t *\n\t\t * Note:\n\t\t * - `layerVersionName` is required\n\t\t * - `compatibleArchitectures` is managed internally\n\t\t */\n\t\treadonly layerOptions?: Partial<\n\t\t\tOmit<LayerVersionProps, 'layerVersionName' | 'compatibleArchitectures'>\n\t\t> &\n\t\t\tRequired<Pick<LayerVersionProps, 'layerVersionName'>>;\n\n\t\t/** Import an existing layer by ARN */\n\t\treadonly fromExistingLayerArn?: string;\n\n\t\t/** Import an existing layer using attributes */\n\t\treadonly fromExistingLayerAttribute?: {\n\t\t\treadonly layerVersionArn: string;\n\t\t\treadonly compatibleRuntimes?: Runtime[];\n\t\t};\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {}\n\n/**\n * CDK construct for Lambda Layer\n *\n * Responsibilities:\n * - Creates a new Lambda layer or imports an existing one\n * - Applies default runtime and architecture compatibility\n * - Exposes the layer ARN as a CloudFormation output\n */\nexport class BaseLambdaLayerConstruct extends Construct {\n\t/** Newly created Lambda Layer (null if importing existing layer) */\n\treadonly layer: LayerVersion;\n\n\t/** Imported Lambda Layer reference (null if creating new layer) */\n\treadonly existingLayer: ILayerVersion;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for layer creation or import\n\t */\n\tconstructor(\n\t\tscope: Construct,\n\t\tid: string,\n\t\tprops?: ILambdaLayerConstructProps,\n\t) {\n\t\tsuper(scope, id);\n\n\t\t/**\n\t\t * Import layer by ARN\n\t\t */\n\t\tif (props?.options?.fromExistingLayerArn) {\n\t\t\tthis.existingLayer = LayerVersion.fromLayerVersionArn(\n\t\t\t\tthis,\n\t\t\t\t`${id}-Arn`,\n\t\t\t\tprops?.options?.fromExistingLayerArn,\n\t\t\t);\n\n\t\t\t/**\n\t\t\t * Import layer using attributes\n\t\t\t */\n\t\t} else if (props?.options?.fromExistingLayerAttribute) {\n\t\t\tthis.existingLayer = LayerVersion.fromLayerVersionAttributes(\n\t\t\t\tthis,\n\t\t\t\t`${id}-Attribute`,\n\t\t\t\tprops?.options?.fromExistingLayerAttribute,\n\t\t\t);\n\n\t\t\t/**\n\t\t\t * Create new Lambda layer\n\t\t\t */\n\t\t} else {\n\t\t\tthis.layer = new LayerVersion(this, id, {\n\t\t\t\t...props.options?.layerOptions,\n\n\t\t\t\t/**\n\t\t\t\t * Default layer code asset\n\t\t\t\t */\n\t\t\t\tcode:\n\t\t\t\t\tprops?.options?.layerOptions?.code || Code.fromAsset('./dist-layer'),\n\n\t\t\t\t/**\n\t\t\t\t * Layer description\n\t\t\t\t */\n\t\t\t\tdescription:\n\t\t\t\t\tprops?.options?.layerOptions?.description ||\n\t\t\t\t\t'Lambda Layer written in NodeJS, NestJS, NodeJS-express, serverless-express',\n\n\t\t\t\t/**\n\t\t\t\t * Supported CPU architectures\n\t\t\t\t */\n\t\t\t\tcompatibleArchitectures: [Architecture.ARM_64, Architecture.X86_64],\n\n\t\t\t\t/**\n\t\t\t\t * Supported runtimes\n\t\t\t\t */\n\t\t\t\tcompatibleRuntimes: [\n\t\t\t\t\tRuntime.NODEJS_22_X,\n\t\t\t\t\tRuntime.NODEJS_24_X,\n\t\t\t\t\tRuntime.NODEJS_LATEST,\n\t\t\t\t],\n\t\t\t} as LayerVersionProps);\n\t\t}\n\n\t\t/**\n\t\t * CloudFormation output exposing the layer ARN\n\t\t * Resolves to either created or imported layer\n\t\t */\n\t\tnew CfnOutput(this, 'LambdaLayerArn', {\n\t\t\tvalue:\n\t\t\t\tprops.options?.fromExistingLayerArn ||\n\t\t\t\tprops.options?.fromExistingLayerAttribute\n\t\t\t\t\t? this.existingLayer.layerVersionArn\n\t\t\t\t\t: this.layer.layerVersionArn,\n\t\t});\n\t}\n}\n","import { Construct } from 'constructs';\nimport { Function } from 'aws-cdk-lib/aws-lambda';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { Topic, TopicProps } from 'aws-cdk-lib/aws-sns';\nimport { LambdaSubscription } from 'aws-cdk-lib/aws-sns-subscriptions';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseSnsConstruct\n *\n * Provides configuration for:\n * - SNS topic creation\n * - Lambda subscriptions\n */\ninterface ISnsConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** SNS topic configuration options */\n\t\treadonly topicOptions: TopicProps;\n\n\t\t/**\n\t\t * Lambda functions to subscribe to the topic\n\t\t *\n\t\t * Each function will receive messages published to the topic\n\t\t */\n\t\treadonly targetFunctions: Function[];\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {}\n\n/**\n * CDK construct for SNS topic with Lambda subscriptions\n *\n * Responsibilities:\n * - Creates an SNS topic with configurable options\n * - Subscribes one or more Lambda functions to the topic\n * - Applies a removal policy\n * - Exposes the topic ARN as a CloudFormation output\n */\nexport class BaseSnsConstruct extends Construct {\n\t/** The created SNS topic instance */\n\treadonly topic: Topic;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for topic and subscriptions\n\t */\n\tconstructor(scope: Construct, id: string, props: ISnsConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.topic = new Topic(this, id, props.options?.topicOptions);\n\n\t\t/**\n\t\t * Attach Lambda subscriptions to the topic\n\t\t */\n\t\tif (props.options?.targetFunctions?.length) {\n\t\t\tprops.options.targetFunctions.forEach((targetFunction) => {\n\t\t\t\tthis.topic.addSubscription(\n\t\t\t\t\t/**\n\t\t\t\t\t * Lambda subscription target\n\t\t\t\t\t */\n\t\t\t\t\tnew LambdaSubscription(targetFunction),\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.topic.applyRemovalPolicy(RemovalPolicy.DESTROY);\n\n\t\t/**\n\t\t * CloudFormation output exposing the topic ARN\n\t\t */\n\t\tnew CfnOutput(this, 'SnsTopicArn', {\n\t\t\tvalue: this.topic.topicArn,\n\t\t});\n\t}\n}\n","import { App, Stack } from \"aws-cdk-lib\";\n\nimport { IBaseStackProps } from \"../../types\";\nimport { BaseLambdaConstruct, BaseLambdaLayerConstruct, BaseSnsConstruct } from \"../constructs\";\nimport { CustomException } from \"@incloodsolutions/toolkit\";\nimport { ILayerVersion } from \"aws-cdk-lib/aws-lambda\";\nimport { TopicProps } from \"aws-cdk-lib/aws-sns\";\n\nexport class BaseLambdaSnsStack extends Stack {\n\tconstructor(scope: App, id: string, props: IBaseStackProps<{\n\t\tlayerOptions?: {\n\t\t\tname: string;\n\t\t\tversion: number;\n\t\t};\n\t\tlambdaOptions?: {};\n\t\ttopicOptions?: TopicProps;\n\t}>) {\n\t\tsuper(scope, id, props);\n\t\tlet layers: ILayerVersion[] = [];\n\n\t\tif (props?.stackOptions?.layerOptions) {\n\t\t\tif (!props.stackOptions?.layerOptions?.name || !props.stackOptions?.layerOptions?.version) {\n\t\t\t\tthrow new CustomException(\"Invalid layer options provided\");\n\t\t\t}\n\t\t\tconst { existingLayer } = new BaseLambdaLayerConstruct(\n\t\t\t\tthis,\n\t\t\t\t'layer',\n\t\t\t\t{\n\t\t\t\t\toptions: {\n\t\t\t\t\t\tfromExistingLayerArn: `arn:aws:lambda:${props.env?.region}:${props.env?.account}:layer:${props.stackOptions?.layerOptions?.name}:${props.stackOptions?.layerOptions?.version}`,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t);\n\t\t\tlayers.push(existingLayer);\n\t\t}\n\n\t\tconst { function: lambdaFunction } = new BaseLambdaConstruct(this, 'lambda', {\n\t\t\tstage: props.stackOptions?.stage,\n\t\t\tstackName: props.stackName,\n\t\t\toptions: {\n\t\t\t\tlambdaOptions: { layers },\n\t\t\t},\n\t\t});\n\n\t\tnew BaseSnsConstruct(this, 'sns', {\n\t\t\toptions: {\n\t\t\t\ttargetFunctions: [lambdaFunction],\n\t\t\t\ttopicOptions: {\n\t\t\t\t\t...props?.stackOptions?.topicOptions,\n\t\t\t\t\ttopicName: props?.stackOptions?.topicOptions?.topicName || props.stackName,\n\t\t\t\t},\n\t\t\t}\n\t\t});\n\n\t}\n}"]}

package/dist/aws-cdk/stacks/lambda-sns.d.cts

@@ -0,0 +1,17 @@
+import { Stack, App } from 'aws-cdk-lib';
+import { IBaseStackProps } from '../../aws-types.cjs';
+import { TopicProps } from 'aws-cdk-lib/aws-sns';
+import '@incloodsolutions/toolkit';
+
+declare class BaseLambdaSnsStack extends Stack {
+    constructor(scope: App, id: string, props: IBaseStackProps<{
+        layerOptions?: {
+            name: string;
+            version: number;
+        };
+        lambdaOptions?: {};
+        topicOptions?: TopicProps;
+    }>);
+}
+
+export { BaseLambdaSnsStack };

package/dist/aws-cdk/stacks/lambda-sns.d.ts

@@ -0,0 +1,17 @@
+import { Stack, App } from 'aws-cdk-lib';
+import { IBaseStackProps } from '../../aws-types.js';
+import { TopicProps } from 'aws-cdk-lib/aws-sns';
+import '@incloodsolutions/toolkit';
+
+declare class BaseLambdaSnsStack extends Stack {
+    constructor(scope: App, id: string, props: IBaseStackProps<{
+        layerOptions?: {
+            name: string;
+            version: number;
+        };
+        lambdaOptions?: {};
+        topicOptions?: TopicProps;
+    }>);
+}
+
+export { BaseLambdaSnsStack };