@hubspot/cli 7.1.1 → 7.2.0-beta.0

package/lib/LocalDevManagerV2.js

@@ -0,0 +1,382 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const chokidar_1 = __importDefault(require("chokidar"));
+const chalk_1 = __importDefault(require("chalk"));
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const localDevAuth_1 = require("@hubspot/local-dev-lib/api/localDevAuth");
+const appsDev_1 = require("@hubspot/local-dev-lib/api/appsDev");
+const config_1 = require("@hubspot/local-dev-lib/config");
+const constants_1 = require("./constants");
+const SpinniesManager_1 = __importDefault(require("./ui/SpinniesManager"));
+const DevServerManagerV2_1 = __importDefault(require("./DevServerManagerV2"));
+const exitCodes_1 = require("./enums/exitCodes");
+const urls_1 = require("./projects/urls");
+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 lang_1 = require("./lang");
+const process_1 = require("./process");
+const WATCH_EVENTS = {
+    add: 'add',
+    change: 'change',
+    unlink: 'unlink',
+    unlinkDir: 'unlinkDir',
+};
+const i18nKey = 'lib.LocalDevManager';
+class LocalDevManagerV2 {
+    targetProjectAccountId;
+    targetTestingAccountId;
+    projectConfig;
+    projectDir;
+    projectId;
+    debug;
+    deployedBuild;
+    isGithubLinked;
+    watcher;
+    uploadWarnings;
+    projectNodes;
+    activeApp;
+    activePublicAppData;
+    env;
+    publicAppActiveInstalls;
+    projectSourceDir;
+    mostRecentUploadWarning;
+    constructor(options) {
+        this.targetProjectAccountId = options.targetProjectAccountId;
+        this.targetTestingAccountId = options.targetTestingAccountId;
+        this.projectConfig = options.projectConfig;
+        this.projectDir = options.projectDir;
+        this.projectId = options.projectId;
+        this.debug = options.debug || false;
+        this.deployedBuild = options.deployedBuild;
+        this.isGithubLinked = options.isGithubLinked;
+        this.watcher = null;
+        this.uploadWarnings = {};
+        this.projectNodes = options.projectNodes;
+        this.activeApp = null;
+        this.activePublicAppData = null;
+        this.env = options.env;
+        this.publicAppActiveInstalls = null;
+        this.mostRecentUploadWarning = null;
+        this.projectSourceDir = path_1.default.join(this.projectDir, this.projectConfig.srcDir);
+        if (!this.targetProjectAccountId ||
+            !this.projectConfig ||
+            !this.projectDir) {
+            logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.failedToInitialize`));
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+    }
+    async setActiveApp(appUid) {
+        if (!appUid) {
+            logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.missingUid`, {
+                devCommand: (0, ui_1.uiCommandReference)('hs project dev'),
+            }));
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        const app = Object.values(this.projectNodes).find(component => component.uid === appUid) || null;
+        if (app && (0, structure_1.isAppIRNode)(app)) {
+            this.activeApp = app;
+            if (app.config.distribution === constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE) {
+                try {
+                    await this.setActivePublicAppData();
+                    await this.checkActivePublicAppInstalls();
+                    await this.checkPublicAppInstallation();
+                }
+                catch (e) {
+                    (0, index_1.logError)(e);
+                }
+            }
+        }
+        return;
+    }
+    async setActivePublicAppData() {
+        const { data: { results: portalPublicApps }, } = await (0, appsDev_1.fetchPublicAppsForPortal)(this.targetProjectAccountId);
+        const activePublicAppData = portalPublicApps.find(({ sourceId }) => sourceId === this.activeApp?.uid);
+        if (!activePublicAppData) {
+            return;
+        }
+        const { data: { uniquePortalInstallCount }, } = await (0, appsDev_1.fetchPublicAppProductionInstallCounts)(activePublicAppData.id, this.targetProjectAccountId);
+        this.activePublicAppData = activePublicAppData;
+        this.publicAppActiveInstalls = uniquePortalInstallCount;
+    }
+    async checkActivePublicAppInstalls() {
+        if (!this.activePublicAppData ||
+            !this.publicAppActiveInstalls ||
+            this.publicAppActiveInstalls < 1) {
+            return;
+        }
+        (0, ui_1.uiLine)();
+        logger_1.logger.warn((0, lang_1.i18n)(`${i18nKey}.activeInstallWarning.installCount`, {
+            appName: this.activePublicAppData.name,
+            installCount: this.publicAppActiveInstalls,
+            installText: this.publicAppActiveInstalls === 1 ? 'install' : 'installs',
+        }));
+        logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.activeInstallWarning.explanation`));
+        (0, ui_1.uiLine)();
+        const proceed = await (0, promptUtils_1.confirmPrompt)((0, lang_1.i18n)(`${i18nKey}.activeInstallWarning.confirmationPrompt`), { defaultAnswer: false });
+        if (!proceed) {
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        }
+    }
+    async start() {
+        SpinniesManager_1.default.stopAll();
+        SpinniesManager_1.default.init();
+        // Local dev currently relies on the existence of a deployed build in the target account
+        if (!this.deployedBuild) {
+            logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.noDeployedBuild`, {
+                projectName: this.projectConfig.name,
+                accountIdentifier: (0, ui_1.uiAccountDescription)(this.targetProjectAccountId),
+                uploadCommand: this.getUploadCommand(),
+            }));
+            logger_1.logger.log();
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        }
+        const setupSucceeded = await this.devServerSetup();
+        if (!setupSucceeded) {
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        else if (!this.debug) {
+            console.clear();
+        }
+        (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`${i18nKey}.betaMessage`));
+        logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`${i18nKey}.learnMoreLocalDevServer`), 'https://developers.hubspot.com/docs/platform/project-cli-commands#start-a-local-development-server'));
+        logger_1.logger.log();
+        logger_1.logger.log(chalk_1.default.hex(ui_1.UI_COLORS.SORBET)((0, lang_1.i18n)(`${i18nKey}.running`, {
+            accountIdentifier: (0, ui_1.uiAccountDescription)(this.targetProjectAccountId),
+            projectName: this.projectConfig.name,
+        })));
+        logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`${i18nKey}.viewProjectLink`), (0, urls_1.getProjectDetailUrl)(this.projectConfig.name, this.targetProjectAccountId) || ''));
+        logger_1.logger.log();
+        logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.quitHelper`));
+        (0, ui_1.uiLine)();
+        logger_1.logger.log();
+        await this.devServerStart();
+        // Initialize project file watcher to detect configuration file changes
+        this.startWatching();
+        this.updateKeypressListeners();
+        this.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) {
+            SpinniesManager_1.default.add('cleanupMessage', {
+                text: (0, lang_1.i18n)(`${i18nKey}.exitingStart`),
+            });
+        }
+        await this.stopWatching();
+        const cleanupSucceeded = await this.devServerCleanup();
+        if (!cleanupSucceeded) {
+            if (showProgress) {
+                SpinniesManager_1.default.fail('cleanupMessage', {
+                    text: (0, lang_1.i18n)(`${i18nKey}.exitingFail`),
+                });
+            }
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        if (showProgress) {
+            SpinniesManager_1.default.succeed('cleanupMessage', {
+                text: (0, lang_1.i18n)(`${i18nKey}.exitingSucceed`),
+            });
+        }
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+    }
+    async checkPublicAppInstallation() {
+        if (!this.activeApp || !this.activePublicAppData) {
+            return;
+        }
+        const { data: { isInstalledWithScopeGroups, previouslyAuthorizedScopeGroups }, } = await (0, localDevAuth_1.fetchAppInstallationData)(this.targetTestingAccountId, this.projectId, this.activeApp.uid, this.activeApp.config.auth.requiredScopes, this.activeApp.config.auth.optionalScopes);
+        const isReinstall = previouslyAuthorizedScopeGroups.length > 0;
+        if (!isInstalledWithScopeGroups) {
+            await (0, installPublicAppPrompt_1.installPublicAppPrompt)(this.env, this.targetTestingAccountId, this.activePublicAppData.clientId, this.activeApp.config.auth.requiredScopes, this.activeApp.config.auth.redirectUrls, isReinstall);
+        }
+    }
+    updateKeypressListeners() {
+        (0, process_1.handleKeypress)(async (key) => {
+            if ((key.ctrl && key.name === 'c') || key.name === 'q') {
+                this.stop();
+            }
+        });
+    }
+    getUploadCommand() {
+        const currentDefaultAccount = (0, config_1.getConfigDefaultAccount)() || undefined;
+        return this.targetProjectAccountId !== (0, config_1.getAccountId)(currentDefaultAccount)
+            ? (0, ui_1.uiCommandReference)(`hs project upload --account=${this.targetProjectAccountId}`)
+            : (0, ui_1.uiCommandReference)('hs project upload');
+    }
+    logUploadWarning(reason) {
+        let warning;
+        if (reason) {
+            warning = reason;
+        }
+        else {
+            warning =
+                this.publicAppActiveInstalls && this.publicAppActiveInstalls > 0
+                    ? (0, lang_1.i18n)(`${i18nKey}.uploadWarning.defaultPublicAppWarning`, {
+                        installCount: this.publicAppActiveInstalls,
+                        installText: this.publicAppActiveInstalls === 1 ? 'install' : 'installs',
+                    })
+                    : (0, lang_1.i18n)(`${i18nKey}.uploadWarning.defaultWarning`);
+        }
+        // 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 (!this.uploadWarnings[warning]) {
+            logger_1.logger.log();
+            logger_1.logger.warn((0, lang_1.i18n)(`${i18nKey}.uploadWarning.header`, { warning }));
+            logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.uploadWarning.stopDev`, {
+                command: (0, ui_1.uiCommandReference)('hs project dev'),
+            }));
+            if (this.isGithubLinked) {
+                logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.uploadWarning.pushToGithub`));
+            }
+            else {
+                logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.uploadWarning.runUpload`, {
+                    command: this.getUploadCommand(),
+                }));
+            }
+            logger_1.logger.log((0, lang_1.i18n)(`${i18nKey}.uploadWarning.restartDev`, {
+                command: (0, ui_1.uiCommandReference)('hs project dev'),
+            }));
+            this.mostRecentUploadWarning = warning;
+            this.uploadWarnings[warning] = true;
+        }
+    }
+    monitorConsoleOutput() {
+        const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        function customStdoutWrite(chunk, encoding, callback) {
+            // Reset the most recently logged warning
+            if (this.mostRecentUploadWarning &&
+                this.uploadWarnings[this.mostRecentUploadWarning]) {
+                delete this.uploadWarnings[this.mostRecentUploadWarning];
+            }
+            if (typeof encoding === 'function') {
+                return originalStdoutWrite(chunk, callback);
+            }
+            return originalStdoutWrite(chunk, encoding, callback);
+        }
+        customStdoutWrite.bind(this);
+        process.stdout.write = customStdoutWrite;
+    }
+    compareLocalProjectToDeployed() {
+        const deployedComponentNames = this.deployedBuild.subbuildStatuses.map(subbuildStatus => subbuildStatus.buildName);
+        const missingProjectNodes = [];
+        Object.values(this.projectNodes).forEach(node => {
+            if ((0, structure_1.isAppIRNode)(node) || (0, structure_1.isCardIRNode)(node)) {
+                if (!deployedComponentNames.includes(node.uid)) {
+                    missingProjectNodes.push(`${(0, lang_1.i18n)(`${i18nKey}.uploadWarning.appLabel`)} ${node.uid}`);
+                }
+            }
+        });
+        if (missingProjectNodes.length) {
+            this.logUploadWarning((0, lang_1.i18n)(`${i18nKey}.uploadWarning.missingComponents`, {
+                missingComponents: missingProjectNodes.join(', '),
+            }));
+        }
+    }
+    startWatching() {
+        this.watcher = chokidar_1.default.watch(this.projectDir, {
+            ignoreInitial: true,
+        });
+        const configPaths = Object.values(this.projectNodes)
+            .filter(structure_1.isAppIRNode)
+            .map(component => component.localDev.componentConfigPath);
+        const projectConfigPath = path_1.default.join(this.projectDir, constants_1.PROJECT_CONFIG_FILE);
+        configPaths.push(projectConfigPath);
+        this.watcher.on('add', filePath => {
+            this.handleWatchEvent(filePath, WATCH_EVENTS.add, configPaths);
+        });
+        this.watcher.on('change', filePath => {
+            this.handleWatchEvent(filePath, WATCH_EVENTS.change, configPaths);
+        });
+        this.watcher.on('unlink', filePath => {
+            this.handleWatchEvent(filePath, WATCH_EVENTS.unlink, configPaths);
+        });
+        this.watcher.on('unlinkDir', filePath => {
+            this.handleWatchEvent(filePath, WATCH_EVENTS.unlinkDir, configPaths);
+        });
+    }
+    async stopWatching() {
+        await this.watcher?.close();
+    }
+    handleWatchEvent(filePath, event, configPaths) {
+        if (configPaths.includes(filePath)) {
+            this.logUploadWarning();
+        }
+        else {
+            this.devServerFileChange(filePath, event);
+        }
+    }
+    async devServerSetup() {
+        try {
+            await DevServerManagerV2_1.default.setup({
+                projectNodes: this.projectNodes,
+                onUploadRequired: this.logUploadWarning.bind(this),
+                accountId: this.targetTestingAccountId,
+                setActiveApp: this.setActiveApp.bind(this),
+            });
+            return true;
+        }
+        catch (e) {
+            if (this.debug) {
+                logger_1.logger.error(e);
+            }
+            logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.devServer.setupError`, {
+                message: e instanceof Error ? e.message : '',
+            }));
+            return false;
+        }
+    }
+    async devServerStart() {
+        try {
+            await DevServerManagerV2_1.default.start({
+                accountId: this.targetTestingAccountId,
+                projectConfig: this.projectConfig,
+            });
+        }
+        catch (e) {
+            if (this.debug) {
+                logger_1.logger.error(e);
+            }
+            logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.devServer.startError`, {
+                message: e instanceof Error ? e.message : '',
+            }));
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+    }
+    devServerFileChange(filePath, event) {
+        try {
+            DevServerManagerV2_1.default.fileChange({ filePath, event });
+        }
+        catch (e) {
+            if (this.debug) {
+                logger_1.logger.error(e);
+            }
+            logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.devServer.fileChangeError`, {
+                message: e instanceof Error ? e.message : '',
+            }));
+        }
+    }
+    async devServerCleanup() {
+        try {
+            await DevServerManagerV2_1.default.cleanup();
+            return true;
+        }
+        catch (e) {
+            if (this.debug) {
+                logger_1.logger.error(e);
+            }
+            logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.devServer.cleanupError`, {
+                message: e instanceof Error ? e.message : '',
+            }));
+            return false;
+        }
+    }
+}
+exports.default = LocalDevManagerV2;

