SalesforceCommerceCloud
diff --git a/‎.github/actions/e2e_acquire_mrt_target/action.yml‎
Lines changed: 36 additions & 0 deletions b/‎.github/actions/e2e_acquire_mrt_target/action.yml‎
Lines changed: 36 additions & 0 deletions
diff --git a/‎.github/actions/e2e_release_mrt_target/action.yml‎
Lines changed: 20 additions & 0 deletions b/‎.github/actions/e2e_release_mrt_target/action.yml‎
Lines changed: 20 additions & 0 deletions
diff --git a/‎.github/actions/e2e_release_mrt_target/dist/main.js‎
Lines changed: 22 additions & 0 deletions b/‎.github/actions/e2e_release_mrt_target/dist/main.js‎
Lines changed: 22 additions & 0 deletions
diff --git a/‎.github/actions/e2e_release_mrt_target/dist/post.js‎
Lines changed: 48 additions & 0 deletions b/‎.github/actions/e2e_release_mrt_target/dist/post.js‎
Lines changed: 48 additions & 0 deletions
diff --git a/‎.github/actions/e2e_validate_generated_app/action.yml‎
Lines changed: 1 addition & 0 deletions b/‎.github/actions/e2e_validate_generated_app/action.yml‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎.github/actions/push_to_mrt/action.yml‎
Lines changed: 28 additions & 28 deletions b/‎.github/actions/push_to_mrt/action.yml‎
Lines changed: 28 additions & 28 deletions
diff --git a/‎.github/actions/update_mrt_target/action.yml‎
Lines changed: 63 additions & 0 deletions b/‎.github/actions/update_mrt_target/action.yml‎
Lines changed: 63 additions & 0 deletions
@@ -0,0 +1,36 @@
+name: e2e_acquire_mrt_target
+description: Acquire MRT Target from pool of available targets in the MRT staging org.
+inputs:
+    BRANCH:
+        description: 'GitHub branch name from workflow invoking this action'
+        required: false
+    RUN_ID:
+        description: 'GitHub workflow run ID from workflow invoking this action'
+        required: true
+    PR_NUMBER:
+        description: 'GitHub PR number from workflow invoking this action'
+        required: false
+    MAX_RETRIES:
+        description: 'Maximum retry attempts to acquire MRT target'
+        required: false
+        default: '3'
+    RETRY_DELAY:
+        description: 'Delay between retries in milliseconds'
+        required: false
+        default: '10000'
+
+runs:
+    using: composite
+    steps:
+        - name: Acquire MRT Target
+          id: acquire_mrt_target
+          shell: bash
+          run: |-
+              set -e
+              cmd="node e2e/scripts/mrt-target-manager.js acquire --run-id ${{inputs.RUN_ID}} --max-retries ${{inputs.MAX_RETRIES}} --retry-delay ${{inputs.RETRY_DELAY}}"
+              if [ -n "${{inputs.PR_NUMBER}}" ]; then
+                cmd="$cmd --pr-number ${{inputs.PR_NUMBER}}"
+              elif [ -n "${{inputs.BRANCH}}" ]; then
+                cmd="$cmd --branch ${{inputs.BRANCH}}"
+              fi
+              eval $cmd
@@ -0,0 +1,20 @@
+name: e2e_release_mrt_target
+description: Release MRT Target back to pool of available targets in the MRT staging org.
+inputs:
+    SLUG:
+        description: 'MRT target slug'
+        required: true
+    MAX_RETRIES:
+        description: 'Maximum retry attempts to release MRT target'
+        required: false
+        default: '3'
+    RETRY_DELAY:
+        description: 'Delay between retries in milliseconds'
+        required: false
+        default: '10000'
+
+runs:
+    using: node20 # Only 'node12', 'node16', 'node20' or 'node24' are supported.
+    main: dist/main.js
+    post: dist/post.js
+    post-if: always()
@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+/**
+ * @file main.js
+ * @description Arms the post-release cleanup for MRT targets in CI. 
+ *
+ * Intentionally empty. This file just needs to exist. Post step will read INPUT_DETAILS_FILE and perform release.
+ * 
+ * Why:
+ * - GitHub Actions post steps execute even when a job fails or is manually cancelled,
+ *   providing best-effort cleanup of leased resources.
+ * - Keeping the actual release in post.js avoids releasing too early while the job
+ *   is still running and centralizes all teardown logic at job end.
+ *
+ * See also:
+ * - post.js (performs the actual release using the saved inputs)
+ */
@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+/**
+ * @file post.js
+ * @description Performs the actual release of the MRT target back to the pool of available targets in the MRT staging org.
+ * This step is executed even when a job fails or is manually cancelled, providing best-effort cleanup of leased resources.
+ * This step is executed after the main step in the workflow.
+ */
+const fs = require('fs')
+const path = require('path')
+const {spawnSync} = require('child_process')
+const config = require('../../../../e2e/config.js')
+
+;(async () => {
+    try {
+        const workspace = process.env.GITHUB_WORKSPACE || process.cwd()
+        const detailsFile = config.MRT_TARGET_DETAILS_FILE
+        const absDetails = path.resolve(workspace, detailsFile)
+        console.log(`Reading MRT target details from ${absDetails}`)
+        if (!fs.existsSync(absDetails)) {
+            console.log(`No details file at ${absDetails}. Skipping release.`)
+            return
+        }
+
+        const details = JSON.parse(fs.readFileSync(absDetails, 'utf8'))
+        console.log(`Details: ${JSON.stringify(details)}`)
+        const slug = details && details.slug
+        if (!slug) {
+            console.log('No slug found in details file. Skipping release.')
+            return
+        }
+
+        const cli = path.resolve(workspace, 'e2e/scripts/mrt-target-manager.js')
+        console.log(`Releasing MRT target: ${slug}`)
+        const res = spawnSync('node', [cli, 'release', slug], {stdio: 'inherit', cwd: workspace})
+
+        if (res.status !== 0) {
+            console.log(`Release exited with status ${res.status}.`)
+        }
+    } catch (e) {
+        console.log(`Release step error: ${e.message}`)
+    }
+})()
@@ -14,6 +14,7 @@ runs:
   steps:
   - name: Validate generated project
     run: |
