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

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.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';

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/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.";
@@ -3160,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?";
@@ -3397,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.',
@@ -3154,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?',
@@ -3391,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: {

package/lib/__tests__/hasFeature.test.js

@@ -1,35 +1,173 @@
 import { fetchEnabledFeatures } from '@hubspot/local-dev-lib/api/localDevAuth';
-import { hasFeature } from '../hasFeature.js';
+import { http } from '@hubspot/local-dev-lib/http';
+import { hasFeature, hasUnfiedAppsAccess } from '../hasFeature.js';
+import { FEATURES } from '../constants.js';
 vi.mock('@hubspot/local-dev-lib/api/localDevAuth');
+vi.mock('@hubspot/local-dev-lib/http');
 const mockedFetchEnabledFeatures = fetchEnabledFeatures;
+const mockedHttp = http;
 describe('lib/hasFeature', () => {
     describe('hasFeature()', () => {
         const accountId = 123;
-        beforeEach(() => {
+        afterEach(() => {
+            vi.clearAllMocks();
+        });
+        it('should return true if the feature is enabled', async () => {
             mockedFetchEnabledFeatures.mockResolvedValueOnce({
                 data: {
                     enabledFeatures: {
                         'feature-1': true,
-                        'feature-2': false,
-                        'feature-3': true,
                     },
                 },
             });
-        });
-        it('should return true if the feature is enabled', async () => {
             // @ts-expect-error test data
             const result = await hasFeature(accountId, 'feature-1');
             expect(result).toBe(true);
         });
-        it('should return false if the feature is not enabled', async () => {
+        it('should return false if the feature is disabled', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-2': false,
+                    },
+                },
+            });
             // @ts-expect-error test data
             const result = await hasFeature(accountId, 'feature-2');
             expect(result).toBe(false);
         });
         it('should return false if the feature is not present', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {},
+                },
+            });
             // @ts-expect-error test data
             const result = await hasFeature(accountId, 'feature-4');
             expect(result).toBe(false);
         });
+        it('should return true for APPS_HOME feature when not present in enabled features (defaults on)', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {},
+                },
+            });
+            const result = await hasFeature(accountId, FEATURES.APPS_HOME);
+            expect(result).toBe(true);
+        });
+        it('should respect explicit setting for APPS_HOME feature even when it defaults on', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        [FEATURES.APPS_HOME]: false,
+                    },
+                },
+            });
+            const result = await hasFeature(accountId, FEATURES.APPS_HOME);
+            expect(result).toBe(false);
+        });
+        it('should handle truthy values correctly', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-truthy': 'yes',
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const truthyResult = await hasFeature(accountId, 'feature-truthy');
+            expect(truthyResult).toBe(true);
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-number': 1,
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const numberResult = await hasFeature(accountId, 'feature-number');
+            expect(numberResult).toBe(true);
+        });
+        it('should handle falsy values correctly', async () => {
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-null': null,
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const nullResult = await hasFeature(accountId, 'feature-null');
+            expect(nullResult).toBe(false);
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-zero': 0,
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const zeroResult = await hasFeature(accountId, 'feature-zero');
+            expect(zeroResult).toBe(false);
+            mockedFetchEnabledFeatures.mockResolvedValueOnce({
+                data: {
+                    enabledFeatures: {
+                        'feature-empty': '',
+                    },
+                },
+            });
+            // @ts-expect-error test data
+            const emptyResult = await hasFeature(accountId, 'feature-empty');
+            expect(emptyResult).toBe(false);
+        });
+        it('should propagate errors from fetchEnabledFeatures', async () => {
+            const error = new Error('API error');
+            mockedFetchEnabledFeatures.mockRejectedValueOnce(error);
+            await expect(hasFeature(accountId, FEATURES.UNIFIED_APPS)).rejects.toThrow('API error');
+        });
+    });
+    describe('hasUnfiedAppsAccess()', () => {
+        const accountId = 123;
+        afterEach(() => {
+            vi.clearAllMocks();
+        });
+        it('should return true when API returns true', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: true });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(true);
+            expect(mockedHttp.get).toHaveBeenCalledWith(accountId, {
+                url: 'developer-tooling/external/developer-portal/has-unified-dev-platform-access',
+            });
+        });
+        it('should return false when API returns false', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: false });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(false);
+        });
+        it('should handle truthy values correctly', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: 'yes' });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(true);
+        });
+        it('should handle falsy values correctly', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: null });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(false);
+        });
+        it('should handle undefined response data', async () => {
+            // @ts-expect-error Don't want to mock the full response object
+            mockedHttp.get.mockResolvedValueOnce({ data: undefined });
+            const result = await hasUnfiedAppsAccess(accountId);
+            expect(result).toBe(false);
+        });
+        it('should propagate errors from http.get', async () => {
+            const error = new Error('Network error');
+            mockedHttp.get.mockRejectedValueOnce(error);
+            await expect(hasUnfiedAppsAccess(accountId)).rejects.toThrow('Network error');
+        });
     });
 });

package/lib/__tests__/importData.test.js

@@ -43,7 +43,7 @@ describe('lib/importData', () => {
                 data: { id: '123' },
             });
             await handleImportData(targetAccountId, dataFileNames, importRequest);
-            expect(mockUiLogger.success).toHaveBeenCalledWith(lib.importData.viewImportLink('https://app.hubspot.com', targetAccountId, '123'));
+            expect(mockUiLogger.info).toHaveBeenCalledWith(lib.importData.viewImportLink('https://app.hubspot.com', targetAccountId, '123'));
         });
         it('should log the correct error message', async () => {
             mockCreateImport.mockRejectedValue(new Error('test-error'));