@incloodsolutions/devkit 0.0.3 → 0.0.5

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/lambda-construct.ts"],"names":[],"mappings":";;;;;;;AAwCO,IAAM,mBAAA,GAAN,cAAkC,SAAA,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,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,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,WAAW,OAAA,CAAQ,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAO3D,OAAA,EACC,KAAA,EAAO,OAAA,EAAS,aAAA,EAAe,WAC/B,QAAA,CAAS,OAAA;AAAA,QACR,KAAA,CAAM,KAAA,KAAU,kBAAA,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,gBAAgB,YAAA,CAAa,MAAA;AAAA;AAAA;AAAA;AAAA,MAK7D,MAAM,KAAA,EAAO,OAAA,EAAS,eAAe,IAAA,IAAQ,IAAA,CAAK,UAAU,MAAM,CAAA;AAAA;AAAA;AAAA;AAAA,MAKlE;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.js","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"]}

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

@@ -49,5 +49,5 @@ var BaseRolePolicyConstruct = class extends constructs.Construct {
 };
 
 exports.BaseRolePolicyConstruct = BaseRolePolicyConstruct;
-//# sourceMappingURL=role-policy-construct.cjs.map
-//# sourceMappingURL=role-policy-construct.cjs.map
+//# sourceMappingURL=role-policy.cjs.map
+//# sourceMappingURL=role-policy.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/role-policy-construct.ts"],"names":["Construct","Role","ManagedPolicy","PolicyStatement","RemovalPolicy","CfnOutput"],"mappings":";;;;;;;;AA2CO,IAAM,uBAAA,GAAN,cAAsCA,oBAAA,CAAU;AAAA,EA3CvD;AA2CuD,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,EAAiB,MAAM,OAAA,EAAS,WAAA,EAAa,kBAC1C,KAAA,CAAM,OAAA,CAAQ,YAAY,eAAA,GAC1B;AAAA,QACAC,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.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport {\n\tManagedPolicy,\n\tPolicyStatement,\n\tPolicyStatementProps,\n\tRole,\n\tRoleProps,\n} 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<\n\tIBaseCdkConstructProps<{\n\t\t/** IAM Role configuration options */\n\t\treadonly roleOptions: RoleProps;\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {\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: props.options?.roleOptions?.managedPolicies\n\t\t\t\t? props.options.roleOptions.managedPolicies\n\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}\n"]}

package/dist/{aws/cdk/constructs/role-policy-construct.d.ts → aws-cdk/constructs/role-policy.d.cts}

@@ -1,7 +1,8 @@
 import { Construct } from 'constructs';
 import { Role, RoleProps, PolicyStatementProps } from 'aws-cdk-lib/aws-iam';
-import { IBaseCdkConstructProps } from '../../types/index.js';
+import { IBaseCdkConstructProps } from '../../aws-types.cjs';
 import '@incloodsolutions/toolkit';
+import 'aws-cdk-lib';
 
 /**
  * Props for BaseRolePolicyConstruct

package/dist/{aws/cdk/constructs/role-policy-construct.d.cts → aws-cdk/constructs/role-policy.d.ts}

@@ -1,7 +1,8 @@
 import { Construct } from 'constructs';
 import { Role, RoleProps, PolicyStatementProps } from 'aws-cdk-lib/aws-iam';
-import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import { IBaseCdkConstructProps } from '../../aws-types.js';
 import '@incloodsolutions/toolkit';
+import 'aws-cdk-lib';
 
 /**
  * Props for BaseRolePolicyConstruct

package/dist/{aws/cdk/constructs/role-policy-construct.js → aws-cdk/constructs/role-policy.js}

@@ -47,5 +47,5 @@ var BaseRolePolicyConstruct = class extends Construct {
 };
 
 export { BaseRolePolicyConstruct };
-//# sourceMappingURL=role-policy-construct.js.map
-//# sourceMappingURL=role-policy-construct.js.map
+//# sourceMappingURL=role-policy.js.map
+//# sourceMappingURL=role-policy.js.map

package/dist/aws-cdk/constructs/role-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/role-policy-construct.ts"],"names":[],"mappings":";;;;;;AA2CO,IAAM,uBAAA,GAAN,cAAsC,SAAA,CAAU;AAAA,EA3CvD;AA2CuD,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,IAAI,IAAA,CAAK,IAAA,EAAM,EAAA,EAAI;AAAA,MAC9B,GAAG,MAAM,OAAA,EAAS,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMlB,eAAA,EAAiB,MAAM,OAAA,EAAS,WAAA,EAAa,kBAC1C,KAAA,CAAM,OAAA,CAAQ,YAAY,eAAA,GAC1B;AAAA,QACA,aAAA,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,IAAI,gBAAgB,MAAM;AAAA,SAC3B;AAAA,MACD,CAAC,CAAA;AAAA,IACF;AAKA,IAAA,IAAA,CAAK,IAAA,CAAK,kBAAA,CAAmB,aAAA,CAAc,OAAO,CAAA;AAKlD,IAAA,IAAI,SAAA,CAAU,MAAM,eAAA,EAAiB;AAAA,MACpC,KAAA,EAAO,KAAK,IAAA,CAAK;AAAA,KACjB,CAAA;AAAA,EACF;AACD","file":"role-policy.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport {\n\tManagedPolicy,\n\tPolicyStatement,\n\tPolicyStatementProps,\n\tRole,\n\tRoleProps,\n} 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<\n\tIBaseCdkConstructProps<{\n\t\t/** IAM Role configuration options */\n\t\treadonly roleOptions: RoleProps;\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {\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: props.options?.roleOptions?.managedPolicies\n\t\t\t\t? props.options.roleOptions.managedPolicies\n\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}\n"]}

package/dist/aws-cdk/constructs/route53.cjs

