@hubspot/cli 7.3.0 → 7.4.1-experimental.0

package/bin/cli.js

@@ -43,6 +43,7 @@ const cmsCommand = require('../commands/cms');
 const feedbackCommand = require('../commands/feedback');
 const doctorCommand = require('../commands/doctor');
 const completionCommand = require('../commands/completion');
+const appCommand = require('../commands/app');
 const notifier = updateNotifier({
     pkg: { ...pkg, name: '@hubspot/cli' },
     distTag: 'latest',
@@ -294,6 +295,7 @@ const argv = yargs
     .command(feedbackCommand)
     .command(doctorCommand)
     .command(completionCommand)
+    .command(appCommand)
     .help()
     .alias('h', 'help')
     .recommendCommands()

package/commands/app/migrate.d.ts

@@ -0,0 +1,7 @@
+import { ArgumentsCamelCase, Argv, CommandModule } from 'yargs';
+import { MigrateAppOptions } from '../../types/Yargs';
+export declare const validMigrationTargets: string[];
+export declare function handler(options: ArgumentsCamelCase<MigrateAppOptions>): Promise<never>;
+export declare function builder(yargs: Argv): Argv<MigrateAppOptions>;
+declare const migrateCommand: CommandModule<unknown, MigrateAppOptions>;
+export default migrateCommand;

package/commands/app/migrate.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validMigrationTargets = void 0;
+exports.handler = handler;
+exports.builder = builder;
+const commonOpts_1 = require("../../lib/commonOpts");
+const usageTracking_1 = require("../../lib/usageTracking");
+const lang_1 = require("../../lib/lang");
+const errorHandlers_1 = require("../../lib/errorHandlers");
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const config_1 = require("@hubspot/local-dev-lib/config");
+const migrate_1 = require("../../lib/app/migrate");
+const projects_1 = require("@hubspot/local-dev-lib/constants/projects");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const ui_1 = require("../../lib/ui");
+const { v2023_2, v2025_2, unstable } = projects_1.PLATFORM_VERSIONS;
+exports.validMigrationTargets = [v2023_2, v2025_2, unstable];
+const command = 'migrate';
+const describe = undefined; // uiBetaTag(i18n(`commands.project.subcommands.migrateApp.header.text.describe`), false);
+async function handler(options) {
+    const { derivedAccountId, platformVersion } = options;
+    await (0, usageTracking_1.trackCommandUsage)('migrate-app', {}, derivedAccountId);
+    const accountConfig = (0, config_1.getAccountConfig)(derivedAccountId);
+    if (!accountConfig) {
+        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.noAccountConfig`));
+        return process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    logger_1.logger.log('');
+    logger_1.logger.log((0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.header.text`), false));
+    logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.header.link`), 'https://developers.hubspot.com/docs/platform/migrate-a-public-app-to-projects'));
+    logger_1.logger.log('');
+    try {
+        if (platformVersion === v2025_2 || platformVersion === unstable) {
+            await (0, migrate_1.migrateApp2025_2)(derivedAccountId, options);
+        }
+        else {
+            await (0, migrate_1.migrateApp2023_2)(derivedAccountId, options, accountConfig);
+        }
+    }
+    catch (error) {
+        if (error &&
+            typeof error === 'object' &&
+            'errors' in error &&
+            Array.isArray(error.errors)) {
+            error.errors.forEach(err => (0, errorHandlers_1.logError)(err));
+        }
+        else {
+            (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
+        }
+        await (0, usageTracking_1.trackCommandMetadataUsage)('migrate-app', { successful: false }, derivedAccountId);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    await (0, usageTracking_1.trackCommandMetadataUsage)('migrate-app', { successful: true }, derivedAccountId);
+    return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+}
+function builder(yargs) {
+    (0, commonOpts_1.addConfigOptions)(yargs);
+    (0, commonOpts_1.addAccountOptions)(yargs);
+    (0, commonOpts_1.addUseEnvironmentOptions)(yargs);
+    yargs.options({
+        name: {
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.name.describe`),
+            type: 'string',
+        },
+        dest: {
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.dest.describe`),
+            type: 'string',
+        },
+        'app-id': {
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.appId.describe`),
+            type: 'number',
+        },
+        'platform-version': {
+            type: 'string',
+            choices: exports.validMigrationTargets,
+            hidden: true,
+            default: '2023.2',
+        },
+    });
+    yargs.example([
+        [
+            `$0 app migrate`,
+            (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.examples.default`),
+        ],
+    ]);
+    return yargs;
+}
+const migrateCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = migrateCommand;

package/commands/app.d.ts

@@ -0,0 +1,6 @@
+import { Argv, CommandModule } from 'yargs';
+export declare const command: string[];
+export declare const describe: undefined;
+export declare function builder(yargs: Argv): Argv<{}>;
+declare const appCommand: CommandModule;
+export default appCommand;

package/commands/app.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describe = exports.command = void 0;
+exports.builder = builder;
+const migrate_1 = __importDefault(require("./app/migrate"));
+const commonOpts_1 = require("../lib/commonOpts");
+exports.command = ['app', 'apps'];
+// Keep the command hidden for now
+exports.describe = undefined;
+function builder(yargs) {
+    (0, commonOpts_1.addGlobalOptions)(yargs);
+    return yargs.command(migrate_1.default).demandCommand(1, '');
+}
+const appCommand = {
+    command: exports.command,
+    describe: exports.describe,
+    builder,
+    handler: () => { },
+};
+exports.default = appCommand;

package/commands/project/cloneApp.d.ts

@@ -1 +1,9 @@
-export {};
+import { ArgumentsCamelCase, Argv, CommandModule } from 'yargs';
+import { CloneAppArgs } from '../../types/Yargs';
+export declare const command = "clone-app";
+export declare const describe: string | undefined;
+export declare const deprecated = true;
+export declare const handler: (options: ArgumentsCamelCase<CloneAppArgs>) => Promise<never>;
+export declare const builder: (yargs: Argv) => Argv<CloneAppArgs>;
+declare const cloneAppCommand: CommandModule<unknown, CloneAppArgs>;
+export default cloneAppCommand;

package/commands/project/cloneApp.js

@@ -1,43 +1,46 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-// @ts-nocheck
-const path = require('path');
-const fs = require('fs');
-const { addAccountOptions, addConfigOptions, addUseEnvironmentOptions, } = require('../../lib/commonOpts');
-const { trackCommandUsage, trackCommandMetadataUsage, } = require('../../lib/usageTracking');
-const { i18n } = require('../../lib/lang');
-const { selectPublicAppPrompt, } = require('../../lib/prompts/selectPublicAppPrompt');
-const { createProjectPrompt, } = require('../../lib/prompts/createProjectPrompt');
-const { poll } = require('../../lib/polling');
-const { uiBetaTag, uiLine, 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 { isAppDeveloperAccount } = require('../../lib/accountTypes');
-const { writeProjectConfig } = require('../../lib/projects');
-const { PROJECT_CONFIG_FILE } = require('../../lib/constants');
-const { cloneApp, checkCloneStatus, downloadClonedProject, } = 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 { extractZipArchive } = require('@hubspot/local-dev-lib/archive');
+exports.builder = exports.handler = exports.deprecated = exports.describe = exports.command = void 0;
+const ui_1 = require("../../lib/ui");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const commonOpts_1 = require("../../lib/commonOpts");
+const usageTracking_1 = require("../../lib/usageTracking");
+const lang_1 = require("../../lib/lang");
+const selectPublicAppPrompt_1 = require("../../lib/prompts/selectPublicAppPrompt");
+const createProjectPrompt_1 = require("../../lib/prompts/createProjectPrompt");
+const polling_1 = require("../../lib/polling");
+const ui_2 = require("../../lib/ui");
+const errorHandlers_1 = require("../../lib/errorHandlers");
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const accountTypes_1 = require("../../lib/accountTypes");
+const projects_1 = require("../../lib/projects");
+const constants_1 = require("../../lib/constants");
+const projects_2 = require("@hubspot/local-dev-lib/api/projects");
+const path_2 = require("@hubspot/local-dev-lib/path");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const archive_1 = require("@hubspot/local-dev-lib/archive");
+const config_1 = require("@hubspot/local-dev-lib/config");
+const SpinniesManager_1 = __importDefault(require("../../lib/ui/SpinniesManager"));
+const migrate_1 = require("../../lib/app/migrate");
 const i18nKey = 'commands.project.subcommands.cloneApp';
 exports.command = 'clone-app';
-exports.describe = uiBetaTag(i18n(`${i18nKey}.describe`), false);
-exports.handler = async (options) => {
+exports.describe = (0, ui_1.uiDeprecatedTag)((0, lang_1.i18n)(`${i18nKey}.describe`), false);
+exports.deprecated = true;
+const handler = async (options) => {
     const { derivedAccountId } = options;
-    const accountConfig = getAccountConfig(derivedAccountId);
-    const accountName = uiAccountDescription(derivedAccountId);
-    trackCommandUsage('clone-app', {}, derivedAccountId);
-    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);
+    await (0, usageTracking_1.trackCommandUsage)('clone-app', {}, derivedAccountId);
+    const accountConfig = (0, config_1.getAccountConfig)(derivedAccountId);
+    const accountName = (0, ui_2.uiAccountDescription)(derivedAccountId);
+    if (!accountConfig) {
+        throw new Error((0, lang_1.i18n)(`commands.projects.subcommands.cloneApp.errors.noAccountConfig`));
+    }
+    if (!(0, accountTypes_1.isAppDeveloperAccount)(accountConfig)) {
+        (0, migrate_1.logInvalidAccountError)(i18nKey);
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
     }
     let appId;
     let projectName;
@@ -45,96 +48,108 @@ exports.handler = async (options) => {
     try {
         appId = options.appId;
         if (!appId) {
-            const appIdResponse = await selectPublicAppPrompt({
+            const appIdResponse = await (0, selectPublicAppPrompt_1.selectPublicAppPrompt)({
                 accountId: derivedAccountId,
                 accountName,
-                options,
                 isMigratingApp: false,
             });
             appId = appIdResponse.appId;
         }
-        const createProjectPromptResponse = await createProjectPrompt(options);
+        const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(options);
         projectName = createProjectPromptResponse.name;
         projectDest = createProjectPromptResponse.dest;
     }
     catch (error) {
-        logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
-        process.exit(EXIT_CODES.ERROR);
+        (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    await trackCommandMetadataUsage('clone-app', { status: 'STARTED' }, derivedAccountId);
+    await (0, usageTracking_1.trackCommandMetadataUsage)('clone-app', { step: 'STARTED' }, derivedAccountId);
     try {
-        SpinniesManager.init();
-        SpinniesManager.add('cloneApp', {
-            text: i18n(`${i18nKey}.cloneStatus.inProgress`),
+        SpinniesManager_1.default.init();
+        SpinniesManager_1.default.add('cloneApp', {
+            text: (0, lang_1.i18n)(`${i18nKey}.cloneStatus.inProgress`),
         });
-        const { data: { exportId }, } = await cloneApp(derivedAccountId, appId);
-        const { status } = await poll(() => checkCloneStatus(derivedAccountId, exportId));
+        const { data: { exportId }, } = await (0, projects_2.cloneApp)(derivedAccountId, appId);
+        const { status } = await (0, polling_1.poll)(() => (0, projects_2.checkCloneStatus)(derivedAccountId, exportId));
         if (status === 'SUCCESS') {
             // Ensure correct project folder structure exists
-            const baseDestPath = path.resolve(getCwd(), projectDest);
-            const absoluteDestPath = path.resolve(baseDestPath, 'src', 'app');
-            fs.mkdirSync(absoluteDestPath, { recursive: true });
+            const baseDestPath = path_1.default.resolve((0, path_2.getCwd)(), projectDest);
+            const absoluteDestPath = path_1.default.resolve(baseDestPath, 'src', 'app');
+            fs_1.default.mkdirSync(absoluteDestPath, { recursive: true });
             // Extract zipped app files and place them in correct directory
-            const { data: zippedApp } = await downloadClonedProject(derivedAccountId, exportId);
-            await extractZipArchive(zippedApp, sanitizeFileName(projectName), absoluteDestPath, {
+            const { data: zippedApp } = await (0, projects_2.downloadClonedProject)(derivedAccountId, exportId);
+            await (0, archive_1.extractZipArchive)(zippedApp, (0, path_2.sanitizeFileName)(projectName), absoluteDestPath, {
                 includesRootDir: true,
                 hideLogs: true,
             });
             // Create hsproject.json file
-            const configPath = path.join(baseDestPath, PROJECT_CONFIG_FILE);
+            const configPath = path_1.default.join(baseDestPath, constants_1.PROJECT_CONFIG_FILE);
             const configContent = {
                 name: projectName,
                 srcDir: 'src',
                 platformVersion: '2023.2',
             };
-            const success = writeProjectConfig(configPath, configContent);
-            SpinniesManager.succeed('cloneApp', {
-                text: i18n(`${i18nKey}.cloneStatus.done`),
+            const success = (0, projects_1.writeProjectConfig)(configPath, configContent);
+            SpinniesManager_1.default.succeed('cloneApp', {
+                text: (0, lang_1.i18n)(`${i18nKey}.cloneStatus.done`),
                 succeedColor: 'white',
             });
             if (!success) {
-                logger.error(i18n(`${i18nKey}.errors.couldNotWriteConfigPath`), configPath);
+                logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.errors.couldNotWriteConfigPath`), configPath);
             }
-            logger.log('');
-            uiLine();
-            logger.success(i18n(`${i18nKey}.cloneStatus.success`, { dest }));
-            logger.log('');
-            process.exit(EXIT_CODES.SUCCESS);
+            logger_1.logger.log('');
+            (0, ui_2.uiLine)();
+            logger_1.logger.success((0, lang_1.i18n)(`${i18nKey}.cloneStatus.success`, { dest: projectDest }));
+            logger_1.logger.log('');
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
         }
     }
     catch (error) {
-        await trackCommandMetadataUsage('clone-app', { status: 'FAILURE' }, derivedAccountId);
-        SpinniesManager.fail('cloneApp', {
-            text: i18n(`${i18nKey}.cloneStatus.failure`),
+        await (0, usageTracking_1.trackCommandMetadataUsage)('clone-app', { successful: false }, derivedAccountId);
+        SpinniesManager_1.default.fail('cloneApp', {
+            text: (0, lang_1.i18n)(`${i18nKey}.cloneStatus.failure`),
             failColor: 'white',
         });
         // Migrations endpoints return a response object with an errors property. The errors property contains an array of errors.
-        if (error.errors && Array.isArray(error.errors)) {
-            error.errors.forEach(e => logError(e, new ApiErrorContext({ accountId: derivedAccountId })));
+        if (error &&
+            typeof error === 'object' &&
+            'errors' in error &&
+            Array.isArray(error.errors)) {
+            error.errors.forEach(e => (0, errorHandlers_1.logError)(e, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId })));
         }
         else {
-            logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
+            (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
         }
     }
-    await trackCommandMetadataUsage('clone-app', { status: 'SUCCESS' }, derivedAccountId);
-    process.exit(EXIT_CODES.SUCCESS);
+    await (0, usageTracking_1.trackCommandMetadataUsage)('clone-app', { successful: true }, derivedAccountId);
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
 };
-exports.builder = yargs => {
+exports.handler = handler;
+const builder = (yargs) => {
     yargs.options({
         dest: {
-            describe: i18n(`${i18nKey}.options.dest.describe`),
+            describe: (0, lang_1.i18n)(`${i18nKey}.options.dest.describe`),
             type: 'string',
         },
         'app-id': {
-            describe: i18n(`${i18nKey}.options.appId.describe`),
+            describe: (0, lang_1.i18n)(`${i18nKey}.options.appId.describe`),
             type: 'number',
         },
     });
     yargs.example([
-        ['$0 project clone-app', i18n(`${i18nKey}.examples.default`)],
+        ['$0 project clone-app', (0, lang_1.i18n)(`${i18nKey}.examples.default`)],
     ]);
-    addConfigOptions(yargs);
-    addAccountOptions(yargs);
-    addUseEnvironmentOptions(yargs);
+    (0, commonOpts_1.addConfigOptions)(yargs);
+    (0, commonOpts_1.addAccountOptions)(yargs);
+    (0, commonOpts_1.addUseEnvironmentOptions)(yargs);
     return yargs;
 };
+exports.builder = builder;
+const cloneAppCommand = {
+    command: exports.command,
+    describe: exports.describe,
+    handler: exports.handler,
+    builder: exports.builder,
+    deprecated: exports.deprecated,
+};
+exports.default = cloneAppCommand;

package/commands/project/migrateApp.d.ts

@@ -1 +1,9 @@
-export {};
+import { ArgumentsCamelCase, Argv, CommandModule } from 'yargs';
+import { MigrateAppOptions } from '../../types/Yargs';
+export declare const command = "migrate-app";
+export declare const describe: string | undefined;
+export declare const deprecated = true;
+export declare function handler(yargs: ArgumentsCamelCase<MigrateAppOptions>): Promise<void>;
+export declare function builder(yargs: Argv): Argv<MigrateAppOptions>;
+declare const migrateAppCommand: CommandModule<unknown, MigrateAppOptions>;
+export default migrateAppCommand;

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/lang/en.lyaml

@@ -570,6 +570,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 +586,41 @@ 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:
+            noApps: "No apps found in account {{ accountId }}"
+            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 }} "
+          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"
+            migrationStarted: "Migration started"
+            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 +639,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:

