@hubspot/cli 8.0.11-experimental.2 → 8.0.12-experimental.1

package/lang/en.d.ts

@@ -129,8 +129,12 @@ export declare const commands: {
             };
             list: {
                 accounts: string;
+                allAccounts: string;
+                linkedAccounts: string;
                 defaultAccountTitle: string;
+                linkedDefaultTitle: string;
                 currentResolvedDefaultAccount: (accountId: number) => string;
+                directory: (dir: string) => string;
                 describe: string;
                 configPath: (configPath: string) => string;
                 overrideFilePathTitle: string;
@@ -177,6 +181,70 @@ export declare const commands: {
                 success: {
                     defaultAccountUpdated: (accountName: string) => string;
                 };
+                linked: {
+                    editingLinkedDefault: (dir: string) => string;
+                    alreadyDefault: (accountId: number) => string;
+                    setLinkedDefault: (account: string) => string;
+                    accountNotLinked: (account: string) => string;
+                    promptToLink: (account: string) => string;
+                    settingGlobalDefault: string;
+                    nonInteractiveNotLinked: (account: string) => string;
+                };
+            };
+            link: {
+                describe: string;
+                verboseDescribe: string;
+                shared: {
+                    noLinkedAccounts: string;
+                    globalAccountsAvailable: (count: number) => string;
+                    configurePrompt: string;
+                    deprecatedConfigNotSupported: (command: string) => string;
+                    writeSettingsFailed: (path: string, err: unknown) => string;
+                    savedToSettings: (path: string) => string;
+                    usingLinkedAccounts: (settingsPath: string) => string;
+                    accountAutoLinked: (accountId: number) => string;
+                    accountAutoLinkFailed: (accountId: number) => string;
+                };
+                linkingDirectory: (dir: string) => string;
+                managingLinkedAccounts: (dir: string) => string;
+                settingsInfo: (path: string) => string;
+                success: {
+                    created: (path: string) => string;
+                };
+                errors: {
+                    authFailed: string;
+                };
+                events: {
+                    accountsLinked: (count: number) => string;
+                    accountsUnlinked: (count: number) => string;
+                    overrideAccountDetected: (accountId: number) => string;
+                    defaultAccountSet: (accountId: number) => string;
+                    defaultAccountRemoved: (isSelectionRequired: boolean) => string;
+                    defaultAccountRemains: (accountId: number) => string;
+                    updatedLinkedAccounts: string;
+                    noAccountsLinked: string;
+                    overrideFileRemoved: string;
+                    invalidDefaultAccount: (accountId: number) => string;
+                };
+                prompts: {
+                    howToProceed: string;
+                    whatToDo: string;
+                    linkExisting: string;
+                    authenticateNew: string;
+                    cancel: string;
+                    selectDefault: string;
+                    selectToLink: string;
+                    selectToUnlink: string;
+                    alreadyLinked: string;
+                    fromHsAccount: string;
+                    newlyAuthenticated: string;
+                    mustSelectOne: string;
+                    keepAsDefault: string;
+                };
+            };
+            unlink: {
+                describe: string;
+                verboseDescribe: string;
             };
             remove: {
                 describe: string;
@@ -245,6 +313,9 @@ export declare const commands: {
                 };
                 name: (name: string) => string;
                 scopeGroups: string;
+                linkedDefaultTitle: string;
+                settingsPath: (path: string) => string;
+                linkedDefault: (account: string) => string;
             };
             clean: {
                 describe: string;
@@ -1448,6 +1519,7 @@ export declare const commands: {
                 projectAccount: string;
                 testingAccount: string;
                 account: string;
+                port: string;
             };
         };
         create: {
@@ -1458,6 +1530,9 @@ export declare const commands: {
                 failedToFetchProjectList: string;
                 cannotNestProjects: (projectDir: string) => string;
             };
+            warnings: {
+                betaPlatformVersion: (platformVersion: string) => string;
+            };
             logs: {
                 success: (projectName: string, projectDest: string) => string;
             };
@@ -1684,6 +1759,7 @@ export declare const commands: {
                 noFunctionsLinkText: string;
                 noFunctionsInProject: string;
                 noFunctionWithName: (name: string) => string;
+                functionNameRequired: string;
                 functionNotDeployed: (name: string) => string;
                 projectLogsManagerNotInitialized: string;
                 noDeployedBuild: string;
@@ -1729,6 +1805,7 @@ export declare const commands: {
             examples: {
                 default: string;
                 withProfile: string;
+                withPreview: string;
             };
             logs: {
                 buildSucceeded: (buildId: number) => string;
@@ -1739,6 +1816,8 @@ export declare const commands: {
             errors: {
                 noProjectConfig: string;
                 projectLockedError: string;
+                previewRequiresTarget: string;
+                targetRequiresPreview: string;
             };
             options: {
                 forceCreate: {
@@ -1750,6 +1829,12 @@ export declare const commands: {
                 profile: {
                     describe: string;
                 };
+                preview: {
+                    describe: string;
+                };
+                target: {
+                    describe: string;
+                };
             };
         };
         watch: {
@@ -1864,6 +1949,7 @@ export declare const commands: {
             loading: {
                 checking: string;
                 creatingConfig: string;
+                addingLintScripts: string;
                 linting: string;
             };
             noProjectConfig: string;
@@ -1876,8 +1962,12 @@ export declare const commands: {
             }[]) => string;
             createEslintConfigPrompt: (directories: string[]) => string;
             eslintConfigCreated: (configPath: string) => string;
+            createEslintConfigRequiresV2Platform: (platformVersion?: string | null) => string;
+            failedToFetchRemoteEslintConfig: (platformVersion: string) => string;
             failedToCreateEslintConfig: (configPath: string) => string;
             eslintConfigRequired: string;
+            lintScriptsAdded: (scriptNames: string[], packageJsonPath: string) => string;
+            failedToAddLintScripts: (packageJsonPath: string) => string;
         };
         updateDeps: {
             help: {
@@ -2009,6 +2099,25 @@ export declare const commands: {
                 force: string;
             };
         };
+        installStatus: {
+            describe: string;
+            examples: {
+                default: string;
+                json: string;
+            };
+            errors: {
+                noProjectConfig: string;
+                unsupportedPlatformVersion: (platformVersion: string) => string;
+                failedToParseProject: string;
+                noAppInProject: string;
+                unsupportedAuthType: (authType: string) => string;
+            };
+            success: {
+                installed: (appName: string, accountId: number) => string;
+                installedWithOutdatedScopes: (appName: string, accountId: number) => string;
+            };
+            notInstalled: (appName: string, accountId: number) => string;
+        };
     };
     sandbox: {
         describe: string;
@@ -2977,6 +3086,9 @@ export declare const commands: {
     };
 };
 export declare const lib: {
+    linkedDirectory: {
+        warning: (action: string, settingsPath: string) => string;
+    };
     parsing: {
         unableToParseStringToNumber: string;
     };
@@ -3290,6 +3402,16 @@ export declare const lib: {
             updatedFileDependency: (packageName: string, relativePath: string) => string;
         };
     };
+    projectPreview: {
+        triggeringPreview: (buildId: number, targetPortalId: number) => string;
+        pollingStatus: (releaseTag: string, targetPortalId: number) => string;
+        succeeded: (releaseTag: string, targetPortalId: number) => string;
+        triggerFailed: string;
+        pollFailed: string;
+        timeout: string;
+        warning: string;
+        missingProjectId: string;
+    };
     importData: {
         errors: {
             incorrectAccountType: (derivedAccountId: number) => string;

package/lang/en.js

@@ -2,11 +2,12 @@ import chalk from 'chalk';
 import { mapToUserFriendlyName } from '@hubspot/project-parsing-lib/transform';
 import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constants/auth';
-import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, } from '@hubspot/local-dev-lib/constants/config';
-import { uiAccountDescription, uiBetaTag, uiCommandReference, uiLink, UI_COLORS, uiAuthCommandReference, } from '../lib/ui/index.js';
-import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, } from '../lib/projects/urls.js';
+import { LOCAL_DEV_DEFAULT_PORT } from '../lib/constants.js';
+import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, } from '@hubspot/local-dev-lib/constants/config';
+import { indent, UI_COLORS, uiAccountDescription, uiAuthCommandReference, uiBetaTag, uiCommandReference, uiLink, } from '../lib/ui/index.js';
+import { getLocalDevUiUrl, getProjectDetailUrl, getProjectSettingsUrl, } from '../lib/projects/urls.js';
 import { getProductUpdatesUrl } from '../lib/links.js';
-import { APP_DISTRIBUTION_TYPES, APP_AUTH_TYPES, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, LEGACY_PUBLIC_APP_FILE, } from '../lib/constants.js';
+import { APP_AUTH_TYPES, APP_DISTRIBUTION_TYPES, LEGACY_PUBLIC_APP_FILE, 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}"?`,
@@ -137,8 +138,12 @@ export const commands = {
             },
             list: {
                 accounts: `${chalk.bold('Accounts')}:`,
+                allAccounts: `${chalk.bold('All Accounts')}:`,
+                linkedAccounts: `${chalk.bold('Linked Accounts')}:`,
                 defaultAccountTitle: `${chalk.bold('Default Account')}`,
+                linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
                 currentResolvedDefaultAccount: (accountId) => `Account: ${uiAccountDescription(accountId)}`,
+                directory: (dir) => `Directory: ${dir}`,
                 describe: 'List names of accounts defined in config.',
                 configPath: (configPath) => `Source: ${configPath}`,
                 overrideFilePathTitle: `${chalk.bold('Default Account Override')}`,
@@ -185,6 +190,70 @@ export const commands = {
                 success: {
                     defaultAccountUpdated: (accountName) => `Default account updated to "${accountName}"`,
                 },
+                linked: {
+                    editingLinkedDefault: (dir) => `Editing the default linked account for this directory (not the global default):\n${indent(1)}${dir}`,
+                    alreadyDefault: (accountId) => `${uiAccountDescription(accountId)} is the only linked account and is already the default.`,
+                    setLinkedDefault: (account) => `Linked default set to ${chalk.cyan(account)}`,
+                    accountNotLinked: (account) => `${account} is not linked to this directory.`,
+                    promptToLink: (account) => `Would you like to link ${account} to this directory?`,
+                    settingGlobalDefault: 'Setting global default instead.',
+                    nonInteractiveNotLinked: (account) => `${account} is not linked to this directory. Setting global default instead.`,
+                },
+            },
+            link: {
+                describe: 'Link authenticated HubSpot accounts to the current directory',
+                verboseDescribe: `Link one or more authenticated HubSpot accounts to the current directory. Linked accounts are saved in a local ${chalk.bold('.hs/settings.json')} file (added to .gitignore automatically).\n\nThis lets the CLI know which account to use when you run commands from this directory, without changing the global default. Run ${uiCommandReference('hs account current')} to see the active configuration.`,
+                shared: {
+                    noLinkedAccounts: 'No HubSpot accounts are linked in this directory.',
+                    globalAccountsAvailable: (count) => `You have ${chalk.cyan(count.toString())} ${count === 1 ? 'account' : 'accounts'} in your global config.`,
+                    configurePrompt: `To configure this directory, run:\n${indent(1)}${uiCommandReference('hs account link')}`,
+                    deprecatedConfigNotSupported: (command) => `${uiCommandReference(command)} does not support deprecated config. Run ${uiCommandReference('hs config migrate')} to migrate to global config. Then re-run ${uiCommandReference(command)}`,
+                    writeSettingsFailed: (path, err) => `Failed to write to ${path}: ${err}`,
+                    savedToSettings: (path) => `Saved to ${path}`,
+                    usingLinkedAccounts: (settingsPath) => `This directory has linked accounts via ${settingsPath}. Only linked accounts will be available for this command. To manage linked accounts, run ${uiCommandReference('hs account link')}.`,
+                    accountAutoLinked: (accountId) => `Automatically linked ${uiAccountDescription(accountId)} to this directory.`,
+                    accountAutoLinkFailed: (accountId) => `Could not automatically link ${uiAccountDescription(accountId)} to this directory. Run ${uiCommandReference('hs account link')} to link it manually.`,
+                },
+                linkingDirectory: (dir) => `Linking HubSpot account(s) for directory:\n${indent(1)}${dir}`,
+                managingLinkedAccounts: (dir) => `Managing linked accounts for:\n${indent(1)}${dir}`,
+                settingsInfo: (path) => `\u2139 Accounts linked here are saved in ${path}`,
+                success: {
+                    created: (path) => `Linked to ${path} (created .hs and added to .gitignore).\n${indent(1)}Now when you work within this directory, the CLI will use the linked account(s).`,
+                },
+                errors: {
+                    authFailed: `Authentication failed to complete`,
+                },
+                events: {
+                    accountsLinked: (count) => `Linked ${count} account${count !== 1 ? 's' : ''}`,
+                    accountsUnlinked: (count) => `Unlinked ${count} account${count !== 1 ? 's' : ''}`,
+                    overrideAccountDetected: (accountId) => `\nCurrent default account (from .hsaccount):\n${indent(1)}${uiAccountDescription(accountId)}`,
+                    defaultAccountSet: (accountId) => `Linked default account set to ${chalk.cyan(uiAccountDescription(accountId))}`,
+                    defaultAccountRemoved: (isSelectionRequired) => `The linked default account was removed. ${isSelectionRequired ? 'A linked default account is required.\n' : ''}`,
+                    defaultAccountRemains: (accountId) => `Linked default account remains ${chalk.cyan(uiAccountDescription(accountId))}`,
+                    updatedLinkedAccounts: 'Updated linked accounts',
+                    noAccountsLinked: `All accounts have been unlinked. Your global config accounts will be used.\n${indent(1)}The ${chalk.bold('.hs')} directory is no longer needed and can be safely deleted.`,
+                    overrideFileRemoved: '.hsaccount file removed',
+                    invalidDefaultAccount: (accountId) => `Default account ${uiAccountDescription(accountId)} is not in the linked accounts list and has been reset. Please select a new default.`,
+                },
+                prompts: {
+                    howToProceed: 'How would you like to link an account?',
+                    whatToDo: 'Which action would you like to perform?',
+                    linkExisting: 'Link existing authenticated account(s)',
+                    authenticateNew: 'Authenticate and link a new account',
+                    cancel: 'Cancel',
+                    selectDefault: 'Select a linked default account',
+                    selectToLink: 'Select authenticated account(s) to link:',
+                    selectToUnlink: 'Select account(s) to unlink',
+                    alreadyLinked: '- Already linked',
+                    fromHsAccount: '(from .hsaccount)',
+                    newlyAuthenticated: '(just authenticated)',
+                    mustSelectOne: 'You must select at least one account to link',
+                    keepAsDefault: 'Keep this as the default?',
+                },
+            },
+            unlink: {
+                describe: 'Unlink HubSpot account(s) from the current directory',
+                verboseDescribe: `Remove one or more linked accounts from this directory's ${chalk.bold('.hs/settings.json')}. If the default account is removed, you will be prompted to select a new one.\n\nThis does not delete the account from the global config - it only removes the local association.`,
             },
             remove: {
                 describe: 'Remove an account from the config.',
@@ -253,6 +322,9 @@ export const commands = {
                 },
                 name: (name) => `${chalk.bold('Account name')}: ${name}`,
                 scopeGroups: `${chalk.bold('Scopes available')}:`,
+                linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
+                settingsPath: (path) => `Source: ${path}`,
+                linkedDefault: (account) => `Account: ${account}`,
             },
             clean: {
                 describe: 'Check for inactive accounts and removes them from the CLI config.',
@@ -1464,6 +1536,7 @@ export const commands = {
                 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.',
                 testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account. Supported on platform versions 2025.2 and newer.',
                 account: 'The id of the account to upload your project to. Unsupported on platform versions 2025.2 and newer.',
+                port: `The port for the local dev server. Defaults to ${LOCAL_DEV_DEFAULT_PORT}.`,
             },
         },
         create: {
@@ -1474,6 +1547,9 @@ export const commands = {
                 failedToFetchProjectList: 'Failed to fetch the list of available project templates. Please try again later.',
                 cannotNestProjects: (projectDir) => `A project already exists at ${projectDir}. Projects cannot be nested within other projects. Please choose a different destination and try again.`,
             },
+            warnings: {
+                betaPlatformVersion: (platformVersion) => `Your portal must be enrolled in the beta to use platform version ${platformVersion}. If you are not enrolled in the beta, your upload will fail. ${uiLink('Enroll in the beta', getProductUpdatesUrl('286886'))}`,
+            },
             logs: {
                 success: (projectName, projectDest) => `Project ${chalk.bold(projectName)} was successfully created in ${projectDest}`,
             },
@@ -1700,6 +1776,7 @@ export const commands = {
                 noFunctionsLinkText: 'Visit developer docs',
                 noFunctionsInProject: `There aren't any functions in this project\n\t- Run ${uiCommandReference('hs project logs --help')} to learn more about logs\n\t- ${uiLink('Visit developer docs', 'https://developers.hubspot.com/docs/platform/serverless-functions')} to learn more about serverless functions`,
                 noFunctionWithName: (name) => `No function with name "${name}"`,
+                functionNameRequired: `A function name is required. Pass ${uiCommandReference('--function=<name>')} or run without it to select one interactively.`,
                 functionNotDeployed: (name) => `The function with name "${name}" is not deployed`,
                 projectLogsManagerNotInitialized: 'Function called on ProjectLogsManager before initialization',
                 noDeployedBuild: 'This project has not been deployed yet. Deploy the project first, then try again.',
@@ -1745,6 +1822,7 @@ export const commands = {
             examples: {
                 default: 'Upload a project into your HubSpot account',
                 withProfile: 'Upload a project into your HubSpot account when using profiles',
+                withPreview: 'Upload and preview the build on a target portal',
             },
             logs: {
                 buildSucceeded: (buildId) => `Build #${buildId} succeeded\n`,
@@ -1755,6 +1833,8 @@ export const commands = {
             errors: {
                 noProjectConfig: 'No project detected. Run this command from a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${uiCommandReference('hs project dev')} command for this project. If this is you, unlock the project in Projects UI.`,
+                previewRequiresTarget: `${uiCommandReference('--preview')} requires ${uiCommandReference('--target=<portalId>')} to specify the portal to preview on.`,
+                targetRequiresPreview: `${uiCommandReference('--target')} can only be used with ${uiCommandReference('--preview')}.`,
             },
             options: {
                 forceCreate: {
@@ -1766,6 +1846,12 @@ export const commands = {
                 profile: {
                     describe: 'Profile to target for this upload',
                 },
+                preview: {
+                    describe: 'Preview the build on a target portal after a successful upload',
+                },
+                target: {
+                    describe: 'Portal ID to preview the build on',
+                },
             },
         },
         watch: {
@@ -1880,6 +1966,7 @@ export const commands = {
             loading: {
                 checking: 'Checking lint packages and configuration…',
                 creatingConfig: 'Creating ESLint configuration files…',
+                addingLintScripts: 'Adding lint scripts to package.json files…',
                 linting: 'Linting…',
             },
             noProjectConfig: 'No project detected. Run this command from a project directory.',
@@ -1899,8 +1986,17 @@ export const commands = {
             },
             createEslintConfigPrompt: (directories) => `ESLint configuration file not found in the following ${directories.length === 1 ? 'directory' : 'directories'}:\n${directories.map(d => `  - ${d}`).join('\n')}\n\nWould you like to set up the required ESLint configuration?`,
             eslintConfigCreated: (configPath) => `ESLint configuration created at ${configPath}`,
+            createEslintConfigRequiresV2Platform: (platformVersion) => {
+                if (!platformVersion) {
+                    return 'Automatic ESLint configuration requires a Developer Platform project (2025.2 or later) with platformVersion set in hsproject.json. Add an eslint.config.js file manually, or set platformVersion and try again.';
+                }
+                return `Automatic ESLint configuration is not available for platform version ${platformVersion}. Use Developer Platform 2025.2 or later, or add eslint.config.js manually.`;
+            },
+            failedToFetchRemoteEslintConfig: (platformVersion) => `Could not download the ESLint config from HubSpot project components for platform version ${platformVersion}. Check your network connection and try again, or add eslint.config.js manually.`,
             failedToCreateEslintConfig: (configPath) => `Failed to create ESLint configuration at ${configPath}`,
             eslintConfigRequired: 'ESLint configuration is required to run the lint command. Run the command again to create the configuration.',
+            lintScriptsAdded: (scriptNames, packageJsonPath) => `Added ${scriptNames.map(s => `"${s}"`).join(' and ')} to ${packageJsonPath}`,
+            failedToAddLintScripts: (packageJsonPath) => `Failed to add lint scripts to ${packageJsonPath}`,
         },
         updateDeps: {
             help: {
@@ -2029,6 +2125,25 @@ export const commands = {
                 force: 'skip confirmation prompt',
             },
         },
+        installStatus: {
+            describe: 'Check whether a static auth app in the current project is installed in the target account. This command must be run from within a HubSpot project directory.',
+            examples: {
+                default: 'Check install status for the static auth app in the current project',
+                json: 'Output install status as JSON',
+            },
+            errors: {
+                noProjectConfig: `No project config found. Run this command from within a HubSpot project directory, or use ${uiCommandReference('hs project create')} to create a new one.`,
+                unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
+                failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
+                noAppInProject: 'No app was found in the local project. Install status is only available for projects that contain an app.',
+                unsupportedAuthType: (authType) => `This command only supports static auth apps. Detected auth type: ${authType}.`,
+            },
+            success: {
+                installed: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)}.`,
+                installedWithOutdatedScopes: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)} with outdated scopes. Reinstall the app to grant the latest scopes.`,
+            },
+            notInstalled: (appName, accountId) => `${chalk.bold(appName)} is not installed in ${uiAccountDescription(accountId)}.`,
+        },
     },
     sandbox: {
         describe: 'Commands for managing sandboxes.',
@@ -2344,7 +2459,7 @@ export const commands = {
                 opsLevel: 'Operations Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
                 serviceLevel: 'Service Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
                 salesLevel: 'Sales Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
-                contentLevel: 'CMS Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
+                contentLevel: 'Content Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
                 commerceLevel: 'Commerce Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
             },
             example: (configPath) => `Create a test account from the config file at ${configPath}`,
@@ -2997,6 +3112,9 @@ export const commands = {
     },
 };
 export const lib = {
+    linkedDirectory: {
+        warning: (action, settingsPath) => `This directory has linked accounts via ${settingsPath}. ${uiCommandReference(action)} modifies your global config, not the linked directory settings. Use ${uiCommandReference('hs account link')} to manage linked accounts.\n`,
+    },
     parsing: {
         unableToParseStringToNumber: 'Unable to parse string to number',
     },
@@ -3310,6 +3428,16 @@ export const lib = {
             updatedFileDependency: (packageName, relativePath) => `  Updated dependencies.${packageName}: file:${relativePath}`,
         },
     },
+    projectPreview: {
+        triggeringPreview: (buildId, targetPortalId) => `Previewing build #${buildId} on portal ${targetPortalId}`,
+        pollingStatus: (releaseTag, targetPortalId) => `Previewing ${releaseTag} on portal ${targetPortalId}`,
+        succeeded: (releaseTag, targetPortalId) => `Previewed ${releaseTag} on portal ${targetPortalId}`,
+        triggerFailed: 'Failed to trigger preview',
+        pollFailed: 'Failed to poll preview status',
+        timeout: 'Preview timed out after 5 minutes',
+        warning: 'The build succeeded but the preview failed. You can manually preview this build from the project UI.',
+        missingProjectId: 'Unable to preview: could not resolve the project ID.',
+    },
     importData: {
         errors: {
             incorrectAccountType: (derivedAccountId) => `The account ${uiAccountDescription(derivedAccountId)} is not a standard account, developer test account, or app developer account.`,
@@ -3963,9 +4091,9 @@ export const lib = {
             validJson: 'JSON files valid',
         },
         port: {
-            inUse: (port) => `Port ${port} is in use`,
-            inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}`,
-            available: (port) => `Port ${port} available for local development`,
+            inUse: (port) => `Default port ${port} is in use`,
+            inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}, or use ${uiCommandReference('--port')} to specify a different port`,
+            available: (port) => `Default port ${port} available for local development`,
         },
         projectValidation: {
             valid: 'Project configuration and structure is valid',

package/lib/app/migrate.js

@@ -127,7 +127,8 @@ export async function selectAppToMigrate(allApps, derivedAccountId, appId) {
     let hasLegacyCrmCards = false;
     selectedApp?.migrationComponents.forEach(component => {
         const userFacingComponentType = mapToUserFacingType(component.componentType);
-        if (component.componentType === 'LEGACY_CRM_CARD' && !component.isSupported) {
+        if (component.componentType === 'LEGACY_CRM_CARD' &&
+            !component.isSupported) {
             hasLegacyCrmCards = true;
         }
         const shouldDisplayComponent = !AUTO_GENERATED_COMPONENT_TYPES.includes(userFacingComponentType);

package/lib/constants.d.ts

@@ -4,6 +4,7 @@ export declare const FEEDBACK_INTERVAL: 10;
 export declare const HUBSPOT_FOLDER: "@hubspot";
 export declare const MARKETPLACE_FOLDER: "@marketplace";
 export declare const DEFAULT_POLLING_DELAY = 2000;
+export declare const PREVIEW_POLL_TIMEOUT: number;
 export declare const PROJECT_CONFIG_FILE: "hsproject.json";
 export declare const PROJECT_BUILD_STATES: {
     readonly BUILDING: "BUILDING";
@@ -142,3 +143,4 @@ export declare const ACCOUNT_LEVELS: {
 };
 export declare const ACCOUNT_LEVEL_CHOICES: readonly ["FREE", "STARTER", "PROFESSIONAL", "ENTERPRISE"];
 export declare const FEEDBACK_URL = "https://developers.hubspot.com/feedback";
+export declare const LOCAL_DEV_DEFAULT_PORT = 4828;

package/lib/constants.js

@@ -4,6 +4,7 @@ export const FEEDBACK_INTERVAL = 10;
 export const HUBSPOT_FOLDER = '@hubspot';
 export const MARKETPLACE_FOLDER = '@marketplace';
 export const DEFAULT_POLLING_DELAY = 2000;
+export const PREVIEW_POLL_TIMEOUT = 5 * 60 * 1000;
 export const PROJECT_CONFIG_FILE = 'hsproject.json';
 export const PROJECT_BUILD_STATES = {
     BUILDING: 'BUILDING',
@@ -143,3 +144,6 @@ export const ACCOUNT_LEVEL_CHOICES = [
     ACCOUNT_LEVELS.ENTERPRISE,
 ];
 export const FEEDBACK_URL = 'https://developers.hubspot.com/feedback';
+// TODO: remove this constant and use PORT_MANAGER_SERVER_PORT from
+// @hubspot/local-dev-lib once LDL changes its default to 4828.
+export const LOCAL_DEV_DEFAULT_PORT = 4828;

package/lib/doctor/Doctor.js

@@ -10,8 +10,8 @@ import fs from 'fs';
 import path from 'path';
 import { Diagnosis } from './Diagnosis.js';
 import { DiagnosticInfoBuilder, } from './DiagnosticInfoBuilder.js';
-import { isPortManagerPortAvailable } from '@hubspot/local-dev-lib/portManager';
-import { PORT_MANAGER_SERVER_PORT } from '@hubspot/local-dev-lib/constants/ports';
+import { isPortAvailable } from '@hubspot/local-dev-lib/portManager';
+import { LOCAL_DEV_DEFAULT_PORT } from '../constants.js';
 import { accessTokenForPersonalAccessKey,
 // scopesOnAccessToken,
  } from '@hubspot/local-dev-lib/personalAccessKey';
@@ -322,16 +322,16 @@ export class Doctor {
         }
     }
     async checkIfPortsAreAvailable() {
-        if (await isPortManagerPortAvailable()) {
+        if (await isPortAvailable(LOCAL_DEV_DEFAULT_PORT)) {
             this.diagnosis?.addProjectSection({
                 type: 'success',
-                message: lib.doctor.port.available(PORT_MANAGER_SERVER_PORT),
+                message: lib.doctor.port.available(LOCAL_DEV_DEFAULT_PORT),
             });
             return;
         }
         this.diagnosis?.addProjectSection({
             type: 'warning',
-            message: lib.doctor.port.inUse(PORT_MANAGER_SERVER_PORT),
+            message: lib.doctor.port.inUse(LOCAL_DEV_DEFAULT_PORT),
             secondaryMessaging: lib.doctor.port.inUseSecondary,
         });
     }

package/lib/link/accountTableUtils.d.ts

@@ -0,0 +1,10 @@
+export interface AccountRow {
+    name: string;
+    accountId: string;
+}
+export declare function buildAccountRow(accountId: number, isDefault: boolean): AccountRow;
+export declare function buildAccountHeader(nameColumnWidth: number): string;
+export declare function getNameColumnWidth(rows: AccountRow[]): number;
+export declare function sortDefaultFirst<T extends number | {
+    accountId: number;
+}>(items: T[], defaultAccount: number | undefined): T[];

package/lib/link/accountTableUtils.js

@@ -0,0 +1,39 @@
+import { HUBSPOT_ACCOUNT_TYPE_STRINGS } from '@hubspot/local-dev-lib/constants/config';
+import { getConfigAccountIfExists } from '@hubspot/local-dev-lib/config';
+import chalk from 'chalk';
+import { commands } from '../../lang/en.js';
+import { indent } from '../ui/index.js';
+import { INK_COLORS } from '../../ui/styles.js';
+export function buildAccountRow(accountId, isDefault) {
+    const account = getConfigAccountIfExists(accountId);
+    let name = String(accountId);
+    if (account && account.accountType) {
+        const typeStr = HUBSPOT_ACCOUNT_TYPE_STRINGS[account.accountType];
+        name = `${account.name} [${typeStr}]`;
+    }
+    if (isDefault) {
+        name = `${name} (default)`;
+    }
+    return { name, accountId: String(accountId) };
+}
+export function buildAccountHeader(nameColumnWidth) {
+    const labels = commands.account.subcommands.list.labels;
+    const paddedName = chalk.bold(chalk.hex(INK_COLORS.INFO_BLUE)(labels.name.padEnd(nameColumnWidth)));
+    const accountId = chalk.bold(chalk.hex(INK_COLORS.INFO_BLUE)(labels.accountId));
+    return `${indent(1)}${paddedName}  ${accountId}`;
+}
+export function getNameColumnWidth(rows) {
+    const labels = commands.account.subcommands.list.labels;
+    return Math.max(labels.name.length, ...rows.map(r => r.name.length));
+}
+export function sortDefaultFirst(items, defaultAccount) {
+    return [...items].sort((a, b) => {
+        const aId = typeof a === 'number' ? a : a.accountId;
+        const bId = typeof b === 'number' ? b : b.accountId;
+        if (aId === defaultAccount)
+            return -1;
+        if (bId === defaultAccount)
+            return 1;
+        return 0;
+    });
+}

package/lib/link/index.d.ts

@@ -0,0 +1,18 @@
+import { HsSettingsFile } from '@hubspot/local-dev-lib/types/HsSettings';
+import { ActionHandlerParams, ActionResult, LinkArgs } from '../../types/Link.js';
+import { ArgumentsCamelCase } from 'yargs';
+export declare class ActionHandlers {
+    static link({ state, context, }: ActionHandlerParams): Promise<ActionResult>;
+    static unlink({ state }: ActionHandlerParams): Promise<ActionResult>;
+    static authenticate({ state, context, args, }: ActionHandlerParams): Promise<ActionResult>;
+    static cancel(): Promise<ActionResult>;
+}
+export declare function handleLinkFlow({ settings, accountOverrideId, args, }: {
+    settings: HsSettingsFile;
+    accountOverrideId: number | null;
+    args: ArgumentsCamelCase<LinkArgs>;
+}): Promise<ActionResult>;
+export declare function handleLinkedUseAction({ state, targetAccountId, }: {
+    state: HsSettingsFile;
+    targetAccountId?: number;
+}): Promise<ActionResult>;