@gradientedge/cdk-utils 8.134.0 → 8.136.0

package/dist/src/lib/aws/construct/site-with-lambda-backend/constants.d.ts

@@ -2,4 +2,4 @@ export declare enum SiteWithLambdaBackendResponseHeaderPolicyType {
     ORIGIN = "origin",
     STATIC = "static"
 }
-export declare const LAMBDA_ALIAS_NAME_CURRENT = "current";
+export declare const LAMBDA_ALIAS_NAME_CURRENT = "latest";

package/dist/src/lib/aws/construct/site-with-lambda-backend/constants.js

@@ -6,4 +6,4 @@ var SiteWithLambdaBackendResponseHeaderPolicyType;
     SiteWithLambdaBackendResponseHeaderPolicyType["ORIGIN"] = "origin";
     SiteWithLambdaBackendResponseHeaderPolicyType["STATIC"] = "static";
 })(SiteWithLambdaBackendResponseHeaderPolicyType || (exports.SiteWithLambdaBackendResponseHeaderPolicyType = SiteWithLambdaBackendResponseHeaderPolicyType = {}));
-exports.LAMBDA_ALIAS_NAME_CURRENT = 'current';
+exports.LAMBDA_ALIAS_NAME_CURRENT = 'latest';

package/dist/src/lib/azure/services/storage/main.d.ts

@@ -15,7 +15,6 @@ import { StorageAccountProps, StorageBlobProps, StorageContainerProps } from './
  *     this.storageManager.createStorageAccount('MyAccount', this, props)
  *   }
  * }
- * @see [CDKTF S3 Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3-readme.html}
  * ```
  */
 export declare class AzureStorageManager {
@@ -24,6 +23,7 @@ export declare class AzureStorageManager {
      * @param id scoped id of the resource
      * @param scope scope in which this resource is defined
      * @param props storage account properties
+     * @see [CDKTF Storage Account Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageAccount.typescript.md}
      */
     createStorageAccount(id: string, scope: CommonAzureConstruct, props: StorageAccountProps): void;
     /**
@@ -31,6 +31,7 @@ export declare class AzureStorageManager {
      * @param id scoped id of the resource
      * @param scope scope in which this resource is defined
      * @param props storage container properties
+     * @see [CDKTF Storage Container Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageContainer.typescript.md}
      */
     createStorageContainer(id: string, scope: CommonAzureConstruct, props: StorageContainerProps): void;
     /**
@@ -38,6 +39,7 @@ export declare class AzureStorageManager {
      * @param id scoped id of the resource
      * @param scope scope in which this resource is defined
      * @param props storage blob properties
+     * @see [CDKTF Storage Blob Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageBlob.typescript.md}
      */
     createStorageBlob(id: string, scope: CommonAzureConstruct, props: StorageBlobProps): void;
 }

package/dist/src/lib/azure/services/storage/main.js

@@ -23,7 +23,6 @@ const utils_1 = require("../../utils");
  *     this.storageManager.createStorageAccount('MyAccount', this, props)
  *   }
  * }
- * @see [CDKTF S3 Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3-readme.html}
  * ```
  */
 class AzureStorageManager {
@@ -32,6 +31,7 @@ class AzureStorageManager {
      * @param id scoped id of the resource
      * @param scope scope in which this resource is defined
      * @param props storage account properties
+     * @see [CDKTF Storage Account Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageAccount.typescript.md}
      */
     createStorageAccount(id, scope, props) {
         if (!props)
@@ -53,15 +53,16 @@ class AzureStorageManager {
                 environment: scope.props.stage,
             },
         });
-        (0, utils_1.createTfOutput)(`${id}-storageAccountName`, scope, storageAccount.name);
-        (0, utils_1.createTfOutput)(`${id}-storageAccountFriendlyUniqueId`, scope, storageAccount.friendlyUniqueId);
-        (0, utils_1.createTfOutput)(`${id}-storageAccountId`, scope, storageAccount.id);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageAccountName`, scope, storageAccount.name);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageAccountFriendlyUniqueId`, scope, storageAccount.friendlyUniqueId);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageAccountId`, scope, storageAccount.id);
     }
     /**
      * @summary Method to create a new storage container
      * @param id scoped id of the resource
      * @param scope scope in which this resource is defined
      * @param props storage container properties
+     * @see [CDKTF Storage Container Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageContainer.typescript.md}
      */
     createStorageContainer(id, scope, props) {
         if (!props)
@@ -82,15 +83,16 @@ class AzureStorageManager {
             name: `${props.name}-${scope.props.stage}`,
             storageAccountName: storageAccount.name,
         });
-        (0, utils_1.createTfOutput)(`${id}-storageContainerName`, scope, storageContainer.name);
-        (0, utils_1.createTfOutput)(`${id}-storageContainerFriendlyUniqueId`, scope, storageContainer.friendlyUniqueId);
-        (0, utils_1.createTfOutput)(`${id}-storageContainerId`, scope, storageContainer.id);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageContainerName`, scope, storageContainer.name);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageContainerFriendlyUniqueId`, scope, storageContainer.friendlyUniqueId);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageContainerId`, scope, storageContainer.id);
     }
     /**
      * @summary Method to create a new storage blob
      * @param id scoped id of the resource
      * @param scope scope in which this resource is defined
      * @param props storage blob properties
+     * @see [CDKTF Storage Blob Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageBlob.typescript.md}
      */
     createStorageBlob(id, scope, props) {
         if (!props)
@@ -116,9 +118,9 @@ class AzureStorageManager {
             storageAccountName: storageAccount.name,
             storageContainerName: storageContainer.name,
         });
