[pull] master from sebi2k1:master

.devcontainer/devcontainer.json

@@ -0,0 +1,26 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.245.2/containers/docker-existing-dockerfile
+{
+	"name": "Existing Dockerfile",
+
+	// Sets the run context to one level up instead of the .devcontainer folder.
+	"context": "..",
+
+	// Update the 'dockerFile' property if you aren't using the standard 'Dockerfile' filename.
+	"dockerFile": "../Dockerfile"
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Uncomment the next line to run commands after the container is created - for example installing curl.
+	// "postCreateCommand": "apt-get update && apt-get install -y curl",
+
+	// Uncomment when using a ptrace-based debugger like C++, Go, and Rust
+	// "runArgs": [ "--cap-add=SYS_PTRACE", "--security-opt", "seccomp=unconfined" ],
+
+	// Uncomment to use the Docker CLI from inside the container. See https://aka.ms/vscode-remote/samples/docker-from-docker.
+	// "mounts": [ "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind" ],
+
+	// Uncomment to connect as a non-root user if you've added one. See https://aka.ms/vscode-remote/containers/non-root.
+	// "remoteUser": "vscode"
+}

.editorconfig

@@ -0,0 +1,25 @@
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = tab
+indent_size = 2
+charset = utf-8
+
+# 4 space indentation
+[*.py]
+indent_style = space
+indent_size = 2
+
+# Matches the exact files either package.json or any .yml
+[{*.json,*.yml,*.yaml}]
+indent_style = space
+indent_size = 2
+
+[*.{js,ts,jsx,tsx,html}]
+indent_style = tab
+indent_size = 2
+

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,67 @@
+name: Bug report
+description: Something isn't working as expected
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please fill in as much detail as you can.
+
+  - type: input
+    id: version
+    attributes:
+      label: socketcan version
+      description: Output of `npm list socketcan`
+    validations:
+      required: true
+
+  - type: input
+    id: node
+    attributes:
+      label: Node.js version
+      description: Output of `node --version`
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Linux distribution and kernel
+      description: e.g. Ubuntu 24.04, kernel 6.8.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: interface
+    attributes:
+      label: CAN interface type
+      options:
+        - Virtual (vcan)
+        - Physical hardware
+        - Both
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: A clear description of the bug.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: A short script or test case that reproduces the issue.
+      render: javascript
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,27 @@
+name: Feature request
+description: Suggest a new feature or improvement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the use case or limitation you're running into.
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What would you like to see added or changed?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Any workarounds or alternative approaches you've thought about.
+    validations:
+      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+## Summary
+
+<!-- What does this PR change and why? -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor / cleanup
+- [ ] Documentation
+- [ ] CI / tooling
+
+## Checklist
+
+- [ ] `npm run build:all` passes (or validated via `docker build -f Dockerfile.build-test .` on macOS)
+- [ ] `npm run lint` passes
+- [ ] Tests added or updated for changed behaviour
+- [ ] `npm test` passes (requires `sh prepare_test_env.sh` first)
+- [ ] CHANGELOG.md updated if this is a user-facing change

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

.github/workflows/cicd.yml

@@ -0,0 +1,50 @@
+name: Full build and test
+
+on: [ push, pull_request ]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [ 22.x, 24.x ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+          cache-dependency-path: package-lock.json
+
+      - name: Prepare Ubuntu
+        run: |
+          sudo apt-get install -y can-utils
+          sudo apt-get install -y libnode-dev
+          sudo apt-get install linux-modules-extra-$(uname -r)
+
+      - name: Prepare deps
+        run: |
+          npm ci
+
+      - name: Compile
+        run: |
+          npm run configure
+          npm run build:all
+
+      - name: Lint
+        run: |
+          npm run lint
+
+      - name: Perform tests
+        run: |
+          sh prepare_test_env.sh
+          npm run test

.github/workflows/npmpublish.yml

@@ -1,24 +1,47 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://help.github.com/actions/language-and-framework-guides/publishing-nodejs-packages
-
-name: Publish SocketCAN
+name: Publish on NPM
 
 on:
-  push:
-    branches:    
-      - master
-    paths:
-      - 'package.json'
+  release:
+    types: [published]
+
+permissions:
+  contents: read
 
 jobs:
-  build:
+  publish:
     runs-on: ubuntu-latest
+    environment: production
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v1
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
         with:
-          node-version: 12
-          registry-url: https://registry.npmjs.org/
-      - run: npm publish
+          node-version: 22
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Prepare Ubuntu
+        run: |
+          sudo apt-get install -y can-utils
+          sudo apt-get install -y libnode-dev
+          sudo apt-get install linux-modules-extra-$(uname -r)
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: |
+          npm run configure
+          npm run build:all
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Test
+        run: |
+          sh prepare_test_env.sh
+          npm test
+
+      - name: Publish
+        run: npm publish
         env:
-          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -1,7 +1,7 @@
 build
+dist
 node_modules
-npm-debug.log
-build/
-package-lock.json
 coverage
+
+npm-debug.log
 .nyc_output

.mocharc.js

@@ -8,5 +8,5 @@ module.exports = {
   slow: 75,
   timeout: 2000,
   ui: 'bdd',
-  'watch-files': ['*.js', 'src/*', 'test/*.js']
+  'watch-files': ['dist/*.js', 'src/*', 'test/*.js']
 };

.vscode/c_cpp_properties.json

@@ -0,0 +1,16 @@
+{
+    "configurations": [
+        {
+            "name": "Linux",
+            "includePath": [
+                "${workspaceFolder}/**"
+            ],
+            "defines": [],
+            "compilerPath": "/usr/bin/gcc",
+            "cStandard": "gnu17",
+            "cppStandard": "gnu++14",
+            "intelliSenseMode": "linux-gcc-x64"
+        }
+    ],
+    "version": 4
+}

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "mos.port": ""
+}

CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+## [4.1.0] - 2026-05-17
+
+### Fixed
+- **Regression vs 4.0.7**: `onMessage` callbacks are now invoked via
+  `napi_make_callback` instead of plain `napi_call_function`. This restores
+  the behaviour of the old NaN implementation, which called
+  `node::MakeCallback` (and therefore ran a microtask checkpoint and fired
+  async hooks after each callback). Without this, adapters that queue work
+  via Promises or `setImmediate` inside `onMessage` could not keep up with
+  incoming frames, producing "evaluation overloaded" warnings and "bad frame"
+  errors (reported against ioBroker.e3oncan).
+- Exceptions thrown by `onMessage` or `onStopped` callbacks are now forwarded
+  to Node.js via `napi_fatal_exception` (matching the old `Nan::FatalException`
+  behaviour) instead of being silently dropped with the JS exception left
+  pending, which could corrupt subsequent frame objects.
+
+### Changed
+- Migrated native addon from `nan` to `node-addon-api` (N-API). The binary
+  is now ABI-stable across Node.js major versions: a module compiled for
+  Node.js 20 loads unchanged on Node.js 22 and 24 without recompilation.
+  This resolves a common issue where upgrading Node.js silently broke
+  downstream packages (e.g. ioBroker adapters) until a manual rebuild was
+  performed. The JavaScript API is unchanged.
+
+### Added
+- `Dockerfile.build-test` for verifying compilation on Linux without a
+  physical CAN interface.
+
+## [4.0.7] - 2024-03-13
+
+### Changed
+- Bump brace-expansion from 1.1.11 to 1.1.12.
+- Upgrade NAN.
+
+## [4.0.6] - 2022-11-14
+
+### Added
+- `err` boolean type to `can.d.ts` Message.