@hubspot/cli 7.7.31-experimental.0 → 7.7.33-experimental.0

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

@@ -4,6 +4,7 @@ import { getProjectComponentListFromRepo } from '../../create/legacy.js';
 import { projectAddPrompt } from '../../../prompts/projectAddPrompt.js';
 import { logger } from '@hubspot/local-dev-lib/logger';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
+import { trackCommandUsage } from '../../../usageTracking.js';
 import { ComponentTypes, } from '../../../../types/Projects.js';
 import { commands } from '../../../../lang/en.js';
 vi.mock('../../structure');
@@ -11,21 +12,25 @@ vi.mock('../../create/legacy');
 vi.mock('../../../prompts/projectAddPrompt');
 vi.mock('@hubspot/local-dev-lib/logger');
 vi.mock('@hubspot/local-dev-lib/github');
+vi.mock('../../../usageTracking.js');
 const mockedFindProjectComponents = vi.mocked(findProjectComponents);
 const mockedGetProjectComponentListFromRepo = vi.mocked(getProjectComponentListFromRepo);
 const mockedProjectAddPrompt = vi.mocked(projectAddPrompt);
 const mockedLogger = vi.mocked(logger);
 const mockedCloneGithubRepo = vi.mocked(cloneGithubRepo);
+const mockedTrackCommandUsage = vi.mocked(trackCommandUsage);
 describe('lib/projects/add/legacyAddComponent', () => {
     const mockProjectConfig = {
         name: 'test-project',
         srcDir: 'src',
         platformVersion: 'v1',
     };
+    const accountId = 1234567890;
     const mockArgs = { name: 'test-component', type: 'module' };
     const projectDir = '/path/to/project';
     beforeEach(() => {
         vi.resetAllMocks();
+        mockedTrackCommandUsage.mockResolvedValue();
     });
     describe('legacyAddComponent()', () => {
         it('successfully adds a component to a project without public apps', async () => {
@@ -58,7 +63,7 @@ describe('lib/projects/add/legacyAddComponent', () => {
             mockedGetProjectComponentListFromRepo.mockResolvedValue(mockComponentList);
             mockedProjectAddPrompt.mockResolvedValue(mockPromptResponse);
             mockedCloneGithubRepo.mockResolvedValue(true);
-            await legacyAddComponent(mockArgs, projectDir, mockProjectConfig);
+            await legacyAddComponent(mockArgs, projectDir, mockProjectConfig, accountId);
             expect(mockedFindProjectComponents).toHaveBeenCalledWith(projectDir);
             expect(mockedGetProjectComponentListFromRepo).toHaveBeenCalledWith('v1');
             expect(mockedProjectAddPrompt).toHaveBeenCalledWith(mockComponentList, mockArgs);
@@ -67,6 +72,9 @@ describe('lib/projects/add/legacyAddComponent', () => {
                 branch: 'main',
                 hideLogs: true,
             }));
+            expect(mockedTrackCommandUsage).toHaveBeenCalledWith('project-add', {
+                type: 'module',
+            }, accountId);
             expect(mockedLogger.log).toHaveBeenCalledWith(commands.project.add.creatingComponent('test-project'));
             expect(mockedLogger.success).toHaveBeenCalledWith(commands.project.add.success('new-component'));
         });
@@ -97,7 +105,7 @@ describe('lib/projects/add/legacyAddComponent', () => {
                 },
             ];
             mockedFindProjectComponents.mockResolvedValue(mockComponents);
-            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig)).rejects.toThrow(commands.project.add.error.projectContainsPublicApp);
+            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig, accountId)).rejects.toThrow(commands.project.add.error.projectContainsPublicApp);
             expect(mockedGetProjectComponentListFromRepo).not.toHaveBeenCalled();
             expect(mockedProjectAddPrompt).not.toHaveBeenCalled();
             expect(mockedCloneGithubRepo).not.toHaveBeenCalled();
@@ -118,7 +126,7 @@ describe('lib/projects/add/legacyAddComponent', () => {
             mockedGetProjectComponentListFromRepo.mockResolvedValue(mockComponentList);
             mockedProjectAddPrompt.mockResolvedValue(mockPromptResponse);
             mockedCloneGithubRepo.mockResolvedValue(true);
-            await legacyAddComponent(mockArgs, projectDir, mockProjectConfig);
+            await legacyAddComponent(mockArgs, projectDir, mockProjectConfig, accountId);
             expect(mockedGetProjectComponentListFromRepo).toHaveBeenCalledWith('v1');
             expect(mockedProjectAddPrompt).toHaveBeenCalledWith(mockComponentList, mockArgs);
             expect(mockedCloneGithubRepo).toHaveBeenCalled();
@@ -140,7 +148,7 @@ describe('lib/projects/add/legacyAddComponent', () => {
             ];
             mockedFindProjectComponents.mockResolvedValue(mockComponents);
             mockedGetProjectComponentListFromRepo.mockResolvedValue([]);
-            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig)).rejects.toThrow(commands.project.add.error.failedToFetchComponentList);
+            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig, accountId)).rejects.toThrow(commands.project.add.error.failedToFetchComponentList);
             expect(mockedProjectAddPrompt).not.toHaveBeenCalled();
             expect(mockedCloneGithubRepo).not.toHaveBeenCalled();
         });
