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

package/commands/project/dev/deprecatedFlow.js

@@ -19,7 +19,7 @@ const process_1 = require("../../../lib/process");
 const accountTypes_1 = require("../../../lib/accountTypes");
 const ensureProjectExists_1 = require("../../../lib/projects/ensureProjectExists");
 async function deprecatedProjectDevFlow({ args, accountId, projectConfig, projectDir, }) {
-    const { providedAccountId, derivedAccountId } = args;
+    const { userProvidedAccount, derivedAccountId } = args;
     const env = (0, environment_1.getValidEnv)((0, config_1.getEnv)(derivedAccountId));
     const components = await (0, structure_1.findProjectComponents)(projectDir);
     const runnableComponents = components.filter(component => component.runnable);
@@ -65,11 +65,11 @@ async function deprecatedProjectDevFlow({ args, accountId, projectConfig, projec
     }
     // targetProjectAccountId and targetTestingAccountId are set to null if --account flag is not provided.
     // By setting them to null, we can later check if they need to be assigned based on the default account configuration and the type of app.
-    let targetProjectAccountId = providedAccountId ? derivedAccountId : null;
+    let targetProjectAccountId = userProvidedAccount ? derivedAccountId : null;
     // The account that we are locally testing against
-    let targetTestingAccountId = providedAccountId ? derivedAccountId : null;
+    let targetTestingAccountId = userProvidedAccount ? derivedAccountId : null;
     // Check that the default account or flag option is valid for the type of app in this project
-    if (providedAccountId) {
+    if (userProvidedAccount) {
         (0, helpers_1.checkIfAccountFlagIsSupported)(accountConfig, hasPublicApps);
         if (hasPublicApps) {
             targetProjectAccountId = accountConfig.parentAccountId || null;

package/commands/project/dev/index.js

@@ -15,19 +15,19 @@ const en_1 = require("../../../lang/en");
 const logger_1 = require("../../../lib/ui/logger");
 const command = 'dev';
 const describe = (0, ui_1.uiBetaTag)(en_1.commands.project.dev.describe, false);
-function validateAccountFlags(testingAccount, projectAccount, providedAccountId, useV3) {
+function validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV3) {
     // Legacy projects do not support targetTestingAccount and targetProjectAccount
     if (testingAccount && projectAccount && !useV3) {
         logger_1.uiLogger.error(en_1.commands.project.dev.errors.unsupportedAccountFlagLegacy);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    if (providedAccountId && useV3) {
+    if (userProvidedAccount && useV3) {
         logger_1.uiLogger.error(en_1.commands.project.dev.errors.unsupportedAccountFlagV3);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
 }
 async function handler(args) {
-    const { derivedAccountId, providedAccountId, testingAccount, projectAccount, } = args;
+    const { derivedAccountId, userProvidedAccount, testingAccount, projectAccount, } = args;
     const { projectConfig, projectDir } = await (0, config_2.getProjectConfig)();
     (0, config_2.validateProjectConfig)(projectConfig, projectDir);
     const useV3 = (0, buildAndDeploy_1.useV3Api)(projectConfig.platformVersion);
@@ -35,9 +35,9 @@ async function handler(args) {
         logger_1.uiLogger.error(en_1.commands.project.dev.errors.noProjectConfig);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    validateAccountFlags(testingAccount, projectAccount, providedAccountId, useV3);
+    validateAccountFlags(testingAccount, projectAccount, userProvidedAccount, useV3);
     let targetProjectAccountId = (projectAccount && (0, config_1.getAccountId)(projectAccount)) ||
-        (providedAccountId && derivedAccountId);
+        (userProvidedAccount && derivedAccountId);
     let profile;
     if (!targetProjectAccountId && (0, buildAndDeploy_1.useV3Api)(projectConfig.platformVersion)) {
         if (args.profile) {

package/commands/project/dev/unifiedFlow.js

@@ -58,6 +58,7 @@ async function unifiedProjectDevFlow({ args, targetProjectAccountId, providedTar
     }
     const accounts = (0, config_2.getConfigAccounts)();
     const accountIsCombined = await (0, accountTypes_1.isUnifiedAccount)(targetProjectAccountConfig);
+    const targetProjectAccountIsTestAccountOrSandbox = (0, accountTypes_1.isTestAccountOrSandbox)(targetProjectAccountConfig);
     if (!accountIsCombined && !profileConfig) {
         logger_1.uiLogger.error(en_1.commands.project.dev.errors.accountNotCombined);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
@@ -67,6 +68,12 @@ async function unifiedProjectDevFlow({ args, targetProjectAccountId, providedTar
         // Bypass the prompt for the testing account if the user has a profile configured
         targetTestingAccountId = profileConfig.accountId;
     }
+    else if (
+    // Bypass the prompt for the testing account if default account is already a test account
+    !targetTestingAccountId &&
+        targetProjectAccountIsTestAccountOrSandbox) {
+        targetTestingAccountId = targetProjectAccountId;
+    }
     else if (!targetTestingAccountId) {
         logger_1.uiLogger.log('');
         (0, ui_1.uiLine)();
@@ -121,6 +128,7 @@ async function unifiedProjectDevFlow({ args, targetProjectAccountId, providedTar
         debug: args.debug,
         deployedBuild,
         isGithubLinked,
+        profile: args.profile,
         targetProjectAccountId,
         targetTestingAccountId: targetTestingAccountId,
         projectConfig,

package/commands/sandbox/delete.js

@@ -19,10 +19,10 @@ const yargsUtils_1 = require("../../lib/yargsUtils");
 const command = 'delete';
 const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.sandbox.subcommands.delete.describe`), false);
 async function handler(args) {
-    const { providedAccountId, force } = args;
-    (0, usageTracking_1.trackCommandUsage)('sandbox-delete', {}, providedAccountId);
+    const { userProvidedAccount, derivedAccountId, force } = args;
+    (0, usageTracking_1.trackCommandUsage)('sandbox-delete', {}, derivedAccountId);
     let accountPrompt;
-    if (!providedAccountId) {
+    if (!userProvidedAccount) {
         if (!force) {
             accountPrompt = await (0, sandboxesPrompt_1.deleteSandboxPrompt)();
         }
@@ -40,7 +40,7 @@ async function handler(args) {
             process.exit(exitCodes_1.EXIT_CODES.ERROR);
         }
     }
-    const sandboxAccountId = (0, config_1.getAccountId)(providedAccountId || accountPrompt.account);
+    const sandboxAccountId = (0, config_1.getAccountId)(userProvidedAccount || accountPrompt.account);
     if (!sandboxAccountId) {
         logger_1.logger.error((0, lang_1.i18n)(`commands.sandbox.subcommands.delete.failure.noSandboxAccountId`));
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
@@ -114,7 +114,7 @@ async function handler(args) {
             : `commands.sandbox.subcommands.delete.success.delete`;
         logger_1.logger.log('');
         logger_1.logger.success((0, lang_1.i18n)(deleteKey, {
-            account: providedAccountId || accountPrompt.account,
+            account: userProvidedAccount || accountPrompt.account,
             sandboxHubId: sandboxAccountId || '',
         }));
         logger_1.logger.log('');

package/commands/testAccount/create.js

@@ -15,6 +15,9 @@ const usageTracking_1 = require("../../lib/usageTracking");
 const validation_1 = require("../../lib/validation");
 const en_1 = require("../../lang/en");
 const createDeveloperTestAccountConfigPrompt_1 = require("../../lib/prompts/createDeveloperTestAccountConfigPrompt");
+const errorHandlers_1 = require("../../lib/errorHandlers");
+const polling_1 = require("../../lib/polling");
+const SpinniesManager_1 = __importDefault(require("../../lib/ui/SpinniesManager"));
 const command = 'create';
 const describe = en_1.commands.testAccount.create.describe;
 async function handler(args) {
@@ -62,19 +65,66 @@ async function handler(args) {
         testAccountConfig = await (0, createDeveloperTestAccountConfigPrompt_1.createDeveloperTestAccountConfigPrompt)();
     }
     const jsonOutput = {};
+    let testAccountId;
+    SpinniesManager_1.default.init({
+        succeedColor: 'white',
+    });
+    SpinniesManager_1.default.add('createTestAccount', {
+        text: en_1.commands.testAccount.create.polling.start(testAccountConfig.accountName),
+    });
     try {
         const { data } = await (0, developerTestAccounts_1.createDeveloperTestAccount)(derivedAccountId, testAccountConfig);
         if (formatOutputAsJson) {
             jsonOutput.accountName = data.accountName;
             jsonOutput.accountId = data.id;
-            jsonOutput.personalAccessKey = data.personalAccessKey;
         }
-        logger_1.uiLogger.success(en_1.commands.testAccount.create.success.configFileUpdated(data.accountName, data.id));
+        testAccountId = data.id;
+    }
+    catch (err) {
+        SpinniesManager_1.default.fail('createTestAccount', {
+            text: en_1.commands.testAccount.create.polling.createFailure,
+        });
+        (0, errorHandlers_1.logError)(err);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    SpinniesManager_1.default.update('createTestAccount', {
+        text: en_1.commands.testAccount.create.polling.syncing,
+    });
+    try {
+        await (0, polling_1.poll)(() => (0, developerTestAccounts_1.fetchDeveloperTestAccountGateSyncStatus)(derivedAccountId, testAccountId), {
+            successStates: ['SUCCESS'],
+            errorStates: [],
+        });
     }
     catch (err) {
-        logger_1.uiLogger.error(en_1.commands.testAccount.create.errors.failedToCreate);
+        (0, errorHandlers_1.debugError)(err);
+        SpinniesManager_1.default.fail('createTestAccount', {
+            text: en_1.commands.testAccount.create.polling.syncFailure,
+        });
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
+    if (formatOutputAsJson) {
+        // HACK: The status endpoint sometimes returns an early success status.
+        // Sleep for an extra 10 seconds to make sure the sync is actually complete.
+        await new Promise(resolve => setTimeout(resolve, 10000));
+        try {
+            // Attempt to generate a new personal access key for the test account now that gate sync is complete.
+            const { data } = await (0, developerTestAccounts_1.generateDeveloperTestAccountPersonalAccessKey)(derivedAccountId, testAccountId);
+            if (data.personalAccessKey && data.personalAccessKey) {
+                jsonOutput.personalAccessKey = data.personalAccessKey;
+            }
+        }
+        catch (err) {
+            (0, errorHandlers_1.debugError)(err);
+            SpinniesManager_1.default.fail('createTestAccount', {
+                text: en_1.commands.testAccount.create.polling.pakFailure,
+            });
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+    }
+    SpinniesManager_1.default.succeed('createTestAccount', {
+        text: en_1.commands.testAccount.create.polling.success(testAccountConfig.accountName, testAccountId),
+    });
     if (formatOutputAsJson) {
         logger_1.uiLogger.json(jsonOutput);
     }

package/lang/en.d.ts

@@ -28,7 +28,7 @@ export declare const commands: {
         readonly openDesignManagerPrompt: "Open Design Manager in your browser?";
         readonly openedDesignManager: "Redirected to Design Manager!";
         readonly developerOverviewBrowserOpenPrep: "We'll take you to your HubSpot account and walk you through installing and previewing your new app.";
-        readonly openDeveloperOverviewPrompt: "Open HubSpot to go to your account?";
+        readonly openInstallUrl: "Open HubSpot to install your app in your account?";
         readonly openedDeveloperOverview: "HubSpot opened!";
         readonly prompts: {
             readonly selectOption: "Are you looking to build apps or CMS?";
@@ -36,17 +36,20 @@ export declare const commands: {
                 readonly app: "App";
                 readonly cms: "CMS";
             };
+            readonly installDependencies: "Would you like to install dependencies now?";
             readonly uploadProject: "Would you like to upload your project to HubSpot now?";
-            readonly appSelected: `We'll create a new project with a sample app for you.
-Projects are what you can use to create apps, themes, and more at HubSpot.
-Usually you'll use the ${string} command, but we'll go ahead and make one now.`;
             readonly projectCreated: {
                 readonly title: string;
-                readonly description: `Upload your project to HubSpot - typically, you'll use the command ${string} for this.
-We'll start the process now.`;
+                readonly description: `Let's prepare and upload your project to HubSpot.
+You can use ${string} to ${string} and ${string} to ${string} your project.`;
             };
         };
         readonly logs: {
+            readonly appSelected: `We'll create a new project with a sample app for you.
+Projects are what you can use to create apps, themes, and more at HubSpot.
+Usually you'll use the ${string} command, but we'll go ahead and make one now.`;
+            readonly dependenciesInstalled: "Dependencies installed successfully.";
+            readonly dependenciesNotInstalled: `Dependencies not installed. Remember to do this later with the command ${string} from the project directory.`;
             readonly uploadingProject: "Uploading your project to HubSpot...";
             readonly uploadSuccess: "Project uploaded successfully!";
             readonly developerOverviewLink: "Open this link to navigate to your HubSpot developer portal";
@@ -54,6 +57,7 @@ We'll start the process now.`;
         readonly errors: {
             readonly uploadFailed: "Failed to upload project to HubSpot.";
             readonly configFileNotFound: "Could not find project configuration for upload.";
+            readonly installDepsFailed: "Failed to install dependencies.";
         };
     };
     readonly completion: {
@@ -189,8 +193,11 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
         };
     };
     readonly auth: {
-        readonly describe: (configName: string) => string;
+        readonly describe: "Configure authentication for your HubSpot account.";
+        readonly verboseDescribe: (configName: string, authMethod: string) => string;
         readonly errors: {
+            readonly invalidAccountIdProvided: "--account must be a number.";
+            readonly globalConfigFileExists: (accountAuthCommand: string) => string;
             readonly noConfigFileFound: "No config file was found. To create a new config file, use the \"hs init\" command.";
             readonly unsupportedAuthType: (type: string, supportedProtocols: string) => string;
         };
@@ -735,7 +742,8 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
         };
     };
     readonly init: {
-        readonly describe: (configName: string) => string;
+        readonly describe: "Create a CLI config file and configure authentication for your HubSpot account.";
+        readonly verboseDescribe: (configName: string, command: string, authMethod: string) => string;
         readonly options: {
             readonly authType: {
                 readonly describe: "Authentication mechanism";
@@ -750,14 +758,16 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
         };
         readonly success: {
             readonly configFileCreated: (configPath: string) => string;
-            readonly configFileUpdated: (account: string, authType: string) => string;
+            readonly configFileUpdated: (authType: string, account: string | number) => string;
         };
         readonly logs: {
             readonly updateConfig: "To update an existing config file, use the \"hs auth\" command.";
         };
         readonly errors: {
+            readonly invalidAccountIdProvided: "--account must be a number.";
             readonly configFileExists: (configPath: string) => string;
             readonly bothConfigFilesNotAllowed: (path: string) => string;
+            readonly globalConfigFileExists: `You are using our new global configuration for account management, which is not compatible with this command. Please use ${string} instead.`;
         };
     };
     readonly lint: {
@@ -1492,6 +1502,28 @@ ${string}`;
     readonly app: {
         readonly describe: "Commands for managing apps.";
         readonly subcommands: {
+            readonly install: {
+                readonly describe: "Install an OAuth app into a test account.";
+                readonly options: {
+                    readonly appUid: "The uid of the app to install";
+                    readonly projectName: "The name of the project that contains the app";
+                };
+                readonly positionals: {
+                    readonly testAccountId: "The id of the test account to install the app into";
+                };
+                readonly errors: {
+                    readonly mustSpecifyProjectName: `You must specify a project name. Use the ${string} flag to specify the project name or run this command from within a project directory.`;
+                    readonly noAppUidFound: `No app uid found. Please specify the app uid with the ${string} flag or run this command from within a project that contains an app.`;
+                    readonly appMustBeOauth: "This command only supports installing oauth apps. Please specify an app with oauth auth type.";
+                };
+                readonly polling: {
+                    readonly start: "Installing app...";
+                    readonly success: "App installed successfully";
+                    readonly failure: "App installation failed";
+                    readonly error: "Error installing app";
+                };
+                readonly example: "Install the app with uid my-app-uid from the project named \"my-project\" into the target account with id 1234567890";
+            };
             readonly secret: {
                 readonly describe: "Commands for managing secrets.";
                 readonly subcommands: {
@@ -1796,10 +1828,14 @@ ${string}`;
             readonly errors: {
                 readonly configFileNotFound: (configPath: string) => string;
                 readonly configFileParseFailed: (configPath: string) => string;
-                readonly failedToCreate: "Failed to create test account";
             };
-            readonly success: {
-                readonly configFileUpdated: (testAccountName: string, testAccountId: number) => string;
+            readonly polling: {
+                readonly start: (testAccountName: string) => string;
+                readonly syncing: "Test account created! Syncing account data... (may take a few minutes - you can exit and the sync will continue)";
+                readonly success: (testAccountName: string, testAccountId: number) => string;
+                readonly createFailure: "Failed to create test account.";
+                readonly syncFailure: "Failed to sync data into test account. The account may not be ready to use.";
+                readonly pakFailure: "Failed to generate a personal access key for the test account.";
             };
             readonly options: {
                 readonly configPath: "The path to the test account config";
@@ -2426,6 +2462,12 @@ ${string}`;
     };
 };
 export declare const lib: {
+    readonly parsing: {
+        readonly unableToParseStringToNumber: "Unable to parse string to number";
+    };
+    readonly configMiddleWare: {
+        readonly invalidAccountIdEnvironmentVariable: "Unable to parse `HUBSPOT_ACCOUNT_ID` environment variable into a number";
+    };
     readonly process: {
         readonly exitDebug: (signal: string) => string;
     };
@@ -2595,6 +2637,9 @@ Run ${string} to upgrade to version ${string}`;
                 readonly invalidAuthDistCombo: (authType: string, distribution: string) => string;
             };
         };
+        readonly add: {
+            readonly nothingAdded: "No features added.";
+        };
         readonly validateProjectConfig: {
             readonly configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${string} to create a new project.`;
             readonly configMissingFields: "The project configuration file is missing required fields.";
@@ -2905,16 +2950,20 @@ Run ${string} to upgrade to version ${string}`;
                 readonly languageRequired: "Please select API sample app's language";
             };
         };
-        readonly createProjectPrompt: {
+        readonly projectNameAndDestPrompt: {
             readonly enterName: "[--name] Give your project a name: ";
             readonly enterDest: "[--dest] Enter the folder to create the project in:";
-            readonly selectTemplate: "[--template] Choose a project template: ";
-            readonly features: "[--features] Which features would you like your app to include?";
             readonly errors: {
                 readonly nameRequired: "A project name is required";
                 readonly destRequired: "A project dest is required";
                 readonly invalidDest: "There is an existing project at this destination. Please provide a new path for this project.";
                 readonly invalidCharacters: "The selected destination contains invalid characters. Please provide a new path and try again.";
+            };
+        };
+        readonly selectProjectTemplatePrompt: {
+            readonly selectTemplate: "[--template] Choose a project template: ";
+            readonly features: "[--features] Which features would you like your app to include?";
+            readonly errors: {
                 readonly invalidTemplate: (template: string) => string;
                 readonly projectTemplateRequired: "Project template is required when projectTemplates is provided";
             };
@@ -3019,6 +3068,9 @@ Run ${string} to upgrade to version ${string}`;
             };
         };
     };
+    readonly polling: {
+        readonly timeoutError: (timeoutMs: number) => string;
+    };
     readonly convertFields: {
         readonly positionals: {
             readonly src: {

package/lang/en.js

@@ -42,7 +42,7 @@ exports.commands = {
         openDesignManagerPrompt: 'Open Design Manager in your browser?',
         openedDesignManager: 'Redirected to Design Manager!',
         developerOverviewBrowserOpenPrep: "We'll take you to your HubSpot account and walk you through installing and previewing your new app.",
-        openDeveloperOverviewPrompt: 'Open HubSpot to go to your account?',
+        openInstallUrl: 'Open HubSpot to install your app in your account?',
         openedDeveloperOverview: 'HubSpot opened!',
         prompts: {
             selectOption: 'Are you looking to build apps or CMS?',
@@ -50,14 +50,17 @@ exports.commands = {
                 app: 'App',
                 cms: 'CMS',
             },
+            installDependencies: 'Would you like to install dependencies now?',
             uploadProject: 'Would you like to upload your project to HubSpot now?',
-            appSelected: `We'll create a new project with a sample app for you.\nProjects are what you can use to create apps, themes, and more at HubSpot.\nUsually you'll use the ${(0, ui_1.uiCommandReference)('hs project create')} command, but we'll go ahead and make one now.`,
             projectCreated: {
                 title: chalk_1.default.bold('Next steps:'),
-                description: `Upload your project to HubSpot - typically, you'll use the command ${(0, ui_1.uiCommandReference)('hs project upload')} for this.\nWe'll start the process now.`,
+                description: `Let's prepare and upload your project to HubSpot.\nYou can use ${(0, ui_1.uiCommandReference)('hs project install-deps')} to ${chalk_1.default.bold('install dependencies')} and ${(0, ui_1.uiCommandReference)('hs project upload')} to ${chalk_1.default.bold('upload')} your project.`,
             },
         },
         logs: {
+            appSelected: `We'll create a new project with a sample app for you.\nProjects are what you can use to create apps, themes, and more at HubSpot.\nUsually you'll use the ${(0, ui_1.uiCommandReference)('hs project create')} command, but we'll go ahead and make one now.`,
+            dependenciesInstalled: 'Dependencies installed successfully.',
+            dependenciesNotInstalled: `Dependencies not installed. Remember to do this later with the command ${(0, ui_1.uiCommandReference)('hs project install-deps')} from the project directory.`,
             uploadingProject: 'Uploading your project to HubSpot...',
             uploadSuccess: 'Project uploaded successfully!',
             developerOverviewLink: 'Open this link to navigate to your HubSpot developer portal',
@@ -65,6 +68,7 @@ exports.commands = {
         errors: {
             uploadFailed: 'Failed to upload project to HubSpot.',
             configFileNotFound: 'Could not find project configuration for upload.',
+            installDepsFailed: 'Failed to install dependencies.',
         },
     },
     completion: {
@@ -196,8 +200,11 @@ exports.commands = {
         },
     },
     auth: {
-        describe: (configName) => `Configure authentication for your HubSpot account. This will update the ${configName} file that stores your account information.`,
+        describe: 'Configure authentication for your HubSpot account.',
+        verboseDescribe: (configName, authMethod) => `Configure authentication for a HubSpot account. This will update the ${configName} file that stores your account information.\n\nThe recommended authentication method is ${chalk_1.default.bold(authMethod)}, which uses an access token tied to a specific user account.`,
         errors: {
+            invalidAccountIdProvided: `--account must be a number.`,
+            globalConfigFileExists: (accountAuthCommand) => `You are using our new global configuration for account management, which is not compatible with this command. Please use ${(0, ui_1.uiCommandReference)(accountAuthCommand)} instead.`,
             noConfigFileFound: 'No config file was found. To create a new config file, use the "hs init" command.',
             unsupportedAuthType: (type, supportedProtocols) => `Unsupported auth type: ${type}. The only supported authentication protocols are ${supportedProtocols}.`,
         },
@@ -744,7 +751,8 @@ exports.commands = {
         },
     },
     init: {
-        describe: (configName) => `Configure authentication for your HubSpot account. This will create a ${configName} file to store your account information.`,
+        describe: 'Create a CLI config file and configure authentication for your HubSpot account.',
+        verboseDescribe: (configName, command, authMethod) => `Configure authentication for a HubSpot account. This will create a ${configName} file to store your account information. To configure authentication for additional accounts, run ${command}.\n\nThe recommended authentication method is ${chalk_1.default.bold(authMethod)}, which uses an access token tied to a specific user account.`,
         options: {
             authType: {
                 describe: 'Authentication mechanism',
@@ -759,14 +767,16 @@ exports.commands = {
         },
         success: {
             configFileCreated: (configPath) => `Created config file "${configPath}"`,
-            configFileUpdated: (account, authType) => `Connected account "${account}" using "${authType}" and set it as the default account`,
+            configFileUpdated: (authType, account) => `Connected account "${account}" using "${authType}" and set it as the default account`,
         },
         logs: {
             updateConfig: 'To update an existing config file, use the "hs auth" command.',
         },
         errors: {
+            invalidAccountIdProvided: `--account must be a number.`,
             configFileExists: (configPath) => `The config file ${configPath} already exists.`,
             bothConfigFilesNotAllowed: (path) => `Unable to create config file, because there is an existing one at "${path}". To create a new config file, delete the existing one and try again.`,
+            globalConfigFileExists: `You are using our new global configuration for account management, which is not compatible with this command. Please use ${(0, ui_1.uiCommandReference)('hs account auth')} instead.`,
         },
     },
     lint: {
@@ -1490,6 +1500,28 @@ exports.commands = {
     app: {
         describe: 'Commands for managing apps.',
         subcommands: {
+            install: {
+                describe: 'Install an OAuth app into a test account.',
+                options: {
+                    appUid: 'The uid of the app to install',
+                    projectName: 'The name of the project that contains the app',
+                },
+                positionals: {
+                    testAccountId: 'The id of the test account to install the app into',
+                },
+                errors: {
+                    mustSpecifyProjectName: `You must specify a project name. Use the ${(0, ui_1.uiCommandReference)('--project-name')} flag to specify the project name or run this command from within a project directory.`,
+                    noAppUidFound: `No app uid found. Please specify the app uid with the ${(0, ui_1.uiCommandReference)('--app-uid')} flag or run this command from within a project that contains an app.`,
+                    appMustBeOauth: 'This command only supports installing oauth apps. Please specify an app with oauth auth type.',
+                },
+                polling: {
+                    start: 'Installing app...',
+                    success: 'App installed successfully',
+                    failure: 'App installation failed',
+                    error: 'Error installing app',
+                },
+                example: 'Install the app with uid my-app-uid from the project named "my-project" into the target account with id 1234567890',
+            },
             secret: {
                 describe: 'Commands for managing secrets.',
                 subcommands: {
@@ -1794,10 +1826,14 @@ exports.commands = {
             errors: {
                 configFileNotFound: (configPath) => `No test account config file exists at ${configPath}. Create a test account config file with the ${(0, ui_1.uiCommandReference)('hs test-account create-config')} command.`,
                 configFileParseFailed: (configPath) => `Failed to parse test account config file at ${configPath}`,
-                failedToCreate: 'Failed to create test account',
             },
-            success: {
-                configFileUpdated: (testAccountName, testAccountId) => `Test account "${testAccountName}" successfully created with id ${testAccountId}`,
+            polling: {
+                start: (testAccountName) => `Creating test account "${chalk_1.default.bold(testAccountName)}"...`,
+                syncing: 'Test account created! Syncing account data... (may take a few minutes - you can exit and the sync will continue)',
+                success: (testAccountName, testAccountId) => `Test account "${chalk_1.default.bold(testAccountName)}" successfully created with id: ${chalk_1.default.bold(testAccountId)}`,
+                createFailure: 'Failed to create test account.',
+                syncFailure: 'Failed to sync data into test account. The account may not be ready to use.',
+                pakFailure: 'Failed to generate a personal access key for the test account.',
             },
             options: {
                 configPath: 'The path to the test account config',
@@ -2424,6 +2460,12 @@ exports.commands = {
     },
 };
 exports.lib = {
+    parsing: {
+        unableToParseStringToNumber: 'Unable to parse string to number',
+    },
+    configMiddleWare: {
+        invalidAccountIdEnvironmentVariable: 'Unable to parse `HUBSPOT_ACCOUNT_ID` environment variable into a number',
+    },
     process: {
         exitDebug: (signal) => `Attempting to gracefully exit. Triggered by ${signal}`,
     },
@@ -2592,6 +2634,9 @@ exports.lib = {
                 invalidAuthDistCombo: (authType, distribution) => `Invalid distribution and auth combination. Apps with distribution '${distribution}' must have auth '${authType}'`,
             },
         },
+        add: {
+            nothingAdded: 'No features added.',
+        },
         validateProjectConfig: {
             configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${(0, ui_1.uiCommandReference)('hs project create')} to create a new project.`,
             configMissingFields: 'The project configuration file is missing required fields.',
@@ -2900,16 +2945,20 @@ exports.lib = {
                 languageRequired: "Please select API sample app's language",
             },
         },
-        createProjectPrompt: {
+        projectNameAndDestPrompt: {
             enterName: '[--name] Give your project a name: ',
             enterDest: '[--dest] Enter the folder to create the project in:',
-            selectTemplate: '[--template] Choose a project template: ',
-            features: '[--features] Which features would you like your app to include?',
             errors: {
                 nameRequired: 'A project name is required',
                 destRequired: 'A project dest is required',
                 invalidDest: 'There is an existing project at this destination. Please provide a new path for this project.',
                 invalidCharacters: 'The selected destination contains invalid characters. Please provide a new path and try again.',
+            },
+        },
+        selectProjectTemplatePrompt: {
+            selectTemplate: '[--template] Choose a project template: ',
+            features: '[--features] Which features would you like your app to include?',
+            errors: {
                 invalidTemplate: (template) => `[--template] Could not find template "${template}". Please choose an available template:`,
                 projectTemplateRequired: 'Project template is required when projectTemplates is provided',
             },
@@ -3014,6 +3063,9 @@ exports.lib = {
             },
         },
     },
+    polling: {
+        timeoutError: (timeoutMs) => `Polling timed out after ${timeoutMs}ms.`,
+    },
     convertFields: {
         positionals: {
             src: {

package/lib/accountTypes.d.ts

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

package/lib/accountTypes.js

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