@hubspot/cli 7.9.0 → 7.10.0-beta.1

package/lang/en.js

@@ -51,12 +51,11 @@ export const commands = {
             uploadProject: (accountName) => `Would you like to upload this project to account "${accountName}" now?`,
             projectCreated: {
                 title: chalk.bold('Next steps:'),
-                description: `Let's prepare and upload your project to HubSpot.\nYou can use ${uiCommandReference('hs project install-deps')} to ${chalk.bold('install dependencies')} and ${uiCommandReference('hs project upload')} to ${chalk.bold('upload')} your project.`,
+                description: `Let's prepare and upload your project to HubSpot.\nYou can use ${uiCommandReference('hs project upload')} to ${chalk.bold('upload')} your project.`,
             },
         },
         logs: {
             appSelected: `We'll create a new project with a sample app for you.\nProjects are what you can use to create apps with HubSpot.\nUsually you'll use the ${uiCommandReference('hs project create')} command, but we'll go ahead and make one now.`,
-            dependenciesInstalled: 'Dependencies installed successfully.',
             uploadingProject: 'Uploading your project to HubSpot...',
             uploadSuccess: 'Project uploaded successfully!',
             developerOverviewLink: 'Open this link to navigate to your HubSpot developer portal',
@@ -64,7 +63,6 @@ export const commands = {
         errors: {
             uploadFailed: 'Failed to upload project to HubSpot.',
             configFileNotFound: 'Could not find project configuration for upload.',
-            installDepsFailed: 'Failed to install dependencies.',
         },
     },
     completion: {
@@ -120,7 +118,7 @@ export const commands = {
                     },
                 },
                 success: {
-                    renamed: (name, newName) => `Account "${name}" renamed to "${newName}"`,
+                    renamed: (name, newName, nameWasSanitized) => `Account "${chalk.bold(name)}" successfully renamed to "${chalk.bold(newName)}"${nameWasSanitized ? ' (Sanitized to remove invalid characters)' : ''}.`,
                 },
             },
             use: {
@@ -1198,6 +1196,7 @@ export const commands = {
         setup: {
             describe: 'Setup the HubSpot development MCP servers.',
             installingDocSearch: 'Adding the docs-search mcp server',
+            codex: 'Codex CLI',
             claudeCode: 'Claude Code',
             cursor: 'Cursor',
             windsurf: 'Windsurf',
@@ -1219,7 +1218,11 @@ export const commands = {
                 configuredClaudeCode: 'Configured Claude Code',
                 claudeCodeNotFound: 'Claude Code not found - skipping configuration',
                 claudeCodeInstallFailed: 'Claude Code CLI not working - skipping configuration',
-                failedToConfigureClaudeDesktop: 'Failed to configure Claude Desktop',
+                // Codex
+                configuringCodex: 'Configuring Codex...',
+                configuredCodex: 'Configured Codex',
+                codexNotFound: 'Codex command not found - skipping configuration',
+                codexInstallFailed: 'Failed to configure Codex',
                 // Cursor
                 configuringCursor: 'Configuring Cursor...',
                 failedToConfigureCursor: 'Failed to configure Cursor',
@@ -1765,6 +1768,22 @@ export const commands = {
             noPackageJsonInProject: (projectName) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
             packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
         },
+        updateDeps: {
+            help: {
+                describe: 'Update the npm dependencies for your project, or update specific dependencies in a subcomponent of a project.',
+                updateAppDepsExample: 'Update the dependencies for the project',
+                updateDepToSubComponentExample: 'Update the npm dependencies in one or more project subcomponents',
+            },
+            installLocationPrompt: 'Choose which project components you would like to update the dependencies for:',
+            installLocationPromptRequired: 'You must choose at least one subcomponent',
+            updatingDependencies: (directory) => `Updating dependencies in ${directory}`,
+            updateSuccessful: (directory) => `Updated dependencies in ${directory}`,
+            updatingDependenciesToLocation: (dependencies, directory) => `Updating ${dependencies} in ${directory}`,
+            updatingDependenciesFailed: (directory) => `Updating dependencies for ${directory} failed`,
+            noProjectConfig: 'No project detected. Run this command from a project directory.',
+            noPackageJsonInProject: (projectName) => `No dependencies to update. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
+            packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
+        },
         validate: {
             describe: 'Validate the project before uploading',
             mustBeRanWithinAProject: 'This command must be run from within a project directory.',
@@ -2082,7 +2101,7 @@ export const commands = {
             },
         },
         create: {
-            describe: 'Create a test account from a config file',
+            describe: `Create a test account from scratch or from a config file. Use ${uiCommandReference('hs test-account create-config')} to generate a config file. \n${uiLink('Learn more', 'https://developers.hubspot.com/docs/developer-tooling/local-development/configurable-test-accounts')}`,
             configPathPrompt: '[--config-path] Enter the path to the test account config: ',
             createTestAccountFromConfigPrompt: 'How would you like to create your test account?',
             createFromConfigOption: 'Create test account from config file',
@@ -2099,9 +2118,21 @@ export const commands = {
                 createFailure: 'Failed to create test account.',
             },
             options: {
-                configPath: 'The path to the test account config',
+                configPath: 'Path to config file (mutually exclusive with other flags)',
+                accountName: 'Name for the test account',
+                description: 'Description for the test account',
+                marketingLevel: 'Marketing Hub tier. Unprovided tiers default to ENTERPRISE. Choices: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
+                opsLevel: 'Operations Hub tier. Unprovided tiers default to ENTERPRISE. Choices: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
+                serviceLevel: 'Service Hub tier. Unprovided tiers default to ENTERPRISE. Choices: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
+                salesLevel: 'Sales Hub tier. Unprovided tiers default to ENTERPRISE. Choices: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
+                contentLevel: 'CMS Hub tier. Unprovided tiers default to ENTERPRISE. Choices: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
             },
             example: (configPath) => `Create a test account from the config file at ${configPath}`,
+            examples: {
+                withAllHubsEnterprise: 'Create a test account with all hubs at ENTERPRISE level',
+                withSpecificHubLevels: 'Create a test account with specific hub levels',
+            },
+            savedAccountNameDiffers: (originalName, savedName) => `Account name "${chalk.bold(originalName)}" was saved as "${chalk.bold(savedName)}" in config.`,
         },
         createConfig: {
             describe: 'Create a test account config file.',
@@ -2964,12 +2995,16 @@ export const lib = {
             },
         },
         add: {
-            nothingAdded: 'No features added.',
+            nothingAdded: 'No features were added to the project. Use the space bar to select features from the list.',
         },
         updateHsMetaFilesWithAutoGeneratedFields: {
             header: 'Created the following components and features:',
             applicationLog: (componentType, uid, name) => `  - Created ${chalk.bold(componentType)} with uid ${chalk.bold(uid)} and name ${chalk.bold(name)}`,
             componentLog: (componentType, uid) => `  - Created ${chalk.bold(componentType)} feature with uid ${chalk.bold(uid)}`,
+            failedToUpdate: (hsMetaFile) => `Failed to update the uid in ${chalk.bold(hsMetaFile)}`,
+        },
+        generateSafeFilenameDifferentiator: {
+            failedToCheckFiles: 'Failed to check files for filename differentiator. Falling back to timestamp.',
         },
         validateProjectConfig: {
             configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${uiCommandReference('hs project create')} to create a new project.`,

package/lib/__tests__/dependencyManagement.test.js

@@ -1,5 +1,5 @@
 import util from 'util';
-import { installPackages, getProjectPackageJsonLocations, } from '../dependencyManagement.js';
+import { installPackages, updatePackages, getProjectPackageJsonLocations, isPackageInstalled, } from '../dependencyManagement.js';
 import { walk } from '@hubspot/local-dev-lib/fs';
 import path from 'path';
 import { getProjectConfig } from '../projects/config.js';
@@ -105,6 +105,54 @@ describe('lib/dependencyManagement', () => {
                 cwd: extensionsDir,
             });
         });
+        it('should install packages as dev dependencies when dev flag is true', async () => {
+            const packages = ['eslint', 'prettier'];
+            await installPackages({ packages, installLocations, dev: true });
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+            for (const location of installLocations) {
+                expect(execMock).toHaveBeenCalledWith(`npm install --save-dev eslint prettier`, {
+                    cwd: location,
+                });
+            }
+        });
+        it('should install packages as regular dependencies when dev flag is false', async () => {
+            const packages = ['react', 'react-dom'];
+            await installPackages({ packages, installLocations, dev: false });
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+            for (const location of installLocations) {
+                expect(execMock).toHaveBeenCalledWith(`npm install react react-dom`, {
+                    cwd: location,
+                });
+            }
+        });
+        it('should install packages as regular dependencies when dev flag is not provided', async () => {
+            const packages = ['axios'];
+            await installPackages({ packages, installLocations });
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+            for (const location of installLocations) {
+                expect(execMock).toHaveBeenCalledWith(`npm install axios`, {
+                    cwd: location,
+                });
+            }
+        });
+        it('should not use --save-dev flag when dev is true but no packages are provided', async () => {
+            await installPackages({ installLocations, dev: true });
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+            for (const location of installLocations) {
+                expect(execMock).toHaveBeenCalledWith(`npm install `, {
+                    cwd: location,
+                });
+            }
+        });
+        it('should not use --save-dev flag when dev is true but packages array is empty', async () => {
+            await installPackages({ packages: [], installLocations, dev: true });
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+            for (const location of installLocations) {
+                expect(execMock).toHaveBeenCalledWith(`npm install `, {
+                    cwd: location,
+                });
+            }
+        });
         it('should throw an error when installing the dependencies fails', async () => {
             execMock = vi.fn().mockImplementation(command => {
                 if (command === 'npm --version') {
@@ -133,6 +181,92 @@ describe('lib/dependencyManagement', () => {
             });
         });
     });
+    describe('updatePackages()', () => {
+        it('should setup a loading spinner', async () => {
+            const packages = ['package1', 'package2'];
+            await updatePackages({ packages, installLocations });
+            expect(SpinniesManager.init).toHaveBeenCalledTimes(installLocations.length);
+            expect(SpinniesManager.add).toHaveBeenCalledTimes(installLocations.length);
+            expect(SpinniesManager.succeed).toHaveBeenCalledTimes(installLocations.length);
+        });
+        it('should update the provided packages in all the provided install locations', async () => {
+            const packages = ['package1', 'package2'];
+            await updatePackages({ packages, installLocations });
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+            expect(SpinniesManager.add).toHaveBeenCalledTimes(installLocations.length);
+            expect(SpinniesManager.succeed).toHaveBeenCalledTimes(installLocations.length);
+            for (const location of installLocations) {
+                expect(execMock).toHaveBeenCalledWith(`npm update package1 package2`, {
+                    cwd: location,
+                });
+                expect(SpinniesManager.add).toHaveBeenCalledWith(`updatingDependencies-${location}`, {
+                    text: `Updating [package1, package2] in ${location}`,
+                });
+                expect(SpinniesManager.succeed).toHaveBeenCalledWith(`updatingDependencies-${location}`, {
+                    text: `Updated dependencies in ${location}`,
+                });
+            }
+        });
+        it('should use the provided install locations', async () => {
+            await updatePackages({ installLocations });
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+            expect(execMock).toHaveBeenCalledWith(`npm update `, {
+                cwd: appFunctionsDir,
+            });
+            expect(execMock).toHaveBeenCalledWith(`npm update `, {
+                cwd: extensionsDir,
+            });
+        });
+        it('should locate the projects package.json files when install locations is not provided', async () => {
+            const installLocations = [
+                path.join(appFunctionsDir, 'package.json'),
+                path.join(extensionsDir, 'package.json'),
+            ];
+            mockedWalk.mockResolvedValue(installLocations);
+            mockedGetProjectConfig.mockResolvedValue({
+                projectDir,
+                projectConfig: {
+                    srcDir,
+                },
+            });
+            await updatePackages({});
+            // It's called once per each install location, plus once to check if npm installed
+            expect(execMock).toHaveBeenCalledTimes(installLocations.length + 1);
+            expect(execMock).toHaveBeenCalledWith(`npm update `, {
+                cwd: appFunctionsDir,
+            });
+            expect(execMock).toHaveBeenCalledWith(`npm update `, {
+                cwd: extensionsDir,
+            });
+        });
+        it('should throw an error when updating the dependencies fails', async () => {
+            execMock = vi.fn().mockImplementation(command => {
+                if (command === 'npm --version') {
+                    return;
+                }
+                throw new Error('OH NO');
+            });
+            util.promisify = mockedPromisify(execMock);
+            // Mock walk to return the directory paths instead of package.json paths
+            mockedWalk.mockResolvedValue([appFunctionsDir, extensionsDir]);
+            mockedFs.existsSync.mockImplementation(filePath => {
+                const pathStr = filePath.toString();
+                if (pathStr === projectDir ||
+                    pathStr === path.join(projectDir, srcDir)) {
+                    return true;
+                }
+                return false;
+            });
+            await expect(() => updatePackages({ installLocations: [appFunctionsDir, extensionsDir] })).rejects.toThrowError(`Updating dependencies for ${appFunctionsDir} failed`);
+            expect(SpinniesManager.fail).toHaveBeenCalledTimes(installLocations.length);
+            expect(SpinniesManager.fail).toHaveBeenCalledWith(`updatingDependencies-${appFunctionsDir}`, {
+                text: `Updating dependencies for ${appFunctionsDir} failed`,
+            });
+            expect(SpinniesManager.fail).toHaveBeenCalledWith(`updatingDependencies-${extensionsDir}`, {
+                text: `Updating dependencies for ${extensionsDir} failed`,
+            });
+        });
+    });
     describe('getProjectPackageJsonFiles()', () => {
         it('should throw an error when ran outside the boundary of a project', async () => {
             mockedGetProjectConfig.mockResolvedValue({});
@@ -149,6 +283,30 @@ describe('lib/dependencyManagement', () => {
             mockedFs.existsSync.mockReturnValueOnce(false);
             await expect(() => getProjectPackageJsonLocations()).rejects.toThrowError(new RegExp(`No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files.`));
         });
+        it('should throw "install" error message when isUpdate=false and no package.json files found', async () => {
+            mockedWalk.mockResolvedValue([]);
+            mockedFs.existsSync.mockImplementation(filePath => {
+                const pathStr = filePath.toString();
+                if (pathStr === projectDir ||
+                    pathStr === path.join(projectDir, srcDir)) {
+                    return true;
+                }
+                return false;
+            });
+            await expect(() => getProjectPackageJsonLocations(undefined, false)).rejects.toThrowError(new RegExp(`No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files.`));
+        });
+        it('should throw "update" error message when isUpdate=true and no package.json files found', async () => {
+            mockedWalk.mockResolvedValue([]);
+            mockedFs.existsSync.mockImplementation(filePath => {
+                const pathStr = filePath.toString();
+                if (pathStr === projectDir ||
+                    pathStr === path.join(projectDir, srcDir)) {
+                    return true;
+                }
+                return false;
+            });
+            await expect(() => getProjectPackageJsonLocations(undefined, true)).rejects.toThrowError(new RegExp(`No dependencies to update. The project ${projectName} folder might be missing component or subcomponent files.`));
+        });
         it('should ignore package.json files in certain directories', async () => {
             const nodeModulesDir = path.join(appDir, 'node_modules');
             const viteDir = path.join(appDir, '.vite');
@@ -172,4 +330,118 @@ describe('lib/dependencyManagement', () => {
             expect(actual).toEqual([appFunctionsDir, extensionsDir]);
         });
     });
+    describe('isPackageInstalled()', () => {
+        const testDir = '/test/directory';
+        const readFileSyncSpy = vi.spyOn(fs, 'readFileSync');
+        const existsSyncSpy = vi.spyOn(fs, 'existsSync');
+        function mockNodeModulesExists(packageName, exists = true) {
+            existsSyncSpy.mockImplementation(filePath => {
+                const pathStr = filePath.toString();
+                return (exists && pathStr === path.join(testDir, 'node_modules', packageName));
+            });
+        }
+        beforeEach(() => {
+            vi.clearAllMocks();
+            readFileSyncSpy.mockReset();
+            existsSyncSpy.mockReset();
+        });
+        it('should return true if package is in dependencies and in node_modules', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                dependencies: {
+                    eslint: '^9.0.0',
+                },
+            }));
+            mockNodeModulesExists('eslint', true);
+            const result = isPackageInstalled(testDir, 'eslint');
+            expect(result).toBe(true);
+            expect(readFileSyncSpy).toHaveBeenCalledWith(path.join(testDir, 'package.json'), 'utf-8');
+            expect(existsSyncSpy).toHaveBeenCalledWith(path.join(testDir, 'node_modules', 'eslint'));
+        });
+        it('should return true if package is in devDependencies and in node_modules', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                devDependencies: {
+                    prettier: '^3.0.0',
+                },
+            }));
+            mockNodeModulesExists('prettier', true);
+            const result = isPackageInstalled(testDir, 'prettier');
+            expect(result).toBe(true);
+        });
+        it('should return false if package is in package.json but not in node_modules', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                dependencies: {
+                    react: '^18.0.0',
+                },
+            }));
+            mockNodeModulesExists('react', false);
+            const result = isPackageInstalled(testDir, 'react');
+            expect(result).toBe(false);
+        });
+        it('should return false if package is not in package.json but is in node_modules', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                dependencies: {
+                    typescript: '^5.0.0',
+                },
+            }));
+            mockNodeModulesExists('lodash', true);
+            const result = isPackageInstalled(testDir, 'lodash');
+            expect(result).toBe(false);
+        });
+        it('should return false if package is not in package.json and not in node_modules', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                dependencies: {},
+            }));
+            mockNodeModulesExists('nonexistent-package', false);
+            const result = isPackageInstalled(testDir, 'nonexistent-package');
+            expect(result).toBe(false);
+        });
+        it('should return false if package.json cannot be read', () => {
+            readFileSyncSpy.mockImplementationOnce(() => {
+                throw new Error('File not found');
+            });
+            const result = isPackageInstalled(testDir, 'eslint');
+            expect(result).toBe(false);
+        });
+        it('should return false if package.json has invalid JSON', () => {
+            readFileSyncSpy.mockReturnValueOnce('invalid json{');
+            const result = isPackageInstalled(testDir, 'eslint');
+            expect(result).toBe(false);
+        });
+        it('should return false if checking node_modules throws an error', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                dependencies: {
+                    eslint: '^9.0.0',
+                },
+            }));
+            existsSyncSpy.mockImplementation(() => {
+                throw new Error('Permission denied');
+            });
+            const result = isPackageInstalled(testDir, 'eslint');
+            expect(result).toBe(false);
+        });
+        it('should handle scoped packages correctly', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                dependencies: {
+                    '@typescript-eslint/parser': '^8.0.0',
+                },
+            }));
+            mockNodeModulesExists('@typescript-eslint/parser', true);
+            const result = isPackageInstalled(testDir, '@typescript-eslint/parser');
+            expect(result).toBe(true);
+            expect(existsSyncSpy).toHaveBeenCalledWith(path.join(testDir, 'node_modules', '@typescript-eslint/parser'));
+        });
+        it('should check both dependencies and devDependencies', () => {
+            readFileSyncSpy.mockReturnValueOnce(JSON.stringify({
+                dependencies: {
+                    react: '^18.0.0',
+                },
+                devDependencies: {
+                    eslint: '^9.0.0',
+                },
+            }));
+            mockNodeModulesExists('eslint', true);
+            const result = isPackageInstalled(testDir, 'eslint');
+            expect(result).toBe(true);
+        });
+    });
 });