+      set -e
       COMMAND="node e2e/scripts/validate-generated-project.js ${{ inputs.PROJECT_KEY }}"
       if [[ -n "${{ inputs.TEMPLATE_VERSION }}" ]]; then
         COMMAND="$COMMAND --templateVersion ${{ inputs.TEMPLATE_VERSION }}"
 
@@ -1,31 +1,31 @@
 name: push_to_mrt
 inputs:
-  CWD:
-    description: Project directory
-    default: ${{ github.workspace }}
-  TARGET:
-    description: MRT target environment
-  FLAGS:
-    description: The rest of the flags for the push command
-  PROJECT:
-    description: MRT target project
-    default: "scaffold-pwa"
-  MESSAGE:
-    description: Bundle message / name
-    default: "build ${{ github.run_id }} on ${{ github.ref }} (${{ github.sha }})"
-  CLOUD_ORIGIN:
-    description: 'MRT Cloud origin'
-    default: 'https://cloud.mobify.com'
-  CREDENTIALS_FILE_PATH:
-    description: 'Path to the credentials file'
-    default: '~/.mobify'
+    CWD:
+        description: Project directory
+        default: ${{ github.workspace }}
+    TARGET:
+        description: MRT target environment
+    FLAGS:
+        description: The rest of the flags for the push command
+    PROJECT:
+        description: MRT target project
+        default: 'scaffold-pwa'
+    MESSAGE:
+        description: Bundle message / name
+        default: 'build ${{ github.run_id }} on ${{ github.ref }} (${{ github.sha }})'
+    CLOUD_ORIGIN:
+        description: MRT Cloud origin
+        default: 'https://cloud.mobify.com'
+    CREDENTIALS_FILE_PATH:
+        description: 'Path to the credentials file'
+        default: '~/.mobify'
 runs:
