@hubspot/cli 8.14.0-beta.0 → 8.14.0-beta.1

package/commands/project/dev/index.js

@@ -110,6 +110,11 @@ function projectDevBuilder(yargs) {
         description: commands.project.dev.options.port,
         default: LOCAL_DEV_DEFAULT_PORT,
     });
+    yargs.option('auto-upload', {
+        type: 'boolean',
+        description: commands.project.dev.options.autoUpload,
+        default: false,
+    });
     yargs.example([['$0 project dev', commands.project.dev.examples.default]]);
     yargs.conflicts('profile', 'testing-account');
     yargs.conflicts('profile', 'project-account');

package/commands/project/dev/unifiedFlow.js

@@ -155,6 +155,13 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
         noLogs: true,
     });
     let project = uploadedProject;
+    // Fail fast before the slower project checks below.
+    const autoDeployEnabled = (project?.deployedBuild ?? project?.latestBuild)?.isAutoDeployEnabled ??
+        true;
+    if (args.autoUpload && !autoDeployEnabled) {
+        uiLogger.error(commands.project.dev.errors.autoUploadRequiresAutoDeploy);
+        return exit(EXIT_CODES.ERROR);
+    }
     if (projectExists && project) {
         await compareLocalProjectToDeployed(projectConfig, targetProjectAccountId, project.deployedBuild?.buildId, projectNodes, exit, args.profile);
     }
@@ -189,6 +196,7 @@ export async function unifiedProjectDevFlow({ args, targetProjectAccountId, prov
         projectData: project,
         env,
         actions: { exit },
+        autoUploadEnabled: Boolean(args.autoUpload) && autoDeployEnabled,
     });
     const websocketServer = new LocalDevWebsocketServer(localDevProcess, args.debug);
     const watcher = new LocalDevWatcher(localDevProcess);

package/commands/project/listBuilds.d.ts

@@ -1,5 +1,6 @@
-import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs.js';
-export type ProjectListBuildsArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
+import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
+import { ProjectBuildsListJsonOutput } from '../../lib/jsonOutput.js';
+export type ProjectListBuildsArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ProjectBuildsListJsonOutput> & {
     project?: string;
     limit?: number;
 };

package/commands/project/listBuilds.js

@@ -5,6 +5,7 @@ import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/con
 import { getProjectDetailUrl } from '../../lib/projects/urls.js';
 import moment from 'moment';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
+import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
@@ -12,6 +13,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { commands } from '../../lang/en.js';
 import { renderTable } from '../../ui/render.js';
+import { ProjectBuildsListSchema, mapBuildToJsonOutput, } from '../../lib/jsonOutput.js';
 const command = 'list-builds';
 const describe = commands.project.listBuilds.describe;
 async function fetchAndDisplayBuilds(accountId, project, options) {
@@ -40,7 +42,7 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
         });
         renderTable(['Build ID', 'Status', 'Completed', 'Duration', 'Details'], builds);
     }
