@hubspot/cli 8.1.2-experimental.3 → 8.1.4-experimental.0

package/commands/account/link.js

@@ -15,9 +15,7 @@ import { commands } from '../../lang/en.js';
 import { debugError } from '../../lib/errorHandlers/index.js';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 const command = 'link';
-// Hide the command until we're done testing and ready to make linking GA
-// const describe = commands.account.subcommands.link.describe;
-const describe = undefined;
+const describe = commands.account.subcommands.link.describe;
 async function handler(args) {
     const { exit } = args;
     if (hasDeprecatedConfigConflict(args._)) {

package/commands/account/unlink.js

@@ -11,9 +11,7 @@ import { commands } from '../../lang/en.js';
 import { DEFAULT_HS_SETTINGS_PATH } from '@hubspot/local-dev-lib/constants/config';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
 const command = 'unlink';
-// Hide the command until we're done testing and ready to make linking GA
-// const describe = commands.account.subcommands.link.describe;
-const describe = undefined;
+const describe = commands.account.subcommands.unlink.describe;
 async function handler(args) {
     const { exit } = args;
     if (hasDeprecatedConfigConflict(args._)) {

package/commands/cms/module/create.js

@@ -73,6 +73,12 @@ function moduleCreateBuilder(yargs) {
         type: 'boolean',
         default: false,
     });
+    yargs.option('available-for-new-content', {
+        describe: commands.cms.subcommands.module.subcommands.create.options
+            .availableForNewContent,
+        type: 'boolean',
+        default: true,
+    });
     return yargs;
 }
 const builder = makeYargsBuilder(moduleCreateBuilder, command, describe, {

package/commands/project/lint.js

@@ -1,5 +1,5 @@
 import path from 'path';
-import { getProjectPackageJsonLocations, installPackages, } from '../../lib/dependencyManagement.js';
+import { installPackages } from '../../lib/dependencyManagement.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';
 import { isPromptExitError } from '../../lib/errors/PromptExitError.js';
 import { getProjectConfig } from '../../lib/projects/config.js';
@@ -10,7 +10,7 @@ import { logError } from '../../lib/errorHandlers/index.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { promptUser } from '../../lib/prompts/promptUtils.js';
 import SpinniesManager from '../../lib/ui/SpinniesManager.js';
-import { areAllLintPackagesInstalled, getMissingLintPackages, getMissingLintScripts, addLintScriptsToPackageJson, lintPackages, displayLintResults, hasEslintConfig, hasDeprecatedEslintConfig, getDeprecatedEslintConfigFiles, createEslintConfig, REQUIRED_PACKAGES_AND_MIN_VERSIONS, } from '../../lib/projects/uieLinting.js';
+import { addLintScriptsToPackageJson, areAllLintPackagesInstalled, createEslintConfig, displayLintResults, getDeprecatedEslintConfigFiles, getMissingLintPackages, getMissingLintScripts, getUieLintablePackageJsonLocations, hasDeprecatedEslintConfig, hasEslintConfig, lintPackages, REQUIRED_PACKAGES_AND_MIN_VERSIONS, } from '../../lib/projects/uieLinting.js';
 import { clearPackageJsonCache } from '../../lib/npm/packageJson.js';
 const command = 'lint';
 const describe = commands.project.lint.help.describe;
@@ -26,7 +26,7 @@ async function handler(args) {
         SpinniesManager.add('lintCheck', {
             text: commands.project.lint.loading.checking,
         });
-        const lintLocations = await getProjectPackageJsonLocations();
+        const lintLocations = await getUieLintablePackageJsonLocations(projectConfig);
         const locationsReadyToLint = [];
         const locationsNeedingPackages = new Map();
         for (const lintLocation of lintLocations) {

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

@@ -0,0 +1,7 @@
+import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, JSONOutputArgs, YargsCommandModule } from '../../../types/Yargs.js';
+export type ProjectReleaseCreateArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & JSONOutputArgs & {
+    build?: number;
+    force: boolean;
+};
+declare const projectReleaseCreateCommand: YargsCommandModule<unknown, ProjectReleaseCreateArgs>;
+export default projectReleaseCreateCommand;

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/upload.js

@@ -124,6 +124,15 @@ async function handler(args) {
                 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({

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/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;

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',

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/projects/uieLinting.d.ts

@@ -1,3 +1,4 @@
+import { LoadedProjectConfig } from './config.js';
 export declare const REQUIRED_PACKAGES_AND_MIN_VERSIONS: {
     readonly eslint: "9.0.0";
     readonly '@eslint/js': "9.0.0";
@@ -23,6 +24,7 @@ export declare function hasEslintConfig(directory: string): boolean;
 export declare function hasDeprecatedEslintConfig(directory: string): boolean;
 export declare function getDeprecatedEslintConfigFiles(directory: string): string[];
 export declare function createEslintConfig(directory: string, platformVersion?: string | null): Promise<string>;
+export declare function getUieLintablePackageJsonLocations(projectConfig: LoadedProjectConfig): Promise<string[]>;
 export declare const HUBSPOT_UI_EXTENSIONS_RULE_PREFIX = "@hubspot/ui-extensions/";
 export declare function isHubSpotEslintConfigActive(directory: string): Promise<boolean>;
 export declare function lintPackagesInDirectory(directory: string, projectDir?: string): Promise<{

package/lib/projects/uieLinting.js

@@ -10,7 +10,8 @@ import { uiLogger } from '../ui/logger.js';
 import { clearPackageJsonCache, safeGetPackageJsonCached, } from '../npm/packageJson.js';
 import { debugError } from '../errorHandlers/index.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
-import { HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, DEFAULT_PROJECT_TEMPLATE_BRANCH, } from '../constants.js';
+import { DEFAULT_PROJECT_TEMPLATE_BRANCH, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, } from '../constants.js';
+import { CARDS_KEY, Components, PAGES_KEY, SETTINGS_KEY, } from '@hubspot/project-parsing-lib/constants';
 export const REQUIRED_PACKAGES_AND_MIN_VERSIONS = {
     eslint: '9.0.0',
     '@eslint/js': '9.0.0',
@@ -40,6 +41,11 @@ const DEPRECATED_ESLINT_CONFIG_FILES = [
     '.eslintrc.json',
     '.eslintrc',
 ];
+const UIE_COMPONENTS = [
+    Components[CARDS_KEY],
+    Components[SETTINGS_KEY],
+    Components[PAGES_KEY],
+];
 export const LINT_SCRIPTS = {
     lint: 'eslint .',
     'lint:fix': 'eslint . --fix',
@@ -163,7 +169,24 @@ export async function createEslintConfig(directory, platformVersion) {
         throw error;
     }
 }
+export async function getUieLintablePackageJsonLocations(projectConfig) {
+    if (!projectConfig.projectDir || !projectConfig.projectConfig?.srcDir) {
+        return [];
+    }
+    const srcDirAbsolute = path.resolve(projectConfig.projectDir, projectConfig.projectConfig.srcDir);
+    const uiePackageDirPrefixes = UIE_COMPONENTS.map(component => path.join(srcDirAbsolute, component.parentComponent
+        ? Components[component.parentComponent].dir
+        : '', component.dir));
+    const allLocations = await getProjectPackageJsonLocations(projectConfig.projectDir);
+    return allLocations.filter(location => {
+        const resolvedLocation = path.resolve(location);
+        return uiePackageDirPrefixes.some(prefix => resolvedLocation.startsWith(prefix));
+    });
+}
 export const HUBSPOT_UI_EXTENSIONS_RULE_PREFIX = '@hubspot/ui-extensions/';
+function getEnvironmentWithoutNpmConfig() {
+    return Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.toLowerCase().startsWith('npm_config_')));
+}
 export async function isHubSpotEslintConfigActive(directory) {
     const exec = util.promisify(execAsync);
     try {
@@ -188,6 +211,7 @@ export async function lintPackagesInDirectory(directory, projectDir) {
         const { stdout, stderr } = await exec(lintCommand, {
             cwd: directory,
             maxBuffer: 10 * 1024 * 1024, // 10MB buffer for large outputs
+            env: getEnvironmentWithoutNpmConfig(),
         });
         let output = `\n${displayPath}:\n`;
         if (stdout && stdout.trim()) {

package/mcp-server/tools/cms/HsCreateFunctionTool.js

@@ -59,7 +59,7 @@ export class HsCreateFunctionTool extends Tool {
             };
         }
         // Build the command
-        let command = 'hs create function';
+        let command = 'hs cms function create';
         if (dest) {
             command += ` "${dest}"`;
         }
@@ -94,7 +94,7 @@ export class HsCreateFunctionTool extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Create HubSpot CMS Serverless Function',
-            description: `Creates a new HubSpot CMS serverless function using the hs create function command. Functions can be created non-interactively by specifying functionsFolder, filename, and endpointPath. Supports all HTTP methods (${HTTP_METHODS.join(', ')}).`,
+            description: `Creates a new HubSpot CMS serverless function using the hs cms function create command. Functions can be created non-interactively by specifying functionsFolder, filename, and endpointPath. Supports all HTTP methods (${HTTP_METHODS.join(', ')}).`,
             inputSchema,
             annotations: {
                 readOnlyHint: false,

package/mcp-server/tools/cms/HsCreateModuleTool.js

@@ -1,9 +1,8 @@
 import { Tool } from '../../Tool.js';
 import { z } from 'zod';
 import { absoluteCurrentWorkingDirectory } from '../project/constants.js';
-import { runCommandInDir } from '../../utils/command.js';
-import { formatTextContents, formatTextContent } from '../../utils/content.js';
-import { addFlag } from '../../utils/command.js';
+import { addFlag, runCommandInDir } from '../../utils/command.js';
+import { formatTextContent, formatTextContents } from '../../utils/content.js';
 import { CONTENT_TYPES } from '../../../types/Cms.js';
 import { setupHubSpotConfig } from '../../utils/config.js';
 import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
@@ -75,7 +74,7 @@ export class HsCreateModuleTool extends Tool {
             };
         }
         // Build the command
-        let command = 'hs create module';
+        let command = 'hs cms module create';
         if (userSuppliedName) {
             command += ` "${userSuppliedName}"`;
         }
@@ -116,7 +115,7 @@ export class HsCreateModuleTool extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Create HubSpot CMS Module',
-            description: 'Creates a new HubSpot CMS module using the hs create module command. Modules can be created non-interactively by specifying moduleLabel and other module options. You can create either HubL or React modules by setting the reactType parameter.',
+            description: 'Creates a new HubSpot CMS module using the hs cms module create command. Modules can be created non-interactively by specifying moduleLabel and other module options. You can create either HubL or React modules by setting the reactType parameter.',
             inputSchema,
             annotations: {
                 readOnlyHint: false,

package/mcp-server/tools/cms/HsCreateTemplateTool.js

@@ -47,7 +47,7 @@ export class HsCreateTemplateTool extends Tool {
             };
         }
         // Build the command
-        let command = 'hs create template';
+        let command = 'hs cms template create';
         if (userSuppliedName) {
             command += ` "${userSuppliedName}"`;
         }
@@ -73,7 +73,7 @@ export class HsCreateTemplateTool extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Create HubSpot CMS Template',
-            description: `Creates a new HubSpot CMS template using the hs create template command. Templates can be created non-interactively by specifying templateType. Supports all template types including: ${TEMPLATE_TYPES.join(', ')}.`,
+            description: `Creates a new HubSpot CMS template using the hs cms template create command. Templates can be created non-interactively by specifying templateType. Supports all template types including: ${TEMPLATE_TYPES.join(', ')}.`,
             inputSchema,
             annotations: {
                 readOnlyHint: false,

package/mcp-server/tools/cms/HsFunctionLogsTool.js

@@ -1,8 +1,7 @@
 import { Tool } from '../../Tool.js';
 import { z } from 'zod';
-import { addFlag } from '../../utils/command.js';
+import { addFlag, runCommandInDir } from '../../utils/command.js';
 import { absoluteCurrentWorkingDirectory } from '../project/constants.js';
-import { runCommandInDir } from '../../utils/command.js';
 import { formatTextContents } from '../../utils/content.js';
 import { setupHubSpotConfig } from '../../utils/config.js';
 import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
@@ -38,7 +37,7 @@ export class HsFunctionLogsTool extends Tool {
         const normalizedEndpoint = endpoint.startsWith('/')
             ? endpoint.slice(1)
             : endpoint;
-        let command = `hs logs ${normalizedEndpoint}`;
+        let command = `hs cms function logs ${normalizedEndpoint}`;
         if (latest) {
             command = addFlag(command, 'latest', latest);
         }

package/mcp-server/tools/cms/HsListFunctionsTool.js

@@ -1,8 +1,7 @@
 import { Tool } from '../../Tool.js';
 import { z } from 'zod';
-import { addFlag } from '../../utils/command.js';
+import { addFlag, runCommandInDir } from '../../utils/command.js';
 import { absoluteCurrentWorkingDirectory } from '../project/constants.js';
-import { runCommandInDir } from '../../utils/command.js';
 import { formatTextContents } from '../../utils/content.js';
 import { setupHubSpotConfig } from '../../utils/config.js';
 import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
@@ -26,7 +25,7 @@ export class HsListFunctionsTool extends Tool {
     }
     async handler({ account, json, absoluteCurrentWorkingDirectory, }) {
         setupHubSpotConfig(absoluteCurrentWorkingDirectory);
-        let command = 'hs function list';
+        let command = 'hs cms function list';
         if (json) {
             command += ' --json';
         }

package/mcp-server/tools/cms/HsListTool.js

@@ -26,7 +26,7 @@ export class HsListTool extends Tool {
     }
     async handler({ path, account, absoluteCurrentWorkingDirectory, }) {
         setupHubSpotConfig(absoluteCurrentWorkingDirectory);
-        let command = 'hs list';
+        let command = 'hs cms list';
         if (path) {
             command += ` ${path}`;
         }
@@ -46,7 +46,7 @@ export class HsListTool extends Tool {
                 content: [
                     {
                         type: 'text',
-                        text: `Error executing hs list command: ${getErrorMessage(error)}`,
+                        text: `Error executing hs cms list command: ${getErrorMessage(error)}`,
                     },
                 ],
             };

package/mcp-server/utils/command.js

@@ -24,10 +24,12 @@ export async function runCommandInDir(directory, command) {
         }
         finalCommand = addFlag(finalCommand, 'disable-usage-tracking', true);
     }
+    const resolvedDir = path.resolve(directory);
     return execAsync(finalCommand, {
-        cwd: path.resolve(directory),
+        cwd: resolvedDir,
         env: {
             ...process.env,
+            INIT_CWD: resolvedDir,
         },
     });
 }

package/mcp-server/utils/config.js

@@ -3,6 +3,7 @@ export function setupHubSpotConfig(absoluteCurrentWorkingDirectory) {
     if (!absoluteCurrentWorkingDirectory) {
         return;
     }
+    process.env.INIT_CWD = absoluteCurrentWorkingDirectory;
     const configPath = getLocalConfigFilePathIfExists(absoluteCurrentWorkingDirectory);
     if (configPath) {
         process.env.HUBSPOT_CONFIG_PATH = configPath;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/cli",
-    "version": "8.1.2-experimental.3",
+    "version": "8.1.4-experimental.0",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",
@@ -10,7 +10,7 @@
         "!**/__tests__/**"
     ],
     "dependencies": {
-        "@hubspot/local-dev-lib": "5.7.0",
+        "@hubspot/local-dev-lib": "5.7.1",
         "@hubspot/project-parsing-lib": "0.16.0",
         "@hubspot/serverless-dev-runtime": "7.0.7",
         "@hubspot/ui-extensions-dev-server": "2.0.7",
@@ -37,7 +37,7 @@
         "table": "6.9.0",
         "tmp": "0.2.4",
         "update-notifier": "7.3.1",
-        "ws": "^8.18.2",
+        "ws": "8.20.0",
         "yargs": "17.7.2",
         "yargs-parser": "21.1.1"
     },