usb 3.0.0-alpha.6 → 3.0.0

package/README.md

@@ -8,6 +8,8 @@ Node.JS library for communicating with USB devices.
 
 This is a complete rewrite in rust using [@kevinmehall](https://github.com/kevinmehall)'s excellent [nusb library](https://docs.rs/nusb/latest/nusb) and [napi-rs](https://napi.rs/).
 
+For the previous v2.x.x version of node-usb, please see https://github.com/node-usb/node-usb.
+
 # License
 [MIT](LICENSE.md)
 
@@ -151,11 +153,13 @@ If using a packaging system for electron, ensure the `node-usb` library does not
 - npmRebuild: false
 
 # APIs
-Since `v3.0.0`, the `node-usb` API follows the WebUSB specification which can be found here:
+Since `v3.0.0`, the API exclusively follows the WebUSB specification which can be found here:
 
 https://wicg.github.io/webusb/
 
-Two versions of the WebUSB API exist by default:
+If you want to use the older `Legacy API`, please install [v2.x.x of node-usb](https://github.com/node-usb/node-usb).
+
+Two versions of the API exist by default:
 
 - `usb` - which exposes all functionality in an unrestricted manner (e.g. without needing to `requestDevice()` first)
 - `webusb` - which follows the WebUSB specification exactly and requires the user to authorise devices via `requestDevice()` first.

package/dist/index.d.ts

@@ -35,6 +35,7 @@ declare class WebUSB extends EventTarget implements USB {
     protected nativeEmitter: Emitter;
     protected authorisedDevices: Set<USBDeviceFilter>;
     protected listenerCount: number;
+    protected eventListeners: Map<string, Set<EventListener>>;
     protected knownDevices: Map<string, UsbDevice>;
     constructor(options?: USBOptions);
     private deviceConnectCallback;

package/dist/index.js

@@ -102,6 +102,7 @@ class WebUSB extends EventTarget {
         this.nativeEmitter = new index_js_1.Emitter();
         this.authorisedDevices = new Set();
         this.listenerCount = 0;
+        this.eventListeners = new Map();
         this.knownDevices = new Map();
         this.deviceConnectCallback = async (device) => {
             this.knownDevices.set(device.handle, device);
@@ -126,9 +127,15 @@ class WebUSB extends EventTarget {
         if (type !== 'connect' && type !== 'disconnect') {
             return;
         }
+        const existingListeners = this.eventListeners.get(type) || new Set();
+        const hadListeners = this.listenerCount > 0;
         super.addEventListener(type, listener);
-        this.listenerCount++;
-        if (this.listenerCount === 1) {
+        if (!existingListeners.has(listener)) {
+            existingListeners.add(listener);
+            this.eventListeners.set(type, existingListeners);
+            this.listenerCount++;
+        }
+        if (!hadListeners && this.listenerCount > 0) {
             this.nativeEmitter.addAttach(this.deviceConnectCallback);
             this.nativeEmitter.addDetach(this.deviceDisconnectCallback);
             (0, index_js_1.nativeGetDevices)().then(devices => devices.forEach(device => this.knownDevices.set(device.handle, device)));
@@ -138,9 +145,16 @@ class WebUSB extends EventTarget {
         if (type !== 'connect' && type !== 'disconnect') {
             return;
         }
+        const existingListeners = this.eventListeners.get(type);
+        const removed = existingListeners ? existingListeners.delete(callback) : false;
         super.removeEventListener(type, callback);
-        this.listenerCount--;
-        if (this.listenerCount === 0) {
+        if (removed) {
+            this.listenerCount--;
+            if (existingListeners && existingListeners.size === 0) {
+                this.eventListeners.delete(type);
+            }
+        }
+        if (removed && this.listenerCount === 0) {
             this.nativeEmitter.removeAttach();
             this.nativeEmitter.removeDetach();
             this.knownDevices.clear();
@@ -204,25 +218,20 @@ class WebUSB extends EventTarget {
         if (devices.length === 0) {
             throw new NamedError('Failed to execute \'requestDevice\' on \'USB\': No device selected.', 'NotFoundError');
         }
-        try {
-            // If no devicesFound function, select the first device found
-            const device = this.options.devicesFound ? await this.options.devicesFound(devices) : devices[0];
-            if (!device) {
-                throw new NamedError('Failed to execute \'requestDevice\' on \'USB\': No device selected.', 'NotFoundError');
-            }
-            this.authorisedDevices.add({
-                vendorId: device.vendorId,
-                productId: device.productId,
-                classCode: device.deviceClass,
-                subclassCode: device.deviceSubclass,
-                protocolCode: device.deviceProtocol,
-                serialNumber: device.serialNumber || undefined
-            });
-            return device;
-        }
-        catch (error) {
+        // If no devicesFound function, select the first device found
+        const device = this.options.devicesFound ? await this.options.devicesFound(devices) : devices[0];
+        if (!device) {
             throw new NamedError('Failed to execute \'requestDevice\' on \'USB\': No device selected.', 'NotFoundError');
         }
+        this.authorisedDevices.add({
+            vendorId: device.vendorId,
+            productId: device.productId,
+            classCode: device.deviceClass,
+            subclassCode: device.deviceSubclass,
+            protocolCode: device.deviceProtocol,
+            serialNumber: device.serialNumber || undefined
+        });
+        return device;
     }
     /**
      * Gets all allowed Web USB devices which are connected

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-android-arm64')
         const bindingPackageVersion = require('@node-usb/usb-android-arm64/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-android-arm-eabi')
         const bindingPackageVersion = require('@node-usb/usb-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-win32-x64-gnu')
         const bindingPackageVersion = require('@node-usb/usb-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-win32-x64-msvc')
         const bindingPackageVersion = require('@node-usb/usb-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-win32-ia32-msvc')
         const bindingPackageVersion = require('@node-usb/usb-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-win32-arm64-msvc')
         const bindingPackageVersion = require('@node-usb/usb-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@node-usb/usb-darwin-universal')
       const bindingPackageVersion = require('@node-usb/usb-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-darwin-x64')
         const bindingPackageVersion = require('@node-usb/usb-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-darwin-arm64')
         const bindingPackageVersion = require('@node-usb/usb-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-freebsd-x64')
         const bindingPackageVersion = require('@node-usb/usb-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-freebsd-arm64')
         const bindingPackageVersion = require('@node-usb/usb-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-x64-musl')
           const bindingPackageVersion = require('@node-usb/usb-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-x64-gnu')
           const bindingPackageVersion = require('@node-usb/usb-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-arm64-musl')
           const bindingPackageVersion = require('@node-usb/usb-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-arm64-gnu')
           const bindingPackageVersion = require('@node-usb/usb-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-arm-musleabihf')
           const bindingPackageVersion = require('@node-usb/usb-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@node-usb/usb-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-loong64-musl')
           const bindingPackageVersion = require('@node-usb/usb-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-loong64-gnu')
           const bindingPackageVersion = require('@node-usb/usb-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-riscv64-musl')
           const bindingPackageVersion = require('@node-usb/usb-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@node-usb/usb-linux-riscv64-gnu')
           const bindingPackageVersion = require('@node-usb/usb-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-linux-ppc64-gnu')
         const bindingPackageVersion = require('@node-usb/usb-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-linux-s390x-gnu')
         const bindingPackageVersion = require('@node-usb/usb-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-openharmony-arm64')
         const bindingPackageVersion = require('@node-usb/usb-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-openharmony-x64')
         const bindingPackageVersion = require('@node-usb/usb-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@node-usb/usb-openharmony-arm')
         const bindingPackageVersion = require('@node-usb/usb-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '3.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 3.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '3.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 3.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -525,23 +525,33 @@ function requireNative() {
 
 nativeBinding = requireNative()
 
-if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → force WASI fallback even if native loaded
+//   'error'                  → force WASI and throw if no WASI binding is found
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error'
+
+if (!nativeBinding || forceWasi) {
   let wasiBinding = null
   let wasiBindingError = null
   try {
     wasiBinding = require('./usb.wasi.cjs')
     nativeBinding = wasiBinding
   } catch (err) {
-    if (process.env.NAPI_RS_FORCE_WASI) {
+    if (forceWasi) {
       wasiBindingError = err
     }
   }
-  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  if (!nativeBinding || forceWasi) {
     try {
       wasiBinding = require('@node-usb/usb-wasm32-wasi')
       nativeBinding = wasiBinding
     } catch (err) {
-      if (process.env.NAPI_RS_FORCE_WASI) {
+      if (forceWasi) {
         if (!wasiBindingError) {
           wasiBindingError = err
         } else {

package/package.json

@@ -2,7 +2,7 @@
   "name": "usb",
   "description": "Library to access USB devices",
   "license": "MIT",
-  "version": "3.0.0-alpha.6",
+  "version": "3.0.0",
   "main": "dist/index.js",
   "engines": {
     "node": ">= 12.22.0 < 13 || >= 14.17.0 < 15 || >= 15.12.0 < 16 || >= 16.0.0"
@@ -45,6 +45,8 @@
     "build": "napi build --platform --release",
     "build:ts": "tsc",
     "build:all": "npm run build && npm run build:ts",
+    "format": "cargo fmt",
+    "format:check": "cargo fmt -- --check",
     "full-test": "mocha --timeout 10000 --require coffeescript/register test/*.coffee",
     "prepublishOnly": "napi prepublish -t npm",
     "preversion": "napi build --platform && git add .",
@@ -53,14 +55,18 @@
     "docs": "typedoc"
   },
   "dependencies": {
-    "@types/w3c-web-usb": "^1.0.13"
+    "@types/w3c-web-usb": "^1.0.14"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^3.2.0",
+    "@napi-rs/cli": "^3.7.0",
     "coffeescript": "^2.7.0",
-    "mocha": "^11.7.5",
-    "typedoc": "^0.28.16",
-    "typescript": "^5.9.3"
+    "mocha": "^11.7.6",
+    "typedoc": "^0.28.19",
+    "typescript": "^6.0.3"
+  },
+  "overrides": {
+    "diff": "9.0.0",
+    "serialize-javascript": "7.0.5"
   },
   "napi": {
     "binaryName": "usb",
@@ -84,15 +90,15 @@
     "index.js"
   ],
   "optionalDependencies": {
-    "@node-usb/usb-win32-x64-msvc": "3.0.0-alpha.6",
-    "@node-usb/usb-darwin-x64": "3.0.0-alpha.6",
-    "@node-usb/usb-linux-x64-gnu": "3.0.0-alpha.6",
-    "@node-usb/usb-linux-x64-musl": "3.0.0-alpha.6",
-    "@node-usb/usb-linux-arm64-gnu": "3.0.0-alpha.6",
-    "@node-usb/usb-win32-ia32-msvc": "3.0.0-alpha.6",
-    "@node-usb/usb-linux-arm-gnueabihf": "3.0.0-alpha.6",
-    "@node-usb/usb-darwin-arm64": "3.0.0-alpha.6",
-    "@node-usb/usb-linux-arm64-musl": "3.0.0-alpha.6",
-    "@node-usb/usb-win32-arm64-msvc": "3.0.0-alpha.6"
+    "@node-usb/usb-win32-x64-msvc": "3.0.0",
+    "@node-usb/usb-darwin-x64": "3.0.0",
+    "@node-usb/usb-linux-x64-gnu": "3.0.0",
+    "@node-usb/usb-linux-x64-musl": "3.0.0",
+    "@node-usb/usb-linux-arm64-gnu": "3.0.0",
+    "@node-usb/usb-win32-ia32-msvc": "3.0.0",
+    "@node-usb/usb-linux-arm-gnueabihf": "3.0.0",
+    "@node-usb/usb-darwin-arm64": "3.0.0",
+    "@node-usb/usb-linux-arm64-musl": "3.0.0",
+    "@node-usb/usb-win32-arm64-msvc": "3.0.0"
   }
 }