@hubspot/cli 7.5.11-experimental.0 → 7.6.0-beta.1

package/commands/project/create.js

@@ -5,71 +5,75 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = __importDefault(require("path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const chalk_1 = __importDefault(require("chalk"));
-const logger_1 = require("@hubspot/local-dev-lib/logger");
 const github_1 = require("@hubspot/local-dev-lib/github");
 const path_2 = require("@hubspot/local-dev-lib/path");
 const usageTracking_1 = require("../../lib/usageTracking");
-const createProjectPrompt_1 = require("../../lib/prompts/createProjectPrompt");
 const config_1 = require("../../lib/projects/config");
-const create_1 = require("../../lib/projects/create");
-const lang_1 = require("../../lib/lang");
+const legacy_1 = require("../../lib/projects/create/legacy");
+const v3_1 = require("../../lib/projects/create/v3");
 const ui_1 = require("../../lib/ui");
 const errorHandlers_1 = require("../../lib/errorHandlers");
 const exitCodes_1 = require("../../lib/enums/exitCodes");
 const constants_1 = require("../../lib/constants");
 const yargsUtils_1 = require("../../lib/yargsUtils");
-const command = 'create';
-const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.create.describe`), false);
+const projects_1 = require("@hubspot/local-dev-lib/constants/projects");
+const en_1 = require("../../lang/en");
+const logger_1 = require("../../lib/ui/logger");
+const v3_2 = require("../../lib/projects/create/v3");
+const create_1 = require("../../lib/projects/create");
+const command = ['create', 'init'];
+const describe = (0, ui_1.uiBetaTag)(en_1.commands.project.create.describe, false);
+const { v2023_2, v2025_1, v2025_2 } = projects_1.PLATFORM_VERSIONS;
 async function handler(args) {
-    const { derivedAccountId } = args;
-    let latestRepoReleaseTag;
-    let templateSource = args.templateSource;
-    if (!templateSource) {
-        templateSource = constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
-        try {
-            const releaseData = await (0, github_1.fetchReleaseData)(constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH);
-            if (releaseData) {
-                latestRepoReleaseTag = releaseData.tag_name;
-            }
-        }
-        catch (err) {
-            logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.error.failedToFetchProjectList`));
-            process.exit(exitCodes_1.EXIT_CODES.ERROR);
-        }
-    }
-    if (!templateSource || !templateSource.includes('/')) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.error.invalidTemplateSource`));
+    const { derivedAccountId, platformVersion, templateSource } = args;
+    if (templateSource && !templateSource.includes('/')) {
+        logger_1.uiLogger.error(en_1.commands.project.create.errors.invalidTemplateSource);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    const projectTemplates = await (0, create_1.getProjectTemplateListFromRepo)(templateSource, latestRepoReleaseTag || constants_1.DEFAULT_PROJECT_TEMPLATE_BRANCH);
-    if (!projectTemplates.length) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.error.failedToFetchProjectList`));
+    const repo = templateSource || constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
+    let handleResult;
+    try {
+        handleResult = await (0, create_1.handleProjectCreationFlow)(args);
+    }
+    catch (error) {
+        (0, errorHandlers_1.logError)(error);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(args, projectTemplates);
+    const { authType, distribution, repoConfig, projectContents, createProjectPromptResponse, } = handleResult;
+    (0, usageTracking_1.trackCommandUsage)('project-create', {
+        type: createProjectPromptResponse.projectTemplate?.name ||
+            (createProjectPromptResponse.componentTemplates || [])
+                // @ts-expect-error
+                .map((item) => item.label)
+                .join(','),
+    }, derivedAccountId);
     const projectDest = path_1.default.resolve((0, path_2.getCwd)(), createProjectPromptResponse.dest);
-    (0, usageTracking_1.trackCommandUsage)('project-create', { type: createProjectPromptResponse.projectTemplate.name }, derivedAccountId);
     const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await (0, config_1.getProjectConfig)(projectDest);
     // Exit if the target destination is within an existing project
     if (existingProjectConfig &&
         existingProjectDir &&
         projectDest.startsWith(existingProjectDir)) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.errors.cannotNestProjects`, {
-            projectDir: existingProjectDir,
-        }));
+        logger_1.uiLogger.error(en_1.commands.project.create.errors.cannotNestProjects(existingProjectDir));
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
+    const components = (0, v3_2.generateComponentPaths)({
+        createProjectPromptResponse,
+        platformVersion,
+        repoConfig,
+        projectContents,
+        authType,
+        distribution,
+    });
     try {
-        await (0, github_1.cloneGithubRepo)(templateSource, projectDest, {
-            sourceDir: createProjectPromptResponse.projectTemplate.path,
-            tag: latestRepoReleaseTag,
+        await (0, github_1.cloneGithubRepo)(repo, projectDest, {
+            sourceDir: createProjectPromptResponse.projectTemplate?.path || components,
             hideLogs: true,
+            branch: 'main',
         });
     }
     catch (err) {
         (0, errorHandlers_1.debugError)(err);
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.errors.failedToDownloadProject`));
+        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);
@@ -79,17 +83,13 @@ async function handler(args) {
         name: createProjectPromptResponse.name,
     });
     // If the template is 'no-template', we need to manually create a src directory