-    if (options && options.after) {
+    if (options.after) {
         if (results.length > 0) {
             uiLogger.log(commands.project.listBuilds.showingNextBuilds(results.length, project.name));
         }
@@ -48,7 +50,8 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
     else {
         uiLogger.log(commands.project.listBuilds.showingRecentBuilds(results.length, project.name, uiLink(commands.project.listBuilds.viewAllBuildsLink, getProjectDetailUrl(project.name, accountId))));
     }
-    if (paging && paging.next) {
+    const canPromptForMore = options.limit === undefined && Boolean(process.stdin.isTTY);
+    if (paging?.next?.after && canPromptForMore) {
         await promptUser({
             name: 'more',
             message: commands.project.listBuilds.continueOrExitPrompt,
@@ -60,7 +63,7 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
     }
 }
 async function handler(args) {
-    const { project: projectFlagValue, limit, derivedAccountId, exit } = args;
+    const { project: projectFlagValue, limit, derivedAccountId, exit, json: formatOutputAsJson, addJsonOutput, } = args;
     let projectName = projectFlagValue;
     if (!projectName) {
         const { projectConfig, projectDir } = await getProjectConfig();
@@ -78,9 +81,25 @@ async function handler(args) {
     }
     try {
         const { data: project } = await fetchProject(derivedAccountId, projectName);
-        await fetchAndDisplayBuilds(derivedAccountId, project, { limit });
+        if (formatOutputAsJson) {
+            const { data: { results, paging }, } = await fetchProjectBuilds(derivedAccountId, project.name, { limit });
+            addJsonOutput({
+                projectName: project.name,
+                deployedBuildId: project.deployedBuildId,
+                results: results.map(build => mapBuildToJsonOutput(build, project.deployedBuildId)),
+                paging: paging?.next?.after
+                    ? { next: { after: paging.next.after } }
+                    : undefined,
+            });
+        }
+        else {
+            await fetchAndDisplayBuilds(derivedAccountId, project, { limit });
+        }
     }
     catch (e) {
+        if (isPromptExitError(e)) {
+            return exit(e.exitCode);
+        }
         if (isHubSpotHttpError(e) && e.status === 404) {
             uiLogger.error(commands.project.listBuilds.errors.projectNotFound(projectName));
         }
@@ -90,6 +109,7 @@ async function handler(args) {
                 projectName,
             }));
         }
+        return exit(EXIT_CODES.ERROR);
     }
     return exit(EXIT_CODES.SUCCESS);
 }
@@ -101,11 +121,19 @@ function projectListBuildsBuilder(yargs) {
         },
         limit: {
             describe: commands.project.listBuilds.options.limit.describe,
-            type: 'string',
+            type: 'number',
         },
     });
     yargs.example([
         ['$0 project list-builds', commands.project.listBuilds.examples.default],
+        [
+            '$0 project list-builds --limit=5',
+            commands.project.listBuilds.examples.withLimit,
+        ],
+        [
+            '$0 project list-builds --json',
+            commands.project.listBuilds.examples.json,
+        ],
     ]);
     return yargs;
 }
@@ -114,11 +142,14 @@ const builder = makeYargsBuilder(projectListBuildsBuilder, command, describe, {
     useConfigOptions: true,
     useAccountOptions: true,
     useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
 });
 const projectListBuildsCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-list-builds', handler),
+    handler: makeWrappedYargsHandler('project-list-builds', handler, {
+        jsonOutputSchema: ProjectBuildsListSchema,
+    }),
     builder,
 };
 export default projectListBuildsCommand;

package/commands/project/upload.js

