@hubspot/cli 8.10.0 → 8.12.0-beta.0

package/lib/mcp/setup.js

@@ -32,8 +32,9 @@ const defaultMcpCommand = {
     command: 'hs',
     args: ['mcp', 'start'],
 };
-export async function configureMcpServer(targets) {
+export async function configureMcpServer(options) {
     try {
+        const { targets, standalone, cliVersion: cliVersionFlag } = options;
         let derivedTargets = [];
         if (!targets || targets.length === 0) {
             const { selectedTargets } = await promptUser({
@@ -52,23 +53,33 @@ export async function configureMcpServer(targets) {
         else {
             derivedTargets = targets;
         }
-        // Prompt for standalone mode
-        const { useStandaloneMode } = await promptUser({
-            name: 'useStandaloneMode',
-            type: 'confirm',
-            message: commands.mcp.setup.prompts.standaloneMode,
-            default: false,
-        });
-        const { cliVersion } = useStandaloneMode
-            ? await promptUser({
-                name: 'cliVersion',
-                type: 'input',
-                message: commands.mcp.setup.prompts.cliVersion,
-                validate: (v) => !v || /^[\d]+\.[\d]+\.[\d]+([-+][\w.]+)?$/.test(v.trim())
-                    ? true
-                    : 'Please enter a valid semver version (e.g. 8.0.1) or leave blank for latest.',
-            })
-            : { cliVersion: '' };
+        let useStandaloneMode = standalone;
+        if (useStandaloneMode === undefined) {
+            const response = await promptUser({
+                name: 'useStandaloneMode',
+                type: 'confirm',
+                message: commands.mcp.setup.prompts.standaloneMode,
+                default: false,
+            });
+            useStandaloneMode = response.useStandaloneMode;
+        }
+        let cliVersion = '';
+        if (useStandaloneMode) {
+            if (cliVersionFlag !== undefined) {
+                cliVersion = cliVersionFlag;
+            }
+            else {
+                const response = await promptUser({
+                    name: 'cliVersion',
+                    type: 'input',
+                    message: commands.mcp.setup.prompts.cliVersion,
+                    validate: (v) => !v || /^[\d]+\.[\d]+\.[\d]+([-+][\w.]+)?$/.test(v.trim())
+                        ? true
+                        : 'Please enter a valid semver version (e.g. 8.0.1) or leave blank for latest.',
+                });
+                cliVersion = response.cliVersion;
+            }
+        }
         const cliPackage = cliVersion
             ? `@hubspot/cli@${cliVersion}`
             : '@hubspot/cli';

package/lib/projects/builds.d.ts

@@ -0,0 +1,2 @@
+import { type Build } from '@hubspot/local-dev-lib/types/Build';
+export declare function getLastSuccessfulBuild(accountId: number, projectName: string, latestBuild?: Build): Promise<Build | undefined>;

package/lib/projects/builds.js

@@ -0,0 +1,22 @@
+import { fetchProjectBuilds } from '@hubspot/local-dev-lib/api/projects';
+import { BUILD_STATUS } from '@hubspot/local-dev-lib/enums/build';
+export async function getLastSuccessfulBuild(accountId, projectName, latestBuild) {
+    if (latestBuild?.status === BUILD_STATUS.SUCCESS) {
+        return latestBuild;
+    }
+    let after;
+    let hasMore = true;
+    while (hasMore) {
+        const { data: { results, paging }, } = await fetchProjectBuilds(accountId, projectName, {
+            limit: 100,
+            ...(after ? { after } : {}),
+        });
+        const successfulBuild = results.find(build => build.status === BUILD_STATUS.SUCCESS);
+        if (successfulBuild) {
+            return successfulBuild;
+        }
+        after = paging?.next?.after;
+        hasMore = !!after;
+    }
+    return undefined;
+}

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

@@ -2,11 +2,11 @@ import LocalDevLogger from './LocalDevLogger.js';
 import { ExitFunction } from '../../../types/Yargs.js';
 type DevSessionManagerConstructorOptions = {
     targetTestingAccountId: number;
-    localDevLogger?: LocalDevLogger;
+    localDevLogger: LocalDevLogger;
     exit: ExitFunction;
 };
 declare class DevSessionManager {
-    localDevLogger?: LocalDevLogger;
+    localDevLogger: LocalDevLogger;
     targetTestingAccountId: number;
     protected devSessionId: number | undefined;
     private heartbeatInterval;

package/lib/projects/localDev/DevSessionManager.js

@@ -1,9 +1,7 @@
 import { getActiveServers } from '@hubspot/local-dev-lib/portManager';
 import { devSessionHeartbeat, registerDevSession, deleteDevSession, } from './helpers/devSessionsApi.js';
 import { EXIT_CODES } from '../../enums/exitCodes.js';
-import { uiLogger } from '../../ui/logger.js';
 import { lib } from '../../../lang/en.js';
-import { getErrorMessage } from '../../errorHandlers/index.js';
 class DevSessionManager {
     localDevLogger;
     targetTestingAccountId;
@@ -21,13 +19,7 @@ class DevSessionManager {
     }
     validateSessionIdExists() {
         if (!this.devSessionId) {
-            if (this.localDevLogger) {
-                this.localDevLogger.devSessionMissingSessionIdError();
-            }
-            else {
-                // Fallback for deprecated local dev manager
-                uiLogger.error(lib.LocalDevManager.devSession.missingSessionIdError);
-            }
+            this.localDevLogger.devSessionMissingSessionIdError();
             throw new Error(lib.LocalDevManager.devSession.missingSessionIdError);
         }
     }
@@ -39,13 +31,7 @@ class DevSessionManager {
             this.devSessionId = registerDevSessionResponse.data.sessionId;
         }
         catch (e) {
-            if (this.localDevLogger) {
-                this.localDevLogger.devSessionRegistrationError(e);
-            }
-            else {
-                // Fallback for deprecated local dev manager
-                uiLogger.error(lib.LocalDevManager.devSession.registrationError(getErrorMessage(e)));
-            }
+            this.localDevLogger.devSessionRegistrationError(e);
             return false;
         }
         try {
@@ -73,13 +59,7 @@ class DevSessionManager {
                     this.heartbeatRetries++;
                     return;
                 }
-                if (this.localDevLogger) {
-                    this.localDevLogger.devSessionHeartbeatError(e);
-                }
-                else {
-                    // Fallback for deprecated local dev manager
-                    uiLogger.error(lib.LocalDevManager.devSession.heartbeatError(getErrorMessage(e)));
-                }
+                this.localDevLogger.devSessionHeartbeatError(e);
                 return this.exit(EXIT_CODES.ERROR);
             }
         }, 30000);
@@ -91,13 +71,7 @@ class DevSessionManager {
                 await deleteDevSession(this.targetTestingAccountId, this.devSessionId);
             }
             catch (e) {
-                if (this.localDevLogger) {
-                    this.localDevLogger.devSessionDeletionError(e);
-                }
-                else {
-                    // Fallback for deprecated local dev manager
-                    uiLogger.error(lib.LocalDevManager.devSession.deletionError(getErrorMessage(e)));
-                }
+                this.localDevLogger.devSessionDeletionError(e);
                 return false;
             }
         }

package/lib/projects/localDev/helpers/account.d.ts

@@ -1,13 +1,6 @@
 import { HubSpotConfigAccount } from '@hubspot/local-dev-lib/types/Accounts';
 import { Environment } from '@hubspot/local-dev-lib/types/Accounts';
 import { DeveloperTestAccount } from '@hubspot/local-dev-lib/types/developerTestAccounts.js';
-import { ProjectDevTargetAccountPromptResponse } from '../../../prompts/projectDevTargetAccountPrompt.js';
-import { ExitFunction } from '../../../../types/Yargs.js';
-export declare function confirmDefaultAccountIsTarget(accountConfig: HubSpotConfigAccount, exit: ExitFunction): Promise<void>;
-export declare function checkIfDefaultAccountIsSupported(accountConfig: HubSpotConfigAccount, hasPublicApps: boolean, exit: ExitFunction): Promise<void>;
-export declare function checkIfParentAccountIsAuthed(accountConfig: HubSpotConfigAccount): void;
-export declare function checkIfAccountFlagIsSupported(accountConfig: HubSpotConfigAccount, hasPublicApps: boolean): void;
-export declare function suggestRecommendedNestedAccount(accounts: HubSpotConfigAccount[], accountConfig: HubSpotConfigAccount, hasPublicApps: boolean): Promise<ProjectDevTargetAccountPromptResponse>;
 export declare function createSandboxForLocalDev(accountId: number, accountConfig: HubSpotConfigAccount, env: Environment): Promise<number>;
 export declare function createDeveloperTestAccountForLocalDev(accountId: number, accountConfig: HubSpotConfigAccount, env: Environment, useV2?: boolean): Promise<number>;
 export declare function useExistingDevTestAccount(env: Environment, account: DeveloperTestAccount): Promise<boolean>;

package/lib/projects/localDev/helpers/account.js

@@ -1,5 +1,3 @@
-import { HUBSPOT_ACCOUNT_TYPE_STRINGS } from '@hubspot/local-dev-lib/constants/config';
-import { getConfigAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
 import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
 import { isMissingScopeError } from '@hubspot/local-dev-lib/errors/index';
@@ -7,15 +5,6 @@ import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constant
 import { getSandboxUsageLimits } from '@hubspot/local-dev-lib/api/sandboxHubs';
 import { uiLogger } from '../../../ui/logger.js';
 import { lib } from '../../../../lang/en.js';
-import { EXIT_CODES } from '../../../enums/exitCodes.js';
-import { confirmDefaultAccountPrompt } from '../../../prompts/projectDevTargetAccountPrompt.js';
-import { isUnifiedAccount } from '../../../accountTypes.js';
-import { isAppDeveloperAccount } from '../../../accountTypes.js';
-import { isDeveloperTestAccount } from '../../../accountTypes.js';
-import { uiAccountDescription } from '../../../ui/index.js';
-import { uiLine } from '../../../ui/index.js';
-import { selectDeveloperTestTargetAccountPrompt } from '../../../prompts/projectDevTargetAccountPrompt.js';
-import { selectSandboxTargetAccountPrompt } from '../../../prompts/projectDevTargetAccountPrompt.js';
 import { validateSandboxUsageLimits } from '../../../sandboxes.js';
 import { logError } from '../../../errorHandlers/index.js';
 import { hubspotAccountNamePrompt } from '../../../prompts/accountNamePrompt.js';
@@ -25,73 +14,6 @@ import { buildDeveloperTestAccount, saveAccountToConfig, buildV2Sandbox, } from
 import { debugError } from '../../../errorHandlers/index.js';
 import { listPrompt } from '../../../prompts/promptUtils.js';
 import { confirmUseExistingDeveloperTestAccountPrompt } from '../../../prompts/projectDevTargetAccountPrompt.js';
-// If the user passed in the --account flag, confirm they want to use that account as
-// their target account, otherwise exit
-export async function confirmDefaultAccountIsTarget(accountConfig, exit) {
-    if (!accountConfig.name || !accountConfig.accountType) {
-        uiLogger.error(lib.localDevHelpers.account.confirmDefaultAccountIsTarget.configError);
-        return exit(EXIT_CODES.ERROR);
-    }
-    uiLogger.log('');
-    const useDefaultAccount = await confirmDefaultAccountPrompt(accountConfig.name, HUBSPOT_ACCOUNT_TYPE_STRINGS[accountConfig.accountType]);
-    if (!useDefaultAccount) {
-        uiLogger.log(lib.localDevHelpers.account.confirmDefaultAccountIsTarget
-            .declineDefaultAccountExplanation);
-        return exit(EXIT_CODES.SUCCESS);
-    }
-}
-// Confirm the default account is supported for the type of apps being developed
-export async function checkIfDefaultAccountIsSupported(accountConfig, hasPublicApps, exit) {
-    const defaultAccountIsUnified = await isUnifiedAccount(accountConfig);
-    if (hasPublicApps &&
-        !(isAppDeveloperAccount(accountConfig) ||
-            isDeveloperTestAccount(accountConfig) ||
-            defaultAccountIsUnified)) {
-        uiLogger.error(lib.localDevHelpers.account.checkIfDefaultAccountIsSupported.publicApp);
-        return exit(EXIT_CODES.SUCCESS);
-    }
-    else if (!hasPublicApps && isAppDeveloperAccount(accountConfig)) {
-        uiLogger.error(lib.localDevHelpers.account.checkIfDefaultAccountIsSupported.privateApp);
-        return exit(EXIT_CODES.SUCCESS);
-    }
-}
-export function checkIfParentAccountIsAuthed(accountConfig) {
-    if (!accountConfig.parentAccountId ||
-        !getConfigAccountIfExists(accountConfig.parentAccountId)?.accountId) {
-        throw new Error(lib.localDevHelpers.account.checkIfParentAccountIsAuthed.notAuthedError(accountConfig.parentAccountId || '', uiAccountDescription(accountConfig.accountId)));
-    }
-}
-// Confirm the default account is a developer account if developing public apps
-export function checkIfAccountFlagIsSupported(accountConfig, hasPublicApps) {
-    if (hasPublicApps) {
-        if (!isDeveloperTestAccount(accountConfig)) {
-            throw new Error(lib.localDevHelpers.account.validateAccountOption
-                .invalidPublicAppAccount);
-        }
-        checkIfParentAccountIsAuthed(accountConfig);
-    }
-    else if (isAppDeveloperAccount(accountConfig)) {
-        throw new Error(lib.localDevHelpers.account.validateAccountOption.invalidPrivateAppAccount);
-    }
-}
-// If the user isn't using the recommended account type, prompt them to use or create one
-export async function suggestRecommendedNestedAccount(accounts, accountConfig, hasPublicApps) {
-    uiLogger.log('');
-    uiLine();
-    if (hasPublicApps) {
-        uiLogger.log(lib.localDevHelpers.account.validateAccountOption
-            .publicAppNonDeveloperTestAccountWarning);
-    }
-    else {
-        uiLogger.log(lib.localDevHelpers.account.validateAccountOption.nonSandboxWarning);
-    }
-    uiLine();
-    uiLogger.log('');
-    const targetAccountPrompt = hasPublicApps
-        ? selectDeveloperTestTargetAccountPrompt
-        : selectSandboxTargetAccountPrompt;
-    return targetAccountPrompt(accounts, accountConfig);
-}
 // Create a new sandbox and return its accountId
 export async function createSandboxForLocalDev(accountId, accountConfig, env) {
     try {
@@ -166,8 +88,7 @@ export async function useExistingDevTestAccount(env, account) {
     const useExistingDevTestAcct = await confirmUseExistingDeveloperTestAccountPrompt(account);
     if (!useExistingDevTestAcct) {
         uiLogger.log('');
-        uiLogger.log(lib.localDevHelpers.account.confirmDefaultAccountIsTarget
-            .declineDefaultAccountExplanation);
+        uiLogger.log(lib.localDevHelpers.account.declineDefaultAccountExplanation);
         uiLogger.log('');
         return false;
     }

package/lib/projects/release.d.ts

@@ -0,0 +1,4 @@
+import { type Release } from '../../api/releases.js';
+export declare function resolveBuildId(accountId: number, projectName: string, buildOption?: number, force?: boolean): Promise<number | null | undefined>;
+export declare function validateBuildForRelease(accountId: number, projectName: string, buildId: number): Promise<boolean>;
+export declare function executeRelease(accountId: number, projectName: string, buildId: number): Promise<Release>;

package/lib/projects/release.js

@@ -0,0 +1,90 @@
+import chalk from 'chalk';
+import { fetchProjectBuilds, getBuildStatus, } from '@hubspot/local-dev-lib/api/projects';
+import { BUILD_STATUS } from '@hubspot/local-dev-lib/enums/build';
+import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
+import { meetsMinimumPlatformVersion } from '@hubspot/project-parsing-lib/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
+import { getLastSuccessfulBuild } from './builds.js';
+import { logError, ApiErrorContext } from '../errorHandlers/index.js';
+import { uiLogger } from '../ui/logger.js';
+import { listPrompt } from '../prompts/promptUtils.js';
+import { commands } from '../../lang/en.js';
+import { createRelease } from '../../api/releases.js';
+function buildChoiceName(build) {
+    const base = build.uploadMessage
+        ? `${build.buildId} — ${build.uploadMessage}`
+        : `${build.buildId} — ${commands.project.release.create.noUploadMessage}`;
+    return build.status !== BUILD_STATUS.SUCCESS
+        ? `[${chalk.yellow('DISABLED')}] ${base}`
+        : base;
+}
+export async function resolveBuildId(accountId, projectName, buildOption, force) {
+    if (buildOption) {
+        return buildOption;
+    }
+    if (force) {
+        const lastSuccessful = await getLastSuccessfulBuild(accountId, projectName);
+        return lastSuccessful ? lastSuccessful.buildId : null;
+    }
+    let results;
+    try {
+        ({
+            data: { results },
+        } = await fetchProjectBuilds(accountId, projectName));
+    }
+    catch (e) {
+        if (isSpecifiedError(e, { statusCode: 404 }) ||
+            isSpecifiedError(e, { statusCode: 400 })) {
+            return undefined;
+        }
+        throw e;
+    }
+    if (results.length === 0) {
+        return undefined;
+    }
+    const lastSuccessful = await getLastSuccessfulBuild(accountId, projectName);
+    if (!lastSuccessful) {
+        uiLogger.error(commands.project.release.create.errors.noSuccessfulBuilds(projectName));
+        return null;
+    }
+    return listPrompt(commands.project.release.create.buildIdPrompt, {
+        choices: results.map(b => ({
+            name: buildChoiceName(b),
+            value: b.buildId,
+            disabled: b.status !== BUILD_STATUS.SUCCESS
+                ? `– ${commands.project.release.create.buildStatus[b.status] ?? b.status}`
+                : undefined,
+        })),
+    });
+}
+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);
+    }
+    catch (e) {
+        if (isSpecifiedError(e, { statusCode: 404 })) {
+            uiLogger.error(commands.project.release.create.errors.buildNotFound(buildId, projectName));
+        }
+        else {
+            logError(e, new ApiErrorContext({
+                accountId,
+                request: 'project release create',
+            }));
+        }
+        throw e;
+    }
+}
+export async function executeRelease(accountId, projectName, buildId) {
+    try {
+        const { data: release } = await createRelease(accountId, projectName, buildId);
+        return release;
+    }
+    catch (e) {
+        logError(e, new ApiErrorContext({
+            accountId,
+            request: 'project release create',
+        }));
+        throw e;
+    }
+}

package/lib/projects/upload.d.ts

@@ -24,7 +24,7 @@ type HandleProjectUploadArg<T> = {
     profile?: string;
     force?: boolean;
 };
-export declare function handleProjectUpload<T>({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage, forceCreate, isUploadCommand, sendIR, skipValidation, skipNpmAudit, skipAutoDeploy: _skipAutoDeploy, force, }: HandleProjectUploadArg<T>): Promise<ProjectUploadResult<T>>;
+export declare function handleProjectUpload<T>({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage, forceCreate, isUploadCommand, sendIR, skipValidation, skipNpmAudit, skipAutoDeploy, force, }: HandleProjectUploadArg<T>): Promise<ProjectUploadResult<T>>;
 export declare function validateSourceDirectory(srcDir: string, projectConfig: ProjectConfig, projectDir: string): Promise<void>;
 export declare function validateNoHSMetaMismatch(srcDir: string, projectConfig: ProjectConfig): Promise<void>;
 type HandleTranslateArg = {

package/lib/projects/upload.js

@@ -21,7 +21,7 @@ import { archiveWorkspacesAndDependencies, getPackageJsonPathsToUpdate, getLockf
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { validateLintConfigOnUpload } from './validateLintConfigOnUpload.js';
 import { runNpmAuditsBeforeProjectUpload } from './npmAuditOnUpload.js';
-async function uploadProjectFiles(accountId, projectName, filePath, uploadMessage, platformVersion, intermediateRepresentation) {
+async function uploadProjectFiles(accountId, projectName, filePath, uploadMessage, platformVersion, intermediateRepresentation, skipAutoDeploy) {
     const accountIdentifier = uiAccountDescription(accountId) || `${accountId}`;
     SpinniesManager.add('upload', {
         text: lib.projectUpload.uploadProjectFiles.add(projectName, accountIdentifier),
@@ -30,8 +30,7 @@ async function uploadProjectFiles(accountId, projectName, filePath, uploadMessag
     let buildId;
     let error;
     try {
-        // TODO(skip-auto-deploy): Pass skipAutoDeploy once local-dev-lib is bumped
-        const { data: upload } = await uploadProject(accountId, projectName, filePath, uploadMessage, platformVersion, intermediateRepresentation);
+        const { data: upload } = await uploadProject(accountId, projectName, filePath, uploadMessage, platformVersion, intermediateRepresentation, skipAutoDeploy);
         buildId = upload.buildId;
         SpinniesManager.succeed('upload', {
             text: lib.projectUpload.uploadProjectFiles.succeed(projectName, accountIdentifier),
@@ -48,10 +47,7 @@ async function uploadProjectFiles(accountId, projectName, filePath, uploadMessag
     }
     return { buildId, error };
 }
-// TODO(skip-auto-deploy): Use skipAutoDeploy once local-dev-lib is bumped to support it
-export async function handleProjectUpload({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage = '', forceCreate = false, isUploadCommand = false, sendIR = false, skipValidation = false, skipNpmAudit = false, 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-skipAutoDeploy: _skipAutoDeploy = false, force = false, }) {
+export async function handleProjectUpload({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage = '', forceCreate = false, isUploadCommand = false, sendIR = false, skipValidation = false, skipNpmAudit = false, skipAutoDeploy = false, force = false, }) {
     const srcDir = path.resolve(projectDir, projectConfig.srcDir);
     await validateSourceDirectory(srcDir, projectConfig, projectDir);
     await validateNoHSMetaMismatch(srcDir, projectConfig);
@@ -119,7 +115,7 @@ skipAutoDeploy: _skipAutoDeploy = false, force = false, }) {
                 return resolve({ projectNotFound: true });
             }
             const projectId = project?.id;
-            const { buildId, error } = await uploadProjectFiles(accountId, projectConfig.name, tempFile.name, uploadMessage, projectConfig.platformVersion, intermediateRepresentation);
+            const { buildId, error } = await uploadProjectFiles(accountId, projectConfig.name, tempFile.name, uploadMessage, projectConfig.platformVersion, intermediateRepresentation, skipAutoDeploy);
             if (error) {
                 resolve({ uploadError: error, projectId });
             }

package/lib/yargs/makeWrappedYargsHandler.d.ts

@@ -1,3 +1,7 @@
 import { ArgumentsCamelCase } from 'yargs';
+import { z } from 'zod';
 import { CommonArgs } from '../../types/Yargs.js';
-export declare function makeWrappedYargsHandler<T extends CommonArgs>(trackingName: string, handler: (args: ArgumentsCamelCase<T>) => Promise<void>): (args: ArgumentsCamelCase<T>) => Promise<void>;
+export type WrappedHandlerOptions = {
+    jsonOutputSchema?: z.ZodType;
+};
+export declare function makeWrappedYargsHandler<T extends CommonArgs>(trackingName: string, handler: (args: ArgumentsCamelCase<T>) => Promise<void>, options?: WrappedHandlerOptions): (args: ArgumentsCamelCase<T>) => Promise<void>;