@incloodsolutions/devkit 0.0.2 → 0.0.3

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

@@ -0,0 +1,82 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsLambda = require('aws-cdk-lib/aws-lambda');
+var toolkit = require('@incloodsolutions/toolkit');
+
+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>-handler" if not provided
+       */
+      functionName: `${props?.options?.lambdaOptions?.functionName || props?.stackName}-handler`,
+      /**
+       * 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
+    });
+  }
+};
+
+exports.BaseLambdaConstruct = BaseLambdaConstruct;
+//# sourceMappingURL=lambda-construct.cjs.map
+//# sourceMappingURL=lambda-construct.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/lambda-construct.ts"],"names":["Construct","detectDuplicateProperties","Function","Runtime","Duration","AppEnvironmentEnum","Architecture","Code","CfnOutput"],"mappings":";;;;;;;;;AA4BO,IAAM,mBAAA,GAAN,cAAkCA,oBAAA,CAAU;AAAA,EA5BnD;AA4BmD,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,cACC,CAAA,EAAG,KAAA,EAAO,SAAS,aAAA,EAAe,YAAA,IAAgB,OAAO,SAAS,CAAA,QAAA,CAAA;AAAA;AAAA;AAAA;AAAA,MAKnE,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAAA,IAC5B,mBAAA;AAAA;AAAA;AAAA;AAAA,MAKJ,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,OAAA,IAC5B,gBAAA;AAAA;AAAA;AAAA;AAAA,MAKJ,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAC5BC,iBAAA,CAAQ,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOZ,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAC5BC,kBAAA,CAAS,OAAA;AAAA,QACX,KAAA,CAAM,KAAA,KAAUC,0BAAA,CAAmB,UAAA,GAAa,EAAA,GAAK;AAAA,OACtD;AAAA;AAAA;AAAA;AAAA,MAKD,UAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,UAAA,IAC5B,IAAA;AAAA;AAAA;AAAA;AAAA,MAKJ,YAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,gBAC5BC,sBAAA,CAAa,MAAA;AAAA;AAAA;AAAA;AAAA,MAKjB,MACC,KAAA,EAAO,OAAA,EAAS,eAAe,IAAA,IAC5BC,cAAA,CAAK,UAAU,MAAM,CAAA;AAAA;AAAA;AAAA;AAAA,MAKzB;AAAA,KACA,CAAA;AAKD,IAAA,IAAIC,mBAAA,CAAU,MAAM,mBAAA,EAAqB;AAAA,MACxC,KAAA,EAAO,KAAK,QAAA,CAAS;AAAA,KACrB,CAAA;AAAA,EACF;AACD","file":"lambda-construct.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, Duration } from 'aws-cdk-lib';\nimport { Architecture, Code, Function, FunctionProps, Runtime } from 'aws-cdk-lib/aws-lambda';\n\nimport { detectDuplicateProperties, AppEnvironmentEnum } 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<IBaseCdkConstructProps<{\n\t/** Partial Lambda configuration options */\n\treadonly lambdaOptions: Partial<FunctionProps>;\n}>, 'appName'> { }\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>-handler\" if not provided\n\t\t\t */\n\t\t\tfunctionName:\n\t\t\t\t`${props?.options?.lambdaOptions?.functionName || props?.stackName}-handler`,\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\n\t\t\t\t|| '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:\n\t\t\t\tprops?.options?.lambdaOptions?.handler\n\t\t\t\t|| 'lambda.handler',\n\n\t\t\t/**\n\t\t\t * Runtime environment\n\t\t\t */\n\t\t\truntime:\n\t\t\t\tprops?.options?.lambdaOptions?.runtime\n\t\t\t\t|| 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\t|| Duration.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:\n\t\t\t\tprops?.options?.lambdaOptions?.memorySize\n\t\t\t\t|| 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\n\t\t\t\t|| Architecture.ARM_64,\n\n\t\t\t/**\n\t\t\t * Lambda deployment package source\n\t\t\t */\n\t\t\tcode:\n\t\t\t\tprops?.options?.lambdaOptions?.code\n\t\t\t\t|| 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}"]}

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

