@vercel/build-utils 12.2.3 → 13.0.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @vercel/build-utils
 
+## 13.0.0
+
+### Major Changes
+
+- Remove getSpawnOptions ([#14176](https://github.com/vercel/vercel/pull/14176))
+
+## 12.2.4
+
+### Patch Changes
+
+- Add helper for detecting backend builders ([#14182](https://github.com/vercel/vercel/pull/14182))
+
 ## 12.2.3
 
 ### Patch Changes

package/dist/framework-helpers.d.ts

@@ -1,7 +1,9 @@
+import { Builder } from '.';
 /**
  * List of backend frameworks supported by the experimental backends feature
  */
 export declare const BACKEND_FRAMEWORKS: readonly ["express", "hono", "h3", "nestjs", "fastify", "elysia"];
+export declare const BACKEND_BUILDERS: readonly ["@vercel/express", "@vercel/hono", "@vercel/h3", "@vercel/nestjs", "@vercel/fastify", "@vercel/elysia"];
 export type BackendFramework = (typeof BACKEND_FRAMEWORKS)[number];
 /**
  * Checks if the given framework is a backend framework
@@ -11,6 +13,7 @@ export declare function isBackendFramework(framework: string | null | undefined)
  * Checks if experimental backends are enabled via environment variable
  */
 export declare function isExperimentalBackendsEnabled(): boolean;
+export declare function isBackendBuilder(builder: Builder | null | undefined): boolean;
 /**
  * Checks if experimental backends are enabled AND the framework is a backend framework
  */

package/dist/framework-helpers.js

@@ -18,7 +18,9 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var framework_helpers_exports = {};
 __export(framework_helpers_exports, {
+  BACKEND_BUILDERS: () => BACKEND_BUILDERS,
   BACKEND_FRAMEWORKS: () => BACKEND_FRAMEWORKS,
+  isBackendBuilder: () => isBackendBuilder,
   isBackendFramework: () => isBackendFramework,
   isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   shouldUseExperimentalBackends: () => shouldUseExperimentalBackends
@@ -32,6 +34,14 @@ const BACKEND_FRAMEWORKS = [
   "fastify",
   "elysia"
 ];
+const BACKEND_BUILDERS = [
+  "@vercel/express",
+  "@vercel/hono",
+  "@vercel/h3",
+  "@vercel/nestjs",
+  "@vercel/fastify",
+  "@vercel/elysia"
+];
 function isBackendFramework(framework) {
   if (!framework)
     return false;
@@ -41,12 +51,20 @@ 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 isBackendBuilder(builder) {
+  if (!builder)
+    return false;
+  const use = builder.use;
+  return BACKEND_BUILDERS.includes(use);
+}
 function shouldUseExperimentalBackends(framework) {
   return isExperimentalBackendsEnabled() && isBackendFramework(framework);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BACKEND_BUILDERS,
   BACKEND_FRAMEWORKS,
+  isBackendBuilder,
   isBackendFramework,
   isExperimentalBackendsEnabled,
   shouldUseExperimentalBackends

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

@@ -84,7 +84,6 @@ export declare function getNodeBinPath({ cwd, }: {
 }): Promise<string>;
 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 | BunVersion>;
 export declare function scanParentDirs(destPath: string, readPackageJson?: boolean, base?: string): Promise<ScanParentDirsResult>;
 export declare function turboVersionSpecifierSupportsCorepack(turboVersionSpecifier: string): boolean;

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

@@ -38,7 +38,6 @@ __export(run_user_scripts_exports, {
   getPathForPackageManager: () => getPathForPackageManager,
   getPathOverrideForPackageManager: () => getPathOverrideForPackageManager,
   getScriptName: () => getScriptName,
-  getSpawnOptions: () => getSpawnOptions,
   installDependencies: () => installDependencies,
   runBundleInstall: () => runBundleInstall,
   runCustomInstallCommand: () => runCustomInstallCommand,
@@ -178,30 +177,6 @@ async function runShellScript(fsPath, args = [], spawnOpts) {
   });
   return true;
 }
-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 || "";
-    const pathSegments = oldPath.split(import_path.default.delimiter).map((segment) => {
-      if (/^\/node[0-9]+\/bin/.test(segment)) {
-        found = true;
-        return `/node${nodeVersion.major}/bin`;
-      }
-      return segment;
-    });
-    if (!found) {
-      pathSegments.unshift(`/node${nodeVersion.major}/bin`);
-    }
-    opts.env.PATH = pathSegments.filter(Boolean).join(import_path.default.delimiter);
-  }
-  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);
@@ -1069,7 +1044,6 @@ const installDependencies = (0, import_util.deprecate)(
   getPathForPackageManager,
   getPathOverrideForPackageManager,
   getScriptName,
-  getSpawnOptions,
   installDependencies,
   runBundleInstall,
   runCustomInstallCommand,

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, 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, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, detectPackageManager, getNodeBinPath, getNodeBinPaths, scanParentDirs, 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, 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, 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,4 +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';
+export { BACKEND_FRAMEWORKS, BackendFramework, isBackendFramework, isBackendBuilder, isExperimentalBackendsEnabled, shouldUseExperimentalBackends, } from './framework-helpers';

package/dist/index.js

@@ -21860,13 +21860,13 @@ __export(src_exports, {
   getPrettyError: () => getPrettyError,
   getProvidedRuntime: () => getProvidedRuntime,
   getScriptName: () => getScriptName,
-  getSpawnOptions: () => getSpawnOptions,
   getSupportedBunVersion: () => getSupportedBunVersion,
   getSupportedNodeVersion: () => getSupportedNodeVersion,
   getWriteableDirectory: () => getWritableDirectory,
   glob: () => glob,
   hardLinkDir: () => hardLinkDir,
   installDependencies: () => installDependencies,
+  isBackendBuilder: () => isBackendBuilder,
   isBackendFramework: () => isBackendFramework,
   isBunVersion: () => isBunVersion,
   isDirectory: () => isDirectory,
@@ -23300,30 +23300,6 @@ async function runShellScript(fsPath, args = [], spawnOpts) {
   });
   return true;
 }
-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 || "";
-    const pathSegments = oldPath.split(import_path5.default.delimiter).map((segment) => {
-      if (/^\/node[0-9]+\/bin/.test(segment)) {
-        found = true;
-        return `/node${nodeVersion.major}/bin`;
-      }
-      return segment;
-    });
-    if (!found) {
-      pathSegments.unshift(`/node${nodeVersion.major}/bin`);
-    }
-    opts.env.PATH = pathSegments.filter(Boolean).join(import_path5.default.delimiter);
-  }
-  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);
@@ -24785,6 +24761,14 @@ var BACKEND_FRAMEWORKS = [
   "fastify",
   "elysia"
 ];
+var BACKEND_BUILDERS = [
+  "@vercel/express",
+  "@vercel/hono",
+  "@vercel/h3",
+  "@vercel/nestjs",
+  "@vercel/fastify",
+  "@vercel/elysia"
+];
 function isBackendFramework(framework) {
   if (!framework)
     return false;
@@ -24794,6 +24778,12 @@ 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 isBackendBuilder(builder) {
+  if (!builder)
+    return false;
+  const use = builder.use;
+  return BACKEND_BUILDERS.includes(use);
+}
 function shouldUseExperimentalBackends(framework) {
   return isExperimentalBackendsEnabled() && isBackendFramework(framework);
 }
@@ -24842,13 +24832,13 @@ function shouldUseExperimentalBackends(framework) {
   getPrettyError,
   getProvidedRuntime,
   getScriptName,
-  getSpawnOptions,
   getSupportedBunVersion,
   getSupportedNodeVersion,
   getWriteableDirectory,
   glob,
   hardLinkDir,
   installDependencies,
+  isBackendBuilder,
   isBackendFramework,
   isBunVersion,
   isDirectory,

package/package.json

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