Initial commit

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.

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.

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/)

node_modules/@serialport/bindings-interface/dist/index-esm.mjs

@@ -0,0 +1 @@
+

node_modules/@serialport/bindings-interface/dist/index.d.ts

@@ -0,0 +1,151 @@
+/// <reference types="node" />
+
+export declare interface BindingInterface<T extends BindingPortInterface = BindingPortInterface, R extends OpenOptions = OpenOptions, P extends PortInfo = PortInfo> {
+    /**
+     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<P[]>;
+    /**
+     * Opens a connection to the serial port referenced by the path.
+     */
+    open(options: R): Promise<T>;
+}
+
+/**
+ * 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<OpenOptions>;
+    /**
+     * Required property. `true` if the port is open, `false` otherwise. Read only.
+     */
+    isOpen: boolean;
+    /**
+     * Closes an open port
+     */
+    close(): Promise<void>;
+    /**
+     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<void>;
+    /**
+     Changes connection settings on an open port.
+     */
+    update(options: UpdateOptions): Promise<void>;
+    /**
+     * 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<void>;
+    /**
+     * Get the control flags (CTS, DSR, DCD) on the open port.
+     */
+    get(): Promise<PortStatus>;
+    /**
+     * 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<void>;
+    /**
+     * 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<void>;
+}
+
+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> = Binding extends BindingInterface<any, infer T> ? 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> = Binding extends BindingInterface<any, any, infer T> ? T : never;
+
+export declare type PortInterfaceFromBinding<Binding> = Binding extends BindingInterface<infer T> ? 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 { }

node_modules/@serialport/bindings-interface/dist/index.js

@@ -0,0 +1,2 @@
+'use strict';
+

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"
+  }
+}