@hubspot/cli 8.14.0 → 8.15.0-beta.0

package/commands/testAccount/create.js

@@ -4,7 +4,7 @@ import { getValidEnv } from '@hubspot/local-dev-lib/environment';
 import { getConfigAccountEnvironment } from '@hubspot/local-dev-lib/config';
 import { getCwd } from '@hubspot/local-dev-lib/path';
 import { makeWrappedYargsHandler } from '../../lib/yargs/makeWrappedYargsHandler.js';
-import { CreateTestAccountSchema, } from '../../lib/jsonOutput.js';
+import { CreateTestAccountSchema, } from '../../lib/jsonOutput/createTestAccount.js';
 import { makeYargsBuilder } from '../../lib/yargsUtils.js';
 import { promptUser, listPrompt } from '../../lib/prompts/promptUtils.js';
 import { EXIT_CODES } from '../../lib/enums/exitCodes.js';

package/lang/en.d.ts

@@ -1466,7 +1466,6 @@ export declare const commands: {
                     duplicateTargetAccount: (targetAccountId: number) => string;
                 };
                 errors: {
-                    noProjectConfig: string;
                     unsupportedPlatformVersion: string;
                     profileExists: (profileName: string) => string;
                     invalidTargetAccount: string;
@@ -1499,7 +1498,6 @@ export declare const commands: {
                     deleteProjectPrompt: (accountId: number) => string;
                 };
                 errors: {
-                    noProjectConfig: string;
                     unsupportedPlatformVersion: string;
                     noProfileFound: (profileName: string) => string;
                     noProfilesFound: string;
@@ -1523,7 +1521,6 @@ export declare const commands: {
                 testingAccountFlagExplanation: (accountId: number) => string;
             };
             errors: {
-                noProjectConfig: string;
                 noAccount: (accountId: number) => string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 noRunnableComponents: string;
@@ -1912,9 +1909,11 @@ export declare const commands: {
                 autoDeployDisabled: (deployCommand: string) => string;
                 autoDeploySkipped: (deployCommand: string) => string;
                 releaseManagementRequired: (releaseCommand: string) => string;
+                uploadingWithProfile: (profileName: string, accountId: number) => string;
+                uploadingToAccount: (accountId: number) => string;
+                uploadedToAccount: (accountId: number) => string;
             };
             errors: {
-                noProjectConfig: string;
                 projectLockedError: string;
                 previewRequiresTarget: string;
                 targetRequiresPreview: string;
@@ -1976,7 +1975,6 @@ export declare const commands: {
                 fileAlreadyQueued: (filePath: string) => string;
             };
             errors: {
-                projectConfigNotFound: string;
                 projectLockedError: string;
                 uploadFailed: (remotePath: string, filePath: string) => string;
                 deleteFileFailed: (remotePath: string) => string;
@@ -2043,7 +2041,6 @@ export declare const commands: {
             installationSuccessful: (directory: string) => string;
             addingDependenciesToLocation: (dependencies: string, directory: string) => string;
             installingDependenciesFailed: (directory: string) => string;
-            noProjectConfig: string;
             noPackageJsonInProject: (projectName: string) => string;
             packageManagerNotInstalled: (packageManager: string) => string;
         };
@@ -2061,7 +2058,6 @@ export declare const commands: {
                 addingLintScripts: string;
                 linting: string;
             };
-            noProjectConfig: string;
             failedToReadPackageJson: (packageJsonPath: string) => string;
             installLintPackagesPrompt: (directories: string[], missingPackages: string[]) => string;
             skippingDirectoriesWarning: (directories: string[]) => string;
@@ -2091,7 +2087,6 @@ export declare const commands: {
             updateSuccessful: (directory: string) => string;
             updatingDependenciesToLocation: (dependencies: string, directory: string) => string;
             updatingDependenciesFailed: (directory: string) => string;
-            noProjectConfig: string;
             noPackageJsonInProject: (projectName: string) => string;
             packageManagerNotInstalled: (packageManager: string) => string;
         };
@@ -2128,6 +2123,10 @@ export declare const commands: {
                 name: string;
                 platformVersion: string;
             };
+            examples: {
+                default: string;
+                json: string;
+            };
             errors: {
                 noProjectsFound: (accountId: number) => string;
             };
@@ -2161,7 +2160,6 @@ export declare const commands: {
                 uid: string;
             };
             errors: {
-                noProjectConfig: string;
                 projectNotFound: (projectName: string, accountId: number) => string;
                 noDeployedBuild: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
@@ -2223,7 +2221,6 @@ export declare const commands: {
                 profile: string;
             };
             errors: {
-                noProjectConfig: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 failedToParseProject: string;
                 noAppInProject: string;
@@ -2257,7 +2254,6 @@ export declare const commands: {
                 json: string;
             };
             errors: {
-                noProjectConfig: string;
                 unsupportedPlatformVersion: (platformVersion: string) => string;
                 failedToParseProject: string;
                 noAppInProject: string;
@@ -3548,7 +3544,6 @@ export declare const lib: {
         };
         loadProfile: {
             errors: {
-                noProjectConfig: string;
                 profileNotFound: (profileName: string) => string;
                 missingAccountId: (profileName: string) => string;
                 listedAccountNotFound: (accountId: number, profileName: string) => string;
@@ -3590,12 +3585,6 @@ export declare const lib: {
         };
         validateProjectConfig: {
             configNotFound: string;
-            configMissingFields: (missingFields: string[]) => string;
-            srcDirNotFound: (srcDir: string, projectDir: string) => string;
-            srcOutsideProjectDir: (projectConfig: string, srcDir: string) => string;
-        };
-        getProjectConfig: {
-            error: string;
         };
         platformVersion: {
             unsupported: (currentCliVersion: string, latestSupported: string, platformVersion?: string) => string;

package/lang/en.js

@@ -1482,7 +1482,6 @@ export const commands = {
                     duplicateTargetAccount: (targetAccountId) => `The account ${uiAccountDescription(targetAccountId)} is being used in an existing profile. Make sure to edit your project's name between uploads if you do not want to overwrite the existing project in this account.`,
                 },
                 errors: {
-                    noProjectConfig: 'No project config found. Please run this command from a project directory.',
                     unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
                     profileExists: (profileName) => `Profile ${chalk.bold(profileName)} already exists. Please choose a different name.`,
                     invalidTargetAccount: 'Target account is not configured in the CLI',
@@ -1515,7 +1514,6 @@ export const commands = {
                     deleteProjectPrompt: (accountId) => `Would you like to delete this project from ${uiAccountDescription(accountId)}?`,
                 },
                 errors: {
-                    noProjectConfig: 'No project config found. Please run this command from a project directory.',
                     unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
                     noProfileFound: (profileName) => `No profile with filename ${chalk.bold(profileName)} found in your project.`,
                     noProfilesFound: 'No profiles found in your project.',
@@ -1539,7 +1537,6 @@ export const commands = {
                 testingAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --testing-account flag for testing`,
             },
             errors: {
-                noProjectConfig: 'No project detected. Please run this command again from a project directory.',
                 noAccount: (accountId) => `An error occurred while reading account ${uiAccountDescription(accountId)} from your config. Run ${uiAuthCommandReference()} to re-auth this account.`,
                 unsupportedPlatformVersion: (platformVersion) => `Local development is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
                 noRunnableComponents: `No supported components were found in this project. Run ${uiCommandReference('hs project add')} to see a list of available components and add one to your project.`,
@@ -1928,9 +1925,11 @@ export const commands = {
                 autoDeployDisabled: (deployCommand) => `Automatic deploys are disabled for this project. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
                 autoDeploySkipped: (deployCommand) => `Auto-deploy was skipped for this build. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
                 releaseManagementRequired: (releaseCommand) => `Run ${uiCommandReference(releaseCommand)} to create a release for this build.`,
+                uploadingWithProfile: (profileName, accountId) => `Initializing project upload with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
+                uploadingToAccount: (accountId) => `Initializing project upload to account ${uiAccountDescription(accountId)}`,
+                uploadedToAccount: (accountId) => `Project uploaded to ${uiAccountDescription(accountId)}`,
             },
             errors: {
-                noProjectConfig: 'No project detected. Run this command from a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${uiCommandReference('hs project dev')} command for this project. If this is you, unlock the project in Projects UI.`,
                 previewRequiresTarget: `${uiCommandReference('--preview')} requires ${uiCommandReference('--target=<portalId>')} to specify the portal to preview on.`,
                 targetRequiresPreview: `${uiCommandReference('--target')} can only be used with ${uiCommandReference('--preview')}.`,
@@ -1992,7 +1991,6 @@ export const commands = {
                 fileAlreadyQueued: (filePath) => `File "${filePath}" is already queued for upload`,
             },
             errors: {
-                projectConfigNotFound: 'No project config found. Please ensure that you are in a project directory.',
                 projectLockedError: `Your project is locked. This may mean that another user is running the ${chalk.bold(`hs project dev`)} command for this project. If this is you, unlock the project in Projects UI.`,
                 uploadFailed: (remotePath, filePath) => `Failed to upload file "${filePath}" to "${remotePath}"`,
                 deleteFileFailed: (remotePath) => `Failed to delete file "${remotePath}"`,
@@ -2059,7 +2057,6 @@ export const commands = {
             installationSuccessful: (directory) => `Installed dependencies in ${directory}`,
             addingDependenciesToLocation: (dependencies, directory) => `Installing ${dependencies} in ${directory}`,
             installingDependenciesFailed: (directory) => `Installing dependencies for ${directory} failed`,
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             noPackageJsonInProject: (projectName) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
             packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
         },
@@ -2077,7 +2074,6 @@ export const commands = {
                 addingLintScripts: 'Adding lint scripts to package.json files…',
                 linting: 'Linting…',
             },
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             failedToReadPackageJson: (packageJsonPath) => `Failed to read package.json at ${packageJsonPath}`,
             installLintPackagesPrompt: (directories, missingPackages) => {
                 const uniquePackages = Array.from(new Set(missingPackages)).sort();
@@ -2119,7 +2115,6 @@ export const commands = {
             updateSuccessful: (directory) => `Updated dependencies in ${directory}`,
             updatingDependenciesToLocation: (dependencies, directory) => `Updating ${dependencies} in ${directory}`,
             updatingDependenciesFailed: (directory) => `Updating dependencies for ${directory} failed`,
-            noProjectConfig: 'No project detected. Run this command from a project directory.',
             noPackageJsonInProject: (projectName) => `No dependencies to update. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
             packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
         },
@@ -2156,6 +2151,10 @@ export const commands = {
                 name: 'Name',
                 platformVersion: 'Platform Version',
             },
+            examples: {
+                default: 'List projects in the target account',
+                json: 'Output as JSON for scripting',
+            },
             errors: {
                 noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
             },
@@ -2189,7 +2188,6 @@ export const commands = {
                 uid: 'UID',
             },
             errors: {
-                noProjectConfig: `No project found in this directory.\n\nRun ${uiCommandReference('hs project create')} to start a new project, or change to a directory containing hsproject.json.`,
                 projectNotFound: (projectName, accountId) => `Project "${projectName}" was not found in account ${uiAccountDescription(accountId)}. Make sure the project has been uploaded at least once.`,
                 noDeployedBuild: `This project has not been deployed yet.\n\nRun ${uiCommandReference('hs project deploy')} to deploy your project.`,
                 unsupportedPlatformVersion: (platformVersion) => `This command is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
@@ -2248,7 +2246,6 @@ export const commands = {
                 profile: 'The profile to target with this install',
             },
             errors: {
-                noProjectConfig: `No project config found. Run this command from within a HubSpot project directory, or use ${uiCommandReference('hs project create')} to create a new one.`,
                 unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
                 failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
                 noAppInProject: 'No app was found in the local project. This command requires a project that contains an app.',
@@ -2282,7 +2279,6 @@ export const commands = {
                 json: 'Output install status as JSON',
             },
             errors: {
-                noProjectConfig: `No project config found. Run this command from within a HubSpot project directory, or use ${uiCommandReference('hs project create')} to create a new one.`,
                 unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
                 failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
                 noAppInProject: 'No app was found in the local project. Install status is only available for projects that contain an app.',
@@ -3587,7 +3583,6 @@ export const lib = {
         },
         loadProfile: {
             errors: {
-                noProjectConfig: 'No project config found. Please run this command from a project directory.',
                 profileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} not found.`,
                 missingAccountId: (profileName) => `Profile ${chalk.bold(profileName)} is missing an account id.`,
                 listedAccountNotFound: (accountId, profileName) => `The account ${uiAccountDescription(accountId)} is defined in your profile ${chalk.bold(profileName)}, but is missing in your config file`,
@@ -3629,12 +3624,6 @@ export const lib = {
         },
         validateProjectConfig: {
             configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${uiCommandReference('hs project create')} to create a new project.`,
-            configMissingFields: (missingFields) => `The project configuration file is missing required field${missingFields.length > 1 ? 's' : ''}: ${missingFields.map(f => chalk.bold(f)).join(', ')}`,
-            srcDirNotFound: (srcDir, projectDir) => `Project source directory ${chalk.bold(srcDir)} could not be found in ${chalk.bold(projectDir)}.`,
-            srcOutsideProjectDir: (projectConfig, srcDir) => `Invalid value for 'srcDir' in ${projectConfig}: ${chalk.bold(`srcDir: "${srcDir}"`)}\n\t'srcDir' must be a relative path to a folder under the project root, such as "." or "./src"`,
-        },
-        getProjectConfig: {
-            error: 'Could not read from project config',
         },
         platformVersion: {
             unsupported: (currentCliVersion, latestSupported, platformVersion) => `Platform version${platformVersion ? ' ' + chalk.bold(platformVersion) : ''} is not officially supported by this version of the CLI (${chalk.bold(currentCliVersion)}).\n\nUpdate your CLI to the latest version with ${uiCommandReference('hs upgrade')} or use a compatible platform version (${chalk.bold(latestSupported)} or earlier).`,

package/lib/app/migrate.js

@@ -39,7 +39,7 @@ export function getUnmigratableReason(reasonCode, projectName, accountId) {
 export function generateFilterAppsByProjectNameFunction(projectConfig) {
     return (app) => {
         if (projectConfig) {
-            return app.projectName === projectConfig?.projectConfig?.name;
+            return app.projectName === projectConfig.projectConfig.name;
         }
         return true;
     };
@@ -70,7 +70,7 @@ export async function validateMigrationApps(appId, derivedAccountId, { migratabl
     if (allApps.length > 1 && projectConfig) {
         throw new Error(lib.migrate.errors.project.multipleApps);
     }
-    if (!projectConfig?.projectConfig) {
+    if (!projectConfig) {
         allApps.forEach(app => {
             if (app.projectName) {
                 app.isMigratable = false;
@@ -80,7 +80,7 @@ export async function validateMigrationApps(appId, derivedAccountId, { migratabl
         });
     }
     if (allApps.length === 0 && projectConfig) {
-        throw new Error(lib.migrate.errors.noAppsForProject(projectConfig?.projectConfig?.name || ''));
+        throw new Error(lib.migrate.errors.noAppsForProject(projectConfig.projectConfig.name));
     }
     if (allApps.length === 0 || !allApps.some(app => app.isMigratable)) {
         const reasons = unmigratableApps.map(app => `${chalk.bold(app.appName)}: ${getUnmigratableReason(app.unmigratableReason, app.projectName, derivedAccountId)}`);
@@ -173,9 +173,7 @@ export async function handleMigrationSetup(derivedAccountId, options, projectCon
         return {};
     }
     // If it's a project we don't want to prompt for dest and name, so just return early
-    if (projectConfig &&
-        projectConfig?.projectConfig &&
-        projectConfig?.projectDir) {
+    if (projectConfig) {
         return {
             appIdToMigrate,
             projectName: projectConfig.projectConfig.name,
@@ -309,7 +307,7 @@ export async function downloadProjectFiles(derivedAccountId, projectName, buildI
         });
         const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, buildId);
         let absoluteDestPath;
-        if (projectConfig?.projectConfig && projectConfig?.projectDir) {
+        if (projectConfig) {
             const { projectDir } = projectConfig;
             absoluteDestPath = projectDir;
             const { srcDir } = projectConfig.projectConfig;

package/lib/dependencyManagement.js

@@ -182,21 +182,14 @@ async function updatePackagesInDirectory({ directory, packages, npmWorkspaceDire
     }
 }
 export async function getProjectPackageJsonLocations(dir, isUpdate = false) {
-    const projectConfig = await getProjectConfig(dir);
-    if (!projectConfig ||
-        !projectConfig.projectDir ||
-        !projectConfig.projectConfig) {
-        throw new Error(isUpdate
-            ? commands.project.updateDeps.noProjectConfig
-            : commands.project.installDeps.noProjectConfig);
-    }
-    const { projectDir, projectConfig: { srcDir, name }, } = projectConfig;
+    const { projectConfig, projectDir } = getProjectConfig(dir);
+    const { srcDir, name } = projectConfig;
     if (!(await isGloballyInstalled(DEFAULT_PACKAGE_MANAGER))) {
         throw new Error(isUpdate
             ? commands.project.updateDeps.packageManagerNotInstalled(DEFAULT_PACKAGE_MANAGER)
             : commands.project.installDeps.packageManagerNotInstalled(DEFAULT_PACKAGE_MANAGER));
     }
-    if (!fs.existsSync(projectConfig.projectDir) ||
+    if (!fs.existsSync(projectDir) ||
         !fs.existsSync(path.join(projectDir, srcDir))) {
         throw new NoPackageJsonFilesError(name, isUpdate);
     }

package/lib/doctor/DiagnosticInfoBuilder.d.ts

@@ -1,9 +1,9 @@
-import { getProjectConfig } from '../projects/config.js';
 import { Environment } from '@hubspot/local-dev-lib/types/Accounts';
 import { AccessToken, AccountType, AuthType } from '@hubspot/local-dev-lib/types/Accounts';
 import { Project } from '@hubspot/local-dev-lib/types/Project';
 import process from 'process';
-export type ProjectConfig = Awaited<ReturnType<typeof getProjectConfig>>;
+import type { LoadedProjectConfig } from '../projects/config.js';
+export type ProjectConfig = LoadedProjectConfig | undefined;
 declare const hubspotCli = "@hubspot/cli";
 interface FilesInfo {
     files: string[];

package/lib/doctor/DiagnosticInfoBuilder.js

@@ -50,12 +50,15 @@ export class DiagnosticInfoBuilder {
         this.processInfo = processInfo;
     }
     async generateDiagnosticInfo() {
-        this._projectConfig = await getProjectConfig();
-        if (this._projectConfig?.projectConfig) {
+        try {
+            this._projectConfig = getProjectConfig();
+        }
+        catch {
+            this._projectConfig = undefined;
+        }
+        if (this._projectConfig) {
             await this.fetchProjectDetails();
             await this.fetchAccessToken();
-        }
-        if (this._projectConfig?.projectDir) {
             await this.fetchProjectFilenames();
         }
         const { platform, arch, versions: { node }, mainModule, } = this.processInfo;
@@ -89,9 +92,7 @@ export class DiagnosticInfoBuilder {
     }
     async fetchProjectDetails() {
         try {
-            const { data } = await fetchProject(this.accountId, 
-            // We check that config exists before running this function
-            this._projectConfig.projectConfig.name);
+            const { data } = await fetchProject(this.accountId, this._projectConfig.projectConfig.name);
             this.projectDetails = data;
         }
         catch (e) {
@@ -109,7 +110,6 @@ export class DiagnosticInfoBuilder {
     }
     async fetchProjectFilenames() {
         try {
-            // We check that projectDir exists before running this function
             this.files = (await walk(this._projectConfig.projectDir, ['node_modules'])).map(filename => path.relative(this._projectConfig.projectDir, filename));
         }
         catch (e) {

package/lib/doctor/Doctor.js

@@ -26,7 +26,7 @@ import { isServerRunningAtUrl } from '../http.js';
 import { detectConfiguredMcpClients } from '../mcp/promotion.js';
 import { MCP_CLIENTS } from '../mcp/clients.js';
 import { WEBHOOKS_KEY, APP_KEY } from '@hubspot/project-parsing-lib/constants';
-import { validateProjectConfig } from '../projects/config.js';
+import { validateProjectConfig } from '@hubspot/project-parsing-lib/projects';
 import { validateSourceDirectory, handleTranslate, } from '../projects/upload.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { validateProjectForProfile } from '../projects/projectProfiles.js';
@@ -57,7 +57,7 @@ export class Doctor {
             ...this.performCliChecks(),
             ...this.performCliConfigChecks(),
             ...this.performNetworkingChecks(),
-            ...(this.projectConfig?.projectConfig ? this.performProjectChecks() : []),
+            ...(this.projectConfig ? this.performProjectChecks() : []),
         ]);
         this.performDefaultAccountOverrideFileChecks();
         this.performCliConfigSettingsChecks();
@@ -283,7 +283,7 @@ export class Doctor {
         for (const packageFile of this.diagnosticInfo?.packageFiles || []) {
             const packageDirName = path.dirname(packageFile);
             try {
-                const needsInstall = await hasMissingPackages(path.join(this.projectConfig?.projectDir || '', packageDirName));
+                const needsInstall = await hasMissingPackages(path.join(this.projectConfig?.projectDir ?? '', packageDirName));
                 if (needsInstall) {
                     foundError = true;
                     this.diagnosis?.addProjectSection({
@@ -331,7 +331,7 @@ export class Doctor {
     async checkProjectConfigJsonFiles() {
         let foundError = false;
         for (const jsonFile of this.diagnosticInfo?.jsonFiles || []) {
-            const fileToCheck = path.join(this.projectConfig?.projectDir || '', jsonFile);
+            const fileToCheck = path.join(this.projectConfig?.projectDir ?? '', jsonFile);
             if (!(await this.isValidJsonFile(fileToCheck))) {
                 foundError = true;
                 this.diagnosis?.addProjectSection({
@@ -432,7 +432,7 @@ export class Doctor {
             const hsMetaFiles = this.diagnosticInfo?.hsMetaFiles || [];
             for (const metaFiles of hsMetaFiles) {
                 try {
-                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir || '', metaFiles), 'utf8');
+                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir ?? '', metaFiles), 'utf8');
                     const contents = JSON.parse(content);
                     if (contents.type === WEBHOOKS_KEY &&
                         contents.config?.settings?.targetUrl) {
@@ -461,7 +461,7 @@ export class Doctor {
             const hsMetaFiles = this.diagnosticInfo?.hsMetaFiles || [];
             for (const metaFile of hsMetaFiles) {
                 try {
-                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir || '', metaFile), 'utf8');
+                    const content = await fs.promises.readFile(path.join(this.projectConfig?.projectDir ?? '', metaFile), 'utf8');
                     const contents = JSON.parse(content);
                     if (contents.type === APP_KEY &&
                         Array.isArray(contents.config?.auth?.redirectUrls)) {
@@ -550,9 +550,7 @@ export class Doctor {
         }
     }
     async checkProjectValidation() {
-        if (!this.projectConfig?.projectConfig ||
-            !this.projectConfig?.projectDir ||
-            !this.accountId) {
+        if (!this.projectConfig || !this.accountId) {
             return;
         }
         const { projectConfig, projectDir } = this.projectConfig;

package/lib/errors/ProjectErrors.d.ts

@@ -1,12 +1,6 @@
 export declare class ProjectNestingError extends Error {
     constructor(message: string);
 }
-export declare class ProjectConfigNotFoundError extends Error {
-    constructor(message: string);
-}
-export declare class ProjectValidationError extends Error {
-    constructor(message: string);
-}
 export declare class ProjectUploadError extends Error {
     constructor(message: string, cause?: unknown);
 }

package/lib/errors/ProjectErrors.js

@@ -4,18 +4,6 @@ export class ProjectNestingError extends Error {
         this.name = 'ProjectNestingError';
     }
 }
-export class ProjectConfigNotFoundError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ProjectConfigNotFoundError';
-    }
-}
-export class ProjectValidationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'ProjectValidationError';
-    }
-}
 export class ProjectUploadError extends Error {
     constructor(message, cause) {
         super(message, { cause });

package/lib/errors/ProjectValidationError.d.ts

@@ -1,4 +1,5 @@
+import { ProjectConfigValidationError } from '@hubspot/project-parsing-lib/projects';
 export default class ProjectValidationError extends Error {
     constructor(message: string, options?: ErrorOptions);
 }
-export declare function isProjectValidationError(err: unknown): err is ProjectValidationError;
+export declare function isProjectValidationError(err: unknown): err is ProjectValidationError | ProjectConfigValidationError;

package/lib/errors/ProjectValidationError.js

@@ -1,3 +1,4 @@
+import { ProjectConfigValidationError } from '@hubspot/project-parsing-lib/projects';
 export default class ProjectValidationError extends Error {
     constructor(message, options) {
         super(message, options);
@@ -5,5 +6,6 @@ export default class ProjectValidationError extends Error {
     }
 }
 export function isProjectValidationError(err) {
-    return err instanceof ProjectValidationError;
+    return (err instanceof ProjectValidationError ||
+        err instanceof ProjectConfigValidationError);
 }

package/lib/getStartedV2Actions.js

@@ -11,8 +11,8 @@ import { translate, } from '@hubspot/project-parsing-lib/translate';
 import { commands, lib } from '../lang/en.js';
 import { getStaticAuthAppInstallUrl } from '../lib/app/urls.js';
 import { HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, PROJECT_CONFIG_FILE, } from '../lib/constants.js';
-import { ProjectNestingError, ProjectConfigNotFoundError, ProjectValidationError, ProjectUploadError, ProjectBuildDeployError, } from './errors/ProjectErrors.js';
-import { getProjectConfig, validateProjectConfig, writeProjectConfig, } from '../lib/projects/config.js';
+import { ProjectNestingError, ProjectUploadError, ProjectBuildDeployError, } from './errors/ProjectErrors.js';
+import { getProjectConfig, writeProjectConfig, } from '../lib/projects/config.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { pollProjectBuildAndDeploy } from '../lib/projects/pollProjectBuildAndDeploy.js';
 import { handleProjectUpload } from '../lib/projects/upload.js';
@@ -29,11 +29,17 @@ export async function createProjectAction({ projectName, projectDest, }) {
             : 'Invalid project directory');
     }
     const projectDestAbsolute = path.resolve(getCwd(), projectDest);
-    const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await getProjectConfig(projectDestAbsolute);
-    if (existingProjectConfig &&
-        existingProjectDir &&
-        projectDestAbsolute.startsWith(existingProjectDir)) {
-        throw new ProjectNestingError(commands.project.create.errors.cannotNestProjects(existingProjectDir));
+    try {
+        const { projectDir: existingProjectDir } = getProjectConfig(projectDestAbsolute);
+        if (projectDestAbsolute.startsWith(existingProjectDir)) {
+            throw new ProjectNestingError(commands.project.create.errors.cannotNestProjects(existingProjectDir));
+        }
+    }
+    catch (error) {
+        if (error instanceof ProjectNestingError) {
+            throw error;
+        }
+        // Not in a project directory, which is the expected case
     }
     try {
         await cloneGithubRepo(HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, projectDestAbsolute, {
@@ -88,17 +94,7 @@ async function buildProjectMetadata(projectDir, projectConfig, accountId) {
     };
 }
 export async function uploadAndDeployAction({ accountId, projectDest, }) {
-    const { projectConfig, projectDir } = await getProjectConfig(projectDest);
-    if (!projectConfig || !projectDir) {
-        throw new ProjectConfigNotFoundError(commands.getStarted.errors.configFileNotFound);
-    }
-    try {
-        validateProjectConfig(projectConfig, projectDir);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new ProjectValidationError(message);
-    }
+    const { projectConfig, projectDir } = getProjectConfig(projectDest);
     const env = getConfigAccountEnvironment(accountId);
     try {
         const { result, uploadError } = await handleProjectUpload({

package/lib/jsonOutput/appInstallStatus.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const InstallStatusSchema: z.ZodObject<{
+    appId: z.ZodOptional<z.ZodNumber>;
+    appUid: z.ZodString;
+    accountId: z.ZodNumber;
+    projectId: z.ZodNumber;
+    isInstalled: z.ZodBoolean;
+    isInstalledWithCurrentScopes: z.ZodBoolean;
+    previouslyAuthorizedScopeGroups: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type InstallStatusJsonOutput = z.infer<typeof InstallStatusSchema>;

package/lib/jsonOutput/appInstallStatus.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+const ScopeGroupSchema = z.object({
+    id: z.number(),
+    name: z.string(),
+});
+export const InstallStatusSchema = z.object({
+    appId: z.number().optional(),
+    appUid: z.string(),
+    accountId: z.number(),
+    projectId: z.number(),
+    isInstalled: z.boolean(),
+    isInstalledWithCurrentScopes: z.boolean(),
+    previouslyAuthorizedScopeGroups: z.array(ScopeGroupSchema),
+});

package/lib/jsonOutput/createTestAccount.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const CreateTestAccountSchema: z.ZodObject<{
+    accountName: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodNumber>;
+    personalAccessKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateTestAccountJsonOutput = z.infer<typeof CreateTestAccountSchema>;

package/lib/jsonOutput/createTestAccount.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export const CreateTestAccountSchema = z.object({
+    accountName: z.string().optional(),
+    accountId: z.number().optional(),
+    personalAccessKey: z.string().optional(),
+});

package/lib/jsonOutput/deploy.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const DeploySchema: z.ZodObject<{
+    deployId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type DeployJsonOutput = z.infer<typeof DeploySchema>;

package/lib/jsonOutput/deploy.js

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export const DeploySchema = z.object({
+    deployId: z.number().optional(),
+});

package/lib/jsonOutput/info.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const ProjectInfoSchema: z.ZodObject<{
+    projectName: z.ZodString;
+    platformVersion: z.ZodString;
+    projectId: z.ZodNumber;
+    deployedBuildId: z.ZodNumber;
+    autoDeployEnabled: z.ZodBoolean;
+    projectUrl: z.ZodOptional<z.ZodString>;
+    app: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodNumber;
+        uid: z.ZodString;
+        authType: z.ZodOptional<z.ZodString>;
+        distributionType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    components: z.ZodArray<z.ZodObject<{
+        uid: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectInfoJsonOutput = z.infer<typeof ProjectInfoSchema>;