@hubspot/cli 7.3.0-experimental.2 → 7.4.0-beta.0

package/lib/LocalDevManagerV2.js

@@ -10,6 +10,7 @@ const logger_1 = require("@hubspot/local-dev-lib/logger");
 const localDevAuth_1 = require("@hubspot/local-dev-lib/api/localDevAuth");
 const appsDev_1 = require("@hubspot/local-dev-lib/api/appsDev");
 const config_1 = require("@hubspot/local-dev-lib/config");
+const project_parsing_lib_1 = require("@hubspot/project-parsing-lib");
 const constants_1 = require("./constants");
 const SpinniesManager_1 = __importDefault(require("./ui/SpinniesManager"));
 const DevServerManagerV2_1 = __importDefault(require("./DevServerManagerV2"));
@@ -212,16 +213,13 @@ class LocalDevManagerV2 {
             : (0, ui_1.uiCommandReference)('hs project upload');
     }
     logUploadWarning(reason) {
-        let warning;
-        if (reason) {
-            warning = reason;
-        }
-        else {
+        let warning = reason;
+        if (!warning) {
             warning =
                 this.publicAppActiveInstalls && this.publicAppActiveInstalls > 0
-                    ? (0, lang_1.i18n)(`${i18nKey}.uploadWarning.defaultPublicAppWarning`, {
+                    ? (0, lang_1.i18n)(`${i18nKey}.uploadWarning.defaultMarketplaceAppWarning`, {
                         installCount: this.publicAppActiveInstalls,
-                        installText: this.publicAppActiveInstalls === 1 ? 'install' : 'installs',
+                        accountText: this.publicAppActiveInstalls === 1 ? 'account' : 'accounts',
                     })
                     : (0, lang_1.i18n)(`${i18nKey}.uploadWarning.defaultWarning`);
         }
@@ -268,10 +266,10 @@ class LocalDevManagerV2 {
         const deployedComponentNames = this.deployedBuild.subbuildStatuses.map(subbuildStatus => subbuildStatus.buildName);
         const missingProjectNodes = [];
         Object.values(this.projectNodes).forEach(node => {
-            if ((0, structure_1.isAppIRNode)(node) || (0, structure_1.isCardIRNode)(node)) {
-                if (!deployedComponentNames.includes(node.uid)) {
-                    missingProjectNodes.push(`${(0, lang_1.i18n)(`${i18nKey}.uploadWarning.appLabel`)} ${node.uid}`);
-                }
+            if (!deployedComponentNames.includes(node.uid)) {
+                const userFriendlyName = (0, project_parsing_lib_1.mapToUserFriendlyName)(node.componentType);
+                const label = userFriendlyName ? `[${userFriendlyName}] ` : '';
+                missingProjectNodes.push(`${label}${node.uid}`);
             }
         });
         if (missingProjectNodes.length) {
@@ -284,9 +282,7 @@ class LocalDevManagerV2 {
         this.watcher = chokidar_1.default.watch(this.projectDir, {
             ignoreInitial: true,
         });
-        const configPaths = Object.values(this.projectNodes)
-            .filter(structure_1.isAppIRNode)
-            .map(component => component.localDev.componentConfigPath);
+        const configPaths = Object.values(this.projectNodes).map(component => component.localDev.componentConfigPath);
         const projectConfigPath = path_1.default.join(this.projectDir, constants_1.PROJECT_CONFIG_FILE);
         configPaths.push(projectConfigPath);
         this.watcher.on('add', filePath => {
@@ -317,7 +313,6 @@ class LocalDevManagerV2 {
         try {
             await DevServerManagerV2_1.default.setup({
                 projectNodes: this.projectNodes,
-                onUploadRequired: this.logUploadWarning.bind(this),
                 accountId: this.targetTestingAccountId,
                 setActiveApp: this.setActiveApp.bind(this),
             });

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;

package/lib/app/migrate.js

@@ -0,0 +1,242 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadProjectFiles = downloadProjectFiles;
+exports.migrateApp2025_2 = migrateApp2025_2;
+exports.logInvalidAccountError = logInvalidAccountError;
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const path_1 = __importDefault(require("path"));
+const path_2 = require("@hubspot/local-dev-lib/path");
+const archive_1 = require("@hubspot/local-dev-lib/archive");
+const chalk_1 = __importDefault(require("chalk"));
+const project_parsing_lib_1 = require("@hubspot/project-parsing-lib");
+const projects_1 = require("@hubspot/local-dev-lib/constants/projects");
+const transform_1 = require("@hubspot/project-parsing-lib/src/lib/transform");
+const Migration_1 = require("@hubspot/local-dev-lib/types/Migration");
+const projects_2 = require("@hubspot/local-dev-lib/api/projects");
+const promptUtils_1 = require("../prompts/promptUtils");
+const ui_1 = require("../ui");
+const lang_1 = require("../lang");
+const projects_3 = require("../projects");
+const SpinniesManager_1 = __importDefault(require("../ui/SpinniesManager"));
+const polling_1 = require("../polling");
+const migrate_1 = require("../../api/migrate");
+function getUnmigratableReason(reasonCode) {
+    switch (reasonCode) {
+        case projects_1.UNMIGRATABLE_REASONS.UP_TO_DATE:
+            return (0, lang_1.i18n)('commands.project.subcommands.migrateApp.unmigratableReasons.upToDate');
+        case projects_1.UNMIGRATABLE_REASONS.IS_A_PRIVATE_APP:
+            return (0, lang_1.i18n)('commands.project.subcommands.migrateApp.unmigratableReasons.isPrivateApp');
+        case projects_1.UNMIGRATABLE_REASONS.LISTED_IN_MARKETPLACE:
+            return (0, lang_1.i18n)('commands.project.subcommands.migrateApp.unmigratableReasons.listedInMarketplace');
+        default:
+            return (0, lang_1.i18n)('commands.project.subcommands.migrateApp.unmigratableReasons.generic', {
+                reasonCode,
+            });
+    }
+}
+async function handleMigrationSetup(derivedAccountId, options) {
+    const { name, dest, appId } = options;
+    const { data: { migratableApps, unmigratableApps }, } = await (0, migrate_1.listAppsForMigration)(derivedAccountId);
+    const migratableAppsWithoutProject = migratableApps.filter((app) => !app.projectName);
+    const unmigratableAppsWithoutProject = unmigratableApps.filter((app) => !app.projectName);
+    const allAppsWithoutProject = [
+        ...migratableAppsWithoutProject,
+        ...unmigratableAppsWithoutProject,
+    ];
+    if (allAppsWithoutProject.length === 0) {
+        const reasons = unmigratableAppsWithoutProject.map(app => `${chalk_1.default.bold(app.appName)}: ${getUnmigratableReason(app.unmigratableReason)}`);
+        throw new Error(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.noAppsEligible`, {
+            accountId: (0, ui_1.uiAccountDescription)(derivedAccountId),
+        })}${reasons.length ? `\n  - ${reasons.join('\n  - ')}` : ''}`);
+    }
+    if (appId &&
+        !allAppsWithoutProject.some(app => {
+            return app.appId === appId;
+        })) {
+        throw new Error((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.chooseApp', {
+            appId,
+        }));
+    }
+    const appChoices = allAppsWithoutProject.map(app => ({
+        name: app.isMigratable
+            ? app.appName
+            : `[${chalk_1.default.yellow('DISABLED')}] ${app.appName} `,
+        value: app,
+        disabled: app.isMigratable
+            ? false
+            : getUnmigratableReason(app.unmigratableReason),
+    }));
+    let appIdToMigrate = appId;
+    if (!appIdToMigrate) {
+        const { appId: selectedAppId } = await (0, promptUtils_1.listPrompt)((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.chooseApp'), {
+            choices: appChoices,
+        });
+        appIdToMigrate = selectedAppId;
+    }
+    const selectedApp = allAppsWithoutProject.find(app => app.appId === appIdToMigrate);
+    const migratableComponents = [];
+    const unmigratableComponents = [];
+    selectedApp?.migrationComponents.forEach(component => {
+        if (component.isSupported) {
+            migratableComponents.push((0, transform_1.mapToUserFacingType)(component.componentType));
+        }
+        else {
+            unmigratableComponents.push((0, transform_1.mapToUserFacingType)(component.componentType));
+        }
+    });
+    if (migratableComponents.length !== 0) {
+        logger_1.logger.log((0, lang_1.i18n)('commands.project.subcommands.migrateApp.componentsToBeMigrated', {
+            components: `\n - ${migratableComponents.join('\n - ')}`,
+        }));
+    }
+    if (unmigratableComponents.length !== 0) {
+        logger_1.logger.log((0, lang_1.i18n)('commands.project.subcommands.migrateApp.componentsThatWillNotBeMigrated', {
+            components: `\n - ${unmigratableComponents.join('\n - ')}`,
+        }));
+    }
+    logger_1.logger.log();
+    const proceed = await (0, promptUtils_1.confirmPrompt)((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.proceed'));
+    if (!proceed) {
+        return {};
+    }
+    const projectName = name ||
+        (await (0, promptUtils_1.inputPrompt)((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.inputName')));
+    const { projectExists } = await (0, projects_3.ensureProjectExists)(derivedAccountId, projectName, { allowCreate: false, noLogs: true });
+    if (projectExists) {
+        throw new Error((0, lang_1.i18n)('commands.project.subcommands.migrateApp.errors.projectAlreadyExists', {
+            projectName,
+        }));
+    }
+    const projectDest = dest ||
+        (await (0, promptUtils_1.inputPrompt)((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.inputDest'), {
+            defaultAnswer: path_1.default.resolve((0, path_2.getCwd)(), (0, path_2.sanitizeFileName)(projectName)),
+        }));
+    return { appIdToMigrate, projectName, projectDest };
+}
+async function beginMigration(derivedAccountId, appId, platformVersion) {
+    SpinniesManager_1.default.add('beginningMigration', {
+        text: (0, lang_1.i18n)('commands.project.subcommands.migrateApp.spinners.beginningMigration'),
+    });
+    const uidMap = {};
+    const { data } = await (0, migrate_1.initializeMigration)(derivedAccountId, appId, platformVersion);
+    const { migrationId } = data;
+    const pollResponse = await pollMigrationStatus(derivedAccountId, migrationId, [Migration_1.MIGRATION_STATUS.INPUT_REQUIRED]);
+    if (pollResponse.status !== Migration_1.MIGRATION_STATUS.INPUT_REQUIRED) {
+        SpinniesManager_1.default.fail('beginningMigration', {
+            text: (0, lang_1.i18n)('commands.project.subcommands.migrateApp.spinners.unableToStartMigration'),
+        });
+        return;
+    }
+    const { componentsRequiringUids } = pollResponse;
+    SpinniesManager_1.default.remove('beginningMigration');
+    if (Object.values(componentsRequiringUids).length !== 0) {
+        for (const [componentId, component] of Object.entries(componentsRequiringUids)) {
+            const { componentHint, componentType } = component;
+            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.uidForComponent', {
+                componentName: componentHint
+                    ? `${componentHint} [${(0, transform_1.mapToUserFacingType)(componentType)}]`
+                    : (0, transform_1.mapToUserFacingType)(componentType),
+            }), {
+                validate: (uid) => {
+                    const result = (0, project_parsing_lib_1.validateUid)(uid);
+                    return result === undefined ? true : result;
+                },
+                defaultAnswer: (componentHint || '')
+                    .toLowerCase()
+                    .replace(/[^a-z0-9_]/g, ''),
+            });
+        }
+    }
+    return { migrationId, uidMap };
+}
+async function pollMigrationStatus(derivedAccountId, migrationId, successStates = []) {
+    return (0, polling_1.poll)(() => (0, migrate_1.checkMigrationStatusV2)(derivedAccountId, migrationId), {
+        successStates: [...successStates],
+        errorStates: [...polling_1.DEFAULT_POLLING_STATUS_LOOKUP.errorStates],
+    });
+}
+async function finalizeMigration(derivedAccountId, migrationId, uidMap, projectName) {
+    let pollResponse;
+    try {
+        SpinniesManager_1.default.add('finishingMigration', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.finishingMigration`),
+        });
+        await (0, migrate_1.continueMigration)(derivedAccountId, migrationId, uidMap, projectName);
+        pollResponse = await pollMigrationStatus(derivedAccountId, migrationId, [
+            Migration_1.MIGRATION_STATUS.SUCCESS,
+        ]);
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('finishingMigration', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.migrationFailed`),
+        });
+        throw error;
+    }
+    if (pollResponse.status === Migration_1.MIGRATION_STATUS.SUCCESS) {
+        SpinniesManager_1.default.succeed('finishingMigration', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.migrationComplete`),
+        });
+        return pollResponse.buildId;
+    }
+    else {
+        SpinniesManager_1.default.fail('finishingMigration', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.migrationFailed`),
+        });
+        if (pollResponse.status === Migration_1.MIGRATION_STATUS.FAILURE) {
+            logger_1.logger.error(pollResponse.componentErrorDetails);
+            throw new Error(pollResponse.projectErrorsDetail);
+        }
+        throw new Error((0, lang_1.i18n)('commands.project.subcommands.migrateApp.errors.migrationFailed'));
+    }
+}
+async function downloadProjectFiles(derivedAccountId, projectName, buildId, projectDest) {
+    try {
+        SpinniesManager_1.default.add('fetchingMigratedProject', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.downloadingProjectContents`),
+        });
+        const { data: zippedProject } = await (0, projects_2.downloadProject)(derivedAccountId, projectName, buildId);
+        const absoluteDestPath = projectDest
+            ? path_1.default.resolve((0, path_2.getCwd)(), projectDest)
+            : (0, path_2.getCwd)();
+        await (0, archive_1.extractZipArchive)(zippedProject, (0, path_2.sanitizeFileName)(projectName), absoluteDestPath, {
+            includesRootDir: true,
+            hideLogs: true,
+        });
+        SpinniesManager_1.default.succeed('fetchingMigratedProject', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.downloadingProjectContentsComplete`),
+        });
+        logger_1.logger.success(`Saved ${projectName} to ${projectDest}`);
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('fetchingMigratedProject', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.downloadingProjectContentsFailed`),
+        });
+        throw error;
+    }
+}
+async function migrateApp2025_2(derivedAccountId, options) {
+    SpinniesManager_1.default.init();
+    const { appIdToMigrate, projectName, projectDest } = await handleMigrationSetup(derivedAccountId, options);
+    if (!appIdToMigrate || !projectName || !projectDest) {
+        return;
+    }
+    const migrationInProgress = await beginMigration(derivedAccountId, appIdToMigrate, options.platformVersion);
+    if (!migrationInProgress) {
+        return;
+    }
+    const { migrationId, uidMap } = migrationInProgress;
+    const buildId = await finalizeMigration(derivedAccountId, migrationId, uidMap, projectName);
+    await downloadProjectFiles(derivedAccountId, projectName, buildId, projectDest);
+}
+function logInvalidAccountError(i18nKey) {
+    (0, ui_1.uiLine)();
+    logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.errors.invalidAccountTypeTitle`));
+    logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.errors.invalidAccountTypeDescription`, {
+        useCommand: (0, ui_1.uiCommandReference)('hs accounts use'),
+        authCommand: (0, ui_1.uiCommandReference)('hs auth'),
+    }));
+    (0, ui_1.uiLine)();
+}

package/lib/app/migrate_legacy.d.ts

@@ -0,0 +1,4 @@
+import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
+import { ArgumentsCamelCase } from 'yargs';
+import { MigrateAppOptions } from '../../types/Yargs';
+export declare function migrateApp2023_2(derivedAccountId: number, options: ArgumentsCamelCase<MigrateAppOptions>, accountConfig: CLIAccount): Promise<void>;

package/lib/app/migrate_legacy.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateApp2023_2 = migrateApp2023_2;
+const appsDev_1 = require("@hubspot/local-dev-lib/api/appsDev");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const projects_1 = require("@hubspot/local-dev-lib/api/projects");
+const path_1 = __importDefault(require("path"));
+const path_2 = require("@hubspot/local-dev-lib/path");
+const urls_1 = require("@hubspot/local-dev-lib/urls");
+const archive_1 = require("@hubspot/local-dev-lib/archive");
+const promptUtils_1 = require("../prompts/promptUtils");
+const errorHandlers_1 = require("../errorHandlers");
+const exitCodes_1 = require("../enums/exitCodes");
+const ui_1 = require("../ui");
+const lang_1 = require("../lang");
+const accountTypes_1 = require("../accountTypes");
+const selectPublicAppPrompt_1 = require("../prompts/selectPublicAppPrompt");
+const createProjectPrompt_1 = require("../prompts/createProjectPrompt");
+const projects_2 = require("../projects");
+const usageTracking_1 = require("../usageTracking");
+const SpinniesManager_1 = __importDefault(require("../ui/SpinniesManager"));
+const process_1 = require("../process");
+const polling_1 = require("../polling");
+const migrate_1 = require("./migrate");
+async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
+    const accountName = (0, ui_1.uiAccountDescription)(derivedAccountId);
+    if (!(0, accountTypes_1.isAppDeveloperAccount)(accountConfig)) {
+        (0, migrate_1.logInvalidAccountError)('commands.project.subcommands.migrateApp');
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+    }
+    const { appId } = 'appId' in options
+        ? options
+        : await (0, selectPublicAppPrompt_1.selectPublicAppPrompt)({
+            accountId: derivedAccountId,
+            accountName,
+            isMigratingApp: true,
+        });
+    try {
+        const { data: selectedApp } = await (0, appsDev_1.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_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.invalidApp`, {
+                appId,
+            }));
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+    }
+    catch (error) {
+        (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(options);
+    const { name: projectName, dest: projectDest } = createProjectPromptResponse;
+    const { projectExists } = await (0, projects_2.ensureProjectExists)(derivedAccountId, projectName, {
+        allowCreate: false,
+        noLogs: true,
+    });
+    if (projectExists) {
+        throw new Error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.projectAlreadyExists`, {
+            projectName,
+        }));
+    }
+    await (0, usageTracking_1.trackCommandMetadataUsage)('migrate-app', { step: 'STARTED' }, derivedAccountId);
+    logger_1.logger.log('');
+    (0, ui_1.uiLine)();
+    logger_1.logger.warn(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.title`)}\n`);
+    logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.projectConversion`));
+    logger_1.logger.log(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.appConfig`)}\n`);
+    logger_1.logger.log(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.buildAndDeploy`)}\n`);
+    logger_1.logger.log(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.existingApps`)}\n`);
+    logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.copyApp`));
+    (0, ui_1.uiLine)();
+    const { shouldCreateApp } = await (0, promptUtils_1.promptUser)({
+        name: 'shouldCreateApp',
+        type: 'confirm',
+        message: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.createAppPrompt`),
+    });
+    process.stdin.resume();
+    if (!shouldCreateApp) {
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+    }
+    try {
+        SpinniesManager_1.default.init();
+        SpinniesManager_1.default.add('migrateApp', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.inProgress`),
+        });
+        (0, process_1.handleKeypress)(async (key) => {
+            if ((key.ctrl && key.name === 'c') || key.name === 'q') {
+                SpinniesManager_1.default.remove('migrateApp');
+                logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationInterrupted`));
+                process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+            }
+        });
+        const { data: migrateResponse } = await (0, projects_1.migrateApp)(derivedAccountId, appId, projectName);
+        const { id } = migrateResponse;
+        const pollResponse = await (0, polling_1.poll)(() => (0, projects_1.checkMigrationStatus)(derivedAccountId, id));
+        const { status, project } = pollResponse;
+        if (status === 'SUCCESS') {
+            const absoluteDestPath = path_1.default.resolve((0, path_2.getCwd)(), projectDest);
+            const { env } = accountConfig;
+            const baseUrl = (0, urls_1.getHubSpotWebsiteOrigin)(env);
+            const { data: zippedProject } = await (0, projects_1.downloadProject)(derivedAccountId, projectName, 1);
+            await (0, archive_1.extractZipArchive)(zippedProject, (0, path_2.sanitizeFileName)(projectName), path_1.default.resolve(absoluteDestPath), { includesRootDir: true, hideLogs: true });
+            SpinniesManager_1.default.succeed('migrateApp', {
+                text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.done`),
+                succeedColor: 'white',
+            });
+            logger_1.logger.log('');
+            (0, ui_1.uiLine)();
+            logger_1.logger.success((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.success`));
+            logger_1.logger.log('');
+            logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.projectDetailsLink`), `${baseUrl}/developer-projects/${derivedAccountId}/project/${encodeURIComponent(project.name)}`));
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        }
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('migrateApp', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.failure`),
+            failColor: 'white',
+        });
+        throw error;
+    }
+}