@@ -0,0 +1,37 @@
+import { Construct } from 'constructs';
+import { Function, FunctionProps } from 'aws-cdk-lib/aws-lambda';
+import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseLambdaConstruct };

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

@@ -0,0 +1,37 @@
+import { Construct } from 'constructs';
+import { Function, FunctionProps } from 'aws-cdk-lib/aws-lambda';
+import { IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseLambdaConstruct };

package/dist/aws/cdk/constructs/lambda-construct.js

@@ -0,0 +1,80 @@
+import { Construct } from 'constructs';
+import { Duration, CfnOutput } from 'aws-cdk-lib';
+import { Function, Architecture, Runtime, Code } from 'aws-cdk-lib/aws-lambda';
+import { detectDuplicateProperties, AppEnvironmentEnum } from '@incloodsolutions/toolkit';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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>-handler" if not provided
+       */
+      functionName: `${props?.options?.lambdaOptions?.functionName || props?.stackName}-handler`,
+      /**
+       * 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
+    });
+  }
+};
+
+export { BaseLambdaConstruct };
+//# sourceMappingURL=lambda-construct.js.map
+//# sourceMappingURL=lambda-construct.js.map

package/dist/aws/cdk/constructs/lambda-construct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/lambda-construct.ts"],"names":[],"mappings":";;;;;;;AA4BO,IAAM,mBAAA,GAAN,cAAkC,SAAA,CAAU;AAAA,EA5BnD;AA4BmD,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,IAAA,yBAAA,CAA0B,EAAE,IAAA,EAAM,WAAA,EAAa,CAAA;AAE/C,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,QAAA,CAAS,IAAA,EAAM,EAAA,EAAI;AAAA,MACtC,GAAG,OAAO,OAAA,EAAS,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMnB,cACC,CAAA,EAAG,KAAA,EAAO,SAAS,aAAA,EAAe,YAAA,IAAgB,OAAO,SAAS,CAAA,QAAA,CAAA;AAAA;AAAA;AAAA;AAAA,MAKnE,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAAA,IAC5B,mBAAA;AAAA;AAAA;AAAA;AAAA,MAKJ,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,OAAA,IAC5B,gBAAA;AAAA;AAAA;AAAA;AAAA,MAKJ,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAC5B,OAAA,CAAQ,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOZ,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAC5B,QAAA,CAAS,OAAA;AAAA,QACX,KAAA,CAAM,KAAA,KAAU,kBAAA,CAAmB,UAAA,GAAa,EAAA,GAAK;AAAA,OACtD;AAAA;AAAA;AAAA;AAAA,MAKD,UAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,UAAA,IAC5B,IAAA;AAAA;AAAA;AAAA;AAAA,MAKJ,YAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,gBAC5B,YAAA,CAAa,MAAA;AAAA;AAAA;AAAA;AAAA,MAKjB,MACC,KAAA,EAAO,OAAA,EAAS,eAAe,IAAA,IAC5B,IAAA,CAAK,UAAU,MAAM,CAAA;AAAA;AAAA;AAAA;AAAA,MAKzB;AAAA,KACA,CAAA;AAKD,IAAA,IAAI,SAAA,CAAU,MAAM,mBAAA,EAAqB;AAAA,MACxC,KAAA,EAAO,KAAK,QAAA,CAAS;AAAA,KACrB,CAAA;AAAA,EACF;AACD","file":"lambda-construct.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, Duration } from 'aws-cdk-lib';\nimport { Architecture, Code, Function, FunctionProps, Runtime } from 'aws-cdk-lib/aws-lambda';\n\nimport { detectDuplicateProperties, AppEnvironmentEnum } 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<IBaseCdkConstructProps<{\n\t/** Partial Lambda configuration options */\n\treadonly lambdaOptions: Partial<FunctionProps>;\n}>, 'appName'> { }\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>-handler\" if not provided\n\t\t\t */\n\t\t\tfunctionName:\n\t\t\t\t`${props?.options?.lambdaOptions?.functionName || props?.stackName}-handler`,\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\n\t\t\t\t|| '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:\n\t\t\t\tprops?.options?.lambdaOptions?.handler\n\t\t\t\t|| 'lambda.handler',\n\n\t\t\t/**\n\t\t\t * Runtime environment\n\t\t\t */\n\t\t\truntime:\n\t\t\t\tprops?.options?.lambdaOptions?.runtime\n\t\t\t\t|| 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\t|| Duration.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:\n\t\t\t\tprops?.options?.lambdaOptions?.memorySize\n\t\t\t\t|| 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\n\t\t\t\t|| Architecture.ARM_64,\n\n\t\t\t/**\n\t\t\t * Lambda deployment package source\n\t\t\t */\n\t\t\tcode:\n\t\t\t\tprops?.options?.lambdaOptions?.code\n\t\t\t\t|| 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}"]}

