@hubspot/cli 8.0.8-experimental.7 → 8.0.8-experimental.8

package/commands/cms/theme/preview.js

@@ -1,14 +1,16 @@
 import fs from 'fs';
 import path from 'path';
+import cliProgress from 'cli-progress';
 import { commands } from '../../../lang/en.js';
 import { getCwd } from '@hubspot/local-dev-lib/path';
+import { FILE_UPLOAD_RESULT_TYPES } from '@hubspot/local-dev-lib/constants/files';
 import { getThemeJSONPath } from '@hubspot/local-dev-lib/cms/themes';
-// Subprocess approach - don't import cms-dev-server directly to avoid React version conflicts
-// import { createDevServer } from '@hubspot/cms-dev-server';
-import { spawnDevServer } from '../../../lib/cms/devServerProcess.js';
+import { createDevServer } from '@hubspot/cms-dev-server';
+import { getUploadableFileList } from '../../../lib/upload.js';
 import { trackCommandUsage } from '../../../lib/usageTracking.js';
 import { previewPrompt, previewProjectPrompt, } from '../../../lib/prompts/previewPrompt.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
+import { ApiErrorContext, logError } from '../../../lib/errorHandlers/index.js';
 import { getProjectConfig } from '../../../lib/projects/config.js';
 import { findProjectComponents } from '../../../lib/projects/structure.js';
 import { ComponentTypes } from '../../../types/Projects.js';
