@vercel/build-utils 13.2.11 → 13.2.13

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @vercel/build-utils
 
+## 13.2.13
+
+### Patch Changes
+
+- [python] experimental python runtime framework preset ([#14646](https://github.com/vercel/vercel/pull/14646))
+
+## 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/framework-helpers.d.ts

@@ -3,12 +3,16 @@ import { Builder } from '.';
  * List of backend frameworks supported by the experimental backends feature
  */
 export declare const BACKEND_FRAMEWORKS: readonly ["express", "hono", "h3", "koa", "nestjs", "fastify", "elysia"];
+export declare const PYTHON_FRAMEWORKS: readonly ["fastapi", "flask", "python"];
+export declare const RUNTIME_FRAMEWORKS: readonly ["python"];
 export declare const BACKEND_BUILDERS: readonly ["@vercel/express", "@vercel/hono", "@vercel/h3", "@vercel/koa", "@vercel/nestjs", "@vercel/fastify", "@vercel/elysia"];
 export type BackendFramework = (typeof BACKEND_FRAMEWORKS)[number];
+export type PythonFramework = (typeof PYTHON_FRAMEWORKS)[number];
 /**
  * Checks if the given framework is a backend framework
  */
 export declare function isBackendFramework(framework: string | null | undefined): framework is BackendFramework;
+export declare function isPythonFramework(framework: string | null | undefined): framework is (typeof PYTHON_FRAMEWORKS)[number];
 export declare function isExperimentalBackendsWithoutIntrospectionEnabled(): boolean;
 export declare function isExperimentalBackendsEnabled(): boolean;
 export declare function isBackendBuilder(builder: Builder | null | undefined): boolean;

package/dist/framework-helpers.js

@@ -20,10 +20,13 @@ var framework_helpers_exports = {};
 __export(framework_helpers_exports, {
   BACKEND_BUILDERS: () => BACKEND_BUILDERS,
   BACKEND_FRAMEWORKS: () => BACKEND_FRAMEWORKS,
+  PYTHON_FRAMEWORKS: () => PYTHON_FRAMEWORKS,
+  RUNTIME_FRAMEWORKS: () => RUNTIME_FRAMEWORKS,
   isBackendBuilder: () => isBackendBuilder,
   isBackendFramework: () => isBackendFramework,
   isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled: () => isExperimentalBackendsWithoutIntrospectionEnabled,
+  isPythonFramework: () => isPythonFramework,
   shouldUseExperimentalBackends: () => shouldUseExperimentalBackends
 });
 module.exports = __toCommonJS(framework_helpers_exports);
@@ -36,6 +39,13 @@ const BACKEND_FRAMEWORKS = [
   "fastify",
   "elysia"
 ];
+const PYTHON_FRAMEWORKS = [
+  "fastapi",
+  "flask",
+  "python"
+  // Generic Python framework preset
+];
+const RUNTIME_FRAMEWORKS = ["python"];
 const BACKEND_BUILDERS = [
   "@vercel/express",
   "@vercel/hono",
@@ -50,6 +60,11 @@ function isBackendFramework(framework) {
     return false;
   return BACKEND_FRAMEWORKS.includes(framework);
 }
+function isPythonFramework(framework) {
+  if (!framework)
+    return false;
+  return PYTHON_FRAMEWORKS.includes(framework);
+}
 function isExperimentalBackendsWithoutIntrospectionEnabled() {
   return process.env.VERCEL_BACKENDS_BUILDS === "1";
 }
@@ -70,9 +85,12 @@ function shouldUseExperimentalBackends(framework) {
 0 && (module.exports = {
   BACKEND_BUILDERS,
   BACKEND_FRAMEWORKS,
+  PYTHON_FRAMEWORKS,
+  RUNTIME_FRAMEWORKS,
   isBackendBuilder,
   isBackendFramework,
   isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled,
+  isPythonFramework,
   shouldUseExperimentalBackends
 });

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';
@@ -32,5 +32,5 @@ export { NODE_VERSIONS } from './fs/node-version';
 export { getInstalledPackageVersion } from './get-installed-package-version';
 export { defaultCachePathGlob } from './default-cache-path-glob';
 export { generateNodeBuilderFunctions } from './generate-node-builder-functions';
-export { BACKEND_FRAMEWORKS, BackendFramework, isBackendFramework, isBackendBuilder, isExperimentalBackendsEnabled, isExperimentalBackendsWithoutIntrospectionEnabled, shouldUseExperimentalBackends, } from './framework-helpers';
+export { BACKEND_FRAMEWORKS, BackendFramework, isBackendFramework, isBackendBuilder, isExperimentalBackendsEnabled, isExperimentalBackendsWithoutIntrospectionEnabled, shouldUseExperimentalBackends, PYTHON_FRAMEWORKS, PythonFramework, isPythonFramework, } from './framework-helpers';
 export * from './python';

package/dist/index.js

@@ -23728,6 +23728,7 @@ __export(src_exports, {
   NodeVersion: () => NodeVersion,
   NodejsLambda: () => NodejsLambda,
   NowBuildError: () => NowBuildError,
+  PYTHON_FRAMEWORKS: () => PYTHON_FRAMEWORKS,
   Prerender: () => Prerender,
   Span: () => Span,
   Version: () => Version,
@@ -23740,6 +23741,7 @@ __export(src_exports, {
   download: () => download,
   downloadFile: () => downloadFile,
   execCommand: () => execCommand,
+  findPackageJson: () => findPackageJson,
   functionsSchema: () => functionsSchema,
   generateNodeBuilderFunctions: () => generateNodeBuilderFunctions,
   getDiscontinuedNodeVersions: () => getDiscontinuedNodeVersions,
@@ -23773,6 +23775,7 @@ __export(src_exports, {
   isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled: () => isExperimentalBackendsWithoutIntrospectionEnabled,
   isPythonEntrypoint: () => isPythonEntrypoint,
+  isPythonFramework: () => isPythonFramework,
   isSymbolicLink: () => isSymbolicLink,
   normalizePath: () => normalizePath,
   readConfigFile: () => readConfigFile,
@@ -25251,7 +25254,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 +25281,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 +25298,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,
@@ -26732,6 +26747,12 @@ var BACKEND_FRAMEWORKS = [
   "fastify",
   "elysia"
 ];
+var PYTHON_FRAMEWORKS = [
+  "fastapi",
+  "flask",
+  "python"
+  // Generic Python framework preset
+];
 var BACKEND_BUILDERS = [
   "@vercel/express",
   "@vercel/hono",
@@ -26746,6 +26767,11 @@ function isBackendFramework(framework) {
     return false;
   return BACKEND_FRAMEWORKS.includes(framework);
 }
+function isPythonFramework(framework) {
+  if (!framework)
+    return false;
+  return PYTHON_FRAMEWORKS.includes(framework);
+}
 function isExperimentalBackendsWithoutIntrospectionEnabled() {
   return process.env.VERCEL_BACKENDS_BUILDS === "1";
 }
@@ -26824,6 +26850,7 @@ async function isPythonEntrypoint(file) {
   NodeVersion,
   NodejsLambda,
   NowBuildError,
+  PYTHON_FRAMEWORKS,
   Prerender,
   Span,
   Version,
@@ -26836,6 +26863,7 @@ async function isPythonEntrypoint(file) {
   download,
   downloadFile,
   execCommand,
+  findPackageJson,
   functionsSchema,
   generateNodeBuilderFunctions,
   getDiscontinuedNodeVersions,
@@ -26869,6 +26897,7 @@ async function isPythonEntrypoint(file) {
   isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled,
   isPythonEntrypoint,
+  isPythonFramework,
   isSymbolicLink,
   normalizePath,
   readConfigFile,

package/package.json

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