Added a Node.js runtime check for the CLI dev command

Author: ericallam

.changeset/odd-poets-own.md

@@ -0,0 +1,5 @@
+---
+"trigger.dev": patch
+---
+
+Added a Node.js runtime check for the CLI

packages/cli-v3/src/commands/dev.tsx

@@ -40,6 +40,7 @@ import { isLoggedIn } from "../utilities/session.js";
 import { createTaskFileImports, gatherTaskFiles } from "../utilities/taskFiles";
 import { UncaughtExceptionError } from "../workers/common/errors";
 import { BackgroundWorker, BackgroundWorkerCoordinator } from "../workers/dev/backgroundWorker.js";
+import { runtimeCheck } from "../utilities/runtimeCheck";
 
 let apiClient: CliApiClient | undefined;
 
@@ -72,7 +73,18 @@ export function configureDevCommand(program: Command) {
   });
 }
 
+const MINIMUM_NODE_MAJOR = 18;
+const MINIMUM_NODE_MINOR = 16;
+
 export async function devCommand(dir: string, options: DevCommandOptions) {
+  try {
+    runtimeCheck(MINIMUM_NODE_MAJOR, MINIMUM_NODE_MINOR);
+  } catch (e) {
+    logger.log(`${chalkError("X Error:")} ${e}`);
+    process.exitCode = 1;
+    return;
+  }
+
   const authorization = await isLoggedIn(options.profile);
 
   if (!authorization.ok) {

packages/cli-v3/src/utilities/runtimeCheck.ts

@@ -0,0 +1,28 @@
+import { logger } from "./logger";
+
+/**
+ * This function is used by the dev CLI to make sure that the runtime is compatible
+ */
+export function runtimeCheck(minimumMajor: number, minimumMinor: number) {
+  // Check if the runtime is Node.js
+  if (typeof process === "undefined") {
+    throw "The dev CLI can only be run in a Node.js compatible environment";
+  }
+
+  // Check if the runtime version is compatible
+  const [major = 0, minor = 0] = process.versions.node.split(".").map(Number);
+
+  const isBun = typeof process.versions.bun === "string";
+
+  if (major < minimumMajor || (major === minimumMajor && minor < minimumMinor)) {
+    if (isBun) {
+      throw `The dev CLI requires at least Node.js ${minimumMajor}.${minimumMinor}. You are running Bun ${process.versions.bun}, which is compatible with Node.js ${process.versions.node}`;
+    } else {
+      throw `The dev CLI requires at least Node.js ${minimumMajor}.${minimumMinor}. You are running Node.js ${process.versions.node}`;
+    }
+  }
+
+  logger.debug(
+    `Node.js version: ${process.versions.node}${isBun ? ` (Bun ${process.versions.bun})` : ""}`
+  );
+}