@@ -71,16 +73,67 @@ async function determineSrcAndDest(args) {
 async function handler(args) {
     const { derivedAccountId, noSsl, resetSession, port, generateFieldsTypes } = args;
     const { absoluteSrc, dest } = await determineSrcAndDest(args);
+    const filePaths = await getUploadableFileList(absoluteSrc, false);
+    function startProgressBar(numFiles) {
+        const initialUploadProgressBar = new cliProgress.SingleBar({
+            gracefulExit: true,
+            format: '[{bar}] {percentage}% | {value}/{total} | {label}',
+            hideCursor: true,
+        }, cliProgress.Presets.rect);
+        initialUploadProgressBar.start(numFiles, 0, {
+            label: commands.cms.subcommands.theme.subcommands.preview
+                .initialUploadProgressBar.start,
+        });
+        let uploadsHaveStarted = false;
+        const uploadOptions = {
+            onAttemptCallback: () => {
+                /* Intentionally blank */
+            },
+            onSuccessCallback: () => {
+                initialUploadProgressBar.increment();
+                if (!uploadsHaveStarted) {
+                    uploadsHaveStarted = true;
+                    initialUploadProgressBar.update(0, {
+                        label: commands.cms.subcommands.theme.subcommands.preview
+                            .initialUploadProgressBar.uploading,
+                    });
+                }
+            },
+            onFirstErrorCallback: () => {
+                /* Intentionally blank */
+            },
+            onRetryCallback: () => {
+                /* Intentionally blank */
+            },
+            onFinalErrorCallback: () => initialUploadProgressBar.increment(),
+            onFinishCallback: (results) => {
+                initialUploadProgressBar.update(numFiles, {
+                    label: commands.cms.subcommands.theme.subcommands.preview
+                        .initialUploadProgressBar.finish,
+                });
+                initialUploadProgressBar.stop();
+                results.forEach(result => {
+                    if (result.resultType == FILE_UPLOAD_RESULT_TYPES.FAILURE) {
+                        uiLogger.error(commands.cms.subcommands.theme.subcommands.preview.errors.uploadFailed(result.file, dest));
+                        logError(result.error, new ApiErrorContext({
+                            accountId: derivedAccountId,
+                            request: dest,
+                            payload: result.file,
+                        }));
+                    }
+                });
+            },
+        };
+        return uploadOptions;
+    }
     trackCommandUsage('preview', {}, derivedAccountId);
-    // Spawn dev server as subprocess to isolate React versions
-    // Calls createDevServer as library function to support standalone themes
-    spawnDevServer({
-        absoluteSrc,
-        accountName: derivedAccountId?.toString(),
-        noSsl,
-        port,
-        generateFieldsTypes,
+    if (port) {
+        process.env['PORT'] = port.toString();
+    }
+    createDevServer(absoluteSrc, false, '', '', !noSsl, generateFieldsTypes, {
+        filePaths,
         resetSession: resetSession || false,
+        startProgressBar,
         dest,
     });
 }

package/lang/en.d.ts

@@ -43,6 +43,11 @@ export declare const commands: {
             checkOutConfig: (configPath: string) => string;
             pressEnterToInstall: (accountName: string) => string;
             pressKeyToExit: string;
+            installingApp: (appName: string, accountName: string) => string;
+            installInstructions: string;
+            browserFailedToOpen: (url: string) => string;
+            pollingTimeout: (minutes: number) => string;
+            pressEnterToContinueSetup: string;
             prompts: {
                 selectOptionV2: string;
                 options: {

package/lang/en.js

@@ -51,6 +51,11 @@ export const commands = {
             checkOutConfig: (configPath) => `Check out ${chalk.cyan(configPath)} for the full configuration.`,
             pressEnterToInstall: (accountName) => `? Press ${chalk.bold('<enter>')} to continue installing and previewing this app in ${chalk.bold(accountName)}`,
             pressKeyToExit: `Press any key to exit...`,
+            installingApp: (appName, accountName) => `Installing ${chalk.bold(appName)} in ${chalk.bold(accountName)}...`,
+            installInstructions: `We'll take you to your HubSpot account and walk you through installing your app.`,
+            browserFailedToOpen: (url) => `⚠️  Failed to open browser automatically. Please open this URL manually:\n${chalk.cyan(url)}`,
+            pollingTimeout: (minutes) => `⚠️  Installation polling timed out after ${minutes} minutes. The app may still be installing in the background.`,
+            pressEnterToContinueSetup: `Press ${chalk.bold('<enter>')} to continue with card setup...`,
             prompts: {
                 selectOptionV2: 'Choose a component type to get started',
                 options: {
@@ -3076,7 +3081,7 @@ export const lib = {
             updateSucceeded: (latestVersion) => `Successfully updated HubSpot CLI to version ${chalk.bold(latestVersion)}`,
             notInstalledGlobally: 'Cannot auto-update the HubSpot CLI because NPM is not installed globally',
             updateFailed: (latestVersion) => `Failed to update HubSpot CLI to version ${chalk.bold(latestVersion)}`,
-            enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun${uiCommandReference('hs config set --allow-auto-updates=true')}`,
+            enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun ${uiCommandReference('hs config set --allow-auto-updates=true')}`,
         },
     },
     projectProfiles: {

package/lib/__tests__/commandSuggestion.test.js

@@ -71,6 +71,8 @@ describe('lib/commandSuggestion', () => {
             // Create a mock yargs builder with strict method
             const mockYargsBuilder = {
                 strict: vi.fn().mockReturnThis(),
+                help: vi.fn().mockReturnThis(),
+                version: vi.fn().mockReturnThis(),
             };
             await commandModule.builder(mockYargsBuilder);
             expect(mockYargsBuilder.strict).toHaveBeenCalledWith(false);

package/lib/commandSuggestion.js

@@ -18,12 +18,6 @@ export const commandSuggestionMappings = {
     'theme generate-selectors': 'hs cms theme generate-selectors',
     'theme marketplace-validate': 'hs cms theme marketplace-validate',
     'theme preview': 'hs cms theme preview',
-    'custom-object schema create': 'hs custom-object create-schema',
-    'custom-object schema delete': 'hs custom-object delete-schema',
-    'custom-object schema fetch-all': 'hs custom-object fetch-all-schemas',
-    'custom-object schema fetch': 'hs custom-object fetch-schema',
-    'custom-object schema list': 'hs custom-object list-schemas',
-    'custom-object schema update': 'hs custom-object update-schema',
 };
 function createCommandSuggestionHandler(newCommand) {
     return () => {
@@ -35,7 +29,7 @@ function createCommandSuggestion(oldCommand, newCommand) {
     return {
         command: oldCommand,
         builder: async (yargs) => {
-            return yargs.strict(false);
+            return yargs.strict(false).help(false).version(false);
         },
         handler: createCommandSuggestionHandler(newCommand),
     };

package/lib/getStartedV2Actions.d.ts

@@ -35,3 +35,16 @@ export declare function uploadAndDeployAction({ accountId, projectDest, }: {
     projectDest: string;
 }): Promise<UploadAndDeployResult>;
 export declare function trackGetStartedUsage(params: Record<string, unknown>, accountId: number): Promise<void>;
+export type PollAppInstallationOptions = {
+    accountId: number;
+    projectId: number;
+    appUid: string;
+    requiredScopes?: string[];
+    optionalScopes?: string[];
+    timeoutMs?: number;
+    intervalMs?: number;
+    onTimeout?: () => void;
+};
+export declare function pollAppInstallation({ accountId, projectId, appUid, requiredScopes, optionalScopes, timeoutMs, // 2 minutes
+intervalMs, // 2 seconds
+onTimeout, }: PollAppInstallationOptions): Promise<void>;

package/lib/getStartedV2Actions.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { fetchPublicAppsForPortal } from '@hubspot/local-dev-lib/api/appsDev';
+import { fetchAppInstallationData } from '@hubspot/local-dev-lib/api/localDevAuth';
 import { fetchProject } from '@hubspot/local-dev-lib/api/projects';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
@@ -144,3 +145,55 @@ export async function uploadAndDeployAction({ accountId, projectDest, }) {
 export function trackGetStartedUsage(params, accountId) {
     return trackCommandMetadataUsage('get-started', params, accountId);
 }
+export async function pollAppInstallation({ accountId, projectId, appUid, requiredScopes = [], optionalScopes = [], timeoutMs = 2 * 60 * 1000, // 2 minutes
+intervalMs = 2000, // 2 seconds
+onTimeout, }) {
+    return new Promise((resolve, reject) => {
+        let consecutiveErrors = 0;
+        const MAX_CONSECUTIVE_ERRORS = 5;
+        let pollInterval = null;
+        let pollTimeout = null;
+        const cleanup = () => {
+            if (pollInterval) {
+                clearTimeout(pollInterval);
+                pollInterval = null;
+            }
+            if (pollTimeout) {
+                clearTimeout(pollTimeout);
+                pollTimeout = null;
+            }
+        };
+        pollTimeout = setTimeout(() => {
+            cleanup();
+            if (onTimeout) {
+                onTimeout();
+            }
+            resolve(); // Resolve instead of reject to allow continuing with timeout state
+        }, timeoutMs);
+        const poll = async () => {
+            try {
+                const { data } = await fetchAppInstallationData(accountId, projectId, appUid, requiredScopes, optionalScopes);
+                // Reset error counter on successful fetch
+                consecutiveErrors = 0;
+                if (data.isInstalledWithScopeGroups) {
+                    cleanup();
+                    resolve();
+                }
+                else if (pollInterval) {
+                    pollInterval = setTimeout(poll, intervalMs);
+                }
+            }
+            catch (error) {
+                consecutiveErrors++;
+                if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
+                    cleanup();
+                    reject(new Error(`Failed to check app installation status after ${MAX_CONSECUTIVE_ERRORS} consecutive errors`, { cause: error }));
+                }
+                else if (pollInterval !== null) {
+                    pollInterval = setTimeout(poll, intervalMs);
+                }
+            }
+        };
+        pollInterval = setTimeout(poll, 0);
+    });
+}

package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts

@@ -5,9 +5,26 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     addApp: z.ZodBoolean;
-    distribution: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
-    auth: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+    distribution: z.ZodOptional<z.ZodEnum<{
+        marketplace: "marketplace";
+        private: "private";
+    }>>;
+    auth: z.ZodOptional<z.ZodEnum<{
+        oauth: "oauth";
+        static: "static";
+    }>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        card: "card";
+        settings: "settings";
+        "app-event": "app-event";
+        page: "page";
+        "workflow-action-tool": "workflow-action-tool";
+        webhooks: "webhooks";
+        "workflow-action": "workflow-action";
+        "app-function": "app-function";
+        "app-object": "app-object";
+        scim: "scim";
+    }>>>;
 }, z.core.$strip>;
 export type AddFeatureInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class AddFeatureToProjectTool extends Tool<AddFeatureInputSchema> {

package/mcp-server/tools/project/AddFeatureToProjectTool.js

@@ -15,17 +15,13 @@ const inputSchema = {
         .boolean()
         .describe('Should an app be added?  If there is no app in the project, an app must be added to add a feature'),
     distribution: z
-        .optional(z.union([
-        z.literal(APP_DISTRIBUTION_TYPES.MARKETPLACE),
-        z.literal(APP_DISTRIBUTION_TYPES.PRIVATE),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. '),
+        .enum([APP_DISTRIBUTION_TYPES.MARKETPLACE, APP_DISTRIBUTION_TYPES.PRIVATE])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. ')
+        .optional(),
     auth: z
-        .optional(z.union([
-        z.literal(APP_AUTH_TYPES.STATIC),
-        z.literal(APP_AUTH_TYPES.OAUTH),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. '),
+        .enum([APP_AUTH_TYPES.STATIC, APP_AUTH_TYPES.OAUTH])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. ')
+        .optional(),
     features,
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/mcp-server/tools/project/CreateProjectTool.d.ts

@@ -5,10 +5,30 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteCurrentWorkingDirectory: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
     destination: z.ZodString;
-    projectBase: z.ZodUnion<readonly [z.ZodLiteral<"empty">, z.ZodLiteral<"app">]>;
-    distribution: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"marketplace">, z.ZodLiteral<"private">]>>;
-    auth: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"static">, z.ZodLiteral<"oauth">]>>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+    projectBase: z.ZodEnum<{
+        app: "app";
+        empty: "empty";
+    }>;
+    distribution: z.ZodOptional<z.ZodEnum<{
+        marketplace: "marketplace";
+        private: "private";
+    }>>;
+    auth: z.ZodOptional<z.ZodEnum<{
+        oauth: "oauth";
+        static: "static";
+    }>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        card: "card";
+        settings: "settings";
+        "app-event": "app-event";
+        page: "page";
+        "workflow-action-tool": "workflow-action-tool";
+        webhooks: "webhooks";
+        "workflow-action": "workflow-action";
+        "app-function": "app-function";
+        "app-object": "app-object";
+        scim: "scim";
+    }>>>;
 }, z.core.$strip>;
 export type CreateProjectInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class CreateProjectTool extends Tool<CreateProjectInputSchema> {

package/mcp-server/tools/project/CreateProjectTool.js

@@ -18,19 +18,14 @@ const inputSchema = {
         .string()
         .describe('DO NOT use the current directory unless the user has explicitly stated to do so. Relative path to the directory the project will be created in.'),
     projectBase: z
-        .union([z.literal(EMPTY_PROJECT), z.literal(PROJECT_WITH_APP)])
+        .enum([EMPTY_PROJECT, PROJECT_WITH_APP])
         .describe('Empty will create an empty project, and app will create a project with an app inside of it.'),
     distribution: z
-        .optional(z.union([
-        z.literal(APP_DISTRIBUTION_TYPES.MARKETPLACE),
-        z.literal(APP_DISTRIBUTION_TYPES.PRIVATE),
-    ]))
-        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. '),
+        .enum([APP_DISTRIBUTION_TYPES.MARKETPLACE, APP_DISTRIBUTION_TYPES.PRIVATE])
+        .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Private is used if you do not wish to distribute your app on the HubSpot marketplace. ')
+        .optional(),
     auth: z
-        .optional(z.union([
-        z.literal(APP_AUTH_TYPES.STATIC),
-        z.literal(APP_AUTH_TYPES.OAUTH),
-    ]))
+        .enum([APP_AUTH_TYPES.STATIC, APP_AUTH_TYPES.OAUTH])
         .describe('If not specified by the user, DO NOT choose for them.  This cannot be changed after a project is uploaded. Static uses a static non changing authentication token, and is only available for private distribution. ')
         .optional(),
     features,

package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js

@@ -12,18 +12,15 @@ const inputSchema = {
     absoluteCurrentWorkingDirectory,
     appId: z
         .string()
-        .regex(/^\d+$/, 'App ID must be a numeric string')
-        .describe('The numeric app ID as a string (e.g., "3003909"). Use get-apps-info to find available app IDs.'),
+        .describe('The numeric app ID as a string (e.g., "3003909"). Must contain only digits. Use get-apps-info to find available app IDs.'),
     startDate: z
         .string()
-        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
-        .optional()
-        .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
+        .describe('Start date for the usage patterns query in YYYY-MM-DD format (e.g., 2025-01-01).')
+        .optional(),
     endDate: z
         .string()
-        .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
-        .optional()
-        .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
+        .describe('End date for the usage patterns query in YYYY-MM-DD format (e.g., 2025-12-31).')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });

package/mcp-server/tools/project/GetBuildLogsTool.d.ts

@@ -5,12 +5,12 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     buildId: z.ZodNumber;
-    logLevel: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+    logLevel: z.ZodOptional<z.ZodEnum<{
         ERROR: "ERROR";
         WARN: "WARN";
         INFO: "INFO";
         ALL: "ALL";
-    }>>>;
+    }>>;
 }, z.core.$strip>;
 export type GetBuildLogsInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class GetBuildLogsTool extends Tool<GetBuildLogsInputSchema> {

package/mcp-server/tools/project/GetBuildLogsTool.js

@@ -18,9 +18,8 @@ const inputSchema = {
         .describe('Build ID to fetch logs for. Use get-build-status to find recent build IDs.'),
     logLevel: z
         .enum(['ERROR', 'WARN', 'INFO', 'ALL'])
-        .optional()
-        .default('ALL')
-        .describe('Filter logs by level. ERROR: Show only errors, WARN: Show only warnings, INFO: Show only info, ALL: Show all logs.'),
+        .describe('Filter logs by level. ERROR: Show only errors, WARN: Show only warnings, INFO: Show only info, ALL: Show all logs. Defaults to ALL if not specified.')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
@@ -85,14 +84,14 @@ export class GetBuildLogsTool extends Tool {
             if (allLogs.length === 0) {
                 return formatTextContents(absoluteCurrentWorkingDirectory, `No logs found for build #${buildId} in project '${projectName}'.`);
             }
-            const filteredLogs = filterLogsByLevel(allLogs, logLevel);
+            const resolvedLogLevel = logLevel || 'ALL';
+            const filteredLogs = filterLogsByLevel(allLogs, resolvedLogLevel);
             let output;
             if (filteredLogs.length === 0) {
-                // No logs match filter, show all logs instead
-                output = `No ${logLevel} level logs found for build #${buildId} in '${projectName}'.\nShowing all logs instead:\n\n${formatLogs(allLogs)}`;
+                output = `No ${resolvedLogLevel} level logs found for build #${buildId} in '${projectName}'.\nShowing all logs instead:\n\n${formatLogs(allLogs)}`;
             }
             else {
-                output = `Logs for build #${buildId} in '${projectName}' (${logLevel} level):\n\n${formatLogs(filteredLogs)}`;
+                output = `Logs for build #${buildId} in '${projectName}' (${resolvedLogLevel} level):\n\n${formatLogs(filteredLogs)}`;
             }
             return formatTextContents(absoluteCurrentWorkingDirectory, output);
         }

package/mcp-server/tools/project/GetBuildStatusTool.d.ts

@@ -5,7 +5,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
     absoluteProjectPath: z.ZodString;
     absoluteCurrentWorkingDirectory: z.ZodString;
     buildId: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type GetBuildStatusInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class GetBuildStatusTool extends Tool<GetBuildStatusInputSchema> {

package/mcp-server/tools/project/GetBuildStatusTool.js

@@ -19,9 +19,8 @@ const inputSchema = {
         .describe('Optional: Specific build ID to inspect. If omitted, shows recent builds to help identify the latest build.'),
     limit: z
         .number()
-        .optional()
-        .default(3)
-        .describe('Number of recent builds to fetch when buildId is not specified.'),
+        .describe('Number of recent builds to fetch when buildId is not specified. Defaults to 3 if not specified.')
+        .optional(),
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
@@ -127,7 +126,7 @@ export class GetBuildStatusTool extends Tool {
             }
             else {
                 const response = await fetchProjectBuilds(accountId, projectName, {
-                    limit,
+                    limit: limit || 3,
                 });
                 const { results } = response.data;
                 if (!results || results.length === 0) {

package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts

@@ -3,7 +3,12 @@ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.
 import { z } from 'zod';
 declare const inputSchemaZodObject: z.ZodObject<{
     absoluteCurrentWorkingDirectory: z.ZodString;
-    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"hs init">, z.ZodLiteral<"hs auth">, z.ZodLiteral<"hs project create">, z.ZodLiteral<"hs project upload">]>>;
+    command: z.ZodOptional<z.ZodEnum<{
+        "hs auth": "hs auth";
+        "hs project create": "hs project create";
+        "hs project upload": "hs project upload";
+        "hs init": "hs init";
+    }>>;
 }, z.core.$strip>;
 type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
 export declare class GuidedWalkthroughTool extends Tool<InputSchemaType> {

package/mcp-server/tools/project/GuidedWalkthroughTool.js

@@ -14,12 +14,7 @@ const nextCommands = {
 const inputSchema = {
     absoluteCurrentWorkingDirectory,
     command: z
-        .union([
-        z.literal('hs init'),
-        z.literal('hs auth'),
-        z.literal('hs project create'),
-        z.literal('hs project upload'),
-    ])
+        .enum(['hs init', 'hs auth', 'hs project create', 'hs project upload'])
         .describe('The command to learn more about.  Start with `hs init`')
         .optional(),
 };

package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js

@@ -1,5 +1,4 @@
 import { GetApiUsagePatternsByAppIdTool } from '../GetApiUsagePatternsByAppIdTool.js';
-import { z } from 'zod';
 import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { http } from '@hubspot/local-dev-lib/http';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
@@ -52,37 +51,6 @@ describe('mcp-server/tools/project/GetApiUsagePatternsByAppIdTool', () => {
             expect(result).toBe(mockRegisteredTool);
         });
     });
-    describe('input validation', () => {
-        const inputSchema = z.object({
-            appId: z
-                .string()
-                .describe('The application ID to get API usage patterns for.'),
-            startDate: z
-                .string()
-                .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
-                .optional()
-                .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
-            endDate: z
-                .string()
-                .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
-                .optional()
-                .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
-        });
-        it('should validate date format correctly', () => {
-            const validInput = {
-                appId: '12345',
-                startDate: '2025-01-01',
-                endDate: '2025-12-31',
-            };
-            const invalidInput = {
-                appId: '12345',
-                startDate: '2025-1-1',
-                endDate: '2025-12-31T00:00:00Z',
-            };
-            expect(() => inputSchema.parse(validInput)).not.toThrow();
-            expect(() => inputSchema.parse(invalidInput)).toThrow();
-        });
-    });
     describe('handler', () => {
         const input = {
             absoluteCurrentWorkingDirectory: '/test/dir',

package/mcp-server/tools/project/constants.d.ts

@@ -1,6 +1,17 @@
 import z from 'zod';
 export declare const absoluteProjectPath: z.ZodString;
 export declare const absoluteCurrentWorkingDirectory: z.ZodString;
-export declare const features: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"card">, z.ZodLiteral<"settings">, z.ZodLiteral<"app-function">, z.ZodLiteral<"webhooks">, z.ZodLiteral<"workflow-action">, z.ZodLiteral<"workflow-action-tool">, z.ZodLiteral<"app-object">, z.ZodLiteral<"app-event">, z.ZodLiteral<"scim">, z.ZodLiteral<"page">]>>>;
+export declare const features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    card: "card";
+    settings: "settings";
+    "app-event": "app-event";
+    page: "page";
+    "workflow-action-tool": "workflow-action-tool";
+    webhooks: "webhooks";
+    "workflow-action": "workflow-action";
+    "app-function": "app-function";
+    "app-object": "app-object";
+    scim: "scim";
+}>>>;
 export declare const docsSearchQuery: z.ZodString;
 export declare const docUrl: z.ZodString;

package/mcp-server/tools/project/constants.js

@@ -6,23 +6,19 @@ export const absoluteCurrentWorkingDirectory = z
     .string()
     .describe('The absolute path to the current working directory.');
 export const features = z
-    .array(z.union([
-    z.literal('card'),
-    z.literal('settings'),
-    z
-        .literal('app-function')
-        .describe('Also known as a public serverless function'),
-    z.literal('webhooks'),
-    z
-        .literal('workflow-action')
-        .describe('Also known as a custom workflow action.'),
-    z.literal('workflow-action-tool').describe('Also known as agent tools.'),
-    z.literal('app-object'),
-    z.literal('app-event'),
-    z.literal('scim'),
-    z.literal('page'),
+    .array(z.enum([
+    'card',
+    'settings',
+    'app-function',
+    'webhooks',
+    'workflow-action',
+    'workflow-action-tool',
+    'app-object',
+    'app-event',
+    'scim',
+    'page',
 ]))
-    .describe('The features to include in the project, multiple options can be selected')
+    .describe('The features to include in the project, multiple options can be selected. "app-function" is also known as a public serverless function. "workflow-action" is also known as a custom workflow action. "workflow-action-tool" is also known as agent tools.')
     .optional();
 export const docsSearchQuery = z
     .string()

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/cli",
-    "version": "8.0.8-experimental.7",
+    "version": "8.0.8-experimental.8",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",
@@ -30,6 +30,7 @@
         "open": "7.4.2",
         "p-queue": "8.1.0",
         "react": "19.2.3",
+        "react-dom": "19.2.3",
         "strip-ansi": "7.1.0",
         "table": "6.9.0",
         "tmp": "0.2.4",
@@ -119,6 +120,7 @@
         "registry": "https://registry.npmjs.org/"
     },
     "resolutions": {
-        "eslint-visitor-keys": "4.2.0"
+        "eslint-visitor-keys": "4.2.0",
+        "@hubspot/cms-dev-server/react": "18.3.1"
     }
 }

package/ui/components/getStarted/GetStartedFlow.js

@@ -1,12 +1,15 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { sanitizeFileName, untildify } from '@hubspot/local-dev-lib/path';
 import { useApp, useFocus, useInput } from 'ink';
+import open from 'open';
 import { useCallback, useEffect, useReducer } from 'react';
 import { commands } from '../../../lang/en.js';
-import { createProjectAction, trackGetStartedUsage, uploadAndDeployAction, } from '../../../lib/getStartedV2Actions.js';
+import { createProjectAction, pollAppInstallation, trackGetStartedUsage, uploadAndDeployAction, } from '../../../lib/getStartedV2Actions.js';
+import { validateProjectDirectory } from '../../../lib/prompts/projectNameAndDestPrompt.js';
 import { uiAccountDescription } from '../../../lib/ui/index.js';
 import { ACTION_STATUSES, GET_STARTED_FLOW_STEPS, } from '../../lib/constants.js';
 import { flowReducer } from './reducer.js';
+import { InstallationScreen } from './screens/InstallationScreen.js';
 import { ProjectSetupScreen } from './screens/ProjectSetupScreen.js';
 import { UploadScreen } from './screens/UploadScreen.js';
 import { getProject } from './selectors.js';
@@ -44,6 +47,7 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
         statuses: {
             create: initialName ? ACTION_STATUSES.RUNNING : ACTION_STATUSES.IDLE,
             upload: ACTION_STATUSES.IDLE,
+            installApp: ACTION_STATUSES.IDLE,
         },
     });
     const [state, dispatch] = useReducer(flowReducer, getInitialState());
@@ -68,6 +72,16 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
         dispatch({ type: 'SET_STEP', payload: GET_STARTED_FLOW_STEPS.DEST_INPUT });
     }, []);
     const handleDestSubmit = useCallback(async () => {
+        const validationResult = validateProjectDirectory(project.destination);
+        if (validationResult !== true) {
+            dispatch({
+                type: 'SET_DEST_ERROR',
+                payload: typeof validationResult === 'string'
+                    ? validationResult
+                    : commands.getStarted.v2.unknownError,
+            });
+            return;
+        }
         dispatch({ type: 'SET_STEP', payload: GET_STARTED_FLOW_STEPS.CREATING });
         try {
             await createProjectAction({
@@ -108,6 +122,57 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
             dispatch({ type: 'UPLOAD_ERROR', payload: errorMessage });
         }
     }, [derivedAccountId, project.destination]);
+    const handlePollInstallation = useCallback(async () => {
+        const uploadApp = project.uploadResult?.app;
+        const projectId = project.uploadResult?.projectId;
+        if (!projectId || !uploadApp?.uid) {
+            dispatch({
+                type: 'INSTALL_APP_ERROR',
+                payload: commands.getStarted.v2.unknownError,
+            });
+            return;
+        }
+        try {
+            await pollAppInstallation({
+                accountId: derivedAccountId,
+                projectId,
+                appUid: uploadApp.uid,
+                requiredScopes: uploadApp.config?.auth?.requiredScopes,
+                optionalScopes: uploadApp.config?.auth?.optionalScopes,
+                onTimeout: () => {
+                    dispatch({ type: 'SET_POLLING_TIMED_OUT', payload: true });
+                },
+            });
+            dispatch({ type: 'INSTALL_APP_DONE' });
+        }
+        catch (error) {
+            dispatch({
+                type: 'INSTALL_APP_ERROR',
+                payload: error instanceof Error
+                    ? error.message
+                    : commands.getStarted.v2.unknownError,
+            });
+        }
+    }, [project.uploadResult, derivedAccountId]);
+    const handleBrowserOpen = useCallback(async (shouldOpen) => {
+        await trackGetStartedUsage({
+            step: 'open-install-page',
+            type: shouldOpen ? 'opened' : 'declined',
+        }, derivedAccountId);
+        if (shouldOpen && project.uploadResult?.installUrl) {
+            try {
+                await open(project.uploadResult.installUrl, { url: true });
+            }
+            catch (error) {
+                dispatch({
+                    type: 'SET_BROWSER_FAILED_URL',
+                    payload: project.uploadResult.installUrl,
+                });
+            }
+        }
+        dispatch({ type: 'START_INSTALL_APP' });
+        await handlePollInstallation();
+    }, [project.uploadResult, derivedAccountId, handlePollInstallation]);
     const handleNameChange = useCallback((value) => {
         dispatch({ type: 'SET_PROJECT_NAME', payload: value });
     }, []);
@@ -116,7 +181,8 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
     }, []);
     useInput((_, key) => {
         const hasError = state.statuses.create === ACTION_STATUSES.ERROR ||
-            state.statuses.upload === ACTION_STATUSES.ERROR;
+            state.statuses.upload === ACTION_STATUSES.ERROR ||
+            state.statuses.installApp === ACTION_STATUSES.ERROR;
         if (hasError) {
             exit();
             return;
@@ -126,11 +192,22 @@ export function GetStartedFlow({ derivedAccountId, initialName, initialDest, })
         if (state.step === GET_STARTED_FLOW_STEPS.COMPLETE) {
             handleUploadStart();
         }
+        else if (state.step === GET_STARTED_FLOW_STEPS.OPEN_APP_PROMPT) {
+            handleBrowserOpen(true);
+        }
+        else if (state.step === GET_STARTED_FLOW_STEPS.INSTALLING_APP &&
+            state.statuses.installApp === ACTION_STATUSES.DONE) {
+            // Ready for card setup - will be handled in PR3
+            exit();
+        }
     });
     if (state.step === GET_STARTED_FLOW_STEPS.UPLOADING ||
         state.step === GET_STARTED_FLOW_STEPS.OPEN_APP_PROMPT) {
         return _jsx(UploadScreen, { state: state, accountName: accountName });
     }
+    if (state.step === GET_STARTED_FLOW_STEPS.INSTALLING_APP) {
+        return _jsx(InstallationScreen, { state: state, accountName: accountName });
+    }
     // Show project setup screen for initial flow
     return (_jsx(ProjectSetupScreen, { state: state, onSelectOption: handleSelect, onNameChange: handleNameChange, onNameSubmit: handleNameSubmit, onDestChange: handleDestChange, onDestSubmit: handleDestSubmit }));
 }

package/ui/components/getStarted/reducer.d.ts

@@ -14,6 +14,7 @@ export type AppState = {
 export type ActionStatuses = {
     create: ActionStatus;
     upload: ActionStatus;
+    installApp: ActionStatus;
 };
 export type FlowState = {
     step: FlowStep;
@@ -21,6 +22,9 @@ export type FlowState = {
     app: AppState;
     statuses: ActionStatuses;
     error?: string;
+    destError?: string;
+    browserFailedUrl?: string;
+    pollingTimedOut?: boolean;
 };
 type FlowAction = {
     type: 'SET_STEP';
@@ -37,6 +41,9 @@ type FlowAction = {
 } | {
     type: 'SET_ERROR';
     payload: string;
+} | {
+    type: 'SET_DEST_ERROR';
+    payload: string;
 } | {
     type: 'CLEAR_ERROR';
 } | {
@@ -54,6 +61,19 @@ type FlowAction = {
 } | {
     type: 'UPLOAD_ERROR';
     payload: string;
+} | {
+    type: 'START_INSTALL_APP';
+} | {
+    type: 'INSTALL_APP_DONE';
+} | {
+    type: 'INSTALL_APP_ERROR';
+    payload: string;
+} | {
+    type: 'SET_BROWSER_FAILED_URL';
+    payload: string;
+} | {
+    type: 'SET_POLLING_TIMED_OUT';
+    payload: boolean;
 };
 export declare function flowReducer(state: FlowState, action: FlowAction): FlowState;
 export {};

package/ui/components/getStarted/reducer.js

@@ -17,6 +17,13 @@ export function flowReducer(state, action) {
             return {
                 ...state,
                 project: { ...state.project, destination: action.payload },
+                destError: undefined,
+            };
+        case 'SET_DEST_ERROR':
+            return {
+                ...state,
+                step: GET_STARTED_FLOW_STEPS.DEST_INPUT,
+                destError: action.payload,
             };
         case 'SET_ERROR':
             return { ...state, error: action.payload };
@@ -66,6 +73,35 @@ export function flowReducer(state, action) {
                 statuses: { ...state.statuses, upload: ACTION_STATUSES.ERROR },
                 error: action.payload,
             };
+        case 'START_INSTALL_APP':
+            return {
+                ...state,
+                step: GET_STARTED_FLOW_STEPS.INSTALLING_APP,
+                statuses: { ...state.statuses, installApp: ACTION_STATUSES.RUNNING },
+                error: undefined,
+                pollingTimedOut: false,
+            };
+        case 'INSTALL_APP_DONE':
+            return {
+                ...state,
+                statuses: { ...state.statuses, installApp: ACTION_STATUSES.DONE },
+            };
+        case 'INSTALL_APP_ERROR':
+            return {
+                ...state,
+                statuses: { ...state.statuses, installApp: ACTION_STATUSES.ERROR },
+                error: action.payload,
+            };
+        case 'SET_BROWSER_FAILED_URL':
+            return {
+                ...state,
+                browserFailedUrl: action.payload,
+            };
+        case 'SET_POLLING_TIMED_OUT':
+            return {
+                ...state,
+                pollingTimedOut: action.payload,
+            };
         default:
             return state;
     }

package/ui/components/getStarted/screens/InstallationScreen.d.ts

@@ -0,0 +1,7 @@
+import { FlowState } from '../reducer.js';
+type InstallationScreenProps = {
+    state: FlowState;
+    accountName: string;
+};
+export declare function InstallationScreen({ state, accountName, }: InstallationScreenProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/ui/components/getStarted/screens/InstallationScreen.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { commands } from '../../../../lang/en.js';
+import { ActionSection } from '../../ActionSection.js';
+import { BoxWithTitle } from '../../BoxWithTitle.js';
+import { INK_COLORS } from '../../../styles.js';
+import { getProject } from '../selectors.js';
+import { ACTION_STATUSES, GET_STARTED_FLOW_STEPS, } from '../../../lib/constants.js';
+export function InstallationScreen({ state, accountName, }) {
+    const project = getProject(state);
+    const titleText = commands.getStarted.v2.startTitle;
+    // If we get to the installation screen, the app is uploaded and we have the name
+    const appName = project.uploadResult?.app?.config.name;
+    return (_jsx(BoxWithTitle, { flexGrow: 1, title: "hs get-started", borderColor: INK_COLORS.HUBSPOT_ORANGE, titleBackgroundColor: INK_COLORS.HUBSPOT_ORANGE, children: _jsxs(Box, { flexDirection: "column", rowGap: 1, children: [_jsx(Text, { bold: true, children: titleText }), _jsx(Text, { children: commands.getStarted.v2.installInstructions }), _jsx(ActionSection, { status: state.statuses.installApp, statusText: commands.getStarted.v2.installingApp(appName, accountName) }), state.browserFailedUrl && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(Text, { color: INK_COLORS.WARNING_YELLOW, children: commands.getStarted.v2.browserFailedToOpen(state.browserFailedUrl) }) })), state.pollingTimedOut && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(Text, { color: INK_COLORS.WARNING_YELLOW, children: commands.getStarted.v2.pollingTimeout(2) }) })), state.step === GET_STARTED_FLOW_STEPS.INSTALLING_APP &&
+                    state.statuses.installApp === ACTION_STATUSES.DONE && (_jsx(Text, { children: commands.getStarted.v2.pressEnterToContinueSetup }))] }) }));
+}

package/ui/components/getStarted/screens/ProjectSetupScreen.js

@@ -35,5 +35,6 @@ export function ProjectSetupScreen({ state, onSelectOption, onNameChange, onName
     return (_jsx(BoxWithTitle, { flexGrow: 1, title: "hs get-started", borderColor: INK_COLORS.HUBSPOT_ORANGE, titleBackgroundColor: INK_COLORS.HUBSPOT_ORANGE, children: _jsxs(Box, { flexDirection: "column", rowGap: 1, children: [_jsx(Text, { bold: true, children: titleText }), state.step === GET_STARTED_FLOW_STEPS.SELECT ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: overviewText }), _jsx(Text, { children: projectsText }), _jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: selectPrompt })] }), _jsx(SelectInput, { items: GET_STARTED_FLOW_OPTIONS, onSelect: onSelectOption })] })) : (_jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: `${selectPrompt}` }), _jsx(Text, { color: INK_COLORS.INFO_BLUE, children: state.app.selectedLabel })] })), _jsxs(ActionSection, { status: state.statuses.create, statusText: runningProjectCreateText, errorMessage: state.statuses.create === ACTION_STATUSES.ERROR
                         ? `${state.error}\n\n${commands.getStarted.v2.pressKeyToExit}`
                         : undefined, children: [state.step !== GET_STARTED_FLOW_STEPS.SELECT && (_jsx(InputField, { flag: "name", prompt: "Enter your project name", value: project.name, isEditing: state.step === GET_STARTED_FLOW_STEPS.NAME_INPUT, onChange: onNameChange, onSubmit: onNameSubmit })), state.step !== GET_STARTED_FLOW_STEPS.SELECT &&
-                            state.step !== GET_STARTED_FLOW_STEPS.NAME_INPUT && (_jsx(InputField, { flag: "dest", prompt: "Choose where to create the project", value: project.destination, isEditing: state.step === GET_STARTED_FLOW_STEPS.DEST_INPUT, onChange: onDestChange, onSubmit: onDestSubmit }))] }), state.step === GET_STARTED_FLOW_STEPS.COMPLETE && (_jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: commands.getStarted.v2.pressEnterToContinueDeploy(state.app.selectedLabel) })] }))] }) }));
+                            state.step !== GET_STARTED_FLOW_STEPS.NAME_INPUT && (_jsxs(_Fragment, { children: [_jsx(InputField, { flag: "dest", prompt: "Choose where to create the project", value: project.destination, isEditing: state.step === GET_STARTED_FLOW_STEPS.DEST_INPUT, onChange: onDestChange, onSubmit: onDestSubmit }), state.destError &&
+                                    state.step === GET_STARTED_FLOW_STEPS.DEST_INPUT && (_jsx(Text, { color: INK_COLORS.ALERT_RED, children: state.destError }))] }))] }), state.step === GET_STARTED_FLOW_STEPS.COMPLETE && (_jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 1, children: [_jsx(Text, { color: INK_COLORS.HUBSPOT_TEAL, children: "?" }), _jsx(Text, { children: commands.getStarted.v2.pressEnterToContinueDeploy(state.app.selectedLabel) })] }))] }) }));
 }

