@hubspot/cli 8.10.0 → 8.12.0-beta.0

package/commands/project/installApp.js

@@ -1,6 +1,7 @@
 import { getConfigAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
+import { InstallAppSchema, } from '../../lib/jsonOutput.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
@@ -13,7 +14,7 @@ const command = 'install-app';
 const describe = commands.project.installApp.describe;
 const verboseDescribe = commands.project.installApp.verboseDescribe;
 async function handler(args) {
-    const { derivedAccountId, formatOutputAsJson, force, profile: profileOption, useEnv: useEnvOption, exit, } = args;
+    const { derivedAccountId, formatOutputAsJson, force, profile: profileOption, useEnv: useEnvOption, exit, addJsonOutput, } = args;
     const { projectConfig, projectDir } = await getProjectConfig();
     if (!projectConfig || !projectDir) {
         uiLogger.error(commands.project.installApp.errors.noProjectConfig);
@@ -60,18 +61,16 @@ async function handler(args) {
     const needsReinstall = !isInstalledWithScopeGroups && previouslyAuthorizedScopeGroups.length > 0;
     const installationState = getAppInstallationState(isInstalledWithScopeGroups, previouslyAuthorizedScopeGroups);
     if (isInstalledWithScopeGroups) {
-        if (formatOutputAsJson) {
-            uiLogger.json({
-                appId,
-                appUid: appNode.uid,
-                accountId: installAccountId,
-                projectId,
-                installationState,
-                installed: true,
-                reinstalled: false,
-            });
-        }
-        else {
+        addJsonOutput({
+            appId,
+            appUid: appNode.uid,
+            accountId: installAccountId,
+            projectId,
+            installationState,
+            installed: true,
+            reinstalled: false,
+        });
+        if (!formatOutputAsJson) {
             uiLogger.success(commands.project.installApp.alreadyInstalled(appNode.config.name, installAccountId));
         }
         return exit(EXIT_CODES.SUCCESS);
@@ -117,18 +116,16 @@ async function handler(args) {
     if (!installed) {
         return exit(EXIT_CODES.ERROR);
     }
-    if (formatOutputAsJson) {
-        uiLogger.json({
-            appId,
-            appUid: appNode.uid,
-            accountId: installAccountId,
-            projectId,
-            installationState: APP_INSTALLATION_STATES.INSTALLED,
-            installed: true,
-            reinstalled: needsReinstall,
-        });
-    }
-    else {
+    addJsonOutput({
+        appId,
+        appUid: appNode.uid,
+        accountId: installAccountId,
+        projectId,
+        installationState: APP_INSTALLATION_STATES.INSTALLED,
+        installed: true,
+        reinstalled: needsReinstall,
+    });
+    if (!formatOutputAsJson) {
         uiLogger.success(commands.project.installApp.success(appNode.config.name, installAccountId));
     }
     return exit(EXIT_CODES.SUCCESS);
@@ -175,7 +172,9 @@ const builder = makeYargsBuilder(projectInstallAppBuilder, command, verboseDescr
 const projectInstallAppCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('project-install-app', handler),
+    handler: makeWrappedYargsHandler('project-install-app', handler, {
+        jsonOutputSchema: InstallAppSchema,
+    }),
     builder,
 };
 export default projectInstallAppCommand;

package/commands/project/list.js

@@ -57,7 +57,7 @@ const builder = makeYargsBuilder(projectListBuilder, command, describe, {
 const projectListCommand = {
     command,
     describe,
-    handler: makeWrappedYargsHandler('projects-list', handler),
+    handler: makeWrappedYargsHandler('project-list', handler),
     builder,
 };
 export default projectListCommand;

package/commands/project/profile/add.d.ts

@@ -1,7 +1,8 @@
 import { YargsCommandModule, CommonArgs } from '../../../types/Yargs.js';
-type ProjectProfileAddArgs = CommonArgs & {
+export type ProjectProfileAddArgs = CommonArgs & {
     name?: string;
     targetAccount?: number;
+    copyFrom?: string;
 };
 declare const projectProfileAddCommand: YargsCommandModule<unknown, ProjectProfileAddArgs>;
 export default projectProfileAddCommand;

package/commands/project/profile/add.js

@@ -157,7 +157,20 @@ async function handler(args) {
         accountId: targetAccountId,
         variables: {},
     };
-    const profileToCopyVariablesFrom = await selectProfileToCopyVariablesFrom(existingProfiles);
+    let profileToCopyVariablesFrom;
+    if (args.copyFrom) {
+        if (existingProfiles.includes(args.copyFrom)) {
+            profileToCopyVariablesFrom = args.copyFrom;
+        }
+        else {
+            uiLogger.error(commands.project.profile.add.errors.copyFromProfileNotFound(args.copyFrom));
+            return exit(EXIT_CODES.ERROR);
+        }
+    }
+    else {
+        profileToCopyVariablesFrom =
+            await selectProfileToCopyVariablesFrom(existingProfiles);
+    }
     if (profileToCopyVariablesFrom) {
         try {
             const profileToCopyFileContent = loadHsProfileFile(projectSourceDir, profileToCopyVariablesFrom);
@@ -190,8 +203,16 @@ function projectProfileAddBuilder(yargs) {
         describe: commands.project.profile.add.options.targetAccount,
         type: 'number',
     });
+    yargs.option('copy-from', {
+        describe: commands.project.profile.add.options.copyFrom,
+        type: 'string',
+    });
     yargs.example([
         ['$0 project profile add qa', commands.project.profile.add.example],
+        [
+            '$0 project profile add qa --target-account 123 --copy-from staging',
+            commands.project.profile.add.exampleCopyFrom,
+        ],
     ]);
     return yargs;
 }

package/commands/project/profile/delete.d.ts

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

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

@@ -1,5 +1,6 @@
 import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../../types/Yargs.js';
-export type ProjectReleaseCreateArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs & {
+import { ReleaseJsonOutput } from '../../../lib/jsonOutput.js';
+export type ProjectReleaseCreateArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ReleaseJsonOutput> & {
     build?: number;
     force: boolean;
 };

package/commands/project/release/create.js

@@ -1,6 +1,8 @@
-import { fetchProject, getBuildStatus, } from '@hubspot/local-dev-lib/api/projects';
-import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { handleProjectUpload } from '../../../lib/projects/upload.js';
+import { pollProjectBuildAndDeploy } from '../../../lib/projects/pollProjectBuildAndDeploy.js';
+import { resolveBuildId, validateBuildForRelease, executeRelease, } from '../../../lib/projects/release.js';
 import { logError, ApiErrorContext } from '../../../lib/errorHandlers/index.js';
+import { isPromptExitError } from '../../../lib/errors/PromptExitError.js';
 import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
 import { confirmPrompt } from '../../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
@@ -8,64 +10,23 @@ import { uiLogger } from '../../../lib/ui/logger.js';
 import { makeYargsBuilder } from '../../../lib/yargsUtils.js';
 import { commands } from '../../../lang/en.js';
 import { makeWrappedYargsHandler } from '../../../lib/yargs/makeWrappedYargsHandler.js';
-import { createRelease } from '../../../api/releases.js';
+import { ReleaseSchema, mapReleaseToJsonOutput, } from '../../../lib/jsonOutput.js';
 const command = 'create';
 // const describe = commands.project.release.create.describe;
 const describe = undefined;
 // const verboseDescribe = commands.project.release.create.verboseDescribe;
 const verboseDescribe = undefined;
-async function resolveBuildId(accountId, projectName, buildOption) {
-    const { data: { deployedBuildId }, } = await fetchProject(accountId, projectName);
-    if (buildOption) {
-        return buildOption;
-    }
-    if (!deployedBuildId) {
-        throw new Error(commands.project.release.create.errors.noDeployedBuild);
-    }
-    return deployedBuildId;
-}
-async function validateBuild(accountId, projectName, buildId) {
-    try {
-        await getBuildStatus(accountId, projectName, buildId);
-    }
-    catch (e) {
-        if (isHubSpotHttpError(e) && e.status === 404) {
-            uiLogger.error(commands.project.release.create.errors.buildNotFound(buildId, projectName));
-        }
-        else {
-            logError(e, new ApiErrorContext({
-                accountId,
-                request: 'project release create',
-            }));
-        }
-        throw e;
-    }
-}
-async function executeRelease(accountId, projectName, buildId, formatOutputAsJson) {
-    try {
-        const { data: release } = await createRelease(accountId, projectName, buildId);
-        if (formatOutputAsJson) {
-            uiLogger.json(release);
-        }
-        else {
-            uiLogger.success(commands.project.release.create.success(release.releaseTag, release.buildId));
-        }
-    }
-    catch (e) {
-        if (isHubSpotHttpError(e) && e.status === 422) {
-            uiLogger.error(commands.project.release.create.errors.buildNotDeployed(buildId));
-        }
-        else {
-            logError(e, new ApiErrorContext({
-                accountId,
-                request: 'project release create',
-            }));
-        }
-        throw e;
+function logUploadError(error, accountId) {
+    if (!error) {
+        return;
     }
+    logError(error, new ApiErrorContext({
+        accountId,
+        request: 'project release create',
+    }));
 }
 async function handler(args) {
-    const { exit, derivedAccountId, build: buildOption, json: formatOutputAsJson, force, } = args;
+    const { exit, derivedAccountId, build: buildOption, json: formatOutputAsJson, force, addJsonOutput, } = args;
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
         validateProjectConfig(projectConfig, projectDir);
@@ -74,34 +35,66 @@ async function handler(args) {
         logError(error);
         return exit(EXIT_CODES.ERROR);
     }
+    if (!projectConfig || !projectDir) {
+        return exit(EXIT_CODES.ERROR);
+    }
     const projectName = projectConfig.name;
     let buildId;
     try {
-        buildId = await resolveBuildId(derivedAccountId, projectName, buildOption);
+        buildId = await resolveBuildId(derivedAccountId, projectName, buildOption, force);
     }
     catch (e) {
-        if (isHubSpotHttpError(e) && e.status === 404) {
-            uiLogger.error(commands.project.release.create.errors.projectNotFound(derivedAccountId, projectName));
-        }
-        else if (!(e instanceof Error) || !e.message) {
-            logError(e, new ApiErrorContext({
-                accountId: derivedAccountId,
-                request: 'project release create',
-            }));
-        }
-        else {
-            uiLogger.error(e.message);
+        if (isPromptExitError(e)) {
+            return exit(e.exitCode);
         }
+        logError(e, new ApiErrorContext({
+            accountId: derivedAccountId,
+            request: 'project release create',
+        }));
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (buildId === null) {
         return exit(EXIT_CODES.ERROR);
     }
-    if (buildOption) {
+    if (!buildId && !force) {
+        let shouldUpload;
         try {
-            await validateBuild(derivedAccountId, projectName, buildId);
+            shouldUpload = await confirmPrompt(commands.project.release.create.uploadPrompt(projectName));
+        }
+        catch (e) {
+            if (isPromptExitError(e)) {
+                return exit(e.exitCode);
+            }
+            throw e;
+        }
+        if (!shouldUpload) {
+            return exit(EXIT_CODES.SUCCESS);
+        }
+    }
+    if (!buildId) {
+        const { result: pollResult, uploadError, projectNotFound, } = await handleProjectUpload({
+            accountId: derivedAccountId,
+            projectConfig,
+            projectDir,
+            sendIR: true,
+            callbackFunc: (...args) => pollProjectBuildAndDeploy(...args, { skipDeploy: true }),
+        });
+        if (projectNotFound || !pollResult || !pollResult.succeeded) {
+            logUploadError(uploadError, derivedAccountId);
+            return exit(EXIT_CODES.ERROR);
         }
-        catch {
+        buildId = pollResult.buildId;
+    }
+    try {
+        const supportsReleases = await validateBuildForRelease(derivedAccountId, projectName, buildId);
+        if (!supportsReleases) {
+            uiLogger.error(commands.project.release.create.errors.incompatibleBuildVersion);
             return exit(EXIT_CODES.ERROR);
         }
     }
+    catch {
+        return exit(EXIT_CODES.ERROR);
+    }
     if (!formatOutputAsJson && !force) {
         const confirmed = await confirmPrompt(commands.project.release.create.confirmPrompt(projectName, buildId));
         if (!confirmed) {
@@ -110,7 +103,11 @@ async function handler(args) {
         }
     }
     try {
-        await executeRelease(derivedAccountId, projectName, buildId, !!formatOutputAsJson);
+        const release = await executeRelease(derivedAccountId, projectName, buildId);
+        addJsonOutput(mapReleaseToJsonOutput(release));
+        if (!formatOutputAsJson) {
+            uiLogger.success(commands.project.release.create.success(release.releaseTag, release.buildId));
+        }
     }
     catch {
         return exit(EXIT_CODES.ERROR);
@@ -154,6 +151,8 @@ const projectReleaseCreateCommand = {
     command,
     describe,
     builder,
-    handler: makeWrappedYargsHandler('project-release-create', handler),
+    handler: makeWrappedYargsHandler('project-release-create', handler, {
+        jsonOutputSchema: ReleaseSchema,
+    }),
 };
 export default projectReleaseCreateCommand;

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

@@ -1,5 +1,6 @@
 import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../../types/Yargs.js';
-export type ProjectReleaseInfoArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs & {
+import { ReleaseJsonOutput } from '../../../lib/jsonOutput.js';
+export type ProjectReleaseInfoArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs<ReleaseJsonOutput> & {
     tag?: string;
 };
 declare const projectReleaseInfoCommand: YargsCommandModule<unknown, ProjectReleaseInfoArgs>;

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;
@@ -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,5 +1,6 @@
 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;

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,11 @@ 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 { 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 +36,7 @@ async function handlePreview(accountId, projectId, buildId, targetPortalId) {
     };
 }
 async function handler(args) {
-    const { force = false, forceCreate = false, message, derivedAccountId, skipValidation, skipNpmAudit, skipAutoDeploy, 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;
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
         validateProjectConfig(projectConfig, projectDir);
@@ -113,27 +114,33 @@ async function handler(args) {
             (!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) {
@@ -147,10 +154,7 @@ 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);
@@ -242,7 +246,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.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/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;