Remove Node 20 support, harden engine requirements (#280)

* Add .node-version, fix minimumReleaseAge config for pnpm

* Switch back to Node 22, add tests for 24, harden engine reqs

* fix node 20 refs

* fix comment

Author: esimkowitz

.github/workflows/ci.yml

@@ -106,11 +106,11 @@ jobs:
       - name: Enable Corepack
         run: corepack enable
 
-      # Setup Node.js
+      # Setup Node.js (version pinned in .node-version)
       - name: Setup Node
         uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version-file: .node-version
           cache: pnpm
 
       # Install Node.js dependencies

.github/workflows/formatting.yml

@@ -31,7 +31,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version-file: .node-version
           cache: pnpm
 
       - name: Install Node.js dependencies

.github/workflows/linting.yml

@@ -63,7 +63,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version-file: .node-version
           cache: pnpm
 
       - name: Install Node.js dependencies

.github/workflows/release.yml

@@ -6,6 +6,17 @@ on:
       - "v*.*.*" # Trigger on version tags like v1.2.3
 
 jobs:
+  setup:
+    name: Resolve primary Node version
+    runs-on: ubuntu-latest
+    permissions: {}
+    outputs:
+      primary-node: ${{ steps.read.outputs.version }}
+    steps:
+      - uses: actions/checkout@v6
+      - id: read
+        run: echo "version=$(cat .node-version)" >> "$GITHUB_OUTPUT"
+
   build-napi:
     name: Build N-API modules
     runs-on: ${{ matrix.settings.host }}
@@ -48,7 +59,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version-file: .node-version
           cache: pnpm
       - name: Setup Rust
         uses: actions-rust-lang/setup-rust-toolchain@v1
@@ -96,16 +107,17 @@ jobs:
           if-no-files-found: error
 
   test-targets:
-    name: Cross-runtime test on ${{ matrix.settings.target }}
+    name: Cross-runtime test on ${{ matrix.settings.target }} (Node ${{ matrix.node }})
     runs-on: ${{ matrix.settings.host }}
-    needs: build-napi
+    needs: [build-napi, setup]
     permissions: {}
     defaults:
       run:
         shell: bash
     strategy:
       fail-fast: false
       matrix:
+        node: [22, 24]
         settings:
           - host: macos-15-intel
             target: x86_64-apple-darwin
@@ -147,7 +159,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version: ${{ matrix.node }}
           cache: pnpm
       - name: Setup Rust
         uses: actions-rust-lang/setup-rust-toolchain@v1
@@ -175,7 +187,14 @@ jobs:
         run: pnpm install --frozen-lockfile
       - name: Run comprehensive tests (includes compilation)
         run: |
-          if [ -n "${{ matrix.settings.test_runtimes }}" ]; then
+          # Only the primary Node version (sourced from .node-version via the
+          # setup job) runs the full cross-runtime suite. Other Node versions
+          # only re-run the Node runtime tests, since Rust/Deno/Bun results
+          # don't depend on the installed Node.
+          if [ "${{ matrix.node }}" != "${{ needs.setup.outputs.primary-node }}" ]; then
+            echo "Running Node-only tests for Node ${{ matrix.node }}"
+            task test -- node
+          elif [ -n "${{ matrix.settings.test_runtimes }}" ]; then
             echo "Running selective runtime tests: ${{ matrix.settings.test_runtimes }}"
             task test -- ${{ matrix.settings.test_runtimes }}
           else
@@ -205,7 +224,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v6
         with:
-          node-version: 24
+          node-version-file: .node-version
           registry-url: https://registry.npmjs.org/
           cache: pnpm
       - name: Install Node.js dependencies

.node-version

@@ -0,0 +1 @@
+22

.npmrc

@@ -1,2 +1 @@
 @jsr:registry=https://npm.jsr.io
-minimum-release-age=2880

CONTRIBUTING.md

@@ -80,8 +80,9 @@ target/                # Rust build artifacts
 
 3. **Node.js 22.13+** - Build scripts and N-API builds. Run `corepack enable`
    once to activate pnpm 11 (the version is pinned via the `packageManager`
-   field in `package.json`). pnpm 11 itself requires Node 22.13+ (consumers of
-   the published package only need Node 20+, per the `engines` field).
+   field in `package.json`). pnpm 11 itself requires Node 22.13+, which also
+   matches the minimum supported runtime version declared in the `engines`
+   field for consumers of the published package.
 
 **Optional (for testing specific runtimes):**
 

docs/CrossRuntimeSupport.md

@@ -22,8 +22,8 @@ The library automatically detects the current runtime and loads appropriate modu
 import { runtimeInfo } from "@printers/printers";
 
 console.log(runtimeInfo);
-// Node.js: { name: "node", isDeno: false, isNode: true, isBun: false, version: "20.x.x" }
-// Deno:    { name: "deno", isDeno: true, isNode: false, isBun: false, version: "1.x.x" }
+// Node.js: { name: "node", isDeno: false, isNode: true, isBun: false, version: "22.x.x" }
+// Deno:    { name: "deno", isDeno: true, isNode: false, isBun: false, version: "2.x.x" }
 // Bun:     { name: "bun", isDeno: false, isNode: false, isBun: true, version: "1.x.x" }
 ```
 

package.json

@@ -20,7 +20,9 @@
     ]
   },
   "engines": {
-    "node": ">= 20"
+    "node": ">= 22",
+    "deno": ">= 2.0",
+    "bun": ">= 1.0"
   },
   "repository": {
     "type": "git",

pnpm-workspace.yaml

@@ -1,2 +1,3 @@
 allowBuilds:
   esbuild: true
+minimumReleaseAge: 2880