@vercel/build-utils 12.2.0 → 12.2.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @vercel/build-utils
 
+## 12.2.2
+
+### Patch Changes
+
+- Allow Node.js 24 behind env var feature flag ([#14160](https://github.com/vercel/vercel/pull/14160))
+
+## 12.2.1
+
+### Patch Changes
+
+- Add backend util helpers ([#14152](https://github.com/vercel/vercel/pull/14152))
+
 ## 12.2.0
 
 ### Minor Changes

package/dist/framework-helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * List of backend frameworks supported by the experimental backends feature
+ */
+export declare const BACKEND_FRAMEWORKS: readonly ["express", "hono", "h3", "nestjs", "fastify"];
+export type BackendFramework = (typeof BACKEND_FRAMEWORKS)[number];
+/**
+ * Checks if the given framework is a backend framework
+ */
+export declare function isBackendFramework(framework: string | null | undefined): framework is BackendFramework;
+/**
+ * Checks if experimental backends are enabled via environment variable
+ */
+export declare function isExperimentalBackendsEnabled(): boolean;
+/**
+ * Checks if experimental backends are enabled AND the framework is a backend framework
+ */
+export declare function shouldUseExperimentalBackends(framework: string | null | undefined): boolean;

package/dist/framework-helpers.js

@@ -0,0 +1,52 @@
+"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 framework_helpers_exports = {};
+__export(framework_helpers_exports, {
+  BACKEND_FRAMEWORKS: () => BACKEND_FRAMEWORKS,
+  isBackendFramework: () => isBackendFramework,
+  isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
+  shouldUseExperimentalBackends: () => shouldUseExperimentalBackends
+});
+module.exports = __toCommonJS(framework_helpers_exports);
+const BACKEND_FRAMEWORKS = [
+  "express",
+  "hono",
+  "h3",
+  "nestjs",
+  "fastify"
+];
+function isBackendFramework(framework) {
+  if (!framework)
+    return false;
+  return BACKEND_FRAMEWORKS.includes(framework);
+}
+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 shouldUseExperimentalBackends(framework) {
+  return isExperimentalBackendsEnabled() && isBackendFramework(framework);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BACKEND_FRAMEWORKS,
+  isBackendFramework,
+  isExperimentalBackendsEnabled,
+  shouldUseExperimentalBackends
+});

package/dist/fs/node-version.js

@@ -100,9 +100,19 @@ const BUN_VERSIONS = [
   })
 ];
 function getNodeVersionByMajor(major) {
-  return NODE_VERSIONS.find((v) => v.major === major);
+  return getOptions().find((v) => v.major === major);
 }
 function getOptions() {
+  if (process.env.VERCEL_ALLOW_NODEJS_24 === "1") {
+    return [
+      new import_types.NodeVersion({
+        major: 24,
+        range: "24.x",
+        runtime: "nodejs24.x"
+      }),
+      ...NODE_VERSIONS
+    ];
+  }
   return NODE_VERSIONS;
 }
 function isNodeVersionAvailable(version) {

package/dist/index.d.ts

@@ -32,3 +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';

package/dist/index.js

@@ -21817,6 +21817,7 @@ var require_ignore = __commonJS({
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  BACKEND_FRAMEWORKS: () => BACKEND_FRAMEWORKS,
   BUILDER_COMPILE_STEP: () => BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP: () => BUILDER_INSTALLER_STEP,
   BunVersion: () => BunVersion,
@@ -21866,8 +21867,10 @@ __export(src_exports, {
   glob: () => glob,
   hardLinkDir: () => hardLinkDir,
   installDependencies: () => installDependencies,
+  isBackendFramework: () => isBackendFramework,
   isBunVersion: () => isBunVersion,
   isDirectory: () => isDirectory,
+  isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   isSymbolicLink: () => isSymbolicLink,
   normalizePath: () => normalizePath,
   readConfigFile: () => readConfigFile,
@@ -21880,6 +21883,7 @@ __export(src_exports, {
   runShellScript: () => runShellScript,
   scanParentDirs: () => scanParentDirs,
   shouldServe: () => shouldServe,
+  shouldUseExperimentalBackends: () => shouldUseExperimentalBackends,
   spawnAsync: () => spawnAsync,
   spawnCommand: () => spawnCommand,
   streamToBuffer: () => streamToBuffer,
@@ -23011,6 +23015,16 @@ var BUN_VERSIONS = [
   })
 ];
 function getOptions() {
+  if (process.env.VERCEL_ALLOW_NODEJS_24 === "1") {
+    return [
+      new NodeVersion({
+        major: 24,
+        range: "24.x",
+        runtime: "nodejs24.x"
+      }),
+      ...NODE_VERSIONS
+    ];
+  }
   return NODE_VERSIONS;
 }
 function isNodeVersionAvailable(version) {
@@ -24761,8 +24775,30 @@ ${entrypointsForMessage}`
     entrypointCallback
   };
 }
+
+// src/framework-helpers.ts
+var BACKEND_FRAMEWORKS = [
+  "express",
+  "hono",
+  "h3",
+  "nestjs",
+  "fastify"
+];
+function isBackendFramework(framework) {
+  if (!framework)
+    return false;
+  return BACKEND_FRAMEWORKS.includes(framework);
+}
+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 shouldUseExperimentalBackends(framework) {
+  return isExperimentalBackendsEnabled() && isBackendFramework(framework);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BACKEND_FRAMEWORKS,
   BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP,
   BunVersion,
@@ -24812,8 +24848,10 @@ ${entrypointsForMessage}`
   glob,
   hardLinkDir,
   installDependencies,
+  isBackendFramework,
   isBunVersion,
   isDirectory,
+  isExperimentalBackendsEnabled,
   isSymbolicLink,
   normalizePath,
   readConfigFile,
@@ -24826,6 +24864,7 @@ ${entrypointsForMessage}`
   runShellScript,
   scanParentDirs,
   shouldServe,
+  shouldUseExperimentalBackends,
   spawnAsync,
   spawnCommand,
   streamToBuffer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "12.2.0",
+  "version": "12.2.2",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -27,7 +27,7 @@
     "@types/semver": "6.0.0",
     "@types/yazl": "2.4.2",
     "@vercel/error-utils": "2.0.3",
-    "@vercel/routing-utils": "5.2.0",
+    "@vercel/routing-utils": "5.2.1",
     "aggregate-error": "3.0.1",
     "async-retry": "1.2.3",
     "async-sema": "2.1.4",