@hubspot/cli 8.0.11-experimental.1 → 8.0.12-experimental.0

package/commands/project/migrate.js

@@ -1,7 +1,7 @@
 import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
 import { migrateApp } from '../../lib/app/migrate.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
-import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
+import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
@@ -14,7 +14,7 @@ import { getHasMigratableThemes, migrateThemesV2, } from '../../lib/theme/migrat
 import { hasFeature } from '../../lib/hasFeature.js';
 import { FEATURES } from '../../lib/constants.js';
 import { trackCommandMetadataUsage } from '../../lib/usageTracking.js';
-const { v2025_2, v2026_03_beta, v2026_03 } = PLATFORM_VERSIONS;
+const { v2025_2, v2026_03_BETA, v2026_03 } = PLATFORM_VERSIONS;
 const command = 'migrate';
 const describe = commands.project.migrate.describe;
 async function handler(args) {
@@ -41,7 +41,7 @@ async function handler(args) {
             await migrateThemesV2(derivedAccountId, {
                 ...args,
                 platformVersion: unstable
-                    ? PLATFORM_VERSIONS.unstable
+                    ? PLATFORM_VERSIONS.UNSTABLE
                     : platformVersion,
             }, migratableThemesCount, projectConfig);
         }
@@ -50,7 +50,7 @@ async function handler(args) {
                 ...args,
                 name: projectConfig?.projectConfig?.name,
                 platformVersion: unstable
-                    ? PLATFORM_VERSIONS.unstable
+                    ? PLATFORM_VERSIONS.UNSTABLE
                     : platformVersion,
             }, projectConfig);
         }
