@hubspot/cli 7.3.0 → 7.4.0-beta.0

package/commands/project/migrateApp.js

@@ -1,188 +1,61 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-// @ts-nocheck
-const path = require('path');
-const { addAccountOptions, addConfigOptions, addUseEnvironmentOptions, } = require('../../lib/commonOpts');
-const { trackCommandUsage, trackCommandMetadataUsage, } = require('../../lib/usageTracking');
-const { createProjectPrompt, } = require('../../lib/prompts/createProjectPrompt');
-const { i18n } = require('../../lib/lang');
-const { selectPublicAppPrompt, } = require('../../lib/prompts/selectPublicAppPrompt');
-const { poll } = require('../../lib/polling');
-const { uiBetaTag, uiLine, uiLink, uiCommandReference, uiAccountDescription, } = require('../../lib/ui');
-const SpinniesManager = require('../../lib/ui/SpinniesManager');
-const { logError, ApiErrorContext } = require('../../lib/errorHandlers/index');
-const { EXIT_CODES } = require('../../lib/enums/exitCodes');
-const { promptUser } = require('../../lib/prompts/promptUtils');
-const { isAppDeveloperAccount } = require('../../lib/accountTypes');
-const { ensureProjectExists } = require('../../lib/projects');
-const { handleKeypress } = require('../../lib/process');
-const { migrateApp, checkMigrationStatus, } = require('@hubspot/local-dev-lib/api/projects');
-const { getCwd, sanitizeFileName } = require('@hubspot/local-dev-lib/path');
-const { logger } = require('@hubspot/local-dev-lib/logger');
-const { getAccountConfig } = require('@hubspot/local-dev-lib/config');
-const { downloadProject } = require('@hubspot/local-dev-lib/api/projects');
-const { extractZipArchive } = require('@hubspot/local-dev-lib/archive');
-const { getHubSpotWebsiteOrigin } = require('@hubspot/local-dev-lib/urls');
-const { fetchPublicAppMetadata, } = require('@hubspot/local-dev-lib/api/appsDev');
-const i18nKey = 'commands.project.subcommands.migrateApp';
+exports.deprecated = exports.describe = exports.command = void 0;
+exports.handler = handler;
+exports.builder = builder;
+const lang_1 = require("../../lib/lang");
+const ui_1 = require("../../lib/ui");
+const migrate_1 = require("../app/migrate");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const commonOpts_1 = require("../../lib/commonOpts");
 exports.command = 'migrate-app';