-    if (createProjectPromptResponse.projectTemplate.name ===
-        create_1.EMPTY_PROJECT_TEMPLATE_NAME) {
+    if (createProjectPromptResponse.projectTemplate?.name ===
+        legacy_1.EMPTY_PROJECT_TEMPLATE_NAME ||
+        projectContents === v3_1.EMPTY_PROJECT) {
         fs_extra_1.default.ensureDirSync(path_1.default.join(projectDest, 'src'));
     }
-    logger_1.logger.log('');
-    logger_1.logger.success((0, lang_1.i18n)(`commands.project.subcommands.create.logs.success`, {
-        projectName: createProjectPromptResponse.name,
-        projectDest,
-    }));
-    logger_1.logger.log('');
-    logger_1.logger.log(chalk_1.default.bold((0, lang_1.i18n)(`commands.project.subcommands.create.logs.welcomeMessage`)));
+    logger_1.uiLogger.success(en_1.commands.project.create.logs.success(createProjectPromptResponse.name, projectDest));
+    logger_1.uiLogger.log(en_1.commands.project.create.logs.welcomeMessage);
     (0, ui_1.uiFeatureHighlight)([
         'projectCommandTip',
         'projectUploadCommand',
@@ -104,32 +104,61 @@ async function handler(args) {
 function projectCreateBuilder(yargs) {
     yargs.options({
         name: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.name.describe`),
+            describe: en_1.commands.project.create.options.name.describe,
             type: 'string',
         },
         dest: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.dest.describe`),
+            describe: en_1.commands.project.create.options.dest.describe,
             type: 'string',
         },
         template: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.template.describe`),
+            // TODO: When we release 2025.2 scaffolding, we need to point out this is only valid for 2025.1 prior
+            describe: en_1.commands.project.create.options.template.describe,
             type: 'string',
         },
         'template-source': {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.templateSource.describe`),
+            describe: en_1.commands.project.create.options.templateSource.describe,
+            type: 'string',
+        },
+        'platform-version': {
+            describe: en_1.commands.project.create.options.platformVersion.describe,
+            hidden: true,
             type: 'string',
+            choices: [v2023_2, v2025_1, v2025_2],
+            default: v2023_2,
+        },
+        'project-base': {
+            describe: en_1.commands.project.create.options.projectBase.describe,
+            hidden: true,
+            type: 'string',
+            choices: [v3_1.EMPTY_PROJECT, v3_1.PROJECT_WITH_APP],
+        },
+        distribution: {
+            describe: en_1.commands.project.create.options.distribution.describe,
+            hidden: true,
+            type: 'string',
+            choices: [constants_1.privateDistribution, constants_1.marketplaceDistribution],
+        },
+        auth: {
+            describe: en_1.commands.project.create.options.auth.describe,
+            hidden: true,
+            type: 'string',
+            choices: [constants_1.oAuth, constants_1.staticAuth],
+        },
+        features: {
+            describe: en_1.commands.project.create.options.features.describe,
+            hidden: true,
+            type: 'array',
         },
     });
+    yargs.conflicts('template', 'features');
     yargs.example([
-        [
-            '$0 project create',
-            (0, lang_1.i18n)(`commands.project.subcommands.create.examples.default`),
-        ],
+        ['$0 project create', en_1.commands.project.create.examples.default],
     ]);
     yargs.example([
         [
             '$0 project create --template-source HubSpot/ui-extensions-examples',
-            (0, lang_1.i18n)(`commands.project.subcommands.create.examples.templateSource`),
+            en_1.commands.project.create.examples.templateSource,
         ],
     ]);
     return yargs;

package/commands/project/deploy.d.ts

@@ -3,6 +3,8 @@ export type ProjectDeployArgs = CommonArgs & ConfigArgs & AccountArgs & Environm
     project?: string;
     build?: number;
     buildId?: number;
+    profile?: string;
+    force: boolean;
 };
 declare const projectDeployCommand: YargsCommandModule<unknown, ProjectDeployArgs>;
 export default projectDeployCommand;

