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

package/lang/en.lyaml

@@ -2,7 +2,7 @@ en:
   commands:
     generalErrors:
       updateNotify:
-        notifyTitle: "Update available"
+        notifyTitle: "CLI update available"
         cmsUpdateNotification: "{{#bold}}The CMS CLI is now the HubSpot CLI{{/bold}}\n\nTo upgrade, uninstall {{#bold}}{{ packageName }}{{/bold}}\nand then run {{ updateCommand }}"
         cliUpdateNotification: "HubSpot CLI version {{#cyan}}{{#bold}}{currentVersion}{{/bold}}{{/cyan}} is outdated.\nRun {{ updateCommand }} to upgrade to version {{#cyan}}{{#bold}}{latestVersion}{{/bold}}{{/cyan}}"
       srcIsProject: "\"{{ src }}\" is in a project folder. Did you mean \"hs project {{command}}\"?"
@@ -801,7 +801,7 @@ en:
             uploadFailed: "Failed to upload file \"{{ filePath }}\" to \"{{ remotePath }}\""
             deleteFileFailed: "Failed to delete file \"{{ remotePath }}\""
             deleteFolderFailed: "Failed to delete folder \"{{ remotePath }}\""
-            v3ApiError: "{{ command }} is not supported for platform version '{{ platformVersion}}', use {{ newCommand }} instead to develop locally. {{ linkToDocs }}"
+            v2ApiError: "{{ command }} is not supported for platform version '{{ platformVersion}}', use {{ newCommand }} instead to develop locally. {{ linkToDocs }}"
         download:
           describe: "Download your project files from HubSpot."
           examples:

package/lib/__tests__/buildAccount.test.js

@@ -102,7 +102,7 @@ describe('lib/buildAccount', () => {
             expect(result).toBe('test-account-with-new-name');
         });
     });