-exports.describe = uiBetaTag(i18n(`${i18nKey}.describe`), false);
-exports.handler = async (options) => {
-    const { derivedAccountId } = options;
-    const accountConfig = getAccountConfig(derivedAccountId);
-    const accountName = uiAccountDescription(derivedAccountId);
-    trackCommandUsage('migrate-app', {}, derivedAccountId);
-    logger.log('');
-    logger.log(uiBetaTag(i18n(`${i18nKey}.header.text`), false));
-    logger.log(uiLink(i18n(`${i18nKey}.header.link`), 'https://developers.hubspot.com/docs/platform/migrate-a-public-app-to-projects'));
-    logger.log('');
-    if (!isAppDeveloperAccount(accountConfig)) {
-        uiLine();
-        logger.error(i18n(`${i18nKey}.errors.invalidAccountTypeTitle`));
-        logger.log(i18n(`${i18nKey}.errors.invalidAccountTypeDescription`, {
-            useCommand: uiCommandReference('hs accounts use'),
-            authCommand: uiCommandReference('hs auth'),
-        }));
-        uiLine();
-        process.exit(EXIT_CODES.SUCCESS);
-    }
-    const { appId } = 'appId' in options
-        ? options
-        : await selectPublicAppPrompt({
-            accountId: derivedAccountId,
-            accountName,
-            isMigratingApp: true,
-        });
-    try {
-        const { data: selectedApp } = await fetchPublicAppMetadata(appId, derivedAccountId);
-        // preventProjectMigrations returns true if we have not added app to allowlist config.
-        // listingInfo will only exist for marketplace apps
-        const preventProjectMigrations = selectedApp.preventProjectMigrations;
-        const listingInfo = selectedApp.listingInfo;
-        if (preventProjectMigrations && listingInfo) {
-            logger.error(i18n(`${i18nKey}.errors.invalidApp`, { appId }));
-            process.exit(EXIT_CODES.ERROR);
-        }
-    }
-    catch (error) {
-        logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
-        process.exit(EXIT_CODES.ERROR);
-    }
-    let projectName;
-    let projectDest;
-    try {
-        const createProjectPromptResponse = await createProjectPrompt(options);
-        projectName = createProjectPromptResponse.name;
-        projectDest = createProjectPromptResponse.dest;
-        const { projectExists } = await ensureProjectExists(derivedAccountId, projectName, {
-            allowCreate: false,
-            noLogs: true,
-        });
-        if (projectExists) {
-            logger.error(i18n(`${i18nKey}.errors.projectAlreadyExists`, {
-                projectName,
-            }));
-            process.exit(EXIT_CODES.ERROR);
-        }
-    }
-    catch (error) {
-        logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
-        process.exit(EXIT_CODES.ERROR);
-    }
-    await trackCommandMetadataUsage('migrate-app', { status: 'STARTED' }, derivedAccountId);
-    logger.log('');
-    uiLine();
-    logger.warn(i18n(`${i18nKey}.warning.title`));
-    logger.log('');
-    logger.log(i18n(`${i18nKey}.warning.projectConversion`));
-    logger.log(i18n(`${i18nKey}.warning.appConfig`));
-    logger.log('');
-    logger.log(i18n(`${i18nKey}.warning.buildAndDeploy`));
-    logger.log('');
-    logger.log(i18n(`${i18nKey}.warning.existingApps`));
-    logger.log('');
-    logger.log(i18n(`${i18nKey}.warning.copyApp`));
-    uiLine();
-    const { shouldCreateApp } = await promptUser({
-        name: 'shouldCreateApp',
-        type: 'confirm',
-        message: i18n(`${i18nKey}.createAppPrompt`),
-    });
-    process.stdin.resume();
-    if (!shouldCreateApp) {
-        process.exit(EXIT_CODES.SUCCESS);
-    }
-    try {
-        SpinniesManager.init();
-        SpinniesManager.add('migrateApp', {
-            text: i18n(`${i18nKey}.migrationStatus.inProgress`),
-        });
-        handleKeypress(async (key) => {
-            if ((key.ctrl && key.name === 'c') || key.name === 'q') {
-                SpinniesManager.remove('migrateApp');
-                logger.log(i18n(`${i18nKey}.migrationInterrupted`));
-                process.exit(EXIT_CODES.SUCCESS);
-            }
-        });
-        const { data: migrateResponse } = await migrateApp(derivedAccountId, appId, projectName);
-        const { id } = migrateResponse;
-        const pollResponse = await poll(() => checkMigrationStatus(derivedAccountId, id));
-        const { status, project } = pollResponse;
-        if (status === 'SUCCESS') {
-            const absoluteDestPath = path.resolve(getCwd(), projectDest);
-            const { env } = accountConfig;
-            const baseUrl = getHubSpotWebsiteOrigin(env);
-            const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, 1);
-            await extractZipArchive(zippedProject, sanitizeFileName(projectName), path.resolve(absoluteDestPath), { includesRootDir: true, hideLogs: true });
-            SpinniesManager.succeed('migrateApp', {
-                text: i18n(`${i18nKey}.migrationStatus.done`),
-                succeedColor: 'white',
-            });
-            logger.log('');
-            uiLine();
-            logger.success(i18n(`${i18nKey}.migrationStatus.success`));
-            logger.log('');
-            logger.log(uiLink(i18n(`${i18nKey}.projectDetailsLink`), `${baseUrl}/developer-projects/${derivedAccountId}/project/${encodeURIComponent(project.name)}`));
-            process.exit(EXIT_CODES.SUCCESS);
-        }
-    }
-    catch (error) {
-        await trackCommandMetadataUsage('migrate-app', { status: 'FAILURE' }, derivedAccountId);
-        SpinniesManager.fail('migrateApp', {
-            text: i18n(`${i18nKey}.migrationStatus.failure`),
-            failColor: 'white',
-        });
-        if (error.errors) {
-            error.errors.forEach(logError);
-        }
-        else {
-            logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
-        }
-        process.exit(EXIT_CODES.ERROR);
-    }
-    await trackCommandMetadataUsage('migrate-app', { status: 'SUCCESS' }, derivedAccountId);
-    process.exit(EXIT_CODES.SUCCESS);
-};
-exports.builder = yargs => {
+// TODO: Leave this as deprecated and remove in the next major release
+exports.describe = (0, ui_1.uiDeprecatedTag)((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.describe`), false);
+exports.deprecated = true;
+async function handler(yargs) {
+    logger_1.logger.warn((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.deprecationWarning`, {
+        oldCommand: (0, ui_1.uiCommandReference)('hs project migrate-app'),
+        newCommand: (0, ui_1.uiCommandReference)('hs app migrate'),
+    }));
+    await (0, migrate_1.handler)(yargs);
+}
+function builder(yargs) {
+    (0, commonOpts_1.addConfigOptions)(yargs);
+    (0, commonOpts_1.addAccountOptions)(yargs);
+    (0, commonOpts_1.addUseEnvironmentOptions)(yargs);
     yargs.options({
         name: {
-            describe: i18n(`${i18nKey}.options.name.describe`),
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.name.describe`),
             type: 'string',
         },
         dest: {
-            describe: i18n(`${i18nKey}.options.dest.describe`),
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.dest.describe`),
             type: 'string',
         },
         'app-id': {
-            describe: i18n(`${i18nKey}.options.appId.describe`),
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.appId.describe`),
             type: 'number',
         },
+        'platform-version': {
+            type: 'string',
+            choices: migrate_1.validMigrationTargets,
+            hidden: true,
+            default: '2023.2',
+        },
     });
     yargs.example([
-        ['$0 project migrate-app', i18n(`${i18nKey}.examples.default`)],
+        [
+            `$0 project migrate-app`,
+            (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.examples.default`),
+        ],
     ]);
