@vercel/build-utils 12.1.3 → 12.2.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @vercel/build-utils
 
+## 12.2.1
+
+### Patch Changes
+
+- Add backend util helpers ([#14152](https://github.com/vercel/vercel/pull/14152))
+
+## 12.2.0
+
+### Minor Changes
+
+- Add support for Bun through a vercel.json property ([#14130](https://github.com/vercel/vercel/pull/14130))
+
 ## 12.1.3
 
 ### Patch Changes

package/dist/framework-helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * List of backend frameworks supported by the experimental backends feature
+ */
+export declare const BACKEND_FRAMEWORKS: readonly ["express", "hono", "h3", "nestjs", "fastify"];
+export type BackendFramework = (typeof BACKEND_FRAMEWORKS)[number];
+/**
+ * Checks if the given framework is a backend framework
+ */
+export declare function isBackendFramework(framework: string | null | undefined): framework is BackendFramework;
+/**
+ * Checks if experimental backends are enabled via environment variable
+ */
+export declare function isExperimentalBackendsEnabled(): boolean;
+/**
+ * Checks if experimental backends are enabled AND the framework is a backend framework
+ */
+export declare function shouldUseExperimentalBackends(framework: string | null | undefined): boolean;

package/dist/framework-helpers.js

@@ -0,0 +1,52 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var framework_helpers_exports = {};
+__export(framework_helpers_exports, {
+  BACKEND_FRAMEWORKS: () => BACKEND_FRAMEWORKS,
+  isBackendFramework: () => isBackendFramework,
+  isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
+  shouldUseExperimentalBackends: () => shouldUseExperimentalBackends
+});
+module.exports = __toCommonJS(framework_helpers_exports);
+const BACKEND_FRAMEWORKS = [
+  "express",
+  "hono",
+  "h3",
+  "nestjs",
+  "fastify"
+];
+function isBackendFramework(framework) {
+  if (!framework)
+    return false;
+  return BACKEND_FRAMEWORKS.includes(framework);
+}
+function isExperimentalBackendsEnabled() {
+  return process.env.VERCEL_EXPERIMENTAL_BACKENDS === "1" || // Previously used for experimental express and hono builds
+  process.env.VERCEL_EXPERIMENTAL_EXPRESS_BUILD === "1" || process.env.VERCEL_EXPERIMENTAL_HONO_BUILD === "1";
+}
+function shouldUseExperimentalBackends(framework) {
+  return isExperimentalBackendsEnabled() && isBackendFramework(framework);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BACKEND_FRAMEWORKS,
+  isBackendFramework,
+  isExperimentalBackendsEnabled,
+  shouldUseExperimentalBackends
+});

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

@@ -1,10 +1,13 @@
-import { NodeVersion } from '../types';
+import { BunVersion, NodeVersion, Version } from '../types';
 export type NodeVersionMajor = ReturnType<typeof getOptions>[number]['major'];
 export declare const NODE_VERSIONS: NodeVersion[];
+export declare const BUN_VERSIONS: BunVersion[];
 export declare function getNodeVersionByMajor(major: number): NodeVersion | undefined;
 declare function getOptions(): NodeVersion[];
 export declare function getAvailableNodeVersions(): NodeVersionMajor[];
 export declare function getLatestNodeVersion(availableVersions?: NodeVersionMajor[]): NodeVersion;
 export declare function getDiscontinuedNodeVersions(): NodeVersion[];
 export declare function getSupportedNodeVersion(engineRange: string | undefined, isAuto?: boolean, availableVersions?: NodeVersionMajor[]): Promise<NodeVersion>;
+export declare function getSupportedBunVersion(engineRange: string): BunVersion;
+export declare function isBunVersion(version: Version): boolean;
 export {};

package/dist/fs/node-version.js

@@ -28,12 +28,15 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var node_version_exports = {};
 __export(node_version_exports, {
+  BUN_VERSIONS: () => BUN_VERSIONS,
   NODE_VERSIONS: () => NODE_VERSIONS,
   getAvailableNodeVersions: () => getAvailableNodeVersions,
   getDiscontinuedNodeVersions: () => getDiscontinuedNodeVersions,
   getLatestNodeVersion: () => getLatestNodeVersion,
   getNodeVersionByMajor: () => getNodeVersionByMajor,
-  getSupportedNodeVersion: () => getSupportedNodeVersion
+  getSupportedBunVersion: () => getSupportedBunVersion,
+  getSupportedNodeVersion: () => getSupportedNodeVersion,
+  isBunVersion: () => isBunVersion
 });
 module.exports = __toCommonJS(node_version_exports);
 var import_fs = require("fs");
@@ -89,6 +92,13 @@ const NODE_VERSIONS = [
     discontinueDate: /* @__PURE__ */ new Date("2020-01-06")
   })
 ];
+const BUN_VERSIONS = [
+  new import_types.BunVersion({
+    major: 1,
+    range: "1.x",
+    runtime: "bun1.x"
+  })
+];
 function getNodeVersionByMajor(major) {
   return NODE_VERSIONS.find((v) => v.major === major);
 }
@@ -175,12 +185,36 @@ async function getSupportedNodeVersion(engineRange, isAuto = false, availableVer
   }
   return selection;
 }
