@hubspot/cli 7.2.0-experimental.0 → 7.2.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/commonOpts.d.ts

@@ -13,6 +13,7 @@ export declare function addCmsPublishModeOptions(yargs: Argv, { read, write }: {
 }): Argv;
 export declare function addTestingOptions(yargs: Argv): Argv;
 export declare function addUseEnvironmentOptions(yargs: Argv): Argv;
+export declare function addCustomHelpOutput(yargs: Argv, command: string, describe: string): Promise<void>;
 export declare function setLogLevel(options: Arguments<{
     debug?: boolean;
 }>): void;

package/lib/commonOpts.js

@@ -1,4 +1,7 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addGlobalOptions = addGlobalOptions;
 exports.addAccountOptions = addAccountOptions;
@@ -7,13 +10,19 @@ exports.addOverwriteOptions = addOverwriteOptions;
 exports.addCmsPublishModeOptions = addCmsPublishModeOptions;
 exports.addTestingOptions = addTestingOptions;
 exports.addUseEnvironmentOptions = addUseEnvironmentOptions;
+exports.addCustomHelpOutput = addCustomHelpOutput;
 exports.setLogLevel = setLogLevel;
 exports.getCommandName = getCommandName;
 exports.getCmsPublishMode = getCmsPublishMode;
+const chalk_1 = __importDefault(require("chalk"));
+const yargs_parser_1 = __importDefault(require("yargs-parser"));
 const logger_1 = require("@hubspot/local-dev-lib/logger");
 const files_1 = require("@hubspot/local-dev-lib/constants/files");
 const config_1 = require("@hubspot/local-dev-lib/config");
 const lang_1 = require("./lang");
+const errorHandlers_1 = require("./errorHandlers");
+const exitCodes_1 = require("./enums/exitCodes");
+const ui_1 = require("./ui");
 const i18nKey = 'lib.commonOpts';
 function addGlobalOptions(yargs) {
     yargs.version(false);
@@ -70,6 +79,27 @@ function addUseEnvironmentOptions(yargs) {
     })
         .conflicts('use-env', 'account');
 }
