@vercel/build-utils 13.36.3 → 14.0.2

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # @vercel/build-utils
 
+## 14.0.2
+
+### Patch Changes
+
+- b7ec19b: Scope the pre-compilation install's `VERCEL_INSTALL_COMPLETED` marker to the `package.json` it installed. Previously, a `vercel.toml`/`vercel.ts` config caused `vc build` to install at the repo root and then silently skip every later default install, so services whose install root is a different workspace (its own `package.json`/lockfile) built without dependencies.
+
+## 14.0.1
+
+### Patch Changes
+
+- 6d7fbfa: Bump all workspace packages to trigger a full publish from vercel-internal.
+- Updated dependencies [6d7fbfa]
+  - @vercel/python-analysis@0.13.1
+
+## 14.0.0
+
+### Major Changes
+
+- 5c33351: Remove `getOsRelease()`, and stop deriving the provided runtime from the build host.
+
+  `getProvidedRuntime()` is retained and now always resolves to `'provided.al2023'`. It previously read `/etc/os-release` and returned `'provided.al2'` on Amazon Linux 2 hosts, so the emitted runtime depended on where the build ran — a `vercel build` on an AL2 machine produced output that is rejected at deploy time, because `provided.al2` is no longer an accepted Lambda runtime. Custom runtimes calling `getProvidedRuntime()` need no changes and are fixed by this release.
+
+  `getOsRelease()` is removed with no replacement.
+
+  `validateBuildResult()` no longer accepts an `osRelease` option. Its runtime allowlist check was previously skipped unless the caller passed `osRelease.VERSION === '2023'`; it now always runs.
+
+### Minor Changes
+
+- b747ab4: Replace the inferred PPR fields on `Prerender` with the Next.js prerender taxonomy.
+
+  `hasPostponed`, `hasFallback`, `isDynamicRoute` and `htmlSize` were derived by
+  `@vercel/next` from build artifacts (the `.meta` postponed state, which manifest
+  section a route came from, and a `statSync` of the `.html` shell). Next.js
+  `>= 16.3.0-canary.96` publishes its own classification in the prerender
+  manifest, so those four fields are removed in favour of a single optional
+  `prerenderClassification` on `Prerender` / `PrerenderOptions`:
+
+  - `routeType` — `'route' | 'page' | 'shell' | 'fallback'`
+  - `response` — `'empty' | 'initial' | 'complete'`
+  - `compute` — `'blocking' | 'resuming' | 'static'`
+  - `htmlSize` — byte size of the prerendered HTML shell, when the entry has one
+
+  The values are carried through unvalidated so a taxonomy value added by a future
+  Next.js release cannot hard-fail a deploy. `@vercel/next` sets the field only
+  when Next.js supplied the complete group — absence is legitimate for
+  `notFoundRoutes` and Pages Router `fallback: false` templates — and only on the
+  primary output of each prerender group, so a route is classified exactly once.
+
+- 5619873: Fix api dir builds receiving incorrect framework or runtime.
+
+### Patch Changes
+
+- Updated dependencies [08a2618]
+  - @vercel/python-analysis@0.13.0
+
 ## 13.36.3
 
 ### Patch Changes

package/dist/collect-build-result/validate-build-result.d.ts

@@ -9,13 +9,11 @@ export interface ValidateBuildResultParams {
     allowInvalidRuntime?: boolean;
     buildConfig?: BuildConfigWithVercelConfig;
     buildResponse: BuildResultV2Typical | BuildResultV3;
-    osRelease?: OsRelease | null;
     vercelBaseUrl?: string;
 }
 export interface ValidateBuildResultResult {
     buildOutputMap: BuildResultV2Typical['output'];
     customFunctionConfiguration?: BuilderFunctions[string];
 }
-type OsRelease = Record<string, string>;
-export declare function validateBuildResult({ allowInvalidRuntime, buildConfig, buildResponse, osRelease, vercelBaseUrl, }: ValidateBuildResultParams): Promise<ValidateBuildResultResult>;
+export declare function validateBuildResult({ allowInvalidRuntime, buildConfig, buildResponse, vercelBaseUrl, }: ValidateBuildResultParams): Promise<ValidateBuildResultResult>;
 export {};

package/dist/collect-build-result/validate-build-result.js

