@hubspot/cli 7.7.31-experimental.0 → 7.7.33-experimental.0

package/commands/app.js

@@ -1,16 +1,11 @@
 import migrateCommand from './app/migrate.js';
 import appSecretCommand from './app/secret.js';
-import installAppCommand from './app/install.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 const command = ['app', 'apps'];
 // Keep the command hidden for now
 const describe = undefined;
 function appBuilder(yargs) {
-    yargs
-        .command(migrateCommand)
-        .command(appSecretCommand)
-        .command(installAppCommand)
-        .demandCommand(1, '');
+    yargs.command(migrateCommand).command(appSecretCommand).demandCommand(1, '');
     return yargs;
 }
 const builder = makeYargsBuilder(appBuilder, command, describe);

package/commands/getStarted.js

@@ -16,7 +16,8 @@ import { handleProjectUpload } from '../lib/projects/upload.js';
 import { PROJECT_CONFIG_FILE, GET_STARTED_OPTIONS, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, } from '../lib/constants.js';
 import { writeProjectConfig, getProjectConfig, validateProjectConfig, } from '../lib/projects/config.js';
 import { getProjectPackageJsonLocations, installPackages, } from '../lib/dependencyManagement.js';
-import { pollProjectBuildAndDeploy, useV3Api, } from '../lib/projects/buildAndDeploy.js';
+import { pollProjectBuildAndDeploy } from '../lib/projects/pollProjectBuildAndDeploy.js';
+import { useV3Api } from '../lib/projects/platformVersion.js';
 import { openLink } from '../lib/links.js';
 import { getStaticAuthAppInstallUrl } from '../lib/app/urls.js';
 import { getEnv } from '@hubspot/local-dev-lib/config';
