@hubspot/cli 8.6.0 → 8.7.0-beta.0

package/commands/project/release/create.js

@@ -0,0 +1,159 @@
+import { fetchProject, getBuildStatus, } from '@hubspot/local-dev-lib/api/projects';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { logError, ApiErrorContext } from '../../../lib/errorHandlers/index.js';
+import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
+import { confirmPrompt } from '../../../lib/prompts/promptUtils.js';
+import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
+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';
+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;
+    }
+}
+async function handler(args) {
+    const { exit, derivedAccountId, build: buildOption, json: formatOutputAsJson, force, } = args;
+    const { projectConfig, projectDir } = await getProjectConfig();
+    try {
+        validateProjectConfig(projectConfig, projectDir);
+    }
+    catch (error) {
+        logError(error);
+        return exit(EXIT_CODES.ERROR);
+    }
+    const projectName = projectConfig.name;
+    let buildId;
+    try {
+        buildId = await resolveBuildId(derivedAccountId, projectName, buildOption);
+    }
+    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);
+        }
+        return exit(EXIT_CODES.ERROR);
+    }
+    if (buildOption) {
+        try {
+            await validateBuild(derivedAccountId, projectName, buildId);
+        }
+        catch {
+            return exit(EXIT_CODES.ERROR);
+        }
+    }
+    if (!formatOutputAsJson && !force) {
+        const confirmed = await confirmPrompt(commands.project.release.create.confirmPrompt(projectName, buildId));
+        if (!confirmed) {
+            uiLogger.log(commands.project.release.create.cancelled);
+            return exit(EXIT_CODES.SUCCESS);
+        }
+    }
+    try {
+        await executeRelease(derivedAccountId, projectName, buildId, !!formatOutputAsJson);
+    }
+    catch {
+        return exit(EXIT_CODES.ERROR);
+    }
+    return exit(EXIT_CODES.SUCCESS);
+}
+function projectReleaseCreateBuilder(yargs) {
+    yargs.options({
+        build: {
+            alias: ['build-id'],
+            describe: commands.project.release.create.options.build,
+            type: 'number',
+        },
+        force: {
+            alias: ['f'],
+            describe: commands.project.release.create.options.force,
+            default: false,
+            type: 'boolean',
+        },
+    });
+    yargs.example([
+        [
+            '$0 project release create',
+            commands.project.release.create.examples.default,
+        ],
+        [
+            '$0 project release create --build=5',
+            commands.project.release.create.examples.withBuild,
+        ],
+    ]);
+    return yargs;
+}
+const builder = makeYargsBuilder(projectReleaseCreateBuilder, command, verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+    useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
+});
+const projectReleaseCreateCommand = {
+    command,
+    describe,
+    builder,
+    handler: makeWrappedYargsHandler('project-release-create', handler),
+};
+export default projectReleaseCreateCommand;

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

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

package/commands/project/release/info.js

