feat!: upgrade support to node 22 and 24

.evergreen.yml

@@ -14,8 +14,13 @@ functions:
           set -e
           set -x
 
-          export NODE_VERSION=20.13.0
-          bash .evergreen/install-node.sh
+          if [ "$OS" == "Windows_NT" ]; then
+            export NODE_GYP_FORCE_PYTHON="C:\python\Python311\python.exe"
+            export PATH="/cygdrive/c/python/Python311/Scripts:/cygdrive/c/python/Python311:$PATH"
+          fi
+
+          export NODE_VERSION=22.17.0
+          . .evergreen/install-node.sh
   install:
     - command: shell.exec
       params:
@@ -25,17 +30,29 @@ functions:
           set -e
           set -x
 
+          if [ "$OS" == "Windows_NT" ]; then
+            export NODE_GYP_FORCE_PYTHON="C:\python\Python311\python.exe"
+            export PATH="/cygdrive/c/python/Python311/Scripts:/cygdrive/c/python/Python311:$PATH"
+          fi
+
           . .evergreen/use-node.sh
           npm install
   check:
     - command: shell.exec
       params:
         working_dir: src
         shell: bash
+        env:
+          NODE_VERSION: ${node_version}
         script: |
           set -e
           set -x
 
+          if [ "$OS" == "Windows_NT" ]; then
+            export NODE_GYP_FORCE_PYTHON="C:\python\Python311\python.exe"
+            export PATH="/cygdrive/c/python/Python311/Scripts:/cygdrive/c/python/Python311:$PATH"
+          fi
+
           . .evergreen/use-node.sh
           npm run build
           npm run lint
@@ -51,10 +68,29 @@ functions:
           AZURE_TEST_CONFIG: ${azure_test_config}
           AZURE_TEST_CREDENTIALS: ${azure_test_credentials}
           DISTRO_ID: ${distro_id}
+          BOXEDNODE_DCHECKS_ENABLED: ${dchecks_enabled}
         script: |
           set -e
           set -x
 
+          if [ `uname` == "Darwin" ]; then
+            # the CI macOS machines have an outdated Clang that
+            # cannot build recent Node.js versions, so we use
+            # the LLVM version installed via Homebrew
+            # (both on arm64 and x64)
+
+            LLVM_PREFIX="$(brew --prefix llvm)"
+            export PATH="$LLVM_PREFIX/bin:$PATH"
+            export CC="$LLVM_PREFIX/bin/clang"
+            export CXX="$LLVM_PREFIX/bin/clang++"
+            export LDFLAGS="-L$LLVM_PREFIX/lib -L$LLVM_PREFIX/lib/c++ -L$LLVM_PREFIX/lib/unwind"
+            export CPPFLAGS="-I$LLVM_PREFIX/include"
+            export CMAKE_PREFIX_PATH="$LLVM_PREFIX"
+
+            $CC --version
+            $CXX --version
+          fi
+
           rm -rf /tmp/m && mkdir -pv /tmp/m # Node.js compilation can fail on long path prefixes
           trap "rm -rf /tmp/m" EXIT
           export TMP=/tmp/m
@@ -64,49 +100,81 @@ functions:
           # able to compile OpenSSL with assembly support,
           # so we revert back to the slower version.
           if [ "$OS" == "Windows_NT" ]; then
-            export PATH="/cygdrive/c/python/Python310/Scripts:/cygdrive/c/python/Python310:/cygdrive/c/Python310/Scripts:/cygdrive/c/Python310:$PATH"
+            export NODE_GYP_FORCE_PYTHON="C:\python\Python311\python.exe"
+            export PATH="/cygdrive/c/python/Python311/Scripts:/cygdrive/c/python/Python311:$PATH"
             export BOXEDNODE_CONFIGURE_ARGS='openssl-no-asm'
           elif uname -a | grep -q 'Darwin.*x86_64'; then
             export BOXEDNODE_CONFIGURE_ARGS='--openssl-no-asm'
           fi
 
           . .evergreen/use-node.sh
-          npm run build
-          TEST_NODE_VERSION="$TEST_NODE_VERSION" npm run test-ci
+          export TEST_NODE_VERSION="$TEST_NODE_VERSION"
+          if [ "$OS" == "Windows_NT" ]; then
+            # The CI machines we have for Windows don't have a working
+            # installation of VS2022, (vswhere.exe can't find the correct path)
+            # So we run the scripts to set up the environment manually, and they
+            # only work properly in CMD
+            WIN_PATH=$(cygpath -aw .evergreen/test-in-vcdev-env.bat)
+            cmd.exe /c "$WIN_PATH"
+          else
+            npm run build
+            npm run test-ci
+          fi
 
 tasks:
