@hubspot/cli 8.1.0-beta.0 → 8.1.0-experimental.0

package/lib/projects/ProjectLogsManager.js

@@ -4,7 +4,7 @@ import { fetchProjectComponentsMetadata } from '@hubspot/local-dev-lib/api/proje
 import { fetchAppMetadataBySourceId } from '@hubspot/local-dev-lib/api/appsDev';
 import { uiLogger } from '../ui/logger.js';
 import { commands } from '../../lang/en.js';
-import { isV2Project } from './platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { getDeployedProjectNodes } from './localDev/helpers/project.js';
 import { debugError } from '../errorHandlers/index.js';
 class _ProjectLogsManager {
@@ -51,7 +51,7 @@ class _ProjectLogsManager {
             throw new Error(commands.project.logs.errors.failedToFetchProjectDetails);
         }
         this.projectId = project.id;
-        if (isV2Project(projectConfig.platformVersion)) {
+        if (!isLegacyProject(projectConfig.platformVersion)) {
             const deployedBuildId = project.deployedBuild.buildId;
             if (!deployedBuildId) {
                 throw new Error(commands.project.logs.errors.noDeployedBuild);
@@ -134,9 +134,12 @@ class _ProjectLogsManager {
         return this.functions.map(serverlessFunction => serverlessFunction.componentName);
     }
     setFunction(functionName) {
-        if (!functionName || this.functions.length === 0) {
+        if (this.functions.length === 0) {
             throw new Error(commands.project.logs.errors.noFunctionsInProject);
         }
+        if (!functionName) {
+            throw new Error(commands.project.logs.errors.functionNameRequired);
+        }
         this.selectedFunction = this.functions.find(serverlessFunction => serverlessFunction.componentName === functionName);
         if (!this.selectedFunction) {
             throw new Error(commands.project.logs.errors.noFunctionWithName(functionName));

package/lib/projects/components.js

@@ -114,9 +114,19 @@ export function handleComponentCollision({ dest, src, collisions }) {
         }
     });
     const filenameDifferentiator = generateSafeFilenameDifferentiator(sourceFiles, hsMetaFiles);
-    // Exclude markdown files fromthe rename process because they should not be duplicated
     const sourceFilenameMapping = sourceFiles
-        .filter(filename => !filename.endsWith('.md'))
+        .filter(filename => {
+        // Exclude markdown files from the rename process because they should not be duplicated
+        if (filename.endsWith('.md')) {
+            return false;
+        }
+        // Also exclude the tooling config we add to new projects
+        const base = path.parse(filename).base;
+        if (base === '.prettierrc.json' || base === 'eslint.config.js') {
+            return false;
+        }
+        return true;
+    })
         .reduce((acc, filename) => {
         return {
             ...acc,
@@ -183,12 +193,13 @@ export async function updateHsMetaFilesWithAutoGeneratedFields(projectName, hsMe
                 return component.uid;
             };
             let uid = getBaseUid();
-            let differentiator = 1;
+            let differentiator = 2;
             while (existingUids.includes(uid)) {
-                differentiator++;
                 uid = `${getBaseUid()}_${differentiator}`;
+                differentiator++;
             }
             component.uid = uid;
+            existingUids.push(uid);
             if (component.type === AppKey && component.config) {
                 component.config.name = `${projectName}-App`;
             }

package/lib/projects/create/index.js

@@ -1,17 +1,15 @@
 import { selectProjectTemplatePrompt, } from '../../prompts/selectProjectTemplatePrompt.js';
 import { projectNameAndDestPrompt } from '../../prompts/projectNameAndDestPrompt.js';
 import { DEFAULT_PROJECT_TEMPLATE_BRANCH, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, EMPTY_PROJECT, } from '../../constants.js';
-import { isV2Project } from '../platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { v2ComponentFlow } from './v2.js';
 import { getProjectTemplateListFromRepo } from './legacy.js';
-import { uiLogger } from '../../ui/logger.js';
 import { commands } from '../../../lang/en.js';
-import { EXIT_CODES } from '../../enums/exitCodes.js';
 export async function handleProjectCreationFlow(args) {
     const { platformVersion, templateSource, projectBase, auth: providedAuth, distribution: providedDistribution, } = args;
     const repo = templateSource || HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
     const projectNameAndDestPromptResponse = await projectNameAndDestPrompt(args);
-    if (isV2Project(platformVersion)) {
+    if (!isLegacyProject(platformVersion)) {
         const { componentTemplateChoices, authType, distribution, repoConfig, projectContents, } = await v2ComponentFlow(platformVersion, projectBase, providedAuth, providedDistribution, args.derivedAccountId);
         const selectProjectTemplatePromptResponse = await selectProjectTemplatePrompt(args, undefined, projectContents !== EMPTY_PROJECT ? componentTemplateChoices : undefined);
         return {
@@ -25,8 +23,7 @@ export async function handleProjectCreationFlow(args) {
     }
     const projectTemplates = await getProjectTemplateListFromRepo(repo, DEFAULT_PROJECT_TEMPLATE_BRANCH);
     if (!projectTemplates.length) {
-        uiLogger.error(commands.project.create.errors.failedToFetchProjectList);
-        process.exit(EXIT_CODES.ERROR);
+        throw new Error(commands.project.create.errors.failedToFetchProjectList);
     }
     const selectProjectTemplatePromptResponse = await selectProjectTemplatePrompt(args, projectTemplates);
     return {

package/lib/projects/create/legacy.js

@@ -1,15 +1,13 @@
 import { fetchRepoFile } from '@hubspot/local-dev-lib/api/github';
 import { DEFAULT_PROJECT_TEMPLATE_BRANCH, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, PROJECT_COMPONENT_TYPES, } from '../../constants.js';
-import { EXIT_CODES } from '../../enums/exitCodes.js';
 import { debugError } from '../../errorHandlers/index.js';
-import { uiLogger } from '../../ui/logger.js';
-import { isV2Project } from '../platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { lib } from '../../../lang/en.js';
 const PROJECT_TEMPLATE_PROPERTIES = ['name', 'label', 'path'];
 export const EMPTY_PROJECT_TEMPLATE_NAME = 'no-template';
 export async function getConfigForPlatformVersion(platformVersion) {
     let path = '';
-    if (isV2Project(platformVersion)) {
+    if (!isLegacyProject(platformVersion)) {
         path = `${platformVersion}/`;
     }
     const { data } = await fetchRepoFile(HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, `${path}config.json`, DEFAULT_PROJECT_TEMPLATE_BRANCH);
@@ -36,18 +34,15 @@ export async function getProjectTemplateListFromRepo(templateSource, githubRef)
     }
     catch (e) {
         debugError(e);
-        uiLogger.error(lib.projects.create.errors.missingConfigFileTemplateSource);
-        return process.exit(EXIT_CODES.ERROR);
+        throw new Error(lib.projects.create.errors.missingConfigFileTemplateSource);
     }
     if (!config || !config[PROJECT_COMPONENT_TYPES.PROJECTS]) {
-        uiLogger.error(lib.projects.create.errors.noProjectsInConfig);
-        return process.exit(EXIT_CODES.ERROR);
+        throw new Error(lib.projects.create.errors.noProjectsInConfig);
     }
     const templates = config[PROJECT_COMPONENT_TYPES.PROJECTS];
     const templatesContainAllProperties = templates.every(config => PROJECT_TEMPLATE_PROPERTIES.every(p => Object.prototype.hasOwnProperty.call(config, p)));
     if (!templatesContainAllProperties) {
-        uiLogger.error(lib.projects.create.errors.missingPropertiesInConfig);
-        return process.exit(EXIT_CODES.ERROR);
+        throw new Error(lib.projects.create.errors.missingPropertiesInConfig);
     }
     return templates;
 }

package/lib/projects/create/v2.js

@@ -1,12 +1,10 @@
 import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, EMPTY_PROJECT, PROJECT_WITH_APP, FEATURES, } from '../../constants.js';
 import { commands, lib } from '../../../lang/en.js';
 import { listPrompt } from '../../prompts/promptUtils.js';
-import { APP_EVENTS_KEY as AppEventsKey, PAGES_KEY as PagesKey, } from '@hubspot/project-parsing-lib/constants';
-import { isV2Project } from '../platformVersion.js';
+import { APP_EVENTS_KEY as AppEventsKey } from '@hubspot/project-parsing-lib/constants';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import path from 'path';
 import { getConfigForPlatformVersion } from './legacy.js';
-import { logError } from '../../errorHandlers/index.js';
-import { EXIT_CODES } from '../../enums/exitCodes.js';
 import { hasFeature } from '../../hasFeature.js';
 export async function createV2App(providedAuth, providedDistribution) {
     let authType;
@@ -49,7 +47,6 @@ export async function createV2App(providedAuth, providedDistribution) {
 }
 const componentTypeToGateMap = {
     [AppEventsKey]: FEATURES.APP_EVENTS,
-    [PagesKey]: FEATURES.APPS_HOME,
     'workflow-action-tool': FEATURES.AGENT_TOOLS,
 };
 export async function calculateComponentTemplateChoices(components, authType, distribution, accountId, projectMetadata) {
@@ -111,21 +108,15 @@ export async function v2ComponentFlow(platformVersion, projectBase, providedAuth
     let repoConfig = undefined;
     let authType;
     let distribution;
-    try {
-        repoConfig = await getConfigForPlatformVersion(platformVersion);
-    }
-    catch (error) {
-        logError(error);
-        return process.exit(EXIT_CODES.SUCCESS);
-    }
+    repoConfig = await getConfigForPlatformVersion(platformVersion);
     const projectContentsChoice = projectBase ||
         (await listPrompt(commands.project.create.prompts.parentComponents, {
             choices: [
+                { name: commands.project.create.prompts.app, value: PROJECT_WITH_APP },
                 {
                     name: commands.project.create.prompts.emptyProject,
                     value: EMPTY_PROJECT,
                 },
-                { name: commands.project.create.prompts.app, value: PROJECT_WITH_APP },
             ],
         }));
     if (projectContentsChoice === PROJECT_WITH_APP) {
@@ -143,7 +134,7 @@ export async function v2ComponentFlow(platformVersion, projectBase, providedAuth
     };
 }
 export function generateComponentPaths({ selectProjectTemplatePromptResponse, platformVersion, repoConfig, projectContents, authType, distribution, }) {
-    if (!isV2Project(platformVersion)) {
+    if (isLegacyProject(platformVersion)) {
         return [];
     }
     const components = selectProjectTemplatePromptResponse.componentTemplates?.map((componentTemplate) => {

package/lib/projects/delete.d.ts

@@ -0,0 +1,13 @@
+export declare const DELETION_POLL_TIMEOUT_MS: number;
+export declare const DELETION_DEPLOY_SUCCESS_STATES: string[];
+export declare const DELETION_DEPLOY_ERROR_STATES: ("FAILURE" | "ERROR" | "REVERTED")[];
+export declare function resolveProjectName(accountId: number, projectArg: string | undefined): Promise<string>;
+export declare function fetchProjectInstallCount(accountId: number, projectId: number): Promise<number>;
+export declare function checkDeployedComponents(accountId: number, projectName: string): Promise<{
+    platformVersion: string;
+    hasUnifiedComponents: boolean;
+    projectId: number;
+}>;
+export declare function deleteDeployedComponents(accountId: number, projectName: string): Promise<void>;
+export declare function handleProjectDeletion(accountId: number, projectName: string): Promise<void>;
+export declare function confirmDeletion(projectName: string, accountId: number, projectId: number): Promise<void>;

package/lib/projects/delete.js

@@ -0,0 +1,193 @@
+import { fetchProjects, fetchProject, stageProjectForDeletion, getDeployStatus, deleteProject, } from '@hubspot/local-dev-lib/api/projects';
+import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
+import { debugError, getErrorMessage } from '../errorHandlers/index.js';
+import { uiLogger } from '../ui/logger.js';
+import SpinniesManager from '../ui/SpinniesManager.js';
+import { commands } from '../../lang/en.js';
+import { confirmPrompt, listPrompt } from '../prompts/promptUtils.js';
+import { poll, DEFAULT_POLLING_STATES, DEFAULT_POLLING_STATUS_LOOKUP, } from '../polling.js';
+import { PromptExitError } from '../errors/PromptExitError.js';
+import { EXIT_CODES } from '../enums/exitCodes.js';
+import { AUTO_GENERATED_COMPONENT_TYPES } from '@hubspot/project-parsing-lib/constants';
+import { mapToUserFacingType } from '@hubspot/project-parsing-lib/transform';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
+import { COMPONENT_TYPES, SUBCOMPONENT_TYPES, } from '@hubspot/local-dev-lib/enums/build';
+export const DELETION_POLL_TIMEOUT_MS = 5 * 60 * 1000;
+export const DELETION_DEPLOY_SUCCESS_STATES = [
+    DEFAULT_POLLING_STATES.SUCCESS,
+    'FINISHED',
+];
+export const DELETION_DEPLOY_ERROR_STATES = DEFAULT_POLLING_STATUS_LOOKUP.errorStates;
+const LEGACY_COMPONENTS_TO_FILTER = [
+    SUBCOMPONENT_TYPES.SERVERLESS_PKG,
+    SUBCOMPONENT_TYPES.REACT_EXTENSION,
+    SUBCOMPONENT_TYPES.PACKAGE_LOCK_FILE,
+    COMPONENT_TYPES.PRIVATE_APP,
+    COMPONENT_TYPES.PUBLIC_APP,
+];
+const legacyComponentFriendlyNames = {
+    [SUBCOMPONENT_TYPES.APP_ID]: 'Private App',
+    [SUBCOMPONENT_TYPES.PUBLIC_APP_ID]: 'Public App',
+    [SUBCOMPONENT_TYPES.CRM_CARD_V2]: 'Card',
+    [SUBCOMPONENT_TYPES.CARD_V2]: 'Card',
+    [SUBCOMPONENT_TYPES.SERVERLESS_FUNCTION]: 'Serverless Function',
+    [SUBCOMPONENT_TYPES.APP_FUNCTION]: 'App Function',
+    [SUBCOMPONENT_TYPES.AUTOMATION_ACTION]: 'Automation Action',
+    [SUBCOMPONENT_TYPES.WEBHOOKS]: 'Webhooks',
+    [COMPONENT_TYPES.THEME]: 'Theme',
+    [COMPONENT_TYPES.REACT_THEME]: 'React Theme',
+};
+function mapLegacyComponentToUserFriendlyName(type) {
+    return legacyComponentFriendlyNames[type] || 'unknown';
+}
+export async function resolveProjectName(accountId, projectArg) {
+    const { data } = await fetchProjects(accountId);
+    const projects = data.results;
+    if (projectArg) {
+        if (!projects.some(p => p.name === projectArg)) {
+            throw new Error(commands.project.delete.errors.projectNotFound(projectArg, accountId));
+        }
+        return projectArg;
+    }
+    if (projects.length === 0) {
+        throw new Error(commands.project.delete.errors.noProjectsFound(accountId));
+    }
+    const selected = await listPrompt(commands.project.delete.prompts.selectProject(accountId), {
+        choices: projects.map(p => ({ name: p.name, value: p.name })),
+        validate: value => !!value || commands.project.delete.prompts.validation.projectRequired,
+    });
+    if (!selected) {
+        throw new Error(commands.project.delete.prompts.validation.projectRequired);
+    }
+    return selected;
+}
+export async function fetchProjectInstallCount(accountId, projectId) {
+    try {
+        const { data } = await fetchPublicAppsForPortal(accountId);
+        return data.results
+            .filter(app => app.projectId === projectId)
+            .reduce((sum, app) => sum + app.publicApplicationInstallCounts.uniquePortalInstallCount, 0);
+    }
+    catch (e) {
+        debugError(e);
+        uiLogger.warn(commands.project.delete.logs.installCountUnknown);
+        return 0;
+    }
+}
+export async function checkDeployedComponents(accountId, projectName) {
+    const { data: projectData } = await fetchProject(accountId, projectName);
+    const platformVersion = projectData.deployedBuild?.platformVersion ||
+        projectData.latestBuild?.platformVersion;
+    if (!platformVersion) {
+        throw new Error(commands.project.delete.errors.noPlatformVersion);
+    }
+    if (isLegacyProject(platformVersion)) {
+        const userVisibleComponents = [];
+        projectData.deployedBuild?.subbuildStatuses?.forEach(item => {
+            if (LEGACY_COMPONENTS_TO_FILTER.includes(item.buildType)) {
+                return;
+            }
+            userVisibleComponents.push(`${item.buildName} - (${mapLegacyComponentToUserFriendlyName(item.buildType)})`);
+        });
+        if (userVisibleComponents.length > 0) {
+            uiLogger.log(commands.project.delete.logs.componentsToDeleteLegacy(userVisibleComponents));
+        }
+        return {
+            platformVersion,
+            hasUnifiedComponents: false,
+            projectId: projectData.id,
+        };
+    }
+    try {
+        const { data } = await stageProjectForDeletion(accountId, projectName, true);
+        if (data.hasDeployedComponents) {
+            const userVisibleComponents = data.componentsToRemove.filter(item => !AUTO_GENERATED_COMPONENT_TYPES.includes(mapToUserFacingType(item.componentType)));
+            uiLogger.log(commands.project.delete.logs.componentsToDeleteUnified(userVisibleComponents));
+        }
+        return {
+            hasUnifiedComponents: data.hasDeployedComponents,
+            platformVersion,
+            projectId: projectData.id,
+        };
+    }
+    catch (e) {
+        debugError(e);
+        throw new Error(commands.project.delete.errors.cannotDelete(projectName, getErrorMessage(e)));
+    }
+}
+export async function deleteDeployedComponents(accountId, projectName) {
+    SpinniesManager.add('removeComponents', {
+        text: commands.project.delete.logs.deletingComponents(projectName),
+    });
+    let projectDeletionResponse;
+    try {
+        const { data } = await stageProjectForDeletion(accountId, projectName, false);
+        projectDeletionResponse = data;
+    }
+    catch (e) {
+        debugError(e);
+        SpinniesManager.fail('removeComponents', {
+            text: commands.project.delete.errors.componentDeletionFailed(projectName),
+        });
+        throw new Error(commands.project.delete.errors.componentDeletionFailed(projectName));
+    }
+    const { deployId, hasDeployedComponents } = projectDeletionResponse;
+    if (deployId === undefined) {
+        if (hasDeployedComponents) {
+            SpinniesManager.fail('removeComponents', {
+                text: commands.project.delete.logs.unableToDetermineIfComponentsWereDeleted(projectName),
+            });
+            throw new Error(commands.project.delete.logs.unableToDetermineIfComponentsWereDeleted(projectName));
+        }
+        else {
+            SpinniesManager.succeed('removeComponents', {
+                text: commands.project.delete.logs.componentsDeleted(projectName),
+            });
+        }
+        return;
+    }
+    try {
+        await poll(() => getDeployStatus(accountId, projectName, deployId), {
+            successStates: DELETION_DEPLOY_SUCCESS_STATES,
+            errorStates: DELETION_DEPLOY_ERROR_STATES,
+        }, DELETION_POLL_TIMEOUT_MS);
+        SpinniesManager.succeed('removeComponents', {
+            text: commands.project.delete.logs.componentsDeleted(projectName),
+        });
+    }
+    catch (e) {
+        debugError(e);
+        SpinniesManager.fail('removeComponents', {
+            text: commands.project.delete.errors.componentDeletionFailed(projectName),
+        });
+        throw new Error(commands.project.delete.errors.componentDeletionFailed(projectName));
+    }
+}
+export async function handleProjectDeletion(accountId, projectName) {
+    try {
+        SpinniesManager.add('deleteProject', {
+            text: commands.project.delete.logs.deleting(projectName),
+        });
+        await deleteProject(accountId, projectName);
+        SpinniesManager.succeed('deleteProject', {
+            text: commands.project.delete.logs.deleted(projectName, accountId),
+        });
+    }
+    catch (e) {
+        SpinniesManager.fail('deleteProject', {
+            text: commands.project.delete.errors.deleteFailed(projectName),
+        });
+        throw e;
+    }
+}
+export async function confirmDeletion(projectName, accountId, projectId) {
+    const installCount = await fetchProjectInstallCount(accountId, projectId);
+    if (installCount > 0) {
+        uiLogger.warn(commands.project.delete.logs.installWarning(installCount));
+    }
+    const confirmed = await confirmPrompt(commands.project.delete.prompts.confirmDelete(projectName, accountId), { defaultAnswer: false });
+    if (!confirmed) {
+        uiLogger.log(commands.project.delete.logs.cancelled);
+        throw new PromptExitError(commands.project.delete.logs.cancelled, EXIT_CODES.SUCCESS);
+    }
+}

package/lib/projects/deploy.d.ts

@@ -10,4 +10,4 @@ export declare function logDeployErrors(errorData: {
         };
     }>;
 }): void;
-export declare function handleProjectDeploy(targetAccountId: number, projectName: string, buildId: number, isV2Project: boolean, force: boolean): Promise<Deploy | undefined>;
+export declare function handleProjectDeploy(targetAccountId: number, projectName: string, buildId: number, isLegacyProject: boolean, force: boolean): Promise<Deploy | undefined>;

package/lib/projects/deploy.js

@@ -47,9 +47,9 @@ function handleBlockedDeploy(deployResp) {
         uiLogger.log('');
     });
 }
-export async function handleProjectDeploy(targetAccountId, projectName, buildId, isV2Project, force) {
+export async function handleProjectDeploy(targetAccountId, projectName, buildId, isLegacyProject, force) {
     let deployId;
-    if (isV2Project) {
+    if (!isLegacyProject) {
         const { data: deployResp } = await deployProjectV2(targetAccountId, projectName, buildId, force);
         if (!deployResp || deployResp.buildResultType !== 'DEPLOY_QUEUED') {
             if (deployResp?.buildResultType === 'DEPLOY_BLOCKED') {

package/lib/projects/ensureProjectExists.js

@@ -2,7 +2,6 @@ import { createProject, fetchProject, } from '@hubspot/local-dev-lib/api/project
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
 import { DEFAULT_POLLING_DELAY } from '../constants.js';
 import { promptUser } from '../prompts/promptUtils.js';
-import { EXIT_CODES } from '../enums/exitCodes.js';
 import { uiAccountDescription } from '../ui/index.js';
 import SpinniesManager from '../ui/SpinniesManager.js';
 import { logError, ApiErrorContext } from '../errorHandlers/index.js';
@@ -85,6 +84,6 @@ export async function ensureProjectExists(accountId, projectName, { forceCreate
             }
         }
         logError(err, new ApiErrorContext({ accountId }));
-        process.exit(EXIT_CODES.ERROR);
+        return { projectExists: false };
     }
 }

package/lib/projects/localDev/AppDevModeInterface.js

@@ -6,6 +6,7 @@ import { EXIT_CODES } from '../../enums/exitCodes.js';
 import { isAppIRNode } from '../../projects/structure.js';
 import { uiLine } from '../../ui/index.js';
 import { logError } from '../../errorHandlers/index.js';
+import { isPromptExitError } from '../../errors/PromptExitError.js';
 import { installAppAutoPrompt, installAppBrowserPrompt, } from '../../prompts/installAppPrompt.js';
 import { confirmPrompt } from '../../prompts/promptUtils.js';
 import { lib } from '../../../lang/en.js';
@@ -27,7 +28,7 @@ class AppDevModeInterface {
             !this.localDevState.projectConfig ||
             !this.localDevState.projectDir) {
             uiLogger.error(lib.LocalDevManager.failedToInitialize);
-            process.exit(EXIT_CODES.ERROR);
+            throw new Error(lib.LocalDevManager.failedToInitialize);
         }
     }
     getAppNodeFromProjectNodes(projectNodes) {
@@ -45,12 +46,12 @@ class AppDevModeInterface {
         // App data will never be accessed before being set
         if (!this.appNode) {
             uiLogger.log(lib.AppDevModeInterface.appDataNotFound);
-            process.exit(EXIT_CODES.ERROR);
+            throw new Error(lib.AppDevModeInterface.appDataNotFound);
         }
         const data = this.localDevState.getAppDataByUid(this.appNode.uid);
         if (!data) {
             uiLogger.log(lib.AppDevModeInterface.appDataNotFound);
-            process.exit(EXIT_CODES.ERROR);
+            throw new Error(lib.AppDevModeInterface.appDataNotFound);
         }
         return data;
     }
@@ -107,7 +108,7 @@ class AppDevModeInterface {
                 text: lib.AppDevModeInterface.fetchAppData.error,
             });
             logError(e);
-            process.exit(EXIT_CODES.ERROR);
+            return this.localDevState.actions.exit(EXIT_CODES.ERROR);
         }
         if (!appData) {
             return;
@@ -135,7 +136,7 @@ class AppDevModeInterface {
         uiLine();
         const proceed = await confirmPrompt(lib.LocalDevManager.activeInstallWarning.confirmationPrompt, { defaultAnswer: false });
         if (!proceed) {
-            process.exit(EXIT_CODES.SUCCESS);
+            return this.localDevState.actions.exit(EXIT_CODES.SUCCESS);
         }
         this.localDevState.addUploadWarning(lib.AppDevModeInterface.defaultMarketplaceAppWarning(this.marketplaceAppInstalls));
     }
@@ -155,7 +156,7 @@ class AppDevModeInterface {
         const shouldInstall = await installAppAutoPrompt();
         if (!shouldInstall) {
             uiLogger.log(lib.AppDevModeInterface.autoInstallDeclined);
-            process.exit(EXIT_CODES.SUCCESS);
+            return this.localDevState.actions.exit(EXIT_CODES.SUCCESS);
         }
         uiLogger.log('');
         SpinniesManager.add('autoInstallStaticAuthApp', {
@@ -224,7 +225,7 @@ class AppDevModeInterface {
         if (!serverIsRunningAtRedirectUrl) {
             uiLogger.log('');
             uiLogger.error(lib.AppDevModeInterface.oauthAppRedirectUrlError(redirectUrl));
-            process.exit(EXIT_CODES.ERROR);
+            return this.localDevState.actions.exit(EXIT_CODES.ERROR);
         }
     }
     resolveAppInstallPromise() {
@@ -245,7 +246,7 @@ class AppDevModeInterface {
     }
     handleAppInstallFailureDevServerMessage() {
         uiLogger.error(lib.AppDevModeInterface.installationFailed);
-        process.exit(EXIT_CODES.ERROR);
+        this.localDevState.actions.exit(EXIT_CODES.ERROR);
     }
     onDevServerMessage = async (message) => {
         if (message === LOCAL_DEV_SERVER_MESSAGE_TYPES.WEBSOCKET_SERVER_CONNECTED) {
@@ -313,6 +314,9 @@ class AppDevModeInterface {
             }
         }
         catch (e) {
+            if (isPromptExitError(e)) {
+                throw e;
+            }
             if (SpinniesManager.pick('fetchAppData')) {
                 SpinniesManager.fail('fetchAppData', {
                     text: lib.AppDevModeInterface.fetchAppData.error,
@@ -320,7 +324,7 @@ class AppDevModeInterface {
                 });
             }
             logError(e);
-            process.exit(EXIT_CODES.ERROR);
+            return this.localDevState.actions.exit(EXIT_CODES.ERROR);
         }
     }
     async start() {

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

@@ -1,4 +1,5 @@
 import { ProjectConfig, ComponentTypes, Component } from '../../../types/Projects.js';
+import { ExitFunction } from '../../../types/Yargs.js';
 type DevServerInterface = {
     setup?: Function;
     start?: (options: object) => Promise<void>;
@@ -20,11 +21,13 @@ declare class DevServerManager_DEPRECATED {
         [key: string]: Component;
     }) => Promise<void>): Promise<void>;
     arrangeComponentsByType(components: Component[]): ComponentsByType;
-    setup({ components, onUploadRequired, accountId, setActiveApp, }: {
+    setup({ components, onUploadRequired, accountId, setActiveApp, exit, port, }: {
         components: Component[];
         onUploadRequired: () => void;
         accountId: number;
         setActiveApp: (appUid: string | undefined) => Promise<void>;
+        exit: ExitFunction;
+        port?: number;
     }): Promise<void>;
     start({ accountId, projectConfig, }: {
         accountId: number;

package/lib/projects/localDev/DevServerManager_DEPRECATED.js

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

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

@@ -1,14 +1,17 @@
 import LocalDevLogger from './LocalDevLogger.js';
+import { ExitFunction } from '../../../types/Yargs.js';
 type DevSessionManagerConstructorOptions = {
     targetTestingAccountId: number;
     localDevLogger?: LocalDevLogger;
+    exit: ExitFunction;
 };
 declare class DevSessionManager {
     localDevLogger?: LocalDevLogger;
     targetTestingAccountId: number;
-    protected _devSessionId: number | undefined;
-    private _heartbeatInterval;
-    private _heartbeatRetries;
+    protected devSessionId: number | undefined;
+    private heartbeatInterval;
+    private heartbeatRetries;
+    private exit;
     constructor(options: DevSessionManagerConstructorOptions);
     private validateSessionIdExists;
     registerSession(): Promise<boolean>;