@@ -0,0 +1,147 @@
+import { getReleaseInfo, listReleases } from '../../../api/releases.js';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { logError, ApiErrorContext } from '../../../lib/errorHandlers/index.js';
+import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
+import { listPrompt } from '../../../lib/prompts/promptUtils.js';
+import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
+import { uiLogger } from '../../../lib/ui/logger.js';
+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 { 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';
+const command = 'info';
+// const describe = commands.project.release.info.describe;
+const describe = undefined;
+// const verboseDescribe = commands.project.release.info.verboseDescribe;
+const verboseDescribe = undefined;
+function normalizeTag(rawTag) {
+    return rawTag.startsWith('v') ? rawTag : `v${rawTag}`;
+}
+async function selectReleasePrompt(accountId, projectName) {
+    const { data: { results, paging }, } = await listReleases(accountId, projectName);
+    if (results.length === 0) {
+        return null;
+    }
+    if (paging?.next?.after) {
+        uiLogger.info(commands.project.release.info.moreReleasesHint);
+    }
+    return listPrompt(commands.project.release.info.selectRelease(projectName), {
+        choices: results.map(release => ({
+            name: `${release.releaseTag} (build #${release.buildId}, ${new Date(release.createdAt).toLocaleString()})`,
+            value: release.releaseTag,
+        })),
+    });
+}
+async function handler(args) {
+    const { derivedAccountId, tag: rawTag, json: formatOutputAsJson, exit, } = args;
+    const { projectConfig, projectDir } = await getProjectConfig();
+    try {
+        validateProjectConfig(projectConfig, projectDir);
+    }
+    catch (error) {
+        logError(error);
+        return exit(EXIT_CODES.ERROR);
+    }
+    const projectName = projectConfig.name;
+    let tag;
+    if (rawTag) {
+        tag = normalizeTag(rawTag);
+    }
+    else {
+        try {
+            const selected = await selectReleasePrompt(derivedAccountId, projectName);
+            if (!selected) {
+                uiLogger.error(commands.project.release.info.errors.noReleases);
+                return exit(EXIT_CODES.ERROR);
+            }
+            tag = selected;
+        }
+        catch (e) {
+            if (isPromptExitError(e)) {
+                throw e;
+            }
+            logError(e);
+            return exit(EXIT_CODES.ERROR);
+        }
+    }
+    try {
+        const { data: release } = await getReleaseInfo(derivedAccountId, projectName, tag);
+        if (formatOutputAsJson) {
+            uiLogger.json(release);
+        }
+        else {
+            uiLogger.log(commands.project.release.info.releaseDetails(release.releaseTag, projectName));
+            renderTable(['Release', 'Build', 'Created'], [
+                [
+                    release.releaseTag,
+                    `#${release.buildId}`,
+                    new Date(release.createdAt).toLocaleString(),
+                ],
+            ]);
+            const visibleComponents = (release.components ?? []).filter(component => !AUTO_GENERATED_COMPONENT_TYPES.includes(component.buildType));
+            if (visibleComponents.length > 0) {
+                uiLogger.log('');
+                uiLogger.log(commands.project.release.info.components);
+                const componentRows = visibleComponents.map(component => [
+                    mapToUserFacingType(component.buildType),
+                    component.buildName ?? '',
+                    component.rootPath ?? '',
+                ]);
+                renderTable(['Type', 'Name', 'Path'], componentRows);
+            }
+            else {
+                uiLogger.log('');
+                uiLogger.log(commands.project.release.info.noComponents);
+            }
+        }
+    }
+    catch (e) {
+        if (isHubSpotHttpError(e) && e.status === 404) {
+            uiLogger.error(commands.project.release.info.errors.releaseNotFound(tag, projectName));
+        }
+        else {
+            logError(e, new ApiErrorContext({
+                accountId: derivedAccountId,
+                request: 'project release info',
+            }));
+        }
+        return exit(EXIT_CODES.ERROR);
+    }
+    return exit(EXIT_CODES.SUCCESS);
+}
+function projectReleaseInfoBuilder(yargs) {
+    yargs.options({
+        tag: {
+            describe: commands.project.release.info.options.tag,
+            type: 'string',
+        },
+    });
+    yargs.example([
+        [
+            '$0 project release info --tag=v1.0.0',
+            commands.project.release.info.examples.default,
+        ],
+        [
+            '$0 project release info --tag=v1.0.0 --json',
+            commands.project.release.info.examples.json,
+        ],
+    ]);
+    return yargs;
+}
+const builder = makeYargsBuilder(projectReleaseInfoBuilder, command, verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+    useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
+});
+const projectReleaseInfoCommand = {
+    command,
+    describe,
+    builder,
+    handler: makeWrappedYargsHandler('project-release-info', handler),
+};
+export default projectReleaseInfoCommand;

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

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

package/commands/project/release/list.js

@@ -0,0 +1,111 @@
+import { listReleases } from '../../../api/releases.js';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { isPromptExitError } from '../../../lib/errors/PromptExitError.js';
+import { logError, ApiErrorContext } from '../../../lib/errorHandlers/index.js';
+import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
+import { promptUser } from '../../../lib/prompts/promptUtils.js';
+import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
+import { uiLogger } from '../../../lib/ui/logger.js';
+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';
+const command = 'list';
+// const describe = commands.project.release.list.describe;
+const describe = undefined;
+// const verboseDescribe = commands.project.release.list.verboseDescribe;
+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);
+    }
+    else {
+        const rows = results.map(release => [
+            release.releaseTag,
+            `#${release.buildId}`,
+            new Date(release.createdAt).toLocaleString(),
+        ]);
+        renderTable(['Release', 'Build', 'Created'], rows);
+    }
+    if (paging?.next?.after) {
+        await promptUser({
+            name: 'more',
+            message: commands.project.release.list.continueOrExitPrompt,
+        });
+        await fetchAndDisplayReleases(accountId, projectName, {
+            limit: options.limit,
+            after: paging.next.after,
+        });
+    }
+}
+async function handler(args) {
+    const { derivedAccountId, limit, json: formatOutputAsJson } = args;
+    const { projectConfig, projectDir } = await getProjectConfig();
+    try {
+        validateProjectConfig(projectConfig, projectDir);
+    }
+    catch (error) {
+        logError(error);
+        process.exit(EXIT_CODES.ERROR);
+    }
+    const projectName = projectConfig.name;
+    try {
+        if (formatOutputAsJson) {
+            const { data } = await listReleases(derivedAccountId, projectName, {
+                limit,
+            });
+            uiLogger.json(data);
+        }
+        else {
+            await fetchAndDisplayReleases(derivedAccountId, projectName, { limit });
+        }
+    }
+    catch (e) {
+        if (isPromptExitError(e)) {
+            throw e;
+        }
+        if (isHubSpotHttpError(e) && e.status === 404) {
+            uiLogger.error(commands.project.release.list.errors.projectNotFound(derivedAccountId, projectName));
+        }
+        else {
+            logError(e, new ApiErrorContext({
+                accountId: derivedAccountId,
+                request: 'project release list',
+            }));
+        }
+        process.exit(EXIT_CODES.ERROR);
+    }
+    process.exit(EXIT_CODES.SUCCESS);
+}
+function projectReleaseListBuilder(yargs) {
+    yargs.options({
+        limit: {
+            describe: commands.project.release.list.options.limit,
+            type: 'number',
+        },
+    });
+    yargs.example([
+        ['$0 project release list', commands.project.release.list.examples.default],
+        [
+            '$0 project release list --limit=5',
+            commands.project.release.list.examples.withLimit,
+        ],
+    ]);
+    return yargs;
+}
+const builder = makeYargsBuilder(projectReleaseListBuilder, command, verboseDescribe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+    useEnvironmentOptions: true,
+    useJSONOutputOptions: true,
+});
+const projectReleaseListCommand = {
+    command,
+    describe,
+    builder,
+    handler: makeWrappedYargsHandler('project-release-list', handler),
+};
+export default projectReleaseListCommand;

