@hubspot/cli 7.4.8 → 7.4.9-beta.1

package/lib/projects/localDev/AppDevModeInterface.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const localDevAuth_1 = require("@hubspot/local-dev-lib/api/localDevAuth");
+const appsDev_1 = require("@hubspot/local-dev-lib/api/appsDev");
+const ui_extensions_dev_server_1 = require("@hubspot/ui-extensions-dev-server");
+const portManager_1 = require("@hubspot/local-dev-lib/portManager");
+const constants_1 = require("../../constants");
+const exitCodes_1 = require("../../enums/exitCodes");
+const structure_1 = require("../../projects/structure");
+const ui_1 = require("../../ui");
+const index_1 = require("../../errorHandlers/index");
+const installPublicAppPrompt_1 = require("../../prompts/installPublicAppPrompt");
+const promptUtils_1 = require("../../prompts/promptUtils");
+const en_1 = require("../../../lang/en");
+const logger_1 = require("../../ui/logger");
+class AppDevModeInterface {
+    localDevState;
+    localDevLogger;
+    _appNode;
+    appData;
+    marketplaceAppInstalls;
+    constructor(options) {
+        this.localDevState = options.localDevState;
+        this.localDevLogger = options.localDevLogger;
+        if (!this.localDevState.targetProjectAccountId ||
+            !this.localDevState.projectConfig ||
+            !this.localDevState.projectDir) {
+            logger_1.uiLogger.log(en_1.lib.LocalDevManager.failedToInitialize);
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+    }
+    // Assumes only one app per project
+    get appNode() {
+        if (this._appNode === undefined) {
+            this._appNode =
+                Object.values(this.localDevState.projectNodes).find(structure_1.isAppIRNode) ||
+                    null;
+        }
+        return this._appNode;
+    }
+    async fetchAppData() {
+        const { data: { results: portalApps }, } = await (0, appsDev_1.fetchPublicAppsForPortal)(this.localDevState.targetProjectAccountId);
+        const appData = portalApps.find(({ sourceId }) => sourceId === this.appNode?.uid);
+        if (!appData) {
+            return;
+        }
+        const { data: { uniquePortalInstallCount }, } = await (0, appsDev_1.fetchPublicAppProductionInstallCounts)(appData.id, this.localDevState.targetProjectAccountId);
+        this.appData = appData;
+        this.marketplaceAppInstalls = uniquePortalInstallCount;
+    }
+    async checkMarketplaceAppInstalls() {
+        if (!this.appData || !this.marketplaceAppInstalls) {
+            return;
+        }
+        (0, ui_1.uiLine)();
+        logger_1.uiLogger.warn(en_1.lib.LocalDevManager.activeInstallWarning.installCount(this.appData.name, this.marketplaceAppInstalls));
+        logger_1.uiLogger.log(en_1.lib.LocalDevManager.activeInstallWarning.explanation);
+        (0, ui_1.uiLine)();
+        const proceed = await (0, promptUtils_1.confirmPrompt)(en_1.lib.LocalDevManager.activeInstallWarning.confirmationPrompt, { defaultAnswer: false });
+        if (!proceed) {
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        }
+        this.localDevLogger.addUploadWarning(en_1.lib.AppDevModeInterface.defaultMarketplaceAppWarning(this.marketplaceAppInstalls));
+    }
+    async checkTestAccountAppInstallation() {
+        if (!this.appNode || !this.appData) {
+            return;
+        }
+        const { data: { isInstalledWithScopeGroups, previouslyAuthorizedScopeGroups }, } = await (0, localDevAuth_1.fetchAppInstallationData)(this.localDevState.targetTestingAccountId, this.localDevState.projectId, this.appNode.uid, this.appNode.config.auth.requiredScopes, this.appNode.config.auth.optionalScopes);
+        const isReinstall = previouslyAuthorizedScopeGroups.length > 0;
+        if (!isInstalledWithScopeGroups) {
+            await (0, installPublicAppPrompt_1.installPublicAppPrompt)(this.localDevState.env, this.localDevState.targetTestingAccountId, this.appData.clientId, this.appNode.config.auth.requiredScopes, this.appNode.config.auth.redirectUrls, isReinstall);
+        }
+    }
+    // @ts-expect-error TODO: reconcile types between CLI and UIE Dev Server
+    // In the future, update UIE Dev Server to use LocalDevState
+    async setup(args) {
+        if (!this.appNode) {
+            return;
+        }
+        try {
+            await this.fetchAppData();
+            if (this.appNode.config.distribution === constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE) {
+                await this.checkMarketplaceAppInstalls();
+            }
+            await this.checkTestAccountAppInstallation();
+        }
+        catch (e) {
+            (0, index_1.logError)(e);
+        }
+        return ui_extensions_dev_server_1.DevModeUnifiedInterface.setup(args);
+    }
+    async start() {
+        if (!this.appNode) {
+            return;
+        }
+        return ui_extensions_dev_server_1.DevModeUnifiedInterface.start({
+            accountId: this.localDevState.targetTestingAccountId,
+            // @ts-expect-error TODO: reconcile types between CLI and UIE Dev Server
+            projectConfig: this.localDevState.projectConfig,
+            requestPorts: portManager_1.requestPorts,
+        });
+    }
+    async fileChange(filePath, event) {
+        if (!this.appNode) {
+            return;
+        }
+        return ui_extensions_dev_server_1.DevModeUnifiedInterface.fileChange(filePath, event);
+    }
+    async cleanup() {
+        if (!this.appNode) {
+            return;
+        }
+        return ui_extensions_dev_server_1.DevModeUnifiedInterface.cleanup();
+    }
+}
+exports.default = AppDevModeInterface;

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

@@ -1,33 +1,22 @@
-import { ProjectConfig } from '../../../types/Projects';
-import { IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types';
-type DevServerInterface = {
-    setup?: Function;
-    start?: (options: object) => Promise<void>;
-    fileChange?: (filePath: string, event: string) => Promise<void>;
-    cleanup?: () => Promise<void>;
+import LocalDevState from './LocalDevState';
+import LocalDevLogger from './LocalDevLogger';
+type DevServerManagerV2ConstructorOptions = {
+    localDevState: LocalDevState;
+    logger: LocalDevLogger;
 };
 declare class DevServerManagerV2 {
     private initialized;
     private started;
     private devServers;
-    constructor();
-    iterateDevServers(callback: (serverInterface: DevServerInterface) => Promise<void>): Promise<void>;
-    setup({ projectNodes, accountId, setActiveApp, }: {
-        projectNodes: {
-            [key: string]: IntermediateRepresentationNodeLocalDev;
-        };
-        accountId: number;
-        setActiveApp: (appUid: string | undefined) => Promise<void>;
-    }): Promise<void>;
-    start({ accountId, projectConfig, }: {
-        accountId: number;
-        projectConfig: ProjectConfig;
-    }): Promise<void>;
+    private localDevState;
+    constructor(options: DevServerManagerV2ConstructorOptions);
+    private iterateDevServers;
+    setup(): Promise<void>;
+    start(): Promise<void>;
     fileChange({ filePath, event, }: {
         filePath: string;
         event: string;
     }): Promise<void>;
     cleanup(): Promise<void>;
 }
-declare const Manager: DevServerManagerV2;
-export default Manager;
+export default DevServerManagerV2;

package/lib/projects/localDev/DevServerManagerV2.js

@@ -1,56 +1,61 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const logger_1 = require("@hubspot/local-dev-lib/logger");
 const promptUtils_1 = require("../../prompts/promptUtils");
-const ui_extensions_dev_server_1 = require("@hubspot/ui-extensions-dev-server");
 const portManager_1 = require("@hubspot/local-dev-lib/portManager");
 const urls_1 = require("@hubspot/local-dev-lib/urls");
 const config_1 = require("@hubspot/local-dev-lib/config");
+const AppDevModeInterface_1 = __importDefault(require("./AppDevModeInterface"));
 const en_1 = require("../../../lang/en");
 class DevServerManagerV2 {
     initialized;
     started;
     devServers;
-    constructor() {
+    localDevState;
+    constructor(options) {
         this.initialized = false;
         this.started = false;
-        this.devServers = [ui_extensions_dev_server_1.DevModeUnifiedInterface];
+        this.localDevState = options.localDevState;
+        const AppsDevServer = new AppDevModeInterface_1.default({
+            localDevState: options.localDevState,
+            localDevLogger: options.logger,
+        });
+        this.devServers = [AppsDevServer];
     }
     async iterateDevServers(callback) {
         await Promise.all(this.devServers.map(devServer => callback(devServer)));
     }
-    async setup({ projectNodes, accountId, setActiveApp, }) {
+    async setup() {
         let env;
-        const accountConfig = (0, config_1.getAccountConfig)(accountId);
+        const accountConfig = (0, config_1.getAccountConfig)(this.localDevState.targetTestingAccountId);
         if (accountConfig) {
             env = accountConfig.env;
         }
         await (0, portManager_1.startPortManagerServer)();
         await this.iterateDevServers(async (serverInterface) => {
             if (serverInterface.setup) {
+                // @TODO: In the future, update UIE Dev Server to use LocalDevState
                 await serverInterface.setup({
-                    components: projectNodes,
+                    components: this.localDevState.projectNodes,
                     promptUser: promptUtils_1.promptUser,
                     logger: logger_1.logger,
                     urls: {
                         api: (0, urls_1.getHubSpotApiOrigin)(env),
                         web: (0, urls_1.getHubSpotWebsiteOrigin)(env),
                     },
-                    setActiveApp,
                 });
             }
         });
         this.initialized = true;
     }
-    async start({ accountId, projectConfig, }) {
+    async start() {
         if (this.initialized) {
             await this.iterateDevServers(async (serverInterface) => {
                 if (serverInterface.start) {
-                    await serverInterface.start({
-                        accountId,
-                        projectConfig,
-                        requestPorts: portManager_1.requestPorts,
-                    });
+                    await serverInterface.start();
                 }
             });
         }
@@ -79,5 +84,4 @@ class DevServerManagerV2 {
         }
     }
 }
-const Manager = new DevServerManagerV2();
-exports.default = Manager;
+exports.default = DevServerManagerV2;

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

@@ -0,0 +1,30 @@
+import LocalDevState from './LocalDevState';
+declare class LocalDevLogger {
+    private state;
+    private mostRecentUploadWarning;
+    private uploadWarnings;
+    constructor(state: LocalDevState);
+    private logUploadInstructions;
+    private handleError;
+    getUploadCommand(): string;
+    uploadWarning(): void;
+    addUploadWarning(warning: string): void;
+    clearUploadWarnings(): void;
+    missingComponentsWarning(components: string[]): void;
+    fileChangeError(e: unknown): void;
+    devServerSetupError(e: unknown): void;
+    devServerStartError(e: unknown): void;
+    devServerCleanupError(e: unknown): void;
+    noDeployedBuild(): void;
+    resetSpinnies(): void;
+    startupMessage(): void;
+    cleanupStart(): void;
+    cleanupError(): void;
+    cleanupSuccess(): void;
+    uploadInitiated(): void;
+    projectConfigMismatch(): void;
+    uploadError(error: unknown): void;
+    uploadSuccess(): void;
+    monitorConsoleOutput(): void;
+}
+export default LocalDevLogger;

package/lib/projects/localDev/LocalDevLogger.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("@hubspot/local-dev-lib/config");
+const config_2 = require("@hubspot/local-dev-lib/config");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const logger_2 = require("../../ui/logger");
+const ui_1 = require("../../ui");
+const en_1 = require("../../../lang/en");
+const SpinniesManager_1 = __importDefault(require("../../ui/SpinniesManager"));
+const errorHandlers_1 = require("../../errorHandlers");
+class LocalDevLogger {
+    state;
+    mostRecentUploadWarning;
+    uploadWarnings;
+    constructor(state) {
+        this.state = state;
+        this.mostRecentUploadWarning = null;
+        this.uploadWarnings = new Set();
+    }
+    logUploadInstructions(warning) {
+        logger_2.uiLogger.log('');
+        logger_2.uiLogger.warn(warning);
+        logger_2.uiLogger.log('');
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.uploadWarning.instructionsHeader);
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.uploadWarning.stopDev);
+        if (this.state.isGithubLinked) {
+            logger_2.uiLogger.log(en_1.lib.LocalDevManager.uploadWarning.pushToGithub);
+        }
+        else {
+            logger_2.uiLogger.log(en_1.lib.LocalDevManager.uploadWarning.runUpload(this.getUploadCommand()));
+        }
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.uploadWarning.restartDev);
+    }
+    handleError(e, langFunction) {
+        if (this.state.debug) {
+            logger_1.logger.error(e);
+        }
+        logger_2.uiLogger.error(langFunction(e instanceof Error ? e.message : ''));
+    }
+    getUploadCommand() {
+        const currentDefaultAccount = (0, config_2.getConfigDefaultAccount)() || undefined;
+        return this.state.targetProjectAccountId !==
+            (0, config_1.getAccountId)(currentDefaultAccount)
+            ? (0, ui_1.uiCommandReference)(`hs project upload --account=${this.state.targetProjectAccountId}`)
+            : (0, ui_1.uiCommandReference)('hs project upload');
+    }
+    uploadWarning() {
+        // At the moment, there is only one additional warning. We may need to do this in a
+        // more robust way in the future
+        const additionalWarnings = Array.from(this.uploadWarnings).join('\n\n');
+        const warning = `${en_1.lib.LocalDevManager.uploadWarning.defaultWarning} ${additionalWarnings}`;
+        // Avoid logging the warning to the console if it is currently the most
+        // recently logged warning. We do not want to spam the console with the same message.
+        if (warning !== this.mostRecentUploadWarning) {
+            this.logUploadInstructions(warning);
+            this.mostRecentUploadWarning = warning;
+        }
+    }
+    addUploadWarning(warning) {
+        this.uploadWarnings.add(warning);
+    }
+    clearUploadWarnings() {
+        this.uploadWarnings.clear();
+    }
+    missingComponentsWarning(components) {
+        const warning = en_1.lib.LocalDevManager.uploadWarning.missingComponents(components.join(', '));
+        if (warning !== this.mostRecentUploadWarning) {
+            this.logUploadInstructions(warning);
+            this.mostRecentUploadWarning = warning;
+        }
+    }
+    fileChangeError(e) {
+        this.handleError(e, en_1.lib.LocalDevManager.devServer.fileChangeError);
+    }
+    devServerSetupError(e) {
+        this.handleError(e, en_1.lib.LocalDevManager.devServer.setupError);
+    }
+    devServerStartError(e) {
+        this.handleError(e, en_1.lib.LocalDevManager.devServer.startError);
+    }
+    devServerCleanupError(e) {
+        this.handleError(e, en_1.lib.LocalDevManager.devServer.cleanupError);
+    }
+    noDeployedBuild() {
+        logger_2.uiLogger.error(en_1.lib.LocalDevManager.noDeployedBuild(this.state.projectConfig.name, (0, ui_1.uiAccountDescription)(this.state.targetProjectAccountId), this.getUploadCommand()));
+        logger_2.uiLogger.log('');
+    }
+    resetSpinnies() {
+        SpinniesManager_1.default.stopAll();
+        SpinniesManager_1.default.init();
+    }
+    startupMessage() {
+        if (!this.state.debug) {
+            console.clear();
+        }
+        (0, ui_1.uiBetaTag)(en_1.lib.LocalDevManager.betaMessage);
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.learnMoreLocalDevServer);
+        logger_2.uiLogger.log('');
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.running(this.state.projectConfig.name, (0, ui_1.uiAccountDescription)(this.state.targetProjectAccountId)));
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.viewProjectLink(this.state.projectConfig.name, this.state.targetProjectAccountId));
+        logger_2.uiLogger.log('');
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.quitHelper);
+        (0, ui_1.uiLine)();
+        logger_2.uiLogger.log('');
+    }
+    cleanupStart() {
+        SpinniesManager_1.default.add('cleanupMessage', {
+            text: en_1.lib.LocalDevManager.exitingStart,
+        });
+    }
+    cleanupError() {
+        SpinniesManager_1.default.fail('cleanupMessage', {
+            text: en_1.lib.LocalDevManager.exitingFail,
+        });
+    }
+    cleanupSuccess() {
+        SpinniesManager_1.default.succeed('cleanupMessage', {
+            text: en_1.lib.LocalDevManager.exitingSucceed,
+        });
+    }
+    uploadInitiated() {
+        logger_2.uiLogger.log(en_1.lib.LocalDevProcess.uploadInitiated);
+    }
+    projectConfigMismatch() {
+        logger_2.uiLogger.log(en_1.lib.LocalDevProcess.projectConfigMismatch);
+    }
+    uploadError(error) {
+        logger_1.logger.log('');
+        (0, errorHandlers_1.logError)(error);
+        logger_2.uiLogger.log(en_1.lib.LocalDevProcess.uploadFailed);
+        logger_1.logger.log('');
+    }
+    uploadSuccess() {
+        logger_1.logger.log('');
+        logger_2.uiLogger.log(en_1.lib.LocalDevProcess.uploadSuccess);
+        (0, ui_1.uiLine)();
+        logger_1.logger.log('');
+    }
+    monitorConsoleOutput() {
+        const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        function customStdoutWrite(chunk, encoding, callback) {
+            // Reset the most recently logged warning
+            if (this.mostRecentUploadWarning) {
+                this.mostRecentUploadWarning = null;
+            }
+            if (typeof encoding === 'function') {
+                return originalStdoutWrite(chunk, callback);
+            }
+            return originalStdoutWrite(chunk, encoding, callback);
+        }
+        customStdoutWrite.bind(this);
+        process.stdout.write = customStdoutWrite;
+    }
+}
+exports.default = LocalDevLogger;