package/dist/aws/cdk/constructs/lambda-layer-construct.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsLambda = require('aws-cdk-lib/aws-lambda');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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
+    });
+  }
+};
+
+exports.BaseLambdaLayerConstruct = BaseLambdaLayerConstruct;
+//# sourceMappingURL=lambda-layer-construct.cjs.map
+//# sourceMappingURL=lambda-layer-construct.cjs.map

package/dist/aws/cdk/constructs/lambda-layer-construct.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/lambda-layer-construct.ts"],"names":["Construct","LayerVersion","Code","Architecture","Runtime","CfnOutput"],"mappings":";;;;;;;;AA0CO,IAAM,wBAAA,GAAN,cAAuCA,oBAAA,CAAU;AAAA,EA1CxD;AA0CwD,IAAA,MAAA,CAAA,IAAA,EAAA,0BAAA,CAAA;AAAA;AAAA;AAAA,EAE9C,KAAA;AAAA;AAAA,EAGA,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAoC;AAC7E,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAKf,IAAA,IAAI,KAAA,EAAO,SAAS,oBAAA,EAAsB;AACzC,MAAA,IAAA,CAAK,gBAAgBC,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,IAC3BC,cAAA,CAAK,UAAU,cAAc,CAAA;AAAA;AAAA;AAAA;AAAA,QAKjC,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,YAAA,EAAc,WAAA,IAC3B,4EAAA;AAAA;AAAA;AAAA;AAAA,QAKJ,uBAAA,EAAyB;AAAA,UACxBC,sBAAA,CAAa,MAAA;AAAA,UACbA,sBAAA,CAAa;AAAA,SACd;AAAA;AAAA;AAAA;AAAA,QAKA,kBAAA,EAAoB;AAAA,UACnBC,iBAAA,CAAQ,WAAA;AAAA,UACRA,iBAAA,CAAQ,WAAA;AAAA,UACRA,iBAAA,CAAQ;AAAA;AACT,OACqB,CAAA;AAAA,IACvB;AAMA,IAAA,IAAIC,mBAAA,CAAU,MAAM,gBAAA,EAAkB;AAAA,MACrC,KAAA,EACE,KAAA,CAAM,OAAA,EAAS,oBAAA,IAAwB,KAAA,CAAM,OAAA,EAAS,0BAAA,GACpD,IAAA,CAAK,aAAA,CAAc,eAAA,GACnB,IAAA,CAAK,KAAA,CAAM;AAAA,KACf,CAAA;AAAA,EACF;AACD","file":"lambda-layer-construct.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { Architecture, Code, ILayerVersion, LayerVersion, LayerVersionProps, Runtime } 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<IBaseCdkConstructProps<{\n\t/**\n\t * Configuration for creating a new Lambda layer\n\t *\n\t * Note:\n\t * - `layerVersionName` is required\n\t * - `compatibleArchitectures` is managed internally\n\t */\n\treadonly layerOptions?: Partial<Omit<LayerVersionProps, 'layerVersionName' | 'compatibleArchitectures'>>\n\t& Required<Pick<LayerVersionProps, 'layerVersionName'>>;\n\n\t/** Import an existing layer by ARN */\n\treadonly fromExistingLayerArn?: string;\n\n\t/** Import an existing layer using attributes */\n\treadonly fromExistingLayerAttribute?: {\n\t\treadonly layerVersionArn: string;\n\t\treadonly compatibleRuntimes?: Runtime[];\n\t};\n}>, 'appName' | 'stage' | 'stackName'> { }\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(scope: Construct, id: string, props?: ILambdaLayerConstructProps) {\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\n\t\t\t\t\t|| 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: [\n\t\t\t\t\tArchitecture.ARM_64,\n\t\t\t\t\tArchitecture.X86_64\n\t\t\t\t],\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\t(props.options?.fromExistingLayerArn || props.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}"]}

package/dist/aws/cdk/constructs/lambda-layer-construct.d.cts

@@ -0,0 +1,52 @@
+import { Construct } from 'constructs';
+import { LayerVersion, ILayerVersion, LayerVersionProps, Runtime } from 'aws-cdk-lib/aws-lambda';
+import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseLambdaLayerConstruct };

