npm package diff

Package: @forge/cli-shared

Versions: 6.10.0-next.4 - 6.10.0-next.5

File: package/out/ui/text.js

Index: package/out/ui/text.js
===================================================================
--- package/out/ui/text.js
+++ package/out/ui/text.js
@@ -606,35 +606,65 @@
                 }
             }
         },
         upgrade: {
-            cmdName: 'bulk-upgrade',
-            option: {
-                json: 'output results in JSON format',
-                outFile: 'specify a file to output the results',
-                version1: 'source version to upgrade in a non-interactive mode',
-                version2: 'target version to upgrade to in a non-interactive mode'
+            cmd: {
+                cmdName: 'bulk-upgrade',
+                desc: 'upgrades installations from one major version to another version.'
             },
-            desc: `upgrades installations using one major version to another version. The version selection list displays:\n${itemList(['major version number', 'deployment date', 'number of installations'])}`,
-            overViewVersionTable: (versions, environment) => `\nDetails for a total of [${versions} major versions] in [${environment}] can be seen below.\nWhere there are no upgrade paths available, use \`forge version compare\` to compare versions and see more information:\n`,
-            promptVersionTable: 'Getting app version list...',
-            selectTargetVersionToUpgrade: (installations) => `Please select version to upgrade existing ${installations} installations to:`,
-            error: {
-                missingVersionUpgradeParameters: `Missing parameters:\nError: [version bulk-upgrade --non-interactive] requires --from-version and --to-version`,
-                appVersionRolloutRunning: `App version rollout for this app environment is already running. Use \`forge version bulk-upgrade list\` to identify the running upgrade and \`forge version bulk-upgrade cancel\` to cancel.`,
-                permissionDeniedError: (fromVersion, toVersion, environmentKey) => `User does not have required permissions: \nError: [version bulk-upgrade --non-interactive --from-version ${fromVersion} --to-version ${toVersion}] requires Admin or Deployer permissions in the [${environmentKey}] environment.`,
-                noUpgradePathAvailable: (fromVersion, toVersion) => `From and to versions specify a combination for which an update is not available:\nError: [version bulk-upgrade --non-interactive --from-version ${fromVersion} --to-version ${toVersion}] does not specify a valid to and from combination. Run \`forge version bulk-upgrade\` interactively to see available versions.`,
-                inValidVersionNumberSpecified: (fromVersion, toVersion) => `Invalid version number specified:\nError: [version bulk-upgrade --non-interactive --from-version ${fromVersion} --to-version ${toVersion}] specifies a [to-version|from-version] that does not exist. Run \`forge version bulk-upgrade\` interactively to see available versions.`,
-                inValidMajorVersionNumberSpecified: (majorVersion) => `Invalid version number specified:\nError: [version bulk-upgrade --non-interactive] specifies a [major version: ${majorVersion}] that does not exist. Run \`forge version bulk-upgrade\` interactively to see available versions.`,
-                noTargetVersionAvailable: 'There are no upgrade paths available, use `forge version compare` to compare versions and see more information:',
-                tooManyRequestsFromAccount: `The capacity for concurrent app rollout requests from your account has been breached. Please try again after some time.`,
-                tooManyRequestsGlobally: `System is unavailable for app rollout requests due to breach in capacity. Please try again after some time.`
+            start: {
+                cmdName: 'start',
+                option: {
+                    json: 'output results in JSON format',
+                    outFile: 'specify a file to output the results',
+                    version1: 'source version to upgrade in a non-interactive mode',
+                    version2: 'target version to upgrade to in a non-interactive mode'
+                },
+                desc: `upgrades installations using one major version to another version. The version selection list displays:\n${itemList(['major version number', 'deployment date', 'number of installations'])}`,
+                overViewVersionTable: (versions, environment) => `\nDetails for a total of [${versions} major versions] in [${environment}] can be seen below.\nWhere there are no upgrade paths available, use \`forge version compare\` to compare versions and see more information:\n`,
+                promptVersionTable: 'Getting app version list...',
+                selectTargetVersionToUpgrade: (installations) => `Please select version to upgrade existing ${installations} installations to:`,
+                error: {
+                    missingVersionUpgradeParameters: `Missing parameters:\nError: [version bulk-upgrade start --non-interactive] requires --from-version and --to-version`,
+                    appVersionRolloutRunning: `App version rollout for this app environment is already running. Use \`forge version bulk-upgrade list\` to identify the running upgrade and \`forge version bulk-upgrade cancel\` to cancel.`,
+                    permissionDeniedError: (fromVersion, toVersion, environmentKey) => `User does not have required permissions: \nError: [version bulk-upgrade start --non-interactive --from-version ${fromVersion} --to-version ${toVersion}] requires Admin or Deployer permissions in the [${environmentKey}] environment.`,
+                    noUpgradePathAvailable: (fromVersion, toVersion) => `From and to versions specify a combination for which an update is not available:\nError: [version bulk-upgrade start --non-interactive --from-version ${fromVersion} --to-version ${toVersion}] does not specify a valid to and from combination. Run \`forge version bulk-upgrade start\` interactively to see available versions.`,
+                    inValidVersionNumberSpecified: (fromVersion, toVersion) => `Invalid version number specified:\nError: [version bulk-upgrade start --non-interactive --from-version ${fromVersion} --to-version ${toVersion}] specifies a [to-version|from-version] that does not exist. Run \`forge version bulk-upgrade start\` interactively to see available versions.`,
+                    inValidMajorVersionNumberSpecified: (majorVersion) => `Invalid version number specified:\nError: [version bulk-upgrade start --non-interactive] specifies a [major version: ${majorVersion}] that does not exist. Run \`forge version bulk-upgrade start\` interactively to see available versions.`,
+                    noTargetVersionAvailable: 'There are no upgrade paths available, use `forge version compare` to compare versions and see more information:',
+                    tooManyRequestsFromAccount: `The capacity for concurrent app rollout requests from your account has been breached. Please try again after some time.`,
+                    tooManyRequestsGlobally: `System is unavailable for app rollout requests due to breach in capacity. Please try again after some time.`
+                },
+                appVersionRolloutSuccess(appRolloutVersionId) {
+                    return `Your upgrade has been queued with upgrade ID ${appRolloutVersionId}. To view that status of your update please use the \`forge version bulk-upgrade list\` command.`;
+                },
+                warningMessage: (sourceVersionId, targetVersionId, installations) => `${chalk_1.default.bold('Warning:')} You are planning to move ${installations} installations from version ${sourceVersionId} to version ${targetVersionId}.`,
+                promptConfirmation: 'Do you want to continue?'
             },
-            appVersionRolloutSuccess(appRolloutVersionId) {
-                return `Your upgrade has been queued with upgrade ID ${appRolloutVersionId}. To view that status of your update please use the \`forge version bulk-upgrade list\` command.`;
-            },
-            warningMessage: (sourceVersionId, targetVersionId, installations) => `${chalk_1.default.bold('Warning:')} You are planning to move ${installations} installations from version ${sourceVersionId} to version ${targetVersionId}.`,
-            promptConfirmation: 'Do you want to continue?'
+            cancel: {
+                cmdName: 'cancel',
+                option: {
+                    json: 'output results in JSON format',
+                    outFile: 'specify a file to output the results',
+                    appRolloutId: 'app rollout version Id to cancel'
+                },
+                desc: `cancels a version upgrade that is in progress.`,
+                error: {
+                    missingCancelVersionUpgradeParameters: `\nMissing parameters:\nError: [version bulk-upgrade cancel] requires --app-upgrade-id`,
+                    permissionDeniedError(environmentKey) {
+                        return `User does not have permission to cancel the upgrade:\nError: [version bulk-upgrade cancel] requires Admin or Deployer permissions in the [${environmentKey}] environment.`;
+                    },
+                    noUpdateInProgress(environmentKey) {
+                        return `No updates are in progress for this app/environment:\nError: [version bulk-upgrade cancel] did not succeed. No upgrades are in progress for this app in the [${environmentKey}] environment.`;
+                    },
+                    inValidRolloutIdSpecified: `Invalid rollout id specified:\nError: [version bulk-upgrade cancel] specifies a rollout id that does not exist. Run \`forge version bulk-upgrade list\` to see rollouts running.`
+                },
+                appVersionRolloutCancelSuccess(appRolloutVersionId) {
+                    return `Your upgrade with upgrade ID ${appRolloutVersionId} has been cancelled.`;
+                },
+                warningMessage: (appRolloutVersionId, sourceVersionId, targetVersionId, installationComplete, totalInstallations) => `${chalk_1.default.bold('Warning:')} You are planning to cancel the upgrade with upgrade ID ${appRolloutVersionId} from version ${sourceVersionId} to version ${targetVersionId} that is in progress. ${installationComplete} of ${totalInstallations} installations have already been upgraded.`,
+                promptConfirmation: 'Do you want to continue?'
+            }
         }
     },
     build: {
         cmd: {