@hubspot/cli 8.14.0 → 8.15.0-beta.1

package/lib/jsonOutput/release.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { Release } from '../../api/releases.js';
+declare const ReleaseComponentSchema: z.ZodObject<{
+    buildType: z.ZodString;
+    buildName: z.ZodOptional<z.ZodString>;
+    rootPath: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReleaseSchema: z.ZodObject<{
+    releaseTag: z.ZodString;
+    buildId: z.ZodNumber;
+    createdAt: z.ZodString;
+    components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        buildType: z.ZodString;
+        buildName: z.ZodOptional<z.ZodString>;
+        rootPath: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ReleaseListSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        releaseTag: z.ZodString;
+        buildId: z.ZodNumber;
+        createdAt: z.ZodString;
+        components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            buildType: z.ZodString;
+            buildName: z.ZodOptional<z.ZodString>;
+            rootPath: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    paging: z.ZodOptional<z.ZodObject<{
+        next: z.ZodObject<{
+            after: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReleaseComponentJsonOutput = z.infer<typeof ReleaseComponentSchema>;
+export type ReleaseJsonOutput = z.infer<typeof ReleaseSchema>;
+export type ReleaseListJsonOutput = z.infer<typeof ReleaseListSchema>;
+export declare function mapReleaseToJsonOutput(release: Release): ReleaseJsonOutput;
+export {};

package/lib/jsonOutput/release.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+const ReleaseComponentSchema = z.object({
+    buildType: z.string(),
+    buildName: z.string().optional(),
+    rootPath: z.string().optional(),
+    id: z.string().optional(),
+});
+export const ReleaseSchema = z.object({
+    releaseTag: z.string(),
+    buildId: z.number(),
+    createdAt: z.string(),
+    components: z.array(ReleaseComponentSchema).optional(),
+});
+export const ReleaseListSchema = z.object({
+    results: z.array(ReleaseSchema),
+    paging: z
+        .object({
+        next: z.object({
+            after: z.string(),
+        }),
+    })
+        .optional(),
+});
+export function mapReleaseToJsonOutput(release) {
+    const { releaseTag, buildId, createdAt, components } = release;
+    return {
+        releaseTag,
+        buildId,
+        createdAt,
+        components: components?.map(({ buildType, buildName, rootPath, id }) => ({
+            buildType,
+            buildName,
+            rootPath,
+            id,
+        })),
+    };
+}

package/lib/jsonOutput/upload.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { HubSpotConfigAccount } from '@hubspot/local-dev-lib/types/Accounts';
+declare const PreviewSchema: z.ZodObject<{
+    releaseTag: z.ZodOptional<z.ZodString>;
+    succeeded: z.ZodBoolean;
+}, z.core.$strip>;
+declare const TargetAccountSchema: z.ZodObject<{
+    accountId: z.ZodNumber;
+    accountName: z.ZodOptional<z.ZodString>;
+    accountType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const UploadSchema: z.ZodObject<{
+    targetAccount: z.ZodOptional<z.ZodObject<{
+        accountId: z.ZodNumber;
+        accountName: z.ZodOptional<z.ZodString>;
+        accountType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    buildId: z.ZodOptional<z.ZodNumber>;
+    deployId: z.ZodOptional<z.ZodNumber>;
+    preview: z.ZodOptional<z.ZodObject<{
+        releaseTag: z.ZodOptional<z.ZodString>;
+        succeeded: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PreviewJsonOutput = z.infer<typeof PreviewSchema>;
+export type TargetAccountJsonOutput = z.infer<typeof TargetAccountSchema>;
+export type UploadJsonOutput = z.infer<typeof UploadSchema>;
+export declare function mapAccountToTargetAccount(accountId: number, account?: HubSpotConfigAccount | null): TargetAccountJsonOutput;
+export {};

package/lib/jsonOutput/upload.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+const PreviewSchema = z.object({
+    releaseTag: z.string().optional(),
+    succeeded: z.boolean(),
+});
+const TargetAccountSchema = z.object({
+    accountId: z.number(),
+    accountName: z.string().optional(),
+    accountType: z.string().optional(),
+});
+export const UploadSchema = z.object({
+    targetAccount: TargetAccountSchema.optional(),
+    buildId: z.number().optional(),
+    deployId: z.number().optional(),
+    preview: PreviewSchema.optional(),
+});
+export function mapAccountToTargetAccount(accountId, account) {
+    return {
+        accountId,
+        accountName: account?.name,
+        accountType: account?.accountType,
+    };
+}

package/lib/jsonOutput/validate.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+declare const ValidationIssueSchema: z.ZodObject<{
+    message: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ProfileValidationSchema: z.ZodObject<{
+    name: z.ZodString;
+    accountId: z.ZodOptional<z.ZodNumber>;
+    valid: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const ValidateSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    projectName: z.ZodOptional<z.ZodString>;
+    platformVersion: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    errors: z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    profiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        accountId: z.ZodOptional<z.ZodNumber>;
+        valid: z.ZodBoolean;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ValidationIssueJsonOutput = z.infer<typeof ValidationIssueSchema>;
+export type ProfileValidationJsonOutput = z.infer<typeof ProfileValidationSchema>;
+export type ValidateJsonOutput = z.infer<typeof ValidateSchema>;
+export {};

package/lib/jsonOutput/validate.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+const ValidationIssueSchema = z.object({
+    message: z.string(),
+    file: z.string().optional(),
+    profile: z.string().optional(),
+});
+const ProfileValidationSchema = z.object({
+    name: z.string(),
+    accountId: z.number().optional(),
+    valid: z.boolean(),
+});
+export const ValidateSchema = z.object({
+    valid: z.boolean(),
+    projectName: z.string().optional(),
+    platformVersion: z.string().optional(),
+    profile: z.string().optional(),
+    errors: z.array(ValidationIssueSchema),
+    warnings: z.array(ValidationIssueSchema),
+    profiles: z.array(ProfileValidationSchema).optional(),
+});

package/lib/npm/packageJson.js

@@ -92,7 +92,7 @@ const findAllPackageJsonFilesInDirectoryCached = async (directory) => {
  * @returns Array of absolute paths to package.json files in the project
  */
 export async function findAllPackageJsonFilesInProjectCached() {
-    const projectConfig = await getProjectConfig();
+    const projectConfig = getProjectConfig();
     const { projectDir } = projectConfig;
     if (!projectDir) {
         return [];

package/lib/projects/ProjectLogsManager.js

@@ -34,10 +34,7 @@ class _ProjectLogsManager {
         this.functions = [];
     }
     async init(accountId) {
-        const { projectConfig } = await getProjectConfig();
-        if (!projectConfig || !projectConfig.name) {
-            throw new Error(commands.project.logs.errors.noProjectConfig);
-        }
+        const { projectConfig } = getProjectConfig();
         this.projectConfig = projectConfig;
         this.projectName = projectConfig.name;
         this.accountId = accountId;

package/lib/projects/config.d.ts

@@ -1,9 +1,10 @@
-import { ProjectConfig } from '../../types/Projects.js';
+import type { ProjectConfig } from '@hubspot/project-parsing-lib/projects';
+export { ProjectConfigValidationError } from '@hubspot/project-parsing-lib/projects';
+export type { ProjectConfig } from '@hubspot/project-parsing-lib/projects';
 export declare function writeProjectConfig(configPath: string, config: ProjectConfig): boolean;
 export declare function getIsInProject(dir?: string): boolean;
 export interface LoadedProjectConfig {
-    projectDir: string | null;
-    projectConfig: ProjectConfig | null;
+    projectDir: string;
+    projectConfig: ProjectConfig;
 }
-export declare function getProjectConfig(dir?: string): Promise<LoadedProjectConfig>;
-export declare function validateProjectConfig(projectConfig: ProjectConfig | null, projectDir: string | null): asserts projectConfig is ProjectConfig;
+export declare function getProjectConfig(dir?: string): LoadedProjectConfig;

package/lib/projects/config.js

@@ -2,10 +2,11 @@ import fs from 'fs-extra';
 import path from 'path';
 import findup from 'findup-sync';
 import { getAbsoluteFilePath, getCwd } from '@hubspot/local-dev-lib/path';
+import { parseProjectConfig, ProjectConfigValidationError, } from '@hubspot/project-parsing-lib/projects';
 import { PROJECT_CONFIG_FILE } from '../constants.js';
 import { lib } from '../../lang/en.js';
 import { uiLogger } from '../ui/logger.js';
-import ProjectValidationError from '../errors/ProjectValidationError.js';
+export { ProjectConfigValidationError } from '@hubspot/project-parsing-lib/projects';
 export function writeProjectConfig(configPath, config) {
     try {
         fs.ensureFileSync(configPath);
@@ -30,44 +31,12 @@ function getProjectConfigPath(dir) {
     });
     return configPath;
 }
-export async function getProjectConfig(dir) {
+export function getProjectConfig(dir) {
     const configPath = getProjectConfigPath(dir);
     if (!configPath) {
-        return { projectConfig: null, projectDir: null };
-    }
-    try {
-        const config = fs.readFileSync(configPath);
-        const projectConfig = JSON.parse(config.toString());
-        return {
-            projectDir: path.dirname(configPath),
-            projectConfig,
-        };
-    }
-    catch (e) {
-        uiLogger.error(lib.projects.getProjectConfig.error);
-        return { projectConfig: null, projectDir: null };
-    }
-}
-export function validateProjectConfig(projectConfig, projectDir) {
-    if (!projectConfig || !projectDir) {
-        throw new ProjectValidationError(lib.projects.validateProjectConfig.configNotFound);
-    }
-    const missingFields = [];
-    if (!projectConfig.name) {
-        missingFields.push('name');
-    }
-    if (!projectConfig.srcDir) {
-        missingFields.push('srcDir');
-    }
-    if (missingFields.length > 0) {
-        throw new ProjectValidationError(lib.projects.validateProjectConfig.configMissingFields(missingFields));
-    }
-    const resolvedPath = path.resolve(projectDir, projectConfig.srcDir);
-    if (!resolvedPath.startsWith(projectDir)) {
-        const projectConfigFile = path.relative('.', path.join(projectDir, PROJECT_CONFIG_FILE));
-        throw new ProjectValidationError(lib.projects.validateProjectConfig.srcOutsideProjectDir(projectConfigFile, projectConfig.srcDir));
-    }
-    if (!fs.existsSync(resolvedPath)) {
-        throw new ProjectValidationError(lib.projects.validateProjectConfig.srcDirNotFound(projectConfig.srcDir, projectDir));
+        throw new ProjectConfigValidationError(lib.projects.validateProjectConfig.configNotFound);
     }
+    const projectDir = path.dirname(configPath);
+    const projectConfig = parseProjectConfig(projectDir);
+    return { projectDir, projectConfig };
 }

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

@@ -0,0 +1 @@
+export declare function getProjectCreateFailureReason(error: unknown): string;

package/lib/projects/create/tracking.js

@@ -0,0 +1,27 @@
+import { isFileSystemError, isGithubRateLimitError, isGithubError, getHttpStatusFromError, } from '@hubspot/local-dev-lib/errors/index';
+const FAILURE_REASON = {
+    GITHUB_RATE_LIMIT: 'github-rate-limit',
+    GITHUB_NOT_FOUND: 'github-not-found',
+    GITHUB_ERROR: 'github-error',
+    HTTP_ERROR: 'http-error',
+    FILESYSTEM: 'filesystem',
+    UNKNOWN: 'unknown',
+};
+export function getProjectCreateFailureReason(error) {
+    if (isGithubRateLimitError(error)) {
+        return FAILURE_REASON.GITHUB_RATE_LIMIT;
+    }
+    const httpStatus = getHttpStatusFromError(error);
+    if (httpStatus !== undefined) {
+        if (isGithubError(error)) {
+            return httpStatus === 404
+                ? FAILURE_REASON.GITHUB_NOT_FOUND
+                : FAILURE_REASON.GITHUB_ERROR;
+        }
+        return FAILURE_REASON.HTTP_ERROR;
+    }
+    if (isFileSystemError(error)) {
+        return FAILURE_REASON.FILESYSTEM;
+    }
+    return FAILURE_REASON.UNKNOWN;
+}

package/lib/projects/delete.js

@@ -79,7 +79,20 @@ export async function checkDeployedComponents(accountId, projectName) {
     const platformVersion = projectData.deployedBuild?.platformVersion ||
         projectData.latestBuild?.platformVersion;
     if (!platformVersion) {
-        throw new Error(commands.project.delete.errors.noPlatformVersion);
+        // A build exists but carries no platform version. That is inconsistent data rather than an
+        // empty project, and the build may have deployed components, so keep failing loudly instead of
+        // silently skipping cleanup.
+        if (projectData.deployedBuild || projectData.latestBuild) {
+            throw new Error(commands.project.delete.errors.noPlatformVersion);
+        }
+        // No builds at all, so nothing is deployed and there is no platform version to branch on. This
+        // happens whenever a project's very first upload fails, for example on a platform version that
+        // is not active, and previously left the project impossible to delete.
+        return {
+            platformVersion: '',
+            hasUnifiedComponents: false,
+            projectId: projectData.id,
+        };
     }
     if (isLegacyProject(platformVersion)) {
         const userVisibleComponents = [];

package/lib/projects/localDev/LocalDevProcess.js

@@ -108,17 +108,17 @@ class LocalDevProcess {
         }
     }
     async projectConfigValidForUpload() {
-        const { projectConfig } = await getProjectConfig();
-        if (!projectConfig) {
+        let projectConfig;
+        try {
+            ({ projectConfig } = getProjectConfig());
+        }
+        catch {
             return false;
         }
-        Object.keys(projectConfig).forEach(key => {
+        return Object.keys(projectConfig).every(key => {
             const field = key;
-            if (projectConfig[field] !== this.state.projectConfig[field]) {
-                return false;
-            }
+            return projectConfig[field] === this.state.projectConfig[field];
         });
-        return true;
     }
     async getIntermediateRepresentation(projectNodesAtLastDeploy) {
         const { intermediateRepresentation } = await translateForLocalDev({

package/lib/projects/projectProfiles.d.ts

@@ -2,8 +2,9 @@ import { type HsProfileFile } from '@hubspot/project-parsing-lib/profiles';
 import { ProjectConfig } from '../../types/Projects.js';
 export declare function logProfileHeader(profileName: string): void;
 export declare function logProfileFooter(profile: HsProfileFile, includeVariables?: boolean): void;
-export declare function loadProfile(projectConfig: ProjectConfig | null, projectDir: string | null, profileName: string): HsProfileFile | never;
-export declare function loadAndValidateProfile(projectConfig: ProjectConfig | null, projectDir: string | null, profileName: string, silent?: boolean): Promise<HsProfileFile | never>;
+export declare function loadProfile(projectConfig: ProjectConfig, projectDir: string, profileName: string): HsProfileFile | never;
+export declare function getProfileAccountId(projectConfig: ProjectConfig, projectDir: string, profileName: string): number | undefined;
+export declare function loadAndValidateProfile(projectConfig: ProjectConfig, projectDir: string, profileName: string, silent?: boolean): Promise<HsProfileFile | never>;
 type ValidateProjectForProfileOptions = {
     projectConfig: ProjectConfig;
     projectDir: string;

package/lib/projects/projectProfiles.js

@@ -25,9 +25,6 @@ export function logProfileFooter(profile, includeVariables = false) {
     uiLogger.log('');
 }
 export function loadProfile(projectConfig, projectDir, profileName) {
-    if (!projectConfig || !projectDir) {
-        throw new Error(lib.projectProfiles.loadProfile.errors.noProjectConfig);
-    }
     const projectSourceDir = path.join(projectDir, projectConfig.srcDir);
     const profileFilename = getHsProfileFilename(profileName);
     let profile;
@@ -51,6 +48,14 @@ export function loadProfile(projectConfig, projectDir, profileName) {
     }
     return profile;
 }
+export function getProfileAccountId(projectConfig, projectDir, profileName) {
+    try {
+        return loadProfile(projectConfig, projectDir, profileName).accountId;
+    }
+    catch (_e) {
+        return undefined;
+    }
+}
 export async function loadAndValidateProfile(projectConfig, projectDir, profileName, silent = false) {
     if (!silent) {
         logProfileHeader(profileName);

package/lib/projects/release.js

@@ -60,7 +60,7 @@ export async function resolveBuildId(accountId, projectName, buildOption, force)
 export async function validateBuildForRelease(accountId, projectName, buildId) {
     try {
         const { data: build } = await getBuildStatus(accountId, projectName, buildId);
-        return meetsMinimumPlatformVersion(build.platformVersion, PLATFORM_VERSIONS.v2027_03_BETA);
+        return meetsMinimumPlatformVersion(build.platformVersion, PLATFORM_VERSIONS.v2027_03);
     }
     catch (e) {
         if (isSpecifiedError(e, { statusCode: 404 })) {

package/lib/projects/uieLinting.d.ts

@@ -24,6 +24,8 @@ export declare function hasEslintConfig(directory: string): boolean;
 export declare function hasDeprecatedEslintConfig(directory: string): boolean;
 export declare function getDeprecatedEslintConfigFiles(directory: string): string[];
 export declare function createEslintConfig(directory: string, platformVersion?: string | null): Promise<string>;
+export declare function getUieComponentDirPrefixes(srcDir: string): string[];
+export declare function isUieComponentDirectory(directory: string, srcDir: string): boolean;
 export declare function getUieLintablePackageJsonLocations(projectConfig: LoadedProjectConfig): Promise<string[]>;
 export declare const HUBSPOT_UI_EXTENSIONS_RULE_PREFIX = "@hubspot/ui-extensions/";
 export declare function isHubSpotEslintConfigActive(directory: string): Promise<boolean>;

package/lib/projects/uieLinting.js

@@ -9,9 +9,10 @@ import { commands } from '../../lang/en.js';
 import { uiLogger } from '../ui/logger.js';
 import { clearPackageJsonCache, safeGetPackageJsonCached, } from '../npm/packageJson.js';
 import { debugError } from '../errorHandlers/index.js';
+import { isPathInsideDirectory } from '../filesystem.js';
 import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
 import { DEFAULT_PROJECT_TEMPLATE_BRANCH, HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, } from '../constants.js';
-import { CARDS_KEY, Components, PAGES_KEY, SETTINGS_KEY, } from '@hubspot/project-parsing-lib/constants';
+import { ACTIONS_KEY, CARDS_KEY, Components, PAGES_KEY, SETTINGS_KEY, } from '@hubspot/project-parsing-lib/constants';
 export const REQUIRED_PACKAGES_AND_MIN_VERSIONS = {
     eslint: '9.0.0',
     '@eslint/js': '9.0.0',
@@ -42,6 +43,7 @@ const DEPRECATED_ESLINT_CONFIG_FILES = [
     '.eslintrc',
 ];
 const UIE_COMPONENTS = [
+    Components[ACTIONS_KEY],
     Components[CARDS_KEY],
     Components[SETTINGS_KEY],
     Components[PAGES_KEY],
@@ -169,19 +171,19 @@ export async function createEslintConfig(directory, platformVersion) {
         throw error;
     }
 }
-export async function getUieLintablePackageJsonLocations(projectConfig) {
-    if (!projectConfig.projectDir || !projectConfig.projectConfig?.srcDir) {
-        return [];
-    }
-    const srcDirAbsolute = path.resolve(projectConfig.projectDir, projectConfig.projectConfig.srcDir);
-    const uiePackageDirPrefixes = UIE_COMPONENTS.map(component => path.join(srcDirAbsolute, component.parentComponent
+export function getUieComponentDirPrefixes(srcDir) {
+    const srcDirAbsolute = path.resolve(srcDir);
+    return UIE_COMPONENTS.map(component => path.join(srcDirAbsolute, component.parentComponent
         ? Components[component.parentComponent].dir
         : '', component.dir));
+}
+export function isUieComponentDirectory(directory, srcDir) {
+    return getUieComponentDirPrefixes(srcDir).some(componentDir => isPathInsideDirectory(directory, componentDir));
+}
+export async function getUieLintablePackageJsonLocations(projectConfig) {
+    const srcDirAbsolute = path.resolve(projectConfig.projectDir, projectConfig.projectConfig.srcDir);
     const allLocations = await getProjectPackageJsonLocations(projectConfig.projectDir);
-    return allLocations.filter(location => {
-        const resolvedLocation = path.resolve(location);
-        return uiePackageDirPrefixes.some(prefix => resolvedLocation.startsWith(prefix));
-    });
+    return allLocations.filter(location => isUieComponentDirectory(location, srcDirAbsolute));
 }
 export const HUBSPOT_UI_EXTENSIONS_RULE_PREFIX = '@hubspot/ui-extensions/';
 function getEnvironmentWithoutNpmConfig() {

package/lib/projects/upload.d.ts

@@ -25,7 +25,11 @@ type HandleProjectUploadArg<T> = {
     force?: boolean;
 };
 export declare function handleProjectUpload<T>({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage, forceCreate, isUploadCommand, sendIR, skipValidation, skipNpmAudit, skipAutoDeploy, force, }: HandleProjectUploadArg<T>): Promise<ProjectUploadResult<T>>;
-export declare function validateSourceDirectory(srcDir: string, projectConfig: ProjectConfig, projectDir: string): Promise<void>;
+export type SourceDirectoryWarning = {
+    message: string;
+    file: string;
+};
+export declare function validateSourceDirectory(srcDir: string, projectConfig: ProjectConfig, projectDir: string): Promise<SourceDirectoryWarning[]>;
 export declare function validateNoHSMetaMismatch(srcDir: string, projectConfig: ProjectConfig): Promise<void>;
 type HandleTranslateArg = {
     projectDir: string;

package/lib/projects/upload.js

@@ -159,14 +159,19 @@ export async function validateSourceDirectory(srcDir, projectConfig, projectDir)
     if (!projectFilePaths || projectFilePaths.length === 0) {
         throw new ProjectValidationError(lib.projectUpload.handleProjectUpload.emptySource(projectConfig.srcDir));
     }
+    const warnings = [];
     if (!isLegacyProject(projectConfig.platformVersion)) {
         projectFilePaths.forEach(filePath => {
             const filename = path.basename(filePath);
             if (LEGACY_CONFIG_FILES.includes(filename)) {
-                uiLogger.warn(lib.projectUpload.handleProjectUpload.legacyFileDetected(path.relative(projectDir, filePath), projectConfig.platformVersion));
+                const relativePath = path.relative(projectDir, filePath);
+                const message = lib.projectUpload.handleProjectUpload.legacyFileDetected(relativePath, projectConfig.platformVersion);
+                warnings.push({ message, file: relativePath });
+                uiLogger.warn(message);
             }
         });
     }
+    return warnings;
 }
 export async function validateNoHSMetaMismatch(srcDir, projectConfig) {
     const hasHsMetaFiles = await projectContainsHsMetaFiles(srcDir);

package/lib/projects/validate.d.ts

@@ -0,0 +1,18 @@
+import { ProjectConfig } from '../../types/Projects.js';
+import { ProfileValidationJsonOutput, ValidationIssueJsonOutput } from '../jsonOutput/validate.js';
+export type ProjectValidationResult = {
+    valid: boolean;
+    errors: ValidationIssueJsonOutput[];
+    warnings: ValidationIssueJsonOutput[];
+    profiles: ProfileValidationJsonOutput[];
+};
+type ValidateProjectArgs = {
+    projectConfig: ProjectConfig;
+    projectDir: string;
+    derivedAccountId: number;
+    profile?: string;
+    formatOutputAsJson?: boolean;
+};
+export declare function toIssue(error: unknown, profile?: string): ValidationIssueJsonOutput;
+export declare function validateProject({ projectConfig, projectDir, derivedAccountId, profile, formatOutputAsJson, }: ValidateProjectArgs): Promise<ProjectValidationResult>;
+export {};