@netlify/build 28.3.1 → 28.4.0

package/lib/plugins/node_version.js

@@ -1,20 +1,40 @@
 import { execPath, version as currentVersion } from 'process';
 import semver from 'semver';
-// This node version is minimum required to use ESModules so if the user's preferred Node.js version is below that
-// we have to fall back to the system node version
-const MINIMUM_REQUIRED_NODE_VERSION = '^12.20.0 || ^14.14.0 || >=16.0.0';
-// Local plugins and `package.json`-installed plugins use user's preferred Node.js version if higher than our minimum
-// supported version. Else default to the system Node version.
-// Local and programmatic builds use `@netlify/build` Node.js version, which is
-// usually the system's Node.js version.
-// If the user Node version does not satisfy our supported engine range use our own system Node version
-export const addPluginsNodeVersion = function ({ pluginsOptions, nodePath, userNodeVersion }) {
+import link from 'terminal-link';
+import { logWarning, logWarningSubHeader } from '../log/logger.js';
+/**
+ * @deprecated will be replaced with `MINIMUM_REQUIRED_NODE_VERSION` at the 5th. of December 2022
+ */
+const OLD_MINIMUM_REQUIRED_NODE_VERSION = '^12.20.0 || ^14.14.0 || >=16.0.0';
+/**
+ * This node version is minimum required to run the plugins code.
+ * If the users preferred Node.js version is below that we have to fall back to the system node version
+ */
+const MINIMUM_REQUIRED_NODE_VERSION = '^14.14.0 || >=16.0.0';
+/**
+ * Local plugins and `package.json`-installed plugins use user's preferred Node.js version if higher than our minimum
+ * supported version. Else default to the system Node version.
+ * Local and programmatic builds use `@netlify/build` Node.js version, which is
+ * usually the system's Node.js version.
+ * If the user Node version does not satisfy our supported engine range use our own system Node version
+ */
+export const addPluginsNodeVersion = function ({ pluginsOptions, nodePath, userNodeVersion, logs }) {
     const currentNodeVersion = semver.clean(currentVersion);
-    return pluginsOptions.map((pluginOptions) => addPluginNodeVersion({ pluginOptions, currentNodeVersion, userNodeVersion, nodePath }));
+    return pluginsOptions.map((pluginOptions) => addPluginNodeVersion({ pluginOptions, currentNodeVersion, userNodeVersion, nodePath, logs }));
 };
-const addPluginNodeVersion = function ({ pluginOptions, pluginOptions: { loadedFrom }, currentNodeVersion, userNodeVersion, nodePath, }) {
+const addPluginNodeVersion = function ({ pluginOptions, pluginOptions: { loadedFrom, packageName }, currentNodeVersion, userNodeVersion, nodePath, logs, }) {
+    // if the plugin is a local one and the users node version does not satisfy
+    // our minimum required node version log a warning as we will default to the system node version
+    if ((loadedFrom === 'local' || loadedFrom === 'package.json') &&
+        !semver.satisfies(userNodeVersion, MINIMUM_REQUIRED_NODE_VERSION)) {
+        logWarningSubHeader(logs, `Warning: ${packageName} will be executed with Node.js version ${currentNodeVersion} in the future`);
+        logWarning(logs, `  The plugin cannot be executed with your defined Node.js version ${userNodeVersion} in the future.
+  Starting December 5th 2022 our minimum required Node version range for executing plugins will be: ${MINIMUM_REQUIRED_NODE_VERSION}
+
+  Read more about our minimum required version in our ${link('forums announcement', 'https://answers.netlify.com/t/build-plugins-dropping-support-for-node-js-12/79421')}`);
+    }
     return (loadedFrom === 'local' || loadedFrom === 'package.json') &&
-        semver.satisfies(userNodeVersion, MINIMUM_REQUIRED_NODE_VERSION)
+        semver.satisfies(userNodeVersion, OLD_MINIMUM_REQUIRED_NODE_VERSION)
         ? { ...pluginOptions, nodePath, nodeVersion: userNodeVersion }
         : { ...pluginOptions, nodePath: execPath, nodeVersion: currentNodeVersion };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netlify/build",
-  "version": "28.3.1",
+  "version": "28.4.0",
   "description": "Netlify build module",
   "type": "module",
   "exports": "./lib/core/main.js",
@@ -109,6 +109,7 @@
     "string-width": "^5.0.0",
     "strip-ansi": "^7.0.0",
     "supports-color": "^9.0.0",
+    "terminal-link": "^3.0.0",
     "tmp-promise": "^3.0.2",
     "ts-node": "^10.6.0",
     "typescript": "^4.8.4",
@@ -148,5 +149,5 @@
       "module": "commonjs"
     }
   },
-  "gitHead": "778bfe266735cbe5f545657e3acfd8b6bb646ed2"
+  "gitHead": "0f1f3ee7946a43698c7a6b45e3ce53dd79cd065d"
 }