package/commands/project/deploy.js

@@ -21,6 +21,8 @@ const ui_1 = require("../../lib/ui");
 const exitCodes_1 = require("../../lib/enums/exitCodes");
 const ui_2 = require("../../lib/ui");
 const yargsUtils_1 = require("../../lib/yargsUtils");
+const projectProfiles_1 = require("../../lib/projectProfiles");
+const constants_1 = require("../../lib/constants");
 const command = 'deploy';
 const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.deploy.describe`), false);
 function validateBuildId(buildId, deployedBuildId, latestBuildId, projectName, accountId) {
@@ -39,30 +41,63 @@ function validateBuildId(buildId, deployedBuildId, latestBuildId, projectName, a
     }
     return true;
 }
+function logDeployErrors(errorData) {
+    logger_1.logger.error(errorData.message);
+    errorData.errors.forEach(err => {
+        if (err.subCategory === constants_1.PROJECT_ERROR_TYPES.DEPLOY_CONTAINS_REMOVALS) {
+            logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.deploy.errors.deployContainsRemovals`, {
+                componentName: err.context.COMPONENT_NAME,
+                forceFlag: (0, ui_2.uiCommandReference)('--force'),
+            }));
+        }
+        else {
+            logger_1.logger.log(err.message);
+        }
+    });
+}
 async function handler(args) {
-    const { derivedAccountId } = args;
+    const { derivedAccountId, project: projectOption, buildId: buildIdOption, force: forceOption, } = args;
     const accountConfig = (0, config_1.getAccountConfig)(derivedAccountId);
-    const { project: projectOption, buildId: buildIdOption } = args;
     const accountType = accountConfig && accountConfig.accountType;
-    (0, usageTracking_1.trackCommandUsage)('project-deploy', accountType ? { type: accountType } : undefined, derivedAccountId);
-    const { projectConfig } = await (0, config_2.getProjectConfig)();
+    let targetAccountId;
+    const { projectConfig, projectDir } = await (0, config_2.getProjectConfig)();
+    if ((0, buildAndDeploy_1.useV3Api)(projectConfig?.platformVersion)) {
+        if (args.profile) {
+            (0, projectProfiles_1.logProfileHeader)(args.profile);
+            const profile = (0, projectProfiles_1.loadProfile)(projectConfig, projectDir, args.profile);
+            if (!profile) {
+                (0, ui_1.uiLine)();
+                process.exit(exitCodes_1.EXIT_CODES.ERROR);
+            }
+            targetAccountId = profile.accountId;
+            (0, projectProfiles_1.logProfileFooter)(profile);
+        }
+        else {
+            // A profile must be specified if this project has profiles configured
+            await (0, projectProfiles_1.exitIfUsingProfiles)(projectConfig, projectDir);
+        }
+    }
+    if (!targetAccountId) {
+        targetAccountId = derivedAccountId;
+    }
+    (0, usageTracking_1.trackCommandUsage)('project-deploy', accountType ? { type: accountType } : undefined, targetAccountId);
     let projectName = projectOption;
     if (!projectOption && projectConfig) {
         projectName = projectConfig.name;
     }
-    const namePromptResponse = await (0, projectNamePrompt_1.projectNamePrompt)(derivedAccountId, {
+    const namePromptResponse = await (0, projectNamePrompt_1.projectNamePrompt)(targetAccountId, {
         project: projectName,
     });
     projectName = namePromptResponse.projectName;
     let buildIdToDeploy = buildIdOption;
     try {
-        const { data: { latestBuild, deployedBuildId }, } = await (0, projects_1.fetchProject)(derivedAccountId, projectName);
+        const { data: { latestBuild, deployedBuildId }, } = await (0, projects_1.fetchProject)(targetAccountId, projectName);
         if (!latestBuild || !latestBuild.buildId) {
             logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.deploy.errors.noBuilds`));
             return process.exit(exitCodes_1.EXIT_CODES.ERROR);
         }
         if (buildIdToDeploy) {
-            const validationResult = validateBuildId(buildIdToDeploy, deployedBuildId, latestBuild.buildId, projectName, derivedAccountId);
+            const validationResult = validateBuildId(buildIdToDeploy, deployedBuildId, latestBuild.buildId, projectName, targetAccountId);
             if (validationResult !== true) {
                 logger_1.logger.error(validationResult);
                 return process.exit(exitCodes_1.EXIT_CODES.ERROR);
@@ -75,7 +110,7 @@ async function handler(args) {
                 default: latestBuild.buildId === deployedBuildId
                     ? undefined
                     : latestBuild.buildId,
-                validate: buildId => validateBuildId(buildId, deployedBuildId, latestBuild.buildId, projectName, derivedAccountId),
+                validate: buildId => validateBuildId(buildId, deployedBuildId, latestBuild.buildId, projectName, targetAccountId),
             });
             buildIdToDeploy = deployBuildIdPromptResponse.buildId;
         }
@@ -83,27 +118,32 @@ async function handler(args) {
             logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.deploy.errors.noBuildId`));
             return process.exit(exitCodes_1.EXIT_CODES.ERROR);
         }
-        const { data: deployResp } = await (0, projects_1.deployProject)(derivedAccountId, projectName, buildIdToDeploy, (0, buildAndDeploy_1.useV3Api)(projectConfig?.platformVersion));
+        const { data: deployResp } = await (0, projects_1.deployProject)(targetAccountId, projectName, buildIdToDeploy, (0, buildAndDeploy_1.useV3Api)(projectConfig?.platformVersion), forceOption);
         if (!deployResp) {
             logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.deploy.errors.deploy`));
             return process.exit(exitCodes_1.EXIT_CODES.ERROR);
         }
-        await (0, buildAndDeploy_2.pollDeployStatus)(derivedAccountId, projectName, Number(deployResp.id), buildIdToDeploy);
+        await (0, buildAndDeploy_2.pollDeployStatus)(targetAccountId, projectName, Number(deployResp.id), buildIdToDeploy);
     }
     catch (e) {
         if ((0, index_1.isHubSpotHttpError)(e) && e.status === 404) {
             logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.deploy.errors.projectNotFound`, {
                 projectName: chalk_1.default.bold(projectName),
-                accountIdentifier: (0, ui_2.uiAccountDescription)(derivedAccountId),
+                accountIdentifier: (0, ui_2.uiAccountDescription)(targetAccountId),
                 command: (0, ui_2.uiCommandReference)('hs project upload'),
             }));
         }
         else if ((0, index_1.isHubSpotHttpError)(e) && e.status === 400) {
-            logger_1.logger.error(e.message);
+            if (e.data?.message && e.data?.errors) {
+                logDeployErrors(e.data);
+            }
+            else {
+                logger_1.logger.error(e.message);
+            }
         }
         else {
             (0, index_2.logError)(e, new index_2.ApiErrorContext({
-                accountId: derivedAccountId,
+                accountId: targetAccountId,
                 request: 'project deploy',
             }));
         }