-  - name: test_n14
+  - name: test_n20
     commands:
       - func: checkout
       - func: install_node
       - func: install
       - func: test
         vars:
-          node_version: "14.21.3"
-  - name: test_n16
+          node_version: "20.19.5"
+  - name: test_n22
     commands:
       - func: checkout
       - func: install_node
       - func: install
       - func: test
         vars:
-          node_version: "16.20.1"
-  - name: test_n18
+          node_version: "22.21.0"
+  - name: test_n24
     commands:
       - func: checkout
       - func: install_node
       - func: install
       - func: test
         vars:
-          node_version: "18.17.0"
-  - name: test_n20
+          node_version: "24.10.0"
+
+  - name: test_n20_dchecks
+    commands:
+      - func: checkout
+      - func: install_node
+      - func: install
+      - func: test
+        vars:
+          node_version: "20.19.5"
+          dchecks_enabled: 1
+  - name: test_n22_dchecks
     commands:
       - func: checkout
       - func: install_node
       - func: install
       - func: test
         vars:
-          node_version: "20.13.0"
+          node_version: "22.21.0"
+          dchecks_enabled: 1
+  - name: test_n24_dchecks
+    commands:
+      - func: checkout
+      - func: install_node
+      - func: install
+      - func: test
+        vars:
+          node_version: "24.10.0"
+          dchecks_enabled: 1
+
   - name: check
     commands:
       - func: checkout
@@ -119,32 +187,35 @@ buildvariants:
     display_name: 'Ubuntu 20.04 x64'
     run_on: ubuntu2004-large
     tasks:
-      - test_n14
-      - test_n16
-      - test_n18
       - test_n20
+      - test_n22
+      - test_n24
       - check
+  - name: ubuntu_arm64_dchecks
+    display_name: 'Ubuntu 24.04 arm64 (Node.js/V8 DCHECKs)'
+    run_on: ubuntu2404-arm64-latest-xlarge
+    tasks:
+      - test_n20_dchecks
+      - test_n22_dchecks
+      - test_n24_dchecks
   - name: macos_x64_test
-    display_name: 'macOS 11.00 x64'
-    run_on: macos-1100
+    display_name: 'macOS 14.00 x64'
+    run_on: macos-14
     tasks:
-      - test_n14
-      - test_n16
-      - test_n18
       - test_n20
+      - test_n22
+      - test_n24
   - name: macos_arm64_test
-    display_name: 'macOS 11.00 arm64'
-    run_on: macos-1100-arm64
+    display_name: 'macOS 14.00 arm64'
+    run_on: macos-14-arm64
     tasks:
-      - test_n14
-      - test_n16
-      - test_n18
       - test_n20
+      - test_n22
+      - test_n24
   - name: windows_x64_test
     display_name: 'Windows x64'
-    run_on: windows-vsCurrent-xlarge
+    run_on: windows-2022-xlarge
     tasks:
-      - test_n14
-      - test_n16
-      - test_n18
       - test_n20
+      - test_n22
+      - test_n24

.evergreen/install-node.sh

@@ -3,11 +3,14 @@
 set -e
 set -x
 
+# so we use the devtools binaries first (for gcc/g++)
+export PATH="/opt/devtools/bin:$PATH"
+
 export BASEDIR="$PWD"
 mkdir -p .deps
 cd .deps
 
-NVM_URL="https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh"
+NVM_URL="https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh"
 
 # this needs to be explicitly exported for the nvm install below
 export NVM_DIR="$PWD/nvm"
