fix: resolve Node.js 20.x compatibility issues in GitHub Actions

- Add tsconfig.node20.json with CommonJS module configuration for Node.js 20.x
- Install tsx package for better ESM compatibility in Node.js 20.x
- Update package.json scripts to use tsx for Node.js 20.x development mode
- Modify GitHub Actions workflow to use appropriate dev scripts for each Node.js version
- Update test files to handle Node.js 20.x development mode correctly
- Ensure all tests continue to pass locally and in CI

This fix addresses the ERR_UNKNOWN_FILE_EXTENSION errors that were causing
Node.js 20.x tests to fail in GitHub Actions while maintaining compatibility
with Node.js 18.x and 22.x.

Node.js Version Compatibility:
- 22.x: Uses ts-node with ESM (tsconfig.dev.json)
- 20.x: Uses tsx with CommonJS (tsconfig.node20.json)
- 18.x: Uses ts-node with CommonJS (tsconfig.node18.json)
- <18.x: Uses ts-node with CommonJS (tsconfig.compat.json)

Change-Id: I4f97f23781fe588a074e5df67595e7b99cc84338
Co-developed-by: Cursor <noreply@cursor.com>

Author: jiangxin

.github/workflows/test.yml

@@ -52,9 +52,12 @@ jobs:
         NODE_VERSION=$(node --version | cut -d. -f1 | tr -d v)
         echo "Testing development mode for Node.js $NODE_VERSION"
         
-        if [ "$NODE_VERSION" -ge 20 ]; then
+        if [ "$NODE_VERSION" -eq 22 ]; then
           echo "Testing with npm run dev"
           npm run dev -- --version
+        elif [ "$NODE_VERSION" -eq 20 ]; then
+          echo "Testing with npm run dev:node20"
+          npm run dev:node20 -- --version
         elif [ "$NODE_VERSION" -eq 18 ]; then
           echo "Testing with npm run dev:node18"
           npm run dev:node18 -- --version

package-lock.json

@@ -12,6 +12,7 @@
     "dev": "NODE_ENV=development NODE_OPTIONS=--no-warnings npx ts-node --esm --transpileOnly --prefer-ts-exts --project tsconfig.dev.json src/bin/commit-msg.dev.ts",
     "dev:compat": "NODE_ENV=development NODE_OPTIONS=--no-warnings npx ts-node --transpileOnly --project tsconfig.compat.json src/bin/commit-msg.dev.ts",
     "dev:node18": "NODE_ENV=development NODE_OPTIONS=--no-warnings npx ts-node --transpileOnly --project tsconfig.node18.json src/bin/commit-msg.dev.ts",
+    "dev:node20": "NODE_ENV=development NODE_OPTIONS=--no-warnings npx tsx src/bin/commit-msg.dev.ts",
     "test": "vitest run",
     "test:compat": "node scripts/test-compatibility.js",
     "format": "npx prettier --write src/ test/",

package.json

@@ -8,11 +8,13 @@ import * as os from 'os';
 const nodeVersion = process.version;
 const nodeMajorVersion = parseInt(nodeVersion.split('.')[0].replace('v', ''));
 const devScript =
-  nodeMajorVersion >= 20
+  nodeMajorVersion === 22
     ? 'dev'
-    : nodeMajorVersion === 18
-      ? 'dev:node18'
-      : 'dev:compat';
+    : nodeMajorVersion === 20
+      ? 'dev:node20'
+      : nodeMajorVersion === 18
+        ? 'dev:node18'
+        : 'dev:compat';
 
 describe('commit-msg CLI npm pack tests', () => {
   const tempDir = path.join(os.tmpdir(), 'commit-msg-pack-test');

test/pack.test.ts

@@ -6,11 +6,13 @@ import { execSync } from 'child_process';
 const nodeVersion = process.version;
 const nodeMajorVersion = parseInt(nodeVersion.split('.')[0].replace('v', ''));
 const devScript =
-  nodeMajorVersion >= 20
+  nodeMajorVersion === 22
     ? 'dev'
-    : nodeMajorVersion === 18
-      ? 'dev:node18'
-      : 'dev:compat';
+    : nodeMajorVersion === 20
+      ? 'dev:node20'
+      : nodeMajorVersion === 18
+        ? 'dev:node18'
+        : 'dev:compat';
 
 describe('commit-msg CLI --version tests', () => {
   // Test development mode --version

test/version.test.ts

@@ -0,0 +1,22 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "target": "ES2022",
+    "lib": ["ES2022"]
+  },
+  "ts-node": {
+    "transpileOnly": true,
+    "preferTsExts": true,
+    "esm": false,
+    "compilerOptions": {
+      "module": "CommonJS",
+      "moduleResolution": "node",
+      "target": "ES2022",
+      "lib": ["ES2022"]
+    }
+  }
+}