-    addConfigOptions(yargs);
-    addAccountOptions(yargs);
-    addUseEnvironmentOptions(yargs);
     return yargs;
+}
+const migrateAppCommand = {
+    command: exports.command,
+    describe: exports.describe,
+    deprecated: exports.deprecated,
+    handler,
+    builder,
 };
+exports.default = migrateAppCommand;

package/commands/project/watch.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 // @ts-nocheck
+const { uiLink } = require('../../lib/ui');
+const { useV3Api } = require('../../lib/projects/buildAndDeploy');
+const { uiCommandReference } = require('../../lib/ui');
 const { i18n } = require('../../lib/lang');
 const { createWatcher } = require('../../lib/projects/watch');
 const { logError, ApiErrorContext } = require('../../lib/errorHandlers/index');
@@ -61,6 +64,15 @@ exports.handler = async (options) => {
     const { initialUpload, derivedAccountId } = options;
     trackCommandUsage('project-watch', null, derivedAccountId);
     const { projectConfig, projectDir } = await getProjectConfig();
+    if (useV3Api(projectConfig?.platformVersion)) {
+        logger.error(i18n(`commands.project.subcommands.watch.errors.v3ApiError`, {
+            command: uiCommandReference('hs project watch'),
+            newCommand: uiCommandReference('hs project dev'),
+            platformVersion: projectConfig.platformVersion,
+            linkToDocs: uiLink('How to develop locally.', 'https://developers.hubspot.com/docs/guides/crm/ui-extensions/local-development'),
+        }));
+        return process.exit(EXIT_CODES.ERROR);
+    }
     validateProjectConfig(projectConfig, projectDir);
     await ensureProjectExists(derivedAccountId, projectConfig.name);
     try {

package/lang/en.js

@@ -11,8 +11,6 @@ export const commands = {
     },
     srcIsProject: (src, command) =>
       `"${src}" is in a project folder. Did you mean "hs project ${command}"?`,
-    setDefaultAccountMoved:
-      'This command has moved. Try `hs accounts use` instead',
     handleDeprecatedEnvVariables: {
       portalEnvVarDeprecated:
         'The HUBSPOT_PORTAL_ID environment variable is deprecated. Please use HUBSPOT_ACCOUNT_ID instead.',
@@ -2818,6 +2816,11 @@ export const lib = {
       fileFiltered: filename => `Ignore rule triggered for "${filename}"`,
     },
   },
+  middleware: {
+    fireAlarm: {
+      failedToLoadBoxen: 'Failed to load boxen util.',
+    },
+  },
   ui: {
     betaTag: chalk.bold('[BETA]'),
     betaWarning: {

package/lang/en.lyaml

@@ -6,11 +6,13 @@ en:
         cmsUpdateNotification: "{{#bold}}The CMS CLI is now the HubSpot CLI{{/bold}}\n\nTo upgrade, uninstall {{#bold}}{{ packageName }}{{/bold}}\nand then run {{ updateCommand }}"
         cliUpdateNotification: "HubSpot CLI version {{#cyan}}{{#bold}}{currentVersion}{{/bold}}{{/cyan}} is outdated.\nRun {{ updateCommand }} to upgrade to version {{#cyan}}{{#bold}}{latestVersion}{{/bold}}{{/cyan}}"
       srcIsProject: "\"{{ src }}\" is in a project folder. Did you mean \"hs project {{command}}\"?"
-      setDefaultAccountMoved: "This command has moved. Try `hs accounts use` instead"
       handleDeprecatedEnvVariables:
         portalEnvVarDeprecated: "The HUBSPOT_PORTAL_ID environment variable is deprecated. Please use HUBSPOT_ACCOUNT_ID instead."
       loadConfigMiddleware:
         configFileExists: "A configuration file already exists at {{ configPath }}. To specify a new configuration file, delete the existing one and try again."
+      injectAccountIdMiddleware:
+        invalidAccountId: "In the default override file ({{ hsAccountFileName }}), the account ID must be a number. Please delete the current file and generate a new one using {{ overrideCommand }}."
+        accountNotFound: "The account in the default override file ({{ hsAccountFileName }}) wasn't found in your configured accounts. You can authorize this account using {{ authCommand }}."
     completion:
       describe: "Enable bash completion shortcuts for commands. Concat the generated script to your .bashrc, .bash_profile, or .zshrc file."
       examples:
@@ -18,11 +20,51 @@ en:
     account:
       describe: "Commands for managing configured accounts."
       subcommands:
+        auth:
+          describe: "Configure authentication for your HubSpot account."
+          options:
+            account:
+              describe: "HubSpot account to authenticate"
+          errors:
+            failedToUpdateConfig: "Failed to update the configuration file. Please try again."
+            bothConfigFilesNotAllowed: "Unable to create config file, because there is an existing \"{{ deprecatedConfig }}\" file. To create a new config file, delete the existing one and try again."
+          success:
+            configFileCreated: "Created config file \"{{ configPath }}\""
+            configFileUpdated: "Connected account \"{{ account }}\" and set it as the default account"
+        createOverride:
+          describe: "Create a new default account override file ({{ hsAccountFileName }}) in the current working directory."
+          success: "Default account override file created at {{ overrideFilePath }}"
+          accountOverride: "An account override file already exists at {{ overrideFilePath }} associated with account \"{{ accountOverride }}\"."
+          prompts:
+            replaceOverrideFile: "Replace existing account override file?"
+          errors:
+            accountNotFound: "The specified account could not be found in the config file {{ configPath }}"
+          options:
+            account:
+              describe: "Name or ID of the account to create an override file for."
+          examples:
+            default: "Create a new default account override file ({{ hsAccountFileName }}) in the current working directory"
+            idBased: "Create a new default account override file ({{ hsAccountFileName }}) in the current working directory, using the account with accountId \"1234567\""
+            nameBased: "Create a new default account override file ({{ hsAccountFileName }}) in the current working directory, using the account with name \"MyAccount\""
+        removeOverride:
+          describe: "Remove the default account override file ({{ overrideFile }}) from the current working directory."
+          accountOverride: "There is an account override file at {{ overrideFilePath }} associated with account \"{{ accountOverride }}\"."
+          prompts:
+            deleteOverrideFile: "Delete account override file?"
+          success: "Removed the default account override file."
+          noOverrideFile: "No default account override file found in the current working directory. No action required."
+          options:
+            force:
+              describe: "Skip confirmation prompt when removing the override file"
         list:
-          accounts: "{{#bold}}Accounts{{/bold}}:"
-          defaultAccount: "{{#bold}}Default account{{/bold}}: {{ account }}"
           describe: "List names of accounts defined in config."
-          configPath: "{{#bold}}Config path{{/bold}}: {{ configPath }}"
+          accounts: "{{#bold}}Accounts{{/bold}}:"
+          defaultAccountTitle: "{{#bold}}Default Account{{/bold}}"
+          defaultAccount: "Account: {{ account }}"
+          configPath: "Source: {{ configPath }}"
+          overrideFilePathTitle: "{{#bold}}Default Account Override{{/bold}}"
+          overrideFilePath: "Source: {{ overrideFilePath }}"
+          overrideAccount: "Account: {{ account }}"
           labels:
             accountId: "Account ID"
             authType: "Auth Type"
@@ -40,6 +82,8 @@ en:
           describe: "Set the Hubspot account to use as the default account. The default account can be overridden with the \"--account\" option."
           errors:
             accountNotFound: "The account \"{{ specifiedAccount }}\" could not be found in {{ configPath }}"
+          accountOverride: "This project currently has an account override set: \"{{ accountOverride }}\". Account \"{{accountOverride}}\" will continue to act as the default account for this project."
+          accountOverrideCommands: "Use {{ createOverrideCommand }} to change override accounts, or {{ removeOverrideCommand }} to remove the override and use your default account."
           examples:
             default: "Select a HubSpot account to use as the default account"
             idBased: "Set the default account to the account in the config with accountId equal to \"1234567\""
@@ -55,6 +99,7 @@ en:
           logs:
             replaceDefaultAccount: "The removed account was the default account."
           prompts:
+            deleteOverrideFile: "Delete the override file ({{ overrideFilePath }}) associated with {{ accountName }}?"
             selectAccountToRemove: "Select an account to remove from the config"
           errors:
             accountNotFound: "The account \"{{ specifiedAccount }}\" could not be found in {{ configPath }}"
@@ -70,6 +115,12 @@ en:
         info:
           accountId: "{{#bold}}Account ID{{/bold}}: {{ accountId }}"
           describe: "Print information about the default account, or about the account specified with the \"account\" option."
+          defaultAccountTitle: "{{#bold}}Default Account{{/bold}}"
+          defaultAccount: "Account: {{ account }}"
+          configPath: "Source: {{ configPath }}"
+          overrideFilePathTitle: "{{#bold}}Default Account Override{{/bold}}"
+          overrideFilePath: "Source: {{ overrideFilePath }}"
+          overrideAccount: "Account: {{ account }}"
           errors:
             notUsingPersonalAccessKey: "This command currently only supports fetching scopes for the personal access key auth type."
           options:
@@ -92,13 +143,15 @@ en:
           confirm:
             one: "Remove 1 inactive account from the CLI config?"
             other: "Remove {{ count }} inactive accounts from the CLI config?"
+          defaultAccountOverride: "\n(This will also delete the default account override file at {{ overrideFilePath }})"
+          replaceDefaultAccount: "The default account was removed."
           removeSuccess: "Removed {{ accountName }} from the CLI config."
     auth:
       describe: "Configure authentication for your HubSpot account."
       verboseDescribe: "Configure authentication for a HubSpot account. This will update the {{ configName }} file that stores your account information.\n\nThe recommended authentication method is {{#bold}}{{ authMethod }}{{/bold}}, which uses an access token tied to a specific user account."
       errors:
-        noConfigFileFound: "No config file was found. To create a new config file, use the \"hs init\" command."
         unsupportedAuthType: "Unsupported auth type: {{ type }}. The only supported authentication protocols are {{ supportedProtocols }}."
+        globalConfigFileExists: "A global config file exists at {{ configPath }}. To authorize an account, please use {{ authCommand }}."
       options:
         authType:
           describe: "Authentication method"
@@ -109,6 +162,16 @@ en:
     config:
       describe: "Commands for managing the CLI config file."
       subcommands:
+        migrate:
+          describe: "Migrate from the deprecated {{ deprecatedConfigPath }} file to the new global config file at {{ globalConfigPath }}."
+          migrationAlreadyCompleted: "No {{ deprecatedConfigPath }} deprecated configuration file found. No migration necessary."
+          errors:
+            configNotFound: "A configuration file at {{ configPath }} could not be found. Please try again with a valid file path."
+          options:
+            force: "When merging a deprecated configuration file with an existing global configuration file, overwrite any conflicting values in the global config with the deprecated config values."
+          examples:
+            default: "Migrate from the deprecated {{ deprecatedConfigPath }} file to the new global config file at {{ globalConfigPath }}"
+            configFlag: "Migrate a specific config file (specified with the config flag) to the new global config file at {{ globalConfigPath }}"
         set:
           describe: "Set various configuration options within the hubspot.config.yml file."
           promptMessage: "Select a config option to update"
@@ -456,8 +519,6 @@ en:
           describe: "Authentication method"
         account:
           describe: "HubSpot account to authenticate"
-        useHiddenConfig:
-          describe: "Use the new HubSpot configuration file located in a hidden file in the user's home directory"
       success:
         configFileCreated: "Created config file \"{{ configPath }}\""
         configFileUpdated: "Connected account \"{{ account }}\" using \"{{ authType }}\" and set it as the default account"
@@ -465,7 +526,7 @@ en:
         updateConfig: "To update an existing config file, use the \"hs auth\" command."
       errors:
         configFileExists: "The config file {{ configPath }} already exists."
-        bothConfigFilesNotAllowed: "Unable to create config file, because there is an existing one at \"{{ path }}\". To create a new config file, delete the existing one and try again."
+        globalConfigFileExists: "A global config file already exists at {{ configPath }}. To specify a new local config file, delete the existing one and try again."
     lint:
       issuesFound: "{{ count }} issues found."
       groupName: "Linting {{ path }}"
@@ -570,6 +631,7 @@ en:
           header:
             text: "Migrate an app to the projects framework"
             link: "Learn more about migrating apps to the projects framework"
+          deprecationWarning: "The {{ oldCommand }} command is deprecated and will be removed. Use {{ newCommand }} going forward."
           migrationStatus:
             inProgress: "Converting app configuration to {{#bold}}public-app.json{{/bold}} component definition ..."
             success: "{{#bold}}Your app was converted and build #1 is deployed{{/bold}}"
@@ -585,11 +647,40 @@ en:
           migrationInterrupted: "\nThe command is terminated, but app migration is still in progress. Please check your account to ensure that the project and associated app have been created successfully."
           createAppPrompt: "Proceed with migrating this app to a project component (this process can't be aborted)?"
           projectDetailsLink: "View project details in your developer account"
+          componentsToBeMigrated: "The following component types will be migrated: {{ components }}"
+          componentsThatWillNotBeMigrated: "[NOTE] These component types are not yet supported for migration but will be available later: {{ components }}"
           errors:
+            noAppsEligible: "No apps in account {{ accountId }} are currently migratable"
+            noAccountConfig: "There is no account associated with {{ accountId }} in the config file. Please choose another account and try again, or authenticate {{ accountId }} using {{ authCommand }}."
             invalidAccountTypeTitle: "{{#bold}}Developer account not targeted{{/bold}}"
             invalidAccountTypeDescription: "Only public apps created in a developer account can be converted to a project component. Select a connected developer account with {{useCommand}} or {{authCommand}} and try again."
             projectAlreadyExists: "A project with name {{ projectName }} already exists. Please choose another name."
             invalidApp: "Could not migrate appId {{ appId }}. This app cannot be migrated at this time. Please choose another public app."
+            appWithAppIdNotFound: "Could not find an app with the id {{ appId }} "
+            migrationFailed: 'Migration Failed'
+          prompt:
+            chooseApp: 'Which app would you like to migrate?'
+            inputName: '[--name] What would you like to name the project?'
+            inputDest: '[--dest] Where would you like to save the project?'
+            uidForComponent: 'What UID would you like to use for {{ componentName }}?'
+            proceed: 'Would you like to proceed?'
+          spinners:
+            beginningMigration: "Beginning migration"
+            unableToStartMigration: "Unable to begin migration"
+            finishingMigration: "Wrapping up migration"
+            migrationComplete: "Migration completed"
+            migrationFailed: "Migration failed"
+            downloadingProjectContents: "Downloading migrated project files"
+            downloadingProjectContentsComplete: "Migrated project files downloaded"
+            downloadingProjectContentsFailed: "Unable to download migrated project files"
+            copyingProjectFiles: "Copying migrated project files"
+            copyingProjectFilesComplete: "Migrated project files copied"
+            copyingProjectFilesFailed: "Unable to copy migrated project files"
+          unmigratableReasons:
+            upToDate: 'App is already up to date'
+            isPrivateApp: 'Private apps are not currently migratable'
+            listedInMarketplace: 'Listed apps are not currently migratable'
+            generic: "Unable to migrate app: {{ reasonCode }}"
         cloneApp:
           describe: "Clone a public app using the projects framework."
           examples:
@@ -608,6 +699,7 @@ en:
             invalidAccountTypeTitle: "{{#bold}}Developer account not targeted{{/bold}}"
             invalidAccountTypeDescription: "Only public apps created in a developer account can be converted to a project component. Select a connected developer account with {{useCommand}} or {{authCommand}} and try again."
             couldNotWriteConfigPath: "Failed to write project config at {{ configPath }}"
+            noAccountConfig: "There is no account associated with {{ accountId }} in the config file. Please choose another account and try again, or authenticate {{ accountId }} using {{ authCommand }}."
         add:
           describe: "Create a new component within a project."
           options:
@@ -741,6 +833,7 @@ en:
             uploadFailed: "Failed to upload file \"{{ filePath }}\" to \"{{ remotePath }}\""
             deleteFileFailed: "Failed to delete file \"{{ remotePath }}\""
             deleteFolderFailed: "Failed to delete folder \"{{ remotePath }}\""
+            v3ApiError: "{{ command }} is not supported for platform version '{{ platformVersion}}', use {{ newCommand }} instead to develop locally. {{ linkToDocs }}"
         download:
           describe: "Download your project files from HubSpot."
           examples:
@@ -1164,6 +1257,9 @@ en:
         compressed: "Project files compressed: {{ byteCount }} bytes"
         compressing: "Compressing build files to \"{{ path }}\""
         fileFiltered: "Ignore rule triggered for \"{{ filename }}\""
+    middleware:
+      fireAlarm:
+        failedToLoadBoxen: "Failed to load boxen util."
     ui:
       betaTag: "{{#bold}}[BETA]{{/bold}}"
       betaWarning:
@@ -1184,11 +1280,14 @@ en:
             command: "--account"
             message: "Use the {{ command }} option with any command to override the default account"
           accountsListCommand:
-            command: hs accounts list
+            command: "hs account list"
             message: "Run {{ command }} to see a list of configured HubSpot accounts"
           accountsUseCommand:
-            command: "hs accounts use"
+            command: "hs account use"
             message: "Run {{ command }} to set the Hubspot account that the CLI will target by default"
+          accountAuthCommand:
+            command: "hs account auth"
+            message: "Run {{ command }} to connect the CLI to additional HubSpot accounts"
           authCommand:
             command: "hs auth"
             message: "Run {{ command }} to connect the CLI to additional HubSpot accounts"
@@ -1253,6 +1352,13 @@ en:
           describe: "Use environment variable config"
         debug:
           describe: "Set log level to debug"
+    configMigrate:
+      migrateConfigPrompt: "Migrate config?\n From deprecated config file: {{ deprecatedConfigPath }}\n To new global config file: {{ globalConfigPath }}\n (This action will delete the deprecated config file).\n"
+      mergeConfigConflictPrompt: "Change the {{ property }} property in the global config from {{ newValue }} to {{ oldValue }}?"
+      mergeConfigsPrompt: "Two config files detected. Merge them?\n Deprecated config file: {{ deprecatedConfigPath }}\n Global config: {{ globalConfigPath }}\n (This action will delete the deprecated config file).\n"
+      migrationSuccess: "The deprecated config file has been migrated to the new global config file at {{ globalConfigPath }}."
+      mergeSuccess: "The deprecated config file has been merged with the global config file at {{ globalConfigPath }}."
+      skippedExistingAccounts: "\nThe following accounts were not merged, because they already exist in the global config: {{ skippedAccountIds }}.\n"
     prompts:
       projectDevTargetAccountPrompt:
         createNewSandboxOption: "<Test on a new development sandbox>"
@@ -1539,6 +1645,9 @@ en:
     doctor:
       runningDiagnostics: "Running diagnostics..."
       diagnosticsComplete: "Diagnostics complete"
+      defaultAccountOverrideFileChecks:
+        overrideActive: "Default account override file active: {{ defaultAccountOverrideFile }}"
+        overrideAccountId: "Active account ID: {{ overrideAccountId }}"
       accountChecks:
         active: "Default account active"
         inactive: "Default account isn't active"
@@ -1590,6 +1699,8 @@ en:
           settings:
             httpUseLocalhost: "The setting {{#bold}}httpUseLocalhost{{/bold}} is enabled"
             httpUseLocalhostSecondary: "This setting causes all CLI requests to route to localhost"
+        defaultAccountOverrideFile:
+          header: "Default account override file path:"
         projectConfig:
           header: "Project configuration"
           projectDirSubHeader: "Project dir: {{#bold}}{{ projectDir }}{{/bold}}"

package/lib/app/migrate.d.ts

@@ -0,0 +1,5 @@
+import { ArgumentsCamelCase } from 'yargs';
+import { MigrateAppOptions } from '../../types/Yargs';
+export declare function downloadProjectFiles(derivedAccountId: number, projectName: string, buildId: number, projectDest: string): Promise<void>;
+export declare function migrateApp2025_2(derivedAccountId: number, options: ArgumentsCamelCase<MigrateAppOptions>): Promise<void>;
+export declare function logInvalidAccountError(i18nKey: string): void;