Better errors for zshy Node.js version requirement (#41405)

GitOrigin-RevId: b4e240c570138c377385807e289c2c696dd877a0

Author: thomasballinger

npm-packages/@convex-dev/codemod/package.json

@@ -15,7 +15,7 @@
     }
   },
   "scripts": {
-    "build": "zshy",
+    "build": "node version-check.mjs && zshy",
     "test": "vitest",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"

npm-packages/@convex-dev/codemod/version-check.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// Until https://github.com/colinhacks/zshy/issues/34 is resolved show a nicer error for the wrong Node.js version
+
+const v = process.versions.node;
+const [maj, min, pat] = v.split(".").map(Number);
+
+if (
+  maj < 20 ||
+  (maj === 20 && min < 19) ||
+  (maj === 22 && (min < 12 || (min === 12 && pat < 0)))
+) {
+  console.error(
+    `Node.js ${v} does not support synchronous require() of ESM. Need 20.19.0+, 22.12.0+, or 23+`,
+  );
+  process.exit(1);
+}

npm-packages/@convex-dev/platform/package.json

@@ -5,7 +5,7 @@
   "description": "",
   "type": "module",
   "scripts": {
-    "build": "npm run generateApiSpec && zshy",
+    "build": "npm run generateApiSpec && node version-check.mjs && zshy",
     "prepack": "node -e \"if (process.env.npm_config_user_agent && !process.env.npm_config_user_agent.startsWith('pnpm')) { console.error('❌ Use pnpm publish instead of npm publish'); process.exit(1); }\"",
     "test": "echo 0",
     "typecheck": "tsc --noEmit",

npm-packages/@convex-dev/platform/version-check.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// Until https://github.com/colinhacks/zshy/issues/34 is resolved show a nicer error for the wrong Node.js version
+
+const v = process.versions.node;
+const [maj, min, pat] = v.split(".").map(Number);
+
+if (
+  maj < 20 ||
+  (maj === 20 && min < 19) ||
+  (maj === 22 && (min < 12 || (min === 12 && pat < 0)))
+) {
+  console.error(
+    `Node.js ${v} does not support synchronous require() of ESM. Need 20.19.0+, 22.12.0+, or 23+`,
+  );
+  process.exit(1);
+}

npm-packages/@convex-dev/workos/package.json

@@ -4,7 +4,7 @@
   "description": "Helper for authenticating a Convex client via WorkOS AuthKit",
   "type": "module",
   "scripts": {
-    "build": "zshy",
+    "build": "node version-check.mjs && zshy",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },

npm-packages/@convex-dev/workos/version-check.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// Until https://github.com/colinhacks/zshy/issues/34 is resolved show a nicer error for the wrong Node.js version
+
+const v = process.versions.node;
+const [maj, min, pat] = v.split(".").map(Number);
+
+if (
+  maj < 20 ||
+  (maj === 20 && min < 19) ||
+  (maj === 22 && (min < 12 || (min === 12 && pat < 0)))
+) {
+  console.error(
+    `Node.js ${v} does not support synchronous require() of ESM. Need 20.19.0+, 22.12.0+, or 23+`,
+  );
+  process.exit(1);
+}