@vercel/build-utils 13.2.13 → 13.2.15

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @vercel/build-utils
 
+## 13.2.15
+
+### Patch Changes
+
+- Optimize `getAvailableNodeVersions` to skip discontinued versions and use non-throwing `statSync` ([#14686](https://github.com/vercel/vercel/pull/14686))
+
+## 13.2.14
+
+### Patch Changes
+
+- Add `experimentalServices` to `vercel.json` ([#14612](https://github.com/vercel/vercel/pull/14612))
+
 ## 13.2.13
 
 ### Patch Changes

package/dist/file-blob.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { FileBase } from './types';
 interface FileBlobOptions {
     mode?: number;

package/dist/fs/node-version.js

@@ -111,14 +111,11 @@ function getOptions() {
   return NODE_VERSIONS;
 }
 function isNodeVersionAvailable(version) {
-  try {
-    return (0, import_fs.statSync)(`/node${version.major}`).isDirectory();
-  } catch {
-  }
-  return false;
+  const stat = (0, import_fs.statSync)(`/node${version.major}`, { throwIfNoEntry: false });
+  return stat?.isDirectory() ?? false;
 }
 function getAvailableNodeVersions() {
-  return getOptions().filter(isNodeVersionAvailable).map((n) => n.major);
+  return getOptions().filter((v) => v.major >= 18).filter(isNodeVersionAvailable).map((n) => n.major);
 }
 function getHint(isAuto = false, availableVersions) {
   const { major, range } = getLatestNodeVersion(availableVersions);
@@ -153,7 +150,7 @@ async function getSupportedNodeVersion(engineRange, isAuto = false, availableVer
       throw new import_errors.NowBuildError({
         code: "BUILD_UTILS_NODE_VERSION_INVALID",
         link: "https://vercel.link/node-version",
-        message: `Found invalid Node.js Version: "${engineRange}". ${getHint(
+        message: `Found invalid or discontinued Node.js Version: "${engineRange}". ${getHint(
           isAuto,
           availableVersions
         )}`

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

@@ -211,7 +211,17 @@ export declare function runCustomInstallCommand({ destPath, installCommand, spaw
 }): 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 type PipInstallResult = {
+    installed: false;
+} | {
+    installed: true;
+    /**
+     * The directory where packages were installed.
+     * Add this to PYTHONPATH when running Python commands.
+     */
+    targetDir: string;
+};
+export declare function runPipInstall(destPath: string, args?: string[], spawnOpts?: SpawnOptions, meta?: Meta): Promise<PipInstallResult>;
 export declare function getScriptName(pkg: Pick<PackageJson, 'scripts'> | null | undefined, possibleNames: Iterable<string>): string | undefined;
 /**
  * @deprecate installDependencies() is deprecated.

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

@@ -1073,15 +1073,21 @@ async function runBundleInstall(destPath, args = [], spawnOpts, meta) {
 async function runPipInstall(destPath, args = [], spawnOpts, meta) {
   if (meta && meta.isDev) {
     (0, import_debug.default)("Skipping dependency installation because dev mode is enabled");
-    return;
+    return { installed: false };
   }
   (0, import_assert.default)(import_path.default.isAbsolute(destPath));
-  const opts = { ...spawnOpts, cwd: destPath, prettyCommand: "pip3 install" };
+  const targetDir = import_path.default.join(destPath, ".vercel_python_packages");
+  const opts = {
+    ...spawnOpts,
+    cwd: destPath,
+    prettyCommand: "uv pip install"
+  };
   await spawnAsync(
-    "pip3",
-    ["install", "--disable-pip-version-check", ...args],
+    "uv",
+    ["pip", "install", "--target", targetDir, ...args],
     opts
   );
+  return { installed: true, targetDir };
 }
 function getScriptName(pkg, possibleNames) {
   if (pkg?.scripts) {

package/dist/fs/stream-to-buffer.d.ts

@@ -1,3 +1,4 @@
 /// <reference types="node" />
+/// <reference types="node" />
 export default function streamToBuffer(stream: NodeJS.ReadableStream): Promise<Buffer>;
 export declare function streamToBufferChunks(stream: NodeJS.ReadableStream, chunkSize?: number): Promise<Buffer[]>;

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, findPackageJson, 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, PipInstallResult } 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, findPackageJson, 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, PipInstallResult, 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

@@ -24940,14 +24940,11 @@ function getOptions() {
   return NODE_VERSIONS;
 }
 function isNodeVersionAvailable(version) {
-  try {
-    return (0, import_fs.statSync)(`/node${version.major}`).isDirectory();
-  } catch {
-  }
-  return false;
+  const stat = (0, import_fs.statSync)(`/node${version.major}`, { throwIfNoEntry: false });
+  return stat?.isDirectory() ?? false;
 }
 function getAvailableNodeVersions() {
-  return getOptions().filter(isNodeVersionAvailable).map((n) => n.major);
+  return getOptions().filter((v) => v.major >= 18).filter(isNodeVersionAvailable).map((n) => n.major);
 }
 function getHint(isAuto = false, availableVersions) {
   const { major, range } = getLatestNodeVersion(availableVersions);
@@ -24982,7 +24979,7 @@ async function getSupportedNodeVersion(engineRange, isAuto = false, availableVer
       throw new NowBuildError({
         code: "BUILD_UTILS_NODE_VERSION_INVALID",
         link: "https://vercel.link/node-version",
-        message: `Found invalid Node.js Version: "${engineRange}". ${getHint(
+        message: `Found invalid or discontinued Node.js Version: "${engineRange}". ${getHint(
           isAuto,
           availableVersions
         )}`
@@ -26114,15 +26111,21 @@ async function runBundleInstall(destPath, args = [], spawnOpts, meta) {
 async function runPipInstall(destPath, args = [], spawnOpts, meta) {
   if (meta && meta.isDev) {
     debug("Skipping dependency installation because dev mode is enabled");
-    return;
+    return { installed: false };
   }
   (0, import_assert6.default)(import_path6.default.isAbsolute(destPath));
-  const opts = { ...spawnOpts, cwd: destPath, prettyCommand: "pip3 install" };
+  const targetDir = import_path6.default.join(destPath, ".vercel_python_packages");
+  const opts = {
+    ...spawnOpts,
+    cwd: destPath,
+    prettyCommand: "uv pip install"
+  };
   await spawnAsync(
-    "pip3",
-    ["install", "--disable-pip-version-check", ...args],
+    "uv",
+    ["pip", "install", "--target", targetDir, ...args],
     opts
   );
+  return { installed: true, targetDir };
 }
 function getScriptName(pkg, possibleNames) {
   if (pkg?.scripts) {

package/dist/types.d.ts

@@ -549,3 +549,57 @@ export interface TriggerEvent {
      */
     initialDelaySeconds?: number;
 }
+export type ServiceRuntime = 'node' | 'python' | 'go' | 'rust' | 'ruby';
+export type ServiceType = 'web' | 'cron' | 'worker';
+/**
+ * Configuration for a service in vercel.json.
+ * @experimental This feature is experimental and may change.
+ */
+export interface ExperimentalServiceConfig {
+    type?: ServiceType;
+    /**
+     * Entry file for the service, relative to the workspace directory.
+     * @example "src/index.ts", "main.py", "api/server.go"
+     */
+    entrypoint?: string;
+    /**
+     * Path to the directory containing the service's manifest file
+     * (package.json, pyproject.toml, etc.).
+     * Defaults to "." (project root) if not specified.
+     */
+    workspace?: string;
+    /** Framework to use */
+    framework?: string;
+    /** Builder to use, e.g. @vercel/node, @vercel/python */
+    builder?: string;
+    /** Specific lambda runtime to use, e.g. nodejs24.x, python3.14 */
+    runtime?: string;
+    buildCommand?: string;
+    installCommand?: string;
+    /** Lambda config */
+    memory?: number;
+    maxDuration?: number;
+    includeFiles?: string | string[];
+    excludeFiles?: string | string[];
+    /** URL prefix for routing */
+    routePrefix?: string;
+    /** Cron schedule expression (e.g., "0 0 * * *") */
+    schedule?: string;
+    topic?: string;
+    consumer?: string;
+}
+/**
+ * Map of service name to service configuration.
+ * @experimental This feature is experimental and may change.
+ */
+export type ExperimentalServices = Record<string, ExperimentalServiceConfig>;
+/**
+ * Map of service group name to array of service names belonging to that group.
+ * @experimental This feature is experimental and may change.
+ * @example
+ * {
+ *   "app": ["site", "backend"],
+ *   "admin": ["admin", "backend"]
+ * }
+ */
+export type ExperimentalServiceGroups = Record<string, string[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.2.13",
+  "version": "13.2.15",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -22,7 +22,7 @@
     "@types/minimatch": "^5.1.2",
     "@types/ms": "0.7.31",
     "@types/multistream": "2.1.1",
-    "@types/node": "14.18.33",
+    "@types/node": "20.11.0",
     "@types/node-fetch": "^2.1.6",
     "@types/semver": "6.0.0",
     "@types/yazl": "2.4.2",