package/lib/projects/localDev/LocalDevManager.js

@@ -14,7 +14,6 @@ const constants_1 = require("../../constants");
 const SpinniesManager_1 = __importDefault(require("../../ui/SpinniesManager"));
 const DevServerManager_1 = __importDefault(require("./DevServerManager"));
 const exitCodes_1 = require("../../enums/exitCodes");
-const urls_1 = require("../../projects/urls");
 const helpers_1 = require("./helpers");
 const structure_1 = require("../../projects/structure");
 const Projects_1 = require("../../../types/Projects");
@@ -113,7 +112,7 @@ class LocalDevManager {
             return;
         }
         (0, ui_1.uiLine)();
-        logger_2.uiLogger.warn(en_1.lib.LocalDevManager.activeInstallWarning.installCount(this.activePublicAppData.name, this.publicAppActiveInstalls, this.publicAppActiveInstalls === 1 ? 'account' : 'accounts'));
+        logger_2.uiLogger.warn(en_1.lib.LocalDevManager.activeInstallWarning.installCount(this.activePublicAppData.name, this.publicAppActiveInstalls));
         logger_2.uiLogger.log(en_1.lib.LocalDevManager.activeInstallWarning.explanation);
         (0, ui_1.uiLine)();
         const proceed = await (0, promptUtils_1.confirmPrompt)(en_1.lib.LocalDevManager.activeInstallWarning.confirmationPrompt, { defaultAnswer: false });