-    describe('createDeveloperTestAccountV3()', () => {
+    describe('createDeveloperTestAccountV2()', () => {
         const parentAccountId = 123456;
         const mockDeveoperTestAccountConfig = {
             accountName: 'Developer Test Account',
@@ -120,7 +120,7 @@ describe('lib/buildAccount', () => {
             });
         });
         it('should create a developer test account successfully', async () => {
-            const result = await buildAccount.createDeveloperTestAccountV3(parentAccountId, mockDeveoperTestAccountConfig);
+            const result = await buildAccount.createDeveloperTestAccountV2(parentAccountId, mockDeveoperTestAccountConfig);
             expect(result).toEqual({
                 accountName: mockDeveoperTestAccountConfig.accountName,
                 accountId: 123456,

package/lib/app/migrate.js

@@ -358,6 +358,6 @@ export async function migrateApp2025_2(derivedAccountId, options, projectConfig)
 export function logInvalidAccountError() {
     uiLine();
     uiLogger.error(lib.migrate.errors.invalidAccountTypeTitle);
-    uiLogger.log(lib.migrate.errors.invalidAccountTypeDescription(uiCommandReference('hs account use'), uiCommandReference('hs auth')));
+    uiLogger.log(lib.migrate.errors.invalidAccountTypeDescription(uiCommandReference('hs account use')));
     uiLine();
 }

package/lib/buildAccount.d.ts

@@ -4,12 +4,12 @@ import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
 import { SandboxResponse, V2Sandbox } from '@hubspot/local-dev-lib/types/Sandbox';
 import { SandboxAccountType } from '../types/Sandboxes.js';
 export declare function saveAccountToConfig(accountId: number | undefined, accountName: string, env: Environment, personalAccessKey?: string, force?: boolean): Promise<string>;
-export declare function createDeveloperTestAccountV3(parentAccountId: number, testAccountConfig: DeveloperTestAccountConfig): Promise<{
+export declare function createDeveloperTestAccountV2(parentAccountId: number, testAccountConfig: DeveloperTestAccountConfig): Promise<{
     accountName: string;
     accountId?: number;
     personalAccessKey?: string;
 }>;
-export declare function buildDeveloperTestAccount(testAccountName: string, parentAccountConfig: CLIAccount, env: Environment, portalLimit: number, useV3?: boolean): Promise<number>;
+export declare function buildDeveloperTestAccount(testAccountName: string, parentAccountConfig: CLIAccount, env: Environment, portalLimit: number, useV2?: boolean): Promise<number>;
 type SandboxAccount = SandboxResponse & {
     name: string;
 };

package/lib/buildAccount.js

@@ -52,7 +52,7 @@ export async function saveAccountToConfig(accountId, accountName, env, personalA
     uiLogger.log('');
     return validName;
 }
-export async function createDeveloperTestAccountV3(parentAccountId, testAccountConfig) {
+export async function createDeveloperTestAccountV2(parentAccountId, testAccountConfig) {
     const result = {
         accountName: testAccountConfig.accountName,
     };
@@ -66,7 +66,7 @@ export async function createDeveloperTestAccountV3(parentAccountId, testAccountC
     }
     catch (err) {
         debugError(err);
-        throw new Error(lib.buildAccount.createDeveloperTestAccountV3.syncFailure);
+        throw new Error(lib.buildAccount.createDeveloperTestAccountV2.syncFailure);
     }
     // HACK: The status endpoint sometimes returns an early success status.
     // Sleep for an extra 5 seconds to make sure the sync is actually complete.
@@ -78,11 +78,11 @@ export async function createDeveloperTestAccountV3(parentAccountId, testAccountC
     }
     catch (err) {
         debugError(err);
-        throw new Error(lib.buildAccount.createDeveloperTestAccountV3.pakFailure);
+        throw new Error(lib.buildAccount.createDeveloperTestAccountV2.pakFailure);
     }
     return result;
 }
-export async function buildDeveloperTestAccount(testAccountName, parentAccountConfig, env, portalLimit, useV3 = false) {
+export async function buildDeveloperTestAccount(testAccountName, parentAccountConfig, env, portalLimit, useV2 = false) {
     const id = getAccountIdentifier(parentAccountConfig);
     const parentAccountId = getAccountId(id);
     let testAccountConfig = {
@@ -91,7 +91,7 @@ export async function buildDeveloperTestAccount(testAccountName, parentAccountCo
     if (!parentAccountId) {
         throw new Error(lib.developerTestAccount.create.loading.fail(''));
     }
-    if (useV3) {
+    if (useV2) {
         testAccountConfig = await createDeveloperTestAccountConfigPrompt({
             name: testAccountConfig.accountName,
             description: 'Test Account created by the HubSpot CLI',
@@ -107,8 +107,8 @@ export async function buildDeveloperTestAccount(testAccountName, parentAccountCo
     let developerTestAccountId;
     let developerTestAccountPersonalAccessKey;
     try {
-        if (useV3) {
-            const result = await createDeveloperTestAccountV3(parentAccountId, testAccountConfig);
+        if (useV2) {
+            const result = await createDeveloperTestAccountV2(parentAccountId, testAccountConfig);
             developerTestAccountId = result.accountId;
             developerTestAccountPersonalAccessKey = result.personalAccessKey;
         }

package/lib/configMigrate.js

@@ -3,6 +3,37 @@ import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME } from '@hubspot/local-dev-lib/c
 import { promptUser } from './prompts/promptUtils.js';
 import { lib } from '../lang/en.js';
 import { uiLogger } from './ui/logger.js';
+async function promptRenameOrOmitAccount(accountName, accountId) {
+    const { shouldRename } = await promptUser({
+        name: 'shouldRename',
+        type: 'confirm',
+        message: lib.configMigrate.handleAccountNameConflicts.prompts.renameOrOmitAccountPrompt(accountName, accountId),
+    });
+    return shouldRename;
+}
+async function promptNewAccountName(account, globalConfig, renamedAccounts) {
+    const { newAccountName } = await promptUser({
+        name: 'newAccountName',
+        type: 'input',
+        default: `${account.name}_${account.portalId}`,
+        message: lib.configMigrate.handleAccountNameConflicts.prompts.newAccountNamePrompt(account.name, account.portalId),
+        validate: value => {
+            if (!value) {
+                return lib.configMigrate.handleAccountNameConflicts.errors.nameRequired;
+            }
+            if (value === account.name) {
+                return lib.configMigrate.handleAccountNameConflicts.errors.sameName;
+            }
+            const existingAccount = globalConfig.accounts.some(acc => acc.name === value);
+            const renamedAccount = renamedAccounts.some(acc => acc.name === value);
+            if (existingAccount || renamedAccount) {
+                return lib.configMigrate.handleAccountNameConflicts.errors.nameAlreadyInConfig(value);
+            }
+            return true;
+        },
+    });
+    return newAccountName;
+}
 export async function handleMigration(deprecatedConfigPath, hideWarning) {
     if (!hideWarning) {
         uiLogger.warn(lib.configMigrate.deprecatedConfigWarning(deprecatedConfigPath || getConfigPath(undefined, false)));
@@ -47,20 +78,67 @@ async function handleMergeConfigProperties(globalConfig, deprecatedConfig, force
     }
     return initialConfig;
 }
+async function handleAccountNameConflicts(globalConfig, deprecatedConfig, force) {
+    if (!deprecatedConfig.portals?.length || !globalConfig.accounts?.length) {
+        return deprecatedConfig;
+    }
+    const accountsWithConflictsToRemove = new Set();
+    const renamedAccounts = [];
+    const accountsNotYetInGlobal = deprecatedConfig.portals.filter(portal => portal.portalId &&
+        !globalConfig.accounts.some(acc => acc.accountId === portal.portalId));
+    const accountsWithConflicts = accountsNotYetInGlobal.filter(localAccount => globalConfig.accounts.some(globalAccount => globalAccount.name === localAccount.name));
+    if (accountsWithConflicts.length > 0) {
+        uiLogger.log('');
+        uiLogger.warn(lib.configMigrate.handleAccountNameConflicts.warnings.accountNameConflictMessage(accountsWithConflicts.length));
+        if (force) {
+            const renameDetails = [];
+            for (const account of accountsWithConflicts) {
+                accountsWithConflictsToRemove.add(account);
+                const newAccountName = `${account.name}_${account.portalId}`;
+                renamedAccounts.push({
+                    ...account,
+                    name: newAccountName,
+                });
+                renameDetails.push(`  "${account.name}" → "${newAccountName}" (ID: ${account.portalId})`);
+            }
+            uiLogger.warn(lib.configMigrate.handleAccountNameConflicts.warnings.forceFlagDetected(accountsWithConflicts.length, renameDetails.join('\n')));
+            uiLogger.log('');
+        }
+        else {
+            for (const account of accountsWithConflicts) {
+                uiLogger.log('');
+                const shouldRename = await promptRenameOrOmitAccount(account.name, account.portalId);
+                accountsWithConflictsToRemove.add(account);
+                if (shouldRename) {
+                    const newAccountName = await promptNewAccountName(account, globalConfig, renamedAccounts);
+                    renamedAccounts.push({
+                        ...account,
+                        name: newAccountName,
+                    });
+                }
+            }
+        }
+        deprecatedConfig.portals.push(...renamedAccounts);
+    }
+    const cleanedPortals = deprecatedConfig.portals.filter(portal => !accountsWithConflictsToRemove.has(portal));
+    return { ...deprecatedConfig, portals: cleanedPortals };
+}
 export async function handleMerge(deprecatedConfigPath, force, hideWarning) {
     if (!hideWarning) {
         uiLogger.warn(lib.configMigrate.deprecatedConfigWarning(deprecatedConfigPath || getConfigPath(undefined, false)));
         uiLogger.log('');
     }
     uiLogger.log(lib.configMigrate.handleMerge.description(ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME));
-    uiLogger.log('');
-    const { shouldMergeConfigs } = await promptUser({
-        name: 'shouldMergeConfigs',
-        type: 'confirm',
-        message: lib.configMigrate.handleMerge.confirmPrompt,
-    });
-    if (!shouldMergeConfigs) {
-        return false;
+    if (!force) {
+        uiLogger.log('');
+        const { shouldMergeConfigs } = await promptUser({
+            name: 'shouldMergeConfigs',
+            type: 'confirm',
+            message: lib.configMigrate.handleMerge.confirmPrompt,
+        });
+        if (shouldMergeConfigs === false) {
+            return true; // exit with "true" so the user is shown a success message instead of an error
+        }
     }
     const deprecatedConfig = getDeprecatedConfig(deprecatedConfigPath);
     const globalConfig = getGlobalConfig();
@@ -68,7 +146,8 @@ export async function handleMerge(deprecatedConfigPath, force, hideWarning) {
         return true;
     }
     const mergedConfig = await handleMergeConfigProperties(globalConfig, deprecatedConfig, force);
-    const { skippedAccountIds } = mergeExistingConfigs(mergedConfig, deprecatedConfig);
+    const cleanedDeprecatedConfig = await handleAccountNameConflicts(mergedConfig, deprecatedConfig, force);
+    const { skippedAccountIds } = mergeExistingConfigs(mergedConfig, cleanedDeprecatedConfig);
     if (skippedAccountIds.length > 0) {
         uiLogger.log('');
         uiLogger.log(lib.configMigrate.handleMerge.skippedExistingAccounts(skippedAccountIds));

package/lib/constants.d.ts

@@ -76,7 +76,6 @@ export declare const APP_AUTH_TYPES: {
     readonly STATIC: "static";
 };
 export declare const FEATURES: {
-    readonly UNIFIED_THEME_PREVIEW: "cms:react:unifiedThemePreview";
     readonly UNIFIED_APPS: "Developers:UnifiedApps:PrivateBeta";
     readonly SANDBOXES_V2: "sandboxes:v2:enabled";
     readonly SANDBOXES_V2_CLI: "sandboxes:v2:cliEnabled";
@@ -96,16 +95,21 @@ export declare const LOCAL_DEV_UI_MESSAGE_SEND_TYPES: {
     UPDATE_PROJECT_DATA: string;
     UPDATE_UPLOAD_WARNINGS: string;
     CLI_METADATA: string;
+    DEV_SERVERS_STARTED: string;
 };
 export declare const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES: {
     UPLOAD: string;
     DEPLOY: string;
     VIEWED_WELCOME_SCREEN: string;
+    APP_INSTALL_SUCCESS: string;
+    APP_INSTALL_INITIATED: string;
+    APP_INSTALL_FAILURE: string;
 };
 export declare const APP_INSTALLATION_STATES: {
     readonly NOT_INSTALLED: "NOT_INSTALLED";
     readonly INSTALLED: "INSTALLED";
     readonly INSTALLED_WITH_OUTDATED_SCOPES: "INSTALLED_WITH_OUTDATED_SCOPES";
+    readonly UNKNOWN: "UNKNOWN";
 };
 export declare const staticAuth = "static";
 export declare const oAuth = "oauth";
@@ -119,6 +123,9 @@ export declare const GET_STARTED_OPTIONS: {
 export declare const LOCAL_DEV_SERVER_MESSAGE_TYPES: {
     readonly INITIAL: "INITIAL";
     readonly WEBSOCKET_SERVER_CONNECTED: "WEBSOCKET_SERVER_CONNECTED";
+    readonly STATIC_AUTH_APP_INSTALL_SUCCESS: "APP_INSTALL_SUCCESS";
+    readonly STATIC_AUTH_APP_INSTALL_FAILURE: "APP_INSTALL_FAILURE";
+    readonly OAUTH_APP_INSTALL_INITIATED: "APP_INSTALL_INITIATED";
 };
 export declare const CONFIG_LOCAL_STATE_FLAGS: {
     readonly LOCAL_DEV_UI_WELCOME: "LOCAL_DEV_UI_WELCOME";

package/lib/constants.js

@@ -68,7 +68,6 @@ export const APP_AUTH_TYPES = {
     STATIC: 'static',
 };
 export const FEATURES = {
-    UNIFIED_THEME_PREVIEW: 'cms:react:unifiedThemePreview',
     UNIFIED_APPS: 'Developers:UnifiedApps:PrivateBeta',
     SANDBOXES_V2: 'sandboxes:v2:enabled',
     SANDBOXES_V2_CLI: 'sandboxes:v2:cliEnabled',
@@ -88,16 +87,21 @@ export const LOCAL_DEV_UI_MESSAGE_SEND_TYPES = {
     UPDATE_PROJECT_DATA: 'server:updateProjectData',
     UPDATE_UPLOAD_WARNINGS: 'server:updateUploadWarnings',
     CLI_METADATA: 'server:cliMetadata',
+    DEV_SERVERS_STARTED: 'server:devServersStarted',
 };
 export const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES = {
     UPLOAD: 'client:upload',
     DEPLOY: 'client:deploy',
     VIEWED_WELCOME_SCREEN: 'client:viewedWelcomeScreen',
+    APP_INSTALL_SUCCESS: 'client:installSuccess',
+    APP_INSTALL_INITIATED: 'client:installInitiated',
+    APP_INSTALL_FAILURE: 'client:installFailure',
 };
 export const APP_INSTALLATION_STATES = {
     NOT_INSTALLED: 'NOT_INSTALLED',
     INSTALLED: 'INSTALLED',
     INSTALLED_WITH_OUTDATED_SCOPES: 'INSTALLED_WITH_OUTDATED_SCOPES',
+    UNKNOWN: 'UNKNOWN',
 };
 export const staticAuth = 'static';
 export const oAuth = 'oauth';
@@ -111,6 +115,9 @@ export const GET_STARTED_OPTIONS = {
 export const LOCAL_DEV_SERVER_MESSAGE_TYPES = {
     INITIAL: 'INITIAL',
     WEBSOCKET_SERVER_CONNECTED: 'WEBSOCKET_SERVER_CONNECTED',
+    STATIC_AUTH_APP_INSTALL_SUCCESS: 'APP_INSTALL_SUCCESS',
+    STATIC_AUTH_APP_INSTALL_FAILURE: 'APP_INSTALL_FAILURE',
+    OAUTH_APP_INSTALL_INITIATED: 'APP_INSTALL_INITIATED',
 };
 export const CONFIG_LOCAL_STATE_FLAGS = {
     LOCAL_DEV_UI_WELCOME: 'LOCAL_DEV_UI_WELCOME',

package/lib/doctor/Doctor.js

@@ -115,7 +115,7 @@ export class Doctor {
                 this.diagnosis?.addCLIConfigSection({
                     type: 'warning',
                     message: lib.doctor.accountChecks.pak.incomplete,
-                    secondaryMessaging: lib.doctor.accountChecks.pak.incompleteSecondary('hs auth', linkToPakUI),
+                    secondaryMessaging: lib.doctor.accountChecks.pak.incompleteSecondary(linkToPakUI),
                 });
             }
             else {
@@ -155,7 +155,7 @@ export class Doctor {
                 this.diagnosis?.addCLIConfigSection({
                     type: 'error',
                     message: lib.doctor.accountChecks.pak.invalid,
-                    secondaryMessaging: lib.doctor.accountChecks.pak.invalidSecondary('hs auth'),
+                    secondaryMessaging: lib.doctor.accountChecks.pak.invalidSecondary,
                 });
             }
             else {

package/lib/errorHandlers/suppressError.js

@@ -2,7 +2,7 @@ import { isSpecifiedError, isMissingScopeError, } from '@hubspot/local-dev-lib/e
 import { uiLogger } from '../ui/logger.js';
 import { PLATFORM_VERSION_ERROR_TYPES } from '../constants.js';
 import { lib } from '../../lang/en.js';
-import { uiAccountDescription, uiLine, uiLink, uiCommandReference, } from '../ui/index.js';
+import { uiAccountDescription, uiLine, uiLink } from '../ui/index.js';
 function createPlatformVersionError(err, subCategory) {
     let translationKey = 'unspecifiedPlatformVersion';
     let platformVersion = 'unspecified platformVersion';
@@ -28,7 +28,7 @@ function createPlatformVersionError(err, subCategory) {
 }
 export function shouldSuppressError(err, context) {
     if (isMissingScopeError(err)) {
-        uiLogger.error(lib.errorHandlers.suppressErrors.missingScopeError(context?.request || 'request', context?.accountId ? uiAccountDescription(context.accountId) : '', uiCommandReference('hs auth')));
+        uiLogger.error(lib.errorHandlers.suppressErrors.missingScopeError(context?.request || 'request', context?.accountId ? uiAccountDescription(context.accountId) : ''));
         return true;
     }
     if (isSpecifiedError(err, {

package/lib/middleware/commandTargetingUtils.d.ts

@@ -3,6 +3,6 @@ type TargetCommandMap = {
 };
 export declare function isTargetedCommand(commandParts: (string | number)[], targetCommandMap: TargetCommandMap): boolean;
 export declare function shouldLoadConfigForCommand(commandParts: (string | number)[]): boolean;
-export declare function shouldRunAccountValidationForCommand(commandParts: (string | number)[]): boolean;
 export declare function shouldRunConfigValidationForCommand(commandParts: (string | number)[]): boolean;
+export declare function shouldRunAccountValidationForCommand(commandParts: (string | number)[]): boolean;
 export {};

package/lib/middleware/commandTargetingUtils.js

@@ -33,6 +33,19 @@ export function shouldLoadConfigForCommand(commandParts) {
     return (!isGlobalConfigMigration &&
         !isTargetedCommand(commandParts, SKIP_CONFIG_LOADING_COMMANDS));
 }
+const SKIP_CONFIG_VALIDATION_COMMANDS = {
+    auth: true,
+    mcp: {
+        setup: true,
+        start: true,
+    },
+};
+// Returns true if the command requires a valid config file to be present
+// Should only run if config has been loaded
+export function shouldRunConfigValidationForCommand(commandParts) {
+    return (shouldLoadConfigForCommand(commandParts) &&
+        !isTargetedCommand(commandParts, SKIP_CONFIG_VALIDATION_COMMANDS));
+}
 const accountsSubCommands = {
     auth: true,
     clean: true,
@@ -45,12 +58,6 @@ const sandboxesSubCommands = {
     delete: true,
 };
 const SKIP_ACCOUNT_VALIDATION_COMMANDS = {
-    init: true,
-    auth: true,
-    mcp: {
-        setup: true,
-        start: true,
-    },
     account: accountsSubCommands,
     accounts: accountsSubCommands,
     sandbox: sandboxesSubCommands,
@@ -58,21 +65,10 @@ const SKIP_ACCOUNT_VALIDATION_COMMANDS = {
     config: {
         migrate: true,
     },
-    feedback: true,
 };
 // Returns true if the command requires a valid account to be set in the config
+// Should only run if config has been loaded and validated
 export function shouldRunAccountValidationForCommand(commandParts) {
-    return !isTargetedCommand(commandParts, SKIP_ACCOUNT_VALIDATION_COMMANDS);
-}
-const SKIP_CONFIG_VALIDATION_COMMANDS = {
-    init: true,
-    auth: true,
-    mcp: {
-        setup: true,
-        start: true,
-    },
-};
-// Returns true if the command requires a valid config file to be present
-export function shouldRunConfigValidationForCommand(commandParts) {
-    return !isTargetedCommand(commandParts, SKIP_CONFIG_VALIDATION_COMMANDS);
+    return (shouldRunConfigValidationForCommand(commandParts) &&
+        !isTargetedCommand(commandParts, SKIP_ACCOUNT_VALIDATION_COMMANDS));
 }