@hubspot/cli 7.10.0 → 7.11.0-beta.0

package/lib/projects/add/__tests__/v2AddComponent.test.js

@@ -5,9 +5,9 @@ import { createV2App } from '../../create/v2.js';
 import { confirmPrompt } from '../../../prompts/promptUtils.js';
 import { projectAddPromptV2 } from '../../../prompts/projectAddPrompt.js';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
-import { uiLogger } from '../../../ui/logger.js';
 import { getProjectMetadata } from '@hubspot/project-parsing-lib/src/lib/project.js';
 import { trackCommandUsage } from '../../../usageTracking.js';
+import { updateHsMetaFilesWithAutoGeneratedFields } from '../../components.js';
 import { commands } from '../../../../lang/en.js';
 vi.mock('fs');
 vi.mock('../../../prompts/promptUtils');
@@ -16,17 +16,19 @@ vi.mock('../../create/v2');
 vi.mock('../../../prompts/projectAddPrompt');
 vi.mock('@hubspot/local-dev-lib/github');
 vi.mock('../../../ui/logger.js');
+vi.mock('../../../ui/SpinniesManager.js');
 vi.mock('@hubspot/project-parsing-lib/src/lib/project');
 vi.mock('../../../usageTracking');
+vi.mock('../../components.js');
 const mockedFs = vi.mocked(fs);
 const mockedGetConfigForPlatformVersion = vi.mocked(getConfigForPlatformVersion);
 const mockedConfirmPrompt = vi.mocked(confirmPrompt);
 const mockedCreateV2App = vi.mocked(createV2App);
 const mockedProjectAddPromptV2 = vi.mocked(projectAddPromptV2);
 const mockedCloneGithubRepo = vi.mocked(cloneGithubRepo);
-const mockedUiLogger = vi.mocked(uiLogger);
 const mockedGetProjectMetadata = vi.mocked(getProjectMetadata);
 const mockedTrackCommandUsage = vi.mocked(trackCommandUsage);
