@hubspot/cli 8.2.0-experimental.2 → 8.2.1-experimental.0

package/commands/project/release/info.js

@@ -12,6 +12,7 @@ import { makeWrappedYargsHandler } from '../../../lib/yargs/makeWrappedYargsHand
 import { isPromptExitError } from '../../../lib/errors/PromptExitError.js';
 import { mapToUserFacingType } from '@hubspot/project-parsing-lib/transform';
 import { AUTO_GENERATED_COMPONENT_TYPES } from '@hubspot/project-parsing-lib/constants';
+import { ReleaseSchema, mapReleaseToJsonOutput, } from '../../../lib/jsonOutput.js';
 const command = 'info';
 // const describe = commands.project.release.info.describe;
 const describe = undefined;
@@ -36,7 +37,7 @@ async function selectReleasePrompt(accountId, projectName) {
     });
 }
 async function handler(args) {
-    const { derivedAccountId, tag: rawTag, json: formatOutputAsJson, exit, } = args;
+    const { derivedAccountId, tag: rawTag, json: formatOutputAsJson, exit, addJsonOutput, } = args;
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
         validateProjectConfig(projectConfig, projectDir);
@@ -69,10 +70,8 @@ async function handler(args) {
     }
     try {
         const { data: release } = await getReleaseInfo(derivedAccountId, projectName, tag);
-        if (formatOutputAsJson) {
-            uiLogger.json(release);
-        }
-        else {
+        addJsonOutput(mapReleaseToJsonOutput(release));
+        if (!formatOutputAsJson) {
             uiLogger.log(commands.project.release.info.releaseDetails(release.releaseTag, projectName));
             renderTable(['Release', 'Build', 'Created'], [
                 [
@@ -142,6 +141,8 @@ const projectReleaseInfoCommand = {
     command,
     describe,
     builder,
-    handler: makeWrappedYargsHandler('project-release-info', handler),
+    handler: makeWrappedYargsHandler('project-release-info', handler, {
+        jsonOutputSchema: ReleaseSchema,
+    }),
 };
 export default projectReleaseInfoCommand;

package/commands/project/release/list.d.ts

@@ -1,5 +1,6 @@
 import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../../types/Yargs.js';
-export type ProjectReleaseListArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs & {
+import { ReleaseListJsonOutput } from '../../../lib/jsonOutput.js';
+export type ProjectReleaseListArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ReleaseListJsonOutput> & {
     limit?: number;
 };
 declare const projectReleaseListCommand: YargsCommandModule<unknown, ProjectReleaseListArgs>;

package/commands/project/release/list.js

@@ -10,6 +10,7 @@ import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { commands } from '../../../lang/en.js';
 import { renderTable } from '../../../ui/render.js';
 import { makeWrappedYargsHandler } from '../../../lib/yargs/makeWrappedYargsHandler.js';
+import { ReleaseListSchema, mapReleaseToJsonOutput, } from '../../../lib/jsonOutput.js';
 const command = 'list';
 // const describe = commands.project.release.list.describe;
 const describe = undefined;
@@ -17,7 +18,6 @@ const describe = undefined;
 const verboseDescribe = undefined;
 async function fetchAndDisplayReleases(accountId, projectName, options) {
     const { data: { results, paging }, } = await listReleases(accountId, projectName, options);
-    uiLogger.log(commands.project.release.list.showingReleases(results.length, projectName));
     if (results.length === 0) {
         uiLogger.log(commands.project.release.list.noReleases);
     }
@@ -28,6 +28,7 @@ async function fetchAndDisplayReleases(accountId, projectName, options) {
             new Date(release.createdAt).toLocaleString(),
         ]);
         renderTable(['Release', 'Build', 'Created'], rows);
+        uiLogger.log(commands.project.release.list.showingReleases(results.length, projectName));
     }
     if (paging?.next?.after) {
         await promptUser({
@@ -41,14 +42,14 @@ async function fetchAndDisplayReleases(accountId, projectName, options) {
     }
 }
 async function handler(args) {
-    const { derivedAccountId, limit, json: formatOutputAsJson } = args;
+    const { derivedAccountId, limit, json: formatOutputAsJson, exit, addJsonOutput, } = args;
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
         validateProjectConfig(projectConfig, projectDir);
     }
     catch (error) {
         logError(error);
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
     const projectName = projectConfig.name;
     try {
@@ -56,7 +57,12 @@ async function handler(args) {
             const { data } = await listReleases(derivedAccountId, projectName, {
                 limit,
             });
-            uiLogger.json(data);
+            addJsonOutput({
+                results: data.results.map(mapReleaseToJsonOutput),
+                paging: data.paging
+                    ? { next: { after: data.paging.next.after } }
+                    : undefined,
+            });
         }
         else {
             await fetchAndDisplayReleases(derivedAccountId, projectName, { limit });
@@ -75,9 +81,9 @@ async function handler(args) {
                 request: 'project release list',
             }));
         }
-        process.exit(EXIT_CODES.ERROR);
+        return exit(EXIT_CODES.ERROR);
     }
-    process.exit(EXIT_CODES.SUCCESS);
+    return exit(EXIT_CODES.SUCCESS);
 }
 function projectReleaseListBuilder(yargs) {
     yargs.options({
@@ -106,6 +112,8 @@ const projectReleaseListCommand = {
     command,
     describe,
     builder,
-    handler: makeWrappedYargsHandler('project-release-list', handler),
+    handler: makeWrappedYargsHandler('project-release-list', handler, {
+        jsonOutputSchema: ReleaseListSchema,
+    }),
 };
 export default projectReleaseListCommand;

package/commands/project/upload.d.ts

@@ -1,10 +1,13 @@
 import { CommonArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-export type ProjectUploadArgs = CommonArgs & JSONOutputArgs & {
+import { UploadJsonOutput } from '../../lib/jsonOutput.js';
+export type ProjectUploadArgs = CommonArgs & JSONOutputArgs<UploadJsonOutput> & {
+    force: boolean;
     forceCreate: boolean;
     message: string;
     m: string;
     skipValidation: boolean;
     skipNpmAudit: boolean;
+    skipAutoDeploy: boolean;
     profile?: string;
     preview: boolean;
     target?: number;

package/commands/project/upload.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
+import { isLegacyProject, meetsMinimumPlatformVersion, } from '@hubspot/project-parsing-lib/projects';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { logFeedbackMessage } from '../../lib/projects/ui.js';
 import { handleProjectUpload } from '../../lib/projects/upload.js';
@@ -14,9 +14,12 @@ import { PROJECT_ERROR_TYPES } from '../../lib/constants.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
+import { UploadSchema, } from '../../lib/jsonOutput.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { projectProfilePrompt } from '../../lib/prompts/projectProfilePrompt.js';
+import { uiDeprecatedTag } from '../../lib/ui/index.js';
 import { showMcpPromotionNudge } from '../../lib/mcp/promotion.js';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 const command = 'upload';
 const describe = commands.project.upload.describe;
 async function handlePreview(accountId, projectId, buildId, targetPortalId) {
@@ -34,8 +37,10 @@ async function handlePreview(accountId, projectId, buildId, targetPortalId) {
     };
 }
 async function handler(args) {
-    const { forceCreate, message, derivedAccountId, skipValidation, skipNpmAudit, formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, preview, target: targetPortalId, exit, addUsageMetadata, } = args;
-    const jsonOutput = {};
+    const { force = false, forceCreate = false, message, derivedAccountId, skipValidation, skipNpmAudit, skipAutoDeploy, formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, preview, target: targetPortalId, exit, addUsageMetadata, addJsonOutput, } = args;
+    if (forceCreate) {
+        uiDeprecatedTag(commands.project.upload.logs.forceCreateDeprecated);
+    }
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
         validateProjectConfig(projectConfig, projectDir);
@@ -72,21 +77,26 @@ async function handler(args) {
         assetType: projectConfig.platformVersion,
     });
     try {
-        const { result, uploadError, projectId } = await handleProjectUpload({
+        const { result, uploadError, projectId, userDeclined } = await handleProjectUpload({
             accountId: targetAccountId,
             projectConfig,
             projectDir,
-            callbackFunc: preview
+            callbackFunc: preview || skipAutoDeploy
                 ? (...args) => pollProjectBuildAndDeploy(...args, { skipDeploy: true })
                 : pollProjectBuildAndDeploy,
             uploadMessage: message,
-            forceCreate,
+            forceCreate: forceCreate || force,
             isUploadCommand: true,
             sendIR: !isLegacyProject(projectConfig.platformVersion),
             skipValidation,
             skipNpmAudit,
+            skipAutoDeploy,
             profile: profileName,
+            force,
         });
+        if (userDeclined) {
+            return exit(EXIT_CODES.SUCCESS);
+        }
         if (uploadError) {
             if (isSpecifiedError(uploadError, {
                 subCategory: PROJECT_ERROR_TYPES.PROJECT_LOCKED,
@@ -105,30 +115,36 @@ async function handler(args) {
         }
         if (result &&
             result.succeeded &&
-            (!result.buildResult.isAutoDeployEnabled || preview)) {
+            (!result.buildResult.isAutoDeployEnabled || preview || skipAutoDeploy)) {
             uiLogger.log(chalk.bold(commands.project.upload.logs.buildSucceeded(result.buildId)));
             if (!preview) {
-                uiLogger.log(commands.project.upload.logs.autoDeployDisabled(`hs project deploy --build=${result.buildId}`));
+                if (meetsMinimumPlatformVersion(result.buildResult.platformVersion, PLATFORM_VERSIONS.v2026_09_BETA)) {
+                    const releaseCommand = `hs project release create --build=${result.buildId}`;
+                    uiLogger.log(commands.project.upload.logs.releaseManagementRequired(releaseCommand));
+                }
+                else {
+                    const deployCommand = `hs project deploy --build=${result.buildId}`;
+                    uiLogger.log(skipAutoDeploy
+                        ? commands.project.upload.logs.autoDeploySkipped(deployCommand)
+                        : commands.project.upload.logs.autoDeployDisabled(deployCommand));
+                }
                 logFeedbackMessage(result.buildId);
             }
             await displayWarnLogs(targetAccountId, projectConfig.name, result.buildId);
         }
         if (result && result.succeeded && preview && targetPortalId) {
             const previewJson = await handlePreview(targetAccountId, projectId, result.buildId, targetPortalId);
-            if (previewJson && formatOutputAsJson) {
-                jsonOutput.preview = previewJson;
+            if (previewJson) {
+                addJsonOutput({ preview: previewJson });
             }
         }
-        if (result && result.succeeded && formatOutputAsJson) {
-            jsonOutput.buildId = result.buildId;
+        if (result) {
+            addJsonOutput({ buildId: result.buildId });
             if (result.deployResult) {
-                jsonOutput.deployId = result.deployResult.deployId;
+                addJsonOutput({ deployId: result.deployResult.deployId });
             }
         }
         if (result && !result.succeeded) {
-            if (formatOutputAsJson) {
-                uiLogger.json(jsonOutput);
-            }
             return exit(EXIT_CODES.ERROR);
         }
         if (!result && !uploadError) {
@@ -142,20 +158,24 @@ async function handler(args) {
         }));
         return exit(EXIT_CODES.ERROR);
     }
-    if (formatOutputAsJson) {
-        uiLogger.json(jsonOutput);
-    }
-    else {
+    if (!formatOutputAsJson) {
         await showMcpPromotionNudge(args._.join(' '));
     }
     return exit(EXIT_CODES.SUCCESS);
 }
 function projectUploadBuilder(yargs) {
     yargs.options({
+        force: {
+            alias: 'f',
+            describe: commands.project.upload.options.force.describe,
+            type: 'boolean',
+            default: false,
+        },
         'force-create': {
             describe: commands.project.upload.options.forceCreate.describe,
             type: 'boolean',
             default: false,
+            hidden: true,
         },
         message: {
             alias: 'm',
@@ -173,6 +193,11 @@ function projectUploadBuilder(yargs) {
             type: 'boolean',
             default: false,
         },
+        'skip-auto-deploy': {
+            describe: commands.project.upload.options.skipAutoDeploy.describe,
+            type: 'boolean',
+            default: false,
+        },
         profile: {
             type: 'string',
             alias: 'p',
@@ -225,7 +250,9 @@ const builder = makeYargsBuilder(projectUploadBuilder, command, describe, {
 const projectUploadCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-upload', handler),
+    handler: makeWrappedYargsHandler('project-upload', handler, {
+        jsonOutputSchema: UploadSchema,
+    }),
     builder,
 };
 export default projectUploadCommand;

package/commands/project/validate.d.ts

@@ -1,5 +1,5 @@
 import { CommonArgs, YargsCommandModule } from '../../types/Yargs.js';
-type ProjectValidateArgs = CommonArgs & {
+export type ProjectValidateArgs = CommonArgs & {
     profile?: string;
 };
 declare const projectValidateCommand: YargsCommandModule<unknown, ProjectValidateArgs>;

package/commands/project/watch.js

@@ -14,9 +14,9 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { handleKeypress, handleExit } from '../../lib/process.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
-import { uiDeprecatedTag } from '../../lib/ui/index.js';
+import { uiCommandRelocatedMessage, uiCommandRenamedDescription, } from '../../lib/ui/index.js';
 const command = 'watch';
-const describe = uiDeprecatedTag(commands.project.watch.describe, false);
+const describe = uiCommandRenamedDescription(commands.project.watch.describe, 'hs project dev');
 async function handleBuildStatus(accountId, projectName, buildId) {
     const { isAutoDeployEnabled, deployStatusTaskLocator } = await pollBuildStatus(accountId, projectName, buildId, null);
     if (isAutoDeployEnabled && deployStatusTaskLocator) {
@@ -57,6 +57,7 @@ function handleUserInput(accountId, projectName, currentBuildId, exit) {
 }
 async function handler(args) {
     const { initialUpload, derivedAccountId, exit } = args;
+    uiCommandRelocatedMessage('hs project dev');
     const { projectConfig, projectDir } = await getProjectConfig();
     if (!projectConfig || !projectDir) {
         uiLogger.error(commands.project.watch.errors.projectConfigNotFound);

package/commands/project.js

@@ -24,7 +24,7 @@ import appInstallStatus from './project/appInstallStatus.js';
 import installApp from './project/installApp.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { getProjectConfig } from '../lib/projects/config.js';
-import { isSupportedPlatformVersion, LATEST_SUPPORTED_PLATFORM_VERSION, } from '@hubspot/project-parsing-lib/projects';
+import { isKnownPlatformVersion, LATEST_SUPPORTED_PLATFORM_VERSION, } from '@hubspot/project-parsing-lib/projects';
 import { uiLogger } from '../lib/ui/logger.js';
 import { debugError } from '../lib/errorHandlers/index.js';
 const command = ['project', 'projects'];
@@ -37,7 +37,7 @@ async function validatePlatformVersion() {
         // Only warn if a platform version is explicitly set but not supported
         // Don't warn if the platform version is missing/undefined
         if (projectConfig?.platformVersion &&
-            !isSupportedPlatformVersion(projectConfig.platformVersion)) {
+            !isKnownPlatformVersion(projectConfig.platformVersion)) {
             uiLogger.warn(lib.projects.platformVersion.unsupported(pkg.version, LATEST_SUPPORTED_PLATFORM_VERSION, projectConfig.platformVersion));
             uiLogger.log('');
         }

package/commands/sandbox/delete.js

@@ -2,8 +2,7 @@ import { uiLogger } from '../../lib/ui/logger.js';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
 import { deleteSandbox } from '@hubspot/local-dev-lib/api/sandboxHubs';
 import { getConfigAccountEnvironment, removeAccountFromConfig, setConfigAccountAsDefault, getAllConfigAccounts, getConfigAccountIfExists, getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
-import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
-import { getValidEnv } from '@hubspot/local-dev-lib/environment';
+import { getHubSpotWebsiteOriginByAccountId } from '@hubspot/local-dev-lib/urls';
 import { logError, debugError } from '../../lib/errorHandlers/index.js';
 import { commands } from '../../lang/en.js';
 import { deleteSandboxPrompt } from '../../lib/prompts/sandboxesPrompt.js';
@@ -43,7 +42,7 @@ async function handler(args) {
     const sandboxAccountId = sandboxAccount.accountId;
     const defaultAccount = getConfigDefaultAccountIfExists();
     const isDefaultAccount = sandboxAccountId === defaultAccount?.accountId;
-    const baseUrl = getHubSpotWebsiteOrigin(getValidEnv(getConfigAccountEnvironment(sandboxAccountId)));
+    const baseUrl = getHubSpotWebsiteOriginByAccountId(sandboxAccountId);
     let parentAccountId;
     const accountsList = getAllConfigAccounts() || [];
     for (const portal of accountsList) {

package/commands/testAccount/create.d.ts

@@ -1,6 +1,7 @@
 import { AccountLevel } from '@hubspot/local-dev-lib/types/developerTestAccounts.js';
 import { CommonArgs, ConfigArgs, AccountArgs, TestingArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../types/Yargs.js';
-type CreateTestAccountArgs = CommonArgs & AccountArgs & ConfigArgs & TestingArgs & EnvironmentArgs & JSONOutputArgs & {
+import { CreateTestAccountJsonOutput } from '../../lib/jsonOutput.js';
+type CreateTestAccountArgs = CommonArgs & AccountArgs & ConfigArgs & TestingArgs & EnvironmentArgs & JSONOutputArgs<CreateTestAccountJsonOutput> & {
     configPath?: string;
     name?: string;
     description?: string;

package/commands/testAccount/create.js

@@ -4,6 +4,7 @@ import { getValidEnv } from '@hubspot/local-dev-lib/environment';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { getCwd } from '@hubspot/local-dev-lib/path';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
+import { CreateTestAccountSchema, } from '../../lib/jsonOutput.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { promptUser, listPrompt } from '../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
@@ -88,7 +89,7 @@ async function buildTestAccountConfig(args) {
     });
 }
 async function handler(args) {
-    const { derivedAccountId, formatOutputAsJson, exit } = args;
+    const { derivedAccountId, formatOutputAsJson, exit, addJsonOutput } = args;
     const env = getValidEnv(getConfigAccountEnvironment(derivedAccountId));
     let testAccountConfig;
     try {
@@ -121,11 +122,8 @@ async function handler(args) {
     SpinniesManager.succeed('createTestAccount', {
         text: commands.testAccount.create.polling.success(testAccountConfig.accountName, resultJson.accountId, derivedAccountId),
     });
-    if (formatOutputAsJson) {
-        uiLogger.json(resultJson);
-    }
-    else {
-        // Only save to config if not using json output
+    addJsonOutput(resultJson);
+    if (!formatOutputAsJson) {
         try {
             const savedAccountName = await saveAccountToConfig(resultJson.accountId, testAccountConfig.accountName, env, resultJson.personalAccessKey);
             // Inform user if the account name was normalized
@@ -230,7 +228,9 @@ const builder = makeYargsBuilder(createTestAccountBuilder, command, describe, {
 const createTestAccountCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('test-account-create', handler),
+    handler: makeWrappedYargsHandler('test-account-create', handler, {
+        jsonOutputSchema: CreateTestAccountSchema,
+    }),
     builder,
 };
 export default createTestAccountCommand;

package/commands/testAccount/importData.d.ts

@@ -1,7 +1,7 @@
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs.js';
 export declare const command = "import-data";
 export declare const describe: string;
-type CrmImportDataArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
+export type CrmImportDataArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
     filePath: string | undefined;
     skipConfirm: boolean | undefined;
 };