@hubspot/cli 8.6.0-beta.1 → 8.7.0-beta.0

package/commands/project/watch.js

@@ -12,7 +12,7 @@ import { handleProjectUpload } from '../../lib/projects/upload.js';
 import { pollBuildStatus, pollDeployStatus, } from '../../lib/projects/pollProjectBuildAndDeploy.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { handleKeypress, handleExit } from '../../lib/process.js';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { uiDeprecatedTag } from '../../lib/ui/index.js';
 const command = 'watch';
@@ -146,7 +146,7 @@ const builder = makeYargsBuilder(projectWatchBuilder, command, describe, {
 const projectWatchCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('project-watch', handler),
+    handler: makeWrappedYargsHandler('project-watch', handler),
     builder,
 };
 export default projectWatchCommand;

package/commands/project.js

@@ -15,6 +15,7 @@ import installDeps from './project/installDeps.js';
 import lint from './project/lint.js';
 import updateDeps from './project/updateDeps.js';
 import profile from './project/profile.js';
+import release from './project/release.js';
 import projectValidate from './project/validate.js';
 import list from './project/list.js';
 import info from './project/info.js';
@@ -66,6 +67,7 @@ function projectBuilder(yargs) {
         .command(lint)
         .command(updateDeps)
         .command(profile)
+        .command(release)
         .command(projectValidate)
         .command(appInstallStatus)
         .demandCommand(1, '');

package/commands/sandbox/create.js

@@ -12,7 +12,7 @@ import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { logError } from '../../lib/errorHandlers/index.js';
 import { buildV2Sandbox } from '../../lib/buildAccount.js';
 import { hubspotAccountNamePrompt } from '../../lib/prompts/accountNamePrompt.js';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'create';
 const describe = uiBetaTag(commands.sandbox.subcommands.create.describe, false);
@@ -150,7 +150,7 @@ const builder = makeYargsBuilder(sandboxCreateBuilder, command, describe, {
 const sandboxCreateCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('sandbox-create', handler),
+    handler: makeWrappedYargsHandler('sandbox-create', handler),
     builder,
 };
 export default sandboxCreateCommand;

package/commands/sandbox/delete.js

@@ -11,7 +11,7 @@ import { selectAccountFromConfig } from '../../lib/prompts/accountsPrompt.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { uiAuthCommandReference, uiBetaTag } from '../../lib/ui/index.js';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'delete';
 const describe = uiBetaTag(commands.sandbox.subcommands.delete.describe, false);
@@ -182,7 +182,7 @@ const builder = makeYargsBuilder(sandboxDeleteBuilder, command, describe, {
 const sandboxDeleteCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('sandbox-delete', handler),
+    handler: makeWrappedYargsHandler('sandbox-delete', handler),
     builder,
 };
 export default sandboxDeleteCommand;

package/commands/secret/addSecret.js

@@ -4,7 +4,7 @@ import { secretValuePrompt, secretNamePrompt, } from '../../lib/prompts/secretPr
 import { commands } from '../../lang/en.js';
 import { uiLogger } from '../../lib/ui/logger.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';
 const command = 'add [name]';
 const describe = commands.secret.subcommands.add.describe;
@@ -51,7 +51,7 @@ const builder = makeYargsBuilder(addSecretBuilder, command, describe, {
 const addSecretCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('secrets-add', handler),
+    handler: makeWrappedYargsHandler('secrets-add', handler),
     builder,
 };
 export default addSecretCommand;

package/commands/secret/deleteSecret.js

@@ -5,7 +5,7 @@ import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { ApiErrorContext, logError } from '../../lib/errorHandlers/index.js';
 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 { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'delete [name]';
 const describe = commands.secret.subcommands.delete.describe;
@@ -64,7 +64,7 @@ const builder = makeYargsBuilder(deleteSecretBuilder, command, describe, {
 const deleteSecretCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('secrets-delete', handler),
+    handler: makeWrappedYargsHandler('secrets-delete', handler),
     builder,
 };
 export default deleteSecretCommand;

package/commands/secret/listSecret.js

@@ -3,7 +3,7 @@ import { logError, ApiErrorContext } from '../../lib/errorHandlers/index.js';
 import { uiAccountDescription } from '../../lib/ui/index.js';
 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 { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'list';
 const describe = commands.secret.subcommands.list.describe;
@@ -36,7 +36,7 @@ const builder = makeYargsBuilder(listSecretBuilder, command, describe, {
 const listSecretCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('secrets-list', handler),
+    handler: makeWrappedYargsHandler('secrets-list', handler),
     builder,
 };
 export default listSecretCommand;

package/commands/secret/updateSecret.js

@@ -4,7 +4,7 @@ import { ApiErrorContext, logError } from '../../lib/errorHandlers/index.js';
 import { secretValuePrompt, secretListPrompt, } from '../../lib/prompts/secretPrompt.js';
 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 { makeYargsBuilder } from '../../lib/yargsUtils.js';
 const command = 'update [name]';
 const describe = commands.secret.subcommands.update.describe;
@@ -50,7 +50,7 @@ const builder = makeYargsBuilder(updateSecretBuilder, command, describe, {
 const updateSecretCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('secrets-update', handler),
+    handler: makeWrappedYargsHandler('secrets-update', handler),
     builder,
 };
 export default updateSecretCommand;

package/commands/testAccount/create.js

@@ -3,7 +3,7 @@ import path from 'path';
 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 { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { promptUser, listPrompt } from '../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
@@ -230,7 +230,7 @@ const builder = makeYargsBuilder(createTestAccountBuilder, command, describe, {
 const createTestAccountCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('test-account-create', handler),
+    handler: makeWrappedYargsHandler('test-account-create', handler),
     builder,
 };
 export default createTestAccountCommand;

package/commands/testAccount/createConfig.js

@@ -1,7 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { getCwd } from '@hubspot/local-dev-lib/path';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
@@ -85,7 +85,7 @@ const builder = makeYargsBuilder(createTestAccountConfigBuilder, command, descri
 const createTestAccountConfigCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('test-account-create-config', handler),
+    handler: makeWrappedYargsHandler('test-account-create-config', handler),
     builder,
 };
 export default createTestAccountConfigCommand;

package/commands/testAccount/delete.js

@@ -1,5 +1,5 @@
 import { fetchDeveloperTestAccounts, deleteDeveloperTestAccount, } from '@hubspot/local-dev-lib/api/developerTestAccounts';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { uiLogger } from '../../lib/ui/logger.js';
@@ -191,7 +191,7 @@ const builder = makeYargsBuilder(deleteTestAccountBuilder, command, describe, {
 const deleteTestAccountCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('test-account-delete', handler),
+    handler: makeWrappedYargsHandler('test-account-delete', handler),
     builder,
 };
 export default deleteTestAccountCommand;

package/commands/testAccount/importData.js

@@ -1,6 +1,6 @@
 import { getImportDataRequest } from '@hubspot/local-dev-lib/crm';
 import { logError } from '../../lib/errorHandlers/index.js';
-import { makeYargsHandlerWithUsageTracking } from '../../lib/yargs/makeYargsHandlerWithUsageTracking.js';
+import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { importDataFilePathPrompt } from '../../lib/prompts/importDataFilePathPrompt.js';
@@ -55,6 +55,6 @@ const crmImportDataCommand = {
     command,
     describe,
     builder,
-    handler: makeYargsHandlerWithUsageTracking('crm-import-data', handler),
+    handler: makeWrappedYargsHandler('crm-import-data', handler),
 };
 export default crmImportDataCommand;

package/commands/upgrade.js

@@ -1,7 +1,7 @@
 import { isConfigFlagEnabled } from '@hubspot/local-dev-lib/config';
 import { CONFIG_FLAGS } from '@hubspot/local-dev-lib/constants/config';
 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 { uiLogger } from '../lib/ui/logger.js';
 import { commands } from '../lang/en.js';
@@ -112,7 +112,7 @@ const builder = makeYargsBuilder(upgradeBuilder, command, describe, {
 const upgradeCommand = {
     command,
     describe,
-    handler: makeYargsHandlerWithUsageTracking('upgrade', handler),
+    handler: makeWrappedYargsHandler('upgrade', handler),
     builder,
 };
 export default upgradeCommand;

package/lang/en.d.ts

@@ -1729,6 +1729,67 @@ export declare const commands: {
                 deployLatestBuild: string;
             };
         };
+        release: {
+            describe: string;
+            create: {
+                describe: string;
+                verboseDescribe: string;
+                confirmPrompt: (projectName: string, buildId: number) => string;
+                success: (releaseTag: string, buildId: number) => string;
+                cancelled: string;
+                errors: {
+                    projectNotFound: (accountId: number, projectName: string) => string;
+                    noDeployedBuild: string;
+                    buildNotFound: (buildId: number, projectName: string) => string;
+                    buildNotDeployed: (buildId: number) => string;
+                };
+                options: {
+                    build: string;
+                    force: string;
+                };
+                examples: {
+                    default: string;
+                    withBuild: string;
+                };
+            };
+            list: {
+                describe: string;
+                verboseDescribe: string;
+                noReleases: string;
+                showingReleases: (count: number, projectName: string) => string;
+                continueOrExitPrompt: string;
+                errors: {
+                    projectNotFound: (accountId: number, projectName: string) => string;
+                };
+                options: {
+                    limit: string;
+                };
+                examples: {
+                    default: string;
+                    withLimit: string;
+                };
+            };
+            info: {
+                describe: string;
+                verboseDescribe: string;
+                releaseDetails: (releaseTag: string, projectName: string) => string;
+                components: string;
+                noComponents: string;
+                moreReleasesHint: string;
+                selectRelease: (projectName: string) => string;
+                errors: {
+                    releaseNotFound: (releaseTag: string, projectName: string) => string;
+                    noReleases: string;
+                };
+                options: {
+                    tag: string;
+                };
+                examples: {
+                    default: string;
+                    json: string;
+                };
+            };
+        };
         listBuilds: {
             describe: string;
             continueOrExitPrompt: string;
@@ -1805,6 +1866,7 @@ export declare const commands: {
             examples: {
                 default: string;
                 withProfile: string;
+                withPreview: string;
             };
             logs: {
                 buildSucceeded: (buildId: number) => string;
@@ -1815,6 +1877,8 @@ export declare const commands: {
             errors: {
                 noProjectConfig: string;
                 projectLockedError: string;
+                previewRequiresTarget: string;
+                targetRequiresPreview: string;
             };
             options: {
                 forceCreate: {
@@ -1826,6 +1890,15 @@ export declare const commands: {
                 profile: {
                     describe: string;
                 };
+                skipNpmAudit: {
+                    describe: string;
+                };
+                preview: {
+                    describe: string;
+                };
+                target: {
+                    describe: string;
+                };
             };
         };
         watch: {
@@ -3089,6 +3162,9 @@ export declare const lib: {
     process: {
         exitDebug: (signal: string) => string;
     };
+    handlerLogFile: {
+        saved: (filePath: string) => string;
+    };
     DevServerManager: {
         portConflict: (port: string) => string;
         notInitialized: string;
@@ -3391,8 +3467,24 @@ export declare const lib: {
             updatingPackageJsonWorkspaces: (packageJsonPath: string) => string;
             updatedWorkspaces: (workspaces: string) => string;
             updatedFileDependency: (packageName: string, relativePath: string) => string;
+            lintPackagesNotConfigured: (packageRoot: string) => string;
+            lintConfigNotFound: (packageRoot: string) => string;
+            lintHubSpotRulesNotActive: (packageRoot: string) => string;
+            npmAuditClean: (packageRoot: string) => string;
+            npmAuditIssues: (packageRoot: string, details: string) => string;
+            npmAuditNpmUnavailable: (packageRoot: string) => string;
+            npmAuditNonZeroExit: (packageRoot: string, exitCode: number) => string;
         };
     };
+    projectPreview: {
+        triggeringPreview: (buildId: number, targetPortalId: number) => string;
+        pollingStatus: (releaseTag: string, targetPortalId: number) => string;
+        succeeded: (releaseTag: string, targetPortalId: number) => string;
+        triggerFailed: string;
+        pollFailed: string;
+        warning: string;
+        missingProjectId: string;
+    };
     importData: {
         errors: {
             incorrectAccountType: (derivedAccountId: number) => string;

package/lang/en.js

@@ -1746,6 +1746,67 @@ export const commands = {
                 deployLatestBuild: 'Deploy the latest build of the current project',
             },
         },
+        release: {
+            describe: 'Manage project releases.',
+            create: {
+                describe: 'Create a release for a project build.',
+                verboseDescribe: `Create a release for a project build\n\nReleases mark a deployed build with an auto-generated semantic version tag (e.g. v1.0.0). The build must have been successfully deployed before it can be released.\n\nBy default, the latest deployed build is used. Use ${uiCommandReference('--build')} to specify a different build ID.`,
+                confirmPrompt: (projectName, buildId) => `Create a release for project ${chalk.bold(projectName)} using build ${chalk.bold(String(buildId))}?`,
+                success: (releaseTag, buildId) => `Release ${chalk.bold(releaseTag)} created for build ${chalk.bold(String(buildId))}.`,
+                cancelled: 'Release creation cancelled.',
+                errors: {
+                    projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
+                    noDeployedBuild: `No deployed build found for this project. Run ${uiCommandReference('hs project deploy')} first.`,
+                    buildNotFound: (buildId, projectName) => `Build ${chalk.bold(String(buildId))} was not found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds or ${uiCommandReference('hs project deploy')} to deploy a build first.`,
+                    buildNotDeployed: (buildId) => `Build ${chalk.bold(String(buildId))} has not been deployed. Run ${uiCommandReference('hs project deploy')} first.`,
+                },
+                options: {
+                    build: 'Build ID to release. Defaults to the latest deployed build.',
+                    force: 'Skip confirmation prompt.',
+                },
+                examples: {
+                    default: 'Create a release for the latest deployed build',
+                    withBuild: 'Create a release for a specific build',
+                },
+            },
+            list: {
+                describe: 'List releases for the current project.',
+                verboseDescribe: `List releases for the current project\n\nDisplays all releases in sorted order, newest first. Includes the version tag, build ID, and creation date. Use ${uiCommandReference('--limit')} to control how many results are shown.`,
+                noReleases: 'No releases found for this project.',
+                showingReleases: (count, projectName) => `Showing ${count} release${count === 1 ? '' : 's'} for ${chalk.bold(projectName)}:`,
+                continueOrExitPrompt: 'Press <enter> to load more, or ctrl+c to exit',
+                errors: {
+                    projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
+                },
+                options: {
+                    limit: 'Number of releases to show',
+                },
+                examples: {
+                    default: 'List releases for the current project',
+                    withLimit: 'Show only the 5 most recent releases',
+                },
+            },
+            info: {
+                describe: 'Show details about a specific release.',
+                verboseDescribe: `Show details about a specific release\n\nDisplays the release tag, build ID, creation date, and list of components included in the release. Use ${uiCommandReference('--json')} for machine-readable output.`,
+                releaseDetails: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} for ${chalk.bold(projectName)}:`,
+                components: 'Components:',
+                noComponents: 'No components found for this release.',
+                moreReleasesHint: `Not all releases are shown. Use ${uiCommandReference('--tag')} to look up an older release directly.`,
+                selectRelease: (projectName) => `Select a release for ${chalk.bold(projectName)}`,
+                errors: {
+                    releaseNotFound: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} was not found for project ${chalk.bold(projectName)}. Verify the project has been uploaded and the release tag exists. Run ${uiCommandReference('hs project release list')} to view existing releases.`,
+                    noReleases: 'No releases found for this project.',
+                },
+                options: {
+                    tag: 'Release tag to look up (e.g. v1.0.0)',
+                },
+                examples: {
+                    default: 'Show details about a specific release',
+                    json: 'Output release details as JSON',
+                },
+            },
+        },
         listBuilds: {
             describe: "List the project's builds.",
             continueOrExitPrompt: 'Press <enter> to load more, or ctrl+c to exit',
@@ -1822,6 +1883,7 @@ export const commands = {
             examples: {
                 default: 'Upload a project into your HubSpot account',
                 withProfile: 'Upload a project into your HubSpot account when using profiles',
+                withPreview: 'Upload and preview the build on a target portal',
             },
             logs: {
                 buildSucceeded: (buildId) => `Build #${buildId} succeeded\n`,
@@ -1832,6 +1894,8 @@ export const commands = {
             errors: {
                 noProjectConfig: 'No project detected. Run this command from a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${uiCommandReference('hs project dev')} command for this project. If this is you, unlock the project in Projects UI.`,
+                previewRequiresTarget: `${uiCommandReference('--preview')} requires ${uiCommandReference('--target=<portalId>')} to specify the portal to preview on.`,
+                targetRequiresPreview: `${uiCommandReference('--target')} can only be used with ${uiCommandReference('--preview')}.`,
             },
             options: {
                 forceCreate: {
@@ -1843,6 +1907,15 @@ export const commands = {
                 profile: {
                     describe: 'Profile to target for this upload',
                 },
+                skipNpmAudit: {
+                    describe: 'Skip the npm audit security check before uploading',
+                },
+                preview: {
+                    describe: 'Preview the build on a target portal after a successful upload',
+                },
+                target: {
+                    describe: 'Portal ID to preview the build on',
+                },
             },
         },
         watch: {
@@ -3115,6 +3188,9 @@ export const lib = {
     process: {
         exitDebug: (signal) => `Attempting to gracefully exit. Triggered by ${signal}`,
     },
+    handlerLogFile: {
+        saved: (filePath) => `Debug logs can be viewed at ${filePath}`,
+    },
     DevServerManager: {
         portConflict: (port) => `The port ${port} is already in use.`,
         notInitialized: 'The Dev Server Manager must be initialized before it is started.',
@@ -3417,8 +3493,24 @@ export const lib = {
             updatingPackageJsonWorkspaces: (packageJsonPath) => `Updating package.json workspaces in archive: ${packageJsonPath}`,
             updatedWorkspaces: (workspaces) => `  Updated workspaces: ${workspaces}`,
             updatedFileDependency: (packageName, relativePath) => `  Updated dependencies.${packageName}: file:${relativePath}`,
+            lintPackagesNotConfigured: (packageRoot) => `Project lint: lint packages not installed for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to install them.`,
+            lintConfigNotFound: (packageRoot) => `Project lint: ESLint configuration not found for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to create an ESLint config.`,
+            lintHubSpotRulesNotActive: (packageRoot) => `Project lint: HubSpot ESLint rules not active for ${chalk.bold(packageRoot)}. Configure ${chalk.bold('@hubspot/eslint-config-ui-extensions')} — see ${uiLink('setup instructions', 'https://www.npmjs.com/package/@hubspot/eslint-config-ui-extensions')}.`,
+            npmAuditClean: (packageRoot) => `npm audit: No npm dependency issues found for ${chalk.bold(packageRoot)}`,
+            npmAuditIssues: (packageRoot, details) => `npm audit: security issues found for ${chalk.bold(packageRoot)}: ${details}`,
+            npmAuditNpmUnavailable: (packageRoot) => `npm audit: skipped for ${chalk.bold(packageRoot)} (npm not available in PATH)`,
+            npmAuditNonZeroExit: (packageRoot, exitCode) => `npm audit: ${chalk.bold(packageRoot)} exited with code ${exitCode}`,
         },
     },
+    projectPreview: {
+        triggeringPreview: (buildId, targetPortalId) => `Previewing build #${buildId} on ${uiAccountDescription(targetPortalId)}`,
+        pollingStatus: (releaseTag, targetPortalId) => `Previewing ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
+        succeeded: (releaseTag, targetPortalId) => `Previewed ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
+        triggerFailed: 'Failed to trigger preview',
+        pollFailed: 'Failed to poll preview status',
+        warning: 'The build succeeded but the preview failed. You can manually preview this build from the project UI.',
+        missingProjectId: 'Unable to preview: could not resolve the project ID.',
+    },
     importData: {
         errors: {
             incorrectAccountType: (derivedAccountId) => `The account ${uiAccountDescription(derivedAccountId)} is not a standard account, developer test account, or app developer account.`,

package/lib/api/usageTracking.d.ts

@@ -0,0 +1,29 @@
+export type ConfigType = 'local' | 'global';
+export type ExecutionSource = 'ci' | 'mcp' | 'user';
+export type UsageTrackingMeta = {
+    action?: string;
+    os?: string;
+    nodeVersion?: string;
+    nodeMajorVersion?: string;
+    version?: string;
+    command?: string;
+    authType?: string;
+    step?: string;
+    assetType?: string;
+    mode?: string;
+    type?: string | number;
+    file?: boolean;
+    successful?: boolean;
+    configType?: ConfigType;
+    executionSource?: ExecutionSource;
+    platformVersion?: string;
+    executionTime?: number;
+};
+export type UsageTrackingRequest = {
+    portalId?: number;
+    accountId?: number;
+    eventName: string;
+    eventClass: string;
+    meta: UsageTrackingMeta;
+};
+export declare function sendUsageEvent(request: UsageTrackingRequest): Promise<void>;

package/lib/api/usageTracking.js

@@ -0,0 +1,28 @@
+import { http } from '@hubspot/local-dev-lib/http';
+import { http as unauthedHttp } from '@hubspot/local-dev-lib/http/unauthed';
+import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
+const USAGE_PATH = 'local/dev/tools/proxy/v1/usage';
+const USAGE_AUTHENTICATED_PATH = `${USAGE_PATH}/authenticated`;
+export async function sendUsageEvent(request) {
+    const { accountId } = request;
+    if (accountId) {
+        try {
+            const account = getConfigAccountById(accountId);
+            if (account?.authType === 'personalaccesskey') {
+                await http.post(accountId, {
+                    url: USAGE_AUTHENTICATED_PATH,
+                    data: request,
+                });
+                return;
+            }
+        }
+        catch (_e) { }
+    }
+    try {
+        await unauthedHttp.post({
+            url: USAGE_PATH,
+            data: request,
+        });
+    }
+    catch (_e) { }
+}

package/lib/commonOpts.js

@@ -76,7 +76,6 @@ export function addJSONOutputOptions(yargs) {
         alias: 'format-output-as-json',
         describe: lib.commonOpts.options.jsonOutput,
         type: 'boolean',
-        hidden: true,
     });
 }
 // Remove this once we've upgraded to yargs 18.0.0

package/lib/constants.d.ts

@@ -4,6 +4,7 @@ export declare const FEEDBACK_INTERVAL: 10;
 export declare const HUBSPOT_FOLDER: "@hubspot";
 export declare const MARKETPLACE_FOLDER: "@marketplace";
 export declare const DEFAULT_POLLING_DELAY = 2000;
+export declare const PREVIEW_POLL_TIMEOUT: number;
 export declare const PROJECT_CONFIG_FILE: "hsproject.json";
 export declare const PROJECT_BUILD_STATES: {
     readonly BUILDING: "BUILDING";

package/lib/constants.js

@@ -4,6 +4,7 @@ export const FEEDBACK_INTERVAL = 10;
 export const HUBSPOT_FOLDER = '@hubspot';
 export const MARKETPLACE_FOLDER = '@marketplace';
 export const DEFAULT_POLLING_DELAY = 2000;
+export const PREVIEW_POLL_TIMEOUT = 5 * 60 * 1000;
 export const PROJECT_CONFIG_FILE = 'hsproject.json';
 export const PROJECT_BUILD_STATES = {
     BUILDING: 'BUILDING',

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

@@ -70,7 +70,7 @@ function projectUploadCallback(accountId, projectConfig, tempFile, exit, buildId
         uiLogger.error(lib.localDevHelpers.project.createInitialBuildForNewProject.genericError);
         return exit(EXIT_CODES.ERROR);
     }
-    return pollProjectBuildAndDeploy(accountId, projectConfig, tempFile, buildId, true);
+    return pollProjectBuildAndDeploy(accountId, projectConfig, tempFile, buildId, { silenceLogs: true });
 }
 // Create an initial build if the project was newly created in the account
 // Return the newly deployed build

package/lib/projects/npmAuditOnUpload.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedPackageJson } from '@hubspot/project-parsing-lib/workspaces';
+export declare function summarizeNpmAuditJson(source: string): string | null;
+type RunNpmAuditsBeforeProjectUploadArgs = {
+    srcDir: string;
+    projectDir: string;
+    parsedPackageJsons: ParsedPackageJson[];
+    isLegacyPlatform: boolean;
+};
+export declare function runNpmAuditsBeforeProjectUpload({ srcDir, projectDir, parsedPackageJsons, isLegacyPlatform, }: RunNpmAuditsBeforeProjectUploadArgs): Promise<void>;
+export {};