package/lib/buildAccount.d.ts

@@ -1,13 +1,12 @@
-import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
 import { Environment } from '@hubspot/local-dev-lib/types/Config';
 import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
 import { DeveloperTestAccount } from '@hubspot/local-dev-lib/types/developerTestAccounts';
 import { SandboxResponse } from '@hubspot/local-dev-lib/types/Sandbox';
+import { SandboxAccountType } from '../types/Sandboxes';
 export declare function saveAccountToConfig(accountId: number | undefined, accountName: string, env: Environment, personalAccessKey?: string, force?: boolean): Promise<string>;
 export declare function buildDeveloperTestAccount(testAccountName: string, parentAccountConfig: CLIAccount, env: Environment, portalLimit: number): Promise<DeveloperTestAccount>;
-type SandboxType = typeof HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX | typeof HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX;
 type SandboxAccount = SandboxResponse & {
     name: string;
 };
-export declare function buildSandbox(sandboxName: string, parentAccountConfig: CLIAccount, sandboxType: SandboxType, env: Environment, force?: boolean): Promise<SandboxAccount>;
+export declare function buildSandbox(sandboxName: string, parentAccountConfig: CLIAccount, sandboxType: SandboxAccountType, env: Environment, force?: boolean): Promise<SandboxAccount>;
 export {};