@@ -0,0 +1,79 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsRoute53 = require('aws-cdk-lib/aws-route53');
+var toolkit = require('@incloodsolutions/toolkit');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseRoute53Construct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseRoute53Construct");
+  }
+  /** The hosted zone this construct created, imported, or looked up */
+  hostedZone;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for the hosted zone and its records
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    const options = props?.options ?? {};
+    if (options.hostedZoneOptions) {
+      this.hostedZone = new awsRoute53.HostedZone(
+        this,
+        `${id}-HostedZone`,
+        options.hostedZoneOptions
+      );
+    } else if (options.fromExistingHostedZoneAttributes) {
+      this.hostedZone = awsRoute53.HostedZone.fromHostedZoneAttributes(
+        this,
+        `${id}-HostedZone`,
+        options.fromExistingHostedZoneAttributes
+      );
+    } else if (options.fromLookupOptions) {
+      this.hostedZone = awsRoute53.HostedZone.fromLookup(
+        this,
+        `${id}-HostedZone`,
+        options.fromLookupOptions
+      );
+    } else {
+      throw new toolkit.CustomException(
+        "BaseRoute53Construct requires one of hostedZoneOptions, fromExistingHostedZoneAttributes, or fromLookupOptions"
+      );
+    }
+    options.aRecords?.forEach((record, index) => {
+      new awsRoute53.ARecord(this, `${id}-ARecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    options.aaaaRecords?.forEach((record, index) => {
+      new awsRoute53.AaaaRecord(this, `${id}-AaaaRecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    options.cnameRecords?.forEach((record, index) => {
+      new awsRoute53.CnameRecord(this, `${id}-CnameRecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    options.txtRecords?.forEach((record, index) => {
+      new awsRoute53.TxtRecord(this, `${id}-TxtRecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    new awsCdkLib.CfnOutput(this, "Route53HostedZoneId", {
+      value: this.hostedZone.hostedZoneId
+    });
+  }
+};
+
+exports.BaseRoute53Construct = BaseRoute53Construct;
+//# sourceMappingURL=route53.cjs.map
+//# sourceMappingURL=route53.cjs.map

package/dist/aws-cdk/constructs/route53.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/route53-construct.ts"],"names":["Construct","HostedZone","CustomException","ARecord","AaaaRecord","CnameRecord","TxtRecord","CfnOutput"],"mappings":";;;;;;;;;AA4GO,IAAM,oBAAA,GAAN,cAAmCA,oBAAA,CAAU;AAAA,EA5GpD;AA4GoD,IAAA,MAAA,CAAA,IAAA,EAAA,sBAAA,CAAA;AAAA;AAAA;AAAA,EAE1C,UAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA+B;AACxE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,MAAM,OAAA,GAAU,KAAA,EAAO,OAAA,IAAW,EAAC;AAEnC,IAAA,IAAI,QAAQ,iBAAA,EAAmB;AAC9B,MAAA,IAAA,CAAK,aAAa,IAAIC,qBAAA;AAAA,QACrB,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,WAAA,CAAA;AAAA,QACL,OAAA,CAAQ;AAAA,OACT;AAAA,IACD,CAAA,MAAA,IAAW,QAAQ,gCAAA,EAAkC;AACpD,MAAA,IAAA,CAAK,aAAaA,qBAAA,CAAW,wBAAA;AAAA,QAC5B,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,WAAA,CAAA;AAAA,QACL,OAAA,CAAQ;AAAA,OACT;AAAA,IACD,CAAA,MAAA,IAAW,QAAQ,iBAAA,EAAmB;AACrC,MAAA,IAAA,CAAK,aAAaA,qBAAA,CAAW,UAAA;AAAA,QAC5B,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,WAAA,CAAA;AAAA,QACL,OAAA,CAAQ;AAAA,OACT;AAAA,IACD,CAAA,MAAO;AACN,MAAA,MAAM,IAAIC,uBAAA;AAAA,QACT;AAAA,OACD;AAAA,IACD;AAEA,IAAA,OAAA,CAAQ,QAAA,EAAU,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAC5C,MAAA,IAAIC,mBAAQ,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,SAAA,EAAY,KAAK,CAAA,CAAA,EAAI;AAAA,QAC3C,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,WAAA,EAAa,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAC/C,MAAA,IAAIC,sBAAW,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,YAAA,EAAe,KAAK,CAAA,CAAA,EAAI;AAAA,QACjD,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,YAAA,EAAc,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAChD,MAAA,IAAIC,uBAAY,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,aAAA,EAAgB,KAAK,CAAA,CAAA,EAAI;AAAA,QACnD,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,UAAA,EAAY,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAC9C,MAAA,IAAIC,qBAAU,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,WAAA,EAAc,KAAK,CAAA,CAAA,EAAI;AAAA,QAC/C,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAKD,IAAA,IAAIC,mBAAA,CAAU,MAAM,qBAAA,EAAuB;AAAA,MAC1C,KAAA,EAAO,KAAK,UAAA,CAAW;AAAA,KACvB,CAAA;AAAA,EACF;AACD","file":"route53.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport {\n\tARecord,\n\tARecordProps,\n\tAaaaRecord,\n\tAaaaRecordProps,\n\tCnameRecord,\n\tCnameRecordProps,\n\tHostedZone,\n\tHostedZoneAttributes,\n\tHostedZoneProps,\n\tHostedZoneProviderProps,\n\tIHostedZone,\n\tTxtRecord,\n\tTxtRecordProps,\n} from 'aws-cdk-lib/aws-route53';\n\nimport { CustomException } from '@incloodsolutions/toolkit';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseRoute53Construct\n *\n * Exactly one of `hostedZoneOptions`, `fromExistingHostedZoneAttributes`, or\n * `fromLookupOptions` must be provided to obtain the hosted zone — a hosted\n * zone is the container Route53 uses to hold every DNS record for one domain.\n * Records are then added to that zone via `aRecords` / `aaaaRecords` /\n * `cnameRecords` / `txtRecords`.\n */\ninterface IRoute53ConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/**\n\t\t * Create a brand-new public hosted zone for `zoneName`. Use this when\n\t\t * Route53 has not yet been given authority over the domain — CDK also\n\t\t * prints the four NS records you must set as the domain's nameservers at\n\t\t * the registrar to actually delegate DNS to this zone.\n\t\t */\n\t\treadonly hostedZoneOptions?: HostedZoneProps;\n\n\t\t/**\n\t\t * Reference an existing hosted zone by its ID and zone name, without\n\t\t * creating a new one. Cheapest and most predictable option — no synth-time\n\t\t * AWS API call, no risk of creating a duplicate zone — but you must already\n\t\t * know the hosted zone ID (from the console, another stack's output, etc.).\n\t\t */\n\t\treadonly fromExistingHostedZoneAttributes?: HostedZoneAttributes;\n\n\t\t/**\n\t\t * Resolve an existing public hosted zone by domain name via an AWS API\n\t\t * call made while CDK synthesises the stack (not at deploy time). Convenient\n\t\t * when you only know the domain name, but requires AWS credentials at synth\n\t\t * and re-runs that lookup (and may cache stale results) on every synth.\n\t\t */\n\t\treadonly fromLookupOptions?: HostedZoneProviderProps;\n\n\t\t/**\n\t\t * `A` records — map this zone (or a subdomain) to one or more IPv4\n\t\t * addresses, or, via `target: RecordTarget.fromAlias(...)`, \"alias\" the\n\t\t * record directly to an AWS resource (CloudFront, API Gateway custom\n\t\t * domain, ALB, another Route53 record, …). Alias `A` records are free,\n\t\t * auto-update if the target's IP changes, and — unlike `CNAME` — are the\n\t\t * only way to point the zone apex (`example.com` itself, not a subdomain)\n\t\t * at an AWS resource. Use this for \"point my (sub)domain at this AWS\n\t\t * service\" or \"point it at a fixed IPv4 address\".\n\t\t */\n\t\treadonly aRecords?: Omit<ARecordProps, 'zone'>[];\n\n\t\t/**\n\t\t * `AAAA` records — the IPv6 counterpart to `A` records: map this zone or a\n\t\t * subdomain to IPv6 addresses, or alias to an AWS resource, the same way\n\t\t * `aRecords` does for IPv4. Add these alongside `aRecords` (not instead of)\n\t\t * when the target also needs to be reachable over IPv6.\n\t\t */\n\t\treadonly aaaaRecords?: Omit<AaaaRecordProps, 'zone'>[];\n\n\t\t/**\n\t\t * `CNAME` records — alias a subdomain to another DNS name (not an IP\n\t\t * address), e.g. `www.example.com` → `example.com`, or a subdomain to a\n\t\t * third-party service's domain (a SaaS custom-domain setup). DNS rules\n\t\t * forbid a `CNAME` at the zone apex and forbid mixing it with any other\n\t\t * record type on the same name — use an alias `A`/`AAAA` record instead\n\t\t * for the apex or for AWS-resource targets.\n\t\t */\n\t\treadonly cnameRecords?: Omit<CnameRecordProps, 'zone'>[];\n\n\t\t/**\n\t\t * `TXT` records — arbitrary text attached to a name, not used for routing\n\t\t * traffic at all. The standard way to prove domain ownership (ACM\n\t\t * certificate DNS validation, Google/Microsoft/other SaaS site\n\t\t * verification) and to publish email-authentication policy (SPF, DKIM,\n\t\t * DMARC). Each string in `values` becomes one quoted TXT value.\n\t\t */\n\t\treadonly txtRecords?: Omit<TxtRecordProps, 'zone'>[];\n\t}>,\n\t'appName' | 'stackName'\n> {}\n\n/**\n * CDK construct for Route53\n *\n * Responsibilities:\n * - Creates a new public hosted zone, imports one by attributes, or looks one\n *   up by domain name (exactly one of the three is required)\n * - Optionally attaches `A`, `AAAA`, `CNAME`, and `TXT` records to that zone\n * - Exposes the hosted zone as `.hostedZone` and its ID as a CloudFormation output\n */\nexport class BaseRoute53Construct extends Construct {\n\t/** The hosted zone this construct created, imported, or looked up */\n\treadonly hostedZone: IHostedZone;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for the hosted zone and its records\n\t */\n\tconstructor(scope: Construct, id: string, props: IRoute53ConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tconst options = props?.options ?? {};\n\n\t\tif (options.hostedZoneOptions) {\n\t\t\tthis.hostedZone = new HostedZone(\n\t\t\t\tthis,\n\t\t\t\t`${id}-HostedZone`,\n\t\t\t\toptions.hostedZoneOptions,\n\t\t\t);\n\t\t} else if (options.fromExistingHostedZoneAttributes) {\n\t\t\tthis.hostedZone = HostedZone.fromHostedZoneAttributes(\n\t\t\t\tthis,\n\t\t\t\t`${id}-HostedZone`,\n\t\t\t\toptions.fromExistingHostedZoneAttributes,\n\t\t\t);\n\t\t} else if (options.fromLookupOptions) {\n\t\t\tthis.hostedZone = HostedZone.fromLookup(\n\t\t\t\tthis,\n\t\t\t\t`${id}-HostedZone`,\n\t\t\t\toptions.fromLookupOptions,\n\t\t\t);\n\t\t} else {\n\t\t\tthrow new CustomException(\n\t\t\t\t'BaseRoute53Construct requires one of hostedZoneOptions, fromExistingHostedZoneAttributes, or fromLookupOptions',\n\t\t\t);\n\t\t}\n\n\t\toptions.aRecords?.forEach((record, index) => {\n\t\t\tnew ARecord(this, `${id}-ARecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\toptions.aaaaRecords?.forEach((record, index) => {\n\t\t\tnew AaaaRecord(this, `${id}-AaaaRecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\toptions.cnameRecords?.forEach((record, index) => {\n\t\t\tnew CnameRecord(this, `${id}-CnameRecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\toptions.txtRecords?.forEach((record, index) => {\n\t\t\tnew TxtRecord(this, `${id}-TxtRecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the Route53 hosted zone ID\n\t\t */\n\t\tnew CfnOutput(this, 'Route53HostedZoneId', {\n\t\t\tvalue: this.hostedZone.hostedZoneId,\n\t\t});\n\t}\n}\n"]}

package/dist/aws-cdk/constructs/route53.d.cts

@@ -0,0 +1,95 @@
+import { Construct } from 'constructs';
+import { IHostedZone, HostedZoneProps, HostedZoneAttributes, HostedZoneProviderProps, ARecordProps, AaaaRecordProps, CnameRecordProps, TxtRecordProps } from 'aws-cdk-lib/aws-route53';
+import { IBaseCdkConstructProps } from '../../aws-types.cjs';
+import '@incloodsolutions/toolkit';
+import 'aws-cdk-lib';
+
+/**
+ * Props for BaseRoute53Construct
+ *
+ * Exactly one of `hostedZoneOptions`, `fromExistingHostedZoneAttributes`, or
+ * `fromLookupOptions` must be provided to obtain the hosted zone — a hosted
+ * zone is the container Route53 uses to hold every DNS record for one domain.
+ * Records are then added to that zone via `aRecords` / `aaaaRecords` /
+ * `cnameRecords` / `txtRecords`.
+ */
+interface IRoute53ConstructProps extends Omit<IBaseCdkConstructProps<{
+    /**
+     * Create a brand-new public hosted zone for `zoneName`. Use this when
+     * Route53 has not yet been given authority over the domain — CDK also
+     * prints the four NS records you must set as the domain's nameservers at
+     * the registrar to actually delegate DNS to this zone.
+     */
+    readonly hostedZoneOptions?: HostedZoneProps;
+    /**
+     * Reference an existing hosted zone by its ID and zone name, without
+     * creating a new one. Cheapest and most predictable option — no synth-time
+     * AWS API call, no risk of creating a duplicate zone — but you must already
+     * know the hosted zone ID (from the console, another stack's output, etc.).
+     */
+    readonly fromExistingHostedZoneAttributes?: HostedZoneAttributes;
+    /**
+     * Resolve an existing public hosted zone by domain name via an AWS API
+     * call made while CDK synthesises the stack (not at deploy time). Convenient
+     * when you only know the domain name, but requires AWS credentials at synth
+     * and re-runs that lookup (and may cache stale results) on every synth.
+     */
+    readonly fromLookupOptions?: HostedZoneProviderProps;
+    /**
+     * `A` records — map this zone (or a subdomain) to one or more IPv4
+     * addresses, or, via `target: RecordTarget.fromAlias(...)`, "alias" the
+     * record directly to an AWS resource (CloudFront, API Gateway custom
+     * domain, ALB, another Route53 record, …). Alias `A` records are free,
+     * auto-update if the target's IP changes, and — unlike `CNAME` — are the
+     * only way to point the zone apex (`example.com` itself, not a subdomain)
+     * at an AWS resource. Use this for "point my (sub)domain at this AWS
+     * service" or "point it at a fixed IPv4 address".
+     */
+    readonly aRecords?: Omit<ARecordProps, 'zone'>[];
+    /**
+     * `AAAA` records — the IPv6 counterpart to `A` records: map this zone or a
+     * subdomain to IPv6 addresses, or alias to an AWS resource, the same way
+     * `aRecords` does for IPv4. Add these alongside `aRecords` (not instead of)
+     * when the target also needs to be reachable over IPv6.
+     */
+    readonly aaaaRecords?: Omit<AaaaRecordProps, 'zone'>[];
+    /**
+     * `CNAME` records — alias a subdomain to another DNS name (not an IP
+     * address), e.g. `www.example.com` → `example.com`, or a subdomain to a
+     * third-party service's domain (a SaaS custom-domain setup). DNS rules
+     * forbid a `CNAME` at the zone apex and forbid mixing it with any other
+     * record type on the same name — use an alias `A`/`AAAA` record instead
+     * for the apex or for AWS-resource targets.
+     */
+    readonly cnameRecords?: Omit<CnameRecordProps, 'zone'>[];
+    /**
+     * `TXT` records — arbitrary text attached to a name, not used for routing
+     * traffic at all. The standard way to prove domain ownership (ACM
+     * certificate DNS validation, Google/Microsoft/other SaaS site
+     * verification) and to publish email-authentication policy (SPF, DKIM,
+     * DMARC). Each string in `values` becomes one quoted TXT value.
+     */
+    readonly txtRecords?: Omit<TxtRecordProps, 'zone'>[];
+}>, 'appName' | 'stackName'> {
+}
+/**
+ * CDK construct for Route53
+ *
+ * Responsibilities:
+ * - Creates a new public hosted zone, imports one by attributes, or looks one
+ *   up by domain name (exactly one of the three is required)
+ * - Optionally attaches `A`, `AAAA`, `CNAME`, and `TXT` records to that zone
+ * - Exposes the hosted zone as `.hostedZone` and its ID as a CloudFormation output
+ */
+declare class BaseRoute53Construct extends Construct {
+    /** The hosted zone this construct created, imported, or looked up */
+    readonly hostedZone: IHostedZone;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for the hosted zone and its records
+     */
+    constructor(scope: Construct, id: string, props: IRoute53ConstructProps);
+}
+
+export { BaseRoute53Construct };

package/dist/aws-cdk/constructs/route53.d.ts

@@ -0,0 +1,95 @@
+import { Construct } from 'constructs';
+import { IHostedZone, HostedZoneProps, HostedZoneAttributes, HostedZoneProviderProps, ARecordProps, AaaaRecordProps, CnameRecordProps, TxtRecordProps } from 'aws-cdk-lib/aws-route53';
+import { IBaseCdkConstructProps } from '../../aws-types.js';
+import '@incloodsolutions/toolkit';
+import 'aws-cdk-lib';
+
+/**
+ * Props for BaseRoute53Construct
+ *
+ * Exactly one of `hostedZoneOptions`, `fromExistingHostedZoneAttributes`, or
+ * `fromLookupOptions` must be provided to obtain the hosted zone — a hosted
+ * zone is the container Route53 uses to hold every DNS record for one domain.
+ * Records are then added to that zone via `aRecords` / `aaaaRecords` /
+ * `cnameRecords` / `txtRecords`.
+ */
+interface IRoute53ConstructProps extends Omit<IBaseCdkConstructProps<{
+    /**
+     * Create a brand-new public hosted zone for `zoneName`. Use this when
+     * Route53 has not yet been given authority over the domain — CDK also
+     * prints the four NS records you must set as the domain's nameservers at
+     * the registrar to actually delegate DNS to this zone.
+     */
+    readonly hostedZoneOptions?: HostedZoneProps;
+    /**
+     * Reference an existing hosted zone by its ID and zone name, without
+     * creating a new one. Cheapest and most predictable option — no synth-time
+     * AWS API call, no risk of creating a duplicate zone — but you must already
+     * know the hosted zone ID (from the console, another stack's output, etc.).
+     */
+    readonly fromExistingHostedZoneAttributes?: HostedZoneAttributes;
+    /**
+     * Resolve an existing public hosted zone by domain name via an AWS API
+     * call made while CDK synthesises the stack (not at deploy time). Convenient
+     * when you only know the domain name, but requires AWS credentials at synth
+     * and re-runs that lookup (and may cache stale results) on every synth.
+     */
+    readonly fromLookupOptions?: HostedZoneProviderProps;
+    /**
+     * `A` records — map this zone (or a subdomain) to one or more IPv4
+     * addresses, or, via `target: RecordTarget.fromAlias(...)`, "alias" the
+     * record directly to an AWS resource (CloudFront, API Gateway custom
+     * domain, ALB, another Route53 record, …). Alias `A` records are free,
+     * auto-update if the target's IP changes, and — unlike `CNAME` — are the
+     * only way to point the zone apex (`example.com` itself, not a subdomain)
+     * at an AWS resource. Use this for "point my (sub)domain at this AWS
+     * service" or "point it at a fixed IPv4 address".
+     */
+    readonly aRecords?: Omit<ARecordProps, 'zone'>[];
+    /**
+     * `AAAA` records — the IPv6 counterpart to `A` records: map this zone or a
+     * subdomain to IPv6 addresses, or alias to an AWS resource, the same way
+     * `aRecords` does for IPv4. Add these alongside `aRecords` (not instead of)
+     * when the target also needs to be reachable over IPv6.
+     */
+    readonly aaaaRecords?: Omit<AaaaRecordProps, 'zone'>[];
+    /**
+     * `CNAME` records — alias a subdomain to another DNS name (not an IP
+     * address), e.g. `www.example.com` → `example.com`, or a subdomain to a
+     * third-party service's domain (a SaaS custom-domain setup). DNS rules
+     * forbid a `CNAME` at the zone apex and forbid mixing it with any other
+     * record type on the same name — use an alias `A`/`AAAA` record instead
+     * for the apex or for AWS-resource targets.
+     */
+    readonly cnameRecords?: Omit<CnameRecordProps, 'zone'>[];
+    /**
+     * `TXT` records — arbitrary text attached to a name, not used for routing
+     * traffic at all. The standard way to prove domain ownership (ACM
+     * certificate DNS validation, Google/Microsoft/other SaaS site
+     * verification) and to publish email-authentication policy (SPF, DKIM,
+     * DMARC). Each string in `values` becomes one quoted TXT value.
+     */
+    readonly txtRecords?: Omit<TxtRecordProps, 'zone'>[];
+}>, 'appName' | 'stackName'> {
+}
+/**
+ * CDK construct for Route53
+ *
+ * Responsibilities:
+ * - Creates a new public hosted zone, imports one by attributes, or looks one
+ *   up by domain name (exactly one of the three is required)
+ * - Optionally attaches `A`, `AAAA`, `CNAME`, and `TXT` records to that zone
+ * - Exposes the hosted zone as `.hostedZone` and its ID as a CloudFormation output
+ */
+declare class BaseRoute53Construct extends Construct {
+    /** The hosted zone this construct created, imported, or looked up */
+    readonly hostedZone: IHostedZone;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for the hosted zone and its records
+     */
+    constructor(scope: Construct, id: string, props: IRoute53ConstructProps);
+}
+
+export { BaseRoute53Construct };

package/dist/aws-cdk/constructs/route53.js

@@ -0,0 +1,77 @@
+import { Construct } from 'constructs';
+import { CfnOutput } from 'aws-cdk-lib';
+import { HostedZone, ARecord, AaaaRecord, CnameRecord, TxtRecord } from 'aws-cdk-lib/aws-route53';
+import { CustomException } from '@incloodsolutions/toolkit';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseRoute53Construct = class extends Construct {
+  static {
+    __name(this, "BaseRoute53Construct");
+  }
+  /** The hosted zone this construct created, imported, or looked up */
+  hostedZone;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for the hosted zone and its records
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    const options = props?.options ?? {};
+    if (options.hostedZoneOptions) {
+      this.hostedZone = new HostedZone(
+        this,
+        `${id}-HostedZone`,
+        options.hostedZoneOptions
+      );
+    } else if (options.fromExistingHostedZoneAttributes) {
+      this.hostedZone = HostedZone.fromHostedZoneAttributes(
+        this,
+        `${id}-HostedZone`,
+        options.fromExistingHostedZoneAttributes
+      );
+    } else if (options.fromLookupOptions) {
+      this.hostedZone = HostedZone.fromLookup(
+        this,
+        `${id}-HostedZone`,
+        options.fromLookupOptions
+      );
+    } else {
+      throw new CustomException(
+        "BaseRoute53Construct requires one of hostedZoneOptions, fromExistingHostedZoneAttributes, or fromLookupOptions"
+      );
+    }
+    options.aRecords?.forEach((record, index) => {
+      new ARecord(this, `${id}-ARecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    options.aaaaRecords?.forEach((record, index) => {
+      new AaaaRecord(this, `${id}-AaaaRecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    options.cnameRecords?.forEach((record, index) => {
+      new CnameRecord(this, `${id}-CnameRecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    options.txtRecords?.forEach((record, index) => {
+      new TxtRecord(this, `${id}-TxtRecord-${index}`, {
+        ...record,
+        zone: this.hostedZone
+      });
+    });
+    new CfnOutput(this, "Route53HostedZoneId", {
+      value: this.hostedZone.hostedZoneId
+    });
+  }
+};
+
+export { BaseRoute53Construct };
+//# sourceMappingURL=route53.js.map
+//# sourceMappingURL=route53.js.map

package/dist/aws-cdk/constructs/route53.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/route53-construct.ts"],"names":[],"mappings":";;;;;;;AA4GO,IAAM,oBAAA,GAAN,cAAmC,SAAA,CAAU;AAAA,EA5GpD;AA4GoD,IAAA,MAAA,CAAA,IAAA,EAAA,sBAAA,CAAA;AAAA;AAAA;AAAA,EAE1C,UAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA+B;AACxE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,MAAM,OAAA,GAAU,KAAA,EAAO,OAAA,IAAW,EAAC;AAEnC,IAAA,IAAI,QAAQ,iBAAA,EAAmB;AAC9B,MAAA,IAAA,CAAK,aAAa,IAAI,UAAA;AAAA,QACrB,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,WAAA,CAAA;AAAA,QACL,OAAA,CAAQ;AAAA,OACT;AAAA,IACD,CAAA,MAAA,IAAW,QAAQ,gCAAA,EAAkC;AACpD,MAAA,IAAA,CAAK,aAAa,UAAA,CAAW,wBAAA;AAAA,QAC5B,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,WAAA,CAAA;AAAA,QACL,OAAA,CAAQ;AAAA,OACT;AAAA,IACD,CAAA,MAAA,IAAW,QAAQ,iBAAA,EAAmB;AACrC,MAAA,IAAA,CAAK,aAAa,UAAA,CAAW,UAAA;AAAA,QAC5B,IAAA;AAAA,QACA,GAAG,EAAE,CAAA,WAAA,CAAA;AAAA,QACL,OAAA,CAAQ;AAAA,OACT;AAAA,IACD,CAAA,MAAO;AACN,MAAA,MAAM,IAAI,eAAA;AAAA,QACT;AAAA,OACD;AAAA,IACD;AAEA,IAAA,OAAA,CAAQ,QAAA,EAAU,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAC5C,MAAA,IAAI,QAAQ,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,SAAA,EAAY,KAAK,CAAA,CAAA,EAAI;AAAA,QAC3C,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,WAAA,EAAa,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAC/C,MAAA,IAAI,WAAW,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,YAAA,EAAe,KAAK,CAAA,CAAA,EAAI;AAAA,QACjD,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,YAAA,EAAc,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAChD,MAAA,IAAI,YAAY,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,aAAA,EAAgB,KAAK,CAAA,CAAA,EAAI;AAAA,QACnD,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,UAAA,EAAY,OAAA,CAAQ,CAAC,MAAA,EAAQ,KAAA,KAAU;AAC9C,MAAA,IAAI,UAAU,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,WAAA,EAAc,KAAK,CAAA,CAAA,EAAI;AAAA,QAC/C,GAAG,MAAA;AAAA,QACH,MAAM,IAAA,CAAK;AAAA,OACX,CAAA;AAAA,IACF,CAAC,CAAA;AAKD,IAAA,IAAI,SAAA,CAAU,MAAM,qBAAA,EAAuB;AAAA,MAC1C,KAAA,EAAO,KAAK,UAAA,CAAW;AAAA,KACvB,CAAA;AAAA,EACF;AACD","file":"route53.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport {\n\tARecord,\n\tARecordProps,\n\tAaaaRecord,\n\tAaaaRecordProps,\n\tCnameRecord,\n\tCnameRecordProps,\n\tHostedZone,\n\tHostedZoneAttributes,\n\tHostedZoneProps,\n\tHostedZoneProviderProps,\n\tIHostedZone,\n\tTxtRecord,\n\tTxtRecordProps,\n} from 'aws-cdk-lib/aws-route53';\n\nimport { CustomException } from '@incloodsolutions/toolkit';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseRoute53Construct\n *\n * Exactly one of `hostedZoneOptions`, `fromExistingHostedZoneAttributes`, or\n * `fromLookupOptions` must be provided to obtain the hosted zone — a hosted\n * zone is the container Route53 uses to hold every DNS record for one domain.\n * Records are then added to that zone via `aRecords` / `aaaaRecords` /\n * `cnameRecords` / `txtRecords`.\n */\ninterface IRoute53ConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/**\n\t\t * Create a brand-new public hosted zone for `zoneName`. Use this when\n\t\t * Route53 has not yet been given authority over the domain — CDK also\n\t\t * prints the four NS records you must set as the domain's nameservers at\n\t\t * the registrar to actually delegate DNS to this zone.\n\t\t */\n\t\treadonly hostedZoneOptions?: HostedZoneProps;\n\n\t\t/**\n\t\t * Reference an existing hosted zone by its ID and zone name, without\n\t\t * creating a new one. Cheapest and most predictable option — no synth-time\n\t\t * AWS API call, no risk of creating a duplicate zone — but you must already\n\t\t * know the hosted zone ID (from the console, another stack's output, etc.).\n\t\t */\n\t\treadonly fromExistingHostedZoneAttributes?: HostedZoneAttributes;\n\n\t\t/**\n\t\t * Resolve an existing public hosted zone by domain name via an AWS API\n\t\t * call made while CDK synthesises the stack (not at deploy time). Convenient\n\t\t * when you only know the domain name, but requires AWS credentials at synth\n\t\t * and re-runs that lookup (and may cache stale results) on every synth.\n\t\t */\n\t\treadonly fromLookupOptions?: HostedZoneProviderProps;\n\n\t\t/**\n\t\t * `A` records — map this zone (or a subdomain) to one or more IPv4\n\t\t * addresses, or, via `target: RecordTarget.fromAlias(...)`, \"alias\" the\n\t\t * record directly to an AWS resource (CloudFront, API Gateway custom\n\t\t * domain, ALB, another Route53 record, …). Alias `A` records are free,\n\t\t * auto-update if the target's IP changes, and — unlike `CNAME` — are the\n\t\t * only way to point the zone apex (`example.com` itself, not a subdomain)\n\t\t * at an AWS resource. Use this for \"point my (sub)domain at this AWS\n\t\t * service\" or \"point it at a fixed IPv4 address\".\n\t\t */\n\t\treadonly aRecords?: Omit<ARecordProps, 'zone'>[];\n\n\t\t/**\n\t\t * `AAAA` records — the IPv6 counterpart to `A` records: map this zone or a\n\t\t * subdomain to IPv6 addresses, or alias to an AWS resource, the same way\n\t\t * `aRecords` does for IPv4. Add these alongside `aRecords` (not instead of)\n\t\t * when the target also needs to be reachable over IPv6.\n\t\t */\n\t\treadonly aaaaRecords?: Omit<AaaaRecordProps, 'zone'>[];\n\n\t\t/**\n\t\t * `CNAME` records — alias a subdomain to another DNS name (not an IP\n\t\t * address), e.g. `www.example.com` → `example.com`, or a subdomain to a\n\t\t * third-party service's domain (a SaaS custom-domain setup). DNS rules\n\t\t * forbid a `CNAME` at the zone apex and forbid mixing it with any other\n\t\t * record type on the same name — use an alias `A`/`AAAA` record instead\n\t\t * for the apex or for AWS-resource targets.\n\t\t */\n\t\treadonly cnameRecords?: Omit<CnameRecordProps, 'zone'>[];\n\n\t\t/**\n\t\t * `TXT` records — arbitrary text attached to a name, not used for routing\n\t\t * traffic at all. The standard way to prove domain ownership (ACM\n\t\t * certificate DNS validation, Google/Microsoft/other SaaS site\n\t\t * verification) and to publish email-authentication policy (SPF, DKIM,\n\t\t * DMARC). Each string in `values` becomes one quoted TXT value.\n\t\t */\n\t\treadonly txtRecords?: Omit<TxtRecordProps, 'zone'>[];\n\t}>,\n\t'appName' | 'stackName'\n> {}\n\n/**\n * CDK construct for Route53\n *\n * Responsibilities:\n * - Creates a new public hosted zone, imports one by attributes, or looks one\n *   up by domain name (exactly one of the three is required)\n * - Optionally attaches `A`, `AAAA`, `CNAME`, and `TXT` records to that zone\n * - Exposes the hosted zone as `.hostedZone` and its ID as a CloudFormation output\n */\nexport class BaseRoute53Construct extends Construct {\n\t/** The hosted zone this construct created, imported, or looked up */\n\treadonly hostedZone: IHostedZone;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for the hosted zone and its records\n\t */\n\tconstructor(scope: Construct, id: string, props: IRoute53ConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tconst options = props?.options ?? {};\n\n\t\tif (options.hostedZoneOptions) {\n\t\t\tthis.hostedZone = new HostedZone(\n\t\t\t\tthis,\n\t\t\t\t`${id}-HostedZone`,\n\t\t\t\toptions.hostedZoneOptions,\n\t\t\t);\n\t\t} else if (options.fromExistingHostedZoneAttributes) {\n\t\t\tthis.hostedZone = HostedZone.fromHostedZoneAttributes(\n\t\t\t\tthis,\n\t\t\t\t`${id}-HostedZone`,\n\t\t\t\toptions.fromExistingHostedZoneAttributes,\n\t\t\t);\n\t\t} else if (options.fromLookupOptions) {\n\t\t\tthis.hostedZone = HostedZone.fromLookup(\n\t\t\t\tthis,\n\t\t\t\t`${id}-HostedZone`,\n\t\t\t\toptions.fromLookupOptions,\n\t\t\t);\n\t\t} else {\n\t\t\tthrow new CustomException(\n\t\t\t\t'BaseRoute53Construct requires one of hostedZoneOptions, fromExistingHostedZoneAttributes, or fromLookupOptions',\n\t\t\t);\n\t\t}\n\n\t\toptions.aRecords?.forEach((record, index) => {\n\t\t\tnew ARecord(this, `${id}-ARecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\toptions.aaaaRecords?.forEach((record, index) => {\n\t\t\tnew AaaaRecord(this, `${id}-AaaaRecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\toptions.cnameRecords?.forEach((record, index) => {\n\t\t\tnew CnameRecord(this, `${id}-CnameRecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\toptions.txtRecords?.forEach((record, index) => {\n\t\t\tnew TxtRecord(this, `${id}-TxtRecord-${index}`, {\n\t\t\t\t...record,\n\t\t\t\tzone: this.hostedZone,\n\t\t\t});\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the Route53 hosted zone ID\n\t\t */\n\t\tnew CfnOutput(this, 'Route53HostedZoneId', {\n\t\t\tvalue: this.hostedZone.hostedZoneId,\n\t\t});\n\t}\n}\n"]}

package/dist/{aws/cdk/constructs/s3-deployment-construct.cjs → aws-cdk/constructs/s3-deployment.cjs}

@@ -112,10 +112,14 @@ var BaseS3DeploymentConstruct = class extends constructs.Construct {
   constructor(scope, id, props) {
     super(scope, id);
     if (!props.options?.cloudfrontOptions?.defaultBehavior?.origin && !props?.withS3Bucket && props.withCloudfront) {
-      throw new toolkit.CustomException("Cloudfront distribution S3_Bucket origins must be defined!");
+      throw new toolkit.CustomException(
+        "Cloudfront distribution S3_Bucket origins must be defined!"
+      );
     }
     if (!props.options?.bucketDeploymentOptions?.destinationBucket && !props?.withS3Bucket) {
-      throw new toolkit.CustomException("Deployment S3_Bucket destination must be defined!");
+      throw new toolkit.CustomException(
+        "Deployment S3_Bucket destination must be defined!"
+      );
     }
     if (props?.withS3Bucket) {
       this.bucket = new BaseS3Construct(this, "bucket", {
@@ -133,13 +137,18 @@ var BaseS3DeploymentConstruct = class extends constructs.Construct {
             /**
              * Map additional behaviors and ensure origin is assigned
              */
-            additionalBehaviors: Object.entries(props.options?.cloudfrontOptions?.additionalBehaviors || {}).reduce((behavior, [pattern, behaviorOptions]) => {
-              behavior[pattern] = {
-                ...behaviorOptions,
-                origin: behaviorOptions.origin || s3Origin
-              };
-              return behavior;
-            }, {}),
+            additionalBehaviors: Object.entries(
+              props.options?.cloudfrontOptions?.additionalBehaviors || {}
+            ).reduce(
+              (behavior, [pattern, behaviorOptions]) => {
+                behavior[pattern] = {
+                  ...behaviorOptions,
+                  origin: behaviorOptions.origin || s3Origin
+                };
+                return behavior;
+              },
+              {}
+            ),
             /**
              * Default behavior configuration
              */
@@ -164,5 +173,5 @@ var BaseS3DeploymentConstruct = class extends constructs.Construct {
 };
 
 exports.BaseS3DeploymentConstruct = BaseS3DeploymentConstruct;
-//# sourceMappingURL=s3-deployment-construct.cjs.map
-//# sourceMappingURL=s3-deployment-construct.cjs.map
+//# sourceMappingURL=s3-deployment.cjs.map
+//# sourceMappingURL=s3-deployment.cjs.map

package/dist/aws-cdk/constructs/s3-deployment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/aws/cdk/constructs/s3-construct.ts","../../../src/aws/cdk/constructs/cloudfront-construct.ts","../../../src/aws/cdk/constructs/s3-deployment-construct.ts"],"names":["Construct","Bucket","RemovalPolicy","CfnOutput","Distribution","ViewerProtocolPolicy","Duration","CustomException","S3BucketOrigin","BucketDeployment"],"mappings":"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","file":"s3-deployment.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { Bucket, BucketProps } from 'aws-cdk-lib/aws-s3';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseS3Construct\n *\n * Provides configuration for creating an S3 bucket\n * with optional overrides for bucket properties.\n */\ninterface IS3DeploymentConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** Configuration options for the S3 bucket */\n\t\treadonly bucketOptions?: BucketProps;\n\t}>,\n\t'appName' | 'stackName'\n> {}\n\n/**\n * CDK construct for S3 bucket\n *\n * Responsibilities:\n * - Creates an S3 bucket with configurable options\n * - Applies a default removal policy if not provided\n * - Exposes the bucket ARN as a CloudFormation output\n */\nexport class BaseS3Construct extends Construct {\n\t/** The created S3 bucket instance */\n\treadonly bucket: Bucket;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for S3 bucket\n\t */\n\tconstructor(\n\t\tscope: Construct,\n\t\tid: string,\n\t\tprops: IS3DeploymentConstructProps,\n\t) {\n\t\tsuper(scope, id);\n\n\t\tthis.bucket = new Bucket(this, id, {\n\t\t\t...props.options?.bucketOptions,\n\n\t\t\t/**\n\t\t\t * Removal policy applied to the bucket\n\t\t\t * Defaults to DESTROY if not explicitly defined\n\t\t\t */\n\t\t\tremovalPolicy:\n\t\t\t\tprops.options?.bucketOptions?.removalPolicy || RemovalPolicy.DESTROY,\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the S3 bucket ARN\n\t\t */\n\t\tnew CfnOutput(this, 'S3BucketArn', {\n\t\t\tvalue: this.bucket.bucketArn,\n\t\t});\n\t}\n}\n","import { Construct } from 'constructs';\nimport { Duration } from 'aws-cdk-lib';\nimport {\n\tDistribution,\n\tDistributionProps,\n\tViewerProtocolPolicy,\n} from 'aws-cdk-lib/aws-cloudfront';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseCloudfrontConstruct\n *\n * Provides configuration for creating a CloudFront distribution\n * with optional overrides for default behaviour and error handling.\n */\ninterface ICloudfrontConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** Partial configuration for the CloudFront distribution */\n\t\treadonly cloudfrontOptions: Partial<DistributionProps>;\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {}\n\n/**\n * CDK construct for CloudFront distribution\n *\n * Responsibilities:\n * - Creates a CloudFront distribution with configurable options\n * - Enforces HTTPS redirection by default\n * - Adds fallback error responses for SPA routing (400, 403, 404 → index.html)\n */\nexport class BaseCloudfrontConstruct extends Construct {\n\t/** The created CloudFront distribution instance */\n\treadonly distribution: Distribution;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for CloudFront distribution\n\t */\n\tconstructor(scope: Construct, id: string, props: ICloudfrontConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.distribution = new Distribution(this, id, {\n\t\t\t...props.options?.cloudfrontOptions,\n\n\t\t\t/**\n\t\t\t * Default behaviour configuration\n\t\t\t * Enforces HTTPS if not explicitly defined\n\t\t\t */\n\t\t\tdefaultBehavior: {\n\t\t\t\t...props.options?.cloudfrontOptions?.defaultBehavior,\n\t\t\t\tviewerProtocolPolicy:\n\t\t\t\t\tprops.options?.cloudfrontOptions?.defaultBehavior\n\t\t\t\t\t\t?.viewerProtocolPolicy || ViewerProtocolPolicy.REDIRECT_TO_HTTPS,\n\t\t\t},\n\n\t\t\t/**\n\t\t\t * Error response configuration\n\t\t\t *\n\t\t\t * Adds SPA-friendly fallbacks:\n\t\t\t * - 400, 403, 404 responses are redirected to index.html\n\t\t\t */\n\t\t\terrorResponses: [\n\t\t\t\t...(props.options?.cloudfrontOptions?.errorResponses || []),\n\n\t\t\t\t/** Handle 400 errors */\n\t\t\t\t{\n\t\t\t\t\thttpStatus: 400,\n\t\t\t\t\tresponseHttpStatus: 200,\n\t\t\t\t\tresponsePagePath: '/index.html',\n\t\t\t\t\tttl: Duration.days(1),\n\t\t\t\t},\n\n\t\t\t\t/** Handle 403 errors */\n\t\t\t\t{\n\t\t\t\t\thttpStatus: 403,\n\t\t\t\t\tresponseHttpStatus: 200,\n\t\t\t\t\tresponsePagePath: '/index.html',\n\t\t\t\t\tttl: Duration.days(1),\n\t\t\t\t},\n\n\t\t\t\t/** Handle 404 errors */\n\t\t\t\t{\n\t\t\t\t\thttpStatus: 404,\n\t\t\t\t\tresponseHttpStatus: 200,\n\t\t\t\t\tresponsePagePath: '/index.html',\n\t\t\t\t\tttl: Duration.days(1),\n\t\t\t\t},\n\t\t\t],\n\t\t});\n\t}\n}\n","import { Construct } from 'constructs';\nimport { Bucket, BucketProps } from 'aws-cdk-lib/aws-s3';\nimport { S3BucketOrigin } from 'aws-cdk-lib/aws-cloudfront-origins';\nimport {\n\tBucketDeployment,\n\tBucketDeploymentProps,\n} from 'aws-cdk-lib/aws-s3-deployment';\nimport {\n\tBehaviorOptions,\n\tDistribution,\n\tDistributionProps,\n} from 'aws-cdk-lib/aws-cloudfront';\n\nimport { ObjectType, CustomException } from '@incloodsolutions/toolkit';\n\nimport { BaseS3Construct } from './s3-construct';\nimport { BaseCloudfrontConstruct } from './cloudfront-construct';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseS3DeploymentConstruct\n *\n * Provides configuration for:\n * - Optional S3 bucket creation\n * - Optional CloudFront distribution\n * - S3 bucket deployment\n */\ninterface IS3DeploymentConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** Configuration options for S3 bucket */\n\t\treadonly bucketOptions?: BucketProps;\n\n\t\t/**\n\t\t * Configuration options for CloudFront distribution\n\t\t *\n\t\t * Note:\n\t\t * - `additionalBehaviors` supports dynamic route mappings\n\t\t * - Origins are automatically resolved if not provided\n\t\t */\n\t\treadonly cloudfrontOptions?: Partial<\n\t\t\tOmit<DistributionProps, 'additionalBehaviors'>\n\t\t> & {\n\t\t\treadonly additionalBehaviors?: ObjectType<\n\t\t\t\tPartial<BehaviorOptions>,\n\t\t\t\tstring\n\t\t\t>;\n\t\t};\n\n\t\t/**\n\t\t * Configuration for S3 bucket deployment\n\t\t *\n\t\t * Note:\n\t\t * - `sources` is required\n\t\t * - `destinationBucket` can be auto-resolved\n\t\t */\n\t\treadonly bucketDeploymentOptions: Omit<\n\t\t\tPartial<BucketDeploymentProps>,\n\t\t\t'sources'\n\t\t> &\n\t\t\tPick<BucketDeploymentProps, 'sources'>;\n\t}>,\n\t'appName' | 'stackName'\n> {\n\t/** Whether to create a new S3 bucket */\n\treadonly withS3Bucket?: boolean;\n\n\t/** Whether to create a CloudFront distribution */\n\treadonly withCloudfront?: boolean;\n}\n\n/**\n * CDK construct for S3 deployment with optional CloudFront integration\n *\n * Responsibilities:\n * - Optionally creates an S3 bucket\n * - Optionally creates a CloudFront distribution with S3 origin\n * - Deploys assets to S3 bucket\n * - Configures CloudFront invalidation paths\n *\n * Behaviour:\n * - Automatically links S3 bucket as CloudFront origin when enabled\n * - Resolves destination bucket and distribution if not explicitly provided\n * - Throws when required dependencies are missing\n */\nexport class BaseS3DeploymentConstruct extends Construct {\n\t/** The created or provided S3 bucket */\n\treadonly bucket: Bucket;\n\n\t/** The created CloudFront distribution */\n\treadonly distribution: Distribution;\n\n\t/** S3 bucket deployment instance */\n\treadonly bucketDeployment: BucketDeployment;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for bucket, distribution, and deployment\n\t */\n\tconstructor(\n\t\tscope: Construct,\n\t\tid: string,\n\t\tprops: IS3DeploymentConstructProps,\n\t) {\n\t\tsuper(scope, id);\n\n\t\t/**\n\t\t * Validate CloudFront origin requirements\n\t\t */\n\t\tif (\n\t\t\t!props.options?.cloudfrontOptions?.defaultBehavior?.origin &&\n\t\t\t!props?.withS3Bucket &&\n\t\t\tprops.withCloudfront\n\t\t) {\n\t\t\tthrow new CustomException(\n\t\t\t\t'Cloudfront distribution S3_Bucket origins must be defined!',\n\t\t\t);\n\t\t}\n\n\t\t/**\n\t\t * Validate deployment destination requirements\n\t\t */\n\t\tif (\n\t\t\t!props.options?.bucketDeploymentOptions?.destinationBucket &&\n\t\t\t!props?.withS3Bucket\n\t\t) {\n\t\t\tthrow new CustomException(\n\t\t\t\t'Deployment S3_Bucket destination must be defined!',\n\t\t\t);\n\t\t}\n\n\t\t/**\n\t\t * Create S3 bucket if enabled\n\t\t */\n\t\tif (props?.withS3Bucket) {\n\t\t\tthis.bucket = new BaseS3Construct(this, 'bucket', {\n\t\t\t\tenableDebug: props.enableDebug,\n\t\t\t\toptions: { bucketOptions: props.options?.bucketOptions },\n\t\t\t}).bucket;\n\t\t}\n\n\t\t/**\n\t\t * Create CloudFront distribution if enabled\n\t\t */\n\t\tif (props?.withCloudfront) {\n\t\t\t/**\n\t\t\t * Resolve S3 origin for distribution\n\t\t\t */\n\t\t\tconst s3Origin =\n\t\t\t\tprops.options?.cloudfrontOptions?.defaultBehavior?.origin ||\n\t\t\t\tS3BucketOrigin.withOriginAccessControl(this.bucket);\n\n\t\t\tthis.distribution = new BaseCloudfrontConstruct(this, 'distribution', {\n\t\t\t\tenableDebug: props.enableDebug,\n\t\t\t\toptions: {\n\t\t\t\t\tcloudfrontOptions: {\n\t\t\t\t\t\t...props.options?.cloudfrontOptions,\n\n\t\t\t\t\t\t/**\n\t\t\t\t\t\t * Map additional behaviors and ensure origin is assigned\n\t\t\t\t\t\t */\n\t\t\t\t\t\tadditionalBehaviors: Object.entries(\n\t\t\t\t\t\t\tprops.options?.cloudfrontOptions?.additionalBehaviors || {},\n\t\t\t\t\t\t).reduce(\n\t\t\t\t\t\t\t(behavior, [pattern, behaviorOptions]) => {\n\t\t\t\t\t\t\t\tbehavior[pattern] = {\n\t\t\t\t\t\t\t\t\t...behaviorOptions,\n\t\t\t\t\t\t\t\t\torigin: behaviorOptions.origin || s3Origin,\n\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\treturn behavior;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{} as typeof props.options.cloudfrontOptions.additionalBehaviors,\n\t\t\t\t\t\t) as ObjectType<BehaviorOptions>,\n\n\t\t\t\t\t\t/**\n\t\t\t\t\t\t * Default behavior configuration\n\t\t\t\t\t\t */\n\t\t\t\t\t\tdefaultBehavior: {\n\t\t\t\t\t\t\t...props.options?.cloudfrontOptions?.defaultBehavior,\n\t\t\t\t\t\t\torigin: s3Origin,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t}).distribution;\n\t\t}\n\n\t\t/**\n\t\t * Deploy assets to S3 bucket\n\t\t *\n\t\t * Automatically resolves:\n\t\t * - Destination bucket\n\t\t * - CloudFront distribution\n\t\t * - Invalidation paths\n\t\t */\n\t\tthis.bucketDeployment = new BucketDeployment(this, 'deployment', {\n\t\t\t...props.options?.bucketDeploymentOptions,\n\n\t\t\t/** Target distribution for cache invalidation */\n\t\t\tdistribution:\n\t\t\t\tprops.options?.bucketDeploymentOptions?.distribution ||\n\t\t\t\tthis.distribution,\n\n\t\t\t/** Paths to invalidate after deployment */\n\t\t\tdistributionPaths: props.options?.bucketDeploymentOptions\n\t\t\t\t?.distributionPaths || ['/*'],\n\n\t\t\t/** Destination S3 bucket */\n\t\t\tdestinationBucket:\n\t\t\t\tprops.options?.bucketDeploymentOptions?.destinationBucket ||\n\t\t\t\tthis.bucket,\n\t\t} as BucketDeploymentProps);\n\t}\n}\n"]}

package/dist/{aws/cdk/constructs/s3-deployment-construct.d.ts → aws-cdk/constructs/s3-deployment.d.cts}

@@ -3,7 +3,8 @@ import { Bucket, BucketProps } from 'aws-cdk-lib/aws-s3';
 import { BucketDeployment, BucketDeploymentProps } from 'aws-cdk-lib/aws-s3-deployment';
 import { Distribution, DistributionProps, BehaviorOptions } from 'aws-cdk-lib/aws-cloudfront';
 import { ObjectType } from '@incloodsolutions/toolkit';
-import { IBaseCdkConstructProps } from '../../types/index.js';
+import { IBaseCdkConstructProps } from '../../aws-types.cjs';
+import 'aws-cdk-lib';
 
 /**
  * Props for BaseS3DeploymentConstruct

package/dist/{aws/cdk/constructs/s3-deployment-construct.d.cts → aws-cdk/constructs/s3-deployment.d.ts}

@@ -3,7 +3,8 @@ import { Bucket, BucketProps } from 'aws-cdk-lib/aws-s3';
 import { BucketDeployment, BucketDeploymentProps } from 'aws-cdk-lib/aws-s3-deployment';
 import { Distribution, DistributionProps, BehaviorOptions } from 'aws-cdk-lib/aws-cloudfront';
 import { ObjectType } from '@incloodsolutions/toolkit';
-import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import { IBaseCdkConstructProps } from '../../aws-types.js';
+import 'aws-cdk-lib';
 
 /**
  * Props for BaseS3DeploymentConstruct

package/dist/{aws/cdk/constructs/s3-deployment-construct.js → aws-cdk/constructs/s3-deployment.js}

@@ -110,10 +110,14 @@ var BaseS3DeploymentConstruct = class extends Construct {
   constructor(scope, id, props) {
     super(scope, id);
     if (!props.options?.cloudfrontOptions?.defaultBehavior?.origin && !props?.withS3Bucket && props.withCloudfront) {
-      throw new CustomException("Cloudfront distribution S3_Bucket origins must be defined!");
+      throw new CustomException(
+        "Cloudfront distribution S3_Bucket origins must be defined!"
+      );
     }
     if (!props.options?.bucketDeploymentOptions?.destinationBucket && !props?.withS3Bucket) {
-      throw new CustomException("Deployment S3_Bucket destination must be defined!");
+      throw new CustomException(
+        "Deployment S3_Bucket destination must be defined!"
+      );
     }
     if (props?.withS3Bucket) {
       this.bucket = new BaseS3Construct(this, "bucket", {
@@ -131,13 +135,18 @@ var BaseS3DeploymentConstruct = class extends Construct {
             /**
              * Map additional behaviors and ensure origin is assigned
              */
-            additionalBehaviors: Object.entries(props.options?.cloudfrontOptions?.additionalBehaviors || {}).reduce((behavior, [pattern, behaviorOptions]) => {
-              behavior[pattern] = {
-                ...behaviorOptions,
-                origin: behaviorOptions.origin || s3Origin
-              };
-              return behavior;
-            }, {}),
+            additionalBehaviors: Object.entries(
+              props.options?.cloudfrontOptions?.additionalBehaviors || {}
+            ).reduce(
+              (behavior, [pattern, behaviorOptions]) => {
+                behavior[pattern] = {
+                  ...behaviorOptions,
+                  origin: behaviorOptions.origin || s3Origin
+                };
+                return behavior;
+              },
+              {}
+            ),
             /**
              * Default behavior configuration
              */
@@ -162,5 +171,5 @@ var BaseS3DeploymentConstruct = class extends Construct {
 };
 
 export { BaseS3DeploymentConstruct };
-//# sourceMappingURL=s3-deployment-construct.js.map
-//# sourceMappingURL=s3-deployment-construct.js.map
+//# sourceMappingURL=s3-deployment.js.map
+//# sourceMappingURL=s3-deployment.js.map