@@ -162,7 +170,7 @@ describe('lib/projects/add/legacyAddComponent', () => {
             mockedFindProjectComponents.mockResolvedValue(mockComponents);
             // @ts-expect-error Breaking stuff on purpose
             mockedGetProjectComponentListFromRepo.mockResolvedValue(null);
-            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig)).rejects.toThrow(commands.project.add.error.failedToFetchComponentList);
+            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig, accountId)).rejects.toThrow(commands.project.add.error.failedToFetchComponentList);
             expect(mockedProjectAddPrompt).not.toHaveBeenCalled();
             expect(mockedCloneGithubRepo).not.toHaveBeenCalled();
         });
@@ -196,9 +204,44 @@ describe('lib/projects/add/legacyAddComponent', () => {
             mockedGetProjectComponentListFromRepo.mockResolvedValue(mockComponentList);
             mockedProjectAddPrompt.mockResolvedValue(mockPromptResponse);
             mockedCloneGithubRepo.mockRejectedValue(new Error('Clone failed'));
-            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig)).rejects.toThrow(commands.project.add.error.failedToDownloadComponent);
+            await expect(legacyAddComponent(mockArgs, projectDir, mockProjectConfig, accountId)).rejects.toThrow(commands.project.add.error.failedToDownloadComponent);
             expect(mockedCloneGithubRepo).toHaveBeenCalled();
             expect(mockedLogger.success).not.toHaveBeenCalled();
         });
+        it('calls trackCommandUsage with correct component type', async () => {
+            const mockComponents = [
+                {
+                    type: ComponentTypes.PrivateApp,
+                    config: {
+                        name: 'private-app',
+                        description: '',
+                        uid: '',
+                        scopes: [],
+                        public: false,
+                    },
+                    runnable: true,
+                    path: '/path/to/private-app',
+                },
+            ];
+            const mockComponentList = [
+                { label: 'Card Component', path: 'card-component', type: 'card' },
+            ];
+            const mockPromptResponse = {
+                name: 'new-card',
+                componentTemplate: {
+                    label: 'Card Component',
+                    path: 'card-template-path',
+                    type: 'card',
+                },
+            };
+            mockedFindProjectComponents.mockResolvedValue(mockComponents);
+            mockedGetProjectComponentListFromRepo.mockResolvedValue(mockComponentList);
+            mockedProjectAddPrompt.mockResolvedValue(mockPromptResponse);
+            mockedCloneGithubRepo.mockResolvedValue(true);
+            await legacyAddComponent(mockArgs, projectDir, mockProjectConfig, accountId);
+            expect(mockedTrackCommandUsage).toHaveBeenCalledWith('project-add', {
+                type: 'card',
+            }, accountId);
+        });
     });
 });

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

@@ -33,7 +33,11 @@ describe('lib/projects/add/v3AddComponent', () => {
         srcDir: 'src',
         platformVersion: 'v3',
     };
-    const mockArgs = { name: 'test-component', type: 'module' };
+    const mockArgs = {
+        name: 'test-component',
+        type: 'module',
+        derivedAccountId: 1234,
+    };
     const projectDir = '/path/to/project';
     const mockAccountId = 123;
     const mockComponentTemplate = {
@@ -245,5 +249,71 @@ describe('lib/projects/add/v3AddComponent', () => {
                 type: '',
             }, mockAccountId);
         });