package/lib/app/migrate.d.ts

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

package/lib/app/migrate.js

@@ -0,0 +1,345 @@
+"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;
+exports.migrateApp2023_2 = migrateApp2023_2;
+const promptUtils_1 = require("../prompts/promptUtils");
+const errorHandlers_1 = require("../errorHandlers");
+const exitCodes_1 = require("../enums/exitCodes");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const ui_1 = require("../ui");
+const lang_1 = require("../lang");
+const accountTypes_1 = require("../accountTypes");
+const selectPublicAppPrompt_1 = require("../prompts/selectPublicAppPrompt");
+const appsDev_1 = require("@hubspot/local-dev-lib/api/appsDev");
+const createProjectPrompt_1 = require("../prompts/createProjectPrompt");
+const projects_1 = require("../projects");
+const usageTracking_1 = require("../usageTracking");
+const SpinniesManager_1 = __importDefault(require("../ui/SpinniesManager"));
+const process_1 = require("../process");
+const projects_2 = require("@hubspot/local-dev-lib/api/projects");
+const polling_1 = require("../polling");
+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 chalk_1 = __importDefault(require("chalk"));
+const project_parsing_lib_1 = require("@hubspot/project-parsing-lib");
+const projects_3 = require("@hubspot/local-dev-lib/constants/projects");
+const transform_1 = require("@hubspot/project-parsing-lib/src/lib/transform");
+function getUnmigratableReason(reasonCode) {
+    switch (reasonCode) {
+        case projects_3.UNMIGRATABLE_REASONS.UP_TO_DATE:
+            return (0, lang_1.i18n)('commands.project.subcommands.migrateApp.unmigratableReasons.upToDate');
+        case projects_3.UNMIGRATABLE_REASONS.IS_A_PRIVATE_APP:
+            return (0, lang_1.i18n)('commands.project.subcommands.migrateApp.unmigratableReasons.isPrivateApp');
+        case projects_3.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 } = await (0, projects_2.listAppsForMigration)(derivedAccountId);
+    const { migratableApps, unmigratableApps } = data;
+    const allApps = [...migratableApps, ...unmigratableApps].filter(app => !app.projectName);
+    if (allApps.length === 0) {
+        throw new Error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.noApps`, {
+            accountId: derivedAccountId,
+        }));
+    }
+    if (migratableApps.length === 0) {
+        const reasons = unmigratableApps.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: derivedAccountId,
+        })} \n  - ${reasons.join('\n  - ')}`);
+    }
+    if (appId &&
+        !allApps.some(app => {
+            return app.appId === appId;
+        })) {
+        throw new Error((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.chooseApp', {
+            appId,
+        }));
+    }
+    const appChoices = allApps.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 = allApps.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_1.ensureProjectExists)(derivedAccountId, projectName, { forceCreate: false, 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, projects_2.initializeMigration)(derivedAccountId, appId, platformVersion);
+    const { migrationId } = data;
+    const pollResponse = await pollMigrationStatus(derivedAccountId, migrationId, ['INPUT_REQUIRED']);
+    if (pollResponse.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.succeed('beginningMigration', {
+        text: (0, lang_1.i18n)('commands.project.subcommands.migrateApp.spinners.migrationStarted'),
+    });
+    if (Object.values(componentsRequiringUids).length !== 0) {
+        for (const [componentId, component] of Object.entries(componentsRequiringUids)) {
+            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)((0, lang_1.i18n)('commands.project.subcommands.migrateApp.prompt.uidForComponent', {
+                componentName: component.componentHint || component.componentType,
+            }), {
+                validate: (uid) => {
+                    const result = (0, project_parsing_lib_1.validateUid)(uid);
+                    return result === undefined ? true : result;
+                },
+            });
+        }
+    }
+    return { migrationId, uidMap };
+}
+async function pollMigrationStatus(derivedAccountId, migrationId, successStates = []) {
+    return (0, polling_1.poll)(() => (0, projects_2.checkMigrationStatusV2)(derivedAccountId, migrationId), {
+        successStates: [...successStates],
+        errorStates: [...polling_1.DEFAULT_POLLING_STATUS_LOOKUP.errorStates],
+    });
+}
+async function finalizeMigration(derivedAccountId, migrationId, uidMap, projectName) {
+    let buildId;
+    try {
+        SpinniesManager_1.default.add('finishingMigration', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.finishingMigration`),
+        });
+        await (0, projects_2.continueMigration)(derivedAccountId, migrationId, uidMap, projectName);
+        const pollResponse = await pollMigrationStatus(derivedAccountId, migrationId, ['SUCCESS']);
+        if (pollResponse.status === 'SUCCESS') {
+            buildId = pollResponse.buildId;
+            SpinniesManager_1.default.succeed('finishingMigration', {
+                text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.migrationComplete`),
+            });
+        }
+        else {
+            SpinniesManager_1.default.fail('finishingMigration', {
+                text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.migrationFailed`),
+            });
+        }
+        return buildId;
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('finishingMigration', {
+            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.spinners.migrationFailed`),
+        });
+        throw error;
+    }
+}
+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: false,
+        });
+        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);
+    if (!buildId) {
+        throw new Error('Migration Failed');
+    }
+    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)();
+}
+async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
+    const i18nKey = 'commands.project.subcommands.migrateApp';
+    const accountName = (0, ui_1.uiAccountDescription)(derivedAccountId);
+    if (!(0, accountTypes_1.isAppDeveloperAccount)(accountConfig)) {
+        logInvalidAccountError(i18nKey);
+        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)(`${i18nKey}.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_1.ensureProjectExists)(derivedAccountId, projectName, {
+        allowCreate: false,
+        noLogs: true,
+    });
+    if (projectExists) {
+        throw new Error((0, lang_1.i18n)(`${i18nKey}.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)(`${i18nKey}.warning.title`)}\n`);
+    logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.warning.projectConversion`));
+    logger_1.logger.log(`${(0, lang_1.i18n)(`${i18nKey}.warning.appConfig`)}\n`);
+    logger_1.logger.log(`${(0, lang_1.i18n)(`${i18nKey}.warning.buildAndDeploy`)}\n`);
+    logger_1.logger.log(`${(0, lang_1.i18n)(`${i18nKey}.warning.existingApps`)}\n`);
+    logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.warning.copyApp`));
+    (0, ui_1.uiLine)();
+    const { shouldCreateApp } = await (0, promptUtils_1.promptUser)({
+        name: 'shouldCreateApp',
+        type: 'confirm',
+        message: (0, lang_1.i18n)(`${i18nKey}.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)(`${i18nKey}.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)(`${i18nKey}.migrationInterrupted`));
+                process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+            }
+        });
+        const { data: migrateResponse } = await (0, projects_2.migrateApp)(derivedAccountId, appId, projectName);
+        const { id } = migrateResponse;
+        const pollResponse = await (0, polling_1.poll)(() => (0, projects_2.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_2.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)(`${i18nKey}.migrationStatus.done`),
+                succeedColor: 'white',
+            });
+            logger_1.logger.log('');
+            (0, ui_1.uiLine)();
+            logger_1.logger.success((0, lang_1.i18n)(`${i18nKey}.migrationStatus.success`));
+            logger_1.logger.log('');
+            logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`${i18nKey}.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)(`${i18nKey}.migrationStatus.failure`),
+            failColor: 'white',
+        });
+        throw error;
+    }
+}

