@vercel/build-utils 8.2.1 → 8.3.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @vercel/build-utils
 
+## 8.3.0
+
+### Minor Changes
+
+- Adds the ability for builders to define a `diagnostics` step that is called after the build operation is done. ([#11653](https://github.com/vercel/vercel/pull/11653))
+  Implements the diagnostics step in the `next` builder.
+
+### Patch Changes
+
+- Add resolved node version range to warning message ([#11742](https://github.com/vercel/vercel/pull/11742))
+
+## 8.2.2
+
+### Patch Changes
+
+- Change node 16.x EOL for Vercel ([#11704](https://github.com/vercel/vercel/pull/11704))
+
+- Improve error message and refactor ([#11706](https://github.com/vercel/vercel/pull/11706))
+
+- [built-utils] Handle case of not having lockfile when corepack is enabled ([#11697](https://github.com/vercel/vercel/pull/11697))
+
 ## 8.2.1
 
 ### Patch Changes

package/dist/fs/node-version.js

@@ -46,7 +46,7 @@ const NODE_VERSIONS = [
     major: 16,
     range: "16.x",
     runtime: "nodejs16.x",
-    discontinueDate: /* @__PURE__ */ new Date("2025-02-28")
+    discontinueDate: /* @__PURE__ */ new Date("2025-01-31")
   },
   {
     major: 14,

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

@@ -190,7 +190,7 @@ async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PRO
     const { node } = packageJson.engines;
     if (configuredVersion && !(0, import_semver.intersects)(configuredVersion, supportedNodeVersion.range)) {
       console.warn(
-        `Warning: Due to "engines": { "node": "${node}" } in your \`package.json\` file, the Node.js Version defined in your Project Settings ("${configuredVersion}") will not apply. Learn More: http://vercel.link/node-version`
+        `Warning: Due to "engines": { "node": "${node}" } in your \`package.json\` file, the Node.js Version defined in your Project Settings ("${configuredVersion}") will not apply, Node.js Version "${supportedNodeVersion.range}" will be used instead. Learn More: http://vercel.link/node-version`
       );
     }
     if ((0, import_semver.coerce)(node)?.raw === node) {
@@ -252,7 +252,7 @@ async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
     lockfilePath = bunLockPath;
     lockfileVersion = 0;
   } else {
-    cliType = "npm";
+    cliType = packageJson ? detectPackageManagerNameWithoutLockfile(packageJson) : "npm";
   }
   const packageJsonPath = pkgJsonPath || void 0;
   return {
@@ -263,6 +263,32 @@ async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
     packageJsonPath
   };
 }
+function detectPackageManagerNameWithoutLockfile(packageJson) {
+  const packageJsonPackageManager = packageJson.packageManager;
+  if (usingCorepack(process.env, packageJsonPackageManager)) {
+    const corepackPackageManager = validateVersionSpecifier(
+      packageJsonPackageManager
+    );
+    switch (corepackPackageManager?.packageName) {
+      case "npm":
+      case "pnpm":
+      case "yarn":
+      case "bun":
+        return corepackPackageManager.packageName;
+      case void 0:
+        return "npm";
+      default:
+        throw new Error(
+          `Unknown package manager "${corepackPackageManager?.packageName}". Change your package.json "packageManager" field to a known package manager: npm, pnpm, yarn, bun.`
+        );
+    }
+  }
+  return "npm";
+}
+function usingCorepack(env, packageJsonPackageManager) {
+  const corepackFlagged = env.ENABLE_EXPERIMENTAL_COREPACK === "1";
+  return corepackFlagged && Boolean(packageJsonPackageManager);
+}
 async function walkParentDirs({
   base,
   start,
@@ -391,8 +417,7 @@ function getEnvForPackageManager({
   nodeVersion,
   env
 }) {
-  const corepackFlagged = env.ENABLE_EXPERIMENTAL_COREPACK === "1";
-  const corepackEnabled = corepackFlagged && Boolean(packageJsonPackageManager);
+  const corepackEnabled = usingCorepack(env, packageJsonPackageManager);
   const {
     detectedLockfile,
     detectedPackageManager,
@@ -528,6 +553,28 @@ function getPathOverrideForPackageManager({
       return no_override;
   }
 }
+function validateVersionSpecifier(version) {
+  if (!version) {
+    return void 0;
+  }
+  const [before, after, ...extra] = version.split("@");
+  if (extra.length) {
+    return void 0;
+  }
+  if (!before) {
+    return void 0;
+  }
+  if (!after) {
+    return void 0;
+  }
+  if (!(0, import_semver.validRange)(after)) {
+    return void 0;
+  }
+  return {
+    packageName: before,
+    packageVersionRange: after
+  };
+}
 function getPathForPackageManager({
   cliType,
   lockfileVersion,

package/dist/index.js

@@ -21620,7 +21620,7 @@ var NODE_VERSIONS = [
     major: 16,
     range: "16.x",
     runtime: "nodejs16.x",
-    discontinueDate: /* @__PURE__ */ new Date("2025-02-28")
+    discontinueDate: /* @__PURE__ */ new Date("2025-01-31")
   },
   {
     major: 14,
@@ -21912,7 +21912,7 @@ async function getNodeVersion(destPath, fallbackVersion = process.env.VERCEL_PRO
     const { node } = packageJson.engines;
     if (configuredVersion && !(0, import_semver2.intersects)(configuredVersion, supportedNodeVersion.range)) {
       console.warn(
-        `Warning: Due to "engines": { "node": "${node}" } in your \`package.json\` file, the Node.js Version defined in your Project Settings ("${configuredVersion}") will not apply. Learn More: http://vercel.link/node-version`
+        `Warning: Due to "engines": { "node": "${node}" } in your \`package.json\` file, the Node.js Version defined in your Project Settings ("${configuredVersion}") will not apply, Node.js Version "${supportedNodeVersion.range}" will be used instead. Learn More: http://vercel.link/node-version`
       );
     }
     if ((0, import_semver2.coerce)(node)?.raw === node) {
@@ -21974,7 +21974,7 @@ async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
     lockfilePath = bunLockPath;
     lockfileVersion = 0;
   } else {
-    cliType = "npm";
+    cliType = packageJson ? detectPackageManagerNameWithoutLockfile(packageJson) : "npm";
   }
   const packageJsonPath = pkgJsonPath || void 0;
   return {
@@ -21985,6 +21985,32 @@ async function scanParentDirs(destPath, readPackageJson = false, base = "/") {
     packageJsonPath
   };
 }
+function detectPackageManagerNameWithoutLockfile(packageJson) {
+  const packageJsonPackageManager = packageJson.packageManager;
+  if (usingCorepack(process.env, packageJsonPackageManager)) {
+    const corepackPackageManager = validateVersionSpecifier(
+      packageJsonPackageManager
+    );
+    switch (corepackPackageManager?.packageName) {
+      case "npm":
+      case "pnpm":
+      case "yarn":
+      case "bun":
+        return corepackPackageManager.packageName;
+      case void 0:
+        return "npm";
+      default:
+        throw new Error(
+          `Unknown package manager "${corepackPackageManager?.packageName}". Change your package.json "packageManager" field to a known package manager: npm, pnpm, yarn, bun.`
+        );
+    }
+  }
+  return "npm";
+}
+function usingCorepack(env, packageJsonPackageManager) {
+  const corepackFlagged = env.ENABLE_EXPERIMENTAL_COREPACK === "1";
+  return corepackFlagged && Boolean(packageJsonPackageManager);
+}
 async function walkParentDirs({
   base,
   start,
@@ -22113,8 +22139,7 @@ function getEnvForPackageManager({
   nodeVersion,
   env
 }) {
-  const corepackFlagged = env.ENABLE_EXPERIMENTAL_COREPACK === "1";
-  const corepackEnabled = corepackFlagged && Boolean(packageJsonPackageManager);
+  const corepackEnabled = usingCorepack(env, packageJsonPackageManager);
   const {
     detectedLockfile,
     detectedPackageManager,
@@ -22250,6 +22275,28 @@ function getPathOverrideForPackageManager({
       return no_override;
   }
 }
+function validateVersionSpecifier(version) {
+  if (!version) {
+    return void 0;
+  }
+  const [before, after, ...extra] = version.split("@");
+  if (extra.length) {
+    return void 0;
+  }
+  if (!before) {
+    return void 0;
+  }
+  if (!after) {
+    return void 0;
+  }
+  if (!(0, import_semver2.validRange)(after)) {
+    return void 0;
+  }
+  return {
+    packageName: before,
+    packageVersionRange: after
+  };
+}
 function getPathForPackageManager({
   cliType,
   lockfileVersion,

package/dist/types.d.ts

@@ -318,12 +318,14 @@ export interface ProjectSettings {
 export interface BuilderV2 {
     version: 2;
     build: BuildV2;
+    diagnostics?: Diagnostics;
     prepareCache?: PrepareCache;
     shouldServe?: ShouldServe;
 }
 export interface BuilderV3 {
     version: 3;
     build: BuildV3;
+    diagnostics?: Diagnostics;
     prepareCache?: PrepareCache;
     shouldServe?: ShouldServe;
     startDevServer?: StartDevServer;
@@ -418,6 +420,7 @@ export interface BuildResultV3 {
 export type BuildV2 = (options: BuildOptions) => Promise<BuildResultV2>;
 export type BuildV3 = (options: BuildOptions) => Promise<BuildResultV3>;
 export type PrepareCache = (options: PrepareCacheOptions) => Promise<Files>;
+export type Diagnostics = (options: BuildOptions) => Promise<Files>;
 export type ShouldServe = (options: ShouldServeOptions) => boolean | Promise<boolean>;
 export type StartDevServer = (options: StartDevServerOptions) => Promise<StartDevServerResult>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "8.2.1",
+  "version": "8.3.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",