-  using: composite
-  steps:
-    - name: Push Bundle to MRT
-      run: |-
-        cd ${{ inputs.CWD }}
-        if [[ ${{ inputs.TARGET }} ]]; then
-          npm run push -- --projectSlug ${{ inputs.PROJECT }} --message "${{ inputs.MESSAGE }}" --target ${{ inputs.TARGET }} --cloud-origin ${{ inputs.CLOUD_ORIGIN }} --credentialsFile ${{ inputs.CREDENTIALS_FILE_PATH }} ${{ inputs.FLAGS }}
-        fi
-      shell: bash
+    using: composite
+    steps:
+        - name: Push Bundle to MRT
+          run: |-
+              cd ${{ inputs.CWD }}
+              if [[ ${{ inputs.TARGET }} ]]; then
+                npm run push -- --projectSlug ${{ inputs.PROJECT }} --message "${{ inputs.MESSAGE }}" --target ${{ inputs.TARGET }} --cloud-origin ${{ inputs.CLOUD_ORIGIN }} --credentialsFile ${{ inputs.CREDENTIALS_FILE_PATH }} ${{ inputs.FLAGS }}
+              fi
+          shell: bash
@@ -0,0 +1,63 @@
+name: update_mrt_target
+description: Update a MRT target environment. This endpoint automatically re-deploys the current bundle if any of the SSR-related properties are changed.
+inputs:
+    PROJECT_SLUG:
+        description: 'MRT Project slug'
+        required: true
+    TARGET_SLUG:
+        description: 'MRT Target slug'
+        required: true
+    MOBIFY_API_KEY:
+        description: 'Mobify API key'
+        required: true
+    CLOUD_ORIGIN:
+        description: 'MRT Cloud origin'
+        required: false
+        default: 'https://cloud.mobify.com'
+    MRT_TARGET_SETTINGS_FILE_PATH:
+        description: 'Path to .env file containing MRT target environment settings'
+        required: false
+    MRT_TARGET_VARS_FILE_PATH:
+        description: 'Path to .env file containing environment variables to be set on the MRT target environment'
+        required: false
+
+runs:
+    using: composite
+    steps:
+        - name: Update MRT Target Settings
+          id: update_mrt_target_settings
+          if: ${{ inputs.MRT_TARGET_SETTINGS_FILE_PATH != '' }}
+          shell: bash
+          run: |-
+              set -e
+
+              # Build arguments for the Node.js script
+              ARGS=(
+                  "--project-slug" "${{ inputs.PROJECT_SLUG }}"
+                  "--target-slug" "${{ inputs.TARGET_SLUG }}"
+                  "--mobify-api-key" "${{ inputs.MOBIFY_API_KEY }}"
+                  "--cloud-origin" "${{ inputs.CLOUD_ORIGIN }}"
+                  "--env-file" "${{ inputs.MRT_TARGET_SETTINGS_FILE_PATH }}"
+              )
+
+              # Run the Node.js script
+              node e2e/scripts/update-mrt-target.js target "${ARGS[@]}"
+
+        - name: Update MRT Target Environment Variables
+          id: update_mrt_target_env_vars
+          if: ${{ inputs.MRT_TARGET_VARS_FILE_PATH != '' }}
+          shell: bash
+          run: |-
+              set -e
+
+              # Build arguments for the Node.js script
+              ARGS=(
+                  "--project-slug" "${{ inputs.PROJECT_SLUG }}"
+                  "--target-slug" "${{ inputs.TARGET_SLUG }}"
+                  "--mobify-api-key" "${{ inputs.MOBIFY_API_KEY }}"
+                  "--env-file" "${{ inputs.MRT_TARGET_VARS_FILE_PATH }}"
+                  "--cloud-origin" "${{ inputs.CLOUD_ORIGIN }}"
+              )
+
+              # Run the Node.js script
+              node e2e/scripts/update-mrt-target.js env-var "${ARGS[@]}"