package/ui/lib/constants.d.ts

@@ -12,5 +12,6 @@ export declare const GET_STARTED_FLOW_STEPS: {
     readonly INSTALLING: "installing";
     readonly UPLOADING: "uploading";
     readonly OPEN_APP_PROMPT: "open-app-prompt";
+    readonly INSTALLING_APP: "installing-app";
     readonly COMPLETE: "complete";
 };

package/ui/lib/constants.js

@@ -12,5 +12,6 @@ export const GET_STARTED_FLOW_STEPS = {
     INSTALLING: 'installing',
     UPLOADING: 'uploading',
     OPEN_APP_PROMPT: 'open-app-prompt',
+    INSTALLING_APP: 'installing-app',
     COMPLETE: 'complete',
 };

package/lib/cms/devServerProcess.d.ts

@@ -1,13 +0,0 @@
-import { ChildProcess } from 'child_process';
-interface DevServerOptions {
-    absoluteSrc: string;
-    accountName?: string;
-    configPath?: string;
-    noSsl?: boolean;
-    port?: number;
-    generateFieldsTypes?: boolean;
-    resetSession?: boolean;
-    dest?: string;
-}
-export declare function spawnDevServer(options: DevServerOptions): ChildProcess;
-export {};

package/lib/cms/devServerProcess.js

