@hubspot/cli 7.7.32-experimental.0 → 7.7.34-experimental.0

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;

package/lib/projects/localDev/AppDevModeInterface.js

@@ -1,19 +1,21 @@
 import { fetchAppInstallationData } from '@hubspot/local-dev-lib/api/localDevAuth';
-import { fetchPublicAppsForPortal, fetchPublicAppProductionInstallCounts, installStaticAuthAppOnTestAccount, } from '@hubspot/local-dev-lib/api/appsDev';
+import { fetchPublicAppsForPortal, fetchPublicAppProductionInstallCounts,
+// installStaticAuthAppOnTestAccount,
+ } from '@hubspot/local-dev-lib/api/appsDev';
 import { DevModeUnifiedInterface as UIEDevModeInterface } from '@hubspot/ui-extensions-dev-server';
 import { requestPorts } from '@hubspot/local-dev-lib/portManager';
-import { getAccountConfig } 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';
 import { uiLine } from '../../ui/index.js';
 import { logError } from '../../errorHandlers/index.js';
-import { installAppAutoPrompt, installAppBrowserPrompt, } from '../../prompts/installAppPrompt.js';
+import { 
+// installAppAutoPrompt,
+installAppBrowserPrompt, } from '../../prompts/installAppPrompt.js';
 import { confirmPrompt } from '../../prompts/promptUtils.js';
 import { lib } from '../../../lang/en.js';
 import { uiLogger } from '../../ui/logger.js';
 import { getOauthAppInstallUrl, getStaticAuthAppInstallUrl, } from '../../app/urls.js';
-import { isDeveloperTestAccount, isSandbox } from '../../accountTypes.js';
 import SpinniesManager from '../../ui/SpinniesManager.js';
 class AppDevModeInterface {
     localDevState;
@@ -52,19 +54,26 @@ class AppDevModeInterface {
         }
         this.localDevState.setAppDataForUid(this.appNode.uid, appData);
     }
