@vercel/build-utils 10.1.0 → 10.3.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @vercel/build-utils
 
+## 10.3.0
+
+### Minor Changes
+
+- Delay pnpm@10 preferred date ([#13100](https://github.com/vercel/vercel/pull/13100))
+
+### Patch Changes
+
+- Type-check tests ([#13096](https://github.com/vercel/vercel/pull/13096))
+
+## 10.2.0
+
+### Minor Changes
+
+- Detect v9 pnpm lock files as pnpm 10 for new projects ([#13072](https://github.com/vercel/vercel/pull/13072))
+
+### Patch Changes
+
+- Improve build log messages surrounding pnpm 10 ([#13088](https://github.com/vercel/vercel/pull/13088))
+
+- [build-utils] extract checkIfAlreadyInstalled helper to clarify intent ([#13060](https://github.com/vercel/vercel/pull/13060))
+
+- Allow pnpm 10 to use package.json#packageManager without an engines error ([#13083](https://github.com/vercel/vercel/pull/13083))
+
 ## 10.1.0
 
 ### Minor Changes

package/dist/fs/node-version.d.ts

@@ -1,6 +1,7 @@
 import { NodeVersion } from '../types';
 export type NodeVersionMajor = ReturnType<typeof getOptions>[number]['major'];
 export declare const NODE_VERSIONS: NodeVersion[];
+export declare function getNodeVersionByMajor(major: number): NodeVersion | undefined;
 declare function getOptions(): NodeVersion[];
 export declare function getAvailableNodeVersions(): NodeVersionMajor[];
 export declare function getLatestNodeVersion(availableVersions?: NodeVersionMajor[]): NodeVersion;

package/dist/fs/node-version.js

@@ -32,6 +32,7 @@ __export(node_version_exports, {
   getAvailableNodeVersions: () => getAvailableNodeVersions,
   getDiscontinuedNodeVersions: () => getDiscontinuedNodeVersions,
   getLatestNodeVersion: () => getLatestNodeVersion,
+  getNodeVersionByMajor: () => getNodeVersionByMajor,
   getSupportedNodeVersion: () => getSupportedNodeVersion
 });
 module.exports = __toCommonJS(node_version_exports);
@@ -87,6 +88,9 @@ const NODE_VERSIONS = [
     discontinueDate: /* @__PURE__ */ new Date("2020-01-06")
   })
 ];
+function getNodeVersionByMajor(major) {
+  return NODE_VERSIONS.find((v) => v.major === major);
+}
 function getOptions() {
   return NODE_VERSIONS;
 }
@@ -176,5 +180,6 @@ async function getSupportedNodeVersion(engineRange, isAuto = false, availableVer
   getAvailableNodeVersions,
   getDiscontinuedNodeVersions,
   getLatestNodeVersion,
+  getNodeVersionByMajor,
   getSupportedNodeVersion
 });

package/dist/fs/run-user-scripts.d.ts

@@ -92,12 +92,12 @@ export declare function usingCorepack(env: {
     [x: string]: string | undefined;
 }, packageJsonPackageManager: string | undefined, turboSupportsCorepackHome: boolean | undefined): boolean;
 export declare function walkParentDirs({ base, start, filename, }: WalkParentDirsProps): Promise<string | null>;
-export declare function runNpmInstall(destPath: string, args?: string[], spawnOpts?: SpawnOptions, meta?: Meta, nodeVersion?: NodeVersion): Promise<boolean>;
+export declare function runNpmInstall(destPath: string, args?: string[], spawnOpts?: SpawnOptions, meta?: Meta, nodeVersion?: NodeVersion, projectCreatedAt?: number): Promise<boolean>;
 /**
  * Prepares the input environment based on the used package manager and lockfile
  * versions.
  */
-export declare function getEnvForPackageManager({ cliType, lockfileVersion, packageJsonPackageManager, nodeVersion, env, packageJsonEngines, turboSupportsCorepackHome, }: {
+export declare function getEnvForPackageManager({ cliType, lockfileVersion, packageJsonPackageManager, nodeVersion, env, packageJsonEngines, turboSupportsCorepackHome, projectCreatedAt, }: {
     cliType: CliType;
     lockfileVersion: number | undefined;
     packageJsonPackageManager?: string | undefined;
@@ -107,20 +107,23 @@ export declare function getEnvForPackageManager({ cliType, lockfileVersion, pack
     };
     packageJsonEngines?: PackageJson.Engines;
     turboSupportsCorepackHome?: boolean | undefined;
+    projectCreatedAt?: number | undefined;
 }): {
     [x: string]: string | undefined;
 };
+export declare const PNPM_10_PREFERRED_AT: Date;
 /**
  * Helper to get the binary paths that link to the used package manager.
  * Note: Make sure it doesn't contain any `console.log` calls.
  */
-export declare function getPathOverrideForPackageManager({ cliType, lockfileVersion, corepackPackageManager, corepackEnabled, packageJsonEngines, }: {
+export declare function getPathOverrideForPackageManager({ cliType, lockfileVersion, corepackPackageManager, corepackEnabled, packageJsonEngines, projectCreatedAt, }: {
     cliType: CliType;
     lockfileVersion: number | undefined;
     corepackPackageManager: string | undefined;
     nodeVersion: NodeVersion | undefined;
     corepackEnabled?: boolean;
     packageJsonEngines?: PackageJson.Engines;
+    projectCreatedAt?: number;
 }): {
     /**
      * Which lockfile was detected.
@@ -136,7 +139,7 @@ export declare function getPathOverrideForPackageManager({ cliType, lockfileVers
      */
     path: string | undefined;
 };
-export declare function detectPackageManager(cliType: CliType, lockfileVersion: number | undefined): {
+export declare function detectPackageManager(cliType: CliType, lockfileVersion: number | undefined, projectCreatedAt?: number): {
     path: string;
     detectedLockfile: string;
     detectedPackageManager: string;
@@ -189,13 +192,14 @@ export declare function getPathForPackageManager({ cliType, lockfileVersion, nod
      */
     yarnNodeLinker: string | undefined;
 };
-export declare function runCustomInstallCommand({ destPath, installCommand, nodeVersion, spawnOpts, }: {
+export declare function runCustomInstallCommand({ destPath, installCommand, nodeVersion, spawnOpts, projectCreatedAt, }: {
     destPath: string;
     installCommand: string;
     nodeVersion: NodeVersion;
     spawnOpts?: SpawnOptions;
+    projectCreatedAt?: number;
 }): Promise<void>;
-export declare function runPackageJsonScript(destPath: string, scriptNames: string | Iterable<string>, spawnOpts?: SpawnOptions): Promise<boolean>;
+export declare function runPackageJsonScript(destPath: string, scriptNames: string | Iterable<string>, spawnOpts?: SpawnOptions, projectCreatedAt?: number): Promise<boolean>;
 export declare function runBundleInstall(destPath: string, args?: string[], spawnOpts?: SpawnOptions, meta?: Meta): Promise<void>;
 export declare function runPipInstall(destPath: string, args?: string[], spawnOpts?: SpawnOptions, meta?: Meta): Promise<void>;
 export declare function getScriptName(pkg: Pick<PackageJson, 'scripts'> | null | undefined, possibleNames: Iterable<string>): string | undefined;

package/dist/fs/run-user-scripts.js

@@ -28,6 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var run_user_scripts_exports = {};
 __export(run_user_scripts_exports, {
+  PNPM_10_PREFERRED_AT: () => PNPM_10_PREFERRED_AT,
   detectPackageManager: () => detectPackageManager,
   execCommand: () => execCommand,
   getEnvForPackageManager: () => getEnvForPackageManager,
@@ -461,8 +462,20 @@ async function runInstallCommand({
   }
   await spawnAsync(packageManager, commandArguments, opts);
 }
+function initializeSet(set) {
+  if (!isSet(set)) {
+    return /* @__PURE__ */ new Set();
+  }
+  return set;
+}
+function checkIfAlreadyInstalled(runNpmInstallSet, packageJsonPath) {
+  const initializedRunNpmInstallSet = initializeSet(runNpmInstallSet);
+  const alreadyInstalled = initializedRunNpmInstallSet.has(packageJsonPath);
+  initializedRunNpmInstallSet.add(packageJsonPath);
+  return { alreadyInstalled, runNpmInstallSet: initializedRunNpmInstallSet };
+}
 const runNpmInstallSema = new import_async_sema.default(1);
-async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion) {
+async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion, projectCreatedAt) {
   if (meta?.isDev) {
     (0, import_debug.default)("Skipping dependency installation because dev mode is enabled");
     return false;
@@ -484,17 +497,16 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion)
       );
       return false;
     }
-    if (meta && packageJsonPath && args.length === 0) {
-      if (!isSet(meta.runNpmInstallSet)) {
-        meta.runNpmInstallSet = /* @__PURE__ */ new Set();
-      }
-      if (isSet(meta.runNpmInstallSet)) {
-        if (meta.runNpmInstallSet.has(packageJsonPath)) {
-          return false;
-        } else {
-          meta.runNpmInstallSet.add(packageJsonPath);
-        }
+    const defaultInstall = args.length === 0;
+    if (meta && packageJsonPath && defaultInstall) {
+      const { alreadyInstalled, runNpmInstallSet } = checkIfAlreadyInstalled(
+        meta.runNpmInstallSet,
+        packageJsonPath
+      );
+      if (alreadyInstalled) {
+        return false;
       }
+      meta.runNpmInstallSet = runNpmInstallSet;
     }
     const installTime = Date.now();
     console.log("Installing dependencies...");
@@ -509,7 +521,8 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion)
       nodeVersion,
       env,
       packageJsonEngines: packageJson?.engines,
-      turboSupportsCorepackHome
+      turboSupportsCorepackHome,
+      projectCreatedAt
     });
     await runInstallCommand({
       packageManager: cliType,
@@ -529,7 +542,8 @@ function getEnvForPackageManager({
   nodeVersion,
   env,
   packageJsonEngines,
-  turboSupportsCorepackHome
+  turboSupportsCorepackHome,
+  projectCreatedAt
 }) {
   const corepackEnabled = usingCorepack(
     env,
@@ -546,7 +560,8 @@ function getEnvForPackageManager({
     corepackPackageManager: packageJsonPackageManager,
     nodeVersion,
     corepackEnabled,
-    packageJsonEngines
+    packageJsonEngines,
+    projectCreatedAt
   });
   if (corepackEnabled) {
     (0, import_debug.default)(
@@ -568,10 +583,26 @@ function getEnvForPackageManager({
     const oldPath = env.PATH + "";
     newEnv.PATH = `${newPath}${import_path.default.delimiter}${oldPath}`;
     if (detectedLockfile && detectedPackageManager) {
-      const versionString = cliType === "pnpm" ? `version ${lockfileVersion} ` : "";
-      console.log(
-        `Detected \`${detectedLockfile}\` ${versionString}generated by ${detectedPackageManager}`
-      );
+      const detectedV9PnpmLockfile = detectedLockfile === "pnpm-lock.yaml" && lockfileVersion === 9;
+      const pnpm10UsingPackageJsonPackageManager = detectedPackageManager === "pnpm@10.x" && packageJsonPackageManager;
+      if (pnpm10UsingPackageJsonPackageManager) {
+        const versionString = cliType === "pnpm" ? `version ${lockfileVersion} ` : "";
+        console.log(
+          `Detected \`${detectedLockfile}\` ${versionString}generated by ${detectedPackageManager} with package.json#packageManager ${packageJsonPackageManager}`
+        );
+      } else if (detectedV9PnpmLockfile) {
+        const otherVersion = detectedPackageManager === "pnpm@10.x" ? `pnpm@9.x` : `pnpm@10.x`;
+        console.log(
+          `Detected \`${detectedLockfile}\` ${lockfileVersion} which may be generated by pnpm@9.x or pnpm@10.x
+Using ${detectedPackageManager} based on project creation date
+To use ${otherVersion}, manually opt in using corepack (https://vercel.com/docs/deployments/configure-a-build#corepack)`
+        );
+      } else {
+        const versionString = cliType === "pnpm" ? `version ${lockfileVersion} ` : "";
+        console.log(
+          `Detected \`${detectedLockfile}\` ${versionString}generated by ${detectedPackageManager}`
+        );
+      }
       if (cliType === "bun") {
         console.warn(
           "Warning: Bun is used as a package manager at build time only, not at runtime with Functions"
@@ -584,7 +615,8 @@ function getEnvForPackageManager({
   }
   return newEnv;
 }
-function detectPnpmVersion(lockfileVersion) {
+const PNPM_10_PREFERRED_AT = /* @__PURE__ */ new Date("2025-02-27T20:00:00Z");
+function detectPnpmVersion(lockfileVersion, projectCreatedAt) {
   switch (true) {
     case lockfileVersion === void 0:
       return "not found";
@@ -594,8 +626,12 @@ function detectPnpmVersion(lockfileVersion) {
       return "pnpm 7";
     case (lockfileVersion === 6 || lockfileVersion === 6.1):
       return "pnpm 8";
-    case (lockfileVersion === 7 || lockfileVersion === 9):
+    case lockfileVersion === 7:
       return "pnpm 9";
+    case lockfileVersion === 9: {
+      const projectPrefersPnpm10 = projectCreatedAt && projectCreatedAt >= PNPM_10_PREFERRED_AT.getTime();
+      return projectPrefersPnpm10 ? "pnpm 10" : "pnpm 9";
+    }
     default:
       return "not found";
   }
@@ -609,6 +645,8 @@ function validLockfileForPackageManager(cliType, lockfileVersion, packageManager
       return true;
     case "pnpm":
       switch (packageManagerMajorVersion) {
+        case 10:
+          return lockfileVersion === 9;
         case 9:
           if ("9.0.0" === packageManagerVersion.version && lockfileVersion === 6) {
             return false;
@@ -630,25 +668,34 @@ function getPathOverrideForPackageManager({
   lockfileVersion,
   corepackPackageManager,
   corepackEnabled = true,
-  packageJsonEngines
+  packageJsonEngines,
+  projectCreatedAt
 }) {
-  const detectedPackageManger = detectPackageManager(cliType, lockfileVersion);
-  if (!corepackPackageManager || !corepackEnabled) {
-    if (cliType === "pnpm" && packageJsonEngines?.pnpm) {
+  const detectedPackageManger = detectPackageManager(
+    cliType,
+    lockfileVersion,
+    projectCreatedAt
+  );
+  const usingCorepack2 = corepackPackageManager && corepackEnabled;
+  if (usingCorepack2) {
+    validateCorepackPackageManager(
+      cliType,
+      lockfileVersion,
+      corepackPackageManager,
+      packageJsonEngines?.pnpm
+    );
+    return NO_OVERRIDE;
+  }
+  if (cliType === "pnpm" && packageJsonEngines?.pnpm) {
+    const usingDetected = detectedPackageManger?.pnpmVersionRange !== "10.x" || !corepackPackageManager;
+    if (usingDetected) {
       checkEnginesPnpmAgainstDetected(
         packageJsonEngines.pnpm,
         detectedPackageManger
       );
     }
-    return detectedPackageManger ?? NO_OVERRIDE;
   }
-  validateCorepackPackageManager(
-    cliType,
-    lockfileVersion,
-    corepackPackageManager,
-    packageJsonEngines?.pnpm
-  );
-  return NO_OVERRIDE;
+  return detectedPackageManger ?? NO_OVERRIDE;
 }
 function checkEnginesPnpmAgainstDetected(enginesPnpm, detectedPackageManger) {
   if (detectedPackageManger?.pnpmVersionRange && (0, import_semver.validRange)(detectedPackageManger.pnpmVersionRange) && (0, import_semver.validRange)(enginesPnpm)) {
@@ -723,12 +770,12 @@ function validateVersionSpecifier(version) {
     packageVersion
   };
 }
-function detectPackageManager(cliType, lockfileVersion) {
+function detectPackageManager(cliType, lockfileVersion, projectCreatedAt) {
   switch (cliType) {
     case "npm":
       return void 0;
     case "pnpm":
-      switch (detectPnpmVersion(lockfileVersion)) {
+      switch (detectPnpmVersion(lockfileVersion, projectCreatedAt)) {
         case "pnpm 7":
           return {
             path: "/pnpm7/node_modules/.bin",
@@ -750,6 +797,13 @@ function detectPackageManager(cliType, lockfileVersion) {
             detectedPackageManager: "pnpm@9.x",
             pnpmVersionRange: "9.x"
           };
+        case "pnpm 10":
+          return {
+            path: "/pnpm10/node_modules/.bin",
+            detectedLockfile: "pnpm-lock.yaml",
+            detectedPackageManager: "pnpm@10.x",
+            pnpmVersionRange: "10.x"
+          };
         case "pnpm 6":
           return {
             // undefined because pnpm@6 is the current default in the build container
@@ -813,7 +867,8 @@ async function runCustomInstallCommand({
   destPath,
   installCommand,
   nodeVersion,
-  spawnOpts
+  spawnOpts,
+  projectCreatedAt
 }) {
   console.log(`Running "install" command: \`${installCommand}\`...`);
   const {
@@ -830,7 +885,8 @@ async function runCustomInstallCommand({
     nodeVersion,
     env: spawnOpts?.env || {},
     packageJsonEngines: packageJson?.engines,
-    turboSupportsCorepackHome
+    turboSupportsCorepackHome,
+    projectCreatedAt
   });
   (0, import_debug.default)(`Running with $PATH:`, env?.PATH || "");
   await execCommand(installCommand, {
@@ -839,7 +895,7 @@ async function runCustomInstallCommand({
     cwd: destPath
   });
 }
-async function runPackageJsonScript(destPath, scriptNames, spawnOpts) {
+async function runPackageJsonScript(destPath, scriptNames, spawnOpts, projectCreatedAt) {
   (0, import_assert.default)(import_path.default.isAbsolute(destPath));
   const {
     packageJson,
@@ -866,7 +922,8 @@ async function runPackageJsonScript(destPath, scriptNames, spawnOpts) {
       nodeVersion: void 0,
       env: (0, import_clone_env.cloneEnv)(process.env, spawnOpts?.env),
       packageJsonEngines: packageJson?.engines,
-      turboSupportsCorepackHome
+      turboSupportsCorepackHome,
+      projectCreatedAt
     })
   };
   if (cliType === "npm") {
@@ -921,6 +978,7 @@ const installDependencies = (0, import_util.deprecate)(
 );
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  PNPM_10_PREFERRED_AT,
   detectPackageManager,
   execCommand,
   getEnvForPackageManager,

package/dist/index.js

@@ -23474,8 +23474,20 @@ async function runInstallCommand({
   }
   await spawnAsync(packageManager, commandArguments, opts);
 }
+function initializeSet(set) {
+  if (!isSet(set)) {
+    return /* @__PURE__ */ new Set();
+  }
+  return set;
+}
+function checkIfAlreadyInstalled(runNpmInstallSet, packageJsonPath) {
+  const initializedRunNpmInstallSet = initializeSet(runNpmInstallSet);
+  const alreadyInstalled = initializedRunNpmInstallSet.has(packageJsonPath);
+  initializedRunNpmInstallSet.add(packageJsonPath);
+  return { alreadyInstalled, runNpmInstallSet: initializedRunNpmInstallSet };
+}
 var runNpmInstallSema = new import_async_sema4.default(1);
-async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion) {
+async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion, projectCreatedAt) {
   if (meta?.isDev) {
     debug("Skipping dependency installation because dev mode is enabled");
     return false;
@@ -23497,17 +23509,16 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion)
       );
       return false;
     }
-    if (meta && packageJsonPath && args.length === 0) {
-      if (!isSet(meta.runNpmInstallSet)) {
-        meta.runNpmInstallSet = /* @__PURE__ */ new Set();
-      }
-      if (isSet(meta.runNpmInstallSet)) {
-        if (meta.runNpmInstallSet.has(packageJsonPath)) {
-          return false;
-        } else {
-          meta.runNpmInstallSet.add(packageJsonPath);
-        }
+    const defaultInstall = args.length === 0;
+    if (meta && packageJsonPath && defaultInstall) {
+      const { alreadyInstalled, runNpmInstallSet } = checkIfAlreadyInstalled(
+        meta.runNpmInstallSet,
+        packageJsonPath
+      );
+      if (alreadyInstalled) {
+        return false;
       }
+      meta.runNpmInstallSet = runNpmInstallSet;
     }
     const installTime = Date.now();
     console.log("Installing dependencies...");
@@ -23522,7 +23533,8 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion)
       nodeVersion,
       env,
       packageJsonEngines: packageJson?.engines,
-      turboSupportsCorepackHome
+      turboSupportsCorepackHome,
+      projectCreatedAt
     });
     await runInstallCommand({
       packageManager: cliType,
@@ -23542,7 +23554,8 @@ function getEnvForPackageManager({
   nodeVersion,
   env,
   packageJsonEngines,
-  turboSupportsCorepackHome
+  turboSupportsCorepackHome,
+  projectCreatedAt
 }) {
   const corepackEnabled = usingCorepack(
     env,
@@ -23559,7 +23572,8 @@ function getEnvForPackageManager({
     corepackPackageManager: packageJsonPackageManager,
     nodeVersion,
     corepackEnabled,
-    packageJsonEngines
+    packageJsonEngines,
+    projectCreatedAt
   });
   if (corepackEnabled) {
     debug(
@@ -23581,10 +23595,26 @@ function getEnvForPackageManager({
     const oldPath = env.PATH + "";
     newEnv.PATH = `${newPath}${import_path5.default.delimiter}${oldPath}`;
     if (detectedLockfile && detectedPackageManager) {
-      const versionString = cliType === "pnpm" ? `version ${lockfileVersion} ` : "";
-      console.log(
-        `Detected \`${detectedLockfile}\` ${versionString}generated by ${detectedPackageManager}`
-      );
+      const detectedV9PnpmLockfile = detectedLockfile === "pnpm-lock.yaml" && lockfileVersion === 9;
+      const pnpm10UsingPackageJsonPackageManager = detectedPackageManager === "pnpm@10.x" && packageJsonPackageManager;
+      if (pnpm10UsingPackageJsonPackageManager) {
+        const versionString = cliType === "pnpm" ? `version ${lockfileVersion} ` : "";
+        console.log(
+          `Detected \`${detectedLockfile}\` ${versionString}generated by ${detectedPackageManager} with package.json#packageManager ${packageJsonPackageManager}`
+        );
+      } else if (detectedV9PnpmLockfile) {
+        const otherVersion = detectedPackageManager === "pnpm@10.x" ? `pnpm@9.x` : `pnpm@10.x`;
+        console.log(
+          `Detected \`${detectedLockfile}\` ${lockfileVersion} which may be generated by pnpm@9.x or pnpm@10.x
+Using ${detectedPackageManager} based on project creation date
+To use ${otherVersion}, manually opt in using corepack (https://vercel.com/docs/deployments/configure-a-build#corepack)`
+        );
+      } else {
+        const versionString = cliType === "pnpm" ? `version ${lockfileVersion} ` : "";
+        console.log(
+          `Detected \`${detectedLockfile}\` ${versionString}generated by ${detectedPackageManager}`
+        );
+      }
       if (cliType === "bun") {
         console.warn(
           "Warning: Bun is used as a package manager at build time only, not at runtime with Functions"
@@ -23597,7 +23627,8 @@ function getEnvForPackageManager({
   }
   return newEnv;
 }
-function detectPnpmVersion(lockfileVersion) {
+var PNPM_10_PREFERRED_AT = /* @__PURE__ */ new Date("2025-02-27T20:00:00Z");
+function detectPnpmVersion(lockfileVersion, projectCreatedAt) {
   switch (true) {
     case lockfileVersion === void 0:
       return "not found";
@@ -23607,8 +23638,12 @@ function detectPnpmVersion(lockfileVersion) {
       return "pnpm 7";
     case (lockfileVersion === 6 || lockfileVersion === 6.1):
       return "pnpm 8";
-    case (lockfileVersion === 7 || lockfileVersion === 9):
+    case lockfileVersion === 7:
       return "pnpm 9";
+    case lockfileVersion === 9: {
+      const projectPrefersPnpm10 = projectCreatedAt && projectCreatedAt >= PNPM_10_PREFERRED_AT.getTime();
+      return projectPrefersPnpm10 ? "pnpm 10" : "pnpm 9";
+    }
     default:
       return "not found";
   }
@@ -23622,6 +23657,8 @@ function validLockfileForPackageManager(cliType, lockfileVersion, packageManager
       return true;
     case "pnpm":
       switch (packageManagerMajorVersion) {
+        case 10:
+          return lockfileVersion === 9;
         case 9:
           if ("9.0.0" === packageManagerVersion.version && lockfileVersion === 6) {
             return false;
@@ -23643,25 +23680,34 @@ function getPathOverrideForPackageManager({
   lockfileVersion,
   corepackPackageManager,
   corepackEnabled = true,
-  packageJsonEngines
+  packageJsonEngines,
+  projectCreatedAt
 }) {
-  const detectedPackageManger = detectPackageManager(cliType, lockfileVersion);
-  if (!corepackPackageManager || !corepackEnabled) {
-    if (cliType === "pnpm" && packageJsonEngines?.pnpm) {
+  const detectedPackageManger = detectPackageManager(
+    cliType,
+    lockfileVersion,
+    projectCreatedAt
+  );
+  const usingCorepack2 = corepackPackageManager && corepackEnabled;
+  if (usingCorepack2) {
+    validateCorepackPackageManager(
+      cliType,
+      lockfileVersion,
+      corepackPackageManager,
+      packageJsonEngines?.pnpm
+    );
+    return NO_OVERRIDE;
+  }
+  if (cliType === "pnpm" && packageJsonEngines?.pnpm) {
+    const usingDetected = detectedPackageManger?.pnpmVersionRange !== "10.x" || !corepackPackageManager;
+    if (usingDetected) {
       checkEnginesPnpmAgainstDetected(
         packageJsonEngines.pnpm,
         detectedPackageManger
       );
     }
-    return detectedPackageManger ?? NO_OVERRIDE;
   }
-  validateCorepackPackageManager(
-    cliType,
-    lockfileVersion,
-    corepackPackageManager,
-    packageJsonEngines?.pnpm
-  );
-  return NO_OVERRIDE;
+  return detectedPackageManger ?? NO_OVERRIDE;
 }
 function checkEnginesPnpmAgainstDetected(enginesPnpm, detectedPackageManger) {
   if (detectedPackageManger?.pnpmVersionRange && (0, import_semver2.validRange)(detectedPackageManger.pnpmVersionRange) && (0, import_semver2.validRange)(enginesPnpm)) {
@@ -23736,12 +23782,12 @@ function validateVersionSpecifier(version) {
     packageVersion
   };
 }
-function detectPackageManager(cliType, lockfileVersion) {
+function detectPackageManager(cliType, lockfileVersion, projectCreatedAt) {
   switch (cliType) {
     case "npm":
       return void 0;
     case "pnpm":
-      switch (detectPnpmVersion(lockfileVersion)) {
+      switch (detectPnpmVersion(lockfileVersion, projectCreatedAt)) {
         case "pnpm 7":
           return {
             path: "/pnpm7/node_modules/.bin",
@@ -23763,6 +23809,13 @@ function detectPackageManager(cliType, lockfileVersion) {
             detectedPackageManager: "pnpm@9.x",
             pnpmVersionRange: "9.x"
           };
+        case "pnpm 10":
+          return {
+            path: "/pnpm10/node_modules/.bin",
+            detectedLockfile: "pnpm-lock.yaml",
+            detectedPackageManager: "pnpm@10.x",
+            pnpmVersionRange: "10.x"
+          };
         case "pnpm 6":
           return {
             // undefined because pnpm@6 is the current default in the build container
@@ -23826,7 +23879,8 @@ async function runCustomInstallCommand({
   destPath,
   installCommand,
   nodeVersion,
-  spawnOpts
+  spawnOpts,
+  projectCreatedAt
 }) {
   console.log(`Running "install" command: \`${installCommand}\`...`);
   const {
@@ -23843,7 +23897,8 @@ async function runCustomInstallCommand({
     nodeVersion,
     env: spawnOpts?.env || {},
     packageJsonEngines: packageJson?.engines,
-    turboSupportsCorepackHome
+    turboSupportsCorepackHome,
+    projectCreatedAt
   });
   debug(`Running with $PATH:`, env?.PATH || "");
   await execCommand(installCommand, {
@@ -23852,7 +23907,7 @@ async function runCustomInstallCommand({
     cwd: destPath
   });
 }
-async function runPackageJsonScript(destPath, scriptNames, spawnOpts) {
+async function runPackageJsonScript(destPath, scriptNames, spawnOpts, projectCreatedAt) {
   (0, import_assert6.default)(import_path5.default.isAbsolute(destPath));
   const {
     packageJson,
@@ -23879,7 +23934,8 @@ async function runPackageJsonScript(destPath, scriptNames, spawnOpts) {
       nodeVersion: void 0,
       env: cloneEnv(process.env, spawnOpts?.env),
       packageJsonEngines: packageJson?.engines,
-      turboSupportsCorepackHome
+      turboSupportsCorepackHome,
+      projectCreatedAt
     })
   };
   if (cliType === "npm") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "10.1.0",
+  "version": "10.3.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",