@@ -55,7 +55,6 @@ async function validateBuildResult({
   allowInvalidRuntime = false,
   buildConfig,
   buildResponse,
-  osRelease,
   vercelBaseUrl
 }) {
   if (!("output" in buildResponse)) {
@@ -71,33 +70,31 @@ async function validateBuildResult({
     });
   }
   const buildOutputMap = getAndVerifyOutputLambdasOrEdgeFuncs(buildResponse);
-  if (osRelease?.VERSION === "2023") {
-    const invalidRuntimes = [];
-    for (const [name, entry] of Object.entries(buildOutputMap)) {
-      let lambda;
-      if (entry.type === "Prerender") {
-        lambda = entry.lambda;
-      } else if (entry.type === "Lambda") {
-        lambda = entry;
-      }
-      if (!lambda)
-        continue;
-      if (!isSupportedAl2023Runtime(lambda.runtime)) {
-        invalidRuntimes.push({ name, lambda });
-      }
+  const invalidRuntimes = [];
+  for (const [name, entry] of Object.entries(buildOutputMap)) {
+    let lambda;
+    if (entry.type === "Prerender") {
+      lambda = entry.lambda;
+    } else if (entry.type === "Lambda") {
+      lambda = entry;
     }
-    if (invalidRuntimes.length > 0 && !allowInvalidRuntime) {
-      throw new import_errors.NowBuildError({
-        code: "NOW_SANDBOX_WORKER_INVALID_RUNTIME",
-        message: `The following Serverless Functions contain an invalid "runtime":
-${invalidRuntimes.map(({ name, lambda }) => `  - ${name} (${lambda.runtime})`).join("\n")}`,
-        link: getVercelUrl(
-          "/docs/functions/runtimes#official-runtimes",
-          vercelBaseUrl
-        )
-      });
+    if (!lambda)
+      continue;
+    if (!isSupportedAl2023Runtime(lambda.runtime)) {
+      invalidRuntimes.push({ name, lambda });
     }
   }
+  if (invalidRuntimes.length > 0 && !allowInvalidRuntime) {
+    throw new import_errors.NowBuildError({
+      code: "NOW_SANDBOX_WORKER_INVALID_RUNTIME",
+      message: `The following Serverless Functions contain an invalid "runtime":
+${invalidRuntimes.map(({ name, lambda }) => `  - ${name} (${lambda.runtime})`).join("\n")}`,
+      link: getVercelUrl(
+        "/docs/functions/runtimes#official-runtimes",
+        vercelBaseUrl
+      )
+    });
+  }
   const customFunctionConfiguration = getCustomFunctionConfigMaybe(buildConfig);
   if (customFunctionConfiguration?.runtime) {
     throw new import_errors.NowBuildError({

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

@@ -592,6 +592,16 @@ function checkIfAlreadyInstalled(runNpmInstallSet, packageJsonPath) {
   return { alreadyInstalled, runNpmInstallSet: initializedRunNpmInstallSet };
 }
 const runNpmInstallSema = new import_async_sema.default(1);
+function installCompletedCovers(packageJsonPath) {
+  if (process.env.VERCEL_INSTALL_COMPLETED !== "1") {
+    return false;
+  }
+  const completedPath = process.env.VERCEL_INSTALL_COMPLETED_PATH;
+  if (!completedPath) {
+    return true;
+  }
+  return packageJsonPath !== void 0 && import_path.default.normalize(completedPath) === import_path.default.normalize(packageJsonPath);
+}
 let customInstallCommandSet;
 function resetCustomInstallCommandSet() {
   customInstallCommandSet = void 0;
@@ -627,7 +637,7 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, projectCreate
       if (alreadyInstalled) {
         return false;
       }
-      if (process.env.VERCEL_INSTALL_COMPLETED === "1") {
+      if (installCompletedCovers(packageJsonPath)) {
         (0, import_debug.default)(
           `Skipping dependency installation for ${packageJsonPath} because VERCEL_INSTALL_COMPLETED is set`
         );
@@ -1041,20 +1051,21 @@ async function runCustomInstallCommand({
     );
     return false;
   }
-  if (process.env.VERCEL_INSTALL_COMPLETED === "1") {
-    (0, import_debug.default)(
-      `Skipping custom install command for ${normalizedPath} because VERCEL_INSTALL_COMPLETED is set`
-    );
-    return false;
-  }
-  console.log(`Running "install" command: \`${installCommand}\`...`);
   const {
     cliType,
     lockfileVersion,
     packageJson,
+    packageJsonPath,
     packageJsonPackageManager,
     turboSupportsCorepackHome
   } = await scanParentDirs(destPath, true);
+  if (installCompletedCovers(packageJsonPath)) {
+    (0, import_debug.default)(
+      `Skipping custom install command for ${normalizedPath} because VERCEL_INSTALL_COMPLETED is set`
+    );
+    return false;
+  }
+  console.log(`Running "install" command: \`${installCommand}\`...`);
   const env = getEnvForPackageManager({
     cliType,
     lockfileVersion,

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import FileFsRef from './file-fs-ref';
 import FileRef from './file-ref';
 import { Lambda, createLambda, getLambdaOptionsFromFunction, sanitizeConsumerName } from './lambda';
 import { NodejsLambda, type NodejsLambdaOptions } from './nodejs-lambda';
-import { Prerender } from './prerender';
+import { Prerender, type PrerenderClassification } from './prerender';
 import download, { downloadFile, DownloadedFiles, isSymbolicLink, isDirectory, isExternalSymlink, isExternalSymlinkTarget, getSymlinkTarget } from './fs/download';
 import getWriteableDirectory from './fs/get-writable-directory';
 import glob, { GlobOptions } from './fs/glob';
@@ -19,14 +19,14 @@ import { getServiceUrlEnvVars, getExperimentalServiceUrlEnvVars } from './get-se
 import { cloneEnv } from './clone-env';
 import { hardLinkDir } from './hard-link-dir';
 import { validateNpmrc } from './validate-npmrc';
-export type { NodejsLambdaOptions };
+export type { NodejsLambdaOptions, PrerenderClassification };
 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';
+export { getProvidedRuntime } from './provided-runtime';
 export * from './should-serve';
 export * from './schemas';
 export { DEFAULT_MAX_DURATION_LIMIT, SKIP_MAX_DURATION_LIMIT_ENV, getMaxDurationLimit, getMaxDurationSchema, } from './max-duration';

package/dist/index.js

@@ -2918,8 +2918,8 @@ var require_graceful_fs = __commonJS({
       fs13.createReadStream = createReadStream;
       fs13.createWriteStream = createWriteStream;
       var fs$readFile = fs13.readFile;
-      fs13.readFile = readFile4;
-      function readFile4(path8, options, cb) {
+      fs13.readFile = readFile3;
+      function readFile3(path8, options, cb) {
         if (typeof options === "function")
           cb = options, options = null;
         return go$readFile(path8, options, cb);
@@ -4667,7 +4667,7 @@ var require_jsonfile = __commonJS({
       }
       return obj;
     }
-    var readFile4 = universalify.fromPromise(_readFile);
+    var readFile3 = universalify.fromPromise(_readFile);
     function readFileSync(file, options = {}) {
       if (typeof options === "string") {
         options = { encoding: options };
@@ -4699,7 +4699,7 @@ var require_jsonfile = __commonJS({
       return fs12.writeFileSync(file, str, options);
     }
     module2.exports = {
-      readFile: readFile4,
+      readFile: readFile3,
       readFileSync,
       writeFile,
       writeFileSync
@@ -15412,7 +15412,7 @@ var require_dist = __commonJS({
       errorToString: () => errorToString,
       errorToStringFriendly: () => errorToStringFriendly,
       getSystemErrorMessage: () => getSystemErrorMessage,
-      isErrnoException: () => isErrnoException3,
+      isErrnoException: () => isErrnoException2,
       isError: () => isError,
       isErrorLike: () => isErrorLike,
       isObject: () => isObject,
@@ -15425,7 +15425,7 @@ var require_dist = __commonJS({
     var isError = (error) => {
       return import_node_util.default.types.isNativeError(error);
     };
-    var isErrnoException3 = (error) => {
+    var isErrnoException2 = (error) => {
       return isError(error) && "code" in error;
     };
     var nativeGetSystemErrorMessage = import_node_util.default.getSystemErrorMessage;
@@ -15442,7 +15442,7 @@ var require_dist = __commonJS({
     };
     var getSystemErrorMessage = nativeGetSystemErrorMessage ?? getSystemErrorMessageFallback;
     var errorToStringFriendly = (error, fallback) => {
-      if (isErrnoException3(error) && typeof error.errno === "number") {
+      if (isErrnoException2(error) && typeof error.errno === "number") {
         return getSystemErrorMessage(error.errno);
       }
       return errorToString(error, fallback);
@@ -15454,7 +15454,7 @@ var require_dist = __commonJS({
       return isErrorLike(error) ? Object.assign(new Error(errorMessage), error) : new Error(errorMessage);
     };
     function isSpawnError(v) {
-      return isErrnoException3(v) && "spawnargs" in v;
+      return isErrnoException2(v) && "spawnargs" in v;
     }
   }
 });
@@ -31618,7 +31618,6 @@ __export(src_exports, {
   getNodeBinPath: () => getNodeBinPath,
   getNodeBinPaths: () => getNodeBinPaths,
   getNodeVersion: () => getNodeVersion,
-  getOsRelease: () => getOsRelease,
   getPackageJson: () => getPackageJson,
   getPathForPackageManager: () => getPathForPackageManager,
   getPlatformEnv: () => getPlatformEnv,
@@ -32616,13 +32615,6 @@ var NodejsLambda = class extends Lambda {
 };
 
 // src/prerender.ts
-function assertOptionalBoolean(value, name) {
-  if (value !== void 0 && typeof value !== "boolean") {
-    throw new Error(
-      `The \`${name}\` argument for \`Prerender\` must be a boolean or undefined.`
-    );
-  }
-}
 var Prerender = class {
   constructor({
     expiration,
@@ -32642,27 +32634,13 @@ var Prerender = class {
     chain,
     exposeErrBody,
     partialFallback,
-    hasPostponed,
-    hasFallback,
-    htmlSize,
-    isDynamicRoute
+    prerenderClassification
   }) {
     this.type = "Prerender";
     this.expiration = expiration;
     this.staleExpiration = staleExpiration;
     this.sourcePath = sourcePath;
-    assertOptionalBoolean(hasPostponed, "hasPostponed");
-    this.hasPostponed = hasPostponed;
-    assertOptionalBoolean(hasFallback, "hasFallback");
-    this.hasFallback = hasFallback;
-    assertOptionalBoolean(isDynamicRoute, "isDynamicRoute");
-    this.isDynamicRoute = isDynamicRoute;
-    if (htmlSize !== void 0 && (!Number.isInteger(htmlSize) || htmlSize < 0)) {
-      throw new Error(
-        "The `htmlSize` argument for `Prerender` must be a non-negative integer or undefined."
-      );
-    }
-    this.htmlSize = htmlSize;
+    this.prerenderClassification = prerenderClassification;
     this.lambda = lambda;
     if (this.lambda) {
       this.lambda.operationType = this.lambda.operationType || "ISR";
@@ -34455,6 +34433,16 @@ function checkIfAlreadyInstalled(runNpmInstallSet, packageJsonPath) {
   return { alreadyInstalled, runNpmInstallSet: initializedRunNpmInstallSet };
 }
 var runNpmInstallSema = new import_async_sema4.default(1);
+function installCompletedCovers(packageJsonPath) {
+  if (process.env.VERCEL_INSTALL_COMPLETED !== "1") {
+    return false;
+  }
+  const completedPath = process.env.VERCEL_INSTALL_COMPLETED_PATH;
+  if (!completedPath) {
+    return true;
+  }
+  return packageJsonPath !== void 0 && import_path6.default.normalize(completedPath) === import_path6.default.normalize(packageJsonPath);
+}
 var customInstallCommandSet;
 function resetCustomInstallCommandSet() {
   customInstallCommandSet = void 0;
@@ -34490,7 +34478,7 @@ async function runNpmInstall(destPath, args = [], spawnOpts, meta, projectCreate
       if (alreadyInstalled) {
         return false;
       }
-      if (process.env.VERCEL_INSTALL_COMPLETED === "1") {
+      if (installCompletedCovers(packageJsonPath)) {
         debug(
           `Skipping dependency installation for ${packageJsonPath} because VERCEL_INSTALL_COMPLETED is set`
         );
@@ -34904,20 +34892,21 @@ async function runCustomInstallCommand({
     );
     return false;
   }
-  if (process.env.VERCEL_INSTALL_COMPLETED === "1") {
-    debug(
-      `Skipping custom install command for ${normalizedPath} because VERCEL_INSTALL_COMPLETED is set`
-    );
-    return false;
-  }
-  console.log(`Running "install" command: \`${installCommand}\`...`);
   const {
     cliType,
     lockfileVersion,
     packageJson,
+    packageJsonPath,
     packageJsonPackageManager,
     turboSupportsCorepackHome
   } = await scanParentDirs(destPath, true);
+  if (installCompletedCovers(packageJsonPath)) {
+    debug(
+      `Skipping custom install command for ${normalizedPath} because VERCEL_INSTALL_COMPLETED is set`
+    );
+    return false;
+  }
+  console.log(`Running "install" command: \`${installCommand}\`...`);
   const env = getEnvForPackageManager({
     cliType,
     lockfileVersion,
@@ -35035,7 +35024,7 @@ function clearRelative(s) {
   return s.replace(/(\n|^)\.\//g, "$1");
 }
 async function get_ignore_filter_default(downloadPath, rootDirectory) {
-  const readFile4 = async (p) => {
+  const readFile3 = async (p) => {
     try {
       return await import_fs_extra8.default.readFile(p, "utf8");
     } catch (error) {
@@ -35058,7 +35047,7 @@ async function get_ignore_filter_default(downloadPath, rootDirectory) {
   const ignoreContents = [];
   try {
     ignoreContents.push(
-      ...(await Promise.all([readFile4(vercelIgnorePath), readFile4(nowIgnorePath)])).filter(Boolean)
+      ...(await Promise.all([readFile3(vercelIgnorePath), readFile3(nowIgnorePath)])).filter(Boolean)
     );
   } catch (error) {
     if (isCodedError(error) && error.code === "ENOTDIR") {
@@ -35334,37 +35323,9 @@ var ContainerImage = class {
   }
 };
 
-// src/os.ts
-var import_fs_extra9 = __toESM(require_lib());
-var import_error_utils2 = __toESM(require_dist());
-async function getOsRelease() {
-  try {
-    const data = await (0, import_fs_extra9.readFile)("/etc/os-release", "utf8");
-    return await parseOsRelease(data);
-  } catch (err) {
-    if ((0, import_error_utils2.isErrnoException)(err) && err.code === "ENOENT") {
-      return null;
-    }
-    throw err;
-  }
-}
-async function parseOsRelease(data) {
-  const obj = {};
-  for (const line of data.trim().split("\n")) {
-    const m = /(?<key>.*)="(?<value>.*)"/.exec(line);
-    if (!m?.groups) {
-      continue;
-    }
-    obj[m.groups.key] = m.groups.value;
-  }
-  return obj;
-}
+// src/provided-runtime.ts
 async function getProvidedRuntime() {
-  const os = await getOsRelease();
-  if (!os) {
-    return "provided.al2023";
-  }
-  return os.PRETTY_NAME === "Amazon Linux 2" ? "provided.al2" : "provided.al2023";
+  return "provided.al2023";
 }
 
 // src/should-serve.ts
@@ -36022,7 +35983,8 @@ async function generateProjectManifest({
   lockfilePath,
   lockfileVersion,
   framework,
-  serviceType
+  serviceType,
+  outputRuntime = "node"
 }) {
   try {
     const pkgJson = await readPackageJson(workPath);
@@ -36097,7 +36059,7 @@ async function generateProjectManifest({
         ...transitiveDeps.sort((a, b) => a.name.localeCompare(b.name))
       ]
     };
-    await writeProjectManifest(manifest, workPath, "node");
+    await writeProjectManifest(manifest, workPath, outputRuntime);
   } catch (err) {
     debug(
       `generateProjectManifest: ${err instanceof Error ? err.message : String(err)}`
@@ -36221,7 +36183,8 @@ async function generateRubyProjectManifest({
   workPath,
   gemfileLockPath,
   framework,
-  serviceType
+  serviceType,
+  outputRuntime = "ruby"
 }) {
   try {
     if (!gemfileLockPath)
@@ -36275,7 +36238,7 @@ async function generateRubyProjectManifest({
         ...transitiveEntries.sort((a, b) => a.name.localeCompare(b.name))
       ]
     };
-    await writeProjectManifest(manifest, workPath, "ruby");
+    await writeProjectManifest(manifest, workPath, outputRuntime);
   } catch {
   }
 }
@@ -37074,7 +37037,6 @@ async function validateBuildResult({
   allowInvalidRuntime = false,
   buildConfig,
   buildResponse,
-  osRelease,
   vercelBaseUrl
 }) {
   if (!("output" in buildResponse)) {
@@ -37090,32 +37052,30 @@ async function validateBuildResult({
     });
   }
   const buildOutputMap = getAndVerifyOutputLambdasOrEdgeFuncs(buildResponse);
-  if (osRelease?.VERSION === "2023") {
-    const invalidRuntimes = [];
-    for (const [name, entry] of Object.entries(buildOutputMap)) {
-      let lambda;
-      if (entry.type === "Prerender") {
-        lambda = entry.lambda;
-      } else if (entry.type === "Lambda") {
-        lambda = entry;
-      }
-      if (!lambda)
-        continue;
-      if (!isSupportedAl2023Runtime(lambda.runtime)) {
-        invalidRuntimes.push({ name, lambda });
-      }
+  const invalidRuntimes = [];
+  for (const [name, entry] of Object.entries(buildOutputMap)) {
+    let lambda;
+    if (entry.type === "Prerender") {
+      lambda = entry.lambda;
+    } else if (entry.type === "Lambda") {
+      lambda = entry;
+    }
+    if (!lambda)
+      continue;
+    if (!isSupportedAl2023Runtime(lambda.runtime)) {
+      invalidRuntimes.push({ name, lambda });
     }
-    if (invalidRuntimes.length > 0 && !allowInvalidRuntime) {
-      throw new NowBuildError({
-        code: "NOW_SANDBOX_WORKER_INVALID_RUNTIME",
-        message: `The following Serverless Functions contain an invalid "runtime":
+  }
+  if (invalidRuntimes.length > 0 && !allowInvalidRuntime) {
+    throw new NowBuildError({
+      code: "NOW_SANDBOX_WORKER_INVALID_RUNTIME",
+      message: `The following Serverless Functions contain an invalid "runtime":
 ${invalidRuntimes.map(({ name, lambda }) => `  - ${name} (${lambda.runtime})`).join("\n")}`,
-        link: getVercelUrl(
-          "/docs/functions/runtimes#official-runtimes",
-          vercelBaseUrl
-        )
-      });
-    }
+      link: getVercelUrl(
+        "/docs/functions/runtimes#official-runtimes",
+        vercelBaseUrl
+      )
+    });
   }
   const customFunctionConfiguration = getCustomFunctionConfigMaybe(buildConfig);
   if (customFunctionConfiguration?.runtime) {
@@ -37425,12 +37385,12 @@ async function fileFsRefCached(fsPath, cache) {
 
 // src/deserialize/create-functions-iterator.ts
 var import_path14 = require("path");
-var import_fs_extra10 = __toESM(require_lib());
+var import_fs_extra9 = __toESM(require_lib());
 var SUFFIX = ".func";
 async function* createFunctionsIterator(dir, root = dir) {
   let paths;
   try {
-    paths = await (0, import_fs_extra10.readdir)(dir);
+    paths = await (0, import_fs_extra9.readdir)(dir);
   } catch (err) {
     if (err.code !== "ENOENT" && err.code !== "ENOTDIR") {
       throw err;
@@ -37439,7 +37399,7 @@ async function* createFunctionsIterator(dir, root = dir) {
   }
   for (const path8 of paths) {
     const abs = (0, import_path14.join)(dir, path8);
-    const s = await (0, import_fs_extra10.stat)(abs);
+    const s = await (0, import_fs_extra9.stat)(abs);
     if (s.isDirectory()) {
       if (path8.endsWith(SUFFIX)) {
         yield (0, import_path14.relative)(root, abs.substring(0, abs.length - SUFFIX.length));
@@ -37451,10 +37411,10 @@ async function* createFunctionsIterator(dir, root = dir) {
 }
 
 // src/deserialize/maybe-read-json.ts
-var import_fs_extra11 = __toESM(require_lib());
+var import_fs_extra10 = __toESM(require_lib());
 async function maybeReadJSON(path8) {
   try {
-    return await (0, import_fs_extra11.readJSON)(path8);
+    return await (0, import_fs_extra10.readJSON)(path8);
   } catch (err) {
     if (err.code !== "ENOENT")
       throw err;
@@ -37763,10 +37723,10 @@ async function deserializeLambda(files, config, repoRootPath, fileFsRefsCache, o
 }
 
 // src/collect-build-result/validate-regular-file.ts
-var import_fs_extra12 = __toESM(require_lib());
+var import_fs_extra11 = __toESM(require_lib());
 async function validateRegularFile(file) {
   if ("fsPath" in file && typeof file.fsPath === "string") {
-    const stat2 = await (0, import_fs_extra12.lstat)(file.fsPath);
+    const stat2 = await (0, import_fs_extra11.lstat)(file.fsPath);
     if (!stat2.isFile() && !stat2.isDirectory() && !stat2.isSymbolicLink()) {
       throw new NowBuildError({
         message: `Output file path is actually not a (regular) file: \`${file.fsPath}\``,
@@ -37946,7 +37906,6 @@ function getExtendedPayload({
   getNodeBinPath,
   getNodeBinPaths,
   getNodeVersion,
-  getOsRelease,
   getPackageJson,
   getPathForPackageManager,
   getPlatformEnv,

package/dist/node-diagnostics.d.ts

@@ -1,6 +1,6 @@
 import type { NodeVersion } from './types';
 type CliType = 'yarn' | 'npm' | 'pnpm' | 'bun' | 'vlt';
-export declare function generateProjectManifest({ workPath, nodeVersion, cliType, lockfilePath, lockfileVersion, framework, serviceType, }: {
+export declare function generateProjectManifest({ workPath, nodeVersion, cliType, lockfilePath, lockfileVersion, framework, serviceType, outputRuntime, }: {
     workPath: string;
     nodeVersion: NodeVersion;
     cliType: CliType;
@@ -8,5 +8,6 @@ export declare function generateProjectManifest({ workPath, nodeVersion, cliType
     lockfileVersion: number | undefined;
     framework?: string;
     serviceType?: string;
+    outputRuntime?: string;
 }): Promise<void>;
 export {};

package/dist/node-diagnostics.js

@@ -387,7 +387,8 @@ async function generateProjectManifest({
   lockfilePath,
   lockfileVersion,
   framework,
-  serviceType
+  serviceType,
+  outputRuntime = "node"
 }) {
   try {
     const pkgJson = await readPackageJson(workPath);
@@ -462,7 +463,7 @@ async function generateProjectManifest({
         ...transitiveDeps.sort((a, b) => a.name.localeCompare(b.name))
       ]
     };
-    await (0, import_package_manifest.writeProjectManifest)(manifest, workPath, "node");
+    await (0, import_package_manifest.writeProjectManifest)(manifest, workPath, outputRuntime);
   } catch (err) {
     (0, import_debug.default)(
       `generateProjectManifest: ${err instanceof Error ? err.message : String(err)}`

package/dist/prerender.d.ts

@@ -1,5 +1,19 @@
 import type { File, HasField, Chain } from './types';
 import { Lambda } from './lambda';
+/**
+ * The framework's own description of what it prerendered, mirroring the
+ * Next.js prerender taxonomy rather than re-deriving it from build artifacts.
+ */
+export interface PrerenderClassification {
+    /** What kind of entry this is within its route group. */
+    routeType: 'route' | 'page' | 'shell' | 'fallback';
+    /** How much of the response the prerender contains. */
+    response: 'empty' | 'initial' | 'complete';
+    /** What has to happen at request time to finish the response. */
+    compute: 'blocking' | 'resuming' | 'static';
+    /** Byte size of the prerendered HTML shell, when the entry has one. */
+    htmlSize?: number;
+}
 interface PrerenderOptions {
     expiration: number | false;
     staleExpiration?: number;
@@ -18,10 +32,7 @@ interface PrerenderOptions {
     chain?: Chain;
     exposeErrBody?: boolean;
     partialFallback?: boolean;
-    hasPostponed?: boolean;
-    hasFallback?: boolean;
-    htmlSize?: number;
-    isDynamicRoute?: boolean;
+    prerenderClassification?: PrerenderClassification;
 }
 export declare class Prerender {
     type: 'Prerender';
@@ -52,31 +63,11 @@ export declare class Prerender {
     exposeErrBody?: boolean;
     partialFallback?: boolean;
     /**
-     * Set to `true` when the route's `.meta` postponed state is present (React
-     * suspended during build prerender). `false` when the framework prerendered
-     * a Prerender route without postponing. `undefined` when the framework did
-     * not provide the signal.
-     */
-    hasPostponed?: boolean;
-    /**
-     * `true` when the route's dynamic template had a static fallback page (the
-     * prerender-manifest `fallback` was a string). `false` for blocking/omitted
-     * dynamic templates (manifest `fallback` was `null`/`false`). `undefined` for
-     * concrete prerenders, where the notion of a fallback doesn't apply.
-     */
-    hasFallback?: boolean;
-    /**
-     * Byte size on disk of the route's prerendered `.html` shell. `0` for an
-     * empty shell (PPR template that postponed everything). `undefined` when
-     * there's no `.html` on disk (pages router, route handlers, edge).
-     */
-    htmlSize?: number;
-    /**
-     * `true` when this entry came from a dynamic route template (the
-     * prerender-manifest `dynamicRoutes` section: fallback, blocking, or omitted)
-     * rather than a concrete prerender.
+     * The framework's classification of this prerender. `undefined` when the
+     * framework did not provide one, which is legitimate: not-found routes and
+     * Pages Router `fallback: false` templates have no classification.
      */
-    isDynamicRoute?: boolean;
-    constructor({ expiration, staleExpiration, lambda, fallback, group, bypassToken, allowQuery, allowHeader, initialHeaders, initialStatus, passQuery, sourcePath, experimentalBypassFor, experimentalStreamingLambdaPath, chain, exposeErrBody, partialFallback, hasPostponed, hasFallback, htmlSize, isDynamicRoute, }: PrerenderOptions);
+    prerenderClassification?: PrerenderClassification;
+    constructor({ expiration, staleExpiration, lambda, fallback, group, bypassToken, allowQuery, allowHeader, initialHeaders, initialStatus, passQuery, sourcePath, experimentalBypassFor, experimentalStreamingLambdaPath, chain, exposeErrBody, partialFallback, prerenderClassification, }: PrerenderOptions);
 }
 export {};

package/dist/prerender.js

@@ -21,13 +21,6 @@ __export(prerender_exports, {
   Prerender: () => Prerender
 });
 module.exports = __toCommonJS(prerender_exports);
-function assertOptionalBoolean(value, name) {
-  if (value !== void 0 && typeof value !== "boolean") {
-    throw new Error(
-      `The \`${name}\` argument for \`Prerender\` must be a boolean or undefined.`
-    );
-  }
-}
 class Prerender {
   constructor({
     expiration,
@@ -47,27 +40,13 @@ class Prerender {
     chain,
     exposeErrBody,
     partialFallback,
-    hasPostponed,
-    hasFallback,
-    htmlSize,
-    isDynamicRoute
+    prerenderClassification
   }) {
     this.type = "Prerender";
     this.expiration = expiration;
     this.staleExpiration = staleExpiration;
     this.sourcePath = sourcePath;
-    assertOptionalBoolean(hasPostponed, "hasPostponed");
-    this.hasPostponed = hasPostponed;
-    assertOptionalBoolean(hasFallback, "hasFallback");
-    this.hasFallback = hasFallback;
-    assertOptionalBoolean(isDynamicRoute, "isDynamicRoute");
-    this.isDynamicRoute = isDynamicRoute;
-    if (htmlSize !== void 0 && (!Number.isInteger(htmlSize) || htmlSize < 0)) {
-      throw new Error(
-        "The `htmlSize` argument for `Prerender` must be a non-negative integer or undefined."
-      );
-    }
-    this.htmlSize = htmlSize;
+    this.prerenderClassification = prerenderClassification;
     this.lambda = lambda;
     if (this.lambda) {
       this.lambda.operationType = this.lambda.operationType || "ISR";

package/dist/provided-runtime.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The Lambda runtime that custom runtimes must target.
+ *
+ * Builds run on Amazon Linux 2023, so this is a constant. It is deliberately
+ * not derived from the build host's `/etc/os-release`: `vercel build` also runs
+ * on developer machines and in CI, and the emitted runtime has to match the
+ * deploy target rather than wherever the build happened to run.
+ *
+ * This stays a function so that custom runtimes pick up any future base image
+ * migration without having to change their own code.
+ */
+export declare function getProvidedRuntime(): Promise<'provided.al2023'>;

package/dist/provided-runtime.js

@@ -0,0 +1,30 @@
+"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 provided_runtime_exports = {};
+__export(provided_runtime_exports, {
+  getProvidedRuntime: () => getProvidedRuntime
+});
+module.exports = __toCommonJS(provided_runtime_exports);
+async function getProvidedRuntime() {
+  return "provided.al2023";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getProvidedRuntime
+});

package/dist/ruby-diagnostics.d.ts

@@ -12,10 +12,11 @@ export declare function parseGemfileLock(content: string): {
     gems: Map<string, GemEntry>;
     directGems: Map<string, string | undefined>;
 };
-export declare function generateRubyProjectManifest({ workPath, gemfileLockPath, framework, serviceType, }: {
+export declare function generateRubyProjectManifest({ workPath, gemfileLockPath, framework, serviceType, outputRuntime, }: {
     workPath: string;
     gemfileLockPath: string | undefined;
     framework?: string | null;
     serviceType?: string | null;
+    outputRuntime?: string;
 }): Promise<void>;
 export {};

package/dist/ruby-diagnostics.js

@@ -154,7 +154,8 @@ async function generateRubyProjectManifest({
   workPath,
   gemfileLockPath,
   framework,
-  serviceType
+  serviceType,
+  outputRuntime = "ruby"
 }) {
   try {
     if (!gemfileLockPath)
@@ -208,7 +209,7 @@ async function generateRubyProjectManifest({
         ...transitiveEntries.sort((a, b) => a.name.localeCompare(b.name))
       ]
     };
-    await (0, import_package_manifest.writeProjectManifest)(manifest, workPath, "ruby");
+    await (0, import_package_manifest.writeProjectManifest)(manifest, workPath, outputRuntime);
   } catch {
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.36.3",
+  "version": "14.0.2",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -13,7 +13,7 @@
   "dependencies": {
     "cjs-module-lexer": "1.2.3",
     "es-module-lexer": "1.5.0",
-    "@vercel/python-analysis": "0.12.0"
+    "@vercel/python-analysis": "0.13.1"
   },
   "devDependencies": {
     "@types/async-retry": "^1.2.1",
@@ -53,14 +53,14 @@
     "vitest": "2.0.1",
     "typescript": "4.9.5",
     "yazl": "2.5.1",
-    "@vercel/routing-utils": "6.4.0",
-    "@vercel/error-utils": "2.2.0"
+    "@vercel/error-utils": "2.2.1",
+    "@vercel/routing-utils": "6.4.1"
   },
   "scripts": {
     "build": "node build.mjs",
     "test": "vitest run --config ../../vitest.config.mts",
     "vitest-run": "vitest -c ../../vitest.config.mts",
-    "vitest-unit": "glob --absolute 'test/unit.*test.ts'",
+    "vitest-unit": "pnpm vitest-run --run test/unit.",
     "vitest-e2e": "glob --absolute 'test/integration*.test.ts'",
     "type-check": "tsc --noEmit"
   }

package/dist/os.d.ts

@@ -1,3 +0,0 @@
-export declare function getOsRelease(): Promise<Record<string, string> | null>;
-export declare function parseOsRelease(data: string): Promise<Record<string, string>>;
-export declare function getProvidedRuntime(): Promise<"provided.al2023" | "provided.al2">;

package/dist/os.js

@@ -1,62 +0,0 @@
-"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 os_exports = {};
-__export(os_exports, {
-  getOsRelease: () => getOsRelease,
-  getProvidedRuntime: () => getProvidedRuntime,
-  parseOsRelease: () => parseOsRelease
-});
-module.exports = __toCommonJS(os_exports);
-var import_fs_extra = require("fs-extra");
-var import_error_utils = require("@vercel/error-utils");
-async function getOsRelease() {
-  try {
-    const data = await (0, import_fs_extra.readFile)("/etc/os-release", "utf8");
-    return await parseOsRelease(data);
-  } catch (err) {
-    if ((0, import_error_utils.isErrnoException)(err) && err.code === "ENOENT") {
-      return null;
-    }
-    throw err;
-  }
-}
-async function parseOsRelease(data) {
-  const obj = {};
-  for (const line of data.trim().split("\n")) {
-    const m = /(?<key>.*)="(?<value>.*)"/.exec(line);
-    if (!m?.groups) {
-      continue;
-    }
-    obj[m.groups.key] = m.groups.value;
-  }
-  return obj;
-}
-async function getProvidedRuntime() {
-  const os = await getOsRelease();
-  if (!os) {
-    return "provided.al2023";
-  }
-  return os.PRETTY_NAME === "Amazon Linux 2" ? "provided.al2" : "provided.al2023";
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getOsRelease,
-  getProvidedRuntime,
-  parseOsRelease
-});