@@ -1,122 +0,0 @@
-import { spawn } from 'child_process';
-export function spawnDevServer(options) {
-    const { absoluteSrc, accountName, noSsl, port, generateFieldsTypes, resetSession, dest, } = options;
-    // Build a Node script that imports and calls createDevServer
-    // This bypasses the CLI's project directory requirement while still isolating React versions
-    const script = `
-    const { createDevServer } = await import('@hubspot/cms-dev-server');
-    const { walk } = await import('@hubspot/local-dev-lib/fs');
-    const { createIgnoreFilter } = await import('@hubspot/local-dev-lib/ignoreRules');
-    const { isAllowedExtension } = await import('@hubspot/local-dev-lib/path');
-    const { FILE_UPLOAD_RESULT_TYPES } = await import('@hubspot/local-dev-lib/constants/files');
-    const cliProgress = (await import('cli-progress')).default;
-
-    ${dest
-        ? `
-    // Get uploadable files for preview (inlined from lib/upload.ts)
-    let filePaths = [];
-    try {
-      filePaths = await walk(${JSON.stringify(absoluteSrc)});
-    } catch (e) {
-      console.error('Error walking directory:', e);
-    }
-    filePaths = filePaths
-      .filter(file => isAllowedExtension(file))
-      .filter(createIgnoreFilter(false));
-
-    // Create progress bar for initial upload
-    function startProgressBar(numFiles) {
-      const initialUploadProgressBar = new cliProgress.SingleBar(
-        {
-          gracefulExit: true,
-          format: '[{bar}] {percentage}% | {value}/{total} | {label}',
-          hideCursor: true,
-        },
-        cliProgress.Presets.rect
-      );
-      initialUploadProgressBar.start(numFiles, 0, {
-        label: 'Preparing upload...',
-      });
-      let uploadsHaveStarted = false;
-      return {
-        onAttemptCallback: () => {},
-        onSuccessCallback: () => {
-          initialUploadProgressBar.increment();
-          if (!uploadsHaveStarted) {
-            uploadsHaveStarted = true;
-            initialUploadProgressBar.update(0, {
-              label: 'Uploading files...',
-            });
-          }
-        },
-        onFirstErrorCallback: () => {},
-        onRetryCallback: () => {},
-        onFinalErrorCallback: () => initialUploadProgressBar.increment(),
-        onFinishCallback: (results) => {
-          initialUploadProgressBar.update(numFiles, {
-            label: 'Upload complete',
-          });
-          initialUploadProgressBar.stop();
-          results.forEach(result => {
-            if (result.resultType == FILE_UPLOAD_RESULT_TYPES.FAILURE) {
-              console.error(\`Failed to upload \${result.file}\`);
-            }
-          });
-        },
-      };
-    }
-
-    const themePreviewOptions = {
-      filePaths,
-      startProgressBar,
-      resetSession: ${Boolean(resetSession)},
-      dest: ${JSON.stringify(dest)},
-    };
-    `
-        : 'const themePreviewOptions = undefined;'}
-
-    createDevServer(
-      ${JSON.stringify(absoluteSrc)},
-      false, // storybook
-      '', // config (uses env var HUBSPOT_CONFIG_PATH)
-      ${JSON.stringify(accountName || '')},
-      ${!noSsl}, // sslEnabled
-      ${Boolean(generateFieldsTypes)}, // fieldGenEnabled
-      themePreviewOptions
-    );
-  `;
-    // Set environment variables
-    const env = { ...process.env };
-    if (port) {
-        env.PORT = port.toString();
-    }
-    // Spawn Node with the inline script
-    const devServer = spawn('node', ['--input-type=module', '-e', script], {
-        stdio: 'inherit',
-        env,
-        cwd: absoluteSrc,
-    });
-    // Handle process events
-    devServer.on('error', error => {
-        console.error('Failed to start dev server:', error);
-        process.exit(1);
-    });
-    devServer.on('exit', (code, signal) => {
-        if (code !== 0 && code !== null) {
-            console.error(`Dev server exited with code ${code}`);
-            process.exit(code);
-        }
-        if (signal) {
-            console.error(`Dev server killed with signal ${signal}`);
-            process.exit(1);
-        }
-    });
-    // Handle CLI termination
-    process.on('SIGINT', () => {
-        devServer.kill('SIGINT');
-    });
-    process.on('SIGTERM', () => {
-        devServer.kill('SIGTERM');
-    });
-    return devServer;
-}