@vercel/build-utils 13.31.1 → 13.32.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @vercel/build-utils
 
+## 13.32.0
+
+### Minor Changes
+
+- 9fb2976: Add `services` as the canonical multi-service project configuration and keep `experimentalServicesV2` as a deprecated backwards-compatible alias.
+
+### Patch Changes
+
+- 186014d: Add an experimental container service runtime. A service with
+  `runtime: "container"` either builds its `Dockerfile`/`Containerfile` and pushes
+  the resulting OCI image to the Vercel Container Registry (VCR), or passes a
+  prebuilt image reference through as build output.
+
+  - **`@vercel/container`** (new builder): authenticates to VCR with the project's
+    `VERCEL_OIDC_TOKEN`, ensures the repository exists, builds and pushes the
+    image, and emits a digest-pinned reference in `handler` (container functions
+    are `type: "Lambda"` with `runtime: "container"`; the platform surfaces
+    `handler` as the image downstream). Uses `docker` on developer machines and
+    `buildah` (daemonless) in the Vercel build container behind a shared
+    `ContainerEngine` interface. Supports `vc dev` via `startDevServer` (local
+    build/run, env parity, log forwarding) and `prepareCache` for buildah layer
+    reuse between builds. Build flow is instrumented with tracing spans
+    (non-secret diagnostics) and debug logging gated on `BUILDER_DEBUG`.
+  - **`@vercel/build-utils`**: add the `ContainerImage` build-output type.
+  - **`@vercel/fs-detectors`**: resolve container services from `vercel.json`
+    (the `services` config and its deprecated `experimentalServices` /
+    `experimentalServicesV2` aliases). A `Dockerfile`, `Containerfile`, or
+    `*.dockerfile` entrypoint triggers a build; any other entrypoint is treated as
+    a prebuilt OCI image reference.
+  - **`vercel`**: wire container output into `vercel build` result writing and
+    config validation.
+
+  Buildah specifics in the build container: host networking for `RUN` steps,
+  native `overlay` storage on the XFS `/vercel` volume (deferring to the image's
+  `storage.conf`), zstd push compression, and registry credentials read from the
+  provisioned auth file when present. Several knobs are available for debugging:
+  `VERCEL_CONTAINER_ENGINE`, `VERCEL_VCR_STRICT_STORAGE`,
+  `VERCEL_VCR_DISABLE_LAYER_CACHE`, and `VERCEL_VCR_FORCE_LOGIN`.
+
+- cb0988f: Set the Node.js 20 discontinuation date to October 1, 2026.
+
 ## 13.31.1
 
 ### Patch Changes

package/dist/container-image.d.ts

@@ -0,0 +1,22 @@
+import type { Env, Files } from './types';
+export interface ContainerImageConfig {
+    /**
+     * The OCI image reference (e.g. `vcr.vercel.com/team/project/svc@sha256:...`).
+     * Carried in `handler` per the build-output contract; api-builds surfaces it
+     * as `image` downstream (see vercel/api#76729).
+     */
+    handler: string;
+    runtime: 'container';
+    command?: string[];
+    environment?: Env;
+}
+export declare class ContainerImage {
+    type: 'ContainerImage';
+    files: Files;
+    /** The OCI image reference, carried in `handler` (see ContainerImageConfig). */
+    handler: string;
+    runtime: 'container';
+    command?: string[];
+    environment: Env;
+    constructor(params: Omit<ContainerImage, 'type'>);
+}

package/dist/container-image.js

@@ -0,0 +1,37 @@
+"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 container_image_exports = {};
+__export(container_image_exports, {
+  ContainerImage: () => ContainerImage
+});
+module.exports = __toCommonJS(container_image_exports);
+class ContainerImage {
+  constructor(params) {
+    this.type = "ContainerImage";
+    this.files = params.files;
+    this.handler = params.handler;
+    this.runtime = params.runtime;
+    this.command = params.command;
+    this.environment = params.environment;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContainerImage
+});

package/dist/deserialize/serialized-types.d.ts

@@ -1,6 +1,7 @@
 import type { Lambda } from '../lambda';
 import type { NodejsLambda } from '../nodejs-lambda';
 import type { EdgeFunction } from '../edge-function';
