@hubspot/cli 7.7.16-experimental.0 → 7.7.16-experimental.10

package/lang/en.js

@@ -22,6 +22,55 @@ exports.commands = {
             configFileExists: (configPath) => `A configuration file already exists at ${configPath}. To specify a new configuration file, delete the existing one and try again.`,
         },
     },
+    getStarted: {
+        options: {
+            dest: {
+                describe: 'Directory where the project should be created',
+            },
+            name: {
+                describe: 'Project name (cannot be changed)',
+            },
+            templateSource: {
+                describe: 'Path to custom GitHub repository from which to create project template',
+            },
+        },
+        startTitle: 'Welcome to HubSpot Development!',
+        verboseDescribe: 'A step-by-step command to get you started with a HubSpot project.',
+        startDescription: 'You can use the HubSpot CLI to build apps, CMS themes, and more.',
+        designManager: 'To onboard with CMS, please visit the HubSpot Design Manager in your account and follow the checklist items.',
+        openDesignManager: 'Click here to go to the HubSpot Design Manager',
+        openDesignManagerPrompt: 'Open Design Manager in your browser?',
+        openedDesignManager: 'Redirected to Design Manager!',
+        developerOverviewBrowserOpenPrep: "We'll take you to your HubSpot account and walk you through installing and previewing your new app.",
+        openInstallUrl: 'Open HubSpot to install your app in your account?',
+        openedDeveloperOverview: 'HubSpot opened!',
+        prompts: {
+            selectOption: 'Are you looking to build apps or CMS?',
+            options: {
+                app: 'App',
+                cms: 'CMS',
+            },
+            installDependencies: 'Would you like to install dependencies now?',
+            uploadProject: 'Would you like to upload your project to HubSpot now?',
+            projectCreated: {
+                title: chalk_1.default.bold('Next steps:'),
+                description: `Let's prepare and upload your project to HubSpot.\nYou can use ${(0, ui_1.uiCommandReference)('hs project install-deps')} to ${chalk_1.default.bold('install dependencies')} and ${(0, ui_1.uiCommandReference)('hs project upload')} to ${chalk_1.default.bold('upload')} your project.`,
+            },
+        },
+        logs: {
+            appSelected: `We'll create a new project with a sample app for you.\nProjects are what you can use to create apps, themes, and more at HubSpot.\nUsually you'll use the ${(0, ui_1.uiCommandReference)('hs project create')} command, but we'll go ahead and make one now.`,
+            dependenciesInstalled: 'Dependencies installed successfully.',
+            dependenciesNotInstalled: `Dependencies not installed. Remember to do this later with the command ${(0, ui_1.uiCommandReference)('hs project install-deps')} from the project directory.`,
+            uploadingProject: 'Uploading your project to HubSpot...',
+            uploadSuccess: 'Project uploaded successfully!',
+            developerOverviewLink: 'Open this link to navigate to your HubSpot developer portal',
+        },
+        errors: {
+            uploadFailed: 'Failed to upload project to HubSpot.',
+            configFileNotFound: 'Could not find project configuration for upload.',
+            installDepsFailed: 'Failed to install dependencies.',
+        },
+    },
     completion: {
         describe: 'Enable bash completion shortcuts for commands. Concat the generated script to your .bashrc, .bash_profile, or .zshrc file.',
         examples: {
@@ -151,8 +200,11 @@ exports.commands = {
         },
     },
     auth: {
-        describe: (configName) => `Configure authentication for your HubSpot account. This will update the ${configName} file that stores your account information.`,
+        describe: 'Configure authentication for your HubSpot account.',
+        verboseDescribe: (configName, authMethod) => `Configure authentication for a HubSpot account. This will update the ${configName} file that stores your account information.\n\nThe recommended authentication method is ${chalk_1.default.bold(authMethod)}, which uses an access token tied to a specific user account.`,
         errors: {
+            invalidAccountIdProvided: `--account must be a number.`,
+            globalConfigFileExists: (accountAuthCommand) => `You are using our new global configuration for account management, which is not compatible with this command. Please use ${(0, ui_1.uiCommandReference)(accountAuthCommand)} instead.`,
             noConfigFileFound: 'No config file was found. To create a new config file, use the "hs init" command.',
             unsupportedAuthType: (type, supportedProtocols) => `Unsupported auth type: ${type}. The only supported authentication protocols are ${supportedProtocols}.`,
         },
@@ -699,7 +751,8 @@ exports.commands = {
         },
     },
     init: {
-        describe: (configName) => `Configure authentication for your HubSpot account. This will create a ${configName} file to store your account information.`,
+        describe: 'Create a CLI config file and configure authentication for your HubSpot account.',
+        verboseDescribe: (configName, command, authMethod) => `Configure authentication for a HubSpot account. This will create a ${configName} file to store your account information. To configure authentication for additional accounts, run ${command}.\n\nThe recommended authentication method is ${chalk_1.default.bold(authMethod)}, which uses an access token tied to a specific user account.`,
         options: {
             authType: {
                 describe: 'Authentication mechanism',
@@ -714,14 +767,16 @@ exports.commands = {
         },
         success: {
             configFileCreated: (configPath) => `Created config file "${configPath}"`,
-            configFileUpdated: (account, authType) => `Connected account "${account}" using "${authType}" and set it as the default account`,
+            configFileUpdated: (authType, account) => `Connected account "${account}" using "${authType}" and set it as the default account`,
         },
         logs: {
             updateConfig: 'To update an existing config file, use the "hs auth" command.',
         },
         errors: {
+            invalidAccountIdProvided: `--account must be a number.`,
             configFileExists: (configPath) => `The config file ${configPath} already exists.`,
             bothConfigFilesNotAllowed: (path) => `Unable to create config file, because there is an existing one at "${path}". To create a new config file, delete the existing one and try again.`,
+            globalConfigFileExists: `You are using our new global configuration for account management, which is not compatible with this command. Please use ${(0, ui_1.uiCommandReference)('hs account auth')} instead.`,
         },
     },
     lint: {
@@ -788,7 +843,7 @@ exports.commands = {
                 client: 'Target applications to configure',
                 docsSearch: 'Should the docs search mcp server be installed',
             },
-            success: (derivedTargets) => `You can now use the HubSpot CLI tools in ${derivedTargets.join(', ')}.  ${chalk_1.default.bold('You may need to restart these tools to apply the changes')}.`,
+            success: (derivedTargets) => `You can now use the HubSpot CLI MCP Server in ${derivedTargets.join(', ')}.  ${chalk_1.default.bold('You may need to restart these tools to apply the changes')}.`,
             errors: {
                 needsNode20: `This feature requires node >=20`,
             },
@@ -802,13 +857,11 @@ exports.commands = {
                 claudeCodeInstallFailed: 'Claude Code CLI not working - skipping configuration',
                 failedToConfigureClaudeDesktop: 'Failed to configure Claude Desktop',
                 configuringCursor: 'Configuring Cursor...',
-                noCursorMcpFile: (configFile) => `No ${configFile} file found - skipping Cursor configuration`,
                 failedToConfigureCursor: 'Failed to configure Cursor',
                 configuredCursor: 'Configured Cursor',
                 alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
-                configuringWindsurf: 'Configuring Cursor...',
-                noWindsurfFile: (configFile) => `No ${configFile} file found - skipping Windsurf configuration`,
-                failedToConfigureWindsurf: 'Failed to configure Cursor',
+                configuringWindsurf: 'Configuring Windsurf...',
+                failedToConfigureWindsurf: 'Failed to configure Windsurf',
                 configuredWindsurf: 'Configured Windsurf',
             },
             prompts: {
@@ -1322,6 +1375,20 @@ exports.commands = {
             noPackageJsonInProject: (projectName, link) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${link}`,
             packageManagerNotInstalled: (packageManager, link) => `This command depends on ${packageManager}, install ${chalk_1.default.bold(link)}`,
         },
+        validate: {
+            describe: 'Validate the project before uploading',
+            mustBeRanWithinAProject: 'This command must be run from within a project directory.',
+            badVersion: 'This command is only available for projects 2025.2 and later.',
+            examples: {
+                default: 'Validate the project before uploading',
+            },
+            success: (projectName) => `Project ${projectName} is valid and ready to upload`,
+            options: {
+                profile: {
+                    describe: 'The profile to target for this validation',
+                },
+            },
+        },
     },
     remove: {
         describe: 'Delete a file or folder from the HubSpot CMS.',
@@ -1433,6 +1500,28 @@ exports.commands = {
     app: {
         describe: 'Commands for managing apps.',
         subcommands: {
+            install: {
+                describe: 'Install an OAuth app into a test account.',
+                options: {
+                    appUid: 'The uid of the app to install',
+                    projectName: 'The name of the project that contains the app',
+                },
+                positionals: {
+                    testAccountId: 'The id of the test account to install the app into',
+                },
+                errors: {
+                    mustSpecifyProjectName: `You must specify a project name. Use the ${(0, ui_1.uiCommandReference)('--project-name')} flag to specify the project name or run this command from within a project directory.`,
+                    noAppUidFound: `No app uid found. Please specify the app uid with the ${(0, ui_1.uiCommandReference)('--app-uid')} flag or run this command from within a project that contains an app.`,
+                    appMustBeOauth: 'This command only supports installing oauth apps. Please specify an app with oauth auth type.',
+                },
+                polling: {
+                    start: 'Installing app...',
+                    success: 'App installed successfully',
+                    failure: 'App installation failed',
+                    error: 'Error installing app',
+                },
+                example: 'Install the app with uid my-app-uid from the project named "my-project" into the target account with id 1234567890',
+            },
             secret: {
                 describe: 'Commands for managing secrets.',
                 subcommands: {
@@ -1726,6 +1815,66 @@ exports.commands = {
             missingSrc: 'Please specify the path to your javascript fields file or directory with the --src flag.',
         },
     },
+    testAccount: {
+        describe: 'Commands for working with test accounts.',
+        create: {
+            describe: 'Create a test account from a config file',
+            configPathPrompt: '[--config-path] Enter the path to the test account config: ',
+            createTestAccountFromConfigPrompt: 'How would you like to create your test account?',
+            createFromConfigOption: 'Create test account from config file',
+            createFromScratchOption: 'Create test account from scratch',
+            errors: {
+                configFileNotFound: (configPath) => `No test account config file exists at ${configPath}. Create a test account config file with the ${(0, ui_1.uiCommandReference)('hs test-account create-config')} command.`,
+                configFileParseFailed: (configPath) => `Failed to parse test account config file at ${configPath}`,
+            },
+            polling: {
+                start: (testAccountName) => `Creating test account "${chalk_1.default.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_1.default.bold(testAccountName)}" successfully created with id: ${chalk_1.default.bold(testAccountId)}`,
+                createFailure: 'Failed to create test account.',
+                syncFailure: 'Failed to sync data into test account. The account may not be ready to use.',
+                pakFailure: 'Failed to generate a personal access key for the test account.',
+            },
+            options: {
+                configPath: 'The path to the test account config',
+            },
+            example: (configPath) => `Create a test account from the config file at ${configPath}`,
+        },
+        createConfig: {
+            describe: 'Create a test account config file.',
+            pathPrompt: '[--path] What is the path to the test account config?',
+            errors: {
+                pathError: 'Path is required',
+                pathFormatError: 'Path must end with .json',
+                failedToCreate: 'Failed to create test account config',
+                pathExistsError: 'A file already exists at this path. Please try again with a different path.',
+            },
+            success: {
+                configFileCreated: (path) => `Test account config successfully created at ${path}`,
+            },
+            options: {
+                name: 'The name of the test account',
+                description: 'The description of the test account',
+                tiers: 'The tiers of the test account',
+                path: 'The path to the test account config',
+            },
+            example: (name) => `Create a test account config file with the name "${name}"`,
+        },
+        delete: {
+            describe: 'Delete a test account config file.',
+            pathPrompt: '[--path] What is the path to the test account config?',
+            errors: {
+                failedToDelete: 'Failed to delete test account',
+            },
+            success: {
+                testAccountDeleted: (testAccountId) => `Test account with id ${testAccountId} successfully deleted`,
+            },
+            positionals: {
+                testAccountId: 'The id of the test account',
+            },
+            example: (testAccountId) => `Delete a test account with the id "${testAccountId}"`,
+        },
+    },
     secrets: {
         add: {
             loading: {
@@ -2311,6 +2460,12 @@ exports.commands = {
     },
 };
 exports.lib = {
+    parsing: {
+        unableToParseStringToNumber: 'Unable to parse string to number',
+    },
+    configMiddleWare: {
+        invalidAccountIdEnvironmentVariable: 'Unable to parse `HUBSPOT_ACCOUNT_ID` environment variable into a number',
+    },
     process: {
         exitDebug: (signal) => `Attempting to gracefully exit. Triggered by ${signal}`,
     },
@@ -2320,7 +2475,6 @@ exports.lib = {
         noCompatibleComponents: (serverKey) => `Skipping call to ${serverKey} because there are no compatible components in the project.`,
     },
     LocalDevManager: {
-        staticAuthAccountsMustMatch: 'You must test static auth apps in the account the project exists in',
         appNotFound: (accountId, appUid) => `Unable to find app with uid ${appUid} in account ${(0, ui_1.uiAccountDescription)(accountId)}`,
         failedToInitialize: 'Missing required arguments to initialize Local Dev',
         noDeployedBuild: (projectName, accountIdentifier, uploadCommand) => `Your project ${chalk_1.default.bold(projectName)} exists in ${accountIdentifier}, but has no deployed build. Projects must be successfully deployed to be developed locally. Address any build and deploy errors your project may have, then run ${uploadCommand} to upload and deploy your project.`,
@@ -2365,6 +2519,9 @@ exports.lib = {
     },
     AppDevModeInterface: {
         defaultMarketplaceAppWarning: (installCount) => `\n\nYour marketplace app is currently installed in ${chalk_1.default.bold(`${installCount} ${installCount === 1 ? 'account' : 'accounts'}`)}. Any uploaded changes will impact your app's users. We strongly recommend creating a copy of this app to test your changes before proceding.`,
+        autoInstallDeclined: 'You must install your app on your target test account to proceed with local development.',
+        autoInstallSuccess: (appName, targetTestAccountId) => `Successfully installed app ${appName} on account ${(0, ui_1.uiAccountDescription)(targetTestAccountId)}\n`,
+        autoInstallError: (appName, targetTestAccountId) => `Error installing app ${appName} on account ${(0, ui_1.uiAccountDescription)(targetTestAccountId)}. You may still be able to install your app in your browser.`,
     },
     LocalDevWebsocketServer: {
         errors: {
@@ -2477,6 +2634,9 @@ exports.lib = {
                 invalidAuthDistCombo: (authType, distribution) => `Invalid distribution and auth combination. Apps with distribution '${distribution}' must have auth '${authType}'`,
             },
         },
+        add: {
+            nothingAdded: 'No features added.',
+        },
         validateProjectConfig: {
             configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${(0, ui_1.uiCommandReference)('hs project create')} to create a new project.`,
             configMissingFields: 'The project configuration file is missing required fields.',
@@ -2513,8 +2673,8 @@ exports.lib = {
         pollProjectBuildAndDeploy: {
             buildSucceededAutomaticallyDeploying: (buildId, accountIdentifier) => `Build #${buildId} succeeded. ${chalk_1.default.bold('Automatically deploying')} to ${accountIdentifier}\n`,
             cleanedUpTempFile: (path) => `Cleaned up temporary file ${path}`,
-            viewDeploys: 'View all deploys for this project in HubSpot',
-            unableToFindAutodeployStatus: (buildId, viewDeploysLink) => `Unable to find the auto deploy for build #${buildId}. This deploy may have been skipped. ${viewDeploysLink}.`,
+            viewDeploys: 'view all deploys for this project in HubSpot',
+            unableToFindAutodeployStatus: (buildId, viewDeploysLink) => `Unable to find the auto deploy for build #${buildId}. This deploy may have been skipped or blocked due to components being removed. Manually deploy with ${(0, ui_1.uiCommandReference)('hs project deploy')} or ${viewDeploysLink}.`,
         },
     },
     projectUpload: {
@@ -2594,7 +2754,7 @@ exports.lib = {
                 },
                 projectDevCommand: {
                     command: 'hs project dev',
-                    message: (command) => `Run ${command} to set up your test environment and start local development`,
+                    message: (command) => `Run ${command} from within your project directory to set up your test environment and start local development`,
                 },
                 projectInstallDepsCommand: {
                     command: 'hs project install-deps',
@@ -2650,31 +2810,18 @@ exports.lib = {
     },
     commonOpts: {
         options: {
-            account: {
-                describe: 'HubSpot account id or name from config',
-            },
-            config: {
-                describe: 'Path to a config file',
-            },
-            overwrite: {
-                describe: 'Overwrite existing files',
-            },
+            account: 'HubSpot account id or name from config',
+            config: 'Path to a config file',
+            overwrite: 'Overwrite existing files',
             modes: {
-                describe: {
-                    default: (modes) => `${modes}`,
-                    read: (modes) => `Read from ${modes}`,
-                    write: (modes) => `Write to ${modes}`,
-                },
-            },
-            qa: {
-                describe: 'Run command in QA mode',
-            },
-            useEnv: {
-                describe: 'Use environment variable config',
-            },
-            debug: {
-                describe: 'Set log level to debug',
+                default: (modes) => `${modes}`,
+                read: (modes) => `Read from ${modes}`,
+                write: (modes) => `Write to ${modes}`,
             },
+            qa: 'Run command in QA mode',
+            useEnv: 'Use environment variable config',
+            jsonOutput: 'Format output as JSON',
+            debug: 'Set log level to debug',
         },
     },
     configMigrate: {
@@ -2716,6 +2863,14 @@ exports.lib = {
             setAsDefaultAccount: (accountName) => `Account "${accountName}" set as the default account`,
             keepingCurrentDefault: (accountName) => `Account "${accountName}" will continue to be the default account`,
         },
+        createDeveloperTestAccountConfigPrompt: {
+            namePrompt: '[--name] What is the name of the test account?',
+            descriptionPrompt: '[--description] What is the description of the test account?',
+            tiersPrompt: '[--tiers] Which product tiers should the test account have?',
+            errors: {
+                tiersError: 'Cannot have more than one tier per hub',
+            },
+        },
         accountNamePrompt: {
             enterAccountName: 'Enter a unique name to reference this account in the CLI:',
             enterDeveloperTestAccountName: 'Name your developer test account:',
@@ -2790,16 +2945,20 @@ exports.lib = {
                 languageRequired: "Please select API sample app's language",
             },
         },
-        createProjectPrompt: {
+        projectNameAndDestPrompt: {
             enterName: '[--name] Give your project a name: ',
             enterDest: '[--dest] Enter the folder to create the project in:',
-            selectTemplate: '[--template] Choose a project template: ',
-            features: '[--features] Which features would you like your app to include?',
             errors: {
                 nameRequired: 'A project name is required',
                 destRequired: 'A project dest is required',
                 invalidDest: 'There is an existing project at this destination. Please provide a new path for this project.',
                 invalidCharacters: 'The selected destination contains invalid characters. Please provide a new path and try again.',
+            },
+        },
+        selectProjectTemplatePrompt: {
+            selectTemplate: '[--template] Choose a project template: ',
+            features: '[--features] Which features would you like your app to include?',
+            errors: {
                 invalidTemplate: (template) => `[--template] Could not find template "${template}". Please choose an available template:`,
                 projectTemplateRequired: 'Project template is required when projectTemplates is provided',
             },
@@ -2888,6 +3047,7 @@ exports.lib = {
             explanation: 'Local development requires this app to be installed in the target test account',
             reinstallExplanation: "This app's required scopes have been updated since it was last installed on the target test account. To avoid issues with local development, we recommend reinstalling the app with the updated scopes.",
             prompt: 'Open HubSpot to install this app?',
+            autoPrompt: 'Install this app in your target test account?',
             reinstallPrompt: 'Open HubSpot to reinstall this app?',
             decline: `To continue local development of this app, install it in your target test account and re-run ${chalk_1.default.bold('`hs project dev`')}`,
         },
@@ -2903,6 +3063,9 @@ exports.lib = {
             },
         },
     },
+    polling: {
+        timeoutError: (timeoutMs) => `Polling timed out after ${timeoutMs}ms.`,
+    },
     convertFields: {
         positionals: {
             src: {

package/lang/en.lyaml

@@ -694,6 +694,7 @@ en:
             buildIdDoesNotExist: "Build {{ buildId }} does not exist for project {{ projectName }}. {{ linkToProject }}"
             buildAlreadyDeployed: "Build {{ buildId }} is already deployed. {{ linkToProject}}"
             viewProjectsBuilds: 'View project builds in HubSpot'
+            deployContainsRemovals: "- This deploy would remove the {{#bold}}{{ componentName }}{{/bold}} component. To proceed, run the deploy command with the {{ forceFlag }} flag"
           examples:
             default: "Deploy the latest build of the current project"
             withOptions: "Deploy build 5 of the project my-project"
@@ -704,6 +705,8 @@ en:
               describe: "Project name"
             profile:
               describe: "The profile to target with this deploy"
+            force:
+              describe: "Skip warnings and force deploy. Use this carefully as it will bypass warnings for destructive actions."
         listBuilds:
           describe: "List the project's builds."
           continueOrExitPrompt: "Press <enter> to load more, or ctrl+c to exit"
@@ -1049,19 +1052,6 @@ en:
       logFeedbackMessage:
         feedbackHeader: "We'd love to hear your feedback!"
         feedbackMessage: "How are you liking the new projects and developer tools? \n > Run `{{#yellow}}hs feedback{{/yellow}}` to let us know what you think!\n"
-    projectBuildAndDeploy:
-      makePollTaskStatusFunc:
-        componentCountSingular: "Found 1 component in this project"
-        componentCount: "Found {{ numComponents }} components in this project"
-        successStatusText: "DONE"
-        failedStatusText: "FAILED"
-        errorFetchingTaskStatus: "An error occurred while fetching the status of the current {{ taskType }}. For more information, view this project in HubSpot by running {{ openCommand }}."
-      pollBuildAutodeployStatusError: "Error fetching autodeploy status for build #{{ buildId }}"
-      pollProjectBuildAndDeploy:
-        buildSucceededAutomaticallyDeploying: "Build #{{ buildId }} succeeded. {{#bold}}Automatically deploying{{/bold}} to {{ accountIdentifier }}\n"
-        cleanedUpTempFile: "Cleaned up temporary file {{ path }}"
-        viewDeploys: "View all deploys for this project in HubSpot"
-        unableToFindAutodeployStatus: "Unable to find the auto deploy for build #{{ buildId }}. This deploy may have been skipped. {{ viewDeploysLink }}."
     projectUpload:
       uploadProjectFiles:
         add: "Uploading {{#bold}}{{ projectName }}{{/bold}} project files to {{ accountIdentifier }}"
@@ -1107,6 +1097,9 @@ en:
           feedbackCommand:
             command: "hs feedback"
             message: "Run {{ command }} to report a bug or leave feedback"
+          getStartedCommand:
+            command: "hs get-started"
+            message: "Run {{ command }} to get started with HubSpot development"
           helpCommand:
             command: "hs help"
             message: "Run {{ command }} to see a list of available commands"
@@ -1124,7 +1117,7 @@ en:
             message: "Run {{ command }} to upload your project to your HubSpot account"
           projectDevCommand:
             command: "hs project dev"
-            message: "Run {{ command }} to set up your test environment and start local development"
+            message: "Run {{ command }} from within your project directory to set up your test environment and start local development"
           projectInstallDepsCommand:
             command: "hs project install-deps"
             message: "Run {{ command }} to install dependencies for your project components"
@@ -1165,6 +1158,8 @@ en:
           describe: "Use environment variable config"
         debug:
           describe: "Set log level to debug"
+        jsonOutput:
+          describe: "Format output as JSON"
     prompts:
       projectDevTargetAccountPrompt:
         createNewSandboxOption: "<Test on a new development sandbox>"

package/lib/accountTypes.d.ts

@@ -5,4 +5,5 @@ export declare function isStandardSandbox(accountConfig: CLIAccount): boolean;
 export declare function isDevelopmentSandbox(accountConfig: CLIAccount): boolean;
 export declare function isDeveloperTestAccount(accountConfig: CLIAccount): boolean;
 export declare function isAppDeveloperAccount(accountConfig: CLIAccount): boolean;
+export declare function isTestAccountOrSandbox(accountConfig: CLIAccount): boolean;
 export declare function isUnifiedAccount(account: CLIAccount): Promise<boolean>;

package/lib/accountTypes.js

@@ -6,33 +6,44 @@ exports.isStandardSandbox = isStandardSandbox;
 exports.isDevelopmentSandbox = isDevelopmentSandbox;
 exports.isDeveloperTestAccount = isDeveloperTestAccount;
 exports.isAppDeveloperAccount = isAppDeveloperAccount;
+exports.isTestAccountOrSandbox = isTestAccountOrSandbox;
 exports.isUnifiedAccount = isUnifiedAccount;
 const config_1 = require("@hubspot/local-dev-lib/constants/config");
 const hasFeature_1 = require("./hasFeature");
 const constants_1 = require("./constants");
 const getAccountIdentifier_1 = require("@hubspot/local-dev-lib/config/getAccountIdentifier");
 function isAccountType(accountConfig, accountType) {
-    return (Boolean(accountConfig.accountType) &&
-        accountConfig.accountType === accountType);
+    return Boolean(accountConfig.accountType && accountType.includes(accountConfig.accountType));
 }
 function isStandardAccount(accountConfig) {
-    return isAccountType(accountConfig, config_1.HUBSPOT_ACCOUNT_TYPES.STANDARD);
+    return isAccountType(accountConfig, [config_1.HUBSPOT_ACCOUNT_TYPES.STANDARD]);
 }
 function isSandbox(accountConfig) {
-    return (isAccountType(accountConfig, config_1.HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX) ||
-        isAccountType(accountConfig, config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX));
+    return isAccountType(accountConfig, [
+        config_1.HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX,
+        config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX,
+    ]);
 }
 function isStandardSandbox(accountConfig) {
-    return isAccountType(accountConfig, config_1.HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX);
+    return isAccountType(accountConfig, [config_1.HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX]);
 }
 function isDevelopmentSandbox(accountConfig) {
-    return isAccountType(accountConfig, config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX);
+    return isAccountType(accountConfig, [
+        config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX,
+    ]);
 }
 function isDeveloperTestAccount(accountConfig) {
-    return isAccountType(accountConfig, config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPER_TEST);
+    return isAccountType(accountConfig, [config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPER_TEST]);
 }
 function isAppDeveloperAccount(accountConfig) {
-    return isAccountType(accountConfig, config_1.HUBSPOT_ACCOUNT_TYPES.APP_DEVELOPER);
+    return isAccountType(accountConfig, [config_1.HUBSPOT_ACCOUNT_TYPES.APP_DEVELOPER]);
+}
+function isTestAccountOrSandbox(accountConfig) {
+    return isAccountType(accountConfig, [
+        config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPER_TEST,
+        config_1.HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX,
+        config_1.HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX,
+    ]);
 }
 async function isUnifiedAccount(account) {
     const accountId = (0, getAccountIdentifier_1.getAccountIdentifier)(account);

package/lib/app/migrate.js

@@ -236,9 +236,21 @@ async function beginMigration(derivedAccountId, appId, platformVersion) {
     if (Object.values(componentsRequiringUids).length !== 0) {
         for (const [componentId, component] of Object.entries(componentsRequiringUids)) {
             const { componentHint, componentType } = component;
-            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)(en_1.lib.migrate.prompt.uidForComponent(componentHint
-                ? `${(0, transform_1.mapToUserFacingType)(componentType)} '${componentHint}'`
-                : (0, transform_1.mapToUserFacingType)(componentType)), {
+            // Extract the internal ID from the base64-encoded ComponentExternalId
+            let internalId;
+            try {
+                const decoded = Buffer.from(componentId, 'base64').toString('utf8');
+                const parts = decoded.split('$$');
+                internalId = parts[1] || componentId;
+            }
+            catch {
+                // If decoding fails, use the componentId as the internalId
+                internalId = componentId;
+            }
+            const promptText = componentHint
+                ? `${(0, transform_1.mapToUserFacingType)(componentType)} '${componentHint}' (ID: ${internalId})`
+                : `${(0, transform_1.mapToUserFacingType)(componentType)} (ID: ${internalId})`;
+            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)(en_1.lib.migrate.prompt.uidForComponent(promptText), {
                 validate: (uid) => {
                     const result = (0, project_parsing_lib_1.validateUid)(uid);
                     return result === undefined ? true : result;

package/lib/app/migrate_legacy.js

@@ -18,7 +18,7 @@ const ui_1 = require("../ui");
 const lang_1 = require("../lang");
 const accountTypes_1 = require("../accountTypes");
 const selectPublicAppForMigrationPrompt_1 = require("../prompts/selectPublicAppForMigrationPrompt");
-const createProjectPrompt_1 = require("../prompts/createProjectPrompt");
+const projectNameAndDestPrompt_1 = require("../prompts/projectNameAndDestPrompt");
 const ensureProjectExists_1 = require("../projects/ensureProjectExists");
 const usageTracking_1 = require("../usageTracking");
 const SpinniesManager_1 = __importDefault(require("../ui/SpinniesManager"));
@@ -58,8 +58,7 @@ async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
         (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
         return process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(options);
-    const { name: projectName, dest: projectDest } = createProjectPromptResponse;
+    const { name: projectName, dest: projectDest } = await (0, projectNameAndDestPrompt_1.projectNameAndDestPrompt)(options);
     const { projectExists } = await (0, ensureProjectExists_1.ensureProjectExists)(derivedAccountId, projectName, {
         allowCreate: false,
         noLogs: true,

package/lib/app/urls.d.ts

@@ -2,7 +2,7 @@ import { Environment } from '@hubspot/local-dev-lib/types/Config';
 type PrivateAppInstallUrlArgs = {
     targetAccountId: number;
     env: Environment;
-    appId: string;
+    appId: number;
 };
 type PublicAppInstallUrlArgs = {
     targetAccountId: number;

package/lib/commonOpts.d.ts

@@ -11,10 +11,12 @@ export declare function addCmsPublishModeOptions(yargs: Argv, { read, write }: {
 }): Argv;
 export declare function addTestingOptions(yargs: Argv): Argv;
 export declare function addUseEnvironmentOptions(yargs: Argv): Argv;
+export declare function addJSONOutputOptions(yargs: Argv): Argv;
 export declare function addCustomHelpOutput(yargs: Argv, command: string | string[], describe?: string): Promise<void>;
 export declare function setLogLevel(options: Arguments<{
     debug?: boolean;
     networkDebug?: boolean;
+    json?: boolean;
 }>): void;
 export declare function getCommandName(argv: Arguments): string;
 export declare function getCmsPublishMode(options: Arguments<{