@hubspot/cli 7.7.22-experimental.0 → 7.7.24-experimental.0

package/lang/en.js

@@ -4,8 +4,7 @@ import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constant
 import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, } from '@hubspot/local-dev-lib/constants/config';
 import { uiAccountDescription, uiBetaTag, uiCommandReference, uiLink, UI_COLORS, } from '../lib/ui/index.js';
 import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, } from '../lib/projects/urls.js';
-import { PROJECT_CONFIG_FILE } from '../lib/constants.js';
-import { PROJECT_WITH_APP } from '../lib/projects/create/v3.js';
+import { PROJECT_CONFIG_FILE, PROJECT_WITH_APP } from '../lib/constants.js';
 export const commands = {
     generalErrors: {
         srcIsProject: (src, command) => `"${src}" is in a project folder. Did you mean "hs project ${command}"?`,
@@ -80,6 +79,7 @@ export const commands = {
                     personalAccessKey: 'Enter existing personal access key',
                 },
                 errors: {
+                    invalidAccountIdProvided: `--account must be a number.`,
                     failedToUpdateConfig: 'Failed to update the configuration file. Please try again.',
                     migrationNotConfirmed: `Did not migrate your configuration file. Run ${uiCommandReference('hs auth')} to update your existing config, or use ${uiCommandReference('hs config migrate')} to switch to the new global configuration.`,
                     mergeNotConfirmed: `Did not merge configuration files. When you are ready to merge the deprecated config file with the global config file, run ${uiCommandReference('hs config migrate')}.`,
@@ -253,6 +253,9 @@ export const commands = {
                     allowAutoUpdates: {
                         describe: 'Enable or disable auto updates',
                     },
+                    autoOpenBrowser: {
+                        describe: 'Enable or disable automatic opening of the browser',
+                    },
                 },
             },
         },
@@ -828,9 +831,9 @@ export const commands = {
         setup: {
             installingDocSearch: 'Adding the docs-search mcp server',
             claudeCode: 'Claude Code',
-            claudeDesktop: 'Claude Desktop',
             cursor: 'Cursor',
             windsurf: 'Windsurf',
+            vsCode: 'VSCode',
             args: {
                 client: 'Target applications to configure',
                 docsSearch: 'Should the docs search mcp server be installed',
@@ -842,20 +845,26 @@ export const commands = {
             },
             spinners: {
                 failedToConfigure: 'Failed to configure the HubSpot mcp server.',
-                configuringClaudeDesktop: 'Configuring Claude Desktop...',
-                configuredClaudeDesktop: 'Configured Claude Desktop',
+                // Claude
                 configuringClaudeCode: 'Configuring Claude Code...',
                 configuredClaudeCode: 'Configured Claude Code',
                 claudeCodeNotFound: 'Claude Code not found - skipping configuration',
                 claudeCodeInstallFailed: 'Claude Code CLI not working - skipping configuration',
                 failedToConfigureClaudeDesktop: 'Failed to configure Claude Desktop',
+                // Cursor
                 configuringCursor: 'Configuring Cursor...',
                 failedToConfigureCursor: 'Failed to configure Cursor',
                 configuredCursor: 'Configured Cursor',
                 alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
+                // Windsurf
                 configuringWindsurf: 'Configuring Windsurf...',
                 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',
             },
             prompts: {
                 targets: '[--client] Which tools would you like to add the HubSpot CLI MCP server to?',
@@ -1375,6 +1384,7 @@ export const commands = {
                 default: 'Validate the project before uploading',
             },
             success: (projectName) => `Project ${projectName} is valid and ready to upload`,
+            failure: (projectName) => `Project ${projectName} is invalid`,
             options: {
                 profile: {
                     describe: 'The profile to target for this validation',
@@ -2451,7 +2461,8 @@ export const lib = {
         running: (projectName, accountIdentifier) => chalk.hex(UI_COLORS.SORBET)(`Running ${chalk.bold(projectName)} locally on ${accountIdentifier}, waiting for changes ...`),
         quitHelper: `Press ${chalk.bold('q')} to stop the local dev server`,
         viewProjectLink: (name, accountId) => uiLink('View project in HubSpot', getProjectDetailUrl(name, accountId) || ''),
-        viewLocalDevUILink: (accountId) => uiLink('View local dev session in HubSpot', getLocalDevUiUrl(accountId)),
+        viewLocalDevUILink: (accountId, showWelcomeScreen) => uiLink('View local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen)),
+        localDevUIAutoMessage: (accountId, showWelcomeScreen) => `Opening your ${uiLink('local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen))}...`,
         viewTestAccountLink: 'View developer test account in HubSpot',
         exitingStart: 'Stopping local dev server ...',
         exitingSucceed: 'Successfully exited',
@@ -2780,6 +2791,11 @@ export const lib = {
             promptMessage: 'Enter http timeout duration',
             success: (timeout) => `HTTP timeout set to: ${timeout}`,
         },
+        setAutoOpenBrowser: {
+            fieldName: 'auto open browser',
+            enabled: 'Auto opening your browser has been enabled',
+            disabled: 'Auto opening your browser has been disabled',
+        },
     },
     commonOpts: {
         options: {

package/lang/en.lyaml

@@ -1038,12 +1038,14 @@ en:
         compressing: "Compressing build files to \"{{ path }}\""
         fileFiltered: "Ignore rule triggered for \"{{ filename }}\""
     ui:
-      betaTag: "{{#bold}}[BETA]{{/bold}}"
+      betaTag: "[BETA]"
+      betaTagWithStyle: "{{#bold}}[BETA]{{/bold}}"
       betaWarning:
         header: "{{#yellow}}***************************** WARNING ****************************{{/yellow}}"
         footer: "{{#yellow}}******************************************************************{{/yellow}}"
       infoTag: "{{#bold}}[INFO]{{/bold}}"
-      deprecatedTag: "{{#bold}}[DEPRECATED]{{/bold}}"
+      deprecatedTag: "[DEPRECATED]"
+      deprecatedTagWithStyle: "{{#bold}}[DEPRECATED]{{/bold}}"
       errorTag: "{{#bold}}[ERROR]{{/bold}}"
       deprecatedMessage: "The {{ command }} command is deprecated and will be disabled soon. {{ url }}"
       deprecatedDescription: "{{ message }}. The {{ command }} command is deprecated and will be disabled soon. {{ url }}"

package/lib/__tests__/buildAccount.test.js

@@ -1,7 +1,7 @@
 import { getAccessToken, updateConfigWithAccessToken, } from '@hubspot/local-dev-lib/personalAccessKey';
 import { accountNameExistsInConfig, updateAccountConfig, writeConfig, getAccountId, } from '@hubspot/local-dev-lib/config';
 import { createDeveloperTestAccount, fetchDeveloperTestAccountGateSyncStatus, generateDeveloperTestAccountPersonalAccessKey, } from '@hubspot/local-dev-lib/api/developerTestAccounts';
-import { createSandbox } from '@hubspot/local-dev-lib/api/sandboxHubs';
+import { createSandbox, createV2Sandbox, getSandboxPersonalAccessKey, } from '@hubspot/local-dev-lib/api/sandboxHubs';
 import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
 import { personalAccessKeyPrompt } from '../prompts/personalAccessKeyPrompt.js';
 import { cliAccountNamePrompt } from '../prompts/accountNamePrompt.js';
@@ -33,6 +33,8 @@ const mockedCreateDeveloperTestAccount = createDeveloperTestAccount;
 const mockedFetchDeveloperTestAccountGateSyncStatus = fetchDeveloperTestAccountGateSyncStatus;
 const mockedGenerateDeveloperTestAccountPersonalAccessKey = generateDeveloperTestAccountPersonalAccessKey;
 const mockedCreateSandbox = createSandbox;
+const mockedCreateV2Sandbox = createV2Sandbox;
+const mockedGetPersonalAccessKey = getSandboxPersonalAccessKey;
 describe('lib/buildAccount', () => {
     describe('saveAccountToConfig()', () => {
         const mockAccountConfig = {
@@ -166,16 +168,17 @@ describe('lib/buildAccount', () => {
     });
     describe('buildSandbox()', () => {
         const mockParentAccountConfig = {
-            name: 'Developer Test Account',
+            name: 'Prod account',
             accountId: 123456,
-            accountType: HUBSPOT_ACCOUNT_TYPES.DEVELOPER_TEST,
+            accountType: HUBSPOT_ACCOUNT_TYPES.STANDARD,
             env: 'prod',
         };
         const mockSandbox = {
             sandboxHubId: 56789,
             parentHubId: 123456,
             createdAt: '2025-01-01',
-            type: 'sandbox',
+            type: 'STANDARD',
+            version: 'V1',
             archived: false,
             name: 'Test Sandbox',
             domain: 'test-sandbox.hubspot.com',
@@ -221,4 +224,59 @@ describe('lib/buildAccount', () => {
             await expect(buildAccount.buildSandbox(mockSandbox.name, mockParentAccountConfig, HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX, mockParentAccountConfig.env, false)).rejects.toThrow();
         });
     });
+    describe('buildV2Sandbox()', () => {
+        const mockParentAccountConfig = {
+            name: 'Prod account',
+            accountId: 123456,
+            accountType: HUBSPOT_ACCOUNT_TYPES.STANDARD,
+            env: 'prod',
+        };
+        const mockSandbox = {
+            sandboxHubId: 56789,
+            parentHubId: 123456,
+            createdAt: '2025-01-01',
+            type: 'STANDARD',
+            archived: false,
+            version: 'V2',
+            name: 'Test v2 Sandbox',
+            domain: 'test-v2-sandbox.hubspot.com',
+            createdByUser: {
+                id: 123456,
+                email: 'test@test.com',
+                firstName: 'Test',
+                lastName: 'User',
+            },
+        };
+        beforeEach(() => {
+            vi.spyOn(buildAccount, 'saveAccountToConfig').mockResolvedValue(mockParentAccountConfig.name);
+            mockedGetAccountId.mockReturnValue(mockParentAccountConfig.accountId);
+            mockedCreateV2Sandbox.mockResolvedValue({
+                data: mockSandbox,
+            });
+            mockedGetPersonalAccessKey.mockResolvedValue({
+                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 });
+            expect(mockedGetPersonalAccessKey).toHaveBeenCalledWith(mockParentAccountConfig.accountId, mockSandbox.sandboxHubId);
+        });
+        it('should create a development sandbox successfully and fetch a personal access key', async () => {
+            const result = await buildAccount.buildV2Sandbox(mockSandbox.name, mockParentAccountConfig, HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX, false, mockParentAccountConfig.env, false);
+            expect(result).toEqual({ sandbox: mockSandbox });
+            expect(mockedGetPersonalAccessKey).toHaveBeenCalledWith(mockParentAccountConfig.accountId, mockSandbox.sandboxHubId);
+        });
+        it('should throw error if account ID is not found', async () => {
+            mockedGetAccountId.mockReturnValue(null);
+            await expect(buildAccount.buildV2Sandbox(mockSandbox.name, mockParentAccountConfig, HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX, false, mockParentAccountConfig.env, false)).rejects.toThrow();
+        });
+        it('should handle API errors when creating sandbox', async () => {
+            mockedCreateV2Sandbox.mockRejectedValue(new Error('test-error'));
+            await expect(buildAccount.buildV2Sandbox(mockSandbox.name, mockParentAccountConfig, HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX, false, mockParentAccountConfig.env, false)).rejects.toThrow();
+        });
+    });
 });

package/lib/__tests__/yargsUtils.test.js

@@ -1,4 +1,4 @@
-import { hasFlag, makeYargsBuilder } from '../yargsUtils.js';
+import { hasFlag, makeYargsBuilder, getExclusiveConflicts, } from '../yargsUtils.js';
 import * as commonOpts from '../commonOpts.js';
 vi.mock('../commonOpts');
 const argvWithFlag = ['hs', 'command', '--test'];
@@ -36,4 +36,15 @@ describe('lib/yargsUtils', () => {
             expect(commonOpts.addCustomHelpOutput).toHaveBeenCalled();
         });
     });
+    describe('getExclusiveConflicts()', () => {
+        it('should return an object where each option conflicts with all others', () => {
+            const options = ['option1', 'option2', 'option3'];
+            const result = getExclusiveConflicts(options);
+            expect(result).toEqual({
+                option1: ['option2', 'option3'],
+                option2: ['option1', 'option3'],
+                option3: ['option1', 'option2'],
+            });
+        });
+    });
 });

package/lib/buildAccount.d.ts

@@ -1,7 +1,7 @@
 import { DeveloperTestAccountConfig } from '@hubspot/local-dev-lib/types/developerTestAccounts';
 import { Environment } from '@hubspot/local-dev-lib/types/Config';
 import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
-import { SandboxResponse } from '@hubspot/local-dev-lib/types/Sandbox';
+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<{
@@ -14,4 +14,7 @@ type SandboxAccount = SandboxResponse & {
     name: string;
 };
 export declare function buildSandbox(sandboxName: string, parentAccountConfig: CLIAccount, sandboxType: SandboxAccountType, env: Environment, force?: boolean): Promise<SandboxAccount>;
+export declare function buildV2Sandbox(sandboxName: string, parentAccountConfig: CLIAccount, sandboxType: SandboxAccountType, syncObjectRecords: boolean, env: Environment, force?: boolean): Promise<{
+    sandbox: V2Sandbox;
+}>;
 export {};

package/lib/buildAccount.js

@@ -4,14 +4,14 @@ import { getAccountIdentifier } from '@hubspot/local-dev-lib/config/getAccountId
 import { logger } from '@hubspot/local-dev-lib/logger';
 import { createDeveloperTestAccount, fetchDeveloperTestAccountGateSyncStatus, generateDeveloperTestAccountPersonalAccessKey, } from '@hubspot/local-dev-lib/api/developerTestAccounts';
 import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
-import { createSandbox } from '@hubspot/local-dev-lib/api/sandboxHubs';
+import { createSandbox, createV2Sandbox, getSandboxPersonalAccessKey, } from '@hubspot/local-dev-lib/api/sandboxHubs';
 import { personalAccessKeyPrompt } from './prompts/personalAccessKeyPrompt.js';
 import { createDeveloperTestAccountConfigPrompt } from './prompts/createDeveloperTestAccountConfigPrompt.js';
 import { i18n } from './lang.js';
 import { cliAccountNamePrompt } from './prompts/accountNamePrompt.js';
 import SpinniesManager from './ui/SpinniesManager.js';
 import { debugError, logError } from './errorHandlers/index.js';
-import { SANDBOX_API_TYPE_MAP, handleSandboxCreateError } from './sandboxes.js';
+import { SANDBOX_API_TYPE_MAP, SANDBOX_TYPE_MAP_V2, handleSandboxCreateError, } from './sandboxes.js';
 import { handleDeveloperTestAccountCreateError } from './developerTestAccounts.js';
 import { lib } from '../lang/en.js';
 import { poll } from './polling.js';
@@ -199,3 +199,58 @@ export async function buildSandbox(sandboxName, parentAccountConfig, sandboxType
     }
     return sandbox;
 }
+export async function buildV2Sandbox(sandboxName, parentAccountConfig, sandboxType, syncObjectRecords, env, force = false) {
+    let i18nKey;
+    if (sandboxType === HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX) {
+        i18nKey = 'lib.sandbox.create.loading.standard';
+    }
+    else {
+        i18nKey = 'lib.sandbox.create.loading.developer';
+    }
+    const id = getAccountIdentifier(parentAccountConfig);
+    const parentAccountId = getAccountId(id);
+    if (!parentAccountId) {
+        throw new Error(i18n(`${i18nKey}.fail`));
+    }
+    SpinniesManager.init({
+        succeedColor: 'white',
+    });
+    logger.log('');
+    SpinniesManager.add('buildV2Sandbox', {
+        text: i18n(`${i18nKey}.add`, {
+            accountName: sandboxName,
+        }),
+    });
+    let sandbox;
+    let pak;
+    try {
+        const sandboxTypeV2 = SANDBOX_TYPE_MAP_V2[sandboxType];
+        const { data } = await createV2Sandbox(parentAccountId, sandboxName, sandboxTypeV2, syncObjectRecords);
+        sandbox = { ...data };
+        const { data: { personalAccessKey }, } = await getSandboxPersonalAccessKey(parentAccountId, sandbox.sandboxHubId);
+        pak = personalAccessKey.encodedOAuthRefreshToken;
+        SpinniesManager.succeed('buildV2Sandbox', {
+            text: i18n(`${i18nKey}.succeed`, {
+                accountName: sandboxName,
+                accountId: sandbox.sandboxHubId,
+            }),
+        });
+    }
+    catch (e) {
+        debugError(e);
+        SpinniesManager.fail('buildV2Sandbox', {
+            text: i18n(`${i18nKey}.fail`, {
+                accountName: sandboxName,
+            }),
+        });
+        handleSandboxCreateError(e, env, sandboxName, parentAccountId);
+    }
+    try {
+        await saveAccountToConfig(sandbox.sandboxHubId, sandboxName, env, pak, force);
+    }
+    catch (err) {
+        logError(err);
+        throw err;
+    }
+    return { sandbox };
+}

package/lib/commonOpts.js

@@ -7,6 +7,7 @@ import { debugError } from './errorHandlers/index.js';
 import { EXIT_CODES } from './enums/exitCodes.js';
 import { uiCommandReference } from './ui/index.js';
 import { i18n } from './lang.js';
+import { getTerminalUISupport, UI_COLORS } from './ui/index.js';
 export function addGlobalOptions(yargs) {
     yargs.version(false);
     yargs.option('debug', {
@@ -76,8 +77,32 @@ export function addJSONOutputOptions(yargs) {
         hidden: true,
     });
 }
+// Remove this once we've upgraded to yargs 18.0.0
+function uiBetaTagWithColor(message) {
+    const terminalUISupport = getTerminalUISupport();
+    const tag = i18n(`lib.ui.betaTagWithStyle`);
+    const result = `${terminalUISupport.color ? chalk.hex(UI_COLORS.SORBET)(tag) : tag} ${message}`;
+    return result;
+}
+// Remove this once we've upgraded to yargs 18.0.0
+function uiDeprecatedTagWithColor(message) {
+    const terminalUISupport = getTerminalUISupport();
+    const tag = i18n(`lib.ui.deprecatedTagWithStyle`);
+    const result = `${terminalUISupport.color ? chalk.yellow(tag) : tag} ${message}`;
+    return result;
+}
 export async function addCustomHelpOutput(yargs, command, describe) {
     try {
+        // Remove this once we've upgraded to yargs 18.0.0
+        if (describe && describe.includes(i18n(`lib.ui.betaTag`))) {
+            describe = describe.replace(i18n(`lib.ui.betaTag`) + ' ', '');
+            describe = uiBetaTagWithColor(describe);
+        }
+        // Remove this once we've upgraded to yargs 18.0.0
+        if (describe && describe.includes(i18n(`lib.ui.deprecatedTag`))) {
+            describe = describe.replace(i18n(`lib.ui.deprecatedTag`) + ' ', '');
+            describe = uiDeprecatedTagWithColor(describe);
+        }
         const parsedArgv = yargsParser(process.argv.slice(2));
         if (parsedArgv && parsedArgv.help) {
             const commandBase = `hs ${parsedArgv._.slice(0, -1).join(' ')}`;

package/lib/configOptions.d.ts

@@ -15,3 +15,8 @@ export declare function setHttpTimeout({ accountId, httpTimeout, }: {
     accountId: number;
     httpTimeout?: string;
 }): Promise<void>;
+export declare function setAutoOpenBrowser({ accountId, autoOpenBrowser, }: {
+    accountId: number;
+    autoOpenBrowser: boolean;
+}): Promise<void>;
+export declare function isAutoOpenBrowserEnabled(): boolean;

package/lib/configOptions.js

@@ -1,4 +1,4 @@
-import { updateAllowUsageTracking, updateAllowAutoUpdates, updateDefaultCmsPublishMode, updateHttpTimeout, } from '@hubspot/local-dev-lib/config';
+import { updateAllowUsageTracking, updateAllowAutoUpdates, updateDefaultCmsPublishMode, updateHttpTimeout, isConfigFlagEnabled, updateAutoOpenBrowser, } from '@hubspot/local-dev-lib/config';
 import { CMS_PUBLISH_MODE } from '@hubspot/local-dev-lib/constants/files';
 import { commaSeparatedValues } from '@hubspot/local-dev-lib/text';
 import { trackCommandUsage } from './usageTracking.js';
@@ -95,3 +95,13 @@ export async function setHttpTimeout({ accountId, httpTimeout, }) {
     updateHttpTimeout(newHttpTimeout);
     uiLogger.success(lib.configOptions.setHttpTimeout.success(newHttpTimeout));
 }
+export async function setAutoOpenBrowser({ accountId, autoOpenBrowser, }) {
+    trackCommandUsage('config-set-auto-open-browser', undefined, accountId);
+    updateAutoOpenBrowser(autoOpenBrowser);
+    uiLogger.success(autoOpenBrowser
+        ? lib.configOptions.setAutoOpenBrowser.enabled
+        : lib.configOptions.setAutoOpenBrowser.disabled);
+}
+export function isAutoOpenBrowserEnabled() {
+    return isConfigFlagEnabled('autoOpenBrowser', true);
+}

package/lib/constants.d.ts

@@ -78,6 +78,8 @@ export declare const APP_AUTH_TYPES: {
 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";
 };
 export declare const LOCAL_DEV_UI_MESSAGE_SEND_TYPES: {
     UPLOAD_SUCCESS: string;
@@ -88,6 +90,7 @@ export declare const LOCAL_DEV_UI_MESSAGE_SEND_TYPES: {
 };
 export declare const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES: {
     UPLOAD: string;
+    VIEWED_WELCOME_SCREEN: string;
 };
 export declare const APP_INSTALLATION_STATES: {
     readonly NOT_INSTALLED: "NOT_INSTALLED";
@@ -107,3 +110,8 @@ export declare const LOCAL_DEV_SERVER_MESSAGE_TYPES: {
     readonly INITIAL: "INITIAL";
     readonly WEBSOCKET_SERVER_CONNECTED: "WEBSOCKET_SERVER_CONNECTED";
 };
+export declare const CONFIG_LOCAL_STATE_FLAGS: {
+    readonly LOCAL_DEV_UI_WELCOME: "LOCAL_DEV_UI_WELCOME";
+};
+export declare const EMPTY_PROJECT = "empty";
+export declare const PROJECT_WITH_APP = "app";

package/lib/constants.js

@@ -70,6 +70,8 @@ export const APP_AUTH_TYPES = {
 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',
 };
 export const LOCAL_DEV_UI_MESSAGE_SEND_TYPES = {
     UPLOAD_SUCCESS: 'server:uploadSuccess',
@@ -80,6 +82,7 @@ export const LOCAL_DEV_UI_MESSAGE_SEND_TYPES = {
 };
 export const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES = {
     UPLOAD: 'client:upload',
+    VIEWED_WELCOME_SCREEN: 'client:viewedWelcomeScreen',
 };
 export const APP_INSTALLATION_STATES = {
     NOT_INSTALLED: 'NOT_INSTALLED',
@@ -99,3 +102,8 @@ export const LOCAL_DEV_SERVER_MESSAGE_TYPES = {
     INITIAL: 'INITIAL',
     WEBSOCKET_SERVER_CONNECTED: 'WEBSOCKET_SERVER_CONNECTED',
 };
+export const CONFIG_LOCAL_STATE_FLAGS = {
+    LOCAL_DEV_UI_WELCOME: 'LOCAL_DEV_UI_WELCOME',
+};
+export const EMPTY_PROJECT = 'empty';
+export const PROJECT_WITH_APP = 'app';

package/lib/errorHandlers/index.js

@@ -5,6 +5,7 @@ import { shouldSuppressError } from './suppressError.js';
 import { i18n } from '../lang.js';
 import util from 'util';
 import { uiCommandReference } from '../ui/index.js';
+import { isProjectValidationError } from '../errors/ProjectValidationError.js';
 export function logError(error, context) {
     debugError(error, context);
     if (isProjectValidationError(error)) {
@@ -84,9 +85,6 @@ export class ApiErrorContext {
         this.projectName = props.projectName || '';
     }
 }
-function isProjectValidationError(error) {
-    return error instanceof Error && error.name === 'ProjectValidationError';
-}
 function isErrorWithMessageOrReason(error) {
     return (typeof error === 'object' &&
         error !== null &&

package/lib/errors/ProjectValidationError.d.ts

@@ -0,0 +1,4 @@
+export default class ProjectValidationError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function isProjectValidationError(err: unknown): err is ProjectValidationError;

package/lib/errors/ProjectValidationError.js

@@ -0,0 +1,9 @@
+export default class ProjectValidationError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ProjectValidationError';
+    }
+}
+export function isProjectValidationError(err) {
+    return err instanceof ProjectValidationError;
+}

package/lib/mcp/setup.d.ts

@@ -7,6 +7,9 @@ export declare const supportedTools: ({
 } | {
     name: "Windsurf";
     value: string;
+} | {
+    name: "VSCode";
+    value: string;
 })[];
 interface McpCommand {
     command: string;
@@ -15,6 +18,7 @@ interface McpCommand {
 export declare function addMintlifyMcpServer(installTargets: string[]): Promise<void>;
 export declare function setupMintlify(derivedTargets?: string[]): Promise<boolean>;
 export declare function addMcpServerToConfig(targets: string[] | undefined): Promise<string[]>;
+export declare function setupVsCode(mcpCommand?: McpCommand): Promise<boolean>;
 export declare function setupClaudeCode(mcpCommand?: McpCommand): Promise<boolean>;
 export declare function setupCursor(mcpCommand?: McpCommand): boolean;
 export declare function setupWindsurf(mcpCommand?: McpCommand): boolean;

package/lib/mcp/setup.js

@@ -13,11 +13,13 @@ const mcpServerName = 'hubspot-cli-mcp';
 const claudeCode = 'claude';
 const windsurf = 'windsurf';
 const cursor = 'cursor';
+const vscode = 'vscode';
 const supportedMintlifyClients = [windsurf, cursor];
 export const supportedTools = [
     { name: commands.mcp.setup.claudeCode, value: claudeCode },
     { name: commands.mcp.setup.cursor, value: cursor },
     { name: commands.mcp.setup.windsurf, value: windsurf },
+    { name: commands.mcp.setup.vsCode, value: vscode },
 ];
 const defaultMcpCommand = {
     command: 'hs',
@@ -75,6 +77,9 @@ export async function addMcpServerToConfig(targets) {
         if (derivedTargets.includes(windsurf)) {
             await runSetupFunction(setupWindsurf);
         }
+        if (derivedTargets.includes(vscode)) {
+            await runSetupFunction(setupVsCode);
+        }
         uiLogger.info(commands.mcp.setup.success(derivedTargets));
         return derivedTargets;
     }
@@ -150,6 +155,37 @@ function setupMcpConfigFile(config) {
         return false;
     }
 }
+export async function setupVsCode(mcpCommand = defaultMcpCommand) {
+    try {
+        SpinniesManager.add('vsCode', {
+            text: commands.mcp.setup.spinners.configuringVsCode,
+        });
+        const mcpConfig = JSON.stringify({
+            name: mcpServerName,
+            ...buildCommandWithAgentString(mcpCommand, vscode),
+        });
+        await execAsync(`code --add-mcp '${mcpConfig}'`);
+        SpinniesManager.succeed('vsCode', {
+            text: commands.mcp.setup.spinners.configuredVsCode,
+        });
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message.includes('code: command not found')) {
+            SpinniesManager.fail('vsCode', {
+                text: commands.mcp.setup.spinners.vsCodeNotFound,
+            });
+        }
+        else {
+            SpinniesManager.fail('vsCode', {
+                text: commands.mcp.setup.spinners.failedToConfigureVsCode,
+            });
+            logError(error);
+        }
+        return false;
+    }
+}
 export async function setupClaudeCode(mcpCommand = defaultMcpCommand) {
     try {
         SpinniesManager.add('claudeCode', {

package/lib/projects/__tests__/LocalDevProcess.test.js

@@ -16,6 +16,7 @@ vi.mock('@hubspot/ui-extensions-dev-server', () => ({
         cleanup: vi.fn().mockResolvedValue(undefined),
     },
 }));
+vi.mock('open');
 vi.mock('@hubspot/project-parsing-lib');
 vi.mock('../upload');
 vi.mock('../config');
@@ -306,4 +307,38 @@ describe('LocalDevProcess', () => {
             expect(listener).toHaveBeenCalledWith(process.projectNodes);
         });
     });
+    describe('removeStateListener()', () => {
+        it('should remove state listener', () => {
+            const listener = vi.fn();
+            const key = 'projectNodes';
+            // Add the listener first
+            process.addStateListener(key, listener);
+            // Trigger state change to verify listener is called
+            // @ts-expect-error
+            process.state.projectNodes = {};
+            expect(listener).toHaveBeenCalledTimes(1);
+            // Remove the listener
+            process.removeStateListener(key, listener);
+            // Trigger state change again to verify listener is no longer called
+            // @ts-expect-error
+            process.state.projectNodes = { newNode: { uid: 'newNode' } };
+            expect(listener).toHaveBeenCalledTimes(1); // Should still be 1, not 2
+        });
+        it('should not affect other listeners when removing one', () => {
+            const listener1 = vi.fn();
+            const listener2 = vi.fn();
+            const key = 'projectNodes';
+            // Add two listeners
+            process.addStateListener(key, listener1);
+            process.addStateListener(key, listener2);
+            // Remove only the first listener
+            process.removeStateListener(key, listener1);
+            // Trigger state change
+            // @ts-expect-error
+            process.state.projectNodes = {};
+            // Only listener2 should be called
+            expect(listener1).not.toHaveBeenCalled();
+            expect(listener2).toHaveBeenCalled();
+        });
+    });
 });