@hubspot/cli 7.7.35-experimental.0 → 7.8.0-beta.1

package/commands/project/dev/unifiedFlow.js

@@ -1,6 +1,7 @@
 import path from 'path';
 import util from 'util';
 import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
+import { startPortManagerServer, stopPortManagerServer, } from '@hubspot/local-dev-lib/portManager';
 import { isTranslationError } from '@hubspot/project-parsing-lib/src/lib/errors.js';
 import { translateForLocalDev } from '@hubspot/project-parsing-lib';
 import { getEnv, getConfigAccounts, getAccountConfig, } from '@hubspot/local-dev-lib/config';
@@ -8,8 +9,8 @@ import { getValidEnv } from '@hubspot/local-dev-lib/environment';
 import { logError } from '../../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { ensureProjectExists } from '../../../lib/projects/ensureProjectExists.js';
-import { createInitialBuildForNewProject, createNewProjectForLocalDev, compareLocalProjectToDeployed, } from '../../../lib/projects/localDev/helpers/project.js';
-import { useExistingDevTestAccount, createDeveloperTestAccountForLocalDev, selectAccountTypePrompt, } from '../../../lib/projects/localDev/helpers/account.js';
+import { createInitialBuildForNewProject, createNewProjectForLocalDev, compareLocalProjectToDeployed, checkAndInstallDependencies, } from '../../../lib/projects/localDev/helpers/project.js';
+import { useExistingDevTestAccount, createDeveloperTestAccountForLocalDev, selectAccountTypePrompt, createSandboxForLocalDev, } from '../../../lib/projects/localDev/helpers/account.js';
 import { selectDeveloperTestTargetAccountPrompt, selectSandboxTargetAccountPrompt, } from '../../../lib/prompts/projectDevTargetAccountPrompt.js';
 import SpinniesManager from '../../../lib/ui/SpinniesManager.js';
 import LocalDevProcess from '../../../lib/projects/localDev/LocalDevProcess.js';
@@ -93,6 +94,9 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
             const sandboxAccountPromptResponse = await selectSandboxTargetAccountPrompt(accounts, targetProjectAccountConfig);
             targetTestingAccountId =
                 sandboxAccountPromptResponse.targetAccountId || undefined;
+            if (sandboxAccountPromptResponse.createNestedAccount) {
+                targetTestingAccountId = await createSandboxForLocalDev(targetProjectAccountId, targetProjectAccountConfig, env);
+            }
         }
         else {
             targetTestingAccountId = targetProjectAccountId;
@@ -115,7 +119,10 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
         project = await createNewProjectForLocalDev(projectConfig, targetProjectAccountId, false, false);
         await createInitialBuildForNewProject(projectConfig, projectDir, targetProjectAccountId, true, args.profile);
     }
+    // Check for missing/outdated dependencies
+    await checkAndInstallDependencies();
     // End setup, start local dev process
+    await startPortManagerServer();
     const localDevProcess = new LocalDevProcess({
         initialProjectNodes: projectNodes,
         initialProjectProfileData: projectProfileData,
@@ -125,15 +132,14 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
         targetTestingAccountId: targetTestingAccountId,
         projectConfig,
         projectDir,
-        projectName: project.name,
-        projectId: project.id,
+        projectData: project,
         env,
     });
-    await localDevProcess.start();
-    const watcher = new LocalDevWatcher(localDevProcess);
-    watcher.start();
     const websocketServer = new LocalDevWebsocketServer(localDevProcess, args.debug);
+    const watcher = new LocalDevWatcher(localDevProcess);
     await websocketServer.start();