package/dist/aws/cdk/constructs/lambda-layer-construct.d.ts

@@ -0,0 +1,52 @@
+import { Construct } from 'constructs';
+import { LayerVersion, ILayerVersion, LayerVersionProps, Runtime } from 'aws-cdk-lib/aws-lambda';
+import { IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseLambdaLayerConstruct };

package/dist/aws/cdk/constructs/lambda-layer-construct.js

@@ -0,0 +1,70 @@
+import { Construct } from 'constructs';
+import { CfnOutput } from 'aws-cdk-lib';
+import { LayerVersion, Runtime, Architecture, Code } from 'aws-cdk-lib/aws-lambda';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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
+    });
+  }
+};
+
+export { BaseLambdaLayerConstruct };
+//# sourceMappingURL=lambda-layer-construct.js.map
+//# sourceMappingURL=lambda-layer-construct.js.map

package/dist/aws/cdk/constructs/lambda-layer-construct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/lambda-layer-construct.ts"],"names":[],"mappings":";;;;;;AA0CO,IAAM,wBAAA,GAAN,cAAuC,SAAA,CAAU;AAAA,EA1CxD;AA0CwD,IAAA,MAAA,CAAA,IAAA,EAAA,0BAAA,CAAA;AAAA;AAAA;AAAA,EAE9C,KAAA;AAAA;AAAA,EAGA,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAoC;AAC7E,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAKf,IAAA,IAAI,KAAA,EAAO,SAAS,oBAAA,EAAsB;AACzC,MAAA,IAAA,CAAK,gBAAgB,YAAA,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,gBAAgB,YAAA,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,IAAI,YAAA,CAAa,IAAA,EAAM,EAAA,EAAI;AAAA,QACvC,GAAG,MAAM,OAAA,EAAS,YAAA;AAAA;AAAA;AAAA;AAAA,QAKlB,MACC,KAAA,EAAO,OAAA,EAAS,cAAc,IAAA,IAC3B,IAAA,CAAK,UAAU,cAAc,CAAA;AAAA;AAAA;AAAA;AAAA,QAKjC,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,YAAA,EAAc,WAAA,IAC3B,4EAAA;AAAA;AAAA;AAAA;AAAA,QAKJ,uBAAA,EAAyB;AAAA,UACxB,YAAA,CAAa,MAAA;AAAA,UACb,YAAA,CAAa;AAAA,SACd;AAAA;AAAA;AAAA;AAAA,QAKA,kBAAA,EAAoB;AAAA,UACnB,OAAA,CAAQ,WAAA;AAAA,UACR,OAAA,CAAQ,WAAA;AAAA,UACR,OAAA,CAAQ;AAAA;AACT,OACqB,CAAA;AAAA,IACvB;AAMA,IAAA,IAAI,SAAA,CAAU,MAAM,gBAAA,EAAkB;AAAA,MACrC,KAAA,EACE,KAAA,CAAM,OAAA,EAAS,oBAAA,IAAwB,KAAA,CAAM,OAAA,EAAS,0BAAA,GACpD,IAAA,CAAK,aAAA,CAAc,eAAA,GACnB,IAAA,CAAK,KAAA,CAAM;AAAA,KACf,CAAA;AAAA,EACF;AACD","file":"lambda-layer-construct.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { Architecture, Code, ILayerVersion, LayerVersion, LayerVersionProps, Runtime } 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<IBaseCdkConstructProps<{\n\t/**\n\t * Configuration for creating a new Lambda layer\n\t *\n\t * Note:\n\t * - `layerVersionName` is required\n\t * - `compatibleArchitectures` is managed internally\n\t */\n\treadonly layerOptions?: Partial<Omit<LayerVersionProps, 'layerVersionName' | 'compatibleArchitectures'>>\n\t& Required<Pick<LayerVersionProps, 'layerVersionName'>>;\n\n\t/** Import an existing layer by ARN */\n\treadonly fromExistingLayerArn?: string;\n\n\t/** Import an existing layer using attributes */\n\treadonly fromExistingLayerAttribute?: {\n\t\treadonly layerVersionArn: string;\n\t\treadonly compatibleRuntimes?: Runtime[];\n\t};\n}>, 'appName' | 'stage' | 'stackName'> { }\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(scope: Construct, id: string, props?: ILambdaLayerConstructProps) {\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\n\t\t\t\t\t|| 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: [\n\t\t\t\t\tArchitecture.ARM_64,\n\t\t\t\t\tArchitecture.X86_64\n\t\t\t\t],\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\t(props.options?.fromExistingLayerArn || props.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}"]}

package/dist/aws/cdk/constructs/role-policy-construct.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsIam = require('aws-cdk-lib/aws-iam');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseRolePolicyConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseRolePolicyConstruct");
+  }
+  /** The created IAM Role instance */
+  role;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for role and policies
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.role = new awsIam.Role(this, id, {
+      ...props.options?.roleOptions,
+      /**
+       * Managed policies attached to the role
+       * Defaults to AWSLambdaBasicExecutionRole if not provided
+       */
+      managedPolicies: props.options?.roleOptions?.managedPolicies ? props.options.roleOptions.managedPolicies : [
+        awsIam.ManagedPolicy.fromAwsManagedPolicyName(
+          "service-role/AWSLambdaBasicExecutionRole"
+        )
+      ]
+    });
+    if (props?.policies?.length) {
+      props.policies.forEach((policy) => {
+        this.role.addToPolicy(
+          /**
+           * Inline policy statement
+           */
+          new awsIam.PolicyStatement(policy)
+        );
+      });
+    }
+    this.role.applyRemovalPolicy(awsCdkLib.RemovalPolicy.DESTROY);
+    new awsCdkLib.CfnOutput(this, "RolePolicyArn", {
+      value: this.role.roleArn
+    });
+  }
+};
+
+exports.BaseRolePolicyConstruct = BaseRolePolicyConstruct;
+//# sourceMappingURL=role-policy-construct.cjs.map
+//# sourceMappingURL=role-policy-construct.cjs.map

