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

package/commands/cms/__tests__/fetch.test.js

@@ -101,12 +101,13 @@ describe('commands/cms/fetch', () => {
                 await fetchCommand.handler(args);
                 expect(trackCommandUsageSpy).toHaveBeenCalledWith('fetch', { mode: 'publish' }, 123456);
             });
-            it('should fetch file successfully', async () => {
+            it('should fetch file successfully with increased timeout', async () => {
                 await fetchCommand.handler(args);
                 expect(downloadFileOrFolderSpy).toHaveBeenCalledWith(123456, '/remote/path/file.js', './local/path', 'publish', expect.objectContaining({
                     assetVersion: undefined,
                     staging: undefined,
                     overwrite: undefined,
+                    timeout: 60000,
                 }));
             });
             it('should use default dest if not provided', async () => {

package/commands/cms/fetch.js

@@ -24,11 +24,12 @@ async function handler(options) {
     trackCommandUsage('fetch', { mode: cmsPublishMode }, derivedAccountId);
     const { assetVersion, staging, overwrite } = options;
     try {
-        // Fetch and write file/folder.
+        // Fetch and write file/folder with increased timeout for large themes.
         await downloadFileOrFolder(derivedAccountId, src, resolveLocalPath(dest), cmsPublishMode, {
             assetVersion: assetVersion !== undefined ? `${assetVersion}` : assetVersion,
             staging,
             overwrite,
+            timeout: 60_000,
         });
     }
     catch (err) {

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

@@ -79,7 +79,7 @@ describe('commands/project/create', () => {
             projectCreateCommand.builder(yargsMock);
             const optionsCall = optionsSpy.mock.calls[0][0];
             expect(optionsCall.auth).toEqual(expect.objectContaining({
-                describe: 'Authentication model for the application.',
+                describe: 'Authentication model for the app.',
                 type: 'string',
                 choices: ['oauth', 'static'],
             }));

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

@@ -2,6 +2,8 @@ import * as configLib from '@hubspot/local-dev-lib/config';
 import * as projectConfigLib from '../../../lib/projects/config.js';
 import * as platformVersionLib from '../../../lib/projects/platformVersion.js';
 import * as projectProfilesLib from '../../../lib/projects/projectProfiles.js';
+import * as projectParsingProfiles from '@hubspot/project-parsing-lib/profiles';
+import * as promptUtilsLib from '../../../lib/prompts/promptUtils.js';
 import * as usageTrackingLib from '../../../lib/usageTracking.js';
 import * as errorHandlers from '../../../lib/errorHandlers/index.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
@@ -10,9 +12,11 @@ import * as deprecatedFlowLib from '../dev/deprecatedFlow.js';
 import * as unifiedFlowLib from '../dev/unifiedFlow.js';
 import projectDevCommand from '../dev/index.js';
 vi.mock('@hubspot/local-dev-lib/config');
+vi.mock('@hubspot/project-parsing-lib/profiles');
 vi.mock('../../../lib/projects/config.js');
 vi.mock('../../../lib/projects/platformVersion.js');
 vi.mock('../../../lib/projects/projectProfiles.js');
+vi.mock('../../../lib/prompts/promptUtils.js');
 vi.mock('../../../lib/errorHandlers/index.js');
 vi.mock('../../../lib/ui/index.js');
 vi.mock('../dev/deprecatedFlow.js');
@@ -23,6 +27,8 @@ const validateProjectConfigSpy = vi.spyOn(projectConfigLib, 'validateProjectConf
 const isV2ProjectSpy = vi.spyOn(platformVersionLib, 'isV2Project');
 const loadProfileSpy = vi.spyOn(projectProfilesLib, 'loadProfile');
 const enforceProfileUsageSpy = vi.spyOn(projectProfilesLib, 'enforceProfileUsage');
+const getAllHsProfilesSpy = vi.spyOn(projectParsingProfiles, 'getAllHsProfiles');
+const listPromptSpy = vi.spyOn(promptUtilsLib, 'listPrompt');
 const trackCommandUsageSpy = vi.spyOn(usageTrackingLib, 'trackCommandUsage');
 const logErrorSpy = vi.spyOn(errorHandlers, 'logError');
 const deprecatedProjectDevFlowSpy = vi.spyOn(deprecatedFlowLib, 'deprecatedProjectDevFlow');
@@ -46,6 +52,8 @@ describe('commands/project/dev', () => {
         deprecatedProjectDevFlowSpy.mockResolvedValue(undefined);
         unifiedProjectDevFlowSpy.mockResolvedValue(undefined);
         enforceProfileUsageSpy.mockResolvedValue(undefined);
+        getAllHsProfilesSpy.mockResolvedValue([]);
+        listPromptSpy.mockResolvedValue('dev');
     });
     describe('command', () => {
         it('should have the correct command structure', () => {
@@ -96,7 +104,11 @@ describe('commands/project/dev', () => {
                     },
                     projectDir: null,
                 });
-                await projectDevCommand.handler(args);
+                // Make process.exit actually throw to stop execution
+                processExitSpy.mockImplementation((code) => {
+                    throw new Error(`process.exit called with ${code}`);
+                });
+                await expect(projectDevCommand.handler(args)).rejects.toThrow('process.exit called');
                 expect(uiLogger.error).toHaveBeenCalledWith(expect.stringContaining('project'));
                 expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
             });
@@ -160,18 +172,37 @@ describe('commands/project/dev', () => {
                 expect(logErrorSpy).toHaveBeenCalledWith(error);
                 expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
             });
-            it('should enforce profile usage for V2 projects without profile', async () => {
+            it('should prompt for profile selection when profiles exist and no profile is specified', async () => {
+                getAllHsProfilesSpy.mockResolvedValue(['dev', 'prod']);
+                listPromptSpy.mockResolvedValue('dev');
+                loadProfileSpy.mockReturnValue({
+                    accountId: 789012,
+                    variables: {},
+                });
                 await projectDevCommand.handler(args);
-                expect(enforceProfileUsageSpy).toHaveBeenCalledWith({
+                expect(getAllHsProfilesSpy).toHaveBeenCalledWith('/test/project/src');
+                expect(listPromptSpy).toHaveBeenCalledWith(expect.any(String), {
+                    choices: ['dev', 'prod'],
+                });
+                expect(loadProfileSpy).toHaveBeenCalledWith({
                     name: 'test-project',
                     srcDir: 'src',
                     platformVersion: 'v2',
-                }, '/test/project');
+                }, '/test/project', 'dev');
+                expect(trackCommandUsageSpy).toHaveBeenCalledWith('project-dev', {}, 789012);
             });
-            it('should exit if profile enforcement fails', async () => {
-                const error = new Error('Profile required');
-                enforceProfileUsageSpy.mockRejectedValue(error);
-                await projectDevCommand.handler(args);
+            it('should exit if profile loading fails after selection', async () => {
+                getAllHsProfilesSpy.mockResolvedValue(['dev', 'prod']);
+                listPromptSpy.mockResolvedValue('dev');
+                const error = new Error('Failed to load profile');
+                loadProfileSpy.mockImplementation(() => {
+                    throw error;
+                });
+                // Make process.exit actually throw to stop execution
+                processExitSpy.mockImplementation((code) => {
+                    throw new Error(`process.exit called with ${code}`);
+                });
+                await expect(projectDevCommand.handler(args)).rejects.toThrow('process.exit called');
                 expect(logErrorSpy).toHaveBeenCalledWith(error);
                 expect(processExitSpy).toHaveBeenCalledWith(EXIT_CODES.ERROR);
             });

package/commands/project/dev/index.js

@@ -1,5 +1,6 @@
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
 import { getConfigAccountIfExists } from '@hubspot/local-dev-lib/config';
+import { getAllHsProfiles, } from '@hubspot/project-parsing-lib/profiles';
 import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { uiLine } from '../../../lib/ui/index.js';
@@ -7,10 +8,12 @@ import { deprecatedProjectDevFlow } from './deprecatedFlow.js';
 import { unifiedProjectDevFlow } from './unifiedFlow.js';
 import { isV2Project } from '../../../lib/projects/platformVersion.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
-import { loadProfile, enforceProfileUsage, } from '../../../lib/projects/projectProfiles.js';
+import { loadProfile } from '../../../lib/projects/projectProfiles.js';
 import { commands } from '../../../lang/en.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { logError } from '../../../lib/errorHandlers/index.js';
+import path from 'path';
+import { listPrompt } from '../../../lib/prompts/promptUtils.js';
 const command = 'dev';
 const describe = commands.project.dev.describe;
 function validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV2) {
@@ -62,27 +65,27 @@ async function handler(args) {
     else if (userProvidedAccount && derivedAccountId) {
         targetProjectAccountId = derivedAccountId;
     }
+    // Determine profile name: from flag or prompt
     if (!targetProjectAccountId && isV2Project(projectConfig.platformVersion)) {
-        if (args.profile) {
-            try {
-                profile = loadProfile(projectConfig, projectDir, args.profile);
-            }
-            catch (error) {
-                logError(error);
-                uiLine();
-                process.exit(EXIT_CODES.ERROR);
+        let profileName = args.profile;
+        if (!profileName) {
+            const existingProfiles = await getAllHsProfiles(path.join(projectDir, projectConfig.srcDir));
+            if (existingProfiles.length !== 0) {
+                profileName = await listPrompt(commands.project.dev.prompts.selectProfile, {
+                    choices: existingProfiles,
+                });
             }
-            targetProjectAccountId = profile.accountId;
-            uiLogger.log('');
-            uiLogger.log(commands.project.dev.logs.profileProjectAccountExplanation(targetProjectAccountId, args.profile));
         }
-        else {
-            // A profile must be specified if this project has profiles configured
+        if (profileName) {
             try {
-                await enforceProfileUsage(projectConfig, projectDir);
+                profile = loadProfile(projectConfig, projectDir, profileName);
+                targetProjectAccountId = profile.accountId;
+                uiLogger.log('');
+                uiLogger.log(commands.project.dev.logs.profileProjectAccountExplanation(targetProjectAccountId, profileName));
             }
             catch (error) {
                 logError(error);
+                uiLine();
                 process.exit(EXIT_CODES.ERROR);
             }
         }

package/commands/testAccount/create.js

@@ -114,7 +114,7 @@ async function handler(args) {
         process.exit(EXIT_CODES.ERROR);
     }
     SpinniesManager.succeed('createTestAccount', {
-        text: commands.testAccount.create.polling.success(testAccountConfig.accountName, resultJson.accountId),
+        text: commands.testAccount.create.polling.success(testAccountConfig.accountName, resultJson.accountId, derivedAccountId),
     });
     if (formatOutputAsJson) {
         uiLogger.json(resultJson);

package/lang/en.d.ts

@@ -1369,6 +1369,9 @@ export declare const commands: {
             examples: {
                 default: string;
             };
+            prompts: {
+                selectProfile: string;
+            };
             options: {
                 profile: string;
                 projectAccount: string;
@@ -2160,7 +2163,7 @@ export declare const commands: {
             polling: {
                 start: (testAccountName: string) => string;
                 syncing: string;
-                success: (testAccountName: string, testAccountId: number) => string;
+                success: (testAccountName: string, testAccountId: number, parentAccountId: number) => string;
                 createFailure: string;
             };
             options: {
@@ -3129,6 +3132,14 @@ export declare const lib: {
             fileFiltered: (filename: string) => string;
             legacyFileDetected: (filename: string, platformVersion: string) => string;
             projectDoesNotExist: (accountId: number) => string;
+            workspaceIncluded: (workspaceDir: string, archivePath: string) => string;
+            fileDependencyIncluded: (packageName: string, localPath: string, archivePath: string) => string;
+            malformedPackageJson: (packageJsonPath: string, error: string) => string;
+            workspaceCollision: (archivePath: string, workspaceDir: string, existingWorkspace: string) => string;
+            fileDependencyAlreadyIncluded: (packageName: string, archivePath: string) => string;
+            updatingPackageJsonWorkspaces: (packageJsonPath: string) => string;
+            updatedWorkspaces: (workspaces: string) => string;
+            updatedFileDependency: (packageName: string, relativePath: string) => string;
         };
     };
     importData: {

package/lang/en.js

@@ -1219,7 +1219,7 @@ export const commands = {
             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')}.`,
@@ -1261,7 +1261,7 @@ 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: {
@@ -1385,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.',
@@ -1438,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}`,
@@ -1536,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`,
@@ -2183,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: {
@@ -2206,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',
@@ -2997,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')}.`,
@@ -3059,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',
@@ -3152,6 +3155,14 @@ export const lib = {
             fileFiltered: (filename) => `Ignore rule triggered for "${filename}"`,
             legacyFileDetected: (filename, platformVersion) => `The ${chalk.bold(filename)} file is not supported on platform version ${chalk.bold(platformVersion)} and will be ignored.`,
             projectDoesNotExist: (accountId) => `Upload cancelled. Run ${uiCommandReference('hs project upload')} again to create the project in ${uiAccountDescription(accountId)}.`,
+            workspaceIncluded: (workspaceDir, archivePath) => `Including workspace: ${workspaceDir} → ${archivePath}`,
+            fileDependencyIncluded: (packageName, localPath, archivePath) => `Including file: dependency ${packageName}: ${localPath} → ${archivePath}`,
+            malformedPackageJson: (packageJsonPath, error) => `Skipping malformed package.json at ${packageJsonPath}: ${error}`,
+            workspaceCollision: (archivePath, workspaceDir, existingWorkspace) => `Workspace collision: ${archivePath} from ${workspaceDir} and ${existingWorkspace}`,
+            fileDependencyAlreadyIncluded: (packageName, archivePath) => `file: dependency ${packageName} already included as workspace: ${archivePath}`,
+            updatingPackageJsonWorkspaces: (packageJsonPath) => `Updating package.json workspaces in archive: ${packageJsonPath}`,
+            updatedWorkspaces: (workspaces) => `  Updated workspaces: ${workspaces}`,
+            updatedFileDependency: (packageName, relativePath) => `  Updated dependencies.${packageName}: file:${relativePath}`,
         },
     },
     importData: {
@@ -3386,10 +3397,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',
             },
@@ -3405,7 +3416,7 @@ export const lib = {
             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: {

package/lib/errorHandlers/__tests__/index.test.d.ts

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