+    await localDevProcess.start();
+    watcher.start();
     handleKeypress(async (key) => {
         if ((key.ctrl && key.name === 'c') || key.name === 'q') {
             await Promise.all([
@@ -147,5 +153,6 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
         localDevProcess.stop(!isSIGHUP);
         watcher.stop();
         websocketServer.shutdown();
+        stopPortManagerServer();
     });
 }

package/commands/project/download.js

@@ -1,22 +1,21 @@
 import path from 'path';
 import { getCwd, sanitizeFileName } from '@hubspot/local-dev-lib/path';
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { extractZipArchive } from '@hubspot/local-dev-lib/archive';
 import { downloadProject, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
 import { downloadProjectPrompt } from '../../lib/prompts/downloadProjectPrompt.js';
-import { i18n } from '../../lib/lang.js';
-import { uiBetaTag } from '../../lib/ui/index.js';
+import { commands } from '../../lang/en.js';
+import { uiLogger } from '../../lib/ui/logger.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'download';
-const describe = uiBetaTag(i18n(`commands.project.subcommands.download.describe`), false);
+const describe = commands.project.download.describe;
 async function handler(args) {
     const { projectConfig } = await getProjectConfig();
     if (projectConfig) {
-        logger.error(i18n(`commands.project.subcommands.download.warnings.cannotDownloadWithinProject`));
+        uiLogger.error(commands.project.download.warnings.cannotDownloadWithinProject);
         process.exit(EXIT_CODES.ERROR);
     }
     const { dest, build, derivedAccountId } = args;
@@ -33,16 +32,16 @@ async function handler(args) {
             }
         }
         if (!buildNumberToDownload) {
-            logger.error(i18n(`commands.project.subcommands.download.errors.noBuildIdToDownload`));
+            uiLogger.error(commands.project.download.errors.noBuildIdToDownload);
             process.exit(EXIT_CODES.ERROR);
         }
-        const absoluteDestPath = dest ? path.resolve(getCwd(), dest) : getCwd();
+        const sanitizedProjectName = sanitizeFileName(projectName);
+        const absoluteDestPath = dest
+            ? path.resolve(getCwd(), dest, sanitizedProjectName)
+            : path.resolve(getCwd(), sanitizedProjectName);
         const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, buildNumberToDownload);
-        await extractZipArchive(zippedProject, sanitizeFileName(projectName), path.resolve(absoluteDestPath), { includesRootDir: false });
-        logger.log(i18n(`commands.project.subcommands.download.logs.downloadSucceeded`, {
-            buildId: buildNumberToDownload,
-            projectName,
-        }));
+        await extractZipArchive(zippedProject, sanitizeFileName(projectName), path.resolve(absoluteDestPath));
+        uiLogger.log(commands.project.download.logs.downloadSucceeded(buildNumberToDownload, projectName));
         process.exit(EXIT_CODES.SUCCESS);
     }
     catch (e) {
@@ -56,15 +55,15 @@ async function handler(args) {
 function projectDownloadBuilder(yargs) {
     yargs.options({
         project: {
-            describe: i18n(`commands.project.subcommands.download.options.project.describe`),
+            describe: commands.project.download.options.project.describe,
             type: 'string',
         },
         dest: {
-            describe: i18n(`commands.project.subcommands.download.options.dest.describe`),
+            describe: commands.project.download.options.dest.describe,
             type: 'string',
         },
         build: {
-            describe: i18n(`commands.project.subcommands.download.options.build.describe`),
+            describe: commands.project.download.options.build.describe,
             alias: ['build-id'],
             type: 'number',
         },
@@ -72,7 +71,7 @@ function projectDownloadBuilder(yargs) {
     yargs.example([
         [
             '$0 project download --project=myProject --dest=myProjectFolder',
-            i18n(`commands.project.subcommands.download.examples.default`),
+            commands.project.download.examples.default,
         ],
     ]);
     return yargs;

package/commands/project/installDeps.d.ts

@@ -1,5 +1,5 @@
-import { CommonArgs, YargsCommandModule } from '../../types/Yargs.js';
-export type ProjectInstallDepsArgs = CommonArgs & {
+import { CommonArgs, ConfigArgs, YargsCommandModule } from '../../types/Yargs.js';
+export type ProjectInstallDepsArgs = CommonArgs & ConfigArgs & {
     packages?: string[];
 };
 declare const projectInstallDepsCommand: YargsCommandModule<unknown, ProjectInstallDepsArgs>;

package/commands/project/installDeps.js

@@ -1,23 +1,22 @@
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { installPackages, getProjectPackageJsonLocations, } from '../../lib/dependencyManagement.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import path from 'path';
-import { i18n } from '../../lib/lang.js';
+import { commands } from '../../lang/en.js';
+import { uiLogger } from '../../lib/ui/logger.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
-import { uiBetaTag } from '../../lib/ui/index.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'install-deps [packages..]';
-const describe = uiBetaTag(i18n(`commands.project.subcommands.installDeps.help.describe`), false);
+const describe = commands.project.installDeps.help.describe;
 async function handler(args) {
     const { derivedAccountId, packages } = args;
     try {
         trackCommandUsage('project-install-deps', undefined, derivedAccountId);
         const projectConfig = await getProjectConfig();
         if (!projectConfig || !projectConfig.projectDir) {
-            logger.error(i18n(`commands.project.subcommands.installDeps.noProjectConfig`));
+            uiLogger.error(commands.project.installDeps.noProjectConfig);
             return process.exit(EXIT_CODES.ERROR);
         }
         const { projectDir } = projectConfig;
@@ -28,14 +27,14 @@ async function handler(args) {
                     name: 'selectedInstallLocations',
                     type: 'checkbox',
                     when: () => packages && packages.length > 0,
-                    message: i18n(`commands.project.subcommands.installDeps.installLocationPrompt`),
+                    message: commands.project.installDeps.installLocationPrompt,
                     choices: installLocations.map(dir => ({
                         name: path.relative(projectDir, dir),
                         value: dir,
                     })),
                     validate: (choices) => {
                         if (choices === undefined || choices.length === 0) {
-                            return i18n(`commands.project.subcommands.installDeps.installLocationPromptRequired`);
+                            return commands.project.installDeps.installLocationPromptRequired;
                         }
                         return true;
                     },
@@ -59,17 +58,18 @@ function projectInstallDepsBuilder(yargs) {
     yargs.example([
         [
             '$0 project install-deps',
-            i18n(`commands.project.subcommands.installDeps.help.installAppDepsExample`),
+            commands.project.installDeps.help.installAppDepsExample,
         ],
         [
             '$0 project install-deps dependency1 dependency2',
-            i18n(`commands.project.subcommands.installDeps.help.addDepToSubComponentExample`),
+            commands.project.installDeps.help.addDepToSubComponentExample,
         ],
     ]);
     return yargs;
 }
 const builder = makeYargsBuilder(projectInstallDepsBuilder, command, describe, {
     useGlobalOptions: true,
+    useConfigOptions: true,
 });
 const projectInstallDepsCommand = {
     command,

package/commands/project/list.d.ts

@@ -0,0 +1,4 @@
+import { AccountArgs, CommonArgs, ConfigArgs, YargsCommandModule } from '../../types/Yargs.js';
+type ProjectListArgs = CommonArgs & ConfigArgs & AccountArgs;
+declare const projectListCommand: YargsCommandModule<unknown, ProjectListArgs>;
+export default projectListCommand;

package/commands/project/list.js

@@ -0,0 +1,62 @@
+import { trackCommandUsage } from '../../lib/usageTracking.js';
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { fetchProjects } from '@hubspot/local-dev-lib/api/projects';
+import { logError } from '../../lib/errorHandlers/index.js';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { getTableContents, getTableHeader } from '../../lib/ui/table.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { commands } from '../../lang/en.js';
+const command = ['list', 'ls'];
+const describe = commands.project.list.describe;
+async function getProjectData(accountId) {
+    try {
+        const { data: projects } = await fetchProjects(accountId);
+        return projects.results;
+    }
+    catch (e) {
+        logError(e);
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+function formatProjectsAsTableRows(projects) {
+    const projectListData = [];
+    projects.forEach(project => {
+        projectListData.push([
+            project.name,
+            project.latestBuild ? project.latestBuild.platformVersion : '',
+        ]);
+    });
+    return projectListData;
+}
+async function handler(args) {
+    const { derivedAccountId } = args;
+    trackCommandUsage('projects-list', undefined, derivedAccountId);
+    const projectData = await getProjectData(derivedAccountId);
+    if (projectData.length === 0) {
+        uiLogger.error(commands.project.list.errors.noProjectsFound(derivedAccountId));
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const projectListData = formatProjectsAsTableRows(projectData);
+    projectListData.unshift(getTableHeader([
+        commands.project.list.labels.name,
+        commands.project.list.labels.platformVersion,
+    ]));
+    uiLogger.log(commands.project.list.projects);
+    uiLogger.log(getTableContents(projectListData, { border: { bodyLeft: '  ' } }));
+}
+function projectListBuilder(yargs) {
+    yargs.example([['$0 project list']]);
+    return yargs;
+}
+const builder = makeYargsBuilder(projectListBuilder, command, describe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+});
+const projectListCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+export default projectListCommand;

package/commands/project/listBuilds.js

@@ -1,34 +1,30 @@
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { fetchProject, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { getTableContents, getTableHeader } from '../../lib/ui/table.js';
-import { uiBetaTag, uiLink } from '../../lib/ui/index.js';
+import { uiLink } from '../../lib/ui/index.js';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { getProjectDetailUrl } from '../../lib/projects/urls.js';
 import moment from 'moment';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
-import { i18n } from '../../lib/lang.js';
+import { uiLogger } from '../../lib/ui/logger.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 const command = 'list-builds';
-const describe = uiBetaTag(i18n(`commands.project.subcommands.listBuilds.describe`), false);
+const describe = commands.project.listBuilds.describe;
 async function fetchAndDisplayBuilds(accountId, project, options) {
     const { data: { results, paging }, } = await fetchProjectBuilds(accountId, project.name, options);
     const currentDeploy = project.deployedBuildId;
     if (options && options.after) {
-        logger.log(i18n(`commands.project.subcommands.listBuilds.logs.showingNextBuilds`, {
-            count: results.length,
-            projectName: project.name,
-        }));
+        uiLogger.log(commands.project.listBuilds.showingNextBuilds(results.length, project.name));
     }
     else {
-        logger.log(commands.project.listBuilds.showingRecentBuilds(results.length, project.name, uiLink(commands.project.listBuilds.viewAllBuildsLink, getProjectDetailUrl(project.name, accountId))));
+        uiLogger.log(commands.project.listBuilds.showingRecentBuilds(results.length, project.name, uiLink(commands.project.listBuilds.viewAllBuildsLink, getProjectDetailUrl(project.name, accountId))));
     }
     if (results.length === 0) {
-        logger.log(i18n(`commands.project.subcommands.listBuilds.errors.noBuilds`));
+        uiLogger.log(commands.project.listBuilds.errors.noBuilds);
     }
     else {
         const builds = results.map(build => {
@@ -49,7 +45,7 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
             ];
         });
         builds.unshift(getTableHeader(['Build ID', 'Status', 'Completed', 'Duration', 'Details']));
-        logger.log(getTableContents(builds, {
+        uiLogger.log(getTableContents(builds, {
             columnDefault: {
                 paddingLeft: 3,
             },
@@ -58,7 +54,7 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
     if (paging && paging.next) {
         await promptUser({
             name: 'more',
-            message: i18n(`commands.project.subcommands.listBuilds.continueOrExitPrompt`),
+            message: commands.project.listBuilds.continueOrExitPrompt,
         });
         await fetchAndDisplayBuilds(accountId, project, {
             limit: options.limit,
@@ -81,9 +77,7 @@ async function handler(args) {
     }
     catch (e) {
         if (isHubSpotHttpError(e) && e.status === 404) {
-            logger.error(i18n(`commands.project.subcommands.listBuilds.errors.projectNotFound`, {
-                projectName,
-            }));
+            uiLogger.error(commands.project.listBuilds.errors.projectNotFound(projectName));
         }
         else {
             logError(e, new ApiErrorContext({
@@ -97,19 +91,16 @@ async function handler(args) {
 function projectListBuildsBuilder(yargs) {
     yargs.options({
         project: {
-            describe: i18n(`commands.project.subcommands.listBuilds.options.project.describe`),
+            describe: commands.project.listBuilds.options.project.describe,
             type: 'string',
         },
         limit: {
-            describe: i18n(`commands.project.subcommands.listBuilds.options.limit.describe`),
+            describe: commands.project.listBuilds.options.limit.describe,
             type: 'string',
         },
     });
     yargs.example([
-        [
-            '$0 project list-builds',
-            i18n(`commands.project.subcommands.listBuilds.examples.default`),
-        ],
+        ['$0 project list-builds', commands.project.listBuilds.examples.default],
     ]);
     return yargs;
 }

package/commands/project/logs.js

@@ -1,13 +1,13 @@
 import { getEnv } from '@hubspot/local-dev-lib/config';
 import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
 import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
-import { logger } from '@hubspot/local-dev-lib/logger';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { getTableContents, getTableHeader } from '../../lib/ui/table.js';
 import { logError } from '../../lib/errorHandlers/index.js';
-import { uiBetaTag, uiLine, uiLink } from '../../lib/ui/index.js';
+import { uiLine } from '../../lib/ui/index.js';
 import { projectLogsPrompt } from '../../lib/prompts/projectsLogsPrompt.js';
-import { i18n } from '../../lib/lang.js';
+import { commands } from '../../lang/en.js';
+import { uiLogger } from '../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { ProjectLogsManager } from '../../lib/projects/ProjectLogsManager.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
@@ -16,34 +16,34 @@ function getPrivateAppsUrl(accountId) {
     return `${baseUrl}/private-apps/${accountId}`;
 }
 function logTable(tableHeader, logsInfo) {
-    logger.log(i18n(`commands.project.subcommands.logs.logs.showingLogs`));
-    logger.log(getTableContents([tableHeader, logsInfo], { border: { bodyLeft: '  ' } }));
+    uiLogger.log(commands.project.logs.logs.showingLogs);
+    uiLogger.log(getTableContents([tableHeader, logsInfo], { border: { bodyLeft: '  ' } }));
 }
 function logPreamble() {
     if (ProjectLogsManager.isPublicFunction) {
         logTable(getTableHeader([
-            i18n(`commands.project.subcommands.logs.table.accountHeader`),
-            i18n(`commands.project.subcommands.logs.table.functionHeader`),
-            i18n(`commands.project.subcommands.logs.table.endpointHeader`),
+            commands.project.logs.table.accountHeader,
+            commands.project.logs.table.functionHeader,
+            commands.project.logs.table.endpointHeader,
         ]), [
             ProjectLogsManager.accountId,
             ProjectLogsManager.functionName,
             ProjectLogsManager.endpointName,
         ]);
-        logger.log(uiLink(i18n(`commands.project.subcommands.logs.logs.hubspotLogsDirectLink`), `${getPrivateAppsUrl(ProjectLogsManager.accountId)}/${ProjectLogsManager.appId}/logs/serverlessGatewayExecution?path=${ProjectLogsManager.endpointName}`));
+        uiLogger.log(commands.project.logs.logs.hubspotLogsDirectLink(`${getPrivateAppsUrl(ProjectLogsManager.accountId)}/${ProjectLogsManager.appId}/logs/serverlessGatewayExecution?path=${ProjectLogsManager.endpointName}`));
     }
     else {
         logTable(getTableHeader([
-            i18n(`commands.project.subcommands.logs.table.accountHeader`),
-            i18n(`commands.project.subcommands.logs.table.functionHeader`),
+            commands.project.logs.table.accountHeader,
+            commands.project.logs.table.functionHeader,
         ]), [ProjectLogsManager.accountId, ProjectLogsManager.functionName]);
-        logger.log(uiLink(i18n(`commands.project.subcommands.logs.logs.hubspotLogsDirectLink`), `${getPrivateAppsUrl(ProjectLogsManager.accountId)}/${ProjectLogsManager.appId}/logs/crm?serverlessFunction=${ProjectLogsManager.functionName}`));
+        uiLogger.log(commands.project.logs.logs.hubspotLogsDirectLink(`${getPrivateAppsUrl(ProjectLogsManager.accountId)}/${ProjectLogsManager.appId}/logs/crm?serverlessFunction=${ProjectLogsManager.functionName}`));
     }
-    logger.log();
+    uiLogger.log('');
     uiLine();
 }
 const command = 'logs';
-const describe = uiBetaTag(i18n(`commands.project.subcommands.logs.describe`), false);
+const describe = commands.project.logs.describe;
 async function handler(args) {
     const { derivedAccountId } = args;
     trackCommandUsage('project-logs', undefined, derivedAccountId);
@@ -70,38 +70,35 @@ function projectLogsBuilder(yargs) {
     yargs.options({
         function: {
             alias: 'function',
-            describe: i18n(`commands.project.subcommands.logs.options.function.describe`),
+            describe: commands.project.logs.options.function.describe,
             requiresArg: true,
             type: 'string',
         },
         latest: {
             alias: 'l',
-            describe: i18n(`commands.project.subcommands.logs.options.latest.describe`),
+            describe: commands.project.logs.options.latest.describe,
             type: 'boolean',
         },
         compact: {
-            describe: i18n(`commands.project.subcommands.logs.options.compact.describe`),
+            describe: commands.project.logs.options.compact.describe,
             type: 'boolean',
         },
         tail: {
             alias: ['t', 'follow'],
-            describe: i18n(`commands.project.subcommands.logs.options.tail.describe`),
+            describe: commands.project.logs.options.tail.describe,
             type: 'boolean',
         },
         limit: {
-            describe: i18n(`commands.project.subcommands.logs.options.limit.describe`),
+            describe: commands.project.logs.options.limit.describe,
             type: 'number',
         },
     });
     yargs.conflicts('tail', 'limit');
     yargs.example([
-        [
-            '$0 project logs',
-            i18n(`commands.project.subcommands.logs.examples.default`),
-        ],
+        ['$0 project logs', commands.project.logs.examples.default],
         [
             '$0 project logs --function=my-function',
-            i18n(`commands.project.subcommands.logs.examples.withOptions`),
+            commands.project.logs.examples.withOptions,
         ],
     ]);
     return yargs;

package/commands/project/migrate.js

@@ -8,36 +8,68 @@ import { uiCommandReference } from '../../lib/ui/index.js';
 import { commands, lib } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { logInBox } from '../../lib/ui/boxen.js';
+import { renderInline } from '../../ui/index.js';
+import { getWarningBox } from '../../ui/components/StatusMessageBoxes.js';
+import { getHasMigratableThemes, migrateThemes2025_2, } from '../../lib/theme/migrate.js';
+import { hasFeature } from '../../lib/hasFeature.js';
+import { FEATURES } from '../../lib/constants.js';
+import { trackCommandMetadataUsage, trackCommandUsage, } from '../../lib/usageTracking.js';
 const { v2025_2 } = PLATFORM_VERSIONS;
 const command = 'migrate';
-const describe = undefined; // commands.project.migrate.describe
+const describe = commands.project.migrate.describe;
 async function handler(args) {
-    const { platformVersion, unstable } = args;
+    const { platformVersion, unstable, derivedAccountId } = args;
+    await trackCommandUsage('project-migrate', {}, derivedAccountId);
     const projectConfig = await getProjectConfig();
     if (!projectConfig.projectConfig) {
         uiLogger.error(commands.project.migrate.errors.noProjectConfig(uiCommandReference('hs app migrate')));
         return process.exit(EXIT_CODES.ERROR);
     }
     if (projectConfig?.projectConfig) {
-        await logInBox({
-            contents: lib.migrate.projectMigrationWarning,
-            options: { title: lib.migrate.projectMigrationWarningTitle },
-        });
+        if (!process.env.HUBSPOT_ENABLE_INK) {
+            await logInBox({
+                contents: lib.migrate.projectMigrationWarning,
+                options: { title: lib.migrate.projectMigrationWarningTitle },
+            });
+        }
+        else {
+            await renderInline(getWarningBox({
+                title: lib.migrate.projectMigrationWarningTitle,
+                message: lib.migrate.projectMigrationWarning,
+            }));
+        }
     }
-    const { derivedAccountId } = args;
     try {
-        await migrateApp2025_2(derivedAccountId, {
-            ...args,
-            name: projectConfig?.projectConfig?.name,
-            platformVersion: unstable
-                ? PLATFORM_VERSIONS.unstable
-                : platformVersion,
-        }, projectConfig);
+        const { hasMigratableThemes, migratableThemesCount } = await getHasMigratableThemes(projectConfig);
+        if (hasMigratableThemes) {
+            const hasThemeMigrationAccess = await hasFeature(derivedAccountId, FEATURES.THEME_MIGRATION_2025_2);
+            if (!hasThemeMigrationAccess) {
+                uiLogger.error(commands.project.migrate.errors.noThemeMigrationAccess(derivedAccountId));
+                return process.exit(EXIT_CODES.ERROR);
+            }
+            await migrateThemes2025_2(derivedAccountId, {
+                ...args,
+                platformVersion: unstable
+                    ? PLATFORM_VERSIONS.unstable
+                    : platformVersion,
+            }, migratableThemesCount, projectConfig);
+        }
+        else {
+            await migrateApp2025_2(derivedAccountId, {
+                ...args,
+                name: projectConfig?.projectConfig?.name,
+                platformVersion: unstable
+                    ? PLATFORM_VERSIONS.unstable
+                    : platformVersion,
+            }, projectConfig);
+        }
     }
     catch (error) {
+        await trackCommandMetadataUsage('project-migrate', { successful: false }, derivedAccountId);
         logError(error);
         return process.exit(EXIT_CODES.ERROR);
     }
+    await trackCommandMetadataUsage('project-migrate', { successful: true }, derivedAccountId);
     return process.exit(EXIT_CODES.SUCCESS);
 }
 function projectMigrateBuilder(yargs) {
@@ -46,7 +78,6 @@ function projectMigrateBuilder(yargs) {
         type: 'string',
         choices: [v2025_2],
         default: v2025_2,
-        hidden: true,
     })
         .option('unstable', {
         type: 'boolean',

package/commands/project/migrateApp.js

@@ -1,48 +1,41 @@
-import { logger } from '@hubspot/local-dev-lib/logger';
-import { i18n } from '../../lib/lang.js';
-import { uiCommandReference, uiDeprecatedTag } from '../../lib/ui/index.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { commands } from '../../lang/en.js';
+import { uiDeprecatedTag } from '../../lib/ui/index.js';
 import { handlerGenerator } from '../app/migrate.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
 const { v2023_2, v2025_2 } = PLATFORM_VERSIONS;
 const command = 'migrate-app';
 // TODO: Leave this as deprecated and remove in the next major release
-const describe = uiDeprecatedTag(i18n(`commands.project.subcommands.migrateApp.describe`), false);
+const describe = uiDeprecatedTag(commands.project.migrateApp.describe, false);
 const deprecated = true;
 async function handler(args) {
-    logger.warn(i18n(`commands.project.subcommands.migrateApp.deprecationWarning`, {
-        oldCommand: uiCommandReference('hs project migrate-app'),
-        newCommand: uiCommandReference(`hs app migrate --platform-version=${args.platformVersion}`),
-    }));
+    uiLogger.warn(commands.project.migrateApp.deprecationWarning(args.platformVersion));
     const localHandler = handlerGenerator('migrate-app');
     await localHandler(args);
 }
 function projectMigrateAppBuilder(yargs) {
     yargs.options({
         name: {
-            describe: i18n(`commands.project.subcommands.migrateApp.options.name.describe`),
+            describe: commands.project.migrateApp.options.name.describe,
             type: 'string',
         },
         dest: {
-            describe: i18n(`commands.project.subcommands.migrateApp.options.dest.describe`),
+            describe: commands.project.migrateApp.options.dest.describe,
             type: 'string',
         },
         'app-id': {
-            describe: i18n(`commands.project.subcommands.migrateApp.options.appId.describe`),
+            describe: commands.project.migrateApp.options.appId.describe,
             type: 'number',
         },
         'platform-version': {
             type: 'string',
             choices: [v2023_2, v2025_2],
-            hidden: true,
-            default: v2023_2,
+            default: v2025_2,
         },
     });
     yargs.example([
-        [
-            `$0 project migrate-app`,
-            i18n(`commands.project.subcommands.migrateApp.examples.default`),
-        ],
+        [`$0 project migrate-app`, commands.project.migrateApp.examples.default],
     ]);
     return yargs;
 }