-        (0, utils_1.createTfOutput)(`${id}-storageBlobName`, scope, storageBlob.name);
-        (0, utils_1.createTfOutput)(`${id}-storageBlobFriendlyUniqueId`, scope, storageBlob.friendlyUniqueId);
-        (0, utils_1.createTfOutput)(`${id}-storageBlobId`, scope, storageBlob.id);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageBlobName`, scope, storageBlob.name);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageBlobFriendlyUniqueId`, scope, storageBlob.friendlyUniqueId);
+        (0, utils_1.createAzureTfOutput)(`${id}-storageBlobId`, scope, storageBlob.id);
     }
 }
 exports.AzureStorageManager = AzureStorageManager;

package/dist/src/lib/azure/services/storage/types.d.ts

@@ -1,10 +1,10 @@
 import { StorageAccountConfig } from '@cdktf/provider-azurerm/lib/storage-account';
 import { StorageBlobConfig } from '@cdktf/provider-azurerm/lib/storage-blob';
 import { StorageContainerConfig } from '@cdktf/provider-azurerm/lib/storage-container';
-import { BaseConfigProps } from '../../types';
+import { BaseAzureConfigProps } from '../../types';
 export interface StorageAccountProps extends StorageAccountConfig {
 }
-export interface StorageContainerProps extends BaseConfigProps, StorageContainerConfig {
+export interface StorageContainerProps extends BaseAzureConfigProps, StorageContainerConfig {
 }
-export interface StorageBlobProps extends BaseConfigProps, StorageBlobConfig {
+export interface StorageBlobProps extends BaseAzureConfigProps, StorageBlobConfig {
 }

package/dist/src/lib/azure/types/index.d.ts

@@ -1,3 +1,3 @@
-export interface BaseConfigProps {
+export interface BaseAzureConfigProps {
     resourceGroupName: string;
 }

package/dist/src/lib/azure/utils/index.d.ts

@@ -1,3 +1,3 @@
 import { TerraformOutput } from 'cdktf';
 import { CommonAzureConstruct } from '../common';
-export declare const createTfOutput: (id: string, scope: CommonAzureConstruct, value?: string, description?: string, sensitive?: boolean, overrideId?: boolean) => TerraformOutput;
+export declare const createAzureTfOutput: (id: string, scope: CommonAzureConstruct, value?: string, description?: string, sensitive?: boolean, overrideId?: boolean) => TerraformOutput;

package/dist/src/lib/azure/utils/index.js

@@ -3,10 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTfOutput = void 0;
+exports.createAzureTfOutput = void 0;
 const cdktf_1 = require("cdktf");
 const lodash_1 = __importDefault(require("lodash"));
-const createTfOutput = (id, scope, value, description, sensitive, overrideId = true) => {
+const createAzureTfOutput = (id, scope, value, description, sensitive, overrideId = true) => {
     const output = new cdktf_1.TerraformOutput(scope, id, {
         description,
         sensitive,
@@ -17,4 +17,4 @@ const createTfOutput = (id, scope, value, description, sensitive, overrideId = t
     }
     return output;
 };
-exports.createTfOutput = createTfOutput;
+exports.createAzureTfOutput = createAzureTfOutput;

package/dist/src/lib/cloudflare/common/construct.d.ts

@@ -0,0 +1,35 @@
+import { TerraformStack } from 'cdktf';
+import { Construct } from 'constructs';
+import { CloudflareZoneManager } from '../services';
+import { CommonCloudflareStackProps } from './types';
+export declare class CommonCloudflareConstruct extends TerraformStack {
+    props: CommonCloudflareStackProps;
+    id: string;
+    fullyQualifiedDomainName: string;
+    zoneManager: CloudflareZoneManager;
+    constructor(scope: Construct, id: string, props: CommonCloudflareStackProps);
+    /**
+     * @summary Determine the fully qualified domain name based on domainName & subDomain
+     */
+    protected determineFullyQualifiedDomain(): void;
+    /**
+     * @summary Utility method to determine if the initialisation is in development (dev) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isDevelopmentStage: () => boolean;
+    /**
+     * @summary Utility method to determine if the initialisation is in test (tst) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isTestStage: () => boolean;
+    /**
+     * @summary Utility method to determine if the initialisation is in uat (uat) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isUatStage: () => boolean;
+    /**
+     * @summary Utility method to determine if the initialisation is in production (prd) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isProductionStage: () => boolean;
+}

package/dist/src/lib/cloudflare/common/construct.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommonCloudflareConstruct = void 0;
+const provider_1 = require("@cdktf/provider-cloudflare/lib/provider");
+const cdktf_1 = require("cdktf");
+const common_1 = require("../../common");
+const services_1 = require("../services");
+class CommonCloudflareConstruct extends cdktf_1.TerraformStack {
+    id;
+    fullyQualifiedDomainName;
+    zoneManager;
+    constructor(scope, id, props) {
+        super(scope, id);
+        this.props = props;
+        this.id = id;
+        this.zoneManager = new services_1.CloudflareZoneManager();
+        this.determineFullyQualifiedDomain();
+        new provider_1.CloudflareProvider(this, `${this.id}-provider`, this.props);
+    }
+    /**
+     * @summary Determine the fully qualified domain name based on domainName & subDomain
+     */
+    determineFullyQualifiedDomain() {
+        this.fullyQualifiedDomainName = this.props.subDomain
+            ? `${this.props.subDomain}.${this.props.domainName}`
+            : this.props.domainName;
+    }
+    /**
+     * @summary Utility method to determine if the initialisation is in development (dev) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isDevelopmentStage = () => (0, common_1.isDevStage)(this.props.stage);
+    /**
+     * @summary Utility method to determine if the initialisation is in test (tst) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isTestStage = () => (0, common_1.isTestStage)(this.props.stage);
+    /**
+     * @summary Utility method to determine if the initialisation is in uat (uat) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isUatStage = () => (0, common_1.isUatStage)(this.props.stage);
+    /**
+     * @summary Utility method to determine if the initialisation is in production (prd) stage
+     * This is determined by the stage property injected via cdk context
+     */
+    isProductionStage = () => (0, common_1.isPrdStage)(this.props.stage);
+}
+exports.CommonCloudflareConstruct = CommonCloudflareConstruct;

package/dist/src/lib/cloudflare/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './construct';
+export * from './stack';
+export * from './types';

package/dist/src/lib/cloudflare/common/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./construct"), exports);
+__exportStar(require("./stack"), exports);
+__exportStar(require("./types"), exports);

package/dist/src/lib/cloudflare/common/stack.d.ts

@@ -0,0 +1,52 @@
+import { CommonCloudflareConstruct } from './construct';
+import { CommonCloudflareStackProps } from './types';
+import { TerraformStack } from 'cdktf';
+import { Construct } from 'constructs';
+/**
+ * @classdesc Common stack to use as a base for all higher level constructs.
+ * @example
+ * import { CommonCloudflareStack } from '@gradientedge/cdk-utils'
+ *
+ * class CustomStack extends CommonCloudflareStack {
+ *   constructor(parent: App, name: string, props: StackProps) {
+ *     super(parent, name, props)
+ *     // provision resources
+ *   }
+ * }
+ */
+export declare class CommonCloudflareStack extends TerraformStack {
+    construct: CommonCloudflareConstruct;
+    props: CommonCloudflareStackProps;
+    constructor(parent: Construct, name: string, props: CommonCloudflareStackProps);
+    /**
+     * @summary Method to determine the core CDK construct properties injected via context cdktf.json
+     * @param props The stack properties
+     * @returns The stack properties
+     */
+    protected determineConstructProps(props: CommonCloudflareStackProps): {
+        accountId: any;
+        domainName: any;
+        extraContexts: any;
+        features: any;
+        name: any;
+        skipStageForARecords: any;
+        stage: any;
+        subDomain: any;
+    };
+    /**
+     * @summary Method to determine extra cdk contexts apart from the main cdktf.json
+     * - Sets the properties from the extra contexts into cdk node context
+     * - Primary use is to have layered config in separate files to enable easier maintenance and readability
+     */
+    protected determineExtraContexts(): void;
+    /**
+     * @summary Method to determine extra cdk stage contexts apart from the main cdktf.json
+     * - Sets the properties from the extra stage contexts into cdk node context
+     * - Primary use is to have layered config for each environment which is injected into the context
+     */
+    protected determineStageContexts(): void;
+    /**
+     * @summary Determine the fully qualified domain name based on domainName & subDomain
+     */
+    protected fullyQualifiedDomain(): any;
+}

package/dist/src/lib/cloudflare/common/stack.js

@@ -0,0 +1,134 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommonCloudflareStack = void 0;
+const fs_1 = __importDefault(require("fs"));
+const construct_1 = require("./construct");
+const app_root_path_1 = __importDefault(require("app-root-path"));
+const cdktf_1 = require("cdktf");
+const lodash_1 = __importDefault(require("lodash"));
+const common_1 = require("../../common");
+/**
+ * @classdesc Common stack to use as a base for all higher level constructs.
+ * @example
+ * import { CommonCloudflareStack } from '@gradientedge/cdk-utils'
+ *
+ * class CustomStack extends CommonCloudflareStack {
+ *   constructor(parent: App, name: string, props: StackProps) {
+ *     super(parent, name, props)
+ *     // provision resources
+ *   }
+ * }
+ */
+class CommonCloudflareStack extends cdktf_1.TerraformStack {
+    construct;
+    props;
+    constructor(parent, name, props) {
+        super(parent, name);
+        /* determine extra cdk contexts */
+        this.determineExtraContexts();
+        /* determine extra cdk stage contexts */
+        this.determineStageContexts();
+        this.props = this.determineConstructProps(props);
+        /* initialise the construct */
+        this.construct = new construct_1.CommonCloudflareConstruct(this, 'cdk-utils', this.props);
+    }
+    /**
+     * @summary Method to determine the core CDK construct properties injected via context cdktf.json
+     * @param props The stack properties
+     * @returns The stack properties
+     */
+    determineConstructProps(props) {
+        return {
+            accountId: this.node.tryGetContext('accountId'),
+            domainName: this.node.tryGetContext('domainName'),
+            extraContexts: this.node.tryGetContext('extraContexts'),
+            features: this.node.tryGetContext('features'),
+            name: this.node.tryGetContext('resourceGroupName'),
+            skipStageForARecords: this.node.tryGetContext('skipStageForARecords'),
+            stage: this.node.tryGetContext('stage'),
+            subDomain: this.node.tryGetContext('subDomain'),
+        };
+    }
+    /**
+     * @summary Method to determine extra cdk contexts apart from the main cdktf.json
+     * - Sets the properties from the extra contexts into cdk node context
+     * - Primary use is to have layered config in separate files to enable easier maintenance and readability
+     */
+    determineExtraContexts() {
+        const extraContexts = this.node.tryGetContext('extraContexts');
+        const debug = this.node.tryGetContext('debug');
+        if (!extraContexts) {
+            if (debug)
+                console.debug(`No additional contexts provided. Using default context properties from cdktf.json`);
+            return;
+        }
+        lodash_1.default.forEach(extraContexts, (context) => {
+            const extraContextPath = `${app_root_path_1.default.path}/${context}`;
+            /* scenario where extra context is configured in cdk.json but absent in file system */
+            if (!fs_1.default.existsSync(extraContextPath))
+                throw `Extra context properties unavailable in path:${extraContextPath}`;
+            /* read the extra properties */
+            const extraContextPropsBuffer = fs_1.default.readFileSync(extraContextPath);
+            if (debug)
+                console.debug(`Adding additional contexts provided in ${extraContextPath}`);
+            /* parse as JSON properties */
+            const extraContextProps = JSON.parse(extraContextPropsBuffer.toString('utf-8'));
+            /* set each of the property into the cdk node context */
+            lodash_1.default.keys(extraContextProps).forEach((propKey) => {
+                this.node.setContext(propKey, extraContextProps[propKey]);
+            });
+        });
+    }
+    /**
+     * @summary Method to determine extra cdk stage contexts apart from the main cdktf.json
+     * - Sets the properties from the extra stage contexts into cdk node context
+     * - Primary use is to have layered config for each environment which is injected into the context
+     */
+    determineStageContexts() {
+        const stage = this.node.tryGetContext('stage');
+        const stageContextPath = this.node.tryGetContext('stageContextPath') || 'cdkEnv';
+        const stageContextFilePath = `${app_root_path_1.default.path}/${stageContextPath}/${stage}.json`;
+        const debug = this.node.tryGetContext('debug');
+        if ((0, common_1.isDevStage)(stage)) {
+            if (debug)
+                console.debug(`Development stage. Using default stage context properties`);
+        }
+        /* alert default context usage when extra stage config is missing */
+        if (!fs_1.default.existsSync(stageContextFilePath)) {
+            if (debug)
+                console.debug(`Stage specific context properties unavailable in path:${stageContextFilePath}`);
+            if (debug)
+                console.debug(`Using default stage context properties for ${stage} stage`);
+            return;
+        }
+        /* read the extra properties */
+        const stageContextPropsBuffer = fs_1.default.readFileSync(stageContextFilePath);
+        if (debug)
+            console.debug(`Adding additional stage contexts provided in ${stageContextFilePath}`);
+        /* parse as JSON properties */
+        const stageContextProps = JSON.parse(stageContextPropsBuffer.toString('utf-8'));
+        /* set each of the property into the cdk node context */
+        lodash_1.default.keys(stageContextProps).forEach((propKey) => {
+            /* handle object, array properties */
+            if (typeof stageContextProps[propKey] === 'object' && !Array.isArray(stageContextProps[propKey])) {
+                this.node.setContext(propKey, lodash_1.default.merge(this.node.tryGetContext(propKey), stageContextProps[propKey]));
+            }
+            else {
+                /* handle all other primitive properties */
+                this.node.setContext(propKey, stageContextProps[propKey]);
+            }
+        });
+    }
+    /**
+     * @summary Determine the fully qualified domain name based on domainName & subDomain
+     */
+    fullyQualifiedDomain() {
+        const domainName = this.node.tryGetContext('domainName');
+        const subDomain = this.node.tryGetContext('subDomain');
+        return subDomain ? `${subDomain}.${domainName}` : domainName;
+    }
+}
+exports.CommonCloudflareStack = CommonCloudflareStack;

package/dist/src/lib/cloudflare/common/types.d.ts

@@ -0,0 +1,7 @@
+import { CloudflareProviderConfig } from '@cdktf/provider-cloudflare/lib/provider';
+import { BaseProps } from '../../common';
+/**
+ */
+export interface CommonCloudflareStackProps extends BaseProps, CloudflareProviderConfig {
+    accountId: string;
+}

package/dist/src/lib/cloudflare/common/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/lib/cloudflare/index.d.ts

@@ -0,0 +1,4 @@
+export * from './common';
+export * from './services';
+export * from './types';
+export * from './utils';

package/dist/src/lib/cloudflare/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);

package/dist/src/lib/cloudflare/services/index.d.ts

@@ -0,0 +1 @@
+export * from './zone';

package/dist/src/lib/cloudflare/services/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./zone"), exports);

package/dist/src/lib/cloudflare/services/zone/index.d.ts

@@ -0,0 +1,2 @@
+export * from './main';
+export * from './types';

package/dist/src/lib/cloudflare/services/zone/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./main"), exports);
+__exportStar(require("./types"), exports);

package/dist/src/lib/cloudflare/services/zone/main.d.ts

@@ -0,0 +1,29 @@
+import { ZoneProps } from './types';
+import { CommonCloudflareConstruct } from '../../common';
+/**
+ * @classdesc Provides operations on Cloudflare Zone
+ * - A new instance of this class is injected into {@link CommonCloudflareConstruct} constructor.
+ * - If a custom construct extends {@link CommonCloudflareConstruct}, an instance is available within the context.
+ * @example
+ * ```
+ * import { CommonCloudflareConstruct, CommonCloudflareConstruct } from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends CommonCloudflareConstruct {
+ *   constructor(parent: Construct, id: string, props: CommonCloudflareStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.zoneManager.createZone('MyZone', this, props)
+ *   }
+ * }
+ * ```
+ */
+export declare class CloudflareZoneManager {
+    /**
+     * @summary Method to create a new zone
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props zone properties
+     * @see [CDKTF Zone Module]{@link https://github.com/cdktf/cdktf-provider-cloudflare/blob/main/docs/zone.typescript.md}
+     */
+    createZone(id: string, scope: CommonCloudflareConstruct, props: ZoneProps): void;
+}

package/dist/src/lib/cloudflare/services/zone/main.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudflareZoneManager = void 0;
+const zone_1 = require("@cdktf/provider-cloudflare/lib/zone");
+const utils_1 = require("../../utils");
+/**
+ * @classdesc Provides operations on Cloudflare Zone
+ * - A new instance of this class is injected into {@link CommonCloudflareConstruct} constructor.
+ * - If a custom construct extends {@link CommonCloudflareConstruct}, an instance is available within the context.
+ * @example
+ * ```
+ * import { CommonCloudflareConstruct, CommonCloudflareConstruct } from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends CommonCloudflareConstruct {
+ *   constructor(parent: Construct, id: string, props: CommonCloudflareStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.zoneManager.createZone('MyZone', this, props)
+ *   }
+ * }
+ * ```
+ */
+class CloudflareZoneManager {
+    /**
+     * @summary Method to create a new zone
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props zone properties
+     * @see [CDKTF Zone Module]{@link https://github.com/cdktf/cdktf-provider-cloudflare/blob/main/docs/zone.typescript.md}
+     */
+    createZone(id, scope, props) {
+        if (!props)
+            throw `Props undefined for ${id}`;
+        const zone = new zone_1.Zone(scope, `${id}`, {
+            ...props,
+            accountId: props.accountId ?? scope.props.accountId,
+            zone: props.zone ?? scope.props.domainName,
+        });
+        (0, utils_1.createCloudflareTfOutput)(`${id}-zoneName`, scope, zone.zone);
+        (0, utils_1.createCloudflareTfOutput)(`${id}-zoneFriendlyUniqueId`, scope, zone.friendlyUniqueId);
+        (0, utils_1.createCloudflareTfOutput)(`${id}-zoneId`, scope, zone.id);
+    }
+}
+exports.CloudflareZoneManager = CloudflareZoneManager;

package/dist/src/lib/cloudflare/services/zone/types.d.ts

@@ -0,0 +1,3 @@
+import { ZoneConfig } from '@cdktf/provider-cloudflare/lib/zone';
+export interface ZoneProps extends ZoneConfig {
+}

package/dist/src/lib/cloudflare/services/zone/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/lib/cloudflare/types/index.d.ts

@@ -0,0 +1,3 @@
+export interface BaseCloudflareProps {
+    accountId: string;
+}

package/dist/src/lib/cloudflare/types/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/lib/cloudflare/utils/index.d.ts

@@ -0,0 +1,3 @@
+import { TerraformOutput } from 'cdktf';
+import { CommonCloudflareConstruct } from '../common';
+export declare const createCloudflareTfOutput: (id: string, scope: CommonCloudflareConstruct, value?: string, description?: string, sensitive?: boolean, overrideId?: boolean) => TerraformOutput;

package/dist/src/lib/cloudflare/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCloudflareTfOutput = void 0;
+const cdktf_1 = require("cdktf");
+const lodash_1 = __importDefault(require("lodash"));
+const createCloudflareTfOutput = (id, scope, value, description, sensitive, overrideId = true) => {
+    const output = new cdktf_1.TerraformOutput(scope, id, {
+        description,
+        sensitive,
+        value,
+    });
+    if (overrideId) {
+        output.overrideLogicalId(lodash_1.default.camelCase(id));
+    }
+    return output;
+};
+exports.createCloudflareTfOutput = createCloudflareTfOutput;

package/dist/src/lib/index.d.ts

@@ -1,3 +1,4 @@
 export * from './aws';
 export * from './azure';
+export * from './cloudflare';
 export * from './common';

package/dist/src/lib/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./aws"), exports);
 __exportStar(require("./azure"), exports);
+__exportStar(require("./cloudflare"), exports);
 __exportStar(require("./common"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils",
-  "version": "8.134.0",
+  "version": "8.136.0",
   "description": "Utilities for AWS CDK provisioning",
   "main": "dist/index.js",
   "engines": {
@@ -18,6 +18,7 @@
   "keywords": [
     "gradientedge",
     "cdk",
+    "cdktf",
     "awscdk"
   ],
   "license": "MIT",
@@ -46,15 +47,16 @@
     }
   },
   "dependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.445.0",
-    "@aws-sdk/credential-providers": "^3.445.0",
-    "@aws-sdk/types": "^3.433.0",
-    "@cdktf/provider-azurerm": "^11.0.3",
+    "@aws-sdk/client-secrets-manager": "^3.449.0",
+    "@aws-sdk/credential-providers": "^3.449.0",
+    "@aws-sdk/types": "^3.449.0",
+    "@cdktf/provider-azurerm": "^11.0.4",
+    "@cdktf/provider-cloudflare": "^10.0.3",
     "@types/lodash": "^4.14.201",
     "@types/node": "^20.9.0",
     "@types/uuid": "^9.0.7",
     "app-root-path": "^3.1.0",
-    "aws-cdk-lib": "^2.105.0",
+    "aws-cdk-lib": "^2.106.1",
     "cdktf": "^0.19.1",
     "constructs": "^10.3.0",
     "lodash": "^4.17.21",
@@ -71,7 +73,7 @@
     "@types/jest": "^29.5.8",
     "@typescript-eslint/eslint-plugin": "^6.10.0",
     "@typescript-eslint/parser": "^6.10.0",
-    "aws-cdk": "^2.105.0",
+    "aws-cdk": "^2.106.1",
     "better-docs": "^2.7.2",
     "codecov": "^3.8.3",
     "commitizen": "^4.3.0",
@@ -80,7 +82,7 @@
     "eslint": "^8.53.0",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-import": "^2.29.0",
-    "eslint-plugin-jsdoc": "^46.8.2",
+    "eslint-plugin-jsdoc": "^46.9.0",
     "husky": "^8.0.3",
     "jest": "^29.7.0",
     "jest-extended": "^4.0.2",
@@ -90,8 +92,8 @@
     "jsdoc-mermaid": "^1.0.0",
     "jsdoc-plugin-typescript": "^2.2.1",
     "jsdoc-to-markdown": "^8.0.0",
-    "prettier": "^3.0.3",
-    "prettier-plugin-organize-imports": "^3.2.3",
+    "prettier": "^3.1.0",
+    "prettier-plugin-organize-imports": "^3.2.4",
     "rimraf": "^5.0.5",
     "semantic-release": "^22.0.7",
     "taffydb": "^2.7.3",

package/src/lib/aws/construct/site-with-lambda-backend/constants.ts

@@ -3,4 +3,4 @@ export enum SiteWithLambdaBackendResponseHeaderPolicyType {
   STATIC = 'static',
 }
 
-export const LAMBDA_ALIAS_NAME_CURRENT = 'current'
+export const LAMBDA_ALIAS_NAME_CURRENT = 'latest'

package/src/lib/azure/services/storage/main.ts

@@ -5,7 +5,7 @@ import { StorageAccount } from '@cdktf/provider-azurerm/lib/storage-account'
 import { StorageBlob } from '@cdktf/provider-azurerm/lib/storage-blob'
 import { StorageContainer } from '@cdktf/provider-azurerm/lib/storage-container'
 import { CommonAzureConstruct } from '../../common'
-import { createTfOutput } from '../../utils'
+import { createAzureTfOutput } from '../../utils'
 import { StorageAccountProps, StorageBlobProps, StorageContainerProps } from './types'
 
 /**
@@ -23,7 +23,6 @@ import { StorageAccountProps, StorageBlobProps, StorageContainerProps } from './
  *     this.storageManager.createStorageAccount('MyAccount', this, props)
  *   }
  * }
- * @see [CDKTF S3 Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3-readme.html}
  * ```
  */
 export class AzureStorageManager {
@@ -32,6 +31,7 @@ export class AzureStorageManager {
    * @param id scoped id of the resource
    * @param scope scope in which this resource is defined
    * @param props storage account properties
+   * @see [CDKTF Storage Account Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageAccount.typescript.md}
    */
   public createStorageAccount(id: string, scope: CommonAzureConstruct, props: StorageAccountProps) {
     if (!props) throw `Props undefined for ${id}`
@@ -55,9 +55,9 @@ export class AzureStorageManager {
       },
     })
 
-    createTfOutput(`${id}-storageAccountName`, scope, storageAccount.name)
-    createTfOutput(`${id}-storageAccountFriendlyUniqueId`, scope, storageAccount.friendlyUniqueId)
-    createTfOutput(`${id}-storageAccountId`, scope, storageAccount.id)
+    createAzureTfOutput(`${id}-storageAccountName`, scope, storageAccount.name)
+    createAzureTfOutput(`${id}-storageAccountFriendlyUniqueId`, scope, storageAccount.friendlyUniqueId)
+    createAzureTfOutput(`${id}-storageAccountId`, scope, storageAccount.id)
   }
 
   /**
@@ -65,6 +65,7 @@ export class AzureStorageManager {
    * @param id scoped id of the resource
    * @param scope scope in which this resource is defined
    * @param props storage container properties
+   * @see [CDKTF Storage Container Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageContainer.typescript.md}
    */
   public createStorageContainer(id: string, scope: CommonAzureConstruct, props: StorageContainerProps) {
     if (!props) throw `Props undefined for ${id}`
@@ -88,9 +89,9 @@ export class AzureStorageManager {
       storageAccountName: storageAccount.name,
     })
 
-    createTfOutput(`${id}-storageContainerName`, scope, storageContainer.name)
-    createTfOutput(`${id}-storageContainerFriendlyUniqueId`, scope, storageContainer.friendlyUniqueId)
-    createTfOutput(`${id}-storageContainerId`, scope, storageContainer.id)
+    createAzureTfOutput(`${id}-storageContainerName`, scope, storageContainer.name)
+    createAzureTfOutput(`${id}-storageContainerFriendlyUniqueId`, scope, storageContainer.friendlyUniqueId)
+    createAzureTfOutput(`${id}-storageContainerId`, scope, storageContainer.id)
   }
 
   /**
@@ -98,6 +99,7 @@ export class AzureStorageManager {
    * @param id scoped id of the resource
    * @param scope scope in which this resource is defined
    * @param props storage blob properties
+   * @see [CDKTF Storage Blob Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/storageBlob.typescript.md}
    */
   public createStorageBlob(id: string, scope: CommonAzureConstruct, props: StorageBlobProps) {
     if (!props) throw `Props undefined for ${id}`
@@ -127,8 +129,8 @@ export class AzureStorageManager {
       storageContainerName: storageContainer.name,
     })
 
-    createTfOutput(`${id}-storageBlobName`, scope, storageBlob.name)
-    createTfOutput(`${id}-storageBlobFriendlyUniqueId`, scope, storageBlob.friendlyUniqueId)
-    createTfOutput(`${id}-storageBlobId`, scope, storageBlob.id)
+    createAzureTfOutput(`${id}-storageBlobName`, scope, storageBlob.name)
+    createAzureTfOutput(`${id}-storageBlobFriendlyUniqueId`, scope, storageBlob.friendlyUniqueId)
+    createAzureTfOutput(`${id}-storageBlobId`, scope, storageBlob.id)
   }
 }

package/src/lib/azure/services/storage/types.ts

@@ -1,10 +1,10 @@
 import { StorageAccountConfig } from '@cdktf/provider-azurerm/lib/storage-account'
 import { StorageBlobConfig } from '@cdktf/provider-azurerm/lib/storage-blob'
 import { StorageContainerConfig } from '@cdktf/provider-azurerm/lib/storage-container'
-import { BaseConfigProps } from '../../types'
+import { BaseAzureConfigProps } from '../../types'
 
 export interface StorageAccountProps extends StorageAccountConfig {}
 
-export interface StorageContainerProps extends BaseConfigProps, StorageContainerConfig {}
+export interface StorageContainerProps extends BaseAzureConfigProps, StorageContainerConfig {}
 
-export interface StorageBlobProps extends BaseConfigProps, StorageBlobConfig {}
+export interface StorageBlobProps extends BaseAzureConfigProps, StorageBlobConfig {}

package/src/lib/azure/types/index.ts

@@ -1,3 +1,3 @@
-export interface BaseConfigProps {
+export interface BaseAzureConfigProps {
   resourceGroupName: string
 }

package/src/lib/azure/utils/index.ts

@@ -2,7 +2,7 @@ import { TerraformOutput } from 'cdktf'
 import _ from 'lodash'
 import { CommonAzureConstruct } from '../common'
 
-export const createTfOutput = (
+export const createAzureTfOutput = (
   id: string,
   scope: CommonAzureConstruct,
   value?: string,

package/src/lib/cloudflare/common/construct.ts

@@ -0,0 +1,57 @@
+import { CloudflareProvider } from '@cdktf/provider-cloudflare/lib/provider'
+import { TerraformStack } from 'cdktf'
+import { Construct } from 'constructs'
+import { isDevStage, isPrdStage, isTestStage, isUatStage } from '../../common'
+import { CloudflareZoneManager } from '../services'
+import { CommonCloudflareStackProps } from './types'
+
+export class CommonCloudflareConstruct extends TerraformStack {
+  declare props: CommonCloudflareStackProps
+  id: string
+  fullyQualifiedDomainName: string
+  zoneManager: CloudflareZoneManager
+
+  constructor(scope: Construct, id: string, props: CommonCloudflareStackProps) {
+    super(scope, id)
+    this.props = props
+    this.id = id
+
+    this.zoneManager = new CloudflareZoneManager()
+
+    this.determineFullyQualifiedDomain()
+    new CloudflareProvider(this, `${this.id}-provider`, this.props)
+  }
+
+  /**
+   * @summary Determine the fully qualified domain name based on domainName & subDomain
+   */
+  protected determineFullyQualifiedDomain(): void {
+    this.fullyQualifiedDomainName = this.props.subDomain
+      ? `${this.props.subDomain}.${this.props.domainName}`
+      : this.props.domainName
+  }
+
+  /**
+   * @summary Utility method to determine if the initialisation is in development (dev) stage
+   * This is determined by the stage property injected via cdk context
+   */
+  public isDevelopmentStage = () => isDevStage(this.props.stage)
+
+  /**
+   * @summary Utility method to determine if the initialisation is in test (tst) stage
+   * This is determined by the stage property injected via cdk context
+   */
+  public isTestStage = () => isTestStage(this.props.stage)
+
+  /**
+   * @summary Utility method to determine if the initialisation is in uat (uat) stage
+   * This is determined by the stage property injected via cdk context
+   */
+  public isUatStage = () => isUatStage(this.props.stage)
+
+  /**
+   * @summary Utility method to determine if the initialisation is in production (prd) stage
+   * This is determined by the stage property injected via cdk context
+   */
+  public isProductionStage = () => isPrdStage(this.props.stage)
+}

package/src/lib/cloudflare/common/index.ts

@@ -0,0 +1,3 @@
+export * from './construct'
+export * from './stack'
+export * from './types'

package/src/lib/cloudflare/common/stack.ts

@@ -0,0 +1,143 @@
+import fs from 'fs'
+import { CommonCloudflareConstruct } from './construct'
+import { CommonCloudflareStackProps } from './types'
+
+import appRoot from 'app-root-path'
+import { TerraformStack } from 'cdktf'
+import { Construct } from 'constructs'
+import _ from 'lodash'
+import { isDevStage } from '../../common'
+
+/**
+ * @classdesc Common stack to use as a base for all higher level constructs.
+ * @example
+ * import { CommonCloudflareStack } from '@gradientedge/cdk-utils'
+ *
+ * class CustomStack extends CommonCloudflareStack {
+ *   constructor(parent: App, name: string, props: StackProps) {
+ *     super(parent, name, props)
+ *     // provision resources
+ *   }
+ * }
+ */
+export class CommonCloudflareStack extends TerraformStack {
+  construct: CommonCloudflareConstruct
+  props: CommonCloudflareStackProps
+
+  constructor(parent: Construct, name: string, props: CommonCloudflareStackProps) {
+    super(parent, name)
+
+    /* determine extra cdk contexts */
+    this.determineExtraContexts()
+
+    /* determine extra cdk stage contexts */
+    this.determineStageContexts()
+
+    this.props = this.determineConstructProps(props)
+
+    /* initialise the construct */
+    this.construct = new CommonCloudflareConstruct(this, 'cdk-utils', this.props)
+  }
+
+  /**
+   * @summary Method to determine the core CDK construct properties injected via context cdktf.json
+   * @param props The stack properties
+   * @returns The stack properties
+   */
+  protected determineConstructProps(props: CommonCloudflareStackProps) {
+    return {
+      accountId: this.node.tryGetContext('accountId'),
+      domainName: this.node.tryGetContext('domainName'),
+      extraContexts: this.node.tryGetContext('extraContexts'),
+      features: this.node.tryGetContext('features'),
+      name: this.node.tryGetContext('resourceGroupName'),
+      skipStageForARecords: this.node.tryGetContext('skipStageForARecords'),
+      stage: this.node.tryGetContext('stage'),
+      subDomain: this.node.tryGetContext('subDomain'),
+    }
+  }
+
+  /**
+   * @summary Method to determine extra cdk contexts apart from the main cdktf.json
+   * - Sets the properties from the extra contexts into cdk node context
+   * - Primary use is to have layered config in separate files to enable easier maintenance and readability
+   */
+  protected determineExtraContexts() {
+    const extraContexts = this.node.tryGetContext('extraContexts')
+    const debug = this.node.tryGetContext('debug')
+
+    if (!extraContexts) {
+      if (debug) console.debug(`No additional contexts provided. Using default context properties from cdktf.json`)
+      return
+    }
+
+    _.forEach(extraContexts, (context: string) => {
+      const extraContextPath = `${appRoot.path}/${context}`
+
+      /* scenario where extra context is configured in cdk.json but absent in file system */
+      if (!fs.existsSync(extraContextPath)) throw `Extra context properties unavailable in path:${extraContextPath}`
+
+      /* read the extra properties */
+      const extraContextPropsBuffer = fs.readFileSync(extraContextPath)
+      if (debug) console.debug(`Adding additional contexts provided in ${extraContextPath}`)
+
+      /* parse as JSON properties */
+      const extraContextProps = JSON.parse(extraContextPropsBuffer.toString('utf-8'))
+
+      /* set each of the property into the cdk node context */
+      _.keys(extraContextProps).forEach((propKey: any) => {
+        this.node.setContext(propKey, extraContextProps[propKey])
+      })
+    })
+  }
+
+  /**
+   * @summary Method to determine extra cdk stage contexts apart from the main cdktf.json
+   * - Sets the properties from the extra stage contexts into cdk node context
+   * - Primary use is to have layered config for each environment which is injected into the context
+   */
+  protected determineStageContexts() {
+    const stage = this.node.tryGetContext('stage')
+    const stageContextPath = this.node.tryGetContext('stageContextPath') || 'cdkEnv'
+    const stageContextFilePath = `${appRoot.path}/${stageContextPath}/${stage}.json`
+    const debug = this.node.tryGetContext('debug')
+
+    if (isDevStage(stage)) {
+      if (debug) console.debug(`Development stage. Using default stage context properties`)
+    }
+
+    /* alert default context usage when extra stage config is missing */
+    if (!fs.existsSync(stageContextFilePath)) {
+      if (debug) console.debug(`Stage specific context properties unavailable in path:${stageContextFilePath}`)
+      if (debug) console.debug(`Using default stage context properties for ${stage} stage`)
+      return
+    }
+
+    /* read the extra properties */
+    const stageContextPropsBuffer = fs.readFileSync(stageContextFilePath)
+    if (debug) console.debug(`Adding additional stage contexts provided in ${stageContextFilePath}`)
+
+    /* parse as JSON properties */
+    const stageContextProps = JSON.parse(stageContextPropsBuffer.toString('utf-8'))
+
+    /* set each of the property into the cdk node context */
+    _.keys(stageContextProps).forEach((propKey: any) => {
+      /* handle object, array properties */
+      if (typeof stageContextProps[propKey] === 'object' && !Array.isArray(stageContextProps[propKey])) {
+        this.node.setContext(propKey, _.merge(this.node.tryGetContext(propKey), stageContextProps[propKey]))
+      } else {
+        /* handle all other primitive properties */
+        this.node.setContext(propKey, stageContextProps[propKey])
+      }
+    })
+  }
+
+  /**
+   * @summary Determine the fully qualified domain name based on domainName & subDomain
+   */
+  protected fullyQualifiedDomain() {
+    const domainName = this.node.tryGetContext('domainName')
+    const subDomain = this.node.tryGetContext('subDomain')
+    return subDomain ? `${subDomain}.${domainName}` : domainName
+  }
+}

package/src/lib/cloudflare/common/types.ts

@@ -0,0 +1,8 @@
+import { CloudflareProviderConfig } from '@cdktf/provider-cloudflare/lib/provider'
+import { BaseProps } from '../../common'
+
+/**
+ */
+export interface CommonCloudflareStackProps extends BaseProps, CloudflareProviderConfig {
+  accountId: string
+}

package/src/lib/cloudflare/index.ts

@@ -0,0 +1,4 @@
+export * from './common'
+export * from './services'
+export * from './types'
+export * from './utils'

package/src/lib/cloudflare/services/index.ts

@@ -0,0 +1 @@
+export * from './zone'

package/src/lib/cloudflare/services/zone/index.ts

@@ -0,0 +1,2 @@
+export * from './main'
+export * from './types'

package/src/lib/cloudflare/services/zone/main.ts

@@ -0,0 +1,44 @@
+import { Zone } from '@cdktf/provider-cloudflare/lib/zone'
+import { ZoneProps } from './types'
+import { createCloudflareTfOutput } from '../../utils'
+import { CommonCloudflareConstruct } from '../../common'
+
+/**
+ * @classdesc Provides operations on Cloudflare Zone
+ * - A new instance of this class is injected into {@link CommonCloudflareConstruct} constructor.
+ * - If a custom construct extends {@link CommonCloudflareConstruct}, an instance is available within the context.
+ * @example
+ * ```
+ * import { CommonCloudflareConstruct, CommonCloudflareConstruct } from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends CommonCloudflareConstruct {
+ *   constructor(parent: Construct, id: string, props: CommonCloudflareStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.zoneManager.createZone('MyZone', this, props)
+ *   }
+ * }
+ * ```
+ */
+export class CloudflareZoneManager {
+  /**
+   * @summary Method to create a new zone
+   * @param id scoped id of the resource
+   * @param scope scope in which this resource is defined
+   * @param props zone properties
+   * @see [CDKTF Zone Module]{@link https://github.com/cdktf/cdktf-provider-cloudflare/blob/main/docs/zone.typescript.md}
+   */
+  public createZone(id: string, scope: CommonCloudflareConstruct, props: ZoneProps) {
+    if (!props) throw `Props undefined for ${id}`
+
+    const zone = new Zone(scope, `${id}`, {
+      ...props,
+      accountId: props.accountId ?? scope.props.accountId,
+      zone: props.zone ?? scope.props.domainName,
+    })
+
+    createCloudflareTfOutput(`${id}-zoneName`, scope, zone.zone)
+    createCloudflareTfOutput(`${id}-zoneFriendlyUniqueId`, scope, zone.friendlyUniqueId)
+    createCloudflareTfOutput(`${id}-zoneId`, scope, zone.id)
+  }
+}

package/src/lib/cloudflare/services/zone/types.ts

@@ -0,0 +1,3 @@
+import { ZoneConfig } from '@cdktf/provider-cloudflare/lib/zone'
+
+export interface ZoneProps extends ZoneConfig {}

package/src/lib/cloudflare/types/index.ts

@@ -0,0 +1,3 @@
+export interface BaseCloudflareProps {
+  accountId: string
+}

package/src/lib/cloudflare/utils/index.ts

@@ -0,0 +1,23 @@
+import { TerraformOutput } from 'cdktf'
+import _ from 'lodash'
+import { CommonCloudflareConstruct } from '../common'
+
+export const createCloudflareTfOutput = (
+  id: string,
+  scope: CommonCloudflareConstruct,
+  value?: string,
+  description?: string,
+  sensitive?: boolean,
+  overrideId = true
+) => {
+  const output = new TerraformOutput(scope, id, {
+    description,
+    sensitive,
+    value,
+  })
+
+  if (overrideId) {
+    output.overrideLogicalId(_.camelCase(id))
+  }
+  return output
+}

package/src/lib/index.ts

@@ -1,3 +1,4 @@
 export * from './aws'
 export * from './azure'
+export * from './cloudflare'
 export * from './common'