package/lib/commonOpts.js

@@ -149,16 +149,13 @@ export function setCLILogLevel(options) {
         setLogLevel(LOG_LEVEL.ERROR);
         SpinniesManager.setDisableOutput(true);
     }
-    else if (debug) {
+    else if (debug || networkDebug) {
         setLogLevel(LOG_LEVEL.DEBUG);
+        process.env.HUBSPOT_NETWORK_LOGGING = 'true';
     }
     else {
         setLogLevel(LOG_LEVEL.LOG);
     }
-    if (networkDebug) {
-        process.env.HUBSPOT_NETWORK_LOGGING = 'true';
-        setLogLevel(LOG_LEVEL.DEBUG);
-    }
 }
 export function getCommandName(argv) {
     return String(argv && argv._ && argv._[0]) || '';

package/lib/constants.d.ts

@@ -139,3 +139,4 @@ export declare const LEGACY_PRIVATE_APP_FILE = "app.json";
 export declare const THEME_FILE = "theme.json";
 export declare const CMS_ASSETS_FILE = "cms-assets.json";
 export declare const LEGACY_CONFIG_FILES: string[];
+export declare const ACCOUNT_LEVEL_CHOICES: readonly ["FREE", "STARTER", "PROFESSIONAL", "ENTERPRISE"];

package/lib/constants.js

@@ -135,3 +135,9 @@ export const LEGACY_CONFIG_FILES = [
     LEGACY_PRIVATE_APP_FILE,
     LEGACY_PUBLIC_APP_FILE,
 ];
+export const ACCOUNT_LEVEL_CHOICES = [
+    'FREE',
+    'STARTER',
+    'PROFESSIONAL',
+    'ENTERPRISE',
+];

package/lib/dependencyManagement.d.ts

@@ -1,6 +1,12 @@
-export declare function installPackages({ packages, installLocations, }: {
+export declare function installPackages({ packages, installLocations, dev, }: {
     packages?: string[];
     installLocations?: string[];
+    dev?: boolean;
 }): Promise<void>;
-export declare function getProjectPackageJsonLocations(dir?: string): Promise<string[]>;
+export declare function updatePackages({ packages, installLocations, }: {
+    packages?: string[];
+    installLocations?: string[];
+}): Promise<void>;
+export declare function getProjectPackageJsonLocations(dir?: string, isUpdate?: boolean): Promise<string[]>;
+export declare function isPackageInstalled(directory: string, packageName: string): boolean;
 export declare function hasMissingPackages(directory: string): Promise<boolean>;

package/lib/dependencyManagement.js

@@ -6,19 +6,21 @@ import { walk } from '@hubspot/local-dev-lib/fs';
 import { getProjectConfig } from './projects/config.js';
 import { commands } from '../lang/en.js';
 import SpinniesManager from './ui/SpinniesManager.js';
-import { isGloballyInstalled, executeInstall, DEFAULT_PACKAGE_MANAGER, } from './npm.js';
+import { isGloballyInstalled, executeInstall, executeUpdate, DEFAULT_PACKAGE_MANAGER, } from './npm.js';
 class NoPackageJsonFilesError extends Error {
-    constructor(projectName) {
-        super(commands.project.installDeps.noPackageJsonInProject(projectName));
+    constructor(projectName, isUpdate = false) {
+        super(isUpdate
+            ? commands.project.updateDeps.noPackageJsonInProject(projectName)
+            : commands.project.installDeps.noPackageJsonInProject(projectName));
     }
 }
-export async function installPackages({ packages, installLocations, }) {
+export async function installPackages({ packages, installLocations, dev = false, }) {
     const installDirs = installLocations || (await getProjectPackageJsonLocations());
     await Promise.all(installDirs.map(async (dir) => {
-        await installPackagesInDirectory(dir, packages);
+        await installPackagesInDirectory(dir, packages, dev);
     }));
 }
-async function installPackagesInDirectory(directory, packages) {
+async function installPackagesInDirectory(directory, packages, dev = false) {
     const spinner = `installingDependencies-${directory}`;
     const relativeDir = path.relative(process.cwd(), directory);
     SpinniesManager.init();
@@ -28,7 +30,8 @@ async function installPackagesInDirectory(directory, packages) {
             : commands.project.installDeps.installingDependencies(relativeDir),
     });
     try {
-        await executeInstall(packages, null, { cwd: directory });
+        const flags = dev && packages && packages.length > 0 ? '--save-dev' : null;
+        await executeInstall(packages, flags, { cwd: directory });
         SpinniesManager.succeed(spinner, {
             text: commands.project.installDeps.installationSuccessful(relativeDir),
         });
@@ -42,26 +45,60 @@ async function installPackagesInDirectory(directory, packages) {
         });
     }
 }
-export async function getProjectPackageJsonLocations(dir) {
+export async function updatePackages({ packages, installLocations, }) {
+    const installDirs = installLocations || (await getProjectPackageJsonLocations(undefined, true));
+    await Promise.all(installDirs.map(async (dir) => {
+        await updatePackagesInDirectory(dir, packages);
+    }));
+}
+async function updatePackagesInDirectory(directory, packages) {
+    const spinner = `updatingDependencies-${directory}`;
+    const relativeDir = path.relative(process.cwd(), directory);
+    SpinniesManager.init();
+    SpinniesManager.add(spinner, {
+        text: packages && packages.length
+            ? commands.project.updateDeps.updatingDependenciesToLocation(`[${packages.join(', ')}]`, relativeDir)
+            : commands.project.updateDeps.updatingDependencies(relativeDir),
+    });
+    try {
+        await executeUpdate(packages, null, { cwd: directory });
+        SpinniesManager.succeed(spinner, {
+            text: commands.project.updateDeps.updateSuccessful(relativeDir),
+        });
+    }
+    catch (e) {
+        SpinniesManager.fail(spinner, {
+            text: commands.project.updateDeps.updatingDependenciesFailed(relativeDir),
+        });
+        throw new Error(commands.project.updateDeps.updatingDependenciesFailed(relativeDir), {
+            cause: e,
+        });
+    }
+}
+export async function getProjectPackageJsonLocations(dir, isUpdate = false) {
     const projectConfig = await getProjectConfig(dir);
     if (!projectConfig ||
         !projectConfig.projectDir ||
         !projectConfig.projectConfig) {
-        throw new Error(commands.project.installDeps.noProjectConfig);
+        throw new Error(isUpdate
+            ? commands.project.updateDeps.noProjectConfig
+            : commands.project.installDeps.noProjectConfig);
     }
     const { projectDir, projectConfig: { srcDir, name }, } = projectConfig;
     if (!(await isGloballyInstalled(DEFAULT_PACKAGE_MANAGER))) {
-        throw new Error(commands.project.installDeps.packageManagerNotInstalled(DEFAULT_PACKAGE_MANAGER));
+        throw new Error(isUpdate
+            ? commands.project.updateDeps.packageManagerNotInstalled(DEFAULT_PACKAGE_MANAGER)
+            : commands.project.installDeps.packageManagerNotInstalled(DEFAULT_PACKAGE_MANAGER));
     }
     if (!fs.existsSync(projectConfig.projectDir) ||
         !fs.existsSync(path.join(projectDir, srcDir))) {
-        throw new NoPackageJsonFilesError(name);
+        throw new NoPackageJsonFilesError(name, isUpdate);
     }
     const packageJsonFiles = (await walk(path.join(projectDir, srcDir))).filter(file => file.includes('package.json') &&
         !file.includes('node_modules') &&
         !file.includes('.vite'));
     if (packageJsonFiles.length === 0) {
-        throw new NoPackageJsonFilesError(name);
+        throw new NoPackageJsonFilesError(name, isUpdate);
     }
     const packageParentDirs = [];
     packageJsonFiles.forEach(packageJsonFile => {
@@ -70,6 +107,32 @@ export async function getProjectPackageJsonLocations(dir) {
     });
     return packageParentDirs;
 }
+function isPackageInPackageJson(directory, packageName) {
+    const packageJsonPath = path.join(directory, 'package.json');
+    try {
+        const packageJsonContent = fs.readFileSync(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(packageJsonContent);
+        return !!((packageJson.dependencies && packageJson.dependencies[packageName]) ||
+            (packageJson.devDependencies && packageJson.devDependencies[packageName]));
+    }
+    catch (error) {
+        return false;
+    }
+}
+function isPackageInNodeModules(directory, packageName) {
+    const packagePath = path.join(directory, 'node_modules', packageName);
+    try {
+        return fs.existsSync(packagePath);
+    }
+    catch (error) {
+        return false;
+    }
+}
+export function isPackageInstalled(directory, packageName) {
+    const inPackageJson = isPackageInPackageJson(directory, packageName);
+    const actuallyInstalled = isPackageInNodeModules(directory, packageName);
+    return inPackageJson && actuallyInstalled;
+}
 export async function hasMissingPackages(directory) {
     const exec = util.promisify(execAsync);
     const { stdout } = await exec(`npm install --ignore-scripts --dry-run`, {

package/lib/mcp/__tests__/setup.test.d.ts

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