@hubspot/cli 8.2.1-experimental.0 → 8.2.1-experimental.1

package/lang/en.d.ts

@@ -1466,7 +1466,6 @@ export declare const commands: {
                     duplicateTargetAccount: (targetAccountId: number) => string;
                 };
                 errors: {
-                    noProjectConfig: string;
                     unsupportedPlatformVersion: string;
                     profileExists: (profileName: string) => string;
                     invalidTargetAccount: string;
@@ -1499,7 +1498,6 @@ export declare const commands: {
                     deleteProjectPrompt: (accountId: number) => string;
                 };
                 errors: {
-                    noProjectConfig: string;
                     unsupportedPlatformVersion: string;
                     noProfileFound: (profileName: string) => string;
                     noProfilesFound: string;
@@ -1523,12 +1521,12 @@ export declare const commands: {
                 testingAccountFlagExplanation: (accountId: number) => string;
             };
             errors: {
-                noProjectConfig: string;
                 noAccount: (accountId: number) => string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 noRunnableComponents: string;
                 accountNotCombined: string;
                 localDevAlreadyRunning: string;
+                autoUploadRequiresAutoDeploy: string;
             };
             examples: {
                 default: string;
@@ -1541,6 +1539,7 @@ export declare const commands: {
                 projectAccount: string;
                 testingAccount: string;
                 port: string;
+                autoUpload: string;
             };
         };
         create: {
@@ -1842,6 +1841,8 @@ export declare const commands: {
             };
             examples: {
                 default: string;
+                withLimit: string;
+                json: string;
             };
         };
         logs: {
@@ -1908,9 +1909,11 @@ export declare const commands: {
                 autoDeployDisabled: (deployCommand: string) => string;
                 autoDeploySkipped: (deployCommand: string) => string;
                 releaseManagementRequired: (releaseCommand: string) => string;
+                uploadingWithProfile: (profileName: string, accountId: number) => string;
+                uploadingToAccount: (accountId: number) => string;
+                uploadedToAccount: (accountId: number) => string;
             };
             errors: {
-                noProjectConfig: string;
                 projectLockedError: string;
                 previewRequiresTarget: string;
                 targetRequiresPreview: string;
@@ -1972,7 +1975,6 @@ export declare const commands: {
                 fileAlreadyQueued: (filePath: string) => string;
             };
             errors: {
-                projectConfigNotFound: string;
                 projectLockedError: string;
                 uploadFailed: (remotePath: string, filePath: string) => string;
                 deleteFileFailed: (remotePath: string) => string;
@@ -2039,7 +2041,6 @@ export declare const commands: {
             installationSuccessful: (directory: string) => string;
             addingDependenciesToLocation: (dependencies: string, directory: string) => string;
             installingDependenciesFailed: (directory: string) => string;
-            noProjectConfig: string;
             noPackageJsonInProject: (projectName: string) => string;
             packageManagerNotInstalled: (packageManager: string) => string;
         };
@@ -2057,7 +2058,6 @@ export declare const commands: {
                 addingLintScripts: string;
                 linting: string;
             };
-            noProjectConfig: string;
             failedToReadPackageJson: (packageJsonPath: string) => string;
             installLintPackagesPrompt: (directories: string[], missingPackages: string[]) => string;
             skippingDirectoriesWarning: (directories: string[]) => string;
@@ -2087,7 +2087,6 @@ export declare const commands: {
             updateSuccessful: (directory: string) => string;
             updatingDependenciesToLocation: (dependencies: string, directory: string) => string;
             updatingDependenciesFailed: (directory: string) => string;
-            noProjectConfig: string;
             noPackageJsonInProject: (projectName: string) => string;
             packageManagerNotInstalled: (packageManager: string) => string;
         };
@@ -2157,7 +2156,6 @@ export declare const commands: {
                 uid: string;
             };
             errors: {
-                noProjectConfig: string;
                 projectNotFound: (projectName: string, accountId: number) => string;
                 noDeployedBuild: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
@@ -2219,7 +2217,6 @@ export declare const commands: {
                 profile: string;
             };
             errors: {
-                noProjectConfig: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 failedToParseProject: string;
                 noAppInProject: string;
@@ -2253,7 +2250,6 @@ export declare const commands: {
                 json: string;
             };
             errors: {
-                noProjectConfig: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 failedToParseProject: string;
                 noAppInProject: string;
@@ -3376,6 +3372,7 @@ export declare const lib: {
         learnMoreLocalDevServer: string;
         running: (projectName: string, accountIdentifier: string) => string;
         quitHelper: string;
+        autoUploadEnabled: string;
         viewProjectLink: (name: string, accountId: number) => string;
         viewLocalDevUILink: (accountId: number, showWelcomeScreen: boolean) => string;
         localDevUIAutoMessage: (accountId: number, showWelcomeScreen: boolean) => string;
@@ -3467,6 +3464,10 @@ export declare const lib: {
     LocalDevProcess: {
         projectConfigMismatch: string;
         uploadInitiated: string;
+        autoUploadScheduled: (filePath: string) => string;
+        autoUploadTriggered: string;
+        autoUploadInProgress: string;
+        autoUploadToggled: (enabled: boolean) => string;
         deployInitiated: string;
         uploadFailed: string;
         deployFailed: string;
@@ -3539,7 +3540,6 @@ export declare const lib: {
         };
         loadProfile: {
             errors: {
-                noProjectConfig: string;
                 profileNotFound: (profileName: string) => string;
                 missingAccountId: (profileName: string) => string;
                 listedAccountNotFound: (accountId: number, profileName: string) => string;
@@ -3581,12 +3581,6 @@ export declare const lib: {
         };
         validateProjectConfig: {
             configNotFound: string;
-            configMissingFields: (missingFields: string[]) => string;
-            srcDirNotFound: (srcDir: string, projectDir: string) => string;
-            srcOutsideProjectDir: (projectConfig: string, srcDir: string) => string;
-        };
-        getProjectConfig: {
-            error: string;
         };
         platformVersion: {
             unsupported: (currentCliVersion: string, latestSupported: string, platformVersion?: string) => string;
@@ -4495,6 +4489,13 @@ export declare const lib: {
             copyingProjectFilesFailed: string;
         };
     };
+    cms: {
+        serverlessDevRuntime: {
+            installStarted: (targetVersion: string) => string;
+            installSucceeded: string;
+            installFailed: string;
+        };
+    };
     theme: {
         cmsDevServerProcess: {
             installStarted: (targetVersion: string) => string;

package/lang/en.js

@@ -1482,7 +1482,6 @@ export const commands = {
                     duplicateTargetAccount: (targetAccountId) => `The account ${uiAccountDescription(targetAccountId)} is being used in an existing profile. Make sure to edit your project's name between uploads if you do not want to overwrite the existing project in this account.`,
                 },
                 errors: {
-                    noProjectConfig: 'No project config found. Please run this command from a project directory.',
                     unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
                     profileExists: (profileName) => `Profile ${chalk.bold(profileName)} already exists. Please choose a different name.`,
                     invalidTargetAccount: 'Target account is not configured in the CLI',
@@ -1515,7 +1514,6 @@ export const commands = {
                     deleteProjectPrompt: (accountId) => `Would you like to delete this project from ${uiAccountDescription(accountId)}?`,
                 },
                 errors: {
-                    noProjectConfig: 'No project config found. Please run this command from a project directory.',
                     unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
                     noProfileFound: (profileName) => `No profile with filename ${chalk.bold(profileName)} found in your project.`,
                     noProfilesFound: 'No profiles found in your project.',
@@ -1539,12 +1537,12 @@ export const commands = {
                 testingAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --testing-account flag for testing`,
             },
             errors: {
-                noProjectConfig: 'No project detected. Please run this command again from a project directory.',
                 noAccount: (accountId) => `An error occurred while reading account ${uiAccountDescription(accountId)} from your config. Run ${uiAuthCommandReference()} to re-auth this account.`,
                 unsupportedPlatformVersion: (platformVersion) => `Local development is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
                 noRunnableComponents: `No supported components were found in this project. Run ${uiCommandReference('hs project add')} to see a list of available components and add one to your project.`,
                 accountNotCombined: `\nLocal development of unified apps is currently only compatible with accounts that are opted into the unified apps beta. Make sure that this account is opted in or switch accounts using ${uiCommandReference('hs account use')}.`,
                 localDevAlreadyRunning: `Another ${uiCommandReference('hs project dev')} process is already running. To proceed with local development of this project, stop the existing process and re-run ${uiCommandReference('hs project dev')}.`,
+                autoUploadRequiresAutoDeploy: `${uiCommandReference('hs project dev --auto-upload')} requires auto-deploy to be enabled for this project, since auto-upload deploys every change. Enable auto-deploy in your project settings, or run ${uiCommandReference('hs project dev')} without it.`,
             },
             examples: {
                 default: 'Start local dev for the current project',
@@ -1557,6 +1555,7 @@ export const commands = {
                 projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account.',
                 testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account.',
                 port: `The port for the local dev server. Defaults to ${LOCAL_DEV_DEFAULT_PORT}.`,
+                autoUpload: 'Automatically upload local changes to HubSpot as you edit files, instead of uploading manually from the Local Dev Panel.',
             },
         },
         create: {
@@ -1858,6 +1857,8 @@ export const commands = {
             },
             examples: {
                 default: 'List the builds for the current project',
+                withLimit: 'List the five most recent builds for the current project',
+                json: 'Output the builds for the current project as JSON',
             },
         },
         logs: {
@@ -1924,9 +1925,11 @@ export const commands = {
                 autoDeployDisabled: (deployCommand) => `Automatic deploys are disabled for this project. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
                 autoDeploySkipped: (deployCommand) => `Auto-deploy was skipped for this build. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
                 releaseManagementRequired: (releaseCommand) => `Run ${uiCommandReference(releaseCommand)} to create a release for this build.`,
+                uploadingWithProfile: (profileName, accountId) => `Initializing project upload with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
+                uploadingToAccount: (accountId) => `Initializing project upload to account ${uiAccountDescription(accountId)}`,
+                uploadedToAccount: (accountId) => `Project uploaded to ${uiAccountDescription(accountId)}`,
             },
             errors: {
-                noProjectConfig: 'No project detected. Run this command from a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${uiCommandReference('hs project dev')} command for this project. If this is you, unlock the project in Projects UI.`,
                 previewRequiresTarget: `${uiCommandReference('--preview')} requires ${uiCommandReference('--target=<portalId>')} to specify the portal to preview on.`,
                 targetRequiresPreview: `${uiCommandReference('--target')} can only be used with ${uiCommandReference('--preview')}.`,
@@ -1988,7 +1991,6 @@ export const commands = {
                 fileAlreadyQueued: (filePath) => `File "${filePath}" is already queued for upload`,
             },
             errors: {
-                projectConfigNotFound: 'No project config found. Please ensure that you are in a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${chalk.bold(`hs project dev`)} command for this project. If this is you, unlock the project in Projects UI.`,
                 uploadFailed: (remotePath, filePath) => `Failed to upload file "${filePath}" to "${remotePath}"`,
                 deleteFileFailed: (remotePath) => `Failed to delete file "${remotePath}"`,
@@ -2055,7 +2057,6 @@ export const commands = {
             installationSuccessful: (directory) => `Installed dependencies in ${directory}`,
             addingDependenciesToLocation: (dependencies, directory) => `Installing ${dependencies} in ${directory}`,
             installingDependenciesFailed: (directory) => `Installing dependencies for ${directory} failed`,
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             noPackageJsonInProject: (projectName) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
             packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
         },
@@ -2073,7 +2074,6 @@ export const commands = {
                 addingLintScripts: 'Adding lint scripts to package.json files…',
                 linting: 'Linting…',
             },
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             failedToReadPackageJson: (packageJsonPath) => `Failed to read package.json at ${packageJsonPath}`,
             installLintPackagesPrompt: (directories, missingPackages) => {
                 const uniquePackages = Array.from(new Set(missingPackages)).sort();
@@ -2115,7 +2115,6 @@ export const commands = {
             updateSuccessful: (directory) => `Updated dependencies in ${directory}`,
             updatingDependenciesToLocation: (dependencies, directory) => `Updating ${dependencies} in ${directory}`,
             updatingDependenciesFailed: (directory) => `Updating dependencies for ${directory} failed`,
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             noPackageJsonInProject: (projectName) => `No dependencies to update. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
             packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
         },
@@ -2185,7 +2184,6 @@ export const commands = {
                 uid: 'UID',
             },
             errors: {
-                noProjectConfig: `No project found in this directory.\n\nRun ${uiCommandReference('hs project create')} to start a new project, or change to a directory containing hsproject.json.`,
                 projectNotFound: (projectName, accountId) => `Project "${projectName}" was not found in account ${uiAccountDescription(accountId)}. Make sure the project has been uploaded at least once.`,
                 noDeployedBuild: `This project has not been deployed yet.\n\nRun ${uiCommandReference('hs project deploy')} to deploy your project.`,
                 unsupportedPlatformVersion: (platformVersion) => `This command is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
@@ -2244,7 +2242,6 @@ export const commands = {
                 profile: 'The profile to target with this install',
             },
             errors: {
-                noProjectConfig: `No project config found. Run this command from within a HubSpot project directory, or use ${uiCommandReference('hs project create')} to create a new one.`,
                 unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
                 failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
                 noAppInProject: 'No app was found in the local project. This command requires a project that contains an app.',
@@ -2278,7 +2275,6 @@ export const commands = {
                 json: 'Output install status as JSON',
             },
             errors: {
-                noProjectConfig: `No project config found. Run this command from within a HubSpot project directory, or use ${uiCommandReference('hs project create')} to create a new one.`,
                 unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
                 failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
                 noAppInProject: 'No app was found in the local project. Install status is only available for projects that contain an app.',
@@ -3401,6 +3397,7 @@ export const lib = {
         learnMoreLocalDevServer: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands'),
         running: (projectName, accountIdentifier) => chalk.hex(UI_COLORS.SORBET)(`Running ${chalk.bold(projectName)} locally on ${accountIdentifier}, waiting for changes ...`),
         quitHelper: `Press ${chalk.bold('q')} to stop the local dev server`,
+        autoUploadEnabled: `${chalk.bold('Auto-upload is on.')} Changes you make locally will be uploaded to HubSpot automatically.`,
         viewProjectLink: (name, accountId) => uiLink('View project in HubSpot', getProjectDetailUrl(name, accountId) || ''),
         viewLocalDevUILink: (accountId, showWelcomeScreen) => uiLink('View local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen)),
         localDevUIAutoMessage: (accountId, showWelcomeScreen) => `Opening your ${uiLink('local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen))}...`,
@@ -3491,8 +3488,14 @@ export const lib = {
     },
     LocalDevProcess: {
         projectConfigMismatch: `Unable to upload project. The project config has been modified since starting ${uiCommandReference('hs project dev')}.`,
-        uploadInitiated: 'Project upload initiated from Local Dev UI.',
-        deployInitiated: 'Project deploy initiated from Local Dev UI.',
+        uploadInitiated: 'Project upload initiated.',
+        autoUploadScheduled: (filePath) => `Auto-upload: detected change to ${filePath}, upload scheduled.`,
+        autoUploadTriggered: 'Auto-upload: debounce elapsed, uploading now.',
+        autoUploadInProgress: 'Auto-upload: an upload is already running, will re-run after it finishes.',
+        autoUploadToggled: (enabled) => enabled
+            ? `${chalk.bold('Auto-upload turned on')} from the Local Dev Panel. Changes you make locally will be uploaded to HubSpot automatically.`
+            : `${chalk.bold('Auto-upload turned off')} from the Local Dev Panel. Upload manually from the Local Dev Panel to push your changes.`,
+        deployInitiated: 'Project deploy initiated from the Local Dev Panel.',
         uploadFailed: 'Project upload failed. To proceed with local development, fix any necessary errors, then re-upload your project.',
         deployFailed: 'Project deploy failed. To proceed with local development, fix any necessary errors, then re-deploy your project.',
         uploadSuccess: 'Project upload completed successfully. Resuming local dev...',
@@ -3576,7 +3579,6 @@ export const lib = {
         },
         loadProfile: {
             errors: {
-                noProjectConfig: 'No project config found. Please run this command from a project directory.',
                 profileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} not found.`,
                 missingAccountId: (profileName) => `Profile ${chalk.bold(profileName)} is missing an account id.`,
                 listedAccountNotFound: (accountId, profileName) => `The account ${uiAccountDescription(accountId)} is defined in your profile ${chalk.bold(profileName)}, but is missing in your config file`,
@@ -3618,12 +3620,6 @@ export const lib = {
         },
         validateProjectConfig: {
             configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${uiCommandReference('hs project create')} to create a new project.`,
-            configMissingFields: (missingFields) => `The project configuration file is missing required field${missingFields.length > 1 ? 's' : ''}: ${missingFields.map(f => chalk.bold(f)).join(', ')}`,
-            srcDirNotFound: (srcDir, projectDir) => `Project source directory ${chalk.bold(srcDir)} could not be found in ${chalk.bold(projectDir)}.`,
-            srcOutsideProjectDir: (projectConfig, srcDir) => `Invalid value for 'srcDir' in ${projectConfig}: ${chalk.bold(`srcDir: "${srcDir}"`)}\n\t'srcDir' must be a relative path to a folder under the project root, such as "." or "./src"`,
-        },
-        getProjectConfig: {
-            error: 'Could not read from project config',
         },
         platformVersion: {
             unsupported: (currentCliVersion, latestSupported, platformVersion) => `Platform version${platformVersion ? ' ' + chalk.bold(platformVersion) : ''} is not officially supported by this version of the CLI (${chalk.bold(currentCliVersion)}).\n\nUpdate your CLI to the latest version with ${uiCommandReference('hs upgrade')} or use a compatible platform version (${chalk.bold(latestSupported)} or earlier).`,
@@ -4532,6 +4528,13 @@ export const lib = {
             copyingProjectFilesFailed: 'Unable to copy migrated project files',
         },
     },
+    cms: {
+        serverlessDevRuntime: {
+            installStarted: (targetVersion) => `Installing serverless-dev-runtime ${targetVersion}...`,
+            installSucceeded: 'serverless-dev-runtime setup complete',
+            installFailed: 'Failed to install serverless-dev-runtime',
+        },
+    },
     theme: {
         cmsDevServerProcess: {
             installStarted: (targetVersion) => `Installing cms-dev-server ${targetVersion}...`,

package/lib/app/migrate.js

@@ -39,7 +39,7 @@ export function getUnmigratableReason(reasonCode, projectName, accountId) {
 export function generateFilterAppsByProjectNameFunction(projectConfig) {
     return (app) => {
         if (projectConfig) {
-            return app.projectName === projectConfig?.projectConfig?.name;
+            return app.projectName === projectConfig.projectConfig.name;
         }
         return true;
     };
@@ -70,7 +70,7 @@ export async function validateMigrationApps(appId, derivedAccountId, { migratabl
     if (allApps.length > 1 && projectConfig) {
         throw new Error(lib.migrate.errors.project.multipleApps);
     }
-    if (!projectConfig?.projectConfig) {
+    if (!projectConfig) {
         allApps.forEach(app => {
             if (app.projectName) {
                 app.isMigratable = false;
@@ -80,7 +80,7 @@ export async function validateMigrationApps(appId, derivedAccountId, { migratabl
         });
     }
     if (allApps.length === 0 && projectConfig) {
-        throw new Error(lib.migrate.errors.noAppsForProject(projectConfig?.projectConfig?.name || ''));
+        throw new Error(lib.migrate.errors.noAppsForProject(projectConfig.projectConfig.name));
     }
     if (allApps.length === 0 || !allApps.some(app => app.isMigratable)) {
         const reasons = unmigratableApps.map(app => `${chalk.bold(app.appName)}: ${getUnmigratableReason(app.unmigratableReason, app.projectName, derivedAccountId)}`);
@@ -173,9 +173,7 @@ export async function handleMigrationSetup(derivedAccountId, options, projectCon
         return {};
     }
     // If it's a project we don't want to prompt for dest and name, so just return early
-    if (projectConfig &&
-        projectConfig?.projectConfig &&
-        projectConfig?.projectDir) {
+    if (projectConfig) {
         return {
             appIdToMigrate,
             projectName: projectConfig.projectConfig.name,
@@ -309,7 +307,7 @@ export async function downloadProjectFiles(derivedAccountId, projectName, buildI
         });
         const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, buildId);
         let absoluteDestPath;
-        if (projectConfig?.projectConfig && projectConfig?.projectDir) {
+        if (projectConfig) {
             const { projectDir } = projectConfig;
             absoluteDestPath = projectDir;
             const { srcDir } = projectConfig.projectConfig;

package/lib/cms/serverlessDevRuntime.d.ts

@@ -0,0 +1 @@
+export declare function startServerlessDevRuntime(options: any): Promise<void>;

package/lib/cms/serverlessDevRuntime.js

@@ -0,0 +1,72 @@
+import { spawn } from 'child_process';
+import { createRequire } from 'module';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+import SpinniesManager from '../ui/SpinniesManager.js';
+import { lib } from '../../lang/en.js';
+const TARGET_SERVERLESS_RUNTIME_VERSION = '7.0.7';
+const CACHE_DIR = path.join(os.homedir(), '.hscli', '.serverless-runtime-cache');
+async function ensureServerlessRuntimeInstalled() {
+    const packageJsonPath = path.join(CACHE_DIR, 'node_modules', '@hubspot', 'serverless-dev-runtime', 'package.json');
+    let needsInstall = true;
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const installed = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            if (installed.version === TARGET_SERVERLESS_RUNTIME_VERSION) {
+                needsInstall = false;
+            }
+        }
+        catch {
+            needsInstall = true;
+        }
+    }
+    if (!needsInstall) {
+        return;
+    }
+    SpinniesManager.init({ succeedColor: 'white' });
+    SpinniesManager.add('serverless-runtime-install', {
+        text: lib.cms.serverlessDevRuntime.installStarted(TARGET_SERVERLESS_RUNTIME_VERSION),
+    });
+    fs.mkdirSync(CACHE_DIR, { recursive: true });
+    const nodeModulesDir = path.join(CACHE_DIR, 'node_modules');
+    if (fs.existsSync(nodeModulesDir)) {
+        fs.rmSync(nodeModulesDir, { recursive: true, force: true });
+    }
+    await new Promise((resolve, reject) => {
+        const installProcess = spawn('npm', [
+            'install',
+            `@hubspot/serverless-dev-runtime@${TARGET_SERVERLESS_RUNTIME_VERSION}`,
+            '--production',
+            '--no-save',
+            '--loglevel=error',
+        ], { cwd: CACHE_DIR, stdio: 'ignore' });
+        installProcess.on('close', code => {
+            if (code === 0) {
+                SpinniesManager.succeed('serverless-runtime-install', {
+                    text: lib.cms.serverlessDevRuntime.installSucceeded,
+                });
+                resolve();
+            }
+            else {
+                SpinniesManager.fail('serverless-runtime-install', {
+                    text: lib.cms.serverlessDevRuntime.installFailed,
+                });
+                reject(new Error(lib.cms.serverlessDevRuntime.installFailed));
+            }
+        });
+        installProcess.on('error', error => {
+            SpinniesManager.fail('serverless-runtime-install', {
+                text: lib.cms.serverlessDevRuntime.installFailed,
+            });
+            reject(error);
+        });
+    });
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export async function startServerlessDevRuntime(options) {
+    await ensureServerlessRuntimeInstalled();
+    const requireFromCache = createRequire(path.join(CACHE_DIR, 'package.json'));
+    const { start } = requireFromCache('@hubspot/serverless-dev-runtime');
+    start(options);
+}

package/lib/constants.d.ts

@@ -94,6 +94,7 @@ export declare const LOCAL_DEV_UI_MESSAGE_SEND_TYPES: {
     UPDATE_PROJECT_DATA: string;
     UPDATE_UPLOAD_WARNINGS: string;
     DEV_SERVERS_STARTED: string;
+    UPLOAD_IN_PROGRESS: string;
 };
 export declare const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES: {
     UPLOAD: string;
@@ -102,6 +103,7 @@ export declare const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES: {
     APP_INSTALL_SUCCESS: string;
     APP_INSTALL_INITIATED: string;
     APP_INSTALL_FAILURE: string;
+    SET_AUTO_UPLOAD: string;
 };
 export declare const APP_INSTALLATION_STATES: {
     readonly NOT_INSTALLED: "NOT_INSTALLED";

package/lib/constants.js

@@ -86,6 +86,7 @@ export const LOCAL_DEV_UI_MESSAGE_SEND_TYPES = {
     UPDATE_PROJECT_DATA: 'server:updateProjectData',
     UPDATE_UPLOAD_WARNINGS: 'server:updateUploadWarnings',
     DEV_SERVERS_STARTED: 'server:devServersStarted',
+    UPLOAD_IN_PROGRESS: 'server:uploadInProgress',
 };
 export const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES = {
     UPLOAD: 'client:upload',
@@ -94,6 +95,7 @@ export const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES = {
     APP_INSTALL_SUCCESS: 'client:installSuccess',
     APP_INSTALL_INITIATED: 'client:installInitiated',
     APP_INSTALL_FAILURE: 'client:installFailure',
+    SET_AUTO_UPLOAD: 'client:setAutoUpload',
 };
 export const APP_INSTALLATION_STATES = {
     NOT_INSTALLED: 'NOT_INSTALLED',

package/lib/dependencyManagement.js

@@ -182,21 +182,14 @@ async function updatePackagesInDirectory({ directory, packages, npmWorkspaceDire
     }
 }
 export async function getProjectPackageJsonLocations(dir, isUpdate = false) {
-    const projectConfig = await getProjectConfig(dir);
-    if (!projectConfig ||
-        !projectConfig.projectDir ||
-        !projectConfig.projectConfig) {
-        throw new Error(isUpdate
-            ? commands.project.updateDeps.noProjectConfig
-            : commands.project.installDeps.noProjectConfig);
-    }
-    const { projectDir, projectConfig: { srcDir, name }, } = projectConfig;
+    const { projectConfig, projectDir } = getProjectConfig(dir);
+    const { srcDir, name } = projectConfig;
     if (!(await isGloballyInstalled(DEFAULT_PACKAGE_MANAGER))) {
         throw new Error(isUpdate
             ? commands.project.updateDeps.packageManagerNotInstalled(DEFAULT_PACKAGE_MANAGER)
             : commands.project.installDeps.packageManagerNotInstalled(DEFAULT_PACKAGE_MANAGER));
     }
-    if (!fs.existsSync(projectConfig.projectDir) ||
+    if (!fs.existsSync(projectDir) ||
         !fs.existsSync(path.join(projectDir, srcDir))) {
         throw new NoPackageJsonFilesError(name, isUpdate);
     }

package/lib/doctor/DiagnosticInfoBuilder.d.ts

@@ -1,9 +1,9 @@
-import { getProjectConfig } from '../projects/config.js';
 import { Environment } from '@hubspot/local-dev-lib/types/Accounts';
 import { AccessToken, AccountType, AuthType } from '@hubspot/local-dev-lib/types/Accounts';
 import { Project } from '@hubspot/local-dev-lib/types/Project';
 import process from 'process';
-export type ProjectConfig = Awaited<ReturnType<typeof getProjectConfig>>;
+import type { LoadedProjectConfig } from '../projects/config.js';
+export type ProjectConfig = LoadedProjectConfig | undefined;
 declare const hubspotCli = "@hubspot/cli";
 interface FilesInfo {
     files: string[];

package/lib/doctor/DiagnosticInfoBuilder.js

@@ -50,12 +50,15 @@ export class DiagnosticInfoBuilder {
         this.processInfo = processInfo;
     }
     async generateDiagnosticInfo() {
-        this._projectConfig = await getProjectConfig();
-        if (this._projectConfig?.projectConfig) {
+        try {
+            this._projectConfig = getProjectConfig();
+        }
+        catch {
+            this._projectConfig = undefined;
+        }
+        if (this._projectConfig) {
             await this.fetchProjectDetails();
             await this.fetchAccessToken();
-        }
-        if (this._projectConfig?.projectDir) {
             await this.fetchProjectFilenames();
         }
         const { platform, arch, versions: { node }, mainModule, } = this.processInfo;
@@ -89,9 +92,7 @@ export class DiagnosticInfoBuilder {
     }
     async fetchProjectDetails() {
         try {
-            const { data } = await fetchProject(this.accountId, 
-            // We check that config exists before running this function
-            this._projectConfig.projectConfig.name);
+            const { data } = await fetchProject(this.accountId, this._projectConfig.projectConfig.name);
             this.projectDetails = data;
         }
         catch (e) {
@@ -109,7 +110,6 @@ export class DiagnosticInfoBuilder {
     }
     async fetchProjectFilenames() {
         try {
-            // We check that projectDir exists before running this function
             this.files = (await walk(this._projectConfig.projectDir, ['node_modules'])).map(filename => path.relative(this._projectConfig.projectDir, filename));
         }
         catch (e) {

package/lib/doctor/Doctor.js

@@ -26,7 +26,7 @@ import { isServerRunningAtUrl } from '../http.js';
 import { detectConfiguredMcpClients } from '../mcp/promotion.js';
 import { MCP_CLIENTS } from '../mcp/clients.js';
 import { WEBHOOKS_KEY, APP_KEY } from '@hubspot/project-parsing-lib/constants';
-import { validateProjectConfig } from '../projects/config.js';
+import { validateProjectConfig } from '@hubspot/project-parsing-lib/projects';
 import { validateSourceDirectory, handleTranslate, } from '../projects/upload.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { validateProjectForProfile } from '../projects/projectProfiles.js';
@@ -57,7 +57,7 @@ export class Doctor {
             ...this.performCliChecks(),
             ...this.performCliConfigChecks(),
             ...this.performNetworkingChecks(),
-            ...(this.projectConfig?.projectConfig ? this.performProjectChecks() : []),
+            ...(this.projectConfig ? this.performProjectChecks() : []),
         ]);
         this.performDefaultAccountOverrideFileChecks();
         this.performCliConfigSettingsChecks();
@@ -283,7 +283,7 @@ export class Doctor {
         for (const packageFile of this.diagnosticInfo?.packageFiles || []) {
             const packageDirName = path.dirname(packageFile);
             try {
-                const needsInstall = await hasMissingPackages(path.join(this.projectConfig?.projectDir || '', packageDirName));
+                const needsInstall = await hasMissingPackages(path.join(this.projectConfig?.projectDir ?? '', packageDirName));
                 if (needsInstall) {
                     foundError = true;
                     this.diagnosis?.addProjectSection({
@@ -331,7 +331,7 @@ export class Doctor {
     async checkProjectConfigJsonFiles() {
         let foundError = false;
         for (const jsonFile of this.diagnosticInfo?.jsonFiles || []) {
-            const fileToCheck = path.join(this.projectConfig?.projectDir || '', jsonFile);
+            const fileToCheck = path.join(this.projectConfig?.projectDir ?? '', jsonFile);
             if (!(await this.isValidJsonFile(fileToCheck))) {
                 foundError = true;
                 this.diagnosis?.addProjectSection({
@@ -432,7 +432,7 @@ export class Doctor {
             const hsMetaFiles = this.diagnosticInfo?.hsMetaFiles || [];
             for (const metaFiles of hsMetaFiles) {
                 try {
-                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir || '', metaFiles), 'utf8');
+                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir ?? '', metaFiles), 'utf8');
                     const contents = JSON.parse(content);
                     if (contents.type === WEBHOOKS_KEY &&
                         contents.config?.settings?.targetUrl) {
@@ -461,7 +461,7 @@ export class Doctor {
             const hsMetaFiles = this.diagnosticInfo?.hsMetaFiles || [];
             for (const metaFile of hsMetaFiles) {
                 try {
-                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir || '', metaFile), 'utf8');
+                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir ?? '', metaFile), 'utf8');
                     const contents = JSON.parse(content);
                     if (contents.type === APP_KEY &&
                         Array.isArray(contents.config?.auth?.redirectUrls)) {
@@ -550,9 +550,7 @@ export class Doctor {
         }
     }
     async checkProjectValidation() {
-        if (!this.projectConfig?.projectConfig ||
-            !this.projectConfig?.projectDir ||
-            !this.accountId) {
+        if (!this.projectConfig || !this.accountId) {
             return;
         }
         const { projectConfig, projectDir } = this.projectConfig;

package/lib/errors/ProjectErrors.d.ts

@@ -1,12 +1,6 @@
 export declare class ProjectNestingError extends Error {
     constructor(message: string);
 }
-export declare class ProjectConfigNotFoundError extends Error {
-    constructor(message: string);
-}
-export declare class ProjectValidationError extends Error {
-    constructor(message: string);
-}
 export declare class ProjectUploadError extends Error {
     constructor(message: string, cause?: unknown);
 }