feat(cli): Enforce a node version via toml option

packages/cli/src/index.js

@@ -35,6 +35,7 @@ import * as upgradeCommand from './commands/upgrade'
 import { getPaths, findUp } from './lib'
 import { exitWithError } from './lib/exit'
 import * as updateCheck from './lib/updateCheck'
+import { enforceNodeVersionConfig } from './middleware/enforceNodeVersionConfig'
 import { loadPlugins } from './plugin'
 import { startTelemetry, shutdownTelemetry } from './telemetry/index'
 
@@ -171,6 +172,7 @@ async function runYargs() {
           delete argv.telemetry
         },
         telemetry && telemetryMiddleware,
+        enforceNodeVersionConfig,
         updateCheck.isEnabled() && updateCheck.updateCheckMiddleware,
       ].filter(Boolean)
     )

packages/cli/src/middleware/enforceNodeVersionConfig.js

@@ -0,0 +1,39 @@
+import boxen from 'boxen'
+import semver from 'semver'
+
+import { getConfig } from '@redwoodjs/project-config'
+
+export async function enforceNodeVersionConfig() {
+  // only check if a node version is specified in redwood.toml
+  const config = getConfig()
+  if (config.node.version !== undefined) {
+    // get current node version, coerce to semver to remove leading 'v'
+    const currentVersion = semver.coerce(process.version)
+
+    // ensure config value is valid, either a valid semver or semver range
+    const requiredVersion = config.node.version
+    if (
+      semver.valid(requiredVersion) === null &&
+      semver.validRange(requiredVersion) === null
+    ) {
+      console.error(
+        boxen(
+          `Node version '${requiredVersion}' is not valid in your redwood.toml`,
+          { padding: 1, borderColor: 'red', title: 'Node version enforcement' }
+        )
+      )
+      process.exit(1)
+    }
+
+    // ensure current version satisfies required version
+    if (!semver.satisfies(currentVersion, requiredVersion)) {
+      console.error(
+        boxen(
+          `Node version '${currentVersion}' is not allowed by your redwood.toml, it requires '${requiredVersion}'`,
+          { padding: 1, borderColor: 'red', title: 'Node version enforcement' }
+        )
+      )
+      process.exit(1)
+    }
+  }
+}

packages/project-config/src/__tests__/config.test.ts

@@ -81,6 +81,9 @@ describe('getConfig', () => {
           "stories": true,
           "tests": true,
         },
+        "node": {
+          "version": undefined,
+        },
         "notifications": {
           "versionUpdates": [],
         },

packages/project-config/src/config.ts

@@ -93,6 +93,9 @@ export interface Config {
   notifications: {
     versionUpdates: string[]
   }
+  node: {
+    version?: string
+  }
   experimental: {
     opentelemetry: {
       enabled: boolean
@@ -156,6 +159,9 @@ const DEFAULT_CONFIG: Config = {
   notifications: {
     versionUpdates: [],
   },
+  node: {
+    version: undefined,
+  },
   experimental: {
     opentelemetry: {
       enabled: false,