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

package/bin/cli.js

@@ -44,6 +44,8 @@ const feedback_1 = __importDefault(require("../commands/feedback"));
 const doctor_1 = __importDefault(require("../commands/doctor"));
 const completion_1 = __importDefault(require("../commands/completion"));
 const app_1 = __importDefault(require("../commands/app"));
+const testAccount_1 = __importDefault(require("../commands/testAccount"));
+const getStarted_1 = __importDefault(require("../commands/getStarted"));
 const mcp_1 = __importDefault(require("../commands/mcp"));
 function getTerminalWidth() {
     const width = yargs_1.default.terminalWidth();
@@ -123,6 +125,8 @@ const argv = yargs_1.default
     .command(doctor_1.default)
     .command(completion_1.default)
     .command(app_1.default)
+    .command(testAccount_1.default)
+    .command(getStarted_1.default)
     .command(mcp_1.default)
     .help()
     .alias('h', 'help')

package/bin/hs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-require('./silenceErrors')
+require('./silenceErrors');
 
 require('./cli');

package/commands/account/auth.js

@@ -98,9 +98,9 @@ async function handleConfigMigration() {
 const describe = en_1.commands.account.subcommands.auth.describe;
 const command = 'auth';
 async function handler(args) {
-    const { providedAccountId, disableTracking, personalAccessKey: providedPersonalAccessKey, } = args;
+    const { disableTracking, personalAccessKey: providedPersonalAccessKey, derivedAccountId, } = args;
     if (!disableTracking) {
-        (0, usageTracking_1.trackCommandUsage)('account-auth', {}, providedAccountId);
+        (0, usageTracking_1.trackCommandUsage)('account-auth', {}, derivedAccountId);
         await (0, usageTracking_1.trackAuthAction)('account-auth', authType, TRACKING_STATUS.STARTED);
     }
     const configMigrationSuccess = await handleConfigMigration();
@@ -114,7 +114,7 @@ async function handler(args) {
     }
     (0, config_1.loadConfig)('');
     (0, process_1.handleExit)(config_1.deleteEmptyConfigFile);
-    const updatedConfig = await updateConfigWithNewAccount(args.qa ? environments_1.ENVIRONMENTS.QA : environments_1.ENVIRONMENTS.PROD, configAlreadyExists, providedPersonalAccessKey, providedAccountId);
+    const updatedConfig = await updateConfigWithNewAccount(args.qa ? environments_1.ENVIRONMENTS.QA : environments_1.ENVIRONMENTS.PROD, configAlreadyExists, providedPersonalAccessKey, derivedAccountId);
     if (!updatedConfig) {
         if (!disableTracking) {
             await (0, usageTracking_1.trackAuthAction)('account-auth', authType, TRACKING_STATUS.ERROR);

package/commands/app/install.d.ts

@@ -0,0 +1,8 @@
+import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, YargsCommandModule, JSONOutputArgs } from '../../types/Yargs';
+type InstallAppArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs & {
+    appUid?: string;
+    projectName?: string;
+    testAccountId: number;
+};
+declare const installAppCommand: YargsCommandModule<unknown, InstallAppArgs>;
+export default installAppCommand;

package/commands/app/install.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const developerTestAccounts_1 = require("@hubspot/local-dev-lib/api/developerTestAccounts");
+const usageTracking_1 = require("../../lib/usageTracking");
+const en_1 = require("../../lang/en");
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const yargsUtils_1 = require("../../lib/yargsUtils");
+const constants_1 = require("../../lib/constants");
+const logger_1 = require("../../lib/ui/logger");
+const SpinniesManager_1 = __importDefault(require("../../lib/ui/SpinniesManager"));
+const errorHandlers_1 = require("../../lib/errorHandlers");
+const polling_1 = require("../../lib/polling");
+const config_1 = require("../../lib/projects/config");
+const upload_1 = require("../../lib/projects/upload");
+const structure_1 = require("../../lib/projects/structure");
+const command = 'install <test-account-id>';
+const describe = undefined; // commands.app.subcommands.install.describe;
+async function handler(args) {
+    const { derivedAccountId, appUid, projectName, testAccountId, formatOutputAsJson, } = args;
+    (0, usageTracking_1.trackCommandUsage)('app-install', {}, derivedAccountId);
+    const jsonOutput = {};
+    let targetProjectName = projectName;
+    let targetAppUid = appUid;
+    const { projectConfig, projectDir } = await (0, config_1.getProjectConfig)();
+    if (!targetProjectName) {
+        (0, config_1.validateProjectConfig)(projectConfig, projectDir);
+        targetProjectName = projectConfig?.name;
+    }
+    if (!targetProjectName) {
+        logger_1.uiLogger.error(en_1.commands.app.subcommands.install.errors.mustSpecifyProjectName);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    let isAppOauth = true;
+    if (!targetAppUid) {
+        const intermediateRepresentation = await (0, upload_1.handleTranslate)(projectDir, projectConfig, derivedAccountId, true, undefined);
+        if (intermediateRepresentation) {
+            Object.values(intermediateRepresentation.intermediateNodesIndexedByUid).forEach(node => {
+                if ((0, structure_1.isAppIRNode)(node)) {
+                    targetAppUid = node.uid;
+                    isAppOauth = node.config.auth.type === constants_1.APP_AUTH_TYPES.OAUTH;
+                }
+            });
+        }
+    }
+    if (!targetAppUid) {
+        logger_1.uiLogger.error(en_1.commands.app.subcommands.install.errors.noAppUidFound);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    if (!isAppOauth) {
+        logger_1.uiLogger.error(en_1.commands.app.subcommands.install.errors.appMustBeOauth);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    try {
+        const { data } = await (0, developerTestAccounts_1.installOauthAppIntoDeveloperTestAccount)(derivedAccountId, testAccountId, targetProjectName, targetAppUid);
+        if (data?.authCodes.length > 0) {
+            jsonOutput.authCode = data.authCodes[0].authCode;
+        }
+    }
+    catch (err) {
+        (0, errorHandlers_1.logError)(err);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    SpinniesManager_1.default.init({
+        succeedColor: 'white',
+    });
+    SpinniesManager_1.default.add('installApp', {
+        text: en_1.commands.app.subcommands.install.polling.start,
+    });
+    let appInstallSucceeded = false;
+    try {
+        await (0, polling_1.poll)(() => (0, developerTestAccounts_1.fetchDeveloperTestAccountOauthAppInstallStatus)(derivedAccountId, targetProjectName, targetAppUid), {
+            successStates: ['SUCCESS'],
+            errorStates: [],
+        });
+        appInstallSucceeded = true;
+    }
+    catch (err) {
+        SpinniesManager_1.default.fail('installApp');
+        (0, errorHandlers_1.logError)(err);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    if (!appInstallSucceeded) {
+        SpinniesManager_1.default.fail('installApp');
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    SpinniesManager_1.default.succeed('installApp', {
+        text: en_1.commands.app.subcommands.install.polling.success,
+    });
+    if (formatOutputAsJson) {
+        logger_1.uiLogger.json(jsonOutput);
+    }
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+}
+function installAppBuilder(yargs) {
+    yargs.positional('test-account-id', {
+        describe: en_1.commands.app.subcommands.install.positionals.testAccountId,
+        required: true,
+        type: 'number',
+    });
+    yargs.option('app-uid', {
+        describe: en_1.commands.app.subcommands.install.options.appUid,
+        type: 'string',
+    });
+    yargs.option('project-name', {
+        describe: en_1.commands.app.subcommands.install.options.projectName,
+        type: 'string',
+    });
+    yargs.example('install 1234567890 --app-uid=my-app-uid --project-name=my-project', en_1.commands.app.subcommands.install.example);
+    return yargs;
+}
+const builder = (0, yargsUtils_1.makeYargsBuilder)(installAppBuilder, command, en_1.commands.app.subcommands.install.describe, {
+    useGlobalOptions: true,
+    useAccountOptions: true,
+    useConfigOptions: true,
+    useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
+});
+const installAppCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = installAppCommand;

package/commands/app.js

@@ -5,12 +5,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const migrate_1 = __importDefault(require("./app/migrate"));
 const secret_1 = __importDefault(require("./app/secret"));
+const install_1 = __importDefault(require("./app/install"));
 const yargsUtils_1 = require("../lib/yargsUtils");
 const command = ['app', 'apps'];
 // Keep the command hidden for now
 const describe = undefined;
 function appBuilder(yargs) {
-    yargs.command(migrate_1.default).command(secret_1.default).demandCommand(1, '');
+    yargs
+        .command(migrate_1.default)
+        .command(secret_1.default)
+        .command(install_1.default)
+        .demandCommand(1, '');
     return yargs;
 }
 const builder = (0, yargsUtils_1.makeYargsBuilder)(appBuilder, command, describe);

package/commands/auth.js

@@ -1,11 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const git_1 = require("../lib/ui/git");
-const logger_1 = require("@hubspot/local-dev-lib/logger");
 const auth_1 = require("@hubspot/local-dev-lib/constants/auth");
 const environments_1 = require("@hubspot/local-dev-lib/constants/environments");
 const config_1 = require("@hubspot/local-dev-lib/constants/config");
-const lang_1 = require("../lib/lang");
 const personalAccessKey_1 = require("@hubspot/local-dev-lib/personalAccessKey");
 const config_2 = require("@hubspot/local-dev-lib/config");
 const text_1 = require("@hubspot/local-dev-lib/text");
@@ -21,6 +19,8 @@ const exitCodes_1 = require("../lib/enums/exitCodes");
 const ui_1 = require("../lib/ui");
 const index_1 = require("../lib/errorHandlers/index");
 const en_1 = require("../lang/en");
+const logger_1 = require("../lib/ui/logger");
+const parsing_1 = require("../lib/parsing");
 const TRACKING_STATUS = {
     STARTED: 'started',
     ERROR: 'error',
@@ -32,9 +32,19 @@ const ALLOWED_AUTH_METHODS = [
 ];
 const SUPPORTED_AUTHENTICATION_PROTOCOLS_TEXT = (0, text_1.commaSeparatedValues)(ALLOWED_AUTH_METHODS);
 const command = 'auth';
-const describe = (0, lang_1.i18n)('commands.auth.describe');
+const describe = en_1.commands.auth.describe;
 async function handler(args) {
-    const { authType: authTypeFlagValue, config: configFlagValue, qa, providedAccountId, personalAccessKey: providedPersonalAccessKey, } = args;
+    const { authType: authTypeFlagValue, config: configFlagValue, qa, personalAccessKey: providedPersonalAccessKey, userProvidedAccount, } = args;
+    let parsedUserProvidedAccountId;
+    try {
+        if (userProvidedAccount) {
+            parsedUserProvidedAccountId = (0, parsing_1.parseStringToNumber)(userProvidedAccount);
+        }
+    }
+    catch (err) {
+        (0, index_1.logError)(en_1.commands.auth.errors.invalidAccountIdProvided);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
     const authType = (authTypeFlagValue && authTypeFlagValue.toLowerCase()) ||
         auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value;
     (0, commonOpts_1.setLogLevel)(args);
@@ -46,13 +56,11 @@ async function handler(args) {
         (0, git_1.checkAndWarnGitInclusion)(configPath);
     }
     if ((0, config_2.configFileExists)(true)) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.auth.errors.globalConfigFileExists`, {
-            accountAuthCommand: (0, ui_1.uiCommandReference)('hs account auth'),
-        }));
+        logger_1.uiLogger.error(en_1.commands.auth.errors.globalConfigFileExists('hs account auth'));
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
     (0, usageTracking_1.trackCommandUsage)('auth');
-    (0, usageTracking_1.trackAuthAction)('auth', authType, TRACKING_STATUS.STARTED, providedAccountId);
+    (0, usageTracking_1.trackAuthAction)('auth', authType, TRACKING_STATUS.STARTED, parsedUserProvidedAccountId);
     let configData;
     let updatedConfig;
     let validName;
@@ -73,7 +81,7 @@ async function handler(args) {
                 ? { personalAccessKey: providedPersonalAccessKey }
                 : await (0, personalAccessKeyPrompt_1.personalAccessKeyPrompt)({
                     env,
-                    account: providedAccountId,
+                    account: parsedUserProvidedAccountId,
                 });
             try {
                 token = await (0, personalAccessKey_1.getAccessToken)(personalAccessKey, env);
@@ -101,24 +109,17 @@ async function handler(args) {
             successAuthMethod = auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.name;
             break;
         default:
-            logger_1.logger.error((0, lang_1.i18n)('commands.auth.errors.unsupportedAuthType', {
-                supportedProtocols: SUPPORTED_AUTHENTICATION_PROTOCOLS_TEXT,
-                type: authType,
-            }));
+            logger_1.uiLogger.error(en_1.commands.auth.errors.unsupportedAuthType(authType, SUPPORTED_AUTHENTICATION_PROTOCOLS_TEXT));
             break;
     }
     if (!successAuthMethod) {
-        await (0, usageTracking_1.trackAuthAction)('auth', authType, TRACKING_STATUS.ERROR, providedAccountId);
+        await (0, usageTracking_1.trackAuthAction)('auth', authType, TRACKING_STATUS.ERROR, parsedUserProvidedAccountId);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
     const nameFromConfigData = configData && 'name' in configData ? configData.name : undefined;
     const accountName = (updatedConfig && updatedConfig.name) || validName || nameFromConfigData;
     await (0, setAsDefaultAccountPrompt_1.setAsDefaultAccountPrompt)(accountName);
-    logger_1.logger.success((0, lang_1.i18n)('commands.auth.success.configFileUpdated', {
-        configFilename: config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME,
-        authType: successAuthMethod,
-        accountName,
-    }));
+    logger_1.uiLogger.success(en_1.commands.auth.success.configFileUpdated(accountName, config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, successAuthMethod));
     (0, ui_1.uiFeatureHighlight)([
         'accountsUseCommand',
         'accountOption',
@@ -131,7 +132,7 @@ async function handler(args) {
 function authBuilder(yargs) {
     yargs.options({
         'auth-type': {
-            describe: (0, lang_1.i18n)('commands.auth.options.authType.describe'),
+            describe: en_1.commands.auth.options.authType.describe,
             type: 'string',
             choices: [
                 `${auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value}`,
@@ -140,7 +141,7 @@ function authBuilder(yargs) {
             default: auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value,
         },
         account: {
-            describe: (0, lang_1.i18n)('commands.auth.options.account.describe'),
+            describe: en_1.commands.auth.options.account.describe,
             type: 'string',
             alias: 'a',
         },
@@ -153,10 +154,7 @@ function authBuilder(yargs) {
     });
     return yargs;
 }
-const builder = (0, yargsUtils_1.makeYargsBuilder)(authBuilder, command, (0, lang_1.i18n)('commands.auth.verboseDescribe', {
-    authMethod: auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value,
-    configName: config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME,
-}), {
+const builder = (0, yargsUtils_1.makeYargsBuilder)(authBuilder, command, en_1.commands.auth.verboseDescribe(auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value, config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME), {
     useGlobalOptions: true,
     useConfigOptions: true,
     useTestingOptions: true,

package/commands/getStarted.d.ts

@@ -0,0 +1,9 @@
+import { AccountArgs, YargsCommandModule, CommonArgs, ConfigArgs, EnvironmentArgs } from '../types/Yargs';
+export declare const command = "get-started";
+export declare const describe: undefined;
+type GetStartedArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
+    name?: string;
+    dest?: string;
+};
+declare const getStartedCommand: YargsCommandModule<unknown, GetStartedArgs>;
+export default getStartedCommand;

package/commands/getStarted.js

@@ -0,0 +1,274 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describe = exports.command = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const open_1 = __importDefault(require("open"));
+const path_2 = require("@hubspot/local-dev-lib/path");
+const github_1 = require("@hubspot/local-dev-lib/github");
+const en_1 = require("../lang/en");
+const usageTracking_1 = require("../lib/usageTracking");
+const exitCodes_1 = require("../lib/enums/exitCodes");
+const yargsUtils_1 = require("../lib/yargsUtils");
+const promptUtils_1 = require("../lib/prompts/promptUtils");
+const projectNameAndDestPrompt_1 = require("../lib/prompts/projectNameAndDestPrompt");
+const ui_1 = require("../lib/ui");
+const logger_1 = require("../lib/ui/logger");
+const errorHandlers_1 = require("../lib/errorHandlers");
+const upload_1 = require("../lib/projects/upload");
+const constants_1 = require("../lib/constants");
+const config_1 = require("../lib/projects/config");
+const dependencyManagement_1 = require("../lib/dependencyManagement");
+const buildAndDeploy_1 = require("../lib/projects/buildAndDeploy");
+const links_1 = require("../lib/links");
+const urls_1 = require("../lib/app/urls");
+const config_2 = require("@hubspot/local-dev-lib/config");
+const environments_1 = require("@hubspot/local-dev-lib/constants/environments");
+const appsDev_1 = require("@hubspot/local-dev-lib/api/appsDev");
+exports.command = 'get-started';
+exports.describe = undefined;
+async function handler(args) {
+    const { derivedAccountId } = args;
+    const env = (0, config_2.getEnv)(derivedAccountId) === 'qa' ? environments_1.ENVIRONMENTS.QA : environments_1.ENVIRONMENTS.PROD;
+    // TODO: Put this in constants.ts once we have a defined place for the template before INBOUND
+    const templateSource = 'robrown-hubspot/hubspot-project-components-ua-app-objects-beta';
+    (0, usageTracking_1.trackCommandUsage)('get-started', {}, derivedAccountId);
+    (0, ui_1.uiInfoSection)(en_1.commands.getStarted.startTitle, () => {
+        logger_1.uiLogger.log(en_1.commands.getStarted.startDescription);
+    });
+    const { default: selectedOption } = await (0, promptUtils_1.promptUser)([
+        {
+            type: 'list',
+            name: 'default',
+            message: en_1.commands.getStarted.prompts.selectOption,
+            choices: [
+                {
+                    name: en_1.commands.getStarted.prompts.options.app,
+                    value: constants_1.GET_STARTED_OPTIONS.APP,
+                },
+                {
+                    name: en_1.commands.getStarted.prompts.options.cms,
+                    value: constants_1.GET_STARTED_OPTIONS.CMS,
+                },
+            ],
+            default: constants_1.GET_STARTED_OPTIONS.APP,
+        },
+    ]);
+    if (selectedOption === constants_1.GET_STARTED_OPTIONS.CMS) {
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.designManager);
+        if (process.env.BROWSER !== 'none') {
+            logger_1.uiLogger.log(' ');
+            const { shouldOpen } = await (0, promptUtils_1.promptUser)([
+                {
+                    name: 'shouldOpen',
+                    type: 'confirm',
+                    message: en_1.commands.getStarted.openDesignManagerPrompt,
+                },
+            ]);
+            if (shouldOpen) {
+                logger_1.uiLogger.log('');
+                (0, links_1.openLink)(derivedAccountId, 'design-manager');
+            }
+        }
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+    }
+    else {
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.logs.appSelected);
+        // 1. Fetch project templates
+        let latestRepoReleaseTag;
+        const { dest, name } = await (0, projectNameAndDestPrompt_1.projectNameAndDestPrompt)(args);
+        // Specific template for get-started command
+        const projectTemplate = {
+            name: 'private-app-get-started-template',
+            label: 'CRM getting started project with private apps',
+            path: 'projects/private-app-get-started-template',
+        };
+        // 3. Create the project files
+        const projectDest = path_1.default.resolve((0, path_2.getCwd)(), dest);
+        const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await (0, config_1.getProjectConfig)(projectDest);
+        if (existingProjectConfig &&
+            existingProjectDir &&
+            projectDest.startsWith(existingProjectDir)) {
+            logger_1.uiLogger.log(' ');
+            logger_1.uiLogger.error(en_1.commands.project.create.errors.cannotNestProjects(existingProjectDir));
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        const repo = templateSource || constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
+        // 4. Clone the project template from GitHub
+        // This is temporary until we have the UA template in the main repo
+        try {
+            await (0, github_1.cloneGithubRepo)(repo, projectDest, {
+                sourceDir: projectTemplate.path,
+                tag: latestRepoReleaseTag,
+                hideLogs: true,
+            });
+        }
+        catch (err) {
+            (0, errorHandlers_1.debugError)(err);
+            logger_1.uiLogger.log(' ');
+            logger_1.uiLogger.error(en_1.commands.project.create.errors.failedToDownloadProject);
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        const projectConfigPath = path_1.default.join(projectDest, constants_1.PROJECT_CONFIG_FILE);
+        const parsedConfigFile = JSON.parse(fs_extra_1.default.readFileSync(projectConfigPath).toString());
+        (0, config_1.writeProjectConfig)(projectConfigPath, {
+            ...parsedConfigFile,
+            name,
+        });
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.success(en_1.commands.project.create.logs.success(name, projectDest));
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.prompts.projectCreated.title);
+        logger_1.uiLogger.log(' ');
+        logger_1.uiLogger.log(en_1.commands.getStarted.prompts.projectCreated.description);
+        logger_1.uiLogger.log(' ');
+        // 5. Install dependencies - Ask user if they want to install dependencies
+        const { shouldInstallDependencies } = await (0, promptUtils_1.promptUser)([
+            {
+                type: 'confirm',
+                name: 'shouldInstallDependencies',
+                message: en_1.commands.getStarted.prompts.installDependencies,
+                default: true,
+            },
+        ]);
+        if (shouldInstallDependencies) {
+            try {
+                // Change to the project directory to install dependencies
+                const originalCwd = process.cwd();
+                process.chdir(projectDest);
+                try {
+                    await (0, dependencyManagement_1.installPackages)({});
+                    logger_1.uiLogger.log(' ');
+                    logger_1.uiLogger.success(en_1.commands.getStarted.logs.dependenciesInstalled);
+                    logger_1.uiLogger.log(' ');
+                }
+                finally {
+                    // Always restore the original working directory
+                    process.chdir(originalCwd);
+                }
+            }
+            catch (err) {
+                logger_1.uiLogger.log(' ');
+                logger_1.uiLogger.error(en_1.commands.getStarted.errors.installDepsFailed);
+                console.log(err);
+                logger_1.uiLogger.log(' ');
+            }
+        }
+        else {
+            logger_1.uiLogger.log(' ');
+            logger_1.uiLogger.log(en_1.commands.getStarted.logs.dependenciesNotInstalled);
+            logger_1.uiLogger.log(' ');
+        }
+        // 6. Ask user if they want to upload the project
+        const { shouldUpload } = await (0, promptUtils_1.promptUser)([
+            {
+                type: 'confirm',
+                name: 'shouldUpload',
+                message: en_1.commands.getStarted.prompts.uploadProject,
+                default: true,
+            },
+        ]);
+        if (shouldUpload) {
+            try {
+                // Get the project config for the newly created project
+                const { projectConfig: newProjectConfig, projectDir: newProjectDir } = await (0, config_1.getProjectConfig)(projectDest);
+                if (!newProjectConfig || !newProjectDir) {
+                    logger_1.uiLogger.log(' ');
+                    logger_1.uiLogger.error(en_1.commands.getStarted.errors.configFileNotFound);
+                    process.exit(exitCodes_1.EXIT_CODES.ERROR);
+                }
+                (0, config_1.validateProjectConfig)(newProjectConfig, newProjectDir);
+                const targetAccountId = derivedAccountId;
+                logger_1.uiLogger.log(' ');
+                logger_1.uiLogger.log(en_1.commands.getStarted.logs.uploadingProject);
+                logger_1.uiLogger.log(' ');
+                const { result, uploadError } = await (0, upload_1.handleProjectUpload)({
+                    accountId: targetAccountId,
+                    projectConfig: newProjectConfig,
+                    projectDir: newProjectDir,
+                    callbackFunc: buildAndDeploy_1.pollProjectBuildAndDeploy,
+                    uploadMessage: 'Initial upload from get-started command',
+                    forceCreate: true, // Auto-create project on HubSpot
+                    isUploadCommand: false,
+                    sendIR: (0, buildAndDeploy_1.useV3Api)(newProjectConfig.platformVersion),
+                    skipValidation: false,
+                });
+                if (uploadError) {
+                    logger_1.uiLogger.log(' ');
+                    logger_1.uiLogger.error(en_1.commands.getStarted.errors.uploadFailed);
+                    (0, errorHandlers_1.debugError)(uploadError);
+                }
+                else if (result) {
+                    logger_1.uiLogger.success(en_1.commands.getStarted.logs.uploadSuccess);
+                    const { data: { results }, } = await (0, appsDev_1.fetchPublicAppsForPortal)(derivedAccountId);
+                    const lastCreatedApp = results.sort((a, b) => b.createdAt - a.createdAt)[0];
+                    if (process.env.BROWSER !== 'none') {
+                        logger_1.uiLogger.log(' ');
+                        logger_1.uiLogger.log(en_1.commands.getStarted.developerOverviewBrowserOpenPrep);
+                        logger_1.uiLogger.log(' ');
+                        const { shouldOpenOverview } = await (0, promptUtils_1.promptUser)([
+                            {
+                                name: 'shouldOpenOverview',
+                                type: 'confirm',
+                                message: en_1.commands.getStarted.openInstallUrl,
+                            },
+                        ]);
+                        if (shouldOpenOverview) {
+                            (0, open_1.default)((0, urls_1.getStaticAuthAppInstallUrl)({
+                                targetAccountId: derivedAccountId,
+                                env: env,
+                                appId: lastCreatedApp.id,
+                            }), { url: true });
+                            logger_1.uiLogger.log(' ');
+                            logger_1.uiLogger.success(en_1.commands.getStarted.openedDeveloperOverview);
+                        }
+                    }
+                    logger_1.uiLogger.log(' ');
+                    (0, ui_1.uiFeatureHighlight)(['projectDevCommand']);
+                }
+            }
+            catch (err) {
+                logger_1.uiLogger.log(' ');
+                logger_1.uiLogger.error(en_1.commands.getStarted.errors.uploadFailed);
+                (0, errorHandlers_1.debugError)(err);
+                process.exit(exitCodes_1.EXIT_CODES.ERROR);
+            }
+        }
+    }
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+}
+function getStartedBuilder(yargs) {
+    yargs.options({
+        name: {
+            describe: en_1.commands.getStarted.options.name.describe,
+            type: 'string',
+        },
+        dest: {
+            describe: en_1.commands.getStarted.options.dest.describe,
+            type: 'string',
+        },
+        'template-source': {
+            describe: en_1.commands.getStarted.options.templateSource.describe,
+            type: 'string',
+        },
+    });
+    return yargs;
+}
+const builder = (0, yargsUtils_1.makeYargsBuilder)(getStartedBuilder, exports.command, en_1.commands.getStarted.verboseDescribe, {
+    useGlobalOptions: true,
+    useAccountOptions: true,
+    useConfigOptions: true,
+    useEnvironmentOptions: true,
+});
+const getStartedCommand = {
+    command: exports.command,
+    describe: exports.describe,
+    handler,
+    builder,
+};
+exports.default = getStartedCommand;