@hubspot/cli 7.7.19-experimental.3 → 7.7.20-experimental.0

package/commands/project/__tests__/installDeps.test.js

@@ -0,0 +1,180 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const projectUtils = __importStar(require("../../../lib/projects/config"));
+const exitCodes_1 = require("../../../lib/enums/exitCodes");
+const usageTracking_1 = require("../../../lib/usageTracking");
+const dependencyManagement = __importStar(require("../../../lib/dependencyManagement"));
+const promptUtils = __importStar(require("../../../lib/prompts/promptUtils"));
+const installDeps_1 = __importDefault(require("../installDeps"));
+vi.mock('@hubspot/local-dev-lib/logger');
+vi.mock('../../../lib/projects/config');
+vi.mock('../../../lib/dependencyManagement');
+vi.mock('../../../lib/prompts/promptUtils');
+vi.mock('../../../lib/usageTracking');
+vi.mock('../../../lib/commonOpts');
+const exampleSpy = vi.spyOn(yargs_1.default, 'example');
+const processExitSpy = vi.spyOn(process, 'exit');
+const getProjectConfigSpy = vi.spyOn(projectUtils, 'getProjectConfig');
+const promptUserSpy = vi.spyOn(promptUtils, 'promptUser');
+const getProjectPackageJsonLocationsSpy = vi.spyOn(dependencyManagement, 'getProjectPackageJsonLocations');
+const installPackagesSpy = vi.spyOn(dependencyManagement, 'installPackages');
+describe('commands/project/installDeps', () => {
+    describe('command', () => {
+        it('should have the correct command structure', () => {
+            expect(installDeps_1.default.command).toEqual('install-deps [packages..]');
+        });
+    });
+    describe('describe', () => {
+        it('should not provide a description', () => {
+            expect(installDeps_1.default.describe).toEqual(expect.stringMatching(/Install the dependencies for your project, or add a dependency to a subcomponent of a project/));
+        });
+    });
+    describe('builder', () => {
+        it('should provide examples', () => {
+            installDeps_1.default.builder(yargs_1.default);
+            expect(exampleSpy).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('handler', () => {
+        let args;
+        beforeEach(() => {
+            args = {
+                derivedAccountId: 999999,
+            };
+            // @ts-expect-error Doesn't match the actual signature because then the linter complains about unused variables
+            processExitSpy.mockImplementation(() => { });
+        });
+        it('should track the command usage', async () => {
+            await installDeps_1.default.handler(args);
+            expect(usageTracking_1.trackCommandUsage).toHaveBeenCalledTimes(1);
+            expect(usageTracking_1.trackCommandUsage).toHaveBeenCalledWith('project-install-deps', undefined, args.derivedAccountId);
+        });
+        it('should handle exceptions', async () => {
+            const error = new Error('Something went super wrong');
+            getProjectConfigSpy.mockImplementationOnce(() => {
+                throw error;
+            });
+            await installDeps_1.default.handler(args);
+            expect(logger_1.logger.error).toHaveBeenCalledTimes(1);
+            expect(logger_1.logger.error).toHaveBeenCalledWith(error.message);
+            expect(processExitSpy).toHaveBeenCalledTimes(1);
+            expect(processExitSpy).toHaveBeenCalledWith(exitCodes_1.EXIT_CODES.ERROR);
+        });
+        it('should log an error and exit when the project config is not defined', async () => {
+            getProjectConfigSpy.mockResolvedValueOnce({
+                projectDir: null,
+                projectConfig: null,
+            });
+            await installDeps_1.default.handler(args);
+            expect(logger_1.logger.error).toHaveBeenCalledTimes(1);
+            expect(logger_1.logger.error).toHaveBeenCalledWith('No project detected. Run this command from a project directory.');
+            expect(processExitSpy).toHaveBeenCalledTimes(1);
+            expect(processExitSpy).toHaveBeenCalledWith(exitCodes_1.EXIT_CODES.ERROR);
+        });
+        it('should log an error and exit when the project config has no projectDir', async () => {
+            getProjectConfigSpy.mockResolvedValueOnce({
+                projectDir: null,
+                projectConfig: null,
+            });
+            await installDeps_1.default.handler(args);
+            expect(logger_1.logger.error).toHaveBeenCalledTimes(1);
+            expect(logger_1.logger.error).toHaveBeenCalledWith('No project detected. Run this command from a project directory.');
+            expect(processExitSpy).toHaveBeenCalledTimes(1);
+            expect(processExitSpy).toHaveBeenCalledWith(exitCodes_1.EXIT_CODES.ERROR);
+        });
+        it('should prompt for input when packages is defined', async () => {
+            const projectDir = 'src';
+            getProjectConfigSpy.mockResolvedValue({
+                projectDir,
+                projectConfig: null,
+            });
+            const packageJsonLocation = path_1.default.join(projectDir, 'directory1');
+            promptUserSpy.mockResolvedValueOnce({
+                selectedInstallLocations: packageJsonLocation,
+            });
+            getProjectPackageJsonLocationsSpy.mockResolvedValue([
+                packageJsonLocation,
+            ]);
+            await installDeps_1.default.handler({
+                ...args,
+                packages: ['@hubspot/local-dev-lib'],
+            });
+            expect(getProjectPackageJsonLocationsSpy).toHaveBeenCalledTimes(1);
+            expect(promptUserSpy).toHaveBeenCalledTimes(1);
+            expect(promptUserSpy).toHaveBeenCalledWith([
+                {
+                    name: 'selectedInstallLocations',
+                    type: 'checkbox',
+                    when: expect.any(Function),
+                    choices: [
+                        {
+                            name: 'directory1',
+                            value: packageJsonLocation,
+                        },
+                    ],
+                    message: 'Choose the project components to install the dependencies:',
+                    validate: expect.any(Function),
+                },
+            ]);
+        });
+        it('should call installPackages correctly', async () => {
+            const projectDir = 'src';
+            const packageJsonLocation = path_1.default.join(projectDir, 'directory1');
+            const installLocations = [packageJsonLocation];
+            const packages = ['@hubspot/local-dev-lib'];
+            getProjectConfigSpy.mockResolvedValue({
+                projectDir,
+                projectConfig: null,
+            });
+            promptUserSpy.mockResolvedValueOnce({
+                selectedInstallLocations: packageJsonLocation,
+            });
+            getProjectPackageJsonLocationsSpy.mockResolvedValue(installLocations);
+            await installDeps_1.default.handler({ ...args, packages });
+            expect(installPackagesSpy).toHaveBeenCalledTimes(1);
+            expect(installPackagesSpy).toHaveBeenCalledWith({
+                packages,
+                installLocations: packageJsonLocation,
+            });
+        });
+    });
+});

package/commands/project/__tests__/listBuilds.test.d.ts

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

package/commands/project/__tests__/listBuilds.test.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const commonOpts_1 = require("../../../lib/commonOpts");
+const listBuilds_1 = __importDefault(require("../listBuilds"));
+vi.mock('../../../lib/commonOpts');
+describe('commands/project/listBuilds', () => {
+    const yargsMock = yargs_1.default;
+    describe('command', () => {
+        it('should have the correct command structure', () => {
+            expect(listBuilds_1.default.command).toEqual('list-builds');
+        });
+    });
+    describe('describe', () => {
+        it('should provide a description', () => {
+            expect(listBuilds_1.default.describe).toBeDefined();
+        });
+    });
+    describe('builder', () => {
+        it('should support the correct options', () => {
+            listBuilds_1.default.builder(yargsMock);
+            expect(commonOpts_1.addAccountOptions).toHaveBeenCalledTimes(1);
+            expect(commonOpts_1.addAccountOptions).toHaveBeenCalledWith(yargsMock);
+            expect(commonOpts_1.addConfigOptions).toHaveBeenCalledTimes(1);
+            expect(commonOpts_1.addConfigOptions).toHaveBeenCalledWith(yargsMock);
+            expect(commonOpts_1.addUseEnvironmentOptions).toHaveBeenCalledTimes(1);
+            expect(commonOpts_1.addUseEnvironmentOptions).toHaveBeenCalledWith(yargsMock);
+        });
+        it('should define project and limit options', () => {
+            const optionsSpy = vi.spyOn(yargsMock, 'options');
+            const exampleSpy = vi.spyOn(yargsMock, 'example');
+            listBuilds_1.default.builder(yargsMock);
+            expect(optionsSpy).toHaveBeenCalledWith(expect.objectContaining({
+                project: expect.any(Object),
+                limit: expect.any(Object),
+            }));
+            expect(exampleSpy).toHaveBeenCalled();
+        });
+    });
+});

package/commands/project/__tests__/logs.test.d.ts

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

package/commands/project/__tests__/logs.test.js

@@ -0,0 +1,246 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const commonOpts_1 = require("../../../lib/commonOpts");
+const ProjectLogsManager_1 = require("../../../lib/projects/ProjectLogsManager");
+const projectLogsPrompt = __importStar(require("../../../lib/prompts/projectsLogsPrompt"));
+const table = __importStar(require("../../../lib/ui/table"));
+const usageTracking_1 = require("../../../lib/usageTracking");
+const ui = __importStar(require("../../../lib/ui"));
+const exitCodes_1 = require("../../../lib/enums/exitCodes");
+const errorHandlers_1 = require("../../../lib/errorHandlers");
+const logs_1 = __importDefault(require("../logs"));
+vi.mock('@hubspot/local-dev-lib/logger');
+vi.mock('../../../lib/commonOpts');
+vi.mock('../../../lib/usageTracking');
+vi.mock('../../../lib/validation');
+vi.mock('../../../lib/projects/ProjectLogsManager');
+vi.mock('../../../lib/prompts/projectsLogsPrompt');
+vi.mock('../../../lib/ui/table');
+vi.mock('../../../lib/errorHandlers');
+const uiLinkSpy = vi.spyOn(ui, 'uiLink');
+const uiLineSpy = vi.spyOn(ui, 'uiLine');
+const processExitSpy = vi.spyOn(process, 'exit');
+const projectLogsPromptSpy = vi.spyOn(projectLogsPrompt, 'projectLogsPrompt');
+const projectLogsManagerSetFunctionSpy = vi.spyOn(ProjectLogsManager_1.ProjectLogsManager, 'setFunction');
+const projectLogsManagerGetFunctionNamesSpy = vi.spyOn(ProjectLogsManager_1.ProjectLogsManager, 'getFunctionNames');
+const projectLogsManagerInitSpy = vi.spyOn(ProjectLogsManager_1.ProjectLogsManager, 'init');
+const getTableHeaderSpy = vi.spyOn(table, 'getTableHeader');
+const getTableContentsSpy = vi.spyOn(table, 'getTableContents');
+const optionsSpy = vi
+    .spyOn(yargs_1.default, 'options')
+    .mockReturnValue(yargs_1.default);
+const conflictsSpy = vi
+    .spyOn(yargs_1.default, 'conflicts')
+    .mockReturnValue(yargs_1.default);
+const exampleSpy = vi
+    .spyOn(yargs_1.default, 'example')
+    .mockReturnValue(yargs_1.default);
+describe('commands/project/logs', () => {
+    beforeEach(() => {
+        // @ts-expect-error Doesn't match the actual signature because then the linter complains about unused variables
+        processExitSpy.mockImplementation(() => { });
+    });
+    describe('command', () => {
+        it('should have the correct command structure', async () => {
+            expect(logs_1.default.command).toEqual('logs');
+        });
+    });
+    describe('describe', () => {
+        it('should contain the beta tag', () => {
+            expect(logs_1.default.describe).toContain('[BETA]');
+        });
+        it('should provide a description', () => {
+            expect(logs_1.default.describe).toBeDefined();
+        });
+    });
+    describe('builder', () => {
+        it('should support the correct options', () => {
+            logs_1.default.builder(yargs_1.default);
+            expect(optionsSpy).toHaveBeenCalledTimes(1);
+            expect(optionsSpy).toHaveBeenCalledWith({
+                function: expect.objectContaining({
+                    alias: 'function',
+                    requiresArg: true,
+                    type: 'string',
+                }),
+                latest: expect.objectContaining({
+                    alias: 'l',
+                    type: 'boolean',
+                }),
+                compact: expect.objectContaining({
+                    type: 'boolean',
+                }),
+                tail: expect.objectContaining({
+                    alias: ['t', 'follow'],
+                    type: 'boolean',
+                }),
+                limit: expect.objectContaining({
+                    type: 'number',
+                }),
+            });
+            expect(commonOpts_1.addUseEnvironmentOptions).toHaveBeenCalledTimes(1);
+            expect(commonOpts_1.addUseEnvironmentOptions).toHaveBeenCalledWith(yargs_1.default);
+        });
+        it('should set the correct conflicts', () => {
+            logs_1.default.builder(yargs_1.default);
+            expect(conflictsSpy).toHaveBeenCalledTimes(1);
+            expect(conflictsSpy).toHaveBeenCalledWith('tail', 'limit');
+        });
+        it('should provide examples', () => {
+            logs_1.default.builder(yargs_1.default);
+            expect(exampleSpy).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('handler', () => {
+        let options;
+        beforeEach(() => {
+            options = {
+                derivedAccountId: 12345678,
+            };
+            projectLogsPromptSpy.mockResolvedValue({ functionName: 'foo' });
+        });
+        it('should track the command usage', async () => {
+            await logs_1.default.handler(options);
+            expect(usageTracking_1.trackCommandUsage).toHaveBeenCalledTimes(1);
+            expect(usageTracking_1.trackCommandUsage).toHaveBeenCalledWith('project-logs', undefined, options.derivedAccountId);
+        });
+        it('should initialize the ProjectLogsManager', async () => {
+            await logs_1.default.handler(options);
+            expect(projectLogsManagerInitSpy).toHaveBeenCalledTimes(1);
+            expect(projectLogsManagerInitSpy).toHaveBeenCalledWith(options.derivedAccountId);
+        });
+        it('should prompt the user for input', async () => {
+            const functionNames = ['function1', 'function2'];
+            projectLogsManagerGetFunctionNamesSpy.mockReturnValue(functionNames);
+            await logs_1.default.handler(options);
+            expect(projectLogsPromptSpy).toHaveBeenCalledTimes(1);
+            expect(projectLogsPromptSpy).toHaveBeenCalledWith({
+                functionChoices: functionNames,
+                promptOptions: options,
+            });
+        });
+        it('should set the function', async () => {
+            const selectedFunction = 'function1';
+            projectLogsManagerGetFunctionNamesSpy.mockReturnValue([
+                selectedFunction,
+                'function2',
+            ]);
+            projectLogsPromptSpy.mockResolvedValue({
+                functionName: selectedFunction,
+            });
+            await logs_1.default.handler(options);
+            expect(projectLogsManagerSetFunctionSpy).toHaveBeenCalledTimes(1);
+            expect(projectLogsManagerSetFunctionSpy).toHaveBeenCalledWith(selectedFunction);
+        });
+        it('should log public functions correctly', async () => {
+            const functionNames = ['function1', 'function2'];
+            const selectedFunction = 'function1';
+            projectLogsManagerGetFunctionNamesSpy.mockReturnValue(functionNames);
+            projectLogsPromptSpy.mockResolvedValue({
+                functionName: selectedFunction,
+            });
+            const tableHeaders = ['Header 1', 'Header 2'];
+            getTableHeaderSpy.mockReturnValue(tableHeaders);
+            ProjectLogsManager_1.ProjectLogsManager.isPublicFunction = true;
+            ProjectLogsManager_1.ProjectLogsManager.accountId = options.derivedAccountId;
+            ProjectLogsManager_1.ProjectLogsManager.functionName = selectedFunction;
+            ProjectLogsManager_1.ProjectLogsManager.endpointName = 'my-endpoint';
+            ProjectLogsManager_1.ProjectLogsManager.appId = 123456;
+            await logs_1.default.handler(options);
+            expect(getTableHeaderSpy).toHaveBeenCalledTimes(1);
+            expect(getTableHeaderSpy).toHaveBeenCalledWith([
+                'Account',
+                'Function',
+                'Endpoint',
+            ]);
+            expect(getTableContentsSpy).toHaveBeenCalledTimes(1);
+            expect(getTableContentsSpy).toHaveBeenCalledWith([
+                tableHeaders,
+                [
+                    ProjectLogsManager_1.ProjectLogsManager.accountId,
+                    ProjectLogsManager_1.ProjectLogsManager.functionName,
+                    ProjectLogsManager_1.ProjectLogsManager.endpointName,
+                ],
+            ], { border: { bodyLeft: '  ' } });
+            expect(uiLinkSpy).toHaveBeenCalledTimes(1);
+            expect(uiLinkSpy).toHaveBeenCalledWith('View function logs in HubSpot', `https://app.hubspot.com/private-apps/${options.derivedAccountId}/${ProjectLogsManager_1.ProjectLogsManager.appId}/logs/serverlessGatewayExecution?path=${ProjectLogsManager_1.ProjectLogsManager.endpointName}`);
+            expect(uiLineSpy).toHaveBeenCalledTimes(1);
+        });
+        it('should log private functions correctly', async () => {
+            const functionNames = ['function1', 'function2'];
+            const selectedFunction = 'function1';
+            projectLogsManagerGetFunctionNamesSpy.mockReturnValue(functionNames);
+            projectLogsPromptSpy.mockResolvedValue({
+                functionName: selectedFunction,
+            });
+            const tableHeaders = ['Header 1', 'Header 2'];
+            getTableHeaderSpy.mockReturnValue(tableHeaders);
+            ProjectLogsManager_1.ProjectLogsManager.isPublicFunction = false;
+            ProjectLogsManager_1.ProjectLogsManager.accountId = options.derivedAccountId;
+            ProjectLogsManager_1.ProjectLogsManager.functionName = selectedFunction;
+            ProjectLogsManager_1.ProjectLogsManager.appId = 456789;
+            await logs_1.default.handler(options);
+            expect(getTableHeaderSpy).toHaveBeenCalledTimes(1);
+            expect(getTableHeaderSpy).toHaveBeenCalledWith(['Account', 'Function']);
+            expect(getTableContentsSpy).toHaveBeenCalledTimes(1);
+            expect(getTableContentsSpy).toHaveBeenCalledWith([
+                tableHeaders,
+                [ProjectLogsManager_1.ProjectLogsManager.accountId, ProjectLogsManager_1.ProjectLogsManager.functionName],
+            ], { border: { bodyLeft: '  ' } });
+            expect(uiLinkSpy).toHaveBeenCalledWith('View function logs in HubSpot', `https://app.hubspot.com/private-apps/${options.derivedAccountId}/${ProjectLogsManager_1.ProjectLogsManager.appId}/logs/crm?serverlessFunction=${selectedFunction}`);
+            expect(uiLineSpy).toHaveBeenCalledTimes(1);
+        });
+        it('should handle errors correctly', async () => {
+            const error = new Error('Something went wrong');
+            projectLogsManagerInitSpy.mockImplementation(() => {
+                throw error;
+            });
+            ProjectLogsManager_1.ProjectLogsManager.projectName = 'Super cool project';
+            await logs_1.default.handler(options);
+            expect(errorHandlers_1.logError).toHaveBeenCalledTimes(1);
+            expect(errorHandlers_1.logError).toHaveBeenCalledWith(error, {
+                accountId: options.derivedAccountId,
+                projectName: ProjectLogsManager_1.ProjectLogsManager.projectName,
+            });
+            expect(processExitSpy).toHaveBeenCalledTimes(1);
+            expect(processExitSpy).toHaveBeenCalledWith(exitCodes_1.EXIT_CODES.ERROR);
+        });
+    });
+});

package/commands/project/__tests__/migrate.test.d.ts

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

package/commands/project/__tests__/migrate.test.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const projects_1 = require("@hubspot/local-dev-lib/constants/projects");
+const migrate_1 = __importDefault(require("../migrate"));
+const migrate_2 = require("../../../lib/app/migrate");
+const config_1 = require("../../../lib/projects/config");
+const en_1 = require("../../../lang/en");
+const ui_1 = require("../../../lib/ui");
+vi.mock('@hubspot/local-dev-lib/logger');
+vi.mock('../../../lib/app/migrate');
+vi.mock('../../../lib/projects/config');
+vi.mock('../../../lib/ui');
+const { v2025_2 } = projects_1.PLATFORM_VERSIONS;
+describe('commands/project/migrate', () => {
+    const yargsMock = yargs_1.default;
+    const optionsSpy = vi.spyOn(yargsMock, 'option').mockReturnValue(yargsMock);
+    // Mock the imported functions
+    const migrateApp2025_2Mock = migrate_2.migrateApp2025_2;
+    const getProjectConfigMock = config_1.getProjectConfig;
+    const uiBetaTagMock = ui_1.uiBetaTag;
+    const uiCommandReferenceMock = ui_1.uiCommandReference;
+    const mockExit = vi
+        .spyOn(process, 'exit')
+        .mockImplementation(() => undefined);
+    beforeEach(() => {
+        // Mock logger methods
+        vi.spyOn(logger_1.logger, 'log').mockImplementation(() => { });
+        vi.spyOn(logger_1.logger, 'error').mockImplementation(() => { });
+        migrateApp2025_2Mock.mockResolvedValue(undefined);
+        getProjectConfigMock.mockResolvedValue({
+            projectConfig: { name: 'test-project' },
+        });
+        uiBetaTagMock.mockReturnValue('beta test description');
+        uiCommandReferenceMock.mockReturnValue('command reference');
+        mockExit.mockClear();
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('command', () => {
+        it('should have the correct command structure', () => {
+            expect(migrate_1.default.command).toEqual('migrate');
+        });
+    });
+    describe('describe', () => {
+        it('should provide a description', () => {
+            expect(migrate_1.default.describe).toBe(undefined);
+        });
+    });
+    describe('builder', () => {
+        it('should support the correct options', () => {
+            migrate_1.default.builder(yargsMock);
+            expect(optionsSpy).toHaveBeenCalledWith('platform-version', {
+                type: 'string',
+                choices: [v2025_2],
+                default: v2025_2,
+                hidden: true,
+            });
+            expect(optionsSpy).toHaveBeenCalledWith('unstable', {
+                type: 'boolean',
+                default: false,
+                hidden: true,
+            });
+        });
+    });
+    describe('handler', () => {
+        let options;
+        beforeEach(() => {
+            options = {
+                platformVersion: v2025_2,
+                unstable: false,
+                derivedAccountId: 123,
+            };
+        });
+        it('should exit with error if no project config exists', async () => {
+            getProjectConfigMock.mockResolvedValue({ projectConfig: null });
+            await migrate_1.default.handler(options);
+            expect(logger_1.logger.error).toHaveBeenCalledWith(en_1.commands.project.migrate.errors.noProjectConfig('command reference'));
+            expect(mockExit).toHaveBeenCalledWith(1);
+            expect(mockExit).toHaveBeenCalledTimes(1);
+        });
+        it('should call migrateApp2025_2 with correct parameters', async () => {
+            await migrate_1.default.handler(options);
+            expect(migrateApp2025_2Mock).toHaveBeenCalledWith(123, {
+                ...options,
+                name: 'test-project',
+                platformVersion: v2025_2,
+            }, { projectConfig: { name: 'test-project' } });
+            expect(mockExit).toHaveBeenCalledWith(0);
+            expect(mockExit).toHaveBeenCalledTimes(1);
+        });
+        it('should use unstable platform version when unstable flag is true', async () => {
+            options.unstable = true;
+            await migrate_1.default.handler(options);
+            expect(migrateApp2025_2Mock).toHaveBeenCalledWith(123, {
+                ...options,
+                name: 'test-project',
+                platformVersion: projects_1.PLATFORM_VERSIONS.unstable,
+            }, { projectConfig: { name: 'test-project' } });
+            expect(mockExit).toHaveBeenCalledWith(0);
+            expect(mockExit).toHaveBeenCalledTimes(1);
+        });
+        it('should handle errors and exit with error code', async () => {
+            const error = new Error('Test error');
+            migrateApp2025_2Mock.mockRejectedValue(error);
+            await migrate_1.default.handler(options);
+            expect(mockExit).toHaveBeenCalledWith(1);
+            expect(mockExit).toHaveBeenCalledTimes(1);
+        });
+    });
+});

package/commands/project/__tests__/migrateApp.test.d.ts

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