feat!: drop support for Node.js <=v20 (#22)

BREAKING CHANGE: Node.js <= 20 is no longer supported.

Author: derevnjuk

.github/workflows/deploy.yml

@@ -15,44 +15,43 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: macos-12
+          - os: macos-15
             label: x64+arm64
             node_arch: x64
             command: build:gyp
             args: --arch x64+arm64
-          - os: windows-2019
-            label: x86
-            node_arch: x86
-            command: build:gyp
-          - os: windows-2019
+          - os: windows-2022
             label: x64
             node_arch: x64
             command: build:gyp
-          - os: ubuntu-20.04
+          - os: ubuntu-22.04
+            label: linux-glibc
+            command: build:gyp-cross
+            args: -i almalinux-devtoolset11
+          - os: ubuntu-22.04
             label: alpine
             command: build:gyp-cross
-            args: -i centos7-devtoolset7 -i alpine
-          - os: ubuntu-20.04
-            label: armv6+armv7
+            args: -i alpine
+          - os: ubuntu-22.04
+            label: linux-arm
             command: build:gyp-cross
-            args: -i linux-arm64-lts -i linux-armv7 -i linux-armv6
-          - os: ubuntu-20.04
-            label: musl+arm64-musl
+            args: -i linux-arm64 -i linux-armv7 -i linux-armv6
+          - os: ubuntu-22.04
+            label: linux-arm-musl
             command: build:gyp-cross
-            args: --tag-libc musl -i linux-arm64-musl
-          - os: ubuntu-20.04
-            label: arm64+armv7
+            args: -i linux-arm64-musl -i linux-armv7l-musl
+          - os: ubuntu-22.04
+            label: android-arm
             command: build:gyp-cross
             args: -i android-arm64 -i android-armv7
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ env.TARGET_REF }}
-          token: ${{ secrets.GPR_TOKEN }}
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
           architecture: ${{ matrix.node_arch }}
 
       - name: Install dependencies
@@ -80,15 +79,18 @@ jobs:
   deploy:
     needs: merge
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      id-token: write
     steps:
       - uses: actions/checkout@v4
         with:
           ref: ${{ env.TARGET_REF }}
-          token: ${{ secrets.GPR_TOKEN }}
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
           registry-url: 'https://registry.npmjs.org'
 
       - uses: actions/download-artifact@v4
@@ -100,17 +102,15 @@ jobs:
         run: npm ci
 
       - name: Publish to npm
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --provenance
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
           registry-url: 'https://npm.pkg.github.com'
           scope: '@NeuraLegion'
 
       - name: Publish to GPR
         run: npm publish
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.GPR_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -7,15 +7,18 @@ on:
 
 jobs:
   release:
+    permissions:
+      contents: write
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
+          fetch-depth: 0
           token: ${{ secrets.GPR_TOKEN }}
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
 
       - run: npm ci --ignore-scripts
       - run: npm run semantic-release

.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        node-version: [20, 22, 23, 24]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      # unfortunately, raw sockets require elevated privileges to run tests, and neither capabilities nor sudo are supported on Linux runners
+      - name: Set raw socket capability (Linux)
+        if: runner.os == 'Linux'
+        run: sudo setcap cap_net_raw,cap_net_admin,cap_net_bind_service+eip $(which node)
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests (Mac)
+        if: runner.os == 'macOS'
+        run: sudo npm test
+      
+      - name: Run tests
+        if: runner.os != 'macOS'
+        run: npm test

.gitignore

@@ -3,3 +3,4 @@ build
 .idea
 node_modules
 npm-debug.log
+index.cjs*

binding.gyp

@@ -1,8 +1,4 @@
 {
-  "variables": {
-    "openssl_fips": "",
-    "android_ndk_path": ""
-  },
   "targets": [
     {
       "target_name": "raw_socket",
@@ -12,20 +8,17 @@
       "include_dirs": [
         "<!(node -e \"require('nan')\")"
       ],
+      "cflags_cc": [
+        "-std=c++20"
+      ],
       "conditions": [
         [
           "OS==\"mac\"",
           {
             "xcode_settings": {
-              "MACOSX_DEPLOYMENT_TARGET": "10.7",
-              "OTHER_CFLAGS": [
-                "-arch x86_64",
-                "-arch arm64"
-              ],
-              "OTHER_LDFLAGS": [
-                "-arch x86_64",
-                "-arch arm64"
-              ]
+              "MACOSX_DEPLOYMENT_TARGET": "14.0",
+              "CLANG_CXX_LANGUAGE_STANDARD": "c++20",
+              "GCC_ENABLE_CPP_EXCEPTIONS": "YES"
             }
           }
         ],
@@ -34,7 +27,12 @@
           {
             "libraries": [
               "ws2_32.lib"
-            ]
+            ],
+            "msvs_settings": {
+              "VCCLCompilerTool": {
+                "AdditionalOptions": ["/std:c++20"]
+              }
+            }
           }
         ]
       ]

example/create-checksum.js

@@ -0,0 +1,22 @@
+import { createChecksum } from '../index.mjs';
+
+const buffer1 = Buffer.from([
+  0x08, 0x00, 0x00, 0x00, 0x00, 0x01, 0x0a, 0x09,
+  0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68,
+  0x69, 0x6a, 0x6b, 0x6c, 0x6d, 0x6e, 0x6f, 0x70
+]);
+
+const buffer2 = Buffer.from([
+  0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x61,
+  0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69
+]);
+
+const option1 = {
+  buffer: buffer1,
+  offset: 0,
+  length: buffer1.length
+};
+
+const sum = createChecksum(option1, buffer2);
+
+console.log(sum.toString(16));

example/create-checksum.mjs

@@ -0,0 +1,25 @@
+import { Protocol, SocketLevel, SocketOption, createSocket } from '../index.mjs';
+
+if (process.argv.length < 4) {
+  console.log('node get-option <name> <option>');
+  process.exit(-1);
+}
+
+let level = process.argv[2];
+let option = process.argv[3];
+
+level = SocketLevel[level] || parseInt(level, 10);
+option = SocketOption[option] || parseInt(option, 10);
+
+const options = {
+  protocol: Protocol.ICMP
+};
+
+const socket = createSocket(options);
+
+const buffer = Buffer.alloc(4096);
+const len = socket.getOption(level, option, buffer, buffer.length);
+
+socket.pauseSend().pauseRecv();
+
+console.log(buffer.toString('hex', 0, len));