@@ -67,7 +67,7 @@ function projectMigrateBuilder(yargs) {
     yargs
         .option('platform-version', {
         type: 'string',
-        choices: [v2025_2, v2026_03_beta, v2026_03],
+        choices: [v2025_2, v2026_03_BETA, v2026_03],
         default: v2026_03,
     })
         .option('unstable', {

package/commands/project/profile/add.js

@@ -3,7 +3,7 @@ import fs from 'fs';
 import { getConfigAccountIfExists, getAllConfigAccounts, } from '@hubspot/local-dev-lib/config';
 import { getAllHsProfiles, getHsProfileFilename, loadHsProfileFile, } from '@hubspot/project-parsing-lib/profiles';
 import { getProjectConfig } from '../../../lib/projects/config.js';
-import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { uiAccountDescription } from '../../../lib/ui/index.js';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
@@ -57,7 +57,7 @@ async function handler(args) {
         uiLogger.error(commands.project.profile.add.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.profile.add.errors.unsupportedPlatformVersion);
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/profile/delete.js

@@ -4,7 +4,7 @@ import { getAllHsProfiles, getHsProfileFilename, loadHsProfileFile, } from '@hub
 import { fetchProject, deleteProject, } from '@hubspot/local-dev-lib/api/projects';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { getProjectConfig } from '../../../lib/projects/config.js';
-import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { uiLogger } from '../../../lib/ui/logger.js';
 import { EXIT_CODES } from '../../../lib/enums/exitCodes.js';
 import { makeYargsHandlerWithUsageTracking } from '../../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
@@ -23,7 +23,7 @@ async function handler(args) {
         uiLogger.error(commands.project.profile.delete.errors.noProjectConfig);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.profile.delete.errors.unsupportedPlatformVersion);
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/upload.d.ts

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

package/commands/project/upload.js

@@ -2,13 +2,14 @@ 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 { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } 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';
 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';
@@ -18,7 +19,7 @@ import { projectProfilePrompt } from '../../lib/prompts/projectProfilePrompt.js'
 const command = 'upload';
 const describe = commands.project.upload.describe;
 async function handler(args) {
-    const { forceCreate, message, derivedAccountId, skipValidation, formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, exit, addUsageMetadata, } = args;
+    const { forceCreate, message, derivedAccountId, skipValidation, formatOutputAsJson, profile: profileOption, useEnv: useEnvOption, preview, target: targetPortalId, exit, addUsageMetadata, } = args;
     const jsonOutput = {};
     const { projectConfig, projectDir } = await getProjectConfig();
     try {
@@ -34,7 +35,7 @@ async function handler(args) {
     }
     let targetAccountId;
     let profileName = args.profile;
-    if (isV2Project(projectConfig?.platformVersion)) {
+    if (!isLegacyProject(projectConfig?.platformVersion)) {
         try {
             const profileNamePromptResult = await projectProfilePrompt(projectDir, projectConfig, profileOption, !!useEnvOption);
             if (profileNamePromptResult) {
@@ -56,7 +57,7 @@ async function handler(args) {
         assetType: projectConfig.platformVersion,
     });
     try {
-        const { result, uploadError } = await handleProjectUpload({
+        const { result, uploadError, projectId } = await handleProjectUpload({
             accountId: targetAccountId,
             projectConfig,
             projectDir,
@@ -64,7 +65,7 @@ async function handler(args) {
             uploadMessage: message,
             forceCreate,
             isUploadCommand: true,
-            sendIR: isV2Project(projectConfig.platformVersion),
+            sendIR: !isLegacyProject(projectConfig.platformVersion),
             skipValidation,
             profile: profileName,
         });
@@ -90,6 +91,23 @@ async function handler(args) {
             logFeedbackMessage(result.buildId);
             await displayWarnLogs(targetAccountId, projectConfig.name, result.buildId);
         }
+        if (result && result.succeeded && preview && targetPortalId) {
+            if (!projectId) {
+                uiLogger.warn(lib.projectPreview.missingProjectId);
+            }
+            else {
+                const previewResult = await triggerAndPollPreview(targetAccountId, projectId, result.buildId, targetPortalId);
+                if (!previewResult.succeeded) {
+                    uiLogger.warn(lib.projectPreview.warning);
+                }
+                if (formatOutputAsJson) {
+                    jsonOutput.preview = {
+                        releaseTag: previewResult.releaseTag,
+                        succeeded: previewResult.succeeded,
+                    };
+                }
+            }
+        }
         if (result && result.succeeded && formatOutputAsJson) {
             jsonOutput.buildId = result.buildId;
             if (result.deployResult) {
@@ -132,14 +150,28 @@ function projectUploadBuilder(yargs) {
             alias: 'p',
             describe: commands.project.upload.options.profile.describe,
         },
+        preview: {
+            describe: commands.project.upload.options.preview.describe,
+            type: 'boolean',
+            default: false,
+        },
+        target: {
+            describe: commands.project.upload.options.target.describe,
+            type: 'number',
+        },
     });
     yargs.conflicts('profile', 'account');
+    yargs.implies('preview', 'target');
     yargs.example([
         ['$0 project upload', commands.project.upload.examples.default],
         [
             '$0 project upload --profile=profileName',
             commands.project.upload.examples.withProfile,
         ],
+        [
+            '$0 project upload --preview --target=12345',
+            commands.project.upload.examples.withPreview,
+        ],
     ]);
     return yargs;
 }

package/commands/project/validate.js

@@ -1,6 +1,6 @@
 import path from 'path';
 import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+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';
@@ -24,7 +24,7 @@ async function handler(args) {
         uiLogger.error(commands.project.validate.mustBeRanWithinAProject);
         return exit(EXIT_CODES.ERROR);
     }
-    if (!isV2Project(projectConfig.platformVersion)) {
+    if (isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.validate.badVersion);
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project/watch.js

@@ -1,6 +1,6 @@
 import { cancelStagedBuild, fetchProjectBuilds, } from '@hubspot/local-dev-lib/api/projects';
 import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
-import { isV2Project } from '../../lib/projects/platformVersion.js';
+import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { commands } from '../../lang/en.js';
 import { createWatcher } from '../../lib/projects/watch.js';
 import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
@@ -62,7 +62,7 @@ async function handler(args) {
         uiLogger.error(commands.project.watch.errors.projectConfigNotFound);
         return exit(EXIT_CODES.ERROR);
     }
-    if (isV2Project(projectConfig.platformVersion)) {
+    if (!isLegacyProject(projectConfig.platformVersion)) {
         uiLogger.error(commands.project.watch.errors.v2ApiError(projectConfig.platformVersion));
         return exit(EXIT_CODES.ERROR);
     }

package/commands/project.js

@@ -19,9 +19,10 @@ import projectValidate from './project/validate.js';
 import list from './project/list.js';
 import info from './project/info.js';
 import deleteProject from './project/delete.js';
+import appInstallStatus from './project/appInstallStatus.js';
 import { makeYargsBuilder } from '../lib/yargsUtils.js';
 import { getProjectConfig } from '../lib/projects/config.js';
-import { isUnsupportedPlatformVersion, LATEST_SUPPORTED_PLATFORM_VERSION, } from '../lib/projects/platformVersion.js';
+import { isSupportedPlatformVersion, 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'];
@@ -31,8 +32,11 @@ const describe = commands.project.describe;
 async function validatePlatformVersion() {
     try {
         const { projectConfig } = await getProjectConfig();
-        if (isUnsupportedPlatformVersion(projectConfig?.platformVersion)) {
-            uiLogger.warn(lib.projects.platformVersion.unsupported(pkg.version, LATEST_SUPPORTED_PLATFORM_VERSION, projectConfig?.platformVersion));
+        // 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)) {
+            uiLogger.warn(lib.projects.platformVersion.unsupported(pkg.version, LATEST_SUPPORTED_PLATFORM_VERSION, projectConfig.platformVersion));
             uiLogger.log('');
         }
     }
@@ -63,6 +67,7 @@ function projectBuilder(yargs) {
         .command(updateDeps)
         .command(profile)
         .command(projectValidate)
+        .command(appInstallStatus)
         .demandCommand(1, '');
     return yargs;
 }

package/commands/testAccount/create.js

@@ -44,14 +44,14 @@ function readConfigFile(configPath) {
 async function promptForConfigPath() {
     const createTestAccountFromConfig = await listPrompt(commands.testAccount.create.createTestAccountFromConfigPrompt, {
         choices: [
-            {
-                name: commands.testAccount.create.createFromConfigOption,
-                value: true,
-            },
             {
                 name: commands.testAccount.create.createFromScratchOption,
                 value: false,
             },
+            {
+                name: commands.testAccount.create.createFromConfigOption,
+                value: true,
+            },
         ],
     });
     if (createTestAccountFromConfig) {

package/lang/en.d.ts

@@ -178,6 +178,58 @@ export declare const commands: {
                     defaultAccountUpdated: (accountName: string) => string;
                 };
             };
+            link: {
+                describe: string;
+                verboseDescribe: string;
+                shared: {
+                    noLinkedAccounts: string;
+                    globalAccountsAvailable: (count: number) => string;
+                    configurePrompt: string;
+                    deprecatedConfigNotSupported: (command: string) => string;
+                    writeSettingsFailed: (path: string, err: unknown) => string;
+                    savedToSettings: (path: string) => string;
+                };
+                linkingDirectory: (dir: string) => string;
+                managingLinkedAccounts: (dir: string) => string;
+                settingsInfo: (path: string) => string;
+                success: {
+                    created: (path: string) => string;
+                };
+                errors: {
+                    authFailed: string;
+                };
+                events: {
+                    accountsLinked: (count: number) => string;
+                    accountsUnlinked: (count: number) => string;
+                    overrideAccountDetected: (accountId: number) => string;
+                    defaultAccountSet: (accountId: number) => string;
+                    defaultAccountRemoved: (isSelectionRequired: boolean) => string;
+                    defaultAccountRemains: (accountId: number) => string;
+                    updatedLinkedAccounts: string;
+                    noAccountsLinked: string;
+                    overrideFileRemoved: string;
+                    invalidDefaultAccount: (accountId: number) => string;
+                };
+                prompts: {
+                    howToProceed: string;
+                    whatToDo: string;
+                    linkExisting: string;
+                    authenticateNew: string;
+                    cancel: string;
+                    selectDefault: string;
+                    selectToLink: string;
+                    selectToUnlink: string;
+                    alreadyLinked: string;
+                    fromHsAccount: string;
+                    newlyAuthenticated: string;
+                    mustSelectOne: string;
+                    keepAsDefault: string;
+                };
+            };
+            unlink: {
+                describe: string;
+                verboseDescribe: string;
+            };
             remove: {
                 describe: string;
                 logs: {
@@ -1458,6 +1510,9 @@ export declare const commands: {
                 failedToFetchProjectList: string;
                 cannotNestProjects: (projectDir: string) => string;
             };
+            warnings: {
+                betaPlatformVersion: (platformVersion: string) => string;
+            };
             logs: {
                 success: (projectName: string, projectDest: string) => string;
             };
@@ -1684,6 +1739,7 @@ export declare const commands: {
                 noFunctionsLinkText: string;
                 noFunctionsInProject: string;
                 noFunctionWithName: (name: string) => string;
+                functionNameRequired: string;
                 functionNotDeployed: (name: string) => string;
                 projectLogsManagerNotInitialized: string;
                 noDeployedBuild: string;
@@ -1729,6 +1785,7 @@ export declare const commands: {
             examples: {
                 default: string;
                 withProfile: string;
+                withPreview: string;
             };
             logs: {
                 buildSucceeded: (buildId: number) => string;
@@ -1750,6 +1807,12 @@ export declare const commands: {
                 profile: {
                     describe: string;
                 };
+                preview: {
+                    describe: string;
+                };
+                target: {
+                    describe: string;
+                };
             };
         };
         watch: {
@@ -1876,6 +1939,8 @@ export declare const commands: {
             }[]) => string;
             createEslintConfigPrompt: (directories: string[]) => string;
             eslintConfigCreated: (configPath: string) => string;
+            createEslintConfigRequiresV2Platform: (platformVersion?: string | null) => string;
+            failedToFetchRemoteEslintConfig: (platformVersion: string) => string;
             failedToCreateEslintConfig: (configPath: string) => string;
             eslintConfigRequired: string;
         };
@@ -2009,6 +2074,25 @@ export declare const commands: {
                 force: string;
             };
         };
+        installStatus: {
+            describe: string;
+            examples: {
+                default: string;
+                json: string;
+            };
+            errors: {
+                noProjectConfig: string;
+                unsupportedPlatformVersion: (platformVersion: string) => string;
+                failedToParseProject: string;
+                noAppInProject: string;
+                unsupportedAuthType: (authType: string) => string;
+            };
+            success: {
+                installed: (appName: string, accountId: number) => string;
+                installedWithOutdatedScopes: (appName: string, accountId: number) => string;
+            };
+            notInstalled: (appName: string, accountId: number) => string;
+        };
     };
     sandbox: {
         describe: string;
@@ -3290,6 +3374,16 @@ export declare const lib: {
             updatedFileDependency: (packageName: string, relativePath: string) => string;
         };
     };
+    projectPreview: {
+        triggeringPreview: (buildId: number, targetPortalId: number) => string;
+        pollingStatus: (releaseTag: string, targetPortalId: number) => string;
+        succeeded: (releaseTag: string, targetPortalId: number) => string;
+        triggerFailed: string;
+        pollFailed: string;
+        timeout: string;
+        warning: string;
+        missingProjectId: string;
+    };
     importData: {
         errors: {
             incorrectAccountType: (derivedAccountId: number) => string;
@@ -4036,6 +4130,7 @@ export declare const lib: {
     migrate: {
         componentsToBeMigrated: (components: string) => string;
         componentsThatWillNotBeMigrated: (components: string) => string;
+        legacyCrmCardMigrationDocs: () => string;
         sourceContentsMoved: (newLocation: string) => string;
         projectMigrationWarningTitle: (platformVersion: string) => string;
         projectMigrationWarning: (platformVersion: string) => string;