@hubspot/cli 7.7.0-experimental.3 → 7.7.0

package/README.md

@@ -4,10 +4,6 @@
 
 A CLI for HubSpot developers to enable local development and automation. [Learn more about building on HubSpot](https://developers.hubspot.com).
 
-## Contributing
-
-For more information on developing, see the [Contributing Guide](CONTRIBUTING.md).
-
 ## Getting started
 
 For more information on using these tools, see [Local Development Tooling: Getting Started](https://developers.hubspot.com/docs/cms/guides/getting-started-with-local-development)

package/api/__tests__/migrate.test.d.ts

@@ -0,0 +1 @@
+export {};

package/api/__tests__/migrate.test.js

@@ -0,0 +1,181 @@
+import { http } from '@hubspot/local-dev-lib/http';
+import { MIGRATION_STATUS } from '@hubspot/local-dev-lib/types/Migration';
+import { listAppsForMigration, initializeAppMigration, continueAppMigration, checkMigrationStatusV2, isMigrationStatus, } from '../migrate.js';
+vi.mock('@hubspot/local-dev-lib/http');
+const httpMock = http;
+describe('api/migrate', () => {
+    const mockAccountId = 12345;
+    const mockPortalId = 12345;
+    const mockAppId = 67890;
+    const mockMigrationId = 54321;
+    const mockPlatformVersion = '2025.2';
+    const convertedPlatformVersion = 'V2025_2';
+    const mockProjectName = 'Test Project';
+    const mockComponentUids = { 'component-1': 'uid-1', 'component-2': 'uid-2' };
+    describe('listAppsForMigration', () => {
+        it('should call http.get with correct parameters', async () => {
+            const mockResponse = {
+                migratableApps: [
+                    {
+                        appId: 1,
+                        appName: 'App 1',
+                        isMigratable: true,
+                        migrationComponents: [
+                            { id: 'comp1', componentType: 'type1', isSupported: true },
+                        ],
+                    },
+                ],
+                unmigratableApps: [
+                    {
+                        appId: 2,
+                        appName: 'App 2',
+                        isMigratable: false,
+                        unmigratableReason: 'UP_TO_DATE',
+                        migrationComponents: [
+                            { id: 'comp2', componentType: 'type2', isSupported: false },
+                        ],
+                    },
+                ],
+            };
+            // @ts-expect-error Mock
+            httpMock.get.mockResolvedValue(mockResponse);
+            const result = await listAppsForMigration(mockAccountId, mockPlatformVersion);
+            expect(http.get).toHaveBeenCalledWith(mockAccountId, {
+                url: 'dfs/migrations/v2/list-apps',
+                params: {
+                    platformVersion: convertedPlatformVersion,
+                },
+            });
+            expect(result).toEqual(mockResponse);
+        });
+    });
+    describe('initializeAppMigration', () => {
+        it('should call http.post with correct parameters', async () => {
+            const mockResponse = { migrationId: mockMigrationId };
+            // @ts-expect-error Mock
+            httpMock.post.mockResolvedValue(mockResponse);
+            const result = await initializeAppMigration(mockAccountId, mockAppId, mockPlatformVersion);
+            expect(http.post).toHaveBeenCalledWith(mockAccountId, {
+                url: 'dfs/migrations/v2/migrations',
+                data: {
+                    applicationId: mockAppId,
+                    platformVersion: convertedPlatformVersion,
+                },
+            });
+            expect(result).toEqual(mockResponse);
+        });
+    });
+    describe('continueAppMigration', () => {
+        it('should call http.post with correct parameters', async () => {
+            const mockResponse = { migrationId: mockMigrationId };
+            // @ts-expect-error Mock
+            httpMock.post.mockResolvedValue(mockResponse);
+            const result = await continueAppMigration(mockPortalId, mockMigrationId, mockComponentUids, mockProjectName);
+            expect(http.post).toHaveBeenCalledWith(mockPortalId, {
+                url: 'dfs/migrations/v2/migrations/continue',
+                data: {
+                    migrationId: mockMigrationId,
+                    projectName: mockProjectName,
+                    componentUids: mockComponentUids,
+                },
+            });
+            expect(result).toEqual(mockResponse);
+        });
+    });
+    describe('checkMigrationStatusV2', () => {
+        it('should call http.get with correct parameters for in-progress status', async () => {
+            const mockResponse = {
+                id: mockMigrationId,
+                status: MIGRATION_STATUS.IN_PROGRESS,
+            };
+            // @ts-expect-error Mock
+            httpMock.get.mockResolvedValue(mockResponse);
+            const result = await checkMigrationStatusV2(mockAccountId, mockMigrationId);
+            expect(http.get).toHaveBeenCalledWith(mockAccountId, {
+                url: `dfs/migrations/v2/migrations/${mockMigrationId}/status`,
+            });
+            expect(result).toEqual(mockResponse);
+        });
+        it('should handle input required status', async () => {
+            const mockResponse = {
+                id: mockMigrationId,
+                status: MIGRATION_STATUS.INPUT_REQUIRED,
+                componentsRequiringUids: {
+                    'component-1': {
+                        componentType: 'type1',
+                        componentHint: 'hint1',
+                    },
+                },
+            };
+            // @ts-expect-error Mock
+            httpMock.get.mockResolvedValue(mockResponse);
+            const result = await checkMigrationStatusV2(mockAccountId, mockMigrationId);
+            expect(result).toEqual(mockResponse);
+        });
+        it('should handle success status', async () => {
+            const mockResponse = {
+                id: mockMigrationId,
+                status: MIGRATION_STATUS.SUCCESS,
+                buildId: 98765,
+            };
+            // @ts-expect-error Mock
+            httpMock.get.mockResolvedValue(mockResponse);
+            const result = await checkMigrationStatusV2(mockAccountId, mockMigrationId);
+            expect(result).toEqual(mockResponse);
+        });
+        it('should handle failure status', async () => {
+            const mockResponse = {
+                id: mockMigrationId,
+                status: MIGRATION_STATUS.FAILURE,
+                projectErrorDetail: 'Error details',
+                componentErrors: [],
+            };
+            // @ts-expect-error Mock
+            httpMock.get.mockResolvedValue(mockResponse);
+            const result = await checkMigrationStatusV2(mockAccountId, mockMigrationId);
+            expect(result).toEqual(mockResponse);
+        });
+    });
+});
+describe('isMigrationStatus', () => {
+    it.each([
+        {
+            id: 123,
+            status: MIGRATION_STATUS.IN_PROGRESS,
+        },
+        {
+            id: 456,
+            status: MIGRATION_STATUS.INPUT_REQUIRED,
+            componentsRequiringUids: {
+                'component-1': {
+                    componentType: 'type1',
+                    componentHint: 'hint1',
+                },
+            },
+        },
+        {
+            id: 789,
+            status: MIGRATION_STATUS.SUCCESS,
+            buildId: 98765,
+        },
+        {
+            id: 101,
+            status: MIGRATION_STATUS.FAILURE,
+            projectErrorDetail: 'Error details',
+            componentErrors: [],
+        },
+    ])('should return true for valid MigrationStatus object %j', status => {
+        expect(isMigrationStatus(status)).toBe(true);
+    });
+    it.each([null, undefined, 123, 'string', true, false, []])('should return false for non-object value %j', value => {
+        expect(isMigrationStatus(value)).toBe(false);
+    });
+    it.each([
+        {},
+        { id: 123 },
+        { status: MIGRATION_STATUS.IN_PROGRESS },
+        { foo: 'bar' },
+    ])('should return false for invalid object %j', obj => {
+        expect(isMigrationStatus(obj)).toBe(false);
+    });
+});

package/api/migrate.d.ts

@@ -24,7 +24,13 @@ export interface ListAppsResponse {
     migratableApps: MigratableApp[];
     unmigratableApps: UnmigratableApp[];
 }
-export interface InitializeMigrationResponse {
+export interface ListThemesResponse {
+    migratableThemes: {
+        THEME: string[];
+        REACT_THEME: string[];
+    };
+}
+export interface InitializeAppMigrationResponse {
     migrationId: number;
 }
 export interface ListAppsMigrationComponent {
@@ -32,7 +38,7 @@ export interface ListAppsMigrationComponent {
     componentType: string;
     isSupported: boolean;
 }
-export type ContinueMigrationResponse = {
+export type ContinueAppMigrationResponse = {
     migrationId: number;
 };
 export interface MigrationBaseStatus {
@@ -65,7 +71,7 @@ export interface MigrationFailed extends MigrationBaseStatus {
 export type MigrationStatus = MigrationInProgress | MigrationInputRequired | MigrationSuccess | MigrationFailed;
 export declare function isMigrationStatus(error: unknown): error is MigrationStatus;
 export declare function listAppsForMigration(accountId: number, platformVersion: string): HubSpotPromise<ListAppsResponse>;
-export declare function initializeMigration(accountId: number, applicationId: number, platformVersion: string): HubSpotPromise<InitializeMigrationResponse>;
-export declare function continueMigration(portalId: number, migrationId: number, componentUids: Record<string, string>, projectName: string): HubSpotPromise<ContinueMigrationResponse>;
+export declare function initializeAppMigration(accountId: number, applicationId: number, platformVersion: string): HubSpotPromise<InitializeAppMigrationResponse>;
+export declare function continueAppMigration(portalId: number, migrationId: number, componentUids: Record<string, string>, projectName: string): HubSpotPromise<ContinueAppMigrationResponse>;
 export declare function checkMigrationStatusV2(accountId: number, id: number): HubSpotPromise<MigrationStatus>;
 export {};

package/api/migrate.js

@@ -1,25 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLI_UNMIGRATABLE_REASONS = void 0;
-exports.isMigrationStatus = isMigrationStatus;
-exports.listAppsForMigration = listAppsForMigration;
-exports.initializeMigration = initializeMigration;
-exports.continueMigration = continueMigration;
-exports.checkMigrationStatusV2 = checkMigrationStatusV2;
-const projects_1 = require("@hubspot/local-dev-lib/constants/projects");
-const http_1 = require("@hubspot/local-dev-lib/http");
+import { PLATFORM_VERSIONS, } from '@hubspot/local-dev-lib/constants/projects';
+import { http } from '@hubspot/local-dev-lib/http';
 const MIGRATIONS_API_PATH_V2 = 'dfs/migrations/v2';
-exports.CLI_UNMIGRATABLE_REASONS = {
+export const CLI_UNMIGRATABLE_REASONS = {
     PART_OF_PROJECT_ALREADY: 'PART_OF_PROJECT_ALREADY',
 };
-function isMigrationStatus(error) {
+export function isMigrationStatus(error) {
     return (typeof error === 'object' &&
         error !== null &&
         'id' in error &&
         'status' in error);
 }
-async function listAppsForMigration(accountId, platformVersion) {
-    return http_1.http.get(accountId, {
+export async function listAppsForMigration(accountId, platformVersion) {
+    return http.get(accountId, {
         url: `${MIGRATIONS_API_PATH_V2}/list-apps`,
         params: {
             platformVersion: mapPlatformVersionToEnum(platformVersion),
@@ -27,13 +19,13 @@ async function listAppsForMigration(accountId, platformVersion) {
     });
 }
 function mapPlatformVersionToEnum(platformVersion) {
-    if (platformVersion === projects_1.PLATFORM_VERSIONS.unstable) {
-        return projects_1.PLATFORM_VERSIONS.unstable.toUpperCase();
+    if (platformVersion === PLATFORM_VERSIONS.unstable) {
+        return PLATFORM_VERSIONS.unstable.toUpperCase();
     }
     return `V${platformVersion.replace('.', '_')}`;
 }
-async function initializeMigration(accountId, applicationId, platformVersion) {
-    return http_1.http.post(accountId, {
+export async function initializeAppMigration(accountId, applicationId, platformVersion) {
+    return http.post(accountId, {
         url: `${MIGRATIONS_API_PATH_V2}/migrations`,
         data: {
             applicationId,
@@ -41,8 +33,8 @@ async function initializeMigration(accountId, applicationId, platformVersion) {
         },
     });
 }
-async function continueMigration(portalId, migrationId, componentUids, projectName) {
-    return http_1.http.post(portalId, {
+export async function continueAppMigration(portalId, migrationId, componentUids, projectName) {
+    return http.post(portalId, {
         url: `${MIGRATIONS_API_PATH_V2}/migrations/continue`,
         data: {
             migrationId,
@@ -51,8 +43,8 @@ async function continueMigration(portalId, migrationId, componentUids, projectNa
         },
     });
 }
-async function checkMigrationStatusV2(accountId, id) {
-    return http_1.http.get(accountId, {
+export async function checkMigrationStatusV2(accountId, id) {
+    return http.get(accountId, {
         url: `${MIGRATIONS_API_PATH_V2}/migrations/${id}/status`,
     });
 }

package/bin/cli.js

@@ -1,53 +1,54 @@
 #!/usr/bin/env node
-"use strict";
-const yargs = require('yargs');
-const { logger } = require('@hubspot/local-dev-lib/logger');
-const { logError } = require('../lib/errorHandlers/index');
-const { setLogLevel, getCommandName } = require('../lib/commonOpts');
-const { trackHelpUsage, trackConvertFieldsUsage, } = require('../lib/usageTracking');
-const { EXIT_CODES } = require('../lib/enums/exitCodes');
-const { loadConfigMiddleware, injectAccountIdMiddleware, validateAccountOptions, handleDeprecatedEnvVariables, } = require('../lib/middleware/configMiddleware');
-const { autoUpdateCLI } = require('../lib/middleware/autoUpdateMiddleware');
-const { checkAndWarnGitInclusionMiddleware, } = require('../lib/middleware/gitMiddleware');
-const { performChecks } = require('../lib/middleware/yargsChecksMiddleware');
-const { setRequestHeaders } = require('../lib/middleware/requestMiddleware');
-const { checkFireAlarms } = require('../lib/middleware/fireAlarmMiddleware');
-const removeCommand = require('../commands/remove');
-const initCommand = require('../commands/init');
-const logsCommand = require('../commands/logs');
-const lintCommand = require('../commands/lint');
-const hubdbCommand = require('../commands/hubdb');
-const watchCommand = require('../commands/watch');
-const authCommand = require('../commands/auth');
-const uploadCommand = require('../commands/upload');
-const createCommand = require('../commands/create');
-const fetchCommand = require('../commands/fetch');
-const filemanagerCommand = require('../commands/filemanager');
-const secretCommands = require('../commands/secret');
-const customObjectCommand = require('../commands/customObject');
-const functionCommands = require('../commands/function');
-const listCommand = require('../commands/list');
-const openCommand = require('../commands/open');
-const mvCommand = require('../commands/mv');
-const projectCommands = require('../commands/project');
-const themeCommand = require('../commands/theme');
-const moduleCommand = require('../commands/module');
-const configCommand = require('../commands/config');
-const accountCommands = require('../commands/account');
-const sandboxesCommand = require('../commands/sandbox');
-const cmsCommand = require('../commands/cms');
-const feedbackCommand = require('../commands/feedback');
-const doctorCommand = require('../commands/doctor');
-const completionCommand = require('../commands/completion');
-const appCommand = require('../commands/app');
-const testAccountCommand = require('../commands/testAccount');
-const getTerminalWidth = () => {
-    const width = yargs.terminalWidth();
+import yargs from 'yargs';
+import { logger } from '@hubspot/local-dev-lib/logger';
+import { logError } from '../lib/errorHandlers/index.js';
+import { setLogLevel, getCommandName } from '../lib/commonOpts.js';
+import { trackHelpUsage, trackConvertFieldsUsage, } from '../lib/usageTracking.js';
+import { EXIT_CODES } from '../lib/enums/exitCodes.js';
+import { loadConfigMiddleware, injectAccountIdMiddleware, validateAccountOptions, handleDeprecatedEnvVariables, } from '../lib/middleware/configMiddleware.js';
+import { autoUpdateCLI } from '../lib/middleware/autoUpdateMiddleware.js';
+import { checkAndWarnGitInclusionMiddleware } from '../lib/middleware/gitMiddleware.js';
+import { performChecks } from '../lib/middleware/yargsChecksMiddleware.js';
+import { setRequestHeaders } from '../lib/middleware/requestMiddleware.js';
+import { checkFireAlarms } from '../lib/middleware/fireAlarmMiddleware.js';
+import removeCommand from '../commands/remove.js';
+import initCommand from '../commands/init.js';
+import logsCommand from '../commands/logs.js';
+import lintCommand from '../commands/lint.js';
+import hubdbCommand from '../commands/hubdb.js';
+import watchCommand from '../commands/watch.js';
+import authCommand from '../commands/auth.js';
+import uploadCommand from '../commands/upload.js';
+import createCommand from '../commands/create.js';
+import fetchCommand from '../commands/fetch.js';
+import filemanagerCommand from '../commands/filemanager.js';
+import secretCommands from '../commands/secret.js';
+import customObjectCommand from '../commands/customObject.js';
+import functionCommands from '../commands/function.js';
+import listCommand from '../commands/list.js';
+import openCommand from '../commands/open.js';
+import mvCommand from '../commands/mv.js';
+import projectCommands from '../commands/project.js';
+import themeCommand from '../commands/theme.js';
+import moduleCommand from '../commands/module.js';
+import configCommand from '../commands/config.js';
+import accountCommands from '../commands/account.js';
+import sandboxesCommand from '../commands/sandbox.js';
+import cmsCommand from '../commands/cms.js';
+import feedbackCommand from '../commands/feedback.js';
+import doctorCommand from '../commands/doctor.js';
+import completionCommand from '../commands/completion.js';
+import appCommand from '../commands/app.js';
+import testAccountCommands from '../commands/testAccount.js';
+import getStartedCommand from '../commands/getStarted.js';
+import mcpCommand from '../commands/mcp.js';
+function getTerminalWidth() {
+    const width = yargs().terminalWidth();
     if (width >= 100)
         return width * 0.9;
     return width;
-};
-const handleFailure = (msg, err, yargs) => {
+}
+function handleFailure(msg, err, yargs) {
     if (msg) {
         logger.error(msg);
     }
@@ -61,8 +62,8 @@ const handleFailure = (msg, err, yargs) => {
     else {
         process.exit(EXIT_CODES.ERROR);
     }
-};
-const argv = yargs
+}
+const argv = yargs(process.argv.slice(2))
     .usage('The command line interface to interact with HubSpot.')
     // loadConfigMiddleware loads the new hidden config for all commands
     .middleware([
@@ -119,16 +120,22 @@ const argv = yargs
     .command(doctorCommand)
     .command(completionCommand)
     .command(appCommand)
-    .command(testAccountCommand)
+    .command(testAccountCommands)
+    .command(getStartedCommand)
+    .command(mcpCommand)
     .help()
     .alias('h', 'help')
     .recommendCommands()
     .demandCommand(1, '')
     .wrap(getTerminalWidth())
     .strict().argv;
-if (argv.help) {
-    trackHelpUsage(getCommandName(argv));
+if ('help' in argv && argv.help !== undefined) {
+    (async () => {
+        await trackHelpUsage(getCommandName(argv));
+    })();
 }
-if (argv.convertFields) {
-    trackConvertFieldsUsage(getCommandName(argv));
+if ('convertFields' in argv && argv.convertFields !== undefined) {
+    (async () => {
+        await trackConvertFieldsUsage(getCommandName(argv));
+    })();
 }

package/bin/hs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-require('./silenceErrors')
+import './silenceErrors.js';
 
-require('./cli');
+import './cli.js';

package/bin/hscms

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 
-require('./silenceErrors')
+import './silenceErrors.js';
 
-require('./cli');
+import './cli.js';

package/bin/silenceErrors.js

@@ -1,6 +1,4 @@
 #!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
 const SILENCED_ERRORS = ['DeprecationWarning:'];
 const originalConsoleError = console.error;
 console.error = msg => {
@@ -10,3 +8,4 @@ console.error = msg => {
     }
     originalConsoleError(msg);
 };
+export {};

package/commands/__tests__/account.test.d.ts

@@ -0,0 +1 @@
+export {};

package/commands/__tests__/account.test.js

@@ -0,0 +1,69 @@
+import yargs from 'yargs';
+import auth from '../account/auth.js';
+import list from '../account/list.js';
+import rename from '../account/rename.js';
+import use from '../account/use.js';
+import info from '../account/info.js';
+import remove from '../account/remove.js';
+import clean from '../account/clean.js';
+import createOverride from '../account/createOverride.js';
+import removeOverride from '../account/removeOverride.js';
+import accountCommands from '../account.js';
+vi.mock('../account/auth');
+vi.mock('../account/list');
+vi.mock('../account/rename');
+vi.mock('../account/use');
+vi.mock('../account/info');
+vi.mock('../account/remove');
+vi.mock('../account/clean');
+vi.mock('../account/createOverride');
+vi.mock('../account/removeOverride');
+vi.mock('../../lib/commonOpts');
+const commandSpy = vi
+    .spyOn(yargs, 'command')
+    .mockReturnValue(yargs);
+const demandCommandSpy = vi
+    .spyOn(yargs, 'demandCommand')
+    .mockReturnValue(yargs);
+describe('commands/account', () => {
+    describe('command', () => {
+        it('should have the correct command structure', () => {
+            expect(accountCommands.command).toEqual(['account', 'accounts']);
+        });
+    });
+    describe('describe', () => {
+        it('should provide a description', () => {
+            expect(accountCommands.describe).toBeDefined();
+        });
+    });
+    describe('builder', () => {
+        beforeEach(() => {
+            commandSpy.mockClear();
+            demandCommandSpy.mockClear();
+        });
+        const subcommands = [
+            auth,
+            list,
+            rename,
+            use,
+            info,
+            remove,
+            clean,
+            createOverride,
+            removeOverride,
+        ];
+        it('should demand the command takes one positional argument', () => {
+            accountCommands.builder(yargs);
+            expect(demandCommandSpy).toHaveBeenCalledTimes(1);
+            expect(demandCommandSpy).toHaveBeenCalledWith(1, '');
+        });
+        it('should add the correct number of sub commands', () => {
+            accountCommands.builder(yargs);
+            expect(commandSpy).toHaveBeenCalledTimes(subcommands.length);
+        });
+        it.each(subcommands)('should attach the %s subcommand', module => {
+            accountCommands.builder(yargs);
+            expect(commandSpy).toHaveBeenCalledWith(module);
+        });
+    });
+});

package/commands/__tests__/auth.test.d.ts

@@ -0,0 +1 @@
+export {};

package/commands/__tests__/auth.test.js

@@ -0,0 +1,38 @@
+import yargs from 'yargs';
+import { addConfigOptions, addTestingOptions } from '../../lib/commonOpts.js';
+import authCommand from '../auth.js';
+vi.mock('../../lib/commonOpts');
+const optionsSpy = vi
+    .spyOn(mockYargs, 'options')
+    .mockReturnValue(yargs);
+describe('commands/auth', () => {
+    describe('command', () => {
+        it('should have the correct command structure', () => {
+            expect(authCommand.command).toEqual('auth');
+        });
+    });
+    describe('describe', () => {
+        it('should provide a description', () => {
+            expect(authCommand.describe).toBeDefined();
+        });
+    });
+    describe('builder', () => {
+        it('should support the correct options', () => {
+            authCommand.builder(yargs);
+            expect(optionsSpy).toHaveBeenCalledTimes(1);
+            expect(optionsSpy).toHaveBeenCalledWith({
+                'auth-type': expect.objectContaining({
+                    type: 'string',
+                    choices: ['personalaccesskey', 'oauth2'],
+                    default: 'personalaccesskey',
+                }),
+                account: expect.objectContaining({ type: 'string' }),
+                'personal-access-key': expect.objectContaining({ type: 'string' }),
+            });
+            expect(addConfigOptions).toHaveBeenCalledTimes(1);
+            expect(addConfigOptions).toHaveBeenCalledWith(yargs);
+            expect(addTestingOptions).toHaveBeenCalledTimes(1);
+            expect(addTestingOptions).toHaveBeenCalledWith(yargs);
+        });
+    });
+});

package/commands/__tests__/cms.test.d.ts

@@ -0,0 +1 @@
+export {};

package/commands/__tests__/cms.test.js

@@ -0,0 +1,44 @@
+import yargs from 'yargs';
+import lighthouseScore from '../cms/lighthouseScore.js';
+import convertFields from '../cms/convertFields.js';
+import getReactModule from '../cms/getReactModule.js';
+import cmsCommand from '../cms.js';
+vi.mock('../cms/lighthouseScore');
+vi.mock('../cms/convertFields');
+vi.mock('../cms/getReactModule');
+vi.mock('../../lib/commonOpts');
+const commandSpy = vi
+    .spyOn(yargs, 'command')
+    .mockReturnValue(yargs);
+const demandCommandSpy = vi
+    .spyOn(yargs, 'demandCommand')
+    .mockReturnValue(yargs);
+describe('commands/cms', () => {
+    describe('command', () => {
+        it('should have the correct command structure', () => {
+            expect(cmsCommand.command).toEqual('cms');
+        });
+    });
+    describe('describe', () => {
+        it('should provide a description', () => {
+            expect(cmsCommand.describe).toBeDefined();
+        });
+    });
+    describe('builder', () => {
+        const subcommands = [lighthouseScore, convertFields, getReactModule];
+        it('should demand the command takes one positional argument', () => {
+            cmsCommand.builder(yargs);
+            expect(demandCommandSpy).toHaveBeenCalledTimes(1);
+            expect(demandCommandSpy).toHaveBeenCalledWith(1, '');
+        });
+        it('should add the correct number of sub commands', () => {
+            cmsCommand.builder(yargs);
+            expect(commandSpy).toHaveBeenCalledTimes(subcommands.length);
+        });
+        it.each(subcommands)('should attach the %s subcommand', module => {
+            cmsCommand.builder(yargs);
+            expect(module).toBeDefined();
+            expect(commandSpy).toHaveBeenCalledWith(module);
+        });
+    });
+});

package/commands/__tests__/config.test.d.ts

@@ -0,0 +1 @@
+export {};