node-hid - npm Package Compare versions

Comparing version 0.7.3 to 0.7.4

package.json

 {
   "name": "node-hid",
   "description": "USB HID device access library",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "author": "Hans Hübner <[e-mail]> (https://github.com/hanshuebner)",
@@ -36,3 +36,3 @@ "bugs": "https://github.com/node-hid/node-hid/issues",
   "engines": {
-    "node": ">=4.0.0"
+    "node": ">=6.0.0"
   },
@@ -43,6 +43,6 @@ "license": "(MIT OR X11)",
     "nan": "^2.10.0",
-    "prebuild-install": "^4.0.0"
+    "prebuild-install": "^5.2.1"
   },
   "devDependencies": {
-    "prebuild": "^7.6.0",
+    "prebuild": "^8.1.2",
     "prebuild-ci": "^2.2.3",
@@ -49,0 +49,0 @@ "rimraf": "^2.6.2"

Publishing.md

@@ -6,3 +6,5 @@ How to publish node-hid
 
-On MacOSX, Windows, Linux, do:
+First, make sure version is bumped to new version. (if code change)
+
+Then, on each of MacOSX, Windows, Linux, do:
 ```
@@ -9,0 +11,0 @@ git clone https://github.com/node-hid/node-hid.git

README.md

@@ -16,2 +16,3 @@ # node-hid - Access USB HID devices from Node.js #
    * [List all HID devices connected](#list-all-hid-devices-connected)
+     * [Cost of HID.devices() and new HID.HID()](#cost-of-hiddevices-and-new-hidhid-for-detecting-device-plugunplug)
    * [Opening a device](#opening-a-device)
@@ -66,14 +67,14 @@ * [Picking a device from the device list](#picking-a-device-from-the-device-list)
 
-| Platform / Arch | Node v4.x | Node v6.x | Node v7.x | Node v8.x | Node v9.x | Node v10.x
-|       ---       | --- | --- | --- | --- | --- | --- |
-| Windows / x86   |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
-| Windows / x64   |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
-| Mac OSX / x64   |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
-| Linux / x64     |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
-| Linux / ia32¹   |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
-| Linux / ARM v6¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
-| Linux / ARM v7¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
-| Linux / ARM v8¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
-| Linux / MIPSel¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
-| Linux / PPC64¹  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
+| Platform / Arch | Node v6.x | Node v7.x | Node v8.x | Node v9.x | Node v10.x
+|       ---       | --- | --- | --- | --- | --- |
+| Windows / x86   |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
+| Windows / x64   |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
+| Mac OSX / x64   |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
+| Linux / x64     |  ☑  |  ☑  |  ☑  |  ☑  |  ☑  |
+| Linux / ia32¹   |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
+| Linux / ARM v6¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
+| Linux / ARM v7¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
+| Linux / ARM v8¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
+| Linux / MIPSel¹ |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
+| Linux / PPC64¹  |  ☐  |  ☐  |  ☐  |  ☐  |  ☐  |
 
@@ -174,2 +175,7 @@ ¹ ia32, ARM, MIPSel and PPC64 platforms are known to work but are not currently part of our test or build matrix.  ARM v4 and v5 was dropped from Node.js after Node v0.10.
 
+#### Cost of `HID.devices()` and `new HID.HID()` for detecting device plug/unplug
+Both `HID.devices()` and `new HID.HID()` are relatively costly, each causing a USB (and potentially Bluetooth) enumeration. This takes time and OS resources. Doing either can slow down the read/write that you do in parallel with a device, and cause other USB devices to slow down too. This is how USB works.
+
+If you are polling `HID.devices()` or doing repeated `new HID.HID(vid,pid)` to detect device plug / unplug, consider instead using [node-usb-detection](https://github.com/MadLittleMods/node-usb-detection). `node-usb-detection` uses OS-specific, non-bus enumeration ways to detect device plug / unplug.
+
 ### Opening a device
@@ -194,2 +200,9 @@
 
+A `node-hid` device is an `EventEmitter`.
+While it shares some method names and usage patterns with
+`Readable` and `Writable` streams, it is not a stream and the semantics vary.
+For example, `device.write` does not take encoding or callback args and
+`device.pause` does not do the same thing as `readable.pause`.
+There is also no `pipe` method.
+
 ### Picking a device from the device list
@@ -237,4 +250,5 @@ If you need to filter down the `HID.devices()` list, you can use
 - To remove an event handler, close the device with `device.close()`
+- When there is not yet a data handler or no data handler exists,
+   data is not read at all -- there is no buffer.
 
-
 ### Writing to a device
@@ -298,3 +312,5 @@
 
-- Pauses reading and the emission of `data` events.
+- Pauses reading and the emission of `data` events.  
+This means the underlying device is _silenced_ until resumption --
+it is not like pausing a stream, where data continues to accumulate.
 
@@ -301,0 +317,0 @@ ### `device.resume()`

New alerts

Debug access

Supply chain risk

Uses debug, reflection and dynamic code execution features.

Found 1 instance in 1 package

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

Fixed alerts

Debug access

Supply chain risk

Uses debug, reflection and dynamic code execution features.

Found 1 instance in 1 package

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

1297715

199%

Number of package files

118

37.21%

Number of lines in readme file

501

3.3%

Dependency changes

• + Added

  base64-js@1.5.1
  (transitive)

• + Added

  bl@4.1.0
  (transitive)

• + Added

  buffer@5.7.1
  (transitive)

• + Added

  decompress-response@4.2.1
  (transitive)

• + Added

  expand-template@2.0.3
  (transitive)

• + Added

  ieee754@1.2.1
  (transitive)

• + Added

  mimic-response@2.1.0
  (transitive)

• + Added

  mkdirp-classic@0.5.3
  (transitive)

• + Added

  napi-build-utils@1.0.2
  (transitive)

• + Added

  prebuild-install@5.3.6
  (transitive)

• + Added

  pump@3.0.4
  (transitive)

• + Added

  readable-stream@3.6.2
  (transitive)

• + Added

  simple-get@3.1.1
  (transitive)

• + Added

  tar-fs@2.1.4
  (transitive)

• + Added

  tar-stream@2.2.0
  (transitive)

• - Removed

  async-function@1.0.0
  (transitive)

• - Removed

  async-generator-function@1.0.0
  (transitive)

• - Removed

  available-typed-arrays@1.0.7
  (transitive)

• - Removed

  bl@1.2.3
  (transitive)

• - Removed

  buffer-alloc@1.2.0
  (transitive)

• - Removed

  buffer-alloc-unsafe@1.1.0
  (transitive)

• - Removed

  buffer-fill@1.0.0
  (transitive)

• - Removed

  call-bind@1.0.9
  (transitive)

• - Removed

  call-bind-apply-helpers@1.0.2
  (transitive)

• - Removed

  call-bound@1.0.4
  (transitive)

• - Removed

  decompress-response@3.3.0
  (transitive)

• - Removed

  define-data-property@1.1.4
  (transitive)

• - Removed

  dunder-proto@1.0.1
  (transitive)

• - Removed

  es-define-property@1.0.1
  (transitive)

• - Removed

  es-errors@1.3.0
  (transitive)

• - Removed

  es-object-atoms@1.1.1
  (transitive)

• - Removed

  expand-template@1.1.1
  (transitive)

• - Removed

  for-each@0.3.5
  (transitive)

• - Removed

  function-bind@1.1.2
  (transitive)

• - Removed

  generator-function@2.0.1
  (transitive)

• - Removed

  get-intrinsic@1.3.1
  (transitive)

• - Removed

  get-proto@1.0.1
  (transitive)

• - Removed

  gopd@1.2.0
  (transitive)

• - Removed

  has-property-descriptors@1.0.2
  (transitive)

• - Removed

  has-symbols@1.1.0
  (transitive)

• - Removed

  has-tostringtag@1.0.2
  (transitive)

• - Removed

  hasown@2.0.3
  (transitive)

• - Removed

  is-callable@1.2.7
  (transitive)

• - Removed

  is-typed-array@1.1.15
  (transitive)

• - Removed

  isarray@2.0.5
  (transitive)

• - Removed

  math-intrinsics@1.1.0
  (transitive)

• - Removed

  mimic-response@1.0.1
  (transitive)

• - Removed

  mkdirp@0.5.6
  (transitive)

• - Removed

  os-homedir@1.0.2
  (transitive)

• - Removed

  possible-typed-array-names@1.1.0
  (transitive)

• - Removed

  prebuild-install@4.0.0
  (transitive)

• - Removed

  pump@1.0.32.0.1
  (transitive)

• - Removed

  safe-buffer@5.2.1
  (transitive)

• - Removed

  set-function-length@1.2.2
  (transitive)

• - Removed

  simple-get@2.8.2
  (transitive)

• - Removed

  tar-fs@1.16.6
  (transitive)

• - Removed

  tar-stream@1.6.2
  (transitive)

• - Removed

  to-buffer@1.2.2
  (transitive)

• - Removed

  typed-array-buffer@1.0.3
  (transitive)

• - Removed

  which-typed-array@1.1.20
  (transitive)

• - Removed

  xtend@4.0.2
  (transitive)

• Updated

  prebuild-install@^5.2.1