@hubspot/cli 8.0.12-experimental.0 → 8.0.12-experimental.1

package/commands/project/upload.js

@@ -18,6 +18,20 @@ import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { projectProfilePrompt } from '../../lib/prompts/projectProfilePrompt.js';
 const command = 'upload';
 const describe = commands.project.upload.describe;
+async function handlePreview(accountId, projectId, buildId, targetPortalId) {
+    if (!projectId) {
+        uiLogger.warn(lib.projectPreview.missingProjectId);
+        return;
+    }
+    const previewResult = await triggerAndPollPreview(accountId, projectId, buildId, targetPortalId);
+    if (!previewResult.succeeded) {
+        uiLogger.warn(lib.projectPreview.warning);
+    }
+    return {
+        releaseTag: previewResult.releaseTag,
+        succeeded: previewResult.succeeded,
+    };
+}
 async function handler(args) {
     const { forceCreate, message, derivedAccountId, skipValidation, formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, preview, target: targetPortalId, exit, addUsageMetadata, } = args;
     const jsonOutput = {};
@@ -92,20 +106,9 @@ async function handler(args) {
             await displayWarnLogs(targetAccountId, projectConfig.name, result.buildId);
         }
         if (result && result.succeeded && preview && targetPortalId) {
-            if (!projectId) {
-                uiLogger.warn(lib.projectPreview.missingProjectId);
-            }
-            else {
-                const previewResult = await triggerAndPollPreview(targetAccountId, projectId, result.buildId, targetPortalId);
-                if (!previewResult.succeeded) {
-                    uiLogger.warn(lib.projectPreview.warning);
-                }
-                if (formatOutputAsJson) {
-                    jsonOutput.preview = {
-                        releaseTag: previewResult.releaseTag,
-                        succeeded: previewResult.succeeded,
-                    };
-                }
+            const previewJson = await handlePreview(targetAccountId, projectId, result.buildId, targetPortalId);
+            if (previewJson && formatOutputAsJson) {
+                jsonOutput.preview = previewJson;
             }
         }
         if (result && result.succeeded && formatOutputAsJson) {
@@ -158,10 +161,19 @@ function projectUploadBuilder(yargs) {
         target: {
             describe: commands.project.upload.options.target.describe,
             type: 'number',
+            requiresArg: true,
         },
     });
+    yargs.check(argv => {
+        if (argv.preview && argv.target == null) {
+            throw new Error(commands.project.upload.errors.previewRequiresTarget);
+        }
+        if (argv.target != null && !argv.preview) {
+            throw new Error(commands.project.upload.errors.targetRequiresPreview);
+        }
+        return true;
+    });
     yargs.conflicts('profile', 'account');
-    yargs.implies('preview', 'target');
     yargs.example([
         ['$0 project upload', commands.project.upload.examples.default],
         [

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,15 @@ 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;
@@ -188,6 +201,9 @@ export declare const commands: {
                     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;
@@ -297,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;
@@ -1500,6 +1519,7 @@ export declare const commands: {
                 projectAccount: string;
                 testingAccount: string;
                 account: string;
+                port: string;
             };
         };
         create: {
@@ -1796,6 +1816,8 @@ export declare const commands: {
             errors: {
                 noProjectConfig: string;
                 projectLockedError: string;
+                previewRequiresTarget: string;
+                targetRequiresPreview: string;
             };
             options: {
                 forceCreate: {
@@ -1927,6 +1949,7 @@ export declare const commands: {
             loading: {
                 checking: string;
                 creatingConfig: string;
+                addingLintScripts: string;
                 linting: string;
             };
             noProjectConfig: string;
@@ -1943,6 +1966,8 @@ export declare const commands: {
             failedToFetchRemoteEslintConfig: (platformVersion: string) => string;
             failedToCreateEslintConfig: (configPath: string) => string;
             eslintConfigRequired: string;
+            lintScriptsAdded: (scriptNames: string[], packageJsonPath: string) => string;
+            failedToAddLintScripts: (packageJsonPath: string) => string;
         };
         updateDeps: {
             help: {
@@ -3061,6 +3086,9 @@ export declare const commands: {
     };
 };
 export declare const lib: {
+    linkedDirectory: {
+        warning: (action: string, settingsPath: string) => string;
+    };
     parsing: {
         unableToParseStringToNumber: string;
     };

package/lang/en.js

@@ -2,6 +2,7 @@ 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 { 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';
@@ -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,15 @@ 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',
@@ -196,6 +210,9 @@ export const commands = {
                     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}`,
@@ -305,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.',
@@ -1516,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: {
@@ -1812,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: {
@@ -1943,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.',
@@ -1971,6 +1995,8 @@ export const commands = {
             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: {
@@ -2433,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}`,
@@ -3086,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',
     },
@@ -4062,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/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/index.d.ts

@@ -12,3 +12,7 @@ export declare function handleLinkFlow({ settings, accountOverrideId, args, }: {
     accountOverrideId: number | null;
     args: ArgumentsCamelCase<LinkArgs>;
 }): Promise<ActionResult>;
+export declare function handleLinkedUseAction({ state, targetAccountId, }: {
+    state: HsSettingsFile;
+    targetAccountId?: number;
+}): Promise<ActionResult>;

package/lib/link/index.js

@@ -1,6 +1,7 @@
 import { getAllConfigAccounts, getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
 import { confirmPrompt } from '../prompts/promptUtils.js';
 import { promptForAccountsToLink, promptForAccountsToUnlink, promptForAction, promptForDefaultAccount, } from './prompts.js';
+import { ACTION_RESULT_STATUS, } from '../../types/Link.js';
 import { getDefaultAccountOverrideFilePath, removeDefaultAccountOverrideFile, } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
 import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
 import { authenticateNewAccount } from '../accountAuth.js';
@@ -19,7 +20,7 @@ export class ActionHandlers {
         }, { eligibleAccounts: [], inEligibleAccounts: [] });
         const toAdd = await promptForAccountsToLink(context, eligibleAccounts, inEligibleAccounts, state.localDefaultAccount);
         const accounts = [...state.accounts, ...toAdd];
-        uiLogger.success(commands.account.subcommands.link.events.accountsLinked(toAdd.length));
+        uiLogger.info(commands.account.subcommands.link.events.accountsLinked(toAdd.length));
         const overrideFilePath = getDefaultAccountOverrideFilePath();
         if (overrideFilePath &&
             context.accountOverrideId &&
@@ -32,7 +33,7 @@ export class ActionHandlers {
             if (useOverride) {
                 uiLogger.success(commands.account.subcommands.link.events.defaultAccountSet(context.accountOverrideId));
                 return {
-                    status: 'success',
+                    status: ACTION_RESULT_STATUS.SUCCESS,
                     settings: {
                         accounts,
                         localDefaultAccount: context.accountOverrideId,
@@ -45,14 +46,14 @@ export class ActionHandlers {
             currentDefault: state.localDefaultAccount,
         });
         return {
-            status: 'success',
+            status: ACTION_RESULT_STATUS.SUCCESS,
             settings: { accounts, localDefaultAccount },
         };
     }
     static async unlink({ state }) {
         const toRemove = await promptForAccountsToUnlink(state.accounts, state.localDefaultAccount);
         if (toRemove.length === 0) {
-            return { status: 'noop' };
+            return { status: ACTION_RESULT_STATUS.NOOP };
         }
         const remainingAccounts = state.accounts.filter(account => !toRemove.includes(account));
         const defaultWasRemoved = state.localDefaultAccount !== undefined &&
@@ -61,7 +62,7 @@ export class ActionHandlers {
         if (remainingAccounts.length === 0) {
             uiLogger.success(commands.account.subcommands.link.events.noAccountsLinked);
             return {
-                status: 'success',
+                status: ACTION_RESULT_STATUS.SUCCESS,
                 settings: {
                     accounts: remainingAccounts,
                     localDefaultAccount: undefined,
@@ -73,7 +74,7 @@ export class ActionHandlers {
             uiLogger.success(commands.account.subcommands.link.events.accountsUnlinked(toRemove.length));
             uiLogger.success(commands.account.subcommands.link.events.defaultAccountRemains(state.localDefaultAccount));
             return {
-                status: 'success',
+                status: ACTION_RESULT_STATUS.SUCCESS,
                 settings: {
                     accounts: remainingAccounts,
                     localDefaultAccount: state.localDefaultAccount,
@@ -90,7 +91,7 @@ export class ActionHandlers {
             uiLogger.success(commands.account.subcommands.link.events.updatedLinkedAccounts);
         }
         return {
-            status: 'success',
+            status: ACTION_RESULT_STATUS.SUCCESS,
             settings: { accounts: remainingAccounts, localDefaultAccount },
         };
     }
@@ -101,7 +102,7 @@ export class ActionHandlers {
         });
         if (!updatedConfig) {
             return {
-                status: 'error',
+                status: ACTION_RESULT_STATUS.ERROR,
                 reason: commands.account.subcommands.link.errors.authFailed,
             };
         }
@@ -115,7 +116,7 @@ export class ActionHandlers {
     }
     static async cancel() {
         return {
-            status: 'noop',
+            status: ACTION_RESULT_STATUS.NOOP,
         };
     }
 }
@@ -152,3 +153,33 @@ async function resolveDefaultAccount({ accounts, currentDefault, prompt = '', })
     }
     return promptForDefaultAccount(accounts, currentDefault, prompt);
 }
+export async function handleLinkedUseAction({ state, targetAccountId, }) {
+    if (targetAccountId !== undefined) {
+        if (state.accounts.includes(targetAccountId)) {
+            uiLogger.success(commands.account.subcommands.link.events.defaultAccountSet(targetAccountId));
+            return {
+                status: ACTION_RESULT_STATUS.SUCCESS,
+                settings: {
+                    accounts: state.accounts,
+                    localDefaultAccount: targetAccountId,
+                },
+            };
+        }
+        const accounts = [...state.accounts, targetAccountId];
+        uiLogger.info(commands.account.subcommands.link.events.accountsLinked(1));
+        uiLogger.success(commands.account.subcommands.link.events.defaultAccountSet(targetAccountId));
+        return {
+            status: ACTION_RESULT_STATUS.SUCCESS,
+            settings: { accounts, localDefaultAccount: targetAccountId },
+        };
+    }
+    const localDefaultAccount = await resolveDefaultAccount({
+        accounts: state.accounts,
+        currentDefault: state.localDefaultAccount,
+    });
+    uiLogger.success(commands.account.subcommands.link.events.defaultAccountSet(localDefaultAccount));
+    return {
+        status: ACTION_RESULT_STATUS.SUCCESS,
+        settings: { accounts: state.accounts, localDefaultAccount },
+    };
+}

package/lib/link/linkUtils.d.ts

@@ -1,4 +1,5 @@
 import { HsSettingsFile } from '@hubspot/local-dev-lib/types/HsSettings';
 export declare function isDirectoryLinked(settings: HsSettingsFile | null): settings is HsSettingsFile;
 export declare function hasDeprecatedConfigConflict(commandArgs: (string | number)[]): boolean;
+export declare function addAccountToLinkedSettings(accountId: number): void;
 export declare function writeLinkedSettings(settings: HsSettingsFile, settingsPath: string): boolean;

package/lib/link/linkUtils.js

@@ -1,6 +1,7 @@
 import { localConfigFileExists } from '@hubspot/local-dev-lib/config';
-import { writeHsSettingsFile } from '@hubspot/local-dev-lib/config/hsSettings';
+import { getHsSettingsFileIfExists, writeHsSettingsFile, } from '@hubspot/local-dev-lib/config/hsSettings';
 import { uiLogger } from '../ui/logger.js';
+import { debugError } from '../errorHandlers/index.js';
 import { commands } from '../../lang/en.js';
 export function isDirectoryLinked(settings) {
     return settings !== null && settings.accounts.length > 0;
@@ -12,6 +13,30 @@ export function hasDeprecatedConfigConflict(commandArgs) {
     }
     return false;
 }
+export function addAccountToLinkedSettings(accountId) {
+    if (localConfigFileExists()) {
+        return;
+    }
+    const settings = getHsSettingsFileIfExists();
+    if (!settings || settings.accounts.length === 0) {
+        return;
+    }
+    if (settings.accounts.includes(accountId)) {
+        return;
+    }
+    const updated = {
+        ...settings,
+        accounts: [...settings.accounts, accountId],
+    };
+    try {
+        writeHsSettingsFile(updated);
+        uiLogger.info(commands.account.subcommands.link.shared.accountAutoLinked(accountId));
+    }
+    catch (err) {
+        uiLogger.warn(commands.account.subcommands.link.shared.accountAutoLinkFailed(accountId));
+        debugError(err);
+    }
+}
 export function writeLinkedSettings(settings, settingsPath) {
     try {
         writeHsSettingsFile(settings);

package/lib/link/warnIfLinkedDirectory.d.ts

@@ -0,0 +1 @@
+export declare function warnIfLinkedDirectory(args: (string | number)[]): void;

package/lib/link/warnIfLinkedDirectory.js

@@ -0,0 +1,9 @@
+import { getHsSettingsFilePath } from '@hubspot/local-dev-lib/config/hsSettings';
+import { uiLogger } from '../ui/logger.js';
+import { lib } from '../../lang/en.js';
+export function warnIfLinkedDirectory(args) {
+    if (getHsSettingsFilePath() === null) {
+        return;
+    }
+    uiLogger.warn(lib.linkedDirectory.warning(`hs ${args.join(' ')}`, getHsSettingsFilePath()));
+}

package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts

@@ -21,12 +21,13 @@ declare class DevServerManager_DEPRECATED {
         [key: string]: Component;
     }) => Promise<void>): Promise<void>;
     arrangeComponentsByType(components: Component[]): ComponentsByType;
-    setup({ components, onUploadRequired, accountId, setActiveApp, exit, }: {
+    setup({ components, onUploadRequired, accountId, setActiveApp, exit, port, }: {
         components: Component[];
         onUploadRequired: () => void;
         accountId: number;
         setActiveApp: (appUid: string | undefined) => Promise<void>;
         exit: ExitFunction;
+        port?: number;
     }): Promise<void>;
     start({ accountId, projectConfig, }: {
         accountId: number;

package/lib/projects/localDev/DevServerManager_DEPRECATED.js

@@ -57,7 +57,7 @@ class DevServerManager_DEPRECATED {
             return acc;
         }, {});
     }
-    async setup({ components, onUploadRequired, accountId, setActiveApp, exit, }) {
+    async setup({ components, onUploadRequired, accountId, setActiveApp, exit, port, }) {
         this.componentsByType = this.arrangeComponentsByType(components);
         let env;
         const accountConfig = getConfigAccountById(accountId);
@@ -65,7 +65,7 @@ class DevServerManager_DEPRECATED {
             env = accountConfig.env;
         }
         try {
-            await startPortManagerServer();
+            await startPortManagerServer(port);
         }
         catch (e) {
             logError(e);

package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts

@@ -16,6 +16,7 @@ type LocalDevManagerConstructorOptions = {
     runnableComponents: Component[];
     env: Environment;
     exit: ExitFunction;
+    port?: number;
 };
 declare class LocalDevManager_DEPRECATED {
     targetAccountId: number;
@@ -39,6 +40,7 @@ declare class LocalDevManager_DEPRECATED {
     mostRecentUploadWarning: string | null;
     private devSessionManager;
     private exit;
+    private port?;
     constructor(options: LocalDevManagerConstructorOptions);
     setActiveApp(appUid?: string): Promise<void>;
     setActivePublicAppData(): Promise<void>;

package/lib/projects/localDev/LocalDevManager_DEPRECATED.js

@@ -48,6 +48,7 @@ class LocalDevManager_DEPRECATED {
     mostRecentUploadWarning;
     devSessionManager;
     exit;
+    port;
     constructor(options) {
         this.targetAccountId = options.targetAccountId;
         // The account that the project exists in. This is not always the targetAccountId
@@ -67,6 +68,7 @@ class LocalDevManager_DEPRECATED {
         this.publicAppActiveInstalls = null;
         this.mostRecentUploadWarning = null;
         this.exit = options.exit;
+        this.port = options.port;
         this.projectSourceDir = path.join(this.projectDir, this.projectConfig.srcDir);
         if (!this.targetAccountId || !this.projectConfig || !this.projectDir) {
             uiLogger.error(lib.LocalDevManager.failedToInitialize);
@@ -337,6 +339,7 @@ class LocalDevManager_DEPRECATED {
                 accountId: this.targetAccountId,
                 setActiveApp: this.setActiveApp.bind(this),
                 exit: this.exit,
+                port: this.port,
             });
             return true;
         }

package/lib/projects/preview.js

@@ -1,9 +1,8 @@
 import { triggerAutoRelease, getAutoReleaseStatus, } from '@hubspot/local-dev-lib/api/projects';
-import { DEFAULT_POLLING_DELAY } from '../constants.js';
+import { DEFAULT_POLLING_DELAY, PREVIEW_POLL_TIMEOUT } from '../constants.js';
 import SpinniesManager from '../ui/SpinniesManager.js';
 import { logError, ApiErrorContext } from '../errorHandlers/index.js';
 import { lib } from '../../lang/en.js';
-const PREVIEW_POLL_TIMEOUT = 5 * 60 * 1000;
 export async function triggerAndPollPreview(accountId, projectId, buildId, targetPortalId) {
     let triggerResponse;
     SpinniesManager.add('preview', {
@@ -46,26 +45,14 @@ export async function triggerAndPollPreview(accountId, projectId, buildId, targe
     });
     return { succeeded: true, releaseTag, appId };
 }
-function pollPreviewStatus(accountId, projectId, targetPortalId, expectedReleaseTag, appId) {
-    return new Promise((resolve, reject) => {
-        const startTime = Date.now();
-        const pollInterval = setInterval(async () => {
-            try {
-                const { data } = await getAutoReleaseStatus(accountId, projectId, targetPortalId, expectedReleaseTag, appId);
-                if (data.status === 'COMPLETE') {
-                    clearInterval(pollInterval);
-                    resolve();
-                    return;
-                }
-                if (Date.now() - startTime >= PREVIEW_POLL_TIMEOUT) {
-                    clearInterval(pollInterval);
-                    reject(new Error(lib.projectPreview.timeout));
-                }
-            }
-            catch (e) {
-                clearInterval(pollInterval);
-                reject(e);
-            }
-        }, DEFAULT_POLLING_DELAY);
-    });
+async function pollPreviewStatus(accountId, projectId, targetPortalId, expectedReleaseTag, appId) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < PREVIEW_POLL_TIMEOUT) {
+        await new Promise(resolve => setTimeout(resolve, DEFAULT_POLLING_DELAY));
+        const { data } = await getAutoReleaseStatus(accountId, projectId, targetPortalId, expectedReleaseTag, appId);
+        if (data.status === 'COMPLETE') {
+            return;
+        }
+    }
+    throw new Error(lib.projectPreview.timeout);
 }