package/lib/polling.d.ts

@@ -6,6 +6,10 @@ export declare const DEFAULT_POLLING_STATES: {
     readonly REVERTED: "REVERTED";
     readonly FAILURE: "FAILURE";
 };
+export declare const DEFAULT_POLLING_STATUS_LOOKUP: {
+    successStates: "SUCCESS"[];
+    errorStates: ("FAILURE" | "ERROR" | "REVERTED")[];
+};
 type GenericPollingResponse = {
     status: string;
 };

package/lib/polling.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_POLLING_STATES = void 0;
+exports.DEFAULT_POLLING_STATUS_LOOKUP = exports.DEFAULT_POLLING_STATES = void 0;
 exports.poll = poll;
 const constants_1 = require("./constants");
 exports.DEFAULT_POLLING_STATES = {
@@ -10,7 +10,7 @@ exports.DEFAULT_POLLING_STATES = {
     REVERTED: 'REVERTED',
     FAILURE: 'FAILURE',
 };
-const DEFAULT_POLLING_STATUS_LOOKUP = {
+exports.DEFAULT_POLLING_STATUS_LOOKUP = {
     successStates: [exports.DEFAULT_POLLING_STATES.SUCCESS],
     errorStates: [
         exports.DEFAULT_POLLING_STATES.ERROR,
@@ -18,7 +18,7 @@ const DEFAULT_POLLING_STATUS_LOOKUP = {
         exports.DEFAULT_POLLING_STATES.FAILURE,
     ],
 };
-function poll(callback, statusLookup = DEFAULT_POLLING_STATUS_LOOKUP) {
+function poll(callback, statusLookup = exports.DEFAULT_POLLING_STATUS_LOOKUP) {
     return new Promise((resolve, reject) => {
         const pollInterval = setInterval(async () => {
             try {

package/lib/prompts/promptUtils.d.ts

@@ -4,10 +4,12 @@ export declare function confirmPrompt(message: string, options?: {
     defaultAnswer?: boolean;
     when?: PromptWhen;
 }): Promise<boolean>;
-export declare function listPrompt(message: string, { choices, when, }: {
-    choices: PromptChoices;
+export declare function listPrompt<T = string>(message: string, { choices, when, }: {
+    choices: PromptChoices<T>;
     when?: PromptWhen;
-}): Promise<string>;
-export declare function inputPrompt(message: string, { when, }?: {
+}): Promise<T>;
+export declare function inputPrompt(message: string, { when, validate, defaultAnswer, }?: {
     when?: boolean | (() => boolean);
+    validate?: (input: string) => boolean | string;
+    defaultAnswer?: string;
 }): Promise<string>;

package/lib/prompts/promptUtils.js

@@ -34,13 +34,15 @@ async function listPrompt(message, { choices, when, }) {
     ]);
     return choice;
 }
-async function inputPrompt(message, { when, } = {}) {
+async function inputPrompt(message, { when, validate, defaultAnswer, } = {}) {
     const { input } = await promptUser([
         {
             name: 'input',
             type: 'input',
+            default: defaultAnswer,
             message,
             when,
+            validate,
         },
     ]);
     return input;

package/lib/ui/index.d.ts

@@ -11,7 +11,7 @@ export declare function uiCommandReference(command: string, withQuotes?: boolean
 export declare function uiFeatureHighlight(features: string[], title?: string): void;
 export declare function uiBetaTag(message: string, log?: true): undefined;
 export declare function uiBetaTag(message: string, log: false): string;
-export declare function uiDeprecatedTag(message: string): void;
+export declare function uiDeprecatedTag(message: string, log?: boolean): string | undefined;
 export declare function uiCommandDisabledBanner(command: string, url?: string, message?: string): void;
-export declare function uiDeprecatedDescription(message: string, command: string, url?: string): void;
+export declare function uiDeprecatedDescription(message: string, command: string, url?: string): string | undefined;
 export declare function uiDeprecatedMessage(command: string, url?: string, message?: string): void;

package/lib/ui/index.js

@@ -102,16 +102,17 @@ function uiBetaTag(message, log = true) {
         logger_1.logger.log(result);
         return;
     }
-    else {
-        return result;
-    }
+    return result;
 }
-function uiDeprecatedTag(message) {
+function uiDeprecatedTag(message, log = true) {
     const i18nKey = 'lib.ui';
     const terminalUISupport = getTerminalUISupport();
     const tag = (0, lang_1.i18n)(`${i18nKey}.deprecatedTag`);
     const result = `${terminalUISupport.color ? chalk_1.default.yellow(tag) : tag} ${message}`;
-    logger_1.logger.log(result);
+    if (log) {
+        logger_1.logger.log(result);
+    }
+    return result;
 }
 function uiCommandDisabledBanner(command, url, message) {
     const i18nKey = 'lib.ui';

package/package.json

@@ -1,11 +1,11 @@
 {
     "name": "@hubspot/cli",
-    "version": "7.3.0",
+    "version": "7.4.1-experimental.0",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",
     "dependencies": {
-        "@hubspot/local-dev-lib": "3.4.1",
+        "@hubspot/local-dev-lib": "0.3.0-experimental.0",
         "@hubspot/project-parsing-lib": "0.1.5",
         "@hubspot/serverless-dev-runtime": "7.0.2",
         "@hubspot/theme-preview-dev-server": "0.0.10",

package/types/Prompts.d.ts

@@ -3,9 +3,9 @@ export type GenericPromptResponse = {
     [key: string]: any;
 };
 type PromptType = 'confirm' | 'list' | 'checkbox' | 'input' | 'password' | 'number' | 'rawlist';
-export type PromptChoices = Array<string | {
+export type PromptChoices<T = any> = Array<string | {
     name: string;
-    value?: any;
+    value?: T;
     disabled?: string | boolean;
 }>;
 export type PromptWhen = boolean | (() => boolean);

package/types/Yargs.d.ts

@@ -27,3 +27,13 @@ export type ProjectDevArgs = CommonArgs & ConfigArgs & EnvironmentArgs;
 export type TestingArgs = {
     qa?: boolean;
 };
+export type MigrateAppOptions = CommonArgs & AccountArgs & EnvironmentArgs & ConfigArgs & {
+    name: string;
+    dest: string;
+    appId: number;
+    platformVersion: string;
+};
+export type CloneAppArgs = ConfigArgs & EnvironmentArgs & AccountArgs & CommonArgs & {
+    dest: string;
+    appId: number;
+};