@@ -121,7 +161,21 @@ function projectDeployBuilder(yargs) {
             describe: (0, lang_1.i18n)(`commands.project.subcommands.deploy.options.build.describe`),
             type: 'number',
         },
+        profile: {
+            alias: ['p'],
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.deploy.options.profile.describe`),
+            type: 'string',
+            hidden: true,
+        },
+        force: {
+            alias: ['f'],
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.deploy.options.force.describe`),
+            default: false,
+            type: 'boolean',
+        },
     });
+    yargs.conflicts('profile', 'project');
+    yargs.conflicts('profile', 'account');
     yargs.example([
         [
             '$0 project deploy',

package/commands/project/dev/deprecatedFlow.d.ts

@@ -1,5 +1,11 @@
 import { ArgumentsCamelCase } from 'yargs';
-import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
 import { ProjectConfig } from '../../../types/Projects';
 import { ProjectDevArgs } from '../../../types/Yargs';
-export declare function deprecatedProjectDevFlow(args: ArgumentsCamelCase<ProjectDevArgs>, accountConfig: CLIAccount, projectConfig: ProjectConfig, projectDir: string): Promise<void>;
+type DeprecatedProjectDevFlowArgs = {
+    args: ArgumentsCamelCase<ProjectDevArgs>;
+    accountId: number;
+    projectConfig: ProjectConfig;
+    projectDir: string;
+};
+export declare function deprecatedProjectDevFlow({ args, accountId, projectConfig, projectDir, }: DeprecatedProjectDevFlowArgs): Promise<void>;
+export {};

package/commands/project/dev/deprecatedFlow.js

@@ -18,7 +18,7 @@ const helpers_1 = require("../../../lib/projects/localDev/helpers");
 const process_1 = require("../../../lib/process");
 const accountTypes_1 = require("../../../lib/accountTypes");
 const ensureProjectExists_1 = require("../../../lib/projects/ensureProjectExists");
-async function deprecatedProjectDevFlow(args, accountConfig, projectConfig, projectDir) {
+async function deprecatedProjectDevFlow({ args, accountId, projectConfig, projectDir, }) {
     const { providedAccountId, derivedAccountId } = args;
     const env = (0, environment_1.getValidEnv)((0, config_1.getEnv)(derivedAccountId));
     const components = await (0, structure_1.findProjectComponents)(projectDir);
@@ -26,6 +26,14 @@ async function deprecatedProjectDevFlow(args, accountConfig, projectConfig, proj
     const componentTypes = (0, structure_1.getProjectComponentTypes)(runnableComponents);
     const hasPrivateApps = !!componentTypes[Projects_1.ComponentTypes.PrivateApp];
     const hasPublicApps = !!componentTypes[Projects_1.ComponentTypes.PublicApp];
+    const accountConfig = (0, config_1.getAccountConfig)(accountId);
+    if (!accountConfig) {
+        logger_1.logger.error((0, lang_1.i18n)('commands.project.subcommands.dev.errors.noAccount', {
+            accountId: accountId,
+            authCommand: (0, ui_1.uiCommandReference)('hs auth'),
+        }));
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
     if (runnableComponents.length === 0) {
         logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.dev.errors.noRunnableComponents`, {
             projectDir,

package/commands/project/dev/index.d.ts

@@ -1,8 +1,5 @@
-import { ArgumentsCamelCase, Argv, CommandModule } from 'yargs';
+import { Argv, CommandModule } from 'yargs';
 import { ProjectDevArgs } from '../../../types/Yargs';
-export declare const command = "dev";
-export declare const describe: string;
-export declare function handler(args: ArgumentsCamelCase<ProjectDevArgs>): Promise<void>;
 export declare const builder: (yargs: Argv) => Promise<Argv<ProjectDevArgs>>;
 declare const projectDevCommand: CommandModule<unknown, ProjectDevArgs>;
 export default projectDevCommand;

package/commands/project/dev/index.js

@@ -1,10 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.builder = exports.describe = exports.command = void 0;
-exports.handler = handler;
+exports.builder = void 0;
 const usageTracking_1 = require("../../../lib/usageTracking");
-const lang_1 = require("../../../lib/lang");
-const logger_1 = require("@hubspot/local-dev-lib/logger");
 const config_1 = require("@hubspot/local-dev-lib/config");
 const config_2 = require("../../../lib/projects/config");
 const exitCodes_1 = require("../../../lib/enums/exitCodes");
@@ -13,52 +10,112 @@ const deprecatedFlow_1 = require("./deprecatedFlow");
 const unifiedFlow_1 = require("./unifiedFlow");
 const buildAndDeploy_1 = require("../../../lib/projects/buildAndDeploy");
 const yargsUtils_1 = require("../../../lib/yargsUtils");
-exports.command = 'dev';
-exports.describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.dev.describe`), false);
-async function handler(args) {
-    const { derivedAccountId } = args;
-    const accountConfig = (0, config_1.getAccountConfig)(derivedAccountId);
-    (0, usageTracking_1.trackCommandUsage)('project-dev', {}, derivedAccountId);
-    const { projectConfig, projectDir } = await (0, config_2.getProjectConfig)();
-    (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.dev.logs.betaMessage`));
-    logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`commands.project.subcommands.dev.logs.learnMoreLocalDevServer`), 'https://developers.hubspot.com/docs/platform/project-cli-commands#start-a-local-development-server'));
-    if (!projectConfig || !projectDir) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.dev.errors.noProjectConfig`, {
-            accountId: derivedAccountId,
-            authCommand: (0, ui_1.uiCommandReference)('hs auth'),
-        }));
+const projectProfiles_1 = require("../../../lib/projectProfiles");
+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) {
+    // 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 (!accountConfig) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.dev.errors.noAccount`));
+    if (providedAccountId && 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 { projectConfig, projectDir } = await (0, config_2.getProjectConfig)();
     (0, config_2.validateProjectConfig)(projectConfig, projectDir);
+    const useV3 = (0, buildAndDeploy_1.useV3Api)(projectConfig.platformVersion);
+    if (!projectDir) {
+        logger_1.uiLogger.error(en_1.commands.project.dev.errors.noProjectConfig);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    validateAccountFlags(testingAccount, projectAccount, providedAccountId, useV3);
+    let targetProjectAccountId = (projectAccount && (0, config_1.getAccountId)(projectAccount)) ||
+        (providedAccountId && derivedAccountId);
+    let profile;
+    if (!targetProjectAccountId && (0, buildAndDeploy_1.useV3Api)(projectConfig.platformVersion)) {
+        if (args.profile) {
+            (0, projectProfiles_1.logProfileHeader)(args.profile);
+            profile = (0, projectProfiles_1.loadProfile)(projectConfig, projectDir, args.profile);
+            if (!profile) {
+                (0, ui_1.uiLine)();
+                process.exit(exitCodes_1.EXIT_CODES.ERROR);
+            }
+            targetProjectAccountId = profile.accountId;
+            (0, projectProfiles_1.logProfileFooter)(profile);
+        }
+        else {
+            // A profile must be specified if this project has profiles configured
+            await (0, projectProfiles_1.exitIfUsingProfiles)(projectConfig, projectDir);
+        }
+    }
+    if (!targetProjectAccountId) {
+        // The user is not using profile or account flags, so we can use the derived accountId
+        targetProjectAccountId = derivedAccountId;
+    }
+    (0, usageTracking_1.trackCommandUsage)('project-dev', {}, targetProjectAccountId);
+    (0, ui_1.uiBetaTag)(en_1.commands.project.dev.logs.betaMessage);
+    logger_1.uiLogger.log(en_1.commands.project.dev.logs.learnMoreLocalDevServer);
     if ((0, buildAndDeploy_1.useV3Api)(projectConfig.platformVersion)) {
-        await (0, unifiedFlow_1.unifiedProjectDevFlow)(args, accountConfig, projectConfig, projectDir);
+        const targetTestingAccountId = (testingAccount && (0, config_1.getAccountId)(testingAccount)) || undefined;
+        await (0, unifiedFlow_1.unifiedProjectDevFlow)({
+            args,
+            targetProjectAccountId,
+            providedTargetTestingAccountId: targetTestingAccountId,
+            projectConfig,
+            projectDir,
+            profileConfig: profile,
+        });
     }
     else {
-        await (0, deprecatedFlow_1.deprecatedProjectDevFlow)(args, accountConfig, projectConfig, projectDir);
+        await (0, deprecatedFlow_1.deprecatedProjectDevFlow)({
+            args,
+            accountId: targetProjectAccountId,
+            projectConfig,
+            projectDir,
+        });
     }
 }
 function projectDevBuilder(yargs) {
-    yargs.example([
-        [
-            '$0 project dev',
-            (0, lang_1.i18n)(`commands.project.subcommands.dev.examples.default`),
-        ],
-    ]);
+    yargs.option('profile', {
+        type: 'string',
+        alias: 'p',
+        description: en_1.commands.project.dev.options.profile,
+        hidden: true,
+    });
+    yargs.options('testingAccount', {
+        type: 'string',
+        description: en_1.commands.project.dev.options.testingAccount,
+        hidden: true,
+        implies: ['projectAccount'],
+    });
+    yargs.options('projectAccount', {
+        type: 'string',
+        description: en_1.commands.project.dev.options.projectAccount,
+        hidden: true,
+        implies: ['testingAccount'],
+    });
+    yargs.example([['$0 project dev', en_1.commands.project.dev.examples.default]]);
+    yargs.conflicts('profile', 'account');
+    yargs.conflicts('profile', 'testingAccount');
+    yargs.conflicts('profile', 'projectAccount');
     return yargs;
 }
-exports.builder = (0, yargsUtils_1.makeYargsBuilder)(projectDevBuilder, exports.command, exports.describe, {
+exports.builder = (0, yargsUtils_1.makeYargsBuilder)(projectDevBuilder, command, describe, {
     useGlobalOptions: true,
     useAccountOptions: true,
     useConfigOptions: true,
     useEnvironmentOptions: true,
 });
 const projectDevCommand = {
-    command: exports.command,
-    describe: exports.describe,
+    command,
+    describe,
     handler,
     builder: exports.builder,
 };

package/commands/project/dev/unifiedFlow.d.ts

@@ -1,5 +1,14 @@
 import { ArgumentsCamelCase } from 'yargs';
-import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
+import { HsProfileFile } from '@hubspot/project-parsing-lib/src/lib/types';
 import { ProjectDevArgs } from '../../../types/Yargs';
 import { ProjectConfig } from '../../../types/Projects';
-export declare function unifiedProjectDevFlow(args: ArgumentsCamelCase<ProjectDevArgs>, accountConfig: CLIAccount, projectConfig: ProjectConfig, projectDir: string): Promise<void>;
+type UnifiedProjectDevFlowArgs = {
+    args: ArgumentsCamelCase<ProjectDevArgs>;
+    targetProjectAccountId: number;
+    providedTargetTestingAccountId?: number;
+    projectConfig: ProjectConfig;
+    projectDir: string;
+    profileConfig?: HsProfileFile;
+};
+export declare function unifiedProjectDevFlow({ args, targetProjectAccountId, providedTargetTestingAccountId, projectConfig, projectDir, profileConfig, }: UnifiedProjectDevFlowArgs): Promise<void>;
+export {};