package/commands/project/release.d.ts

@@ -0,0 +1,3 @@
+import { YargsCommandModuleBucket } from '../../types/Yargs.js';
+declare const projectReleaseCommand: YargsCommandModuleBucket;
+export default projectReleaseCommand;

package/commands/project/release.js

@@ -0,0 +1,20 @@
+import create from './release/create.js';
+import info from './release/info.js';
+import list from './release/list.js';
+import { makeYargsBuilder } from '../../lib/yargsUtils.js';
+// import { commands } from '../../lang/en.js';
+const command = 'release';
+// const describe = commands.project.release.describe;
+const describe = undefined;
+function projectReleaseBuilder(yargs) {
+    yargs.command(create).command(info).command(list).demandCommand(1, '');
+    return yargs;
+}
+const builder = makeYargsBuilder(projectReleaseBuilder, command, describe);
+const projectReleaseCommand = {
+    command,
+    describe,
+    builder,
+    handler: () => { },
+};
+export default projectReleaseCommand;

package/commands/project/updateDeps.js

@@ -6,7 +6,7 @@ import { promptUser } from '../../lib/prompts/promptUtils.js';
 import path from 'path';
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.js';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'update-deps [packages..]';
@@ -77,7 +77,7 @@ const builder = makeYargsBuilder(projectUpdateDepsBuilder, command, describe, {
 const projectUpdateDepsCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('project-update-deps', handler),
+    handler: makeWrappedYargsHandler('project-update-deps', handler),
     builder,
 };
 export default projectUpdateDepsCommand;

package/commands/project/upload.d.ts

@@ -4,7 +4,10 @@ export type ProjectUploadArgs = CommonArgs & JSONOutputArgs & {
     message: string;
     m: string;
     skipValidation: boolean;
+    skipNpmAudit: boolean;
     profile?: string;
+    preview: boolean;
+    target?: number;
 };
 declare const projectUploadCommand: YargsCommandModule<unknown, ProjectUploadArgs>;
 export default projectUploadCommand;

package/commands/project/upload.js

@@ -8,17 +8,32 @@ import { logFeedbackMessage } from '../../lib/projects/ui.js';
 import { handleProjectUpload } from '../../lib/projects/upload.js';
 import { loadAndValidateProfile } from '../../lib/projects/projectProfiles.js';
 import { displayWarnLogs, pollProjectBuildAndDeploy, } from '../../lib/projects/pollProjectBuildAndDeploy.js';
-import { commands } from '../../lang/en.js';
+import { triggerAndPollPreview } from '../../lib/projects/preview.js';
+import { commands, lib } from '../../lang/en.js';
 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 { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { projectProfilePrompt } from '../../lib/prompts/projectProfilePrompt.js';
 const command = 'upload';
 const describe = commands.project.upload.describe;
+async function handlePreview(accountId, projectId, buildId, targetPortalId) {
+    if (!projectId) {
+        uiLogger.warn(lib.projectPreview.missingProjectId);
+        return;
+    }
+    const previewResult = await triggerAndPollPreview(accountId, projectId, buildId, targetPortalId);
+    if (!previewResult.succeeded) {
+        uiLogger.warn(lib.projectPreview.warning);
+    }
+    return {
+        releaseTag: previewResult.releaseTag,
+        succeeded: previewResult.succeeded,
+    };
+}
 async function handler(args) {
-    const { forceCreate, message, derivedAccountId, skipValidation, formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, exit, addUsageMetadata, } = args;
+    const { forceCreate, message, derivedAccountId, skipValidation, skipNpmAudit, formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, preview, target: targetPortalId, exit, addUsageMetadata, } = args;
     const jsonOutput = {};
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
@@ -56,16 +71,19 @@ async function handler(args) {
         assetType: projectConfig.platformVersion,
     });
     try {
-        const { result, uploadError } = await handleProjectUpload({
+        const { result, uploadError, projectId } = await handleProjectUpload({
             accountId: targetAccountId,
             projectConfig,
             projectDir,
-            callbackFunc: pollProjectBuildAndDeploy,
+            callbackFunc: preview
+                ? (...args) => pollProjectBuildAndDeploy(...args, { skipDeploy: true })
+                : pollProjectBuildAndDeploy,
             uploadMessage: message,
             forceCreate,
             isUploadCommand: true,
             sendIR: !isLegacyProject(projectConfig.platformVersion),
             skipValidation,
+            skipNpmAudit,
             profile: profileName,
         });
         if (uploadError) {
@@ -84,18 +102,37 @@ async function handler(args) {
             }
             return exit(EXIT_CODES.ERROR);
         }
-        if (result && result.succeeded && !result.buildResult.isAutoDeployEnabled) {
+        if (result &&
+            result.succeeded &&
+            (!result.buildResult.isAutoDeployEnabled || preview)) {
             uiLogger.log(chalk.bold(commands.project.upload.logs.buildSucceeded(result.buildId)));
-            uiLogger.log(commands.project.upload.logs.autoDeployDisabled(`hs project deploy --build=${result.buildId}`));
-            logFeedbackMessage(result.buildId);
+            if (!preview) {
+                uiLogger.log(commands.project.upload.logs.autoDeployDisabled(`hs project deploy --build=${result.buildId}`));
+                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 (result && result.succeeded && formatOutputAsJson) {
             jsonOutput.buildId = result.buildId;
             if (result.deployResult) {
                 jsonOutput.deployId = result.deployResult.deployId;
             }
         }
+        if (result && !result.succeeded) {
+            if (formatOutputAsJson) {
+                uiLogger.json(jsonOutput);
+            }
+            return exit(EXIT_CODES.ERROR);
+        }
+        if (!result && !uploadError) {
+            return exit(EXIT_CODES.ERROR);
+        }
     }
     catch (e) {
         logError(e, new ApiErrorContext({
@@ -127,11 +164,37 @@ function projectUploadBuilder(yargs) {
             hidden: true,
             default: false,
         },
+        'skip-npm-audit': {
+            describe: commands.project.upload.options.skipNpmAudit.describe,
+            type: 'boolean',
+            default: false,
+        },
         profile: {
             type: 'string',
             alias: 'p',
             describe: commands.project.upload.options.profile.describe,
         },
+        preview: {
+            describe: commands.project.upload.options.preview.describe,
+            type: 'boolean',
+            default: false,
+            hidden: true,
+        },
+        target: {
+            describe: commands.project.upload.options.target.describe,
+            type: 'number',
+            requiresArg: true,
+            hidden: true,
+        },
+    });
+    yargs.check(argv => {
+        if (argv.preview && argv.target == null) {
+            throw new Error(commands.project.upload.errors.previewRequiresTarget);
+        }
+        if (argv.target != null && !argv.preview) {
+            throw new Error(commands.project.upload.errors.targetRequiresPreview);
+        }
+        return true;
     });
     yargs.conflicts('profile', 'account');
     yargs.example([
@@ -140,6 +203,11 @@ function projectUploadBuilder(yargs) {
             '$0 project upload --profile=profileName',
             commands.project.upload.examples.withProfile,
         ],
+        // TODO: Unhide when 2026.09 ships
+        // [
+        //   '$0 project upload --preview --target=12345',
+        //   commands.project.upload.examples.withPreview,
+        // ],
     ]);
     return yargs;
 }
@@ -153,7 +221,7 @@ const builder = makeYargsBuilder(projectUploadBuilder, command, describe, {
 const projectUploadCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('project-upload', handler),
+    handler: makeWrappedYargsHandler('project-upload', handler),
     builder,
 };
 export default projectUploadCommand;

package/commands/project/validate.js

@@ -4,7 +4,7 @@ import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { uiLogger } from '../../lib/ui/logger.js';
 import { getProjectConfig, validateProjectConfig, } from '../../lib/projects/config.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { validateSourceDirectory, handleTranslate, } from '../../lib/projects/upload.js';
 import { commands } from '../../lang/en.js';
@@ -150,7 +150,7 @@ const builder = makeYargsBuilder(projectValidateBuilder, command, describe, {
 const projectValidateCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('project-validate', handler),
+    handler: makeWrappedYargsHandler('project-validate', handler),
     builder,
 };
 export default projectValidateCommand;