@@ -28,10 +29,12 @@ async function handler(args) {
     const { derivedAccountId } = args;
     const env = getEnv(derivedAccountId) === 'qa' ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD;
     await trackCommandUsage('get-started', {}, derivedAccountId);
+    const accountName = uiAccountDescription(derivedAccountId);
     // TODO: Put this in constants.ts once we have a defined place for the template before INBOUND
     const templateSource = 'robrown-hubspot/hubspot-project-components-ua-app-objects-beta';
     uiInfoSection(commands.getStarted.startTitle, () => {
         uiLogger.log(commands.getStarted.startDescription);
+        uiLogger.log(commands.getStarted.guideOverview(accountName));
     });
     const { default: selectedOption } = await promptUser([
         {
@@ -163,7 +166,6 @@ async function handler(args) {
             uiLogger.log(' ');
         }
         // 6. Ask user if they want to upload the project
-        const accountName = uiAccountDescription(derivedAccountId);
         const { shouldUpload } = await promptUser([
             {
                 type: 'confirm',
@@ -192,12 +194,11 @@ async function handler(args) {
                     process.exit(EXIT_CODES.ERROR);
                 }
                 validateProjectConfig(newProjectConfig, newProjectDir);
-                const targetAccountId = derivedAccountId;
                 uiLogger.log(' ');
                 uiLogger.log(commands.getStarted.logs.uploadingProject);
                 uiLogger.log(' ');
                 const { result, uploadError } = await handleProjectUpload({
-                    accountId: targetAccountId,
+                    accountId: derivedAccountId,
                     projectConfig: newProjectConfig,
                     projectDir: newProjectDir,
                     callbackFunc: pollProjectBuildAndDeploy,

package/commands/project/__tests__/add.test.js

@@ -4,13 +4,13 @@ import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, } from
 import { v3AddComponent } from '../../../lib/projects/add/v3AddComponent.js';
 import { legacyAddComponent } from '../../../lib/projects/add/legacyAddComponent.js';
 import { getProjectConfig } from '../../../lib/projects/config.js';
-import { useV3Api } from '../../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../../lib/projects/platformVersion.js';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
 vi.mock('../../../lib/commonOpts');
 vi.mock('../../../lib/projects/add/v3AddComponent');
 vi.mock('../../../lib/projects/add/legacyAddComponent');
 vi.mock('../../../lib/projects/config');
-vi.mock('../../../lib/projects/buildAndDeploy');
+vi.mock('../../../lib/projects/platformVersion');
 vi.mock('../../../lib/usageTracking');
 const mockedV3AddComponent = vi.mocked(v3AddComponent);
 const mockedLegacyAddComponent = vi.mocked(legacyAddComponent);
@@ -82,15 +82,13 @@ describe('commands/project/add', () => {
         it('should call v3AddComponent with accountId for v3 projects', async () => {
             mockedUseV3Api.mockReturnValue(true);
             await expect(projectAddCommand.handler(mockArgs)).rejects.toThrow('process.exit called');
-            expect(mockedTrackCommandUsage).toHaveBeenCalledWith('project-add', undefined, 123);
             expect(mockedV3AddComponent).toHaveBeenCalledWith(mockArgs, mockProjectDir, mockProjectConfig, 123);
             expect(mockedLegacyAddComponent).not.toHaveBeenCalled();
         });
         it('should call legacyAddComponent for non-v3 projects', async () => {
             mockedUseV3Api.mockReturnValue(false);
             await expect(projectAddCommand.handler(mockArgs)).rejects.toThrow('process.exit called');
-            expect(mockedTrackCommandUsage).toHaveBeenCalledWith('project-add', undefined, 123);
-            expect(mockedLegacyAddComponent).toHaveBeenCalledWith(mockArgs, mockProjectDir, mockProjectConfig);
+            expect(mockedLegacyAddComponent).toHaveBeenCalledWith(mockArgs, mockProjectDir, mockProjectConfig, 123);
             expect(mockedV3AddComponent).not.toHaveBeenCalled();
         });
         it('should exit with error when project config is not found', async () => {

package/commands/project/__tests__/deploy.test.js

@@ -8,7 +8,7 @@ import * as ui from '../../../lib/ui/index.js';
 import { addAccountOptions, addConfigOptions, addJSONOutputOptions, addUseEnvironmentOptions, } from '../../../lib/commonOpts.js';
 import * as projectUtils from '../../../lib/projects/config.js';
 import * as projectUrlUtils from '../../../lib/projects/urls.js';
-import { pollDeployStatus } from '../../../lib/projects/buildAndDeploy.js';
+import { pollDeployStatus } from '../../../lib/projects/pollProjectBuildAndDeploy.js';
 import * as projectNamePrompt from '../../../lib/prompts/projectNamePrompt.js';
 import * as promptUtils from '../../../lib/prompts/promptUtils.js';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
@@ -23,7 +23,8 @@ vi.mock('../../../lib/commonOpts');
 vi.mock('../../../lib/validation');
 vi.mock('../../../lib/projects/config');
 vi.mock('../../../lib/projects/urls');
-vi.mock('../../../lib/projects/buildAndDeploy');
+vi.mock('../../../lib/projects/pollProjectBuildAndDeploy');
+vi.mock('../../../lib/projects/platformVersion');
 vi.mock('../../../lib/prompts/projectNamePrompt');
 vi.mock('../../../lib/prompts/promptUtils');
 vi.mock('../../../lib/usageTracking');

package/commands/project/add.js

@@ -1,11 +1,10 @@
 import { logError } from '../../lib/errorHandlers/index.js';
-import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
 import { uiBetaTag } from '../../lib/ui/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
-import { useV3Api } from '../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../lib/projects/platformVersion.js';
 import { legacyAddComponent } from '../../lib/projects/add/legacyAddComponent.js';
 import { v3AddComponent } from '../../lib/projects/add/v3AddComponent.js';
 import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, } from '../../lib/constants.js';
@@ -15,7 +14,6 @@ const describe = uiBetaTag(commands.project.add.describe, false);
 async function handler(args) {
     try {
         const { derivedAccountId } = args;
-        trackCommandUsage('project-add', undefined, derivedAccountId);
         const { projectConfig, projectDir } = await getProjectConfig();
         if (!projectDir || !projectConfig) {
             uiLogger.error(commands.project.add.error.locationInProject);
@@ -26,7 +24,7 @@ async function handler(args) {
             await v3AddComponent(args, projectDir, projectConfig, derivedAccountId);
         }
         else {
-            await legacyAddComponent(args, projectDir, projectConfig);
+            await legacyAddComponent(args, projectDir, projectConfig, derivedAccountId);
         }
     }
     catch (e) {

package/commands/project/deploy.js

@@ -1,11 +1,10 @@
-import { deployProject, fetchProject, } from '@hubspot/local-dev-lib/api/projects';
+import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
 import { getAccountConfig } from '@hubspot/local-dev-lib/config';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
-import { useV3Api } from '../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../lib/projects/platformVersion.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
-import { pollDeployStatus } from '../../lib/projects/buildAndDeploy.js';
 import { projectNamePrompt } from '../../lib/prompts/projectNamePrompt.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { uiBetaTag, uiLine } from '../../lib/ui/index.js';
@@ -13,54 +12,11 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { loadProfile, logProfileFooter, logProfileHeader, exitIfUsingProfiles, } from '../../lib/projectProfiles.js';
-import { PROJECT_ERROR_TYPES, PROJECT_DEPLOY_TEXT, } from '../../lib/constants.js';
+import { PROJECT_DEPLOY_TEXT } from '../../lib/constants.js';
 import { commands } from '../../lang/en.js';
+import { handleProjectDeploy, validateBuildIdForDeploy, logDeployErrors, } from '../../lib/projects/deploy.js';
 const command = 'deploy';
 const describe = uiBetaTag(commands.project.deploy.describe, false);
-function validateBuildId(buildId, deployedBuildId, latestBuildId, projectName, accountId) {
-    if (Number(buildId) > latestBuildId) {
-        return commands.project.deploy.errors.buildIdDoesNotExist(accountId, buildId, projectName);
-    }
-    if (Number(buildId) === deployedBuildId) {
-        return commands.project.deploy.errors.buildAlreadyDeployed(accountId, buildId, projectName);
-    }
-    return true;
-}
-function logDeployErrors(errorData) {
-    uiLogger.error(errorData.message);
-    errorData.errors.forEach(err => {
-        // This is how the pre-deploy check manifests itself in < 2025.2 projects
-        if (err.subCategory === PROJECT_ERROR_TYPES.DEPLOY_CONTAINS_REMOVALS) {
-            uiLogger.log(commands.project.deploy.errors.deployContainsRemovals(err.context.COMPONENT_NAME));
-        }
-        else {
-            uiLogger.log(err.message);
-        }
-    });
-}
-function handleBlockedDeploy(deployResp) {
-    const deployCanBeForced = deployResp.issues.every(issue => issue.blockingMessages.every(message => message.isWarning));
-    uiLogger.log('');
-    if (deployCanBeForced) {
-        uiLogger.warn(commands.project.deploy.errors.deployWarningsHeader);
-        uiLogger.log('');
-    }
-    else {
-        uiLogger.error(commands.project.deploy.errors.deployBlockedHeader);
-        uiLogger.log('');
-    }
-    deployResp.issues.forEach(issue => {
-        if (issue.blockingMessages.length > 0) {
-            issue.blockingMessages.forEach(message => {
-                uiLogger.log(commands.project.deploy.errors.deployIssueComponentWarning(issue.uid, issue.componentTypeName, message.message));
-            });
-        }
-        else {
-            uiLogger.log(commands.project.deploy.errors.deployIssueComponentGeneric(issue.uid, issue.componentTypeName));
-        }
-        uiLogger.log('');
-    });
-}
 async function handler(args) {
     const { derivedAccountId, project: projectOption, buildId: buildIdOption, force: forceOption, deployLatestBuild: deployLatestBuildOption, json: formatOutputAsJson, } = args;
     const accountConfig = getAccountConfig(derivedAccountId);
@@ -105,7 +61,7 @@ async function handler(args) {
             return process.exit(EXIT_CODES.ERROR);
         }
         if (buildIdToDeploy) {
-            const validationResult = validateBuildId(buildIdToDeploy, deployedBuildId, latestBuild.buildId, projectName, targetAccountId);
+            const validationResult = validateBuildIdForDeploy(buildIdToDeploy, deployedBuildId, latestBuild.buildId, projectName, targetAccountId);
             if (validationResult !== true) {
                 uiLogger.error(validationResult.toString());
                 return process.exit(EXIT_CODES.ERROR);
@@ -122,7 +78,7 @@ async function handler(args) {
                     default: latestBuild.buildId === deployedBuildId
                         ? undefined
                         : latestBuild.buildId,
-                    validate: buildId => validateBuildId(buildId, deployedBuildId, latestBuild.buildId, projectName, targetAccountId),
+                    validate: buildId => validateBuildIdForDeploy(buildId, deployedBuildId, latestBuild.buildId, projectName, targetAccountId),
                 });
                 buildIdToDeploy = deployBuildIdPromptResponse.buildId;
             }
@@ -131,21 +87,13 @@ async function handler(args) {
             uiLogger.error(commands.project.deploy.errors.noBuildId);
             return process.exit(EXIT_CODES.ERROR);
         }
-        const { data: deployResp } = await deployProject(targetAccountId, projectName, buildIdToDeploy, useV3Api(projectConfig?.platformVersion), forceOption);
-        if (!deployResp || deployResp.buildResultType !== 'DEPLOY_QUEUED') {
-            if (deployResp?.buildResultType === 'DEPLOY_BLOCKED') {
-                handleBlockedDeploy(deployResp);
-                process.exit(EXIT_CODES.ERROR);
-            }
-            else {
-                uiLogger.error(commands.project.deploy.errors.deploy);
-            }
+        const deployResult = await handleProjectDeploy(targetAccountId, projectName, buildIdToDeploy, useV3Api(projectConfig?.platformVersion), forceOption);
+        if (!deployResult) {
             return process.exit(EXIT_CODES.ERROR);
         }
         else if (formatOutputAsJson) {
-            jsonOutput.deployId = Number(deployResp.id);
+            jsonOutput.deployId = deployResult.deployId;
         }
-        const deployResult = await pollDeployStatus(targetAccountId, projectName, Number(deployResp.id), buildIdToDeploy);
         if (deployResult.status === PROJECT_DEPLOY_TEXT.STATES.SUCCESS) {
             deploySuccess = true;
         }

package/commands/project/dev/index.js

@@ -5,7 +5,7 @@ import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { uiBetaTag, uiLine } from '../../../lib/ui/index.js';
 import { deprecatedProjectDevFlow } from './deprecatedFlow.js';
 import { unifiedProjectDevFlow } from './unifiedFlow.js';
-import { useV3Api } from '../../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../../lib/projects/platformVersion.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { loadProfile, exitIfUsingProfiles, } from '../../../lib/projectProfiles.js';
 import { commands } from '../../../lang/en.js';

package/commands/project/dev/unifiedFlow.js

@@ -22,6 +22,7 @@ import LocalDevWebsocketServer from '../../../lib/projects/localDev/LocalDevWebs
 export async function unifiedProjectDevFlow({ args, targetProjectAccountId, providedTargetTestingAccountId, projectConfig, projectDir, }) {
     const env = getValidEnv(getEnv(targetProjectAccountId));
     let projectNodes;
+    let projectProfileData;
     // Get IR
     try {
         const intermediateRepresentation = await translateForLocalDev({
@@ -30,6 +31,7 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
             accountId: targetProjectAccountId,
         }, { profile: args.profile });
         projectNodes = intermediateRepresentation.intermediateNodesIndexedByUid;
+        projectProfileData = intermediateRepresentation.profileData;
         uiLogger.debug(util.inspect(projectNodes, false, null, true));
     }
     catch (e) {
@@ -116,6 +118,7 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
     // End setup, start local dev process
     const localDevProcess = new LocalDevProcess({
         initialProjectNodes: projectNodes,
+        initialProjectProfileData: projectProfileData,
         debug: args.debug,
         profile: args.profile,
         targetProjectAccountId,

package/commands/project/upload.d.ts

@@ -1,5 +1,5 @@
-import { CommonArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-type ProjectUploadArgs = CommonArgs & JSONOutputArgs & EnvironmentArgs & {
+import { CommonArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
+type ProjectUploadArgs = CommonArgs & JSONOutputArgs & {
     forceCreate: boolean;
     message: string;
     m: string;

package/commands/project/upload.js

@@ -2,14 +2,14 @@ import chalk from 'chalk';
 import { logger } from '@hubspot/local-dev-lib/logger';
 import { getAccountConfig } from '@hubspot/local-dev-lib/config';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { useV3Api } from '../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../lib/projects/platformVersion.js';
 import { uiBetaTag, uiCommandReference } from '../../lib/ui/index.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { logFeedbackMessage } from '../../lib/projects/ui.js';
 import { handleProjectUpload } from '../../lib/projects/upload.js';
 import { loadAndValidateProfile } from '../../lib/projectProfiles.js';
-import { displayWarnLogs, pollProjectBuildAndDeploy, } from '../../lib/projects/buildAndDeploy.js';
+import { displayWarnLogs, pollProjectBuildAndDeploy, } from '../../lib/projects/pollProjectBuildAndDeploy.js';
 import { i18n } from '../../lib/lang.js';
 import { PROJECT_ERROR_TYPES } from '../../lib/constants.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
@@ -25,7 +25,7 @@ async function handler(args) {
     validateProjectConfig(projectConfig, projectDir);
     let targetAccountId;
     if (useV3Api(projectConfig.platformVersion)) {
-        targetAccountId = await loadAndValidateProfile(projectConfig, projectDir, profile, args.useEnv);
+        targetAccountId = await loadAndValidateProfile(projectConfig, projectDir, profile);
     }
     targetAccountId = targetAccountId || derivedAccountId;
     const accountConfig = getAccountConfig(targetAccountId);

package/commands/project/validate.js

@@ -1,6 +1,6 @@
 import path from 'path';
 import { getAccountConfig } from '@hubspot/local-dev-lib/config';
-import { useV3Api } from '../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../lib/projects/platformVersion.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { getProjectConfig, validateProjectConfig as validateProjectConfig, } from '../../lib/projects/config.js';

package/commands/project/watch.js

@@ -1,6 +1,6 @@
 import { cancelStagedBuild, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { useV3Api } from '../../lib/projects/buildAndDeploy.js';
+import { useV3Api } from '../../lib/projects/platformVersion.js';
 import { uiCommandReference, uiLink, uiBetaTag } from '../../lib/ui/index.js';
 import { i18n } from '../../lib/lang.js';
 import { createWatcher } from '../../lib/projects/watch.js';
@@ -11,7 +11,7 @@ import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { logFeedbackMessage } from '../../lib/projects/ui.js';
 import { handleProjectUpload } from '../../lib/projects/upload.js';
-import { pollBuildStatus, pollDeployStatus, } from '../../lib/projects/buildAndDeploy.js';
+import { pollBuildStatus, pollDeployStatus, } from '../../lib/projects/pollProjectBuildAndDeploy.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { handleKeypress, handleExit } from '../../lib/process.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';

package/commands/testAccount/create.js

@@ -75,9 +75,6 @@ async function handler(args) {
         resultJson.personalAccessKey = createResult.personalAccessKey;
     }
     catch (err) {
-        SpinniesManager.fail('createTestAccount', {
-            text: commands.testAccount.create.polling.createFailure,
-        });
         logError(err);
         SpinniesManager.fail('createTestAccount', {
             text: commands.testAccount.create.polling.createFailure,

package/lang/en.d.ts

@@ -23,7 +23,8 @@ export declare const commands: {
         };
         readonly startTitle: "Welcome to HubSpot Development!";
         readonly verboseDescribe: "A step-by-step command to get you started with a HubSpot project.";
-        readonly startDescription: "You can use the HubSpot CLI to build apps, CMS themes, and more.";
+        readonly startDescription: "You can use the HubSpot CLI to build apps, CMS themes, and more.\n";
+        readonly guideOverview: (accountName: string) => string;
         readonly designManager: "To onboard with CMS, please visit the HubSpot Design Manager in your account and follow the checklist items.";
         readonly openDesignManager: "Click here to go to the HubSpot Design Manager";
         readonly openDesignManagerPrompt: "Open Design Manager in your browser?";
@@ -1188,9 +1189,11 @@ ${string}`;
             readonly success: (componentName: string, multiple?: boolean) => string;
             readonly error: {
                 readonly failedToDownloadComponent: "Failed to download project. Please try again later.";
+                readonly invalidComponentType: (componentType: string) => string;
                 readonly maxExceeded: (maxCount: number) => string;
                 readonly authTypeNotAllowed: (authType: string) => string;
                 readonly distributionNotAllowed: (dist: string) => string;
+                readonly portalDoesNotHaveAccessToThisFeature: (accountId: number) => string;
                 readonly locationInProject: "This command must be run from within a project directory.";
                 readonly failedToFetchComponentList: "Failed to fetch the list of available features. Please try again later.";
                 readonly projectContainsPublicApp: "This project contains a public app. This command is currently only compatible with projects that contain private apps.";
@@ -1550,28 +1553,6 @@ ${string}`;
     readonly app: {
         readonly describe: "Commands for managing apps.";
         readonly subcommands: {
-            readonly install: {
-                readonly describe: "Install an OAuth app into a test account.";
-                readonly options: {
-                    readonly appUid: "The uid of the app to install";
-                    readonly projectName: "The name of the project that contains the app";
-                };
-                readonly positionals: {
-                    readonly testAccountId: "The id of the test account to install the app into";
-                };
-                readonly errors: {
-                    readonly mustSpecifyProjectName: `You must specify a project name. Use the ${string} flag to specify the project name or run this command from within a project directory.`;
-                    readonly noAppUidFound: `No app uid found. Please specify the app uid with the ${string} flag or run this command from within a project that contains an app.`;
-                    readonly appMustBeOauth: "This command only supports installing oauth apps. Please specify an app with oauth auth type.";
-                };
-                readonly polling: {
-                    readonly start: "Installing app...";
-                    readonly success: "App installed successfully";
-                    readonly failure: "App installation failed";
-                    readonly error: "Error installing app";
-                };
-                readonly example: "Install the app with uid my-app-uid from the project named \"my-project\" into the target account with id 1234567890";
-            };
             readonly secret: {
                 readonly describe: "Commands for managing secrets.";
                 readonly subcommands: {
@@ -3182,8 +3163,9 @@ Run ${string} to upgrade to version ${string}`;
             };
         };
         readonly installAppPrompt: {
-            readonly explanation: "Local development requires this app to be installed in the target test account";
+            readonly explanation: "Local development requires this app to be installed in the target test account.";
             readonly reinstallExplanation: "This app's required scopes have been updated since it was last installed on the target test account. To avoid issues with local development, we recommend reinstalling the app with the updated scopes.";
+            readonly staticAuthExplanation: (projectAccountId: number, testingAccountId: number, projectName: string, appUid: string) => string;
             readonly prompt: "Open HubSpot to install this app?";
             readonly autoPrompt: "Install this app in your target test account?";
             readonly reinstallPrompt: "Open HubSpot to reinstall this app?";
@@ -3404,7 +3386,7 @@ Run ${string} to upgrade to version ${string}`;
         readonly componentsToBeMigrated: (components: string) => string;
         readonly componentsThatWillNotBeMigrated: (components: string) => string;
         readonly sourceContentsMoved: (newLocation: string) => string;
-        readonly projectMigrationWarningTitle: "⚠️ Important: Migrating to platformVersion 2025.2 is irreversible ⚠️";
+        readonly projectMigrationWarningTitle: "Important: Migrating to platformVersion 2025.2 is irreversible";
         readonly projectMigrationWarning: string;
         readonly success: {
             readonly downloadedProject: (projectName: string, projectDest: string) => string;
@@ -3419,7 +3401,7 @@ Run ${string} to upgrade to version ${string}`;
                 readonly themesAndAppsNotAllowed: "Support for migrating projects containing both themes and apps to the latest platform version is coming soon. Try again later.";
                 readonly multipleApps: "Multiple apps found in project, this is not allowed in 2025.2";
                 readonly alreadyExists: (projectName: string) => string;
-                readonly failedToMigrateThemes: "Failed to migrate project themes. Please verify that you have propoerly formatted themes before trying again.";
+                readonly failedToMigrateThemes: "Failed to migrate project themes. Please verify that your themes are properly formatted before trying again.";
                 readonly failedToUpdateProjectConfig: "Failed to update project config file. Please update the platformVersion in the project config file manually.";
             };
             readonly unmigratableReasons: {

package/lang/en.js

@@ -4,7 +4,7 @@ import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
 import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constants/auth';
 import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, } from '@hubspot/local-dev-lib/constants/config';
 import { uiAccountDescription, uiBetaTag, uiCommandReference, uiLink, UI_COLORS, } from '../lib/ui/index.js';
-import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, } from '../lib/projects/urls.js';
+import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, getAppAllowlistUrl, } from '../lib/projects/urls.js';
 import { APP_DISTRIBUTION_TYPES, APP_AUTH_TYPES, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, } from '../lib/constants.js';
 import { getAccountIdentifier } from '@hubspot/local-dev-lib/config/getAccountIdentifier';
 export const commands = {
@@ -31,7 +31,8 @@ export const commands = {
         },
         startTitle: 'Welcome to HubSpot Development!',
         verboseDescribe: 'A step-by-step command to get you started with a HubSpot project.',
-        startDescription: 'You can use the HubSpot CLI to build apps, CMS themes, and more.',
+        startDescription: 'You can use the HubSpot CLI to build apps, CMS themes, and more.\n',
+        guideOverview: (accountName) => `This guide will walk you through deploying your first project to ${chalk.bold(accountName)}.\nTo target a different account, exit this guide ${chalk.bold('(ctrl + c)')} and run ${uiCommandReference('hs account use')} before trying again.`,
         designManager: 'To onboard with CMS, please visit the HubSpot Design Manager in your account and follow the checklist items.',
         openDesignManager: 'Click here to go to the HubSpot Design Manager',
         openDesignManagerPrompt: 'Open Design Manager in your browser?',
@@ -1187,9 +1188,11 @@ export const commands = {
             success: (componentName, multiple = false) => `${componentName || 'An app'} ${multiple ? 'were' : 'was'} successfully added to your ${componentName ? 'app' : 'project'}.`,
             error: {
                 failedToDownloadComponent: 'Failed to download project. Please try again later.',
+                invalidComponentType: (componentType) => `'${componentType}' is not a valid project component type.`,
                 maxExceeded: (maxCount) => `This project has the maximum allowed(${maxCount})`,
                 authTypeNotAllowed: (authType) => `Auth type '${authType}' not allowed.`,
                 distributionNotAllowed: (dist) => `Distribution '${dist}' not allowed.`,
+                portalDoesNotHaveAccessToThisFeature: (accountId) => `The account ${uiAccountDescription(accountId)} does not have access to this feature`,
                 locationInProject: 'This command must be run from within a project directory.',
                 failedToFetchComponentList: 'Failed to fetch the list of available features. Please try again later.',
                 projectContainsPublicApp: 'This project contains a public app. This command is currently only compatible with projects that contain private apps.',
@@ -1547,28 +1550,6 @@ export const commands = {
     app: {
         describe: 'Commands for managing apps.',
         subcommands: {
-            install: {
-                describe: 'Install an OAuth app into a test account.',
-                options: {
-                    appUid: 'The uid of the app to install',
-                    projectName: 'The name of the project that contains the app',
-                },
-                positionals: {
-                    testAccountId: 'The id of the test account to install the app into',
-                },
-                errors: {
-                    mustSpecifyProjectName: `You must specify a project name. Use the ${uiCommandReference('--project-name')} flag to specify the project name or run this command from within a project directory.`,
-                    noAppUidFound: `No app uid found. Please specify the app uid with the ${uiCommandReference('--app-uid')} flag or run this command from within a project that contains an app.`,
-                    appMustBeOauth: 'This command only supports installing oauth apps. Please specify an app with oauth auth type.',
-                },
-                polling: {
-                    start: 'Installing app...',
-                    success: 'App installed successfully',
-                    failure: 'App installation failed',
-                    error: 'Error installing app',
-                },
-                example: 'Install the app with uid my-app-uid from the project named "my-project" into the target account with id 1234567890',
-            },
             secret: {
                 describe: 'Commands for managing secrets.',
                 subcommands: {
@@ -3176,8 +3157,9 @@ export const lib = {
             },
         },
         installAppPrompt: {
-            explanation: 'Local development requires this app to be installed in the target test account',
+            explanation: 'Local development requires this app to be installed in the target test account.',
             reinstallExplanation: "This app's required scopes have been updated since it was last installed on the target test account. To avoid issues with local development, we recommend reinstalling the app with the updated scopes.",
+            staticAuthExplanation: (projectAccountId, testingAccountId, projectName, appUid) => `To install this static auth app, your testing account ${uiAccountDescription(testingAccountId)} must be on ${uiLink("this app's allowlist", getAppAllowlistUrl(projectAccountId, projectName, appUid))}.`,
             prompt: 'Open HubSpot to install this app?',
             autoPrompt: 'Install this app in your target test account?',
             reinstallPrompt: 'Open HubSpot to reinstall this app?',
@@ -3398,7 +3380,7 @@ export const lib = {
         componentsToBeMigrated: (components) => `The following features will be migrated: ${components}`,
         componentsThatWillNotBeMigrated: (components) => `[NOTE] These features are not yet supported for migration but will be available later: ${components}`,
         sourceContentsMoved: (newLocation) => `The contents of your old source directory have been moved to ${newLocation}, move any required files to the new source directory.`,
-        projectMigrationWarningTitle: '⚠️ Important: Migrating to platformVersion 2025.2 is irreversible ⚠️',
+        projectMigrationWarningTitle: 'Important: Migrating to platformVersion 2025.2 is irreversible',
         projectMigrationWarning: uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion 2025.2. This action cannot be undone. To ensure you have access to your original files, they will be copied to a new directory (archive) for safekeeping.\n\nThis command will guide you through the process, prompting you to enter the required fields and will download the new project source code into your project source directory.`, false),
         success: {
             downloadedProject: (projectName, projectDest) => `Saved ${projectName} to ${projectDest}`,
@@ -3413,7 +3395,7 @@ export const lib = {
                 themesAndAppsNotAllowed: 'Support for migrating projects containing both themes and apps to the latest platform version is coming soon. Try again later.',
                 multipleApps: 'Multiple apps found in project, this is not allowed in 2025.2',
                 alreadyExists: (projectName) => `A project with name ${projectName} already exists. Please choose another name.`,
-                failedToMigrateThemes: 'Failed to migrate project themes. Please verify that you have propoerly formatted themes before trying again.',
+                failedToMigrateThemes: 'Failed to migrate project themes. Please verify that your themes are properly formatted before trying again.',
                 failedToUpdateProjectConfig: 'Failed to update project config file. Please update the platformVersion in the project config file manually.',
             },
             unmigratableReasons: {