+const mockedUpdateHsMetaFilesWithAutoGeneratedFields = vi.mocked(updateHsMetaFilesWithAutoGeneratedFields);
 describe('lib/projects/add/v2AddComponent', () => {
     const mockProjectConfig = {
         name: 'test-project',
@@ -75,6 +77,7 @@ describe('lib/projects/add/v2AddComponent', () => {
     describe('v2AddComponent()', () => {
         it('successfully adds a component when app already exists', async () => {
             const mockAppMeta = {
+                name: 'Test App',
                 config: {
                     distribution: 'private',
                     auth: { type: 'oauth' },
@@ -83,14 +86,33 @@ describe('lib/projects/add/v2AddComponent', () => {
             const mockPromptResponse = {
                 componentTemplate: [mockComponentTemplate],
             };
+            const mockUpdatedProjectMetadata = {
+                hsMetaFiles: ['/path/to/new-module.meta.json'],
+                components: {
+                    app: {
+                        count: 1,
+                        maxCount: 1,
+                        hsMetaFiles: ['/path/to/app.meta.json'],
+                    },
+                    module: {
+                        count: 1,
+                        maxCount: 5,
+                        hsMetaFiles: ['/path/to/new-module.meta.json'],
+                    },
+                },
+            };
             mockedGetConfigForPlatformVersion.mockResolvedValue(mockConfig);
-            mockedGetProjectMetadata.mockResolvedValue(mockProjectMetadata);
+            mockedGetProjectMetadata
+                .mockResolvedValueOnce(mockProjectMetadata)
+                .mockResolvedValueOnce(mockUpdatedProjectMetadata);
             mockedFs.readFileSync.mockReturnValue(JSON.stringify(mockAppMeta));
             mockedProjectAddPromptV2.mockResolvedValue(mockPromptResponse);
             mockedCloneGithubRepo.mockResolvedValue(true);
+            mockedUpdateHsMetaFilesWithAutoGeneratedFields.mockResolvedValue(undefined);
             await v2AddComponent(mockArgs, projectDir, mockProjectConfig, mockAccountId);
             expect(mockedGetConfigForPlatformVersion).toHaveBeenCalledWith('2025.2');
             expect(mockedGetProjectMetadata).toHaveBeenCalledWith('/path/to/project/src');
+            expect(mockedGetProjectMetadata).toHaveBeenCalledTimes(2);
             expect(mockedProjectAddPromptV2).toHaveBeenCalled();
             expect(mockedTrackCommandUsage).toHaveBeenCalledWith('project-add', {
                 type: 'module',
@@ -100,7 +122,11 @@ describe('lib/projects/add/v2AddComponent', () => {
                 hideLogs: true,
                 branch: 'main',
             }));
-            expect(mockedUiLogger.success).toHaveBeenCalled();
+            expect(mockedUpdateHsMetaFilesWithAutoGeneratedFields).toHaveBeenCalledWith('test-project', ['/path/to/new-module.meta.json'], [], expect.objectContaining({
+                currentProjectMetadata: mockProjectMetadata,
+                updatedProjectMetadata: mockUpdatedProjectMetadata,
+                showSuccessMessage: true,
+            }));
         });
         it('creates an app when no app exists and user confirms', async () => {
             const mockProjectMetadataNoApps = {

package/lib/projects/add/legacyAddComponent.js

@@ -38,7 +38,7 @@ export async function legacyAddComponent(args, projectDir, projectConfig, derive
             branch: DEFAULT_PROJECT_TEMPLATE_BRANCH,
             hideLogs: true,
         });
-        uiLogger.success(commands.project.add.success(projectAddPromptResponse.name));
+        uiLogger.success(commands.project.add.success(projectConfig.name));
     }
     catch (error) {
         throw new Error(commands.project.add.error.failedToDownloadComponent);

package/lib/projects/add/v2AddComponent.js

@@ -13,8 +13,8 @@ import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
 import { debugError } from '../../errorHandlers/index.js';
 import { uiLogger } from '../../ui/logger.js';
 import { trackCommandUsage } from '../../usageTracking.js';
+import SpinniesManager from '../../ui/SpinniesManager.js';
 export async function v2AddComponent(args, projectDir, projectConfig, accountId) {
-    uiLogger.log(commands.project.add.creatingComponent(projectConfig.name));
     const config = await getConfigForPlatformVersion(projectConfig.platformVersion);
     const { components, parentComponents } = config;
     if (!components || !components.length) {
@@ -52,6 +52,10 @@ export async function v2AddComponent(args, projectDir, projectConfig, accountId)
     await trackCommandUsage('project-add', {
         type: componentTypes?.join(','),
     }, accountId);
+    SpinniesManager.init();
+    SpinniesManager.add('project-add', {
+        text: commands.project.add.creatingComponent(projectConfig.name),
+    });
     try {
         const components = projectAddPromptResponse.componentTemplate?.map((componentTemplate) => {
             return path.join(projectConfig.platformVersion, componentTemplate.path);
@@ -87,12 +91,19 @@ export async function v2AddComponent(args, projectDir, projectConfig, accountId)
                 return '';
             }
         });
-        updateHsMetaFilesWithAutoGeneratedFields(projectConfig.name, newHsMetaFiles, existingUids);
-        uiLogger.success(commands.project.add.success(projectAddPromptResponse.componentTemplate
-            .map(template => `'${template.label}'`)
-            .join(', '), projectAddPromptResponse.componentTemplate.length > 1));
+        SpinniesManager.succeed('project-add', {
+            text: commands.project.add.success(projectConfig.name),
+        });
+        await updateHsMetaFilesWithAutoGeneratedFields(projectConfig.name, newHsMetaFiles, existingUids, {
+            currentProjectMetadata,
+            updatedProjectMetadata,
+            showSuccessMessage: true,
+        });
     }
     catch (error) {
+        SpinniesManager.fail('project-add', {
+            text: commands.project.add.failure(projectConfig.name),
+        });
         debugError(error);
         throw new Error(commands.project.add.error.failedToDownloadComponent, {
             cause: error,

package/lib/projects/components.d.ts

@@ -1,3 +1,10 @@
 import { Collision } from '@hubspot/local-dev-lib/types/Archive';
+import { ProjectMetadata } from '@hubspot/project-parsing-lib/src/lib/project.js';
 export declare function handleComponentCollision({ dest, src, collisions }: Collision): void;
-export declare function updateHsMetaFilesWithAutoGeneratedFields(projectName: string, hsMetaFilePaths: string[], existingUids?: string[]): void;
+export declare function updateHsMetaFilesWithAutoGeneratedFields(projectName: string, hsMetaFilePaths: string[], existingUids?: string[], options?: {
+    currentProjectMetadata?: ProjectMetadata;
+    updatedProjectMetadata?: ProjectMetadata;
+    showSuccessMessage?: boolean;
+    isProjectEmpty?: boolean;
+    projectDest?: string;
+}): Promise<void>;

package/lib/projects/components.js

@@ -6,8 +6,59 @@ import { uiLogger } from '../ui/logger.js';
 import { AppKey } from '@hubspot/project-parsing-lib/src/lib/constants.js';
 import { lib } from '../../lang/en.js';
 import { debugError } from '../errorHandlers/index.js';
+import { uiLink } from '../ui/index.js';
+import chalk from 'chalk';
+import { renderInline } from '../../ui/index.js';
+import { getSuccessBox } from '../../ui/components/StatusMessageBoxes.js';
 // Prefix for the metafile extension
 const metafileExtensionPrefix = path.parse(metafileExtension).name;
+function buildProjectTree(projectName, uids, componentsByType, showOnlyNew) {
+    const lines = [];
+    lines.push(chalk.bold(projectName));
+    const types = Array.from(componentsByType.keys());
+    for (const uid of uids) {
+        lines.push(`├─ [app] ${uid}`);
+        for (let i = 0; i < types.length; i++) {
+            const type = types[i];
+            const allComponents = componentsByType.get(type) || [];
+            const components = showOnlyNew
+                ? allComponents.filter(c => c.isNew)
+                : allComponents;
+            if (components.length === 0)
+                continue;
+            const isLastType = i === types.length - 1;
+            const typePrefix = isLastType ? '│  └─' : '│  ├─';
+            const typeConnector = isLastType ? '   ' : '│  ';
+            lines.push(`${typePrefix} ${type}`);
+            for (let j = 0; j < components.length; j++) {
+                const component = components[j];
+                const isLastComponent = j === components.length - 1;
+                const componentPrefix = isLastComponent ? '└─' : '├─';
+                const addedLabel = component.isNew ? chalk.green(' (added)') : '';
+                lines.push(`│  ${typeConnector}${componentPrefix} ${component.filename}${addedLabel}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function buildSuccessMessage(projectName, uids, componentsByType, newComponentsCount, showOnlyNew, isProjectEmpty, projectDest) {
+    const messages = lib.projects.components.buildSuccessMessage;
+    const tree = buildProjectTree(projectName, uids, componentsByType, showOnlyNew);
+    const featureText = `${newComponentsCount} feature${newComponentsCount > 1 ? 's' : ''}`;
+    const uid = uids.length === 1 ? uids[0] : projectName;
+    const docsLink = uiLink(messages.seeOurDocs, messages.docsUrl);
+    const header = projectDest
+        ? messages.headerCreated(projectName, projectDest)
+        : messages.headerAdded(featureText, uid, newComponentsCount > 1);
+    // Use \n\n between sections to create gaps, \n within sections for no gaps
+    const sections = [
+        header,
+        isProjectEmpty ? null : tree,
+        messages.docsDetails(docsLink),
+        `${messages.uploadPrompt}\n${messages.devPrompt}`,
+    ].filter(Boolean);
+    return sections.join('\n\n');
+}
 function applyDifferentiatorToFilename(filename, differentiator, isHsMetaFile) {
     const { name, ext, dir } = path.parse(filename);
     if (isHsMetaFile) {
@@ -120,9 +171,7 @@ function handlePackageJsonCollisions(dest, src, packageJsonFiles) {
         fs.writeFileSync(path.join(dest, file), JSON.stringify(existingPackageJsonContents, null, 2));
     });
 }
-export function updateHsMetaFilesWithAutoGeneratedFields(projectName, hsMetaFilePaths, existingUids = []) {
-    uiLogger.log('');
-    uiLogger.log(lib.projects.updateHsMetaFilesWithAutoGeneratedFields.header);
+export async function updateHsMetaFilesWithAutoGeneratedFields(projectName, hsMetaFilePaths, existingUids = [], options) {
     for (const hsMetaFile of hsMetaFilePaths) {
         try {
             const component = JSON.parse(fs.readFileSync(hsMetaFile).toString());
@@ -142,10 +191,6 @@ export function updateHsMetaFilesWithAutoGeneratedFields(projectName, hsMetaFile
             component.uid = uid;
             if (component.type === AppKey && component.config) {
                 component.config.name = `${projectName}-Application`;
-                uiLogger.log(lib.projects.updateHsMetaFilesWithAutoGeneratedFields.applicationLog(component.type, component.uid, component.config.name));
-            }
-            else {
-                uiLogger.log(lib.projects.updateHsMetaFilesWithAutoGeneratedFields.componentLog(component.type, component.uid));
             }
             fs.writeFileSync(hsMetaFile, JSON.stringify(component, null, 2));
         }
@@ -154,5 +199,43 @@ export function updateHsMetaFilesWithAutoGeneratedFields(projectName, hsMetaFile
             uiLogger.error(lib.projects.updateHsMetaFilesWithAutoGeneratedFields.failedToUpdate(hsMetaFile));
         }
     }
-    uiLogger.log('');
+    if (options?.showSuccessMessage && options?.updatedProjectMetadata) {
+        const { currentProjectMetadata, updatedProjectMetadata, isProjectEmpty, projectDest, } = options;
+        const uids = [];
+        const updatedAppsMetadata = updatedProjectMetadata.components[AppKey];
+        // Get UID(s) from -hsmeta.json files
+        if (updatedAppsMetadata?.hsMetaFiles) {
+            updatedAppsMetadata.hsMetaFiles.forEach(appLocation => {
+                try {
+                    const appConfig = JSON.parse(fs.readFileSync(appLocation, 'utf-8'));
+                    uids.push(appConfig.uid || 'unknown app'); // fallback to unknown app incase we can't get uid
+                }
+                catch (err) {
+                    uiLogger.debug(lib.projects.components.unableToGetUidFromHsmeta);
+                }
+            });
+        }
+        // Fallback if no app hsmeta files found or all failed to parse
+        if (uids.length === 0) {
+            uids.push('unknown app');
+        }
+        const componentsByType = new Map();
+        const addComponent = (hsMetaPath, isNew) => {
+            const type = path.basename(path.dirname(hsMetaPath));
+            const existing = componentsByType.get(type) || [];
+            existing.push({ filename: path.basename(hsMetaPath), isNew });
+            componentsByType.set(type, existing);
+        };
+        // Add new files
+        hsMetaFilePaths.forEach(hsMetaFile => addComponent(hsMetaFile, true));
+        if (currentProjectMetadata) {
+            Object.entries(currentProjectMetadata.components)
+                .filter(([type, metadata]) => type !== AppKey && metadata.count > 0)
+                .flatMap(([, metadata]) => metadata.hsMetaFiles)
+                .forEach(hsMetaFile => addComponent(hsMetaFile, false));
+        }
+        const newComponentsCount = hsMetaFilePaths.length;
+        const successMessage = buildSuccessMessage(projectName, uids, componentsByType, newComponentsCount, false, isProjectEmpty, projectDest);
+        await renderInline(getSuccessBox({ title: 'SUCCESS', message: successMessage }));
+    }
 }

package/lib/projects/create/__tests__/v2.test.js

@@ -1,12 +1,23 @@
 import { calculateComponentTemplateChoices } from '../v2.js';
 import { hasFeature } from '../../../hasFeature.js';
+import { getConfigAccountById as __getConfigAccountById } from '@hubspot/local-dev-lib/config';
+const getConfigAccountById = __getConfigAccountById;
 vi.mock('../../ui/logger.js');
 vi.mock('@hubspot/local-dev-lib/api/github');
 vi.mock('../../../hasFeature.js');
+vi.mock('@hubspot/local-dev-lib/config');
 const mockHasFeature = vi.mocked(hasFeature);
 describe('lib/projects/create/v2', () => {
     beforeEach(() => {
         mockHasFeature.mockResolvedValue(true);
+        // Mock account config
+        getConfigAccountById.mockReturnValue({
+            accountId: 123,
+            name: 'Test Account',
+            authType: 'personalaccesskey',
+            personalAccessKey: 'test-key',
+            env: 'prod',
+        });
     });
     describe('calculateComponentTemplateChoices()', () => {
         beforeEach(() => {

package/lib/projects/deploy.js

@@ -1,7 +1,7 @@
 import { uiLogger } from '../ui/logger.js';
 import { commands } from '../../lang/en.js';
 import { PROJECT_ERROR_TYPES } from '../constants.js';
-import { deployProject } from '@hubspot/local-dev-lib/api/projects';
+import { deployProjectV1, deployProjectV2, } from '@hubspot/local-dev-lib/api/projects';
 import { pollDeployStatus } from './pollProjectBuildAndDeploy.js';
 export function validateBuildIdForDeploy(buildId, deployedBuildId, latestBuildId, projectName, accountId) {
     if (Number(buildId) > latestBuildId) {
@@ -48,16 +48,29 @@ function handleBlockedDeploy(deployResp) {
     });
 }
 export async function handleProjectDeploy(targetAccountId, projectName, buildId, isV2Project, force) {
-    const { data: deployResp } = await deployProject(targetAccountId, projectName, buildId, isV2Project, force);
-    if (!deployResp || deployResp.buildResultType !== 'DEPLOY_QUEUED') {
-        if (deployResp?.buildResultType === 'DEPLOY_BLOCKED') {
-            handleBlockedDeploy(deployResp);
+    let deployId;
+    if (isV2Project) {
+        const { data: deployResp } = await deployProjectV2(targetAccountId, projectName, buildId, force);
+        if (!deployResp || deployResp.buildResultType !== 'DEPLOY_QUEUED') {
+            if (deployResp?.buildResultType === 'DEPLOY_BLOCKED') {
+                handleBlockedDeploy(deployResp);
+            }
+            else {
+                uiLogger.error(commands.project.deploy.errors.deploy);
+            }
+            return;
         }
-        else {
+        deployId = deployResp.id;
+    }
+    else {
+        const response = await deployProjectV1(targetAccountId, projectName, buildId, force);
+        const { data: deployResp } = response;
+        if (!deployResp) {
             uiLogger.error(commands.project.deploy.errors.deploy);
+            return;
         }
-        return;
+        deployId = deployResp.id;
     }
-    const deployResult = await pollDeployStatus(targetAccountId, projectName, Number(deployResp.id), buildId);
+    const deployResult = await pollDeployStatus(targetAccountId, projectName, Number(deployId), buildId);
     return deployResult;
 }

package/lib/projects/localDev/AppDevModeInterface.js

@@ -1,6 +1,6 @@
 import { fetchAppInstallationData } from '@hubspot/local-dev-lib/api/localDevAuth';
 import { fetchAppMetadataByUid, fetchPublicAppProductionInstallCounts, installStaticAuthAppOnTestAccount, } from '@hubspot/local-dev-lib/api/appsDev';
-import { getAccountConfig } from '@hubspot/local-dev-lib/config';
+import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { APP_AUTH_TYPES, APP_DISTRIBUTION_TYPES, APP_INSTALLATION_STATES, LOCAL_DEV_SERVER_MESSAGE_TYPES, } from '../../constants.js';
 import { EXIT_CODES } from '../../enums/exitCodes.js';
 import { isAppIRNode } from '../../projects/structure.js';
@@ -67,7 +67,7 @@ class AppDevModeInterface {
         return (this.appNode?.config.auth.type.toLowerCase() === APP_AUTH_TYPES.OAUTH);
     }
     isAutomaticallyInstallable() {
-        const targetTestingAccount = getAccountConfig(this.localDevState.targetTestingAccountId);
+        const targetTestingAccount = getConfigAccountById(this.localDevState.targetTestingAccountId);
         if (!targetTestingAccount) {
             return false;
         }

package/lib/projects/localDev/DevServerManager_DEPRECATED.js

@@ -2,10 +2,12 @@ import { logger } from '@hubspot/local-dev-lib/logger';
 import { DevModeInterface as UIEDevModeInterface } from '@hubspot/ui-extensions-dev-server';
 import { startPortManagerServer, stopPortManagerServer, requestPorts, } from '@hubspot/local-dev-lib/portManager';
 import { getHubSpotApiOrigin, getHubSpotWebsiteOrigin, } from '@hubspot/local-dev-lib/urls';
-import { getAccountConfig } from '@hubspot/local-dev-lib/config';
+import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
 import { ComponentTypes, } from '../../../types/Projects.js';
 import { lib } from '../../../lang/en.js';
 import { uiLogger } from '../../ui/logger.js';
+import { logError } from '../../errorHandlers/index.js';
+import { EXIT_CODES } from '../../enums/exitCodes.js';
 const SERVER_KEYS = {
     privateApp: 'privateApp',
     publicApp: 'publicApp',
@@ -58,11 +60,17 @@ class DevServerManager_DEPRECATED {
     async setup({ components, onUploadRequired, accountId, setActiveApp, }) {
         this.componentsByType = this.arrangeComponentsByType(components);
         let env;
-        const accountConfig = getAccountConfig(accountId);
+        const accountConfig = getConfigAccountById(accountId);
         if (accountConfig) {
             env = accountConfig.env;
         }
-        await startPortManagerServer();
+        try {
+            await startPortManagerServer();
+        }
+        catch (e) {
+            logError(e);
+            process.exit(EXIT_CODES.ERROR);
+        }
         await this.iterateDevServers(async (serverInterface, compatibleComponents) => {
             if (serverInterface.setup) {
                 await serverInterface.setup({

package/lib/projects/localDev/LocalDevLogger.js

@@ -1,5 +1,5 @@
-import { getAccountId, hasLocalStateFlag } from '@hubspot/local-dev-lib/config';
-import { getConfigDefaultAccount } from '@hubspot/local-dev-lib/config';
+import { hasLocalStateFlag } from '@hubspot/local-dev-lib/config';
+import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { uiLogger } from '../../ui/logger.js';
 import { uiLine, uiAccountDescription, uiCommandReference, } from '../../ui/index.js';
 import { lib } from '../../../lang/en.js';
@@ -30,9 +30,9 @@ class LocalDevLogger {
         uiLogger.error(langFunction(e instanceof Error ? e.message : ''));
     }
     getUploadCommand() {
-        const currentDefaultAccount = getConfigDefaultAccount() || undefined;
+        const currentDefaultAccount = getConfigDefaultAccountIfExists();
         return this.state.targetProjectAccountId !==
-            getAccountId(currentDefaultAccount)
+            currentDefaultAccount?.accountId
             ? uiCommandReference(`hs project upload --account=${this.state.targetProjectAccountId}`)
             : uiCommandReference('hs project upload');
     }

package/lib/projects/localDev/LocalDevManager_DEPRECATED.js

@@ -3,7 +3,7 @@ import chokidar from 'chokidar';
 import chalk from 'chalk';
 import { fetchAppInstallationData } from '@hubspot/local-dev-lib/api/localDevAuth';
 import { fetchPublicAppsForPortal, fetchPublicAppProductionInstallCounts, } from '@hubspot/local-dev-lib/api/appsDev';
-import { getAccountId, getConfigDefaultAccount, } from '@hubspot/local-dev-lib/config';
+import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { PROJECT_CONFIG_FILE } from '../../constants.js';
 import SpinniesManager from '../../ui/SpinniesManager.js';
 import DevServerManager_DEPRECATED from './DevServerManager_DEPRECATED.js';
@@ -200,8 +200,8 @@ class LocalDevManager {
         });
     }
     getUploadCommand() {
-        const currentDefaultAccount = getConfigDefaultAccount() || undefined;
-        return this.targetProjectAccountId !== getAccountId(currentDefaultAccount)
+        const currentDefaultAccount = getConfigDefaultAccountIfExists();
+        return this.targetProjectAccountId !== currentDefaultAccount?.accountId
             ? uiCommandReference(`hs project upload --account=${this.targetProjectAccountId}`)
             : uiCommandReference('hs project upload');
     }

package/lib/projects/localDev/helpers/account.d.ts

@@ -1,14 +1,14 @@
-import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
+import { HubSpotConfigAccount } from '@hubspot/local-dev-lib/types/Accounts';
 import { Environment } from '@hubspot/local-dev-lib/types/Config';
 import { DeveloperTestAccount } from '@hubspot/local-dev-lib/types/developerTestAccounts.js';
 import { ProjectDevTargetAccountPromptResponse } from '../../../prompts/projectDevTargetAccountPrompt.js';
-export declare function confirmDefaultAccountIsTarget(accountConfig: CLIAccount): Promise<void>;
-export declare function checkIfDefaultAccountIsSupported(accountConfig: CLIAccount, hasPublicApps: boolean): Promise<void>;
-export declare function checkIfParentAccountIsAuthed(accountConfig: CLIAccount): void;
-export declare function checkIfAccountFlagIsSupported(accountConfig: CLIAccount, hasPublicApps: boolean): void;
-export declare function suggestRecommendedNestedAccount(accounts: CLIAccount[], accountConfig: CLIAccount, hasPublicApps: boolean): Promise<ProjectDevTargetAccountPromptResponse>;
-export declare function createSandboxForLocalDev(accountId: number, accountConfig: CLIAccount, env: Environment): Promise<number>;
-export declare function createDeveloperTestAccountForLocalDev(accountId: number, accountConfig: CLIAccount, env: Environment, useV2?: boolean): Promise<number>;
+export declare function confirmDefaultAccountIsTarget(accountConfig: HubSpotConfigAccount): Promise<void>;
+export declare function checkIfDefaultAccountIsSupported(accountConfig: HubSpotConfigAccount, hasPublicApps: boolean): Promise<void>;
+export declare function checkIfParentAccountIsAuthed(accountConfig: HubSpotConfigAccount): void;
+export declare function checkIfAccountFlagIsSupported(accountConfig: HubSpotConfigAccount, hasPublicApps: boolean): void;
+export declare function suggestRecommendedNestedAccount(accounts: HubSpotConfigAccount[], accountConfig: HubSpotConfigAccount, hasPublicApps: boolean): Promise<ProjectDevTargetAccountPromptResponse>;
+export declare function createSandboxForLocalDev(accountId: number, accountConfig: HubSpotConfigAccount, env: Environment): Promise<number>;
+export declare function createDeveloperTestAccountForLocalDev(accountId: number, accountConfig: HubSpotConfigAccount, env: Environment, useV2?: boolean): Promise<number>;
 export declare function useExistingDevTestAccount(env: Environment, account: DeveloperTestAccount): Promise<void>;
-export declare function hasSandboxes(account: CLIAccount): Promise<boolean>;
-export declare function selectAccountTypePrompt(accountConfig: CLIAccount): Promise<string | null>;
+export declare function hasSandboxes(account: HubSpotConfigAccount): Promise<boolean>;
+export declare function selectAccountTypePrompt(accountConfig: HubSpotConfigAccount): Promise<string | null>;

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

@@ -1,6 +1,5 @@
 import { HUBSPOT_ACCOUNT_TYPE_STRINGS } from '@hubspot/local-dev-lib/constants/config';
-import { getAccountConfig } from '@hubspot/local-dev-lib/config';
-import { getAccountIdentifier } from '@hubspot/local-dev-lib/config/getAccountIdentifier';
+import { getConfigAccountById, getConfigAccountIfExists, } from '@hubspot/local-dev-lib/config';
 import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
 import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
 import { isMissingScopeError } from '@hubspot/local-dev-lib/errors/index';
@@ -60,8 +59,8 @@ export async function checkIfDefaultAccountIsSupported(accountConfig, hasPublicA
 }
 export function checkIfParentAccountIsAuthed(accountConfig) {
     if (!accountConfig.parentAccountId ||
-        !getAccountConfig(accountConfig.parentAccountId)) {
-        uiLogger.error(lib.localDevHelpers.account.checkIfParentAccountIsAuthed.notAuthedError(accountConfig.parentAccountId || '', uiAccountDescription(getAccountIdentifier(accountConfig))));
+        !getConfigAccountIfExists(accountConfig.parentAccountId)?.accountId) {
+        uiLogger.error(lib.localDevHelpers.account.checkIfParentAccountIsAuthed.notAuthedError(accountConfig.parentAccountId || '', uiAccountDescription(accountConfig.accountId)));
         process.exit(EXIT_CODES.SUCCESS);
     }
 }
@@ -122,11 +121,7 @@ export async function createSandboxForLocalDev(accountId, accountConfig, env) {
         trackCommandMetadataUsage('sandbox-create', { step: 'project-dev' }, accountId);
         const result = await buildSandbox(name, accountConfig, HUBSPOT_ACCOUNT_TYPES.DEVELOPMENT_SANDBOX, env);
         const targetAccountId = result.sandbox.sandboxHubId;
-        const sandboxAccountConfig = getAccountConfig(result.sandbox.sandboxHubId);
-        if (!sandboxAccountConfig) {
-            uiLogger.error(lib.sandbox.create.developer.failure.generic);
-            process.exit(EXIT_CODES.ERROR);
-        }
+        const sandboxAccountConfig = getConfigAccountById(result.sandbox.sandboxHubId);
         const syncTasks = await getAvailableSyncTypes(accountConfig, sandboxAccountConfig);
         // For v1 sandboxes, keep sync here. Once we migrate to v2, this will be handled by BE automatically
         await syncSandbox(sandboxAccountConfig, accountConfig, env, syncTasks, true);
@@ -190,7 +185,7 @@ export async function useExistingDevTestAccount(env, account) {
     uiLogger.success(lib.developerTestAccount.create.success.configFileUpdated(devTestAcctConfigName, PERSONAL_ACCESS_KEY_AUTH_METHOD.name));
 }
 export async function hasSandboxes(account) {
-    const accountId = getAccountIdentifier(account);
+    const accountId = account.accountId;
     if (!accountId) {
         return false;
     }
@@ -206,7 +201,7 @@ export async function hasSandboxes(account) {
 // Top level prompt to choose the type of account to test on
 export async function selectAccountTypePrompt(accountConfig) {
     const hasAccessToSandboxes = await hasSandboxes(accountConfig);
-    const accountId = getAccountIdentifier(accountConfig);
+    const accountId = accountConfig.accountId;
     const result = await listPrompt(lib.localDevHelpers.account.selectAccountTypePrompt.message, {
         choices: [
             {

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

@@ -5,9 +5,11 @@ import { uiLogger } from '../../../ui/logger.js';
 import { commands } from '../../../../lang/en.js';
 export async function confirmLocalDevIsNotRunning() {
     try {
-        await getServerPortByInstanceId(LOCAL_DEV_WEBSOCKET_SERVER_INSTANCE_ID);
-        uiLogger.error(commands.project.dev.errors.localDevAlreadyRunning);
-        process.exit(EXIT_CODES.ERROR);
+        const existingPortInUse = await getServerPortByInstanceId(LOCAL_DEV_WEBSOCKET_SERVER_INSTANCE_ID);
+        if (existingPortInUse) {
+            uiLogger.error(commands.project.dev.errors.localDevAlreadyRunning);
+            process.exit(EXIT_CODES.ERROR);
+        }
     }
     catch (error) {
         return;

package/lib/projects/uieLinting.d.ts

@@ -0,0 +1,33 @@
+export declare const REQUIRED_PACKAGES_AND_MIN_VERSIONS: {
+    readonly eslint: "9.0.0";
+    readonly '@typescript-eslint/eslint-plugin': "8.46.4";
+    readonly '@typescript-eslint/parser': "8.46.4";
+    readonly 'typescript-eslint': "8.46.4";
+    readonly jiti: "2.6.1";
+};
+export declare function isEslintInstalled(directory: string): boolean;
+export declare function areAllLintPackagesInstalled(directory: string): boolean;
+export declare function getMissingLintPackages(directory: string): {
+    missingPackages: string[];
+};
+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): string;
+export declare function lintPackagesInDirectory(directory: string, projectDir?: string): Promise<{
+    success: boolean;
+    output: string;
+}>;
+export declare function lintPackages(lintLocations?: string[], projectDir?: string): Promise<{
+    success: boolean;
+    results: Array<{
+        location: string;
+        success: boolean;
+        output: string;
+    }>;
+}>;
+export declare function displayLintResults(results: Array<{
+    location: string;
+    success: boolean;
+    output: string;
+}>): void;