@hubspot/cli 8.5.0-beta.1 → 8.6.0-beta.0

package/commands/account/clean.js

@@ -14,6 +14,7 @@ import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { renderList } from '../../ui/render.js';
+import { warnIfLinkedDirectory } from '../../lib/link/warnIfLinkedDirectory.js';
 const command = 'clean';
 const describe = commands.account.subcommands.clean.describe;
 async function handler(args) {
@@ -24,6 +25,7 @@ async function handler(args) {
         uiLogger.log(commands.account.subcommands.clean.noResults);
         return exit(EXIT_CODES.SUCCESS);
     }
+    warnIfLinkedDirectory(args._);
     const accountsToRemove = [];
     SpinniesManager.init({
         succeedColor: 'white',

package/commands/account/createOverride.js

@@ -12,11 +12,14 @@ import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHand
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
+import { warnIfLinkedDirectory } from '../../lib/link/warnIfLinkedDirectory.js';
 const command = 'create-override [account]';
 const describe = commands.account.subcommands.createOverride.describe(DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME);
 async function handler(args) {
     const { exit } = args;
     let overrideDefaultAccount = args.account;
+    // TODO: Block this command when linked directory exists (next breaking change)
+    warnIfLinkedDirectory(args._);
     const globalConfigExists = globalConfigFileExists();
     if (!globalConfigExists) {
         uiLogger.error(commands.account.subcommands.createOverride.errors.globalConfigNotFound);

package/commands/account/info.js

@@ -1,6 +1,9 @@
 import { getConfigAccountById, getConfigDefaultAccount, getConfigFilePath, } from '@hubspot/local-dev-lib/config';
 import { getDefaultAccountOverrideFilePath } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
+import { getHsSettingsFileIfExists, getHsSettingsFilePath, } from '@hubspot/local-dev-lib/config/hsSettings';
+import { isDirectoryLinked } from '../../lib/link/linkUtils.js';
 import { getAccessToken } from '@hubspot/local-dev-lib/personalAccessKey';
+import { uiAccountDescription } from '../../lib/ui/index.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { indent } from '../../lib/ui/index.js';
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
@@ -9,31 +12,46 @@ import { uiLogger } from '../../lib/ui/logger.js';
 import { renderList } from '../../ui/render.js';
 const describe = commands.account.subcommands.info.describe;
 const command = 'info [account]';
+function logLinkedAccountInfo(hsSettingsPath, localDefaultAccount) {
+    uiLogger.log(commands.account.subcommands.info.linkedDefaultTitle);
+    uiLogger.log(`${indent(1)}${commands.account.subcommands.info.settingsPath(hsSettingsPath)}`);
+    if (localDefaultAccount) {
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.info.linkedDefault(uiAccountDescription(localDefaultAccount))}`);
+    }
+}
+function logGlobalAccountInfo() {
+    const configPath = getConfigFilePath();
+    if (configPath) {
+        uiLogger.log(commands.account.subcommands.info.defaultAccountTitle);
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.info.configPath(configPath)}`);
+        const defaultAccount = getConfigDefaultAccount();
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.info.defaultAccount(defaultAccount.name)}`);
+    }
+    const overrideFilePath = getDefaultAccountOverrideFilePath();
+    if (overrideFilePath) {
+        uiLogger.log('');
+        uiLogger.log(commands.account.subcommands.info.overrideFilePathTitle);
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.info.overrideFilePath(overrideFilePath)}`);
+        const defaultAccount = getConfigDefaultAccount();
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.info.overrideAccount(defaultAccount.name)}`);
+    }
+}
 async function handler(args) {
     const { derivedAccountId } = args;
     const config = getConfigAccountById(derivedAccountId);
-    // check if the provided account is using a personal access key, if not, show an error
     if (config && config.authType === 'personalaccesskey') {
         const { name, personalAccessKey, env } = config;
         let scopeGroups = [];
         const response = await getAccessToken(personalAccessKey, env, derivedAccountId);
         scopeGroups = response.scopeGroups.map(s => [s]);
-        // If a default account is present in the config, display it
-        const configPath = getConfigFilePath();
-        if (configPath) {
-            uiLogger.log(commands.account.subcommands.info.defaultAccountTitle);
-            uiLogger.log(`${indent(1)}${commands.account.subcommands.info.configPath(configPath)}`);
-            const defaultAccount = getConfigDefaultAccount();
-            uiLogger.log(`${indent(1)}${commands.account.subcommands.info.defaultAccount(defaultAccount.name)}`);
+        const hsSettings = getHsSettingsFileIfExists();
+        const hsSettingsPath = getHsSettingsFilePath();
+        const isLinked = isDirectoryLinked(hsSettings) && hsSettingsPath !== null;
+        if (isLinked) {
+            logLinkedAccountInfo(hsSettingsPath, hsSettings.localDefaultAccount);
         }
-        // If a default account override is present, display it
-        const overrideFilePath = getDefaultAccountOverrideFilePath();
-        if (overrideFilePath) {
-            uiLogger.log('');
-            uiLogger.log(commands.account.subcommands.info.overrideFilePathTitle);
-            uiLogger.log(`${indent(1)}${commands.account.subcommands.info.overrideFilePath(overrideFilePath)}`);
-            const defaultAccount = getConfigDefaultAccount();
-            uiLogger.log(`${indent(1)}${commands.account.subcommands.info.overrideAccount(defaultAccount.name)}`);
+        else {
+            logGlobalAccountInfo();
         }
         uiLogger.log('');
         uiLogger.log(commands.account.subcommands.info.name(name));

package/commands/account/link.d.ts

@@ -0,0 +1,4 @@
+import { YargsCommandModule } from '../../types/Yargs.js';
+import { LinkArgs } from '../../types/Link.js';
+declare const linkCommand: YargsCommandModule<unknown, LinkArgs>;
+export default linkCommand;

package/commands/account/link.js

@@ -0,0 +1,89 @@
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { getAllConfigAccounts } from '@hubspot/local-dev-lib/config';
+import { getCwd } from '@hubspot/local-dev-lib/path';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { getHsSettingsFileIfExists, getHsSettingsFilePath, } from '@hubspot/local-dev-lib/config/hsSettings';
+import { getDefaultAccountOverrideAccountId } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
+import { checkAndAddHsFolderToGitignore } from '@hubspot/local-dev-lib/gitignore';
+import { DEFAULT_HS_SETTINGS_PATH, EMPTY_HS_SETTINGS_FILE, } from '@hubspot/local-dev-lib/constants/config';
+import { ACTION_RESULT_STATUS } from '../../types/Link.js';
+import { handleLinkFlow } from '../../lib/link/index.js';
+import { hasDeprecatedConfigConflict, writeLinkedSettings, } from '../../lib/link/linkUtils.js';
+import { renderLinkedAccountsTable } from '../../lib/link/renderLinkedAccountsTable.js';
+import { commands } from '../../lang/en.js';
+import { debugError } from '../../lib/errorHandlers/index.js';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+const command = 'link';
+// Hide the command until we're done testing and ready to make linking GA
+// const describe = commands.account.subcommands.link.describe;
+const describe = undefined;
+async function handler(args) {
+    const { exit } = args;
+    if (hasDeprecatedConfigConflict(args._)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    const existingSettings = getHsSettingsFileIfExists();
+    const isNewFile = existingSettings === null;
+    if (isNewFile) {
+        uiLogger.log(commands.account.subcommands.link.linkingDirectory(getCwd()));
+    }
+    else {
+        uiLogger.log(commands.account.subcommands.link.managingLinkedAccounts(getCwd()));
+    }
+    uiLogger.log('');
+    const settingsFilePath = getHsSettingsFilePath() || DEFAULT_HS_SETTINGS_PATH;
+    uiLogger.log(commands.account.subcommands.link.settingsInfo(settingsFilePath));
+    uiLogger.log('');
+    const settings = isNewFile ? EMPTY_HS_SETTINGS_FILE : existingSettings;
+    const accounts = getAllConfigAccounts();
+    const accountOverrideId = getDefaultAccountOverrideAccountId(accounts);
+    if (settings.accounts.length !== 0) {
+        await renderLinkedAccountsTable(settings);
+        uiLogger.log('');
+    }
+    const result = await handleLinkFlow({
+        settings,
+        accountOverrideId,
+        args,
+    });
+    if (result.status === ACTION_RESULT_STATUS.ERROR) {
+        uiLogger.error(result.reason);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (result.status === ACTION_RESULT_STATUS.NOOP) {
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    const settingsPath = getHsSettingsFilePath() || DEFAULT_HS_SETTINGS_PATH;
+    if (!writeLinkedSettings(result.settings, settingsPath)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    try {
+        checkAndAddHsFolderToGitignore(settingsPath);
+    }
+    catch (e) {
+        debugError(e);
+    }
+    if (isNewFile) {
+        uiLogger.success(commands.account.subcommands.link.success.created(settingsPath));
+    }
+    else {
+        uiLogger.success(commands.account.subcommands.link.shared.savedToSettings(settingsPath));
+    }
+    return exit(EXIT_CODES.SUCCESS);
+}
+function linkBuilder(yargs) {
+    yargs.example([['$0 link']]);
+    return yargs;
+}
+const builder = makeYargsBuilder(linkBuilder, command, commands.account.subcommands.link.verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+});
+const linkCommand = {
+    command,
+    describe,
+    handler: makeYargsHandlerWithUsageTracking('account-link', handler),
+    builder,
+};
+export default linkCommand;

package/commands/account/list.js

@@ -1,92 +1,50 @@
-import { getConfigFilePath, getAllConfigAccounts, getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
+import { getConfigFilePath, getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
 import { getDefaultAccountOverrideFilePath } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
+import { getHsSettingsFileIfExists, getHsSettingsFilePath, } from '@hubspot/local-dev-lib/config/hsSettings';
+import { getCwd } from '@hubspot/local-dev-lib/path';
 import { indent } from '../../lib/ui/index.js';
-import { isSandbox, isDeveloperTestAccount } from '../../lib/accountTypes.js';
-import { HUBSPOT_ACCOUNT_TYPES, HUBSPOT_ACCOUNT_TYPE_STRINGS, } from '@hubspot/local-dev-lib/constants/config';
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { commands } from '../../lang/en.js';
-import { renderTable } from '../../ui/render.js';
+import { renderAccountTable } from '../../lib/ui/accountTable.js';
+import { renderLinkedAccountsTable } from '../../lib/link/renderLinkedAccountsTable.js';
+import { isDirectoryLinked } from '../../lib/link/linkUtils.js';
 const command = ['list', 'ls'];
 const describe = commands.account.subcommands.list.describe;
-function sortAndMapAccounts(accounts) {
-    const mappedAccountData = {};
-    // Standard and app developer accounts
-    accounts
-        .filter(p => p.accountType &&
-        (p.accountType === HUBSPOT_ACCOUNT_TYPES.STANDARD ||
-            p.accountType === HUBSPOT_ACCOUNT_TYPES.APP_DEVELOPER))
-        .forEach(account => {
-        mappedAccountData[account.accountId] = [account];
-    });
-    // Non-standard accounts (sandbox, developer test account)
-    accounts
-        .filter(p => p.accountType && (isSandbox(p) || isDeveloperTestAccount(p)))
-        .forEach(p => {
-        if (p.parentAccountId) {
-            mappedAccountData[p.parentAccountId] = [
-                ...(mappedAccountData[p.parentAccountId] || []),
-                p,
-            ];
-        }
-        else {
-            mappedAccountData[p.accountId] = [p];
-        }
-    });
-    return mappedAccountData;
-}
-function getAccountData(mappedAccountData) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const accountData = [];
-    Object.entries(mappedAccountData).forEach(([key, set]) => {
-        const hasParentAccount = set.filter(p => p.accountId === parseInt(key, 10))[0];
-        set.forEach(account => {
-            let name = `${account.name} [${HUBSPOT_ACCOUNT_TYPE_STRINGS[account.accountType]}]`;
-            if (isSandbox(account)) {
-                if (hasParentAccount && set.length > 1) {
-                    name = `↳ ${name}`;
-                }
-            }
-            else if (isDeveloperTestAccount(account)) {
-                if (hasParentAccount && set.length > 1) {
-                    name = `↳ ${name}`;
-                }
-            }
-            accountData.push([name, account.accountId, account.authType]);
-        });
-    });
-    return accountData;
-}
 async function handler() {
     const configPath = getConfigFilePath();
-    const accountsList = getAllConfigAccounts();
-    const mappedAccountData = sortAndMapAccounts(accountsList);
-    const accountData = getAccountData(mappedAccountData);
-    const tableHeader = [
-        commands.account.subcommands.list.labels.name,
-        commands.account.subcommands.list.labels.accountId,
-        commands.account.subcommands.list.labels.authType,
-    ];
     const defaultAccount = getConfigDefaultAccountIfExists();
     const accountId = defaultAccount?.accountId;
     const overrideFilePath = getDefaultAccountOverrideFilePath();
-    // If a default account is present in the config, display it
-    if (configPath && accountId) {
-        uiLogger.log(commands.account.subcommands.list.defaultAccountTitle);
-        uiLogger.log(`${indent(1)}${commands.account.subcommands.list.configPath(configPath)}`);
-        uiLogger.log(`${indent(1)}${commands.account.subcommands.list.currentResolvedDefaultAccount(accountId)}`);
+    const hsSettings = getHsSettingsFileIfExists();
+    const hsSettingsPath = getHsSettingsFilePath();
+    const isLinked = isDirectoryLinked(hsSettings);
+    if (isLinked && hsSettingsPath) {
+        uiLogger.log(commands.account.subcommands.list.linkedDefaultTitle);
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.list.directory(getCwd())}`);
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.list.configPath(hsSettingsPath)}`);
+        if (hsSettings.localDefaultAccount) {
+            uiLogger.log(`${indent(1)}${commands.account.subcommands.list.currentResolvedDefaultAccount(hsSettings.localDefaultAccount)}`);
+        }
+        uiLogger.log('');
+        uiLogger.log(commands.account.subcommands.list.linkedAccounts);
+        await renderLinkedAccountsTable(hsSettings);
         uiLogger.log('');
     }
-    // If a default account override is present, display it
-    if (overrideFilePath && accountId) {
-        uiLogger.log(commands.account.subcommands.list.overrideFilePathTitle);
-        uiLogger.log(`${indent(1)}${commands.account.subcommands.list.overrideFilePath(overrideFilePath)}`);
+    if (!isLinked && configPath && accountId) {
+        uiLogger.log(commands.account.subcommands.list.defaultAccountTitle);
+        uiLogger.log(`${indent(1)}${commands.account.subcommands.list.configPath(configPath)}`);
         uiLogger.log(`${indent(1)}${commands.account.subcommands.list.currentResolvedDefaultAccount(accountId)}`);
         uiLogger.log('');
+        if (overrideFilePath) {
+            uiLogger.log(commands.account.subcommands.list.overrideFilePathTitle);
+            uiLogger.log(`${indent(1)}${commands.account.subcommands.list.overrideFilePath(overrideFilePath)}`);
+            uiLogger.log(`${indent(1)}${commands.account.subcommands.list.currentResolvedDefaultAccount(accountId)}`);
+            uiLogger.log('');
+        }
     }
-    uiLogger.log(commands.account.subcommands.list.accounts);
-    renderTable(tableHeader, accountData, true);
+    renderAccountTable(isLinked);
 }
 function accountListBuilder(yargs) {
     yargs.example([['$0 accounts list']]);

package/commands/account/remove.js

@@ -8,9 +8,11 @@ import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHand
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { commands } from '../../lang/en.js';
+import { warnIfLinkedDirectory } from '../../lib/link/warnIfLinkedDirectory.js';
 const command = 'remove [account]';
 const describe = commands.account.subcommands.remove.describe;
 async function handler(args) {
+    warnIfLinkedDirectory(args._);
     const { account: accountFlag } = args;
     let accountToRemoveConfig = accountFlag
         ? getConfigAccountIfExists(accountFlag)

package/commands/account/removeOverride.js

@@ -9,10 +9,13 @@ import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHand
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { commands } from '../../lang/en.js';
+import { warnIfLinkedDirectory } from '../../lib/link/warnIfLinkedDirectory.js';
 const command = 'remove-override';
 const describe = commands.account.subcommands.removeOverride.describe(DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME);
 async function handler(args) {
     const { force, exit } = args;
+    // TODO: Block this command when linked directory exists (next breaking change)
+    warnIfLinkedDirectory(args._);
     const globalConfigExists = globalConfigFileExists();
     if (!globalConfigExists) {
         uiLogger.error(commands.account.subcommands.removeOverride.errors.globalConfigNotFound);

package/commands/account/unlink.d.ts

@@ -0,0 +1,4 @@
+import { YargsCommandModule } from '../../types/Yargs.js';
+import { LinkArgs } from '../../types/Link.js';
+declare const unlinkCommand: YargsCommandModule<unknown, LinkArgs>;
+export default unlinkCommand;

package/commands/account/unlink.js

@@ -0,0 +1,70 @@
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+import { uiLogger } from '../../lib/ui/logger.js';
+import { getAllConfigAccounts } from '@hubspot/local-dev-lib/config';
+import { getCwd } from '@hubspot/local-dev-lib/path';
+import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { getHsSettingsFileIfExists, getHsSettingsFilePath, } from '@hubspot/local-dev-lib/config/hsSettings';
+import { ACTION_RESULT_STATUS } from '../../types/Link.js';
+import { ActionHandlers } from '../../lib/link/index.js';
+import { hasDeprecatedConfigConflict, isDirectoryLinked, writeLinkedSettings, } from '../../lib/link/linkUtils.js';
+import { commands } from '../../lang/en.js';
+import { DEFAULT_HS_SETTINGS_PATH } from '@hubspot/local-dev-lib/constants/config';
+import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+const command = 'unlink';
+// Hide the command until we're done testing and ready to make linking GA
+// const describe = commands.account.subcommands.link.describe;
+const describe = undefined;
+async function handler(args) {
+    const { exit } = args;
+    if (hasDeprecatedConfigConflict(args._)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    const existingSettings = getHsSettingsFileIfExists();
+    if (!isDirectoryLinked(existingSettings)) {
+        const globalAccounts = getAllConfigAccounts();
+        uiLogger.log(commands.account.subcommands.link.shared.noLinkedAccounts);
+        uiLogger.log(commands.account.subcommands.link.shared.globalAccountsAvailable(globalAccounts.length));
+        uiLogger.log('');
+        uiLogger.log(commands.account.subcommands.link.shared.configurePrompt);
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    uiLogger.log(commands.account.subcommands.link.managingLinkedAccounts(getCwd()));
+    uiLogger.log('');
+    const result = await ActionHandlers.unlink({
+        state: existingSettings,
+        context: {
+            globalAccountsList: getAllConfigAccounts(),
+            globalDefaultAccount: undefined,
+            accountOverrideId: null,
+        },
+        args,
+    });
+    if (result.status === ACTION_RESULT_STATUS.ERROR) {
+        uiLogger.error(result.reason);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (result.status === ACTION_RESULT_STATUS.NOOP) {
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    const settingsPath = getHsSettingsFilePath() || DEFAULT_HS_SETTINGS_PATH;
+    if (!writeLinkedSettings(result.settings, settingsPath)) {
+        return exit(EXIT_CODES.ERROR);
+    }
+    uiLogger.success(commands.account.subcommands.link.shared.savedToSettings(settingsPath));
+    return exit(EXIT_CODES.SUCCESS);
+}
+function unlinkBuilder(yargs) {
+    yargs.example([['$0 account unlink']]);
+    return yargs;
+}
+const builder = makeYargsBuilder(unlinkBuilder, command, commands.account.subcommands.unlink.verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+});
+const unlinkCommand = {
+    command,
+    describe,
+    handler: makeYargsHandlerWithUsageTracking('account-unlink', handler),
+    builder,
+};
+export default unlinkCommand;

package/commands/account/use.js

@@ -1,5 +1,7 @@
 import { getConfigFilePath, setConfigAccountAsDefault, getConfigAccountIfExists, getConfigAccountByName, getConfigAccountById, globalConfigFileExists, getAllConfigAccounts, } from '@hubspot/local-dev-lib/config';
 import { getDefaultAccountOverrideAccountId, getDefaultAccountOverrideFilePath, } from '@hubspot/local-dev-lib/config/defaultAccountOverride';
+import { getHsSettingsFileIfExists, getHsSettingsFilePath, writeHsSettingsFile, } from '@hubspot/local-dev-lib/config/hsSettings';
+import { getCwd } from '@hubspot/local-dev-lib/path';
 import { ENVIRONMENTS } from '@hubspot/local-dev-lib/constants/environments';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
@@ -8,9 +10,69 @@ import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHand
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { authenticateNewAccount } from '../../lib/accountAuth.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
+import { confirmPrompt } from '../../lib/prompts/promptUtils.js';
+import { handleLinkedUseAction } from '../../lib/link/index.js';
+import { isDirectoryLinked } from '../../lib/link/linkUtils.js';
+import { ACTION_RESULT_STATUS } from '../../types/Link.js';
+import { DEFAULT_HS_SETTINGS_PATH } from '@hubspot/local-dev-lib/constants/config';
 const command = 'use [account]';
 const describe = commands.account.subcommands.use.describe;
-async function handler(args) {
+async function handleLinkedUse(args, hsSettings) {
+    const { exit } = args;
+    uiLogger.log(commands.account.subcommands.use.linked.editingLinkedDefault(getCwd()));
+    uiLogger.log('');
+    if (!args.account && hsSettings.accounts.length === 1) {
+        uiLogger.log(commands.account.subcommands.use.linked.alreadyDefault(hsSettings.accounts[0]));
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    let targetAccountId;
+    if (args.account) {
+        const account = getConfigAccountIfExists(args.account);
+        if (!account) {
+            uiLogger.error(commands.account.subcommands.use.errors.accountNotFound(args.account, getConfigFilePath()));
+            return exit(EXIT_CODES.ERROR);
+        }
+        if (!hsSettings.accounts.includes(account.accountId)) {
+            if (!process.stdin.isTTY) {
+                uiLogger.log(commands.account.subcommands.use.linked.nonInteractiveNotLinked(account.name));
+                setConfigAccountAsDefault(String(args.account));
+                uiLogger.success(commands.account.subcommands.use.success.defaultAccountUpdated(account.name));
+                return exit(EXIT_CODES.SUCCESS);
+            }
+            uiLogger.log(commands.account.subcommands.use.linked.accountNotLinked(account.name));
+            const shouldLink = await confirmPrompt(commands.account.subcommands.use.linked.promptToLink(account.name));
+            if (!shouldLink) {
+                uiLogger.log(commands.account.subcommands.use.linked.settingGlobalDefault);
+                setConfigAccountAsDefault(String(args.account));
+                uiLogger.success(commands.account.subcommands.use.success.defaultAccountUpdated(account.name));
+                return exit(EXIT_CODES.SUCCESS);
+            }
+        }
+        targetAccountId = account.accountId;
+    }
+    const result = await handleLinkedUseAction({
+        state: hsSettings,
+        targetAccountId,
+    });
+    if (result.status === ACTION_RESULT_STATUS.ERROR) {
+        uiLogger.error(result.reason);
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (result.status === ACTION_RESULT_STATUS.NOOP) {
+        return exit(EXIT_CODES.SUCCESS);
+    }
+    const settingsPath = getHsSettingsFilePath() || DEFAULT_HS_SETTINGS_PATH;
+    try {
+        writeHsSettingsFile(result.settings);
+    }
+    catch (err) {
+        uiLogger.error(commands.account.subcommands.link.shared.writeSettingsFailed(settingsPath, err));
+        return exit(EXIT_CODES.ERROR);
+    }
+    uiLogger.success(commands.account.subcommands.link.shared.savedToSettings(settingsPath));
+    return exit(EXIT_CODES.SUCCESS);
+}
+async function handleGlobalUse(args) {
     const { exit } = args;
     let newDefaultAccount = args.account;
     const usingGlobalConfig = globalConfigFileExists();
@@ -52,6 +114,14 @@ async function handler(args) {
     setConfigAccountAsDefault(String(newDefaultAccount));
     return uiLogger.success(commands.account.subcommands.use.success.defaultAccountUpdated(account.name));
 }
+async function handler(args) {
+    const hsSettings = getHsSettingsFileIfExists();
+    const isLinked = isDirectoryLinked(hsSettings);
+    if (isLinked) {
+        return handleLinkedUse(args, hsSettings);
+    }
+    return handleGlobalUse(args);
+}
 function accountUseBuilder(yargs) {
     yargs.positional('account', {
         describe: commands.account.subcommands.use.options.account.describe,

package/commands/account.js

@@ -8,12 +8,16 @@ import remove from './account/remove.js';
 import clean from './account/clean.js';
 import createOverride from './account/createOverride.js';
 import removeOverride from './account/removeOverride.js';
+import link from './account/link.js';
+import unlink from './account/unlink.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 const command = ['account', 'accounts'];
 const describe = commands.account.describe;
 function accountBuilder(yargs) {
     yargs
         .command(auth)
+        .command(link)
+        .command(unlink)
         .command(list)
         .command(rename)
         .command(use)

package/commands/project/appInstallStatus.d.ts

@@ -0,0 +1,4 @@
+import { AccountArgs, CommonArgs, ConfigArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
+type ProjectInstallStatusArgs = CommonArgs & ConfigArgs & AccountArgs & JSONOutputArgs;
+declare const projectInstallStatusCommand: YargsCommandModule<unknown, ProjectInstallStatusArgs>;
+export default projectInstallStatusCommand;