@vercel/build-utils 13.2.12 → 13.2.14

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @vercel/build-utils
 
+## 13.2.14
+
+### Patch Changes
+
+- Add `experimentalServices` to `vercel.json` ([#14612](https://github.com/vercel/vercel/pull/14612))
+
+## 13.2.13
+
+### Patch Changes
+
+- [python] experimental python runtime framework preset ([#14646](https://github.com/vercel/vercel/pull/14646))
+
 ## 13.2.12
 
 ### 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/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

@@ -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';
@@ -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,
@@ -23774,6 +23775,7 @@ __export(src_exports, {
   isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled: () => isExperimentalBackendsWithoutIntrospectionEnabled,
   isPythonEntrypoint: () => isPythonEntrypoint,
+  isPythonFramework: () => isPythonFramework,
   isSymbolicLink: () => isSymbolicLink,
   normalizePath: () => normalizePath,
   readConfigFile: () => readConfigFile,
@@ -26112,15 +26114,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) {
@@ -26745,6 +26753,12 @@ var BACKEND_FRAMEWORKS = [
   "fastify",
   "elysia"
 ];
+var PYTHON_FRAMEWORKS = [
+  "fastapi",
+  "flask",
+  "python"
+  // Generic Python framework preset
+];
 var BACKEND_BUILDERS = [
   "@vercel/express",
   "@vercel/hono",
@@ -26759,6 +26773,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";
 }
@@ -26837,6 +26856,7 @@ async function isPythonEntrypoint(file) {
   NodeVersion,
   NodejsLambda,
   NowBuildError,
+  PYTHON_FRAMEWORKS,
   Prerender,
   Span,
   Version,
@@ -26883,6 +26903,7 @@ async function isPythonEntrypoint(file) {
   isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled,
   isPythonEntrypoint,
+  isPythonFramework,
   isSymbolicLink,
   normalizePath,
   readConfigFile,

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.12",
+  "version": "13.2.14",
   "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",
@@ -47,8 +47,8 @@
     "yazl": "2.5.1",
     "vitest": "2.0.1",
     "json5": "2.2.3",
-    "@vercel/error-utils": "2.0.3",
-    "@vercel/routing-utils": "5.3.2"
+    "@vercel/routing-utils": "5.3.2",
+    "@vercel/error-utils": "2.0.3"
   },
   "scripts": {
     "build": "node build.mjs",