@@ -21,12 +24,18 @@ if [[ "$OS" == "Windows_NT" ]]; then
   mv -v node-v$NODE_VERSION-win-x64/* node/bin
   chmod a+x node/bin/*
   export PATH="$PWD/node/bin:$PATH"
-# install Node.js on Linux/MacOS
 else
-  curl -o- $NVM_URL | bash
-  set +x
-  [ -s "${NVM_DIR}/nvm.sh" ] && source "${NVM_DIR}/nvm.sh"
-  nvm install --no-progress "$NODE_VERSION"
+    if [ "$(uname -s)" == "Darwin" ] ; then # install Node.js on MacOS
+        curl -o- $NVM_URL | bash
+        set +x
+        [ -s "${NVM_DIR}/nvm.sh" ] && source "${NVM_DIR}/nvm.sh"
+        nvm install --no-progress "$NODE_VERSION"
+    else # Linux already has its own toolchain in evergreen
+        mkdir -p node
+        NODE_MAJOR=$(echo $NODE_VERSION | awk -F . '{print $1}')
+        ln -s "/opt/devtools/node$NODE_MAJOR/bin/" "$PWD/node/bin"
+        export PATH="$PWD/node/bin:$PATH"
+    fi
 fi
 
 which node && node -v || echo "node not found, PATH=$PATH"

.evergreen/test-in-vcdev-env.bat

@@ -0,0 +1,6 @@
+CALL "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvars64.bat"
+REM APPDATA is empty in CMD, and npm requires it to be a valid path
+SET APPDATA="npm-cache"
+
+CALL npm run build
+CALL npm run test-ci

.evergreen/use-node.sh

@@ -1,8 +1,16 @@
 if [[ "$OS" == "Windows_NT" ]]; then
-  export PATH="$PWD/.deps/node/bin:$PATH"
+    export APPDATA="npm-cache"
+    export PATH="$PWD/.deps/node/bin:$PATH"
 else
-  export NVM_DIR="$PWD/.deps/nvm"
-  [ -s "$NVM_DIR/nvm.sh" ] && source "$NVM_DIR/nvm.sh"
+    # so we use the devtools binaries first (for gcc/g++)
+    export PATH="/opt/devtools/bin:$PATH"
+
+    if [ "$(uname -s)" == "Darwin" ] ; then # in OSX use nvm
+        export NVM_DIR="$PWD/.deps/nvm"
+        [ -s "$NVM_DIR/nvm.sh" ] && source "$NVM_DIR/nvm.sh"
+    else # In Linux, use .deps/node/bin because it was set up with symlink to an existing node in the toolchain
+        export PATH="$PWD/.deps/node/bin:$PATH"
+    fi
 fi
 
 echo "updated PATH=$PATH"

.github/workflows/codeql.yml

@@ -42,13 +42,13 @@ jobs:
     - name: Checkout repository
       uses: actions/checkout@v3
 
-    - name: Use Node.js v18.x
+    - name: Use Node.js v24.x
       if: matrix.language == 'cpp'
-      uses: actions/setup-node@8f152de45cc393bb48ce5d89d36b731f54556e65 # v4.0.0
+      uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 18.x
+        node-version: 24.x
 
-    - name: Use Node.js v18.x
+    - name: Use Node.js v24.x
       if: matrix.language == 'cpp'
       run: |
         npm install

.github/workflows/nodejs.yml

@@ -1,3 +1,7 @@
+# This is a generated file. Please change .github/workflows/nodejs.yml.in
+# and run the following command to update the GHA Workflow
+# $> npm run update-gha-workflow
+# --------------------
 on: [pull_request]
 
 name: CI
@@ -13,19 +17,55 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        node-version: [14.x, 16.x, 18.x, 20.x]
+        node-version: [20.x, 22.x, 24.x]
+        test-to-run: ["works in a simple case","works with a Nan addon","works with a N-API addon","passes through env vars and runs the pre-compile hook","works with code caching support","works with snapshot support (compressBlobs = "]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v5
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v6
         with:
           check-latest: true
           node-version: ${{ matrix.node-version }}
-      - name: Install npm@8.x
-        if: ${{ matrix.node-version == '14.x' }}
-        run: npm install -g npm@8.x
       - name: Install Dependencies
         run: npm install
+      - name: Lint
+        run: npm run lint
+      - name: Build
+        run: npm run build
       - name: Test
-        run: npm test
+        run: npm run test-ci -- -f "${{ matrix.test-to-run }}"
+
+  test-windows:
+    name: Windows tests
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest]
+        node-version: [20.x, 22.x, 24.x]
+        vs-version: ['17'] # 17 => VS2022
+        test-to-run: ["works in a simple case","works with a Nan addon","works with a N-API addon","passes through env vars and runs the pre-compile hook","works with code caching support","works with snapshot support (compressBlobs = "]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v5
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v6
+        with:
+          check-latest: true
+          node-version: ${{ matrix.node-version }}
+      - uses: microsoft/setup-msbuild@v2
+        name: Setup MSBuild
+        with:
+          vs-version: ${{ matrix.vs-version }}
+          msbuild-architecture: x64
+      - name: Install Dependencies
+        run: npm install
+      - name: Lint
+        run: npm run lint
+      - name: Build
+        run: npm run build
+      - name: Test
+        run: npm run test-ci -- -f "${{ matrix.test-to-run }}"
+        env:
+          BOXEDNODE_MAKE_ARGS: "debug"
+