@@ -118,7 +118,7 @@ async function handler(args) {
             (!result.buildResult.isAutoDeployEnabled || preview || skipAutoDeploy)) {
             uiLogger.log(chalk.bold(commands.project.upload.logs.buildSucceeded(result.buildId)));
             if (!preview) {
-                if (meetsMinimumPlatformVersion(result.buildResult.platformVersion, PLATFORM_VERSIONS.v2026_09_BETA)) {
+                if (meetsMinimumPlatformVersion(result.buildResult.platformVersion, PLATFORM_VERSIONS.v2027_03_BETA)) {
                     const releaseCommand = `hs project release create --build=${result.buildId}`;
                     uiLogger.log(commands.project.upload.logs.releaseManagementRequired(releaseCommand));
                 }

package/lang/en.d.ts

@@ -1529,6 +1529,7 @@ export declare const commands: {
                 noRunnableComponents: string;
                 accountNotCombined: string;
                 localDevAlreadyRunning: string;
+                autoUploadRequiresAutoDeploy: string;
             };
             examples: {
                 default: string;
@@ -1541,6 +1542,7 @@ export declare const commands: {
                 projectAccount: string;
                 testingAccount: string;
                 port: string;
+                autoUpload: string;
             };
         };
         create: {
@@ -1842,6 +1844,8 @@ export declare const commands: {
             };
             examples: {
                 default: string;
+                withLimit: string;
+                json: string;
             };
         };
         logs: {
@@ -3376,6 +3380,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 +3472,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;

package/lang/en.js

@@ -1545,6 +1545,7 @@ export const commands = {
                 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 +1558,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 +1860,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: {
@@ -3401,6 +3405,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 +3496,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...',

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/jsonOutput.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { Build } from '@hubspot/local-dev-lib/types/Build';
 import { Release } from '../api/releases.js';
 declare const ReleaseComponentSchema: z.ZodObject<{
     buildType: z.ZodString;
@@ -35,6 +36,74 @@ export declare const ReleaseListSchema: z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+declare const BuildSubbuildStatusSchema: z.ZodObject<{
+    buildName: z.ZodString;
+    buildType: z.ZodString;
+    status: z.ZodString;
+    errorMessage: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    rootPath: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+    visible: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const BuildSchema: z.ZodObject<{
+    buildId: z.ZodNumber;
+    status: z.ZodString;
+    isDeployed: z.ZodBoolean;
+    isAutoDeployEnabled: z.ZodOptional<z.ZodBoolean>;
+    deployableState: z.ZodOptional<z.ZodString>;
+    platformVersion: z.ZodOptional<z.ZodString>;
+    uploadMessage: z.ZodOptional<z.ZodString>;
+    enqueuedAt: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    subbuildStatuses: z.ZodArray<z.ZodObject<{
+        buildName: z.ZodString;
+        buildType: z.ZodString;
+        status: z.ZodString;
+        errorMessage: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        rootPath: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        visible: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ProjectBuildsListSchema: z.ZodObject<{
+    projectName: z.ZodString;
+    deployedBuildId: z.ZodOptional<z.ZodNumber>;
+    results: z.ZodArray<z.ZodObject<{
+        buildId: z.ZodNumber;
+        status: z.ZodString;
+        isDeployed: z.ZodBoolean;
+        isAutoDeployEnabled: z.ZodOptional<z.ZodBoolean>;
+        deployableState: z.ZodOptional<z.ZodString>;
+        platformVersion: z.ZodOptional<z.ZodString>;
+        uploadMessage: z.ZodOptional<z.ZodString>;
+        enqueuedAt: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        subbuildStatuses: z.ZodArray<z.ZodObject<{
+            buildName: z.ZodString;
+            buildType: z.ZodString;
+            status: z.ZodString;
+            errorMessage: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            finishedAt: z.ZodOptional<z.ZodString>;
+            rootPath: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            visible: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    paging: z.ZodOptional<z.ZodObject<{
+        next: z.ZodObject<{
+            after: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const ProjectInfoSchema: z.ZodObject<{
     projectName: z.ZodString;
     platformVersion: z.ZodString;
@@ -98,6 +167,9 @@ export declare const CreateTestAccountSchema: z.ZodObject<{
 export type ReleaseComponentJsonOutput = z.infer<typeof ReleaseComponentSchema>;
 export type ReleaseJsonOutput = z.infer<typeof ReleaseSchema>;
 export type ReleaseListJsonOutput = z.infer<typeof ReleaseListSchema>;
+export type BuildSubbuildStatusJsonOutput = z.infer<typeof BuildSubbuildStatusSchema>;
+export type BuildJsonOutput = z.infer<typeof BuildSchema>;
+export type ProjectBuildsListJsonOutput = z.infer<typeof ProjectBuildsListSchema>;
 export type ProjectInfoJsonOutput = z.infer<typeof ProjectInfoSchema>;
 export type PreviewJsonOutput = z.infer<typeof PreviewSchema>;
 export type UploadJsonOutput = z.infer<typeof UploadSchema>;
@@ -105,5 +177,6 @@ export type DeployJsonOutput = z.infer<typeof DeploySchema>;
 export type InstallStatusJsonOutput = z.infer<typeof InstallStatusSchema>;
 export type InstallAppJsonOutput = z.infer<typeof InstallAppSchema>;
 export type CreateTestAccountJsonOutput = z.infer<typeof CreateTestAccountSchema>;
+export declare function mapBuildToJsonOutput(build: Build, deployedBuildId?: number): BuildJsonOutput;
 export declare function mapReleaseToJsonOutput(release: Release): ReleaseJsonOutput;
 export {};

package/lib/jsonOutput.js

@@ -21,6 +21,43 @@ export const ReleaseListSchema = z.object({
     })
         .optional(),
 });
+const BuildSubbuildStatusSchema = z.object({
+    buildName: z.string(),
+    buildType: z.string(),
+    status: z.string(),
+    errorMessage: z.string().optional(),
+    startedAt: z.string().optional(),
+    finishedAt: z.string().optional(),
+    rootPath: z.string().optional(),
+    id: z.string().optional(),
+    visible: z.boolean().optional(),
+});
+export const BuildSchema = z.object({
+    buildId: z.number(),
+    status: z.string(),
+    isDeployed: z.boolean(),
+    isAutoDeployEnabled: z.boolean().optional(),
+    deployableState: z.string().optional(),
+    platformVersion: z.string().optional(),
+    uploadMessage: z.string().optional(),
+    enqueuedAt: z.string().optional(),
+    startedAt: z.string().optional(),
+    finishedAt: z.string().optional(),
+    createdAt: z.string().optional(),
+    subbuildStatuses: z.array(BuildSubbuildStatusSchema),
+});
+export const ProjectBuildsListSchema = z.object({
+    projectName: z.string(),
+    deployedBuildId: z.number().optional(),
+    results: z.array(BuildSchema),
+    paging: z
+        .object({
+        next: z.object({
+            after: z.string(),
+        }),
+    })
+        .optional(),
+});
 export const ProjectInfoSchema = z.object({
     projectName: z.string(),
     platformVersion: z.string(),
@@ -78,6 +115,33 @@ export const CreateTestAccountSchema = z.object({
     accountId: z.number().optional(),
     personalAccessKey: z.string().optional(),
 });
+export function mapBuildToJsonOutput(build, deployedBuildId) {
+    const { buildId, status, isAutoDeployEnabled, deployableState, platformVersion, uploadMessage, enqueuedAt, startedAt, finishedAt, createdAt, subbuildStatuses, } = build;
+    return {
+        buildId,
+        status,
+        isDeployed: buildId === deployedBuildId,
+        isAutoDeployEnabled,
+        deployableState,
+        platformVersion,
+        uploadMessage,
+        enqueuedAt,
+        startedAt,
+        finishedAt,
+        createdAt,
+        subbuildStatuses: subbuildStatuses.map(subbuild => ({
+            buildName: subbuild.buildName,
+            buildType: subbuild.buildType,
+            status: subbuild.status,
+            errorMessage: subbuild.errorMessage,
+            startedAt: subbuild.startedAt,
+            finishedAt: subbuild.finishedAt,
+            rootPath: subbuild.rootPath,
+            id: subbuild.id,
+            visible: subbuild.visible,
+        })),
+    };
+}
 export function mapReleaseToJsonOutput(release) {
     const { releaseTag, buildId, createdAt, components } = release;
     return {

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

@@ -22,6 +22,10 @@ declare class LocalDevLogger {
     cleanupError(): void;
     cleanupSuccess(): void;
     uploadInitiated(): void;
+    autoUploadScheduled(filePath: string): void;
+    autoUploadTriggered(): void;
+    autoUploadInProgress(): void;
+    autoUploadToggled(enabled: boolean): void;
     deployInitiated(): void;
     projectConfigMismatch(): void;
     uploadError(error: unknown): void;

package/lib/projects/localDev/LocalDevLogger.js

@@ -99,6 +99,10 @@ class LocalDevLogger {
             uiLogger.log('');
             uiLogger.log(lib.LocalDevManager.localDevUIAutoMessage(this.state.targetTestingAccountId, showWelcomeScreen));
         }
+        if (this.state.autoUploadEnabled) {
+            uiLogger.log('');
+            uiLogger.log(lib.LocalDevManager.autoUploadEnabled);
+        }
         uiLogger.log('');
         uiLogger.log(lib.LocalDevManager.quitHelper);
         uiLine();
@@ -122,6 +126,20 @@ class LocalDevLogger {
     uploadInitiated() {
         uiLogger.log(lib.LocalDevProcess.uploadInitiated);
     }
+    autoUploadScheduled(filePath) {
+        uiLogger.debug(lib.LocalDevProcess.autoUploadScheduled(filePath));
+    }
+    autoUploadTriggered() {
+        uiLogger.debug(lib.LocalDevProcess.autoUploadTriggered);
+    }
+    autoUploadInProgress() {
+        uiLogger.debug(lib.LocalDevProcess.autoUploadInProgress);
+    }
+    autoUploadToggled(enabled) {
+        uiLogger.log('');
+        uiLogger.log(lib.LocalDevProcess.autoUploadToggled(enabled));
+        uiLogger.log('');
+    }
     deployInitiated() {
         uiLogger.log(lib.LocalDevProcess.deployInitiated);
     }

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

@@ -8,6 +8,9 @@ declare class LocalDevProcess {
     private _logger;
     private devServerManager;
     private devSessionManager;
+    private autoUploadTimeout;
+    private pendingAutoUpload;
+    private autoUploadStopped;
     constructor(options: LocalDevStateConstructorOptions);
     get projectDir(): string;
     get projectData(): Project;
@@ -17,6 +20,10 @@ declare class LocalDevProcess {
         [key: string]: IntermediateRepresentationNodeLocalDev;
     };
     get logger(): LocalDevLogger;
+    get autoUploadEnabled(): boolean;
+    setAutoUploadEnabled(enabled: boolean): void;
+    get autoUploadAvailable(): boolean;
+    private isAutoDeployEnabled;
     private setupDevServers;
     private startDevServers;
     private cleanupDevServers;
@@ -27,10 +34,13 @@ declare class LocalDevProcess {
     private openLocalDevUi;
     private updateProjectData;
     handleFileChange(filePath: string, event: string): Promise<void>;
-    handleConfigFileChange(): Promise<void>;
+    handleConfigFileChange(configFilePath: string): Promise<void>;
+    private scheduleAutoUpload;
+    private runAutoUpload;
     start(): Promise<void>;
     stop(showProgress?: boolean): Promise<void>;
     uploadProject(): Promise<LocalDevProjectUploadResult>;
+    private performUpload;
     deployLatestBuild(force?: boolean): Promise<LocalDevProjectDeployResult>;
     addStateListener<K extends keyof LocalDevState>(key: K, listener: LocalDevStateListener<K>): void;
     sendDevServerMessage(message: LocalDevServerMessage): void;

package/lib/projects/localDev/LocalDevProcess.js

@@ -17,11 +17,15 @@ import { getLocalDevUiUrl } from '../urls.js';
 import { CONFIG_LOCAL_STATE_FLAGS, PROJECT_DEPLOY_STATES, } from '../../constants.js';
 import { lib } from '../../../lang/en.js';
 import { debugError } from '../../errorHandlers/index.js';
+const AUTO_UPLOAD_DEBOUNCE_MS = 2000;
 class LocalDevProcess {
     state;
     _logger;
     devServerManager;
     devSessionManager;
+    autoUploadTimeout = null;
+    pendingAutoUpload = false;
+    autoUploadStopped = false;
     constructor(options) {
         this.state = new LocalDevState(options);
         this._logger = new LocalDevLogger(this.state);
@@ -53,6 +57,27 @@ class LocalDevProcess {
     get logger() {
         return this._logger;
     }
+    get autoUploadEnabled() {
+        return this.state.autoUploadEnabled;
+    }
+    setAutoUploadEnabled(enabled) {
+        this.state.autoUploadEnabled = enabled;
+        this.logger.autoUploadToggled(enabled);
+        if (!enabled) {
+            if (this.autoUploadTimeout) {
+                clearTimeout(this.autoUploadTimeout);
+                this.autoUploadTimeout = null;
+            }
+            this.pendingAutoUpload = false;
+        }
+    }
+    get autoUploadAvailable() {
+        return this.isAutoDeployEnabled();
+    }
+    isAutoDeployEnabled() {
+        const { deployedBuild, latestBuild } = this.state.projectData;
+        return (deployedBuild ?? latestBuild)?.isAutoDeployEnabled ?? true;
+    }
     async setupDevServers() {
         try {
             await this.devServerManager.setup();
@@ -141,10 +166,52 @@ class LocalDevProcess {
         catch (e) {
             this.logger.fileChangeError(e);
         }
+        this.scheduleAutoUpload(filePath);
     }
-    async handleConfigFileChange() {
+    async handleConfigFileChange(configFilePath) {
         await this.updateProjectNodes();
-        this.logger.uploadWarning();
+        if (this.state.autoUploadEnabled) {
+            this.scheduleAutoUpload(configFilePath);
+        }
+        else {
+            this.logger.uploadWarning();
+        }
+    }
+    scheduleAutoUpload(changedPath) {
+        if (!this.state.autoUploadEnabled || this.autoUploadStopped) {
+            return;
+        }
+        this.logger.autoUploadScheduled(changedPath ?? 'project files');
+        if (this.autoUploadTimeout) {
+            clearTimeout(this.autoUploadTimeout);
+        }
+        this.autoUploadTimeout = setTimeout(() => {
+            this.autoUploadTimeout = null;
+            void this.runAutoUpload();
+        }, AUTO_UPLOAD_DEBOUNCE_MS);
+    }
+    async runAutoUpload() {
+        if (this.autoUploadStopped) {
+            return;
+        }
+        if (this.state.uploadInProgress) {
+            this.logger.autoUploadInProgress();
+            this.pendingAutoUpload = true;
+            return;
+        }
+        this.logger.autoUploadTriggered();
+        try {
+            await this.uploadProject();
+        }
+        catch (e) {
+            this.logger.uploadError(e);
+        }
+        finally {
+            if (this.pendingAutoUpload) {
+                this.pendingAutoUpload = false;
+                this.scheduleAutoUpload();
+            }
+        }
     }
     async start() {
         this.logger.resetSpinnies();
@@ -165,6 +232,12 @@ class LocalDevProcess {
         this.logger.monitorConsoleOutput();
     }
     async stop(showProgress = true) {
+        this.autoUploadStopped = true;
+        this.pendingAutoUpload = false;
+        if (this.autoUploadTimeout) {
+            clearTimeout(this.autoUploadTimeout);
+            this.autoUploadTimeout = null;
+        }
         if (showProgress) {
             this.logger.cleanupStart();
         }
@@ -182,6 +255,15 @@ class LocalDevProcess {
         return this.state.actions.exit(EXIT_CODES.SUCCESS);
     }
     async uploadProject() {
+        this.state.uploadInProgress = true;
+        try {
+            return await this.performUpload();
+        }
+        finally {
+            this.state.uploadInProgress = false;
+        }
+    }
+    async performUpload() {
         this.logger.uploadInitiated();
         const isUploadable = await this.projectConfigValidForUpload();
         if (!isUploadable) {

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

@@ -21,8 +21,10 @@ declare class LocalDevState {
     private _devServerMessage;
     private _uploadWarnings;
     private _devServersStarted;
+    private _autoUploadEnabled;
+    private _uploadInProgress;
     actions: LocalDevActions;
-    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectData, debug, initialProjectNodes, initialProjectProfileData, profile, env, actions, }: LocalDevStateConstructorOptions);
+    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectData, debug, initialProjectNodes, initialProjectProfileData, profile, env, actions, autoUploadEnabled, }: LocalDevStateConstructorOptions);
     private runListeners;
     get targetProjectAccountId(): number;
     get targetTestingAccountId(): number;
@@ -56,6 +58,10 @@ declare class LocalDevState {
     get uploadWarnings(): Set<string>;
     get devServersStarted(): boolean;
     set devServersStarted(started: boolean);
+    get autoUploadEnabled(): boolean;
+    set autoUploadEnabled(autoUploadEnabled: boolean);
+    get uploadInProgress(): boolean;
+    set uploadInProgress(inProgress: boolean);
     addUploadWarning(warning: string): void;
     clearUploadWarnings(): void;
     addListener<K extends keyof LocalDevState>(key: K, listener: LocalDevStateListener<K>): void;

package/lib/projects/localDev/LocalDevState.js

@@ -16,8 +16,10 @@ class LocalDevState {
     _devServerMessage;
     _uploadWarnings;
     _devServersStarted;
+    _autoUploadEnabled;
+    _uploadInProgress;
     actions;
-    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectData, debug, initialProjectNodes, initialProjectProfileData, profile, env, actions, }) {
+    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectData, debug, initialProjectNodes, initialProjectProfileData, profile, env, actions, autoUploadEnabled, }) {
         this._targetProjectAccountId = targetProjectAccountId;
         this._targetTestingAccountId = targetTestingAccountId;
         this._profile = profile;
@@ -33,6 +35,8 @@ class LocalDevState {
         this._devServerMessage = LOCAL_DEV_SERVER_MESSAGE_TYPES.INITIAL;
         this._uploadWarnings = new Set();
         this._devServersStarted = false;
+        this._autoUploadEnabled = autoUploadEnabled || false;
+        this._uploadInProgress = false;
         this.actions = actions;
         this._listeners = {};
     }
@@ -117,6 +121,20 @@ class LocalDevState {
         this._devServersStarted = started;
         this.runListeners('devServersStarted');
     }
+    get autoUploadEnabled() {
+        return this._autoUploadEnabled;
+    }
+    set autoUploadEnabled(autoUploadEnabled) {
+        this._autoUploadEnabled = autoUploadEnabled;
+        this.runListeners('autoUploadEnabled');
+    }
+    get uploadInProgress() {
+        return this._uploadInProgress;
+    }
+    set uploadInProgress(inProgress) {
+        this._uploadInProgress = inProgress;
+        this.runListeners('uploadInProgress');
+    }
     addUploadWarning(warning) {
         this.uploadWarnings.add(warning);
         this.runListeners('uploadWarnings');

package/lib/projects/localDev/LocalDevWatcher.js

@@ -16,7 +16,7 @@ class LocalDevWatcher {
     }
     handleWatchEvent(filePath, event, configPaths) {
         if (configPaths.includes(filePath)) {
-            return this.localDevProcess.handleConfigFileChange();
+            return this.localDevProcess.handleConfigFileChange(filePath);
         }
         return this.localDevProcess.handleFileChange(filePath, event);
     }

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

@@ -14,6 +14,7 @@ declare class LocalDevWebsocketServer {
     private setupAppDataListener;
     private setupUploadWarningsListener;
     private setupDevServersStartedListener;
+    private setupUploadInProgressListener;
     private setupStateListeners;
     start(): Promise<void>;
     shutdown(): void;

package/lib/projects/localDev/LocalDevWebsocketServer.js

@@ -1,7 +1,7 @@
 import { addLocalStateFlag } from '@hubspot/local-dev-lib/config';
 import { LOCAL_DEV_UI_MESSAGE_SEND_TYPES, LOCAL_DEV_SERVER_MESSAGE_TYPES, CONFIG_LOCAL_STATE_FLAGS, LOCAL_DEV_WEBSOCKET_SERVER_INSTANCE_ID, } from '../../constants.js';
 import { removeAnsiCodes } from '../../ui/removeAnsiCodes.js';
-import { isDeployWebsocketMessage, isViewedWelcomeScreenWebsocketMessage, isUploadWebsocketMessage, isAppInstallFailureWebsocketMessage, isAppInstallSuccessWebsocketMessage, isAppInstallInitiatedWebsocketMessage, } from './localDevWebsocketServerUtils.js';
+import { isDeployWebsocketMessage, isViewedWelcomeScreenWebsocketMessage, isUploadWebsocketMessage, isAppInstallFailureWebsocketMessage, isAppInstallSuccessWebsocketMessage, isAppInstallInitiatedWebsocketMessage, isSetAutoUploadWebsocketMessage, } from './localDevWebsocketServerUtils.js';
 import CLIWebSocketServer from '../../CLIWebSocketServer.js';
 const LOCAL_DEV_WEBSOCKET_SERVER_VERSION = 2;
 const LOG_PREFIX = '[LocalDevWebsocketServer]';
@@ -78,6 +78,12 @@ class LocalDevWebsocketServer {
             this.handleAppInstallInitiated();
             return true;
         }
+        else if (isSetAutoUploadWebsocketMessage(message)) {
+            if (this.localDevProcess.autoUploadAvailable) {
+                this.localDevProcess.setAutoUploadEnabled(message.data.enabled);
+            }
+            return true;
+        }
         return false;
     }
     sendProjectData(websocket) {
@@ -90,6 +96,9 @@ class LocalDevWebsocketServer {
                 deployedBuild: this.localDevProcess.projectData.deployedBuild,
                 targetProjectAccountId: this.localDevProcess.targetProjectAccountId,
                 targetTestingAccountId: this.localDevProcess.targetTestingAccountId,
+                autoUploadEnabled: this.localDevProcess.autoUploadAvailable
+                    ? this.localDevProcess.autoUploadEnabled
+                    : undefined,
             },
         });
     }
@@ -143,11 +152,24 @@ class LocalDevWebsocketServer {
             this.localDevProcess.removeStateListener('devServersStarted', listener);
         });
     }
+    setupUploadInProgressListener(websocket) {
+        const listener = (uploadInProgress) => {
+            this.cliWebSocketServer.sendMessage(websocket, {
+                type: LOCAL_DEV_UI_MESSAGE_SEND_TYPES.UPLOAD_IN_PROGRESS,
+                data: { uploadInProgress },
+            });
+        };
+        this.localDevProcess.addStateListener('uploadInProgress', listener);
+        websocket.on('close', () => {
+            this.localDevProcess.removeStateListener('uploadInProgress', listener);
+        });
+    }
     setupStateListeners(websocket) {
         this.setupProjectNodesListener(websocket);
         this.setupAppDataListener(websocket);
         this.setupUploadWarningsListener(websocket);
         this.setupDevServersStartedListener(websocket);
+        this.setupUploadInProgressListener(websocket);
     }
     async start() {
         await this.cliWebSocketServer.start({

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

@@ -1,7 +1,8 @@
-import { LocalDevDeployWebsocketMessage } from '../../../types/LocalDev.js';
+import { LocalDevDeployWebsocketMessage, LocalDevSetAutoUploadWebsocketMessage } from '../../../types/LocalDev.js';
 import { CLIWebSocketMessage } from '../../CLIWebSocketServer.js';
 export declare function isUploadWebsocketMessage(message: CLIWebSocketMessage): boolean;
 export declare function isDeployWebsocketMessage(message: CLIWebSocketMessage): message is LocalDevDeployWebsocketMessage;
+export declare function isSetAutoUploadWebsocketMessage(message: CLIWebSocketMessage): message is LocalDevSetAutoUploadWebsocketMessage;
 export declare function isViewedWelcomeScreenWebsocketMessage(message: CLIWebSocketMessage): boolean;
 export declare function isAppInstallSuccessWebsocketMessage(message: CLIWebSocketMessage): boolean;
 export declare function isAppInstallInitiatedWebsocketMessage(message: CLIWebSocketMessage): boolean;

package/lib/projects/localDev/localDevWebsocketServerUtils.js

@@ -5,6 +5,9 @@ export function isUploadWebsocketMessage(message) {
 export function isDeployWebsocketMessage(message) {
     return message.type === LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES.DEPLOY;
 }
+export function isSetAutoUploadWebsocketMessage(message) {
+    return message.type === LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES.SET_AUTO_UPLOAD;
+}
 export function isViewedWelcomeScreenWebsocketMessage(message) {
     return (message.type === LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES.VIEWED_WELCOME_SCREEN);
 }

package/lib/projects/release.js

@@ -60,7 +60,7 @@ export async function resolveBuildId(accountId, projectName, buildOption, force)
 export async function validateBuildForRelease(accountId, projectName, buildId) {
     try {
         const { data: build } = await getBuildStatus(accountId, projectName, buildId);
-        return meetsMinimumPlatformVersion(build.platformVersion, PLATFORM_VERSIONS.v2026_09_BETA);
+        return meetsMinimumPlatformVersion(build.platformVersion, PLATFORM_VERSIONS.v2027_03_BETA);
     }
     catch (e) {
         if (isSpecifiedError(e, { statusCode: 404 })) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/cli",
-    "version": "8.14.0-beta.0",
+    "version": "8.14.0-beta.1",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",
@@ -11,7 +11,7 @@
     ],
     "dependencies": {
         "@hubspot/local-dev-lib": "5.10.3",
-        "@hubspot/project-parsing-lib": "0.22.1",
+        "@hubspot/project-parsing-lib": "0.23.0",
         "@hubspot/ui-extensions-dev-server": "2.1.2",
         "@inquirer/prompts": "7.1.0",
         "@modelcontextprotocol/sdk": "1.29.0",

package/types/LocalDev.d.ts

@@ -25,6 +25,7 @@ export type LocalDevStateConstructorOptions = {
     initialProjectProfileData: HSProfileVariables;
     env: Environment;
     actions: LocalDevActions;
+    autoUploadEnabled?: boolean;
 };
 export type LocalDevDeployWebsocketMessage = {
     type: typeof LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES.DEPLOY;
@@ -32,6 +33,12 @@ export type LocalDevDeployWebsocketMessage = {
         force: boolean;
     };
 };
+export type LocalDevSetAutoUploadWebsocketMessage = {
+    type: typeof LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES.SET_AUTO_UPLOAD;
+    data: {
+        enabled: boolean;
+    };
+};
 export type LocalDevStateListener<K extends keyof LocalDevState> = (value: LocalDevState[K]) => void;
 export type AppLocalDevData = {
     id: number;

package/types/Yargs.d.ts

@@ -49,6 +49,7 @@ export type ProjectDevArgs = CommonArgs & ConfigArgs & EnvironmentArgs & {
     testingAccount?: string | number;
     projectAccount?: string | number;
     port?: number;
+    autoUpload?: boolean;
 };
 export type TestingArgs = {
     qa?: boolean;