@gradientedge/cdk-utils-azure 2.35.0 → 2.37.0

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

@@ -46,12 +46,26 @@ export declare class CommonAzureStack extends ComponentResource {
      * - Primary use is to have layered config in separate files to enable easier maintenance and readability
      */
     protected determineExtraContexts(): Record<string, any>;
+    /**
+     * @summary Method to determine region contexts apart from the main context
+     * - Location is resolved from `location` Pulumi config
+     * - Loads `{regionContextPath}/{location}.json` if present
+     * - Primary use is to have layered config for each region in separate files
+     */
+    protected determineRegionContexts(): any;
     /**
      * @summary Method to determine extra stage contexts apart from the main context
      * - Sets the properties from the extra stage contexts
      * - Primary use is to have layered config for each environment which is injected into the context
      */
     protected determineStageContexts(): any;
+    /**
+     * @summary Method to determine stage-region contexts for environment and region-specific overrides
+     * - Loads `{stageRegionContextPath}/{stage}.{location}.json` if present
+     * - Has the highest priority in the configuration hierarchy
+     * - Primary use is to override config for a specific stage+region combination (e.g., prd.uksouth.json)
+     */
+    protected determineStageRegionContexts(): any;
     /**
      * @summary Create the construct instance for this stack
      * - Override in subclasses to provision infrastructure resources

package/dist/src/common/stack.js

@@ -55,14 +55,13 @@ export class CommonAzureStack extends ComponentResource {
      * @returns The stack properties
      */
     determineConstructProps(props) {
-        return {
-            ...props,
+        return _.merge({}, props, {
             extraContexts: this.config.getObject('extraContexts'),
+            regionContextPath: this.config.get('regionContextPath'),
             stage: this.config.get('stage'),
             stageContextPath: this.config.get('stageContextPath'),
-            ...this.determineExtraContexts(),
-            ...this.determineStageContexts(),
-        };
+            stageRegionContextPath: this.config.get('stageRegionContextPath'),
+        }, this.determineExtraContexts(), this.determineRegionContexts(), this.determineStageContexts(), this.determineStageRegionContexts());
     }
     /**
      * @summary Method to determine extra contexts apart from the main context
@@ -88,13 +87,41 @@ export class CommonAzureStack extends ComponentResource {
             if (debug)
                 console.debug(`Adding additional contexts provided in ${extraContextPath}`);
             /* parse as JSON properties */
-            extraContextProps = {
-                ...extraContextProps,
-                ...JSON.parse(extraContextPropsBuffer.toString('utf-8')),
-            };
+            extraContextProps = _.merge(extraContextProps, JSON.parse(extraContextPropsBuffer.toString('utf-8')));
         });
         return extraContextProps;
     }
+    /**
+     * @summary Method to determine region contexts apart from the main context
+     * - Location is resolved from `location` Pulumi config
+     * - Loads `{regionContextPath}/{location}.json` if present
+     * - Primary use is to have layered config for each region in separate files
+     */
+    determineRegionContexts() {
+        const debug = this.config.getBoolean('debug');
+        const location = this.config.get('location');
+        const regionContextPath = this.config.get('regionContextPath');
+        if (!location || !regionContextPath) {
+            if (debug)
+                console.debug(`No region context provided. Using default context properties`);
+            return {};
+        }
+        const regionContextFilePath = path.join(appRoot.path, regionContextPath, `${location}.json`);
+        /* alert default context usage when region config is missing */
+        if (!fs.existsSync(regionContextFilePath)) {
+            if (debug)
+                console.debug(`Region context properties unavailable in path:${regionContextFilePath}`);
+            if (debug)
+                console.debug(`Using default context properties for ${location} location`);
+            return {};
+        }
+        /* read the region properties */
+        const regionContextPropsBuffer = fs.readFileSync(regionContextFilePath);
+        if (debug)
+            console.debug(`Adding region contexts provided in ${regionContextFilePath}`);
+        /* parse as JSON properties */
+        return JSON.parse(regionContextPropsBuffer.toString('utf-8'));
+    }
     /**
      * @summary Method to determine extra stage contexts apart from the main context
      * - Sets the properties from the extra stage contexts
@@ -124,6 +151,36 @@ export class CommonAzureStack extends ComponentResource {
         /* parse as JSON properties */
         return JSON.parse(stageContextPropsBuffer.toString('utf-8'));
     }
+    /**
+     * @summary Method to determine stage-region contexts for environment and region-specific overrides
+     * - Loads `{stageRegionContextPath}/{stage}.{location}.json` if present
+     * - Has the highest priority in the configuration hierarchy
+     * - Primary use is to override config for a specific stage+region combination (e.g., prd.uksouth.json)
+     */
+    determineStageRegionContexts() {
+        const debug = this.config.getBoolean('debug');
+        const stage = this.config.get('stage');
+        const location = this.config.get('location');
+        const stageRegionContextPath = this.config.get('stageRegionContextPath');
+        if (!stage || !location || !stageRegionContextPath) {
+            if (debug)
+                console.debug(`No stage-region context provided. Using default context properties`);
+            return {};
+        }
+        const stageRegionContextFilePath = path.join(appRoot.path, stageRegionContextPath, `${stage}.${location}.json`);
+        /* gracefully skip when stage-region config is missing */
+        if (!fs.existsSync(stageRegionContextFilePath)) {
+            if (debug)
+                console.debug(`Stage-region context properties unavailable in path:${stageRegionContextFilePath}`);
+            return {};
+        }
+        /* read the stage-region properties */
+        const stageRegionContextPropsBuffer = fs.readFileSync(stageRegionContextFilePath);
+        if (debug)
+            console.debug(`Adding stage-region contexts provided in ${stageRegionContextFilePath}`);
+        /* parse as JSON properties */
+        return JSON.parse(stageRegionContextPropsBuffer.toString('utf-8'));
+    }
     /**
      * @summary Create the construct instance for this stack
      * - Override in subclasses to provision infrastructure resources

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils-azure",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Azure Pulumi utilities for @gradientedge/cdk-utils",
   "type": "module",
   "main": "dist/src/index.js",
@@ -23,7 +23,7 @@
     "lodash": "4.18.1",
     "uuid": "14.0.0",
     "yaml": "2.9.0",
-    "@gradientedge/cdk-utils-common": "2.3.0"
+    "@gradientedge/cdk-utils-common": "2.4.0"
   },
   "keywords": [
     "gradientedge",