commit 0eb8fbcf6914b4c0080cfa8e8446c0baa604ff9d Author: mehranz Date: Mon Feb 16 15:55:07 2026 +0330 update diff --git a/BOOTEX.LOG b/BOOTEX.LOG new file mode 100644 index 0000000..e96d3bc Binary files /dev/null and b/BOOTEX.LOG differ diff --git a/node-v22.19.0-x64.msi b/node-v22.19.0-x64.msi new file mode 100644 index 0000000..6662fa8 Binary files /dev/null and b/node-v22.19.0-x64.msi differ diff --git a/node_modules/.bin/mime b/node_modules/.bin/mime new file mode 100644 index 0000000..7751de3 --- /dev/null +++ b/node_modules/.bin/mime @@ -0,0 +1,16 @@ +#!/bin/sh +basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')") + +case `uname` in + *CYGWIN*|*MINGW*|*MSYS*) + if command -v cygpath > /dev/null 2>&1; then + basedir=`cygpath -w "$basedir"` + fi + ;; +esac + +if [ -x "$basedir/node" ]; then + exec "$basedir/node" "$basedir/../mime/cli.js" "$@" +else + exec node "$basedir/../mime/cli.js" "$@" +fi diff --git a/node_modules/.bin/mime.cmd b/node_modules/.bin/mime.cmd new file mode 100644 index 0000000..54491f1 --- /dev/null +++ b/node_modules/.bin/mime.cmd @@ -0,0 +1,17 @@ +@ECHO off +GOTO start +:find_dp0 +SET dp0=%~dp0 +EXIT /b +:start +SETLOCAL +CALL :find_dp0 + +IF EXIST "%dp0%\node.exe" ( + SET "_prog=%dp0%\node.exe" +) ELSE ( + SET "_prog=node" + SET PATHEXT=%PATHEXT:;.JS;=;% +) + +endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%" "%dp0%\..\mime\cli.js" %* diff --git a/node_modules/.bin/mime.ps1 b/node_modules/.bin/mime.ps1 new file mode 100644 index 0000000..2222f40 --- /dev/null +++ b/node_modules/.bin/mime.ps1 @@ -0,0 +1,28 @@ +#!/usr/bin/env pwsh +$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent + +$exe="" +if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) { + # Fix case when both the Windows and Linux builds of Node + # are installed in the same directory + $exe=".exe" +} +$ret=0 +if (Test-Path "$basedir/node$exe") { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "$basedir/node$exe" "$basedir/../mime/cli.js" $args + } else { + & "$basedir/node$exe" "$basedir/../mime/cli.js" $args + } + $ret=$LASTEXITCODE +} else { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "node$exe" "$basedir/../mime/cli.js" $args + } else { + & "node$exe" "$basedir/../mime/cli.js" $args + } + $ret=$LASTEXITCODE +} +exit $ret diff --git a/node_modules/.bin/node-gyp-build b/node_modules/.bin/node-gyp-build new file mode 100644 index 0000000..b804ba9 --- /dev/null +++ b/node_modules/.bin/node-gyp-build @@ -0,0 +1,16 @@ +#!/bin/sh +basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')") + +case `uname` in + *CYGWIN*|*MINGW*|*MSYS*) + if command -v cygpath > /dev/null 2>&1; then + basedir=`cygpath -w "$basedir"` + fi + ;; +esac + +if [ -x "$basedir/node" ]; then + exec "$basedir/node" "$basedir/../node-gyp-build/bin.js" "$@" +else + exec node "$basedir/../node-gyp-build/bin.js" "$@" +fi diff --git a/node_modules/.bin/node-gyp-build-optional b/node_modules/.bin/node-gyp-build-optional new file mode 100644 index 0000000..cb670aa --- /dev/null +++ b/node_modules/.bin/node-gyp-build-optional @@ -0,0 +1,16 @@ +#!/bin/sh +basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')") + +case `uname` in + *CYGWIN*|*MINGW*|*MSYS*) + if command -v cygpath > /dev/null 2>&1; then + basedir=`cygpath -w "$basedir"` + fi + ;; +esac + +if [ -x "$basedir/node" ]; then + exec "$basedir/node" "$basedir/../node-gyp-build/optional.js" "$@" +else + exec node "$basedir/../node-gyp-build/optional.js" "$@" +fi diff --git a/node_modules/.bin/node-gyp-build-optional.cmd b/node_modules/.bin/node-gyp-build-optional.cmd new file mode 100644 index 0000000..74d85f2 --- /dev/null +++ b/node_modules/.bin/node-gyp-build-optional.cmd @@ -0,0 +1,17 @@ +@ECHO off +GOTO start +:find_dp0 +SET dp0=%~dp0 +EXIT /b +:start +SETLOCAL +CALL :find_dp0 + +IF EXIST "%dp0%\node.exe" ( + SET "_prog=%dp0%\node.exe" +) ELSE ( + SET "_prog=node" + SET PATHEXT=%PATHEXT:;.JS;=;% +) + +endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%" "%dp0%\..\node-gyp-build\optional.js" %* diff --git a/node_modules/.bin/node-gyp-build-optional.ps1 b/node_modules/.bin/node-gyp-build-optional.ps1 new file mode 100644 index 0000000..45995c3 --- /dev/null +++ b/node_modules/.bin/node-gyp-build-optional.ps1 @@ -0,0 +1,28 @@ +#!/usr/bin/env pwsh +$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent + +$exe="" +if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) { + # Fix case when both the Windows and Linux builds of Node + # are installed in the same directory + $exe=".exe" +} +$ret=0 +if (Test-Path "$basedir/node$exe") { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "$basedir/node$exe" "$basedir/../node-gyp-build/optional.js" $args + } else { + & "$basedir/node$exe" "$basedir/../node-gyp-build/optional.js" $args + } + $ret=$LASTEXITCODE +} else { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "node$exe" "$basedir/../node-gyp-build/optional.js" $args + } else { + & "node$exe" "$basedir/../node-gyp-build/optional.js" $args + } + $ret=$LASTEXITCODE +} +exit $ret diff --git a/node_modules/.bin/node-gyp-build-test b/node_modules/.bin/node-gyp-build-test new file mode 100644 index 0000000..bdf6dca --- /dev/null +++ b/node_modules/.bin/node-gyp-build-test @@ -0,0 +1,16 @@ +#!/bin/sh +basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')") + +case `uname` in + *CYGWIN*|*MINGW*|*MSYS*) + if command -v cygpath > /dev/null 2>&1; then + basedir=`cygpath -w "$basedir"` + fi + ;; +esac + +if [ -x "$basedir/node" ]; then + exec "$basedir/node" "$basedir/../node-gyp-build/build-test.js" "$@" +else + exec node "$basedir/../node-gyp-build/build-test.js" "$@" +fi diff --git a/node_modules/.bin/node-gyp-build-test.cmd b/node_modules/.bin/node-gyp-build-test.cmd new file mode 100644 index 0000000..182a757 --- /dev/null +++ b/node_modules/.bin/node-gyp-build-test.cmd @@ -0,0 +1,17 @@ +@ECHO off +GOTO start +:find_dp0 +SET dp0=%~dp0 +EXIT /b +:start +SETLOCAL +CALL :find_dp0 + +IF EXIST "%dp0%\node.exe" ( + SET "_prog=%dp0%\node.exe" +) ELSE ( + SET "_prog=node" + SET PATHEXT=%PATHEXT:;.JS;=;% +) + +endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%" "%dp0%\..\node-gyp-build\build-test.js" %* diff --git a/node_modules/.bin/node-gyp-build-test.ps1 b/node_modules/.bin/node-gyp-build-test.ps1 new file mode 100644 index 0000000..6cb0b9b --- /dev/null +++ b/node_modules/.bin/node-gyp-build-test.ps1 @@ -0,0 +1,28 @@ +#!/usr/bin/env pwsh +$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent + +$exe="" +if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) { + # Fix case when both the Windows and Linux builds of Node + # are installed in the same directory + $exe=".exe" +} +$ret=0 +if (Test-Path "$basedir/node$exe") { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "$basedir/node$exe" "$basedir/../node-gyp-build/build-test.js" $args + } else { + & "$basedir/node$exe" "$basedir/../node-gyp-build/build-test.js" $args + } + $ret=$LASTEXITCODE +} else { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "node$exe" "$basedir/../node-gyp-build/build-test.js" $args + } else { + & "node$exe" "$basedir/../node-gyp-build/build-test.js" $args + } + $ret=$LASTEXITCODE +} +exit $ret diff --git a/node_modules/.bin/node-gyp-build.cmd b/node_modules/.bin/node-gyp-build.cmd new file mode 100644 index 0000000..ac854a6 --- /dev/null +++ b/node_modules/.bin/node-gyp-build.cmd @@ -0,0 +1,17 @@ +@ECHO off +GOTO start +:find_dp0 +SET dp0=%~dp0 +EXIT /b +:start +SETLOCAL +CALL :find_dp0 + +IF EXIST "%dp0%\node.exe" ( + SET "_prog=%dp0%\node.exe" +) ELSE ( + SET "_prog=node" + SET PATHEXT=%PATHEXT:;.JS;=;% +) + +endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%" "%dp0%\..\node-gyp-build\bin.js" %* diff --git a/node_modules/.bin/node-gyp-build.ps1 b/node_modules/.bin/node-gyp-build.ps1 new file mode 100644 index 0000000..c1f9a9a --- /dev/null +++ b/node_modules/.bin/node-gyp-build.ps1 @@ -0,0 +1,28 @@ +#!/usr/bin/env pwsh +$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent + +$exe="" +if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) { + # Fix case when both the Windows and Linux builds of Node + # are installed in the same directory + $exe=".exe" +} +$ret=0 +if (Test-Path "$basedir/node$exe") { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "$basedir/node$exe" "$basedir/../node-gyp-build/bin.js" $args + } else { + & "$basedir/node$exe" "$basedir/../node-gyp-build/bin.js" $args + } + $ret=$LASTEXITCODE +} else { + # Support pipeline input + if ($MyInvocation.ExpectingInput) { + $input | & "node$exe" "$basedir/../node-gyp-build/bin.js" $args + } else { + & "node$exe" "$basedir/../node-gyp-build/bin.js" $args + } + $ret=$LASTEXITCODE +} +exit $ret diff --git a/node_modules/.package-lock.json b/node_modules/.package-lock.json new file mode 100644 index 0000000..27114c1 --- /dev/null +++ b/node_modules/.package-lock.json @@ -0,0 +1,1091 @@ +{ + "name": "radin-scale-api", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "node_modules/@serialport/binding-mock": { + "version": "10.2.2", + "resolved": "https://registry.npmjs.org/@serialport/binding-mock/-/binding-mock-10.2.2.tgz", + "integrity": "sha512-HAFzGhk9OuFMpuor7aT5G1ChPgn5qSsklTFOTUX72Rl6p0xwcSVsRtG/xaGp6bxpN7fI9D/S8THLBWbBgS6ldw==", + "dependencies": { + "@serialport/bindings-interface": "^1.2.1", + "debug": "^4.3.3" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/@serialport/binding-mock/node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/@serialport/binding-mock/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==" + }, + "node_modules/@serialport/bindings-cpp": { + "version": "12.0.1", + "resolved": "https://registry.npmjs.org/@serialport/bindings-cpp/-/bindings-cpp-12.0.1.tgz", + "integrity": "sha512-r2XOwY2dDvbW7dKqSPIk2gzsr6M6Qpe9+/Ngs94fNaNlcTRCV02PfaoDmRgcubpNVVcLATlxSxPTIDw12dbKOg==", + "hasInstallScript": true, + "dependencies": { + "@serialport/bindings-interface": "1.2.2", + "@serialport/parser-readline": "11.0.0", + "debug": "4.3.4", + "node-addon-api": "7.0.0", + "node-gyp-build": "4.6.0" + }, + "engines": { + "node": ">=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-delimiter/-/parser-delimiter-11.0.0.tgz", + "integrity": "sha512-aZLJhlRTjSmEwllLG7S4J8s8ctRAS0cbvCpO87smLvl3e4BgzbVgF6Z6zaJd3Aji2uSiYgfedCdNc4L6W+1E2g==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-readline/-/parser-readline-11.0.0.tgz", + "integrity": "sha512-rRAivhRkT3YO28WjmmG4FQX6L+KMb5/ikhyylRfzWPw0nSXy97+u07peS9CbHqaNvJkMhH1locp2H36aGMOEIA==", + "dependencies": { + "@serialport/parser-delimiter": "11.0.0" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/bindings-cpp/node_modules/debug": { + "version": "4.3.4", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", + "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", + "dependencies": { + "ms": "2.1.2" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/@serialport/bindings-cpp/node_modules/ms": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", + "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==" + }, + "node_modules/@serialport/bindings-interface": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/@serialport/bindings-interface/-/bindings-interface-1.2.2.tgz", + "integrity": "sha512-CJaUd5bLvtM9c5dmO9rPBHPXTa9R2UwpkJ0wdh9JCYcbrPWsKz+ErvR0hBLeo7NPeiFdjFO4sonRljiw4d2XiA==", + "engines": { + "node": "^12.22 || ^14.13 || >=16" + } + }, + "node_modules/@serialport/parser-byte-length": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-byte-length/-/parser-byte-length-12.0.0.tgz", + "integrity": "sha512-0ei0txFAj+s6FTiCJFBJ1T2hpKkX8Md0Pu6dqMrYoirjPskDLJRgZGLqoy3/lnU1bkvHpnJO+9oJ3PB9v8rNlg==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-cctalk": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-cctalk/-/parser-cctalk-12.0.0.tgz", + "integrity": "sha512-0PfLzO9t2X5ufKuBO34DQKLXrCCqS9xz2D0pfuaLNeTkyGUBv426zxoMf3rsMRodDOZNbFblu3Ae84MOQXjnZw==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-delimiter": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-delimiter/-/parser-delimiter-12.0.0.tgz", + "integrity": "sha512-gu26tVt5lQoybhorLTPsH2j2LnX3AOP2x/34+DUSTNaUTzu2fBXw+isVjQJpUBFWu6aeQRZw5bJol5X9Gxjblw==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-inter-byte-timeout": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-inter-byte-timeout/-/parser-inter-byte-timeout-12.0.0.tgz", + "integrity": "sha512-GnCh8K0NAESfhCuXAt+FfBRz1Cf9CzIgXfp7SdMgXwrtuUnCC/yuRTUFWRvuzhYKoAo1TL0hhUo77SFHUH1T/w==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-packet-length": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-packet-length/-/parser-packet-length-12.0.0.tgz", + "integrity": "sha512-p1hiCRqvGHHLCN/8ZiPUY/G0zrxd7gtZs251n+cfNTn+87rwcdUeu9Dps3Aadx30/sOGGFL6brIRGK4l/t7MuQ==", + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/@serialport/parser-readline": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-readline/-/parser-readline-12.0.0.tgz", + "integrity": "sha512-O7cywCWC8PiOMvo/gglEBfAkLjp/SENEML46BXDykfKP5mTPM46XMaX1L0waWU6DXJpBgjaL7+yX6VriVPbN4w==", + "dependencies": { + "@serialport/parser-delimiter": "12.0.0" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-ready": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-ready/-/parser-ready-12.0.0.tgz", + "integrity": "sha512-ygDwj3O4SDpZlbrRUraoXIoIqb8sM7aMKryGjYTIF0JRnKeB1ys8+wIp0RFMdFbO62YriUDextHB5Um5cKFSWg==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-regex": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-regex/-/parser-regex-12.0.0.tgz", + "integrity": "sha512-dCAVh4P/pZrLcPv9NJ2mvPRBg64L5jXuiRxIlyxxdZGH4WubwXVXY/kBTihQmiAMPxbT3yshSX8f2+feqWsxqA==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-slip-encoder": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-slip-encoder/-/parser-slip-encoder-12.0.0.tgz", + "integrity": "sha512-0APxDGR9YvJXTRfY+uRGhzOhTpU5akSH183RUcwzN7QXh8/1jwFsFLCu0grmAUfi+fItCkR+Xr1TcNJLR13VNA==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/parser-spacepacket": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/parser-spacepacket/-/parser-spacepacket-12.0.0.tgz", + "integrity": "sha512-dozONxhPC/78pntuxpz/NOtVps8qIc/UZzdc/LuPvVsqCoJXiRxOg6ZtCP/W58iibJDKPZPAWPGYeZt9DJxI+Q==", + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/stream": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/@serialport/stream/-/stream-12.0.0.tgz", + "integrity": "sha512-9On64rhzuqKdOQyiYLYv2lQOh3TZU/D3+IWCR5gk0alPel2nwpp4YwDEGiUBfrQZEdQ6xww0PWkzqth4wqwX3Q==", + "dependencies": { + "@serialport/bindings-interface": "1.2.2", + "debug": "4.3.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/@serialport/stream/node_modules/debug": { + "version": "4.3.4", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", + "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", + "dependencies": { + "ms": "2.1.2" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/@serialport/stream/node_modules/ms": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", + "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==" + }, + "node_modules/accepts": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", + "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", + "dependencies": { + "mime-types": "~2.1.34", + "negotiator": "0.6.3" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/array-flatten": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", + "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==" + }, + "node_modules/body-parser": { + "version": "1.20.3", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz", + "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==", + "dependencies": { + "bytes": "3.1.2", + "content-type": "~1.0.5", + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "on-finished": "2.4.1", + "qs": "6.13.0", + "raw-body": "2.5.2", + "type-is": "~1.6.18", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/content-disposition": { + "version": "0.5.4", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", + "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", + "dependencies": { + "safe-buffer": "5.2.1" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/content-type": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", + "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie": { + "version": "0.7.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz", + "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie-signature": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", + "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==" + }, + "node_modules/cors": { + "version": "2.8.5", + "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.5.tgz", + "integrity": "sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==", + "dependencies": { + "object-assign": "^4", + "vary": "^1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/destroy": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", + "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==" + }, + "node_modules/encodeurl": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", + "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", + "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==" + }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/express": { + "version": "4.21.2", + "resolved": "https://registry.npmjs.org/express/-/express-4.21.2.tgz", + "integrity": "sha512-28HqgMZAmih1Czt9ny7qr6ek2qddF4FclbMzwhCREB6OFfH+rXAnuNCwo1/wFvrtbgsQDb4kSbX9de9lFbrXnA==", + "dependencies": { + "accepts": "~1.3.8", + "array-flatten": "1.1.1", + "body-parser": "1.20.3", + "content-disposition": "0.5.4", + "content-type": "~1.0.4", + "cookie": "0.7.1", + "cookie-signature": "1.0.6", + "debug": "2.6.9", + "depd": "2.0.0", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "finalhandler": "1.3.1", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "merge-descriptors": "1.0.3", + "methods": "~1.1.2", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "path-to-regexp": "0.1.12", + "proxy-addr": "~2.0.7", + "qs": "6.13.0", + "range-parser": "~1.2.1", + "safe-buffer": "5.2.1", + "send": "0.19.0", + "serve-static": "1.16.2", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "type-is": "~1.6.18", + "utils-merge": "1.0.1", + "vary": "~1.1.2" + }, + "engines": { + "node": ">= 0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/finalhandler": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz", + "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==", + "dependencies": { + "debug": "2.6.9", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "statuses": "2.0.1", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/forwarded": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", + "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fresh": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", + "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/http-errors": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz", + "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==", + "dependencies": { + "depd": "2.0.0", + "inherits": "2.0.4", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "toidentifier": "1.0.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/iconv-lite": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", + "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==" + }, + "node_modules/ipaddr.js": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", + "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/media-typer": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", + "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/merge-descriptors": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz", + "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/methods": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", + "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==" + }, + "node_modules/negotiator": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", + "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/node-addon-api": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-7.0.0.tgz", + "integrity": "sha512-vgbBJTS4m5/KkE16t5Ly0WW9hz46swAstv0hYYwMtbG7AznRhNyfLRe8HZAiWIpcHzoO7HxhLuBQj9rJ/Ho0ZA==" + }, + "node_modules/node-gyp-build": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/node-gyp-build/-/node-gyp-build-4.6.0.tgz", + "integrity": "sha512-NTZVKn9IylLwUzaKjkas1e4u2DLNcV4rdYagA4PWdPwW87Bi7z+BznyKSRwS/761tV/lzCGXplWsiaMjLqP2zQ==", + "bin": { + "node-gyp-build": "bin.js", + "node-gyp-build-optional": "optional.js", + "node-gyp-build-test": "build-test.js" + } + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/parseurl": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", + "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/path-to-regexp": { + "version": "0.1.12", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz", + "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==" + }, + "node_modules/proxy-addr": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", + "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/qs": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz", + "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==", + "dependencies": { + "side-channel": "^1.0.6" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/range-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", + "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/raw-body": { + "version": "2.5.2", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz", + "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==", + "dependencies": { + "bytes": "3.1.2", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ] + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==" + }, + "node_modules/send": { + "version": "0.19.0", + "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz", + "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==", + "dependencies": { + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "encodeurl": "~1.0.2", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "mime": "1.6.0", + "ms": "2.1.3", + "on-finished": "2.4.1", + "range-parser": "~1.2.1", + "statuses": "2.0.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/send/node_modules/encodeurl": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz", + "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/send/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==" + }, + "node_modules/serialport": { + "version": "12.0.0", + "resolved": "https://registry.npmjs.org/serialport/-/serialport-12.0.0.tgz", + "integrity": "sha512-AmH3D9hHPFmnF/oq/rvigfiAouAKyK/TjnrkwZRYSFZxNggJxwvbAbfYrLeuvq7ktUdhuHdVdSjj852Z55R+uA==", + "dependencies": { + "@serialport/binding-mock": "10.2.2", + "@serialport/bindings-cpp": "12.0.1", + "@serialport/parser-byte-length": "12.0.0", + "@serialport/parser-cctalk": "12.0.0", + "@serialport/parser-delimiter": "12.0.0", + "@serialport/parser-inter-byte-timeout": "12.0.0", + "@serialport/parser-packet-length": "12.0.0", + "@serialport/parser-readline": "12.0.0", + "@serialport/parser-ready": "12.0.0", + "@serialport/parser-regex": "12.0.0", + "@serialport/parser-slip-encoder": "12.0.0", + "@serialport/parser-spacepacket": "12.0.0", + "@serialport/stream": "12.0.0", + "debug": "4.3.4" + }, + "engines": { + "node": ">=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/serialport/donate" + } + }, + "node_modules/serialport/node_modules/debug": { + "version": "4.3.4", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz", + "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==", + "dependencies": { + "ms": "2.1.2" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/serialport/node_modules/ms": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", + "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==" + }, + "node_modules/serve-static": { + "version": "1.16.2", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz", + "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==", + "dependencies": { + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "parseurl": "~1.3.3", + "send": "0.19.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==" + }, + "node_modules/side-channel": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", + "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3", + "side-channel-list": "^1.0.0", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz", + "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/statuses": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz", + "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/type-is": { + "version": "1.6.18", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", + "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", + "dependencies": { + "media-typer": "0.3.0", + "mime-types": "~2.1.24" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/unpipe": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", + "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/utils-merge": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", + "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/vary": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", + "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", + "engines": { + "node": ">= 0.8" + } + } + } +} diff --git a/node_modules/@serialport/binding-mock/.releaserc b/node_modules/@serialport/binding-mock/.releaserc new file mode 100644 index 0000000..fa2d899 --- /dev/null +++ b/node_modules/@serialport/binding-mock/.releaserc @@ -0,0 +1,6 @@ +{ + "branches": [ + "main", + "next" + ] +} diff --git a/node_modules/@serialport/binding-mock/LICENSE b/node_modules/@serialport/binding-mock/LICENSE new file mode 100644 index 0000000..c48c4ac --- /dev/null +++ b/node_modules/@serialport/binding-mock/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2021 Francis Gulotta + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/node_modules/@serialport/binding-mock/README.md b/node_modules/@serialport/binding-mock/README.md new file mode 100644 index 0000000..8b63f66 --- /dev/null +++ b/node_modules/@serialport/binding-mock/README.md @@ -0,0 +1,9 @@ +# @serialport/binding-mock + +```ts +import { MockBinding } from '@serialport/binding-mock' +const MockBinding = new MockBinding() + +MockBinding.createPort('/dev/fakePort', { echo: true }) +await MockBinding.write(Buffer.from('data'))) +``` diff --git a/node_modules/@serialport/binding-mock/dist/index-esm.mjs b/node_modules/@serialport/binding-mock/dist/index-esm.mjs new file mode 100644 index 0000000..27f2301 --- /dev/null +++ b/node_modules/@serialport/binding-mock/dist/index-esm.mjs @@ -0,0 +1,271 @@ +import debugFactory from 'debug'; + +const debug = debugFactory('serialport/binding-mock'); +let ports = {}; +let serialNumber = 0; +function resolveNextTick() { + return new Promise(resolve => process.nextTick(() => resolve())); +} +class CanceledError extends Error { + constructor(message) { + super(message); + this.canceled = true; + } +} +const MockBinding = { + reset() { + ports = {}; + serialNumber = 0; + }, + // Create a mock port + createPort(path, options = {}) { + serialNumber++; + const optWithDefaults = Object.assign({ echo: false, record: false, manufacturer: 'The J5 Robotics Company', vendorId: undefined, productId: undefined, maxReadSize: 1024 }, options); + ports[path] = { + data: Buffer.alloc(0), + echo: optWithDefaults.echo, + record: optWithDefaults.record, + readyData: optWithDefaults.readyData, + maxReadSize: optWithDefaults.maxReadSize, + info: { + path, + manufacturer: optWithDefaults.manufacturer, + serialNumber: `${serialNumber}`, + pnpId: undefined, + locationId: undefined, + vendorId: optWithDefaults.vendorId, + productId: optWithDefaults.productId, + }, + }; + debug(serialNumber, 'created port', JSON.stringify({ path, opt: options })); + }, + async list() { + debug(null, 'list'); + return Object.values(ports).map(port => port.info); + }, + async open(options) { + var _a; + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + if (!options.path) { + throw new TypeError('"path" is not a valid port'); + } + if (!options.baudRate) { + throw new TypeError('"baudRate" is not a valid baudRate'); + } + const openOptions = Object.assign({ dataBits: 8, lock: true, stopBits: 1, parity: 'none', rtscts: false, xon: false, xoff: false, xany: false, hupcl: true }, options); + const { path } = openOptions; + debug(null, `open: opening path ${path}`); + const port = ports[path]; + await resolveNextTick(); + if (!port) { + throw new Error(`Port does not exist - please call MockBinding.createPort('${path}') first`); + } + const serialNumber = port.info.serialNumber; + if ((_a = port.openOpt) === null || _a === void 0 ? void 0 : _a.lock) { + debug(serialNumber, 'open: Port is locked cannot open'); + throw new Error('Port is locked cannot open'); + } + debug(serialNumber, `open: opened path ${path}`); + port.openOpt = Object.assign({}, openOptions); + return new MockPortBinding(port, openOptions); + }, +}; +/** + * Mock bindings for pretend serialport access + */ +class MockPortBinding { + constructor(port, openOptions) { + this.port = port; + this.openOptions = openOptions; + this.pendingRead = null; + this.isOpen = true; + this.lastWrite = null; + this.recording = Buffer.alloc(0); + this.writeOperation = null; // in flight promise or null + this.serialNumber = port.info.serialNumber; + if (port.readyData) { + const data = port.readyData; + process.nextTick(() => { + if (this.isOpen) { + debug(this.serialNumber, 'emitting ready data'); + this.emitData(data); + } + }); + } + } + // Emit data on a mock port + emitData(data) { + if (!this.isOpen || !this.port) { + throw new Error('Port must be open to pretend to receive data'); + } + const bufferData = Buffer.isBuffer(data) ? data : Buffer.from(data); + debug(this.serialNumber, 'emitting data - pending read:', Boolean(this.pendingRead)); + this.port.data = Buffer.concat([this.port.data, bufferData]); + if (this.pendingRead) { + process.nextTick(this.pendingRead); + this.pendingRead = null; + } + } + async close() { + debug(this.serialNumber, 'close'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + const port = this.port; + if (!port) { + throw new Error('already closed'); + } + port.openOpt = undefined; + // reset data on close + port.data = Buffer.alloc(0); + debug(this.serialNumber, 'port is closed'); + this.serialNumber = undefined; + this.isOpen = false; + if (this.pendingRead) { + this.pendingRead(new CanceledError('port is closed')); + } + } + async read(buffer, offset, length) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + if (typeof offset !== 'number' || isNaN(offset)) { + throw new TypeError(`"offset" is not an integer got "${isNaN(offset) ? 'NaN' : typeof offset}"`); + } + if (typeof length !== 'number' || isNaN(length)) { + throw new TypeError(`"length" is not an integer got "${isNaN(length) ? 'NaN' : typeof length}"`); + } + if (buffer.length < offset + length) { + throw new Error('buffer is too small'); + } + if (!this.isOpen) { + throw new Error('Port is not open'); + } + debug(this.serialNumber, 'read', length, 'bytes'); + await resolveNextTick(); + if (!this.isOpen || !this.port) { + throw new CanceledError('Read canceled'); + } + if (this.port.data.length <= 0) { + return new Promise((resolve, reject) => { + this.pendingRead = err => { + if (err) { + return reject(err); + } + this.read(buffer, offset, length).then(resolve, reject); + }; + }); + } + const lengthToRead = this.port.maxReadSize > length ? length : this.port.maxReadSize; + const data = this.port.data.slice(0, lengthToRead); + const bytesRead = data.copy(buffer, offset); + this.port.data = this.port.data.slice(lengthToRead); + debug(this.serialNumber, 'read', bytesRead, 'bytes'); + return { bytesRead, buffer }; + } + async write(buffer) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + if (!this.isOpen || !this.port) { + debug('write', 'error port is not open'); + throw new Error('Port is not open'); + } + debug(this.serialNumber, 'write', buffer.length, 'bytes'); + if (this.writeOperation) { + throw new Error('Overlapping writes are not supported and should be queued by the serialport object'); + } + this.writeOperation = (async () => { + await resolveNextTick(); + if (!this.isOpen || !this.port) { + throw new Error('Write canceled'); + } + const data = (this.lastWrite = Buffer.from(buffer)); // copy + if (this.port.record) { + this.recording = Buffer.concat([this.recording, data]); + } + if (this.port.echo) { + process.nextTick(() => { + if (this.isOpen) { + this.emitData(data); + } + }); + } + this.writeOperation = null; + debug(this.serialNumber, 'writing finished'); + })(); + return this.writeOperation; + } + async update(options) { + if (typeof options !== 'object') { + throw TypeError('"options" is not an object'); + } + if (typeof options.baudRate !== 'number') { + throw new TypeError('"options.baudRate" is not a number'); + } + debug(this.serialNumber, 'update'); + if (!this.isOpen || !this.port) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + if (this.port.openOpt) { + this.port.openOpt.baudRate = options.baudRate; + } + } + async set(options) { + if (typeof options !== 'object') { + throw new TypeError('"options" is not an object'); + } + debug(this.serialNumber, 'set'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + } + async get() { + debug(this.serialNumber, 'get'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + return { + cts: true, + dsr: false, + dcd: false, + }; + } + async getBaudRate() { + var _a; + debug(this.serialNumber, 'getBaudRate'); + if (!this.isOpen || !this.port) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + if (!((_a = this.port.openOpt) === null || _a === void 0 ? void 0 : _a.baudRate)) { + throw new Error('Internal Error'); + } + return { + baudRate: this.port.openOpt.baudRate, + }; + } + async flush() { + debug(this.serialNumber, 'flush'); + if (!this.isOpen || !this.port) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + this.port.data = Buffer.alloc(0); + } + async drain() { + debug(this.serialNumber, 'drain'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await this.writeOperation; + await resolveNextTick(); + } +} + +export { CanceledError, MockBinding, MockPortBinding }; diff --git a/node_modules/@serialport/binding-mock/dist/index.d.ts b/node_modules/@serialport/binding-mock/dist/index.d.ts new file mode 100644 index 0000000..57841a1 --- /dev/null +++ b/node_modules/@serialport/binding-mock/dist/index.d.ts @@ -0,0 +1,73 @@ +/// + +import { BindingInterface } from '@serialport/bindings-interface'; +import { BindingPortInterface } from '@serialport/bindings-interface'; +import { OpenOptions } from '@serialport/bindings-interface'; +import { PortInfo } from '@serialport/bindings-interface'; +import { PortStatus } from '@serialport/bindings-interface'; +import { SetOptions } from '@serialport/bindings-interface'; +import { UpdateOptions } from '@serialport/bindings-interface'; + +export declare class CanceledError extends Error { + canceled: true; + constructor(message: string); +} + +export declare interface CreatePortOptions { + echo?: boolean; + record?: boolean; + readyData?: Buffer; + maxReadSize?: number; + manufacturer?: string; + vendorId?: string; + productId?: string; +} + +export declare const MockBinding: MockBindingInterface; + +export declare interface MockBindingInterface extends BindingInterface { + reset(): void; + createPort(path: string, opt?: CreatePortOptions): void; +} + +/** + * Mock bindings for pretend serialport access + */ +export declare class MockPortBinding implements BindingPortInterface { + readonly openOptions: Required; + readonly port: MockPortInternal; + private pendingRead; + lastWrite: null | Buffer; + recording: Buffer; + writeOperation: null | Promise; + isOpen: boolean; + serialNumber?: string; + constructor(port: MockPortInternal, openOptions: Required); + emitData(data: Buffer | string): void; + close(): Promise; + read(buffer: Buffer, offset: number, length: number): Promise<{ + buffer: Buffer; + bytesRead: number; + }>; + write(buffer: Buffer): Promise; + update(options: UpdateOptions): Promise; + set(options: SetOptions): Promise; + get(): Promise; + getBaudRate(): Promise<{ + baudRate: number; + }>; + flush(): Promise; + drain(): Promise; +} + +export declare interface MockPortInternal { + data: Buffer; + echo: boolean; + record: boolean; + info: PortInfo; + maxReadSize: number; + readyData?: Buffer; + openOpt?: OpenOptions; +} + +export { } diff --git a/node_modules/@serialport/binding-mock/dist/index.js b/node_modules/@serialport/binding-mock/dist/index.js new file mode 100644 index 0000000..1ff65cb --- /dev/null +++ b/node_modules/@serialport/binding-mock/dist/index.js @@ -0,0 +1,281 @@ +'use strict'; + +Object.defineProperty(exports, '__esModule', { value: true }); + +var debugFactory = require('debug'); + +function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; } + +var debugFactory__default = /*#__PURE__*/_interopDefaultLegacy(debugFactory); + +const debug = debugFactory__default["default"]('serialport/binding-mock'); +let ports = {}; +let serialNumber = 0; +function resolveNextTick() { + return new Promise(resolve => process.nextTick(() => resolve())); +} +class CanceledError extends Error { + constructor(message) { + super(message); + this.canceled = true; + } +} +const MockBinding = { + reset() { + ports = {}; + serialNumber = 0; + }, + // Create a mock port + createPort(path, options = {}) { + serialNumber++; + const optWithDefaults = Object.assign({ echo: false, record: false, manufacturer: 'The J5 Robotics Company', vendorId: undefined, productId: undefined, maxReadSize: 1024 }, options); + ports[path] = { + data: Buffer.alloc(0), + echo: optWithDefaults.echo, + record: optWithDefaults.record, + readyData: optWithDefaults.readyData, + maxReadSize: optWithDefaults.maxReadSize, + info: { + path, + manufacturer: optWithDefaults.manufacturer, + serialNumber: `${serialNumber}`, + pnpId: undefined, + locationId: undefined, + vendorId: optWithDefaults.vendorId, + productId: optWithDefaults.productId, + }, + }; + debug(serialNumber, 'created port', JSON.stringify({ path, opt: options })); + }, + async list() { + debug(null, 'list'); + return Object.values(ports).map(port => port.info); + }, + async open(options) { + var _a; + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + if (!options.path) { + throw new TypeError('"path" is not a valid port'); + } + if (!options.baudRate) { + throw new TypeError('"baudRate" is not a valid baudRate'); + } + const openOptions = Object.assign({ dataBits: 8, lock: true, stopBits: 1, parity: 'none', rtscts: false, xon: false, xoff: false, xany: false, hupcl: true }, options); + const { path } = openOptions; + debug(null, `open: opening path ${path}`); + const port = ports[path]; + await resolveNextTick(); + if (!port) { + throw new Error(`Port does not exist - please call MockBinding.createPort('${path}') first`); + } + const serialNumber = port.info.serialNumber; + if ((_a = port.openOpt) === null || _a === void 0 ? void 0 : _a.lock) { + debug(serialNumber, 'open: Port is locked cannot open'); + throw new Error('Port is locked cannot open'); + } + debug(serialNumber, `open: opened path ${path}`); + port.openOpt = Object.assign({}, openOptions); + return new MockPortBinding(port, openOptions); + }, +}; +/** + * Mock bindings for pretend serialport access + */ +class MockPortBinding { + constructor(port, openOptions) { + this.port = port; + this.openOptions = openOptions; + this.pendingRead = null; + this.isOpen = true; + this.lastWrite = null; + this.recording = Buffer.alloc(0); + this.writeOperation = null; // in flight promise or null + this.serialNumber = port.info.serialNumber; + if (port.readyData) { + const data = port.readyData; + process.nextTick(() => { + if (this.isOpen) { + debug(this.serialNumber, 'emitting ready data'); + this.emitData(data); + } + }); + } + } + // Emit data on a mock port + emitData(data) { + if (!this.isOpen || !this.port) { + throw new Error('Port must be open to pretend to receive data'); + } + const bufferData = Buffer.isBuffer(data) ? data : Buffer.from(data); + debug(this.serialNumber, 'emitting data - pending read:', Boolean(this.pendingRead)); + this.port.data = Buffer.concat([this.port.data, bufferData]); + if (this.pendingRead) { + process.nextTick(this.pendingRead); + this.pendingRead = null; + } + } + async close() { + debug(this.serialNumber, 'close'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + const port = this.port; + if (!port) { + throw new Error('already closed'); + } + port.openOpt = undefined; + // reset data on close + port.data = Buffer.alloc(0); + debug(this.serialNumber, 'port is closed'); + this.serialNumber = undefined; + this.isOpen = false; + if (this.pendingRead) { + this.pendingRead(new CanceledError('port is closed')); + } + } + async read(buffer, offset, length) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + if (typeof offset !== 'number' || isNaN(offset)) { + throw new TypeError(`"offset" is not an integer got "${isNaN(offset) ? 'NaN' : typeof offset}"`); + } + if (typeof length !== 'number' || isNaN(length)) { + throw new TypeError(`"length" is not an integer got "${isNaN(length) ? 'NaN' : typeof length}"`); + } + if (buffer.length < offset + length) { + throw new Error('buffer is too small'); + } + if (!this.isOpen) { + throw new Error('Port is not open'); + } + debug(this.serialNumber, 'read', length, 'bytes'); + await resolveNextTick(); + if (!this.isOpen || !this.port) { + throw new CanceledError('Read canceled'); + } + if (this.port.data.length <= 0) { + return new Promise((resolve, reject) => { + this.pendingRead = err => { + if (err) { + return reject(err); + } + this.read(buffer, offset, length).then(resolve, reject); + }; + }); + } + const lengthToRead = this.port.maxReadSize > length ? length : this.port.maxReadSize; + const data = this.port.data.slice(0, lengthToRead); + const bytesRead = data.copy(buffer, offset); + this.port.data = this.port.data.slice(lengthToRead); + debug(this.serialNumber, 'read', bytesRead, 'bytes'); + return { bytesRead, buffer }; + } + async write(buffer) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + if (!this.isOpen || !this.port) { + debug('write', 'error port is not open'); + throw new Error('Port is not open'); + } + debug(this.serialNumber, 'write', buffer.length, 'bytes'); + if (this.writeOperation) { + throw new Error('Overlapping writes are not supported and should be queued by the serialport object'); + } + this.writeOperation = (async () => { + await resolveNextTick(); + if (!this.isOpen || !this.port) { + throw new Error('Write canceled'); + } + const data = (this.lastWrite = Buffer.from(buffer)); // copy + if (this.port.record) { + this.recording = Buffer.concat([this.recording, data]); + } + if (this.port.echo) { + process.nextTick(() => { + if (this.isOpen) { + this.emitData(data); + } + }); + } + this.writeOperation = null; + debug(this.serialNumber, 'writing finished'); + })(); + return this.writeOperation; + } + async update(options) { + if (typeof options !== 'object') { + throw TypeError('"options" is not an object'); + } + if (typeof options.baudRate !== 'number') { + throw new TypeError('"options.baudRate" is not a number'); + } + debug(this.serialNumber, 'update'); + if (!this.isOpen || !this.port) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + if (this.port.openOpt) { + this.port.openOpt.baudRate = options.baudRate; + } + } + async set(options) { + if (typeof options !== 'object') { + throw new TypeError('"options" is not an object'); + } + debug(this.serialNumber, 'set'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + } + async get() { + debug(this.serialNumber, 'get'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + return { + cts: true, + dsr: false, + dcd: false, + }; + } + async getBaudRate() { + var _a; + debug(this.serialNumber, 'getBaudRate'); + if (!this.isOpen || !this.port) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + if (!((_a = this.port.openOpt) === null || _a === void 0 ? void 0 : _a.baudRate)) { + throw new Error('Internal Error'); + } + return { + baudRate: this.port.openOpt.baudRate, + }; + } + async flush() { + debug(this.serialNumber, 'flush'); + if (!this.isOpen || !this.port) { + throw new Error('Port is not open'); + } + await resolveNextTick(); + this.port.data = Buffer.alloc(0); + } + async drain() { + debug(this.serialNumber, 'drain'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await this.writeOperation; + await resolveNextTick(); + } +} + +exports.CanceledError = CanceledError; +exports.MockBinding = MockBinding; +exports.MockPortBinding = MockPortBinding; diff --git a/node_modules/@serialport/binding-mock/node_modules/debug/LICENSE b/node_modules/@serialport/binding-mock/node_modules/debug/LICENSE new file mode 100644 index 0000000..1a9820e --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/debug/LICENSE @@ -0,0 +1,20 @@ +(The MIT License) + +Copyright (c) 2014-2017 TJ Holowaychuk +Copyright (c) 2018-2021 Josh Junon + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software +and associated documentation files (the 'Software'), to deal in the Software without restriction, +including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, +and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial +portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT +LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/node_modules/@serialport/binding-mock/node_modules/debug/README.md b/node_modules/@serialport/binding-mock/node_modules/debug/README.md new file mode 100644 index 0000000..9ebdfbf --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/debug/README.md @@ -0,0 +1,481 @@ +# debug +[![OpenCollective](https://opencollective.com/debug/backers/badge.svg)](#backers) +[![OpenCollective](https://opencollective.com/debug/sponsors/badge.svg)](#sponsors) + + + +A tiny JavaScript debugging utility modelled after Node.js core's debugging +technique. Works in Node.js and web browsers. + +## Installation + +```bash +$ npm install debug +``` + +## Usage + +`debug` exposes a function; simply pass this function the name of your module, and it will return a decorated version of `console.error` for you to pass debug statements to. This will allow you to toggle the debug output for different parts of your module as well as the module as a whole. + +Example [_app.js_](./examples/node/app.js): + +```js +var debug = require('debug')('http') + , http = require('http') + , name = 'My App'; + +// fake app + +debug('booting %o', name); + +http.createServer(function(req, res){ + debug(req.method + ' ' + req.url); + res.end('hello\n'); +}).listen(3000, function(){ + debug('listening'); +}); + +// fake worker of some kind + +require('./worker'); +``` + +Example [_worker.js_](./examples/node/worker.js): + +```js +var a = require('debug')('worker:a') + , b = require('debug')('worker:b'); + +function work() { + a('doing lots of uninteresting work'); + setTimeout(work, Math.random() * 1000); +} + +work(); + +function workb() { + b('doing some work'); + setTimeout(workb, Math.random() * 2000); +} + +workb(); +``` + +The `DEBUG` environment variable is then used to enable these based on space or +comma-delimited names. + +Here are some examples: + +screen shot 2017-08-08 at 12 53 04 pm +screen shot 2017-08-08 at 12 53 38 pm +screen shot 2017-08-08 at 12 53 25 pm + +#### Windows command prompt notes + +##### CMD + +On Windows the environment variable is set using the `set` command. + +```cmd +set DEBUG=*,-not_this +``` + +Example: + +```cmd +set DEBUG=* & node app.js +``` + +##### PowerShell (VS Code default) + +PowerShell uses different syntax to set environment variables. + +```cmd +$env:DEBUG = "*,-not_this" +``` + +Example: + +```cmd +$env:DEBUG='app';node app.js +``` + +Then, run the program to be debugged as usual. + +npm script example: +```js + "windowsDebug": "@powershell -Command $env:DEBUG='*';node app.js", +``` + +## Namespace Colors + +Every debug instance has a color generated for it based on its namespace name. +This helps when visually parsing the debug output to identify which debug instance +a debug line belongs to. + +#### Node.js + +In Node.js, colors are enabled when stderr is a TTY. You also _should_ install +the [`supports-color`](https://npmjs.org/supports-color) module alongside debug, +otherwise debug will only use a small handful of basic colors. + + + +#### Web Browser + +Colors are also enabled on "Web Inspectors" that understand the `%c` formatting +option. These are WebKit web inspectors, Firefox ([since version +31](https://hacks.mozilla.org/2014/05/editable-box-model-multiple-selection-sublime-text-keys-much-more-firefox-developer-tools-episode-31/)) +and the Firebug plugin for Firefox (any version). + + + + +## Millisecond diff + +When actively developing an application it can be useful to see when the time spent between one `debug()` call and the next. Suppose for example you invoke `debug()` before requesting a resource, and after as well, the "+NNNms" will show you how much time was spent between calls. + + + +When stdout is not a TTY, `Date#toISOString()` is used, making it more useful for logging the debug information as shown below: + + + + +## Conventions + +If you're using this in one or more of your libraries, you _should_ use the name of your library so that developers may toggle debugging as desired without guessing names. If you have more than one debuggers you _should_ prefix them with your library name and use ":" to separate features. For example "bodyParser" from Connect would then be "connect:bodyParser". If you append a "*" to the end of your name, it will always be enabled regardless of the setting of the DEBUG environment variable. You can then use it for normal output as well as debug output. + +## Wildcards + +The `*` character may be used as a wildcard. Suppose for example your library has +debuggers named "connect:bodyParser", "connect:compress", "connect:session", +instead of listing all three with +`DEBUG=connect:bodyParser,connect:compress,connect:session`, you may simply do +`DEBUG=connect:*`, or to run everything using this module simply use `DEBUG=*`. + +You can also exclude specific debuggers by prefixing them with a "-" character. +For example, `DEBUG=*,-connect:*` would include all debuggers except those +starting with "connect:". + +## Environment Variables + +When running through Node.js, you can set a few environment variables that will +change the behavior of the debug logging: + +| Name | Purpose | +|-----------|-------------------------------------------------| +| `DEBUG` | Enables/disables specific debugging namespaces. | +| `DEBUG_HIDE_DATE` | Hide date from debug output (non-TTY). | +| `DEBUG_COLORS`| Whether or not to use colors in the debug output. | +| `DEBUG_DEPTH` | Object inspection depth. | +| `DEBUG_SHOW_HIDDEN` | Shows hidden properties on inspected objects. | + + +__Note:__ The environment variables beginning with `DEBUG_` end up being +converted into an Options object that gets used with `%o`/`%O` formatters. +See the Node.js documentation for +[`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options) +for the complete list. + +## Formatters + +Debug uses [printf-style](https://wikipedia.org/wiki/Printf_format_string) formatting. +Below are the officially supported formatters: + +| Formatter | Representation | +|-----------|----------------| +| `%O` | Pretty-print an Object on multiple lines. | +| `%o` | Pretty-print an Object all on a single line. | +| `%s` | String. | +| `%d` | Number (both integer and float). | +| `%j` | JSON. Replaced with the string '[Circular]' if the argument contains circular references. | +| `%%` | Single percent sign ('%'). This does not consume an argument. | + + +### Custom formatters + +You can add custom formatters by extending the `debug.formatters` object. +For example, if you wanted to add support for rendering a Buffer as hex with +`%h`, you could do something like: + +```js +const createDebug = require('debug') +createDebug.formatters.h = (v) => { + return v.toString('hex') +} + +// …elsewhere +const debug = createDebug('foo') +debug('this is hex: %h', new Buffer('hello world')) +// foo this is hex: 68656c6c6f20776f726c6421 +0ms +``` + + +## Browser Support + +You can build a browser-ready script using [browserify](https://github.com/substack/node-browserify), +or just use the [browserify-as-a-service](https://wzrd.in/) [build](https://wzrd.in/standalone/debug@latest), +if you don't want to build it yourself. + +Debug's enable state is currently persisted by `localStorage`. +Consider the situation shown below where you have `worker:a` and `worker:b`, +and wish to debug both. You can enable this using `localStorage.debug`: + +```js +localStorage.debug = 'worker:*' +``` + +And then refresh the page. + +```js +a = debug('worker:a'); +b = debug('worker:b'); + +setInterval(function(){ + a('doing some work'); +}, 1000); + +setInterval(function(){ + b('doing some work'); +}, 1200); +``` + +In Chromium-based web browsers (e.g. Brave, Chrome, and Electron), the JavaScript console will—by default—only show messages logged by `debug` if the "Verbose" log level is _enabled_. + + + +## Output streams + + By default `debug` will log to stderr, however this can be configured per-namespace by overriding the `log` method: + +Example [_stdout.js_](./examples/node/stdout.js): + +```js +var debug = require('debug'); +var error = debug('app:error'); + +// by default stderr is used +error('goes to stderr!'); + +var log = debug('app:log'); +// set this namespace to log via console.log +log.log = console.log.bind(console); // don't forget to bind to console! +log('goes to stdout'); +error('still goes to stderr!'); + +// set all output to go via console.info +// overrides all per-namespace log settings +debug.log = console.info.bind(console); +error('now goes to stdout via console.info'); +log('still goes to stdout, but via console.info now'); +``` + +## Extend +You can simply extend debugger +```js +const log = require('debug')('auth'); + +//creates new debug instance with extended namespace +const logSign = log.extend('sign'); +const logLogin = log.extend('login'); + +log('hello'); // auth hello +logSign('hello'); //auth:sign hello +logLogin('hello'); //auth:login hello +``` + +## Set dynamically + +You can also enable debug dynamically by calling the `enable()` method : + +```js +let debug = require('debug'); + +console.log(1, debug.enabled('test')); + +debug.enable('test'); +console.log(2, debug.enabled('test')); + +debug.disable(); +console.log(3, debug.enabled('test')); + +``` + +print : +``` +1 false +2 true +3 false +``` + +Usage : +`enable(namespaces)` +`namespaces` can include modes separated by a colon and wildcards. + +Note that calling `enable()` completely overrides previously set DEBUG variable : + +``` +$ DEBUG=foo node -e 'var dbg = require("debug"); dbg.enable("bar"); console.log(dbg.enabled("foo"))' +=> false +``` + +`disable()` + +Will disable all namespaces. The functions returns the namespaces currently +enabled (and skipped). This can be useful if you want to disable debugging +temporarily without knowing what was enabled to begin with. + +For example: + +```js +let debug = require('debug'); +debug.enable('foo:*,-foo:bar'); +let namespaces = debug.disable(); +debug.enable(namespaces); +``` + +Note: There is no guarantee that the string will be identical to the initial +enable string, but semantically they will be identical. + +## Checking whether a debug target is enabled + +After you've created a debug instance, you can determine whether or not it is +enabled by checking the `enabled` property: + +```javascript +const debug = require('debug')('http'); + +if (debug.enabled) { + // do stuff... +} +``` + +You can also manually toggle this property to force the debug instance to be +enabled or disabled. + +## Usage in child processes + +Due to the way `debug` detects if the output is a TTY or not, colors are not shown in child processes when `stderr` is piped. A solution is to pass the `DEBUG_COLORS=1` environment variable to the child process. +For example: + +```javascript +worker = fork(WORKER_WRAP_PATH, [workerPath], { + stdio: [ + /* stdin: */ 0, + /* stdout: */ 'pipe', + /* stderr: */ 'pipe', + 'ipc', + ], + env: Object.assign({}, process.env, { + DEBUG_COLORS: 1 // without this settings, colors won't be shown + }), +}); + +worker.stderr.pipe(process.stderr, { end: false }); +``` + + +## Authors + + - TJ Holowaychuk + - Nathan Rajlich + - Andrew Rhyne + - Josh Junon + +## Backers + +Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/debug#backer)] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Sponsors + +Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/debug#sponsor)] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## License + +(The MIT License) + +Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca> +Copyright (c) 2018-2021 Josh Junon + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/@serialport/binding-mock/node_modules/debug/package.json b/node_modules/@serialport/binding-mock/node_modules/debug/package.json new file mode 100644 index 0000000..ee8abb5 --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/debug/package.json @@ -0,0 +1,64 @@ +{ + "name": "debug", + "version": "4.4.3", + "repository": { + "type": "git", + "url": "git://github.com/debug-js/debug.git" + }, + "description": "Lightweight debugging utility for Node.js and the browser", + "keywords": [ + "debug", + "log", + "debugger" + ], + "files": [ + "src", + "LICENSE", + "README.md" + ], + "author": "Josh Junon (https://github.com/qix-)", + "contributors": [ + "TJ Holowaychuk ", + "Nathan Rajlich (http://n8.io)", + "Andrew Rhyne " + ], + "license": "MIT", + "scripts": { + "lint": "xo", + "test": "npm run test:node && npm run test:browser && npm run lint", + "test:node": "mocha test.js test.node.js", + "test:browser": "karma start --single-run", + "test:coverage": "cat ./coverage/lcov.info | coveralls" + }, + "dependencies": { + "ms": "^2.1.3" + }, + "devDependencies": { + "brfs": "^2.0.1", + "browserify": "^16.2.3", + "coveralls": "^3.0.2", + "karma": "^3.1.4", + "karma-browserify": "^6.0.0", + "karma-chrome-launcher": "^2.2.0", + "karma-mocha": "^1.3.0", + "mocha": "^5.2.0", + "mocha-lcov-reporter": "^1.2.0", + "sinon": "^14.0.0", + "xo": "^0.23.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + }, + "main": "./src/index.js", + "browser": "./src/browser.js", + "engines": { + "node": ">=6.0" + }, + "xo": { + "rules": { + "import/extensions": "off" + } + } +} diff --git a/node_modules/@serialport/binding-mock/node_modules/debug/src/browser.js b/node_modules/@serialport/binding-mock/node_modules/debug/src/browser.js new file mode 100644 index 0000000..5993451 --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/debug/src/browser.js @@ -0,0 +1,272 @@ +/* eslint-env browser */ + +/** + * This is the web browser implementation of `debug()`. + */ + +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; +exports.storage = localstorage(); +exports.destroy = (() => { + let warned = false; + + return () => { + if (!warned) { + warned = true; + console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.'); + } + }; +})(); + +/** + * Colors. + */ + +exports.colors = [ + '#0000CC', + '#0000FF', + '#0033CC', + '#0033FF', + '#0066CC', + '#0066FF', + '#0099CC', + '#0099FF', + '#00CC00', + '#00CC33', + '#00CC66', + '#00CC99', + '#00CCCC', + '#00CCFF', + '#3300CC', + '#3300FF', + '#3333CC', + '#3333FF', + '#3366CC', + '#3366FF', + '#3399CC', + '#3399FF', + '#33CC00', + '#33CC33', + '#33CC66', + '#33CC99', + '#33CCCC', + '#33CCFF', + '#6600CC', + '#6600FF', + '#6633CC', + '#6633FF', + '#66CC00', + '#66CC33', + '#9900CC', + '#9900FF', + '#9933CC', + '#9933FF', + '#99CC00', + '#99CC33', + '#CC0000', + '#CC0033', + '#CC0066', + '#CC0099', + '#CC00CC', + '#CC00FF', + '#CC3300', + '#CC3333', + '#CC3366', + '#CC3399', + '#CC33CC', + '#CC33FF', + '#CC6600', + '#CC6633', + '#CC9900', + '#CC9933', + '#CCCC00', + '#CCCC33', + '#FF0000', + '#FF0033', + '#FF0066', + '#FF0099', + '#FF00CC', + '#FF00FF', + '#FF3300', + '#FF3333', + '#FF3366', + '#FF3399', + '#FF33CC', + '#FF33FF', + '#FF6600', + '#FF6633', + '#FF9900', + '#FF9933', + '#FFCC00', + '#FFCC33' +]; + +/** + * Currently only WebKit-based Web Inspectors, Firefox >= v31, + * and the Firebug extension (any Firefox version) are known + * to support "%c" CSS customizations. + * + * TODO: add a `localStorage` variable to explicitly enable/disable colors + */ + +// eslint-disable-next-line complexity +function useColors() { + // NB: In an Electron preload script, document will be defined but not fully + // initialized. Since we know we're in Chrome, we'll just detect this case + // explicitly + if (typeof window !== 'undefined' && window.process && (window.process.type === 'renderer' || window.process.__nwjs)) { + return true; + } + + // Internet Explorer and Edge do not support colors. + if (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/(edge|trident)\/(\d+)/)) { + return false; + } + + let m; + + // Is webkit? http://stackoverflow.com/a/16459606/376773 + // document is undefined in react-native: https://github.com/facebook/react-native/pull/1632 + // eslint-disable-next-line no-return-assign + return (typeof document !== 'undefined' && document.documentElement && document.documentElement.style && document.documentElement.style.WebkitAppearance) || + // Is firebug? http://stackoverflow.com/a/398120/376773 + (typeof window !== 'undefined' && window.console && (window.console.firebug || (window.console.exception && window.console.table))) || + // Is firefox >= v31? + // https://developer.mozilla.org/en-US/docs/Tools/Web_Console#Styling_messages + (typeof navigator !== 'undefined' && navigator.userAgent && (m = navigator.userAgent.toLowerCase().match(/firefox\/(\d+)/)) && parseInt(m[1], 10) >= 31) || + // Double check webkit in userAgent just in case we are in a worker + (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/applewebkit\/(\d+)/)); +} + +/** + * Colorize log arguments if enabled. + * + * @api public + */ + +function formatArgs(args) { + args[0] = (this.useColors ? '%c' : '') + + this.namespace + + (this.useColors ? ' %c' : ' ') + + args[0] + + (this.useColors ? '%c ' : ' ') + + '+' + module.exports.humanize(this.diff); + + if (!this.useColors) { + return; + } + + const c = 'color: ' + this.color; + args.splice(1, 0, c, 'color: inherit'); + + // The final "%c" is somewhat tricky, because there could be other + // arguments passed either before or after the %c, so we need to + // figure out the correct index to insert the CSS into + let index = 0; + let lastC = 0; + args[0].replace(/%[a-zA-Z%]/g, match => { + if (match === '%%') { + return; + } + index++; + if (match === '%c') { + // We only are interested in the *last* %c + // (the user may have provided their own) + lastC = index; + } + }); + + args.splice(lastC, 0, c); +} + +/** + * Invokes `console.debug()` when available. + * No-op when `console.debug` is not a "function". + * If `console.debug` is not available, falls back + * to `console.log`. + * + * @api public + */ +exports.log = console.debug || console.log || (() => {}); + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ +function save(namespaces) { + try { + if (namespaces) { + exports.storage.setItem('debug', namespaces); + } else { + exports.storage.removeItem('debug'); + } + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ +function load() { + let r; + try { + r = exports.storage.getItem('debug') || exports.storage.getItem('DEBUG') ; + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } + + // If debug isn't set in LS, and we're in Electron, try to load $DEBUG + if (!r && typeof process !== 'undefined' && 'env' in process) { + r = process.env.DEBUG; + } + + return r; +} + +/** + * Localstorage attempts to return the localstorage. + * + * This is necessary because safari throws + * when a user disables cookies/localstorage + * and you attempt to access it. + * + * @return {LocalStorage} + * @api private + */ + +function localstorage() { + try { + // TVMLKit (Apple TV JS Runtime) does not have a window object, just localStorage in the global context + // The Browser also has localStorage in the global context. + return localStorage; + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } +} + +module.exports = require('./common')(exports); + +const {formatters} = module.exports; + +/** + * Map %j to `JSON.stringify()`, since no Web Inspectors do that by default. + */ + +formatters.j = function (v) { + try { + return JSON.stringify(v); + } catch (error) { + return '[UnexpectedJSONParseError]: ' + error.message; + } +}; diff --git a/node_modules/@serialport/binding-mock/node_modules/debug/src/common.js b/node_modules/@serialport/binding-mock/node_modules/debug/src/common.js new file mode 100644 index 0000000..141cb57 --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/debug/src/common.js @@ -0,0 +1,292 @@ + +/** + * This is the common logic for both the Node.js and web browser + * implementations of `debug()`. + */ + +function setup(env) { + createDebug.debug = createDebug; + createDebug.default = createDebug; + createDebug.coerce = coerce; + createDebug.disable = disable; + createDebug.enable = enable; + createDebug.enabled = enabled; + createDebug.humanize = require('ms'); + createDebug.destroy = destroy; + + Object.keys(env).forEach(key => { + createDebug[key] = env[key]; + }); + + /** + * The currently active debug mode names, and names to skip. + */ + + createDebug.names = []; + createDebug.skips = []; + + /** + * Map of special "%n" handling functions, for the debug "format" argument. + * + * Valid key names are a single, lower or upper-case letter, i.e. "n" and "N". + */ + createDebug.formatters = {}; + + /** + * Selects a color for a debug namespace + * @param {String} namespace The namespace string for the debug instance to be colored + * @return {Number|String} An ANSI color code for the given namespace + * @api private + */ + function selectColor(namespace) { + let hash = 0; + + for (let i = 0; i < namespace.length; i++) { + hash = ((hash << 5) - hash) + namespace.charCodeAt(i); + hash |= 0; // Convert to 32bit integer + } + + return createDebug.colors[Math.abs(hash) % createDebug.colors.length]; + } + createDebug.selectColor = selectColor; + + /** + * Create a debugger with the given `namespace`. + * + * @param {String} namespace + * @return {Function} + * @api public + */ + function createDebug(namespace) { + let prevTime; + let enableOverride = null; + let namespacesCache; + let enabledCache; + + function debug(...args) { + // Disabled? + if (!debug.enabled) { + return; + } + + const self = debug; + + // Set `diff` timestamp + const curr = Number(new Date()); + const ms = curr - (prevTime || curr); + self.diff = ms; + self.prev = prevTime; + self.curr = curr; + prevTime = curr; + + args[0] = createDebug.coerce(args[0]); + + if (typeof args[0] !== 'string') { + // Anything else let's inspect with %O + args.unshift('%O'); + } + + // Apply any `formatters` transformations + let index = 0; + args[0] = args[0].replace(/%([a-zA-Z%])/g, (match, format) => { + // If we encounter an escaped % then don't increase the array index + if (match === '%%') { + return '%'; + } + index++; + const formatter = createDebug.formatters[format]; + if (typeof formatter === 'function') { + const val = args[index]; + match = formatter.call(self, val); + + // Now we need to remove `args[index]` since it's inlined in the `format` + args.splice(index, 1); + index--; + } + return match; + }); + + // Apply env-specific formatting (colors, etc.) + createDebug.formatArgs.call(self, args); + + const logFn = self.log || createDebug.log; + logFn.apply(self, args); + } + + debug.namespace = namespace; + debug.useColors = createDebug.useColors(); + debug.color = createDebug.selectColor(namespace); + debug.extend = extend; + debug.destroy = createDebug.destroy; // XXX Temporary. Will be removed in the next major release. + + Object.defineProperty(debug, 'enabled', { + enumerable: true, + configurable: false, + get: () => { + if (enableOverride !== null) { + return enableOverride; + } + if (namespacesCache !== createDebug.namespaces) { + namespacesCache = createDebug.namespaces; + enabledCache = createDebug.enabled(namespace); + } + + return enabledCache; + }, + set: v => { + enableOverride = v; + } + }); + + // Env-specific initialization logic for debug instances + if (typeof createDebug.init === 'function') { + createDebug.init(debug); + } + + return debug; + } + + function extend(namespace, delimiter) { + const newDebug = createDebug(this.namespace + (typeof delimiter === 'undefined' ? ':' : delimiter) + namespace); + newDebug.log = this.log; + return newDebug; + } + + /** + * Enables a debug mode by namespaces. This can include modes + * separated by a colon and wildcards. + * + * @param {String} namespaces + * @api public + */ + function enable(namespaces) { + createDebug.save(namespaces); + createDebug.namespaces = namespaces; + + createDebug.names = []; + createDebug.skips = []; + + const split = (typeof namespaces === 'string' ? namespaces : '') + .trim() + .replace(/\s+/g, ',') + .split(',') + .filter(Boolean); + + for (const ns of split) { + if (ns[0] === '-') { + createDebug.skips.push(ns.slice(1)); + } else { + createDebug.names.push(ns); + } + } + } + + /** + * Checks if the given string matches a namespace template, honoring + * asterisks as wildcards. + * + * @param {String} search + * @param {String} template + * @return {Boolean} + */ + function matchesTemplate(search, template) { + let searchIndex = 0; + let templateIndex = 0; + let starIndex = -1; + let matchIndex = 0; + + while (searchIndex < search.length) { + if (templateIndex < template.length && (template[templateIndex] === search[searchIndex] || template[templateIndex] === '*')) { + // Match character or proceed with wildcard + if (template[templateIndex] === '*') { + starIndex = templateIndex; + matchIndex = searchIndex; + templateIndex++; // Skip the '*' + } else { + searchIndex++; + templateIndex++; + } + } else if (starIndex !== -1) { // eslint-disable-line no-negated-condition + // Backtrack to the last '*' and try to match more characters + templateIndex = starIndex + 1; + matchIndex++; + searchIndex = matchIndex; + } else { + return false; // No match + } + } + + // Handle trailing '*' in template + while (templateIndex < template.length && template[templateIndex] === '*') { + templateIndex++; + } + + return templateIndex === template.length; + } + + /** + * Disable debug output. + * + * @return {String} namespaces + * @api public + */ + function disable() { + const namespaces = [ + ...createDebug.names, + ...createDebug.skips.map(namespace => '-' + namespace) + ].join(','); + createDebug.enable(''); + return namespaces; + } + + /** + * Returns true if the given mode name is enabled, false otherwise. + * + * @param {String} name + * @return {Boolean} + * @api public + */ + function enabled(name) { + for (const skip of createDebug.skips) { + if (matchesTemplate(name, skip)) { + return false; + } + } + + for (const ns of createDebug.names) { + if (matchesTemplate(name, ns)) { + return true; + } + } + + return false; + } + + /** + * Coerce `val`. + * + * @param {Mixed} val + * @return {Mixed} + * @api private + */ + function coerce(val) { + if (val instanceof Error) { + return val.stack || val.message; + } + return val; + } + + /** + * XXX DO NOT USE. This is a temporary stub function. + * XXX It WILL be removed in the next major release. + */ + function destroy() { + console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.'); + } + + createDebug.enable(createDebug.load()); + + return createDebug; +} + +module.exports = setup; diff --git a/node_modules/@serialport/binding-mock/node_modules/debug/src/index.js b/node_modules/@serialport/binding-mock/node_modules/debug/src/index.js new file mode 100644 index 0000000..bf4c57f --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/debug/src/index.js @@ -0,0 +1,10 @@ +/** + * Detect Electron renderer / nwjs process, which is node, but we should + * treat as a browser. + */ + +if (typeof process === 'undefined' || process.type === 'renderer' || process.browser === true || process.__nwjs) { + module.exports = require('./browser.js'); +} else { + module.exports = require('./node.js'); +} diff --git a/node_modules/@serialport/binding-mock/node_modules/debug/src/node.js b/node_modules/@serialport/binding-mock/node_modules/debug/src/node.js new file mode 100644 index 0000000..715560a --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/debug/src/node.js @@ -0,0 +1,263 @@ +/** + * Module dependencies. + */ + +const tty = require('tty'); +const util = require('util'); + +/** + * This is the Node.js implementation of `debug()`. + */ + +exports.init = init; +exports.log = log; +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; +exports.destroy = util.deprecate( + () => {}, + 'Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.' +); + +/** + * Colors. + */ + +exports.colors = [6, 2, 3, 4, 5, 1]; + +try { + // Optional dependency (as in, doesn't need to be installed, NOT like optionalDependencies in package.json) + // eslint-disable-next-line import/no-extraneous-dependencies + const supportsColor = require('supports-color'); + + if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) { + exports.colors = [ + 20, + 21, + 26, + 27, + 32, + 33, + 38, + 39, + 40, + 41, + 42, + 43, + 44, + 45, + 56, + 57, + 62, + 63, + 68, + 69, + 74, + 75, + 76, + 77, + 78, + 79, + 80, + 81, + 92, + 93, + 98, + 99, + 112, + 113, + 128, + 129, + 134, + 135, + 148, + 149, + 160, + 161, + 162, + 163, + 164, + 165, + 166, + 167, + 168, + 169, + 170, + 171, + 172, + 173, + 178, + 179, + 184, + 185, + 196, + 197, + 198, + 199, + 200, + 201, + 202, + 203, + 204, + 205, + 206, + 207, + 208, + 209, + 214, + 215, + 220, + 221 + ]; + } +} catch (error) { + // Swallow - we only care if `supports-color` is available; it doesn't have to be. +} + +/** + * Build up the default `inspectOpts` object from the environment variables. + * + * $ DEBUG_COLORS=no DEBUG_DEPTH=10 DEBUG_SHOW_HIDDEN=enabled node script.js + */ + +exports.inspectOpts = Object.keys(process.env).filter(key => { + return /^debug_/i.test(key); +}).reduce((obj, key) => { + // Camel-case + const prop = key + .substring(6) + .toLowerCase() + .replace(/_([a-z])/g, (_, k) => { + return k.toUpperCase(); + }); + + // Coerce string value into JS value + let val = process.env[key]; + if (/^(yes|on|true|enabled)$/i.test(val)) { + val = true; + } else if (/^(no|off|false|disabled)$/i.test(val)) { + val = false; + } else if (val === 'null') { + val = null; + } else { + val = Number(val); + } + + obj[prop] = val; + return obj; +}, {}); + +/** + * Is stdout a TTY? Colored output is enabled when `true`. + */ + +function useColors() { + return 'colors' in exports.inspectOpts ? + Boolean(exports.inspectOpts.colors) : + tty.isatty(process.stderr.fd); +} + +/** + * Adds ANSI color escape codes if enabled. + * + * @api public + */ + +function formatArgs(args) { + const {namespace: name, useColors} = this; + + if (useColors) { + const c = this.color; + const colorCode = '\u001B[3' + (c < 8 ? c : '8;5;' + c); + const prefix = ` ${colorCode};1m${name} \u001B[0m`; + + args[0] = prefix + args[0].split('\n').join('\n' + prefix); + args.push(colorCode + 'm+' + module.exports.humanize(this.diff) + '\u001B[0m'); + } else { + args[0] = getDate() + name + ' ' + args[0]; + } +} + +function getDate() { + if (exports.inspectOpts.hideDate) { + return ''; + } + return new Date().toISOString() + ' '; +} + +/** + * Invokes `util.formatWithOptions()` with the specified arguments and writes to stderr. + */ + +function log(...args) { + return process.stderr.write(util.formatWithOptions(exports.inspectOpts, ...args) + '\n'); +} + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ +function save(namespaces) { + if (namespaces) { + process.env.DEBUG = namespaces; + } else { + // If you set a process.env field to null or undefined, it gets cast to the + // string 'null' or 'undefined'. Just delete instead. + delete process.env.DEBUG; + } +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ + +function load() { + return process.env.DEBUG; +} + +/** + * Init logic for `debug` instances. + * + * Create a new `inspectOpts` object in case `useColors` is set + * differently for a particular `debug` instance. + */ + +function init(debug) { + debug.inspectOpts = {}; + + const keys = Object.keys(exports.inspectOpts); + for (let i = 0; i < keys.length; i++) { + debug.inspectOpts[keys[i]] = exports.inspectOpts[keys[i]]; + } +} + +module.exports = require('./common')(exports); + +const {formatters} = module.exports; + +/** + * Map %o to `util.inspect()`, all on a single line. + */ + +formatters.o = function (v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts) + .split('\n') + .map(str => str.trim()) + .join(' '); +}; + +/** + * Map %O to `util.inspect()`, allowing multiple lines if needed. + */ + +formatters.O = function (v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts); +}; diff --git a/node_modules/@serialport/binding-mock/node_modules/ms/index.js b/node_modules/@serialport/binding-mock/node_modules/ms/index.js new file mode 100644 index 0000000..ea734fb --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/ms/index.js @@ -0,0 +1,162 @@ +/** + * Helpers. + */ + +var s = 1000; +var m = s * 60; +var h = m * 60; +var d = h * 24; +var w = d * 7; +var y = d * 365.25; + +/** + * Parse or format the given `val`. + * + * Options: + * + * - `long` verbose formatting [false] + * + * @param {String|Number} val + * @param {Object} [options] + * @throws {Error} throw an error if val is not a non-empty string or a number + * @return {String|Number} + * @api public + */ + +module.exports = function (val, options) { + options = options || {}; + var type = typeof val; + if (type === 'string' && val.length > 0) { + return parse(val); + } else if (type === 'number' && isFinite(val)) { + return options.long ? fmtLong(val) : fmtShort(val); + } + throw new Error( + 'val is not a non-empty string or a valid number. val=' + + JSON.stringify(val) + ); +}; + +/** + * Parse the given `str` and return milliseconds. + * + * @param {String} str + * @return {Number} + * @api private + */ + +function parse(str) { + str = String(str); + if (str.length > 100) { + return; + } + var match = /^(-?(?:\d+)?\.?\d+) *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|years?|yrs?|y)?$/i.exec( + str + ); + if (!match) { + return; + } + var n = parseFloat(match[1]); + var type = (match[2] || 'ms').toLowerCase(); + switch (type) { + case 'years': + case 'year': + case 'yrs': + case 'yr': + case 'y': + return n * y; + case 'weeks': + case 'week': + case 'w': + return n * w; + case 'days': + case 'day': + case 'd': + return n * d; + case 'hours': + case 'hour': + case 'hrs': + case 'hr': + case 'h': + return n * h; + case 'minutes': + case 'minute': + case 'mins': + case 'min': + case 'm': + return n * m; + case 'seconds': + case 'second': + case 'secs': + case 'sec': + case 's': + return n * s; + case 'milliseconds': + case 'millisecond': + case 'msecs': + case 'msec': + case 'ms': + return n; + default: + return undefined; + } +} + +/** + * Short format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtShort(ms) { + var msAbs = Math.abs(ms); + if (msAbs >= d) { + return Math.round(ms / d) + 'd'; + } + if (msAbs >= h) { + return Math.round(ms / h) + 'h'; + } + if (msAbs >= m) { + return Math.round(ms / m) + 'm'; + } + if (msAbs >= s) { + return Math.round(ms / s) + 's'; + } + return ms + 'ms'; +} + +/** + * Long format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtLong(ms) { + var msAbs = Math.abs(ms); + if (msAbs >= d) { + return plural(ms, msAbs, d, 'day'); + } + if (msAbs >= h) { + return plural(ms, msAbs, h, 'hour'); + } + if (msAbs >= m) { + return plural(ms, msAbs, m, 'minute'); + } + if (msAbs >= s) { + return plural(ms, msAbs, s, 'second'); + } + return ms + ' ms'; +} + +/** + * Pluralization helper. + */ + +function plural(ms, msAbs, n, name) { + var isPlural = msAbs >= n * 1.5; + return Math.round(ms / n) + ' ' + name + (isPlural ? 's' : ''); +} diff --git a/node_modules/@serialport/binding-mock/node_modules/ms/license.md b/node_modules/@serialport/binding-mock/node_modules/ms/license.md new file mode 100644 index 0000000..fa5d39b --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/ms/license.md @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2020 Vercel, Inc. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/node_modules/@serialport/binding-mock/node_modules/ms/package.json b/node_modules/@serialport/binding-mock/node_modules/ms/package.json new file mode 100644 index 0000000..4997189 --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/ms/package.json @@ -0,0 +1,38 @@ +{ + "name": "ms", + "version": "2.1.3", + "description": "Tiny millisecond conversion utility", + "repository": "vercel/ms", + "main": "./index", + "files": [ + "index.js" + ], + "scripts": { + "precommit": "lint-staged", + "lint": "eslint lib/* bin/*", + "test": "mocha tests.js" + }, + "eslintConfig": { + "extends": "eslint:recommended", + "env": { + "node": true, + "es6": true + } + }, + "lint-staged": { + "*.js": [ + "npm run lint", + "prettier --single-quote --write", + "git add" + ] + }, + "license": "MIT", + "devDependencies": { + "eslint": "4.18.2", + "expect.js": "0.3.1", + "husky": "0.14.3", + "lint-staged": "5.0.0", + "mocha": "4.0.1", + "prettier": "2.0.5" + } +} diff --git a/node_modules/@serialport/binding-mock/node_modules/ms/readme.md b/node_modules/@serialport/binding-mock/node_modules/ms/readme.md new file mode 100644 index 0000000..0fc1abb --- /dev/null +++ b/node_modules/@serialport/binding-mock/node_modules/ms/readme.md @@ -0,0 +1,59 @@ +# ms + +![CI](https://github.com/vercel/ms/workflows/CI/badge.svg) + +Use this package to easily convert various time formats to milliseconds. + +## Examples + +```js +ms('2 days') // 172800000 +ms('1d') // 86400000 +ms('10h') // 36000000 +ms('2.5 hrs') // 9000000 +ms('2h') // 7200000 +ms('1m') // 60000 +ms('5s') // 5000 +ms('1y') // 31557600000 +ms('100') // 100 +ms('-3 days') // -259200000 +ms('-1h') // -3600000 +ms('-200') // -200 +``` + +### Convert from Milliseconds + +```js +ms(60000) // "1m" +ms(2 * 60000) // "2m" +ms(-3 * 60000) // "-3m" +ms(ms('10 hours')) // "10h" +``` + +### Time Format Written-Out + +```js +ms(60000, { long: true }) // "1 minute" +ms(2 * 60000, { long: true }) // "2 minutes" +ms(-3 * 60000, { long: true }) // "-3 minutes" +ms(ms('10 hours'), { long: true }) // "10 hours" +``` + +## Features + +- Works both in [Node.js](https://nodejs.org) and in the browser +- If a number is supplied to `ms`, a string with a unit is returned +- If a string that contains the number is supplied, it returns it as a number (e.g.: it returns `100` for `'100'`) +- If you pass a string with a number and a valid unit, the number of equivalent milliseconds is returned + +## Related Packages + +- [ms.macro](https://github.com/knpwrs/ms.macro) - Run `ms` as a macro at build-time. + +## Caught a Bug? + +1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device +2. Link the package to the global module directory: `npm link` +3. Within the module you want to test your local development instance of ms, just link it to the dependencies: `npm link ms`. Instead of the default one from npm, Node.js will now use your clone of ms! + +As always, you can run the tests using: `npm test` diff --git a/node_modules/@serialport/binding-mock/package.json b/node_modules/@serialport/binding-mock/package.json new file mode 100644 index 0000000..348bc0e --- /dev/null +++ b/node_modules/@serialport/binding-mock/package.json @@ -0,0 +1,58 @@ +{ + "name": "@serialport/binding-mock", + "version": "10.2.2", + "description": "The mock serialport bindings", + "types": "./dist/index.d.ts", + "main": "./dist/index.js", + "exports": { + "require": "./dist/index.js", + "default": "./dist/index-esm.mjs" + }, + "engines": { + "node": ">=12.0.0" + }, + "repository": "git@github.com:serialport/binding-mock.git", + "homepage": "https://github.com/serialport/binding-mock", + "scripts": { + "test": "mocha", + "lint": "tsc && eslint lib/**/*.ts", + "format": "eslint lib/**/*.ts --fix", + "clean": "rm -rf dist-ts dist", + "build": "npm run clean && tsc -p tsconfig-build.json && rollup -c && node -r esbuild-register bundle-types", + "prepublishOnly": "npm run build", + "semantic-release": "semantic-release" + }, + "keywords": [ + "serialport-binding", + "debug" + ], + "license": "MIT", + "devDependencies": { + "@microsoft/api-extractor": "7.19.4", + "@types/chai": "4.3.0", + "@types/mocha": "9.1.0", + "@types/node": "17.0.15", + "@typescript-eslint/eslint-plugin": "5.10.2", + "@typescript-eslint/parser": "5.10.2", + "chai": "4.3.6", + "esbuild": "0.14.18", + "esbuild-register": "3.3.2", + "eslint": "8.8.0", + "mocha": "9.2.0", + "rollup": "2.67.0", + "rollup-plugin-node-resolve": "5.2.0", + "semantic-release": "19.0.2", + "typescript": "4.5.5" + }, + "mocha": { + "bail": true, + "require": [ + "esbuild-register" + ], + "spec": "lib/**/*-test.ts" + }, + "dependencies": { + "@serialport/bindings-interface": "^1.2.1", + "debug": "^4.3.3" + } +} diff --git a/node_modules/@serialport/bindings-cpp/LICENSE b/node_modules/@serialport/bindings-cpp/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/bindings-cpp/README.md b/node_modules/@serialport/bindings-cpp/README.md new file mode 100644 index 0000000..1bf126a --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/README.md @@ -0,0 +1,95 @@ +# @serialport/bindings-cpp + +[![Backers on Open Collective](https://opencollective.com/serialport/backers/badge.svg)](#backers) +[![Sponsors on Open Collective](https://opencollective.com/serialport/sponsors/badge.svg)](#sponsors) +[![codecov](https://codecov.io/gh/serialport/bindings-cpp/branch/main/graph/badge.svg?token=rsGeOmdnsV)](https://codecov.io/gh/serialport/bindings-cpp) +[![Test / Lint](https://github.com/serialport/bindings-cpp/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/serialport/bindings-cpp/actions/workflows/test.yml) + +Access serial ports with JavaScript. Linux, OSX and Windows. Welcome your robotic JavaScript overlords. Better yet, program them! + +> Go to https://serialport.io/ to learn more, find guides and api documentation. + +## Quick Links + +- 📚 [**Guides**](https://serialport.io/docs/) +- [**API Docs**](https://serialport.io/docs/api-serialport) +- [`@serialport/bindings-cpp`](https://www.npmjs.com/package/@serialport/bindings-cpp) +- 🐛 [Help and Bugs](https://github.com/serialport/node-serialport/issues/new/choose) All serialport issues are pointed to the main serialport repo. + +### Bindings + +The Bindings provide a low level interface to work with your serialport. It is possible to use them alone but it's usually easier to use them with an interface. + +- [`@serialport/bindings-cpp`](https://serialport.io/docs/api-bindings-cpp) bindings for Linux, Mac and Windows +- [`@serialport/binding-interface`](https://serialport.io/docs/api-bindings-interface) as an interface to use if you're making your own bindings +- [`@serialport/binding-mock`](https://serialport.io/docs/api-binding-mock) for a mock binding package for testing + +## Developing + +### Developing node serialport projects + +1. Clone this repo `git clone git@github.com:serialport/bindings-cpp.git` +1. Run `npm install` to setup local package dependencies (run this any time you depend on a package local to this repo) +1. Run `npm test` to ensure everything is working properly +1. If you have a serial loopback device (TX to RX) you can run run `TEST_PORT=/path/to/port npm test` for a more comprehensive test suite. (Defaults to 115200 baud customize with the TEST_BAUD env.) You can use an arduino with the `test/arduino-echo` sketch. + +### Developing Docs + +See https://github.com/serialport/website + +## License + +SerialPort packages are all [MIT licensed](LICENSE) and all it's dependencies are MIT licensed. + +## Code of Conduct + +SerialPort follows the [Nodebots Code of Conduct](http://nodebots.io/conduct.html). While the code is MIT licensed participation in the community has some rules to make this a good place to work and learn. + +### TLDR + +- Be respectful. +- Abusive behavior is never tolerated. +- Data published to NodeBots is hosted at the discretion of the service administrators, and may be removed. +- Don't build evil robots. +- Violations of this code may result in swift and permanent expulsion from the NodeBots community. + +## Governance and Community + +SerialPort is currently employees a [governance](https://medium.com/the-node-js-collection/healthy-open-source-967fa8be7951) with a group of maintainers, committers and contributors, all fixing bugs and adding features and improving documentation. You need not apply to work on SerialPort, all are welcome to join, build, and maintain this project. + +- A Contributor is any individual creating or commenting on an issue or pull request. By participating, this is you. +- Committers are contributors who have been given write access to the repository. They can review and merge pull requests. +- Maintainers are committers representing the required technical expertise to resolve rare disputes. + +If you have a PR that improves the project people in any or all of the above people will help you land it. + +**Maintainers** + +- [Francis Gulotta](https://twitter.com/reconbot) | [reconbot](https://github.com/reconbot) +- [Nick Hehr](https://twitter.com/hipsterbrown) | [hipsterbrown](https://github.com/hipsterbrown) + +### Contributors + +This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)]. + + +### Backers + +Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/serialport#backer)] + + + +### Sponsors + +Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/serialport#sponsor)] + + diff --git a/node_modules/@serialport/bindings-cpp/binding.gyp b/node_modules/@serialport/bindings-cpp/binding.gyp new file mode 100644 index 0000000..f944385 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/binding.gyp @@ -0,0 +1,80 @@ +{ + 'variables': { + 'openssl_fips': '' + }, + 'targets': [{ + 'target_name': 'bindings', + 'sources': [ + 'src/serialport.cpp' + ], + 'include_dirs': [" +import { BindingPortInterface } from '.'; +import { BindingInterface, OpenOptions, PortStatus, SetOptions, UpdateOptions } from '@serialport/bindings-interface'; +import { Poller } from './poller'; +export interface DarwinOpenOptions extends OpenOptions { + /** Defaults to none */ + parity?: 'none' | 'even' | 'odd'; + /** see [`man termios`](http://linux.die.net/man/3/termios) defaults to 1 */ + vmin?: number; + /** see [`man termios`](http://linux.die.net/man/3/termios) defaults to 0 */ + vtime?: number; +} +export type DarwinBindingInterface = BindingInterface; +export declare const DarwinBinding: DarwinBindingInterface; +/** + * The Darwin binding layer for OSX + */ +export declare class DarwinPortBinding implements BindingPortInterface { + readonly openOptions: Required; + readonly poller: Poller; + private writeOperation; + fd: null | number; + constructor(fd: number, options: Required); + get isOpen(): boolean; + close(): Promise; + read(buffer: Buffer, offset: number, length: number): Promise<{ + buffer: Buffer; + bytesRead: number; + }>; + write(buffer: Buffer): Promise; + update(options: UpdateOptions): Promise; + set(options: SetOptions): Promise; + get(): Promise; + getBaudRate(): Promise<{ + baudRate: number; + }>; + flush(): Promise; + drain(): Promise; +} diff --git a/node_modules/@serialport/bindings-cpp/dist/darwin.js b/node_modules/@serialport/bindings-cpp/dist/darwin.js new file mode 100644 index 0000000..ada895b --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/darwin.js @@ -0,0 +1,148 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.DarwinPortBinding = exports.DarwinBinding = void 0; +const debug_1 = __importDefault(require("debug")); +const load_bindings_1 = require("./load-bindings"); +const poller_1 = require("./poller"); +const unix_read_1 = require("./unix-read"); +const unix_write_1 = require("./unix-write"); +const debug = (0, debug_1.default)('serialport/bindings-cpp'); +exports.DarwinBinding = { + list() { + debug('list'); + return (0, load_bindings_1.asyncList)(); + }, + async open(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + if (!options.path) { + throw new TypeError('"path" is not a valid port'); + } + if (!options.baudRate) { + throw new TypeError('"baudRate" is not a valid baudRate'); + } + debug('open'); + const openOptions = Object.assign({ vmin: 1, vtime: 0, dataBits: 8, lock: true, stopBits: 1, parity: 'none', rtscts: false, xon: false, xoff: false, xany: false, hupcl: true }, options); + const fd = await (0, load_bindings_1.asyncOpen)(openOptions.path, openOptions); + return new DarwinPortBinding(fd, openOptions); + }, +}; +/** + * The Darwin binding layer for OSX + */ +class DarwinPortBinding { + constructor(fd, options) { + this.fd = fd; + this.openOptions = options; + this.poller = new poller_1.Poller(fd); + this.writeOperation = null; + } + get isOpen() { + return this.fd !== null; + } + async close() { + debug('close'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + const fd = this.fd; + this.poller.stop(); + this.poller.destroy(); + this.fd = null; + await (0, load_bindings_1.asyncClose)(fd); + } + async read(buffer, offset, length) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + if (typeof offset !== 'number' || isNaN(offset)) { + throw new TypeError(`"offset" is not an integer got "${isNaN(offset) ? 'NaN' : typeof offset}"`); + } + if (typeof length !== 'number' || isNaN(length)) { + throw new TypeError(`"length" is not an integer got "${isNaN(length) ? 'NaN' : typeof length}"`); + } + debug('read'); + if (buffer.length < offset + length) { + throw new Error('buffer is too small'); + } + if (!this.isOpen) { + throw new Error('Port is not open'); + } + return (0, unix_read_1.unixRead)({ binding: this, buffer, offset, length }); + } + async write(buffer) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + debug('write', buffer.length, 'bytes'); + if (!this.isOpen) { + debug('write', 'error port is not open'); + throw new Error('Port is not open'); + } + this.writeOperation = (async () => { + if (buffer.length === 0) { + return; + } + await (0, unix_write_1.unixWrite)({ binding: this, buffer }); + this.writeOperation = null; + })(); + return this.writeOperation; + } + async update(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw TypeError('"options" is not an object'); + } + if (typeof options.baudRate !== 'number') { + throw new TypeError('"options.baudRate" is not a number'); + } + debug('update'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncUpdate)(this.fd, options); + } + async set(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + debug('set', options); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncSet)(this.fd, options); + } + async get() { + debug('get'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + return (0, load_bindings_1.asyncGet)(this.fd); + } + async getBaudRate() { + debug('getBaudRate'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + throw new Error('getBaudRate is not implemented on darwin'); + } + async flush() { + debug('flush'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncFlush)(this.fd); + } + async drain() { + debug('drain'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await this.writeOperation; + await (0, load_bindings_1.asyncDrain)(this.fd); + } +} +exports.DarwinPortBinding = DarwinPortBinding; diff --git a/node_modules/@serialport/bindings-cpp/dist/errors.d.ts b/node_modules/@serialport/bindings-cpp/dist/errors.d.ts new file mode 100644 index 0000000..8d21f61 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/errors.d.ts @@ -0,0 +1,7 @@ +import { BindingsErrorInterface } from '@serialport/bindings-interface'; +export declare class BindingsError extends Error implements BindingsErrorInterface { + canceled: boolean; + constructor(message: string, { canceled }?: { + canceled?: boolean | undefined; + }); +} diff --git a/node_modules/@serialport/bindings-cpp/dist/errors.js b/node_modules/@serialport/bindings-cpp/dist/errors.js new file mode 100644 index 0000000..3102828 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/errors.js @@ -0,0 +1,10 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.BindingsError = void 0; +class BindingsError extends Error { + constructor(message, { canceled = false } = {}) { + super(message); + this.canceled = canceled; + } +} +exports.BindingsError = BindingsError; diff --git a/node_modules/@serialport/bindings-cpp/dist/index.d.ts b/node_modules/@serialport/bindings-cpp/dist/index.d.ts new file mode 100644 index 0000000..b1a7564 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/index.d.ts @@ -0,0 +1,13 @@ +import { DarwinBindingInterface } from './darwin'; +import { LinuxBindingInterface } from './linux'; +import { WindowsBindingInterface } from './win32'; +export * from '@serialport/bindings-interface'; +export * from './darwin'; +export * from './linux'; +export * from './win32'; +export * from './errors'; +export type AutoDetectTypes = DarwinBindingInterface | WindowsBindingInterface | LinuxBindingInterface; +/** + * This is an auto detected binding for your current platform + */ +export declare function autoDetect(): AutoDetectTypes; diff --git a/node_modules/@serialport/bindings-cpp/dist/index.js b/node_modules/@serialport/bindings-cpp/dist/index.js new file mode 100644 index 0000000..cc9c436 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/index.js @@ -0,0 +1,48 @@ +"use strict"; +var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) { + if (k2 === undefined) k2 = k; + var desc = Object.getOwnPropertyDescriptor(m, k); + if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) { + desc = { enumerable: true, get: function() { return m[k]; } }; + } + Object.defineProperty(o, k2, desc); +}) : (function(o, m, k, k2) { + if (k2 === undefined) k2 = k; + o[k2] = m[k]; +})); +var __exportStar = (this && this.__exportStar) || function(m, exports) { + for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p); +}; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.autoDetect = void 0; +/* eslint-disable @typescript-eslint/no-var-requires */ +const debug_1 = __importDefault(require("debug")); +const darwin_1 = require("./darwin"); +const linux_1 = require("./linux"); +const win32_1 = require("./win32"); +const debug = (0, debug_1.default)('serialport/bindings-cpp'); +__exportStar(require("@serialport/bindings-interface"), exports); +__exportStar(require("./darwin"), exports); +__exportStar(require("./linux"), exports); +__exportStar(require("./win32"), exports); +__exportStar(require("./errors"), exports); +/** + * This is an auto detected binding for your current platform + */ +function autoDetect() { + switch (process.platform) { + case 'win32': + debug('loading WindowsBinding'); + return win32_1.WindowsBinding; + case 'darwin': + debug('loading DarwinBinding'); + return darwin_1.DarwinBinding; + default: + debug('loading LinuxBinding'); + return linux_1.LinuxBinding; + } +} +exports.autoDetect = autoDetect; diff --git a/node_modules/@serialport/bindings-cpp/dist/linux-list.d.ts b/node_modules/@serialport/bindings-cpp/dist/linux-list.d.ts new file mode 100644 index 0000000..0f35891 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/linux-list.d.ts @@ -0,0 +1,4 @@ +/// +import { spawn } from 'child_process'; +import { PortInfo } from '@serialport/bindings-interface'; +export declare function linuxList(spawnCmd?: typeof spawn): Promise; diff --git a/node_modules/@serialport/bindings-cpp/dist/linux-list.js b/node_modules/@serialport/bindings-cpp/dist/linux-list.js new file mode 100644 index 0000000..4569b59 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/linux-list.js @@ -0,0 +1,115 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.linuxList = void 0; +const child_process_1 = require("child_process"); +const parser_readline_1 = require("@serialport/parser-readline"); +// get only serial port names +function checkPathOfDevice(path) { + return /(tty(S|WCH|ACM|USB|AMA|MFD|O|XRUSB)|rfcomm)/.test(path) && path; +} +function propName(name) { + return { + DEVNAME: 'path', + ID_VENDOR_ENC: 'manufacturer', + ID_SERIAL_SHORT: 'serialNumber', + ID_VENDOR_ID: 'vendorId', + ID_MODEL_ID: 'productId', + DEVLINKS: 'pnpId', + /** + * Workaround for systemd defect + * see https://github.com/serialport/bindings-cpp/issues/115 + */ + ID_USB_VENDOR_ENC: 'manufacturer', + ID_USB_SERIAL_SHORT: 'serialNumber', + ID_USB_VENDOR_ID: 'vendorId', + ID_USB_MODEL_ID: 'productId', + // End of workaround + }[name.toUpperCase()]; +} +function decodeHexEscape(str) { + return str.replace(/\\x([a-fA-F0-9]{2})/g, (a, b) => { + return String.fromCharCode(parseInt(b, 16)); + }); +} +function propVal(name, val) { + if (name === 'pnpId') { + const match = val.match(/\/by-id\/([^\s]+)/); + return (match === null || match === void 0 ? void 0 : match[1]) || undefined; + } + if (name === 'manufacturer') { + return decodeHexEscape(val); + } + if (/^0x/.test(val)) { + return val.substr(2); + } + return val; +} +function linuxList(spawnCmd = child_process_1.spawn) { + const ports = []; + const udevadm = spawnCmd('udevadm', ['info', '-e']); + const lines = udevadm.stdout.pipe(new parser_readline_1.ReadlineParser()); + let skipPort = false; + let port = { + path: '', + manufacturer: undefined, + serialNumber: undefined, + pnpId: undefined, + locationId: undefined, + vendorId: undefined, + productId: undefined, + }; + lines.on('data', (line) => { + const lineType = line.slice(0, 1); + const data = line.slice(3); + // new port entry + if (lineType === 'P') { + port = { + path: '', + manufacturer: undefined, + serialNumber: undefined, + pnpId: undefined, + locationId: undefined, + vendorId: undefined, + productId: undefined, + }; + skipPort = false; + return; + } + if (skipPort) { + return; + } + // Check dev name and save port if it matches flag to skip the rest of the data if not + if (lineType === 'N') { + if (checkPathOfDevice(data)) { + ports.push(port); + } + else { + skipPort = true; + } + return; + } + // parse data about each port + if (lineType === 'E') { + const keyValue = data.match(/^(.+)=(.*)/); + if (!keyValue) { + return; + } + const key = propName(keyValue[1]); + if (!key) { + return; + } + port[key] = propVal(key, keyValue[2]); + } + }); + return new Promise((resolve, reject) => { + udevadm.on('close', (code) => { + if (code) { + reject(new Error(`Error listing ports udevadm exited with error code: ${code}`)); + } + }); + udevadm.on('error', reject); + lines.on('error', reject); + lines.on('finish', () => resolve(ports)); + }); +} +exports.linuxList = linuxList; diff --git a/node_modules/@serialport/bindings-cpp/dist/linux.d.ts b/node_modules/@serialport/bindings-cpp/dist/linux.d.ts new file mode 100644 index 0000000..f11ee1b --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/linux.d.ts @@ -0,0 +1,46 @@ +/// +import { Poller } from './poller'; +import { BindingInterface, OpenOptions, PortStatus, SetOptions, UpdateOptions } from '@serialport/bindings-interface'; +import { BindingPortInterface } from '.'; +export interface LinuxOpenOptions extends OpenOptions { + /** Defaults to none */ + parity?: 'none' | 'even' | 'odd'; + /** see [`man termios`](http://linux.die.net/man/3/termios) defaults to 1 */ + vmin?: number; + /** see [`man termios`](http://linux.die.net/man/3/termios) defaults to 0 */ + vtime?: number; +} +export interface LinuxPortStatus extends PortStatus { + lowLatency: boolean; +} +export interface LinuxSetOptions extends SetOptions { + /** Low latency mode */ + lowLatency?: boolean; +} +export type LinuxBindingInterface = BindingInterface; +export declare const LinuxBinding: LinuxBindingInterface; +/** + * The linux binding layer + */ +export declare class LinuxPortBinding implements BindingPortInterface { + readonly openOptions: Required; + readonly poller: Poller; + private writeOperation; + fd: number | null; + constructor(fd: number, openOptions: Required); + get isOpen(): boolean; + close(): Promise; + read(buffer: Buffer, offset: number, length: number): Promise<{ + buffer: Buffer; + bytesRead: number; + }>; + write(buffer: Buffer): Promise; + update(options: UpdateOptions): Promise; + set(options: LinuxSetOptions): Promise; + get(): Promise; + getBaudRate(): Promise<{ + baudRate: number; + }>; + flush(): Promise; + drain(): Promise; +} diff --git a/node_modules/@serialport/bindings-cpp/dist/linux.js b/node_modules/@serialport/bindings-cpp/dist/linux.js new file mode 100644 index 0000000..5056300 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/linux.js @@ -0,0 +1,150 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.LinuxPortBinding = exports.LinuxBinding = void 0; +const debug_1 = __importDefault(require("debug")); +const linux_list_1 = require("./linux-list"); +const poller_1 = require("./poller"); +const unix_read_1 = require("./unix-read"); +const unix_write_1 = require("./unix-write"); +const load_bindings_1 = require("./load-bindings"); +const debug = (0, debug_1.default)('serialport/bindings-cpp'); +exports.LinuxBinding = { + list() { + debug('list'); + return (0, linux_list_1.linuxList)(); + }, + async open(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + if (!options.path) { + throw new TypeError('"path" is not a valid port'); + } + if (!options.baudRate) { + throw new TypeError('"baudRate" is not a valid baudRate'); + } + debug('open'); + const openOptions = Object.assign({ vmin: 1, vtime: 0, dataBits: 8, lock: true, stopBits: 1, parity: 'none', rtscts: false, xon: false, xoff: false, xany: false, hupcl: true }, options); + const fd = await (0, load_bindings_1.asyncOpen)(openOptions.path, openOptions); + this.fd = fd; + return new LinuxPortBinding(fd, openOptions); + }, +}; +/** + * The linux binding layer + */ +class LinuxPortBinding { + constructor(fd, openOptions) { + this.fd = fd; + this.openOptions = openOptions; + this.poller = new poller_1.Poller(fd); + this.writeOperation = null; + } + get isOpen() { + return this.fd !== null; + } + async close() { + debug('close'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + const fd = this.fd; + this.poller.stop(); + this.poller.destroy(); + this.fd = null; + await (0, load_bindings_1.asyncClose)(fd); + } + async read(buffer, offset, length) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + if (typeof offset !== 'number' || isNaN(offset)) { + throw new TypeError(`"offset" is not an integer got "${isNaN(offset) ? 'NaN' : typeof offset}"`); + } + if (typeof length !== 'number' || isNaN(length)) { + throw new TypeError(`"length" is not an integer got "${isNaN(length) ? 'NaN' : typeof length}"`); + } + debug('read'); + if (buffer.length < offset + length) { + throw new Error('buffer is too small'); + } + if (!this.isOpen) { + throw new Error('Port is not open'); + } + return (0, unix_read_1.unixRead)({ binding: this, buffer, offset, length }); + } + async write(buffer) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + debug('write', buffer.length, 'bytes'); + if (!this.isOpen) { + debug('write', 'error port is not open'); + throw new Error('Port is not open'); + } + this.writeOperation = (async () => { + if (buffer.length === 0) { + return; + } + await (0, unix_write_1.unixWrite)({ binding: this, buffer }); + this.writeOperation = null; + })(); + return this.writeOperation; + } + async update(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw TypeError('"options" is not an object'); + } + if (typeof options.baudRate !== 'number') { + throw new TypeError('"options.baudRate" is not a number'); + } + debug('update'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncUpdate)(this.fd, options); + } + async set(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + debug('set'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncSet)(this.fd, options); + } + async get() { + debug('get'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + return (0, load_bindings_1.asyncGet)(this.fd); + } + async getBaudRate() { + debug('getBaudRate'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + return (0, load_bindings_1.asyncGetBaudRate)(this.fd); + } + async flush() { + debug('flush'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncFlush)(this.fd); + } + async drain() { + debug('drain'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await this.writeOperation; + await (0, load_bindings_1.asyncDrain)(this.fd); + } +} +exports.LinuxPortBinding = LinuxPortBinding; diff --git a/node_modules/@serialport/bindings-cpp/dist/load-bindings.d.ts b/node_modules/@serialport/bindings-cpp/dist/load-bindings.d.ts new file mode 100644 index 0000000..d5e7971 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/load-bindings.d.ts @@ -0,0 +1,11 @@ +export declare const asyncClose: Function; +export declare const asyncDrain: Function; +export declare const asyncFlush: Function; +export declare const asyncGet: Function; +export declare const asyncGetBaudRate: Function; +export declare const asyncList: Function; +export declare const asyncOpen: Function; +export declare const asyncSet: Function; +export declare const asyncUpdate: Function; +export declare const asyncRead: Function; +export declare const asyncWrite: Function; diff --git a/node_modules/@serialport/bindings-cpp/dist/load-bindings.js b/node_modules/@serialport/bindings-cpp/dist/load-bindings.js new file mode 100644 index 0000000..1fc911f --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/load-bindings.js @@ -0,0 +1,22 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.asyncWrite = exports.asyncRead = exports.asyncUpdate = exports.asyncSet = exports.asyncOpen = exports.asyncList = exports.asyncGetBaudRate = exports.asyncGet = exports.asyncFlush = exports.asyncDrain = exports.asyncClose = void 0; +const node_gyp_build_1 = __importDefault(require("node-gyp-build")); +const util_1 = require("util"); +const path_1 = require("path"); +// eslint-disable-next-line @typescript-eslint/no-explicit-any +const binding = (0, node_gyp_build_1.default)((0, path_1.join)(__dirname, '../')); +exports.asyncClose = binding.close ? (0, util_1.promisify)(binding.close) : async () => { throw new Error('"binding.close" Method not implemented'); }; +exports.asyncDrain = binding.drain ? (0, util_1.promisify)(binding.drain) : async () => { throw new Error('"binding.drain" Method not implemented'); }; +exports.asyncFlush = binding.flush ? (0, util_1.promisify)(binding.flush) : async () => { throw new Error('"binding.flush" Method not implemented'); }; +exports.asyncGet = binding.get ? (0, util_1.promisify)(binding.get) : async () => { throw new Error('"binding.get" Method not implemented'); }; +exports.asyncGetBaudRate = binding.getBaudRate ? (0, util_1.promisify)(binding.getBaudRate) : async () => { throw new Error('"binding.getBaudRate" Method not implemented'); }; +exports.asyncList = binding.list ? (0, util_1.promisify)(binding.list) : async () => { throw new Error('"binding.list" Method not implemented'); }; +exports.asyncOpen = binding.open ? (0, util_1.promisify)(binding.open) : async () => { throw new Error('"binding.open" Method not implemented'); }; +exports.asyncSet = binding.set ? (0, util_1.promisify)(binding.set) : async () => { throw new Error('"binding.set" Method not implemented'); }; +exports.asyncUpdate = binding.update ? (0, util_1.promisify)(binding.update) : async () => { throw new Error('"binding.update" Method not implemented'); }; +exports.asyncRead = binding.read ? (0, util_1.promisify)(binding.read) : async () => { throw new Error('"binding.read" Method not implemented'); }; +exports.asyncWrite = binding.write ? (0, util_1.promisify)(binding.write) : async () => { throw new Error('"binding.write" Method not implemented'); }; diff --git a/node_modules/@serialport/bindings-cpp/dist/poller.d.ts b/node_modules/@serialport/bindings-cpp/dist/poller.d.ts new file mode 100644 index 0000000..008fea2 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/poller.d.ts @@ -0,0 +1,40 @@ +/// +import { EventEmitter } from 'events'; +interface PollerClass { + new (fd: number, cb: (err: Error, flag: number) => void): PollerInstance; +} +interface PollerInstance { + poll(flag: number): void; + stop(): void; + destroy(): void; +} +export declare const EVENTS: { + UV_READABLE: number; + UV_WRITABLE: number; + UV_DISCONNECT: number; +}; +/** + * Polls unix systems for readable or writable states of a file or serialport + */ +export declare class Poller extends EventEmitter { + poller: PollerInstance; + constructor(fd: number, FDPoller?: PollerClass); + /** + * Wait for the next event to occur + * @param {string} event ('readable'|'writable'|'disconnect') + * @returns {Poller} returns itself + */ + once(event: 'readable' | 'writable' | 'disconnect', callback: (err: null | Error) => void): this; + /** + * Ask the bindings to listen for an event, it is recommend to use `.once()` for easy use + * @param {EVENTS} eventFlag polls for an event or group of events based upon a flag. + */ + poll(eventFlag?: number): void; + /** + * Stop listening for events and cancel all outstanding listening with an error + */ + stop(): void; + destroy(): void; + emitCanceled(): void; +} +export {}; diff --git a/node_modules/@serialport/bindings-cpp/dist/poller.js b/node_modules/@serialport/bindings-cpp/dist/poller.js new file mode 100644 index 0000000..0eeafb2 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/poller.js @@ -0,0 +1,104 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.Poller = exports.EVENTS = void 0; +const debug_1 = __importDefault(require("debug")); +const events_1 = require("events"); +const path_1 = require("path"); +const node_gyp_build_1 = __importDefault(require("node-gyp-build")); +const errors_1 = require("./errors"); +const { Poller: PollerBindings } = (0, node_gyp_build_1.default)((0, path_1.join)(__dirname, '../')); +const logger = (0, debug_1.default)('serialport/bindings-cpp/poller'); +exports.EVENTS = { + UV_READABLE: 0b0001, + UV_WRITABLE: 0b0010, + UV_DISCONNECT: 0b0100, +}; +function handleEvent(error, eventFlag) { + if (error) { + logger('error', error); + this.emit('readable', error); + this.emit('writable', error); + this.emit('disconnect', error); + return; + } + if (eventFlag & exports.EVENTS.UV_READABLE) { + logger('received "readable"'); + this.emit('readable', null); + } + if (eventFlag & exports.EVENTS.UV_WRITABLE) { + logger('received "writable"'); + this.emit('writable', null); + } + if (eventFlag & exports.EVENTS.UV_DISCONNECT) { + logger('received "disconnect"'); + this.emit('disconnect', null); + } +} +/** + * Polls unix systems for readable or writable states of a file or serialport + */ +class Poller extends events_1.EventEmitter { + constructor(fd, FDPoller = PollerBindings) { + logger('Creating poller'); + super(); + this.poller = new FDPoller(fd, handleEvent.bind(this)); + } + /** + * Wait for the next event to occur + * @param {string} event ('readable'|'writable'|'disconnect') + * @returns {Poller} returns itself + */ + once(event, callback) { + switch (event) { + case 'readable': + this.poll(exports.EVENTS.UV_READABLE); + break; + case 'writable': + this.poll(exports.EVENTS.UV_WRITABLE); + break; + case 'disconnect': + this.poll(exports.EVENTS.UV_DISCONNECT); + break; + } + return super.once(event, callback); + } + /** + * Ask the bindings to listen for an event, it is recommend to use `.once()` for easy use + * @param {EVENTS} eventFlag polls for an event or group of events based upon a flag. + */ + poll(eventFlag = 0) { + if (eventFlag & exports.EVENTS.UV_READABLE) { + logger('Polling for "readable"'); + } + if (eventFlag & exports.EVENTS.UV_WRITABLE) { + logger('Polling for "writable"'); + } + if (eventFlag & exports.EVENTS.UV_DISCONNECT) { + logger('Polling for "disconnect"'); + } + this.poller.poll(eventFlag); + } + /** + * Stop listening for events and cancel all outstanding listening with an error + */ + stop() { + logger('Stopping poller'); + this.poller.stop(); + this.emitCanceled(); + } + destroy() { + logger('Destroying poller'); + this.poller.destroy(); + this.emitCanceled(); + } + emitCanceled() { + const err = new errors_1.BindingsError('Canceled', { canceled: true }); + this.emit('readable', err); + this.emit('writable', err); + this.emit('disconnect', err); + } +} +exports.Poller = Poller; diff --git a/node_modules/@serialport/bindings-cpp/dist/unix-read.d.ts b/node_modules/@serialport/bindings-cpp/dist/unix-read.d.ts new file mode 100644 index 0000000..2a94c52 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/unix-read.d.ts @@ -0,0 +1,18 @@ +/// +/// +import { read as fsRead } from 'fs'; +import { LinuxPortBinding } from './linux'; +import { DarwinPortBinding } from './darwin'; +declare const readAsync: typeof fsRead.__promisify__; +interface UnixReadOptions { + binding: LinuxPortBinding | DarwinPortBinding; + buffer: Buffer; + offset: number; + length: number; + fsReadAsync?: typeof readAsync; +} +export declare const unixRead: ({ binding, buffer, offset, length, fsReadAsync, }: UnixReadOptions) => Promise<{ + buffer: Buffer; + bytesRead: number; +}>; +export {}; diff --git a/node_modules/@serialport/bindings-cpp/dist/unix-read.js b/node_modules/@serialport/bindings-cpp/dist/unix-read.js new file mode 100644 index 0000000..e442812 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/unix-read.js @@ -0,0 +1,55 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.unixRead = void 0; +const util_1 = require("util"); +const fs_1 = require("fs"); +const errors_1 = require("./errors"); +const debug_1 = __importDefault(require("debug")); +const logger = (0, debug_1.default)('serialport/bindings-cpp/unixRead'); +const readAsync = (0, util_1.promisify)(fs_1.read); +const readable = (binding) => { + return new Promise((resolve, reject) => { + if (!binding.poller) { + throw new Error('No poller on bindings'); + } + binding.poller.once('readable', err => (err ? reject(err) : resolve())); + }); +}; +const unixRead = async ({ binding, buffer, offset, length, fsReadAsync = readAsync, }) => { + logger('Starting read'); + if (!binding.isOpen || !binding.fd) { + throw new errors_1.BindingsError('Port is not open', { canceled: true }); + } + try { + const { bytesRead } = await fsReadAsync(binding.fd, buffer, offset, length, null); + if (bytesRead === 0) { + return (0, exports.unixRead)({ binding, buffer, offset, length, fsReadAsync }); + } + logger('Finished read', bytesRead, 'bytes'); + return { bytesRead, buffer }; + } + catch (err) { + logger('read error', err); + if (err.code === 'EAGAIN' || err.code === 'EWOULDBLOCK' || err.code === 'EINTR') { + if (!binding.isOpen) { + throw new errors_1.BindingsError('Port is not open', { canceled: true }); + } + logger('waiting for readable because of code:', err.code); + await readable(binding); + return (0, exports.unixRead)({ binding, buffer, offset, length, fsReadAsync }); + } + const disconnectError = err.code === 'EBADF' || // Bad file number means we got closed + err.code === 'ENXIO' || // No such device or address probably usb disconnect + err.code === 'UNKNOWN' || + err.errno === -1; // generic error + if (disconnectError) { + err.disconnect = true; + logger('disconnecting', err); + } + throw err; + } +}; +exports.unixRead = unixRead; diff --git a/node_modules/@serialport/bindings-cpp/dist/unix-write.d.ts b/node_modules/@serialport/bindings-cpp/dist/unix-write.d.ts new file mode 100644 index 0000000..34d11cf --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/unix-write.d.ts @@ -0,0 +1,14 @@ +/// +/// +import { write } from 'fs'; +import { LinuxPortBinding } from './linux'; +import { DarwinPortBinding } from './darwin'; +declare const writeAsync: typeof write.__promisify__; +interface UnixWriteOptions { + binding: LinuxPortBinding | DarwinPortBinding; + buffer: Buffer; + offset?: number; + fsWriteAsync?: typeof writeAsync; +} +export declare const unixWrite: ({ binding, buffer, offset, fsWriteAsync }: UnixWriteOptions) => Promise; +export {}; diff --git a/node_modules/@serialport/bindings-cpp/dist/unix-write.js b/node_modules/@serialport/bindings-cpp/dist/unix-write.js new file mode 100644 index 0000000..f4b48f6 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/unix-write.js @@ -0,0 +1,56 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.unixWrite = void 0; +const fs_1 = require("fs"); +const debug_1 = __importDefault(require("debug")); +const util_1 = require("util"); +const logger = (0, debug_1.default)('serialport/bindings-cpp/unixWrite'); +const writeAsync = (0, util_1.promisify)(fs_1.write); +const writable = (binding) => { + return new Promise((resolve, reject) => { + binding.poller.once('writable', err => (err ? reject(err) : resolve())); + }); +}; +const unixWrite = async ({ binding, buffer, offset = 0, fsWriteAsync = writeAsync }) => { + const bytesToWrite = buffer.length - offset; + logger('Starting write', buffer.length, 'bytes offset', offset, 'bytesToWrite', bytesToWrite); + if (!binding.isOpen || !binding.fd) { + throw new Error('Port is not open'); + } + try { + const { bytesWritten } = await fsWriteAsync(binding.fd, buffer, offset, bytesToWrite); + logger('write returned: wrote', bytesWritten, 'bytes'); + if (bytesWritten + offset < buffer.length) { + if (!binding.isOpen) { + throw new Error('Port is not open'); + } + return (0, exports.unixWrite)({ binding, buffer, offset: bytesWritten + offset, fsWriteAsync }); + } + logger('Finished writing', bytesWritten + offset, 'bytes'); + } + catch (err) { + logger('write errored', err); + if (err.code === 'EAGAIN' || err.code === 'EWOULDBLOCK' || err.code === 'EINTR') { + if (!binding.isOpen) { + throw new Error('Port is not open'); + } + logger('waiting for writable because of code:', err.code); + await writable(binding); + return (0, exports.unixWrite)({ binding, buffer, offset, fsWriteAsync }); + } + const disconnectError = err.code === 'EBADF' || // Bad file number means we got closed + err.code === 'ENXIO' || // No such device or address probably usb disconnect + err.code === 'UNKNOWN' || + err.errno === -1; // generic error + if (disconnectError) { + err.disconnect = true; + logger('disconnecting', err); + } + logger('error', err); + throw err; + } +}; +exports.unixWrite = unixWrite; diff --git a/node_modules/@serialport/bindings-cpp/dist/win32-sn-parser.d.ts b/node_modules/@serialport/bindings-cpp/dist/win32-sn-parser.d.ts new file mode 100644 index 0000000..4320ab7 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/win32-sn-parser.d.ts @@ -0,0 +1 @@ +export declare const serialNumParser: (pnpId?: string) => string | null; diff --git a/node_modules/@serialport/bindings-cpp/dist/win32-sn-parser.js b/node_modules/@serialport/bindings-cpp/dist/win32-sn-parser.js new file mode 100644 index 0000000..05e67d2 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/win32-sn-parser.js @@ -0,0 +1,17 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.serialNumParser = void 0; +const PARSERS = [/USB\\(?:.+)\\(.+)/, /FTDIBUS\\(?:.+)\+(.+?)A?\\.+/]; +const serialNumParser = (pnpId) => { + if (!pnpId) { + return null; + } + for (const parser of PARSERS) { + const sn = pnpId.match(parser); + if (sn) { + return sn[1]; + } + } + return null; +}; +exports.serialNumParser = serialNumParser; diff --git a/node_modules/@serialport/bindings-cpp/dist/win32.d.ts b/node_modules/@serialport/bindings-cpp/dist/win32.d.ts new file mode 100644 index 0000000..91d8565 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/win32.d.ts @@ -0,0 +1,35 @@ +/// +import { BindingPortInterface } from '.'; +import { BindingInterface, OpenOptions, PortStatus, SetOptions, UpdateOptions } from '@serialport/bindings-interface'; +export interface WindowsOpenOptions extends OpenOptions { + /** Device parity defaults to none */ + parity?: 'none' | 'even' | 'odd' | 'mark' | 'space'; + /** RTS mode defaults to handshake */ + rtsMode?: 'handshake' | 'enable' | 'toggle'; +} +export type WindowsBindingInterface = BindingInterface; +export declare const WindowsBinding: WindowsBindingInterface; +/** + * The Windows binding layer + */ +export declare class WindowsPortBinding implements BindingPortInterface { + fd: null | number; + writeOperation: Promise | null; + openOptions: Required; + constructor(fd: number, options: Required); + get isOpen(): boolean; + close(): Promise; + read(buffer: Buffer, offset: number, length: number): Promise<{ + buffer: Buffer; + bytesRead: number; + }>; + write(buffer: Buffer): Promise; + update(options: UpdateOptions): Promise; + set(options: SetOptions): Promise; + get(): Promise; + getBaudRate(): Promise<{ + baudRate: number; + }>; + flush(): Promise; + drain(): Promise; +} diff --git a/node_modules/@serialport/bindings-cpp/dist/win32.js b/node_modules/@serialport/bindings-cpp/dist/win32.js new file mode 100644 index 0000000..24c897a --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/dist/win32.js @@ -0,0 +1,162 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.WindowsPortBinding = exports.WindowsBinding = void 0; +const debug_1 = __importDefault(require("debug")); +const _1 = require("."); +const load_bindings_1 = require("./load-bindings"); +const win32_sn_parser_1 = require("./win32-sn-parser"); +const debug = (0, debug_1.default)('serialport/bindings-cpp'); +exports.WindowsBinding = { + async list() { + const ports = await (0, load_bindings_1.asyncList)(); + // Grab the serial number from the pnp id + return ports.map(port => { + if (port.pnpId && !port.serialNumber) { + const serialNumber = (0, win32_sn_parser_1.serialNumParser)(port.pnpId); + if (serialNumber) { + return Object.assign(Object.assign({}, port), { serialNumber }); + } + } + return port; + }); + }, + async open(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + if (!options.path) { + throw new TypeError('"path" is not a valid port'); + } + if (!options.baudRate) { + throw new TypeError('"baudRate" is not a valid baudRate'); + } + debug('open'); + const openOptions = Object.assign({ dataBits: 8, lock: true, stopBits: 1, parity: 'none', rtscts: false, rtsMode: 'handshake', xon: false, xoff: false, xany: false, hupcl: true }, options); + const fd = await (0, load_bindings_1.asyncOpen)(openOptions.path, openOptions); + return new WindowsPortBinding(fd, openOptions); + }, +}; +/** + * The Windows binding layer + */ +class WindowsPortBinding { + constructor(fd, options) { + this.fd = fd; + this.openOptions = options; + this.writeOperation = null; + } + get isOpen() { + return this.fd !== null; + } + async close() { + debug('close'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + const fd = this.fd; + this.fd = null; + await (0, load_bindings_1.asyncClose)(fd); + } + async read(buffer, offset, length) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + if (typeof offset !== 'number' || isNaN(offset)) { + throw new TypeError(`"offset" is not an integer got "${isNaN(offset) ? 'NaN' : typeof offset}"`); + } + if (typeof length !== 'number' || isNaN(length)) { + throw new TypeError(`"length" is not an integer got "${isNaN(length) ? 'NaN' : typeof length}"`); + } + debug('read'); + if (buffer.length < offset + length) { + throw new Error('buffer is too small'); + } + if (!this.isOpen) { + throw new Error('Port is not open'); + } + try { + const bytesRead = await (0, load_bindings_1.asyncRead)(this.fd, buffer, offset, length); + return { bytesRead, buffer }; + } + catch (err) { + if (!this.isOpen) { + throw new _1.BindingsError(err.message, { canceled: true }); + } + throw err; + } + } + async write(buffer) { + if (!Buffer.isBuffer(buffer)) { + throw new TypeError('"buffer" is not a Buffer'); + } + debug('write', buffer.length, 'bytes'); + if (!this.isOpen) { + debug('write', 'error port is not open'); + throw new Error('Port is not open'); + } + this.writeOperation = (async () => { + if (buffer.length === 0) { + return; + } + await (0, load_bindings_1.asyncWrite)(this.fd, buffer); + this.writeOperation = null; + })(); + return this.writeOperation; + } + async update(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw TypeError('"options" is not an object'); + } + if (typeof options.baudRate !== 'number') { + throw new TypeError('"options.baudRate" is not a number'); + } + debug('update'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncUpdate)(this.fd, options); + } + async set(options) { + if (!options || typeof options !== 'object' || Array.isArray(options)) { + throw new TypeError('"options" is not an object'); + } + debug('set', options); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncSet)(this.fd, options); + } + async get() { + debug('get'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + return (0, load_bindings_1.asyncGet)(this.fd); + } + async getBaudRate() { + debug('getBaudRate'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + return (0, load_bindings_1.asyncGetBaudRate)(this.fd); + } + async flush() { + debug('flush'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await (0, load_bindings_1.asyncFlush)(this.fd); + } + async drain() { + debug('drain'); + if (!this.isOpen) { + throw new Error('Port is not open'); + } + await this.writeOperation; + await (0, load_bindings_1.asyncDrain)(this.fd); + } +} +exports.WindowsPortBinding = WindowsPortBinding; diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/LICENSE b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/README.md b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/README.md new file mode 100644 index 0000000..55437e2 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-delimiter + +See our api docs https://serialport.io/docs/api-parser-delimiter diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/dist/index.d.ts b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/dist/index.d.ts new file mode 100644 index 0000000..33f361e --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/dist/index.d.ts @@ -0,0 +1,23 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface DelimiterOptions extends TransformOptions { + /** The delimiter on which to split incoming data. */ + delimiter: string | Buffer | number[]; + /** Should the delimiter be included at the end of data. Defaults to `false` */ + includeDelimiter?: boolean; +} +/** + * A transform stream that emits data each time a byte sequence is received. + * @extends Transform + * + * To use the `Delimiter` parser, provide a delimiter as a string, buffer, or array of bytes. Runs in O(n) time. + */ +export declare class DelimiterParser extends Transform { + includeDelimiter: boolean; + delimiter: Buffer; + buffer: Buffer; + constructor({ delimiter, includeDelimiter, ...options }: DelimiterOptions); + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/dist/index.js b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/dist/index.js new file mode 100644 index 0000000..bf56bcc --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/dist/index.js @@ -0,0 +1,40 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.DelimiterParser = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that emits data each time a byte sequence is received. + * @extends Transform + * + * To use the `Delimiter` parser, provide a delimiter as a string, buffer, or array of bytes. Runs in O(n) time. + */ +class DelimiterParser extends stream_1.Transform { + constructor({ delimiter, includeDelimiter = false, ...options }) { + super(options); + if (delimiter === undefined) { + throw new TypeError('"delimiter" is not a bufferable object'); + } + if (delimiter.length === 0) { + throw new TypeError('"delimiter" has a 0 or undefined length'); + } + this.includeDelimiter = includeDelimiter; + this.delimiter = Buffer.from(delimiter); + this.buffer = Buffer.alloc(0); + } + _transform(chunk, encoding, cb) { + let data = Buffer.concat([this.buffer, chunk]); + let position; + while ((position = data.indexOf(this.delimiter)) !== -1) { + this.push(data.slice(0, position + (this.includeDelimiter ? this.delimiter.length : 0))); + data = data.slice(position + this.delimiter.length); + } + this.buffer = data; + cb(); + } + _flush(cb) { + this.push(this.buffer); + this.buffer = Buffer.alloc(0); + cb(); + } +} +exports.DelimiterParser = DelimiterParser; diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/package.json b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/package.json new file mode 100644 index 0000000..c2e4271 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-delimiter/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-delimiter", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "version": "11.0.0", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.0.4" + }, + "gitHead": "6a8202cd947c87ac70c9f3c84d60fe4b5f5d70a9" +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/LICENSE b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/README.md b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/README.md new file mode 100644 index 0000000..4c8677d --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-readline + +See our api docs See our api docs https://serialport.io/docs/api-parser-readline diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/dist/index.d.ts b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/dist/index.d.ts new file mode 100644 index 0000000..a1f1b4a --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/dist/index.d.ts @@ -0,0 +1,19 @@ +/// +/// +import { DelimiterParser } from '@serialport/parser-delimiter'; +import { TransformOptions } from 'stream'; +export interface ReadlineOptions extends TransformOptions { + /** delimiter to use defaults to \n */ + delimiter?: string | Buffer | number[]; + /** include the delimiter at the end of the packet defaults to false */ + includeDelimiter?: boolean; + /** Defaults to utf8 */ + encoding?: BufferEncoding; +} +/** + * A transform stream that emits data after a newline delimiter is received. + * @summary To use the `Readline` parser, provide a delimiter (defaults to `\n`). Data is emitted as string controllable by the `encoding` option (defaults to `utf8`). + */ +export declare class ReadlineParser extends DelimiterParser { + constructor(options?: ReadlineOptions); +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/dist/index.js b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/dist/index.js new file mode 100644 index 0000000..e2791b6 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/dist/index.js @@ -0,0 +1,22 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.ReadlineParser = void 0; +const parser_delimiter_1 = require("@serialport/parser-delimiter"); +/** + * A transform stream that emits data after a newline delimiter is received. + * @summary To use the `Readline` parser, provide a delimiter (defaults to `\n`). Data is emitted as string controllable by the `encoding` option (defaults to `utf8`). + */ +class ReadlineParser extends parser_delimiter_1.DelimiterParser { + constructor(options) { + const opts = { + delimiter: Buffer.from('\n', 'utf8'), + encoding: 'utf8', + ...options, + }; + if (typeof opts.delimiter === 'string') { + opts.delimiter = Buffer.from(opts.delimiter, opts.encoding); + } + super(opts); + } +} +exports.ReadlineParser = ReadlineParser; diff --git a/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/package.json b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/package.json new file mode 100644 index 0000000..2b8c5a5 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/@serialport/parser-readline/package.json @@ -0,0 +1,28 @@ +{ + "name": "@serialport/parser-readline", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "version": "11.0.0", + "dependencies": { + "@serialport/parser-delimiter": "11.0.0" + }, + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.0.4" + }, + "gitHead": "6a8202cd947c87ac70c9f3c84d60fe4b5f5d70a9" +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/debug/LICENSE b/node_modules/@serialport/bindings-cpp/node_modules/debug/LICENSE new file mode 100644 index 0000000..1a9820e --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/debug/LICENSE @@ -0,0 +1,20 @@ +(The MIT License) + +Copyright (c) 2014-2017 TJ Holowaychuk +Copyright (c) 2018-2021 Josh Junon + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software +and associated documentation files (the 'Software'), to deal in the Software without restriction, +including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, +and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial +portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT +LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/node_modules/@serialport/bindings-cpp/node_modules/debug/README.md b/node_modules/@serialport/bindings-cpp/node_modules/debug/README.md new file mode 100644 index 0000000..e9c3e04 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/debug/README.md @@ -0,0 +1,481 @@ +# debug +[![Build Status](https://travis-ci.org/debug-js/debug.svg?branch=master)](https://travis-ci.org/debug-js/debug) [![Coverage Status](https://coveralls.io/repos/github/debug-js/debug/badge.svg?branch=master)](https://coveralls.io/github/debug-js/debug?branch=master) [![Slack](https://visionmedia-community-slackin.now.sh/badge.svg)](https://visionmedia-community-slackin.now.sh/) [![OpenCollective](https://opencollective.com/debug/backers/badge.svg)](#backers) +[![OpenCollective](https://opencollective.com/debug/sponsors/badge.svg)](#sponsors) + + + +A tiny JavaScript debugging utility modelled after Node.js core's debugging +technique. Works in Node.js and web browsers. + +## Installation + +```bash +$ npm install debug +``` + +## Usage + +`debug` exposes a function; simply pass this function the name of your module, and it will return a decorated version of `console.error` for you to pass debug statements to. This will allow you to toggle the debug output for different parts of your module as well as the module as a whole. + +Example [_app.js_](./examples/node/app.js): + +```js +var debug = require('debug')('http') + , http = require('http') + , name = 'My App'; + +// fake app + +debug('booting %o', name); + +http.createServer(function(req, res){ + debug(req.method + ' ' + req.url); + res.end('hello\n'); +}).listen(3000, function(){ + debug('listening'); +}); + +// fake worker of some kind + +require('./worker'); +``` + +Example [_worker.js_](./examples/node/worker.js): + +```js +var a = require('debug')('worker:a') + , b = require('debug')('worker:b'); + +function work() { + a('doing lots of uninteresting work'); + setTimeout(work, Math.random() * 1000); +} + +work(); + +function workb() { + b('doing some work'); + setTimeout(workb, Math.random() * 2000); +} + +workb(); +``` + +The `DEBUG` environment variable is then used to enable these based on space or +comma-delimited names. + +Here are some examples: + +screen shot 2017-08-08 at 12 53 04 pm +screen shot 2017-08-08 at 12 53 38 pm +screen shot 2017-08-08 at 12 53 25 pm + +#### Windows command prompt notes + +##### CMD + +On Windows the environment variable is set using the `set` command. + +```cmd +set DEBUG=*,-not_this +``` + +Example: + +```cmd +set DEBUG=* & node app.js +``` + +##### PowerShell (VS Code default) + +PowerShell uses different syntax to set environment variables. + +```cmd +$env:DEBUG = "*,-not_this" +``` + +Example: + +```cmd +$env:DEBUG='app';node app.js +``` + +Then, run the program to be debugged as usual. + +npm script example: +```js + "windowsDebug": "@powershell -Command $env:DEBUG='*';node app.js", +``` + +## Namespace Colors + +Every debug instance has a color generated for it based on its namespace name. +This helps when visually parsing the debug output to identify which debug instance +a debug line belongs to. + +#### Node.js + +In Node.js, colors are enabled when stderr is a TTY. You also _should_ install +the [`supports-color`](https://npmjs.org/supports-color) module alongside debug, +otherwise debug will only use a small handful of basic colors. + + + +#### Web Browser + +Colors are also enabled on "Web Inspectors" that understand the `%c` formatting +option. These are WebKit web inspectors, Firefox ([since version +31](https://hacks.mozilla.org/2014/05/editable-box-model-multiple-selection-sublime-text-keys-much-more-firefox-developer-tools-episode-31/)) +and the Firebug plugin for Firefox (any version). + + + + +## Millisecond diff + +When actively developing an application it can be useful to see when the time spent between one `debug()` call and the next. Suppose for example you invoke `debug()` before requesting a resource, and after as well, the "+NNNms" will show you how much time was spent between calls. + + + +When stdout is not a TTY, `Date#toISOString()` is used, making it more useful for logging the debug information as shown below: + + + + +## Conventions + +If you're using this in one or more of your libraries, you _should_ use the name of your library so that developers may toggle debugging as desired without guessing names. If you have more than one debuggers you _should_ prefix them with your library name and use ":" to separate features. For example "bodyParser" from Connect would then be "connect:bodyParser". If you append a "*" to the end of your name, it will always be enabled regardless of the setting of the DEBUG environment variable. You can then use it for normal output as well as debug output. + +## Wildcards + +The `*` character may be used as a wildcard. Suppose for example your library has +debuggers named "connect:bodyParser", "connect:compress", "connect:session", +instead of listing all three with +`DEBUG=connect:bodyParser,connect:compress,connect:session`, you may simply do +`DEBUG=connect:*`, or to run everything using this module simply use `DEBUG=*`. + +You can also exclude specific debuggers by prefixing them with a "-" character. +For example, `DEBUG=*,-connect:*` would include all debuggers except those +starting with "connect:". + +## Environment Variables + +When running through Node.js, you can set a few environment variables that will +change the behavior of the debug logging: + +| Name | Purpose | +|-----------|-------------------------------------------------| +| `DEBUG` | Enables/disables specific debugging namespaces. | +| `DEBUG_HIDE_DATE` | Hide date from debug output (non-TTY). | +| `DEBUG_COLORS`| Whether or not to use colors in the debug output. | +| `DEBUG_DEPTH` | Object inspection depth. | +| `DEBUG_SHOW_HIDDEN` | Shows hidden properties on inspected objects. | + + +__Note:__ The environment variables beginning with `DEBUG_` end up being +converted into an Options object that gets used with `%o`/`%O` formatters. +See the Node.js documentation for +[`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options) +for the complete list. + +## Formatters + +Debug uses [printf-style](https://wikipedia.org/wiki/Printf_format_string) formatting. +Below are the officially supported formatters: + +| Formatter | Representation | +|-----------|----------------| +| `%O` | Pretty-print an Object on multiple lines. | +| `%o` | Pretty-print an Object all on a single line. | +| `%s` | String. | +| `%d` | Number (both integer and float). | +| `%j` | JSON. Replaced with the string '[Circular]' if the argument contains circular references. | +| `%%` | Single percent sign ('%'). This does not consume an argument. | + + +### Custom formatters + +You can add custom formatters by extending the `debug.formatters` object. +For example, if you wanted to add support for rendering a Buffer as hex with +`%h`, you could do something like: + +```js +const createDebug = require('debug') +createDebug.formatters.h = (v) => { + return v.toString('hex') +} + +// …elsewhere +const debug = createDebug('foo') +debug('this is hex: %h', new Buffer('hello world')) +// foo this is hex: 68656c6c6f20776f726c6421 +0ms +``` + + +## Browser Support + +You can build a browser-ready script using [browserify](https://github.com/substack/node-browserify), +or just use the [browserify-as-a-service](https://wzrd.in/) [build](https://wzrd.in/standalone/debug@latest), +if you don't want to build it yourself. + +Debug's enable state is currently persisted by `localStorage`. +Consider the situation shown below where you have `worker:a` and `worker:b`, +and wish to debug both. You can enable this using `localStorage.debug`: + +```js +localStorage.debug = 'worker:*' +``` + +And then refresh the page. + +```js +a = debug('worker:a'); +b = debug('worker:b'); + +setInterval(function(){ + a('doing some work'); +}, 1000); + +setInterval(function(){ + b('doing some work'); +}, 1200); +``` + +In Chromium-based web browsers (e.g. Brave, Chrome, and Electron), the JavaScript console will—by default—only show messages logged by `debug` if the "Verbose" log level is _enabled_. + + + +## Output streams + + By default `debug` will log to stderr, however this can be configured per-namespace by overriding the `log` method: + +Example [_stdout.js_](./examples/node/stdout.js): + +```js +var debug = require('debug'); +var error = debug('app:error'); + +// by default stderr is used +error('goes to stderr!'); + +var log = debug('app:log'); +// set this namespace to log via console.log +log.log = console.log.bind(console); // don't forget to bind to console! +log('goes to stdout'); +error('still goes to stderr!'); + +// set all output to go via console.info +// overrides all per-namespace log settings +debug.log = console.info.bind(console); +error('now goes to stdout via console.info'); +log('still goes to stdout, but via console.info now'); +``` + +## Extend +You can simply extend debugger +```js +const log = require('debug')('auth'); + +//creates new debug instance with extended namespace +const logSign = log.extend('sign'); +const logLogin = log.extend('login'); + +log('hello'); // auth hello +logSign('hello'); //auth:sign hello +logLogin('hello'); //auth:login hello +``` + +## Set dynamically + +You can also enable debug dynamically by calling the `enable()` method : + +```js +let debug = require('debug'); + +console.log(1, debug.enabled('test')); + +debug.enable('test'); +console.log(2, debug.enabled('test')); + +debug.disable(); +console.log(3, debug.enabled('test')); + +``` + +print : +``` +1 false +2 true +3 false +``` + +Usage : +`enable(namespaces)` +`namespaces` can include modes separated by a colon and wildcards. + +Note that calling `enable()` completely overrides previously set DEBUG variable : + +``` +$ DEBUG=foo node -e 'var dbg = require("debug"); dbg.enable("bar"); console.log(dbg.enabled("foo"))' +=> false +``` + +`disable()` + +Will disable all namespaces. The functions returns the namespaces currently +enabled (and skipped). This can be useful if you want to disable debugging +temporarily without knowing what was enabled to begin with. + +For example: + +```js +let debug = require('debug'); +debug.enable('foo:*,-foo:bar'); +let namespaces = debug.disable(); +debug.enable(namespaces); +``` + +Note: There is no guarantee that the string will be identical to the initial +enable string, but semantically they will be identical. + +## Checking whether a debug target is enabled + +After you've created a debug instance, you can determine whether or not it is +enabled by checking the `enabled` property: + +```javascript +const debug = require('debug')('http'); + +if (debug.enabled) { + // do stuff... +} +``` + +You can also manually toggle this property to force the debug instance to be +enabled or disabled. + +## Usage in child processes + +Due to the way `debug` detects if the output is a TTY or not, colors are not shown in child processes when `stderr` is piped. A solution is to pass the `DEBUG_COLORS=1` environment variable to the child process. +For example: + +```javascript +worker = fork(WORKER_WRAP_PATH, [workerPath], { + stdio: [ + /* stdin: */ 0, + /* stdout: */ 'pipe', + /* stderr: */ 'pipe', + 'ipc', + ], + env: Object.assign({}, process.env, { + DEBUG_COLORS: 1 // without this settings, colors won't be shown + }), +}); + +worker.stderr.pipe(process.stderr, { end: false }); +``` + + +## Authors + + - TJ Holowaychuk + - Nathan Rajlich + - Andrew Rhyne + - Josh Junon + +## Backers + +Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/debug#backer)] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Sponsors + +Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/debug#sponsor)] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## License + +(The MIT License) + +Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca> +Copyright (c) 2018-2021 Josh Junon + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/@serialport/bindings-cpp/node_modules/debug/package.json b/node_modules/@serialport/bindings-cpp/node_modules/debug/package.json new file mode 100644 index 0000000..3bcdc24 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/debug/package.json @@ -0,0 +1,59 @@ +{ + "name": "debug", + "version": "4.3.4", + "repository": { + "type": "git", + "url": "git://github.com/debug-js/debug.git" + }, + "description": "Lightweight debugging utility for Node.js and the browser", + "keywords": [ + "debug", + "log", + "debugger" + ], + "files": [ + "src", + "LICENSE", + "README.md" + ], + "author": "Josh Junon ", + "contributors": [ + "TJ Holowaychuk ", + "Nathan Rajlich (http://n8.io)", + "Andrew Rhyne " + ], + "license": "MIT", + "scripts": { + "lint": "xo", + "test": "npm run test:node && npm run test:browser && npm run lint", + "test:node": "istanbul cover _mocha -- test.js", + "test:browser": "karma start --single-run", + "test:coverage": "cat ./coverage/lcov.info | coveralls" + }, + "dependencies": { + "ms": "2.1.2" + }, + "devDependencies": { + "brfs": "^2.0.1", + "browserify": "^16.2.3", + "coveralls": "^3.0.2", + "istanbul": "^0.4.5", + "karma": "^3.1.4", + "karma-browserify": "^6.0.0", + "karma-chrome-launcher": "^2.2.0", + "karma-mocha": "^1.3.0", + "mocha": "^5.2.0", + "mocha-lcov-reporter": "^1.2.0", + "xo": "^0.23.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + }, + "main": "./src/index.js", + "browser": "./src/browser.js", + "engines": { + "node": ">=6.0" + } +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/debug/src/browser.js b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/browser.js new file mode 100644 index 0000000..cd0fc35 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/browser.js @@ -0,0 +1,269 @@ +/* eslint-env browser */ + +/** + * This is the web browser implementation of `debug()`. + */ + +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; +exports.storage = localstorage(); +exports.destroy = (() => { + let warned = false; + + return () => { + if (!warned) { + warned = true; + console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.'); + } + }; +})(); + +/** + * Colors. + */ + +exports.colors = [ + '#0000CC', + '#0000FF', + '#0033CC', + '#0033FF', + '#0066CC', + '#0066FF', + '#0099CC', + '#0099FF', + '#00CC00', + '#00CC33', + '#00CC66', + '#00CC99', + '#00CCCC', + '#00CCFF', + '#3300CC', + '#3300FF', + '#3333CC', + '#3333FF', + '#3366CC', + '#3366FF', + '#3399CC', + '#3399FF', + '#33CC00', + '#33CC33', + '#33CC66', + '#33CC99', + '#33CCCC', + '#33CCFF', + '#6600CC', + '#6600FF', + '#6633CC', + '#6633FF', + '#66CC00', + '#66CC33', + '#9900CC', + '#9900FF', + '#9933CC', + '#9933FF', + '#99CC00', + '#99CC33', + '#CC0000', + '#CC0033', + '#CC0066', + '#CC0099', + '#CC00CC', + '#CC00FF', + '#CC3300', + '#CC3333', + '#CC3366', + '#CC3399', + '#CC33CC', + '#CC33FF', + '#CC6600', + '#CC6633', + '#CC9900', + '#CC9933', + '#CCCC00', + '#CCCC33', + '#FF0000', + '#FF0033', + '#FF0066', + '#FF0099', + '#FF00CC', + '#FF00FF', + '#FF3300', + '#FF3333', + '#FF3366', + '#FF3399', + '#FF33CC', + '#FF33FF', + '#FF6600', + '#FF6633', + '#FF9900', + '#FF9933', + '#FFCC00', + '#FFCC33' +]; + +/** + * Currently only WebKit-based Web Inspectors, Firefox >= v31, + * and the Firebug extension (any Firefox version) are known + * to support "%c" CSS customizations. + * + * TODO: add a `localStorage` variable to explicitly enable/disable colors + */ + +// eslint-disable-next-line complexity +function useColors() { + // NB: In an Electron preload script, document will be defined but not fully + // initialized. Since we know we're in Chrome, we'll just detect this case + // explicitly + if (typeof window !== 'undefined' && window.process && (window.process.type === 'renderer' || window.process.__nwjs)) { + return true; + } + + // Internet Explorer and Edge do not support colors. + if (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/(edge|trident)\/(\d+)/)) { + return false; + } + + // Is webkit? http://stackoverflow.com/a/16459606/376773 + // document is undefined in react-native: https://github.com/facebook/react-native/pull/1632 + return (typeof document !== 'undefined' && document.documentElement && document.documentElement.style && document.documentElement.style.WebkitAppearance) || + // Is firebug? http://stackoverflow.com/a/398120/376773 + (typeof window !== 'undefined' && window.console && (window.console.firebug || (window.console.exception && window.console.table))) || + // Is firefox >= v31? + // https://developer.mozilla.org/en-US/docs/Tools/Web_Console#Styling_messages + (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/firefox\/(\d+)/) && parseInt(RegExp.$1, 10) >= 31) || + // Double check webkit in userAgent just in case we are in a worker + (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/applewebkit\/(\d+)/)); +} + +/** + * Colorize log arguments if enabled. + * + * @api public + */ + +function formatArgs(args) { + args[0] = (this.useColors ? '%c' : '') + + this.namespace + + (this.useColors ? ' %c' : ' ') + + args[0] + + (this.useColors ? '%c ' : ' ') + + '+' + module.exports.humanize(this.diff); + + if (!this.useColors) { + return; + } + + const c = 'color: ' + this.color; + args.splice(1, 0, c, 'color: inherit'); + + // The final "%c" is somewhat tricky, because there could be other + // arguments passed either before or after the %c, so we need to + // figure out the correct index to insert the CSS into + let index = 0; + let lastC = 0; + args[0].replace(/%[a-zA-Z%]/g, match => { + if (match === '%%') { + return; + } + index++; + if (match === '%c') { + // We only are interested in the *last* %c + // (the user may have provided their own) + lastC = index; + } + }); + + args.splice(lastC, 0, c); +} + +/** + * Invokes `console.debug()` when available. + * No-op when `console.debug` is not a "function". + * If `console.debug` is not available, falls back + * to `console.log`. + * + * @api public + */ +exports.log = console.debug || console.log || (() => {}); + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ +function save(namespaces) { + try { + if (namespaces) { + exports.storage.setItem('debug', namespaces); + } else { + exports.storage.removeItem('debug'); + } + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ +function load() { + let r; + try { + r = exports.storage.getItem('debug'); + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } + + // If debug isn't set in LS, and we're in Electron, try to load $DEBUG + if (!r && typeof process !== 'undefined' && 'env' in process) { + r = process.env.DEBUG; + } + + return r; +} + +/** + * Localstorage attempts to return the localstorage. + * + * This is necessary because safari throws + * when a user disables cookies/localstorage + * and you attempt to access it. + * + * @return {LocalStorage} + * @api private + */ + +function localstorage() { + try { + // TVMLKit (Apple TV JS Runtime) does not have a window object, just localStorage in the global context + // The Browser also has localStorage in the global context. + return localStorage; + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } +} + +module.exports = require('./common')(exports); + +const {formatters} = module.exports; + +/** + * Map %j to `JSON.stringify()`, since no Web Inspectors do that by default. + */ + +formatters.j = function (v) { + try { + return JSON.stringify(v); + } catch (error) { + return '[UnexpectedJSONParseError]: ' + error.message; + } +}; diff --git a/node_modules/@serialport/bindings-cpp/node_modules/debug/src/common.js b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/common.js new file mode 100644 index 0000000..e3291b2 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/common.js @@ -0,0 +1,274 @@ + +/** + * This is the common logic for both the Node.js and web browser + * implementations of `debug()`. + */ + +function setup(env) { + createDebug.debug = createDebug; + createDebug.default = createDebug; + createDebug.coerce = coerce; + createDebug.disable = disable; + createDebug.enable = enable; + createDebug.enabled = enabled; + createDebug.humanize = require('ms'); + createDebug.destroy = destroy; + + Object.keys(env).forEach(key => { + createDebug[key] = env[key]; + }); + + /** + * The currently active debug mode names, and names to skip. + */ + + createDebug.names = []; + createDebug.skips = []; + + /** + * Map of special "%n" handling functions, for the debug "format" argument. + * + * Valid key names are a single, lower or upper-case letter, i.e. "n" and "N". + */ + createDebug.formatters = {}; + + /** + * Selects a color for a debug namespace + * @param {String} namespace The namespace string for the debug instance to be colored + * @return {Number|String} An ANSI color code for the given namespace + * @api private + */ + function selectColor(namespace) { + let hash = 0; + + for (let i = 0; i < namespace.length; i++) { + hash = ((hash << 5) - hash) + namespace.charCodeAt(i); + hash |= 0; // Convert to 32bit integer + } + + return createDebug.colors[Math.abs(hash) % createDebug.colors.length]; + } + createDebug.selectColor = selectColor; + + /** + * Create a debugger with the given `namespace`. + * + * @param {String} namespace + * @return {Function} + * @api public + */ + function createDebug(namespace) { + let prevTime; + let enableOverride = null; + let namespacesCache; + let enabledCache; + + function debug(...args) { + // Disabled? + if (!debug.enabled) { + return; + } + + const self = debug; + + // Set `diff` timestamp + const curr = Number(new Date()); + const ms = curr - (prevTime || curr); + self.diff = ms; + self.prev = prevTime; + self.curr = curr; + prevTime = curr; + + args[0] = createDebug.coerce(args[0]); + + if (typeof args[0] !== 'string') { + // Anything else let's inspect with %O + args.unshift('%O'); + } + + // Apply any `formatters` transformations + let index = 0; + args[0] = args[0].replace(/%([a-zA-Z%])/g, (match, format) => { + // If we encounter an escaped % then don't increase the array index + if (match === '%%') { + return '%'; + } + index++; + const formatter = createDebug.formatters[format]; + if (typeof formatter === 'function') { + const val = args[index]; + match = formatter.call(self, val); + + // Now we need to remove `args[index]` since it's inlined in the `format` + args.splice(index, 1); + index--; + } + return match; + }); + + // Apply env-specific formatting (colors, etc.) + createDebug.formatArgs.call(self, args); + + const logFn = self.log || createDebug.log; + logFn.apply(self, args); + } + + debug.namespace = namespace; + debug.useColors = createDebug.useColors(); + debug.color = createDebug.selectColor(namespace); + debug.extend = extend; + debug.destroy = createDebug.destroy; // XXX Temporary. Will be removed in the next major release. + + Object.defineProperty(debug, 'enabled', { + enumerable: true, + configurable: false, + get: () => { + if (enableOverride !== null) { + return enableOverride; + } + if (namespacesCache !== createDebug.namespaces) { + namespacesCache = createDebug.namespaces; + enabledCache = createDebug.enabled(namespace); + } + + return enabledCache; + }, + set: v => { + enableOverride = v; + } + }); + + // Env-specific initialization logic for debug instances + if (typeof createDebug.init === 'function') { + createDebug.init(debug); + } + + return debug; + } + + function extend(namespace, delimiter) { + const newDebug = createDebug(this.namespace + (typeof delimiter === 'undefined' ? ':' : delimiter) + namespace); + newDebug.log = this.log; + return newDebug; + } + + /** + * Enables a debug mode by namespaces. This can include modes + * separated by a colon and wildcards. + * + * @param {String} namespaces + * @api public + */ + function enable(namespaces) { + createDebug.save(namespaces); + createDebug.namespaces = namespaces; + + createDebug.names = []; + createDebug.skips = []; + + let i; + const split = (typeof namespaces === 'string' ? namespaces : '').split(/[\s,]+/); + const len = split.length; + + for (i = 0; i < len; i++) { + if (!split[i]) { + // ignore empty strings + continue; + } + + namespaces = split[i].replace(/\*/g, '.*?'); + + if (namespaces[0] === '-') { + createDebug.skips.push(new RegExp('^' + namespaces.slice(1) + '$')); + } else { + createDebug.names.push(new RegExp('^' + namespaces + '$')); + } + } + } + + /** + * Disable debug output. + * + * @return {String} namespaces + * @api public + */ + function disable() { + const namespaces = [ + ...createDebug.names.map(toNamespace), + ...createDebug.skips.map(toNamespace).map(namespace => '-' + namespace) + ].join(','); + createDebug.enable(''); + return namespaces; + } + + /** + * Returns true if the given mode name is enabled, false otherwise. + * + * @param {String} name + * @return {Boolean} + * @api public + */ + function enabled(name) { + if (name[name.length - 1] === '*') { + return true; + } + + let i; + let len; + + for (i = 0, len = createDebug.skips.length; i < len; i++) { + if (createDebug.skips[i].test(name)) { + return false; + } + } + + for (i = 0, len = createDebug.names.length; i < len; i++) { + if (createDebug.names[i].test(name)) { + return true; + } + } + + return false; + } + + /** + * Convert regexp to namespace + * + * @param {RegExp} regxep + * @return {String} namespace + * @api private + */ + function toNamespace(regexp) { + return regexp.toString() + .substring(2, regexp.toString().length - 2) + .replace(/\.\*\?$/, '*'); + } + + /** + * Coerce `val`. + * + * @param {Mixed} val + * @return {Mixed} + * @api private + */ + function coerce(val) { + if (val instanceof Error) { + return val.stack || val.message; + } + return val; + } + + /** + * XXX DO NOT USE. This is a temporary stub function. + * XXX It WILL be removed in the next major release. + */ + function destroy() { + console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.'); + } + + createDebug.enable(createDebug.load()); + + return createDebug; +} + +module.exports = setup; diff --git a/node_modules/@serialport/bindings-cpp/node_modules/debug/src/index.js b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/index.js new file mode 100644 index 0000000..bf4c57f --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/index.js @@ -0,0 +1,10 @@ +/** + * Detect Electron renderer / nwjs process, which is node, but we should + * treat as a browser. + */ + +if (typeof process === 'undefined' || process.type === 'renderer' || process.browser === true || process.__nwjs) { + module.exports = require('./browser.js'); +} else { + module.exports = require('./node.js'); +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/debug/src/node.js b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/node.js new file mode 100644 index 0000000..79bc085 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/debug/src/node.js @@ -0,0 +1,263 @@ +/** + * Module dependencies. + */ + +const tty = require('tty'); +const util = require('util'); + +/** + * This is the Node.js implementation of `debug()`. + */ + +exports.init = init; +exports.log = log; +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; +exports.destroy = util.deprecate( + () => {}, + 'Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.' +); + +/** + * Colors. + */ + +exports.colors = [6, 2, 3, 4, 5, 1]; + +try { + // Optional dependency (as in, doesn't need to be installed, NOT like optionalDependencies in package.json) + // eslint-disable-next-line import/no-extraneous-dependencies + const supportsColor = require('supports-color'); + + if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) { + exports.colors = [ + 20, + 21, + 26, + 27, + 32, + 33, + 38, + 39, + 40, + 41, + 42, + 43, + 44, + 45, + 56, + 57, + 62, + 63, + 68, + 69, + 74, + 75, + 76, + 77, + 78, + 79, + 80, + 81, + 92, + 93, + 98, + 99, + 112, + 113, + 128, + 129, + 134, + 135, + 148, + 149, + 160, + 161, + 162, + 163, + 164, + 165, + 166, + 167, + 168, + 169, + 170, + 171, + 172, + 173, + 178, + 179, + 184, + 185, + 196, + 197, + 198, + 199, + 200, + 201, + 202, + 203, + 204, + 205, + 206, + 207, + 208, + 209, + 214, + 215, + 220, + 221 + ]; + } +} catch (error) { + // Swallow - we only care if `supports-color` is available; it doesn't have to be. +} + +/** + * Build up the default `inspectOpts` object from the environment variables. + * + * $ DEBUG_COLORS=no DEBUG_DEPTH=10 DEBUG_SHOW_HIDDEN=enabled node script.js + */ + +exports.inspectOpts = Object.keys(process.env).filter(key => { + return /^debug_/i.test(key); +}).reduce((obj, key) => { + // Camel-case + const prop = key + .substring(6) + .toLowerCase() + .replace(/_([a-z])/g, (_, k) => { + return k.toUpperCase(); + }); + + // Coerce string value into JS value + let val = process.env[key]; + if (/^(yes|on|true|enabled)$/i.test(val)) { + val = true; + } else if (/^(no|off|false|disabled)$/i.test(val)) { + val = false; + } else if (val === 'null') { + val = null; + } else { + val = Number(val); + } + + obj[prop] = val; + return obj; +}, {}); + +/** + * Is stdout a TTY? Colored output is enabled when `true`. + */ + +function useColors() { + return 'colors' in exports.inspectOpts ? + Boolean(exports.inspectOpts.colors) : + tty.isatty(process.stderr.fd); +} + +/** + * Adds ANSI color escape codes if enabled. + * + * @api public + */ + +function formatArgs(args) { + const {namespace: name, useColors} = this; + + if (useColors) { + const c = this.color; + const colorCode = '\u001B[3' + (c < 8 ? c : '8;5;' + c); + const prefix = ` ${colorCode};1m${name} \u001B[0m`; + + args[0] = prefix + args[0].split('\n').join('\n' + prefix); + args.push(colorCode + 'm+' + module.exports.humanize(this.diff) + '\u001B[0m'); + } else { + args[0] = getDate() + name + ' ' + args[0]; + } +} + +function getDate() { + if (exports.inspectOpts.hideDate) { + return ''; + } + return new Date().toISOString() + ' '; +} + +/** + * Invokes `util.format()` with the specified arguments and writes to stderr. + */ + +function log(...args) { + return process.stderr.write(util.format(...args) + '\n'); +} + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ +function save(namespaces) { + if (namespaces) { + process.env.DEBUG = namespaces; + } else { + // If you set a process.env field to null or undefined, it gets cast to the + // string 'null' or 'undefined'. Just delete instead. + delete process.env.DEBUG; + } +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ + +function load() { + return process.env.DEBUG; +} + +/** + * Init logic for `debug` instances. + * + * Create a new `inspectOpts` object in case `useColors` is set + * differently for a particular `debug` instance. + */ + +function init(debug) { + debug.inspectOpts = {}; + + const keys = Object.keys(exports.inspectOpts); + for (let i = 0; i < keys.length; i++) { + debug.inspectOpts[keys[i]] = exports.inspectOpts[keys[i]]; + } +} + +module.exports = require('./common')(exports); + +const {formatters} = module.exports; + +/** + * Map %o to `util.inspect()`, all on a single line. + */ + +formatters.o = function (v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts) + .split('\n') + .map(str => str.trim()) + .join(' '); +}; + +/** + * Map %O to `util.inspect()`, allowing multiple lines if needed. + */ + +formatters.O = function (v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts); +}; diff --git a/node_modules/@serialport/bindings-cpp/node_modules/ms/index.js b/node_modules/@serialport/bindings-cpp/node_modules/ms/index.js new file mode 100644 index 0000000..c4498bc --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/ms/index.js @@ -0,0 +1,162 @@ +/** + * Helpers. + */ + +var s = 1000; +var m = s * 60; +var h = m * 60; +var d = h * 24; +var w = d * 7; +var y = d * 365.25; + +/** + * Parse or format the given `val`. + * + * Options: + * + * - `long` verbose formatting [false] + * + * @param {String|Number} val + * @param {Object} [options] + * @throws {Error} throw an error if val is not a non-empty string or a number + * @return {String|Number} + * @api public + */ + +module.exports = function(val, options) { + options = options || {}; + var type = typeof val; + if (type === 'string' && val.length > 0) { + return parse(val); + } else if (type === 'number' && isFinite(val)) { + return options.long ? fmtLong(val) : fmtShort(val); + } + throw new Error( + 'val is not a non-empty string or a valid number. val=' + + JSON.stringify(val) + ); +}; + +/** + * Parse the given `str` and return milliseconds. + * + * @param {String} str + * @return {Number} + * @api private + */ + +function parse(str) { + str = String(str); + if (str.length > 100) { + return; + } + var match = /^(-?(?:\d+)?\.?\d+) *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|years?|yrs?|y)?$/i.exec( + str + ); + if (!match) { + return; + } + var n = parseFloat(match[1]); + var type = (match[2] || 'ms').toLowerCase(); + switch (type) { + case 'years': + case 'year': + case 'yrs': + case 'yr': + case 'y': + return n * y; + case 'weeks': + case 'week': + case 'w': + return n * w; + case 'days': + case 'day': + case 'd': + return n * d; + case 'hours': + case 'hour': + case 'hrs': + case 'hr': + case 'h': + return n * h; + case 'minutes': + case 'minute': + case 'mins': + case 'min': + case 'm': + return n * m; + case 'seconds': + case 'second': + case 'secs': + case 'sec': + case 's': + return n * s; + case 'milliseconds': + case 'millisecond': + case 'msecs': + case 'msec': + case 'ms': + return n; + default: + return undefined; + } +} + +/** + * Short format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtShort(ms) { + var msAbs = Math.abs(ms); + if (msAbs >= d) { + return Math.round(ms / d) + 'd'; + } + if (msAbs >= h) { + return Math.round(ms / h) + 'h'; + } + if (msAbs >= m) { + return Math.round(ms / m) + 'm'; + } + if (msAbs >= s) { + return Math.round(ms / s) + 's'; + } + return ms + 'ms'; +} + +/** + * Long format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtLong(ms) { + var msAbs = Math.abs(ms); + if (msAbs >= d) { + return plural(ms, msAbs, d, 'day'); + } + if (msAbs >= h) { + return plural(ms, msAbs, h, 'hour'); + } + if (msAbs >= m) { + return plural(ms, msAbs, m, 'minute'); + } + if (msAbs >= s) { + return plural(ms, msAbs, s, 'second'); + } + return ms + ' ms'; +} + +/** + * Pluralization helper. + */ + +function plural(ms, msAbs, n, name) { + var isPlural = msAbs >= n * 1.5; + return Math.round(ms / n) + ' ' + name + (isPlural ? 's' : ''); +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/ms/license.md b/node_modules/@serialport/bindings-cpp/node_modules/ms/license.md new file mode 100644 index 0000000..69b6125 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/ms/license.md @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2016 Zeit, Inc. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/node_modules/@serialport/bindings-cpp/node_modules/ms/package.json b/node_modules/@serialport/bindings-cpp/node_modules/ms/package.json new file mode 100644 index 0000000..eea666e --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/ms/package.json @@ -0,0 +1,37 @@ +{ + "name": "ms", + "version": "2.1.2", + "description": "Tiny millisecond conversion utility", + "repository": "zeit/ms", + "main": "./index", + "files": [ + "index.js" + ], + "scripts": { + "precommit": "lint-staged", + "lint": "eslint lib/* bin/*", + "test": "mocha tests.js" + }, + "eslintConfig": { + "extends": "eslint:recommended", + "env": { + "node": true, + "es6": true + } + }, + "lint-staged": { + "*.js": [ + "npm run lint", + "prettier --single-quote --write", + "git add" + ] + }, + "license": "MIT", + "devDependencies": { + "eslint": "4.12.1", + "expect.js": "0.3.1", + "husky": "0.14.3", + "lint-staged": "5.0.0", + "mocha": "4.0.1" + } +} diff --git a/node_modules/@serialport/bindings-cpp/node_modules/ms/readme.md b/node_modules/@serialport/bindings-cpp/node_modules/ms/readme.md new file mode 100644 index 0000000..9a1996b --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/node_modules/ms/readme.md @@ -0,0 +1,60 @@ +# ms + +[![Build Status](https://travis-ci.org/zeit/ms.svg?branch=master)](https://travis-ci.org/zeit/ms) +[![Join the community on Spectrum](https://withspectrum.github.io/badge/badge.svg)](https://spectrum.chat/zeit) + +Use this package to easily convert various time formats to milliseconds. + +## Examples + +```js +ms('2 days') // 172800000 +ms('1d') // 86400000 +ms('10h') // 36000000 +ms('2.5 hrs') // 9000000 +ms('2h') // 7200000 +ms('1m') // 60000 +ms('5s') // 5000 +ms('1y') // 31557600000 +ms('100') // 100 +ms('-3 days') // -259200000 +ms('-1h') // -3600000 +ms('-200') // -200 +``` + +### Convert from Milliseconds + +```js +ms(60000) // "1m" +ms(2 * 60000) // "2m" +ms(-3 * 60000) // "-3m" +ms(ms('10 hours')) // "10h" +``` + +### Time Format Written-Out + +```js +ms(60000, { long: true }) // "1 minute" +ms(2 * 60000, { long: true }) // "2 minutes" +ms(-3 * 60000, { long: true }) // "-3 minutes" +ms(ms('10 hours'), { long: true }) // "10 hours" +``` + +## Features + +- Works both in [Node.js](https://nodejs.org) and in the browser +- If a number is supplied to `ms`, a string with a unit is returned +- If a string that contains the number is supplied, it returns it as a number (e.g.: it returns `100` for `'100'`) +- If you pass a string with a number and a valid unit, the number of equivalent milliseconds is returned + +## Related Packages + +- [ms.macro](https://github.com/knpwrs/ms.macro) - Run `ms` as a macro at build-time. + +## Caught a Bug? + +1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device +2. Link the package to the global module directory: `npm link` +3. Within the module you want to test your local development instance of ms, just link it to the dependencies: `npm link ms`. Instead of the default one from npm, Node.js will now use your clone of ms! + +As always, you can run the tests using: `npm test` diff --git a/node_modules/@serialport/bindings-cpp/package.json b/node_modules/@serialport/bindings-cpp/package.json new file mode 100644 index 0000000..fbf67f4 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/package.json @@ -0,0 +1,113 @@ +{ + "name": "@serialport/bindings-cpp", + "description": "SerialPort Hardware bindings for node serialport written in c++", + "version": "12.0.1", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "keywords": [ + "serialport-binding", + "COM", + "com port", + "hardware", + "iot", + "modem", + "serial port", + "serial", + "serialport", + "tty", + "UART" + ], + "dependencies": { + "@serialport/bindings-interface": "1.2.2", + "@serialport/parser-readline": "11.0.0", + "debug": "4.3.4", + "node-addon-api": "7.0.0", + "node-gyp-build": "4.6.0" + }, + "devDependencies": { + "@semantic-release/exec": "6.0.3", + "@serialport/binding-mock": "10.2.2", + "@types/chai": "4.3.5", + "@types/chai-subset": "1.3.3", + "@types/debug": "4.1.8", + "@types/mocha": "10.0.1", + "@types/node": "18.16.20", + "@typescript-eslint/eslint-plugin": "6.1.0", + "@typescript-eslint/parser": "6.1.0", + "cc": "3.0.1", + "chai": "4.3.7", + "chai-subset": "1.6.0", + "esbuild": "0.18.15", + "esbuild-register": "3.4.2", + "eslint": "8.45.0", + "mocha": "10.2.0", + "node-abi": "3.45.0", + "node-gyp": "9.4.0", + "nyc": "15.1.0", + "prebuildify": "5.0.1", + "prebuildify-cross": "5.0.0", + "semantic-release": "21.0.7", + "shx": "0.3.4", + "sinon": "15.2.0", + "typescript": "5.1.6" + }, + "engines": { + "node": ">=16.0.0" + }, + "scripts": { + "build": "rm -rf dist && tsc -p tsconfig-build.json", + "install": "node-gyp-build", + "prebuildify": "prebuildify --napi --target 14.0.0 --force --strip --verbose", + "prebuildify-cross": "prebuildify-cross --napi --target 14.0.0 --force --strip --verbose", + "rebuild": "node-gyp rebuild", + "format": "eslint lib test bin --fix", + "lint": "eslint lib test bin && cc --verbose", + "test": "nyc --reporter lcov --reporter text mocha", + "test:arduino": "TEST_PORT=$(./bin/find-arduino.ts) npm test", + "test:watch": "mocha -w", + "semantic-release": "semantic-release", + "typecheck": "tsc" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "gypfile": true, + "cc": { + "filter": [ + "legal/copyright", + "build/include" + ], + "files": [ + "src/*.cpp", + "src/*.h" + ], + "linelength": "120" + }, + "binary": { + "napi_versions": [ + 6 + ] + }, + "repository": { + "type": "git", + "url": "https://github.com/serialport/bindings-cpp.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "changelog": { + "labels": { + "breaking": ":boom: BREAKING CHANGES :boom:", + "feature-request": "Features", + "bug": "Bug Fixes", + "docs": "Documentation", + "internal": "Chores" + } + }, + "mocha": { + "bail": true, + "require": [ + "esbuild-register" + ], + "spec": "lib/**/*.test.*" + } +} diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/android-arm/node.napi.armv7.node b/node_modules/@serialport/bindings-cpp/prebuilds/android-arm/node.napi.armv7.node new file mode 100644 index 0000000..9cbff91 Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/android-arm/node.napi.armv7.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/android-arm64/node.napi.armv8.node b/node_modules/@serialport/bindings-cpp/prebuilds/android-arm64/node.napi.armv8.node new file mode 100644 index 0000000..a2ad13a Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/android-arm64/node.napi.armv8.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/darwin-x64+arm64/node.napi.node b/node_modules/@serialport/bindings-cpp/prebuilds/darwin-x64+arm64/node.napi.node new file mode 100644 index 0000000..214f43d Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/darwin-x64+arm64/node.napi.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm/node.napi.armv6.node b/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm/node.napi.armv6.node new file mode 100644 index 0000000..fb02d81 Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm/node.napi.armv6.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm/node.napi.armv7.node b/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm/node.napi.armv7.node new file mode 100644 index 0000000..736a058 Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm/node.napi.armv7.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm64/node.napi.armv8.node b/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm64/node.napi.armv8.node new file mode 100644 index 0000000..15d2a02 Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/linux-arm64/node.napi.armv8.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/linux-x64/node.napi.glibc.node b/node_modules/@serialport/bindings-cpp/prebuilds/linux-x64/node.napi.glibc.node new file mode 100644 index 0000000..e45ac52 Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/linux-x64/node.napi.glibc.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/linux-x64/node.napi.musl.node b/node_modules/@serialport/bindings-cpp/prebuilds/linux-x64/node.napi.musl.node new file mode 100644 index 0000000..e4f52ad Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/linux-x64/node.napi.musl.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/win32-ia32/node.napi.node b/node_modules/@serialport/bindings-cpp/prebuilds/win32-ia32/node.napi.node new file mode 100644 index 0000000..571d407 Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/win32-ia32/node.napi.node differ diff --git a/node_modules/@serialport/bindings-cpp/prebuilds/win32-x64/node.napi.node b/node_modules/@serialport/bindings-cpp/prebuilds/win32-x64/node.napi.node new file mode 100644 index 0000000..04e348d Binary files /dev/null and b/node_modules/@serialport/bindings-cpp/prebuilds/win32-x64/node.napi.node differ diff --git a/node_modules/@serialport/bindings-cpp/src/darwin_list.cpp b/node_modules/@serialport/bindings-cpp/src/darwin_list.cpp new file mode 100644 index 0000000..3dd8542 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/darwin_list.cpp @@ -0,0 +1,317 @@ +#include "./darwin_list.h" + +#include +#include +#include +#include + +#if defined(MAC_OS_X_VERSION_10_4) && (MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_4) +#include +#include +#endif + +#include +#include + +uv_mutex_t list_mutex; +Boolean lockInitialised = FALSE; + +Napi::Value List(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // callback + if (!info[0].IsFunction()) { + Napi::TypeError::New(env, "First argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Function callback = info[0].As(); + ListBaton* baton = new ListBaton(callback); + snprintf(baton->errorString, sizeof(baton->errorString), ""); + + baton->Queue(); + return env.Undefined(); +} + +void setIfNotEmpty(Napi::Object item, std::string key, const char *value) { + Napi::Env env = item.Env(); + Napi::String v8key = Napi::String::New(env, key); + if (strlen(value) > 0) { + (item).Set(v8key, Napi::String::New(env, value)); + } else { + (item).Set(v8key, env.Undefined()); + } +} + + +// Function prototypes +static kern_return_t FindModems(io_iterator_t *matchingServices); +static io_service_t GetUsbDevice(io_service_t service); +static stDeviceListItem* GetSerialDevices(); + + +static kern_return_t FindModems(io_iterator_t *matchingServices) { + kern_return_t kernResult; + CFMutableDictionaryRef classesToMatch; + classesToMatch = IOServiceMatching(kIOSerialBSDServiceValue); + if (classesToMatch != NULL) { + CFDictionarySetValue(classesToMatch, + CFSTR(kIOSerialBSDTypeKey), + CFSTR(kIOSerialBSDAllTypes)); + } + + kernResult = IOServiceGetMatchingServices(kIOMasterPortDefault, classesToMatch, matchingServices); + + return kernResult; +} + +static io_service_t GetUsbDevice(io_service_t service) { + IOReturn status; + io_iterator_t iterator = 0; + io_service_t device = 0; + + if (!service) { + return device; + } + + status = IORegistryEntryCreateIterator(service, + kIOServicePlane, + (kIORegistryIterateParents | kIORegistryIterateRecursively), + &iterator); + + if (status == kIOReturnSuccess) { + io_service_t currentService; + while ((currentService = IOIteratorNext(iterator)) && device == 0) { + io_name_t serviceName; + status = IORegistryEntryGetNameInPlane(currentService, kIOServicePlane, serviceName); + if (status == kIOReturnSuccess && IOObjectConformsTo(currentService, kIOUSBDeviceClassName)) { + device = currentService; + } else { + // Release the service object which is no longer needed + (void) IOObjectRelease(currentService); + } + } + + // Release the iterator + (void) IOObjectRelease(iterator); + } + + return device; +} + +static void ExtractUsbInformation(stSerialDevice *serialDevice, IOUSBDeviceInterface **deviceInterface) { + kern_return_t kernResult; + UInt32 locationID; + kernResult = (*deviceInterface)->GetLocationID(deviceInterface, &locationID); + if (KERN_SUCCESS == kernResult) { + snprintf(serialDevice->locationId, sizeof(serialDevice->locationId), "%08x", locationID); + } + + UInt16 vendorID; + kernResult = (*deviceInterface)->GetDeviceVendor(deviceInterface, &vendorID); + if (KERN_SUCCESS == kernResult) { + snprintf(serialDevice->vendorId, sizeof(serialDevice->vendorId), "%04x", vendorID); + } + + UInt16 productID; + kernResult = (*deviceInterface)->GetDeviceProduct(deviceInterface, &productID); + if (KERN_SUCCESS == kernResult) { + snprintf(serialDevice->productId, sizeof(serialDevice->productId), "%04x", productID); + } +} + +static stDeviceListItem* GetSerialDevices() { + char bsdPath[MAXPATHLEN]; + + io_iterator_t serialPortIterator; + FindModems(&serialPortIterator); + + kern_return_t kernResult = KERN_FAILURE; + Boolean modemFound = false; + + // Initialize the returned path + *bsdPath = '\0'; + + stDeviceListItem* devices = NULL; + stDeviceListItem* lastDevice = NULL; + int length = 0; + + io_service_t modemService; + while ((modemService = IOIteratorNext(serialPortIterator))) { + CFTypeRef bsdPathAsCFString; + bsdPathAsCFString = IORegistryEntrySearchCFProperty( + modemService, + kIOServicePlane, + CFSTR(kIODialinDeviceKey), + kCFAllocatorDefault, + kIORegistryIterateRecursively); + + if (bsdPathAsCFString) { + Boolean result; + + // Convert the path from a CFString to a C (NUL-terminated) + result = CFStringGetCString((CFStringRef) bsdPathAsCFString, + bsdPath, + sizeof(bsdPath), + kCFStringEncodingUTF8); + CFRelease(bsdPathAsCFString); + + if (result) { + stDeviceListItem *deviceListItem = reinterpret_cast( malloc(sizeof(stDeviceListItem))); + stSerialDevice *serialDevice = &(deviceListItem->value); + snprintf(serialDevice->port, sizeof(serialDevice->port), "%s", bsdPath); + memset(serialDevice->locationId, 0, sizeof(serialDevice->locationId)); + memset(serialDevice->vendorId, 0, sizeof(serialDevice->vendorId)); + memset(serialDevice->productId, 0, sizeof(serialDevice->productId)); + serialDevice->manufacturer[0] = '\0'; + serialDevice->serialNumber[0] = '\0'; + deviceListItem->next = NULL; + deviceListItem->length = &length; + + if (devices == NULL) { + devices = deviceListItem; + } else { + lastDevice->next = deviceListItem; + } + + lastDevice = deviceListItem; + length++; + + modemFound = true; + kernResult = KERN_SUCCESS; + + uv_mutex_lock(&list_mutex); + + io_service_t device = GetUsbDevice(modemService); + + if (device) { + CFStringRef manufacturerAsCFString = (CFStringRef) IORegistryEntryCreateCFProperty(device, + CFSTR(kUSBVendorString), + kCFAllocatorDefault, + 0); + + if (manufacturerAsCFString) { + Boolean result; + char manufacturer[MAXPATHLEN]; + + // Convert from a CFString to a C (NUL-terminated) + result = CFStringGetCString(manufacturerAsCFString, + manufacturer, + sizeof(manufacturer), + kCFStringEncodingUTF8); + + if (result) { + snprintf(serialDevice->manufacturer, sizeof(serialDevice->manufacturer), "%s", manufacturer); + } + + CFRelease(manufacturerAsCFString); + } + + CFStringRef serialNumberAsCFString = (CFStringRef) IORegistryEntrySearchCFProperty(device, + kIOServicePlane, + CFSTR(kUSBSerialNumberString), + kCFAllocatorDefault, + kIORegistryIterateRecursively); + + if (serialNumberAsCFString) { + Boolean result; + char serialNumber[MAXPATHLEN]; + + // Convert from a CFString to a C (NUL-terminated) + result = CFStringGetCString(serialNumberAsCFString, + serialNumber, + sizeof(serialNumber), + kCFStringEncodingUTF8); + + if (result) { + snprintf(serialDevice->serialNumber, sizeof(serialDevice->serialNumber), "%s", serialNumber); + } + + CFRelease(serialNumberAsCFString); + } + + IOCFPlugInInterface **plugInInterface = NULL; + SInt32 score; + HRESULT res; + + IOUSBDeviceInterface **deviceInterface = NULL; + + kernResult = IOCreatePlugInInterfaceForService(device, kIOUSBDeviceUserClientTypeID, kIOCFPlugInInterfaceID, + &plugInInterface, &score); + + if ((kIOReturnSuccess == kernResult) && plugInInterface) { + // Use the plugin interface to retrieve the device interface. + res = (*plugInInterface)->QueryInterface(plugInInterface, CFUUIDGetUUIDBytes(kIOUSBDeviceInterfaceID), + reinterpret_cast (&deviceInterface)); + + // Now done with the plugin interface. + (*plugInInterface)->Release(plugInInterface); + + if (!res && deviceInterface != NULL) { + // Extract the desired Information + ExtractUsbInformation(serialDevice, deviceInterface); + + // Release the Interface + (*deviceInterface)->Release(deviceInterface); + } + } + + // Release the device + (void) IOObjectRelease(device); + } + + uv_mutex_unlock(&list_mutex); + } + } + + // Release the io_service_t now that we are done with it. + (void) IOObjectRelease(modemService); + } + + IOObjectRelease(serialPortIterator); // Release the iterator. + + return devices; +} + +void ListBaton::Execute() { + + if (!lockInitialised) { + uv_mutex_init(&list_mutex); + lockInitialised = TRUE; + } + + stDeviceListItem* devices = GetSerialDevices(); + if (devices != NULL && *(devices->length) > 0) { + stDeviceListItem* next = devices; + + for (int i = 0, len = *(devices->length); i < len; i++) { + stSerialDevice device = (* next).value; + + ListResultItem* resultItem = new ListResultItem(); + resultItem->path = device.port; + + if (*device.locationId) { + resultItem->locationId = device.locationId; + } + if (*device.vendorId) { + resultItem->vendorId = device.vendorId; + } + if (*device.productId) { + resultItem->productId = device.productId; + } + if (*device.manufacturer) { + resultItem->manufacturer = device.manufacturer; + } + if (*device.serialNumber) { + resultItem->serialNumber = device.serialNumber; + } + results.push_back(resultItem); + + stDeviceListItem* current = next; + + if (next->next != NULL) { + next = next->next; + } + + free(current); + } + } +} diff --git a/node_modules/@serialport/bindings-cpp/src/darwin_list.h b/node_modules/@serialport/bindings-cpp/src/darwin_list.h new file mode 100644 index 0000000..2bd15a1 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/darwin_list.h @@ -0,0 +1,68 @@ +#ifndef PACKAGES_SERIALPORT_SRC_DARWIN_LIST_H_ +#define PACKAGES_SERIALPORT_SRC_DARWIN_LIST_H_ +#include // For MAXPATHLEN +#include +#include +#include +#include + +#define ERROR_STRING_SIZE 1088 + +Napi::Value List(const Napi::CallbackInfo& info); +void setIfNotEmpty(Napi::Object item, std::string key, const char *value); + +struct ListResultItem { + std::string path; + std::string manufacturer; + std::string serialNumber; + std::string pnpId; + std::string locationId; + std::string vendorId; + std::string productId; +}; + +struct ListBaton : public Napi::AsyncWorker { + ListBaton(Napi::Function& callback) : Napi::AsyncWorker(callback, "node-serialport:ListBaton"), + errorString() {} + std::list results; + char errorString[ERROR_STRING_SIZE]; + void Execute() override; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Napi::Array result = Napi::Array::New(env); + int i = 0; + for (std::list::iterator it = results.begin(); it != results.end(); ++it, i++) { + Napi::Object item = Napi::Object::New(env); + + setIfNotEmpty(item, "path", (*it)->path.c_str()); + setIfNotEmpty(item, "manufacturer", (*it)->manufacturer.c_str()); + setIfNotEmpty(item, "serialNumber", (*it)->serialNumber.c_str()); + setIfNotEmpty(item, "pnpId", (*it)->pnpId.c_str()); + setIfNotEmpty(item, "locationId", (*it)->locationId.c_str()); + setIfNotEmpty(item, "vendorId", (*it)->vendorId.c_str()); + setIfNotEmpty(item, "productId", (*it)->productId.c_str()); + + (result).Set(i, item); + } + Callback().Call({env.Null(), result}); + } +}; + +typedef struct SerialDevice { + char port[MAXPATHLEN]; + char locationId[MAXPATHLEN]; + char vendorId[MAXPATHLEN]; + char productId[MAXPATHLEN]; + char manufacturer[MAXPATHLEN]; + char serialNumber[MAXPATHLEN]; +} stSerialDevice; + +typedef struct DeviceListItem { + struct SerialDevice value; + struct DeviceListItem *next; + int* length; +} stDeviceListItem; + +#endif // PACKAGES_SERIALPORT_SRC_DARWIN_LIST_H_ diff --git a/node_modules/@serialport/bindings-cpp/src/poller.cpp b/node_modules/@serialport/bindings-cpp/src/poller.cpp new file mode 100644 index 0000000..0b04692 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/poller.cpp @@ -0,0 +1,166 @@ +#include +#include +#include "./poller.h" + +Poller::Poller (const Napi::CallbackInfo &info) : Napi::ObjectWrap(info) + { + Napi::Env env = info.Env(); + Napi::HandleScope scope(env); + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return; + } + this->fd = info[0].As().Int32Value(); + + // callback + if (!info[1].IsFunction()) { + Napi::TypeError::New(env, "Second argument must be a function").ThrowAsJavaScriptException(); + return; + } + this->callback = Napi::Persistent(info[1].As()); + + this->poll_handle = new uv_poll_t(); + memset(this->poll_handle, 0, sizeof(uv_poll_t)); + poll_handle->data = this; + int status = uv_poll_init(uv_default_loop(), poll_handle, fd); + if (0 != status) { + Napi::Error::New(env, uv_strerror(status)).ThrowAsJavaScriptException(); + return; + } + uv_poll_init_success = true; +} + +Poller::~Poller() { + // if we call uv_poll_stop after uv_poll_init failed we segfault + if (uv_poll_init_success) { + uv_poll_stop(poll_handle); + uv_unref(reinterpret_cast (poll_handle)); + uv_close(reinterpret_cast (poll_handle), Poller::onClose); + } else { + delete poll_handle; + } + return; +} + +void Poller::onClose(uv_handle_t* poll_handle) { + // fprintf(stdout, "~Poller is closed\n"); + delete poll_handle; +} + +// Events can be UV_READABLE | UV_WRITABLE | UV_DISCONNECT +void Poller::poll(Napi::Env env, int events) { + Napi::HandleScope scope(env); + // fprintf(stdout, "Poller:poll for %d\n", events); + this->events = this->events | events; + int status = uv_poll_start(this->poll_handle, events, Poller::onData); + if (0 != status) { + Napi::Error::New(env, uv_strerror(status)).ThrowAsJavaScriptException(); + } + return; +} + +void Poller::stop(Napi::Env env) { + Napi::HandleScope scope(env); + int status = uv_poll_stop(this->poll_handle); + if (0 != status) { + Napi::Error::New(env, uv_strerror(status)).ThrowAsJavaScriptException(); + } + return; +} + +int Poller::_stop() { + return uv_poll_stop(poll_handle); +} + +void Poller::onData(uv_poll_t* handle, int status, int events) { + Poller* obj = static_cast(handle->data); + Napi::Env env = obj->Env(); + Napi::HandleScope scope(env); + + // if Error + if (0 != status) { + // fprintf(stdout, "OnData Error status=%s events=%d\n", uv_strerror(status), events); + obj->_stop(); // doesn't matter if this errors + obj->callback.Call({Napi::Error::New(env, uv_strerror(status)).Value(), env.Undefined()}); + } else { + // fprintf(stdout, "OnData status=%d events=%d subscribed=%d\n", status, events, obj->events); + // remove triggered events from the poll + int newEvents = obj->events & ~events; + obj->poll(env, newEvents); + obj->callback.Call({env.Null(), Napi::Number::New(env, events)}); + } + +} + +Napi::Object Poller::Init(Napi::Env env, Napi::Object exports) { + Napi::Function func = DefineClass(env, "Poller", { + StaticMethod<&Poller::New>("New"), + InstanceMethod<&Poller::poll>("poll"), + InstanceMethod<&Poller::stop>("stop"), + InstanceMethod<&Poller::destroy>("destroy"), + }); + + Napi::FunctionReference* constructor = new Napi::FunctionReference(); + + *constructor = Napi::Persistent(func); + exports.Set("Poller", func); + + env.SetInstanceData(constructor); + + return exports; +} + +Napi::Value Poller::New(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + Napi::HandleScope scope(env); + + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "fd must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Value fd = info[0]; + if (!info[1].IsFunction()) { + Napi::TypeError::New(env, "cb must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Function callback = info[1].As(); + Napi::FunctionReference* constructor = info.Env().GetInstanceData(); + return constructor->New({fd, callback}); +} + +Napi::Value Poller::poll(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + Napi::HandleScope scope(env); + Poller* obj = this; + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "events must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int events = info[0].As().Int32Value(); + obj->poll(env, events); + return env.Undefined(); +} + +Napi::Value Poller::stop(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + Napi::HandleScope scope(env); + this->stop(env); + return env.Undefined(); +} + +Napi::Value Poller::destroy(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + Napi::HandleScope scope(env); + Poller* obj = this; + // TODO Fix destruction Segfault + obj->Reset(); + // delete obj; + return env.Undefined(); +} + +inline Napi::FunctionReference & Poller::constructor() { + static Napi::FunctionReference my_constructor; + // TODO Check if required + // my_constructor.SuppressDestruct(); + return my_constructor; +} diff --git a/node_modules/@serialport/bindings-cpp/src/poller.h b/node_modules/@serialport/bindings-cpp/src/poller.h new file mode 100644 index 0000000..c15a2e9 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/poller.h @@ -0,0 +1,35 @@ +#ifndef PACKAGES_SERIALPORT_SRC_POLLER_H_ +#define PACKAGES_SERIALPORT_SRC_POLLER_H_ + +#include +#include + +class Poller : public Napi::ObjectWrap { + public: + static Napi::Object Init(Napi::Env env, Napi::Object exports); + explicit Poller(const Napi::CallbackInfo &info); + static Napi::Value New(const Napi::CallbackInfo& info); + static void onData(uv_poll_t* handle, int status, int events); + static void onClose(uv_handle_t* poll_handle); + ~Poller(); + + private: + int fd; + uv_poll_t* poll_handle = nullptr; + Napi::FunctionReference callback; + bool uv_poll_init_success = false; + + // can this be read off of poll_handle? + int events = 0; + + void poll(Napi::Env env, int events); + void stop(Napi::Env env); + int _stop(); + + Napi::Value poll(const Napi::CallbackInfo& info); + Napi::Value stop(const Napi::CallbackInfo& info); + Napi::Value destroy(const Napi::CallbackInfo& info); + static inline Napi::FunctionReference & constructor(); +}; + +#endif // PACKAGES_SERIALPORT_SRC_POLLER_H_ \ No newline at end of file diff --git a/node_modules/@serialport/bindings-cpp/src/serialport.cpp b/node_modules/@serialport/bindings-cpp/src/serialport.cpp new file mode 100644 index 0000000..c03f38f --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport.cpp @@ -0,0 +1,342 @@ +#include "./serialport.h" + +#ifdef __APPLE__ + #include "./darwin_list.h" +#endif + +#ifdef WIN32 + #define strncasecmp strnicmp + #include "./serialport_win.h" +#else + #include "./poller.h" +#endif + +Napi::Value getValueFromObject(Napi::Object options, std::string key) { + Napi::String str = Napi::String::New(options.Env(), key); + return (options).Get(str); +} + +int getIntFromObject(Napi::Object options, std::string key) { + return getValueFromObject(options, key).ToNumber().Int64Value(); +} + +bool getBoolFromObject(Napi::Object options, std::string key) { + return getValueFromObject(options, key).ToBoolean().Value(); +} + +Napi::String getStringFromObj(Napi::Object options, std::string key) { + return getValueFromObject(options, key).ToString(); +} + +double getDoubleFromObject(Napi::Object options, std::string key) { + return getValueFromObject(options, key).ToNumber().DoubleValue(); +} + +Napi::Value Open(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // path + if (!info[0].IsString()) { + Napi::TypeError::New(env, "First argument must be a string").ThrowAsJavaScriptException(); + return env.Null(); + } + std::string path = info[0].ToString().Utf8Value(); + + // options + if (!info[1].IsObject()) { + Napi::TypeError::New(env, "Second argument must be an object").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Object options = info[1].ToObject(); + + // callback + if (!info[2].IsFunction()) { + Napi::TypeError::New(env, "Third argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Function callback = info[2].As(); + OpenBaton* baton = new OpenBaton(callback); + snprintf(baton->path, sizeof(baton->path), "%s", path.c_str()); + baton->baudRate = getIntFromObject(options, "baudRate"); + baton->dataBits = getIntFromObject(options, "dataBits"); + baton->parity = ToParityEnum(getStringFromObj(options, "parity")); + baton->stopBits = ToStopBitEnum(getDoubleFromObject(options, "stopBits")); + baton->rtscts = getBoolFromObject(options, "rtscts"); + baton->rtsMode = ToRtsModeEnum(getStringFromObj(options, "rtsMode")); + baton->xon = getBoolFromObject(options, "xon"); + baton->xoff = getBoolFromObject(options, "xoff"); + baton->xany = getBoolFromObject(options, "xany"); + baton->hupcl = getBoolFromObject(options, "hupcl"); + baton->lock = getBoolFromObject(options, "lock"); + + #ifndef WIN32 + baton->vmin = getIntFromObject(options, "vmin"); + baton->vtime = getIntFromObject(options, "vtime"); + #endif + + baton->Queue(); + return env.Undefined(); +} + +Napi::Value Update(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // options + if (!info[1].IsObject()) { + Napi::TypeError::New(env, "Second argument must be an object").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Object options = info[1].ToObject(); + + if (!(options).Has("baudRate")) { + Napi::TypeError::New(env, "\"baudRate\" must be set on options object").ThrowAsJavaScriptException(); + return env.Null(); + } + + // callback + if (!info[2].IsFunction()) { + Napi::TypeError::New(env, "Third argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + + Napi::Function callback = info[2].As(); + ConnectionOptionsBaton* baton = new ConnectionOptionsBaton(callback); + + baton->fd = fd; + baton->baudRate = getIntFromObject(options, "baudRate"); + + baton->Queue(); + return env.Undefined(); +} + +Napi::Value Close(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + + // callback + if (!info[1].IsFunction()) { + Napi::TypeError::New(env, "Second argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + + Napi::Function callback = info[1].As(); + CloseBaton* baton = new CloseBaton(callback); + baton->fd = info[0].ToNumber().Int64Value();; + + baton->Queue(); + return env.Undefined(); +} + +Napi::Value Flush(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // callback + if (!info[1].IsFunction()) { + Napi::TypeError::New(env, "Second argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Function callback = info[1].As(); + + FlushBaton* baton = new FlushBaton(callback); + baton->fd = fd; + + baton->Queue(); + return env.Undefined(); +} + +Napi::Value Set(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // options + if (!info[1].IsObject()) { + Napi::TypeError::New(env, "Second argument must be an object").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Object options = info[1].ToObject(); + + // callback + if (!info[2].IsFunction()) { + Napi::TypeError::New(env, "Third argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Function callback = info[2].As(); + + SetBaton* baton = new SetBaton(callback); + baton->fd = fd; + baton->brk = getBoolFromObject(options, "brk"); + baton->rts = getBoolFromObject(options, "rts"); + baton->cts = getBoolFromObject(options, "cts"); + baton->dtr = getBoolFromObject(options, "dtr"); + baton->dsr = getBoolFromObject(options, "dsr"); + baton->lowLatency = getBoolFromObject(options, "lowLatency"); + + baton->Queue(); + return env.Undefined(); +} + +Napi::Value Get(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // callback + if (!info[1].IsFunction()) { + Napi::TypeError::New(env, "Second argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Function callback = info[1].As(); + + GetBaton* baton = new GetBaton(callback); + baton->fd = fd; + baton->cts = false; + baton->dsr = false; + baton->dcd = false; + baton->lowLatency = false; + + baton->Queue(); + return env.Undefined(); +} + +Napi::Value GetBaudRate(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // callback + if (!info[1].IsFunction()) { + Napi::TypeError::New(env, "Second argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + + Napi::Function callback = info[1].As(); + GetBaudRateBaton* baton = new GetBaudRateBaton(callback); + baton->fd = fd; + baton->baudRate = 0; + + baton->Queue(); + return env.Undefined(); +} + +Napi::Value Drain(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // callback + if (!info[1].IsFunction()) { + Napi::TypeError::New(env, "Second argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + + Napi::Function callback = info[1].As(); + DrainBaton* baton = new DrainBaton(callback); + baton->fd = fd; + + baton->Queue(); + return env.Undefined(); +} + +inline SerialPortParity ToParityEnum(const Napi::String& napistr) { + auto tmp = napistr.Utf8Value(); + const char* str = tmp.c_str(); + + size_t count = strlen(str); + SerialPortParity parity = SERIALPORT_PARITY_NONE; + if (!strncasecmp(str, "none", count)) { + parity = SERIALPORT_PARITY_NONE; + } else if (!strncasecmp(str, "even", count)) { + parity = SERIALPORT_PARITY_EVEN; + } else if (!strncasecmp(str, "mark", count)) { + parity = SERIALPORT_PARITY_MARK; + } else if (!strncasecmp(str, "odd", count)) { + parity = SERIALPORT_PARITY_ODD; + } else if (!strncasecmp(str, "space", count)) { + parity = SERIALPORT_PARITY_SPACE; + } + return parity; +} + + inline SerialPortStopBits ToStopBitEnum(double stopBits) { + if (stopBits > 1.4 && stopBits < 1.6) { + return SERIALPORT_STOPBITS_ONE_FIVE; + } + if (stopBits == 2) { + return SERIALPORT_STOPBITS_TWO; + } + return SERIALPORT_STOPBITS_ONE; +} + +inline SerialPortRtsMode ToRtsModeEnum(const Napi::String& napistr) { + auto tmp = napistr.Utf8Value(); + const char* str = tmp.c_str(); + + size_t count = strlen(str); + SerialPortRtsMode mode = SERIALPORT_RTSMODE_HANDSHAKE; + if (!strncasecmp(str, "enable", count)) { + mode = SERIALPORT_RTSMODE_ENABLE; + } else if (!strncasecmp(str, "handshake", count)) { + mode = SERIALPORT_RTSMODE_HANDSHAKE; + } else if (!strncasecmp(str, "toggle", count)) { + mode = SERIALPORT_RTSMODE_TOGGLE; + } + return mode; +} + +Napi::Object init(Napi::Env env, Napi::Object exports) { + exports.Set("set", Napi::Function::New(env, Set)); + exports.Set("get", Napi::Function::New(env, Get)); + exports.Set("getBaudRate", Napi::Function::New(env, GetBaudRate)); + exports.Set("open", Napi::Function::New(env, Open)); + exports.Set("update", Napi::Function::New(env, Update)); + exports.Set("close", Napi::Function::New(env, Close)); + exports.Set("flush", Napi::Function::New(env, Flush)); + exports.Set("drain", Napi::Function::New(env, Drain)); + + #ifdef __APPLE__ + exports.Set("list", Napi::Function::New(env, List)); + #endif + + #ifdef WIN32 + exports.Set("write", Napi::Function::New(env, Write)); + exports.Set("read", Napi::Function::New(env, Read)); + exports.Set("list", Napi::Function::New(env, List)); + #else + Poller::Init(env, exports); + #endif + return exports; +} + +NODE_API_MODULE(serialport, init); diff --git a/node_modules/@serialport/bindings-cpp/src/serialport.h b/node_modules/@serialport/bindings-cpp/src/serialport.h new file mode 100644 index 0000000..27c8108 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport.h @@ -0,0 +1,202 @@ +#ifndef PACKAGES_SERIALPORT_SRC_SERIALPORT_H_ +#define PACKAGES_SERIALPORT_SRC_SERIALPORT_H_ + +// Workaround for electron 11 abi issue https://github.com/serialport/node-serialport/issues/2191 +// TODO Replace with ABI stable runtime check (per https://github.com/serialport/node-serialport/pull/2305#discussion_r697542996) +#include +#if CHECK_NODE_API_MODULE_VERSION && NODE_API_MODULE_VERSION == 85 +#define V8_REVERSE_JSARGS +#endif + +#include +#include +#include +#include +#include + +#define ERROR_STRING_SIZE 1088 + +Napi::Value Open(const Napi::CallbackInfo& info); + +Napi::Value Update(const Napi::CallbackInfo& info); + +Napi::Value Close(const Napi::CallbackInfo& info); + +Napi::Value Flush(const Napi::CallbackInfo& info); + +Napi::Value Set(const Napi::CallbackInfo& info); + +Napi::Value Get(const Napi::CallbackInfo& info); + +Napi::Value GetBaudRate(const Napi::CallbackInfo& info); + +Napi::Value Drain(const Napi::CallbackInfo& info); + +enum SerialPortParity { + SERIALPORT_PARITY_NONE = 1, + SERIALPORT_PARITY_MARK = 2, + SERIALPORT_PARITY_EVEN = 3, + SERIALPORT_PARITY_ODD = 4, + SERIALPORT_PARITY_SPACE = 5 +}; + +enum SerialPortStopBits { + SERIALPORT_STOPBITS_ONE = 1, + SERIALPORT_STOPBITS_ONE_FIVE = 2, + SERIALPORT_STOPBITS_TWO = 3 +}; + +enum SerialPortRtsMode { + SERIALPORT_RTSMODE_ENABLE = 1, + SERIALPORT_RTSMODE_HANDSHAKE = 2, + SERIALPORT_RTSMODE_TOGGLE = 3 +}; + +SerialPortParity ToParityEnum(const Napi::String& str); +SerialPortStopBits ToStopBitEnum(double stopBits); +SerialPortRtsMode ToRtsModeEnum(const Napi::String& str); + +struct OpenBaton : public Napi::AsyncWorker { + OpenBaton(Napi::Function& callback) : Napi::AsyncWorker(callback, "node-serialport:OpenBaton"), + errorString(), path() {} + char errorString[ERROR_STRING_SIZE]; + char path[1024]; + int fd = 0; + int result = 0; + int baudRate = 0; + int dataBits = 0; + bool rtscts = false; + bool xon = false; + bool xoff = false; + bool xany = false; + bool hupcl = false; + bool lock = false; + SerialPortParity parity; + SerialPortStopBits stopBits; + SerialPortRtsMode rtsMode; +#ifndef WIN32 + uint8_t vmin = 0; + uint8_t vtime = 0; +#endif + void Execute() override; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Callback().Call({env.Null(), Napi::Number::New(env, result)}); + } +}; + +struct ConnectionOptions { + ConnectionOptions() : errorString() {} + char errorString[ERROR_STRING_SIZE]; + int fd = 0; + int baudRate = 0; +}; +struct ConnectionOptionsBaton : ConnectionOptions , Napi::AsyncWorker { + ConnectionOptionsBaton(Napi::Function& callback) : ConnectionOptions() , Napi::AsyncWorker(callback, "node-serialport:ConnectionOptionsBaton") {} + + void Execute() override; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Callback().Call({env.Null()}); + } +}; + +struct SetBaton : public Napi::AsyncWorker { + SetBaton(Napi::Function& callback) : Napi::AsyncWorker(callback, "node-serialport:SetBaton"), + errorString() {} + int fd = 0; + int result = 0; + char errorString[ERROR_STRING_SIZE]; + bool rts = false; + bool cts = false; + bool dtr = false; + bool dsr = false; + bool brk = false; + bool lowLatency = false; + + void Execute() override; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Callback().Call({env.Null()}); + } +}; + +struct GetBaton : public Napi::AsyncWorker { + GetBaton(Napi::Function& callback) : Napi::AsyncWorker(callback, "node-serialport:GetBaton"), + errorString() {} + int fd = 0; + char errorString[ERROR_STRING_SIZE]; + bool cts = false; + bool dsr = false; + bool dcd = false; + bool lowLatency = false; + + void Execute() override; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Napi::Object results = Napi::Object::New(env); + results.Set("cts", cts); + results.Set("dsr", dsr); + results.Set("dcd", dcd); + results.Set("lowLatency", lowLatency); + Callback().Call({env.Null(), results}); + } +}; + +struct GetBaudRateBaton : public Napi::AsyncWorker { + GetBaudRateBaton(Napi::Function& callback) : Napi::AsyncWorker(callback, "node-serialport:GetBaudRateBaton"), + errorString() {} + int fd = 0; + char errorString[ERROR_STRING_SIZE]; + int baudRate = 0; + + void Execute() override; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Napi::Object results = Napi::Object::New(env); + (results).Set(Napi::String::New(env, "baudRate"), Napi::Number::New(env, baudRate)); + Callback().Call({env.Null(),results}); + } +}; + +struct VoidBaton : public Napi::AsyncWorker { + VoidBaton(Napi::Function& callback, const char *resource_name) : Napi::AsyncWorker(callback, resource_name), + errorString() {} + int fd = 0; + char errorString[ERROR_STRING_SIZE]; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Callback().Call({env.Null()}); + } +}; + +struct CloseBaton : VoidBaton { + CloseBaton(Napi::Function& callback) : VoidBaton(callback, "node-serialport:CloseBaton") {} + void Execute() override; +}; + +struct DrainBaton : VoidBaton { + DrainBaton(Napi::Function& callback) : VoidBaton(callback, "node-serialport:DrainBaton") {} + void Execute() override; +}; + +struct FlushBaton : VoidBaton { + FlushBaton(Napi::Function& callback) : VoidBaton(callback, "node-serialport:FlushBaton") {} + void Execute() override; +}; + +int setup(int fd, OpenBaton *data); +int setBaudRate(ConnectionOptions *data); +#endif // PACKAGES_SERIALPORT_SRC_SERIALPORT_H_ diff --git a/node_modules/@serialport/bindings-cpp/src/serialport_linux.cpp b/node_modules/@serialport/bindings-cpp/src/serialport_linux.cpp new file mode 100644 index 0000000..b53ed13 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport_linux.cpp @@ -0,0 +1,76 @@ +#if defined(__linux__) + +#include +#include +#include +#include + +// Uses the termios2 interface to set nonstandard baud rates +int linuxSetCustomBaudRate(const int fd, const unsigned int baudrate) { + struct termios2 t; + + if (ioctl(fd, TCGETS2, &t) == -1) { + return -1; + } + + t.c_cflag &= ~CBAUD; + t.c_cflag |= BOTHER; + t.c_ospeed = t.c_ispeed = baudrate; + + if (ioctl(fd, TCSETS2, &t) == -1) { + return -2; + } + + return 0; +} + +// Uses termios2 interface to retrieve system reported baud rate +int linuxGetSystemBaudRate(const int fd, int* const outbaud) { + struct termios2 t; + + if (ioctl(fd, TCGETS2, &t) == -1) { + return -1; + } + + *outbaud = static_cast(t.c_ospeed); + + return 0; +} + +int linuxSetLowLatencyMode(const int fd, const bool enable) { + struct serial_struct ss; + + if (ioctl(fd, TIOCGSERIAL, &ss) == -1) { + return -1; + } + + if ((ss.flags & ASYNC_LOW_LATENCY) == enable) { + return 0; + } + + if (enable) { + ss.flags |= ASYNC_LOW_LATENCY; + } else { + ss.flags &= ~ASYNC_LOW_LATENCY; + } + + if (ioctl(fd, TIOCSSERIAL, &ss) == -1) { + return -2; + } + + return 0; +} + +int linuxGetLowLatencyMode(const int fd, bool* const enabled) { + struct serial_struct ss; + + if (ioctl(fd, TIOCGSERIAL, &ss) == -1) { + return -1; + } + + *enabled = ss.flags & ASYNC_LOW_LATENCY; + + return 0; +} + +#endif diff --git a/node_modules/@serialport/bindings-cpp/src/serialport_linux.h b/node_modules/@serialport/bindings-cpp/src/serialport_linux.h new file mode 100644 index 0000000..f6eb928 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport_linux.h @@ -0,0 +1,10 @@ +#ifndef PACKAGES_SERIALPORT_SRC_SERIALPORT_LINUX_H_ +#define PACKAGES_SERIALPORT_SRC_SERIALPORT_LINUX_H_ + +int linuxSetCustomBaudRate(const int fd, const unsigned int baudrate); +int linuxGetSystemBaudRate(const int fd, int* const outbaud); +int linuxSetLowLatencyMode(const int fd, const bool enable); +int linuxGetLowLatencyMode(const int fd, bool* const enabled); + +#endif // PACKAGES_SERIALPORT_SRC_SERIALPORT_LINUX_H_ + diff --git a/node_modules/@serialport/bindings-cpp/src/serialport_unix.cpp b/node_modules/@serialport/bindings-cpp/src/serialport_unix.cpp new file mode 100644 index 0000000..bde5232 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport_unix.cpp @@ -0,0 +1,482 @@ +#include "serialport_unix.h" +#include "serialport.h" + +#include +#include +#include +#include +#include + +#ifdef __APPLE__ +#include +#include +#endif + +#if defined(MAC_OS_X_VERSION_10_4) && (MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_4) +#include +#include + +#elif defined(__NetBSD__) +#include + +#elif defined(__OpenBSD__) +#include + +#elif defined(__linux__) +#include +#include +#include "serialport_linux.h" +#endif + +int ToStopBitsConstant(SerialPortStopBits stopBits); + +int ToBaudConstant(int baudRate) { + switch (baudRate) { + case 0: return B0; + case 50: return B50; + case 75: return B75; + case 110: return B110; + case 134: return B134; + case 150: return B150; + case 200: return B200; + case 300: return B300; + case 600: return B600; + case 1200: return B1200; + case 1800: return B1800; + case 2400: return B2400; + case 4800: return B4800; + case 9600: return B9600; + case 19200: return B19200; + case 38400: return B38400; + case 57600: return B57600; + case 115200: return B115200; + case 230400: return B230400; +#if defined(__linux__) + case 460800: return B460800; + case 500000: return B500000; + case 576000: return B576000; + case 921600: return B921600; + case 1000000: return B1000000; + case 1152000: return B1152000; + case 1500000: return B1500000; + case 2000000: return B2000000; + case 2500000: return B2500000; + case 3000000: return B3000000; + case 3500000: return B3500000; + case 4000000: return B4000000; +#endif + } + return -1; +} + +int ToDataBitsConstant(int dataBits) { + switch (dataBits) { + case 8: default: return CS8; + case 7: return CS7; + case 6: return CS6; + case 5: return CS5; + } + return -1; +} + +void OpenBaton::Execute() { + + int flags = (O_RDWR | O_NOCTTY | O_NONBLOCK | O_CLOEXEC | O_SYNC); + int fd = open(path, flags); + + if (-1 == fd) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot open %s", strerror(errno), path); + this->SetError(errorString); + return; + } + + if (-1 == setup(fd, this)) { + this->SetError(errorString); + close(fd); + return; + } + + result = fd; +} + +void ConnectionOptionsBaton::Execute() { + // lookup the standard baudrates from the table + int baudRate = ToBaudConstant(this->baudRate); + + // get port options + struct termios options; + if (-1 == tcgetattr(fd, &options)) { + snprintf(errorString, sizeof(errorString), "Error: %s setting custom baud rate of %d", strerror(errno), baudRate); + this->SetError(errorString); + return; + } + + // If there is a custom baud rate on linux you can do the following trick with B38400 + #if defined(__linux__) && defined(ASYNC_SPD_CUST) + if (baudRate == -1) { + int err = linuxSetCustomBaudRate(fd, baudRate); + + if (err == -1) { + snprintf(errorString, sizeof(errorString), "Error: %s || while retrieving termios2 info", strerror(errno)); + this->SetError(errorString); + return; + } else if (err == -2) { + snprintf(errorString, sizeof(errorString), "Error: %s || while setting custom baud rate of %d", strerror(errno), baudRate); + this->SetError(errorString); + return; + } + + return; + } + #endif + + // On OS X, starting with Tiger, we can set a custom baud rate with ioctl + #if defined(MAC_OS_X_VERSION_10_4) && (MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_4) + if (-1 == baudRate) { + speed_t speed = baudRate; + if (-1 == ioctl(fd, IOSSIOSPEED, &speed)) { + snprintf(errorString, sizeof(errorString), "Error: %s calling ioctl(.., IOSSIOSPEED, %ld )", strerror(errno), speed); + this->SetError(errorString); + return; + } else { + tcflush(fd, TCIOFLUSH); + return; + } + } + #endif + + if (-1 == baudRate) { + snprintf(errorString, sizeof(errorString), "Error baud rate of %d is not supported on your platform", baudRate); + this->SetError(errorString); + return; + } + + // If we have a good baud rate set it and lets go + cfsetospeed(&options, baudRate); + cfsetispeed(&options, baudRate); + // throw away all the buffered data + tcflush(fd, TCIOFLUSH); + // make the changes now + tcsetattr(fd, TCSANOW, &options); + return; +} + +int setup(int fd, OpenBaton *data) { + int dataBits = ToDataBitsConstant(data->dataBits); + if (-1 == dataBits) { + snprintf(data->errorString, sizeof(data->errorString),"Invalid data bits setting %d", data->dataBits); + return -1; + } + + // Snow Leopard doesn't have O_CLOEXEC + if (-1 == fcntl(fd, F_SETFD, FD_CLOEXEC)) { + snprintf(data->errorString, sizeof(data->errorString), "Error %s Cannot open %s", strerror(errno), data->path); + return -1; + } + + // Get port configuration for modification + struct termios options; + tcgetattr(fd, &options); + + // IGNPAR: ignore bytes with parity errors + options.c_iflag = IGNPAR; + + // ICRNL: map CR to NL (otherwise a CR input on the other computer will not terminate input) + // Future potential option + // options.c_iflag = ICRNL; + // otherwise make device raw (no other input processing) + + // Specify data bits + options.c_cflag &= ~CSIZE; + options.c_cflag |= dataBits; + + options.c_cflag &= ~(CRTSCTS); + + if (data->rtscts) { + options.c_cflag |= CRTSCTS; + // evaluate specific flow control options + } + + options.c_iflag &= ~(IXON | IXOFF | IXANY); + + if (data->xon) { + options.c_iflag |= IXON; + } + + if (data->xoff) { + options.c_iflag |= IXOFF; + } + + if (data->xany) { + options.c_iflag |= IXANY; + } + + switch (data->parity) { + case SERIALPORT_PARITY_NONE: + options.c_cflag &= ~PARENB; + // options.c_cflag &= ~CSTOPB; + // options.c_cflag &= ~CSIZE; + // options.c_cflag |= CS8; + break; + case SERIALPORT_PARITY_ODD: + options.c_cflag |= PARENB; + options.c_cflag |= PARODD; + // options.c_cflag &= ~CSTOPB; + // options.c_cflag &= ~CSIZE; + // options.c_cflag |= CS7; + break; + case SERIALPORT_PARITY_EVEN: + options.c_cflag |= PARENB; + options.c_cflag &= ~PARODD; + // options.c_cflag &= ~CSTOPB; + // options.c_cflag &= ~CSIZE; + // options.c_cflag |= CS7; + break; + default: + snprintf(data->errorString, sizeof(data->errorString), "Invalid parity setting %d", data->parity); + return -1; + } + + switch (data->stopBits) { + case SERIALPORT_STOPBITS_ONE: + options.c_cflag &= ~CSTOPB; + break; + case SERIALPORT_STOPBITS_TWO: + options.c_cflag |= CSTOPB; + break; + default: + snprintf(data->errorString, sizeof(data->errorString), "Invalid stop bits setting %d", data->stopBits); + return -1; + } + + options.c_cflag |= CLOCAL; // ignore status lines + options.c_cflag |= CREAD; // enable receiver + if (data->hupcl) { + options.c_cflag |= HUPCL; // drop DTR (i.e. hangup) on close + } + + // Raw output + options.c_oflag = 0; + + // ICANON makes partial lines not readable. It should be optional. + // It works with ICRNL. + options.c_lflag = 0; // ICANON; + options.c_cc[VMIN]= data->vmin; + options.c_cc[VTIME]= data->vtime; + + // Note that tcsetattr() returns success if any of the requested changes could be successfully carried out. + // Therefore, when making multiple changes it may be necessary to follow this call with a further call to + // tcgetattr() to check that all changes have been performed successfully. + // This also fails on OSX + tcsetattr(fd, TCSANOW, &options); + + if (data->lock) { + if (-1 == flock(fd, LOCK_EX | LOCK_NB)) { + snprintf(data->errorString, sizeof(data->errorString), "Error %s Cannot lock port", strerror(errno)); + return -1; + } + } + + // Copy the connection options into the ConnectionOptionsBaton to set the baud rate + ConnectionOptions* connectionOptions = new ConnectionOptions(); + connectionOptions->fd = fd; + connectionOptions->baudRate = data->baudRate; + + if (-1 == setBaudRate(connectionOptions)) { + strncpy(data->errorString, connectionOptions->errorString, sizeof(data->errorString)); + delete(connectionOptions); + return -1; + } + delete(connectionOptions); + + // flush all unread and wrote data up to this point because it could have been received or sent with bad settings + // Not needed since setBaudRate does this for us + // tcflush(fd, TCIOFLUSH); + + return 1; +} + +int setBaudRate(ConnectionOptions *data) { + // lookup the standard baudrates from the table + int baudRate = ToBaudConstant(data->baudRate); + int fd = data->fd; + + // get port options + struct termios options; + if (-1 == tcgetattr(fd, &options)) { + snprintf(data->errorString, sizeof(data->errorString), + "Error: %s setting custom baud rate of %d", strerror(errno), data->baudRate); + return -1; + } + + // If there is a custom baud rate on linux you can do the following trick with B38400 + #if defined(__linux__) && defined(ASYNC_SPD_CUST) + if (baudRate == -1) { + int err = linuxSetCustomBaudRate(fd, data->baudRate); + + if (err == -1) { + snprintf(data->errorString, sizeof(data->errorString), + "Error: %s || while retrieving termios2 info", strerror(errno)); + return -1; + } else if (err == -2) { + snprintf(data->errorString, sizeof(data->errorString), + "Error: %s || while setting custom baud rate of %d", strerror(errno), data->baudRate); + return -1; + } + + return 1; + } + #endif + + // On OS X, starting with Tiger, we can set a custom baud rate with ioctl + #if defined(MAC_OS_X_VERSION_10_4) && (MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_4) + if (-1 == baudRate) { + speed_t speed = data->baudRate; + if (-1 == ioctl(fd, IOSSIOSPEED, &speed)) { + snprintf(data->errorString, sizeof(data->errorString), + "Error: %s calling ioctl(.., IOSSIOSPEED, %ld )", strerror(errno), speed); + return -1; + } else { + tcflush(fd, TCIOFLUSH); + return 1; + } + } + #endif + + if (-1 == baudRate) { + snprintf(data->errorString, sizeof(data->errorString), "Error baud rate of %d is not supported on your platform", data->baudRate); + return -1; + } + + // If we have a good baud rate set it and lets go + cfsetospeed(&options, baudRate); + cfsetispeed(&options, baudRate); + // throw away all the buffered data + tcflush(fd, TCIOFLUSH); + // make the changes now + tcsetattr(fd, TCSANOW, &options); + return 1; +} + +void CloseBaton::Execute() { + + if (-1 == close(fd)) { + snprintf(errorString, sizeof(errorString), "Error: %s, unable to close fd %d", strerror(errno), fd); + this->SetError(errorString); + } +} + +void SetBaton::Execute() { + + int bits; + ioctl(fd, TIOCMGET, &bits); + + bits &= ~(TIOCM_RTS | TIOCM_CTS | TIOCM_DTR | TIOCM_DSR); + + if (rts) { + bits |= TIOCM_RTS; + } + + if (cts) { + bits |= TIOCM_CTS; + } + + if (dtr) { + bits |= TIOCM_DTR; + } + + if (dsr) { + bits |= TIOCM_DSR; + } + + int result = 0; + if (brk) { + result = ioctl(fd, TIOCSBRK, NULL); + } else { + result = ioctl(fd, TIOCCBRK, NULL); + } + + if (-1 == result) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot set", strerror(errno)); + this->SetError(errorString); + return; + } + + if (-1 == ioctl(fd, TIOCMSET, &bits)) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot set", strerror(errno)); + this->SetError(errorString); + return; + } + + #if defined(__linux__) + int err = linuxSetLowLatencyMode(fd, lowLatency); + // Only report errors when the lowLatency is being set to true. Attempting to set as false can error, since the default is false + if (lowLatency) { + if (err == -1) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot get low latency", strerror(errno)); + return; + } else if(err == -2) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot set low latency", strerror(errno)); + return; + } + } + #endif +} + +void GetBaton::Execute() { + int bits; + if (-1 == ioctl(fd, TIOCMGET, &bits)) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot get", strerror(errno)); + this->SetError(errorString); + return; + } + + cts = bits & TIOCM_CTS; + dsr = bits & TIOCM_DSR; + dcd = bits & TIOCM_CD; + + #if defined(__linux__) && defined(ASYNC_LOW_LATENCY) + bool lowlatency = false; + // Try to get low latency info, but we don't care if fails (a failure state will still return lowlatency = false) + linuxGetLowLatencyMode(fd, &lowlatency); + lowLatency = lowlatency; + #else + lowLatency = false; + #endif +} + +void GetBaudRateBaton::Execute() { + int outbaud = -1; + + #if defined(__linux__) && defined(ASYNC_SPD_CUST) + if (-1 == linuxGetSystemBaudRate(fd, &outbaud)) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot get baud rate", strerror(errno)); + this->SetError(errorString); + return; + } + #else + snprintf(errorString, sizeof(errorString), "Error: System baud rate check not implemented on this platform"); + this->SetError(errorString); + return; + #endif + + baudRate = outbaud; +} + +void FlushBaton::Execute() { + + if (-1 == tcflush(fd, TCIOFLUSH)) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot flush", strerror(errno)); + this->SetError(errorString); + return; + } +} + +void DrainBaton::Execute() { + + if (-1 == tcdrain(fd)) { + snprintf(errorString, sizeof(errorString), "Error: %s, cannot drain", strerror(errno)); + this->SetError(errorString); + return; + } +} diff --git a/node_modules/@serialport/bindings-cpp/src/serialport_unix.h b/node_modules/@serialport/bindings-cpp/src/serialport_unix.h new file mode 100644 index 0000000..aaf30b8 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport_unix.h @@ -0,0 +1,7 @@ +#ifndef PACKAGES_SERIALPORT_SRC_SERIALPORT_UNIX_H_ +#define PACKAGES_SERIALPORT_SRC_SERIALPORT_UNIX_H_ + +int ToBaudConstant(int baudRate); +int ToDataBitsConstant(int dataBits); + +#endif // PACKAGES_SERIALPORT_SRC_SERIALPORT_UNIX_H_ diff --git a/node_modules/@serialport/bindings-cpp/src/serialport_win.cpp b/node_modules/@serialport/bindings-cpp/src/serialport_win.cpp new file mode 100644 index 0000000..910023e --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport_win.cpp @@ -0,0 +1,958 @@ +#include "./serialport.h" +#include "./serialport_win.h" +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#pragma comment(lib, "setupapi.lib") + +#define ARRAY_SIZE(arr) (sizeof(arr)/sizeof(arr[0])) + +#define MAX_BUFFER_SIZE 1000 + +// As per https://msdn.microsoft.com/en-us/library/windows/desktop/ms724872(v=vs.85).aspx +#define MAX_REGISTRY_KEY_SIZE 255 + +// Declare type of pointer to CancelIoEx function +typedef BOOL (WINAPI *CancelIoExType)(HANDLE hFile, LPOVERLAPPED lpOverlapped); + + +std::list g_closingHandles; + +void ErrorCodeToString(const wchar_t* prefix, int errorCode, wchar_t *errorStr) { + switch (errorCode) { + case ERROR_FILE_NOT_FOUND: + _snwprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, L"%ls: File not found", prefix); + break; + case ERROR_INVALID_HANDLE: + _snwprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, L"%ls: Invalid handle", prefix); + break; + case ERROR_ACCESS_DENIED: + _snwprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, L"%ls: Access denied", prefix); + break; + case ERROR_OPERATION_ABORTED: + _snwprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, L"%ls: Operation aborted", prefix); + break; + case ERROR_INVALID_PARAMETER: + _snwprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, L"%ls: The parameter is incorrect %d", prefix, errorCode); + break; + default: + _snwprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, L"%ls: Unknown error code %d", prefix, errorCode); + break; + } +} + +void ErrorCodeToString(const char* prefix, int errorCode, char *errorStr) { + switch (errorCode) { + case ERROR_FILE_NOT_FOUND: + _snprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, "%s: File not found", prefix); + break; + case ERROR_INVALID_HANDLE: + _snprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, "%s: Invalid handle", prefix); + break; + case ERROR_ACCESS_DENIED: + _snprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, "%s: Access denied", prefix); + break; + case ERROR_OPERATION_ABORTED: + _snprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, "%s: Operation aborted", prefix); + break; + case ERROR_INVALID_PARAMETER: + _snprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, "%s: The parameter is incorrect", prefix); + break; + default: + _snprintf_s(errorStr, ERROR_STRING_SIZE, _TRUNCATE, "%s: Unknown error code %d", prefix, errorCode); + break; + } +} + +void AsyncCloseCallback(uv_handle_t* handle) { + uv_async_t* async = reinterpret_cast(handle); + delete async; +} + +void OpenBaton::Execute() { + char originalPath[1024]; + strncpy_s(originalPath, sizeof(originalPath), path, _TRUNCATE); + // path is char[1024] but on Windows it has the form "COMx\0" or "COMxx\0" + // We want to prepend "\\\\.\\" to it before we call CreateFile + strncpy(path + 20, path, 10); + strncpy(path, "\\\\.\\", 4); + strncpy(path + 4, path + 20, 10); + + int shareMode = FILE_SHARE_READ | FILE_SHARE_WRITE; + if (lock) { + shareMode = 0; + } + + HANDLE file = CreateFile( + path, + GENERIC_READ | GENERIC_WRITE, + shareMode, // dwShareMode 0 Prevents other processes from opening if they request delete, read, or write access + NULL, + OPEN_EXISTING, + FILE_FLAG_OVERLAPPED, // allows for reading and writing at the same time and sets the handle for asynchronous I/O + NULL); + + if (file == INVALID_HANDLE_VALUE) { + DWORD errorCode = GetLastError(); + char temp[100]; + _snprintf_s(temp, sizeof(temp), _TRUNCATE, "Opening %s", originalPath); + ErrorCodeToString(temp, errorCode, errorString); + this->SetError(errorString); + return; + } + + DCB dcb = { 0 }; + SecureZeroMemory(&dcb, sizeof(DCB)); + dcb.DCBlength = sizeof(DCB); + + if (!GetCommState(file, &dcb)) { + ErrorCodeToString("Open (GetCommState)", GetLastError(), errorString); + this->SetError(errorString); + CloseHandle(file); + return; + } + + if (hupcl) { + dcb.fDtrControl = DTR_CONTROL_ENABLE; + } else { + dcb.fDtrControl = DTR_CONTROL_DISABLE; // disable DTR to avoid reset + } + + dcb.Parity = NOPARITY; + dcb.StopBits = ONESTOPBIT; + + + dcb.fOutxDsrFlow = FALSE; + dcb.fOutxCtsFlow = FALSE; + + if (xon) { + dcb.fOutX = TRUE; + } else { + dcb.fOutX = FALSE; + } + + if (xoff) { + dcb.fInX = TRUE; + } else { + dcb.fInX = FALSE; + } + + if (rtscts) { + switch (rtsMode) { + case SERIALPORT_RTSMODE_ENABLE: + dcb.fRtsControl = RTS_CONTROL_ENABLE; + break; + case SERIALPORT_RTSMODE_HANDSHAKE: + dcb.fRtsControl = RTS_CONTROL_HANDSHAKE; + break; + case SERIALPORT_RTSMODE_TOGGLE: + dcb.fRtsControl = RTS_CONTROL_TOGGLE; + break; + } + dcb.fOutxCtsFlow = TRUE; + } else { + dcb.fRtsControl = RTS_CONTROL_DISABLE; + } + + dcb.fBinary = true; + dcb.BaudRate = baudRate; + dcb.ByteSize = dataBits; + + switch (parity) { + case SERIALPORT_PARITY_NONE: + dcb.Parity = NOPARITY; + break; + case SERIALPORT_PARITY_MARK: + dcb.Parity = MARKPARITY; + break; + case SERIALPORT_PARITY_EVEN: + dcb.Parity = EVENPARITY; + break; + case SERIALPORT_PARITY_ODD: + dcb.Parity = ODDPARITY; + break; + case SERIALPORT_PARITY_SPACE: + dcb.Parity = SPACEPARITY; + break; + } + + switch (stopBits) { + case SERIALPORT_STOPBITS_ONE: + dcb.StopBits = ONESTOPBIT; + break; + case SERIALPORT_STOPBITS_ONE_FIVE: + dcb.StopBits = ONE5STOPBITS; + break; + case SERIALPORT_STOPBITS_TWO: + dcb.StopBits = TWOSTOPBITS; + break; + } + + if (!SetCommState(file, &dcb)) { + ErrorCodeToString("Open (SetCommState)", GetLastError(), errorString); + this->SetError(errorString); + CloseHandle(file); + return; + } + + // Set the timeouts for read and write operations. + // Read operation will wait for at least 1 byte to be received. + COMMTIMEOUTS commTimeouts = {}; + commTimeouts.ReadIntervalTimeout = 0; // Never timeout, always wait for data. + commTimeouts.ReadTotalTimeoutMultiplier = 0; // Do not allow big read timeout when big read buffer used + commTimeouts.ReadTotalTimeoutConstant = 0; // Total read timeout (period of read loop) + commTimeouts.WriteTotalTimeoutConstant = 0; // Const part of write timeout + commTimeouts.WriteTotalTimeoutMultiplier = 0; // Variable part of write timeout (per byte) + + if (!SetCommTimeouts(file, &commTimeouts)) { + ErrorCodeToString("Open (SetCommTimeouts)", GetLastError(), errorString); + this->SetError(errorString); + CloseHandle(file); + return; + } + + // Remove garbage data in RX/TX queues + PurgeComm(file, PURGE_RXCLEAR); + PurgeComm(file, PURGE_TXCLEAR); + + result = static_cast(reinterpret_cast(file)); +} + +void ConnectionOptionsBaton::Execute() { + DCB dcb = { 0 }; + SecureZeroMemory(&dcb, sizeof(DCB)); + dcb.DCBlength = sizeof(DCB); + + if (!GetCommState(int2handle(fd), &dcb)) { + ErrorCodeToString("Update (GetCommState)", GetLastError(), errorString); + this->SetError(errorString); + return; + } + + dcb.BaudRate = baudRate; + + if (!SetCommState(int2handle(fd), &dcb)) { + ErrorCodeToString("Update (SetCommState)", GetLastError(), errorString); + this->SetError(errorString); + return; + } +} + +void SetBaton::Execute() { + if (rts) { + EscapeCommFunction(int2handle(fd), SETRTS); + } else { + EscapeCommFunction(int2handle(fd), CLRRTS); + } + + if (dtr) { + EscapeCommFunction(int2handle(fd), SETDTR); + } else { + EscapeCommFunction(int2handle(fd), CLRDTR); + } + + if (brk) { + EscapeCommFunction(int2handle(fd), SETBREAK); + } else { + EscapeCommFunction(int2handle(fd), CLRBREAK); + } + + DWORD bits = 0; + + GetCommMask(int2handle(fd), &bits); + + bits &= ~(EV_CTS | EV_DSR); + + if (cts) { + bits |= EV_CTS; + } + + if (dsr) { + bits |= EV_DSR; + } + + if (!SetCommMask(int2handle(fd), bits)) { + ErrorCodeToString("Setting options on COM port (SetCommMask)", GetLastError(), errorString); + this->SetError(errorString); + return; + } +} + +void GetBaton::Execute() { + DWORD bits = 0; + if (!GetCommModemStatus(int2handle(fd), &bits)) { + ErrorCodeToString("Getting control settings on COM port (GetCommModemStatus)", GetLastError(), errorString); + this->SetError(errorString); + return; + } + + cts = bits & MS_CTS_ON; + dsr = bits & MS_DSR_ON; + dcd = bits & MS_RLSD_ON; +} + +void GetBaudRateBaton::Execute() { + + DCB dcb = { 0 }; + SecureZeroMemory(&dcb, sizeof(DCB)); + dcb.DCBlength = sizeof(DCB); + + if (!GetCommState(int2handle(fd), &dcb)) { + ErrorCodeToString("Getting baud rate (GetCommState)", GetLastError(), errorString); + this->SetError(errorString); + return; + } + + baudRate = static_cast(dcb.BaudRate); +} + +bool IsClosingHandle(int fd) { + for (std::list::iterator it = g_closingHandles.begin(); it != g_closingHandles.end(); ++it) { + if (fd == *it) { + g_closingHandles.remove(fd); + return true; + } + } + return false; +} + +void __stdcall WriteIOCompletion(DWORD errorCode, DWORD bytesTransferred, OVERLAPPED* ov) { + WriteBaton* baton = static_cast(ov->hEvent); + DWORD bytesWritten; + if (!GetOverlappedResult(int2handle(baton->fd), ov, &bytesWritten, TRUE)) { + errorCode = GetLastError(); + ErrorCodeToString("Writing to COM port (GetOverlappedResult)", errorCode, baton->errorString); + baton->complete = true; + return; + } + if (bytesWritten) { + baton->offset += bytesWritten; + if (baton->offset >= baton->bufferLength) { + baton->complete = true; + } + } +} + +DWORD __stdcall WriteThread(LPVOID param) { + uv_async_t* async = static_cast(param); + WriteBaton* baton = static_cast(async->data); + + OVERLAPPED* ov = new OVERLAPPED; + memset(ov, 0, sizeof(OVERLAPPED)); + ov->hEvent = static_cast(baton); + + while (!baton->complete) { + char* offsetPtr = baton->bufferData + baton->offset; + // WriteFileEx requires calling GetLastError even upon success. Clear the error beforehand. + SetLastError(0); + WriteFileEx(int2handle(baton->fd), offsetPtr, + static_cast(baton->bufferLength - baton->offset), ov, WriteIOCompletion); + // Error codes when call is successful, such as ERROR_MORE_DATA. + DWORD lastError = GetLastError(); + if (lastError != ERROR_SUCCESS) { + ErrorCodeToString("Writing to COM port (WriteFileEx)", lastError, baton->errorString); + break; + } + // IOCompletion routine is only called once this thread is in an alertable wait state. + SleepEx(INFINITE, TRUE); + } + delete ov; + // Signal the main thread to run the callback. + uv_async_send(async); + ExitThread(0); +} + +void EIO_AfterWrite(uv_async_t* req) { + WriteBaton* baton = static_cast(req->data); + Napi::Env env = baton->callback.Env(); + Napi::HandleScope scope(env); + WaitForSingleObject(baton->hThread, INFINITE); + CloseHandle(baton->hThread); + uv_close(reinterpret_cast(req), AsyncCloseCallback); + + v8::Local argv[1]; + if (baton->errorString[0]) { + baton->callback.Call({Napi::Error::New(env, baton->errorString).Value()}); + } else { + baton->callback.Call({env.Null()}); + } + baton->buffer.Reset(); + delete baton; +} + + +Napi::Value Write(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // buffer + if (!info[1].IsObject() || !info[1].IsBuffer()) { + Napi::TypeError::New(env, "Second argument must be a buffer").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Buffer buffer = info[1].As>(); + //getBufferFromObject(info[1].ToObject().ti); + char* bufferData = buffer.Data(); //.As>().Data(); + size_t bufferLength = buffer.Length();//.As>().Length(); + + // callback + if (!info[2].IsFunction()) { + Napi::TypeError::New(env, "Third argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + + WriteBaton* baton = new WriteBaton(); + baton->callback = Napi::Persistent(info[2].As()); + baton->fd = fd; + baton->buffer.Reset(buffer); + baton->bufferData = bufferData; + baton->bufferLength = bufferLength; + baton->offset = 0; + baton->complete = false; + + uv_async_t* async = new uv_async_t; + uv_async_init(uv_default_loop(), async, EIO_AfterWrite); + async->data = baton; + // WriteFileEx requires a thread that can block. Create a new thread to + // run the write operation, saving the handle so it can be deallocated later. + baton->hThread = CreateThread(NULL, 0, WriteThread, async, 0, NULL); + return env.Null(); +} + +void __stdcall ReadIOCompletion(DWORD errorCode, DWORD bytesTransferred, OVERLAPPED* ov) { + ReadBaton* baton = static_cast(ov->hEvent); + + if (errorCode) { + ErrorCodeToString("Reading from COM port (ReadIOCompletion)", errorCode, baton->errorString); + baton->complete = true; + return; + } + + DWORD lastError; + if (!GetOverlappedResult(int2handle(baton->fd), ov, &bytesTransferred, TRUE)) { + lastError = GetLastError(); + ErrorCodeToString("Reading from COM port (GetOverlappedResult)", lastError, baton->errorString); + baton->complete = true; + return; + } + if (bytesTransferred) { + baton->bytesToRead -= bytesTransferred; + baton->bytesRead += bytesTransferred; + baton->offset += bytesTransferred; + } + + // ReadFileEx and GetOverlappedResult retrieved only 1 byte. Read any additional data in the input + // buffer. Set the timeout to MAXDWORD in order to disable timeouts, so the read operation will + // return immediately no matter how much data is available. + COMMTIMEOUTS commTimeouts = {}; + commTimeouts.ReadIntervalTimeout = MAXDWORD; + if (!SetCommTimeouts(int2handle(baton->fd), &commTimeouts)) { + lastError = GetLastError(); + ErrorCodeToString("Setting COM timeout (SetCommTimeouts)", lastError, baton->errorString); + baton->complete = true; + return; + } + + // Store additional data after whatever data has already been read. + char* offsetPtr = baton->bufferData + baton->offset; + + // ReadFile, unlike ReadFileEx, needs an event in the overlapped structure. + memset(ov, 0, sizeof(OVERLAPPED)); + ov->hEvent = CreateEvent(NULL, TRUE, FALSE, NULL); + if (!ReadFile(int2handle(baton->fd), offsetPtr, baton->bytesToRead, &bytesTransferred, ov)) { + errorCode = GetLastError(); + + if (errorCode != ERROR_IO_PENDING) { + ErrorCodeToString("Reading from COM port (ReadFile)", errorCode, baton->errorString); + baton->complete = true; + CloseHandle(ov->hEvent); + return; + } + + if (!GetOverlappedResult(int2handle(baton->fd), ov, &bytesTransferred, TRUE)) { + lastError = GetLastError(); + ErrorCodeToString("Reading from COM port (GetOverlappedResult)", lastError, baton->errorString); + baton->complete = true; + CloseHandle(ov->hEvent); + return; + } + } + CloseHandle(ov->hEvent); + + baton->bytesToRead -= bytesTransferred; + baton->bytesRead += bytesTransferred; + baton->complete = true; +} + +DWORD __stdcall ReadThread(LPVOID param) { + uv_async_t* async = static_cast(param); + ReadBaton* baton = static_cast(async->data); + DWORD lastError; + + OVERLAPPED* ov = new OVERLAPPED; + memset(ov, 0, sizeof(OVERLAPPED)); + ov->hEvent = static_cast(baton); + + while (!baton->complete) { + // Reset the read timeout to 0, so that it will block until more data arrives. + COMMTIMEOUTS commTimeouts = {}; + commTimeouts.ReadIntervalTimeout = 0; + if (!SetCommTimeouts(int2handle(baton->fd), &commTimeouts)) { + lastError = GetLastError(); + ErrorCodeToString("Setting COM timeout (SetCommTimeouts)", lastError, baton->errorString); + break; + } + // ReadFileEx doesn't use overlapped's hEvent, so it is reserved for user data. + ov->hEvent = static_cast(baton); + char* offsetPtr = baton->bufferData + baton->offset; + // ReadFileEx requires calling GetLastError even upon success. Clear the error beforehand. + SetLastError(0); + // Only read 1 byte, so that the callback will be triggered once any data arrives. + ReadFileEx(int2handle(baton->fd), offsetPtr, 1, ov, ReadIOCompletion); + // Error codes when call is successful, such as ERROR_MORE_DATA. + lastError = GetLastError(); + if (lastError != ERROR_SUCCESS) { + ErrorCodeToString("Reading from COM port (ReadFileEx)", lastError, baton->errorString); + break; + } + // IOCompletion routine is only called once this thread is in an alertable wait state. + SleepEx(INFINITE, TRUE); + } + delete ov; + // Signal the main thread to run the callback. + uv_async_send(async); + ExitThread(0); +} + +void EIO_AfterRead(uv_async_t* req) { + ReadBaton* baton = static_cast(req->data); + Napi::Env env = baton->callback.Env(); + Napi::HandleScope scope(env); + WaitForSingleObject(baton->hThread, INFINITE); + CloseHandle(baton->hThread); + uv_close(reinterpret_cast(req), AsyncCloseCallback); + + if (baton->errorString[0]) { + baton->callback.Call({Napi::Error::New(env, baton->errorString).Value(), env.Undefined()}); + } else { + baton->callback.Call({env.Null(), Napi::Number::New(env, static_cast(baton->bytesRead))}); + } + delete baton; +} + +Napi::Value Read(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // file descriptor + if (!info[0].IsNumber()) { + Napi::TypeError::New(env, "First argument must be a fd").ThrowAsJavaScriptException(); + return env.Null(); + } + int fd = info[0].As().Int32Value(); + + // buffer + if (!info[1].IsObject() || !info[1].IsBuffer()) { + Napi::TypeError::New(env, "Second argument must be a buffer").ThrowAsJavaScriptException(); + return env.Null(); + } + Napi::Object buffer = info[1].ToObject(); + size_t bufferLength = buffer.As>().Length(); + + // offset + if (!info[2].IsNumber()) { + Napi::TypeError::New(env, "Third argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + int offset = info[2].ToNumber().Int64Value(); + + // bytes to read + if (!info[3].IsNumber()) { + Napi::TypeError::New(env, "Fourth argument must be an int").ThrowAsJavaScriptException(); + return env.Null(); + } + size_t bytesToRead = info[3].ToNumber().Int64Value(); + + if ((bytesToRead + offset) > bufferLength) { + Napi::TypeError::New(env, "'bytesToRead' + 'offset' cannot be larger than the buffer's length").ThrowAsJavaScriptException(); + return env.Null(); + } + + // callback + if (!info[4].IsFunction()) { + Napi::TypeError::New(env, "Fifth argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + ReadBaton* baton = new ReadBaton(); + baton->callback = Napi::Persistent(info[4].As()); + baton->fd = fd; + baton->offset = offset; + baton->bytesToRead = bytesToRead; + baton->bufferLength = bufferLength; + + baton->bufferData = buffer.As>().Data(); + baton->complete = false; + + uv_async_t* async = new uv_async_t; + uv_async_init(uv_default_loop(), async, EIO_AfterRead); + async->data = baton; + baton->hThread = CreateThread(NULL, 0, ReadThread, async, 0, NULL); + // ReadFileEx requires a thread that can block. Create a new thread to + // run the read operation, saving the handle so it can be deallocated later. + return env.Null(); +} + +void CloseBaton::Execute() { + g_closingHandles.push_back(fd); + + HMODULE hKernel32 = LoadLibrary("kernel32.dll"); + // Look up function address + CancelIoExType pCancelIoEx = (CancelIoExType)GetProcAddress(hKernel32, "CancelIoEx"); + // Do something with it + if (pCancelIoEx) { + // Function exists so call it + // Cancel all pending IO Requests for the current device + pCancelIoEx(int2handle(fd), NULL); + } + if (!CloseHandle(int2handle(fd))) { + ErrorCodeToString("Closing connection (CloseHandle)", GetLastError(), errorString); + this->SetError(errorString); + return; + } +} + +wchar_t *copySubstring(wchar_t *someString, int n) { + wchar_t *new_ = reinterpret_cast(malloc(sizeof(wchar_t)*n + 1)); + wcsncpy_s(new_, n + 1, someString, n); + new_[n] = '\0'; + return new_; +} + +Napi::Value List(const Napi::CallbackInfo& info) { + Napi::Env env = info.Env(); + // callback + if (!info[0].IsFunction()) { + Napi::TypeError::New(env, "First argument must be a function").ThrowAsJavaScriptException(); + return env.Null(); + } + + Napi::Function callback = info[0].As(); + ListBaton* baton = new ListBaton(callback); + _snwprintf(baton->errorString, sizeof(baton->errorString), L""); + + baton->Queue(); + return env.Undefined(); +} + +// It's possible that the s/n is a construct and not the s/n of the parent USB +// composite device. This performs some convoluted registry lookups to fetch the USB s/n. +void getSerialNumber(const wchar_t *vid, + const wchar_t *pid, + const HDEVINFO hDevInfo, + SP_DEVINFO_DATA deviceInfoData, + const unsigned int maxSerialNumberLength, + wchar_t* serialNumber) { + _snwprintf_s(serialNumber, maxSerialNumberLength, _TRUNCATE, L""); + if (vid == NULL || pid == NULL) { + return; + } + + DWORD dwSize; + WCHAR szWUuidBuffer[MAX_BUFFER_SIZE]; + WCHAR wantedUuid[MAX_BUFFER_SIZE]; + + + // Fetch the "Container ID" for this device node. In USB context, this "Container + // ID" refers to the composite USB device, i.e. the USB device as a whole, not + // just one of its interfaces with a serial port driver attached. + + // From https://stackoverflow.com/questions/3438366/setupdigetdeviceproperty-usage-example: + // Because this is not compiled with UNICODE defined, the call to SetupDiGetDevicePropertyW + // has to be setup manually. + DEVPROPTYPE ulPropertyType; + typedef BOOL (WINAPI *FN_SetupDiGetDevicePropertyW)( + __in HDEVINFO DeviceInfoSet, + __in PSP_DEVINFO_DATA DeviceInfoData, + __in const DEVPROPKEY *PropertyKey, + __out DEVPROPTYPE *PropertyType, + __out_opt PBYTE PropertyBuffer, + __in DWORD PropertyBufferSize, + __out_opt PDWORD RequiredSize, + __in DWORD Flags); + + FN_SetupDiGetDevicePropertyW fn_SetupDiGetDevicePropertyW = (FN_SetupDiGetDevicePropertyW) + GetProcAddress(GetModuleHandle(TEXT("Setupapi.dll")), "SetupDiGetDevicePropertyW"); + + if (fn_SetupDiGetDevicePropertyW ( + hDevInfo, + &deviceInfoData, + &DEVPKEY_Device_ContainerId, + &ulPropertyType, + reinterpret_cast(szWUuidBuffer), + sizeof(szWUuidBuffer), + &dwSize, + 0)) { + szWUuidBuffer[dwSize] = '\0'; + + // Given the UUID bytes, build up a (widechar) string from it. There's some mangling + // going on. + StringFromGUID2((REFGUID)szWUuidBuffer, wantedUuid, ARRAY_SIZE(wantedUuid)); + } else { + // Container UUID could not be fetched, return empty serial number. + return; + } + + // NOTE: Devices might have a containerUuid like {00000000-0000-0000-FFFF-FFFFFFFFFFFF} + // This means they're non-removable, and are not handled (yet). + // Maybe they should inherit the s/n from somewhere else. + + // Iterate through all the USB devices with the given VendorID/ProductID + + HKEY vendorProductHKey; + DWORD retCode; + wchar_t hkeyPath[MAX_BUFFER_SIZE]; + + _snwprintf_s(hkeyPath, MAX_BUFFER_SIZE, _TRUNCATE, L"SYSTEM\\CurrentControlSet\\Enum\\USB\\VID_%s&PID_%s", vid, pid); + + retCode = RegOpenKeyExW( + HKEY_LOCAL_MACHINE, + hkeyPath, + 0, + KEY_READ, + &vendorProductHKey); + + if (retCode == ERROR_SUCCESS) { + DWORD serialNumbersCount = 0; // number of subkeys + + // Fetch how many subkeys there are for this VendorID/ProductID pair. + // That's the number of devices for this VendorID/ProductID known to this machine. + + retCode = RegQueryInfoKey( + vendorProductHKey, // hkey handle + NULL, // buffer for class name + NULL, // size of class string + NULL, // reserved + &serialNumbersCount, // number of subkeys + NULL, // longest subkey size + NULL, // longest class string + NULL, // number of values for this key + NULL, // longest value name + NULL, // longest value data + NULL, // security descriptor + NULL); // last write time + + if (retCode == ERROR_SUCCESS && serialNumbersCount > 0) { + for (unsigned int i=0; i < serialNumbersCount; i++) { + // Each of the subkeys here is the serial number of a USB device with the + // given VendorId/ProductId. Now fetch the string for the S/N. + DWORD serialNumberLength = maxSerialNumberLength; + retCode = RegEnumKeyExW(vendorProductHKey, + i, + reinterpret_cast(serialNumber), + &serialNumberLength, + NULL, + NULL, + NULL, + NULL); + + if (retCode == ERROR_SUCCESS) { + // Lookup info for VID_(vendorId)&PID_(productId)\(serialnumber) + + _snwprintf_s(hkeyPath, MAX_BUFFER_SIZE, _TRUNCATE, + L"SYSTEM\\CurrentControlSet\\Enum\\USB\\VID_%ls&PID_%ls\\%ls", + vid, pid, serialNumber); + + HKEY deviceHKey; + + if (RegOpenKeyExW(HKEY_LOCAL_MACHINE, hkeyPath, 0, KEY_READ, &deviceHKey) == ERROR_SUCCESS) { + wchar_t readUuid[MAX_BUFFER_SIZE]; + DWORD readSize = sizeof(readUuid); + + // Query VID_(vendorId)&PID_(productId)\(serialnumber)\ContainerID + retCode = RegQueryValueExW(deviceHKey, L"ContainerID", NULL, NULL, (LPBYTE)&readUuid, &readSize); + if (retCode == ERROR_SUCCESS) { + readUuid[readSize] = '\0'; + if (wcscmp(wantedUuid, readUuid) == 0) { + // The ContainerID UUIDs match, return now that serialNumber has + // the right value. + RegCloseKey(deviceHKey); + RegCloseKey(vendorProductHKey); + return; + } + } + } + RegCloseKey(deviceHKey); + } + } + } + + /* In case we did not obtain the path, for whatever reason, we close the key and return an empty string. */ + RegCloseKey(vendorProductHKey); + } + + _snwprintf_s(serialNumber, maxSerialNumberLength, _TRUNCATE, L""); + return; +} + +void ListBaton::Execute() { + + GUID *guidDev = (GUID*)& GUID_DEVCLASS_PORTS; // NOLINT + HDEVINFO hDevInfo = SetupDiGetClassDevs(guidDev, NULL, NULL, DIGCF_PRESENT | DIGCF_PROFILE); + SP_DEVINFO_DATA deviceInfoData; + + int memberIndex = 0; + DWORD dwSize, dwPropertyRegDataType; + wchar_t szBuffer[MAX_BUFFER_SIZE]; + wchar_t *pnpId; + wchar_t *vendorId; + wchar_t *productId; + wchar_t *name; + wchar_t *manufacturer; + wchar_t *locationId; + wchar_t *friendlyName; + wchar_t serialNumber[MAX_REGISTRY_KEY_SIZE]; + bool isCom; + while (true) { + isCom = false; + pnpId = NULL; + vendorId = NULL; + productId = NULL; + name = NULL; + manufacturer = NULL; + locationId = NULL; + friendlyName = NULL; + + ZeroMemory(&deviceInfoData, sizeof(SP_DEVINFO_DATA)); + deviceInfoData.cbSize = sizeof(SP_DEVINFO_DATA); + + if (SetupDiEnumDeviceInfo(hDevInfo, memberIndex, &deviceInfoData) == FALSE) { + if (GetLastError() == ERROR_NO_MORE_ITEMS) { + break; + } + } + + dwSize = sizeof(szBuffer); + SetupDiGetDeviceInstanceIdW(hDevInfo, &deviceInfoData, reinterpret_cast(szBuffer), dwSize, &dwSize); + szBuffer[dwSize] = '\0'; + pnpId = wcsdup(szBuffer); + + vendorId = wcsstr(szBuffer, L"VID_"); + if (vendorId) { + vendorId += 4; + vendorId = copySubstring(vendorId, 4); + } + productId = wcsstr(szBuffer, L"PID_"); + if (productId) { + productId += 4; + productId = copySubstring(productId, 4); + } + + getSerialNumber(vendorId, productId, hDevInfo, deviceInfoData, MAX_REGISTRY_KEY_SIZE, serialNumber); + + if (SetupDiGetDeviceRegistryPropertyW(hDevInfo, &deviceInfoData, + SPDRP_LOCATION_INFORMATION, &dwPropertyRegDataType, + reinterpret_cast(szBuffer), sizeof(szBuffer), &dwSize)) { + locationId = wcsdup(szBuffer); + } + if (SetupDiGetDeviceRegistryPropertyW(hDevInfo, &deviceInfoData, + SPDRP_FRIENDLYNAME, &dwPropertyRegDataType, + reinterpret_cast(szBuffer), sizeof(szBuffer), &dwSize)) { + friendlyName = wcsdup(szBuffer); + } + if (SetupDiGetDeviceRegistryPropertyW(hDevInfo, &deviceInfoData, + SPDRP_MFG, &dwPropertyRegDataType, + reinterpret_cast(szBuffer), sizeof(szBuffer), &dwSize)) { + manufacturer = wcsdup(szBuffer); + } + + HKEY hkey = SetupDiOpenDevRegKey(hDevInfo, &deviceInfoData, DICS_FLAG_GLOBAL, 0, DIREG_DEV, KEY_READ); + if (hkey != INVALID_HANDLE_VALUE) { + dwSize = sizeof(szBuffer); + if (RegQueryValueExW(hkey, L"PortName", NULL, NULL, (LPBYTE)&szBuffer, &dwSize) == ERROR_SUCCESS) { + name = wcsdup(szBuffer); + szBuffer[dwSize] = '\0'; + isCom = wcsstr(szBuffer, L"COM") != NULL; + } + } + if (isCom) { + ListResultItem* resultItem = new ListResultItem(); + resultItem->path = name; + resultItem->manufacturer = manufacturer; + resultItem->pnpId = pnpId; + if (vendorId) { + resultItem->vendorId = vendorId; + } + if (productId) { + resultItem->productId = productId; + } + resultItem->serialNumber = serialNumber; + if (locationId) { + resultItem->locationId = locationId; + } + if (friendlyName) { + resultItem->friendlyName = friendlyName; + } + results.push_back(resultItem); + } + free(pnpId); + free(vendorId); + free(productId); + free(locationId); + free(manufacturer); + free(name); + + RegCloseKey(hkey); + memberIndex++; + } + if (hDevInfo) { + SetupDiDestroyDeviceInfoList(hDevInfo); + } +} + +void setIfNotEmpty(Napi::Object item, std::string key, const char *value) { + Napi::Env env = item.Env(); + Napi::String v8key = Napi::String::New(env, key); + if (strlen(value) > 0) { + (item).Set(v8key, Napi::String::New(env, value)); + } else { + (item).Set(v8key, env.Undefined()); + } +} + +void setIfNotEmpty(Napi::Object item, std::string key, const wchar_t *value) { + Napi::Env env = item.Env(); + Napi::String v8key = Napi::String::New(env, key); + if (wcslen(value) > 0) { + (item).Set(v8key, Napi::String::New(env, (const char16_t*) value)); + } else { + (item).Set(v8key, env.Undefined()); + } +} + +void FlushBaton::Execute() { + DWORD purge_all = PURGE_RXCLEAR | PURGE_TXABORT | PURGE_TXCLEAR; + if (!PurgeComm(int2handle(fd), purge_all)) { + ErrorCodeToString("Flushing connection (PurgeComm)", GetLastError(), errorString); + this->SetError(errorString); + return; + } +} + +void DrainBaton::Execute() { + if (!FlushFileBuffers(int2handle(fd))) { + ErrorCodeToString("Draining connection (FlushFileBuffers)", GetLastError(), errorString); + this->SetError(errorString); + return; + } +} diff --git a/node_modules/@serialport/bindings-cpp/src/serialport_win.h b/node_modules/@serialport/bindings-cpp/src/serialport_win.h new file mode 100644 index 0000000..b535737 --- /dev/null +++ b/node_modules/@serialport/bindings-cpp/src/serialport_win.h @@ -0,0 +1,93 @@ +#ifndef PACKAGES_SERIALPORT_SRC_SERIALPORT_WIN_H_ +#define PACKAGES_SERIALPORT_SRC_SERIALPORT_WIN_H_ +#include +#include +#include +#include +#include + +#define ERROR_STRING_SIZE 1088 + +static inline HANDLE int2handle(int ptr) { + return reinterpret_cast(static_cast(ptr)); +} + +struct WriteBaton { + WriteBaton() : bufferData(), errorString() {} + int fd = 0; + char* bufferData = nullptr; + size_t bufferLength = 0; + size_t offset = 0; + size_t bytesWritten = 0; + void* hThread = nullptr; + bool complete = false; + Napi::ObjectReference buffer; + Napi::FunctionReference callback; + int result = 0; + char errorString[ERROR_STRING_SIZE]; +}; + +Napi::Value Write(const Napi::CallbackInfo& info); + +struct ReadBaton { + ReadBaton() : errorString() {} + int fd = 0; + char* bufferData = nullptr; + size_t bufferLength = 0; + size_t bytesRead = 0; + size_t bytesToRead = 0; + size_t offset = 0; + void* hThread = nullptr; + Napi::FunctionReference callback; + bool complete = false; + char errorString[ERROR_STRING_SIZE]; +}; + +Napi::Value Read(const Napi::CallbackInfo& info); + +Napi::Value List(const Napi::CallbackInfo& info); +void setIfNotEmpty(Napi::Object item, std::string key, const char *value); +void setIfNotEmpty(Napi::Object item, std::string key, const wchar_t *value); + +struct ListResultItem { + std::wstring path; + std::wstring manufacturer; + std::wstring serialNumber; + std::wstring pnpId; + std::wstring locationId; + std::wstring friendlyName; + std::wstring vendorId; + std::wstring productId; +}; + +struct ListBaton : public Napi::AsyncWorker { + ListBaton(Napi::Function& callback) : Napi::AsyncWorker(callback, "node-serialport:ListBaton"), + errorString() {} + std::list results; + wchar_t errorString[ERROR_STRING_SIZE]; + void Execute() override; + + void OnOK() override { + Napi::Env env = Env(); + Napi::HandleScope scope(env); + Napi::Array result = Napi::Array::New(env); + int i = 0; + for (std::list::iterator it = results.begin(); it != results.end(); ++it, i++) { + Napi::Object item = Napi::Object::New(env); + + setIfNotEmpty(item, "path", (*it)->path.c_str()); + setIfNotEmpty(item, "manufacturer", (*it)->manufacturer.c_str()); + setIfNotEmpty(item, "serialNumber", (*it)->serialNumber.c_str()); + setIfNotEmpty(item, "pnpId", (*it)->pnpId.c_str()); + setIfNotEmpty(item, "locationId", (*it)->locationId.c_str()); + setIfNotEmpty(item, "friendlyName", (*it)->friendlyName.c_str()); + setIfNotEmpty(item, "vendorId", (*it)->vendorId.c_str()); + setIfNotEmpty(item, "productId", (*it)->productId.c_str()); + + (result).Set(i, item); + } + Callback().Call({env.Null(), result}); + } +}; + +#endif // PACKAGES_SERIALPORT_SRC_SERIALPORT_WIN_H_ diff --git a/node_modules/@serialport/bindings-interface/CODE_OF_CONDUCT.md b/node_modules/@serialport/bindings-interface/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..2f54e01 --- /dev/null +++ b/node_modules/@serialport/bindings-interface/CODE_OF_CONDUCT.md @@ -0,0 +1,10 @@ +# Code of Conduct + +SerialPort follows the Nodebots Code of Conduct. The full text can be found at http://nodebots.io/conduct.html + +## TLDR +- Be respectful. +- Abusive behavior is never tolerated. +- Data published to NodeBots is hosted at the discretion of the service administrators, and may be removed. +- Don't build evil robots. +- Violations of this code may result in swift and permanent expulsion from the NodeBots community. diff --git a/node_modules/@serialport/bindings-interface/LICENSE b/node_modules/@serialport/bindings-interface/LICENSE new file mode 100644 index 0000000..c48c4ac --- /dev/null +++ b/node_modules/@serialport/bindings-interface/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2021 Francis Gulotta + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/node_modules/@serialport/bindings-interface/README.md b/node_modules/@serialport/bindings-interface/README.md new file mode 100644 index 0000000..2b330b0 --- /dev/null +++ b/node_modules/@serialport/bindings-interface/README.md @@ -0,0 +1,7 @@ +# @serialport/bindings-interface + +[![Release](https://github.com/serialport/bindings-interface/actions/workflows/test.yml/badge.svg)](https://github.com/serialport/bindings-interface/actions/workflows/test.yml) + +SerialPort Bindings Typescript Types. + +All issues should be filed on [the main node serialport repo](github.com/serialport/node-serialport/) diff --git a/node_modules/@serialport/bindings-interface/dist/index-esm.mjs b/node_modules/@serialport/bindings-interface/dist/index-esm.mjs new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/node_modules/@serialport/bindings-interface/dist/index-esm.mjs @@ -0,0 +1 @@ + diff --git a/node_modules/@serialport/bindings-interface/dist/index.d.ts b/node_modules/@serialport/bindings-interface/dist/index.d.ts new file mode 100644 index 0000000..8202341 --- /dev/null +++ b/node_modules/@serialport/bindings-interface/dist/index.d.ts @@ -0,0 +1,151 @@ +/// + +export declare interface BindingInterface { + /** + Retrieves a list of available serial ports with metadata. The `path` must be guaranteed, and all other fields should be undefined if unavailable. The `path` is either the path or an identifier (eg `COM1`) used to open the serialport. + */ + list(): Promise; + /** + * Opens a connection to the serial port referenced by the path. + */ + open(options: R): Promise; +} + +/** + * BindingPort objects are used to access the underlying hardware. This documentation is geared towards people who are making bindings for different platforms. This interface is implemented in all bindings. + */ +export declare interface BindingPortInterface { + readonly openOptions: Required; + /** + * Required property. `true` if the port is open, `false` otherwise. Read only. + */ + isOpen: boolean; + /** + * Closes an open port + */ + close(): Promise; + /** + Request a number of bytes from the SerialPort. This function is similar to Node's [`fs.read`](http://nodejs.org/api/fs.html#fs_fs_read_fd_buffer_offset_length_position_callback) as it will attempt to read up to `length` number of bytes. This function has a guarantee that it will always return at least one byte. This leverages os specific polling or async reads so you don't have to. + + The in progress reads must error when the port is closed with an error object that has the property `canceled` equal to `true`. Any other error will cause a disconnection. + + * @param buffer - The Buffer to read data into. + * @param offset - The offset in the buffer to start writing at. + * @param length - Specifies the maximum number of bytes to read. + * @returns Promise - Resolves with the number of bytes read after a read operation. + */ + read(buffer: Buffer, offset: number, length: number): Promise<{ + buffer: Buffer; + bytesRead: number; + }>; + /** + Write bytes to the SerialPort. Only called when there is no pending write operation. + + The in progress writes must error when the port is closed with an error object that has the property `canceled` equal to `true`. Any other error will cause a disconnection. + + Resolves after the data is passed to the operating system for writing. + */ + write(buffer: Buffer): Promise; + /** + Changes connection settings on an open port. + */ + update(options: UpdateOptions): Promise; + /** + * Set control flags on an open port. + * All options are operating system default when the port is opened. Every flag is set on each call to the provided or default values. + */ + set(options: SetOptions): Promise; + /** + * Get the control flags (CTS, DSR, DCD) on the open port. + */ + get(): Promise; + /** + * Get the OS reported baud rate for the open port. + * Used mostly for debugging custom baud rates. + */ + getBaudRate(): Promise<{ + baudRate: number; + }>; + /** + * Flush (discard) data received but not read, and written but not transmitted. + * Resolves once the flush operation finishes. + */ + flush(): Promise; + /** + * Drain waits until all output data is transmitted to the serial port. An in progress write should be completed before this returns. + * Resolves once the drain operation finishes. + */ + drain(): Promise; +} + +export declare interface BindingsErrorInterface extends Error { + canceled?: boolean; +} + +export declare interface OpenOptions { + /** The system path of the serial port you want to open. For example, `/dev/tty.XXX` on Mac/Linux, or `COM1` on Windows */ + path: string; + /** + * The baud rate of the port to be opened. This should match one of the commonly available baud rates, such as 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, or 115200. Custom rates are supported best effort per platform. The device connected to the serial port is not guaranteed to support the requested baud rate, even if the port itself supports that baud rate. + */ + baudRate: number; + /** Must be one of these: 5, 6, 7, or 8 defaults to 8 */ + dataBits?: 5 | 6 | 7 | 8; + /** Prevent other processes from opening the port. Windows does not currently support `false`. Defaults to true */ + lock?: boolean; + /** Must be 1, 1.5 or 2 defaults to 1 */ + stopBits?: 1 | 1.5 | 2; + parity?: string; + /** Flow control Setting. Defaults to false */ + rtscts?: boolean; + /** Flow control Setting. Defaults to false */ + xon?: boolean; + /** Flow control Setting. Defaults to false */ + xoff?: boolean; + /** Flow control Setting defaults to false*/ + xany?: boolean; + /** drop DTR on close. Defaults to true */ + hupcl?: boolean; +} + +export declare type OpenOptionsFromBinding = Binding extends BindingInterface ? T : never; + +/** + Serial port info with metadata. Only the `path` is guaranteed. If unavailable the other fields will be undefined. The `path` is either the path or an identifier (eg `COM1`) used to open the SerialPort. + + We make an effort to identify the hardware attached and have consistent results between systems. Linux and OS X are mostly consistent. Windows relies on 3rd party device drivers for the information and is unable to guarantee the information. On windows If you have a USB connected device can we provide a serial number otherwise it will be `undefined`. The `pnpId` and `locationId` are not the same or present on all systems. The examples below were run with the same Arduino Uno. + */ +export declare interface PortInfo { + path: string; + manufacturer: string | undefined; + serialNumber: string | undefined; + pnpId: string | undefined; + locationId: string | undefined; + productId: string | undefined; + vendorId: string | undefined; +} + +export declare type PortInfoFromBinding = Binding extends BindingInterface ? T : never; + +export declare type PortInterfaceFromBinding = Binding extends BindingInterface ? T : never; + +export declare interface PortStatus { + cts: boolean; + dsr: boolean; + dcd: boolean; +} + +export declare interface SetOptions { + brk?: boolean; + cts?: boolean; + dsr?: boolean; + dtr?: boolean; + rts?: boolean; +} + +export declare interface UpdateOptions { + /** If provided a baud rate that the bindings do not support, it should reject */ + baudRate: number; +} + +export { } diff --git a/node_modules/@serialport/bindings-interface/dist/index.js b/node_modules/@serialport/bindings-interface/dist/index.js new file mode 100644 index 0000000..eb109ab --- /dev/null +++ b/node_modules/@serialport/bindings-interface/dist/index.js @@ -0,0 +1,2 @@ +'use strict'; + diff --git a/node_modules/@serialport/bindings-interface/package.json b/node_modules/@serialport/bindings-interface/package.json new file mode 100644 index 0000000..1f46c41 --- /dev/null +++ b/node_modules/@serialport/bindings-interface/package.json @@ -0,0 +1,46 @@ +{ + "name": "@serialport/bindings-interface", + "version": "1.2.2", + "description": "SerialPort Bindings Typescript Types", + "types": "dist/index.d.ts", + "main": "./dist/index.js", + "exports": { + "require": "./dist/index.js", + "default": "./dist/index-esm.mjs" + }, + "publishConfig": { + "access": "public" + }, + "engines": { + "node": "^12.22 || ^14.13 || >=16" + }, + "repository": "git@github.com:serialport/bindings-interface.git", + "homepage": "https://github.com/serialport/bindings-interface", + "scripts": { + "lint": "tsc && eslint lib/**/*.ts", + "format": "eslint lib/**/*.ts --fix", + "clean": "rm -rf dist-ts dist", + "build": "npm run clean && tsc -p tsconfig-build.json && rollup -c && node -r esbuild-register bundle-types", + "prepublishOnly": "npm run build", + "semantic-release": "semantic-release" + }, + "keywords": [ + "serialport", + "serialport-binding" + ], + "license": "MIT", + "dependencies": {}, + "devDependencies": { + "@microsoft/api-extractor": "7.19.4", + "@types/node": "17.0.8", + "@typescript-eslint/eslint-plugin": "5.10.2", + "@typescript-eslint/parser": "5.10.2", + "esbuild": "0.14.18", + "esbuild-register": "3.3.2", + "eslint": "7.32.0", + "rollup": "2.67.0", + "rollup-plugin-node-resolve": "5.2.0", + "semantic-release": "19.0.2", + "typescript": "4.5.5" + } +} diff --git a/node_modules/@serialport/parser-byte-length/LICENSE b/node_modules/@serialport/parser-byte-length/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-byte-length/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-byte-length/README.md b/node_modules/@serialport/parser-byte-length/README.md new file mode 100644 index 0000000..b6536fd --- /dev/null +++ b/node_modules/@serialport/parser-byte-length/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-byte-length + +See our api docs https://serialport.io/docs/api-parser-byte-length diff --git a/node_modules/@serialport/parser-byte-length/dist/index.d.ts b/node_modules/@serialport/parser-byte-length/dist/index.d.ts new file mode 100644 index 0000000..5e1b8c9 --- /dev/null +++ b/node_modules/@serialport/parser-byte-length/dist/index.d.ts @@ -0,0 +1,20 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface ByteLengthOptions extends TransformOptions { + /** the number of bytes on each data event */ + length: number; +} +/** + * Emit data every number of bytes + * + * A transform stream that emits data as a buffer after a specific number of bytes are received. Runs in O(n) time. + */ +export declare class ByteLengthParser extends Transform { + length: number; + private position; + private buffer; + constructor(options: ByteLengthOptions); + _transform(chunk: Buffer, _encoding: BufferEncoding, cb: TransformCallback): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-byte-length/dist/index.js b/node_modules/@serialport/parser-byte-length/dist/index.js new file mode 100644 index 0000000..f26e4c4 --- /dev/null +++ b/node_modules/@serialport/parser-byte-length/dist/index.js @@ -0,0 +1,46 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.ByteLengthParser = void 0; +const stream_1 = require("stream"); +/** + * Emit data every number of bytes + * + * A transform stream that emits data as a buffer after a specific number of bytes are received. Runs in O(n) time. + */ +class ByteLengthParser extends stream_1.Transform { + length; + position; + buffer; + constructor(options) { + super(options); + if (typeof options.length !== 'number') { + throw new TypeError('"length" is not a number'); + } + if (options.length < 1) { + throw new TypeError('"length" is not greater than 0'); + } + this.length = options.length; + this.position = 0; + this.buffer = Buffer.alloc(this.length); + } + _transform(chunk, _encoding, cb) { + let cursor = 0; + while (cursor < chunk.length) { + this.buffer[this.position] = chunk[cursor]; + cursor++; + this.position++; + if (this.position === this.length) { + this.push(this.buffer); + this.buffer = Buffer.alloc(this.length); + this.position = 0; + } + } + cb(); + } + _flush(cb) { + this.push(this.buffer.slice(0, this.position)); + this.buffer = Buffer.alloc(this.length); + cb(); + } +} +exports.ByteLengthParser = ByteLengthParser; diff --git a/node_modules/@serialport/parser-byte-length/package.json b/node_modules/@serialport/parser-byte-length/package.json new file mode 100644 index 0000000..5ae4b7e --- /dev/null +++ b/node_modules/@serialport/parser-byte-length/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-byte-length", + "version": "12.0.0", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-cctalk/LICENSE b/node_modules/@serialport/parser-cctalk/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-cctalk/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-cctalk/README.md b/node_modules/@serialport/parser-cctalk/README.md new file mode 100644 index 0000000..e968e9d --- /dev/null +++ b/node_modules/@serialport/parser-cctalk/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-cctalk + +See our api docs https://serialport.io/docs/api-parser-cctalk diff --git a/node_modules/@serialport/parser-cctalk/dist/index.d.ts b/node_modules/@serialport/parser-cctalk/dist/index.d.ts new file mode 100644 index 0000000..88240b4 --- /dev/null +++ b/node_modules/@serialport/parser-cctalk/dist/index.d.ts @@ -0,0 +1,17 @@ +/// +/// +import { Transform, TransformCallback } from 'stream'; +/** + * Parse the CCTalk protocol + * @extends Transform + * + * A transform stream that emits CCTalk packets as they are received. + */ +export declare class CCTalkParser extends Transform { + array: number[]; + cursor: number; + lastByteFetchTime: number; + maxDelayBetweenBytesMs: number; + constructor(maxDelayBetweenBytesMs?: number); + _transform(buffer: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-cctalk/dist/index.js b/node_modules/@serialport/parser-cctalk/dist/index.js new file mode 100644 index 0000000..589dd6f --- /dev/null +++ b/node_modules/@serialport/parser-cctalk/dist/index.js @@ -0,0 +1,50 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.CCTalkParser = void 0; +const stream_1 = require("stream"); +/** + * Parse the CCTalk protocol + * @extends Transform + * + * A transform stream that emits CCTalk packets as they are received. + */ +class CCTalkParser extends stream_1.Transform { + array; + cursor; + lastByteFetchTime; + maxDelayBetweenBytesMs; + constructor(maxDelayBetweenBytesMs = 50) { + super(); + this.array = []; + this.cursor = 0; + this.lastByteFetchTime = 0; + this.maxDelayBetweenBytesMs = maxDelayBetweenBytesMs; + } + _transform(buffer, encoding, cb) { + if (this.maxDelayBetweenBytesMs > 0) { + const now = Date.now(); + if (now - this.lastByteFetchTime > this.maxDelayBetweenBytesMs) { + this.array = []; + this.cursor = 0; + } + this.lastByteFetchTime = now; + } + this.cursor += buffer.length; + // TODO: Better Faster es7 no supported by node 4 + // ES7 allows directly push [...buffer] + // this.array = this.array.concat(Array.from(buffer)) //Slower ?!? + Array.from(buffer).map(byte => this.array.push(byte)); + while (this.cursor > 1 && this.cursor >= this.array[1] + 5) { + // full frame accumulated + // copy command from the array + const FullMsgLength = this.array[1] + 5; + const frame = Buffer.from(this.array.slice(0, FullMsgLength)); + // Preserve Extra Data + this.array = this.array.slice(frame.length, this.array.length); + this.cursor -= FullMsgLength; + this.push(frame); + } + cb(); + } +} +exports.CCTalkParser = CCTalkParser; diff --git a/node_modules/@serialport/parser-cctalk/package.json b/node_modules/@serialport/parser-cctalk/package.json new file mode 100644 index 0000000..3169d4c --- /dev/null +++ b/node_modules/@serialport/parser-cctalk/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-cctalk", + "version": "12.0.0", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-delimiter/LICENSE b/node_modules/@serialport/parser-delimiter/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-delimiter/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-delimiter/README.md b/node_modules/@serialport/parser-delimiter/README.md new file mode 100644 index 0000000..55437e2 --- /dev/null +++ b/node_modules/@serialport/parser-delimiter/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-delimiter + +See our api docs https://serialport.io/docs/api-parser-delimiter diff --git a/node_modules/@serialport/parser-delimiter/dist/index.d.ts b/node_modules/@serialport/parser-delimiter/dist/index.d.ts new file mode 100644 index 0000000..33f361e --- /dev/null +++ b/node_modules/@serialport/parser-delimiter/dist/index.d.ts @@ -0,0 +1,23 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface DelimiterOptions extends TransformOptions { + /** The delimiter on which to split incoming data. */ + delimiter: string | Buffer | number[]; + /** Should the delimiter be included at the end of data. Defaults to `false` */ + includeDelimiter?: boolean; +} +/** + * A transform stream that emits data each time a byte sequence is received. + * @extends Transform + * + * To use the `Delimiter` parser, provide a delimiter as a string, buffer, or array of bytes. Runs in O(n) time. + */ +export declare class DelimiterParser extends Transform { + includeDelimiter: boolean; + delimiter: Buffer; + buffer: Buffer; + constructor({ delimiter, includeDelimiter, ...options }: DelimiterOptions); + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-delimiter/dist/index.js b/node_modules/@serialport/parser-delimiter/dist/index.js new file mode 100644 index 0000000..2d8c68e --- /dev/null +++ b/node_modules/@serialport/parser-delimiter/dist/index.js @@ -0,0 +1,43 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.DelimiterParser = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that emits data each time a byte sequence is received. + * @extends Transform + * + * To use the `Delimiter` parser, provide a delimiter as a string, buffer, or array of bytes. Runs in O(n) time. + */ +class DelimiterParser extends stream_1.Transform { + includeDelimiter; + delimiter; + buffer; + constructor({ delimiter, includeDelimiter = false, ...options }) { + super(options); + if (delimiter === undefined) { + throw new TypeError('"delimiter" is not a bufferable object'); + } + if (delimiter.length === 0) { + throw new TypeError('"delimiter" has a 0 or undefined length'); + } + this.includeDelimiter = includeDelimiter; + this.delimiter = Buffer.from(delimiter); + this.buffer = Buffer.alloc(0); + } + _transform(chunk, encoding, cb) { + let data = Buffer.concat([this.buffer, chunk]); + let position; + while ((position = data.indexOf(this.delimiter)) !== -1) { + this.push(data.slice(0, position + (this.includeDelimiter ? this.delimiter.length : 0))); + data = data.slice(position + this.delimiter.length); + } + this.buffer = data; + cb(); + } + _flush(cb) { + this.push(this.buffer); + this.buffer = Buffer.alloc(0); + cb(); + } +} +exports.DelimiterParser = DelimiterParser; diff --git a/node_modules/@serialport/parser-delimiter/package.json b/node_modules/@serialport/parser-delimiter/package.json new file mode 100644 index 0000000..6853c38 --- /dev/null +++ b/node_modules/@serialport/parser-delimiter/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-delimiter", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "version": "12.0.0", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-inter-byte-timeout/LICENSE b/node_modules/@serialport/parser-inter-byte-timeout/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-inter-byte-timeout/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-inter-byte-timeout/README.md b/node_modules/@serialport/parser-inter-byte-timeout/README.md new file mode 100644 index 0000000..576545e --- /dev/null +++ b/node_modules/@serialport/parser-inter-byte-timeout/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-inter-byte-timeout + +See our api docs https://serialport.io/docs/api-parser-inter-byte-timeout diff --git a/node_modules/@serialport/parser-inter-byte-timeout/dist/index.d.ts b/node_modules/@serialport/parser-inter-byte-timeout/dist/index.d.ts new file mode 100644 index 0000000..292dd8f --- /dev/null +++ b/node_modules/@serialport/parser-inter-byte-timeout/dist/index.d.ts @@ -0,0 +1,23 @@ +/// +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface InterByteTimeoutOptions extends TransformOptions { + /** the period of silence in milliseconds after which data is emitted */ + interval: number; + /** the maximum number of bytes after which data will be emitted. Defaults to 65536 */ + maxBufferSize?: number; +} +/** + * A transform stream that buffers data and emits it after not receiving any bytes for the specified amount of time or hitting a max buffer size. + */ +export declare class InterByteTimeoutParser extends Transform { + maxBufferSize: number; + currentPacket: number[]; + interval: number; + intervalID: NodeJS.Timeout | undefined; + constructor({ maxBufferSize, interval, ...transformOptions }: InterByteTimeoutOptions); + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; + emitPacket(): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-inter-byte-timeout/dist/index.js b/node_modules/@serialport/parser-inter-byte-timeout/dist/index.js new file mode 100644 index 0000000..9a34d59 --- /dev/null +++ b/node_modules/@serialport/parser-inter-byte-timeout/dist/index.js @@ -0,0 +1,61 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.InterByteTimeoutParser = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that buffers data and emits it after not receiving any bytes for the specified amount of time or hitting a max buffer size. + */ +class InterByteTimeoutParser extends stream_1.Transform { + maxBufferSize; + currentPacket; + interval; + intervalID; + constructor({ maxBufferSize = 65536, interval, ...transformOptions }) { + super(transformOptions); + if (!interval) { + throw new TypeError('"interval" is required'); + } + if (typeof interval !== 'number' || Number.isNaN(interval)) { + throw new TypeError('"interval" is not a number'); + } + if (interval < 1) { + throw new TypeError('"interval" is not greater than 0'); + } + if (typeof maxBufferSize !== 'number' || Number.isNaN(maxBufferSize)) { + throw new TypeError('"maxBufferSize" is not a number'); + } + if (maxBufferSize < 1) { + throw new TypeError('"maxBufferSize" is not greater than 0'); + } + this.maxBufferSize = maxBufferSize; + this.currentPacket = []; + this.interval = interval; + } + _transform(chunk, encoding, cb) { + if (this.intervalID) { + clearTimeout(this.intervalID); + } + for (let offset = 0; offset < chunk.length; offset++) { + this.currentPacket.push(chunk[offset]); + if (this.currentPacket.length >= this.maxBufferSize) { + this.emitPacket(); + } + } + this.intervalID = setTimeout(this.emitPacket.bind(this), this.interval); + cb(); + } + emitPacket() { + if (this.intervalID) { + clearTimeout(this.intervalID); + } + if (this.currentPacket.length > 0) { + this.push(Buffer.from(this.currentPacket)); + } + this.currentPacket = []; + } + _flush(cb) { + this.emitPacket(); + cb(); + } +} +exports.InterByteTimeoutParser = InterByteTimeoutParser; diff --git a/node_modules/@serialport/parser-inter-byte-timeout/package.json b/node_modules/@serialport/parser-inter-byte-timeout/package.json new file mode 100644 index 0000000..14f9722 --- /dev/null +++ b/node_modules/@serialport/parser-inter-byte-timeout/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-inter-byte-timeout", + "version": "12.0.0", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-packet-length/LICENSE b/node_modules/@serialport/parser-packet-length/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-packet-length/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-packet-length/README.md b/node_modules/@serialport/parser-packet-length/README.md new file mode 100644 index 0000000..22649fe --- /dev/null +++ b/node_modules/@serialport/parser-packet-length/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-packet-length + +The documentation at https://serialport.io/docs/api-parser-packet-length diff --git a/node_modules/@serialport/parser-packet-length/dist/index.d.ts b/node_modules/@serialport/parser-packet-length/dist/index.d.ts new file mode 100644 index 0000000..07a51ab --- /dev/null +++ b/node_modules/@serialport/parser-packet-length/dist/index.d.ts @@ -0,0 +1,42 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface PacketLengthOptions extends TransformOptions { + /** delimiter to use defaults to 0xaa */ + delimiter?: number; + /** overhead of packet (including length, delimiter and any checksum / packet footer) defaults to 2 */ + packetOverhead?: number; + /** number of bytes containing length defaults to 1 */ + lengthBytes?: number; + /** offset of length field defaults to 1 */ + lengthOffset?: number; + /** max packet length defaults to 0xff */ + maxLen?: number; +} +/** + * A transform stream that decodes packets with a delimiter and length of payload + * specified within the data stream. + * @extends Transform + * @summary Decodes packets of the general form: + * [delimiter][len][payload0] ... [payload0 + len] + * + * The length field can be up to 4 bytes and can be at any offset within the packet + * [delimiter][header0][header1][len0][len1[payload0] ... [payload0 + len] + * + * The offset and number of bytes of the length field need to be provided in options + * if not 1 byte immediately following the delimiter. + */ +export declare class PacketLengthParser extends Transform { + buffer: Buffer; + start: boolean; + opts: { + delimiter: number; + packetOverhead: number; + lengthBytes: number; + lengthOffset: number; + maxLen: number; + }; + constructor(options?: PacketLengthOptions); + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-packet-length/dist/index.js b/node_modules/@serialport/parser-packet-length/dist/index.js new file mode 100644 index 0000000..08d7ec5 --- /dev/null +++ b/node_modules/@serialport/parser-packet-length/dist/index.js @@ -0,0 +1,61 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.PacketLengthParser = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that decodes packets with a delimiter and length of payload + * specified within the data stream. + * @extends Transform + * @summary Decodes packets of the general form: + * [delimiter][len][payload0] ... [payload0 + len] + * + * The length field can be up to 4 bytes and can be at any offset within the packet + * [delimiter][header0][header1][len0][len1[payload0] ... [payload0 + len] + * + * The offset and number of bytes of the length field need to be provided in options + * if not 1 byte immediately following the delimiter. + */ +class PacketLengthParser extends stream_1.Transform { + buffer; + start; + opts; + constructor(options = {}) { + super(options); + const { delimiter = 0xaa, packetOverhead = 2, lengthBytes = 1, lengthOffset = 1, maxLen = 0xff } = options; + this.opts = { + delimiter, + packetOverhead, + lengthBytes, + lengthOffset, + maxLen, + }; + this.buffer = Buffer.alloc(0); + this.start = false; + } + _transform(chunk, encoding, cb) { + for (let ndx = 0; ndx < chunk.length; ndx++) { + const byte = chunk[ndx]; + if (byte === this.opts.delimiter) { + this.start = true; + } + if (true === this.start) { + this.buffer = Buffer.concat([this.buffer, Buffer.from([byte])]); + if (this.buffer.length >= this.opts.lengthOffset + this.opts.lengthBytes) { + const len = this.buffer.readUIntLE(this.opts.lengthOffset, this.opts.lengthBytes); + if (this.buffer.length == len + this.opts.packetOverhead || len > this.opts.maxLen) { + this.push(this.buffer); + this.buffer = Buffer.alloc(0); + this.start = false; + } + } + } + } + cb(); + } + _flush(cb) { + this.push(this.buffer); + this.buffer = Buffer.alloc(0); + cb(); + } +} +exports.PacketLengthParser = PacketLengthParser; diff --git a/node_modules/@serialport/parser-packet-length/package.json b/node_modules/@serialport/parser-packet-length/package.json new file mode 100644 index 0000000..6568e72 --- /dev/null +++ b/node_modules/@serialport/parser-packet-length/package.json @@ -0,0 +1,24 @@ +{ + "name": "@serialport/parser-packet-length", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "version": "12.0.0", + "engines": { + "node": ">=8.6.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-readline/LICENSE b/node_modules/@serialport/parser-readline/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-readline/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-readline/README.md b/node_modules/@serialport/parser-readline/README.md new file mode 100644 index 0000000..4c8677d --- /dev/null +++ b/node_modules/@serialport/parser-readline/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-readline + +See our api docs See our api docs https://serialport.io/docs/api-parser-readline diff --git a/node_modules/@serialport/parser-readline/dist/index.d.ts b/node_modules/@serialport/parser-readline/dist/index.d.ts new file mode 100644 index 0000000..a1f1b4a --- /dev/null +++ b/node_modules/@serialport/parser-readline/dist/index.d.ts @@ -0,0 +1,19 @@ +/// +/// +import { DelimiterParser } from '@serialport/parser-delimiter'; +import { TransformOptions } from 'stream'; +export interface ReadlineOptions extends TransformOptions { + /** delimiter to use defaults to \n */ + delimiter?: string | Buffer | number[]; + /** include the delimiter at the end of the packet defaults to false */ + includeDelimiter?: boolean; + /** Defaults to utf8 */ + encoding?: BufferEncoding; +} +/** + * A transform stream that emits data after a newline delimiter is received. + * @summary To use the `Readline` parser, provide a delimiter (defaults to `\n`). Data is emitted as string controllable by the `encoding` option (defaults to `utf8`). + */ +export declare class ReadlineParser extends DelimiterParser { + constructor(options?: ReadlineOptions); +} diff --git a/node_modules/@serialport/parser-readline/dist/index.js b/node_modules/@serialport/parser-readline/dist/index.js new file mode 100644 index 0000000..e2791b6 --- /dev/null +++ b/node_modules/@serialport/parser-readline/dist/index.js @@ -0,0 +1,22 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.ReadlineParser = void 0; +const parser_delimiter_1 = require("@serialport/parser-delimiter"); +/** + * A transform stream that emits data after a newline delimiter is received. + * @summary To use the `Readline` parser, provide a delimiter (defaults to `\n`). Data is emitted as string controllable by the `encoding` option (defaults to `utf8`). + */ +class ReadlineParser extends parser_delimiter_1.DelimiterParser { + constructor(options) { + const opts = { + delimiter: Buffer.from('\n', 'utf8'), + encoding: 'utf8', + ...options, + }; + if (typeof opts.delimiter === 'string') { + opts.delimiter = Buffer.from(opts.delimiter, opts.encoding); + } + super(opts); + } +} +exports.ReadlineParser = ReadlineParser; diff --git a/node_modules/@serialport/parser-readline/package.json b/node_modules/@serialport/parser-readline/package.json new file mode 100644 index 0000000..5ac68b6 --- /dev/null +++ b/node_modules/@serialport/parser-readline/package.json @@ -0,0 +1,28 @@ +{ + "name": "@serialport/parser-readline", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "version": "12.0.0", + "dependencies": { + "@serialport/parser-delimiter": "12.0.0" + }, + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-ready/LICENSE b/node_modules/@serialport/parser-ready/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-ready/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-ready/README.md b/node_modules/@serialport/parser-ready/README.md new file mode 100644 index 0000000..c5281d2 --- /dev/null +++ b/node_modules/@serialport/parser-ready/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-ready + +See our api docs https://serialport.io/docs/api-parser-ready diff --git a/node_modules/@serialport/parser-ready/dist/index.d.ts b/node_modules/@serialport/parser-ready/dist/index.d.ts new file mode 100644 index 0000000..1ac7684 --- /dev/null +++ b/node_modules/@serialport/parser-ready/dist/index.d.ts @@ -0,0 +1,19 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface ReadyParserOptions extends TransformOptions { + /** delimiter to use to detect the input is ready */ + delimiter: string | Buffer | number[]; +} +/** + * A transform stream that waits for a sequence of "ready" bytes before emitting a ready event and emitting data events + * + * To use the `Ready` parser provide a byte start sequence. After the bytes have been received a ready event is fired and data events are passed through. + */ +export declare class ReadyParser extends Transform { + delimiter: Buffer; + readOffset: number; + ready: boolean; + constructor({ delimiter, ...options }: ReadyParserOptions); + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-ready/dist/index.js b/node_modules/@serialport/parser-ready/dist/index.js new file mode 100644 index 0000000..d54afe4 --- /dev/null +++ b/node_modules/@serialport/parser-ready/dist/index.js @@ -0,0 +1,53 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.ReadyParser = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that waits for a sequence of "ready" bytes before emitting a ready event and emitting data events + * + * To use the `Ready` parser provide a byte start sequence. After the bytes have been received a ready event is fired and data events are passed through. + */ +class ReadyParser extends stream_1.Transform { + delimiter; + readOffset; + ready; + constructor({ delimiter, ...options }) { + if (delimiter === undefined) { + throw new TypeError('"delimiter" is not a bufferable object'); + } + if (delimiter.length === 0) { + throw new TypeError('"delimiter" has a 0 or undefined length'); + } + super(options); + this.delimiter = Buffer.from(delimiter); + this.readOffset = 0; + this.ready = false; + } + _transform(chunk, encoding, cb) { + if (this.ready) { + this.push(chunk); + return cb(); + } + const delimiter = this.delimiter; + let chunkOffset = 0; + while (this.readOffset < delimiter.length && chunkOffset < chunk.length) { + if (delimiter[this.readOffset] === chunk[chunkOffset]) { + this.readOffset++; + } + else { + this.readOffset = 0; + } + chunkOffset++; + } + if (this.readOffset === delimiter.length) { + this.ready = true; + this.emit('ready'); + const chunkRest = chunk.slice(chunkOffset); + if (chunkRest.length > 0) { + this.push(chunkRest); + } + } + cb(); + } +} +exports.ReadyParser = ReadyParser; diff --git a/node_modules/@serialport/parser-ready/package.json b/node_modules/@serialport/parser-ready/package.json new file mode 100644 index 0000000..f10cd83 --- /dev/null +++ b/node_modules/@serialport/parser-ready/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-ready", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "version": "12.0.0", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-regex/LICENSE b/node_modules/@serialport/parser-regex/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-regex/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-regex/README.md b/node_modules/@serialport/parser-regex/README.md new file mode 100644 index 0000000..6026d65 --- /dev/null +++ b/node_modules/@serialport/parser-regex/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-regex + +See our api docs https://serialport.io/docs/api-parser-regex diff --git a/node_modules/@serialport/parser-regex/dist/index.d.ts b/node_modules/@serialport/parser-regex/dist/index.d.ts new file mode 100644 index 0000000..5da0f06 --- /dev/null +++ b/node_modules/@serialport/parser-regex/dist/index.d.ts @@ -0,0 +1,21 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface RegexParserOptions extends TransformOptions { + /** The regular expression to use to split incoming text */ + regex: RegExp | string | Buffer; + /** Defaults to utf8 */ + encoding?: BufferEncoding; +} +/** + * A transform stream that uses a regular expression to split the incoming text upon. + * + * To use the `Regex` parser provide a regular expression to split the incoming text upon. Data is emitted as string controllable by the `encoding` option (defaults to `utf8`). + */ +export declare class RegexParser extends Transform { + regex: RegExp; + data: string; + constructor({ regex, ...options }: RegexParserOptions); + _transform(chunk: string, encoding: BufferEncoding, cb: TransformCallback): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-regex/dist/index.js b/node_modules/@serialport/parser-regex/dist/index.js new file mode 100644 index 0000000..0612405 --- /dev/null +++ b/node_modules/@serialport/parser-regex/dist/index.js @@ -0,0 +1,43 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.RegexParser = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that uses a regular expression to split the incoming text upon. + * + * To use the `Regex` parser provide a regular expression to split the incoming text upon. Data is emitted as string controllable by the `encoding` option (defaults to `utf8`). + */ +class RegexParser extends stream_1.Transform { + regex; + data; + constructor({ regex, ...options }) { + const opts = { + encoding: 'utf8', + ...options, + }; + if (regex === undefined) { + throw new TypeError('"options.regex" must be a regular expression pattern or object'); + } + if (!(regex instanceof RegExp)) { + regex = new RegExp(regex.toString()); + } + super(opts); + this.regex = regex; + this.data = ''; + } + _transform(chunk, encoding, cb) { + const data = this.data + chunk; + const parts = data.split(this.regex); + this.data = parts.pop() || ''; + parts.forEach(part => { + this.push(part); + }); + cb(); + } + _flush(cb) { + this.push(this.data); + this.data = ''; + cb(); + } +} +exports.RegexParser = RegexParser; diff --git a/node_modules/@serialport/parser-regex/package.json b/node_modules/@serialport/parser-regex/package.json new file mode 100644 index 0000000..af072a8 --- /dev/null +++ b/node_modules/@serialport/parser-regex/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-regex", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "version": "12.0.0", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-slip-encoder/LICENSE b/node_modules/@serialport/parser-slip-encoder/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-slip-encoder/README.md b/node_modules/@serialport/parser-slip-encoder/README.md new file mode 100644 index 0000000..8aa7a6b --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-slip-encoder + +See our api docs https://serialport.io/docs/api-parser-slip-encoder diff --git a/node_modules/@serialport/parser-slip-encoder/dist/decoder.d.ts b/node_modules/@serialport/parser-slip-encoder/dist/decoder.d.ts new file mode 100644 index 0000000..bae6da4 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/dist/decoder.d.ts @@ -0,0 +1,39 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface SlipDecoderOptions extends TransformOptions { + /** Custom start byte */ + START?: number; + /** Custom start escape byte */ + ESC_START?: number; + /** custom escape byte */ + ESC?: number; + /** custom end byte */ + END?: number; + /** custom escape end byte */ + ESC_END?: number; + /** custom escape escape byte */ + ESC_ESC?: number; +} +/** + * A transform stream that decodes slip encoded data. + * @extends Transform + * + * Runs in O(n) time, stripping out slip encoding and emitting decoded data. Optionally custom slip escape and delimiters can be provided. + */ +export declare class SlipDecoder extends Transform { + opts: { + START: number | undefined; + ESC: number; + END: number; + ESC_START: number | undefined; + ESC_END: number; + ESC_ESC: number; + }; + buffer: Buffer; + escape: boolean; + start: boolean; + constructor(options?: SlipDecoderOptions); + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-slip-encoder/dist/decoder.js b/node_modules/@serialport/parser-slip-encoder/dist/decoder.js new file mode 100644 index 0000000..4083253 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/dist/decoder.js @@ -0,0 +1,83 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.SlipDecoder = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that decodes slip encoded data. + * @extends Transform + * + * Runs in O(n) time, stripping out slip encoding and emitting decoded data. Optionally custom slip escape and delimiters can be provided. + */ +class SlipDecoder extends stream_1.Transform { + opts; + buffer; + escape; + start; + constructor(options = {}) { + super(options); + const { START, ESC = 0xdb, END = 0xc0, ESC_START, ESC_END = 0xdc, ESC_ESC = 0xdd } = options; + this.opts = { + START, + ESC, + END, + ESC_START, + ESC_END, + ESC_ESC, + }; + this.buffer = Buffer.alloc(0); + this.escape = false; + this.start = false; + } + _transform(chunk, encoding, cb) { + for (let ndx = 0; ndx < chunk.length; ndx++) { + let byte = chunk[ndx]; + if (byte === this.opts.START) { + this.start = true; + continue; + } + else if (undefined == this.opts.START) { + this.start = true; + } + if (this.escape) { + if (byte === this.opts.ESC_START && this.opts.START) { + byte = this.opts.START; + } + else if (byte === this.opts.ESC_ESC) { + byte = this.opts.ESC; + } + else if (byte === this.opts.ESC_END) { + byte = this.opts.END; + } + else { + this.escape = false; + this.push(this.buffer); + this.buffer = Buffer.alloc(0); + } + } + else { + if (byte === this.opts.ESC) { + this.escape = true; + continue; + } + if (byte === this.opts.END) { + this.push(this.buffer); + this.buffer = Buffer.alloc(0); + this.escape = false; + this.start = false; + continue; + } + } + this.escape = false; + if (this.start) { + this.buffer = Buffer.concat([this.buffer, Buffer.from([byte])]); + } + } + cb(); + } + _flush(cb) { + this.push(this.buffer); + this.buffer = Buffer.alloc(0); + cb(); + } +} +exports.SlipDecoder = SlipDecoder; diff --git a/node_modules/@serialport/parser-slip-encoder/dist/encoder.d.ts b/node_modules/@serialport/parser-slip-encoder/dist/encoder.d.ts new file mode 100644 index 0000000..ea3e847 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/dist/encoder.d.ts @@ -0,0 +1,38 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +export interface SlipEncoderOptions extends TransformOptions { + /** Custom start byte */ + START?: number; + /** Custom start escape byte */ + ESC_START?: number; + /** custom escape byte */ + ESC?: number; + /** custom end byte */ + END?: number; + /** custom escape end byte */ + ESC_END?: number; + /** custom escape escape byte */ + ESC_ESC?: number; + /** Adds an END character at the beginning of each packet per the Bluetooth Core Specification 4.0, Volume 4, Part D, Chapter 3 "SLIP Layer" and allowed by RFC 1055 */ + bluetoothQuirk?: boolean; +} +/** + * A transform stream that emits SLIP-encoded data for each incoming packet. + * + * Runs in O(n) time, adding a 0xC0 character at the end of each + * received packet and escaping characters, according to RFC 1055. + */ +export declare class SlipEncoder extends Transform { + opts: { + START: number | undefined; + ESC: number; + END: number; + ESC_START: number | undefined; + ESC_END: number; + ESC_ESC: number; + bluetoothQuirk: boolean; + }; + constructor(options?: SlipEncoderOptions); + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-slip-encoder/dist/encoder.js b/node_modules/@serialport/parser-slip-encoder/dist/encoder.js new file mode 100644 index 0000000..962cf63 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/dist/encoder.js @@ -0,0 +1,63 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.SlipEncoder = void 0; +const stream_1 = require("stream"); +/** + * A transform stream that emits SLIP-encoded data for each incoming packet. + * + * Runs in O(n) time, adding a 0xC0 character at the end of each + * received packet and escaping characters, according to RFC 1055. + */ +class SlipEncoder extends stream_1.Transform { + opts; + constructor(options = {}) { + super(options); + const { START, ESC = 0xdb, END = 0xc0, ESC_START, ESC_END = 0xdc, ESC_ESC = 0xdd, bluetoothQuirk = false } = options; + this.opts = { + START, + ESC, + END, + ESC_START, + ESC_END, + ESC_ESC, + bluetoothQuirk, + }; + } + _transform(chunk, encoding, cb) { + const chunkLength = chunk.length; + if (this.opts.bluetoothQuirk && chunkLength === 0) { + // Edge case: push no data. Bluetooth-quirky SLIP parsers don't like + // lots of 0xC0s together. + return cb(); + } + // Allocate memory for the worst-case scenario: all bytes are escaped, + // plus start and end separators. + const encoded = Buffer.alloc(chunkLength * 2 + 2); + let j = 0; + if (this.opts.bluetoothQuirk == true) { + encoded[j++] = this.opts.END; + } + if (this.opts.START !== undefined) { + encoded[j++] = this.opts.START; + } + for (let i = 0; i < chunkLength; i++) { + let byte = chunk[i]; + if (byte === this.opts.START && this.opts.ESC_START) { + encoded[j++] = this.opts.ESC; + byte = this.opts.ESC_START; + } + else if (byte === this.opts.END) { + encoded[j++] = this.opts.ESC; + byte = this.opts.ESC_END; + } + else if (byte === this.opts.ESC) { + encoded[j++] = this.opts.ESC; + byte = this.opts.ESC_ESC; + } + encoded[j++] = byte; + } + encoded[j++] = this.opts.END; + cb(null, encoded.slice(0, j)); + } +} +exports.SlipEncoder = SlipEncoder; diff --git a/node_modules/@serialport/parser-slip-encoder/dist/index.d.ts b/node_modules/@serialport/parser-slip-encoder/dist/index.d.ts new file mode 100644 index 0000000..8c64a60 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/dist/index.d.ts @@ -0,0 +1,2 @@ +export * from './decoder'; +export * from './encoder'; diff --git a/node_modules/@serialport/parser-slip-encoder/dist/index.js b/node_modules/@serialport/parser-slip-encoder/dist/index.js new file mode 100644 index 0000000..1a634c2 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/dist/index.js @@ -0,0 +1,18 @@ +"use strict"; +var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) { + if (k2 === undefined) k2 = k; + var desc = Object.getOwnPropertyDescriptor(m, k); + if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) { + desc = { enumerable: true, get: function() { return m[k]; } }; + } + Object.defineProperty(o, k2, desc); +}) : (function(o, m, k, k2) { + if (k2 === undefined) k2 = k; + o[k2] = m[k]; +})); +var __exportStar = (this && this.__exportStar) || function(m, exports) { + for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p); +}; +Object.defineProperty(exports, "__esModule", { value: true }); +__exportStar(require("./decoder"), exports); +__exportStar(require("./encoder"), exports); diff --git a/node_modules/@serialport/parser-slip-encoder/package.json b/node_modules/@serialport/parser-slip-encoder/package.json new file mode 100644 index 0000000..f779d97 --- /dev/null +++ b/node_modules/@serialport/parser-slip-encoder/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-slip-encoder", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "version": "12.0.0", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/parser-spacepacket/LICENSE b/node_modules/@serialport/parser-spacepacket/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/parser-spacepacket/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/parser-spacepacket/README.md b/node_modules/@serialport/parser-spacepacket/README.md new file mode 100644 index 0000000..a339ae4 --- /dev/null +++ b/node_modules/@serialport/parser-spacepacket/README.md @@ -0,0 +1,3 @@ +# @serialport/parser-spacepacket + +See our api docs https://serialport.io/docs/api-parser-spacepacket diff --git a/node_modules/@serialport/parser-spacepacket/dist/index.d.ts b/node_modules/@serialport/parser-spacepacket/dist/index.d.ts new file mode 100644 index 0000000..347e223 --- /dev/null +++ b/node_modules/@serialport/parser-spacepacket/dist/index.d.ts @@ -0,0 +1,50 @@ +/// +/// +import { Transform, TransformCallback, TransformOptions } from 'stream'; +import { SpacePacket, SpacePacketHeader } from './utils'; +export { SpacePacket, SpacePacketHeader }; +/** The optional configuration object, only needed if either of the two fields of the secondary header need their length defined */ +export interface SpacePacketOptions extends Omit { + /** The length of the Time Code Field in octets, if present */ + timeCodeFieldLength?: number; + /** The length of the Ancillary Data Field in octets, if present */ + ancillaryDataFieldLength?: number; +} +/** + * A Transform stream that accepts a stream of octet data and converts it into an object + * representation of a CCSDS Space Packet. See https://public.ccsds.org/Pubs/133x0b2e1.pdf for a + * description of the Space Packet format. + */ +export declare class SpacePacketParser extends Transform { + timeCodeFieldLength: number; + ancillaryDataFieldLength: number; + dataBuffer: Buffer; + headerBuffer: Buffer; + dataLength: number; + expectingHeader: boolean; + dataSlice: number; + header?: SpacePacketHeader; + /** + * A Transform stream that accepts a stream of octet data and emits object representations of + * CCSDS Space Packets once a packet has been completely received. + * @param {Object} [options] Configuration options for the stream + * @param {Number} options.timeCodeFieldLength The length of the time code field within the data + * @param {Number} options.ancillaryDataFieldLength The length of the ancillary data field within the data + */ + constructor(options?: SpacePacketOptions); + /** + * Bundle the header, secondary header if present, and the data into a JavaScript object to emit. + * If more data has been received past the current packet, begin the process of parsing the next + * packet(s). + */ + pushCompletedPacket(): void; + /** + * Build the Stream's headerBuffer property from the received Buffer chunk; extract data from it + * if it's complete. If there's more to the chunk than just the header, initiate handling the + * packet data. + * @param chunk - Build the Stream's headerBuffer property from + */ + extractHeader(chunk: Buffer): void; + _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void; + _flush(cb: TransformCallback): void; +} diff --git a/node_modules/@serialport/parser-spacepacket/dist/index.js b/node_modules/@serialport/parser-spacepacket/dist/index.js new file mode 100644 index 0000000..26e7729 --- /dev/null +++ b/node_modules/@serialport/parser-spacepacket/dist/index.js @@ -0,0 +1,124 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.SpacePacketParser = void 0; +const stream_1 = require("stream"); +const utils_1 = require("./utils"); +/** + * A Transform stream that accepts a stream of octet data and converts it into an object + * representation of a CCSDS Space Packet. See https://public.ccsds.org/Pubs/133x0b2e1.pdf for a + * description of the Space Packet format. + */ +class SpacePacketParser extends stream_1.Transform { + timeCodeFieldLength; + ancillaryDataFieldLength; + dataBuffer; + headerBuffer; + dataLength; + expectingHeader; + dataSlice; + header; + /** + * A Transform stream that accepts a stream of octet data and emits object representations of + * CCSDS Space Packets once a packet has been completely received. + * @param {Object} [options] Configuration options for the stream + * @param {Number} options.timeCodeFieldLength The length of the time code field within the data + * @param {Number} options.ancillaryDataFieldLength The length of the ancillary data field within the data + */ + constructor(options = {}) { + super({ ...options, objectMode: true }); + // Set the constants for this Space Packet Connection; these will help us parse incoming data + // fields: + this.timeCodeFieldLength = options.timeCodeFieldLength || 0; + this.ancillaryDataFieldLength = options.ancillaryDataFieldLength || 0; + this.dataSlice = this.timeCodeFieldLength + this.ancillaryDataFieldLength; + // These are stateful based on the current packet being received: + this.dataBuffer = Buffer.alloc(0); + this.headerBuffer = Buffer.alloc(0); + this.dataLength = 0; + this.expectingHeader = true; + } + /** + * Bundle the header, secondary header if present, and the data into a JavaScript object to emit. + * If more data has been received past the current packet, begin the process of parsing the next + * packet(s). + */ + pushCompletedPacket() { + if (!this.header) { + throw new Error('Missing header'); + } + const timeCode = Buffer.from(this.dataBuffer.slice(0, this.timeCodeFieldLength)); + const ancillaryData = Buffer.from(this.dataBuffer.slice(this.timeCodeFieldLength, this.timeCodeFieldLength + this.ancillaryDataFieldLength)); + const data = Buffer.from(this.dataBuffer.slice(this.dataSlice, this.dataLength)); + const completedPacket = { + header: { ...this.header }, + data: data.toString(), + }; + if (timeCode.length > 0 || ancillaryData.length > 0) { + completedPacket.secondaryHeader = {}; + if (timeCode.length) { + completedPacket.secondaryHeader.timeCode = timeCode.toString(); + } + if (ancillaryData.length) { + completedPacket.secondaryHeader.ancillaryData = ancillaryData.toString(); + } + } + this.push(completedPacket); + // If there is an overflow (i.e. we have more data than the packet we just pushed) begin parsing + // the next packet. + const nextChunk = Buffer.from(this.dataBuffer.slice(this.dataLength)); + if (nextChunk.length >= utils_1.HEADER_LENGTH) { + this.extractHeader(nextChunk); + } + else { + this.headerBuffer = nextChunk; + this.dataBuffer = Buffer.alloc(0); + this.expectingHeader = true; + this.dataLength = 0; + this.header = undefined; + } + } + /** + * Build the Stream's headerBuffer property from the received Buffer chunk; extract data from it + * if it's complete. If there's more to the chunk than just the header, initiate handling the + * packet data. + * @param chunk - Build the Stream's headerBuffer property from + */ + extractHeader(chunk) { + const headerAsBuffer = Buffer.concat([this.headerBuffer, chunk]); + const startOfDataBuffer = headerAsBuffer.slice(utils_1.HEADER_LENGTH); + if (headerAsBuffer.length >= utils_1.HEADER_LENGTH) { + this.header = (0, utils_1.convertHeaderBufferToObj)(headerAsBuffer); + this.dataLength = this.header.dataLength; + this.headerBuffer = Buffer.alloc(0); + this.expectingHeader = false; + } + else { + this.headerBuffer = headerAsBuffer; + } + if (startOfDataBuffer.length > 0) { + this.dataBuffer = Buffer.from(startOfDataBuffer); + if (this.dataBuffer.length >= this.dataLength) { + this.pushCompletedPacket(); + } + } + } + _transform(chunk, encoding, cb) { + if (this.expectingHeader) { + this.extractHeader(chunk); + } + else { + this.dataBuffer = Buffer.concat([this.dataBuffer, chunk]); + if (this.dataBuffer.length >= this.dataLength) { + this.pushCompletedPacket(); + } + } + cb(); + } + _flush(cb) { + const remaining = Buffer.concat([this.headerBuffer, this.dataBuffer]); + const remainingArray = Array.from(remaining); + this.push(remainingArray); + cb(); + } +} +exports.SpacePacketParser = SpacePacketParser; diff --git a/node_modules/@serialport/parser-spacepacket/dist/utils.d.ts b/node_modules/@serialport/parser-spacepacket/dist/utils.d.ts new file mode 100644 index 0000000..bc7a314 --- /dev/null +++ b/node_modules/@serialport/parser-spacepacket/dist/utils.d.ts @@ -0,0 +1,28 @@ +export declare const HEADER_LENGTH = 6; +export interface SpacePacketHeader { + versionNumber: string | number; + identification: { + apid: number; + secondaryHeader: number; + type: number; + }; + sequenceControl: { + packetName: number; + sequenceFlags: number; + }; + dataLength: number; +} +export interface SpacePacket { + header: SpacePacketHeader; + secondaryHeader?: { + timeCode?: string; + ancillaryData?: string; + }; + data: string; +} +/** + * Converts a Buffer of any length to an Object representation of a Space Packet header, provided + * the received data is in the correct format. + * @param buf - The buffer containing the Space Packet Header Data + */ +export declare const convertHeaderBufferToObj: (buf: Buffer) => SpacePacketHeader; diff --git a/node_modules/@serialport/parser-spacepacket/dist/utils.js b/node_modules/@serialport/parser-spacepacket/dist/utils.js new file mode 100644 index 0000000..daada67 --- /dev/null +++ b/node_modules/@serialport/parser-spacepacket/dist/utils.js @@ -0,0 +1,44 @@ +"use strict"; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.convertHeaderBufferToObj = exports.HEADER_LENGTH = void 0; +exports.HEADER_LENGTH = 6; +/** + * For numbers less than 255, will ensure that their string representation is at least 8 characters long. + */ +const toOctetStr = (num) => { + let str = Number(num).toString(2); + while (str.length < 8) { + str = `0${str}`; + } + return str; +}; +/** + * Converts a Buffer of any length to an Object representation of a Space Packet header, provided + * the received data is in the correct format. + * @param buf - The buffer containing the Space Packet Header Data + */ +const convertHeaderBufferToObj = (buf) => { + const headerStr = Array.from(buf.slice(0, exports.HEADER_LENGTH)).reduce((accum, curr) => `${accum}${toOctetStr(curr)}`, ''); + const isVersion1 = headerStr.slice(0, 3) === '000'; + const versionNumber = isVersion1 ? 1 : 'UNKNOWN_VERSION'; + const type = Number(headerStr[3]); + const secondaryHeader = Number(headerStr[4]); + const apid = parseInt(headerStr.slice(5, 16), 2); + const sequenceFlags = parseInt(headerStr.slice(16, 18), 2); + const packetName = parseInt(headerStr.slice(18, 32), 2); + const dataLength = parseInt(headerStr.slice(-16), 2) + 1; + return { + versionNumber, + identification: { + apid, + secondaryHeader, + type, + }, + sequenceControl: { + packetName, + sequenceFlags, + }, + dataLength, + }; +}; +exports.convertHeaderBufferToObj = convertHeaderBufferToObj; diff --git a/node_modules/@serialport/parser-spacepacket/package.json b/node_modules/@serialport/parser-spacepacket/package.json new file mode 100644 index 0000000..360466e --- /dev/null +++ b/node_modules/@serialport/parser-spacepacket/package.json @@ -0,0 +1,25 @@ +{ + "name": "@serialport/parser-spacepacket", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "version": "12.0.0", + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "devDependencies": { + "typescript": "5.2.2" + }, + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/@serialport/stream/LICENSE b/node_modules/@serialport/stream/LICENSE new file mode 100644 index 0000000..800d776 --- /dev/null +++ b/node_modules/@serialport/stream/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright 2010 Christopher Williams. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/node_modules/@serialport/stream/README.md b/node_modules/@serialport/stream/README.md new file mode 100644 index 0000000..6ee9c78 --- /dev/null +++ b/node_modules/@serialport/stream/README.md @@ -0,0 +1,16 @@ +# @serialport/stream + +The serialport stream interface. This package requires bindings to work. + +You'd use this if you want to keep your package size down by requiring only the parts of serialport that you want to use. It is used internally in the `serialport` package. + +This is how you use it. + +```ts +const { SerialPortStream } = require('@serialport/stream') +const { autoDetect } = require('@serialport/bindings-cpp') +const binding = autoDetect() +const port = new SerialPortStream({ binding, path: '/dev/ttyay', baudRate: 9600 }) +``` + +Learn more at our [stream documentation](https://serialport.io/docs/api-stream) page. diff --git a/node_modules/@serialport/stream/dist/index.d.ts b/node_modules/@serialport/stream/dist/index.d.ts new file mode 100644 index 0000000..0ef9683 --- /dev/null +++ b/node_modules/@serialport/stream/dist/index.d.ts @@ -0,0 +1,179 @@ +/// +/// +import { Duplex } from 'stream'; +import { SetOptions, BindingInterface, PortInterfaceFromBinding, OpenOptionsFromBinding } from '@serialport/bindings-interface'; +export declare class DisconnectedError extends Error { + disconnected: true; + constructor(message: string); +} +interface InternalSettings { + binding: T; + autoOpen: boolean; + endOnClose: boolean; + highWaterMark: number; +} +/** + * A callback called with an error or an object with the modem line values (cts, dsr, dcd). + */ +export type ErrorCallback = (err: Error | null) => void; +export type ModemBitsCallback = (err: Error | null, options?: { + cts: boolean; + dsr: boolean; + dcd: boolean; +}) => void; +export type OpenOptions = StreamOptions & OpenOptionsFromBinding; +/** + * Options to open a port + */ +export interface StreamOptions { + /** + * The hardware access binding. `Bindings` are how Node-Serialport talks to the underlying system. If you're using the `serialport` package, this defaults to `'@serialport/bindings-cpp'` which auto detects Windows (`WindowsBinding`), Linux (`LinuxBinding`) and OS X (`DarwinBinding`) and load the appropriate module for your system. + */ + binding: T; + /** Automatically opens the port defaults to true*/ + autoOpen?: boolean; + /** + * The size of the read and write buffers defaults to 64k + */ + highWaterMark?: number; + /** + * Emit 'end' on port close defaults false + */ + endOnClose?: boolean; +} +export declare class SerialPortStream extends Duplex { + port?: PortInterfaceFromBinding; + private _pool; + private _kMinPoolSpace; + opening: boolean; + closing: boolean; + readonly settings: InternalSettings & OpenOptionsFromBinding; + /** + * Create a new serial port object for the `path`. In the case of invalid arguments or invalid options, when constructing a new SerialPort it will throw an error. The port will open automatically by default, which is the equivalent of calling `port.open(openCallback)` in the next tick. You can disable this by setting the option `autoOpen` to `false`. + * @emits open + * @emits data + * @emits close + * @emits error + */ + constructor(options: OpenOptions, openCallback?: ErrorCallback); + get path(): string; + get baudRate(): number; + get isOpen(): boolean; + private _error; + private _asyncError; + /** + * Opens a connection to the given serial port. + * @param {ErrorCallback=} openCallback - Called after a connection is opened. If this is not provided and an error occurs, it will be emitted on the port's `error` event. + * @emits open + */ + open(openCallback?: ErrorCallback): void; + /** + * Changes the baud rate for an open port. Emits an error or calls the callback if the baud rate isn't supported. + * @param {object=} options Only supports `baudRate`. + * @param {number=} [options.baudRate] The baud rate of the port to be opened. This should match one of the commonly available baud rates, such as 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, or 115200. Custom rates are supported best effort per platform. The device connected to the serial port is not guaranteed to support the requested baud rate, even if the port itself supports that baud rate. + * @param {ErrorCallback=} [callback] Called once the port's baud rate changes. If `.update` is called without a callback, and there is an error, an error event is emitted. + * @returns {undefined} + */ + update(options: { + baudRate: number; + }, callback?: ErrorCallback): void; + /** + * Writes data to the given serial port. Buffers written data if the port is not open. + + The write operation is non-blocking. When it returns, data might still not have been written to the serial port. See `drain()`. + + Some devices, like the Arduino, reset when you open a connection to them. In such cases, immediately writing to the device will cause lost data as they wont be ready to receive the data. This is often worked around by having the Arduino send a "ready" byte that your Node program waits for before writing. You can also often get away with waiting around 400ms. + + If a port is disconnected during a write, the write will error in addition to the `close` event. + + From the [stream docs](https://nodejs.org/api/stream.html#stream_writable_write_chunk_encoding_callback) write errors don't always provide the error in the callback, sometimes they use the error event. + > If an error occurs, the callback may or may not be called with the error as its first argument. To reliably detect write errors, add a listener for the 'error' event. + + In addition to the usual `stream.write` arguments (`String` and `Buffer`), `write()` can accept arrays of bytes (positive numbers under 256) which is passed to `Buffer.from([])` for conversion. This extra functionality is pretty sweet. + + * @param {(string|array|buffer)} data Accepts a [`Buffer`](http://nodejs.org/api/buffer.html) object, or a type that is accepted by the `Buffer.from` method (e.g. an array of bytes or a string). + * @param {string=} encoding The encoding, if chunk is a string. Defaults to `'utf8'`. Also accepts `'ascii'`, `'base64'`, `'binary'`, and `'hex'` See [Buffers and Character Encodings](https://nodejs.org/api/buffer.html#buffer_buffers_and_character_encodings) for all available options. + * @param {function=} errorCallback Called once the write operation finishes. Data may not yet be flushed to the underlying port. No optional Error. + * @returns {boolean} `false` if the stream wishes for the calling code to wait for the `'drain'` event to be emitted before continuing to write additional data; otherwise `true`. + */ + write(chunk: any, encoding?: BufferEncoding, cb?: (error: Error | null | undefined) => void): boolean; + write(chunk: any, cb?: (error: Error | null | undefined) => void): boolean; + _write(data: Buffer, encoding: BufferEncoding | undefined, callback: (error: Error | null) => void): void; + _writev(data: Array<{ + chunk: Buffer; + encoding: BufferEncoding; + }>, callback: ErrorCallback): void; + _read(bytesToRead: number): void; + _disconnected(err: Error): void; + /** + * Closes an open connection. + * + * If there are in progress writes when the port is closed the writes will error. + * @param {ErrorCallback} callback Called once a connection is closed. + * @param {Error} disconnectError used internally to propagate a disconnect error + */ + close(callback?: ErrorCallback | undefined, disconnectError?: Error | null): void; + /** + * Set control flags on an open port. Uses [`SetCommMask`](https://msdn.microsoft.com/en-us/library/windows/desktop/aa363257(v=vs.85).aspx) for Windows and [`ioctl`](http://linux.die.net/man/4/tty_ioctl) for OS X and Linux. + * + * All options are operating system default when the port is opened. Every flag is set on each call to the provided or default values. If options isn't provided default options is used. + */ + set(options: SetOptions, callback?: ErrorCallback): void; + /** + * Returns the control flags (CTS, DSR, DCD) on the open port. + * Uses [`GetCommModemStatus`](https://msdn.microsoft.com/en-us/library/windows/desktop/aa363258(v=vs.85).aspx) for Windows and [`ioctl`](http://linux.die.net/man/4/tty_ioctl) for mac and linux. + */ + get(callback: ModemBitsCallback): void; + /** + * Flush discards data received but not read, and written but not transmitted by the operating system. For more technical details, see [`tcflush(fd, TCIOFLUSH)`](http://linux.die.net/man/3/tcflush) for Mac/Linux and [`FlushFileBuffers`](http://msdn.microsoft.com/en-us/library/windows/desktop/aa364439) for Windows. + */ + flush(callback?: ErrorCallback): void; + /** + * Waits until all output data is transmitted to the serial port. After any pending write has completed it calls [`tcdrain()`](http://linux.die.net/man/3/tcdrain) or [FlushFileBuffers()](https://msdn.microsoft.com/en-us/library/windows/desktop/aa364439(v=vs.85).aspx) to ensure it has been written to the device. + * @example + Write the `data` and wait until it has finished transmitting to the target serial port before calling the callback. This will queue until the port is open and writes are finished. + + ```js + function writeAndDrain (data, callback) { + port.write(data); + port.drain(callback); + } + ``` + */ + drain(callback?: ErrorCallback): void; +} +export {}; +/** + * The `error` event's callback is called with an error object whenever there is an error. + * @event error + */ +/** + * The `open` event's callback is called with no arguments when the port is opened and ready for writing. This happens if you have the constructor open immediately (which opens in the next tick) or if you open the port manually with `open()`. See [Useage/Opening a Port](#opening-a-port) for more information. + * @event open + */ +/** + * Request a number of bytes from the SerialPort. The `read()` method pulls some data out of the internal buffer and returns it. If no data is available to be read, null is returned. By default, the data is returned as a `Buffer` object unless an encoding has been specified using the `.setEncoding()` method. + * @method SerialPort.prototype.read + * @param {number=} size Specify how many bytes of data to return, if available + * @returns {(string|Buffer|null)} The data from internal buffers + */ +/** + * Listening for the `data` event puts the port in flowing mode. Data is emitted as soon as it's received. Data is a `Buffer` object with a varying amount of data in it. The `readLine` parser converts the data into string lines. See the [parsers](https://serialport.io/docs/api-parsers-overview) section for more information on parsers, and the [Node.js stream documentation](https://nodejs.org/api/stream.html#stream_event_data) for more information on the data event. + * @event data + */ +/** + * The `close` event's callback is called with no arguments when the port is closed. In the case of a disconnect it will be called with a Disconnect Error object (`err.disconnected == true`). In the event of a close error (unlikely), an error event is triggered. + * @event close + */ +/** + * The `pause()` method causes a stream in flowing mode to stop emitting 'data' events, switching out of flowing mode. Any data that becomes available remains in the internal buffer. + * @method SerialPort.prototype.pause + * @see resume + * @returns `this` + */ +/** + * The `resume()` method causes an explicitly paused, `Readable` stream to resume emitting 'data' events, switching the stream into flowing mode. + * @method SerialPort.prototype.resume + * @see pause + * @returns `this` + */ diff --git a/node_modules/@serialport/stream/dist/index.js b/node_modules/@serialport/stream/dist/index.js new file mode 100644 index 0000000..3bb9e23 --- /dev/null +++ b/node_modules/@serialport/stream/dist/index.js @@ -0,0 +1,380 @@ +"use strict"; +var __importDefault = (this && this.__importDefault) || function (mod) { + return (mod && mod.__esModule) ? mod : { "default": mod }; +}; +Object.defineProperty(exports, "__esModule", { value: true }); +exports.SerialPortStream = exports.DisconnectedError = void 0; +const stream_1 = require("stream"); +const debug_1 = __importDefault(require("debug")); +const debug = (0, debug_1.default)('serialport/stream'); +class DisconnectedError extends Error { + disconnected; + constructor(message) { + super(message); + this.disconnected = true; + } +} +exports.DisconnectedError = DisconnectedError; +const defaultSetFlags = { + brk: false, + cts: false, + dtr: true, + rts: true, +}; +function allocNewReadPool(poolSize) { + const pool = Buffer.allocUnsafe(poolSize); + pool.used = 0; + return pool; +} +class SerialPortStream extends stream_1.Duplex { + port; + _pool; + _kMinPoolSpace; + opening; + closing; + settings; + /** + * Create a new serial port object for the `path`. In the case of invalid arguments or invalid options, when constructing a new SerialPort it will throw an error. The port will open automatically by default, which is the equivalent of calling `port.open(openCallback)` in the next tick. You can disable this by setting the option `autoOpen` to `false`. + * @emits open + * @emits data + * @emits close + * @emits error + */ + constructor(options, openCallback) { + const settings = { + autoOpen: true, + endOnClose: false, + highWaterMark: 64 * 1024, + ...options, + }; + super({ + highWaterMark: settings.highWaterMark, + }); + if (!settings.binding) { + throw new TypeError('"Bindings" is invalid pass it as `options.binding`'); + } + if (!settings.path) { + throw new TypeError(`"path" is not defined: ${settings.path}`); + } + if (typeof settings.baudRate !== 'number') { + throw new TypeError(`"baudRate" must be a number: ${settings.baudRate}`); + } + this.settings = settings; + this.opening = false; + this.closing = false; + this._pool = allocNewReadPool(this.settings.highWaterMark); + this._kMinPoolSpace = 128; + if (this.settings.autoOpen) { + this.open(openCallback); + } + } + get path() { + return this.settings.path; + } + get baudRate() { + return this.settings.baudRate; + } + get isOpen() { + return (this.port?.isOpen ?? false) && !this.closing; + } + _error(error, callback) { + if (callback) { + callback.call(this, error); + } + else { + this.emit('error', error); + } + } + _asyncError(error, callback) { + process.nextTick(() => this._error(error, callback)); + } + /** + * Opens a connection to the given serial port. + * @param {ErrorCallback=} openCallback - Called after a connection is opened. If this is not provided and an error occurs, it will be emitted on the port's `error` event. + * @emits open + */ + open(openCallback) { + if (this.isOpen) { + return this._asyncError(new Error('Port is already open'), openCallback); + } + if (this.opening) { + return this._asyncError(new Error('Port is opening'), openCallback); + } + // eslint-disable-next-line @typescript-eslint/no-unused-vars + const { highWaterMark, binding, autoOpen, endOnClose, ...openOptions } = this.settings; + this.opening = true; + debug('opening', `path: ${this.path}`); + this.settings.binding.open(openOptions).then(port => { + debug('opened', `path: ${this.path}`); + this.port = port; + this.opening = false; + this.emit('open'); + if (openCallback) { + openCallback.call(this, null); + } + }, err => { + this.opening = false; + debug('Binding #open had an error', err); + this._error(err, openCallback); + }); + } + /** + * Changes the baud rate for an open port. Emits an error or calls the callback if the baud rate isn't supported. + * @param {object=} options Only supports `baudRate`. + * @param {number=} [options.baudRate] The baud rate of the port to be opened. This should match one of the commonly available baud rates, such as 110, 300, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, or 115200. Custom rates are supported best effort per platform. The device connected to the serial port is not guaranteed to support the requested baud rate, even if the port itself supports that baud rate. + * @param {ErrorCallback=} [callback] Called once the port's baud rate changes. If `.update` is called without a callback, and there is an error, an error event is emitted. + * @returns {undefined} + */ + update(options, callback) { + if (!this.isOpen || !this.port) { + debug('update attempted, but port is not open'); + return this._asyncError(new Error('Port is not open'), callback); + } + debug('update', `baudRate: ${options.baudRate}`); + this.port.update(options).then(() => { + debug('binding.update', 'finished'); + this.settings.baudRate = options.baudRate; + if (callback) { + callback.call(this, null); + } + }, err => { + debug('binding.update', 'error', err); + return this._error(err, callback); + }); + } + write(data, encoding, callback) { + if (Array.isArray(data)) { + data = Buffer.from(data); + } + if (typeof encoding === 'function') { + return super.write(data, encoding); + } + return super.write(data, encoding, callback); + } + _write(data, encoding, callback) { + if (!this.isOpen || !this.port) { + this.once('open', () => { + this._write(data, encoding, callback); + }); + return; + } + debug('_write', `${data.length} bytes of data`); + this.port.write(data).then(() => { + debug('binding.write', 'write finished'); + callback(null); + }, err => { + debug('binding.write', 'error', err); + if (!err.canceled) { + this._disconnected(err); + } + callback(err); + }); + } + _writev(data, callback) { + debug('_writev', `${data.length} chunks of data`); + const dataV = data.map(write => write.chunk); + this._write(Buffer.concat(dataV), undefined, callback); + } + _read(bytesToRead) { + if (!this.isOpen || !this.port) { + debug('_read', 'queueing _read for after open'); + this.once('open', () => { + this._read(bytesToRead); + }); + return; + } + if (!this._pool || this._pool.length - this._pool.used < this._kMinPoolSpace) { + debug('_read', 'discarding the read buffer pool because it is below kMinPoolSpace'); + this._pool = allocNewReadPool(this.settings.highWaterMark); + } + // Grab another reference to the pool in the case that while we're + // in the thread pool another read() finishes up the pool, and + // allocates a new one. + const pool = this._pool; + // Read the smaller of rest of the pool or however many bytes we want + const toRead = Math.min(pool.length - pool.used, bytesToRead); + const start = pool.used; + // the actual read. + debug('_read', `reading`, { start, toRead }); + this.port.read(pool, start, toRead).then(({ bytesRead }) => { + debug('binding.read', `finished`, { bytesRead }); + // zero bytes means read means we've hit EOF? Maybe this should be an error + if (bytesRead === 0) { + debug('binding.read', 'Zero bytes read closing readable stream'); + this.push(null); + return; + } + pool.used += bytesRead; + this.push(pool.slice(start, start + bytesRead)); + }, err => { + debug('binding.read', `error`, err); + if (!err.canceled) { + this._disconnected(err); + } + this._read(bytesToRead); // prime to read more once we're reconnected + }); + } + _disconnected(err) { + if (!this.isOpen) { + debug('disconnected aborted because already closed', err); + return; + } + debug('disconnected', err); + this.close(undefined, new DisconnectedError(err.message)); + } + /** + * Closes an open connection. + * + * If there are in progress writes when the port is closed the writes will error. + * @param {ErrorCallback} callback Called once a connection is closed. + * @param {Error} disconnectError used internally to propagate a disconnect error + */ + close(callback, disconnectError = null) { + if (!this.isOpen || !this.port) { + debug('close attempted, but port is not open'); + return this._asyncError(new Error('Port is not open'), callback); + } + this.closing = true; + debug('#close'); + this.port.close().then(() => { + this.closing = false; + debug('binding.close', 'finished'); + this.emit('close', disconnectError); + if (this.settings.endOnClose) { + this.emit('end'); + } + if (callback) { + callback.call(this, disconnectError); + } + }, err => { + this.closing = false; + debug('binding.close', 'had an error', err); + return this._error(err, callback); + }); + } + /** + * Set control flags on an open port. Uses [`SetCommMask`](https://msdn.microsoft.com/en-us/library/windows/desktop/aa363257(v=vs.85).aspx) for Windows and [`ioctl`](http://linux.die.net/man/4/tty_ioctl) for OS X and Linux. + * + * All options are operating system default when the port is opened. Every flag is set on each call to the provided or default values. If options isn't provided default options is used. + */ + set(options, callback) { + if (!this.isOpen || !this.port) { + debug('set attempted, but port is not open'); + return this._asyncError(new Error('Port is not open'), callback); + } + const settings = { ...defaultSetFlags, ...options }; + debug('#set', settings); + this.port.set(settings).then(() => { + debug('binding.set', 'finished'); + if (callback) { + callback.call(this, null); + } + }, err => { + debug('binding.set', 'had an error', err); + return this._error(err, callback); + }); + } + /** + * Returns the control flags (CTS, DSR, DCD) on the open port. + * Uses [`GetCommModemStatus`](https://msdn.microsoft.com/en-us/library/windows/desktop/aa363258(v=vs.85).aspx) for Windows and [`ioctl`](http://linux.die.net/man/4/tty_ioctl) for mac and linux. + */ + get(callback) { + if (!this.isOpen || !this.port) { + debug('get attempted, but port is not open'); + return this._asyncError(new Error('Port is not open'), callback); + } + debug('#get'); + this.port.get().then(status => { + debug('binding.get', 'finished'); + callback.call(this, null, status); + }, err => { + debug('binding.get', 'had an error', err); + return this._error(err, callback); + }); + } + /** + * Flush discards data received but not read, and written but not transmitted by the operating system. For more technical details, see [`tcflush(fd, TCIOFLUSH)`](http://linux.die.net/man/3/tcflush) for Mac/Linux and [`FlushFileBuffers`](http://msdn.microsoft.com/en-us/library/windows/desktop/aa364439) for Windows. + */ + flush(callback) { + if (!this.isOpen || !this.port) { + debug('flush attempted, but port is not open'); + return this._asyncError(new Error('Port is not open'), callback); + } + debug('#flush'); + this.port.flush().then(() => { + debug('binding.flush', 'finished'); + if (callback) { + callback.call(this, null); + } + }, err => { + debug('binding.flush', 'had an error', err); + return this._error(err, callback); + }); + } + /** + * Waits until all output data is transmitted to the serial port. After any pending write has completed it calls [`tcdrain()`](http://linux.die.net/man/3/tcdrain) or [FlushFileBuffers()](https://msdn.microsoft.com/en-us/library/windows/desktop/aa364439(v=vs.85).aspx) to ensure it has been written to the device. + * @example + Write the `data` and wait until it has finished transmitting to the target serial port before calling the callback. This will queue until the port is open and writes are finished. + + ```js + function writeAndDrain (data, callback) { + port.write(data); + port.drain(callback); + } + ``` + */ + drain(callback) { + debug('drain'); + if (!this.isOpen || !this.port) { + debug('drain queuing on port open'); + this.once('open', () => { + this.drain(callback); + }); + return; + } + this.port.drain().then(() => { + debug('binding.drain', 'finished'); + if (callback) { + callback.call(this, null); + } + }, err => { + debug('binding.drain', 'had an error', err); + return this._error(err, callback); + }); + } +} +exports.SerialPortStream = SerialPortStream; +/** + * The `error` event's callback is called with an error object whenever there is an error. + * @event error + */ +/** + * The `open` event's callback is called with no arguments when the port is opened and ready for writing. This happens if you have the constructor open immediately (which opens in the next tick) or if you open the port manually with `open()`. See [Useage/Opening a Port](#opening-a-port) for more information. + * @event open + */ +/** + * Request a number of bytes from the SerialPort. The `read()` method pulls some data out of the internal buffer and returns it. If no data is available to be read, null is returned. By default, the data is returned as a `Buffer` object unless an encoding has been specified using the `.setEncoding()` method. + * @method SerialPort.prototype.read + * @param {number=} size Specify how many bytes of data to return, if available + * @returns {(string|Buffer|null)} The data from internal buffers + */ +/** + * Listening for the `data` event puts the port in flowing mode. Data is emitted as soon as it's received. Data is a `Buffer` object with a varying amount of data in it. The `readLine` parser converts the data into string lines. See the [parsers](https://serialport.io/docs/api-parsers-overview) section for more information on parsers, and the [Node.js stream documentation](https://nodejs.org/api/stream.html#stream_event_data) for more information on the data event. + * @event data + */ +/** + * The `close` event's callback is called with no arguments when the port is closed. In the case of a disconnect it will be called with a Disconnect Error object (`err.disconnected == true`). In the event of a close error (unlikely), an error event is triggered. + * @event close + */ +/** + * The `pause()` method causes a stream in flowing mode to stop emitting 'data' events, switching out of flowing mode. Any data that becomes available remains in the internal buffer. + * @method SerialPort.prototype.pause + * @see resume + * @returns `this` + */ +/** + * The `resume()` method causes an explicitly paused, `Readable` stream to resume emitting 'data' events, switching the stream into flowing mode. + * @method SerialPort.prototype.resume + * @see pause + * @returns `this` + */ diff --git a/node_modules/@serialport/stream/node_modules/debug/LICENSE b/node_modules/@serialport/stream/node_modules/debug/LICENSE new file mode 100644 index 0000000..1a9820e --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/debug/LICENSE @@ -0,0 +1,20 @@ +(The MIT License) + +Copyright (c) 2014-2017 TJ Holowaychuk +Copyright (c) 2018-2021 Josh Junon + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software +and associated documentation files (the 'Software'), to deal in the Software without restriction, +including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, +and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial +portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT +LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/node_modules/@serialport/stream/node_modules/debug/README.md b/node_modules/@serialport/stream/node_modules/debug/README.md new file mode 100644 index 0000000..e9c3e04 --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/debug/README.md @@ -0,0 +1,481 @@ +# debug +[![Build Status](https://travis-ci.org/debug-js/debug.svg?branch=master)](https://travis-ci.org/debug-js/debug) [![Coverage Status](https://coveralls.io/repos/github/debug-js/debug/badge.svg?branch=master)](https://coveralls.io/github/debug-js/debug?branch=master) [![Slack](https://visionmedia-community-slackin.now.sh/badge.svg)](https://visionmedia-community-slackin.now.sh/) [![OpenCollective](https://opencollective.com/debug/backers/badge.svg)](#backers) +[![OpenCollective](https://opencollective.com/debug/sponsors/badge.svg)](#sponsors) + + + +A tiny JavaScript debugging utility modelled after Node.js core's debugging +technique. Works in Node.js and web browsers. + +## Installation + +```bash +$ npm install debug +``` + +## Usage + +`debug` exposes a function; simply pass this function the name of your module, and it will return a decorated version of `console.error` for you to pass debug statements to. This will allow you to toggle the debug output for different parts of your module as well as the module as a whole. + +Example [_app.js_](./examples/node/app.js): + +```js +var debug = require('debug')('http') + , http = require('http') + , name = 'My App'; + +// fake app + +debug('booting %o', name); + +http.createServer(function(req, res){ + debug(req.method + ' ' + req.url); + res.end('hello\n'); +}).listen(3000, function(){ + debug('listening'); +}); + +// fake worker of some kind + +require('./worker'); +``` + +Example [_worker.js_](./examples/node/worker.js): + +```js +var a = require('debug')('worker:a') + , b = require('debug')('worker:b'); + +function work() { + a('doing lots of uninteresting work'); + setTimeout(work, Math.random() * 1000); +} + +work(); + +function workb() { + b('doing some work'); + setTimeout(workb, Math.random() * 2000); +} + +workb(); +``` + +The `DEBUG` environment variable is then used to enable these based on space or +comma-delimited names. + +Here are some examples: + +screen shot 2017-08-08 at 12 53 04 pm +screen shot 2017-08-08 at 12 53 38 pm +screen shot 2017-08-08 at 12 53 25 pm + +#### Windows command prompt notes + +##### CMD + +On Windows the environment variable is set using the `set` command. + +```cmd +set DEBUG=*,-not_this +``` + +Example: + +```cmd +set DEBUG=* & node app.js +``` + +##### PowerShell (VS Code default) + +PowerShell uses different syntax to set environment variables. + +```cmd +$env:DEBUG = "*,-not_this" +``` + +Example: + +```cmd +$env:DEBUG='app';node app.js +``` + +Then, run the program to be debugged as usual. + +npm script example: +```js + "windowsDebug": "@powershell -Command $env:DEBUG='*';node app.js", +``` + +## Namespace Colors + +Every debug instance has a color generated for it based on its namespace name. +This helps when visually parsing the debug output to identify which debug instance +a debug line belongs to. + +#### Node.js + +In Node.js, colors are enabled when stderr is a TTY. You also _should_ install +the [`supports-color`](https://npmjs.org/supports-color) module alongside debug, +otherwise debug will only use a small handful of basic colors. + + + +#### Web Browser + +Colors are also enabled on "Web Inspectors" that understand the `%c` formatting +option. These are WebKit web inspectors, Firefox ([since version +31](https://hacks.mozilla.org/2014/05/editable-box-model-multiple-selection-sublime-text-keys-much-more-firefox-developer-tools-episode-31/)) +and the Firebug plugin for Firefox (any version). + + + + +## Millisecond diff + +When actively developing an application it can be useful to see when the time spent between one `debug()` call and the next. Suppose for example you invoke `debug()` before requesting a resource, and after as well, the "+NNNms" will show you how much time was spent between calls. + + + +When stdout is not a TTY, `Date#toISOString()` is used, making it more useful for logging the debug information as shown below: + + + + +## Conventions + +If you're using this in one or more of your libraries, you _should_ use the name of your library so that developers may toggle debugging as desired without guessing names. If you have more than one debuggers you _should_ prefix them with your library name and use ":" to separate features. For example "bodyParser" from Connect would then be "connect:bodyParser". If you append a "*" to the end of your name, it will always be enabled regardless of the setting of the DEBUG environment variable. You can then use it for normal output as well as debug output. + +## Wildcards + +The `*` character may be used as a wildcard. Suppose for example your library has +debuggers named "connect:bodyParser", "connect:compress", "connect:session", +instead of listing all three with +`DEBUG=connect:bodyParser,connect:compress,connect:session`, you may simply do +`DEBUG=connect:*`, or to run everything using this module simply use `DEBUG=*`. + +You can also exclude specific debuggers by prefixing them with a "-" character. +For example, `DEBUG=*,-connect:*` would include all debuggers except those +starting with "connect:". + +## Environment Variables + +When running through Node.js, you can set a few environment variables that will +change the behavior of the debug logging: + +| Name | Purpose | +|-----------|-------------------------------------------------| +| `DEBUG` | Enables/disables specific debugging namespaces. | +| `DEBUG_HIDE_DATE` | Hide date from debug output (non-TTY). | +| `DEBUG_COLORS`| Whether or not to use colors in the debug output. | +| `DEBUG_DEPTH` | Object inspection depth. | +| `DEBUG_SHOW_HIDDEN` | Shows hidden properties on inspected objects. | + + +__Note:__ The environment variables beginning with `DEBUG_` end up being +converted into an Options object that gets used with `%o`/`%O` formatters. +See the Node.js documentation for +[`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options) +for the complete list. + +## Formatters + +Debug uses [printf-style](https://wikipedia.org/wiki/Printf_format_string) formatting. +Below are the officially supported formatters: + +| Formatter | Representation | +|-----------|----------------| +| `%O` | Pretty-print an Object on multiple lines. | +| `%o` | Pretty-print an Object all on a single line. | +| `%s` | String. | +| `%d` | Number (both integer and float). | +| `%j` | JSON. Replaced with the string '[Circular]' if the argument contains circular references. | +| `%%` | Single percent sign ('%'). This does not consume an argument. | + + +### Custom formatters + +You can add custom formatters by extending the `debug.formatters` object. +For example, if you wanted to add support for rendering a Buffer as hex with +`%h`, you could do something like: + +```js +const createDebug = require('debug') +createDebug.formatters.h = (v) => { + return v.toString('hex') +} + +// …elsewhere +const debug = createDebug('foo') +debug('this is hex: %h', new Buffer('hello world')) +// foo this is hex: 68656c6c6f20776f726c6421 +0ms +``` + + +## Browser Support + +You can build a browser-ready script using [browserify](https://github.com/substack/node-browserify), +or just use the [browserify-as-a-service](https://wzrd.in/) [build](https://wzrd.in/standalone/debug@latest), +if you don't want to build it yourself. + +Debug's enable state is currently persisted by `localStorage`. +Consider the situation shown below where you have `worker:a` and `worker:b`, +and wish to debug both. You can enable this using `localStorage.debug`: + +```js +localStorage.debug = 'worker:*' +``` + +And then refresh the page. + +```js +a = debug('worker:a'); +b = debug('worker:b'); + +setInterval(function(){ + a('doing some work'); +}, 1000); + +setInterval(function(){ + b('doing some work'); +}, 1200); +``` + +In Chromium-based web browsers (e.g. Brave, Chrome, and Electron), the JavaScript console will—by default—only show messages logged by `debug` if the "Verbose" log level is _enabled_. + + + +## Output streams + + By default `debug` will log to stderr, however this can be configured per-namespace by overriding the `log` method: + +Example [_stdout.js_](./examples/node/stdout.js): + +```js +var debug = require('debug'); +var error = debug('app:error'); + +// by default stderr is used +error('goes to stderr!'); + +var log = debug('app:log'); +// set this namespace to log via console.log +log.log = console.log.bind(console); // don't forget to bind to console! +log('goes to stdout'); +error('still goes to stderr!'); + +// set all output to go via console.info +// overrides all per-namespace log settings +debug.log = console.info.bind(console); +error('now goes to stdout via console.info'); +log('still goes to stdout, but via console.info now'); +``` + +## Extend +You can simply extend debugger +```js +const log = require('debug')('auth'); + +//creates new debug instance with extended namespace +const logSign = log.extend('sign'); +const logLogin = log.extend('login'); + +log('hello'); // auth hello +logSign('hello'); //auth:sign hello +logLogin('hello'); //auth:login hello +``` + +## Set dynamically + +You can also enable debug dynamically by calling the `enable()` method : + +```js +let debug = require('debug'); + +console.log(1, debug.enabled('test')); + +debug.enable('test'); +console.log(2, debug.enabled('test')); + +debug.disable(); +console.log(3, debug.enabled('test')); + +``` + +print : +``` +1 false +2 true +3 false +``` + +Usage : +`enable(namespaces)` +`namespaces` can include modes separated by a colon and wildcards. + +Note that calling `enable()` completely overrides previously set DEBUG variable : + +``` +$ DEBUG=foo node -e 'var dbg = require("debug"); dbg.enable("bar"); console.log(dbg.enabled("foo"))' +=> false +``` + +`disable()` + +Will disable all namespaces. The functions returns the namespaces currently +enabled (and skipped). This can be useful if you want to disable debugging +temporarily without knowing what was enabled to begin with. + +For example: + +```js +let debug = require('debug'); +debug.enable('foo:*,-foo:bar'); +let namespaces = debug.disable(); +debug.enable(namespaces); +``` + +Note: There is no guarantee that the string will be identical to the initial +enable string, but semantically they will be identical. + +## Checking whether a debug target is enabled + +After you've created a debug instance, you can determine whether or not it is +enabled by checking the `enabled` property: + +```javascript +const debug = require('debug')('http'); + +if (debug.enabled) { + // do stuff... +} +``` + +You can also manually toggle this property to force the debug instance to be +enabled or disabled. + +## Usage in child processes + +Due to the way `debug` detects if the output is a TTY or not, colors are not shown in child processes when `stderr` is piped. A solution is to pass the `DEBUG_COLORS=1` environment variable to the child process. +For example: + +```javascript +worker = fork(WORKER_WRAP_PATH, [workerPath], { + stdio: [ + /* stdin: */ 0, + /* stdout: */ 'pipe', + /* stderr: */ 'pipe', + 'ipc', + ], + env: Object.assign({}, process.env, { + DEBUG_COLORS: 1 // without this settings, colors won't be shown + }), +}); + +worker.stderr.pipe(process.stderr, { end: false }); +``` + + +## Authors + + - TJ Holowaychuk + - Nathan Rajlich + - Andrew Rhyne + - Josh Junon + +## Backers + +Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/debug#backer)] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Sponsors + +Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/debug#sponsor)] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## License + +(The MIT License) + +Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca> +Copyright (c) 2018-2021 Josh Junon + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/@serialport/stream/node_modules/debug/package.json b/node_modules/@serialport/stream/node_modules/debug/package.json new file mode 100644 index 0000000..3bcdc24 --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/debug/package.json @@ -0,0 +1,59 @@ +{ + "name": "debug", + "version": "4.3.4", + "repository": { + "type": "git", + "url": "git://github.com/debug-js/debug.git" + }, + "description": "Lightweight debugging utility for Node.js and the browser", + "keywords": [ + "debug", + "log", + "debugger" + ], + "files": [ + "src", + "LICENSE", + "README.md" + ], + "author": "Josh Junon ", + "contributors": [ + "TJ Holowaychuk ", + "Nathan Rajlich (http://n8.io)", + "Andrew Rhyne " + ], + "license": "MIT", + "scripts": { + "lint": "xo", + "test": "npm run test:node && npm run test:browser && npm run lint", + "test:node": "istanbul cover _mocha -- test.js", + "test:browser": "karma start --single-run", + "test:coverage": "cat ./coverage/lcov.info | coveralls" + }, + "dependencies": { + "ms": "2.1.2" + }, + "devDependencies": { + "brfs": "^2.0.1", + "browserify": "^16.2.3", + "coveralls": "^3.0.2", + "istanbul": "^0.4.5", + "karma": "^3.1.4", + "karma-browserify": "^6.0.0", + "karma-chrome-launcher": "^2.2.0", + "karma-mocha": "^1.3.0", + "mocha": "^5.2.0", + "mocha-lcov-reporter": "^1.2.0", + "xo": "^0.23.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + }, + "main": "./src/index.js", + "browser": "./src/browser.js", + "engines": { + "node": ">=6.0" + } +} diff --git a/node_modules/@serialport/stream/node_modules/debug/src/browser.js b/node_modules/@serialport/stream/node_modules/debug/src/browser.js new file mode 100644 index 0000000..cd0fc35 --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/debug/src/browser.js @@ -0,0 +1,269 @@ +/* eslint-env browser */ + +/** + * This is the web browser implementation of `debug()`. + */ + +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; +exports.storage = localstorage(); +exports.destroy = (() => { + let warned = false; + + return () => { + if (!warned) { + warned = true; + console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.'); + } + }; +})(); + +/** + * Colors. + */ + +exports.colors = [ + '#0000CC', + '#0000FF', + '#0033CC', + '#0033FF', + '#0066CC', + '#0066FF', + '#0099CC', + '#0099FF', + '#00CC00', + '#00CC33', + '#00CC66', + '#00CC99', + '#00CCCC', + '#00CCFF', + '#3300CC', + '#3300FF', + '#3333CC', + '#3333FF', + '#3366CC', + '#3366FF', + '#3399CC', + '#3399FF', + '#33CC00', + '#33CC33', + '#33CC66', + '#33CC99', + '#33CCCC', + '#33CCFF', + '#6600CC', + '#6600FF', + '#6633CC', + '#6633FF', + '#66CC00', + '#66CC33', + '#9900CC', + '#9900FF', + '#9933CC', + '#9933FF', + '#99CC00', + '#99CC33', + '#CC0000', + '#CC0033', + '#CC0066', + '#CC0099', + '#CC00CC', + '#CC00FF', + '#CC3300', + '#CC3333', + '#CC3366', + '#CC3399', + '#CC33CC', + '#CC33FF', + '#CC6600', + '#CC6633', + '#CC9900', + '#CC9933', + '#CCCC00', + '#CCCC33', + '#FF0000', + '#FF0033', + '#FF0066', + '#FF0099', + '#FF00CC', + '#FF00FF', + '#FF3300', + '#FF3333', + '#FF3366', + '#FF3399', + '#FF33CC', + '#FF33FF', + '#FF6600', + '#FF6633', + '#FF9900', + '#FF9933', + '#FFCC00', + '#FFCC33' +]; + +/** + * Currently only WebKit-based Web Inspectors, Firefox >= v31, + * and the Firebug extension (any Firefox version) are known + * to support "%c" CSS customizations. + * + * TODO: add a `localStorage` variable to explicitly enable/disable colors + */ + +// eslint-disable-next-line complexity +function useColors() { + // NB: In an Electron preload script, document will be defined but not fully + // initialized. Since we know we're in Chrome, we'll just detect this case + // explicitly + if (typeof window !== 'undefined' && window.process && (window.process.type === 'renderer' || window.process.__nwjs)) { + return true; + } + + // Internet Explorer and Edge do not support colors. + if (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/(edge|trident)\/(\d+)/)) { + return false; + } + + // Is webkit? http://stackoverflow.com/a/16459606/376773 + // document is undefined in react-native: https://github.com/facebook/react-native/pull/1632 + return (typeof document !== 'undefined' && document.documentElement && document.documentElement.style && document.documentElement.style.WebkitAppearance) || + // Is firebug? http://stackoverflow.com/a/398120/376773 + (typeof window !== 'undefined' && window.console && (window.console.firebug || (window.console.exception && window.console.table))) || + // Is firefox >= v31? + // https://developer.mozilla.org/en-US/docs/Tools/Web_Console#Styling_messages + (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/firefox\/(\d+)/) && parseInt(RegExp.$1, 10) >= 31) || + // Double check webkit in userAgent just in case we are in a worker + (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/applewebkit\/(\d+)/)); +} + +/** + * Colorize log arguments if enabled. + * + * @api public + */ + +function formatArgs(args) { + args[0] = (this.useColors ? '%c' : '') + + this.namespace + + (this.useColors ? ' %c' : ' ') + + args[0] + + (this.useColors ? '%c ' : ' ') + + '+' + module.exports.humanize(this.diff); + + if (!this.useColors) { + return; + } + + const c = 'color: ' + this.color; + args.splice(1, 0, c, 'color: inherit'); + + // The final "%c" is somewhat tricky, because there could be other + // arguments passed either before or after the %c, so we need to + // figure out the correct index to insert the CSS into + let index = 0; + let lastC = 0; + args[0].replace(/%[a-zA-Z%]/g, match => { + if (match === '%%') { + return; + } + index++; + if (match === '%c') { + // We only are interested in the *last* %c + // (the user may have provided their own) + lastC = index; + } + }); + + args.splice(lastC, 0, c); +} + +/** + * Invokes `console.debug()` when available. + * No-op when `console.debug` is not a "function". + * If `console.debug` is not available, falls back + * to `console.log`. + * + * @api public + */ +exports.log = console.debug || console.log || (() => {}); + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ +function save(namespaces) { + try { + if (namespaces) { + exports.storage.setItem('debug', namespaces); + } else { + exports.storage.removeItem('debug'); + } + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ +function load() { + let r; + try { + r = exports.storage.getItem('debug'); + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } + + // If debug isn't set in LS, and we're in Electron, try to load $DEBUG + if (!r && typeof process !== 'undefined' && 'env' in process) { + r = process.env.DEBUG; + } + + return r; +} + +/** + * Localstorage attempts to return the localstorage. + * + * This is necessary because safari throws + * when a user disables cookies/localstorage + * and you attempt to access it. + * + * @return {LocalStorage} + * @api private + */ + +function localstorage() { + try { + // TVMLKit (Apple TV JS Runtime) does not have a window object, just localStorage in the global context + // The Browser also has localStorage in the global context. + return localStorage; + } catch (error) { + // Swallow + // XXX (@Qix-) should we be logging these? + } +} + +module.exports = require('./common')(exports); + +const {formatters} = module.exports; + +/** + * Map %j to `JSON.stringify()`, since no Web Inspectors do that by default. + */ + +formatters.j = function (v) { + try { + return JSON.stringify(v); + } catch (error) { + return '[UnexpectedJSONParseError]: ' + error.message; + } +}; diff --git a/node_modules/@serialport/stream/node_modules/debug/src/common.js b/node_modules/@serialport/stream/node_modules/debug/src/common.js new file mode 100644 index 0000000..e3291b2 --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/debug/src/common.js @@ -0,0 +1,274 @@ + +/** + * This is the common logic for both the Node.js and web browser + * implementations of `debug()`. + */ + +function setup(env) { + createDebug.debug = createDebug; + createDebug.default = createDebug; + createDebug.coerce = coerce; + createDebug.disable = disable; + createDebug.enable = enable; + createDebug.enabled = enabled; + createDebug.humanize = require('ms'); + createDebug.destroy = destroy; + + Object.keys(env).forEach(key => { + createDebug[key] = env[key]; + }); + + /** + * The currently active debug mode names, and names to skip. + */ + + createDebug.names = []; + createDebug.skips = []; + + /** + * Map of special "%n" handling functions, for the debug "format" argument. + * + * Valid key names are a single, lower or upper-case letter, i.e. "n" and "N". + */ + createDebug.formatters = {}; + + /** + * Selects a color for a debug namespace + * @param {String} namespace The namespace string for the debug instance to be colored + * @return {Number|String} An ANSI color code for the given namespace + * @api private + */ + function selectColor(namespace) { + let hash = 0; + + for (let i = 0; i < namespace.length; i++) { + hash = ((hash << 5) - hash) + namespace.charCodeAt(i); + hash |= 0; // Convert to 32bit integer + } + + return createDebug.colors[Math.abs(hash) % createDebug.colors.length]; + } + createDebug.selectColor = selectColor; + + /** + * Create a debugger with the given `namespace`. + * + * @param {String} namespace + * @return {Function} + * @api public + */ + function createDebug(namespace) { + let prevTime; + let enableOverride = null; + let namespacesCache; + let enabledCache; + + function debug(...args) { + // Disabled? + if (!debug.enabled) { + return; + } + + const self = debug; + + // Set `diff` timestamp + const curr = Number(new Date()); + const ms = curr - (prevTime || curr); + self.diff = ms; + self.prev = prevTime; + self.curr = curr; + prevTime = curr; + + args[0] = createDebug.coerce(args[0]); + + if (typeof args[0] !== 'string') { + // Anything else let's inspect with %O + args.unshift('%O'); + } + + // Apply any `formatters` transformations + let index = 0; + args[0] = args[0].replace(/%([a-zA-Z%])/g, (match, format) => { + // If we encounter an escaped % then don't increase the array index + if (match === '%%') { + return '%'; + } + index++; + const formatter = createDebug.formatters[format]; + if (typeof formatter === 'function') { + const val = args[index]; + match = formatter.call(self, val); + + // Now we need to remove `args[index]` since it's inlined in the `format` + args.splice(index, 1); + index--; + } + return match; + }); + + // Apply env-specific formatting (colors, etc.) + createDebug.formatArgs.call(self, args); + + const logFn = self.log || createDebug.log; + logFn.apply(self, args); + } + + debug.namespace = namespace; + debug.useColors = createDebug.useColors(); + debug.color = createDebug.selectColor(namespace); + debug.extend = extend; + debug.destroy = createDebug.destroy; // XXX Temporary. Will be removed in the next major release. + + Object.defineProperty(debug, 'enabled', { + enumerable: true, + configurable: false, + get: () => { + if (enableOverride !== null) { + return enableOverride; + } + if (namespacesCache !== createDebug.namespaces) { + namespacesCache = createDebug.namespaces; + enabledCache = createDebug.enabled(namespace); + } + + return enabledCache; + }, + set: v => { + enableOverride = v; + } + }); + + // Env-specific initialization logic for debug instances + if (typeof createDebug.init === 'function') { + createDebug.init(debug); + } + + return debug; + } + + function extend(namespace, delimiter) { + const newDebug = createDebug(this.namespace + (typeof delimiter === 'undefined' ? ':' : delimiter) + namespace); + newDebug.log = this.log; + return newDebug; + } + + /** + * Enables a debug mode by namespaces. This can include modes + * separated by a colon and wildcards. + * + * @param {String} namespaces + * @api public + */ + function enable(namespaces) { + createDebug.save(namespaces); + createDebug.namespaces = namespaces; + + createDebug.names = []; + createDebug.skips = []; + + let i; + const split = (typeof namespaces === 'string' ? namespaces : '').split(/[\s,]+/); + const len = split.length; + + for (i = 0; i < len; i++) { + if (!split[i]) { + // ignore empty strings + continue; + } + + namespaces = split[i].replace(/\*/g, '.*?'); + + if (namespaces[0] === '-') { + createDebug.skips.push(new RegExp('^' + namespaces.slice(1) + '$')); + } else { + createDebug.names.push(new RegExp('^' + namespaces + '$')); + } + } + } + + /** + * Disable debug output. + * + * @return {String} namespaces + * @api public + */ + function disable() { + const namespaces = [ + ...createDebug.names.map(toNamespace), + ...createDebug.skips.map(toNamespace).map(namespace => '-' + namespace) + ].join(','); + createDebug.enable(''); + return namespaces; + } + + /** + * Returns true if the given mode name is enabled, false otherwise. + * + * @param {String} name + * @return {Boolean} + * @api public + */ + function enabled(name) { + if (name[name.length - 1] === '*') { + return true; + } + + let i; + let len; + + for (i = 0, len = createDebug.skips.length; i < len; i++) { + if (createDebug.skips[i].test(name)) { + return false; + } + } + + for (i = 0, len = createDebug.names.length; i < len; i++) { + if (createDebug.names[i].test(name)) { + return true; + } + } + + return false; + } + + /** + * Convert regexp to namespace + * + * @param {RegExp} regxep + * @return {String} namespace + * @api private + */ + function toNamespace(regexp) { + return regexp.toString() + .substring(2, regexp.toString().length - 2) + .replace(/\.\*\?$/, '*'); + } + + /** + * Coerce `val`. + * + * @param {Mixed} val + * @return {Mixed} + * @api private + */ + function coerce(val) { + if (val instanceof Error) { + return val.stack || val.message; + } + return val; + } + + /** + * XXX DO NOT USE. This is a temporary stub function. + * XXX It WILL be removed in the next major release. + */ + function destroy() { + console.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.'); + } + + createDebug.enable(createDebug.load()); + + return createDebug; +} + +module.exports = setup; diff --git a/node_modules/@serialport/stream/node_modules/debug/src/index.js b/node_modules/@serialport/stream/node_modules/debug/src/index.js new file mode 100644 index 0000000..bf4c57f --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/debug/src/index.js @@ -0,0 +1,10 @@ +/** + * Detect Electron renderer / nwjs process, which is node, but we should + * treat as a browser. + */ + +if (typeof process === 'undefined' || process.type === 'renderer' || process.browser === true || process.__nwjs) { + module.exports = require('./browser.js'); +} else { + module.exports = require('./node.js'); +} diff --git a/node_modules/@serialport/stream/node_modules/debug/src/node.js b/node_modules/@serialport/stream/node_modules/debug/src/node.js new file mode 100644 index 0000000..79bc085 --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/debug/src/node.js @@ -0,0 +1,263 @@ +/** + * Module dependencies. + */ + +const tty = require('tty'); +const util = require('util'); + +/** + * This is the Node.js implementation of `debug()`. + */ + +exports.init = init; +exports.log = log; +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; +exports.destroy = util.deprecate( + () => {}, + 'Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.' +); + +/** + * Colors. + */ + +exports.colors = [6, 2, 3, 4, 5, 1]; + +try { + // Optional dependency (as in, doesn't need to be installed, NOT like optionalDependencies in package.json) + // eslint-disable-next-line import/no-extraneous-dependencies + const supportsColor = require('supports-color'); + + if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) { + exports.colors = [ + 20, + 21, + 26, + 27, + 32, + 33, + 38, + 39, + 40, + 41, + 42, + 43, + 44, + 45, + 56, + 57, + 62, + 63, + 68, + 69, + 74, + 75, + 76, + 77, + 78, + 79, + 80, + 81, + 92, + 93, + 98, + 99, + 112, + 113, + 128, + 129, + 134, + 135, + 148, + 149, + 160, + 161, + 162, + 163, + 164, + 165, + 166, + 167, + 168, + 169, + 170, + 171, + 172, + 173, + 178, + 179, + 184, + 185, + 196, + 197, + 198, + 199, + 200, + 201, + 202, + 203, + 204, + 205, + 206, + 207, + 208, + 209, + 214, + 215, + 220, + 221 + ]; + } +} catch (error) { + // Swallow - we only care if `supports-color` is available; it doesn't have to be. +} + +/** + * Build up the default `inspectOpts` object from the environment variables. + * + * $ DEBUG_COLORS=no DEBUG_DEPTH=10 DEBUG_SHOW_HIDDEN=enabled node script.js + */ + +exports.inspectOpts = Object.keys(process.env).filter(key => { + return /^debug_/i.test(key); +}).reduce((obj, key) => { + // Camel-case + const prop = key + .substring(6) + .toLowerCase() + .replace(/_([a-z])/g, (_, k) => { + return k.toUpperCase(); + }); + + // Coerce string value into JS value + let val = process.env[key]; + if (/^(yes|on|true|enabled)$/i.test(val)) { + val = true; + } else if (/^(no|off|false|disabled)$/i.test(val)) { + val = false; + } else if (val === 'null') { + val = null; + } else { + val = Number(val); + } + + obj[prop] = val; + return obj; +}, {}); + +/** + * Is stdout a TTY? Colored output is enabled when `true`. + */ + +function useColors() { + return 'colors' in exports.inspectOpts ? + Boolean(exports.inspectOpts.colors) : + tty.isatty(process.stderr.fd); +} + +/** + * Adds ANSI color escape codes if enabled. + * + * @api public + */ + +function formatArgs(args) { + const {namespace: name, useColors} = this; + + if (useColors) { + const c = this.color; + const colorCode = '\u001B[3' + (c < 8 ? c : '8;5;' + c); + const prefix = ` ${colorCode};1m${name} \u001B[0m`; + + args[0] = prefix + args[0].split('\n').join('\n' + prefix); + args.push(colorCode + 'm+' + module.exports.humanize(this.diff) + '\u001B[0m'); + } else { + args[0] = getDate() + name + ' ' + args[0]; + } +} + +function getDate() { + if (exports.inspectOpts.hideDate) { + return ''; + } + return new Date().toISOString() + ' '; +} + +/** + * Invokes `util.format()` with the specified arguments and writes to stderr. + */ + +function log(...args) { + return process.stderr.write(util.format(...args) + '\n'); +} + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ +function save(namespaces) { + if (namespaces) { + process.env.DEBUG = namespaces; + } else { + // If you set a process.env field to null or undefined, it gets cast to the + // string 'null' or 'undefined'. Just delete instead. + delete process.env.DEBUG; + } +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ + +function load() { + return process.env.DEBUG; +} + +/** + * Init logic for `debug` instances. + * + * Create a new `inspectOpts` object in case `useColors` is set + * differently for a particular `debug` instance. + */ + +function init(debug) { + debug.inspectOpts = {}; + + const keys = Object.keys(exports.inspectOpts); + for (let i = 0; i < keys.length; i++) { + debug.inspectOpts[keys[i]] = exports.inspectOpts[keys[i]]; + } +} + +module.exports = require('./common')(exports); + +const {formatters} = module.exports; + +/** + * Map %o to `util.inspect()`, all on a single line. + */ + +formatters.o = function (v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts) + .split('\n') + .map(str => str.trim()) + .join(' '); +}; + +/** + * Map %O to `util.inspect()`, allowing multiple lines if needed. + */ + +formatters.O = function (v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts); +}; diff --git a/node_modules/@serialport/stream/node_modules/ms/index.js b/node_modules/@serialport/stream/node_modules/ms/index.js new file mode 100644 index 0000000..c4498bc --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/ms/index.js @@ -0,0 +1,162 @@ +/** + * Helpers. + */ + +var s = 1000; +var m = s * 60; +var h = m * 60; +var d = h * 24; +var w = d * 7; +var y = d * 365.25; + +/** + * Parse or format the given `val`. + * + * Options: + * + * - `long` verbose formatting [false] + * + * @param {String|Number} val + * @param {Object} [options] + * @throws {Error} throw an error if val is not a non-empty string or a number + * @return {String|Number} + * @api public + */ + +module.exports = function(val, options) { + options = options || {}; + var type = typeof val; + if (type === 'string' && val.length > 0) { + return parse(val); + } else if (type === 'number' && isFinite(val)) { + return options.long ? fmtLong(val) : fmtShort(val); + } + throw new Error( + 'val is not a non-empty string or a valid number. val=' + + JSON.stringify(val) + ); +}; + +/** + * Parse the given `str` and return milliseconds. + * + * @param {String} str + * @return {Number} + * @api private + */ + +function parse(str) { + str = String(str); + if (str.length > 100) { + return; + } + var match = /^(-?(?:\d+)?\.?\d+) *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|years?|yrs?|y)?$/i.exec( + str + ); + if (!match) { + return; + } + var n = parseFloat(match[1]); + var type = (match[2] || 'ms').toLowerCase(); + switch (type) { + case 'years': + case 'year': + case 'yrs': + case 'yr': + case 'y': + return n * y; + case 'weeks': + case 'week': + case 'w': + return n * w; + case 'days': + case 'day': + case 'd': + return n * d; + case 'hours': + case 'hour': + case 'hrs': + case 'hr': + case 'h': + return n * h; + case 'minutes': + case 'minute': + case 'mins': + case 'min': + case 'm': + return n * m; + case 'seconds': + case 'second': + case 'secs': + case 'sec': + case 's': + return n * s; + case 'milliseconds': + case 'millisecond': + case 'msecs': + case 'msec': + case 'ms': + return n; + default: + return undefined; + } +} + +/** + * Short format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtShort(ms) { + var msAbs = Math.abs(ms); + if (msAbs >= d) { + return Math.round(ms / d) + 'd'; + } + if (msAbs >= h) { + return Math.round(ms / h) + 'h'; + } + if (msAbs >= m) { + return Math.round(ms / m) + 'm'; + } + if (msAbs >= s) { + return Math.round(ms / s) + 's'; + } + return ms + 'ms'; +} + +/** + * Long format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtLong(ms) { + var msAbs = Math.abs(ms); + if (msAbs >= d) { + return plural(ms, msAbs, d, 'day'); + } + if (msAbs >= h) { + return plural(ms, msAbs, h, 'hour'); + } + if (msAbs >= m) { + return plural(ms, msAbs, m, 'minute'); + } + if (msAbs >= s) { + return plural(ms, msAbs, s, 'second'); + } + return ms + ' ms'; +} + +/** + * Pluralization helper. + */ + +function plural(ms, msAbs, n, name) { + var isPlural = msAbs >= n * 1.5; + return Math.round(ms / n) + ' ' + name + (isPlural ? 's' : ''); +} diff --git a/node_modules/@serialport/stream/node_modules/ms/license.md b/node_modules/@serialport/stream/node_modules/ms/license.md new file mode 100644 index 0000000..69b6125 --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/ms/license.md @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2016 Zeit, Inc. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/node_modules/@serialport/stream/node_modules/ms/package.json b/node_modules/@serialport/stream/node_modules/ms/package.json new file mode 100644 index 0000000..eea666e --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/ms/package.json @@ -0,0 +1,37 @@ +{ + "name": "ms", + "version": "2.1.2", + "description": "Tiny millisecond conversion utility", + "repository": "zeit/ms", + "main": "./index", + "files": [ + "index.js" + ], + "scripts": { + "precommit": "lint-staged", + "lint": "eslint lib/* bin/*", + "test": "mocha tests.js" + }, + "eslintConfig": { + "extends": "eslint:recommended", + "env": { + "node": true, + "es6": true + } + }, + "lint-staged": { + "*.js": [ + "npm run lint", + "prettier --single-quote --write", + "git add" + ] + }, + "license": "MIT", + "devDependencies": { + "eslint": "4.12.1", + "expect.js": "0.3.1", + "husky": "0.14.3", + "lint-staged": "5.0.0", + "mocha": "4.0.1" + } +} diff --git a/node_modules/@serialport/stream/node_modules/ms/readme.md b/node_modules/@serialport/stream/node_modules/ms/readme.md new file mode 100644 index 0000000..9a1996b --- /dev/null +++ b/node_modules/@serialport/stream/node_modules/ms/readme.md @@ -0,0 +1,60 @@ +# ms + +[![Build Status](https://travis-ci.org/zeit/ms.svg?branch=master)](https://travis-ci.org/zeit/ms) +[![Join the community on Spectrum](https://withspectrum.github.io/badge/badge.svg)](https://spectrum.chat/zeit) + +Use this package to easily convert various time formats to milliseconds. + +## Examples + +```js +ms('2 days') // 172800000 +ms('1d') // 86400000 +ms('10h') // 36000000 +ms('2.5 hrs') // 9000000 +ms('2h') // 7200000 +ms('1m') // 60000 +ms('5s') // 5000 +ms('1y') // 31557600000 +ms('100') // 100 +ms('-3 days') // -259200000 +ms('-1h') // -3600000 +ms('-200') // -200 +``` + +### Convert from Milliseconds + +```js +ms(60000) // "1m" +ms(2 * 60000) // "2m" +ms(-3 * 60000) // "-3m" +ms(ms('10 hours')) // "10h" +``` + +### Time Format Written-Out + +```js +ms(60000, { long: true }) // "1 minute" +ms(2 * 60000, { long: true }) // "2 minutes" +ms(-3 * 60000, { long: true }) // "-3 minutes" +ms(ms('10 hours'), { long: true }) // "10 hours" +``` + +## Features + +- Works both in [Node.js](https://nodejs.org) and in the browser +- If a number is supplied to `ms`, a string with a unit is returned +- If a string that contains the number is supplied, it returns it as a number (e.g.: it returns `100` for `'100'`) +- If you pass a string with a number and a valid unit, the number of equivalent milliseconds is returned + +## Related Packages + +- [ms.macro](https://github.com/knpwrs/ms.macro) - Run `ms` as a macro at build-time. + +## Caught a Bug? + +1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your own GitHub account and then [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device +2. Link the package to the global module directory: `npm link` +3. Within the module you want to test your local development instance of ms, just link it to the dependencies: `npm link ms`. Instead of the default one from npm, Node.js will now use your clone of ms! + +As always, you can run the tests using: `npm test` diff --git a/node_modules/@serialport/stream/package.json b/node_modules/@serialport/stream/package.json new file mode 100644 index 0000000..c85d1f2 --- /dev/null +++ b/node_modules/@serialport/stream/package.json @@ -0,0 +1,30 @@ +{ + "name": "@serialport/stream", + "version": "12.0.0", + "main": "./dist/index.js", + "types": "./dist/index.d.ts", + "scripts": { + "build": "tsc --build tsconfig-build.json" + }, + "dependencies": { + "@serialport/bindings-interface": "1.2.2", + "debug": "4.3.4" + }, + "devDependencies": { + "@serialport/binding-mock": "^10.2.2", + "typescript": "5.2.2" + }, + "engines": { + "node": ">=12.0.0" + }, + "publishConfig": { + "access": "public" + }, + "license": "MIT", + "repository": { + "type": "git", + "url": "git://github.com/serialport/node-serialport.git" + }, + "funding": "https://opencollective.com/serialport/donate", + "gitHead": "f7e7bd53f9578a26c4f44cc1949fef396dc064c7" +} diff --git a/node_modules/accepts/HISTORY.md b/node_modules/accepts/HISTORY.md new file mode 100644 index 0000000..cb5990c --- /dev/null +++ b/node_modules/accepts/HISTORY.md @@ -0,0 +1,243 @@ +1.3.8 / 2022-02-02 +================== + + * deps: mime-types@~2.1.34 + - deps: mime-db@~1.51.0 + * deps: negotiator@0.6.3 + +1.3.7 / 2019-04-29 +================== + + * deps: negotiator@0.6.2 + - Fix sorting charset, encoding, and language with extra parameters + +1.3.6 / 2019-04-28 +================== + + * deps: mime-types@~2.1.24 + - deps: mime-db@~1.40.0 + +1.3.5 / 2018-02-28 +================== + + * deps: mime-types@~2.1.18 + - deps: mime-db@~1.33.0 + +1.3.4 / 2017-08-22 +================== + + * deps: mime-types@~2.1.16 + - deps: mime-db@~1.29.0 + +1.3.3 / 2016-05-02 +================== + + * deps: mime-types@~2.1.11 + - deps: mime-db@~1.23.0 + * deps: negotiator@0.6.1 + - perf: improve `Accept` parsing speed + - perf: improve `Accept-Charset` parsing speed + - perf: improve `Accept-Encoding` parsing speed + - perf: improve `Accept-Language` parsing speed + +1.3.2 / 2016-03-08 +================== + + * deps: mime-types@~2.1.10 + - Fix extension of `application/dash+xml` + - Update primary extension for `audio/mp4` + - deps: mime-db@~1.22.0 + +1.3.1 / 2016-01-19 +================== + + * deps: mime-types@~2.1.9 + - deps: mime-db@~1.21.0 + +1.3.0 / 2015-09-29 +================== + + * deps: mime-types@~2.1.7 + - deps: mime-db@~1.19.0 + * deps: negotiator@0.6.0 + - Fix including type extensions in parameters in `Accept` parsing + - Fix parsing `Accept` parameters with quoted equals + - Fix parsing `Accept` parameters with quoted semicolons + - Lazy-load modules from main entry point + - perf: delay type concatenation until needed + - perf: enable strict mode + - perf: hoist regular expressions + - perf: remove closures getting spec properties + - perf: remove a closure from media type parsing + - perf: remove property delete from media type parsing + +1.2.13 / 2015-09-06 +=================== + + * deps: mime-types@~2.1.6 + - deps: mime-db@~1.18.0 + +1.2.12 / 2015-07-30 +=================== + + * deps: mime-types@~2.1.4 + - deps: mime-db@~1.16.0 + +1.2.11 / 2015-07-16 +=================== + + * deps: mime-types@~2.1.3 + - deps: mime-db@~1.15.0 + +1.2.10 / 2015-07-01 +=================== + + * deps: mime-types@~2.1.2 + - deps: mime-db@~1.14.0 + +1.2.9 / 2015-06-08 +================== + + * deps: mime-types@~2.1.1 + - perf: fix deopt during mapping + +1.2.8 / 2015-06-07 +================== + + * deps: mime-types@~2.1.0 + - deps: mime-db@~1.13.0 + * perf: avoid argument reassignment & argument slice + * perf: avoid negotiator recursive construction + * perf: enable strict mode + * perf: remove unnecessary bitwise operator + +1.2.7 / 2015-05-10 +================== + + * deps: negotiator@0.5.3 + - Fix media type parameter matching to be case-insensitive + +1.2.6 / 2015-05-07 +================== + + * deps: mime-types@~2.0.11 + - deps: mime-db@~1.9.1 + * deps: negotiator@0.5.2 + - Fix comparing media types with quoted values + - Fix splitting media types with quoted commas + +1.2.5 / 2015-03-13 +================== + + * deps: mime-types@~2.0.10 + - deps: mime-db@~1.8.0 + +1.2.4 / 2015-02-14 +================== + + * Support Node.js 0.6 + * deps: mime-types@~2.0.9 + - deps: mime-db@~1.7.0 + * deps: negotiator@0.5.1 + - Fix preference sorting to be stable for long acceptable lists + +1.2.3 / 2015-01-31 +================== + + * deps: mime-types@~2.0.8 + - deps: mime-db@~1.6.0 + +1.2.2 / 2014-12-30 +================== + + * deps: mime-types@~2.0.7 + - deps: mime-db@~1.5.0 + +1.2.1 / 2014-12-30 +================== + + * deps: mime-types@~2.0.5 + - deps: mime-db@~1.3.1 + +1.2.0 / 2014-12-19 +================== + + * deps: negotiator@0.5.0 + - Fix list return order when large accepted list + - Fix missing identity encoding when q=0 exists + - Remove dynamic building of Negotiator class + +1.1.4 / 2014-12-10 +================== + + * deps: mime-types@~2.0.4 + - deps: mime-db@~1.3.0 + +1.1.3 / 2014-11-09 +================== + + * deps: mime-types@~2.0.3 + - deps: mime-db@~1.2.0 + +1.1.2 / 2014-10-14 +================== + + * deps: negotiator@0.4.9 + - Fix error when media type has invalid parameter + +1.1.1 / 2014-09-28 +================== + + * deps: mime-types@~2.0.2 + - deps: mime-db@~1.1.0 + * deps: negotiator@0.4.8 + - Fix all negotiations to be case-insensitive + - Stable sort preferences of same quality according to client order + +1.1.0 / 2014-09-02 +================== + + * update `mime-types` + +1.0.7 / 2014-07-04 +================== + + * Fix wrong type returned from `type` when match after unknown extension + +1.0.6 / 2014-06-24 +================== + + * deps: negotiator@0.4.7 + +1.0.5 / 2014-06-20 +================== + + * fix crash when unknown extension given + +1.0.4 / 2014-06-19 +================== + + * use `mime-types` + +1.0.3 / 2014-06-11 +================== + + * deps: negotiator@0.4.6 + - Order by specificity when quality is the same + +1.0.2 / 2014-05-29 +================== + + * Fix interpretation when header not in request + * deps: pin negotiator@0.4.5 + +1.0.1 / 2014-01-18 +================== + + * Identity encoding isn't always acceptable + * deps: negotiator@~0.4.0 + +1.0.0 / 2013-12-27 +================== + + * Genesis diff --git a/node_modules/accepts/LICENSE b/node_modules/accepts/LICENSE new file mode 100644 index 0000000..0616607 --- /dev/null +++ b/node_modules/accepts/LICENSE @@ -0,0 +1,23 @@ +(The MIT License) + +Copyright (c) 2014 Jonathan Ong +Copyright (c) 2015 Douglas Christopher Wilson + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/accepts/README.md b/node_modules/accepts/README.md new file mode 100644 index 0000000..82680c5 --- /dev/null +++ b/node_modules/accepts/README.md @@ -0,0 +1,140 @@ +# accepts + +[![NPM Version][npm-version-image]][npm-url] +[![NPM Downloads][npm-downloads-image]][npm-url] +[![Node.js Version][node-version-image]][node-version-url] +[![Build Status][github-actions-ci-image]][github-actions-ci-url] +[![Test Coverage][coveralls-image]][coveralls-url] + +Higher level content negotiation based on [negotiator](https://www.npmjs.com/package/negotiator). +Extracted from [koa](https://www.npmjs.com/package/koa) for general use. + +In addition to negotiator, it allows: + +- Allows types as an array or arguments list, ie `(['text/html', 'application/json'])` + as well as `('text/html', 'application/json')`. +- Allows type shorthands such as `json`. +- Returns `false` when no types match +- Treats non-existent headers as `*` + +## Installation + +This is a [Node.js](https://nodejs.org/en/) module available through the +[npm registry](https://www.npmjs.com/). Installation is done using the +[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally): + +```sh +$ npm install accepts +``` + +## API + +```js +var accepts = require('accepts') +``` + +### accepts(req) + +Create a new `Accepts` object for the given `req`. + +#### .charset(charsets) + +Return the first accepted charset. If nothing in `charsets` is accepted, +then `false` is returned. + +#### .charsets() + +Return the charsets that the request accepts, in the order of the client's +preference (most preferred first). + +#### .encoding(encodings) + +Return the first accepted encoding. If nothing in `encodings` is accepted, +then `false` is returned. + +#### .encodings() + +Return the encodings that the request accepts, in the order of the client's +preference (most preferred first). + +#### .language(languages) + +Return the first accepted language. If nothing in `languages` is accepted, +then `false` is returned. + +#### .languages() + +Return the languages that the request accepts, in the order of the client's +preference (most preferred first). + +#### .type(types) + +Return the first accepted type (and it is returned as the same text as what +appears in the `types` array). If nothing in `types` is accepted, then `false` +is returned. + +The `types` array can contain full MIME types or file extensions. Any value +that is not a full MIME types is passed to `require('mime-types').lookup`. + +#### .types() + +Return the types that the request accepts, in the order of the client's +preference (most preferred first). + +## Examples + +### Simple type negotiation + +This simple example shows how to use `accepts` to return a different typed +respond body based on what the client wants to accept. The server lists it's +preferences in order and will get back the best match between the client and +server. + +```js +var accepts = require('accepts') +var http = require('http') + +function app (req, res) { + var accept = accepts(req) + + // the order of this list is significant; should be server preferred order + switch (accept.type(['json', 'html'])) { + case 'json': + res.setHeader('Content-Type', 'application/json') + res.write('{"hello":"world!"}') + break + case 'html': + res.setHeader('Content-Type', 'text/html') + res.write('hello, world!') + break + default: + // the fallback is text/plain, so no need to specify it above + res.setHeader('Content-Type', 'text/plain') + res.write('hello, world!') + break + } + + res.end() +} + +http.createServer(app).listen(3000) +``` + +You can test this out with the cURL program: +```sh +curl -I -H'Accept: text/html' http://localhost:3000/ +``` + +## License + +[MIT](LICENSE) + +[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/accepts/master +[coveralls-url]: https://coveralls.io/r/jshttp/accepts?branch=master +[github-actions-ci-image]: https://badgen.net/github/checks/jshttp/accepts/master?label=ci +[github-actions-ci-url]: https://github.com/jshttp/accepts/actions/workflows/ci.yml +[node-version-image]: https://badgen.net/npm/node/accepts +[node-version-url]: https://nodejs.org/en/download +[npm-downloads-image]: https://badgen.net/npm/dm/accepts +[npm-url]: https://npmjs.org/package/accepts +[npm-version-image]: https://badgen.net/npm/v/accepts diff --git a/node_modules/accepts/index.js b/node_modules/accepts/index.js new file mode 100644 index 0000000..e9b2f63 --- /dev/null +++ b/node_modules/accepts/index.js @@ -0,0 +1,238 @@ +/*! + * accepts + * Copyright(c) 2014 Jonathan Ong + * Copyright(c) 2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module dependencies. + * @private + */ + +var Negotiator = require('negotiator') +var mime = require('mime-types') + +/** + * Module exports. + * @public + */ + +module.exports = Accepts + +/** + * Create a new Accepts object for the given req. + * + * @param {object} req + * @public + */ + +function Accepts (req) { + if (!(this instanceof Accepts)) { + return new Accepts(req) + } + + this.headers = req.headers + this.negotiator = new Negotiator(req) +} + +/** + * Check if the given `type(s)` is acceptable, returning + * the best match when true, otherwise `undefined`, in which + * case you should respond with 406 "Not Acceptable". + * + * The `type` value may be a single mime type string + * such as "application/json", the extension name + * such as "json" or an array `["json", "html", "text/plain"]`. When a list + * or array is given the _best_ match, if any is returned. + * + * Examples: + * + * // Accept: text/html + * this.types('html'); + * // => "html" + * + * // Accept: text/*, application/json + * this.types('html'); + * // => "html" + * this.types('text/html'); + * // => "text/html" + * this.types('json', 'text'); + * // => "json" + * this.types('application/json'); + * // => "application/json" + * + * // Accept: text/*, application/json + * this.types('image/png'); + * this.types('png'); + * // => undefined + * + * // Accept: text/*;q=.5, application/json + * this.types(['html', 'json']); + * this.types('html', 'json'); + * // => "json" + * + * @param {String|Array} types... + * @return {String|Array|Boolean} + * @public + */ + +Accepts.prototype.type = +Accepts.prototype.types = function (types_) { + var types = types_ + + // support flattened arguments + if (types && !Array.isArray(types)) { + types = new Array(arguments.length) + for (var i = 0; i < types.length; i++) { + types[i] = arguments[i] + } + } + + // no types, return all requested types + if (!types || types.length === 0) { + return this.negotiator.mediaTypes() + } + + // no accept header, return first given type + if (!this.headers.accept) { + return types[0] + } + + var mimes = types.map(extToMime) + var accepts = this.negotiator.mediaTypes(mimes.filter(validMime)) + var first = accepts[0] + + return first + ? types[mimes.indexOf(first)] + : false +} + +/** + * Return accepted encodings or best fit based on `encodings`. + * + * Given `Accept-Encoding: gzip, deflate` + * an array sorted by quality is returned: + * + * ['gzip', 'deflate'] + * + * @param {String|Array} encodings... + * @return {String|Array} + * @public + */ + +Accepts.prototype.encoding = +Accepts.prototype.encodings = function (encodings_) { + var encodings = encodings_ + + // support flattened arguments + if (encodings && !Array.isArray(encodings)) { + encodings = new Array(arguments.length) + for (var i = 0; i < encodings.length; i++) { + encodings[i] = arguments[i] + } + } + + // no encodings, return all requested encodings + if (!encodings || encodings.length === 0) { + return this.negotiator.encodings() + } + + return this.negotiator.encodings(encodings)[0] || false +} + +/** + * Return accepted charsets or best fit based on `charsets`. + * + * Given `Accept-Charset: utf-8, iso-8859-1;q=0.2, utf-7;q=0.5` + * an array sorted by quality is returned: + * + * ['utf-8', 'utf-7', 'iso-8859-1'] + * + * @param {String|Array} charsets... + * @return {String|Array} + * @public + */ + +Accepts.prototype.charset = +Accepts.prototype.charsets = function (charsets_) { + var charsets = charsets_ + + // support flattened arguments + if (charsets && !Array.isArray(charsets)) { + charsets = new Array(arguments.length) + for (var i = 0; i < charsets.length; i++) { + charsets[i] = arguments[i] + } + } + + // no charsets, return all requested charsets + if (!charsets || charsets.length === 0) { + return this.negotiator.charsets() + } + + return this.negotiator.charsets(charsets)[0] || false +} + +/** + * Return accepted languages or best fit based on `langs`. + * + * Given `Accept-Language: en;q=0.8, es, pt` + * an array sorted by quality is returned: + * + * ['es', 'pt', 'en'] + * + * @param {String|Array} langs... + * @return {Array|String} + * @public + */ + +Accepts.prototype.lang = +Accepts.prototype.langs = +Accepts.prototype.language = +Accepts.prototype.languages = function (languages_) { + var languages = languages_ + + // support flattened arguments + if (languages && !Array.isArray(languages)) { + languages = new Array(arguments.length) + for (var i = 0; i < languages.length; i++) { + languages[i] = arguments[i] + } + } + + // no languages, return all requested languages + if (!languages || languages.length === 0) { + return this.negotiator.languages() + } + + return this.negotiator.languages(languages)[0] || false +} + +/** + * Convert extnames to mime. + * + * @param {String} type + * @return {String} + * @private + */ + +function extToMime (type) { + return type.indexOf('/') === -1 + ? mime.lookup(type) + : type +} + +/** + * Check if mime is valid. + * + * @param {String} type + * @return {String} + * @private + */ + +function validMime (type) { + return typeof type === 'string' +} diff --git a/node_modules/accepts/package.json b/node_modules/accepts/package.json new file mode 100644 index 0000000..0f2d15d --- /dev/null +++ b/node_modules/accepts/package.json @@ -0,0 +1,47 @@ +{ + "name": "accepts", + "description": "Higher-level content negotiation", + "version": "1.3.8", + "contributors": [ + "Douglas Christopher Wilson ", + "Jonathan Ong (http://jongleberry.com)" + ], + "license": "MIT", + "repository": "jshttp/accepts", + "dependencies": { + "mime-types": "~2.1.34", + "negotiator": "0.6.3" + }, + "devDependencies": { + "deep-equal": "1.0.1", + "eslint": "7.32.0", + "eslint-config-standard": "14.1.1", + "eslint-plugin-import": "2.25.4", + "eslint-plugin-markdown": "2.2.1", + "eslint-plugin-node": "11.1.0", + "eslint-plugin-promise": "4.3.1", + "eslint-plugin-standard": "4.1.0", + "mocha": "9.2.0", + "nyc": "15.1.0" + }, + "files": [ + "LICENSE", + "HISTORY.md", + "index.js" + ], + "engines": { + "node": ">= 0.6" + }, + "scripts": { + "lint": "eslint .", + "test": "mocha --reporter spec --check-leaks --bail test/", + "test-ci": "nyc --reporter=lcov --reporter=text npm test", + "test-cov": "nyc --reporter=html --reporter=text npm test" + }, + "keywords": [ + "content", + "negotiation", + "accept", + "accepts" + ] +} diff --git a/node_modules/array-flatten/LICENSE b/node_modules/array-flatten/LICENSE new file mode 100644 index 0000000..983fbe8 --- /dev/null +++ b/node_modules/array-flatten/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2014 Blake Embrey (hello@blakeembrey.com) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/node_modules/array-flatten/README.md b/node_modules/array-flatten/README.md new file mode 100644 index 0000000..91fa5b6 --- /dev/null +++ b/node_modules/array-flatten/README.md @@ -0,0 +1,43 @@ +# Array Flatten + +[![NPM version][npm-image]][npm-url] +[![NPM downloads][downloads-image]][downloads-url] +[![Build status][travis-image]][travis-url] +[![Test coverage][coveralls-image]][coveralls-url] + +> Flatten an array of nested arrays into a single flat array. Accepts an optional depth. + +## Installation + +``` +npm install array-flatten --save +``` + +## Usage + +```javascript +var flatten = require('array-flatten') + +flatten([1, [2, [3, [4, [5], 6], 7], 8], 9]) +//=> [1, 2, 3, 4, 5, 6, 7, 8, 9] + +flatten([1, [2, [3, [4, [5], 6], 7], 8], 9], 2) +//=> [1, 2, 3, [4, [5], 6], 7, 8, 9] + +(function () { + flatten(arguments) //=> [1, 2, 3] +})(1, [2, 3]) +``` + +## License + +MIT + +[npm-image]: https://img.shields.io/npm/v/array-flatten.svg?style=flat +[npm-url]: https://npmjs.org/package/array-flatten +[downloads-image]: https://img.shields.io/npm/dm/array-flatten.svg?style=flat +[downloads-url]: https://npmjs.org/package/array-flatten +[travis-image]: https://img.shields.io/travis/blakeembrey/array-flatten.svg?style=flat +[travis-url]: https://travis-ci.org/blakeembrey/array-flatten +[coveralls-image]: https://img.shields.io/coveralls/blakeembrey/array-flatten.svg?style=flat +[coveralls-url]: https://coveralls.io/r/blakeembrey/array-flatten?branch=master diff --git a/node_modules/array-flatten/array-flatten.js b/node_modules/array-flatten/array-flatten.js new file mode 100644 index 0000000..089117b --- /dev/null +++ b/node_modules/array-flatten/array-flatten.js @@ -0,0 +1,64 @@ +'use strict' + +/** + * Expose `arrayFlatten`. + */ +module.exports = arrayFlatten + +/** + * Recursive flatten function with depth. + * + * @param {Array} array + * @param {Array} result + * @param {Number} depth + * @return {Array} + */ +function flattenWithDepth (array, result, depth) { + for (var i = 0; i < array.length; i++) { + var value = array[i] + + if (depth > 0 && Array.isArray(value)) { + flattenWithDepth(value, result, depth - 1) + } else { + result.push(value) + } + } + + return result +} + +/** + * Recursive flatten function. Omitting depth is slightly faster. + * + * @param {Array} array + * @param {Array} result + * @return {Array} + */ +function flattenForever (array, result) { + for (var i = 0; i < array.length; i++) { + var value = array[i] + + if (Array.isArray(value)) { + flattenForever(value, result) + } else { + result.push(value) + } + } + + return result +} + +/** + * Flatten an array, with the ability to define a depth. + * + * @param {Array} array + * @param {Number} depth + * @return {Array} + */ +function arrayFlatten (array, depth) { + if (depth == null) { + return flattenForever(array, []) + } + + return flattenWithDepth(array, [], depth) +} diff --git a/node_modules/array-flatten/package.json b/node_modules/array-flatten/package.json new file mode 100644 index 0000000..1a24e2a --- /dev/null +++ b/node_modules/array-flatten/package.json @@ -0,0 +1,39 @@ +{ + "name": "array-flatten", + "version": "1.1.1", + "description": "Flatten an array of nested arrays into a single flat array", + "main": "array-flatten.js", + "files": [ + "array-flatten.js", + "LICENSE" + ], + "scripts": { + "test": "istanbul cover _mocha -- -R spec" + }, + "repository": { + "type": "git", + "url": "git://github.com/blakeembrey/array-flatten.git" + }, + "keywords": [ + "array", + "flatten", + "arguments", + "depth" + ], + "author": { + "name": "Blake Embrey", + "email": "hello@blakeembrey.com", + "url": "http://blakeembrey.me" + }, + "license": "MIT", + "bugs": { + "url": "https://github.com/blakeembrey/array-flatten/issues" + }, + "homepage": "https://github.com/blakeembrey/array-flatten", + "devDependencies": { + "istanbul": "^0.3.13", + "mocha": "^2.2.4", + "pre-commit": "^1.0.7", + "standard": "^3.7.3" + } +} diff --git a/node_modules/body-parser/HISTORY.md b/node_modules/body-parser/HISTORY.md new file mode 100644 index 0000000..81d23e0 --- /dev/null +++ b/node_modules/body-parser/HISTORY.md @@ -0,0 +1,672 @@ +1.20.3 / 2024-09-10 +=================== + + * deps: qs@6.13.0 + * add `depth` option to customize the depth level in the parser + * IMPORTANT: The default `depth` level for parsing URL-encoded data is now `32` (previously was `Infinity`) + +1.20.2 / 2023-02-21 +=================== + + * Fix strict json error message on Node.js 19+ + * deps: content-type@~1.0.5 + - perf: skip value escaping when unnecessary + * deps: raw-body@2.5.2 + +1.20.1 / 2022-10-06 +=================== + + * deps: qs@6.11.0 + * perf: remove unnecessary object clone + +1.20.0 / 2022-04-02 +=================== + + * Fix error message for json parse whitespace in `strict` + * Fix internal error when inflated body exceeds limit + * Prevent loss of async hooks context + * Prevent hanging when request already read + * deps: depd@2.0.0 + - Replace internal `eval` usage with `Function` constructor + - Use instance methods on `process` to check for listeners + * deps: http-errors@2.0.0 + - deps: depd@2.0.0 + - deps: statuses@2.0.1 + * deps: on-finished@2.4.1 + * deps: qs@6.10.3 + * deps: raw-body@2.5.1 + - deps: http-errors@2.0.0 + +1.19.2 / 2022-02-15 +=================== + + * deps: bytes@3.1.2 + * deps: qs@6.9.7 + * Fix handling of `__proto__` keys + * deps: raw-body@2.4.3 + - deps: bytes@3.1.2 + +1.19.1 / 2021-12-10 +=================== + + * deps: bytes@3.1.1 + * deps: http-errors@1.8.1 + - deps: inherits@2.0.4 + - deps: toidentifier@1.0.1 + - deps: setprototypeof@1.2.0 + * deps: qs@6.9.6 + * deps: raw-body@2.4.2 + - deps: bytes@3.1.1 + - deps: http-errors@1.8.1 + * deps: safe-buffer@5.2.1 + * deps: type-is@~1.6.18 + +1.19.0 / 2019-04-25 +=================== + + * deps: bytes@3.1.0 + - Add petabyte (`pb`) support + * deps: http-errors@1.7.2 + - Set constructor name when possible + - deps: setprototypeof@1.1.1 + - deps: statuses@'>= 1.5.0 < 2' + * deps: iconv-lite@0.4.24 + - Added encoding MIK + * deps: qs@6.7.0 + - Fix parsing array brackets after index + * deps: raw-body@2.4.0 + - deps: bytes@3.1.0 + - deps: http-errors@1.7.2 + - deps: iconv-lite@0.4.24 + * deps: type-is@~1.6.17 + - deps: mime-types@~2.1.24 + - perf: prevent internal `throw` on invalid type + +1.18.3 / 2018-05-14 +=================== + + * Fix stack trace for strict json parse error + * deps: depd@~1.1.2 + - perf: remove argument reassignment + * deps: http-errors@~1.6.3 + - deps: depd@~1.1.2 + - deps: setprototypeof@1.1.0 + - deps: statuses@'>= 1.3.1 < 2' + * deps: iconv-lite@0.4.23 + - Fix loading encoding with year appended + - Fix deprecation warnings on Node.js 10+ + * deps: qs@6.5.2 + * deps: raw-body@2.3.3 + - deps: http-errors@1.6.3 + - deps: iconv-lite@0.4.23 + * deps: type-is@~1.6.16 + - deps: mime-types@~2.1.18 + +1.18.2 / 2017-09-22 +=================== + + * deps: debug@2.6.9 + * perf: remove argument reassignment + +1.18.1 / 2017-09-12 +=================== + + * deps: content-type@~1.0.4 + - perf: remove argument reassignment + - perf: skip parameter parsing when no parameters + * deps: iconv-lite@0.4.19 + - Fix ISO-8859-1 regression + - Update Windows-1255 + * deps: qs@6.5.1 + - Fix parsing & compacting very deep objects + * deps: raw-body@2.3.2 + - deps: iconv-lite@0.4.19 + +1.18.0 / 2017-09-08 +=================== + + * Fix JSON strict violation error to match native parse error + * Include the `body` property on verify errors + * Include the `type` property on all generated errors + * Use `http-errors` to set status code on errors + * deps: bytes@3.0.0 + * deps: debug@2.6.8 + * deps: depd@~1.1.1 + - Remove unnecessary `Buffer` loading + * deps: http-errors@~1.6.2 + - deps: depd@1.1.1 + * deps: iconv-lite@0.4.18 + - Add support for React Native + - Add a warning if not loaded as utf-8 + - Fix CESU-8 decoding in Node.js 8 + - Improve speed of ISO-8859-1 encoding + * deps: qs@6.5.0 + * deps: raw-body@2.3.1 + - Use `http-errors` for standard emitted errors + - deps: bytes@3.0.0 + - deps: iconv-lite@0.4.18 + - perf: skip buffer decoding on overage chunk + * perf: prevent internal `throw` when missing charset + +1.17.2 / 2017-05-17 +=================== + + * deps: debug@2.6.7 + - Fix `DEBUG_MAX_ARRAY_LENGTH` + - deps: ms@2.0.0 + * deps: type-is@~1.6.15 + - deps: mime-types@~2.1.15 + +1.17.1 / 2017-03-06 +=================== + + * deps: qs@6.4.0 + - Fix regression parsing keys starting with `[` + +1.17.0 / 2017-03-01 +=================== + + * deps: http-errors@~1.6.1 + - Make `message` property enumerable for `HttpError`s + - deps: setprototypeof@1.0.3 + * deps: qs@6.3.1 + - Fix compacting nested arrays + +1.16.1 / 2017-02-10 +=================== + + * deps: debug@2.6.1 + - Fix deprecation messages in WebStorm and other editors + - Undeprecate `DEBUG_FD` set to `1` or `2` + +1.16.0 / 2017-01-17 +=================== + + * deps: debug@2.6.0 + - Allow colors in workers + - Deprecated `DEBUG_FD` environment variable + - Fix error when running under React Native + - Use same color for same namespace + - deps: ms@0.7.2 + * deps: http-errors@~1.5.1 + - deps: inherits@2.0.3 + - deps: setprototypeof@1.0.2 + - deps: statuses@'>= 1.3.1 < 2' + * deps: iconv-lite@0.4.15 + - Added encoding MS-31J + - Added encoding MS-932 + - Added encoding MS-936 + - Added encoding MS-949 + - Added encoding MS-950 + - Fix GBK/GB18030 handling of Euro character + * deps: qs@6.2.1 + - Fix array parsing from skipping empty values + * deps: raw-body@~2.2.0 + - deps: iconv-lite@0.4.15 + * deps: type-is@~1.6.14 + - deps: mime-types@~2.1.13 + +1.15.2 / 2016-06-19 +=================== + + * deps: bytes@2.4.0 + * deps: content-type@~1.0.2 + - perf: enable strict mode + * deps: http-errors@~1.5.0 + - Use `setprototypeof` module to replace `__proto__` setting + - deps: statuses@'>= 1.3.0 < 2' + - perf: enable strict mode + * deps: qs@6.2.0 + * deps: raw-body@~2.1.7 + - deps: bytes@2.4.0 + - perf: remove double-cleanup on happy path + * deps: type-is@~1.6.13 + - deps: mime-types@~2.1.11 + +1.15.1 / 2016-05-05 +=================== + + * deps: bytes@2.3.0 + - Drop partial bytes on all parsed units + - Fix parsing byte string that looks like hex + * deps: raw-body@~2.1.6 + - deps: bytes@2.3.0 + * deps: type-is@~1.6.12 + - deps: mime-types@~2.1.10 + +1.15.0 / 2016-02-10 +=================== + + * deps: http-errors@~1.4.0 + - Add `HttpError` export, for `err instanceof createError.HttpError` + - deps: inherits@2.0.1 + - deps: statuses@'>= 1.2.1 < 2' + * deps: qs@6.1.0 + * deps: type-is@~1.6.11 + - deps: mime-types@~2.1.9 + +1.14.2 / 2015-12-16 +=================== + + * deps: bytes@2.2.0 + * deps: iconv-lite@0.4.13 + * deps: qs@5.2.0 + * deps: raw-body@~2.1.5 + - deps: bytes@2.2.0 + - deps: iconv-lite@0.4.13 + * deps: type-is@~1.6.10 + - deps: mime-types@~2.1.8 + +1.14.1 / 2015-09-27 +=================== + + * Fix issue where invalid charset results in 400 when `verify` used + * deps: iconv-lite@0.4.12 + - Fix CESU-8 decoding in Node.js 4.x + * deps: raw-body@~2.1.4 + - Fix masking critical errors from `iconv-lite` + - deps: iconv-lite@0.4.12 + * deps: type-is@~1.6.9 + - deps: mime-types@~2.1.7 + +1.14.0 / 2015-09-16 +=================== + + * Fix JSON strict parse error to match syntax errors + * Provide static `require` analysis in `urlencoded` parser + * deps: depd@~1.1.0 + - Support web browser loading + * deps: qs@5.1.0 + * deps: raw-body@~2.1.3 + - Fix sync callback when attaching data listener causes sync read + * deps: type-is@~1.6.8 + - Fix type error when given invalid type to match against + - deps: mime-types@~2.1.6 + +1.13.3 / 2015-07-31 +=================== + + * deps: type-is@~1.6.6 + - deps: mime-types@~2.1.4 + +1.13.2 / 2015-07-05 +=================== + + * deps: iconv-lite@0.4.11 + * deps: qs@4.0.0 + - Fix dropping parameters like `hasOwnProperty` + - Fix user-visible incompatibilities from 3.1.0 + - Fix various parsing edge cases + * deps: raw-body@~2.1.2 + - Fix error stack traces to skip `makeError` + - deps: iconv-lite@0.4.11 + * deps: type-is@~1.6.4 + - deps: mime-types@~2.1.2 + - perf: enable strict mode + - perf: remove argument reassignment + +1.13.1 / 2015-06-16 +=================== + + * deps: qs@2.4.2 + - Downgraded from 3.1.0 because of user-visible incompatibilities + +1.13.0 / 2015-06-14 +=================== + + * Add `statusCode` property on `Error`s, in addition to `status` + * Change `type` default to `application/json` for JSON parser + * Change `type` default to `application/x-www-form-urlencoded` for urlencoded parser + * Provide static `require` analysis + * Use the `http-errors` module to generate errors + * deps: bytes@2.1.0 + - Slight optimizations + * deps: iconv-lite@0.4.10 + - The encoding UTF-16 without BOM now defaults to UTF-16LE when detection fails + - Leading BOM is now removed when decoding + * deps: on-finished@~2.3.0 + - Add defined behavior for HTTP `CONNECT` requests + - Add defined behavior for HTTP `Upgrade` requests + - deps: ee-first@1.1.1 + * deps: qs@3.1.0 + - Fix dropping parameters like `hasOwnProperty` + - Fix various parsing edge cases + - Parsed object now has `null` prototype + * deps: raw-body@~2.1.1 + - Use `unpipe` module for unpiping requests + - deps: iconv-lite@0.4.10 + * deps: type-is@~1.6.3 + - deps: mime-types@~2.1.1 + - perf: reduce try block size + - perf: remove bitwise operations + * perf: enable strict mode + * perf: remove argument reassignment + * perf: remove delete call + +1.12.4 / 2015-05-10 +=================== + + * deps: debug@~2.2.0 + * deps: qs@2.4.2 + - Fix allowing parameters like `constructor` + * deps: on-finished@~2.2.1 + * deps: raw-body@~2.0.1 + - Fix a false-positive when unpiping in Node.js 0.8 + - deps: bytes@2.0.1 + * deps: type-is@~1.6.2 + - deps: mime-types@~2.0.11 + +1.12.3 / 2015-04-15 +=================== + + * Slight efficiency improvement when not debugging + * deps: depd@~1.0.1 + * deps: iconv-lite@0.4.8 + - Add encoding alias UNICODE-1-1-UTF-7 + * deps: raw-body@1.3.4 + - Fix hanging callback if request aborts during read + - deps: iconv-lite@0.4.8 + +1.12.2 / 2015-03-16 +=================== + + * deps: qs@2.4.1 + - Fix error when parameter `hasOwnProperty` is present + +1.12.1 / 2015-03-15 +=================== + + * deps: debug@~2.1.3 + - Fix high intensity foreground color for bold + - deps: ms@0.7.0 + * deps: type-is@~1.6.1 + - deps: mime-types@~2.0.10 + +1.12.0 / 2015-02-13 +=================== + + * add `debug` messages + * accept a function for the `type` option + * use `content-type` to parse `Content-Type` headers + * deps: iconv-lite@0.4.7 + - Gracefully support enumerables on `Object.prototype` + * deps: raw-body@1.3.3 + - deps: iconv-lite@0.4.7 + * deps: type-is@~1.6.0 + - fix argument reassignment + - fix false-positives in `hasBody` `Transfer-Encoding` check + - support wildcard for both type and subtype (`*/*`) + - deps: mime-types@~2.0.9 + +1.11.0 / 2015-01-30 +=================== + + * make internal `extended: true` depth limit infinity + * deps: type-is@~1.5.6 + - deps: mime-types@~2.0.8 + +1.10.2 / 2015-01-20 +=================== + + * deps: iconv-lite@0.4.6 + - Fix rare aliases of single-byte encodings + * deps: raw-body@1.3.2 + - deps: iconv-lite@0.4.6 + +1.10.1 / 2015-01-01 +=================== + + * deps: on-finished@~2.2.0 + * deps: type-is@~1.5.5 + - deps: mime-types@~2.0.7 + +1.10.0 / 2014-12-02 +=================== + + * make internal `extended: true` array limit dynamic + +1.9.3 / 2014-11-21 +================== + + * deps: iconv-lite@0.4.5 + - Fix Windows-31J and X-SJIS encoding support + * deps: qs@2.3.3 + - Fix `arrayLimit` behavior + * deps: raw-body@1.3.1 + - deps: iconv-lite@0.4.5 + * deps: type-is@~1.5.3 + - deps: mime-types@~2.0.3 + +1.9.2 / 2014-10-27 +================== + + * deps: qs@2.3.2 + - Fix parsing of mixed objects and values + +1.9.1 / 2014-10-22 +================== + + * deps: on-finished@~2.1.1 + - Fix handling of pipelined requests + * deps: qs@2.3.0 + - Fix parsing of mixed implicit and explicit arrays + * deps: type-is@~1.5.2 + - deps: mime-types@~2.0.2 + +1.9.0 / 2014-09-24 +================== + + * include the charset in "unsupported charset" error message + * include the encoding in "unsupported content encoding" error message + * deps: depd@~1.0.0 + +1.8.4 / 2014-09-23 +================== + + * fix content encoding to be case-insensitive + +1.8.3 / 2014-09-19 +================== + + * deps: qs@2.2.4 + - Fix issue with object keys starting with numbers truncated + +1.8.2 / 2014-09-15 +================== + + * deps: depd@0.4.5 + +1.8.1 / 2014-09-07 +================== + + * deps: media-typer@0.3.0 + * deps: type-is@~1.5.1 + +1.8.0 / 2014-09-05 +================== + + * make empty-body-handling consistent between chunked requests + - empty `json` produces `{}` + - empty `raw` produces `new Buffer(0)` + - empty `text` produces `''` + - empty `urlencoded` produces `{}` + * deps: qs@2.2.3 + - Fix issue where first empty value in array is discarded + * deps: type-is@~1.5.0 + - fix `hasbody` to be true for `content-length: 0` + +1.7.0 / 2014-09-01 +================== + + * add `parameterLimit` option to `urlencoded` parser + * change `urlencoded` extended array limit to 100 + * respond with 413 when over `parameterLimit` in `urlencoded` + +1.6.7 / 2014-08-29 +================== + + * deps: qs@2.2.2 + - Remove unnecessary cloning + +1.6.6 / 2014-08-27 +================== + + * deps: qs@2.2.0 + - Array parsing fix + - Performance improvements + +1.6.5 / 2014-08-16 +================== + + * deps: on-finished@2.1.0 + +1.6.4 / 2014-08-14 +================== + + * deps: qs@1.2.2 + +1.6.3 / 2014-08-10 +================== + + * deps: qs@1.2.1 + +1.6.2 / 2014-08-07 +================== + + * deps: qs@1.2.0 + - Fix parsing array of objects + +1.6.1 / 2014-08-06 +================== + + * deps: qs@1.1.0 + - Accept urlencoded square brackets + - Accept empty values in implicit array notation + +1.6.0 / 2014-08-05 +================== + + * deps: qs@1.0.2 + - Complete rewrite + - Limits array length to 20 + - Limits object depth to 5 + - Limits parameters to 1,000 + +1.5.2 / 2014-07-27 +================== + + * deps: depd@0.4.4 + - Work-around v8 generating empty stack traces + +1.5.1 / 2014-07-26 +================== + + * deps: depd@0.4.3 + - Fix exception when global `Error.stackTraceLimit` is too low + +1.5.0 / 2014-07-20 +================== + + * deps: depd@0.4.2 + - Add `TRACE_DEPRECATION` environment variable + - Remove non-standard grey color from color output + - Support `--no-deprecation` argument + - Support `--trace-deprecation` argument + * deps: iconv-lite@0.4.4 + - Added encoding UTF-7 + * deps: raw-body@1.3.0 + - deps: iconv-lite@0.4.4 + - Added encoding UTF-7 + - Fix `Cannot switch to old mode now` error on Node.js 0.10+ + * deps: type-is@~1.3.2 + +1.4.3 / 2014-06-19 +================== + + * deps: type-is@1.3.1 + - fix global variable leak + +1.4.2 / 2014-06-19 +================== + + * deps: type-is@1.3.0 + - improve type parsing + +1.4.1 / 2014-06-19 +================== + + * fix urlencoded extended deprecation message + +1.4.0 / 2014-06-19 +================== + + * add `text` parser + * add `raw` parser + * check accepted charset in content-type (accepts utf-8) + * check accepted encoding in content-encoding (accepts identity) + * deprecate `bodyParser()` middleware; use `.json()` and `.urlencoded()` as needed + * deprecate `urlencoded()` without provided `extended` option + * lazy-load urlencoded parsers + * parsers split into files for reduced mem usage + * support gzip and deflate bodies + - set `inflate: false` to turn off + * deps: raw-body@1.2.2 + - Support all encodings from `iconv-lite` + +1.3.1 / 2014-06-11 +================== + + * deps: type-is@1.2.1 + - Switch dependency from mime to mime-types@1.0.0 + +1.3.0 / 2014-05-31 +================== + + * add `extended` option to urlencoded parser + +1.2.2 / 2014-05-27 +================== + + * deps: raw-body@1.1.6 + - assert stream encoding on node.js 0.8 + - assert stream encoding on node.js < 0.10.6 + - deps: bytes@1 + +1.2.1 / 2014-05-26 +================== + + * invoke `next(err)` after request fully read + - prevents hung responses and socket hang ups + +1.2.0 / 2014-05-11 +================== + + * add `verify` option + * deps: type-is@1.2.0 + - support suffix matching + +1.1.2 / 2014-05-11 +================== + + * improve json parser speed + +1.1.1 / 2014-05-11 +================== + + * fix repeated limit parsing with every request + +1.1.0 / 2014-05-10 +================== + + * add `type` option + * deps: pin for safety and consistency + +1.0.2 / 2014-04-14 +================== + + * use `type-is` module + +1.0.1 / 2014-03-20 +================== + + * lower default limits to 100kb diff --git a/node_modules/body-parser/LICENSE b/node_modules/body-parser/LICENSE new file mode 100644 index 0000000..386b7b6 --- /dev/null +++ b/node_modules/body-parser/LICENSE @@ -0,0 +1,23 @@ +(The MIT License) + +Copyright (c) 2014 Jonathan Ong +Copyright (c) 2014-2015 Douglas Christopher Wilson + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/body-parser/README.md b/node_modules/body-parser/README.md new file mode 100644 index 0000000..f6661b7 --- /dev/null +++ b/node_modules/body-parser/README.md @@ -0,0 +1,476 @@ +# body-parser + +[![NPM Version][npm-version-image]][npm-url] +[![NPM Downloads][npm-downloads-image]][npm-url] +[![Build Status][ci-image]][ci-url] +[![Test Coverage][coveralls-image]][coveralls-url] +[![OpenSSF Scorecard Badge][ossf-scorecard-badge]][ossf-scorecard-visualizer] + +Node.js body parsing middleware. + +Parse incoming request bodies in a middleware before your handlers, available +under the `req.body` property. + +**Note** As `req.body`'s shape is based on user-controlled input, all +properties and values in this object are untrusted and should be validated +before trusting. For example, `req.body.foo.toString()` may fail in multiple +ways, for example the `foo` property may not be there or may not be a string, +and `toString` may not be a function and instead a string or other user input. + +[Learn about the anatomy of an HTTP transaction in Node.js](https://nodejs.org/en/docs/guides/anatomy-of-an-http-transaction/). + +_This does not handle multipart bodies_, due to their complex and typically +large nature. For multipart bodies, you may be interested in the following +modules: + + * [busboy](https://www.npmjs.org/package/busboy#readme) and + [connect-busboy](https://www.npmjs.org/package/connect-busboy#readme) + * [multiparty](https://www.npmjs.org/package/multiparty#readme) and + [connect-multiparty](https://www.npmjs.org/package/connect-multiparty#readme) + * [formidable](https://www.npmjs.org/package/formidable#readme) + * [multer](https://www.npmjs.org/package/multer#readme) + +This module provides the following parsers: + + * [JSON body parser](#bodyparserjsonoptions) + * [Raw body parser](#bodyparserrawoptions) + * [Text body parser](#bodyparsertextoptions) + * [URL-encoded form body parser](#bodyparserurlencodedoptions) + +Other body parsers you might be interested in: + +- [body](https://www.npmjs.org/package/body#readme) +- [co-body](https://www.npmjs.org/package/co-body#readme) + +## Installation + +```sh +$ npm install body-parser +``` + +## API + +```js +var bodyParser = require('body-parser') +``` + +The `bodyParser` object exposes various factories to create middlewares. All +middlewares will populate the `req.body` property with the parsed body when +the `Content-Type` request header matches the `type` option, or an empty +object (`{}`) if there was no body to parse, the `Content-Type` was not matched, +or an error occurred. + +The various errors returned by this module are described in the +[errors section](#errors). + +### bodyParser.json([options]) + +Returns middleware that only parses `json` and only looks at requests where +the `Content-Type` header matches the `type` option. This parser accepts any +Unicode encoding of the body and supports automatic inflation of `gzip` and +`deflate` encodings. + +A new `body` object containing the parsed data is populated on the `request` +object after the middleware (i.e. `req.body`). + +#### Options + +The `json` function takes an optional `options` object that may contain any of +the following keys: + +##### inflate + +When set to `true`, then deflated (compressed) bodies will be inflated; when +`false`, deflated bodies are rejected. Defaults to `true`. + +##### limit + +Controls the maximum request body size. If this is a number, then the value +specifies the number of bytes; if it is a string, the value is passed to the +[bytes](https://www.npmjs.com/package/bytes) library for parsing. Defaults +to `'100kb'`. + +##### reviver + +The `reviver` option is passed directly to `JSON.parse` as the second +argument. You can find more information on this argument +[in the MDN documentation about JSON.parse](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#Example.3A_Using_the_reviver_parameter). + +##### strict + +When set to `true`, will only accept arrays and objects; when `false` will +accept anything `JSON.parse` accepts. Defaults to `true`. + +##### type + +The `type` option is used to determine what media type the middleware will +parse. This option can be a string, array of strings, or a function. If not a +function, `type` option is passed directly to the +[type-is](https://www.npmjs.org/package/type-is#readme) library and this can +be an extension name (like `json`), a mime type (like `application/json`), or +a mime type with a wildcard (like `*/*` or `*/json`). If a function, the `type` +option is called as `fn(req)` and the request is parsed if it returns a truthy +value. Defaults to `application/json`. + +##### verify + +The `verify` option, if supplied, is called as `verify(req, res, buf, encoding)`, +where `buf` is a `Buffer` of the raw request body and `encoding` is the +encoding of the request. The parsing can be aborted by throwing an error. + +### bodyParser.raw([options]) + +Returns middleware that parses all bodies as a `Buffer` and only looks at +requests where the `Content-Type` header matches the `type` option. This +parser supports automatic inflation of `gzip` and `deflate` encodings. + +A new `body` object containing the parsed data is populated on the `request` +object after the middleware (i.e. `req.body`). This will be a `Buffer` object +of the body. + +#### Options + +The `raw` function takes an optional `options` object that may contain any of +the following keys: + +##### inflate + +When set to `true`, then deflated (compressed) bodies will be inflated; when +`false`, deflated bodies are rejected. Defaults to `true`. + +##### limit + +Controls the maximum request body size. If this is a number, then the value +specifies the number of bytes; if it is a string, the value is passed to the +[bytes](https://www.npmjs.com/package/bytes) library for parsing. Defaults +to `'100kb'`. + +##### type + +The `type` option is used to determine what media type the middleware will +parse. This option can be a string, array of strings, or a function. +If not a function, `type` option is passed directly to the +[type-is](https://www.npmjs.org/package/type-is#readme) library and this +can be an extension name (like `bin`), a mime type (like +`application/octet-stream`), or a mime type with a wildcard (like `*/*` or +`application/*`). If a function, the `type` option is called as `fn(req)` +and the request is parsed if it returns a truthy value. Defaults to +`application/octet-stream`. + +##### verify + +The `verify` option, if supplied, is called as `verify(req, res, buf, encoding)`, +where `buf` is a `Buffer` of the raw request body and `encoding` is the +encoding of the request. The parsing can be aborted by throwing an error. + +### bodyParser.text([options]) + +Returns middleware that parses all bodies as a string and only looks at +requests where the `Content-Type` header matches the `type` option. This +parser supports automatic inflation of `gzip` and `deflate` encodings. + +A new `body` string containing the parsed data is populated on the `request` +object after the middleware (i.e. `req.body`). This will be a string of the +body. + +#### Options + +The `text` function takes an optional `options` object that may contain any of +the following keys: + +##### defaultCharset + +Specify the default character set for the text content if the charset is not +specified in the `Content-Type` header of the request. Defaults to `utf-8`. + +##### inflate + +When set to `true`, then deflated (compressed) bodies will be inflated; when +`false`, deflated bodies are rejected. Defaults to `true`. + +##### limit + +Controls the maximum request body size. If this is a number, then the value +specifies the number of bytes; if it is a string, the value is passed to the +[bytes](https://www.npmjs.com/package/bytes) library for parsing. Defaults +to `'100kb'`. + +##### type + +The `type` option is used to determine what media type the middleware will +parse. This option can be a string, array of strings, or a function. If not +a function, `type` option is passed directly to the +[type-is](https://www.npmjs.org/package/type-is#readme) library and this can +be an extension name (like `txt`), a mime type (like `text/plain`), or a mime +type with a wildcard (like `*/*` or `text/*`). If a function, the `type` +option is called as `fn(req)` and the request is parsed if it returns a +truthy value. Defaults to `text/plain`. + +##### verify + +The `verify` option, if supplied, is called as `verify(req, res, buf, encoding)`, +where `buf` is a `Buffer` of the raw request body and `encoding` is the +encoding of the request. The parsing can be aborted by throwing an error. + +### bodyParser.urlencoded([options]) + +Returns middleware that only parses `urlencoded` bodies and only looks at +requests where the `Content-Type` header matches the `type` option. This +parser accepts only UTF-8 encoding of the body and supports automatic +inflation of `gzip` and `deflate` encodings. + +A new `body` object containing the parsed data is populated on the `request` +object after the middleware (i.e. `req.body`). This object will contain +key-value pairs, where the value can be a string or array (when `extended` is +`false`), or any type (when `extended` is `true`). + +#### Options + +The `urlencoded` function takes an optional `options` object that may contain +any of the following keys: + +##### extended + +The `extended` option allows to choose between parsing the URL-encoded data +with the `querystring` library (when `false`) or the `qs` library (when +`true`). The "extended" syntax allows for rich objects and arrays to be +encoded into the URL-encoded format, allowing for a JSON-like experience +with URL-encoded. For more information, please +[see the qs library](https://www.npmjs.org/package/qs#readme). + +Defaults to `true`, but using the default has been deprecated. Please +research into the difference between `qs` and `querystring` and choose the +appropriate setting. + +##### inflate + +When set to `true`, then deflated (compressed) bodies will be inflated; when +`false`, deflated bodies are rejected. Defaults to `true`. + +##### limit + +Controls the maximum request body size. If this is a number, then the value +specifies the number of bytes; if it is a string, the value is passed to the +[bytes](https://www.npmjs.com/package/bytes) library for parsing. Defaults +to `'100kb'`. + +##### parameterLimit + +The `parameterLimit` option controls the maximum number of parameters that +are allowed in the URL-encoded data. If a request contains more parameters +than this value, a 413 will be returned to the client. Defaults to `1000`. + +##### type + +The `type` option is used to determine what media type the middleware will +parse. This option can be a string, array of strings, or a function. If not +a function, `type` option is passed directly to the +[type-is](https://www.npmjs.org/package/type-is#readme) library and this can +be an extension name (like `urlencoded`), a mime type (like +`application/x-www-form-urlencoded`), or a mime type with a wildcard (like +`*/x-www-form-urlencoded`). If a function, the `type` option is called as +`fn(req)` and the request is parsed if it returns a truthy value. Defaults +to `application/x-www-form-urlencoded`. + +##### verify + +The `verify` option, if supplied, is called as `verify(req, res, buf, encoding)`, +where `buf` is a `Buffer` of the raw request body and `encoding` is the +encoding of the request. The parsing can be aborted by throwing an error. + +#### depth + +The `depth` option is used to configure the maximum depth of the `qs` library when `extended` is `true`. This allows you to limit the amount of keys that are parsed and can be useful to prevent certain types of abuse. Defaults to `32`. It is recommended to keep this value as low as possible. + +## Errors + +The middlewares provided by this module create errors using the +[`http-errors` module](https://www.npmjs.com/package/http-errors). The errors +will typically have a `status`/`statusCode` property that contains the suggested +HTTP response code, an `expose` property to determine if the `message` property +should be displayed to the client, a `type` property to determine the type of +error without matching against the `message`, and a `body` property containing +the read body, if available. + +The following are the common errors created, though any error can come through +for various reasons. + +### content encoding unsupported + +This error will occur when the request had a `Content-Encoding` header that +contained an encoding but the "inflation" option was set to `false`. The +`status` property is set to `415`, the `type` property is set to +`'encoding.unsupported'`, and the `charset` property will be set to the +encoding that is unsupported. + +### entity parse failed + +This error will occur when the request contained an entity that could not be +parsed by the middleware. The `status` property is set to `400`, the `type` +property is set to `'entity.parse.failed'`, and the `body` property is set to +the entity value that failed parsing. + +### entity verify failed + +This error will occur when the request contained an entity that could not be +failed verification by the defined `verify` option. The `status` property is +set to `403`, the `type` property is set to `'entity.verify.failed'`, and the +`body` property is set to the entity value that failed verification. + +### request aborted + +This error will occur when the request is aborted by the client before reading +the body has finished. The `received` property will be set to the number of +bytes received before the request was aborted and the `expected` property is +set to the number of expected bytes. The `status` property is set to `400` +and `type` property is set to `'request.aborted'`. + +### request entity too large + +This error will occur when the request body's size is larger than the "limit" +option. The `limit` property will be set to the byte limit and the `length` +property will be set to the request body's length. The `status` property is +set to `413` and the `type` property is set to `'entity.too.large'`. + +### request size did not match content length + +This error will occur when the request's length did not match the length from +the `Content-Length` header. This typically occurs when the request is malformed, +typically when the `Content-Length` header was calculated based on characters +instead of bytes. The `status` property is set to `400` and the `type` property +is set to `'request.size.invalid'`. + +### stream encoding should not be set + +This error will occur when something called the `req.setEncoding` method prior +to this middleware. This module operates directly on bytes only and you cannot +call `req.setEncoding` when using this module. The `status` property is set to +`500` and the `type` property is set to `'stream.encoding.set'`. + +### stream is not readable + +This error will occur when the request is no longer readable when this middleware +attempts to read it. This typically means something other than a middleware from +this module read the request body already and the middleware was also configured to +read the same request. The `status` property is set to `500` and the `type` +property is set to `'stream.not.readable'`. + +### too many parameters + +This error will occur when the content of the request exceeds the configured +`parameterLimit` for the `urlencoded` parser. The `status` property is set to +`413` and the `type` property is set to `'parameters.too.many'`. + +### unsupported charset "BOGUS" + +This error will occur when the request had a charset parameter in the +`Content-Type` header, but the `iconv-lite` module does not support it OR the +parser does not support it. The charset is contained in the message as well +as in the `charset` property. The `status` property is set to `415`, the +`type` property is set to `'charset.unsupported'`, and the `charset` property +is set to the charset that is unsupported. + +### unsupported content encoding "bogus" + +This error will occur when the request had a `Content-Encoding` header that +contained an unsupported encoding. The encoding is contained in the message +as well as in the `encoding` property. The `status` property is set to `415`, +the `type` property is set to `'encoding.unsupported'`, and the `encoding` +property is set to the encoding that is unsupported. + +### The input exceeded the depth + +This error occurs when using `bodyParser.urlencoded` with the `extended` property set to `true` and the input exceeds the configured `depth` option. The `status` property is set to `400`. It is recommended to review the `depth` option and evaluate if it requires a higher value. When the `depth` option is set to `32` (default value), the error will not be thrown. + +## Examples + +### Express/Connect top-level generic + +This example demonstrates adding a generic JSON and URL-encoded parser as a +top-level middleware, which will parse the bodies of all incoming requests. +This is the simplest setup. + +```js +var express = require('express') +var bodyParser = require('body-parser') + +var app = express() + +// parse application/x-www-form-urlencoded +app.use(bodyParser.urlencoded({ extended: false })) + +// parse application/json +app.use(bodyParser.json()) + +app.use(function (req, res) { + res.setHeader('Content-Type', 'text/plain') + res.write('you posted:\n') + res.end(JSON.stringify(req.body, null, 2)) +}) +``` + +### Express route-specific + +This example demonstrates adding body parsers specifically to the routes that +need them. In general, this is the most recommended way to use body-parser with +Express. + +```js +var express = require('express') +var bodyParser = require('body-parser') + +var app = express() + +// create application/json parser +var jsonParser = bodyParser.json() + +// create application/x-www-form-urlencoded parser +var urlencodedParser = bodyParser.urlencoded({ extended: false }) + +// POST /login gets urlencoded bodies +app.post('/login', urlencodedParser, function (req, res) { + res.send('welcome, ' + req.body.username) +}) + +// POST /api/users gets JSON bodies +app.post('/api/users', jsonParser, function (req, res) { + // create user in req.body +}) +``` + +### Change accepted type for parsers + +All the parsers accept a `type` option which allows you to change the +`Content-Type` that the middleware will parse. + +```js +var express = require('express') +var bodyParser = require('body-parser') + +var app = express() + +// parse various different custom JSON types as JSON +app.use(bodyParser.json({ type: 'application/*+json' })) + +// parse some custom thing into a Buffer +app.use(bodyParser.raw({ type: 'application/vnd.custom-type' })) + +// parse an HTML body into a string +app.use(bodyParser.text({ type: 'text/html' })) +``` + +## License + +[MIT](LICENSE) + +[ci-image]: https://badgen.net/github/checks/expressjs/body-parser/master?label=ci +[ci-url]: https://github.com/expressjs/body-parser/actions/workflows/ci.yml +[coveralls-image]: https://badgen.net/coveralls/c/github/expressjs/body-parser/master +[coveralls-url]: https://coveralls.io/r/expressjs/body-parser?branch=master +[node-version-image]: https://badgen.net/npm/node/body-parser +[node-version-url]: https://nodejs.org/en/download +[npm-downloads-image]: https://badgen.net/npm/dm/body-parser +[npm-url]: https://npmjs.org/package/body-parser +[npm-version-image]: https://badgen.net/npm/v/body-parser +[ossf-scorecard-badge]: https://api.scorecard.dev/projects/github.com/expressjs/body-parser/badge +[ossf-scorecard-visualizer]: https://ossf.github.io/scorecard-visualizer/#/projects/github.com/expressjs/body-parser \ No newline at end of file diff --git a/node_modules/body-parser/SECURITY.md b/node_modules/body-parser/SECURITY.md new file mode 100644 index 0000000..9694d42 --- /dev/null +++ b/node_modules/body-parser/SECURITY.md @@ -0,0 +1,25 @@ +# Security Policies and Procedures + +## Reporting a Bug + +The Express team and community take all security bugs seriously. Thank you +for improving the security of Express. We appreciate your efforts and +responsible disclosure and will make every effort to acknowledge your +contributions. + +Report security bugs by emailing the current owner(s) of `body-parser`. This +information can be found in the npm registry using the command +`npm owner ls body-parser`. +If unsure or unable to get the information from the above, open an issue +in the [project issue tracker](https://github.com/expressjs/body-parser/issues) +asking for the current contact information. + +To ensure the timely response to your report, please ensure that the entirety +of the report is contained within the email body and not solely behind a web +link or an attachment. + +At least one owner will acknowledge your email within 48 hours, and will send a +more detailed response within 48 hours indicating the next steps in handling +your report. After the initial reply to your report, the owners will +endeavor to keep you informed of the progress towards a fix and full +announcement, and may ask for additional information or guidance. diff --git a/node_modules/body-parser/index.js b/node_modules/body-parser/index.js new file mode 100644 index 0000000..bb24d73 --- /dev/null +++ b/node_modules/body-parser/index.js @@ -0,0 +1,156 @@ +/*! + * body-parser + * Copyright(c) 2014-2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module dependencies. + * @private + */ + +var deprecate = require('depd')('body-parser') + +/** + * Cache of loaded parsers. + * @private + */ + +var parsers = Object.create(null) + +/** + * @typedef Parsers + * @type {function} + * @property {function} json + * @property {function} raw + * @property {function} text + * @property {function} urlencoded + */ + +/** + * Module exports. + * @type {Parsers} + */ + +exports = module.exports = deprecate.function(bodyParser, + 'bodyParser: use individual json/urlencoded middlewares') + +/** + * JSON parser. + * @public + */ + +Object.defineProperty(exports, 'json', { + configurable: true, + enumerable: true, + get: createParserGetter('json') +}) + +/** + * Raw parser. + * @public + */ + +Object.defineProperty(exports, 'raw', { + configurable: true, + enumerable: true, + get: createParserGetter('raw') +}) + +/** + * Text parser. + * @public + */ + +Object.defineProperty(exports, 'text', { + configurable: true, + enumerable: true, + get: createParserGetter('text') +}) + +/** + * URL-encoded parser. + * @public + */ + +Object.defineProperty(exports, 'urlencoded', { + configurable: true, + enumerable: true, + get: createParserGetter('urlencoded') +}) + +/** + * Create a middleware to parse json and urlencoded bodies. + * + * @param {object} [options] + * @return {function} + * @deprecated + * @public + */ + +function bodyParser (options) { + // use default type for parsers + var opts = Object.create(options || null, { + type: { + configurable: true, + enumerable: true, + value: undefined, + writable: true + } + }) + + var _urlencoded = exports.urlencoded(opts) + var _json = exports.json(opts) + + return function bodyParser (req, res, next) { + _json(req, res, function (err) { + if (err) return next(err) + _urlencoded(req, res, next) + }) + } +} + +/** + * Create a getter for loading a parser. + * @private + */ + +function createParserGetter (name) { + return function get () { + return loadParser(name) + } +} + +/** + * Load a parser module. + * @private + */ + +function loadParser (parserName) { + var parser = parsers[parserName] + + if (parser !== undefined) { + return parser + } + + // this uses a switch for static require analysis + switch (parserName) { + case 'json': + parser = require('./lib/types/json') + break + case 'raw': + parser = require('./lib/types/raw') + break + case 'text': + parser = require('./lib/types/text') + break + case 'urlencoded': + parser = require('./lib/types/urlencoded') + break + } + + // store to prevent invoking require() + return (parsers[parserName] = parser) +} diff --git a/node_modules/body-parser/lib/read.js b/node_modules/body-parser/lib/read.js new file mode 100644 index 0000000..fce6283 --- /dev/null +++ b/node_modules/body-parser/lib/read.js @@ -0,0 +1,205 @@ +/*! + * body-parser + * Copyright(c) 2014-2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module dependencies. + * @private + */ + +var createError = require('http-errors') +var destroy = require('destroy') +var getBody = require('raw-body') +var iconv = require('iconv-lite') +var onFinished = require('on-finished') +var unpipe = require('unpipe') +var zlib = require('zlib') + +/** + * Module exports. + */ + +module.exports = read + +/** + * Read a request into a buffer and parse. + * + * @param {object} req + * @param {object} res + * @param {function} next + * @param {function} parse + * @param {function} debug + * @param {object} options + * @private + */ + +function read (req, res, next, parse, debug, options) { + var length + var opts = options + var stream + + // flag as parsed + req._body = true + + // read options + var encoding = opts.encoding !== null + ? opts.encoding + : null + var verify = opts.verify + + try { + // get the content stream + stream = contentstream(req, debug, opts.inflate) + length = stream.length + stream.length = undefined + } catch (err) { + return next(err) + } + + // set raw-body options + opts.length = length + opts.encoding = verify + ? null + : encoding + + // assert charset is supported + if (opts.encoding === null && encoding !== null && !iconv.encodingExists(encoding)) { + return next(createError(415, 'unsupported charset "' + encoding.toUpperCase() + '"', { + charset: encoding.toLowerCase(), + type: 'charset.unsupported' + })) + } + + // read body + debug('read body') + getBody(stream, opts, function (error, body) { + if (error) { + var _error + + if (error.type === 'encoding.unsupported') { + // echo back charset + _error = createError(415, 'unsupported charset "' + encoding.toUpperCase() + '"', { + charset: encoding.toLowerCase(), + type: 'charset.unsupported' + }) + } else { + // set status code on error + _error = createError(400, error) + } + + // unpipe from stream and destroy + if (stream !== req) { + unpipe(req) + destroy(stream, true) + } + + // read off entire request + dump(req, function onfinished () { + next(createError(400, _error)) + }) + return + } + + // verify + if (verify) { + try { + debug('verify body') + verify(req, res, body, encoding) + } catch (err) { + next(createError(403, err, { + body: body, + type: err.type || 'entity.verify.failed' + })) + return + } + } + + // parse + var str = body + try { + debug('parse body') + str = typeof body !== 'string' && encoding !== null + ? iconv.decode(body, encoding) + : body + req.body = parse(str) + } catch (err) { + next(createError(400, err, { + body: str, + type: err.type || 'entity.parse.failed' + })) + return + } + + next() + }) +} + +/** + * Get the content stream of the request. + * + * @param {object} req + * @param {function} debug + * @param {boolean} [inflate=true] + * @return {object} + * @api private + */ + +function contentstream (req, debug, inflate) { + var encoding = (req.headers['content-encoding'] || 'identity').toLowerCase() + var length = req.headers['content-length'] + var stream + + debug('content-encoding "%s"', encoding) + + if (inflate === false && encoding !== 'identity') { + throw createError(415, 'content encoding unsupported', { + encoding: encoding, + type: 'encoding.unsupported' + }) + } + + switch (encoding) { + case 'deflate': + stream = zlib.createInflate() + debug('inflate body') + req.pipe(stream) + break + case 'gzip': + stream = zlib.createGunzip() + debug('gunzip body') + req.pipe(stream) + break + case 'identity': + stream = req + stream.length = length + break + default: + throw createError(415, 'unsupported content encoding "' + encoding + '"', { + encoding: encoding, + type: 'encoding.unsupported' + }) + } + + return stream +} + +/** + * Dump the contents of a request. + * + * @param {object} req + * @param {function} callback + * @api private + */ + +function dump (req, callback) { + if (onFinished.isFinished(req)) { + callback(null) + } else { + onFinished(req, callback) + req.resume() + } +} diff --git a/node_modules/body-parser/lib/types/json.js b/node_modules/body-parser/lib/types/json.js new file mode 100644 index 0000000..59f3f7e --- /dev/null +++ b/node_modules/body-parser/lib/types/json.js @@ -0,0 +1,247 @@ +/*! + * body-parser + * Copyright(c) 2014 Jonathan Ong + * Copyright(c) 2014-2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module dependencies. + * @private + */ + +var bytes = require('bytes') +var contentType = require('content-type') +var createError = require('http-errors') +var debug = require('debug')('body-parser:json') +var read = require('../read') +var typeis = require('type-is') + +/** + * Module exports. + */ + +module.exports = json + +/** + * RegExp to match the first non-space in a string. + * + * Allowed whitespace is defined in RFC 7159: + * + * ws = *( + * %x20 / ; Space + * %x09 / ; Horizontal tab + * %x0A / ; Line feed or New line + * %x0D ) ; Carriage return + */ + +var FIRST_CHAR_REGEXP = /^[\x20\x09\x0a\x0d]*([^\x20\x09\x0a\x0d])/ // eslint-disable-line no-control-regex + +var JSON_SYNTAX_CHAR = '#' +var JSON_SYNTAX_REGEXP = /#+/g + +/** + * Create a middleware to parse JSON bodies. + * + * @param {object} [options] + * @return {function} + * @public + */ + +function json (options) { + var opts = options || {} + + var limit = typeof opts.limit !== 'number' + ? bytes.parse(opts.limit || '100kb') + : opts.limit + var inflate = opts.inflate !== false + var reviver = opts.reviver + var strict = opts.strict !== false + var type = opts.type || 'application/json' + var verify = opts.verify || false + + if (verify !== false && typeof verify !== 'function') { + throw new TypeError('option verify must be function') + } + + // create the appropriate type checking function + var shouldParse = typeof type !== 'function' + ? typeChecker(type) + : type + + function parse (body) { + if (body.length === 0) { + // special-case empty json body, as it's a common client-side mistake + // TODO: maybe make this configurable or part of "strict" option + return {} + } + + if (strict) { + var first = firstchar(body) + + if (first !== '{' && first !== '[') { + debug('strict violation') + throw createStrictSyntaxError(body, first) + } + } + + try { + debug('parse json') + return JSON.parse(body, reviver) + } catch (e) { + throw normalizeJsonSyntaxError(e, { + message: e.message, + stack: e.stack + }) + } + } + + return function jsonParser (req, res, next) { + if (req._body) { + debug('body already parsed') + next() + return + } + + req.body = req.body || {} + + // skip requests without bodies + if (!typeis.hasBody(req)) { + debug('skip empty body') + next() + return + } + + debug('content-type %j', req.headers['content-type']) + + // determine if request should be parsed + if (!shouldParse(req)) { + debug('skip parsing') + next() + return + } + + // assert charset per RFC 7159 sec 8.1 + var charset = getCharset(req) || 'utf-8' + if (charset.slice(0, 4) !== 'utf-') { + debug('invalid charset') + next(createError(415, 'unsupported charset "' + charset.toUpperCase() + '"', { + charset: charset, + type: 'charset.unsupported' + })) + return + } + + // read + read(req, res, next, parse, debug, { + encoding: charset, + inflate: inflate, + limit: limit, + verify: verify + }) + } +} + +/** + * Create strict violation syntax error matching native error. + * + * @param {string} str + * @param {string} char + * @return {Error} + * @private + */ + +function createStrictSyntaxError (str, char) { + var index = str.indexOf(char) + var partial = '' + + if (index !== -1) { + partial = str.substring(0, index) + JSON_SYNTAX_CHAR + + for (var i = index + 1; i < str.length; i++) { + partial += JSON_SYNTAX_CHAR + } + } + + try { + JSON.parse(partial); /* istanbul ignore next */ throw new SyntaxError('strict violation') + } catch (e) { + return normalizeJsonSyntaxError(e, { + message: e.message.replace(JSON_SYNTAX_REGEXP, function (placeholder) { + return str.substring(index, index + placeholder.length) + }), + stack: e.stack + }) + } +} + +/** + * Get the first non-whitespace character in a string. + * + * @param {string} str + * @return {function} + * @private + */ + +function firstchar (str) { + var match = FIRST_CHAR_REGEXP.exec(str) + + return match + ? match[1] + : undefined +} + +/** + * Get the charset of a request. + * + * @param {object} req + * @api private + */ + +function getCharset (req) { + try { + return (contentType.parse(req).parameters.charset || '').toLowerCase() + } catch (e) { + return undefined + } +} + +/** + * Normalize a SyntaxError for JSON.parse. + * + * @param {SyntaxError} error + * @param {object} obj + * @return {SyntaxError} + */ + +function normalizeJsonSyntaxError (error, obj) { + var keys = Object.getOwnPropertyNames(error) + + for (var i = 0; i < keys.length; i++) { + var key = keys[i] + if (key !== 'stack' && key !== 'message') { + delete error[key] + } + } + + // replace stack before message for Node.js 0.10 and below + error.stack = obj.stack.replace(error.message, obj.message) + error.message = obj.message + + return error +} + +/** + * Get the simple type checker. + * + * @param {string} type + * @return {function} + */ + +function typeChecker (type) { + return function checkType (req) { + return Boolean(typeis(req, type)) + } +} diff --git a/node_modules/body-parser/lib/types/raw.js b/node_modules/body-parser/lib/types/raw.js new file mode 100644 index 0000000..f5d1b67 --- /dev/null +++ b/node_modules/body-parser/lib/types/raw.js @@ -0,0 +1,101 @@ +/*! + * body-parser + * Copyright(c) 2014-2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module dependencies. + */ + +var bytes = require('bytes') +var debug = require('debug')('body-parser:raw') +var read = require('../read') +var typeis = require('type-is') + +/** + * Module exports. + */ + +module.exports = raw + +/** + * Create a middleware to parse raw bodies. + * + * @param {object} [options] + * @return {function} + * @api public + */ + +function raw (options) { + var opts = options || {} + + var inflate = opts.inflate !== false + var limit = typeof opts.limit !== 'number' + ? bytes.parse(opts.limit || '100kb') + : opts.limit + var type = opts.type || 'application/octet-stream' + var verify = opts.verify || false + + if (verify !== false && typeof verify !== 'function') { + throw new TypeError('option verify must be function') + } + + // create the appropriate type checking function + var shouldParse = typeof type !== 'function' + ? typeChecker(type) + : type + + function parse (buf) { + return buf + } + + return function rawParser (req, res, next) { + if (req._body) { + debug('body already parsed') + next() + return + } + + req.body = req.body || {} + + // skip requests without bodies + if (!typeis.hasBody(req)) { + debug('skip empty body') + next() + return + } + + debug('content-type %j', req.headers['content-type']) + + // determine if request should be parsed + if (!shouldParse(req)) { + debug('skip parsing') + next() + return + } + + // read + read(req, res, next, parse, debug, { + encoding: null, + inflate: inflate, + limit: limit, + verify: verify + }) + } +} + +/** + * Get the simple type checker. + * + * @param {string} type + * @return {function} + */ + +function typeChecker (type) { + return function checkType (req) { + return Boolean(typeis(req, type)) + } +} diff --git a/node_modules/body-parser/lib/types/text.js b/node_modules/body-parser/lib/types/text.js new file mode 100644 index 0000000..083a009 --- /dev/null +++ b/node_modules/body-parser/lib/types/text.js @@ -0,0 +1,121 @@ +/*! + * body-parser + * Copyright(c) 2014-2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module dependencies. + */ + +var bytes = require('bytes') +var contentType = require('content-type') +var debug = require('debug')('body-parser:text') +var read = require('../read') +var typeis = require('type-is') + +/** + * Module exports. + */ + +module.exports = text + +/** + * Create a middleware to parse text bodies. + * + * @param {object} [options] + * @return {function} + * @api public + */ + +function text (options) { + var opts = options || {} + + var defaultCharset = opts.defaultCharset || 'utf-8' + var inflate = opts.inflate !== false + var limit = typeof opts.limit !== 'number' + ? bytes.parse(opts.limit || '100kb') + : opts.limit + var type = opts.type || 'text/plain' + var verify = opts.verify || false + + if (verify !== false && typeof verify !== 'function') { + throw new TypeError('option verify must be function') + } + + // create the appropriate type checking function + var shouldParse = typeof type !== 'function' + ? typeChecker(type) + : type + + function parse (buf) { + return buf + } + + return function textParser (req, res, next) { + if (req._body) { + debug('body already parsed') + next() + return + } + + req.body = req.body || {} + + // skip requests without bodies + if (!typeis.hasBody(req)) { + debug('skip empty body') + next() + return + } + + debug('content-type %j', req.headers['content-type']) + + // determine if request should be parsed + if (!shouldParse(req)) { + debug('skip parsing') + next() + return + } + + // get charset + var charset = getCharset(req) || defaultCharset + + // read + read(req, res, next, parse, debug, { + encoding: charset, + inflate: inflate, + limit: limit, + verify: verify + }) + } +} + +/** + * Get the charset of a request. + * + * @param {object} req + * @api private + */ + +function getCharset (req) { + try { + return (contentType.parse(req).parameters.charset || '').toLowerCase() + } catch (e) { + return undefined + } +} + +/** + * Get the simple type checker. + * + * @param {string} type + * @return {function} + */ + +function typeChecker (type) { + return function checkType (req) { + return Boolean(typeis(req, type)) + } +} diff --git a/node_modules/body-parser/lib/types/urlencoded.js b/node_modules/body-parser/lib/types/urlencoded.js new file mode 100644 index 0000000..2bd4485 --- /dev/null +++ b/node_modules/body-parser/lib/types/urlencoded.js @@ -0,0 +1,307 @@ +/*! + * body-parser + * Copyright(c) 2014 Jonathan Ong + * Copyright(c) 2014-2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module dependencies. + * @private + */ + +var bytes = require('bytes') +var contentType = require('content-type') +var createError = require('http-errors') +var debug = require('debug')('body-parser:urlencoded') +var deprecate = require('depd')('body-parser') +var read = require('../read') +var typeis = require('type-is') + +/** + * Module exports. + */ + +module.exports = urlencoded + +/** + * Cache of parser modules. + */ + +var parsers = Object.create(null) + +/** + * Create a middleware to parse urlencoded bodies. + * + * @param {object} [options] + * @return {function} + * @public + */ + +function urlencoded (options) { + var opts = options || {} + + // notice because option default will flip in next major + if (opts.extended === undefined) { + deprecate('undefined extended: provide extended option') + } + + var extended = opts.extended !== false + var inflate = opts.inflate !== false + var limit = typeof opts.limit !== 'number' + ? bytes.parse(opts.limit || '100kb') + : opts.limit + var type = opts.type || 'application/x-www-form-urlencoded' + var verify = opts.verify || false + var depth = typeof opts.depth !== 'number' + ? Number(opts.depth || 32) + : opts.depth + + if (verify !== false && typeof verify !== 'function') { + throw new TypeError('option verify must be function') + } + + // create the appropriate query parser + var queryparse = extended + ? extendedparser(opts) + : simpleparser(opts) + + // create the appropriate type checking function + var shouldParse = typeof type !== 'function' + ? typeChecker(type) + : type + + function parse (body) { + return body.length + ? queryparse(body) + : {} + } + + return function urlencodedParser (req, res, next) { + if (req._body) { + debug('body already parsed') + next() + return + } + + req.body = req.body || {} + + // skip requests without bodies + if (!typeis.hasBody(req)) { + debug('skip empty body') + next() + return + } + + debug('content-type %j', req.headers['content-type']) + + // determine if request should be parsed + if (!shouldParse(req)) { + debug('skip parsing') + next() + return + } + + // assert charset + var charset = getCharset(req) || 'utf-8' + if (charset !== 'utf-8') { + debug('invalid charset') + next(createError(415, 'unsupported charset "' + charset.toUpperCase() + '"', { + charset: charset, + type: 'charset.unsupported' + })) + return + } + + // read + read(req, res, next, parse, debug, { + debug: debug, + encoding: charset, + inflate: inflate, + limit: limit, + verify: verify, + depth: depth + }) + } +} + +/** + * Get the extended query parser. + * + * @param {object} options + */ + +function extendedparser (options) { + var parameterLimit = options.parameterLimit !== undefined + ? options.parameterLimit + : 1000 + + var depth = typeof options.depth !== 'number' + ? Number(options.depth || 32) + : options.depth + var parse = parser('qs') + + if (isNaN(parameterLimit) || parameterLimit < 1) { + throw new TypeError('option parameterLimit must be a positive number') + } + + if (isNaN(depth) || depth < 0) { + throw new TypeError('option depth must be a zero or a positive number') + } + + if (isFinite(parameterLimit)) { + parameterLimit = parameterLimit | 0 + } + + return function queryparse (body) { + var paramCount = parameterCount(body, parameterLimit) + + if (paramCount === undefined) { + debug('too many parameters') + throw createError(413, 'too many parameters', { + type: 'parameters.too.many' + }) + } + + var arrayLimit = Math.max(100, paramCount) + + debug('parse extended urlencoding') + try { + return parse(body, { + allowPrototypes: true, + arrayLimit: arrayLimit, + depth: depth, + strictDepth: true, + parameterLimit: parameterLimit + }) + } catch (err) { + if (err instanceof RangeError) { + throw createError(400, 'The input exceeded the depth', { + type: 'querystring.parse.rangeError' + }) + } else { + throw err + } + } + } +} + +/** + * Get the charset of a request. + * + * @param {object} req + * @api private + */ + +function getCharset (req) { + try { + return (contentType.parse(req).parameters.charset || '').toLowerCase() + } catch (e) { + return undefined + } +} + +/** + * Count the number of parameters, stopping once limit reached + * + * @param {string} body + * @param {number} limit + * @api private + */ + +function parameterCount (body, limit) { + var count = 0 + var index = 0 + + while ((index = body.indexOf('&', index)) !== -1) { + count++ + index++ + + if (count === limit) { + return undefined + } + } + + return count +} + +/** + * Get parser for module name dynamically. + * + * @param {string} name + * @return {function} + * @api private + */ + +function parser (name) { + var mod = parsers[name] + + if (mod !== undefined) { + return mod.parse + } + + // this uses a switch for static require analysis + switch (name) { + case 'qs': + mod = require('qs') + break + case 'querystring': + mod = require('querystring') + break + } + + // store to prevent invoking require() + parsers[name] = mod + + return mod.parse +} + +/** + * Get the simple query parser. + * + * @param {object} options + */ + +function simpleparser (options) { + var parameterLimit = options.parameterLimit !== undefined + ? options.parameterLimit + : 1000 + var parse = parser('querystring') + + if (isNaN(parameterLimit) || parameterLimit < 1) { + throw new TypeError('option parameterLimit must be a positive number') + } + + if (isFinite(parameterLimit)) { + parameterLimit = parameterLimit | 0 + } + + return function queryparse (body) { + var paramCount = parameterCount(body, parameterLimit) + + if (paramCount === undefined) { + debug('too many parameters') + throw createError(413, 'too many parameters', { + type: 'parameters.too.many' + }) + } + + debug('parse urlencoding') + return parse(body, undefined, undefined, { maxKeys: parameterLimit }) + } +} + +/** + * Get the simple type checker. + * + * @param {string} type + * @return {function} + */ + +function typeChecker (type) { + return function checkType (req) { + return Boolean(typeis(req, type)) + } +} diff --git a/node_modules/body-parser/package.json b/node_modules/body-parser/package.json new file mode 100644 index 0000000..3c9926f --- /dev/null +++ b/node_modules/body-parser/package.json @@ -0,0 +1,56 @@ +{ + "name": "body-parser", + "description": "Node.js body parsing middleware", + "version": "1.20.3", + "contributors": [ + "Douglas Christopher Wilson ", + "Jonathan Ong (http://jongleberry.com)" + ], + "license": "MIT", + "repository": "expressjs/body-parser", + "dependencies": { + "bytes": "3.1.2", + "content-type": "~1.0.5", + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "on-finished": "2.4.1", + "qs": "6.13.0", + "raw-body": "2.5.2", + "type-is": "~1.6.18", + "unpipe": "1.0.0" + }, + "devDependencies": { + "eslint": "8.34.0", + "eslint-config-standard": "14.1.1", + "eslint-plugin-import": "2.27.5", + "eslint-plugin-markdown": "3.0.0", + "eslint-plugin-node": "11.1.0", + "eslint-plugin-promise": "6.1.1", + "eslint-plugin-standard": "4.1.0", + "methods": "1.1.2", + "mocha": "10.2.0", + "nyc": "15.1.0", + "safe-buffer": "5.2.1", + "supertest": "6.3.3" + }, + "files": [ + "lib/", + "LICENSE", + "HISTORY.md", + "SECURITY.md", + "index.js" + ], + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + }, + "scripts": { + "lint": "eslint .", + "test": "mocha --require test/support/env --reporter spec --check-leaks --bail test/", + "test-ci": "nyc --reporter=lcov --reporter=text npm test", + "test-cov": "nyc --reporter=html --reporter=text npm test" + } +} diff --git a/node_modules/bytes/History.md b/node_modules/bytes/History.md new file mode 100644 index 0000000..d60ce0e --- /dev/null +++ b/node_modules/bytes/History.md @@ -0,0 +1,97 @@ +3.1.2 / 2022-01-27 +================== + + * Fix return value for un-parsable strings + +3.1.1 / 2021-11-15 +================== + + * Fix "thousandsSeparator" incorrecting formatting fractional part + +3.1.0 / 2019-01-22 +================== + + * Add petabyte (`pb`) support + +3.0.0 / 2017-08-31 +================== + + * Change "kB" to "KB" in format output + * Remove support for Node.js 0.6 + * Remove support for ComponentJS + +2.5.0 / 2017-03-24 +================== + + * Add option "unit" + +2.4.0 / 2016-06-01 +================== + + * Add option "unitSeparator" + +2.3.0 / 2016-02-15 +================== + + * Drop partial bytes on all parsed units + * Fix non-finite numbers to `.format` to return `null` + * Fix parsing byte string that looks like hex + * perf: hoist regular expressions + +2.2.0 / 2015-11-13 +================== + + * add option "decimalPlaces" + * add option "fixedDecimals" + +2.1.0 / 2015-05-21 +================== + + * add `.format` export + * add `.parse` export + +2.0.2 / 2015-05-20 +================== + + * remove map recreation + * remove unnecessary object construction + +2.0.1 / 2015-05-07 +================== + + * fix browserify require + * remove node.extend dependency + +2.0.0 / 2015-04-12 +================== + + * add option "case" + * add option "thousandsSeparator" + * return "null" on invalid parse input + * support proper round-trip: bytes(bytes(num)) === num + * units no longer case sensitive when parsing + +1.0.0 / 2014-05-05 +================== + + * add negative support. fixes #6 + +0.3.0 / 2014-03-19 +================== + + * added terabyte support + +0.2.1 / 2013-04-01 +================== + + * add .component + +0.2.0 / 2012-10-28 +================== + + * bytes(200).should.eql('200b') + +0.1.0 / 2012-07-04 +================== + + * add bytes to string conversion [yields] diff --git a/node_modules/bytes/LICENSE b/node_modules/bytes/LICENSE new file mode 100644 index 0000000..63e95a9 --- /dev/null +++ b/node_modules/bytes/LICENSE @@ -0,0 +1,23 @@ +(The MIT License) + +Copyright (c) 2012-2014 TJ Holowaychuk +Copyright (c) 2015 Jed Watson + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/bytes/Readme.md b/node_modules/bytes/Readme.md new file mode 100644 index 0000000..5790e23 --- /dev/null +++ b/node_modules/bytes/Readme.md @@ -0,0 +1,152 @@ +# Bytes utility + +[![NPM Version][npm-image]][npm-url] +[![NPM Downloads][downloads-image]][downloads-url] +[![Build Status][ci-image]][ci-url] +[![Test Coverage][coveralls-image]][coveralls-url] + +Utility to parse a string bytes (ex: `1TB`) to bytes (`1099511627776`) and vice-versa. + +## Installation + +This is a [Node.js](https://nodejs.org/en/) module available through the +[npm registry](https://www.npmjs.com/). Installation is done using the +[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally): + +```bash +$ npm install bytes +``` + +## Usage + +```js +var bytes = require('bytes'); +``` + +#### bytes(number|string value, [options]): number|string|null + +Default export function. Delegates to either `bytes.format` or `bytes.parse` based on the type of `value`. + +**Arguments** + +| Name | Type | Description | +|---------|----------|--------------------| +| value | `number`|`string` | Number value to format or string value to parse | +| options | `Object` | Conversion options for `format` | + +**Returns** + +| Name | Type | Description | +|---------|------------------|-------------------------------------------------| +| results | `string`|`number`|`null` | Return null upon error. Numeric value in bytes, or string value otherwise. | + +**Example** + +```js +bytes(1024); +// output: '1KB' + +bytes('1KB'); +// output: 1024 +``` + +#### bytes.format(number value, [options]): string|null + +Format the given value in bytes into a string. If the value is negative, it is kept as such. If it is a float, it is + rounded. + +**Arguments** + +| Name | Type | Description | +|---------|----------|--------------------| +| value | `number` | Value in bytes | +| options | `Object` | Conversion options | + +**Options** + +| Property | Type | Description | +|-------------------|--------|-----------------------------------------------------------------------------------------| +| decimalPlaces | `number`|`null` | Maximum number of decimal places to include in output. Default value to `2`. | +| fixedDecimals | `boolean`|`null` | Whether to always display the maximum number of decimal places. Default value to `false` | +| thousandsSeparator | `string`|`null` | Example of values: `' '`, `','` and `'.'`... Default value to `''`. | +| unit | `string`|`null` | The unit in which the result will be returned (B/KB/MB/GB/TB). Default value to `''` (which means auto detect). | +| unitSeparator | `string`|`null` | Separator to use between number and unit. Default value to `''`. | + +**Returns** + +| Name | Type | Description | +|---------|------------------|-------------------------------------------------| +| results | `string`|`null` | Return null upon error. String value otherwise. | + +**Example** + +```js +bytes.format(1024); +// output: '1KB' + +bytes.format(1000); +// output: '1000B' + +bytes.format(1000, {thousandsSeparator: ' '}); +// output: '1 000B' + +bytes.format(1024 * 1.7, {decimalPlaces: 0}); +// output: '2KB' + +bytes.format(1024, {unitSeparator: ' '}); +// output: '1 KB' +``` + +#### bytes.parse(string|number value): number|null + +Parse the string value into an integer in bytes. If no unit is given, or `value` +is a number, it is assumed the value is in bytes. + +Supported units and abbreviations are as follows and are case-insensitive: + + * `b` for bytes + * `kb` for kilobytes + * `mb` for megabytes + * `gb` for gigabytes + * `tb` for terabytes + * `pb` for petabytes + +The units are in powers of two, not ten. This means 1kb = 1024b according to this parser. + +**Arguments** + +| Name | Type | Description | +|---------------|--------|--------------------| +| value | `string`|`number` | String to parse, or number in bytes. | + +**Returns** + +| Name | Type | Description | +|---------|-------------|-------------------------| +| results | `number`|`null` | Return null upon error. Value in bytes otherwise. | + +**Example** + +```js +bytes.parse('1KB'); +// output: 1024 + +bytes.parse('1024'); +// output: 1024 + +bytes.parse(1024); +// output: 1024 +``` + +## License + +[MIT](LICENSE) + +[ci-image]: https://badgen.net/github/checks/visionmedia/bytes.js/master?label=ci +[ci-url]: https://github.com/visionmedia/bytes.js/actions?query=workflow%3Aci +[coveralls-image]: https://badgen.net/coveralls/c/github/visionmedia/bytes.js/master +[coveralls-url]: https://coveralls.io/r/visionmedia/bytes.js?branch=master +[downloads-image]: https://badgen.net/npm/dm/bytes +[downloads-url]: https://npmjs.org/package/bytes +[npm-image]: https://badgen.net/npm/v/bytes +[npm-url]: https://npmjs.org/package/bytes diff --git a/node_modules/bytes/index.js b/node_modules/bytes/index.js new file mode 100644 index 0000000..6f2d0f8 --- /dev/null +++ b/node_modules/bytes/index.js @@ -0,0 +1,170 @@ +/*! + * bytes + * Copyright(c) 2012-2014 TJ Holowaychuk + * Copyright(c) 2015 Jed Watson + * MIT Licensed + */ + +'use strict'; + +/** + * Module exports. + * @public + */ + +module.exports = bytes; +module.exports.format = format; +module.exports.parse = parse; + +/** + * Module variables. + * @private + */ + +var formatThousandsRegExp = /\B(?=(\d{3})+(?!\d))/g; + +var formatDecimalsRegExp = /(?:\.0*|(\.[^0]+)0+)$/; + +var map = { + b: 1, + kb: 1 << 10, + mb: 1 << 20, + gb: 1 << 30, + tb: Math.pow(1024, 4), + pb: Math.pow(1024, 5), +}; + +var parseRegExp = /^((-|\+)?(\d+(?:\.\d+)?)) *(kb|mb|gb|tb|pb)$/i; + +/** + * Convert the given value in bytes into a string or parse to string to an integer in bytes. + * + * @param {string|number} value + * @param {{ + * case: [string], + * decimalPlaces: [number] + * fixedDecimals: [boolean] + * thousandsSeparator: [string] + * unitSeparator: [string] + * }} [options] bytes options. + * + * @returns {string|number|null} + */ + +function bytes(value, options) { + if (typeof value === 'string') { + return parse(value); + } + + if (typeof value === 'number') { + return format(value, options); + } + + return null; +} + +/** + * Format the given value in bytes into a string. + * + * If the value is negative, it is kept as such. If it is a float, + * it is rounded. + * + * @param {number} value + * @param {object} [options] + * @param {number} [options.decimalPlaces=2] + * @param {number} [options.fixedDecimals=false] + * @param {string} [options.thousandsSeparator=] + * @param {string} [options.unit=] + * @param {string} [options.unitSeparator=] + * + * @returns {string|null} + * @public + */ + +function format(value, options) { + if (!Number.isFinite(value)) { + return null; + } + + var mag = Math.abs(value); + var thousandsSeparator = (options && options.thousandsSeparator) || ''; + var unitSeparator = (options && options.unitSeparator) || ''; + var decimalPlaces = (options && options.decimalPlaces !== undefined) ? options.decimalPlaces : 2; + var fixedDecimals = Boolean(options && options.fixedDecimals); + var unit = (options && options.unit) || ''; + + if (!unit || !map[unit.toLowerCase()]) { + if (mag >= map.pb) { + unit = 'PB'; + } else if (mag >= map.tb) { + unit = 'TB'; + } else if (mag >= map.gb) { + unit = 'GB'; + } else if (mag >= map.mb) { + unit = 'MB'; + } else if (mag >= map.kb) { + unit = 'KB'; + } else { + unit = 'B'; + } + } + + var val = value / map[unit.toLowerCase()]; + var str = val.toFixed(decimalPlaces); + + if (!fixedDecimals) { + str = str.replace(formatDecimalsRegExp, '$1'); + } + + if (thousandsSeparator) { + str = str.split('.').map(function (s, i) { + return i === 0 + ? s.replace(formatThousandsRegExp, thousandsSeparator) + : s + }).join('.'); + } + + return str + unitSeparator + unit; +} + +/** + * Parse the string value into an integer in bytes. + * + * If no unit is given, it is assumed the value is in bytes. + * + * @param {number|string} val + * + * @returns {number|null} + * @public + */ + +function parse(val) { + if (typeof val === 'number' && !isNaN(val)) { + return val; + } + + if (typeof val !== 'string') { + return null; + } + + // Test if the string passed is valid + var results = parseRegExp.exec(val); + var floatValue; + var unit = 'b'; + + if (!results) { + // Nothing could be extracted from the given string + floatValue = parseInt(val, 10); + unit = 'b' + } else { + // Retrieve the value and the unit + floatValue = parseFloat(results[1]); + unit = results[4].toLowerCase(); + } + + if (isNaN(floatValue)) { + return null; + } + + return Math.floor(map[unit] * floatValue); +} diff --git a/node_modules/bytes/package.json b/node_modules/bytes/package.json new file mode 100644 index 0000000..f2b6a8b --- /dev/null +++ b/node_modules/bytes/package.json @@ -0,0 +1,42 @@ +{ + "name": "bytes", + "description": "Utility to parse a string bytes to bytes and vice-versa", + "version": "3.1.2", + "author": "TJ Holowaychuk (http://tjholowaychuk.com)", + "contributors": [ + "Jed Watson ", + "Théo FIDRY " + ], + "license": "MIT", + "keywords": [ + "byte", + "bytes", + "utility", + "parse", + "parser", + "convert", + "converter" + ], + "repository": "visionmedia/bytes.js", + "devDependencies": { + "eslint": "7.32.0", + "eslint-plugin-markdown": "2.2.1", + "mocha": "9.2.0", + "nyc": "15.1.0" + }, + "files": [ + "History.md", + "LICENSE", + "Readme.md", + "index.js" + ], + "engines": { + "node": ">= 0.8" + }, + "scripts": { + "lint": "eslint .", + "test": "mocha --check-leaks --reporter spec", + "test-ci": "nyc --reporter=lcov --reporter=text npm test", + "test-cov": "nyc --reporter=html --reporter=text npm test" + } +} diff --git a/node_modules/call-bind-apply-helpers/.eslintrc b/node_modules/call-bind-apply-helpers/.eslintrc new file mode 100644 index 0000000..201e859 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/.eslintrc @@ -0,0 +1,17 @@ +{ + "root": true, + + "extends": "@ljharb", + + "rules": { + "func-name-matching": 0, + "id-length": 0, + "new-cap": [2, { + "capIsNewExceptions": [ + "GetIntrinsic", + ], + }], + "no-extra-parens": 0, + "no-magic-numbers": 0, + }, +} diff --git a/node_modules/call-bind-apply-helpers/.github/FUNDING.yml b/node_modules/call-bind-apply-helpers/.github/FUNDING.yml new file mode 100644 index 0000000..0011e9d --- /dev/null +++ b/node_modules/call-bind-apply-helpers/.github/FUNDING.yml @@ -0,0 +1,12 @@ +# These are supported funding model platforms + +github: [ljharb] +patreon: # Replace with a single Patreon username +open_collective: # Replace with a single Open Collective username +ko_fi: # Replace with a single Ko-fi username +tidelift: npm/call-bind-apply-helpers +community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry +liberapay: # Replace with a single Liberapay username +issuehunt: # Replace with a single IssueHunt username +otechie: # Replace with a single Otechie username +custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] diff --git a/node_modules/call-bind-apply-helpers/.nycrc b/node_modules/call-bind-apply-helpers/.nycrc new file mode 100644 index 0000000..bdd626c --- /dev/null +++ b/node_modules/call-bind-apply-helpers/.nycrc @@ -0,0 +1,9 @@ +{ + "all": true, + "check-coverage": false, + "reporter": ["text-summary", "text", "html", "json"], + "exclude": [ + "coverage", + "test" + ] +} diff --git a/node_modules/call-bind-apply-helpers/CHANGELOG.md b/node_modules/call-bind-apply-helpers/CHANGELOG.md new file mode 100644 index 0000000..2484942 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/CHANGELOG.md @@ -0,0 +1,30 @@ +# Changelog + +All notable changes to this project will be documented in this file. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +## [v1.0.2](https://github.com/ljharb/call-bind-apply-helpers/compare/v1.0.1...v1.0.2) - 2025-02-12 + +### Commits + +- [types] improve inferred types [`e6f9586`](https://github.com/ljharb/call-bind-apply-helpers/commit/e6f95860a3c72879cb861a858cdfb8138fbedec1) +- [Dev Deps] update `@arethetypeswrong/cli`, `@ljharb/tsconfig`, `@types/tape`, `es-value-fixtures`, `for-each`, `has-strict-mode`, `object-inspect` [`e43d540`](https://github.com/ljharb/call-bind-apply-helpers/commit/e43d5409f97543bfbb11f345d47d8ce4e066d8c1) + +## [v1.0.1](https://github.com/ljharb/call-bind-apply-helpers/compare/v1.0.0...v1.0.1) - 2024-12-08 + +### Commits + +- [types] `reflectApply`: fix types [`4efc396`](https://github.com/ljharb/call-bind-apply-helpers/commit/4efc3965351a4f02cc55e836fa391d3d11ef2ef8) +- [Fix] `reflectApply`: oops, Reflect is not a function [`83cc739`](https://github.com/ljharb/call-bind-apply-helpers/commit/83cc7395de6b79b7730bdf092f1436f0b1263c75) +- [Dev Deps] update `@arethetypeswrong/cli` [`80bd5d3`](https://github.com/ljharb/call-bind-apply-helpers/commit/80bd5d3ae58b4f6b6995ce439dd5a1bcb178a940) + +## v1.0.0 - 2024-12-05 + +### Commits + +- Initial implementation, tests, readme [`7879629`](https://github.com/ljharb/call-bind-apply-helpers/commit/78796290f9b7430c9934d6f33d94ae9bc89fce04) +- Initial commit [`3f1dc16`](https://github.com/ljharb/call-bind-apply-helpers/commit/3f1dc164afc43285631b114a5f9dd9137b2b952f) +- npm init [`081df04`](https://github.com/ljharb/call-bind-apply-helpers/commit/081df048c312fcee400922026f6e97281200a603) +- Only apps should have lockfiles [`5b9ca0f`](https://github.com/ljharb/call-bind-apply-helpers/commit/5b9ca0fe8101ebfaf309c549caac4e0a017ed930) diff --git a/node_modules/call-bind-apply-helpers/LICENSE b/node_modules/call-bind-apply-helpers/LICENSE new file mode 100644 index 0000000..f82f389 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2024 Jordan Harband + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/node_modules/call-bind-apply-helpers/README.md b/node_modules/call-bind-apply-helpers/README.md new file mode 100644 index 0000000..8fc0dae --- /dev/null +++ b/node_modules/call-bind-apply-helpers/README.md @@ -0,0 +1,62 @@ +# call-bind-apply-helpers [![Version Badge][npm-version-svg]][package-url] + +[![github actions][actions-image]][actions-url] +[![coverage][codecov-image]][codecov-url] +[![dependency status][deps-svg]][deps-url] +[![dev dependency status][dev-deps-svg]][dev-deps-url] +[![License][license-image]][license-url] +[![Downloads][downloads-image]][downloads-url] + +[![npm badge][npm-badge-png]][package-url] + +Helper functions around Function call/apply/bind, for use in `call-bind`. + +The only packages that should likely ever use this package directly are `call-bind` and `get-intrinsic`. +Please use `call-bind` unless you have a very good reason not to. + +## Getting started + +```sh +npm install --save call-bind-apply-helpers +``` + +## Usage/Examples + +```js +const assert = require('assert'); +const callBindBasic = require('call-bind-apply-helpers'); + +function f(a, b) { + assert.equal(this, 1); + assert.equal(a, 2); + assert.equal(b, 3); + assert.equal(arguments.length, 2); +} + +const fBound = callBindBasic([f, 1]); + +delete Function.prototype.call; +delete Function.prototype.bind; + +fBound(2, 3); +``` + +## Tests + +Clone the repo, `npm install`, and run `npm test` + +[package-url]: https://npmjs.org/package/call-bind-apply-helpers +[npm-version-svg]: https://versionbadg.es/ljharb/call-bind-apply-helpers.svg +[deps-svg]: https://david-dm.org/ljharb/call-bind-apply-helpers.svg +[deps-url]: https://david-dm.org/ljharb/call-bind-apply-helpers +[dev-deps-svg]: https://david-dm.org/ljharb/call-bind-apply-helpers/dev-status.svg +[dev-deps-url]: https://david-dm.org/ljharb/call-bind-apply-helpers#info=devDependencies +[npm-badge-png]: https://nodei.co/npm/call-bind-apply-helpers.png?downloads=true&stars=true +[license-image]: https://img.shields.io/npm/l/call-bind-apply-helpers.svg +[license-url]: LICENSE +[downloads-image]: https://img.shields.io/npm/dm/call-bind-apply-helpers.svg +[downloads-url]: https://npm-stat.com/charts.html?package=call-bind-apply-helpers +[codecov-image]: https://codecov.io/gh/ljharb/call-bind-apply-helpers/branch/main/graphs/badge.svg +[codecov-url]: https://app.codecov.io/gh/ljharb/call-bind-apply-helpers/ +[actions-image]: https://img.shields.io/endpoint?url=https://github-actions-badge-u3jn4tfpocch.runkit.sh/ljharb/call-bind-apply-helpers +[actions-url]: https://github.com/ljharb/call-bind-apply-helpers/actions diff --git a/node_modules/call-bind-apply-helpers/actualApply.d.ts b/node_modules/call-bind-apply-helpers/actualApply.d.ts new file mode 100644 index 0000000..b87286a --- /dev/null +++ b/node_modules/call-bind-apply-helpers/actualApply.d.ts @@ -0,0 +1 @@ +export = Reflect.apply; \ No newline at end of file diff --git a/node_modules/call-bind-apply-helpers/actualApply.js b/node_modules/call-bind-apply-helpers/actualApply.js new file mode 100644 index 0000000..ffa5135 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/actualApply.js @@ -0,0 +1,10 @@ +'use strict'; + +var bind = require('function-bind'); + +var $apply = require('./functionApply'); +var $call = require('./functionCall'); +var $reflectApply = require('./reflectApply'); + +/** @type {import('./actualApply')} */ +module.exports = $reflectApply || bind.call($call, $apply); diff --git a/node_modules/call-bind-apply-helpers/applyBind.d.ts b/node_modules/call-bind-apply-helpers/applyBind.d.ts new file mode 100644 index 0000000..d176c1a --- /dev/null +++ b/node_modules/call-bind-apply-helpers/applyBind.d.ts @@ -0,0 +1,19 @@ +import actualApply from './actualApply'; + +type TupleSplitHead = T['length'] extends N + ? T + : T extends [...infer R, any] + ? TupleSplitHead + : never + +type TupleSplitTail = O['length'] extends N + ? T + : T extends [infer F, ...infer R] + ? TupleSplitTail<[...R], N, [...O, F]> + : never + +type TupleSplit = [TupleSplitHead, TupleSplitTail] + +declare function applyBind(...args: TupleSplit, 2>[1]): ReturnType; + +export = applyBind; \ No newline at end of file diff --git a/node_modules/call-bind-apply-helpers/applyBind.js b/node_modules/call-bind-apply-helpers/applyBind.js new file mode 100644 index 0000000..d2b7723 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/applyBind.js @@ -0,0 +1,10 @@ +'use strict'; + +var bind = require('function-bind'); +var $apply = require('./functionApply'); +var actualApply = require('./actualApply'); + +/** @type {import('./applyBind')} */ +module.exports = function applyBind() { + return actualApply(bind, $apply, arguments); +}; diff --git a/node_modules/call-bind-apply-helpers/functionApply.d.ts b/node_modules/call-bind-apply-helpers/functionApply.d.ts new file mode 100644 index 0000000..1f6e11b --- /dev/null +++ b/node_modules/call-bind-apply-helpers/functionApply.d.ts @@ -0,0 +1 @@ +export = Function.prototype.apply; \ No newline at end of file diff --git a/node_modules/call-bind-apply-helpers/functionApply.js b/node_modules/call-bind-apply-helpers/functionApply.js new file mode 100644 index 0000000..c71df9c --- /dev/null +++ b/node_modules/call-bind-apply-helpers/functionApply.js @@ -0,0 +1,4 @@ +'use strict'; + +/** @type {import('./functionApply')} */ +module.exports = Function.prototype.apply; diff --git a/node_modules/call-bind-apply-helpers/functionCall.d.ts b/node_modules/call-bind-apply-helpers/functionCall.d.ts new file mode 100644 index 0000000..15e93df --- /dev/null +++ b/node_modules/call-bind-apply-helpers/functionCall.d.ts @@ -0,0 +1 @@ +export = Function.prototype.call; \ No newline at end of file diff --git a/node_modules/call-bind-apply-helpers/functionCall.js b/node_modules/call-bind-apply-helpers/functionCall.js new file mode 100644 index 0000000..7a8d873 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/functionCall.js @@ -0,0 +1,4 @@ +'use strict'; + +/** @type {import('./functionCall')} */ +module.exports = Function.prototype.call; diff --git a/node_modules/call-bind-apply-helpers/index.d.ts b/node_modules/call-bind-apply-helpers/index.d.ts new file mode 100644 index 0000000..541516b --- /dev/null +++ b/node_modules/call-bind-apply-helpers/index.d.ts @@ -0,0 +1,64 @@ +type RemoveFromTuple< + Tuple extends readonly unknown[], + RemoveCount extends number, + Index extends 1[] = [] +> = Index["length"] extends RemoveCount + ? Tuple + : Tuple extends [infer First, ...infer Rest] + ? RemoveFromTuple + : Tuple; + +type ConcatTuples< + Prefix extends readonly unknown[], + Suffix extends readonly unknown[] +> = [...Prefix, ...Suffix]; + +type ExtractFunctionParams = T extends (this: infer TThis, ...args: infer P extends readonly unknown[]) => infer R + ? { thisArg: TThis; params: P; returnType: R } + : never; + +type BindFunction< + T extends (this: any, ...args: any[]) => any, + TThis, + TBoundArgs extends readonly unknown[], + ReceiverBound extends boolean +> = ExtractFunctionParams extends { + thisArg: infer OrigThis; + params: infer P extends readonly unknown[]; + returnType: infer R; +} + ? ReceiverBound extends true + ? (...args: RemoveFromTuple>) => R extends [OrigThis, ...infer Rest] + ? [TThis, ...Rest] // Replace `this` with `thisArg` + : R + : >>( + thisArg: U, + ...args: RemainingArgs + ) => R extends [OrigThis, ...infer Rest] + ? [U, ...ConcatTuples] // Preserve bound args in return type + : R + : never; + +declare function callBind< + const T extends (this: any, ...args: any[]) => any, + Extracted extends ExtractFunctionParams, + const TBoundArgs extends Partial & readonly unknown[], + const TThis extends Extracted["thisArg"] +>( + args: [fn: T, thisArg: TThis, ...boundArgs: TBoundArgs] +): BindFunction; + +declare function callBind< + const T extends (this: any, ...args: any[]) => any, + Extracted extends ExtractFunctionParams, + const TBoundArgs extends Partial & readonly unknown[] +>( + args: [fn: T, ...boundArgs: TBoundArgs] +): BindFunction; + +declare function callBind( + args: [fn: Exclude, ...rest: TArgs] +): never; + +// export as namespace callBind; +export = callBind; diff --git a/node_modules/call-bind-apply-helpers/index.js b/node_modules/call-bind-apply-helpers/index.js new file mode 100644 index 0000000..2f6dab4 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/index.js @@ -0,0 +1,15 @@ +'use strict'; + +var bind = require('function-bind'); +var $TypeError = require('es-errors/type'); + +var $call = require('./functionCall'); +var $actualApply = require('./actualApply'); + +/** @type {(args: [Function, thisArg?: unknown, ...args: unknown[]]) => Function} TODO FIXME, find a way to use import('.') */ +module.exports = function callBindBasic(args) { + if (args.length < 1 || typeof args[0] !== 'function') { + throw new $TypeError('a function is required'); + } + return $actualApply(bind, $call, args); +}; diff --git a/node_modules/call-bind-apply-helpers/package.json b/node_modules/call-bind-apply-helpers/package.json new file mode 100644 index 0000000..923b8be --- /dev/null +++ b/node_modules/call-bind-apply-helpers/package.json @@ -0,0 +1,85 @@ +{ + "name": "call-bind-apply-helpers", + "version": "1.0.2", + "description": "Helper functions around Function call/apply/bind, for use in `call-bind`", + "main": "index.js", + "exports": { + ".": "./index.js", + "./actualApply": "./actualApply.js", + "./applyBind": "./applyBind.js", + "./functionApply": "./functionApply.js", + "./functionCall": "./functionCall.js", + "./reflectApply": "./reflectApply.js", + "./package.json": "./package.json" + }, + "scripts": { + "prepack": "npmignore --auto --commentLines=auto", + "prepublish": "not-in-publish || npm run prepublishOnly", + "prepublishOnly": "safe-publish-latest", + "prelint": "evalmd README.md", + "lint": "eslint --ext=.js,.mjs .", + "postlint": "tsc -p . && attw -P", + "pretest": "npm run lint", + "tests-only": "nyc tape 'test/**/*.js'", + "test": "npm run tests-only", + "posttest": "npx npm@'>=10.2' audit --production", + "version": "auto-changelog && git add CHANGELOG.md", + "postversion": "auto-changelog && git add CHANGELOG.md && git commit --no-edit --amend && git tag -f \"v$(node -e \"console.log(require('./package.json').version)\")\"" + }, + "repository": { + "type": "git", + "url": "git+https://github.com/ljharb/call-bind-apply-helpers.git" + }, + "author": "Jordan Harband ", + "license": "MIT", + "bugs": { + "url": "https://github.com/ljharb/call-bind-apply-helpers/issues" + }, + "homepage": "https://github.com/ljharb/call-bind-apply-helpers#readme", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "devDependencies": { + "@arethetypeswrong/cli": "^0.17.3", + "@ljharb/eslint-config": "^21.1.1", + "@ljharb/tsconfig": "^0.2.3", + "@types/for-each": "^0.3.3", + "@types/function-bind": "^1.1.10", + "@types/object-inspect": "^1.13.0", + "@types/tape": "^5.8.1", + "auto-changelog": "^2.5.0", + "encoding": "^0.1.13", + "es-value-fixtures": "^1.7.1", + "eslint": "=8.8.0", + "evalmd": "^0.0.19", + "for-each": "^0.3.5", + "has-strict-mode": "^1.1.0", + "in-publish": "^2.0.1", + "npmignore": "^0.3.1", + "nyc": "^10.3.2", + "object-inspect": "^1.13.4", + "safe-publish-latest": "^2.0.0", + "tape": "^5.9.0", + "typescript": "next" + }, + "testling": { + "files": "test/index.js" + }, + "auto-changelog": { + "output": "CHANGELOG.md", + "template": "keepachangelog", + "unreleased": false, + "commitLimit": false, + "backfillLimit": false, + "hideCredit": true + }, + "publishConfig": { + "ignore": [ + ".github/workflows" + ] + }, + "engines": { + "node": ">= 0.4" + } +} diff --git a/node_modules/call-bind-apply-helpers/reflectApply.d.ts b/node_modules/call-bind-apply-helpers/reflectApply.d.ts new file mode 100644 index 0000000..6b2ae76 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/reflectApply.d.ts @@ -0,0 +1,3 @@ +declare const reflectApply: false | typeof Reflect.apply; + +export = reflectApply; diff --git a/node_modules/call-bind-apply-helpers/reflectApply.js b/node_modules/call-bind-apply-helpers/reflectApply.js new file mode 100644 index 0000000..3d03caa --- /dev/null +++ b/node_modules/call-bind-apply-helpers/reflectApply.js @@ -0,0 +1,4 @@ +'use strict'; + +/** @type {import('./reflectApply')} */ +module.exports = typeof Reflect !== 'undefined' && Reflect && Reflect.apply; diff --git a/node_modules/call-bind-apply-helpers/test/index.js b/node_modules/call-bind-apply-helpers/test/index.js new file mode 100644 index 0000000..1cdc89e --- /dev/null +++ b/node_modules/call-bind-apply-helpers/test/index.js @@ -0,0 +1,63 @@ +'use strict'; + +var callBind = require('../'); +var hasStrictMode = require('has-strict-mode')(); +var forEach = require('for-each'); +var inspect = require('object-inspect'); +var v = require('es-value-fixtures'); + +var test = require('tape'); + +test('callBindBasic', function (t) { + forEach(v.nonFunctions, function (nonFunction) { + t['throws']( + // @ts-expect-error + function () { callBind([nonFunction]); }, + TypeError, + inspect(nonFunction) + ' is not a function' + ); + }); + + var sentinel = { sentinel: true }; + /** @type {(this: T, a: A, b: B) => [T | undefined, A, B]} */ + var func = function (a, b) { + // eslint-disable-next-line no-invalid-this + return [!hasStrictMode && this === global ? undefined : this, a, b]; + }; + t.equal(func.length, 2, 'original function length is 2'); + + /** type {(thisArg: unknown, a: number, b: number) => [unknown, number, number]} */ + var bound = callBind([func]); + /** type {((a: number, b: number) => [typeof sentinel, typeof a, typeof b])} */ + var boundR = callBind([func, sentinel]); + /** type {((b: number) => [typeof sentinel, number, typeof b])} */ + var boundArg = callBind([func, sentinel, /** @type {const} */ (1)]); + + // @ts-expect-error + t.deepEqual(bound(), [undefined, undefined, undefined], 'bound func with no args'); + + // @ts-expect-error + t.deepEqual(func(), [undefined, undefined, undefined], 'unbound func with too few args'); + // @ts-expect-error + t.deepEqual(bound(1, 2), [hasStrictMode ? 1 : Object(1), 2, undefined], 'bound func too few args'); + // @ts-expect-error + t.deepEqual(boundR(), [sentinel, undefined, undefined], 'bound func with receiver, with too few args'); + // @ts-expect-error + t.deepEqual(boundArg(), [sentinel, 1, undefined], 'bound func with receiver and arg, with too few args'); + + t.deepEqual(func(1, 2), [undefined, 1, 2], 'unbound func with right args'); + t.deepEqual(bound(1, 2, 3), [hasStrictMode ? 1 : Object(1), 2, 3], 'bound func with right args'); + t.deepEqual(boundR(1, 2), [sentinel, 1, 2], 'bound func with receiver, with right args'); + t.deepEqual(boundArg(2), [sentinel, 1, 2], 'bound func with receiver and arg, with right arg'); + + // @ts-expect-error + t.deepEqual(func(1, 2, 3), [undefined, 1, 2], 'unbound func with too many args'); + // @ts-expect-error + t.deepEqual(bound(1, 2, 3, 4), [hasStrictMode ? 1 : Object(1), 2, 3], 'bound func with too many args'); + // @ts-expect-error + t.deepEqual(boundR(1, 2, 3), [sentinel, 1, 2], 'bound func with receiver, with too many args'); + // @ts-expect-error + t.deepEqual(boundArg(2, 3), [sentinel, 1, 2], 'bound func with receiver and arg, with too many args'); + + t.end(); +}); diff --git a/node_modules/call-bind-apply-helpers/tsconfig.json b/node_modules/call-bind-apply-helpers/tsconfig.json new file mode 100644 index 0000000..aef9993 --- /dev/null +++ b/node_modules/call-bind-apply-helpers/tsconfig.json @@ -0,0 +1,9 @@ +{ + "extends": "@ljharb/tsconfig", + "compilerOptions": { + "target": "es2021", + }, + "exclude": [ + "coverage", + ], +} \ No newline at end of file diff --git a/node_modules/call-bound/.eslintrc b/node_modules/call-bound/.eslintrc new file mode 100644 index 0000000..2612ed8 --- /dev/null +++ b/node_modules/call-bound/.eslintrc @@ -0,0 +1,13 @@ +{ + "root": true, + + "extends": "@ljharb", + + "rules": { + "new-cap": [2, { + "capIsNewExceptions": [ + "GetIntrinsic", + ], + }], + }, +} diff --git a/node_modules/call-bound/.github/FUNDING.yml b/node_modules/call-bound/.github/FUNDING.yml new file mode 100644 index 0000000..2a2a135 --- /dev/null +++ b/node_modules/call-bound/.github/FUNDING.yml @@ -0,0 +1,12 @@ +# These are supported funding model platforms + +github: [ljharb] +patreon: # Replace with a single Patreon username +open_collective: # Replace with a single Open Collective username +ko_fi: # Replace with a single Ko-fi username +tidelift: npm/call-bound +community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry +liberapay: # Replace with a single Liberapay username +issuehunt: # Replace with a single IssueHunt username +otechie: # Replace with a single Otechie username +custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] diff --git a/node_modules/call-bound/.nycrc b/node_modules/call-bound/.nycrc new file mode 100644 index 0000000..bdd626c --- /dev/null +++ b/node_modules/call-bound/.nycrc @@ -0,0 +1,9 @@ +{ + "all": true, + "check-coverage": false, + "reporter": ["text-summary", "text", "html", "json"], + "exclude": [ + "coverage", + "test" + ] +} diff --git a/node_modules/call-bound/CHANGELOG.md b/node_modules/call-bound/CHANGELOG.md new file mode 100644 index 0000000..8bde4e9 --- /dev/null +++ b/node_modules/call-bound/CHANGELOG.md @@ -0,0 +1,42 @@ +# Changelog + +All notable changes to this project will be documented in this file. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +## [v1.0.4](https://github.com/ljharb/call-bound/compare/v1.0.3...v1.0.4) - 2025-03-03 + +### Commits + +- [types] improve types [`e648922`](https://github.com/ljharb/call-bound/commit/e6489222a9e54f350fbf952ceabe51fd8b6027ff) +- [Dev Deps] update `@arethetypeswrong/cli`, `@ljharb/tsconfig`, `@types/tape`, `es-value-fixtures`, `for-each`, `has-strict-mode`, `object-inspect` [`a42a5eb`](https://github.com/ljharb/call-bound/commit/a42a5ebe6c1b54fcdc7997c7dc64fdca9e936719) +- [Deps] update `call-bind-apply-helpers`, `get-intrinsic` [`f529eac`](https://github.com/ljharb/call-bound/commit/f529eac132404c17156bbc23ab2297a25d0f20b8) + +## [v1.0.3](https://github.com/ljharb/call-bound/compare/v1.0.2...v1.0.3) - 2024-12-15 + +### Commits + +- [Refactor] use `call-bind-apply-helpers` instead of `call-bind` [`5e0b134`](https://github.com/ljharb/call-bound/commit/5e0b13496df14fb7d05dae9412f088da8d3f75be) +- [Deps] update `get-intrinsic` [`41fc967`](https://github.com/ljharb/call-bound/commit/41fc96732a22c7b7e8f381f93ccc54bb6293be2e) +- [readme] fix example [`79a0137`](https://github.com/ljharb/call-bound/commit/79a0137723f7c6d09c9c05452bbf8d5efb5d6e49) +- [meta] add `sideEffects` flag [`08b07be`](https://github.com/ljharb/call-bound/commit/08b07be7f1c03f67dc6f3cdaf0906259771859f7) + +## [v1.0.2](https://github.com/ljharb/call-bound/compare/v1.0.1...v1.0.2) - 2024-12-10 + +### Commits + +- [Dev Deps] update `@arethetypeswrong/cli`, `@ljharb/tsconfig`, `gopd` [`e6a5ffe`](https://github.com/ljharb/call-bound/commit/e6a5ffe849368fe4f74dfd6cdeca1b9baa39e8d5) +- [Deps] update `call-bind`, `get-intrinsic` [`2aeb5b5`](https://github.com/ljharb/call-bound/commit/2aeb5b521dc2b2683d1345c753ea1161de2d1c14) +- [types] improve return type [`1a0c9fe`](https://github.com/ljharb/call-bound/commit/1a0c9fe3114471e7ca1f57d104e2efe713bb4871) + +## v1.0.1 - 2024-12-05 + +### Commits + +- Initial implementation, tests, readme, types [`6d94121`](https://github.com/ljharb/call-bound/commit/6d94121a9243602e506334069f7a03189fe3363d) +- Initial commit [`0eae867`](https://github.com/ljharb/call-bound/commit/0eae867334ea025c33e6e91cdecfc9df96680cf9) +- npm init [`71b2479`](https://github.com/ljharb/call-bound/commit/71b2479c6723e0b7d91a6b663613067e98b7b275) +- Only apps should have lockfiles [`c3754a9`](https://github.com/ljharb/call-bound/commit/c3754a949b7f9132b47e2d18c1729889736741eb) +- [actions] skip `npm ls` in node < 10 [`74275a5`](https://github.com/ljharb/call-bound/commit/74275a5186b8caf6309b6b97472bdcb0df4683a8) +- [Dev Deps] add missing peer dep [`1354de8`](https://github.com/ljharb/call-bound/commit/1354de8679413e4ae9c523d85f76fa7a5e032d97) diff --git a/node_modules/call-bound/LICENSE b/node_modules/call-bound/LICENSE new file mode 100644 index 0000000..f82f389 --- /dev/null +++ b/node_modules/call-bound/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2024 Jordan Harband + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/node_modules/call-bound/README.md b/node_modules/call-bound/README.md new file mode 100644 index 0000000..a44e43e --- /dev/null +++ b/node_modules/call-bound/README.md @@ -0,0 +1,53 @@ +# call-bound [![Version Badge][npm-version-svg]][package-url] + +[![github actions][actions-image]][actions-url] +[![coverage][codecov-image]][codecov-url] +[![dependency status][deps-svg]][deps-url] +[![dev dependency status][dev-deps-svg]][dev-deps-url] +[![License][license-image]][license-url] +[![Downloads][downloads-image]][downloads-url] + +[![npm badge][npm-badge-png]][package-url] + +Robust call-bound JavaScript intrinsics, using `call-bind` and `get-intrinsic`. + +## Getting started + +```sh +npm install --save call-bound +``` + +## Usage/Examples + +```js +const assert = require('assert'); +const callBound = require('call-bound'); + +const slice = callBound('Array.prototype.slice'); + +delete Function.prototype.call; +delete Function.prototype.bind; +delete Array.prototype.slice; + +assert.deepEqual(slice([1, 2, 3, 4], 1, -1), [2, 3]); +``` + +## Tests + +Clone the repo, `npm install`, and run `npm test` + +[package-url]: https://npmjs.org/package/call-bound +[npm-version-svg]: https://versionbadg.es/ljharb/call-bound.svg +[deps-svg]: https://david-dm.org/ljharb/call-bound.svg +[deps-url]: https://david-dm.org/ljharb/call-bound +[dev-deps-svg]: https://david-dm.org/ljharb/call-bound/dev-status.svg +[dev-deps-url]: https://david-dm.org/ljharb/call-bound#info=devDependencies +[npm-badge-png]: https://nodei.co/npm/call-bound.png?downloads=true&stars=true +[license-image]: https://img.shields.io/npm/l/call-bound.svg +[license-url]: LICENSE +[downloads-image]: https://img.shields.io/npm/dm/call-bound.svg +[downloads-url]: https://npm-stat.com/charts.html?package=call-bound +[codecov-image]: https://codecov.io/gh/ljharb/call-bound/branch/main/graphs/badge.svg +[codecov-url]: https://app.codecov.io/gh/ljharb/call-bound/ +[actions-image]: https://img.shields.io/endpoint?url=https://github-actions-badge-u3jn4tfpocch.runkit.sh/ljharb/call-bound +[actions-url]: https://github.com/ljharb/call-bound/actions diff --git a/node_modules/call-bound/index.d.ts b/node_modules/call-bound/index.d.ts new file mode 100644 index 0000000..5562f00 --- /dev/null +++ b/node_modules/call-bound/index.d.ts @@ -0,0 +1,94 @@ +type Intrinsic = typeof globalThis; + +type IntrinsicName = keyof Intrinsic | `%${keyof Intrinsic}%`; + +type IntrinsicPath = IntrinsicName | `${StripPercents}.${string}` | `%${StripPercents}.${string}%`; + +type AllowMissing = boolean; + +type StripPercents = T extends `%${infer U}%` ? U : T; + +type BindMethodPrecise = + F extends (this: infer This, ...args: infer Args) => infer R + ? (obj: This, ...args: Args) => R + : F extends { + (this: infer This1, ...args: infer Args1): infer R1; + (this: infer This2, ...args: infer Args2): infer R2 + } + ? { + (obj: This1, ...args: Args1): R1; + (obj: This2, ...args: Args2): R2 + } + : never + +// Extract method type from a prototype +type GetPrototypeMethod = + (typeof globalThis)[T] extends { prototype: any } + ? M extends keyof (typeof globalThis)[T]['prototype'] + ? (typeof globalThis)[T]['prototype'][M] + : never + : never + +// Get static property/method +type GetStaticMember = + P extends keyof (typeof globalThis)[T] ? (typeof globalThis)[T][P] : never + +// Type that maps string path to actual bound function or value with better precision +type BoundIntrinsic = + S extends `${infer Obj}.prototype.${infer Method}` + ? Obj extends keyof typeof globalThis + ? BindMethodPrecise> + : unknown + : S extends `${infer Obj}.${infer Prop}` + ? Obj extends keyof typeof globalThis + ? GetStaticMember + : unknown + : unknown + +declare function arraySlice(array: readonly T[], start?: number, end?: number): T[]; +declare function arraySlice(array: ArrayLike, start?: number, end?: number): T[]; +declare function arraySlice(array: IArguments, start?: number, end?: number): T[]; + +// Special cases for methods that need explicit typing +interface SpecialCases { + '%Object.prototype.isPrototypeOf%': (thisArg: {}, obj: unknown) => boolean; + '%String.prototype.replace%': { + (str: string, searchValue: string | RegExp, replaceValue: string): string; + (str: string, searchValue: string | RegExp, replacer: (substring: string, ...args: any[]) => string): string + }; + '%Object.prototype.toString%': (obj: {}) => string; + '%Object.prototype.hasOwnProperty%': (obj: {}, v: PropertyKey) => boolean; + '%Array.prototype.slice%': typeof arraySlice; + '%Array.prototype.map%': (array: readonly T[], callbackfn: (value: T, index: number, array: readonly T[]) => U, thisArg?: any) => U[]; + '%Array.prototype.filter%': (array: readonly T[], predicate: (value: T, index: number, array: readonly T[]) => unknown, thisArg?: any) => T[]; + '%Array.prototype.indexOf%': (array: readonly T[], searchElement: T, fromIndex?: number) => number; + '%Function.prototype.apply%': (fn: (...args: A) => R, thisArg: any, args: A) => R; + '%Function.prototype.call%': (fn: (...args: A) => R, thisArg: any, ...args: A) => R; + '%Function.prototype.bind%': (fn: (...args: A) => R, thisArg: any, ...args: A) => (...remainingArgs: A) => R; + '%Promise.prototype.then%': { + (promise: Promise, onfulfilled: (value: T) => R | PromiseLike): Promise; + (promise: Promise, onfulfilled: ((value: T) => R | PromiseLike) | undefined | null, onrejected: (reason: any) => R | PromiseLike): Promise; + }; + '%RegExp.prototype.test%': (regexp: RegExp, str: string) => boolean; + '%RegExp.prototype.exec%': (regexp: RegExp, str: string) => RegExpExecArray | null; + '%Error.prototype.toString%': (error: Error) => string; + '%TypeError.prototype.toString%': (error: TypeError) => string; + '%String.prototype.split%': ( + obj: unknown, + splitter: string | RegExp | { + [Symbol.split](string: string, limit?: number): string[]; + }, + limit?: number | undefined + ) => string[]; +} + +/** + * Returns a bound function for a prototype method, or a value for a static property. + * + * @param name - The name of the intrinsic (e.g. 'Array.prototype.slice') + * @param {AllowMissing} [allowMissing] - Whether to allow missing intrinsics (default: false) + */ +declare function callBound, S extends IntrinsicPath>(name: K, allowMissing?: AllowMissing): SpecialCases[`%${StripPercents}%`]; +declare function callBound, S extends IntrinsicPath>(name: S, allowMissing?: AllowMissing): BoundIntrinsic; + +export = callBound; diff --git a/node_modules/call-bound/index.js b/node_modules/call-bound/index.js new file mode 100644 index 0000000..e9ade74 --- /dev/null +++ b/node_modules/call-bound/index.js @@ -0,0 +1,19 @@ +'use strict'; + +var GetIntrinsic = require('get-intrinsic'); + +var callBindBasic = require('call-bind-apply-helpers'); + +/** @type {(thisArg: string, searchString: string, position?: number) => number} */ +var $indexOf = callBindBasic([GetIntrinsic('%String.prototype.indexOf%')]); + +/** @type {import('.')} */ +module.exports = function callBoundIntrinsic(name, allowMissing) { + /* eslint no-extra-parens: 0 */ + + var intrinsic = /** @type {(this: unknown, ...args: unknown[]) => unknown} */ (GetIntrinsic(name, !!allowMissing)); + if (typeof intrinsic === 'function' && $indexOf(name, '.prototype.') > -1) { + return callBindBasic(/** @type {const} */ ([intrinsic])); + } + return intrinsic; +}; diff --git a/node_modules/call-bound/package.json b/node_modules/call-bound/package.json new file mode 100644 index 0000000..d542db4 --- /dev/null +++ b/node_modules/call-bound/package.json @@ -0,0 +1,99 @@ +{ + "name": "call-bound", + "version": "1.0.4", + "description": "Robust call-bound JavaScript intrinsics, using `call-bind` and `get-intrinsic`.", + "main": "index.js", + "exports": { + ".": "./index.js", + "./package.json": "./package.json" + }, + "sideEffects": false, + "scripts": { + "prepack": "npmignore --auto --commentLines=auto", + "prepublish": "not-in-publish || npm run prepublishOnly", + "prepublishOnly": "safe-publish-latest", + "prelint": "evalmd README.md", + "lint": "eslint --ext=.js,.mjs .", + "postlint": "tsc -p . && attw -P", + "pretest": "npm run lint", + "tests-only": "nyc tape 'test/**/*.js'", + "test": "npm run tests-only", + "posttest": "npx npm@'>=10.2' audit --production", + "version": "auto-changelog && git add CHANGELOG.md", + "postversion": "auto-changelog && git add CHANGELOG.md && git commit --no-edit --amend && git tag -f \"v$(node -e \"console.log(require('./package.json').version)\")\"" + }, + "repository": { + "type": "git", + "url": "git+https://github.com/ljharb/call-bound.git" + }, + "keywords": [ + "javascript", + "ecmascript", + "es", + "js", + "callbind", + "callbound", + "call", + "bind", + "bound", + "call-bind", + "call-bound", + "function", + "es-abstract" + ], + "author": "Jordan Harband ", + "funding": { + "url": "https://github.com/sponsors/ljharb" + }, + "license": "MIT", + "bugs": { + "url": "https://github.com/ljharb/call-bound/issues" + }, + "homepage": "https://github.com/ljharb/call-bound#readme", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "devDependencies": { + "@arethetypeswrong/cli": "^0.17.4", + "@ljharb/eslint-config": "^21.1.1", + "@ljharb/tsconfig": "^0.3.0", + "@types/call-bind": "^1.0.5", + "@types/get-intrinsic": "^1.2.3", + "@types/tape": "^5.8.1", + "auto-changelog": "^2.5.0", + "encoding": "^0.1.13", + "es-value-fixtures": "^1.7.1", + "eslint": "=8.8.0", + "evalmd": "^0.0.19", + "for-each": "^0.3.5", + "gopd": "^1.2.0", + "has-strict-mode": "^1.1.0", + "in-publish": "^2.0.1", + "npmignore": "^0.3.1", + "nyc": "^10.3.2", + "object-inspect": "^1.13.4", + "safe-publish-latest": "^2.0.0", + "tape": "^5.9.0", + "typescript": "next" + }, + "testling": { + "files": "test/index.js" + }, + "auto-changelog": { + "output": "CHANGELOG.md", + "template": "keepachangelog", + "unreleased": false, + "commitLimit": false, + "backfillLimit": false, + "hideCredit": true + }, + "publishConfig": { + "ignore": [ + ".github/workflows" + ] + }, + "engines": { + "node": ">= 0.4" + } +} diff --git a/node_modules/call-bound/test/index.js b/node_modules/call-bound/test/index.js new file mode 100644 index 0000000..a2fc9f0 --- /dev/null +++ b/node_modules/call-bound/test/index.js @@ -0,0 +1,61 @@ +'use strict'; + +var test = require('tape'); + +var callBound = require('../'); + +/** @template {true} T @template U @typedef {T extends U ? T : never} AssertType */ + +test('callBound', function (t) { + // static primitive + t.equal(callBound('Array.length'), Array.length, 'Array.length yields itself'); + t.equal(callBound('%Array.length%'), Array.length, '%Array.length% yields itself'); + + // static non-function object + t.equal(callBound('Array.prototype'), Array.prototype, 'Array.prototype yields itself'); + t.equal(callBound('%Array.prototype%'), Array.prototype, '%Array.prototype% yields itself'); + t.equal(callBound('Array.constructor'), Array.constructor, 'Array.constructor yields itself'); + t.equal(callBound('%Array.constructor%'), Array.constructor, '%Array.constructor% yields itself'); + + // static function + t.equal(callBound('Date.parse'), Date.parse, 'Date.parse yields itself'); + t.equal(callBound('%Date.parse%'), Date.parse, '%Date.parse% yields itself'); + + // prototype primitive + t.equal(callBound('Error.prototype.message'), Error.prototype.message, 'Error.prototype.message yields itself'); + t.equal(callBound('%Error.prototype.message%'), Error.prototype.message, '%Error.prototype.message% yields itself'); + + var x = callBound('Object.prototype.toString'); + var y = callBound('%Object.prototype.toString%'); + + // prototype function + t.notEqual(x, Object.prototype.toString, 'Object.prototype.toString does not yield itself'); + t.notEqual(y, Object.prototype.toString, '%Object.prototype.toString% does not yield itself'); + t.equal(x(true), Object.prototype.toString.call(true), 'call-bound Object.prototype.toString calls into the original'); + t.equal(y(true), Object.prototype.toString.call(true), 'call-bound %Object.prototype.toString% calls into the original'); + + t['throws']( + // @ts-expect-error + function () { callBound('does not exist'); }, + SyntaxError, + 'nonexistent intrinsic throws' + ); + t['throws']( + // @ts-expect-error + function () { callBound('does not exist', true); }, + SyntaxError, + 'allowMissing arg still throws for unknown intrinsic' + ); + + t.test('real but absent intrinsic', { skip: typeof WeakRef !== 'undefined' }, function (st) { + st['throws']( + function () { callBound('WeakRef'); }, + TypeError, + 'real but absent intrinsic throws' + ); + st.equal(callBound('WeakRef', true), undefined, 'allowMissing arg avoids exception'); + st.end(); + }); + + t.end(); +}); diff --git a/node_modules/call-bound/tsconfig.json b/node_modules/call-bound/tsconfig.json new file mode 100644 index 0000000..8976d98 --- /dev/null +++ b/node_modules/call-bound/tsconfig.json @@ -0,0 +1,10 @@ +{ + "extends": "@ljharb/tsconfig", + "compilerOptions": { + "target": "ESNext", + "lib": ["es2024"], + }, + "exclude": [ + "coverage", + ], +} diff --git a/node_modules/content-disposition/HISTORY.md b/node_modules/content-disposition/HISTORY.md new file mode 100644 index 0000000..488effa --- /dev/null +++ b/node_modules/content-disposition/HISTORY.md @@ -0,0 +1,60 @@ +0.5.4 / 2021-12-10 +================== + + * deps: safe-buffer@5.2.1 + +0.5.3 / 2018-12-17 +================== + + * Use `safe-buffer` for improved Buffer API + +0.5.2 / 2016-12-08 +================== + + * Fix `parse` to accept any linear whitespace character + +0.5.1 / 2016-01-17 +================== + + * perf: enable strict mode + +0.5.0 / 2014-10-11 +================== + + * Add `parse` function + +0.4.0 / 2014-09-21 +================== + + * Expand non-Unicode `filename` to the full ISO-8859-1 charset + +0.3.0 / 2014-09-20 +================== + + * Add `fallback` option + * Add `type` option + +0.2.0 / 2014-09-19 +================== + + * Reduce ambiguity of file names with hex escape in buggy browsers + +0.1.2 / 2014-09-19 +================== + + * Fix periodic invalid Unicode filename header + +0.1.1 / 2014-09-19 +================== + + * Fix invalid characters appearing in `filename*` parameter + +0.1.0 / 2014-09-18 +================== + + * Make the `filename` argument optional + +0.0.0 / 2014-09-18 +================== + + * Initial release diff --git a/node_modules/content-disposition/LICENSE b/node_modules/content-disposition/LICENSE new file mode 100644 index 0000000..84441fb --- /dev/null +++ b/node_modules/content-disposition/LICENSE @@ -0,0 +1,22 @@ +(The MIT License) + +Copyright (c) 2014-2017 Douglas Christopher Wilson + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/content-disposition/README.md b/node_modules/content-disposition/README.md new file mode 100644 index 0000000..3a0bb05 --- /dev/null +++ b/node_modules/content-disposition/README.md @@ -0,0 +1,142 @@ +# content-disposition + +[![NPM Version][npm-image]][npm-url] +[![NPM Downloads][downloads-image]][downloads-url] +[![Node.js Version][node-version-image]][node-version-url] +[![Build Status][github-actions-ci-image]][github-actions-ci-url] +[![Test Coverage][coveralls-image]][coveralls-url] + +Create and parse HTTP `Content-Disposition` header + +## Installation + +```sh +$ npm install content-disposition +``` + +## API + +```js +var contentDisposition = require('content-disposition') +``` + +### contentDisposition(filename, options) + +Create an attachment `Content-Disposition` header value using the given file name, +if supplied. The `filename` is optional and if no file name is desired, but you +want to specify `options`, set `filename` to `undefined`. + +```js +res.setHeader('Content-Disposition', contentDisposition('∫ maths.pdf')) +``` + +**note** HTTP headers are of the ISO-8859-1 character set. If you are writing this +header through a means different from `setHeader` in Node.js, you'll want to specify +the `'binary'` encoding in Node.js. + +#### Options + +`contentDisposition` accepts these properties in the options object. + +##### fallback + +If the `filename` option is outside ISO-8859-1, then the file name is actually +stored in a supplemental field for clients that support Unicode file names and +a ISO-8859-1 version of the file name is automatically generated. + +This specifies the ISO-8859-1 file name to override the automatic generation or +disables the generation all together, defaults to `true`. + + - A string will specify the ISO-8859-1 file name to use in place of automatic + generation. + - `false` will disable including a ISO-8859-1 file name and only include the + Unicode version (unless the file name is already ISO-8859-1). + - `true` will enable automatic generation if the file name is outside ISO-8859-1. + +If the `filename` option is ISO-8859-1 and this option is specified and has a +different value, then the `filename` option is encoded in the extended field +and this set as the fallback field, even though they are both ISO-8859-1. + +##### type + +Specifies the disposition type, defaults to `"attachment"`. This can also be +`"inline"`, or any other value (all values except inline are treated like +`attachment`, but can convey additional information if both parties agree to +it). The type is normalized to lower-case. + +### contentDisposition.parse(string) + +```js +var disposition = contentDisposition.parse('attachment; filename="EURO rates.txt"; filename*=UTF-8\'\'%e2%82%ac%20rates.txt') +``` + +Parse a `Content-Disposition` header string. This automatically handles extended +("Unicode") parameters by decoding them and providing them under the standard +parameter name. This will return an object with the following properties (examples +are shown for the string `'attachment; filename="EURO rates.txt"; filename*=UTF-8\'\'%e2%82%ac%20rates.txt'`): + + - `type`: The disposition type (always lower case). Example: `'attachment'` + + - `parameters`: An object of the parameters in the disposition (name of parameter + always lower case and extended versions replace non-extended versions). Example: + `{filename: "€ rates.txt"}` + +## Examples + +### Send a file for download + +```js +var contentDisposition = require('content-disposition') +var destroy = require('destroy') +var fs = require('fs') +var http = require('http') +var onFinished = require('on-finished') + +var filePath = '/path/to/public/plans.pdf' + +http.createServer(function onRequest (req, res) { + // set headers + res.setHeader('Content-Type', 'application/pdf') + res.setHeader('Content-Disposition', contentDisposition(filePath)) + + // send file + var stream = fs.createReadStream(filePath) + stream.pipe(res) + onFinished(res, function () { + destroy(stream) + }) +}) +``` + +## Testing + +```sh +$ npm test +``` + +## References + +- [RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1][rfc-2616] +- [RFC 5987: Character Set and Language Encoding for Hypertext Transfer Protocol (HTTP) Header Field Parameters][rfc-5987] +- [RFC 6266: Use of the Content-Disposition Header Field in the Hypertext Transfer Protocol (HTTP)][rfc-6266] +- [Test Cases for HTTP Content-Disposition header field (RFC 6266) and the Encodings defined in RFCs 2047, 2231 and 5987][tc-2231] + +[rfc-2616]: https://tools.ietf.org/html/rfc2616 +[rfc-5987]: https://tools.ietf.org/html/rfc5987 +[rfc-6266]: https://tools.ietf.org/html/rfc6266 +[tc-2231]: http://greenbytes.de/tech/tc2231/ + +## License + +[MIT](LICENSE) + +[npm-image]: https://img.shields.io/npm/v/content-disposition.svg +[npm-url]: https://npmjs.org/package/content-disposition +[node-version-image]: https://img.shields.io/node/v/content-disposition.svg +[node-version-url]: https://nodejs.org/en/download +[coveralls-image]: https://img.shields.io/coveralls/jshttp/content-disposition.svg +[coveralls-url]: https://coveralls.io/r/jshttp/content-disposition?branch=master +[downloads-image]: https://img.shields.io/npm/dm/content-disposition.svg +[downloads-url]: https://npmjs.org/package/content-disposition +[github-actions-ci-image]: https://img.shields.io/github/workflow/status/jshttp/content-disposition/ci/master?label=ci +[github-actions-ci-url]: https://github.com/jshttp/content-disposition?query=workflow%3Aci diff --git a/node_modules/content-disposition/index.js b/node_modules/content-disposition/index.js new file mode 100644 index 0000000..ecec899 --- /dev/null +++ b/node_modules/content-disposition/index.js @@ -0,0 +1,458 @@ +/*! + * content-disposition + * Copyright(c) 2014-2017 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * Module exports. + * @public + */ + +module.exports = contentDisposition +module.exports.parse = parse + +/** + * Module dependencies. + * @private + */ + +var basename = require('path').basename +var Buffer = require('safe-buffer').Buffer + +/** + * RegExp to match non attr-char, *after* encodeURIComponent (i.e. not including "%") + * @private + */ + +var ENCODE_URL_ATTR_CHAR_REGEXP = /[\x00-\x20"'()*,/:;<=>?@[\\\]{}\x7f]/g // eslint-disable-line no-control-regex + +/** + * RegExp to match percent encoding escape. + * @private + */ + +var HEX_ESCAPE_REGEXP = /%[0-9A-Fa-f]{2}/ +var HEX_ESCAPE_REPLACE_REGEXP = /%([0-9A-Fa-f]{2})/g + +/** + * RegExp to match non-latin1 characters. + * @private + */ + +var NON_LATIN1_REGEXP = /[^\x20-\x7e\xa0-\xff]/g + +/** + * RegExp to match quoted-pair in RFC 2616 + * + * quoted-pair = "\" CHAR + * CHAR = + * @private + */ + +var QESC_REGEXP = /\\([\u0000-\u007f])/g // eslint-disable-line no-control-regex + +/** + * RegExp to match chars that must be quoted-pair in RFC 2616 + * @private + */ + +var QUOTE_REGEXP = /([\\"])/g + +/** + * RegExp for various RFC 2616 grammar + * + * parameter = token "=" ( token | quoted-string ) + * token = 1* + * separators = "(" | ")" | "<" | ">" | "@" + * | "," | ";" | ":" | "\" | <"> + * | "/" | "[" | "]" | "?" | "=" + * | "{" | "}" | SP | HT + * quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + * qdtext = > + * quoted-pair = "\" CHAR + * CHAR = + * TEXT = + * LWS = [CRLF] 1*( SP | HT ) + * CRLF = CR LF + * CR = + * LF = + * SP = + * HT = + * CTL = + * OCTET = + * @private + */ + +var PARAM_REGEXP = /;[\x09\x20]*([!#$%&'*+.0-9A-Z^_`a-z|~-]+)[\x09\x20]*=[\x09\x20]*("(?:[\x20!\x23-\x5b\x5d-\x7e\x80-\xff]|\\[\x20-\x7e])*"|[!#$%&'*+.0-9A-Z^_`a-z|~-]+)[\x09\x20]*/g // eslint-disable-line no-control-regex +var TEXT_REGEXP = /^[\x20-\x7e\x80-\xff]+$/ +var TOKEN_REGEXP = /^[!#$%&'*+.0-9A-Z^_`a-z|~-]+$/ + +/** + * RegExp for various RFC 5987 grammar + * + * ext-value = charset "'" [ language ] "'" value-chars + * charset = "UTF-8" / "ISO-8859-1" / mime-charset + * mime-charset = 1*mime-charsetc + * mime-charsetc = ALPHA / DIGIT + * / "!" / "#" / "$" / "%" / "&" + * / "+" / "-" / "^" / "_" / "`" + * / "{" / "}" / "~" + * language = ( 2*3ALPHA [ extlang ] ) + * / 4ALPHA + * / 5*8ALPHA + * extlang = *3( "-" 3ALPHA ) + * value-chars = *( pct-encoded / attr-char ) + * pct-encoded = "%" HEXDIG HEXDIG + * attr-char = ALPHA / DIGIT + * / "!" / "#" / "$" / "&" / "+" / "-" / "." + * / "^" / "_" / "`" / "|" / "~" + * @private + */ + +var EXT_VALUE_REGEXP = /^([A-Za-z0-9!#$%&+\-^_`{}~]+)'(?:[A-Za-z]{2,3}(?:-[A-Za-z]{3}){0,3}|[A-Za-z]{4,8}|)'((?:%[0-9A-Fa-f]{2}|[A-Za-z0-9!#$&+.^_`|~-])+)$/ + +/** + * RegExp for various RFC 6266 grammar + * + * disposition-type = "inline" | "attachment" | disp-ext-type + * disp-ext-type = token + * disposition-parm = filename-parm | disp-ext-parm + * filename-parm = "filename" "=" value + * | "filename*" "=" ext-value + * disp-ext-parm = token "=" value + * | ext-token "=" ext-value + * ext-token = + * @private + */ + +var DISPOSITION_TYPE_REGEXP = /^([!#$%&'*+.0-9A-Z^_`a-z|~-]+)[\x09\x20]*(?:$|;)/ // eslint-disable-line no-control-regex + +/** + * Create an attachment Content-Disposition header. + * + * @param {string} [filename] + * @param {object} [options] + * @param {string} [options.type=attachment] + * @param {string|boolean} [options.fallback=true] + * @return {string} + * @public + */ + +function contentDisposition (filename, options) { + var opts = options || {} + + // get type + var type = opts.type || 'attachment' + + // get parameters + var params = createparams(filename, opts.fallback) + + // format into string + return format(new ContentDisposition(type, params)) +} + +/** + * Create parameters object from filename and fallback. + * + * @param {string} [filename] + * @param {string|boolean} [fallback=true] + * @return {object} + * @private + */ + +function createparams (filename, fallback) { + if (filename === undefined) { + return + } + + var params = {} + + if (typeof filename !== 'string') { + throw new TypeError('filename must be a string') + } + + // fallback defaults to true + if (fallback === undefined) { + fallback = true + } + + if (typeof fallback !== 'string' && typeof fallback !== 'boolean') { + throw new TypeError('fallback must be a string or boolean') + } + + if (typeof fallback === 'string' && NON_LATIN1_REGEXP.test(fallback)) { + throw new TypeError('fallback must be ISO-8859-1 string') + } + + // restrict to file base name + var name = basename(filename) + + // determine if name is suitable for quoted string + var isQuotedString = TEXT_REGEXP.test(name) + + // generate fallback name + var fallbackName = typeof fallback !== 'string' + ? fallback && getlatin1(name) + : basename(fallback) + var hasFallback = typeof fallbackName === 'string' && fallbackName !== name + + // set extended filename parameter + if (hasFallback || !isQuotedString || HEX_ESCAPE_REGEXP.test(name)) { + params['filename*'] = name + } + + // set filename parameter + if (isQuotedString || hasFallback) { + params.filename = hasFallback + ? fallbackName + : name + } + + return params +} + +/** + * Format object to Content-Disposition header. + * + * @param {object} obj + * @param {string} obj.type + * @param {object} [obj.parameters] + * @return {string} + * @private + */ + +function format (obj) { + var parameters = obj.parameters + var type = obj.type + + if (!type || typeof type !== 'string' || !TOKEN_REGEXP.test(type)) { + throw new TypeError('invalid type') + } + + // start with normalized type + var string = String(type).toLowerCase() + + // append parameters + if (parameters && typeof parameters === 'object') { + var param + var params = Object.keys(parameters).sort() + + for (var i = 0; i < params.length; i++) { + param = params[i] + + var val = param.substr(-1) === '*' + ? ustring(parameters[param]) + : qstring(parameters[param]) + + string += '; ' + param + '=' + val + } + } + + return string +} + +/** + * Decode a RFC 5987 field value (gracefully). + * + * @param {string} str + * @return {string} + * @private + */ + +function decodefield (str) { + var match = EXT_VALUE_REGEXP.exec(str) + + if (!match) { + throw new TypeError('invalid extended field value') + } + + var charset = match[1].toLowerCase() + var encoded = match[2] + var value + + // to binary string + var binary = encoded.replace(HEX_ESCAPE_REPLACE_REGEXP, pdecode) + + switch (charset) { + case 'iso-8859-1': + value = getlatin1(binary) + break + case 'utf-8': + value = Buffer.from(binary, 'binary').toString('utf8') + break + default: + throw new TypeError('unsupported charset in extended field') + } + + return value +} + +/** + * Get ISO-8859-1 version of string. + * + * @param {string} val + * @return {string} + * @private + */ + +function getlatin1 (val) { + // simple Unicode -> ISO-8859-1 transformation + return String(val).replace(NON_LATIN1_REGEXP, '?') +} + +/** + * Parse Content-Disposition header string. + * + * @param {string} string + * @return {object} + * @public + */ + +function parse (string) { + if (!string || typeof string !== 'string') { + throw new TypeError('argument string is required') + } + + var match = DISPOSITION_TYPE_REGEXP.exec(string) + + if (!match) { + throw new TypeError('invalid type format') + } + + // normalize type + var index = match[0].length + var type = match[1].toLowerCase() + + var key + var names = [] + var params = {} + var value + + // calculate index to start at + index = PARAM_REGEXP.lastIndex = match[0].substr(-1) === ';' + ? index - 1 + : index + + // match parameters + while ((match = PARAM_REGEXP.exec(string))) { + if (match.index !== index) { + throw new TypeError('invalid parameter format') + } + + index += match[0].length + key = match[1].toLowerCase() + value = match[2] + + if (names.indexOf(key) !== -1) { + throw new TypeError('invalid duplicate parameter') + } + + names.push(key) + + if (key.indexOf('*') + 1 === key.length) { + // decode extended value + key = key.slice(0, -1) + value = decodefield(value) + + // overwrite existing value + params[key] = value + continue + } + + if (typeof params[key] === 'string') { + continue + } + + if (value[0] === '"') { + // remove quotes and escapes + value = value + .substr(1, value.length - 2) + .replace(QESC_REGEXP, '$1') + } + + params[key] = value + } + + if (index !== -1 && index !== string.length) { + throw new TypeError('invalid parameter format') + } + + return new ContentDisposition(type, params) +} + +/** + * Percent decode a single character. + * + * @param {string} str + * @param {string} hex + * @return {string} + * @private + */ + +function pdecode (str, hex) { + return String.fromCharCode(parseInt(hex, 16)) +} + +/** + * Percent encode a single character. + * + * @param {string} char + * @return {string} + * @private + */ + +function pencode (char) { + return '%' + String(char) + .charCodeAt(0) + .toString(16) + .toUpperCase() +} + +/** + * Quote a string for HTTP. + * + * @param {string} val + * @return {string} + * @private + */ + +function qstring (val) { + var str = String(val) + + return '"' + str.replace(QUOTE_REGEXP, '\\$1') + '"' +} + +/** + * Encode a Unicode string for HTTP (RFC 5987). + * + * @param {string} val + * @return {string} + * @private + */ + +function ustring (val) { + var str = String(val) + + // percent encode as UTF-8 + var encoded = encodeURIComponent(str) + .replace(ENCODE_URL_ATTR_CHAR_REGEXP, pencode) + + return 'UTF-8\'\'' + encoded +} + +/** + * Class for parsed Content-Disposition header for v8 optimization + * + * @public + * @param {string} type + * @param {object} parameters + * @constructor + */ + +function ContentDisposition (type, parameters) { + this.type = type + this.parameters = parameters +} diff --git a/node_modules/content-disposition/package.json b/node_modules/content-disposition/package.json new file mode 100644 index 0000000..43c70ce --- /dev/null +++ b/node_modules/content-disposition/package.json @@ -0,0 +1,44 @@ +{ + "name": "content-disposition", + "description": "Create and parse Content-Disposition header", + "version": "0.5.4", + "author": "Douglas Christopher Wilson ", + "license": "MIT", + "keywords": [ + "content-disposition", + "http", + "rfc6266", + "res" + ], + "repository": "jshttp/content-disposition", + "dependencies": { + "safe-buffer": "5.2.1" + }, + "devDependencies": { + "deep-equal": "1.0.1", + "eslint": "7.32.0", + "eslint-config-standard": "13.0.1", + "eslint-plugin-import": "2.25.3", + "eslint-plugin-markdown": "2.2.1", + "eslint-plugin-node": "11.1.0", + "eslint-plugin-promise": "5.2.0", + "eslint-plugin-standard": "4.1.0", + "istanbul": "0.4.5", + "mocha": "9.1.3" + }, + "files": [ + "LICENSE", + "HISTORY.md", + "README.md", + "index.js" + ], + "engines": { + "node": ">= 0.6" + }, + "scripts": { + "lint": "eslint .", + "test": "mocha --reporter spec --bail --check-leaks test/", + "test-ci": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --reporter spec --check-leaks test/", + "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --reporter dot --check-leaks test/" + } +} diff --git a/node_modules/content-type/HISTORY.md b/node_modules/content-type/HISTORY.md new file mode 100644 index 0000000..4583671 --- /dev/null +++ b/node_modules/content-type/HISTORY.md @@ -0,0 +1,29 @@ +1.0.5 / 2023-01-29 +================== + + * perf: skip value escaping when unnecessary + +1.0.4 / 2017-09-11 +================== + + * perf: skip parameter parsing when no parameters + +1.0.3 / 2017-09-10 +================== + + * perf: remove argument reassignment + +1.0.2 / 2016-05-09 +================== + + * perf: enable strict mode + +1.0.1 / 2015-02-13 +================== + + * Improve missing `Content-Type` header error message + +1.0.0 / 2015-02-01 +================== + + * Initial implementation, derived from `media-typer@0.3.0` diff --git a/node_modules/content-type/LICENSE b/node_modules/content-type/LICENSE new file mode 100644 index 0000000..34b1a2d --- /dev/null +++ b/node_modules/content-type/LICENSE @@ -0,0 +1,22 @@ +(The MIT License) + +Copyright (c) 2015 Douglas Christopher Wilson + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/node_modules/content-type/README.md b/node_modules/content-type/README.md new file mode 100644 index 0000000..c1a922a --- /dev/null +++ b/node_modules/content-type/README.md @@ -0,0 +1,94 @@ +# content-type + +[![NPM Version][npm-version-image]][npm-url] +[![NPM Downloads][npm-downloads-image]][npm-url] +[![Node.js Version][node-image]][node-url] +[![Build Status][ci-image]][ci-url] +[![Coverage Status][coveralls-image]][coveralls-url] + +Create and parse HTTP Content-Type header according to RFC 7231 + +## Installation + +```sh +$ npm install content-type +``` + +## API + +```js +var contentType = require('content-type') +``` + +### contentType.parse(string) + +```js +var obj = contentType.parse('image/svg+xml; charset=utf-8') +``` + +Parse a `Content-Type` header. This will return an object with the following +properties (examples are shown for the string `'image/svg+xml; charset=utf-8'`): + + - `type`: The media type (the type and subtype, always lower case). + Example: `'image/svg+xml'` + + - `parameters`: An object of the parameters in the media type (name of parameter + always lower case). Example: `{charset: 'utf-8'}` + +Throws a `TypeError` if the string is missing or invalid. + +### contentType.parse(req) + +```js +var obj = contentType.parse(req) +``` + +Parse the `Content-Type` header from the given `req`. Short-cut for +`contentType.parse(req.headers['content-type'])`. + +Throws a `TypeError` if the `Content-Type` header is missing or invalid. + +### contentType.parse(res) + +```js +var obj = contentType.parse(res) +``` + +Parse the `Content-Type` header set on the given `res`. Short-cut for +`contentType.parse(res.getHeader('content-type'))`. + +Throws a `TypeError` if the `Content-Type` header is missing or invalid. + +### contentType.format(obj) + +```js +var str = contentType.format({ + type: 'image/svg+xml', + parameters: { charset: 'utf-8' } +}) +``` + +Format an object into a `Content-Type` header. This will return a string of the +content type for the given object with the following properties (examples are +shown that produce the string `'image/svg+xml; charset=utf-8'`): + + - `type`: The media type (will be lower-cased). Example: `'image/svg+xml'` + + - `parameters`: An object of the parameters in the media type (name of the + parameter will be lower-cased). Example: `{charset: 'utf-8'}` + +Throws a `TypeError` if the object contains an invalid type or parameter names. + +## License + +[MIT](LICENSE) + +[ci-image]: https://badgen.net/github/checks/jshttp/content-type/master?label=ci +[ci-url]: https://github.com/jshttp/content-type/actions/workflows/ci.yml +[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/content-type/master +[coveralls-url]: https://coveralls.io/r/jshttp/content-type?branch=master +[node-image]: https://badgen.net/npm/node/content-type +[node-url]: https://nodejs.org/en/download +[npm-downloads-image]: https://badgen.net/npm/dm/content-type +[npm-url]: https://npmjs.org/package/content-type +[npm-version-image]: https://badgen.net/npm/v/content-type diff --git a/node_modules/content-type/index.js b/node_modules/content-type/index.js new file mode 100644 index 0000000..41840e7 --- /dev/null +++ b/node_modules/content-type/index.js @@ -0,0 +1,225 @@ +/*! + * content-type + * Copyright(c) 2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict' + +/** + * RegExp to match *( ";" parameter ) in RFC 7231 sec 3.1.1.1 + * + * parameter = token "=" ( token / quoted-string ) + * token = 1*tchar + * tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" + * / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~" + * / DIGIT / ALPHA + * ; any VCHAR, except delimiters + * quoted-string = DQUOTE *( qdtext / quoted-pair ) DQUOTE + * qdtext = HTAB / SP / %x21 / %x23-5B / %x5D-7E / obs-text + * obs-text = %x80-FF + * quoted-pair = "\" ( HTAB / SP / VCHAR / obs-text ) + */ +var PARAM_REGEXP = /; *([!#$%&'*+.^_`|~0-9A-Za-z-]+) *= *("(?:[\u000b\u0020\u0021\u0023-\u005b\u005d-\u007e\u0080-\u00ff]|\\[\u000b\u0020-\u00ff])*"|[!#$%&'*+.^_`|~0-9A-Za-z-]+) */g // eslint-disable-line no-control-regex +var TEXT_REGEXP = /^[\u000b\u0020-\u007e\u0080-\u00ff]+$/ // eslint-disable-line no-control-regex +var TOKEN_REGEXP = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/ + +/** + * RegExp to match quoted-pair in RFC 7230 sec 3.2.6 + * + * quoted-pair = "\" ( HTAB / SP / VCHAR / obs-text ) + * obs-text = %x80-FF + */ +var QESC_REGEXP = /\\([\u000b\u0020-\u00ff])/g // eslint-disable-line no-control-regex + +/** + * RegExp to match chars that must be quoted-pair in RFC 7230 sec 3.2.6 + */ +var QUOTE_REGEXP = /([\\"])/g + +/** + * RegExp to match type in RFC 7231 sec 3.1.1.1 + * + * media-type = type "/" subtype + * type = token + * subtype = token + */ +var TYPE_REGEXP = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+\/[!#$%&'*+.^_`|~0-9A-Za-z-]+$/ + +/** + * Module exports. + * @public + */ + +exports.format = format +exports.parse = parse + +/** + * Format object to media type. + * + * @param {object} obj + * @return {string} + * @public + */ + +function format (obj) { + if (!obj || typeof obj !== 'object') { + throw new TypeError('argument obj is required') + } + + var parameters = obj.parameters + var type = obj.type + + if (!type || !TYPE_REGEXP.test(type)) { + throw new TypeError('invalid type') + } + + var string = type + + // append parameters + if (parameters && typeof parameters === 'object') { + var param + var params = Object.keys(parameters).sort() + + for (var i = 0; i < params.length; i++) { + param = params[i] + + if (!TOKEN_REGEXP.test(param)) { + throw new TypeError('invalid parameter name') + } + + string += '; ' + param + '=' + qstring(parameters[param]) + } + } + + return string +} + +/** + * Parse media type to object. + * + * @param {string|object} string + * @return {Object} + * @public + */ + +function parse (string) { + if (!string) { + throw new TypeError('argument string is required') + } + + // support req/res-like objects as argument + var header = typeof string === 'object' + ? getcontenttype(string) + : string + + if (typeof header !== 'string') { + throw new TypeError('argument string is required to be a string') + } + + var index = header.indexOf(';') + var type = index !== -1 + ? header.slice(0, index).trim() + : header.trim() + + if (!TYPE_REGEXP.test(type)) { + throw new TypeError('invalid media type') + } + + var obj = new ContentType(type.toLowerCase()) + + // parse parameters + if (index !== -1) { + var key + var match + var value + + PARAM_REGEXP.lastIndex = index + + while ((match = PARAM_REGEXP.exec(header))) { + if (match.index !== index) { + throw new TypeError('invalid parameter format') + } + + index += match[0].length + key = match[1].toLowerCase() + value = match[2] + + if (value.charCodeAt(0) === 0x22 /* " */) { + // remove quotes + value = value.slice(1, -1) + + // remove escapes + if (value.indexOf('\\') !== -1) { + value = value.replace(QESC_REGEXP, '$1') + } + } + + obj.parameters[key] = value + } + + if (index !== header.length) { + throw new TypeError('invalid parameter format') + } + } + + return obj +} + +/** + * Get content-type from req/res objects. + * + * @param {object} + * @return {Object} + * @private + */ + +function getcontenttype (obj) { + var header + + if (typeof obj.getHeader === 'function') { + // res-like + header = obj.getHeader('content-type') + } else if (typeof obj.headers === 'object') { + // req-like + header = obj.headers && obj.headers['content-type'] + } + + if (typeof header !== 'string') { + throw new TypeError('content-type header is missing from object') + } + + return header +} + +/** + * Quote a string if necessary. + * + * @param {string} val + * @return {string} + * @private + */ + +function qstring (val) { + var str = String(val) + + // no need to quote tokens + if (TOKEN_REGEXP.test(str)) { + return str + } + + if (str.length > 0 && !TEXT_REGEXP.test(str)) { + throw new TypeError('invalid parameter value') + } + + return '"' + str.replace(QUOTE_REGEXP, '\\$1') + '"' +} + +/** + * Class to represent a content type. + * @private + */ +function ContentType (type) { + this.parameters = Object.create(null) + this.type = type +} diff --git a/node_modules/content-type/package.json b/node_modules/content-type/package.json new file mode 100644 index 0000000..9db19f6 --- /dev/null +++ b/node_modules/content-type/package.json @@ -0,0 +1,42 @@ +{ + "name": "content-type", + "description": "Create and parse HTTP Content-Type header", + "version": "1.0.5", + "author": "Douglas Christopher Wilson ", + "license": "MIT", + "keywords": [ + "content-type", + "http", + "req", + "res", + "rfc7231" + ], + "repository": "jshttp/content-type", + "devDependencies": { + "deep-equal": "1.0.1", + "eslint": "8.32.0", + "eslint-config-standard": "15.0.1", + "eslint-plugin-import": "2.27.5", + "eslint-plugin-node": "11.1.0", + "eslint-plugin-promise": "6.1.1", + "eslint-plugin-standard": "4.1.0", + "mocha": "10.2.0", + "nyc": "15.1.0" + }, + "files": [ + "LICENSE", + "HISTORY.md", + "README.md", + "index.js" + ], + "engines": { + "node": ">= 0.6" + }, + "scripts": { + "lint": "eslint .", + "test": "mocha --reporter spec --check-leaks --bail test/", + "test-ci": "nyc --reporter=lcovonly --reporter=text npm test", + "test-cov": "nyc --reporter=html --reporter=text npm test", + "version": "node scripts/version-history.js && git add HISTORY.md" + } +} diff --git a/node_modules/cookie-signature/.npmignore b/node_modules/cookie-signature/.npmignore new file mode 100644 index 0000000..f1250e5 --- /dev/null +++ b/node_modules/cookie-signature/.npmignore @@ -0,0 +1,4 @@ +support +test +examples +*.sock diff --git a/node_modules/cookie-signature/History.md b/node_modules/cookie-signature/History.md new file mode 100644 index 0000000..78513cc --- /dev/null +++ b/node_modules/cookie-signature/History.md @@ -0,0 +1,38 @@ +1.0.6 / 2015-02-03 +================== + +* use `npm test` instead of `make test` to run tests +* clearer assertion messages when checking input + + +1.0.5 / 2014-09-05 +================== + +* add license to package.json + +1.0.4 / 2014-06-25 +================== + + * corrected avoidance of timing attacks (thanks @tenbits!) + +1.0.3 / 2014-01-28 +================== + + * [incorrect] fix for timing attacks + +1.0.2 / 2014-01-28 +================== + + * fix missing repository warning + * fix typo in test + +1.0.1 / 2013-04-15 +================== + + * Revert "Changed underlying HMAC algo. to sha512." + * Revert "Fix for timing attacks on MAC verification." + +0.0.1 / 2010-01-03 +================== + + * Initial release diff --git a/node_modules/cookie-signature/Readme.md b/node_modules/cookie-signature/Readme.md new file mode 100644 index 0000000..2559e84 --- /dev/null +++ b/node_modules/cookie-signature/Readme.md @@ -0,0 +1,42 @@ + +# cookie-signature + + Sign and unsign cookies. + +## Example + +```js +var cookie = require('cookie-signature'); + +var val = cookie.sign('hello', 'tobiiscool'); +val.should.equal('hello.DGDUkGlIkCzPz+C0B064FNgHdEjox7ch8tOBGslZ5QI'); + +var val = cookie.sign('hello', 'tobiiscool'); +cookie.unsign(val, 'tobiiscool').should.equal('hello'); +cookie.unsign(val, 'luna').should.be.false; +``` + +## License + +(The MIT License) + +Copyright (c) 2012 LearnBoost <tj@learnboost.com> + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/node_modules/cookie-signature/index.js b/node_modules/cookie-signature/index.js new file mode 100644 index 0000000..b8c9463 --- /dev/null +++ b/node_modules/cookie-signature/index.js @@ -0,0 +1,51 @@ +/** + * Module dependencies. + */ + +var crypto = require('crypto'); + +/** + * Sign the given `val` with `secret`. + * + * @param {String} val + * @param {String} secret + * @return {String} + * @api private + */ + +exports.sign = function(val, secret){ + if ('string' != typeof val) throw new TypeError("Cookie value must be provided as a string."); + if ('string' != typeof secret) throw new TypeError("Secret string must be provided."); + return val + '.' + crypto + .createHmac('sha256', secret) + .update(val) + .digest('base64') + .replace(/\=+$/, ''); +}; + +/** + * Unsign and decode the given `val` with `secret`, + * returning `false` if the signature is invalid. + * + * @param {String} val + * @param {String} secret + * @return {String|Boolean} + * @api private + */ + +exports.unsign = function(val, secret){ + if ('string' != typeof val) throw new TypeError("Signed cookie string must be provided."); + if ('string' != typeof secret) throw new TypeError("Secret string must be provided."); + var str = val.slice(0, val.lastIndexOf('.')) + , mac = exports.sign(str, secret); + + return sha1(mac) == sha1(val) ? str : false; +}; + +/** + * Private + */ + +function sha1(str){ + return crypto.createHash('sha1').update(str).digest('hex'); +} diff --git a/node_modules/cookie-signature/package.json b/node_modules/cookie-signature/package.json new file mode 100644 index 0000000..29c4498 --- /dev/null +++ b/node_modules/cookie-signature/package.json @@ -0,0 +1,18 @@ +{ + "name": "cookie-signature", + "version": "1.0.6", + "description": "Sign and unsign cookies", + "keywords": ["cookie", "sign", "unsign"], + "author": "TJ Holowaychuk ", + "license": "MIT", + "repository": { "type": "git", "url": "https://github.com/visionmedia/node-cookie-signature.git"}, + "dependencies": {}, + "devDependencies": { + "mocha": "*", + "should": "*" + }, + "scripts": { + "test": "mocha --require should --reporter spec" + }, + "main": "index" +} diff --git a/node_modules/cookie/LICENSE b/node_modules/cookie/LICENSE new file mode 100644 index 0000000..058b6b4 --- /dev/null +++ b/node_modules/cookie/LICENSE @@ -0,0 +1,24 @@ +(The MIT License) + +Copyright (c) 2012-2014 Roman Shtylman +Copyright (c) 2015 Douglas Christopher Wilson + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +'Software'), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/node_modules/cookie/README.md b/node_modules/cookie/README.md new file mode 100644 index 0000000..71fdac1 --- /dev/null +++ b/node_modules/cookie/README.md @@ -0,0 +1,317 @@ +# cookie + +[![NPM Version][npm-version-image]][npm-url] +[![NPM Downloads][npm-downloads-image]][npm-url] +[![Node.js Version][node-image]][node-url] +[![Build Status][ci-image]][ci-url] +[![Coverage Status][coveralls-image]][coveralls-url] + +Basic HTTP cookie parser and serializer for HTTP servers. + +## Installation + +This is a [Node.js](https://nodejs.org/en/) module available through the +[npm registry](https://www.npmjs.com/). Installation is done using the +[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally): + +```sh +$ npm install cookie +``` + +## API + +```js +var cookie = require('cookie'); +``` + +### cookie.parse(str, options) + +Parse an HTTP `Cookie` header string and returning an object of all cookie name-value pairs. +The `str` argument is the string representing a `Cookie` header value and `options` is an +optional object containing additional parsing options. + +```js +var cookies = cookie.parse('foo=bar; equation=E%3Dmc%5E2'); +// { foo: 'bar', equation: 'E=mc^2' } +``` + +#### Options + +`cookie.parse` accepts these properties in the options object. + +##### decode + +Specifies a function that will be used to decode a cookie's value. Since the value of a cookie +has a limited character set (and must be a simple string), this function can be used to decode +a previously-encoded cookie value into a JavaScript string or other object. + +The default function is the global `decodeURIComponent`, which will decode any URL-encoded +sequences into their byte representations. + +**note** if an error is thrown from this function, the original, non-decoded cookie value will +be returned as the cookie's value. + +### cookie.serialize(name, value, options) + +Serialize a cookie name-value pair into a `Set-Cookie` header string. The `name` argument is the +name for the cookie, the `value` argument is the value to set the cookie to, and the `options` +argument is an optional object containing additional serialization options. + +```js +var setCookie = cookie.serialize('foo', 'bar'); +// foo=bar +``` + +#### Options + +`cookie.serialize` accepts these properties in the options object. + +##### domain + +Specifies the value for the [`Domain` `Set-Cookie` attribute][rfc-6265-5.2.3]. By default, no +domain is set, and most clients will consider the cookie to apply to only the current domain. + +##### encode + +Specifies a function that will be used to encode a cookie's value. Since value of a cookie +has a limited character set (and must be a simple string), this function can be used to encode +a value into a string suited for a cookie's value. + +The default function is the global `encodeURIComponent`, which will encode a JavaScript string +into UTF-8 byte sequences and then URL-encode any that fall outside of the cookie range. + +##### expires + +Specifies the `Date` object to be the value for the [`Expires` `Set-Cookie` attribute][rfc-6265-5.2.1]. +By default, no expiration is set, and most clients will consider this a "non-persistent cookie" and +will delete it on a condition like exiting a web browser application. + +**note** the [cookie storage model specification][rfc-6265-5.3] states that if both `expires` and +`maxAge` are set, then `maxAge` takes precedence, but it is possible not all clients by obey this, +so if both are set, they should point to the same date and time. + +##### httpOnly + +Specifies the `boolean` value for the [`HttpOnly` `Set-Cookie` attribute][rfc-6265-5.2.6]. When truthy, +the `HttpOnly` attribute is set, otherwise it is not. By default, the `HttpOnly` attribute is not set. + +**note** be careful when setting this to `true`, as compliant clients will not allow client-side +JavaScript to see the cookie in `document.cookie`. + +##### maxAge + +Specifies the `number` (in seconds) to be the value for the [`Max-Age` `Set-Cookie` attribute][rfc-6265-5.2.2]. +The given number will be converted to an integer by rounding down. By default, no maximum age is set. + +**note** the [cookie storage model specification][rfc-6265-5.3] states that if both `expires` and +`maxAge` are set, then `maxAge` takes precedence, but it is possible not all clients by obey this, +so if both are set, they should point to the same date and time. + +##### partitioned + +Specifies the `boolean` value for the [`Partitioned` `Set-Cookie`](rfc-cutler-httpbis-partitioned-cookies) +attribute. When truthy, the `Partitioned` attribute is set, otherwise it is not. By default, the +`Partitioned` attribute is not set. + +**note** This is an attribute that has not yet been fully standardized, and may change in the future. +This also means many clients may ignore this attribute until they understand it. + +More information about can be found in [the proposal](https://github.com/privacycg/CHIPS). + +##### path + +Specifies the value for the [`Path` `Set-Cookie` attribute][rfc-6265-5.2.4]. By default, the path +is considered the ["default path"][rfc-6265-5.1.4]. + +##### priority + +Specifies the `string` to be the value for the [`Priority` `Set-Cookie` attribute][rfc-west-cookie-priority-00-4.1]. + + - `'low'` will set the `Priority` attribute to `Low`. + - `'medium'` will set the `Priority` attribute to `Medium`, the default priority when not set. + - `'high'` will set the `Priority` attribute to `High`. + +More information about the different priority levels can be found in +[the specification][rfc-west-cookie-priority-00-4.1]. + +**note** This is an attribute that has not yet been fully standardized, and may change in the future. +This also means many clients may ignore this attribute until they understand it. + +##### sameSite + +Specifies the `boolean` or `string` to be the value for the [`SameSite` `Set-Cookie` attribute][rfc-6265bis-09-5.4.7]. + + - `true` will set the `SameSite` attribute to `Strict` for strict same site enforcement. + - `false` will not set the `SameSite` attribute. + - `'lax'` will set the `SameSite` attribute to `Lax` for lax same site enforcement. + - `'none'` will set the `SameSite` attribute to `None` for an explicit cross-site cookie. + - `'strict'` will set the `SameSite` attribute to `Strict` for strict same site enforcement. + +More information about the different enforcement levels can be found in +[the specification][rfc-6265bis-09-5.4.7]. + +**note** This is an attribute that has not yet been fully standardized, and may change in the future. +This also means many clients may ignore this attribute until they understand it. + +##### secure + +Specifies the `boolean` value for the [`Secure` `Set-Cookie` attribute][rfc-6265-5.2.5]. When truthy, +the `Secure` attribute is set, otherwise it is not. By default, the `Secure` attribute is not set. + +**note** be careful when setting this to `true`, as compliant clients will not send the cookie back to +the server in the future if the browser does not have an HTTPS connection. + +## Example + +The following example uses this module in conjunction with the Node.js core HTTP server +to prompt a user for their name and display it back on future visits. + +```js +var cookie = require('cookie'); +var escapeHtml = require('escape-html'); +var http = require('http'); +var url = require('url'); + +function onRequest(req, res) { + // Parse the query string + var query = url.parse(req.url, true, true).query; + + if (query && query.name) { + // Set a new cookie with the name + res.setHeader('Set-Cookie', cookie.serialize('name', String(query.name), { + httpOnly: true, + maxAge: 60 * 60 * 24 * 7 // 1 week + })); + + // Redirect back after setting cookie + res.statusCode = 302; + res.setHeader('Location', req.headers.referer || '/'); + res.end(); + return; + } + + // Parse the cookies on the request + var cookies = cookie.parse(req.headers.cookie || ''); + + // Get the visitor name set in the cookie + var name = cookies.name; + + res.setHeader('Content-Type', 'text/html; charset=UTF-8'); + + if (name) { + res.write('

Welcome back, ' + escapeHtml(name) + '!

'); + } else { + res.write('

Hello, new visitor!

'); + } + + res.write('
'); + res.write(' '); + res.end('
'); +} + +http.createServer(onRequest).listen(3000); +``` + +## Testing + +```sh +$ npm test +``` + +## Benchmark + +``` +$ npm run bench + +> cookie@0.5.0 bench +> node benchmark/index.js + + node@18.18.2 + acorn@8.10.0 + ada@2.6.0 + ares@1.19.1 + brotli@1.0.9 + cldr@43.1 + icu@73.2 + llhttp@6.0.11 + modules@108 + napi@9 + nghttp2@1.57.0 + nghttp3@0.7.0 + ngtcp2@0.8.1 + openssl@3.0.10+quic + simdutf@3.2.14 + tz@2023c + undici@5.26.3 + unicode@15.0 + uv@1.44.2 + uvwasi@0.0.18 + v8@10.2.154.26-node.26 + zlib@1.2.13.1-motley + +> node benchmark/parse-top.js + + cookie.parse - top sites + + 14 tests completed. + + parse accounts.google.com x 2,588,913 ops/sec ±0.74% (186 runs sampled) + parse apple.com x 2,370,002 ops/sec ±0.69% (186 runs sampled) + parse cloudflare.com x 2,213,102 ops/sec ±0.88% (188 runs sampled) + parse docs.google.com x 2,194,157 ops/sec ±1.03% (184 runs sampled) + parse drive.google.com x 2,265,084 ops/sec ±0.79% (187 runs sampled) + parse en.wikipedia.org x 457,099 ops/sec ±0.81% (186 runs sampled) + parse linkedin.com x 504,407 ops/sec ±0.89% (186 runs sampled) + parse maps.google.com x 1,230,959 ops/sec ±0.98% (186 runs sampled) + parse microsoft.com x 926,294 ops/sec ±0.88% (184 runs sampled) + parse play.google.com x 2,311,338 ops/sec ±0.83% (185 runs sampled) + parse support.google.com x 1,508,850 ops/sec ±0.86% (186 runs sampled) + parse www.google.com x 1,022,582 ops/sec ±1.32% (182 runs sampled) + parse youtu.be x 332,136 ops/sec ±1.02% (185 runs sampled) + parse youtube.com x 323,833 ops/sec ±0.77% (183 runs sampled) + +> node benchmark/parse.js + + cookie.parse - generic + + 6 tests completed. + + simple x 3,214,032 ops/sec ±1.61% (183 runs sampled) + decode x 587,237 ops/sec ±1.16% (187 runs sampled) + unquote x 2,954,618 ops/sec ±1.35% (183 runs sampled) + duplicates x 857,008 ops/sec ±0.89% (187 runs sampled) + 10 cookies x 292,133 ops/sec ±0.89% (187 runs sampled) + 100 cookies x 22,610 ops/sec ±0.68% (187 runs sampled) +``` + +## References + +- [RFC 6265: HTTP State Management Mechanism][rfc-6265] +- [Same-site Cookies][rfc-6265bis-09-5.4.7] + +[rfc-cutler-httpbis-partitioned-cookies]: https://tools.ietf.org/html/draft-cutler-httpbis-partitioned-cookies/ +[rfc-west-cookie-priority-00-4.1]: https://tools.ietf.org/html/draft-west-cookie-priority-00#section-4.1 +[rfc-6265bis-09-5.4.7]: https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-09#section-5.4.7 +[rfc-6265]: https://tools.ietf.org/html/rfc6265 +[rfc-6265-5.1.4]: https://tools.ietf.org/html/rfc6265#section-5.1.4 +[rfc-6265-5.2.1]: https://tools.ietf.org/html/rfc6265#section-5.2.1 +[rfc-6265-5.2.2]: https://tools.ietf.org/html/rfc6265#section-5.2.2 +[rfc-6265-5.2.3]: https://tools.ietf.org/html/rfc6265#section-5.2.3 +[rfc-6265-5.2.4]: https://tools.ietf.org/html/rfc6265#section-5.2.4 +[rfc-6265-5.2.5]: https://tools.ietf.org/html/rfc6265#section-5.2.5 +[rfc-6265-5.2.6]: https://tools.ietf.org/html/rfc6265#section-5.2.6 +[rfc-6265-5.3]: https://tools.ietf.org/html/rfc6265#section-5.3 + +## License + +[MIT](LICENSE) + +[ci-image]: https://badgen.net/github/checks/jshttp/cookie/master?label=ci +[ci-url]: https://github.com/jshttp/cookie/actions/workflows/ci.yml +[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/cookie/master +[coveralls-url]: https://coveralls.io/r/jshttp/cookie?branch=master +[node-image]: https://badgen.net/npm/node/cookie +[node-url]: https://nodejs.org/en/download +[npm-downloads-image]: https://badgen.net/npm/dm/cookie +[npm-url]: https://npmjs.org/package/cookie +[npm-version-image]: https://badgen.net/npm/v/cookie diff --git a/node_modules/cookie/SECURITY.md b/node_modules/cookie/SECURITY.md new file mode 100644 index 0000000..fd4a6c5 --- /dev/null +++ b/node_modules/cookie/SECURITY.md @@ -0,0 +1,25 @@ +# Security Policies and Procedures + +## Reporting a Bug + +The `cookie` team and community take all security bugs seriously. Thank +you for improving the security of the project. We appreciate your efforts and +responsible disclosure and will make every effort to acknowledge your +contributions. + +Report security bugs by emailing the current owner(s) of `cookie`. This +information can be found in the npm registry using the command +`npm owner ls cookie`. +If unsure or unable to get the information from the above, open an issue +in the [project issue tracker](https://github.com/jshttp/cookie/issues) +asking for the current contact information. + +To ensure the timely response to your report, please ensure that the entirety +of the report is contained within the email body and not solely behind a web +link or an attachment. + +At least one owner will acknowledge your email within 48 hours, and will send a +more detailed response within 48 hours indicating the next steps in handling +your report. After the initial reply to your report, the owners will +endeavor to keep you informed of the progress towards a fix and full +announcement, and may ask for additional information or guidance. diff --git a/node_modules/cookie/index.js b/node_modules/cookie/index.js new file mode 100644 index 0000000..51a58cb --- /dev/null +++ b/node_modules/cookie/index.js @@ -0,0 +1,334 @@ +/*! + * cookie + * Copyright(c) 2012-2014 Roman Shtylman + * Copyright(c) 2015 Douglas Christopher Wilson + * MIT Licensed + */ + +'use strict'; + +/** + * Module exports. + * @public + */ + +exports.parse = parse; +exports.serialize = serialize; + +/** + * Module variables. + * @private + */ + +var __toString = Object.prototype.toString + +/** + * RegExp to match cookie-name in RFC 6265 sec 4.1.1 + * This refers out to the obsoleted definition of token in RFC 2616 sec 2.2 + * which has been replaced by the token definition in RFC 7230 appendix B. + * + * cookie-name = token + * token = 1*tchar + * tchar = "!" / "#" / "$" / "%" / "&" / "'" / + * "*" / "+" / "-" / "." / "^" / "_" / + * "`" / "|" / "~" / DIGIT / ALPHA + */ + +var cookieNameRegExp = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/; + +/** + * RegExp to match cookie-value in RFC 6265 sec 4.1.1 + * + * cookie-value = *cookie-octet / ( DQUOTE *cookie-octet DQUOTE ) + * cookie-octet = %x21 / %x23-2B / %x2D-3A / %x3C-5B / %x5D-7E + * ; US-ASCII characters excluding CTLs, + * ; whitespace DQUOTE, comma, semicolon, + * ; and backslash + */ + +var cookieValueRegExp = /^("?)[\u0021\u0023-\u002B\u002D-\u003A\u003C-\u005B\u005D-\u007E]*\1$/; + +/** + * RegExp to match domain-value in RFC 6265 sec 4.1.1 + * + * domain-value = + * ; defined in [RFC1034], Section 3.5, as + * ; enhanced by [RFC1123], Section 2.1 + * =