package/lib/configMigrate.d.ts

@@ -0,0 +1,2 @@
+export declare function handleMigration(accountId: number | undefined, configPath?: string): Promise<void>;
+export declare function handleMerge(accountId: number | undefined, configPath?: string, force?: boolean): Promise<void>;

package/lib/configMigrate.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleMigration = handleMigration;
+exports.handleMerge = handleMerge;
+const migrate_1 = require("@hubspot/local-dev-lib/config/migrate");
+const config_1 = require("@hubspot/local-dev-lib/constants/config");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const promptUtils_1 = require("./prompts/promptUtils");
+const lang_1 = require("./lang");
+const usageTracking_1 = require("./usageTracking");
+async function handleMigration(accountId, configPath) {
+    const { shouldMigrateConfig } = await (0, promptUtils_1.promptUser)({
+        name: 'shouldMigrateConfig',
+        type: 'confirm',
+        message: (0, lang_1.i18n)('lib.configMigrate.migrateConfigPrompt', {
+            deprecatedConfigPath: (0, migrate_1.getConfigPath)(configPath, false) ||
+                config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME,
+            globalConfigPath: config_1.GLOBAL_CONFIG_PATH,
+        }),
+    });
+    if (!shouldMigrateConfig) {
+        (0, usageTracking_1.trackCommandMetadataUsage)('config-migrate', {
+            command: 'hs config migrate',
+            type: 'migration',
+            step: 'Reject migration via prompt',
+        }, accountId);
+        return;
+    }
+    const deprecatedConfig = (0, migrate_1.getDeprecatedConfig)(configPath);
+    (0, migrate_1.migrateConfig)(deprecatedConfig);
+    (0, usageTracking_1.trackCommandMetadataUsage)('config-migrate', {
+        command: 'hs config migrate',
+        type: 'migration',
+        step: 'Confirm migration via prompt',
+        successful: true,
+    }, accountId);
+    logger_1.logger.success((0, lang_1.i18n)('lib.configMigrate.migrationSuccess', {
+        globalConfigPath: config_1.GLOBAL_CONFIG_PATH,
+    }));
+    return;
+}
+async function mergeConfigProperties(globalConfig, deprecatedConfig, force) {
+    const { initialConfig, conflicts, } = (0, migrate_1.mergeConfigProperties)(globalConfig, deprecatedConfig, force);
+    if (conflicts.length > 0) {
+        for (const conflict of conflicts) {
+            const { property, newValue, oldValue } = conflict;
+            const { shouldOverwrite } = await (0, promptUtils_1.promptUser)({
+                name: 'shouldOverwrite',
+                type: 'confirm',
+                message: (0, lang_1.i18n)('lib.configMigrate.mergeConfigConflictPrompt', {
+                    property,
+                    oldValue: `${oldValue}`,
+                    newValue: `${newValue}`,
+                }),
+            });
+            if (shouldOverwrite) {
+                // @ts-expect-error Cannot reconcile CLIConfig_NEW and CLIConfig_DEPRECATED
+                initialConfig[property] = oldValue;
+            }
+        }
+    }
+    return initialConfig;
+}
+async function handleMerge(accountId, configPath, force) {
+    const { shouldMergeConfigs } = await (0, promptUtils_1.promptUser)({
+        name: 'shouldMergeConfigs',
+        type: 'confirm',
+        message: (0, lang_1.i18n)('lib.configMigrate.mergeConfigsPrompt', {
+            deprecatedConfigPath: (0, migrate_1.getConfigPath)(configPath, false) ||
+                config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME,
+            globalConfigPath: config_1.GLOBAL_CONFIG_PATH,
+        }),
+    });
+    if (!shouldMergeConfigs) {
+        (0, usageTracking_1.trackCommandMetadataUsage)('config-migrate', {
+            command: 'hs config migrate',
+            type: 'merge',
+            step: 'Reject merge via prompt',
+        }, accountId);
+        return;
+    }
+    const deprecatedConfig = (0, migrate_1.getDeprecatedConfig)(configPath);
+    const globalConfig = (0, migrate_1.getGlobalConfig)();
+    if (!deprecatedConfig || !globalConfig) {
+        return;
+    }
+    const mergedConfig = await mergeConfigProperties(globalConfig, deprecatedConfig, force);
+    const { skippedAccountIds } = (0, migrate_1.mergeExistingConfigs)(mergedConfig, deprecatedConfig);
+    if (skippedAccountIds.length > 0) {
+        logger_1.logger.log((0, lang_1.i18n)('lib.configMigrate.skippedExistingAccounts', {
+            skippedAccountIds: skippedAccountIds.join(', '),
+        }));
+    }
+    logger_1.logger.success((0, lang_1.i18n)('lib.configMigrate.mergeSuccess', {
+        globalConfigPath: config_1.GLOBAL_CONFIG_PATH,
+    }));
+    (0, usageTracking_1.trackCommandMetadataUsage)('config-migrate', {
+        command: 'hs config migrate',
+        type: 'merge',
+        step: 'Confirm merge via prompt',
+        successful: true,
+    }, accountId);
+    return;
+}

package/lib/dependencyManagement.d.ts

@@ -1,3 +1,8 @@
+export declare function isGloballyInstalled(command: string): Promise<boolean>;
+export declare function getLatestCliVersion(): Promise<{
+    latest: string;
+    next: string;
+}>;
 export declare function installPackages({ packages, installLocations, }: {
     packages?: string[];
     installLocations?: string[];