package/lib/constants.d.ts

@@ -3,9 +3,6 @@ export declare const DEFAULT_PROJECT_TEMPLATE_BRANCH: "main";
 export declare const FEEDBACK_INTERVAL: 10;
 export declare const HUBSPOT_FOLDER: "@hubspot";
 export declare const MARKETPLACE_FOLDER: "@marketplace";
-export declare const CONFIG_FLAGS: {
-    readonly USE_CUSTOM_OBJECT_HUBFILE: "useCustomObjectHubfile";
-};
 export declare const DEFAULT_POLLING_DELAY = 2000;
 export declare const PROJECT_CONFIG_FILE: "hsproject.json";
 export declare const PROJECT_BUILD_STATES: {
@@ -65,3 +62,15 @@ export declare const PLATFORM_VERSION_ERROR_TYPES: {
     readonly PLATFORM_VERSION_RETIRED: "PlatformVersionErrorType.PLATFORM_VERSION_RETIRED";
     readonly PLATFORM_VERSION_SPECIFIED_DOES_NOT_EXIST: "PlatformVersionErrorType.PLATFORM_VERSION_SPECIFIED_DOES_NOT_EXIST";
 };
+export declare const IR_COMPONENT_TYPES: {
+    readonly APPLICATION: "APPLICATION";
+    readonly CARD: "CARD";
+};
+export declare const APP_DISTRIBUTION_TYPES: {
+    readonly MARKETPLACE: "marketplace";
+    readonly PRIVATE: "private";
+};
+export declare const APP_AUTH_TYPES: {
+    readonly OAUTH: "oauth";
+    readonly STATIC: "static";
+};

package/lib/constants.js

@@ -1,14 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PLATFORM_VERSION_ERROR_TYPES = exports.PROJECT_COMPONENT_TYPES = exports.PROJECT_TASK_TYPES = exports.PROJECT_ERROR_TYPES = exports.PROJECT_DEPLOY_TEXT = exports.PROJECT_BUILD_TEXT = exports.PROJECT_DEPLOY_STATES = exports.PROJECT_BUILD_STATES = exports.PROJECT_CONFIG_FILE = exports.DEFAULT_POLLING_DELAY = exports.CONFIG_FLAGS = exports.MARKETPLACE_FOLDER = exports.HUBSPOT_FOLDER = exports.FEEDBACK_INTERVAL = exports.DEFAULT_PROJECT_TEMPLATE_BRANCH = exports.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH = void 0;
+exports.APP_AUTH_TYPES = exports.APP_DISTRIBUTION_TYPES = exports.IR_COMPONENT_TYPES = exports.PLATFORM_VERSION_ERROR_TYPES = exports.PROJECT_COMPONENT_TYPES = exports.PROJECT_TASK_TYPES = exports.PROJECT_ERROR_TYPES = exports.PROJECT_DEPLOY_TEXT = exports.PROJECT_BUILD_TEXT = exports.PROJECT_DEPLOY_STATES = exports.PROJECT_BUILD_STATES = exports.PROJECT_CONFIG_FILE = exports.DEFAULT_POLLING_DELAY = exports.MARKETPLACE_FOLDER = exports.HUBSPOT_FOLDER = exports.FEEDBACK_INTERVAL = exports.DEFAULT_PROJECT_TEMPLATE_BRANCH = exports.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH = void 0;
 exports.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH = 'HubSpot/hubspot-project-components';
 exports.DEFAULT_PROJECT_TEMPLATE_BRANCH = 'main';
 exports.FEEDBACK_INTERVAL = 10;
 exports.HUBSPOT_FOLDER = '@hubspot';
 exports.MARKETPLACE_FOLDER = '@marketplace';
-exports.CONFIG_FLAGS = {
-    USE_CUSTOM_OBJECT_HUBFILE: 'useCustomObjectHubfile',
-};
 exports.DEFAULT_POLLING_DELAY = 2000;
 exports.PROJECT_CONFIG_FILE = 'hsproject.json';
 exports.PROJECT_BUILD_STATES = {
@@ -60,3 +57,15 @@ exports.PLATFORM_VERSION_ERROR_TYPES = {
     PLATFORM_VERSION_RETIRED: 'PlatformVersionErrorType.PLATFORM_VERSION_RETIRED',
     PLATFORM_VERSION_SPECIFIED_DOES_NOT_EXIST: 'PlatformVersionErrorType.PLATFORM_VERSION_SPECIFIED_DOES_NOT_EXIST',
 };
+exports.IR_COMPONENT_TYPES = {
+    APPLICATION: 'APPLICATION',
+    CARD: 'CARD',
+};
+exports.APP_DISTRIBUTION_TYPES = {
+    MARKETPLACE: 'marketplace',
+    PRIVATE: 'private',
+};
+exports.APP_AUTH_TYPES = {
+    OAUTH: 'oauth',
+    STATIC: 'static',
+};

package/lib/customObject.d.ts

@@ -0,0 +1,3 @@
+import { SchemaDefinition, ObjectDefinition } from '@hubspot/local-dev-lib/types/Schemas';
+export declare function isSchemaDefinition(schema: unknown): schema is SchemaDefinition;
+export declare function isObjectDefinition(object: unknown): object is ObjectDefinition;

package/lib/customObject.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSchemaDefinition = isSchemaDefinition;
+exports.isObjectDefinition = isObjectDefinition;
+function isSchemaDefinition(schema) {
+    return (typeof schema === 'object' &&
+        schema !== null &&
+        'labels' in schema &&
+        'name' in schema &&
+        'properties' in schema &&
+        'requiredProperties' in schema);
+}
+function isObjectDefinition(object) {
+    return typeof object === 'object' && object !== null && 'inputs' in object;
+}

package/lib/doctor/DiagnosticInfoBuilder.d.ts

@@ -21,6 +21,9 @@ export interface DiagnosticInfo extends FilesInfo {
         npm: string | null;
     };
     config: string | null;
+    configSettings: {
+        [key: string]: unknown;
+    };
     project: {
         details?: Project;
         config?: ProjectConfig;
@@ -41,6 +44,9 @@ export interface DiagnosticInfo extends FilesInfo {
 }
 export declare class DiagnosticInfoBuilder {
     accountId: number | null;
+    readonly configSettings: {
+        [key: string]: unknown;
+    };
     readonly env?: Environment;
     readonly authType?: AuthType;
     readonly accountType?: AccountType;

package/lib/doctor/DiagnosticInfoBuilder.js

@@ -27,6 +27,7 @@ const configFiles = [
 ];
 class DiagnosticInfoBuilder {
     accountId;
+    configSettings;
     env;
     authType;
     accountType;
@@ -39,6 +40,9 @@ class DiagnosticInfoBuilder {
     constructor(processInfo) {
         this.accountId = (0, config_1.getAccountId)();
         const accountConfig = (0, config_2.getAccountConfig)(this.accountId);
+        this.configSettings = {
+            httpUseLocalhost: (0, config_1.isConfigFlagEnabled)('httpUseLocalhost'),
+        };
         this.env = accountConfig?.env;
         this.authType = accountConfig?.authType;
         this.accountType = accountConfig?.accountType;
@@ -60,6 +64,7 @@ class DiagnosticInfoBuilder {
             arch,
             path: mainModule?.path,
             config: (0, config_2.getConfigPath)(),
+            configSettings: this.configSettings,
             versions: {
                 [hubspotCli]: package_json_1.default.version,
                 node,

package/lib/doctor/Doctor.d.ts

@@ -10,6 +10,7 @@ export declare class Doctor {
     private performCliChecks;
     private performProjectChecks;
     private performCliConfigChecks;
+    private performCliConfigSettingsChecks;
     private checkIfAccessTokenValid;
     private checkIfNodeIsInstalled;
     private checkIfNpmIsInstalled;

package/lib/doctor/Doctor.js

@@ -51,6 +51,7 @@ class Doctor {
             ...this.performCliConfigChecks(),
             ...(this.projectConfig?.projectConfig ? this.performProjectChecks() : []),
         ]);
+        this.performCliConfigSettingsChecks();
         SpinniesManager_1.default.succeed('runningDiagnostics', {
             text: i18n(`${i18nKey}.diagnosticsComplete`),
             succeedColor: 'white',
@@ -87,6 +88,15 @@ class Doctor {
         }
         return [this.checkIfAccessTokenValid()];
     }
+    performCliConfigSettingsChecks() {
+        if (this.diagnosticInfo?.configSettings.httpUseLocalhost) {
+            this.diagnosis?.addCLIConfigSection({
+                type: 'warning',
+                message: i18n(`${i18nKey}.diagnosis.cliConfig.settings.httpUseLocalhost`),
+                secondaryMessaging: i18n(`${i18nKey}.diagnosis.cliConfig.settings.httpUseLocalhostSecondary`),
+            });
+        }
+    }
     async checkIfAccessTokenValid() {
         const localI18nKey = `${i18nKey}.accountChecks`;
         try {

package/lib/localDev.d.ts

@@ -3,15 +3,16 @@ import { Environment } from '@hubspot/local-dev-lib/types/Config';
 import { DeveloperTestAccount } from '@hubspot/local-dev-lib/types/developerTestAccounts';
 import { Project } from '@hubspot/local-dev-lib/types/Project';
 import { ProjectConfig } from '../types/Projects';
+import { ProjectDevTargetAccountPromptResponse } from '../types/Prompts';
 import { Build } from '@hubspot/local-dev-lib/types/Build';
 export declare function confirmDefaultAccountIsTarget(accountConfig: CLIAccount): Promise<void>;
 export declare function checkIfDefaultAccountIsSupported(accountConfig: CLIAccount, hasPublicApps: boolean): void;
 export declare function checkIfParentAccountIsAuthed(accountConfig: CLIAccount): void;
 export declare function checkIfAccountFlagIsSupported(accountConfig: CLIAccount, hasPublicApps: boolean): void;
-export declare function suggestRecommendedNestedAccount(accounts: CLIAccount[], accountConfig: CLIAccount, hasPublicApps: boolean): Promise<CLIAccount | DeveloperTestAccount>;
+export declare function suggestRecommendedNestedAccount(accounts: CLIAccount[], accountConfig: CLIAccount, hasPublicApps: boolean): Promise<ProjectDevTargetAccountPromptResponse>;
 export declare function createSandboxForLocalDev(accountId: number, accountConfig: CLIAccount, env: Environment): Promise<number>;
 export declare function createDeveloperTestAccountForLocalDev(accountId: number, accountConfig: CLIAccount, env: Environment): Promise<number>;
 export declare function useExistingDevTestAccount(env: Environment, account: DeveloperTestAccount): Promise<void>;
 export declare function createNewProjectForLocalDev(projectConfig: ProjectConfig, targetAccountId: number, shouldCreateWithoutConfirmation: boolean, hasPublicApps: boolean): Promise<Project>;
-export declare function createInitialBuildForNewProject(projectConfig: ProjectConfig, projectDir: string, targetAccountId: number): Promise<Build>;
+export declare function createInitialBuildForNewProject(projectConfig: ProjectConfig, projectDir: string, targetAccountId: number, sendIr?: boolean): Promise<Build>;
 export declare function getAccountHomeUrl(accountId: number): string;

package/lib/localDev.js

@@ -294,8 +294,8 @@ function projectUploadCallback(accountId, projectConfig, tempFile, buildId) {
 }
 // Create an initial build if the project was newly created in the account
 // Return the newly deployed build
-async function createInitialBuildForNewProject(projectConfig, projectDir, targetAccountId) {
-    const { result: initialUploadResult, uploadError } = await (0, upload_1.handleProjectUpload)(targetAccountId, projectConfig, projectDir, projectUploadCallback, (0, lang_1.i18n)(`${i18nKey}.createInitialBuildForNewProject.initialUploadMessage`));
+async function createInitialBuildForNewProject(projectConfig, projectDir, targetAccountId, sendIr) {
+    const { result: initialUploadResult, uploadError } = await (0, upload_1.handleProjectUpload)(targetAccountId, projectConfig, projectDir, projectUploadCallback, (0, lang_1.i18n)(`${i18nKey}.createInitialBuildForNewProject.initialUploadMessage`), sendIr);
     if (uploadError) {
         if ((0, index_1.isSpecifiedError)(uploadError, {
             subCategory: constants_1.PROJECT_ERROR_TYPES.PROJECT_LOCKED,

package/lib/marketplaceValidate.d.ts

@@ -1,6 +1,6 @@
 import { GetValidationResultsResponse } from '@hubspot/local-dev-lib/types/MarketplaceValidation';
 export declare function kickOffValidation(accountId: number, assetType: string, src: string): Promise<number>;
-export declare function pollForValidationFinish(accountId: number, validationId: string): Promise<void>;
-export declare function fetchValidationResults(accountId: number, validationId: string): Promise<GetValidationResultsResponse>;
+export declare function pollForValidationFinish(accountId: number, validationId: number): Promise<void>;
+export declare function fetchValidationResults(accountId: number, validationId: number): Promise<GetValidationResultsResponse>;
 export declare function processValidationErrors(i18nKey: string, validationResults: GetValidationResultsResponse): void;
 export declare function displayValidationResults(i18nKey: string, validationResults: GetValidationResultsResponse): void;

package/lib/process.d.ts

@@ -5,6 +5,7 @@ interface KeyPress {
     meta?: boolean;
     name?: string;
 }
+export declare const TERMINATION_SIGNALS: string[];
 export declare function handleExit(callback: (onTerminate: {
     isSIGHUP: boolean;
 }) => void): void;

package/lib/process.js

@@ -3,24 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TERMINATION_SIGNALS = void 0;
 exports.handleExit = handleExit;
 exports.handleKeypress = handleKeypress;
 const readline_1 = __importDefault(require("readline"));
 const logger_1 = require("@hubspot/local-dev-lib/logger");
 const lang_1 = require("./lang");
 const i18nKey = 'lib.process';
+exports.TERMINATION_SIGNALS = [
+    'beforeExit',
+    'SIGINT', // Terminal trying to interrupt (Ctrl + C)
+    'SIGUSR1', // Start Debugger User-defined signal 1
+    'SIGUSR2', // User-defined signal 2
+    'uncaughtException',
+    'SIGTERM', // Represents a graceful termination
+    'SIGHUP', // Parent terminal has been closed
+];
 function handleExit(callback) {
-    const terminationSignals = [
-        'beforeExit',
-        'SIGINT', // Terminal trying to interrupt (Ctrl + C)
-        'SIGUSR1', // Start Debugger User-defined signal 1
-        'SIGUSR2', // User-defined signal 2
-        'uncaughtException',
-        'SIGTERM', // Represents a graceful termination
-        'SIGHUP', // Parent terminal has been closed
-    ];
     let exitInProgress = false;
-    terminationSignals.forEach(signal => {
+    exports.TERMINATION_SIGNALS.forEach(signal => {
         process.removeAllListeners(signal);
         process.on(signal, async () => {
             // Prevent duplicate exit handling

package/lib/projects/buildAndDeploy.js

@@ -24,8 +24,11 @@ function useV3Api(platformVersion) {
     if (!platformVersion || typeof platformVersion !== 'string') {
         return false;
     }
+    if (platformVersion.toLowerCase() === 'unstable') {
+        return true;
+    }
     const [year, minor] = platformVersion.split('.');
-    return Number(year) >= 2025 && Number(minor) >= 1;
+    return Number(year) >= 2025 && Number(minor) >= 2;
 }
 function getSubtasks(task) {
     if ('subbuildStatuses' in task) {