@hubspot/cli 7.11.8-experimental.0 → 8.0.0-beta.1

package/lang/en.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { mapToUserFriendlyName } from '@hubspot/project-parsing-lib';
+import { mapToUserFriendlyName } from '@hubspot/project-parsing-lib/transform';
 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';
@@ -10,9 +10,6 @@ import { APP_DISTRIBUTION_TYPES, APP_AUTH_TYPES, PROJECT_CONFIG_FILE, PROJECT_WI
 export const commands = {
     generalErrors: {
         srcIsProject: (src, command) => `"${src}" is in a project folder. Did you mean "hs project ${command}"?`,
-        handleDeprecatedEnvVariables: {
-            portalEnvVarDeprecated: 'The HUBSPOT_PORTAL_ID environment variable is deprecated. Please use HUBSPOT_ACCOUNT_ID instead.',
-        },
         validateConfigMiddleware: {
             missingConfigFile: `A HubSpot config file is required to run this command, but none was found. To create a new config file and authenticate a HubSpot account, run ${uiCommandReference('hs account auth')}`,
             configValidationFailed: (errors) => `Your HubSpot config file is invalid. Please fix the following errors:\n - ${errors.join('\n- ')}`,
@@ -419,7 +416,6 @@ export const commands = {
                             dest: 'Path in HubSpot Design Tools. Can be a net new path. If you wish to preview a site page using your theme changes it must match the path of the theme used by the site.',
                         },
                         options: {
-                            notify: 'Log to specified file when a watch task is triggered and after workers have gone idle. Ex. --notify path/to/file',
                             noSsl: 'Disable HTTPS',
                             port: 'The port on which to start the local server',
                         },
@@ -1026,6 +1022,27 @@ export const commands = {
         },
         outputWritten: (filename) => `Output written to ${chalk.bold(filename)}`,
     },
+    upgrade: {
+        describe: 'Install the latest version of the HubSpot CLI, or a specific version.',
+        options: {
+            version: 'Specific version to install (defaults to latest)',
+            force: 'Skip confirmation prompt and install immediately',
+            beta: 'Install the next version of the HubSpot CLI (beta)',
+        },
+        alreadyLatest: (version, beta) => `You are already running the latest ${beta ? 'beta ' : ''}version (${chalk.bold(version)}).`,
+        alreadyOnVersion: (current) => `You are already running version ${chalk.bold(current)}`,
+        autoUpgradeNotAvailable: (version) => `Unable to auto-upgrade the HubSpot CLI. You can manually install ${chalk.bold(`@hubspot/cli@${version}`)}`,
+        confirmPrompt: (current, version) => `Upgrade from ${current} to version ${version}?`,
+        cancelled: 'Upgrade cancelled.',
+        installing: (version) => `Installing @hubspot/cli@${version}...`,
+        success: (version) => `Successfully installed @hubspot/cli@${version}`,
+        autoUpgradeMessage: `The HubSpot CLI supports automatic updates as an optional feature.\n\nWhen enabled, the CLI will automatically install non-breaking updates within the current major version. Major releases will always require manual upgrades.\n\nRun ${uiCommandReference('hs config set --allow-auto-updates=true')}\n\nYou can change this later at any time with ${uiCommandReference('hs config set')}`,
+        errors: {
+            unableToDetermineLatestVersion: 'Unable to determine the latest version of the HubSpot CLI. Please try again later.',
+            installFailed: 'Failed to install the CLI. Verify that the target version is available and try again.',
+            generic: 'An error occurred while upgrading the CLI.',
+        },
+    },
     filemanager: {
         describe: 'Commands for managing files in the File Manager.',
         subcommands: {
@@ -1198,16 +1215,16 @@ export const commands = {
             codex: 'Codex CLI',
             claudeCode: 'Claude Code',
             cursor: 'Cursor',
+            gemini: 'Gemini CLI',
             windsurf: 'Windsurf',
             vsCode: 'VSCode',
             args: {
-                client: 'Target applications to configure',
+                client: 'Target apps to configure',
                 docsSearch: 'Should the docs search mcp server be installed',
             },
             success: (derivedTargets) => `You can now use the HubSpot CLI MCP Server in ${derivedTargets.join(', ')}.  ${chalk.bold('You may need to restart these tools to apply the changes')}.`,
             errors: {
                 needsMcpAccess: (accountId) => `You must opt in to the developer MCP beta to use this feature on ${uiAccountDescription(accountId)}. Try again with a different account or ${uiLink('join the beta now', getProductUpdatesUrl('239890', accountId))}`,
-                needsNode20: `This feature requires node >=20`,
                 errorParsingJsonFIle: (filename, errorMessage) => `Unable to update ${chalk.bold(filename)} due to invalid JSON: ${errorMessage}`,
             },
             spinners: {
@@ -1226,6 +1243,11 @@ export const commands = {
                 configuringCursor: 'Configuring Cursor...',
                 failedToConfigureCursor: 'Failed to configure Cursor',
                 configuredCursor: 'Configured Cursor',
+                // Gemini
+                configuringGemini: 'Configuring Gemini CLI...',
+                configuredGemini: 'Configured Gemini CLI',
+                geminiNotFound: 'Gemini CLI not found - skipping configuration',
+                geminiInstallFailed: 'Failed to configure Gemini CLI',
                 alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
                 // Windsurf
                 configuringWindsurf: 'Configuring Windsurf...',
@@ -1239,12 +1261,11 @@ export const commands = {
             },
             prompts: {
                 targets: '[--client] Which tools would you like to add the HubSpot CLI MCP server to?',
-                targetsRequired: 'Must choose at least one application to configure.',
+                targetsRequired: 'Must choose at least one app to configure.',
             },
         },
         start: {
             errors: {
-                needsNode20: `This feature requires node >=20`,
                 serverFileNotFound: (serverPath) => `MCP server file not found at ${serverPath}`,
                 failedToStart: 'Failed to start MCP server',
             },
@@ -1364,6 +1385,9 @@ export const commands = {
             examples: {
                 default: 'Start local dev for the current project',
             },
+            prompts: {
+                selectProfile: '[--profile] Select a profile to use for local development',
+            },
             options: {
                 profile: 'The profile to target during local dev',
                 projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account. Supported on platform versions 2025.2 and newer.',
@@ -1417,7 +1441,7 @@ export const commands = {
                     describe: 'How the app will be distributed.',
                 },
                 auth: {
-                    describe: 'Authentication model for the application.',
+                    describe: 'Authentication model for the app.',
                 },
                 features: {
                     describe: `Features to include in the project. Only valid if project-base is ${PROJECT_WITH_APP}`,
@@ -1515,13 +1539,13 @@ export const commands = {
                     describe: "The path to the component type's location within the hubspot-project-components Github repo: https://github.com/HubSpot/hubspot-project-components",
                 },
                 distribution: {
-                    describe: 'The distribution method for the application.',
+                    describe: 'The distribution method for the app.',
                 },
                 auth: {
-                    describe: 'The authentication type for the application.',
+                    describe: 'The authentication type for the app.',
                 },
                 features: {
-                    describe: 'Which features to include with the application.',
+                    describe: 'Which features to include with the app.',
                 },
             },
             creatingComponent: (projectName) => `Adding feature(s) to app [${chalk.bold(projectName)}]\n`,
@@ -1565,6 +1589,7 @@ export const commands = {
             examples: {
                 default: 'Deploy the latest build of the current project',
                 withOptions: 'Deploy build 5 of the project my-project',
+                withProfile: 'Deploy using the provided profile',
             },
             options: {
                 build: 'Project build ID to be deployed',
@@ -1647,6 +1672,7 @@ export const commands = {
             describe: 'Upload your project files and create a new build.',
             examples: {
                 default: 'Upload a project into your HubSpot account',
+                withProfile: 'Upload a project into your HubSpot account when using profiles',
             },
             logs: {
                 buildSucceeded: (buildId) => `Build #${buildId} succeeded\n`,
@@ -1825,12 +1851,23 @@ export const commands = {
             badVersion: 'This command is only available for projects 2025.2 and later.',
             examples: {
                 default: 'Validate the project before uploading',
+                withProfile: 'Validate the project with a profile before uploading.',
             },
             success: (projectName) => `Project ${projectName} is valid and ready to upload`,
-            failure: (projectName) => `Project ${projectName} is invalid`,
+            failure: (projectName, profileName) => `Project ${projectName} is invalid${profileName ? ` with profile "${profileName}" applied` : ''}`,
+            failureWithProfile: (profileName) => chalk.bold(`With profile "${profileName}":`),
+            spinners: {
+                validatingProfile: (profileName) => `Validating project with profile "${profileName}"`,
+                profileValidationFailed: (profileName) => `Profile "${profileName}" failed validation`,
+                profileValidationSucceeded: (profileName) => `Project valid with profile "${profileName}" applied`,
+                invalidWithProfile: (profileName) => `Project is invalid with profile "${profileName}" applied`,
+                validatingAllProfiles: 'Validating the project with all profiles',
+                allProfilesValidationSucceeded: 'Project profile validation succeeded',
+                allProfilesValidationFailed: 'Project profile validation failed',
+            },
             options: {
                 profile: {
-                    describe: 'The profile to target for this validation',
+                    describe: 'The profile to target for this validation.  If no profile is provided, all profiles will be validated.',
                 },
             },
         },
@@ -2149,7 +2186,7 @@ export const commands = {
             polling: {
                 start: (testAccountName) => `Creating test account "${chalk.bold(testAccountName)}"...`,
                 syncing: 'Test account created! Syncing account data... (may take a few minutes - you can exit and the sync will continue)',
-                success: (testAccountName, testAccountId) => `Test account "${chalk.bold(testAccountName)}" successfully created with id: ${chalk.bold(testAccountId)}`,
+                success: (testAccountName, testAccountId, parentAccountId) => `Test account "${chalk.bold(testAccountName)}" successfully created with id ${chalk.bold(testAccountId)} under parent account ${uiAccountDescription(parentAccountId)}`,
                 createFailure: 'Failed to create test account.',
             },
             options: {
@@ -2161,6 +2198,7 @@ export const commands = {
                 serviceLevel: 'Service Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
                 salesLevel: 'Sales Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
                 contentLevel: 'CMS Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
+                commerceLevel: 'Commerce Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
             },
             example: (configPath) => `Create a test account from the config file at ${configPath}`,
             examples: {
@@ -2171,7 +2209,7 @@ export const commands = {
         },
         createConfig: {
             describe: 'Create a test account config file.',
-            pathPrompt: '[--path] Enter the name of the Test Account config file: ',
+            pathPrompt: '[--path] Enter the name of the test account config file: ',
             errors: {
                 pathError: 'Path is required',
                 pathFormatError: 'Path must end with .json',
@@ -2869,6 +2907,12 @@ export const lib = {
             startError: (message) => `Failed to start local dev server: ${message}`,
             fileChangeError: (message) => `Failed to notify local dev server of file change: ${message}`,
         },
+        devSession: {
+            registrationError: (message) => `Failed to register dev session: ${message}`,
+            missingSessionIdError: 'Failed to connect to dev session: Missing session ID. Please try creating a new dev session.',
+            heartbeatError: (message) => `Failed to send dev session heartbeat: ${message}`,
+            deletionError: (message) => `Failed to delete dev session: ${message}`,
+        },
     },
     AppDevModeInterface: {
         autoInstallStaticAuthApp: {
@@ -2956,7 +3000,7 @@ export const lib = {
                 privateApp: `This project contains a private app. Local development of private apps is not supported in developer accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
             },
             validateAccountOption: {
-                invalidPublicAppAccount: `This project contains a public app. The "--account" flag must point to a developer test account to develop this project locally. Alternatively, change your default account to an App Developer Account using ${uiCommandReference('hs account use')} and run ${uiCommandReference('hs project dev')} to set up a new Developer Test Account.`,
+                invalidPublicAppAccount: `This project contains a public app. The "--account" flag must point to a developer test account to develop this project locally. Alternatively, change your default account to an app developer account using ${uiCommandReference('hs account use')} and run ${uiCommandReference('hs project dev')} to set up a new developer test account.`,
                 invalidPrivateAppAccount: `This project contains a private app. The account specified with the "--account" flag points to a developer account, which do not support the local development of private apps. Update the "--account" flag to point to a standard, sandbox, or developer test account, or change your default account by running ${uiCommandReference('hs account use')}.`,
                 nonSandboxWarning: `Testing in a sandbox is strongly recommended. To switch the target account, select an option below or run ${uiCommandReference('hs account use')} before running the command again.`,
                 publicAppNonDeveloperTestAccountWarning: `Local development of public apps is only supported in ${chalk.bold('developer test accounts')}.`,
@@ -2979,7 +3023,7 @@ export const lib = {
     },
     middleware: {
         updateNotification: {
-            notifyTitle: chalk.bold('CLI update available'),
+            notifyTitle: chalk.bold('Update available'),
             cmsUpdateNotification: (packageName) => `${chalk.bold('The CMS CLI is now the HubSpot CLI')}\n\nTo upgrade, uninstall ${chalk.bold(packageName)}\nand then run ${uiCommandReference('{updateCommand}')}`,
             cliUpdateNotification: (currentVersion, updateCommand, latestVersion) => `HubSpot CLI version ${chalk.cyan(chalk.bold(`${currentVersion}`))} is outdated.\nRun ${uiCommandReference(`${updateCommand}`)} to upgrade to version ${chalk.cyan(chalk.bold(`${latestVersion}`))}`,
         },
@@ -2988,6 +3032,7 @@ export const lib = {
             updateSucceeded: (latestVersion) => `Successfully updated HubSpot CLI to version ${chalk.bold(latestVersion)}`,
             notInstalledGlobally: 'Cannot auto-update the HubSpot CLI because NPM is not installed globally',
             updateFailed: (latestVersion) => `Failed to update HubSpot CLI to version ${chalk.bold(latestVersion)}`,
+            enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun${uiCommandReference('hs config set --allow-auto-updates=true')}`,
         },
     },
     projectProfiles: {
@@ -3006,7 +3051,9 @@ export const lib = {
                 noProjectConfig: 'No project config found. Please run this command from a project directory.',
                 profileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} not found.`,
                 missingAccountId: (profileName) => `Profile ${chalk.bold(profileName)} is missing an account id.`,
+                listedAccountNotFound: (accountId, profileName) => `The account ${uiAccountDescription(accountId)} is defined in your profile ${chalk.bold(profileName)}, but is missing in your config file`,
                 failedToLoadProfile: (profileName) => `Failed to load profile ${chalk.bold(profileName)}.`,
+                profileNotValid: (profileName, errors) => `${chalk.bold(`With profile "${profileName}"`)}:\n\t- ${errors.join('\n\t- ')}`,
             },
         },
     },
@@ -3015,7 +3062,7 @@ export const lib = {
             prompt: {
                 marketPlaceDistribution: 'On the HubSpot marketplace',
                 privateDistribution: 'Privately',
-                distribution: '[--distribution] Choose how to distribute your application:',
+                distribution: '[--distribution] Choose how to distribute your app:',
                 auth: '[--auth] Choose your authentication type:',
                 staticAuth: 'Static Auth',
                 oauth: 'OAuth',
@@ -3342,10 +3389,10 @@ export const lib = {
             keepingCurrentDefault: (accountName) => `Account "${accountName}" will continue to be the default account`,
         },
         createDeveloperTestAccountConfigPrompt: {
-            namePrompt: (withFlag = true) => `${withFlag ? '[--name] ' : ''}Enter the name of the Test Account:`,
-            descriptionPrompt: (withFlag = true) => `${withFlag ? '[--description] ' : ''}Enter the description of the Test Account:`,
+            namePrompt: (withFlag = true) => `${withFlag ? '[--name] ' : ''}Enter the name of the test account:`,
+            descriptionPrompt: (withFlag = true) => `${withFlag ? '[--description] ' : ''}Enter the description of the test account:`,
             useDefaultAccountLevelsPrompt: {
-                message: 'Would you like to create a default Test Account, or customize your own?',
+                message: 'Would you like to create a default test account, or customize your own?',
                 default: 'Default (All Hubs, ENTERPRISE)',
                 manual: 'Customize my own',
             },
@@ -3356,11 +3403,12 @@ export const lib = {
                 service: 'Service',
                 sales: 'Sales',
                 content: 'Content',
+                commerce: 'Commerce',
             },
             errors: {
                 allHubsRequired: 'Select a tier for each hub',
                 tiersError: 'Cannot have more than one tier per hub',
-                nameRequired: 'The name may not be blank. Please add a name for the Test Account.',
+                nameRequired: 'The name may not be blank. Please add a name for the test account.',
             },
         },
         accountNamePrompt: {
@@ -3739,7 +3787,7 @@ export const lib = {
             notLatestSecondary: (command, hsVersion) => `Run ${uiCommandReference(command)} to upgrade to the latest version ${hsVersion}`,
             latest: (hsVersion) => `HubSpot CLI v${hsVersion} up to date`,
             unableToDetermine: 'Unable to determine if HubSpot CLI is up to date.',
-            unableToDetermineSecondary: (command, link) => `Run ${uiCommandReference(command)} to check your installed version; then visit the ${uiLink('npm HubSpot CLI version history', link)} to validate whether you have the latest version`,
+            unableToDetermineSecondary: (link) => `Run ${uiCommandReference('hs --version')} to check your installed version; then visit the ${uiLink('npm HubSpot CLI version history', link)} to validate whether you have the latest version`,
         },
         projectDependenciesChecks: {
             missingDependencies: (dir) => `missing dependencies in ${chalk.bold(dir)}`,
@@ -3753,9 +3801,18 @@ export const lib = {
         },
         port: {
             inUse: (port) => `Port ${port} is in use`,
-            inUseSecondary: (command) => `Make sure it is available before running ${uiCommandReference(command)}`,
+            inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}`,
             available: (port) => `Port ${port} available for local development`,
         },
+        projectValidation: {
+            valid: 'Project configuration and structure is valid',
+            configInvalid: 'Project configuration is invalid',
+            configMissing: 'Project configuration file not found',
+            sourceDirectoryInvalid: 'Project source directory validation failed',
+            translationFailed: 'Project validation failed',
+            profileValidationFailed: (profileName) => `Project validation failed with profile '${profileName}' applied`,
+            validationDetails: `Run ${uiCommandReference('hs project validate')} for more details.`,
+        },
         diagnosis: {
             cli: {
                 header: 'HubSpot CLI install',
@@ -3784,6 +3841,28 @@ export const lib = {
                 warnings: (count) => `${chalk.bold('Warning:')} ${count}`,
             },
         },
+        networkChecks: {
+            header: 'Network & API connectivity',
+            hubspotApiReachable: 'HubSpot API is reachable',
+            hubspotApiUnreachable: 'Unable to connect to HubSpot API',
+            hubspotApiUnreachableSecondary: 'Check your internet connection and firewall settings',
+            npmRegistryReachable: 'npm registry is reachable',
+            npmRegistryUnreachable: 'Unable to connect to npm registry',
+            npmRegistryUnreachableSecondary: 'Check your internet connection and npm configuration',
+        },
+        webhookChecks: {
+            header: 'Webhook endpoints',
+            endpointReachable: (url) => `Webhook endpoint reachable: ${url}`,
+            endpointUnreachable: (url) => `Webhook endpoint unreachable: ${url}`,
+            endpointUnreachableSecondary: 'Verify the URL is correct and the server is running',
+            checkType: 'Webhook',
+        },
+        appRedirectChecks: {
+            redirectUrlReachable: (url) => `App redirect URL reachable: ${url}`,
+            redirectUrlUnreachable: (url) => `App redirect URL unreachable: ${url}`,
+            redirectUrlUnreachableSecondary: 'Verify the URL is correct and the server is running',
+            checkType: 'App redirect URL',
+        },
         defaultAccountOverrideFileChecks: {
             overrideActive: (defaultAccountOverrideFile) => `Default account override file is active: ${defaultAccountOverrideFile}`,
             overrideAccountId: (overrideAccountId) => `Active account ID: ${overrideAccountId}`,

package/lib/__tests__/buildAccount.test.js

@@ -11,7 +11,6 @@ vi.mock('@hubspot/local-dev-lib/personalAccessKey');
 vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('@hubspot/local-dev-lib/api/developerTestAccounts');
 vi.mock('@hubspot/local-dev-lib/api/sandboxHubs');
-vi.mock('../ui/logger.js');
 vi.mock('../errorHandlers/index.js');
 vi.mock('../prompts/personalAccessKeyPrompt');
 vi.mock('../prompts/accountNamePrompt');
@@ -65,9 +64,6 @@ describe('lib/buildAccount', () => {
             mockedGetConfigAccountIfExists.mockResolvedValue(undefined);
             mockedUpdateConfigAccount.mockReturnValue(undefined);
         });
-        afterEach(() => {
-            vi.clearAllMocks();
-        });
         it('should save account with provided personal access key', async () => {
             const result = await buildAccount.saveAccountToConfig(mockAccountConfig.accountId, mockAccountConfig.name, mockAccountConfig.env, 'test-key');
             expect(mockedPersonalAccessKeyPrompt).not.toHaveBeenCalled();
@@ -157,9 +153,6 @@ describe('lib/buildAccount', () => {
                 data: mockDeveloperTestAccount,
             });
         });
-        afterEach(() => {
-            vi.clearAllMocks();
-        });
         it('should create a developer test account successfully', async () => {
             const result = await buildAccount.buildDeveloperTestAccount(mockDeveloperTestAccount.accountName, mockParentAccountConfig, mockParentAccountConfig.env, 10);
             expect(result).toEqual(mockDeveloperTestAccount.id);
@@ -198,9 +191,6 @@ describe('lib/buildAccount', () => {
                 data: { sandbox: mockSandbox, personalAccessKey: 'test-key' },
             });
         });
-        afterEach(() => {
-            vi.clearAllMocks();
-        });
         it('should create a standard sandbox successfully', async () => {
             const result = await buildAccount.buildSandbox(mockSandbox.name, mockParentAccountConfig, HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX, mockParentAccountConfig.env, false);
             expect(result).toEqual({
@@ -254,9 +244,6 @@ describe('lib/buildAccount', () => {
                 data: { personalAccessKey: { encodedOAuthRefreshToken: 'test-key' } },
             });
         });
-        afterEach(() => {
-            vi.clearAllMocks();
-        });
         it('should create a v2 standard sandbox successfully and fetch a personal access key', async () => {
             const result = await buildAccount.buildV2Sandbox(mockSandbox.name, mockParentAccountConfig, HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX, false, mockParentAccountConfig.env, false);
             expect(result).toEqual({ sandbox: mockSandbox });

package/lib/__tests__/cliUpgradeUtils.test.js

@@ -0,0 +1,131 @@
+import updateNotifier from 'update-notifier';
+import { isCliGloballyInstalled, canCliBeAutoUpgraded, getLatestCliVersion, getCliUpgradeInfo, installCliVersion, } from '../cliUpgradeUtils.js';
+import { isGloballyInstalled, getLatestPackageVersion, executeInstall, isInstalledGloballyWithNPM, } from '../npm/npmCli.js';
+import { pkg } from '../jsonLoader.js';
+vi.mock('../npm/npmCli');
+vi.mock('update-notifier');
+vi.mock('../jsonLoader.js', () => ({
+    pkg: {
+        name: '@hubspot/cli',
+        version: '7.11.2',
+    },
+}));
+const mockedIsGloballyInstalled = vi.mocked(isGloballyInstalled);
+const mockedGetLatestPackageVersion = vi.mocked(getLatestPackageVersion);
+const mockedExecuteInstall = vi.mocked(executeInstall);
+const mockedUpdateNotifier = vi.mocked(updateNotifier);
+const mockedIsInstalledGloballyWithNPM = vi.mocked(isInstalledGloballyWithNPM);
+describe('lib/cliUpgradeUtils', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('isCliGloballyInstalled()', () => {
+        it('should return true when hs is globally installed', async () => {
+            mockedIsGloballyInstalled.mockResolvedValueOnce(true);
+            const result = await isCliGloballyInstalled();
+            expect(result).toBe(true);
+            expect(mockedIsGloballyInstalled).toHaveBeenCalledTimes(1);
+            expect(mockedIsGloballyInstalled).toHaveBeenCalledWith('hs');
+        });
+        it('should return false when hs is not globally installed', async () => {
+            mockedIsGloballyInstalled.mockResolvedValueOnce(false);
+            const result = await isCliGloballyInstalled();
+            expect(result).toBe(false);
+            expect(mockedIsGloballyInstalled).toHaveBeenCalledTimes(1);
+            expect(mockedIsGloballyInstalled).toHaveBeenCalledWith('hs');
+        });
+    });
+    describe('canCliBeAutoUpgraded()', () => {
+        it('should return true when package is installed globally via npm', async () => {
+            mockedIsInstalledGloballyWithNPM.mockResolvedValueOnce(true);
+            const result = await canCliBeAutoUpgraded();
+            expect(result).toBe(true);
+            expect(mockedIsInstalledGloballyWithNPM).toHaveBeenCalledTimes(1);
+            expect(mockedIsInstalledGloballyWithNPM).toHaveBeenCalledWith(pkg.name);
+        });
+        it('should return false when package is not installed globally via npm', async () => {
+            mockedIsInstalledGloballyWithNPM.mockResolvedValueOnce(false);
+            const result = await canCliBeAutoUpgraded();
+            expect(result).toBe(false);
+            expect(mockedIsInstalledGloballyWithNPM).toHaveBeenCalledTimes(1);
+            expect(mockedIsInstalledGloballyWithNPM).toHaveBeenCalledWith(pkg.name);
+        });
+    });
+    describe('getLatestCliVersion()', () => {
+        it('should return the latest CLI version', async () => {
+            const latest = '7.12.0';
+            const next = '7.12.0-beta.1';
+            mockedGetLatestPackageVersion.mockResolvedValueOnce({ latest, next });
+            const result = await getLatestCliVersion();
+            expect(result).toEqual({ latest, next });
+            expect(mockedGetLatestPackageVersion).toHaveBeenCalledTimes(1);
+            expect(mockedGetLatestPackageVersion).toHaveBeenCalledWith(pkg.name);
+        });
+        it('should throw errors from getLatestPackageVersion', async () => {
+            const errorMessage = 'Failed to get version';
+            mockedGetLatestPackageVersion.mockRejectedValueOnce(new Error(errorMessage));
+            await expect(getLatestCliVersion()).rejects.toThrow(errorMessage);
+            expect(mockedGetLatestPackageVersion).toHaveBeenCalledWith(pkg.name);
+        });
+    });
+    describe('getCliUpgradeInfo()', () => {
+        it('should return upgrade info when update is available', () => {
+            const mockNotifier = {
+                update: {
+                    current: '7.11.2',
+                    latest: '7.12.0',
+                    type: 'minor',
+                },
+            };
+            mockedUpdateNotifier.mockReturnValue(mockNotifier);
+            const result = getCliUpgradeInfo();
+            expect(result).toMatchObject({
+                current: '7.11.2',
+                latest: '7.12.0',
+                type: 'minor',
+            });
+            expect(mockedUpdateNotifier).toHaveBeenCalledWith({
+                pkg,
+                distTag: 'latest',
+                shouldNotifyInNpmScript: true,
+            });
+        });
+        it('should return cached info on subsequent calls', () => {
+            const mockNotifier = {
+                update: {
+                    current: '7.11.2',
+                    latest: '7.12.0',
+                    type: 'minor',
+                },
+            };
+            mockedUpdateNotifier.mockReturnValue(mockNotifier);
+            const firstCall = getCliUpgradeInfo();
+            const secondCall = getCliUpgradeInfo();
+            expect(firstCall).toEqual(secondCall);
+            expect(firstCall.current).toBe('7.11.2');
+            expect(firstCall.latest).toBe('7.12.0');
+            expect(firstCall.type).toBe('minor');
+        });
+    });
+    describe('installCliVersion()', () => {
+        it('should install latest version by default', async () => {
+            mockedExecuteInstall.mockResolvedValueOnce(undefined);
+            await installCliVersion();
+            expect(mockedExecuteInstall).toHaveBeenCalledTimes(1);
+            expect(mockedExecuteInstall).toHaveBeenCalledWith([`${pkg.name}@latest`], '-g');
+        });
+        it('should install a specific version when provided', async () => {
+            const version = '7.12.0';
+            mockedExecuteInstall.mockResolvedValueOnce(undefined);
+            await installCliVersion(version);
+            expect(mockedExecuteInstall).toHaveBeenCalledTimes(1);
+            expect(mockedExecuteInstall).toHaveBeenCalledWith([`${pkg.name}@${version}`], '-g');
+        });
+        it('should throw errors from executeInstall', async () => {
+            const errorMessage = 'Installation failed';
+            mockedExecuteInstall.mockRejectedValueOnce(new Error(errorMessage));
+            await expect(installCliVersion()).rejects.toThrow(errorMessage);
+            expect(mockedExecuteInstall).toHaveBeenCalledWith([`${pkg.name}@latest`], '-g');
+        });
+    });
+});

package/lib/__tests__/commonOpts.test.js

@@ -11,7 +11,6 @@ function buildArguments(args) {
     };
 }
 vi.mock('@hubspot/local-dev-lib/config');
-vi.mock('../../ui/logger.js');
 describe('lib/commonOpts', () => {
     describe('getCmsPublishMode()', () => {
         const accounts = {