@vercel/build-utils 13.2.11 → 13.2.12

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @vercel/build-utils
 
+## 13.2.12
+
+### Patch Changes
+
+- Add `findPackageJson` function for optimized package.json lookup without lockfile scanning. This improves `getNodeVersion` performance by avoiding unnecessary lockfile parsing. ([#14658](https://github.com/vercel/vercel/pull/14658))
+
 ## 13.2.10
 
 ### Patch Changes

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

@@ -2,11 +2,7 @@
 import { SpawnOptions } from 'child_process';
 import { Meta, PackageJson, NodeVersion, Config, BunVersion } from '../types';
 export type CliType = 'yarn' | 'npm' | 'pnpm' | 'bun' | 'vlt';
-export interface ScanParentDirsResult {
-    /**
-     * "yarn", "npm", or "pnpm" depending on the presence of lockfiles.
-     */
-    cliType: CliType;
+export interface FindPackageJsonResult {
     /**
      * The file path of found `package.json` file, or `undefined` if not found.
      */
@@ -16,6 +12,12 @@ export interface ScanParentDirsResult {
      * option is enabled.
      */
     packageJson?: PackageJson;
+}
+export interface ScanParentDirsResult extends FindPackageJsonResult {
+    /**
+     * "yarn", "npm", or "pnpm" depending on the presence of lockfiles.
+     */
+    cliType: CliType;
     /**
      * The file path of the lockfile (`yarn.lock`, `package-lock.json`, or `pnpm-lock.yaml`)
      * or `undefined` if not found.
@@ -91,6 +93,12 @@ export declare function runShellScript(fsPath: string, args?: string[], spawnOpt
  */
 export declare function getSpawnOptions(meta: Meta, nodeVersion: NodeVersion): SpawnOptions;
 export declare function getNodeVersion(destPath: string, fallbackVersion?: string | undefined, config?: Config, meta?: Meta, availableVersions?: number[]): Promise<NodeVersion | BunVersion>;
+/**
+ * Traverses up directories to find and optionally read package.json.
+ * This is a lightweight alternative to `scanParentDirs` when only
+ * package.json information is needed (without lockfile detection).
+ */
+export declare function findPackageJson(destPath: string, readPackageJson?: boolean, base?: string): Promise<FindPackageJsonResult>;
 export declare function scanParentDirs(destPath: string, readPackageJson?: boolean, base?: string): Promise<ScanParentDirsResult>;
 export declare function turboVersionSpecifierSupportsCorepack(turboVersionSpecifier: string): boolean;
 export declare function usingCorepack(env: {

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

@@ -31,6 +31,7 @@ __export(run_user_scripts_exports, {
   PNPM_10_PREFERRED_AT: () => PNPM_10_PREFERRED_AT,
   detectPackageManager: () => detectPackageManager,
   execCommand: () => execCommand,
+  findPackageJson: () => findPackageJson,
   getEnvForPackageManager: () => getEnvForPackageManager,
   getNodeBinPath: () => getNodeBinPath,
   getNodeBinPaths: () => getNodeBinPaths,
@@ -212,7 +213,7 @@ async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PRO
     latestVersion.runtime = "nodejs";
     return latestVersion;
   }
-  const { packageJson } = await scanParentDirs(destPath, true);
+  const { packageJson } = await findPackageJson(destPath, true);
   const configuredVersion = config.nodeVersion || fallbackVersion;
   const packageJsonVersion = packageJson?.engines?.node;
   const supportedNodeVersion = await (0, import_node_version.getSupportedNodeVersion)(
@@ -239,7 +240,7 @@ async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PRO
   }
   return supportedNodeVersion;
 }
-async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
+async function findPackageJson(destPath, readPackageJson = false, base = "/") {
   (0, import_assert.default)(import_path.default.isAbsolute(destPath));
   const pkgJsonPath = await walkParentDirs({
     base,
@@ -256,6 +257,18 @@ async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
       );
     }
   }
+  return {
+    packageJsonPath: pkgJsonPath || void 0,
+    packageJson
+  };
+}
+async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
+  (0, import_assert.default)(import_path.default.isAbsolute(destPath));
+  const { packageJsonPath: pkgJsonPath, packageJson } = await findPackageJson(
+    destPath,
+    readPackageJson,
+    base
+  );
   const {
     paths: [
       yarnLockPath,
@@ -1089,6 +1102,7 @@ const installDependencies = (0, import_util.deprecate)(
   PNPM_10_PREFERRED_AT,
   detectPackageManager,
   execCommand,
+  findPackageJson,
   getEnvForPackageManager,
   getNodeBinPath,
   getNodeBinPaths,

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import download, { downloadFile, DownloadedFiles, isSymbolicLink, isDirectory }
 import getWriteableDirectory from './fs/get-writable-directory';
 import glob, { GlobOptions } from './fs/glob';
 import rename from './fs/rename';
-import { spawnAsync, execCommand, spawnCommand, walkParentDirs, getScriptName, installDependencies, runPackageJsonScript, runNpmInstall, runBundleInstall, runPipInstall, runShellScript, runCustomInstallCommand, resetCustomInstallCommandSet, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, detectPackageManager, getSpawnOptions, getNodeBinPath, getNodeBinPaths, scanParentDirs, traverseUpDirectories } from './fs/run-user-scripts';
+import { spawnAsync, execCommand, spawnCommand, walkParentDirs, getScriptName, installDependencies, runPackageJsonScript, runNpmInstall, runBundleInstall, runPipInstall, runShellScript, runCustomInstallCommand, resetCustomInstallCommandSet, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, detectPackageManager, getSpawnOptions, getNodeBinPath, getNodeBinPaths, scanParentDirs, findPackageJson, traverseUpDirectories } from './fs/run-user-scripts';
 import { getLatestNodeVersion, getDiscontinuedNodeVersions, getSupportedNodeVersion, isBunVersion, getSupportedBunVersion } from './fs/node-version';
 import streamToBuffer, { streamToBufferChunks } from './fs/stream-to-buffer';
 import debug from './debug';
@@ -18,7 +18,7 @@ import { getPrefixedEnvVars } from './get-prefixed-env-vars';
 import { cloneEnv } from './clone-env';
 import { hardLinkDir } from './hard-link-dir';
 import { validateNpmrc } from './validate-npmrc';
-export { FileBlob, FileFsRef, FileRef, Lambda, NodejsLambda, createLambda, Prerender, download, downloadFile, DownloadedFiles, getWriteableDirectory, glob, GlobOptions, rename, spawnAsync, getScriptName, installDependencies, runPackageJsonScript, execCommand, spawnCommand, walkParentDirs, getNodeBinPath, getNodeBinPaths, getSupportedNodeVersion, isBunVersion, getSupportedBunVersion, detectPackageManager, runNpmInstall, runBundleInstall, runPipInstall, runShellScript, runCustomInstallCommand, resetCustomInstallCommandSet, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, getLatestNodeVersion, getDiscontinuedNodeVersions, getSpawnOptions, getPlatformEnv, getPrefixedEnvVars, streamToBuffer, streamToBufferChunks, debug, isSymbolicLink, isDirectory, getLambdaOptionsFromFunction, scanParentDirs, getIgnoreFilter, cloneEnv, hardLinkDir, traverseUpDirectories, validateNpmrc, };
+export { FileBlob, FileFsRef, FileRef, Lambda, NodejsLambda, createLambda, Prerender, download, downloadFile, DownloadedFiles, getWriteableDirectory, glob, GlobOptions, rename, spawnAsync, getScriptName, installDependencies, runPackageJsonScript, execCommand, spawnCommand, walkParentDirs, getNodeBinPath, getNodeBinPaths, getSupportedNodeVersion, isBunVersion, getSupportedBunVersion, detectPackageManager, runNpmInstall, runBundleInstall, runPipInstall, runShellScript, runCustomInstallCommand, resetCustomInstallCommandSet, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, getLatestNodeVersion, getDiscontinuedNodeVersions, getSpawnOptions, getPlatformEnv, getPrefixedEnvVars, streamToBuffer, streamToBufferChunks, debug, isSymbolicLink, isDirectory, getLambdaOptionsFromFunction, scanParentDirs, findPackageJson, getIgnoreFilter, cloneEnv, hardLinkDir, traverseUpDirectories, validateNpmrc, };
 export { EdgeFunction } from './edge-function';
 export { readConfigFile, getPackageJson } from './fs/read-config-file';
 export { normalizePath } from './fs/normalize-path';

package/dist/index.js

@@ -23740,6 +23740,7 @@ __export(src_exports, {
   download: () => download,
   downloadFile: () => downloadFile,
   execCommand: () => execCommand,
+  findPackageJson: () => findPackageJson,
   functionsSchema: () => functionsSchema,
   generateNodeBuilderFunctions: () => generateNodeBuilderFunctions,
   getDiscontinuedNodeVersions: () => getDiscontinuedNodeVersions,
@@ -25251,7 +25252,7 @@ async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PRO
     latestVersion.runtime = "nodejs";
     return latestVersion;
   }
-  const { packageJson } = await scanParentDirs(destPath, true);
+  const { packageJson } = await findPackageJson(destPath, true);
   const configuredVersion = config.nodeVersion || fallbackVersion;
   const packageJsonVersion = packageJson?.engines?.node;
   const supportedNodeVersion = await getSupportedNodeVersion(
@@ -25278,7 +25279,7 @@ async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PRO
   }
   return supportedNodeVersion;
 }
-async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
+async function findPackageJson(destPath, readPackageJson = false, base = "/") {
   (0, import_assert6.default)(import_path6.default.isAbsolute(destPath));
   const pkgJsonPath = await walkParentDirs({
     base,
@@ -25295,6 +25296,18 @@ async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
       );
     }
   }
+  return {
+    packageJsonPath: pkgJsonPath || void 0,
+    packageJson
+  };
+}
+async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
+  (0, import_assert6.default)(import_path6.default.isAbsolute(destPath));
+  const { packageJsonPath: pkgJsonPath, packageJson } = await findPackageJson(
+    destPath,
+    readPackageJson,
+    base
+  );
   const {
     paths: [
       yarnLockPath,
@@ -26836,6 +26849,7 @@ async function isPythonEntrypoint(file) {
   download,
   downloadFile,
   execCommand,
+  findPackageJson,
   functionsSchema,
   generateNodeBuilderFunctions,
   getDiscontinuedNodeVersions,

package/package.json

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