+async function addCustomHelpOutput(yargs, command, describe) {
+    try {
+        const parsedArgv = (0, yargs_parser_1.default)(process.argv.slice(2));
+        if (parsedArgv && parsedArgv.help) {
+            // Construct the full command, including positional arguments
+            const commandBase = `hs ${parsedArgv._.slice(0, -1).join(' ')}`;
+            const fullCommand = `${commandBase.trim()} ${command}`;
+            // Format the original help output to be more readable
+            let commandHelp = await yargs.getHelp();
+            ['Options:', 'Examples:', 'Positionals:'].forEach(header => {
+                commandHelp = commandHelp.replace(header, chalk_1.default.bold(header));
+            });
+            logger_1.logger.log(`${(0, ui_1.uiCommandReference)(fullCommand, false)}\n\n${describe}\n\n${commandHelp}`);
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        }
+    }
+    catch (e) {
+        // Ignore error to allow yargs to show the default help output using the command description
+        (0, errorHandlers_1.debugError)(e);
+    }
+}
 function setLogLevel(options) {
     const { debug } = options;
     if (debug) {

package/lib/constants.d.ts

@@ -62,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,6 +1,6 @@
 "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.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;
@@ -57,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/localDev.d.ts

@@ -14,5 +14,5 @@ export declare function createSandboxForLocalDev(accountId: number, accountConfi
 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/projects/structure.d.ts

@@ -1,4 +1,6 @@
 import { ComponentTypes, Component, GenericComponentConfig, PublicAppComponentConfig, PrivateAppComponentConfig, AppCardComponentConfig } from '../../types/Projects';
+import { IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types';
+import { AppIRNode, CardIRNode } from '../../types/ProjectComponents';
 export declare const CONFIG_FILES: {
     [k in ComponentTypes]: string;
 };
@@ -13,3 +15,5 @@ export declare function getProjectComponentTypes(components: Array<Component>):
 export declare function getComponentUid(component?: Component | null): string | null;
 export declare function componentIsApp(component?: Component | null): component is Component<PublicAppComponentConfig | PrivateAppComponentConfig>;
 export declare function componentIsPublicApp(component?: Component | null): component is Component<PublicAppComponentConfig>;
+export declare function isAppIRNode(component: IntermediateRepresentationNodeLocalDev): component is AppIRNode;
+export declare function isCardIRNode(component: IntermediateRepresentationNodeLocalDev): component is CardIRNode;

package/lib/projects/structure.js

@@ -43,12 +43,15 @@ exports.getProjectComponentTypes = getProjectComponentTypes;
 exports.getComponentUid = getComponentUid;
 exports.componentIsApp = componentIsApp;
 exports.componentIsPublicApp = componentIsPublicApp;
+exports.isAppIRNode = isAppIRNode;
+exports.isCardIRNode = isCardIRNode;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const fs_1 = require("@hubspot/local-dev-lib/fs");
 const logger_1 = require("@hubspot/local-dev-lib/logger");
 const index_1 = require("../errorHandlers/index");
 const Projects_1 = require("../../types/Projects");
+const constants_1 = require("../constants");
 exports.CONFIG_FILES = {
     [Projects_1.ComponentTypes.PrivateApp]: 'app.json',
     [Projects_1.ComponentTypes.PublicApp]: 'public-app.json',
@@ -169,3 +172,9 @@ function componentIsApp(component) {
 function componentIsPublicApp(component) {
     return component?.type === Projects_1.ComponentTypes.PublicApp;
 }
+function isAppIRNode(component) {
+    return component.componentType === constants_1.IR_COMPONENT_TYPES.APPLICATION;
+}
+function isCardIRNode(component) {
+    return component.componentType === constants_1.IR_COMPONENT_TYPES.CARD;
+}

package/lib/prompts/accountNamePrompt.d.ts

@@ -1,12 +1,11 @@
 import { PromptConfig } from '../../types/Prompts';
 import { AccountType } from '@hubspot/local-dev-lib/types/Accounts';
-type AccountNamePromptResponse = {
+export type AccountNamePromptResponse = {
     name: string;
 };
 export declare function getCliAccountNamePromptConfig(defaultName?: string): PromptConfig<AccountNamePromptResponse>;
-export declare function cliAccountNamePrompt(defaultName: string): Promise<AccountNamePromptResponse>;
+export declare function cliAccountNamePrompt(defaultName?: string): Promise<AccountNamePromptResponse>;
 export declare function hubspotAccountNamePrompt({ accountType, currentPortalCount, }: {
     accountType: AccountType;
     currentPortalCount?: number;
 }): Promise<AccountNamePromptResponse>;
-export {};

package/lib/prompts/personalAccessKeyPrompt.d.ts

@@ -1,5 +1,6 @@
+import { AccountNamePromptResponse } from './accountNamePrompt';
 import { PromptConfig } from '../../types/Prompts';
-type PersonalAccessKeyPromptResponse = {
+export type PersonalAccessKeyPromptResponse = {
     personalAccessKey: string;
     env: string;
 };
@@ -15,6 +16,7 @@ type ClientSecretPromptResponse = {
 type ScopesPromptResponse = {
     scopes: string[];
 };
+export type OauthPromptResponse = AccountNamePromptResponse & AccountIdPromptResponse & ClientIdPromptResponse & ClientSecretPromptResponse & ScopesPromptResponse;
 /**
  * Displays notification to user that we are about to open the browser,
  * then opens their browser to the personal-access-key shortlink
@@ -23,7 +25,5 @@ export declare function personalAccessKeyPrompt({ env, account, }: {
     env: string;
     account?: number;
 }): Promise<PersonalAccessKeyPromptResponse>;
-export declare const OAUTH_FLOW: (PromptConfig<{
-    name: string;
-}> | PromptConfig<AccountIdPromptResponse> | PromptConfig<ClientIdPromptResponse> | PromptConfig<ClientSecretPromptResponse> | PromptConfig<ScopesPromptResponse>)[];
+export declare const OAUTH_FLOW: (PromptConfig<AccountNamePromptResponse> | PromptConfig<AccountIdPromptResponse> | PromptConfig<ClientIdPromptResponse> | PromptConfig<ClientSecretPromptResponse> | PromptConfig<ScopesPromptResponse>)[];
 export {};

package/lib/ui/index.d.ts

@@ -7,7 +7,7 @@ export declare function uiLine(): void;
 export declare function uiLink(linkText: string, url: string): string;
 export declare function uiAccountDescription(accountId?: number | null, bold?: boolean): string;
 export declare function uiInfoSection(title: string, logContent: () => void): void;
-export declare function uiCommandReference(command: string): string;
+export declare function uiCommandReference(command: string, withQuotes?: boolean): string;
 export declare function uiFeatureHighlight(commands: string[], title?: string): void;
 export declare function uiBetaTag(message: string, log?: boolean): string | undefined;
 export declare function uiDeprecatedTag(message: string): void;

package/lib/ui/index.js

@@ -70,9 +70,9 @@ function uiInfoSection(title, logContent) {
     logger_1.logger.log('');
     uiLine();
 }
-function uiCommandReference(command) {
+function uiCommandReference(command, withQuotes = true) {
     const terminalUISupport = getTerminalUISupport();
-    const commandReference = `\`${command}\``;
+    const commandReference = withQuotes ? `\`${command}\`` : command;
     return chalk_1.default.bold(terminalUISupport.color
         ? chalk_1.default.hex(exports.UI_COLORS.MARIGOLD_DARK)(commandReference)
         : commandReference);

package/lib/ui/supportHyperlinks.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.supportsHyperlinkModule = void 0;
-const hasFlag_1 = require("../hasFlag");
+const yargsUtils_1 = require("../yargsUtils");
 //See https://github.com/jamestalmage/supports-hyperlinks (License: https://github.com/jamestalmage/supports-hyperlinks/blob/master/license)
 function parseVersion(versionString) {
     if (/^\d{3,4}$/.test(versionString)) {
@@ -22,7 +22,7 @@ function parseVersion(versionString) {
 }
 function supportsHyperlink(stream) {
     const { env } = process;
-    if ((0, hasFlag_1.hasFlag)('noHyperlinks')) {
+    if ((0, yargsUtils_1.hasFlag)('noHyperlinks')) {
         return false;
     }
     if (stream && !stream.isTTY) {

package/lib/ui/supportsColor.js

@@ -7,7 +7,7 @@ exports.supportsColor = void 0;
 const process_1 = __importDefault(require("process"));
 const os_1 = __importDefault(require("os"));
 const tty_1 = __importDefault(require("tty"));
-const hasFlag_1 = require("../hasFlag");
+const yargsUtils_1 = require("../yargsUtils");
 const { env } = process_1.default;
 function translateLevel(level) {
     if (level === 0) {
@@ -33,7 +33,7 @@ function _supportsColor(haveStream, { streamIsTTY } = {}) {
     if (env.TERM === 'dumb') {
         return min;
     }
-    if ((0, hasFlag_1.hasFlag)('noColor')) {
+    if ((0, yargsUtils_1.hasFlag)('noColor')) {
         return 0;
     }
     if (process_1.default.platform === 'win32') {

package/lib/usageTracking.d.ts

@@ -16,6 +16,6 @@ type Meta = {
 export declare function trackCommandUsage(command: string, meta?: Meta, accountId?: number): Promise<void>;
 export declare function trackHelpUsage(command: string): Promise<void>;
 export declare function trackConvertFieldsUsage(command: string): Promise<void>;
-export declare function trackAuthAction(command: string, authType: string, step: string, accountId: number): Promise<void>;
+export declare function trackAuthAction(command: string, authType: string, step: string, accountId?: number): Promise<void>;
 export declare function trackCommandMetadataUsage(command: string, meta?: Meta, accountId?: number): Promise<void>;
 export {};