-    isAutomaticallyInstallable() {
-        const targetTestingAccount = getAccountConfig(this.localDevState.targetTestingAccountId);
-        if (!targetTestingAccount) {
-            return false;
-        }
-        const isTestAccount = isDeveloperTestAccount(targetTestingAccount) ||
-            isSandbox(targetTestingAccount);
-        const hasCorrectParent = targetTestingAccount.parentAccountId ===
-            this.localDevState.targetProjectAccountId;
-        return (isTestAccount &&
-            hasCorrectParent &&
-            this.appNode?.config.auth.type === APP_AUTH_TYPES.STATIC);
-    }
+    // @TODO: Restore test account auto install functionality
+    // private isAutomaticallyInstallable(): boolean {
+    //   const targetTestingAccount = getAccountConfig(
+    //     this.localDevState.targetTestingAccountId
+    //   );
+    //   if (!targetTestingAccount) {
+    //     return false;
+    //   }
+    //   const isTestAccount =
+    //     isDeveloperTestAccount(targetTestingAccount) ||
+    //     isSandbox(targetTestingAccount);
+    //   const hasCorrectParent =
+    //     targetTestingAccount.parentAccountId ===
+    //     this.localDevState.targetProjectAccountId;
+    //   return (
+    //     isTestAccount &&
+    //     hasCorrectParent &&
+    //     this.appNode?.config.auth.type === APP_AUTH_TYPES.STATIC
+    //   );
+    // }
     async getAppInstallUrl() {
         if (this.appNode?.config.auth.type === APP_AUTH_TYPES.OAUTH) {
             return getOauthAppInstallUrl({
@@ -134,27 +143,47 @@ class AppDevModeInterface {
         }
         this.localDevState.addUploadWarning(lib.AppDevModeInterface.defaultMarketplaceAppWarning(this.marketplaceAppInstalls));
     }
-    async autoInstallStaticAuthApp() {
-        const shouldInstall = await installAppAutoPrompt();
-        if (!shouldInstall) {
-            uiLogger.log(lib.AppDevModeInterface.autoInstallDeclined);
-            process.exit(EXIT_CODES.SUCCESS);
-        }
-        await installStaticAuthAppOnTestAccount(this.appData.id, this.localDevState.targetTestingAccountId, this.appData.scopeGroupIds);
-    }
+    // @TODO: Restore test account auto install functionality
+    // private async autoInstallStaticAuthApp(): Promise<void> {
+    //   const shouldInstall = await installAppAutoPrompt();
+    //   if (!shouldInstall) {
+    //     uiLogger.log(lib.AppDevModeInterface.autoInstallDeclined);
+    //     process.exit(EXIT_CODES.SUCCESS);
+    //   }
+    //   await installStaticAuthAppOnTestAccount(
+    //     this.appData!.id,
+    //     this.localDevState.targetTestingAccountId,
+    //     this.appData!.scopeGroupIds
+    //   );
+    // }
     async installAppOrOpenInstallUrl(isReinstall) {
-        if (this.isAutomaticallyInstallable()) {
-            try {
-                await this.autoInstallStaticAuthApp();
-                uiLogger.success(lib.AppDevModeInterface.autoInstallSuccess(this.appData.name, this.localDevState.targetTestingAccountId));
-                return;
-            }
-            catch (e) {
-                uiLogger.error(lib.AppDevModeInterface.autoInstallError(this.appData.name, this.localDevState.targetTestingAccountId));
-            }
-        }
+        // @TODO: Restore test account auto install functionality
+        // if (this.isAutomaticallyInstallable()) {
+        //   try {
+        //     await this.autoInstallStaticAuthApp();
+        //     uiLogger.success(
+        //       lib.AppDevModeInterface.autoInstallSuccess(
+        //         this.appData!.name,
+        //         this.localDevState.targetTestingAccountId
+        //       )
+        //     );
+        //     return;
+        //   } catch (e) {
+        //     uiLogger.error(
+        //       lib.AppDevModeInterface.autoInstallError(
+        //         this.appData!.name,
+        //         this.localDevState.targetTestingAccountId
+        //       )
+        //     );
+        //   }
+        // }
         const installUrl = await this.getAppInstallUrl();
-        await installAppBrowserPrompt(installUrl, isReinstall);
+        await installAppBrowserPrompt(installUrl, isReinstall, {
+            testingAccountId: this.localDevState.targetTestingAccountId,
+            projectAccountId: this.localDevState.targetProjectAccountId,
+            projectName: this.localDevState.projectConfig.name,
+            appUid: this.appNode.uid,
+        });
     }
     async checkTestAccountAppInstallation() {
         if (!this.appNode || !this.appData) {

package/lib/projects/localDev/DevServerManagerV2.js

@@ -34,6 +34,7 @@ class DevServerManagerV2 {
                 // @TODO: In the future, update UIE Dev Server to use LocalDevState
                 await serverInterface.setup({
                     components: this.localDevState.projectNodes,
+                    profileData: this.localDevState.projectProfileData,
                     logger,
                     urls: {
                         api: getHubSpotApiOrigin(env),

package/lib/projects/localDev/LocalDevProcess.js

@@ -8,7 +8,7 @@ import DevServerManagerV2 from './DevServerManagerV2.js';
 import { EXIT_CODES } from '../../enums/exitCodes.js';
 import { getProjectConfig } from '../config.js';
 import { handleProjectUpload } from '../upload.js';
-import { pollProjectBuildAndDeploy } from '../buildAndDeploy.js';
+import { pollProjectBuildAndDeploy } from '../pollProjectBuildAndDeploy.js';
 import { getLocalDevUiUrl } from '../urls.js';
 import { CONFIG_LOCAL_STATE_FLAGS } from '../../constants.js';
 import { isAutoOpenBrowserEnabled } from '../../configOptions.js';
@@ -101,11 +101,13 @@ class LocalDevProcess {
         const intermediateRepresentation = await this.getIntermediateRepresentation(this.state.projectNodesAtLastUpload);
         this.state.projectNodes =
             intermediateRepresentation.intermediateNodesIndexedByUid;
+        this.state.projectProfileData = intermediateRepresentation.profileData;
     }
     async updateProjectNodesAfterUpload() {
         const intermediateRepresentation = await this.getIntermediateRepresentation();
         this.state.projectNodes =
             intermediateRepresentation.intermediateNodesIndexedByUid;
+        this.state.projectProfileData = intermediateRepresentation.profileData;
         this.state.projectNodesAtLastUpload =
             intermediateRepresentation.intermediateNodesIndexedByUid;
     }

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

@@ -1,4 +1,4 @@
-import { IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types.js';
+import { IntermediateRepresentationNodeLocalDev, HSProfileVariables } from '@hubspot/project-parsing-lib/src/lib/types.js';
 import { Environment } from '@hubspot/local-dev-lib/types/Config';
 import { ProjectConfig } from '../../../types/Projects.js';
 import { LocalDevStateConstructorOptions, LocalDevStateListener, AppLocalDevData, LocalDevServerMessage } from '../../../types/LocalDev.js';
@@ -12,13 +12,14 @@ declare class LocalDevState {
     private _projectName;
     private _debug;
     private _projectNodes;
+    private _projectProfileData;
     private _projectNodesAtLastUpload;
     private _env;
     private _listeners;
     private _appData;
     private _devServerMessage;
     private _uploadWarnings;
-    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectId, projectName, debug, initialProjectNodes, profile, env, }: LocalDevStateConstructorOptions);
+    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectId, projectName, debug, initialProjectNodes, initialProjectProfileData, profile, env, }: LocalDevStateConstructorOptions);
     private runListeners;
     get targetProjectAccountId(): number;
     get targetTestingAccountId(): number;
@@ -34,6 +35,8 @@ declare class LocalDevState {
     set projectNodes(nodes: {
         [key: string]: IntermediateRepresentationNodeLocalDev;
     });
+    get projectProfileData(): HSProfileVariables;
+    set projectProfileData(profileData: HSProfileVariables);
     get projectNodesAtLastUpload(): {
         [key: string]: IntermediateRepresentationNodeLocalDev;
     };

package/lib/projects/localDev/LocalDevState.js

@@ -9,13 +9,14 @@ class LocalDevState {
     _projectName;
     _debug;
     _projectNodes;
+    _projectProfileData;
     _projectNodesAtLastUpload;
     _env;
     _listeners;
     _appData;
     _devServerMessage;
     _uploadWarnings;
-    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectId, projectName, debug, initialProjectNodes, profile, env, }) {
+    constructor({ targetProjectAccountId, targetTestingAccountId, projectConfig, projectDir, projectId, projectName, debug, initialProjectNodes, initialProjectProfileData, profile, env, }) {
         this._targetProjectAccountId = targetProjectAccountId;
         this._targetTestingAccountId = targetTestingAccountId;
         this._profile = profile;
@@ -26,6 +27,7 @@ class LocalDevState {
         this._debug = debug || false;
         this._projectNodes = initialProjectNodes;
         this._projectNodesAtLastUpload = initialProjectNodes;
+        this._projectProfileData = initialProjectProfileData;
         this._env = env;
         this._appData = {};
         this._devServerMessage = LOCAL_DEV_SERVER_MESSAGE_TYPES.INITIAL;
@@ -68,6 +70,12 @@ class LocalDevState {
         this._projectNodes = nodes;
         this.runListeners('projectNodes');
     }
+    get projectProfileData() {
+        return structuredClone(this._projectProfileData);
+    }
+    set projectProfileData(profileData) {
+        this._projectProfileData = profileData;
+    }
     get projectNodesAtLastUpload() {
         return structuredClone(this._projectNodesAtLastUpload);
     }

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

@@ -6,7 +6,7 @@ export declare function createNewProjectForLocalDev(projectConfig: ProjectConfig
 export declare function createInitialBuildForNewProject(projectConfig: ProjectConfig, projectDir: string, targetAccountId: number, sendIR?: boolean, profile?: string): Promise<Build>;
 export declare function compareLocalProjectToDeployed(projectConfig: ProjectConfig, accountId: number, deployedBuildId: number | undefined, localProjectNodes: {
     [key: string]: IntermediateRepresentationNodeLocalDev;
-}): Promise<void>;
+}, profile?: string): Promise<void>;
 export declare function isDeployedProjectUpToDateWithLocal(projectConfig: ProjectConfig, accountId: number, deployedBuildId: number, localProjectNodes: {
     [key: string]: IntermediateRepresentationNodeLocalDev;
-}): Promise<boolean>;
+}, profile?: string): Promise<boolean>;

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

@@ -17,7 +17,7 @@ import { uiAccountDescription } from '../../../ui/index.js';
 import SpinniesManager from '../../../ui/SpinniesManager.js';
 import { EXIT_CODES } from '../../../enums/exitCodes.js';
 import { handleProjectUpload } from '../../upload.js';
-import { pollProjectBuildAndDeploy } from '../../buildAndDeploy.js';
+import { pollProjectBuildAndDeploy } from '../../pollProjectBuildAndDeploy.js';
 import { logError } from '../../../errorHandlers/index.js';
 import { ApiErrorContext } from '../../../errorHandlers/index.js';
 // Prompt the user to create a new project if one doesn't exist on their target account
@@ -123,7 +123,7 @@ export async function createInitialBuildForNewProject(projectConfig, projectDir,
     }
     return initialUploadResult.buildResult;
 }
-export async function compareLocalProjectToDeployed(projectConfig, accountId, deployedBuildId, localProjectNodes) {
+export async function compareLocalProjectToDeployed(projectConfig, accountId, deployedBuildId, localProjectNodes, profile) {
     uiLogger.log('');
     if (!deployedBuildId) {
         uiLogger.error(lib.localDevHelpers.project.compareLocalProjectToDeployed.noDeployedBuild(projectConfig.name, uiAccountDescription(accountId)));
@@ -132,7 +132,7 @@ export async function compareLocalProjectToDeployed(projectConfig, accountId, de
     SpinniesManager.add('compareLocalProjectToDeployed', {
         text: lib.localDevHelpers.project.compareLocalProjectToDeployed.checking,
     });
-    const isUpToDate = await isDeployedProjectUpToDateWithLocal(projectConfig, accountId, deployedBuildId, localProjectNodes);
+    const isUpToDate = await isDeployedProjectUpToDateWithLocal(projectConfig, accountId, deployedBuildId, localProjectNodes, profile);
     if (isUpToDate) {
         SpinniesManager.succeed('compareLocalProjectToDeployed', {
             text: lib.localDevHelpers.project.compareLocalProjectToDeployed.upToDate,
@@ -144,12 +144,11 @@ export async function compareLocalProjectToDeployed(projectConfig, accountId, de
                 .notUpToDate,
         });
         uiLogger.log('');
-        uiLogger.log(lib.localDevHelpers.project.compareLocalProjectToDeployed
-            .notUpToDateExplanation);
+        uiLogger.log(lib.localDevHelpers.project.compareLocalProjectToDeployed.notUpToDateExplanation(profile));
         process.exit(EXIT_CODES.SUCCESS);
     }
 }
-export async function isDeployedProjectUpToDateWithLocal(projectConfig, accountId, deployedBuildId, localProjectNodes) {
+export async function isDeployedProjectUpToDateWithLocal(projectConfig, accountId, deployedBuildId, localProjectNodes, profile) {
     let tempDir = null;
     try {
         tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'hubspot-project-compare-'));
@@ -161,7 +160,7 @@ export async function isDeployedProjectUpToDateWithLocal(projectConfig, accountI
             projectSourceDir: deployedProjectSourceDir,
             platformVersion: projectConfig.platformVersion,
             accountId: accountId,
-        }, {});
+        }, { profile });
         return isDeepEqual(localProjectNodes, deployedProjectNodes, ['localDev']);
     }
     finally {

package/lib/projects/platformVersion.d.ts

@@ -0,0 +1 @@
+export declare function useV3Api(platformVersion?: string | null): boolean;

package/lib/projects/platformVersion.js

@@ -0,0 +1,10 @@
+export function useV3Api(platformVersion) {
+    if (!platformVersion || typeof platformVersion !== 'string') {
+        return false;
+    }
+    if (platformVersion.toLowerCase() === 'unstable') {
+        return true;
+    }
+    const [year, minor] = platformVersion.split('.');
+    return Number(year) >= 2025 && Number(minor) >= 2;
+}

package/lib/projects/{buildAndDeploy.d.ts → pollProjectBuildAndDeploy.d.ts}

@@ -2,7 +2,6 @@ import { FileResult } from 'tmp';
 import { Build } from '@hubspot/local-dev-lib/types/Build';
 import { Deploy } from '@hubspot/local-dev-lib/types/Deploy';
 import { ProjectConfig, ProjectTask, ProjectPollResult } from '../../types/Projects.js';
-export declare function useV3Api(platformVersion?: string | null): boolean;
 type PollTaskStatusFunction<T extends ProjectTask> = (accountId: number, taskName: string, taskId: number, deployedBuildId: number | null, silenceLogs?: boolean) => Promise<T>;
 export declare const pollBuildStatus: PollTaskStatusFunction<Build>;
 export declare const pollDeployStatus: PollTaskStatusFunction<Deploy>;

package/lib/projects/{buildAndDeploy.js → pollProjectBuildAndDeploy.js}

@@ -13,16 +13,6 @@ import { mapToInternalType } from '@hubspot/project-parsing-lib';
 const SPINNER_STATUS = {
     SPINNING: 'spinning',
 };
-export function useV3Api(platformVersion) {
-    if (!platformVersion || typeof platformVersion !== 'string') {
-        return false;
-    }
-    if (platformVersion.toLowerCase() === 'unstable') {
-        return true;
-    }
-    const [year, minor] = platformVersion.split('.');
-    return Number(year) >= 2025 && Number(minor) >= 2;
-}
 function getSubtasks(task) {
     if ('subbuildStatuses' in task) {
         return task.subbuildStatuses;

package/lib/projects/structure.d.ts

@@ -1,5 +1,5 @@
 import { ComponentTypes, Component, GenericComponentConfig, PublicAppComponentConfig, PrivateAppComponentConfig, AppCardComponentConfig } from '../../types/Projects.js';
-import { IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types.js';
+import { IntermediateRepresentationNode, IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/src/lib/types.js';
 import { AppIRNode } from '../../types/ProjectComponents.js';
 export declare const CONFIG_FILES: {
     [k in ComponentTypes]: string;
@@ -15,4 +15,4 @@ export declare function getProjectComponentTypes(components: Array<Component>):
 export declare function getComponentUid(component?: Component | null): string | null;
 export declare function componentIsApp(component?: Component | null): component is Component<PublicAppComponentConfig | PrivateAppComponentConfig>;
 export declare function componentIsPublicApp(component?: Component | null): component is Component<PublicAppComponentConfig>;
-export declare function isAppIRNode(component: IntermediateRepresentationNodeLocalDev): component is AppIRNode;
+export declare function isAppIRNode(component: IntermediateRepresentationNodeLocalDev | IntermediateRepresentationNode): component is AppIRNode;

package/lib/projects/upload.d.ts

@@ -1,4 +1,5 @@
 import { FileResult } from 'tmp';
+import { IntermediateRepresentation } from '@hubspot/project-parsing-lib';
 import { ProjectConfig } from '../../types/Projects.js';
 type ProjectUploadCallbackFunction<T> = (accountId: number, projectConfig: ProjectConfig, tempFile: FileResult, buildId: number) => Promise<T>;
 type ProjectUploadResult<T> = {
@@ -20,5 +21,5 @@ type HandleProjectUploadArg<T> = {
 export declare function handleProjectUpload<T>({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage, forceCreate, isUploadCommand, sendIR, skipValidation, }: HandleProjectUploadArg<T>): Promise<ProjectUploadResult<T>>;
 export declare function validateSourceDirectory(srcDir: string, projectConfig: ProjectConfig): void;
 export declare function validateNoHSMetaMismatch(srcDir: string, projectConfig: ProjectConfig): Promise<void>;
-export declare function handleTranslate(projectDir: string, projectConfig: ProjectConfig, accountId: number, skipValidation: boolean, profile: string | undefined): Promise<unknown>;
+export declare function handleTranslate(projectDir: string, projectConfig: ProjectConfig, accountId: number, skipValidation: boolean, profile: string | undefined): Promise<IntermediateRepresentation | undefined>;
 export {};

package/lib/projects/upload.js

@@ -12,7 +12,7 @@ import util from 'node:util';
 import { lib } from '../../lang/en.js';
 import { ensureProjectExists } from './ensureProjectExists.js';
 import { uiLogger } from '../ui/logger.js';
-import { useV3Api } from './buildAndDeploy.js';
+import { useV3Api } from './platformVersion.js';
 import { EXIT_CODES } from '../enums/exitCodes.js';
 import ProjectValidationError from '../errors/ProjectValidationError.js';
 async function uploadProjectFiles(accountId, projectName, filePath, uploadMessage, platformVersion, intermediateRepresentation) {
@@ -133,4 +133,5 @@ export async function handleTranslate(projectDir, projectConfig, accountId, skip
         }
         throw e;
     }
+    return undefined;
 }

package/lib/projects/urls.d.ts

@@ -7,3 +7,4 @@ export declare function getProjectBuildDetailUrl(projectName: string, buildId: n
 export declare function getProjectDeployDetailUrl(projectName: string, deployId: number, accountId: number): string;
 export declare function getLocalDevUiUrl(accountId: number, showWelcomeScreen?: boolean): string;
 export declare function getAccountHomeUrl(accountId: number): string;
+export declare function getAppAllowlistUrl(accountId: number, projectName: string, appUid: string): string;

package/lib/projects/urls.js

@@ -41,3 +41,6 @@ export function getAccountHomeUrl(accountId) {
     const baseUrl = getHubSpotWebsiteOrigin(getEnv(accountId) === 'qa' ? ENVIRONMENTS.QA : ENVIRONMENTS.PROD);
     return `${baseUrl}/home?portalId=${accountId}`;
 }
+export function getAppAllowlistUrl(accountId, projectName, appUid) {
+    return `${getProjectHomeUrl(accountId)}/project/${projectName}/component/${appUid}/distribution?panel=static-token-allowlist`;
+}

package/lib/prompts/__tests__/projectAddPrompt.test.d.ts

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