@@ -141,7 +140,7 @@ class LocalDevManager {
         logger_2.uiLogger.log((0, ui_1.uiLink)(en_1.lib.LocalDevManager.learnMoreLocalDevServer, 'https://developers.hubspot.com/docs/platform/project-cli-commands#start-a-local-development-server'));
         logger_2.uiLogger.log('');
         logger_2.uiLogger.log(chalk_1.default.hex(ui_1.UI_COLORS.SORBET)(en_1.lib.LocalDevManager.running(this.projectConfig.name, (0, ui_1.uiAccountDescription)(this.targetAccountId))));
-        logger_2.uiLogger.log((0, ui_1.uiLink)(en_1.lib.LocalDevManager.viewProjectLink, (0, urls_1.getProjectDetailUrl)(this.projectConfig.name, this.targetProjectAccountId) || ''));
+        logger_2.uiLogger.log(en_1.lib.LocalDevManager.viewProjectLink(this.projectConfig.name, this.targetProjectAccountId));
         if (this.activeApp?.type === Projects_1.ComponentTypes.PublicApp) {
             logger_2.uiLogger.log((0, ui_1.uiLink)(en_1.lib.LocalDevManager.viewTestAccountLink, (0, helpers_1.getAccountHomeUrl)(this.targetAccountId)));
         }

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

@@ -0,0 +1,27 @@
+import { IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types';
+import LocalDevState from './LocalDevState';
+import LocalDevLogger from './LocalDevLogger';
+import { LocalDevStateConstructorOptions, LocalDevStateListener } from '../../../types/LocalDev';
+declare class LocalDevProcess {
+    private state;
+    private _logger;
+    private devServerManager;
+    constructor(options: LocalDevStateConstructorOptions);
+    get projectDir(): string;
+    get projectNodes(): {
+        [key: string]: IntermediateRepresentationNodeLocalDev;
+    };
+    get logger(): LocalDevLogger;
+    private setupDevServers;
+    private startDevServers;
+    private cleanupDevServers;
+    private compareLocalProjectToDeployed;
+    private projectConfigValidForUpload;
+    handleFileChange(filePath: string, event: string): void;
+    start(): Promise<void>;
+    stop(showProgress?: boolean): Promise<void>;
+    updateProjectNodes(): Promise<void>;
+    uploadProject(): Promise<void>;
+    addStateListener<K extends keyof LocalDevState>(key: K, listener: LocalDevStateListener<K>): void;
+}
+export default LocalDevProcess;

package/lib/projects/localDev/LocalDevProcess.js

@@ -0,0 +1,171 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const project_parsing_lib_1 = require("@hubspot/project-parsing-lib");
+const path_1 = __importDefault(require("path"));
+const LocalDevState_1 = __importDefault(require("./LocalDevState"));
+const LocalDevLogger_1 = __importDefault(require("./LocalDevLogger"));
+const DevServerManagerV2_1 = __importDefault(require("./DevServerManagerV2"));
+const exitCodes_1 = require("../../enums/exitCodes");
+const transform_1 = require("@hubspot/project-parsing-lib/src/lib/transform");
+const config_1 = require("../config");
+const upload_1 = require("../upload");
+const buildAndDeploy_1 = require("../buildAndDeploy");
+class LocalDevProcess {
+    state;
+    _logger;
+    devServerManager;
+    constructor(options) {
+        this.state = new LocalDevState_1.default(options);
+        this._logger = new LocalDevLogger_1.default(this.state);
+        this.devServerManager = new DevServerManagerV2_1.default({
+            localDevState: this.state,
+            logger: this._logger,
+        });
+    }
+    get projectDir() {
+        return this.state.projectDir;
+    }
+    get projectNodes() {
+        return this.state.projectNodes;
+    }
+    get logger() {
+        return this._logger;
+    }
+    async setupDevServers() {
+        try {
+            await this.devServerManager.setup();
+            return true;
+        }
+        catch (e) {
+            this.logger.devServerSetupError(e);
+            return false;
+        }
+    }
+    async startDevServers() {
+        try {
+            await this.devServerManager.start();
+        }
+        catch (e) {
+            this.logger.devServerStartError(e);
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+    }
+    async cleanupDevServers() {
+        try {
+            await this.devServerManager.cleanup();
+            return true;
+        }
+        catch (e) {
+            this.logger.devServerCleanupError(e);
+            return false;
+        }
+    }
+    compareLocalProjectToDeployed() {
+        const deployedComponentNames = this.state.deployedBuild.subbuildStatuses.map(subbuildStatus => subbuildStatus.buildName);
+        const missingProjectNodes = [];
+        Object.values(this.projectNodes).forEach(node => {
+            if (!deployedComponentNames.includes(node.uid)) {
+                const userFriendlyName = (0, transform_1.mapToUserFriendlyName)(node.componentType);
+                const label = userFriendlyName ? `[${userFriendlyName}] ` : '';
+                missingProjectNodes.push(`${label}${node.uid}`);
+            }
+        });
+        if (missingProjectNodes.length) {
+            this.logger.missingComponentsWarning(missingProjectNodes);
+        }
+    }
+    async projectConfigValidForUpload() {
+        const { projectConfig } = await (0, config_1.getProjectConfig)();
+        if (!projectConfig) {
+            return false;
+        }
+        Object.keys(projectConfig).forEach(key => {
+            const field = key;
+            if (projectConfig[field] !== this.state.projectConfig[field]) {
+                return false;
+            }
+        });
+        return true;
+    }
+    handleFileChange(filePath, event) {
+        try {
+            this.devServerManager.fileChange({ filePath, event });
+        }
+        catch (e) {
+            this.logger.fileChangeError(e);
+        }
+    }
+    async start() {
+        this.logger.resetSpinnies();
+        // Local dev currently relies on the existence of a deployed build in the target account
+        if (!this.state.deployedBuild) {
+            this.logger.noDeployedBuild();
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        }
+        const setupSucceeded = await this.setupDevServers();
+        if (!setupSucceeded) {
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        this.logger.startupMessage();
+        await this.startDevServers();
+        this.logger.monitorConsoleOutput();
+        // Verify that there are no mismatches between components in the local project
+        // and components in the deployed build of the project.
+        this.compareLocalProjectToDeployed();
+    }
+    async stop(showProgress = true) {
+        if (showProgress) {
+            this.logger.cleanupStart();
+        }
+        const cleanupSucceeded = await this.cleanupDevServers();
+        if (!cleanupSucceeded) {
+            if (showProgress) {
+                this.logger.cleanupError();
+            }
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        if (showProgress) {
+            this.logger.cleanupSuccess();
+        }
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+    }
+    async updateProjectNodes() {
+        const intermediateRepresentation = await (0, project_parsing_lib_1.translateForLocalDev)({
+            projectSourceDir: path_1.default.join(this.state.projectDir, this.state.projectConfig.srcDir),
+            platformVersion: this.state.projectConfig.platformVersion,
+            accountId: this.state.targetProjectAccountId,
+        });
+        this.state.projectNodes =
+            intermediateRepresentation.intermediateNodesIndexedByUid;
+    }
+    async uploadProject() {
+        this.logger.uploadInitiated();
+        const isUploadable = await this.projectConfigValidForUpload();
+        if (!isUploadable) {
+            this.logger.projectConfigMismatch();
+            return;
+        }
+        const { uploadError } = await (0, upload_1.handleProjectUpload)({
+            accountId: this.state.targetProjectAccountId,
+            projectConfig: this.state.projectConfig,
+            projectDir: this.state.projectDir,
+            callbackFunc: buildAndDeploy_1.pollProjectBuildAndDeploy,
+            sendIR: true,
+            skipValidation: true,
+        });
+        if (uploadError) {
+            this.logger.uploadError(uploadError);
+        }
+        else {
+            this.logger.uploadSuccess();
+            this.logger.clearUploadWarnings();
+        }
+    }
+    addStateListener(key, listener) {
+        this.state.addListener(key, listener);
+    }
+}
+exports.default = LocalDevProcess;