+import type { ContainerImage } from '../container-image';
 import type FileFsRef from '../file-fs-ref';
 import type { Prerender } from '../prerender';
 /**
@@ -25,4 +26,7 @@ export type SerializedPrerender = Properties<Omit<Prerender, 'lambda' | 'fallbac
     fallback: SerializedFileFsRef | null;
 };
 export type SerializedEdgeFunction = Properties<Omit<EdgeFunction, 'name' | 'files' | 'deploymentTarget'>> & FilesMapProp;
+export type SerializedContainerImage = Omit<Properties<ContainerImage>, 'files' | 'type'> & {
+    type?: 'ContainerImage';
+} & FilesMapProp;
 export {};

package/dist/fs/node-version.js

@@ -58,7 +58,8 @@ const NODE_VERSIONS = [
   new import_types.NodeVersion({
     major: 20,
     range: "20.x",
-    runtime: "nodejs20.x"
+    runtime: "nodejs20.x",
+    discontinueDate: /* @__PURE__ */ new Date("2026-10-01")
   }),
   new import_types.NodeVersion({
     major: 18,

package/dist/index.d.ts

@@ -22,6 +22,8 @@ import { validateNpmrc } from './validate-npmrc';
 export type { NodejsLambdaOptions };
 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, NpmInstallOutput, runBundleInstall, runPipInstall, PipInstallResult, runShellScript, runCustomInstallCommand, resetCustomInstallCommandSet, getEnvForPackageManager, getNodeVersion, getPathForPackageManager, getLatestNodeVersion, getDiscontinuedNodeVersions, getSpawnOptions, getPlatformEnv, getPrefixedEnvVars, getServiceUrlEnvVars, getExperimentalServiceUrlEnvVars, streamToBuffer, streamToBufferChunks, debug, isSymbolicLink, isDirectory, isExternalSymlink, isExternalSymlinkTarget, getSymlinkTarget, getLambdaOptionsFromFunction, sanitizeConsumerName, scanParentDirs, findPackageJson, getIgnoreFilter, cloneEnv, hardLinkDir, traverseUpDirectories, validateNpmrc, type CliType, };
 export { EdgeFunction } from './edge-function';
+export { ContainerImage } from './container-image';
+export type { ContainerImageConfig } from './container-image';
 export { readConfigFile, getPackageJson } from './fs/read-config-file';
 export { normalizePath } from './fs/normalize-path';
 export { getOsRelease, getProvidedRuntime } from './os';

package/dist/index.js

@@ -34510,6 +34510,7 @@ __export(src_exports, {
   BUILDER_INSTALLER_STEP: () => BUILDER_INSTALLER_STEP,
   BUILDER_PRE_DEPLOY_STEP: () => BUILDER_PRE_DEPLOY_STEP,
   BunVersion: () => BunVersion,
+  ContainerImage: () => ContainerImage,
   DEFAULT_MAX_DURATION_LIMIT: () => DEFAULT_MAX_DURATION_LIMIT,
   ENV_WRAPPER_SUPPORTED_FAMILIES: () => ENV_WRAPPER_SUPPORTED_FAMILIES,
   EdgeFunction: () => EdgeFunction,
@@ -35953,7 +35954,8 @@ var NODE_VERSIONS = [
   new NodeVersion({
     major: 20,
     range: "20.x",
-    runtime: "nodejs20.x"
+    runtime: "nodejs20.x",
+    discontinueDate: /* @__PURE__ */ new Date("2026-10-01")
   }),
   new NodeVersion({
     major: 18,
@@ -38259,6 +38261,18 @@ var EdgeFunction = class {
   }
 };
 
+// src/container-image.ts
+var ContainerImage = class {
+  constructor(params) {
+    this.type = "ContainerImage";
+    this.files = params.files;
+    this.handler = params.handler;
+    this.runtime = params.runtime;
+    this.command = params.command;
+    this.environment = params.environment;
+  }
+};
+
 // src/os.ts
 var import_fs_extra9 = __toESM(require_lib());
 var import_error_utils2 = __toESM(require_dist());
@@ -40796,6 +40810,7 @@ function getExtendedPayload({
   BUILDER_INSTALLER_STEP,
   BUILDER_PRE_DEPLOY_STEP,
   BunVersion,
+  ContainerImage,
   DEFAULT_MAX_DURATION_LIMIT,
   ENV_WRAPPER_SUPPORTED_FAMILIES,
   EdgeFunction,

package/dist/types.d.ts

@@ -4,6 +4,7 @@ import type FileBlob from './file-blob';
 import type { Lambda, LambdaArchitecture } from './lambda';
 import type { Prerender } from './prerender';
 import type { EdgeFunction } from './edge-function';
+import type { ContainerImage } from './container-image';
 import type { Span } from './trace';
 import type { HasField, Route, Rewrite, Redirect, Header } from '@vercel/routing-utils';
 export interface Env {
@@ -546,6 +547,8 @@ export interface ExperimentalServiceV2 {
     runtime?: string;
     /** Resolved entrypoint, relative to the service root. */
     entrypoint?: string;
+    /** Command override for `runtime: "container"` services. */
+    command?: string[];
     /** Builder selected by the resolver. */
     builder: Builder;
     installCommand?: string;
@@ -610,7 +613,7 @@ export interface BuildResultV2Typical {
     routes?: any[];
     images?: Images;
     output: {
-        [key: string]: File | Lambda | Prerender | EdgeFunction;
+        [key: string]: File | Lambda | Prerender | EdgeFunction | ContainerImage;
     };
     wildcard?: Array<{
         domain: string;
@@ -744,7 +747,7 @@ export interface TriggerEvent extends TriggerEventBase {
     /** Name of the consumer group for this trigger (always present in processed output) */
     consumer: string;
 }
-export type ServiceRuntime = 'node' | 'python' | 'go' | 'rust' | 'ruby';
+export type ServiceRuntime = 'node' | 'python' | 'go' | 'rust' | 'ruby' | 'container';
 export type ServiceType = 'web' | 'cron' | 'worker' | 'job';
 export interface ExperimentalServiceMount {
     /** URL path prefix where the service is mounted. */
@@ -780,8 +783,10 @@ export interface ExperimentalServiceConfig {
     framework?: string;
     /** Builder to use, e.g. @vercel/node, @vercel/python */
     builder?: string;
-    /** Specific lambda runtime to use, e.g. nodejs24.x, python3.14 */
+    /** Specific lambda runtime to use, e.g. nodejs24.x, python3.14, container */
     runtime?: string;
+    /** Optional command override for container image services. */
+    command?: string | string[];
     workspace?: string;
     buildCommand?: string;
     installCommand?: string;
@@ -817,22 +822,18 @@ export type ExperimentalServices = Record<string, ExperimentalServiceConfig>;
  * }
  */
 export type ExperimentalServiceGroups = Record<string, string[]>;
-export interface ExperimentalServiceV2Binding {
+export interface ServiceBinding {
     /** Must be `"service"` for Service-to-Service HTTP bindings. */
     type: 'service';
-    /** Target service name from `experimentalServicesV2`. */
+    /** Target service name from `services`. */
     service: string;
     /** Generated value shape, must be `"url"`. */
     format: 'url';
     /** Environment variable name that will store the generated value */
     env: string;
 }
-/**
- * Configuration for a service in `experimentalServicesV2` in `vercel.json`.
- *
- * @experimental This feature is experimental and may change.
- */
-export interface ExperimentalServiceV2Config {
+/** Configuration for a service in `vercel.json#services`. */
+export interface ServiceConfig {
     /** Path to the service root, relative to `vercel.json`. */
     root: string;
     /** Framework for this service. */
@@ -842,15 +843,19 @@ export interface ExperimentalServiceV2Config {
     /**
      * Service entrypoint, relative to the service root directory.
      * Can be a file path or a module specification (for Python).
+     * For `runtime: "container"`, a Dockerfile path (built & pushed) or a
+     * prebuilt OCI image reference.
      */
     entrypoint?: string;
+    /** Command override for `runtime: "container"` services. */
+    command?: string | string[];
     installCommand?: string;
     buildCommand?: string;
     devCommand?: string;
     ignoreCommand?: string;
     outputDirectory?: string;
     /** Caller-side bindings that grant this service access to another service. */
-    bindings?: ExperimentalServiceV2Binding[];
+    bindings?: ServiceBinding[];
     /** Function configuration scoped to this service root. */
     functions?: BuilderFunctions;
     headers?: Header[];
@@ -860,12 +865,14 @@ export interface ExperimentalServiceV2Config {
     cleanUrls?: boolean;
     trailingSlash?: boolean;
 }
-/**
- * Map of service name to service configuration for `experimentalServicesV2`.
- *
- * @experimental This feature is experimental and may change.
- */
-export type ExperimentalServicesV2 = Record<string, ExperimentalServiceV2Config>;
+/** Map of service name to service configuration for `vercel.json#services`. */
+export type Services = Record<string, ServiceConfig>;
+/** @deprecated Use `ServiceBinding` instead. */
+export type ExperimentalServiceV2Binding = ServiceBinding;
+/** @deprecated Use `ServiceConfig` instead. */
+export type ExperimentalServiceV2Config = ServiceConfig;
+/** @deprecated Use `Services` instead. */
+export type ExperimentalServicesV2 = Services;
 /**
  * Result of a runtime builder's normalized entrypoint detection.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.31.1",
+  "version": "13.32.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -55,8 +55,8 @@
     "vitest": "2.0.1",
     "typescript": "4.9.5",
     "yazl": "2.5.1",
-    "@vercel/error-utils": "2.2.0",
-    "@vercel/routing-utils": "6.3.1"
+    "@vercel/routing-utils": "6.3.1",
+    "@vercel/error-utils": "2.2.0"
   },
   "scripts": {
     "build": "node build.mjs",