+        it('should track usage with cliSelector when available', async () => {
+            const mockAppMeta = {
+                config: {
+                    distribution: 'private',
+                    auth: { type: 'oauth' },
+                },
+            };
+            const mockComponentTemplateWithCliSelector = {
+                label: 'Workflow Action Tool',
+                path: 'workflow-action-tool',
+                type: 'workflow-action',
+                cliSelector: 'workflow-action-tool',
+                supportedAuthTypes: ['oauth'],
+                supportedDistributions: ['private'],
+            };
+            const mockPromptResponse = {
+                componentTemplate: [mockComponentTemplateWithCliSelector],
+            };
+            mockedGetConfigForPlatformVersion.mockResolvedValue(mockConfig);
+            mockedGetProjectMetadata.mockResolvedValue(mockProjectMetadata);
+            mockedFs.readFileSync.mockReturnValue(JSON.stringify(mockAppMeta));
+            mockedProjectAddPromptV3.mockResolvedValue(mockPromptResponse);
+            mockedCloneGithubRepo.mockResolvedValue(true);
+            await v3AddComponent(mockArgs, projectDir, mockProjectConfig, mockAccountId);
+            expect(mockedTrackCommandUsage).toHaveBeenCalledWith('project-add', {
+                type: 'workflow-action-tool',
+            }, mockAccountId);
+        });
+        it('should track usage with cliSelector for multiple components', async () => {
+            const mockAppMeta = {
+                config: {
+                    distribution: 'private',
+                    auth: { type: 'oauth' },
+                },
+            };
+            const mockComponentWithCliSelector = {
+                label: 'Workflow Action Tool',
+                path: 'workflow-action-tool',
+                type: 'workflow-action',
+                cliSelector: 'workflow-action-tool',
+                supportedAuthTypes: ['oauth'],
+                supportedDistributions: ['private'],
+            };
+            const mockComponentWithoutCliSelector = {
+                label: 'Regular Module',
+                path: 'module',
+                type: 'module',
+                supportedAuthTypes: ['oauth'],
+                supportedDistributions: ['private'],
+            };
+            const mockPromptResponse = {
+                componentTemplate: [
+                    mockComponentWithCliSelector,
+                    mockComponentWithoutCliSelector,
+                ],
+            };
+            mockedGetConfigForPlatformVersion.mockResolvedValue(mockConfig);
+            mockedGetProjectMetadata.mockResolvedValue(mockProjectMetadata);
+            mockedFs.readFileSync.mockReturnValue(JSON.stringify(mockAppMeta));
+            mockedProjectAddPromptV3.mockResolvedValue(mockPromptResponse);
+            mockedCloneGithubRepo.mockResolvedValue(true);
+            await v3AddComponent(mockArgs, projectDir, mockProjectConfig, mockAccountId);
+            expect(mockedTrackCommandUsage).toHaveBeenCalledWith('project-add', {
+                type: 'workflow-action-tool,module',
+            }, mockAccountId);
+        });
     });
 });

package/lib/projects/add/legacyAddComponent.d.ts

@@ -2,4 +2,4 @@ import { ProjectConfig } from '../../../types/Projects.js';
 export declare function legacyAddComponent(args: {
     name?: string;
     type?: string;
-}, projectDir: string, projectConfig: ProjectConfig): Promise<void>;
+}, projectDir: string, projectConfig: ProjectConfig, derivedAccountId: number): Promise<void>;

package/lib/projects/add/legacyAddComponent.js

@@ -8,7 +8,8 @@ import path from 'path';
 import { HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, DEFAULT_PROJECT_TEMPLATE_BRANCH, } from '../../constants.js';
 import { cloneGithubRepo } from '@hubspot/local-dev-lib/github';
 import { uiLogger } from '../../ui/logger.js';
