@hubspot/cli 8.0.2-experimental.0 → 8.0.3-experimental.0

package/commands/__tests__/getStarted.test.js

@@ -10,7 +10,7 @@ import { GET_STARTED_OPTIONS } from '../../lib/constants.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import open from 'open';
 import { renderInteractive } from '../../ui/render.js';
-import { getGetStartedFlow } from '../../ui/components/GetStartedFlow.js';
+import { getGetStartedFlow } from '../../ui/components/getStarted/GetStartedFlow.js';
 vi.mock('../../lib/prompts/promptUtils');
 vi.mock('../../lib/prompts/projectNameAndDestPrompt');
 vi.mock('../../lib/projects/config');
@@ -19,7 +19,7 @@ vi.mock('@hubspot/local-dev-lib/github');
 vi.mock('../../lib/dependencyManagement');
 vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('../../ui/render');
-vi.mock('../../ui/components/GetStartedFlow');
+vi.mock('../../ui/components/getStarted/GetStartedFlow');
 vi.mock('open');
 vi.mock('fs-extra', () => ({
     default: {

package/commands/__tests__/project.test.js

@@ -17,6 +17,9 @@ import validate from '../project/validate.js';
 import profileCommands from '../project/profile.js';
 import list from '../project/list.js';
 import projectCommand from '../project.js';
+import * as projectConfigLib from '../../lib/projects/config.js';
+import * as platformVersionLib from '../../lib/projects/platformVersion.js';
+import { uiLogger } from '../../lib/ui/logger.js';
 vi.mock('../project/deploy');
 vi.mock('../project/create');
 vi.mock('../project/upload');
@@ -40,13 +43,24 @@ vi.mock('../project/installDeps');
 vi.mock('../project/lint');
 vi.mock('../project/profile');
 vi.mock('../../lib/commonOpts');
+vi.mock('../../lib/projects/config.js');
+vi.mock('../../lib/projects/platformVersion.js');
 const commandSpy = vi
     .spyOn(yargs, 'command')
     .mockReturnValue(yargs);
 const demandCommandSpy = vi
     .spyOn(yargs, 'demandCommand')
     .mockReturnValue(yargs);
+const getProjectConfigSpy = vi.spyOn(projectConfigLib, 'getProjectConfig');
+const isUnsupportedPlatformVersionSpy = vi.spyOn(platformVersionLib, 'isUnsupportedPlatformVersion');
+const processExitSpy = vi.spyOn(process, 'exit');
+const uiLoggerErrorSpy = vi.spyOn(uiLogger, 'error');
 describe('commands/project', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // @ts-expect-error Mock implementation
+        processExitSpy.mockImplementation(() => { });
+    });
     describe('command', () => {
         it('should have the correct command structure', () => {
             expect(projectCommand.command).toEqual(['project', 'projects']);
@@ -92,4 +106,20 @@ describe('commands/project', () => {
             expect(commandSpy).toHaveBeenCalledWith(module);
         });
     });
+    describe('middleware - validatePlatformVersion', () => {
+        it('should have platform version validation functions available', () => {
+            // Verify the necessary functions are available for middleware
+            expect(getProjectConfigSpy).toBeDefined();
+            expect(isUnsupportedPlatformVersionSpy).toBeDefined();
+            expect(uiLoggerErrorSpy).toBeDefined();
+            expect(processExitSpy).toBeDefined();
+        });
+        it('should register middleware when building', async () => {
+            // Verify middleware is registered during builder execution
+            await projectCommand.builder(yargs);
+            // The middleware should be registered (we can't easily test async middleware execution)
+            // but we verify the builder completes successfully
+            expect(projectCommand.builder).toBeDefined();
+        });
+    });
 });

package/commands/account/auth.js

@@ -1,96 +1,21 @@
-import { updateConfigAccount, createEmptyConfigFile, deleteConfigFileIfEmpty, getConfigFilePath, localConfigFileExists, globalConfigFileExists, } from '@hubspot/local-dev-lib/config';
-import { getAccessToken, updateConfigWithAccessToken, } from '@hubspot/local-dev-lib/personalAccessKey';
 import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
-import { toKebabCase } from '@hubspot/local-dev-lib/text';
 import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constants/auth';
-import { handleMerge, handleMigration } from '../../lib/configMigrate.js';
+import { deleteConfigFileIfEmpty } from '@hubspot/local-dev-lib/config';
 import { handleExit } from '../../lib/process.js';
-import { debugError } from '../../lib/errorHandlers/index.js';
 import { trackCommandUsage, trackAuthAction } from '../../lib/usageTracking.js';
-import { personalAccessKeyPrompt } from '../../lib/prompts/personalAccessKeyPrompt.js';
-import { cliAccountNamePrompt } from '../../lib/prompts/accountNamePrompt.js';
-import { setAsDefaultAccountPrompt } from '../../lib/prompts/setAsDefaultAccountPrompt.js';
-import { logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiFeatureHighlight } from '../../lib/ui/index.js';
 import { parseStringToNumber } from '../../lib/parsing.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
+import { authenticateNewAccount } from '../../lib/accountAuth.js';
 const TRACKING_STATUS = {
     STARTED: 'started',
     ERROR: 'error',
     COMPLETE: 'complete',
 };
 const authType = PERSONAL_ACCESS_KEY_AUTH_METHOD.value;
-async function updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId) {
-    try {
-        const { personalAccessKey } = providedPersonalAccessKey
-            ? { personalAccessKey: providedPersonalAccessKey }
-            : await personalAccessKeyPrompt({
-                env,
-                account: accountId,
-            });
-        const token = await getAccessToken(personalAccessKey, env);
-        const defaultAccountName = token.hubName
-            ? toKebabCase(token.hubName)
-            : undefined;
-        const accountName = configAlreadyExists
-            ? undefined
-            : (await cliAccountNamePrompt(defaultAccountName)).name;
-        const updatedConfig = await updateConfigWithAccessToken(token, personalAccessKey, env, accountName, !configAlreadyExists);
-        if (!updatedConfig)
-            return null;
-        // Can happen if the user is re-authenticating an account with no name
-        if (configAlreadyExists && !updatedConfig.name) {
-            updatedConfig.name = (await cliAccountNamePrompt(defaultAccountName)).name;
-            updateConfigAccount({
-                ...updatedConfig,
-            });
-        }
-        return updatedConfig;
-    }
-    catch (e) {
-        debugError(e);
-        return null;
-    }
-}
-async function handleConfigMigration() {
-    const deprecatedConfigExists = localConfigFileExists();
-    const globalConfigExists = globalConfigFileExists();
-    // No deprecated config exists, so no migration is needed
-    if (!deprecatedConfigExists) {
-        return true;
-    }
-    // Global config exists, so we need to merge the deprecated config with the global config
-    if (globalConfigExists) {
-        try {
-            const mergeConfirmed = await handleMerge();
-            if (!mergeConfirmed) {
-                uiLogger.log('');
-                uiLogger.log(commands.account.subcommands.auth.errors.mergeNotConfirmed);
-            }
-            return mergeConfirmed;
-        }
-        catch (error) {
-            logError(error);
-            return false;
-        }
-    }
-    // Global config does not exist, so we only need to migrate the deprecated config
-    try {
-        const migrationConfirmed = await handleMigration();
-        if (!migrationConfirmed) {
-            uiLogger.log('');
-            uiLogger.log(commands.account.subcommands.auth.errors.migrationNotConfirmed);
-        }
-        return migrationConfirmed;
-    }
-    catch (error) {
-        logError(error);
-        return false;
-    }
-}
 const describe = commands.account.subcommands.auth.describe;
 const command = 'auth';
 async function handler(args) {
@@ -109,33 +34,19 @@ async function handler(args) {
         trackCommandUsage('account-auth', {}, parsedUserProvidedAccountId);
         await trackAuthAction('account-auth', authType, TRACKING_STATUS.STARTED);
     }
-    const configMigrationSuccess = await handleConfigMigration();
-    if (!configMigrationSuccess) {
-        await trackAuthAction('account-auth', authType, TRACKING_STATUS.ERROR);
-        process.exit(EXIT_CODES.ERROR);
-    }
-    const configAlreadyExists = globalConfigFileExists();
-    if (!configAlreadyExists) {
-        createEmptyConfigFile(true);
-    }
     handleExit(deleteConfigFileIfEmpty);
-    const updatedConfig = await updateConfigWithNewAccount(args.qa ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD, configAlreadyExists, providedPersonalAccessKey, parsedUserProvidedAccountId);
+    const updatedConfig = await authenticateNewAccount({
+        env: args.qa ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD,
+        providedPersonalAccessKey,
+        accountId: parsedUserProvidedAccountId,
+    });
     if (!updatedConfig) {
         if (!disableTracking) {
             await trackAuthAction('account-auth', authType, TRACKING_STATUS.ERROR);
         }
-        uiLogger.error(commands.account.subcommands.auth.errors.failedToUpdateConfig);
         return process.exit(EXIT_CODES.ERROR);
     }
-    const { accountId, name } = updatedConfig;
-    if (!configAlreadyExists) {
-        uiLogger.log('');
-        uiLogger.success(commands.account.subcommands.auth.success.configFileCreated(getConfigFilePath()));
-        uiLogger.success(commands.account.subcommands.auth.success.configFileUpdated(accountId));
-    }
-    else {
-        await setAsDefaultAccountPrompt(name);
-    }
+    const { accountId } = updatedConfig;
     uiFeatureHighlight([
         'getStartedCommand',
         'helpCommand',

package/commands/account/use.js

@@ -1,24 +1,39 @@
-import { getConfigFilePath, setConfigAccountAsDefault, getConfigAccountIfExists, getConfigAccountByName, getConfigAccountById, getAllConfigAccounts, } from '@hubspot/local-dev-lib/config';
+import { getConfigFilePath, setConfigAccountAsDefault, getConfigAccountIfExists, getConfigAccountByName, getConfigAccountById, globalConfigFileExists, getAllConfigAccounts, } from '@hubspot/local-dev-lib/config';
 import { getDefaultAccountOverrideAccountId, getDefaultAccountOverrideFilePath, } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
+import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
-import { selectAccountFromConfig } from '../../lib/prompts/accountsPrompt.js';
+import { selectAccountFromConfig, AUTHENTICATE_NEW_ACCOUNT_VALUE, } from '../../lib/prompts/accountsPrompt.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { authenticateNewAccount } from '../../lib/accountAuth.js';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 const command = 'use [account]';
 const describe = commands.account.subcommands.use.describe;
 async function handler(args) {
     let newDefaultAccount = args.account;
+    const usingGlobalConfig = globalConfigFileExists();
     if (!newDefaultAccount) {
-        newDefaultAccount = await selectAccountFromConfig();
+        newDefaultAccount = await selectAccountFromConfig('', usingGlobalConfig);
     }
     else {
         const account = getConfigAccountIfExists(newDefaultAccount);
         if (!account) {
             uiLogger.error(commands.account.subcommands.use.errors.accountNotFound(newDefaultAccount, getConfigFilePath()));
-            newDefaultAccount = await selectAccountFromConfig();
+            newDefaultAccount = await selectAccountFromConfig('', usingGlobalConfig);
         }
     }
+    if (newDefaultAccount === AUTHENTICATE_NEW_ACCOUNT_VALUE) {
+        const updatedConfig = await authenticateNewAccount({
+            env: args.qa ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD,
+            setAsDefaultAccount: true,
+        });
+        if (!updatedConfig) {
+            process.exit(EXIT_CODES.ERROR);
+        }
+        trackCommandUsage('accounts-use', undefined, updatedConfig.accountId);
+        return;
+    }
     let account;
     if (!isNaN(Number(newDefaultAccount))) {
         account = getConfigAccountById(Number(newDefaultAccount));

package/commands/cms/module/marketplace-validate.js

@@ -1,9 +1,10 @@
 import SpinniesManager from '../../../lib/ui/SpinniesManager.js';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
-import { kickOffValidation, pollForValidationFinish, fetchValidationResults, processValidationErrors, displayValidationResults, } from '../../../lib/marketplaceValidate.js';
+import { kickOffValidation, pollForValidationFinish, fetchValidationResults, hasProcessValidationErrors, displayValidationResults, } from '../../../lib/marketplaceValidate.js';
 import { commands } from '../../../lang/en.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
+import { logError } from '../../../lib/errorHandlers/index.js';
 const command = 'marketplace-validate <src>';
 const describe = commands.cms.subcommands.module.subcommands.marketplaceValidate.describe;
 async function handler(args) {
@@ -13,12 +14,29 @@ async function handler(args) {
         text: commands.cms.subcommands.module.subcommands.marketplaceValidate.logs.validatingModule(src),
     });
     const assetType = 'MODULE';
-    const validationId = await kickOffValidation(derivedAccountId, assetType, src);
-    await pollForValidationFinish(derivedAccountId, validationId);
+    let validationId;
+    try {
+        validationId = await kickOffValidation(derivedAccountId, assetType, src);
+        await pollForValidationFinish(derivedAccountId, validationId);
+    }
+    catch (e) {
+        logError(e);
+        process.exit(EXIT_CODES.ERROR);
+    }
     SpinniesManager.remove('marketplaceValidation');
-    const validationResults = await fetchValidationResults(derivedAccountId, validationId);
-    processValidationErrors(commands.cms.subcommands.module.subcommands.marketplaceValidate.errors
+    let validationResults;
+    try {
+        validationResults = await fetchValidationResults(derivedAccountId, validationId);
+    }
+    catch (e) {
+        logError(e);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const hasErrors = hasProcessValidationErrors(commands.cms.subcommands.module.subcommands.marketplaceValidate.errors
         .invalidPath, validationResults);
+    if (hasErrors) {
+        process.exit(EXIT_CODES.ERROR);
+    }
     displayValidationResults(commands.cms.subcommands.module.subcommands.marketplaceValidate.results, validationResults);
     process.exit(EXIT_CODES.SUCCESS);
 }

package/commands/cms/theme/marketplace-validate.js

@@ -1,8 +1,10 @@
 import SpinniesManager from '../../../lib/ui/SpinniesManager.js';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
-import { kickOffValidation, pollForValidationFinish, fetchValidationResults, processValidationErrors, displayValidationResults, } from '../../../lib/marketplaceValidate.js';
+import { kickOffValidation, pollForValidationFinish, fetchValidationResults, hasProcessValidationErrors, displayValidationResults, } from '../../../lib/marketplaceValidate.js';
 import { commands } from '../../../lang/en.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
+import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
+import { logError } from '../../../lib/errorHandlers/index.js';
 const command = 'marketplace-validate <path>';
 const describe = commands.cms.subcommands.theme.subcommands.marketplaceValidate.describe;
 async function handler(args) {
@@ -12,14 +14,31 @@ async function handler(args) {
         text: commands.cms.subcommands.theme.subcommands.marketplaceValidate.logs.validatingTheme(path),
     });
     const assetType = 'THEME';
-    const validationId = await kickOffValidation(derivedAccountId, assetType, path);
-    await pollForValidationFinish(derivedAccountId, validationId);
+    let validationId;
+    try {
+        validationId = await kickOffValidation(derivedAccountId, assetType, path);
+        await pollForValidationFinish(derivedAccountId, validationId);
+    }
+    catch (e) {
+        logError(e);
+        process.exit(EXIT_CODES.ERROR);
+    }
     SpinniesManager.remove('marketplaceValidation');
-    const validationResults = await fetchValidationResults(derivedAccountId, validationId);
-    processValidationErrors(commands.cms.subcommands.theme.subcommands.marketplaceValidate.errors
+    let validationResults;
+    try {
+        validationResults = await fetchValidationResults(derivedAccountId, validationId);
+    }
+    catch (e) {
+        logError(e);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const hasErrors = hasProcessValidationErrors(commands.cms.subcommands.theme.subcommands.marketplaceValidate.errors
         .invalidPath, validationResults);
+    if (hasErrors) {
+        process.exit(EXIT_CODES.ERROR);
+    }
     displayValidationResults(commands.cms.subcommands.theme.subcommands.marketplaceValidate.results, validationResults);
-    process.exit();
+    process.exit(EXIT_CODES.SUCCESS);
 }
 function themeValidateBuilder(yargs) {
     yargs.positional('path', {

package/commands/mcp/setup.js

@@ -6,9 +6,8 @@ import { addMcpServerToConfig, supportedTools } from '../../lib/mcp/setup.js';
 import { trackCommandUsage } from '../../lib/usageTracking.js';
 import { hasFeature } from '../../lib/hasFeature.js';
 import { FEATURES } from '../../lib/constants.js';
-import { uiBetaTag } from '../../lib/ui/index.js';
 const command = ['setup'];
-const describe = uiBetaTag(commands.mcp.setup.describe, false);
+const describe = commands.mcp.setup.describe;
 async function handler(args) {
     const { derivedAccountId } = args;
     const hasMcpAccess = await hasFeature(derivedAccountId, FEATURES.MCP_ACCESS);

package/commands/mcp.js

@@ -2,9 +2,8 @@ import startCommand from './mcp/start.js';
 import setupCommand from './mcp/setup.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { commands } from '../lang/en.js';
-import { uiBetaTag } from '../lib/ui/index.js';
 const command = 'mcp';
-const describe = uiBetaTag(commands.mcp.describe, false);
+const describe = commands.mcp.describe;
 function mcpBuilder(yargs) {
     yargs.command(startCommand).command(setupCommand).demandCommand(1, '');
     return yargs;

package/commands/project.js

@@ -1,4 +1,5 @@
-import { commands } from '../lang/en.js';
+import { pkg } from '../lib/jsonLoader.js';
+import { commands, lib } from '../lang/en.js';
 import deploy from './project/deploy.js';
 import create from './project/create.js';
 import upload from './project/upload.js';
@@ -17,9 +18,29 @@ import profile from './project/profile.js';
 import projectValidate from './project/validate.js';
 import list from './project/list.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
+import { getProjectConfig } from '../lib/projects/config.js';
+import { isUnsupportedPlatformVersion, LATEST_SUPPORTED_PLATFORM_VERSION, } from '../lib/projects/platformVersion.js';
+import { uiLogger } from '../lib/ui/logger.js';
+import { debugError } from '../lib/errorHandlers/index.js';
 const command = ['project', 'projects'];
 const describe = commands.project.describe;
+// Warn users when they are interacting with a version of projects that this version of
+// the CLI is not officially compatible with
+async function validatePlatformVersion() {
+    try {
+        const { projectConfig } = await getProjectConfig();
+        if (isUnsupportedPlatformVersion(projectConfig?.platformVersion)) {
+            uiLogger.warn(lib.projects.platformVersion.unsupported(pkg.version, LATEST_SUPPORTED_PLATFORM_VERSION, projectConfig?.platformVersion));
+            uiLogger.log('');
+        }
+    }
+    catch (error) {
+        // Silently fail. We don't want this to interrupt command execution
+        debugError(error);
+    }
+}
 function projectBuilder(yargs) {
+    yargs.middleware([validatePlatformVersion]);
     yargs
         .command(create)
         .command(add)

package/lang/en.d.ts

@@ -34,6 +34,15 @@ export declare const commands: {
             installingDependenciesIn: (installPath: string) => string;
             createdProjectSuccess: (projectName: string, projectDest: string) => string;
             pressEnterToContinueDeploy: (accountName: string) => string;
+            uploadingProject: string;
+            uploadSuccess: string;
+            appDeployedReady: string;
+            appConfigDetails: string;
+            distribution: string;
+            authType: string;
+            checkOutConfig: (configPath: string) => string;
+            pressEnterToInstall: (accountName: string) => string;
+            pressKeyToExit: string;
             prompts: {
                 selectOptionV2: string;
                 options: {
@@ -75,10 +84,15 @@ export declare const commands: {
             uploadingProject: string;
             uploadSuccess: string;
             developerOverviewLink: string;
+            initialUploadMessage: string;
         };
         errors: {
             uploadFailed: string;
             configFileNotFound: string;
+            noAppsFound: string;
+            uploadActionFailed: string;
+            buildOrDeployFailed: string;
+            failedToUploadAndDeploy: string;
         };
     };
     completion: {
@@ -154,6 +168,7 @@ export declare const commands: {
                     };
                 };
                 promptMessage: string;
+                authenticateNewAccount: string;
                 success: {
                     defaultAccountUpdated: (accountName: string) => string;
                 };
@@ -1255,6 +1270,7 @@ export declare const commands: {
                 codexNotFound: string;
                 codexInstallFailed: string;
                 configuringCursor: string;
+                cursorNotFound: string;
                 failedToConfigureCursor: string;
                 configuredCursor: string;
                 configuringGemini: string;
@@ -1263,6 +1279,7 @@ export declare const commands: {
                 geminiInstallFailed: string;
                 alreadyInstalled: string;
                 configuringWindsurf: string;
+                windsurfNotFound: string;
                 failedToConfigureWindsurf: string;
                 configuredWindsurf: string;
                 configuringVsCode: string;
@@ -1642,6 +1659,7 @@ export declare const commands: {
                 noFunctionWithName: (name: string) => string;
                 functionNotDeployed: (name: string) => string;
                 projectLogsManagerNotInitialized: string;
+                noDeployedBuild: string;
                 generic: string;
             };
             logs: {
@@ -3093,13 +3111,16 @@ export declare const lib: {
         };
         validateProjectConfig: {
             configNotFound: string;
-            configMissingFields: string;
+            configMissingFields: (missingFields: string[]) => string;
             srcDirNotFound: (srcDir: string, projectDir: string) => string;
             srcOutsideProjectDir: (projectConfig: string, srcDir: string) => string;
         };
         getProjectConfig: {
             error: string;
         };
+        platformVersion: {
+            unsupported: (currentCliVersion: string, latestSupported: string, platformVersion?: string) => string;
+        };
         ensureProjectExists: {
             createPrompt: (projectName: string, accountIdentifier: string) => string;
             createPromptUpload: (projectName: string, accountIdentifier: string) => string;

package/lang/en.js

@@ -42,6 +42,15 @@ export const commands = {
             installingDependenciesIn: (installPath) => `Installing dependencies in ${installPath}`,
             createdProjectSuccess: (projectName, projectDest) => `[SUCCESS] Project ${chalk.bold(projectName)} was successfully created in ${projectDest}`,
             pressEnterToContinueDeploy: (accountName) => `Press ${chalk.bold('<enter>')} to deploy this project to ${chalk.bold(accountName)} ...`,
+            uploadingProject: `Running \`${uiCommandReference('hs project upload', false)}\` to upload and deploy your project...`,
+            uploadSuccess: '✓ Upload and deploy complete!',
+            appDeployedReady: '🚀 Your new app is now deployed on HubSpot and ready to install!',
+            appConfigDetails: 'App configuration details:',
+            distribution: 'distribution',
+            authType: 'auth type',
+            checkOutConfig: (configPath) => `Check out ${chalk.cyan(configPath)} for the full configuration.`,
+            pressEnterToInstall: (accountName) => `? Press ${chalk.bold('<enter>')} to continue installing and previewing this app in ${chalk.bold(accountName)}`,
+            pressKeyToExit: `Press any key to exit...`,
             prompts: {
                 selectOptionV2: 'Choose a component type to get started',
                 options: {
@@ -83,10 +92,15 @@ export const commands = {
             uploadingProject: 'Uploading your project to HubSpot...',
             uploadSuccess: 'Project uploaded successfully!',
             developerOverviewLink: 'Open this link to navigate to your HubSpot developer portal',
+            initialUploadMessage: 'Initial upload from get-started command',
         },
         errors: {
             uploadFailed: 'Failed to upload project to HubSpot.',
             configFileNotFound: 'Could not find project configuration for upload.',
+            noAppsFound: 'No apps found after deployment.',
+            uploadActionFailed: 'Upload failed',
+            buildOrDeployFailed: 'Build or deploy failed',
+            failedToUploadAndDeploy: 'Failed to upload and deploy project',
         },
     },
     completion: {
@@ -162,6 +176,7 @@ export const commands = {
                     },
                 },
                 promptMessage: 'Select an account to use as the default',
+                authenticateNewAccount: '<Authenticate a new account>',
                 success: {
                     defaultAccountUpdated: (accountName) => `Default account updated to "${accountName}"`,
                 },
@@ -1259,32 +1274,34 @@ export const commands = {
                 // Claude
                 configuringClaudeCode: 'Configuring Claude Code...',
                 configuredClaudeCode: 'Configured Claude Code',
-                claudeCodeNotFound: 'Claude Code not found - skipping configuration',
+                claudeCodeNotFound: "Claude Code is not installed (missing 'claude' command). Install it and re-run hs mcp setup.",
                 claudeCodeInstallFailed: 'Claude Code CLI not working - skipping configuration',
                 // Codex
                 configuringCodex: 'Configuring Codex...',
                 configuredCodex: 'Configured Codex',
-                codexNotFound: 'Codex command not found - skipping configuration',
+                codexNotFound: "Codex CLI is not installed (missing 'codex' command). Install it and re-run hs mcp setup.",
                 codexInstallFailed: 'Failed to configure Codex',
                 // Cursor
                 configuringCursor: 'Configuring Cursor...',
+                cursorNotFound: 'Cursor is not installed. Install it and re-run hs mcp setup.',
                 failedToConfigureCursor: 'Failed to configure Cursor',
                 configuredCursor: 'Configured Cursor',
                 // Gemini
                 configuringGemini: 'Configuring Gemini CLI...',
                 configuredGemini: 'Configured Gemini CLI',
-                geminiNotFound: 'Gemini CLI not found - skipping configuration',
+                geminiNotFound: "Gemini CLI is not installed (missing 'gemini' command). Install it and re-run hs mcp setup.",
                 geminiInstallFailed: 'Failed to configure Gemini CLI',
                 alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
                 // Windsurf
                 configuringWindsurf: 'Configuring Windsurf...',
+                windsurfNotFound: 'Windsurf is not installed. Install it and re-run hs mcp setup.',
                 failedToConfigureWindsurf: 'Failed to configure Windsurf',
                 configuredWindsurf: 'Configured Windsurf',
                 // VS Code
                 configuringVsCode: 'Configuring VSCode...',
                 failedToConfigureVsCode: 'Failed to configure VSCode',
                 configuredVsCode: 'Configured VSCode',
-                vsCodeNotFound: 'VSCode not found - skipping configuration',
+                vsCodeNotFound: "VSCode CLI is not installed (missing 'code' command). Install it and re-run hs mcp setup.",
             },
             prompts: {
                 targets: '[--client] Which tools would you like to add the HubSpot CLI MCP server to?',
@@ -1658,6 +1675,7 @@ export const commands = {
                 noFunctionWithName: (name) => `No function with name "${name}"`,
                 functionNotDeployed: (name) => `The function with name "${name}" is not deployed`,
                 projectLogsManagerNotInitialized: 'Function called on ProjectLogsManager before initialization',
+                noDeployedBuild: 'This project has not been deployed yet. Deploy the project first, then try again.',
                 generic: 'Error fetching logs',
             },
             logs: {
@@ -3116,13 +3134,16 @@ export const lib = {
         },
         validateProjectConfig: {
             configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${uiCommandReference('hs project create')} to create a new project.`,
-            configMissingFields: 'The project configuration file is missing required fields.',
+            configMissingFields: (missingFields) => `The project configuration file is missing required field${missingFields.length > 1 ? 's' : ''}: ${missingFields.map(f => chalk.bold(f)).join(', ')}`,
             srcDirNotFound: (srcDir, projectDir) => `Project source directory ${chalk.bold(srcDir)} could not be found in ${chalk.bold(projectDir)}.`,
             srcOutsideProjectDir: (projectConfig, srcDir) => `Invalid value for 'srcDir' in ${projectConfig}: ${chalk.bold(`srcDir: "${srcDir}"`)}\n\t'srcDir' must be a relative path to a folder under the project root, such as "." or "./src"`,
         },
         getProjectConfig: {
             error: 'Could not read from project config',
         },
+        platformVersion: {
+            unsupported: (currentCliVersion, latestSupported, platformVersion) => `Platform version${platformVersion ? ' ' + chalk.bold(platformVersion) : ''} is not officially supported by this version of the CLI (${chalk.bold(currentCliVersion)}).\n\nUpdate your CLI to the latest version with ${uiCommandReference('hs upgrade')} or use a compatible platform version (${chalk.bold(latestSupported)} or earlier).`,
+        },
         ensureProjectExists: {
             createPrompt: (projectName, accountIdentifier) => `The project ${projectName} does not exist in ${accountIdentifier}. Would you like to create it?`,
             createPromptUpload: (projectName, accountIdentifier) => `[--forceCreate] The project ${projectName} does not exist in ${accountIdentifier}. Would you like to create it?`,

package/lib/__tests__/accountAuth.test.d.ts

@@ -0,0 +1 @@
+export {};