package/dist/aws/cdk/constructs/role-policy-construct.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/role-policy-construct.ts"],"names":["Construct","Role","ManagedPolicy","PolicyStatement","RemovalPolicy","CfnOutput"],"mappings":";;;;;;;;AAkCO,IAAM,uBAAA,GAAN,cAAsCA,oBAAA,CAAU;AAAA,EAlCvD;AAkCuD,IAAA,MAAA,CAAA,IAAA,EAAA,yBAAA,CAAA;AAAA;AAAA;AAAA,EAE7C,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAgC;AACzE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,IAAA,GAAO,IAAIC,WAAA,CAAK,IAAA,EAAM,EAAA,EAAI;AAAA,MAC9B,GAAG,MAAM,OAAA,EAAS,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMlB,eAAA,EACC,MAAM,OAAA,EAAS,WAAA,EAAa,kBACzB,KAAA,CAAM,OAAA,CAAQ,YAAY,eAAA,GAC1B;AAAA,QACDC,oBAAA,CAAc,wBAAA;AAAA,UACb;AAAA;AACD;AACD,KACF,CAAA;AAKD,IAAA,IAAI,KAAA,EAAO,UAAU,MAAA,EAAQ;AAC5B,MAAA,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,CAAC,MAAA,KAAW;AAClC,QAAA,IAAA,CAAK,IAAA,CAAK,WAAA;AAAA;AAAA;AAAA;AAAA,UAIT,IAAIC,uBAAgB,MAAM;AAAA,SAC3B;AAAA,MACD,CAAC,CAAA;AAAA,IACF;AAKA,IAAA,IAAA,CAAK,IAAA,CAAK,kBAAA,CAAmBC,uBAAA,CAAc,OAAO,CAAA;AAKlD,IAAA,IAAIC,mBAAA,CAAU,MAAM,eAAA,EAAiB;AAAA,MACpC,KAAA,EAAO,KAAK,IAAA,CAAK;AAAA,KACjB,CAAA;AAAA,EACF;AACD","file":"role-policy-construct.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { ManagedPolicy, PolicyStatement, PolicyStatementProps, Role, RoleProps } from 'aws-cdk-lib/aws-iam';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseRolePolicyConstruct\n *\n * Provides configuration for:\n * - IAM role creation\n * - Inline policy statements\n */\ninterface IDynamoDBConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** IAM Role configuration options */\n\treadonly roleOptions: RoleProps\n}>, 'appName' | 'stage' | 'stackName'> {\n\t/**\n\t * Additional inline policies to attach to the role\n\t *\n\t * Each entry is converted into a PolicyStatement\n\t */\n\treadonly policies?: PolicyStatementProps[];\n}\n\n/**\n * CDK construct for IAM Role with policies\n *\n * Responsibilities:\n * - Creates an IAM role with configurable options\n * - Applies a default AWS managed policy if none is provided\n * - Attaches optional inline policy statements\n * - Exposes the role ARN as a CloudFormation output\n */\nexport class BaseRolePolicyConstruct extends Construct {\n\t/** The created IAM Role instance */\n\treadonly role: Role;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for role and policies\n\t */\n\tconstructor(scope: Construct, id: string, props: IDynamoDBConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.role = new Role(this, id, {\n\t\t\t...props.options?.roleOptions,\n\n\t\t\t/**\n\t\t\t * Managed policies attached to the role\n\t\t\t * Defaults to AWSLambdaBasicExecutionRole if not provided\n\t\t\t */\n\t\t\tmanagedPolicies:\n\t\t\t\tprops.options?.roleOptions?.managedPolicies\n\t\t\t\t\t? props.options.roleOptions.managedPolicies\n\t\t\t\t\t: [\n\t\t\t\t\t\tManagedPolicy.fromAwsManagedPolicyName(\n\t\t\t\t\t\t\t'service-role/AWSLambdaBasicExecutionRole'\n\t\t\t\t\t\t)\n\t\t\t\t\t]\n\t\t});\n\n\t\t/**\n\t\t * Attach inline policy statements to the role\n\t\t */\n\t\tif (props?.policies?.length) {\n\t\t\tprops.policies.forEach((policy) => {\n\t\t\t\tthis.role.addToPolicy(\n\t\t\t\t\t/**\n\t\t\t\t\t * Inline policy statement\n\t\t\t\t\t */\n\t\t\t\t\tnew PolicyStatement(policy)\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.role.applyRemovalPolicy(RemovalPolicy.DESTROY);\n\n\t\t/**\n\t\t * CloudFormation output exposing the role ARN\n\t\t */\n\t\tnew CfnOutput(this, 'RolePolicyArn', {\n\t\t\tvalue: this.role.roleArn\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/role-policy-construct.d.cts

@@ -0,0 +1,44 @@
+import { Construct } from 'constructs';
+import { Role, RoleProps, PolicyStatementProps } from 'aws-cdk-lib/aws-iam';
+import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * 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);
+}
+
+export { BaseRolePolicyConstruct };