-export async function legacyAddComponent(args, projectDir, projectConfig) {
+import { trackCommandUsage } from '../../usageTracking.js';
+export async function legacyAddComponent(args, projectDir, projectConfig, derivedAccountId) {
     // We currently only support adding private apps to projects
     let projectContainsPublicApp = false;
     try {
@@ -27,6 +28,9 @@ export async function legacyAddComponent(args, projectDir, projectConfig) {
         throw new Error(commands.project.add.error.failedToFetchComponentList);
     }
     const projectAddPromptResponse = await projectAddPrompt(components, args);
+    trackCommandUsage('project-add', {
+        type: projectAddPromptResponse.componentTemplate.type,
+    }, derivedAccountId);
     try {
         const componentPath = path.join(projectDir, projectConfig.srcDir, projectAddPromptResponse.name);
         await cloneGithubRepo(HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, componentPath, {

package/lib/projects/add/v3AddComponent.d.ts

@@ -5,4 +5,5 @@ export declare function v3AddComponent(args: {
     features?: string[];
     auth?: string;
     distribution?: string;
+    derivedAccountId: number;
 }, projectDir: string, projectConfig: ProjectConfig, accountId: number): Promise<void>;

package/lib/projects/add/v3AddComponent.js

@@ -46,9 +46,9 @@ export async function v3AddComponent(args, projectDir, projectConfig, accountId)
         derivedDistribution = apps[0].config?.distribution;
         derivedAuthType = apps[0].config?.auth?.type;
     }
-    const componentTemplateChoices = calculateComponentTemplateChoices(components, derivedAuthType, derivedDistribution, currentProjectMetadata);
+    const componentTemplateChoices = await calculateComponentTemplateChoices(components, derivedAuthType, derivedDistribution, args.derivedAccountId, currentProjectMetadata);
     const projectAddPromptResponse = await projectAddPromptV3(componentTemplateChoices, args.features);
-    const componentTypes = projectAddPromptResponse.componentTemplate?.map(componentTemplate => componentTemplate.type);
+    const componentTypes = projectAddPromptResponse.componentTemplate?.map(componentTemplate => componentTemplate.cliSelector || componentTemplate.type);
     await trackCommandUsage('project-add', {
         type: componentTypes?.join(','),
     }, accountId);

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

@@ -26,9 +26,9 @@ describe('lib/projects/create/v3', () => {
                 card: { count: 3, maxCount: 3, hsMetaFiles: [] },
             },
         };
-        it('returns enabled components when they meet all requirements', () => {
-            const choices = calculateComponentTemplateChoices(mockComponents, 'oauth', 'private', mockProjectMetadataForChoices);
-            expect(choices).toHaveLength(3); // includes separator
+        it('returns enabled components when they meet all requirements', async () => {
+            const choices = await calculateComponentTemplateChoices(mockComponents, 'oauth', 'private', 123, mockProjectMetadataForChoices);
+            expect(choices).toHaveLength(4); // includes separator
             expect(choices[0]).toEqual({
                 name: 'Module Component',
                 value: mockComponents[0],
@@ -39,8 +39,8 @@ describe('lib/projects/create/v3', () => {
                 disabled: expect.stringContaining('maximum'),
             });
         });
-        it('disables components when auth type is not supported', () => {
-            const choices = calculateComponentTemplateChoices(mockComponents, 'privatekey', 'private', mockProjectMetadataForChoices);
+        it('disables components when auth type is not supported', async () => {
+            const choices = await calculateComponentTemplateChoices(mockComponents, 'privatekey', 'private', 123, mockProjectMetadataForChoices);
             // All components should be disabled, so they come after the separator
             expect(choices[1]).toEqual({
                 name: expect.stringContaining('Module Component'),
@@ -48,8 +48,8 @@ describe('lib/projects/create/v3', () => {
                 disabled: expect.stringContaining('privatekey'),
             });
         });
-        it('disables components when distribution is not supported', () => {
-            const choices = calculateComponentTemplateChoices(mockComponents, 'oauth', 'enterprise', mockProjectMetadataForChoices);
+        it('disables components when distribution is not supported', async () => {
+            const choices = await calculateComponentTemplateChoices(mockComponents, 'oauth', 'enterprise', 123, mockProjectMetadataForChoices);
             // All components should be disabled, so they come after the separator
             expect(choices[1]).toEqual({
                 name: expect.stringContaining('Module Component'),
@@ -57,7 +57,7 @@ describe('lib/projects/create/v3', () => {
                 disabled: expect.stringContaining('enterprise'),
             });
         });
-        it('handles components without auth type or distribution restrictions', () => {
+        it('handles components without auth type or distribution restrictions', async () => {
             const componentsWithoutRestrictions = [
                 {
                     label: 'Unrestricted Component',
@@ -65,7 +65,7 @@ describe('lib/projects/create/v3', () => {
                     type: 'module',
                 },
             ];
-            const choices = calculateComponentTemplateChoices(componentsWithoutRestrictions, 'oauth', 'private', {
+            const choices = await calculateComponentTemplateChoices(componentsWithoutRestrictions, 'oauth', 'private', 123, {
                 hsMetaFiles: [],
                 components: { module: { count: 0, maxCount: 5, hsMetaFiles: [] } },
             });
@@ -74,5 +74,93 @@ describe('lib/projects/create/v3', () => {
                 value: componentsWithoutRestrictions[0],
             });
         });
+        it('handles components with cliSelector field (metadata compatibility)', async () => {
+            const componentWithCliSelector = [
+                {
+                    label: 'Workflow Action Tool',
+                    path: 'workflow-action-tool',
+                    type: 'workflow-action',
+                    cliSelector: 'workflow-action-tool',
+                    supportedAuthTypes: ['oauth'],
+                    supportedDistributions: ['private'],
+                },
+            ];
+            const projectMetadataWithWorkflowAction = {
+                hsMetaFiles: [],
+                components: {
+                    'workflow-action': { count: 2, maxCount: 3, hsMetaFiles: [] },
+                },
+            };
+            const choices = await calculateComponentTemplateChoices(componentWithCliSelector, 'oauth', 'private', 213, projectMetadataWithWorkflowAction);
+            expect(choices).toHaveLength(1); // no disabled components
+            expect(choices[0]).toEqual({
+                name: 'Workflow Action Tool',
+                value: componentWithCliSelector[0],
+            });
+        });
+        it('disables component when project metadata count exceeds maximum', async () => {
+            const componentWithCliSelector = [
+                {
+                    label: 'Workflow Action Tool',
+                    path: 'workflow-action-tool',
+                    type: 'workflow-action',
+                    cliSelector: 'workflow-action-tool',
+                    supportedAuthTypes: ['oauth'],
+                    supportedDistributions: ['private'],
+                },
+            ];
+            const projectMetadataAtMaxWorkflowAction = {
+                hsMetaFiles: [],
+                components: {
+                    'workflow-action': { count: 3, maxCount: 3, hsMetaFiles: [] },
+                },
+            };
+            const choices = await calculateComponentTemplateChoices(componentWithCliSelector, 'oauth', 'private', 123, projectMetadataAtMaxWorkflowAction);
+            expect(choices).toHaveLength(3); // includes separators
+            expect(choices[1]).toEqual({
+                name: expect.stringContaining('Workflow Action Tool'),
+                value: componentWithCliSelector[0],
+                disabled: expect.stringContaining('maximum'),
+            });
+        });
+        it('handles undefined projectMetadata without throwing errors', async () => {
+            const componentWithCliSelector = [
+                {
+                    label: 'Workflow Action Tool',
+                    path: 'workflow-action-tool',
+                    type: 'workflow-action',
+                    cliSelector: 'workflow-action-tool',
+                    supportedAuthTypes: ['oauth'],
+                    supportedDistributions: ['private'],
+                },
+            ];
+            const choices = await calculateComponentTemplateChoices(componentWithCliSelector, 'oauth', 'private', 123, undefined);
+            expect(choices).toHaveLength(1); // no disabled components
+            expect(choices[0]).toEqual({
+                name: 'Workflow Action Tool',
+                value: componentWithCliSelector[0],
+            });
+        });
+        it('handles projectMetadata with undefined components property (after fix)', async () => {
+            const componentWithCliSelector = [
+                {
+                    label: 'Workflow Action Tool',
+                    path: 'workflow-action-tool',
+                    type: 'workflow-action',
+                    cliSelector: 'workflow-action-tool',
+                    supportedAuthTypes: ['oauth'],
+                    supportedDistributions: ['private'],
+                },
+            ];
+            const projectMetadataWithoutComponents = {
+                hsMetaFiles: [],
+                components: undefined,
+            };
+            // This test verifies the null check fix works
+            // Currently this will fail because the fix checks for projectMetadata.components
+            await expect(async () => calculateComponentTemplateChoices(componentWithCliSelector, 'oauth', 'private', 123, 
+            // @ts-expect-error breaking stuff on purpose
+            projectMetadataWithoutComponents)).rejects.toThrow();
+        });
     });
 });

package/lib/projects/create/index.js

@@ -1,7 +1,7 @@
 import { selectProjectTemplatePrompt, } from '../../prompts/selectProjectTemplatePrompt.js';
 import { projectNameAndDestPrompt } from '../../prompts/projectNameAndDestPrompt.js';
 import { DEFAULT_PROJECT_TEMPLATE_BRANCH, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, EMPTY_PROJECT, } from '../../constants.js';
-import { useV3Api } from '../buildAndDeploy.js';
+import { useV3Api } from '../platformVersion.js';
 import { v3ComponentFlow } from './v3.js';
 import { getProjectTemplateListFromRepo } from './legacy.js';
 import { uiLogger } from '../../ui/logger.js';
@@ -12,7 +12,7 @@ export async function handleProjectCreationFlow(args) {
     const repo = templateSource || HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
     const projectNameAndDestPromptResponse = await projectNameAndDestPrompt(args);
     if (useV3Api(platformVersion)) {
-        const { componentTemplateChoices, authType, distribution, repoConfig, projectContents, } = await v3ComponentFlow(platformVersion, projectBase, providedAuth, providedDistribution);
+        const { componentTemplateChoices, authType, distribution, repoConfig, projectContents, } = await v3ComponentFlow(platformVersion, projectBase, providedAuth, providedDistribution, args.derivedAccountId);
         const selectProjectTemplatePromptResponse = await selectProjectTemplatePrompt(args, undefined, projectContents !== EMPTY_PROJECT ? componentTemplateChoices : undefined);
         return {
             authType,

package/lib/projects/create/legacy.js

@@ -3,7 +3,7 @@ import { DEFAULT_PROJECT_TEMPLATE_BRANCH, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH
 import { EXIT_CODES } from '../../enums/exitCodes.js';
 import { debugError } from '../../errorHandlers/index.js';
 import { uiLogger } from '../../ui/logger.js';
-import { useV3Api } from '../buildAndDeploy.js';
+import { useV3Api } from '../platformVersion.js';
 import { lib } from '../../../lang/en.js';
 const PROJECT_TEMPLATE_PROPERTIES = ['name', 'label', 'path'];
 export const EMPTY_PROJECT_TEMPLATE_NAME = 'no-template';

package/lib/projects/create/v3.d.ts

@@ -6,7 +6,7 @@ export declare function createV3App(providedAuth: string | undefined, providedDi
     authType: string;
     distribution: string;
 }>;
-export declare function calculateComponentTemplateChoices(components: ComponentTemplate[], authType: string | undefined, distribution: string | undefined, projectMetadata?: ProjectMetadata): (ComponentTemplateChoice | Separator)[];
+export declare function calculateComponentTemplateChoices(components: ComponentTemplate[], authType: string | undefined, distribution: string | undefined, accountId: number, projectMetadata?: ProjectMetadata): Promise<(ComponentTemplateChoice | Separator)[]>;
 type V3ComponentInfo = {
     authType?: string;
     distribution?: string;
@@ -14,7 +14,7 @@ type V3ComponentInfo = {
     projectContents?: string;
     componentTemplateChoices?: (ComponentTemplateChoice | Separator)[];
 };
-export declare function v3ComponentFlow(platformVersion: string, projectBase: string | undefined, providedAuth: string | undefined, providedDistribution: string | undefined): Promise<V3ComponentInfo>;
+export declare function v3ComponentFlow(platformVersion: string, projectBase: string | undefined, providedAuth: string | undefined, providedDistribution: string | undefined, accountId: number): Promise<V3ComponentInfo>;
 export declare function generateComponentPaths({ selectProjectTemplatePromptResponse, platformVersion, repoConfig, projectContents, authType, distribution, }: {
     selectProjectTemplatePromptResponse: SelectProjectTemplatePromptResponse;
     platformVersion: string;

package/lib/projects/create/v3.js

@@ -1,13 +1,15 @@
 import { Separator } from '@inquirer/prompts';
-import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, EMPTY_PROJECT, PROJECT_WITH_APP, } from '../../constants.js';
+import { marketplaceDistribution, oAuth, privateDistribution, staticAuth, EMPTY_PROJECT, PROJECT_WITH_APP, FEATURES, } from '../../constants.js';
 import { commands, lib } from '../../../lang/en.js';
 import { listPrompt } from '../../prompts/promptUtils.js';
 import chalk from 'chalk';
-import { useV3Api } from '../buildAndDeploy.js';
+import { useV3Api } from '../platformVersion.js';
 import path from 'path';
 import { getConfigForPlatformVersion } from './legacy.js';
 import { logError } from '../../errorHandlers/index.js';
 import { EXIT_CODES } from '../../enums/exitCodes.js';
+import { hasFeature } from '../../hasFeature.js';
+import { AppEventsKey, PagesKey, } from '@hubspot/project-parsing-lib/src/lib/constants.js';
 export async function createV3App(providedAuth, providedDistribution) {
     let authType;
     if (providedAuth &&
@@ -47,16 +49,26 @@ export async function createV3App(providedAuth, providedDistribution) {
         authType: authType,
     };
 }
-export function calculateComponentTemplateChoices(components, authType, distribution, projectMetadata) {
+const componentTypeToGateMap = {
+    [AppEventsKey]: FEATURES.APP_EVENTS,
+    [PagesKey]: FEATURES.APPS_HOME,
+};
+export async function calculateComponentTemplateChoices(components, authType, distribution, accountId, projectMetadata) {
     const enabledComponents = [];
     const disabledComponents = [];
-    components.forEach(template => {
+    for (const template of components) {
         const { supportedAuthTypes, supportedDistributions } = template;
         const disabledReasons = [];
         if (projectMetadata) {
-            const { count, maxCount } = projectMetadata.components[template.type];
-            if (count >= maxCount) {
-                disabledReasons.push(commands.project.add.error.maxExceeded(maxCount));
+            const componentMetadata = projectMetadata.components[template.type];
+            if (!componentMetadata) {
+                disabledReasons.push(commands.project.add.error.invalidComponentType(template.type));
+            }
+            else {
+                const { count, maxCount } = componentMetadata;
+                if (count >= maxCount) {
+                    disabledReasons.push(commands.project.add.error.maxExceeded(maxCount));
+                }
             }
         }
         if (Array.isArray(supportedAuthTypes) &&
@@ -69,9 +81,15 @@ export function calculateComponentTemplateChoices(components, authType, distribu
             !supportedDistributions.includes(distribution)) {
             disabledReasons.push(commands.project.add.error.distributionNotAllowed(distribution));
         }
+        if (componentTypeToGateMap[template.type]) {
+            const isUngated = await hasFeature(accountId, componentTypeToGateMap[template.type]);
+            if (!isUngated) {
+                disabledReasons.push(commands.project.add.error.portalDoesNotHaveAccessToThisFeature(accountId));
+            }
+        }
         if (disabledReasons.length > 0) {
             disabledComponents.push({
-                name: `[${chalk.yellow('DISABLED')}] ${template.label}`,
+                name: `[${chalk.yellow('DISABLED')}] ${template.label} -`,
                 value: template,
                 disabled: disabledReasons.join(' '),
             });
@@ -82,12 +100,17 @@ export function calculateComponentTemplateChoices(components, authType, distribu
                 value: template,
             });
         }
-    });
+    }
     return disabledComponents.length
-        ? [...enabledComponents, new Separator(), ...disabledComponents]
+        ? [
+            ...enabledComponents,
+            new Separator(),
+            ...disabledComponents,
+            new Separator(),
+        ]
         : [...enabledComponents];
 }
-export async function v3ComponentFlow(platformVersion, projectBase, providedAuth, providedDistribution) {
+export async function v3ComponentFlow(platformVersion, projectBase, providedAuth, providedDistribution, accountId) {
     let repoConfig = undefined;
     let authType;
     let distribution;
@@ -113,7 +136,7 @@ export async function v3ComponentFlow(platformVersion, projectBase, providedAuth
         authType = selectedAuthType;
         distribution = selectedDistribution;
     }
-    const componentTemplateChoices = calculateComponentTemplateChoices(repoConfig?.components || [], authType, distribution);
+    const componentTemplateChoices = await calculateComponentTemplateChoices(repoConfig?.components || [], authType, distribution, accountId);
     return {
         componentTemplateChoices,
         authType,

package/lib/projects/deploy.d.ts

@@ -0,0 +1,13 @@
+import { Deploy } from '@hubspot/local-dev-lib/types/Deploy';
+export declare function validateBuildIdForDeploy(buildId: number, deployedBuildId: number | undefined, latestBuildId: number, projectName: string | undefined, accountId: number): boolean | string;
+export declare function logDeployErrors(errorData: {
+    message: string;
+    errors: Array<{
+        message: string;
+        subCategory: string;
+        context: {
+            COMPONENT_NAME: string;
+        };
+    }>;
+}): void;
+export declare function handleProjectDeploy(targetAccountId: number, projectName: string, buildId: number, useV3Api: boolean, force: boolean): Promise<Deploy | undefined>;

package/lib/projects/deploy.js

@@ -0,0 +1,63 @@
+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 { pollDeployStatus } from './pollProjectBuildAndDeploy.js';
+export function validateBuildIdForDeploy(buildId, deployedBuildId, latestBuildId, projectName, accountId) {
+    if (Number(buildId) > latestBuildId) {
+        return commands.project.deploy.errors.buildIdDoesNotExist(accountId, buildId, projectName);
+    }
+    if (Number(buildId) === deployedBuildId) {
+        return commands.project.deploy.errors.buildAlreadyDeployed(accountId, buildId, projectName);
+    }
+    return true;
+}
+export function logDeployErrors(errorData) {
+    uiLogger.error(errorData.message);
+    errorData.errors.forEach(err => {
+        // This is how the pre-deploy check manifests itself in < 2025.2 projects
+        if (err.subCategory === PROJECT_ERROR_TYPES.DEPLOY_CONTAINS_REMOVALS) {
+            uiLogger.log(commands.project.deploy.errors.deployContainsRemovals(err.context.COMPONENT_NAME));
+        }
+        else {
+            uiLogger.log(err.message);
+        }
+    });
+}
+function handleBlockedDeploy(deployResp) {
+    const deployCanBeForced = deployResp.issues.every(issue => issue.blockingMessages.every(message => message.isWarning));
+    uiLogger.log('');
+    if (deployCanBeForced) {
+        uiLogger.warn(commands.project.deploy.errors.deployWarningsHeader);
+        uiLogger.log('');
+    }
+    else {
+        uiLogger.error(commands.project.deploy.errors.deployBlockedHeader);
+        uiLogger.log('');
+    }
+    deployResp.issues.forEach(issue => {
+        if (issue.blockingMessages.length > 0) {
+            issue.blockingMessages.forEach(message => {
+                uiLogger.log(commands.project.deploy.errors.deployIssueComponentWarning(issue.uid, issue.componentTypeName, message.message));
+            });
+        }
+        else {
+            uiLogger.log(commands.project.deploy.errors.deployIssueComponentGeneric(issue.uid, issue.componentTypeName));
+        }
+        uiLogger.log('');
+    });
+}
+export async function handleProjectDeploy(targetAccountId, projectName, buildId, useV3Api, force) {
+    const { data: deployResp } = await deployProject(targetAccountId, projectName, buildId, useV3Api, force);
+    if (!deployResp || deployResp.buildResultType !== 'DEPLOY_QUEUED') {
+        if (deployResp?.buildResultType === 'DEPLOY_BLOCKED') {
+            handleBlockedDeploy(deployResp);
+        }
+        else {
+            uiLogger.error(commands.project.deploy.errors.deploy);
+        }
+        return;
+    }
+    const deployResult = await pollDeployStatus(targetAccountId, projectName, Number(deployResp.id), buildId);
+    return deployResult;
+}

package/lib/projects/localDev/AppDevModeInterface.d.ts

@@ -15,11 +15,9 @@ declare class AppDevModeInterface {
     private get appNode();
     private get appData();
     private set appData(value);
-    private isAutomaticallyInstallable;
     private getAppInstallUrl;
     private fetchAppData;
     private checkMarketplaceAppInstalls;
-    private autoInstallStaticAuthApp;
     private installAppOrOpenInstallUrl;
     private checkTestAccountAppInstallation;
     private onDevServerMessage;