+function getSupportedBunVersion(engineRange) {
+  if ((0, import_semver.validRange)(engineRange)) {
+    const selected = BUN_VERSIONS.find((version) => {
+      return (0, import_semver.intersects)(version.range, engineRange);
+    });
+    if (selected) {
+      return new import_types.BunVersion({
+        major: selected.major,
+        range: selected.range,
+        runtime: selected.runtime
+      });
+    }
+  }
+  throw new import_errors.NowBuildError({
+    message: `Found invalid Bun Version: "${engineRange}".`,
+    code: "BUILD_UTILS_BUN_VERSION_INVALID"
+  });
+}
+function isBunVersion(version) {
+  return version.runtime.startsWith("bun");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BUN_VERSIONS,
   NODE_VERSIONS,
   getAvailableNodeVersions,
   getDiscontinuedNodeVersions,
   getLatestNodeVersion,
   getNodeVersionByMajor,
-  getSupportedNodeVersion
+  getSupportedBunVersion,
+  getSupportedNodeVersion,
+  isBunVersion
 });

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

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { SpawnOptions } from 'child_process';
-import { Meta, PackageJson, NodeVersion, Config } from '../types';
+import { Meta, PackageJson, NodeVersion, Config, BunVersion } from '../types';
 export type CliType = 'yarn' | 'npm' | 'pnpm' | 'bun' | 'vlt';
 export interface ScanParentDirsResult {
     /**
@@ -85,23 +85,22 @@ export declare function getNodeBinPath({ cwd, }: {
 export declare function getNodeBinPaths({ start, base, }: TraverseUpDirectoriesProps): string[];
 export declare function runShellScript(fsPath: string, args?: string[], spawnOpts?: SpawnOptions): Promise<boolean>;
 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>;
+export declare function getNodeVersion(destPath: string, fallbackVersion?: string | undefined, config?: Config, meta?: Meta, availableVersions?: number[]): Promise<NodeVersion | BunVersion>;
 export declare function scanParentDirs(destPath: string, readPackageJson?: boolean, base?: string): Promise<ScanParentDirsResult>;
 export declare function turboVersionSpecifierSupportsCorepack(turboVersionSpecifier: string): boolean;
 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, projectCreatedAt?: number): Promise<boolean>;
+export declare function runNpmInstall(destPath: string, args?: string[], spawnOpts?: SpawnOptions, meta?: Meta, 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, projectCreatedAt, }: {
+export declare function getEnvForPackageManager({ cliType, lockfileVersion, packageJsonPackageManager, env, packageJsonEngines, turboSupportsCorepackHome, projectCreatedAt, }: {
     cliType: CliType;
     lockfileVersion: number | undefined;
     packageJsonPackageManager?: string | undefined;
-    nodeVersion: NodeVersion | undefined;
     env: {
         [x: string]: string | undefined;
     };
@@ -120,7 +119,6 @@ export declare function getPathOverrideForPackageManager({ cliType, lockfileVers
     cliType: CliType;
     lockfileVersion: number | undefined;
     corepackPackageManager: string | undefined;
-    nodeVersion: NodeVersion | undefined;
     corepackEnabled?: boolean;
     packageJsonEngines?: PackageJson.Engines;
     projectCreatedAt?: number;
@@ -160,10 +158,9 @@ export declare function detectPackageManager(cliType: CliType, lockfileVersion:
  * Note: Make sure it doesn't contain any `console.log` calls.
  * @deprecated use `getEnvForPackageManager` instead
  */
-export declare function getPathForPackageManager({ cliType, lockfileVersion, nodeVersion, env, }: {
+export declare function getPathForPackageManager({ cliType, lockfileVersion, env, }: {
     cliType: CliType;
     lockfileVersion: number | undefined;
-    nodeVersion: NodeVersion | undefined;
     env: {
         [x: string]: string | undefined;
     };
@@ -187,10 +184,9 @@ export declare function getPathForPackageManager({ cliType, lockfileVersion, nod
      */
     yarnNodeLinker: string | undefined;
 };
-export declare function runCustomInstallCommand({ destPath, installCommand, nodeVersion, spawnOpts, projectCreatedAt, }: {
+export declare function runCustomInstallCommand({ destPath, installCommand, spawnOpts, projectCreatedAt, }: {
     destPath: string;
     installCommand: string;
-    nodeVersion: NodeVersion;
     spawnOpts?: SpawnOptions;
     projectCreatedAt?: number;
 }): Promise<void>;

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

@@ -182,6 +182,9 @@ function getSpawnOptions(meta, nodeVersion) {
   const opts = {
     env: (0, import_clone_env.cloneEnv)(process.env)
   };
+  if ((0, import_node_version.isBunVersion)(nodeVersion)) {
+    return opts;
+  }
   if (!meta.isDev) {
     let found = false;
     const oldPath = opts.env.PATH || process.env.PATH || "";
@@ -200,6 +203,9 @@ function getSpawnOptions(meta, nodeVersion) {
   return opts;
 }
 async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PROJECT_SETTINGS_NODE_VERSION, config = {}, meta = {}, availableVersions = (0, import_node_version.getAvailableNodeVersions)()) {
+  if (config.bunVersion) {
+    return (0, import_node_version.getSupportedBunVersion)(config.bunVersion);
+  }
   const latestVersion = (0, import_node_version.getLatestNodeVersion)(availableVersions);
   if (meta.isDev) {
     latestVersion.runtime = "nodejs";
@@ -520,7 +526,7 @@ function checkIfAlreadyInstalled(runNpmInstallSet, packageJsonPath) {
   return { alreadyInstalled, runNpmInstallSet: initializedRunNpmInstallSet };
 }
 const runNpmInstallSema = new import_async_sema.default(1);
-async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion, projectCreatedAt) {
+async function runNpmInstall(destPath, args = [], spawnOpts, meta, projectCreatedAt) {
   if (meta?.isDev) {
     (0, import_debug.default)("Skipping dependency installation because dev mode is enabled");
     return false;
@@ -573,7 +579,6 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion,
       cliType,
       lockfileVersion,
       packageJsonPackageManager,
-      nodeVersion,
       env,
       packageJsonEngines: packageJson?.engines,
       turboSupportsCorepackHome,
@@ -600,7 +605,6 @@ function getEnvForPackageManager({
   cliType,
   lockfileVersion,
   packageJsonPackageManager,
-  nodeVersion,
   env,
   packageJsonEngines,
   turboSupportsCorepackHome,
@@ -619,7 +623,6 @@ function getEnvForPackageManager({
     cliType,
     lockfileVersion,
     corepackPackageManager: packageJsonPackageManager,
-    nodeVersion,
     corepackEnabled,
     packageJsonEngines,
     projectCreatedAt
@@ -913,15 +916,13 @@ function detectPackageManager(cliType, lockfileVersion, projectCreatedAt) {
 function getPathForPackageManager({
   cliType,
   lockfileVersion,
-  nodeVersion,
   env
 }) {
   const corepackEnabled = env.ENABLE_EXPERIMENTAL_COREPACK === "1";
   let overrides = getPathOverrideForPackageManager({
     cliType,
     lockfileVersion,
-    corepackPackageManager: void 0,
-    nodeVersion
+    corepackPackageManager: void 0
   });
   if (corepackEnabled) {
     overrides = NO_OVERRIDE;
@@ -947,7 +948,6 @@ function getPathForPackageManager({
 async function runCustomInstallCommand({
   destPath,
   installCommand,
-  nodeVersion,
   spawnOpts,
   projectCreatedAt
 }) {
@@ -963,7 +963,6 @@ async function runCustomInstallCommand({
     cliType,
     lockfileVersion,
     packageJsonPackageManager,
-    nodeVersion,
     env: spawnOpts?.env || {},
     packageJsonEngines: packageJson?.engines,
     turboSupportsCorepackHome,
@@ -1000,7 +999,6 @@ async function runPackageJsonScript(destPath, scriptNames, spawnOpts, projectCre
       cliType,
       lockfileVersion,
       packageJsonPackageManager,
-      nodeVersion: void 0,
       env: (0, import_clone_env.cloneEnv)(process.env, spawnOpts?.env),
       packageJsonEngines: packageJson?.engines,
       turboSupportsCorepackHome,

package/dist/index.d.ts

@@ -9,7 +9,7 @@ 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, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, detectPackageManager, getSpawnOptions, getNodeBinPath, getNodeBinPaths, scanParentDirs, traverseUpDirectories } from './fs/run-user-scripts';
-import { getLatestNodeVersion, getDiscontinuedNodeVersions, getSupportedNodeVersion } from './fs/node-version';
+import { getLatestNodeVersion, getDiscontinuedNodeVersions, getSupportedNodeVersion, isBunVersion, getSupportedBunVersion } from './fs/node-version';
 import streamToBuffer, { streamToBufferChunks } from './fs/stream-to-buffer';
 import debug from './debug';
 import getIgnoreFilter from './get-ignore-filter';
@@ -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, detectPackageManager, runNpmInstall, runBundleInstall, runPipInstall, runShellScript, runCustomInstallCommand, 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, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, getLatestNodeVersion, getDiscontinuedNodeVersions, getSpawnOptions, getPlatformEnv, getPrefixedEnvVars, streamToBuffer, streamToBufferChunks, debug, isSymbolicLink, isDirectory, getLambdaOptionsFromFunction, scanParentDirs, getIgnoreFilter, cloneEnv, hardLinkDir, traverseUpDirectories, validateNpmrc, };
 export { EdgeFunction } from './edge-function';
 export { readConfigFile } from './fs/read-config-file';
 export { normalizePath } from './fs/normalize-path';
@@ -32,3 +32,4 @@ 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, isExperimentalBackendsEnabled, shouldUseExperimentalBackends, } from './framework-helpers';

package/dist/index.js

@@ -21817,8 +21817,10 @@ var require_ignore = __commonJS({
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  BACKEND_FRAMEWORKS: () => BACKEND_FRAMEWORKS,
   BUILDER_COMPILE_STEP: () => BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP: () => BUILDER_INSTALLER_STEP,
+  BunVersion: () => BunVersion,
   EdgeFunction: () => EdgeFunction,
   FileBlob: () => FileBlob,
   FileFsRef: () => file_fs_ref_default,
@@ -21859,12 +21861,16 @@ __export(src_exports, {
   getProvidedRuntime: () => getProvidedRuntime,
   getScriptName: () => getScriptName,
   getSpawnOptions: () => getSpawnOptions,
+  getSupportedBunVersion: () => getSupportedBunVersion,
   getSupportedNodeVersion: () => getSupportedNodeVersion,
   getWriteableDirectory: () => getWritableDirectory,
   glob: () => glob,
   hardLinkDir: () => hardLinkDir,
   installDependencies: () => installDependencies,
+  isBackendFramework: () => isBackendFramework,
+  isBunVersion: () => isBunVersion,
   isDirectory: () => isDirectory,
+  isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   isSymbolicLink: () => isSymbolicLink,
   normalizePath: () => normalizePath,
   readConfigFile: () => readConfigFile,
@@ -21877,6 +21883,7 @@ __export(src_exports, {
   runShellScript: () => runShellScript,
   scanParentDirs: () => scanParentDirs,
   shouldServe: () => shouldServe,
+  shouldUseExperimentalBackends: () => shouldUseExperimentalBackends,
   spawnAsync: () => spawnAsync,
   spawnCommand: () => spawnCommand,
   streamToBuffer: () => streamToBuffer,
@@ -22948,6 +22955,8 @@ var Version = class {
 };
 var NodeVersion = class extends Version {
 };
+var BunVersion = class extends Version {
+};
 
 // src/fs/node-version.ts
 var NODE_VERSIONS = [
@@ -22998,6 +23007,13 @@ var NODE_VERSIONS = [
     discontinueDate: /* @__PURE__ */ new Date("2020-01-06")
   })
 ];
+var BUN_VERSIONS = [
+  new BunVersion({
+    major: 1,
+    range: "1.x",
+    runtime: "bun1.x"
+  })
+];
 function getOptions() {
   return NODE_VERSIONS;
 }
@@ -23081,6 +23097,27 @@ async function getSupportedNodeVersion(engineRange, isAuto = false, availableVer
   }
   return selection;
 }
+function getSupportedBunVersion(engineRange) {
+  if ((0, import_semver.validRange)(engineRange)) {
+    const selected = BUN_VERSIONS.find((version) => {
+      return (0, import_semver.intersects)(version.range, engineRange);
+    });
+    if (selected) {
+      return new BunVersion({
+        major: selected.major,
+        range: selected.range,
+        runtime: selected.runtime
+      });
+    }
+  }
+  throw new NowBuildError({
+    message: `Found invalid Bun Version: "${engineRange}".`,
+    code: "BUILD_UTILS_BUN_VERSION_INVALID"
+  });
+}
+function isBunVersion(version) {
+  return version.runtime.startsWith("bun");
+}
 
 // src/fs/read-config-file.ts
 var import_js_yaml = __toESM(require_js_yaml2());
@@ -23257,6 +23294,9 @@ function getSpawnOptions(meta, nodeVersion) {
   const opts = {
     env: cloneEnv(process.env)
   };
+  if (isBunVersion(nodeVersion)) {
+    return opts;
+  }
   if (!meta.isDev) {
     let found = false;
     const oldPath = opts.env.PATH || process.env.PATH || "";
@@ -23275,6 +23315,9 @@ function getSpawnOptions(meta, nodeVersion) {
   return opts;
 }
 async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PROJECT_SETTINGS_NODE_VERSION, config = {}, meta = {}, availableVersions = getAvailableNodeVersions()) {
+  if (config.bunVersion) {
+    return getSupportedBunVersion(config.bunVersion);
+  }
   const latestVersion = getLatestNodeVersion(availableVersions);
   if (meta.isDev) {
     latestVersion.runtime = "nodejs";
@@ -23595,7 +23638,7 @@ function checkIfAlreadyInstalled(runNpmInstallSet, packageJsonPath) {
   return { alreadyInstalled, runNpmInstallSet: initializedRunNpmInstallSet };
 }
 var runNpmInstallSema = new import_async_sema4.default(1);
-async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion, projectCreatedAt) {
+async function runNpmInstall(destPath, args = [], spawnOpts, meta, projectCreatedAt) {
   if (meta?.isDev) {
     debug("Skipping dependency installation because dev mode is enabled");
     return false;
@@ -23648,7 +23691,6 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, nodeVersion,
       cliType,
       lockfileVersion,
       packageJsonPackageManager,
-      nodeVersion,
       env,
       packageJsonEngines: packageJson?.engines,
       turboSupportsCorepackHome,
@@ -23675,7 +23717,6 @@ function getEnvForPackageManager({
   cliType,
   lockfileVersion,
   packageJsonPackageManager,
-  nodeVersion,
   env,
   packageJsonEngines,
   turboSupportsCorepackHome,
@@ -23694,7 +23735,6 @@ function getEnvForPackageManager({
     cliType,
     lockfileVersion,
     corepackPackageManager: packageJsonPackageManager,
-    nodeVersion,
     corepackEnabled,
     packageJsonEngines,
     projectCreatedAt
@@ -23988,15 +24028,13 @@ function detectPackageManager(cliType, lockfileVersion, projectCreatedAt) {
 function getPathForPackageManager({
   cliType,
   lockfileVersion,
-  nodeVersion,
   env
 }) {
   const corepackEnabled = env.ENABLE_EXPERIMENTAL_COREPACK === "1";
   let overrides = getPathOverrideForPackageManager({
     cliType,
     lockfileVersion,
-    corepackPackageManager: void 0,
-    nodeVersion
+    corepackPackageManager: void 0
   });
   if (corepackEnabled) {
     overrides = NO_OVERRIDE;
@@ -24022,7 +24060,6 @@ function getPathForPackageManager({
 async function runCustomInstallCommand({
   destPath,
   installCommand,
-  nodeVersion,
   spawnOpts,
   projectCreatedAt
 }) {
@@ -24038,7 +24075,6 @@ async function runCustomInstallCommand({
     cliType,
     lockfileVersion,
     packageJsonPackageManager,
-    nodeVersion,
     env: spawnOpts?.env || {},
     packageJsonEngines: packageJson?.engines,
     turboSupportsCorepackHome,
@@ -24075,7 +24111,6 @@ async function runPackageJsonScript(destPath, scriptNames, spawnOpts, projectCre
       cliType,
       lockfileVersion,
       packageJsonPackageManager,
-      nodeVersion: void 0,
       env: cloneEnv(process.env, spawnOpts?.env),
       packageJsonEngines: packageJson?.engines,
       turboSupportsCorepackHome,
@@ -24730,10 +24765,33 @@ ${entrypointsForMessage}`
     entrypointCallback
   };
 }
+
+// src/framework-helpers.ts
+var BACKEND_FRAMEWORKS = [
+  "express",
+  "hono",
+  "h3",
+  "nestjs",
+  "fastify"
+];
+function isBackendFramework(framework) {
+  if (!framework)
+    return false;
+  return BACKEND_FRAMEWORKS.includes(framework);
+}
+function isExperimentalBackendsEnabled() {
+  return process.env.VERCEL_EXPERIMENTAL_BACKENDS === "1" || // Previously used for experimental express and hono builds
+  process.env.VERCEL_EXPERIMENTAL_EXPRESS_BUILD === "1" || process.env.VERCEL_EXPERIMENTAL_HONO_BUILD === "1";
+}
+function shouldUseExperimentalBackends(framework) {
+  return isExperimentalBackendsEnabled() && isBackendFramework(framework);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BACKEND_FRAMEWORKS,
   BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP,
+  BunVersion,
   EdgeFunction,
   FileBlob,
   FileFsRef,
@@ -24774,12 +24832,16 @@ ${entrypointsForMessage}`
   getProvidedRuntime,
   getScriptName,
   getSpawnOptions,
+  getSupportedBunVersion,
   getSupportedNodeVersion,
   getWriteableDirectory,
   glob,
   hardLinkDir,
   installDependencies,
+  isBackendFramework,
+  isBunVersion,
   isDirectory,
+  isExperimentalBackendsEnabled,
   isSymbolicLink,
   normalizePath,
   readConfigFile,
@@ -24792,6 +24854,7 @@ ${entrypointsForMessage}`
   runShellScript,
   scanParentDirs,
   shouldServe,
+  shouldUseExperimentalBackends,
   spawnAsync,
   spawnCommand,
   streamToBuffer,

package/dist/types.d.ts

@@ -22,6 +22,7 @@ export interface Files {
     [filePath: string]: File;
 }
 export interface Config {
+    bunVersion?: string;
     maxLambdaSize?: string;
     includeFiles?: string | string[];
     excludeFiles?: string | string[];
@@ -318,6 +319,8 @@ export declare class Version implements BaseVersion {
 }
 export declare class NodeVersion extends Version {
 }
+export declare class BunVersion extends Version {
+}
 export interface Builder {
     use: string;
     src?: string;

package/dist/types.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var types_exports = {};
 __export(types_exports, {
+  BunVersion: () => BunVersion,
   NodeVersion: () => NodeVersion,
   Version: () => Version
 });
@@ -44,8 +45,11 @@ class Version {
 }
 class NodeVersion extends Version {
 }
+class BunVersion extends Version {
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BunVersion,
   NodeVersion,
   Version
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "12.1.3",
+  "version": "12.2.1",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -27,7 +27,7 @@
     "@types/semver": "6.0.0",
     "@types/yazl": "2.4.2",
     "@vercel/error-utils": "2.0.3",
-    "@vercel/routing-utils": "5.2.0",
+    "@vercel/routing-utils": "5.2.1",
     "aggregate-error": "3.0.1",
     "async-retry": "1.2.3",
     "async-sema": "2.1.4",