webserial-core 1.0.0

package/README.md

@@ -0,0 +1,297 @@
+# WebSerial Core
+
+And easy way to connect to a serial port from a web page.
+
+## Installation
+
+```bash
+npm install webserial-core
+```
+
+## Usage
+
+You need to create a new class to configure your device functions. In this example, we are going to create a class to
+connect to an Arduino device.
+
+The first step is having the Arduino code ready. In this case, we are going to use the following code.
+
+```cpp
+// serial.ino
+
+void setup() {
+  Serial.begin(9600);
+}
+
+void loop() {
+  if (Serial.available() > 0) { // Check if data to read is available
+    String comando = Serial.readStringUntil('\n'); // read the data until a new line is found
+
+    if(comando.startsWith("CONNECT")){
+      Serial.println("connected");
+    } else if (comando.startsWith("CREDITS")) {
+      Serial.println("created by danidoble");
+    } else if (comando.startsWith("HI")) {
+      Serial.println("hello there");
+    } else {
+      Serial.println("ara ara, what are you doing?");
+    }
+  }
+}
+```
+
+Create a new class to connect to the device.
+
+```javascript
+// arduino.js
+import { Core } from 'webserial-core';
+
+export class Arduino extends Core {
+  constructor(
+    {
+      filters = null,
+      config_port = {
+        baudRate: 9600,
+        dataBits: 8,
+        stopBits: 1,
+        parity: "none",
+        bufferSize: 32768,
+        flowControl: "none",
+      },
+      no_device = 1,
+    } = {
+      filters: null,
+      config_port: {
+        baudRate: 9600,
+        dataBits: 8,
+        stopBits: 1,
+        parity: "none",
+        bufferSize: 32768,
+        flowControl: "none",
+      },
+      no_device: 1,
+    }
+  ) {
+    super({ filters, config_port, no_device });
+    this.__internal__.device.type = "arduino";
+    Devices.registerType(this.__internal__.device.type);
+    if (Devices.getByNumber(this.typeDevice, no_device)) {
+      throw new Error(`Device ${this.typeDevice} ${no_device} already exists`);
+    }
+    this.__internal__.time.response_connection = 2e3;
+    this.__internal__.time.response_general = 2e3;
+    this.__internal__.serial.delay_first_connection = 1_000;
+    this.#registerAvailableListenersArduino();
+    this.#touch();
+    this.getResponseAsString();
+  }
+
+  #touch() {
+    Devices.add(this);
+  }
+
+  #registerAvailableListenersArduino() {
+    /*const _ = [
+    'my_own_event_dispatched',
+    'my_other_own_event_dispatched',
+    ];
+    for (const event of _) {
+        this.serialRegisterAvailableListener(event)
+    }
+    */
+  }
+
+  serialMessage(codex) {
+    const message = {
+      code: [],
+      name: "",
+      description: "",
+      request: "",
+      no_code: 0,
+    };
+
+    message.code = codex;
+
+    switch (codex) {
+      case "connected":
+        message.name = "connected";
+        message.description = "Connection established";
+        message.request = "connect";
+        message.no_code = 100;
+        break;
+      case "created by danidoble":
+        message.name = "thanks";
+        message.description = "thanks for using this software";
+        message.request = "credits";
+        message.no_code = 101;
+        break;
+      case "hello there":
+        message.name = "hello there";
+        message.description = "hi human";
+        message.request = "hi";
+        message.no_code = 102;
+        break;
+      case "ara ara":
+        message.name = "ara ara";
+        message.description = "troll";
+        message.request = "ara ara";
+        message.no_code = 404;
+        break;
+      default:
+        message.name = "unknown";
+        message.description = "Unknown command";
+        message.request = "unknown";
+        message.no_code = 400;
+        break;
+    }
+
+    this.dispatch("serial:message", message);
+  }
+
+  serialSetConnectionConstant() {
+    return this.add0x(this.parseStringToBytes("CONNECT"));
+  }
+
+  async sayCredits() {
+    const arr = this.parseStringToBytes("CREDITS");
+    await this.appendToQueue(arr, "credits");
+  }
+
+  async sayHi() {
+    const arr = this.parseStringToBytes("HI");
+    await this.appendToQueue(arr, "hi");
+  }
+
+  async sayAra() {
+    const arr = this.parseStringToBytes("OTHER");
+    await this.appendToQueue(arr, "ara");
+  }
+
+  async sendCustomCode({ code = "" } = { code: "" }) {
+    if (typeof code !== "string") throw new Error("Invalid string");
+    const arr = this.parseStringToBytes(code);
+    await this.appendToQueue(arr, "custom");
+  }
+}
+```
+
+Then you can use the class to connect to your device.
+
+```javascript 
+// serialConnection.js
+
+import { Arduino } from './arduino.js';
+
+const arduino = new Arduino();
+
+arduino.on('serial:message', (message) => {
+  console.log(message);
+});
+
+arduino.on('serial:timeout', (data) => {
+  console.log('serial:timeout', data.detail);
+});
+
+// if you need to debug the data sent
+// arduino.on('serial:sent', data => {
+//     console.log('serial:sent',data.detail);
+// });
+
+arduino.on('serial:error', (event) => {
+  document.getElementById('log').innerText += event.detail.message + '\n\n';
+});
+
+// eslint-disable-next-line no-unused-vars
+arduino.on('serial:disconnected', (event) => {
+  document.getElementById('log').innerText += 'Disconnected\n\n';
+
+  document.getElementById('disconnected').classList.remove('hidden');
+  document.getElementById('connect').classList.remove('hidden');
+});
+
+// eslint-disable-next-line no-unused-vars
+arduino.on('serial:connecting', (event) => {
+  document.getElementById('log').innerText += 'Connecting\n\n';
+});
+
+// eslint-disable-next-line no-unused-vars
+arduino.on('serial:connected', (event) => {
+  document.getElementById('log').innerText += 'Connected\n\n';
+
+  document.getElementById('disconnected').classList.add('hidden');
+  document.getElementById('need-permission').classList.add('hidden');
+  document.getElementById('connect').classList.add('hidden');
+});
+
+// eslint-disable-next-line no-unused-vars
+arduino.on('serial:need-permission', (event) => {
+  document.getElementById('disconnected').classList.remove('hidden');
+  document.getElementById('need-permission').classList.remove('hidden');
+  document.getElementById('connect').classList.remove('hidden');
+});
+
+// eslint-disable-next-line no-unused-vars
+arduino.on('serial:soft-reload', (event) => {
+  // reset your variables
+});
+
+// eslint-disable-next-line no-unused-vars
+arduino.on('serial:unsupported', (event) => {
+  document.getElementById('unsupported').classList.remove('hidden');
+});
+
+function tryConnect() {
+  arduino
+    .connect()
+    .then(() => {})
+    .catch(console.error);
+}
+
+document.addEventListener('DOMContentLoaded', () => {
+  tryConnect();
+  document.getElementById('connect').addEventListener('click', tryConnect);
+});
+
+```
+
+But wait still need to create the HTML file.
+
+```html
+<!doctype html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Webserial</title>
+    <script src="./serialConnection.js" type="module"></script>
+</head>
+
+<body class="bg-neutral-950 text-white p-4 w-full">
+
+    <div class="webserial w-full max-w-xl mx-auto grid grid-cols-1 gap-y-4">
+        <div class="my-6"></div>
+        <button id="connect" class="hidden px-4 py-3 bg-gray-800 rounded-lg">Connect to serial</button>
+
+        <div id="need-permission" class="hidden p-4 bg-rose-900 rounded-lg">
+            Woooah! It seems that you need to give permission to access the serial port.
+            Please, click the button 'Connect to serial' to try again.
+        </div>
+
+        <div id="disconnected" class="hidden p-4 bg-neutral-900 w-full">
+            The arduino is disconnected. Please, check the connection.
+        </div>
+
+        <div id="unsupported" class="hidden p-4 bg-orange-700 w-full absolute bottom-0 left-0">
+            This browser does not support the WebSerial API. Please, use a compatible browser.
+        </div>
+
+        <div id="log" class="bg-neutral-800 p-4 rounded-lg">
+            Log: <br>
+        </div>
+    </div>
+
+    <script src="https://cdn.tailwindcss.com?plugins=forms,typography,aspect-ratio,container-queries"></script>
+</body>
+
+</html>
+```

package/dist/webserial-core.js

@@ -0,0 +1,647 @@
+var N = Object.defineProperty;
+var b = (r) => {
+  throw TypeError(r);
+};
+var O = (r, i, e) => i in r ? N(r, i, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[i] = e;
+var h = (r, i, e) => O(r, typeof i != "symbol" ? i + "" : i, e), H = (r, i, e) => i.has(r) || b("Cannot " + e);
+var m = (r, i, e) => i.has(r) ? b("Cannot add the same private member more than once") : i instanceof WeakSet ? i.add(r) : i.set(r, e);
+var l = (r, i, e) => (H(r, i, "access private method"), e);
+const _ = [];
+for (let r = 0; r < 256; ++r)
+  _.push((r + 256).toString(16).slice(1));
+function j(r, i = 0) {
+  return (_[r[i + 0]] + _[r[i + 1]] + _[r[i + 2]] + _[r[i + 3]] + "-" + _[r[i + 4]] + _[r[i + 5]] + "-" + _[r[i + 6]] + _[r[i + 7]] + "-" + _[r[i + 8]] + _[r[i + 9]] + "-" + _[r[i + 10]] + _[r[i + 11]] + _[r[i + 12]] + _[r[i + 13]] + _[r[i + 14]] + _[r[i + 15]]).toLowerCase();
+}
+let p;
+const B = new Uint8Array(16);
+function F() {
+  if (!p) {
+    if (typeof crypto > "u" || !crypto.getRandomValues)
+      throw new Error("crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported");
+    p = crypto.getRandomValues.bind(crypto);
+  }
+  return p(B);
+}
+const $ = typeof crypto < "u" && crypto.randomUUID && crypto.randomUUID.bind(crypto), w = { randomUUID: $ };
+function V(r, i, e) {
+  var n;
+  if (w.randomUUID && !r)
+    return w.randomUUID();
+  r = r || {};
+  const t = r.random ?? ((n = r.rng) == null ? void 0 : n.call(r)) ?? F();
+  if (t.length < 16)
+    throw new Error("Random bytes length must be >= 16");
+  return t[6] = t[6] & 15 | 64, t[8] = t[8] & 63 | 128, j(t);
+}
+class v extends CustomEvent {
+  constructor(i, e) {
+    super(i, e);
+  }
+}
+class S extends EventTarget {
+  constructor() {
+    super(...arguments);
+    h(this, "__listeners__", {
+      debug: !1
+    });
+    h(this, "__debug__", !1);
+  }
+  dispatch(e, t = null) {
+    const n = new v(e, { detail: t });
+    this.dispatchEvent(n), this.__debug__ && this.dispatchEvent(new v("debug", { detail: { type: e, data: t } }));
+  }
+  dispatchAsync(e, t = null, n = 100) {
+    const s = this;
+    setTimeout(() => {
+      s.dispatch(e, t);
+    }, n);
+  }
+  on(e, t) {
+    typeof this.__listeners__[e] < "u" && !this.__listeners__[e] && (this.__listeners__[e] = !0), this.addEventListener(e, t);
+  }
+  off(e, t) {
+    this.removeEventListener(e, t);
+  }
+  serialRegisterAvailableListener(e) {
+    this.__listeners__[e] || (this.__listeners__[e] = !1);
+  }
+  get availableListeners() {
+    return Object.keys(this.__listeners__).sort().map((t) => ({
+      type: t,
+      listening: this.__listeners__[t]
+    }));
+  }
+}
+function x(r = 100) {
+  return new Promise(
+    (i) => setTimeout(() => i(), r)
+  );
+}
+function Q() {
+  return "serial" in navigator;
+}
+const f = {
+  baudRate: 9600,
+  dataBits: 8,
+  stopBits: 1,
+  parity: "none",
+  bufferSize: 32768,
+  flowControl: "none"
+};
+var a, C, g, c, A, E, T, U, k, D, I, L, P, q, R, M;
+class z extends S {
+  constructor({
+    filters: e = null,
+    config_port: t = f,
+    no_device: n = 1,
+    device_listen_on_channel: s = 1
+  } = {
+    filters: null,
+    config_port: f,
+    no_device: 1,
+    device_listen_on_channel: 1
+  }) {
+    super();
+    m(this, a);
+    h(this, "__internal__", {
+      auto_response: !1,
+      device_number: 1,
+      aux_port_connector: 0,
+      last_error: {
+        message: null,
+        action: null,
+        code: null,
+        no_code: 0
+      },
+      serial: {
+        connected: !1,
+        port: null,
+        last_action: null,
+        response: {
+          length: null,
+          buffer: new Uint8Array([]),
+          as: "hex"
+        },
+        reader: null,
+        input_done: null,
+        output_done: null,
+        input_stream: null,
+        output_stream: null,
+        keep_reading: !0,
+        time_until_send_bytes: void 0,
+        delay_first_connection: 200,
+        bytes_connection: null,
+        filters: [],
+        config_port: f,
+        queue: []
+      },
+      device: {
+        type: "unknown",
+        id: V(),
+        listen_on_port: null
+      },
+      time: {
+        response_connection: 500,
+        response_general: 2e3
+      },
+      timeout: {
+        until_response: 0
+      },
+      interval: {
+        reconnection: 0
+      }
+    });
+    e && (this.serialFilters = e), t && (this.serialConfigPort = t), n && l(this, a, R).call(this, n), s && ["number", "string"].includes(typeof s) && (this.listenOnChannel = s), l(this, a, I).call(this), l(this, a, L).call(this);
+  }
+  set listenOnChannel(e) {
+    if (typeof e == "string" && (e = parseInt(e)), isNaN(e) || e < 1 || e > 255)
+      throw new Error("Invalid port number");
+    this.__internal__.device.listen_on_port = e, this.__internal__.serial.bytes_connection = this.serialSetConnectionConstant(e);
+  }
+  get lastAction() {
+    return this.__internal__.serial.last_action;
+  }
+  get listenOnChannel() {
+    return this.__internal__.device.listen_on_port ?? 1;
+  }
+  set serialFilters(e) {
+    this.__internal__.serial.filters = e;
+  }
+  get serialFilters() {
+    return this.__internal__.serial.filters;
+  }
+  set serialConfigPort(e) {
+    this.__internal__.serial.config_port = e;
+  }
+  get serialConfigPort() {
+    return this.__internal__.serial.config_port;
+  }
+  get isConnected() {
+    return this.__internal__.serial.connected;
+  }
+  get isDisconnected() {
+    return !this.__internal__.serial.connected;
+  }
+  get deviceNumber() {
+    return this.__internal__.device_number;
+  }
+  get uuid() {
+    return this.__internal__.device.id;
+  }
+  get typeDevice() {
+    return this.__internal__.device.type;
+  }
+  get queue() {
+    return this.__internal__.serial.queue;
+  }
+  async timeout(e, t) {
+    this.__internal__.last_error.message = "Operation response timed out.", this.__internal__.last_error.action = t, this.__internal__.last_error.code = e, this.__internal__.timeout.until_response && (clearTimeout(this.__internal__.timeout.until_response), this.__internal__.timeout.until_response = 0), t === "connect" ? (this.__internal__.serial.connected = !1, this.dispatch("serial:reconnect", {})) : t === "connection:start" && (await this.serialDisconnect(), this.__internal__.serial.connected = !1, this.__internal__.aux_port_connector += 1, await this.serialConnect()), this.dispatch("serial:timeout", {
+      ...this.__internal__.last_error,
+      bytes: e,
+      action: t
+    });
+  }
+  async disconnect(e = null) {
+    await this.serialDisconnect(), this.__internal__.serial.connected = !1, this.__internal__.aux_port_connector = 0, this.dispatch("serial:disconnected", e);
+  }
+  async connect() {
+    return new Promise((e, t) => {
+      Q() || t("Web Serial not supported"), setTimeout(async () => {
+        await x(499), await this.serialConnect(), this.isConnected ? e(`${this.typeDevice} device ${this.deviceNumber} connected`) : t(`${this.typeDevice} device ${this.deviceNumber} not connected`);
+      }, 1);
+    });
+  }
+  async serialDisconnect() {
+    try {
+      const e = this.__internal__.serial.reader, t = this.__internal__.serial.output_stream;
+      e && (await e.cancel().catch((s) => this.serialErrors(s)), await this.__internal__.serial.input_done), t && (await t.getWriter().close(), await this.__internal__.serial.output_done), this.__internal__.serial.connected && this.__internal__.serial && this.__internal__.serial.port && await this.__internal__.serial.port.close();
+    } catch (e) {
+      this.serialErrors(e);
+    } finally {
+      this.__internal__.serial.reader = null, this.__internal__.serial.input_done = null, this.__internal__.serial.output_stream = null, this.__internal__.serial.output_done = null, this.__internal__.serial.connected = !1, this.__internal__.serial.port = null;
+    }
+  }
+  getResponseAsArrayBuffer() {
+    this.__internal__.serial.response.as = "arraybuffer";
+  }
+  getResponseAsArrayHex() {
+    this.__internal__.serial.response.as = "hex";
+  }
+  getResponseAsUint8Array() {
+    this.__internal__.serial.response.as = "uint8";
+  }
+  getResponseAsString() {
+    this.__internal__.serial.response.as = "string";
+  }
+  async serialPortsSaved(e) {
+    const t = this.serialFilters;
+    if (this.__internal__.aux_port_connector < e.length) {
+      const n = this.__internal__.aux_port_connector;
+      this.__internal__.serial.port = e[n];
+    } else
+      this.__internal__.aux_port_connector = 0, this.__internal__.serial.port = await navigator.serial.requestPort({
+        filters: t
+      });
+    if (!this.__internal__.serial.port)
+      throw new Error("Select another port please");
+  }
+  serialErrors(e) {
+    const t = e.toString().toLowerCase();
+    switch (!0) {
+      case t.includes("must be handling a user gesture to show a permission request"):
+      case t.includes("the port is closed."):
+      case t.includes("the port is closed or is not writable"):
+      case t.includes("select another port please"):
+      case t.includes("no port selected by the user"):
+      case t.includes(
+        "this readable stream reader has been released and cannot be used to cancel its previous owner stream"
+      ):
+        this.dispatch("serial:need-permission", {});
+        break;
+      case t.includes("the port is already open."):
+      case t.includes("failed to open serial port"):
+        this.serialDisconnect().then(async () => {
+          this.__internal__.aux_port_connector += 1, await this.serialConnect();
+        });
+        break;
+      case t.includes("cannot read properties of undefined (reading 'writable')"):
+      case t.includes("cannot read properties of null (reading 'writable')"):
+      case t.includes("cannot read property 'writable' of null"):
+      case t.includes("cannot read property 'writable' of undefined"):
+        this.serialDisconnect().then(async () => {
+          await this.serialConnect();
+        });
+        break;
+      case t.includes("'close' on 'serialport': a call to close() is already in progress."):
+        break;
+      case t.includes("failed to execute 'open' on 'serialport': a call to open() is already in progress."):
+        break;
+      case t.includes("the port is already closed."):
+        break;
+      case t.includes("the device has been lost"):
+        this.dispatch("serial:lost", {});
+        break;
+      case t.includes("navigator.serial is undefined"):
+        this.dispatch("serial:unsupported", {});
+        break;
+      default:
+        console.error(e);
+        break;
+    }
+    this.dispatch("serial:error", e);
+  }
+  async serialConnect() {
+    try {
+      this.dispatch("serial:connecting", {});
+      const e = await l(this, a, A).call(this);
+      if (e.length > 0)
+        await this.serialPortsSaved(e);
+      else {
+        const s = this.serialFilters;
+        this.__internal__.serial.port = await navigator.serial.requestPort({
+          filters: s
+        });
+      }
+      const t = this.__internal__.serial.port;
+      if (!t)
+        throw new Error("No port selected by the user");
+      await t.open(this.serialConfigPort);
+      const n = this;
+      t.onconnect = (s) => {
+        n.dispatch("serial:connected", s), n.__internal__.serial.queue.length > 0 && n.dispatch("internal:queue", {});
+      }, t.ondisconnect = async () => {
+        await n.disconnect();
+      }, await x(this.__internal__.serial.delay_first_connection), this.__internal__.timeout.until_response = setTimeout(async () => {
+        await n.timeout(n.__internal__.serial.bytes_connection ?? [], "connection:start");
+      }, this.__internal__.time.response_connection), this.__internal__.serial.last_action = "connect", await l(this, a, g).call(this, this.__internal__.serial.bytes_connection ?? []), this.dispatch("serial:sent", {
+        action: "connect",
+        bytes: this.__internal__.serial.bytes_connection
+      }), this.__internal__.auto_response && l(this, a, c).call(this, ["DD", "DD"], null), await l(this, a, k).call(this);
+    } catch (e) {
+      this.serialErrors(e);
+    }
+  }
+  async serialForget() {
+    return await l(this, a, D).call(this);
+  }
+  decToHex(e) {
+    return typeof e == "string" && (e = parseInt(e, 10)), e.toString(16);
+  }
+  hexToDec(e) {
+    return parseInt(e, 16);
+  }
+  hexMaker(e = "00", t = 2) {
+    return e.toString().padStart(t, "0").toLowerCase();
+  }
+  add0x(e) {
+    const t = [];
+    return e.forEach((n, s) => {
+      t[s] = "0x" + n;
+    }), t;
+  }
+  bytesToHex(e) {
+    return this.add0x(Array.from(e, (t) => this.hexMaker(t)));
+  }
+  async appendToQueue(e, t) {
+    const n = this.bytesToHex(e);
+    if (["connect", "connection:start"].includes(t)) {
+      if (this.__internal__.serial.connected) return;
+      await this.serialConnect();
+      return;
+    }
+    this.__internal__.serial.queue.push({ bytes: n, action: t }), this.dispatch("internal:queue", {});
+  }
+  serialSetConnectionConstant(e = 1) {
+    throw new Error(`Method not implemented 'serialSetConnectionConstant' to listen on channel ${e}`);
+  }
+  serialMessage(e) {
+    throw console.log(e), new Error("Method not implemented 'serialMessage'");
+  }
+  serialCorruptMessage(e, t) {
+    throw console.log(e, t), new Error("Method not implemented 'serialCorruptMessage'");
+  }
+  clearSerialQueue() {
+    this.__internal__.serial.queue = [];
+  }
+  sumHex(e) {
+    let t = 0;
+    return e.forEach((n) => {
+      t += parseInt(n, 16);
+    }), t.toString(16);
+  }
+  toString() {
+    return JSON.stringify({
+      __class: this.typeDevice,
+      device_number: this.deviceNumber,
+      uuid: this.uuid,
+      connected: this.isConnected,
+      connection: this.__internal__.serial.bytes_connection
+    });
+  }
+  softReload() {
+    l(this, a, M).call(this), this.dispatch("serial:soft-reload", {});
+  }
+  async sendConnect() {
+    if (!this.__internal__.serial.bytes_connection)
+      throw new Error("No connection bytes defined");
+    await this.appendToQueue(this.__internal__.serial.bytes_connection, "connect");
+  }
+  // @ts-expect-error code is required but can be empty
+  async sendCustomCode({ code: e = [] } = { code: [] }) {
+    if (e === null || e.length === 0)
+      throw new Error("No data to send");
+    await this.appendToQueue(e, "custom");
+  }
+  stringToArrayHex(e) {
+    return Array.from(e).map((t) => t.charCodeAt(0).toString(16));
+  }
+  stringToArrayBuffer(e, t = `
+`) {
+    return this.parseStringToTextEncoder(e, t).buffer;
+  }
+  parseStringToTextEncoder(e = "", t = `
+`) {
+    const n = new TextEncoder();
+    return e += t, n.encode(e);
+  }
+  parseStringToBytes(e = "", t = `
+`) {
+    const n = this.parseStringToTextEncoder(e, t);
+    return Array.from(n).map((s) => s.toString(16));
+  }
+  parseUint8ToHex(e) {
+    return Array.from(e).map((t) => t.toString(16));
+  }
+  parseHexToUint8(e) {
+    return new Uint8Array(e.map((t) => parseInt(t, 16)));
+  }
+  stringArrayToUint8Array(e) {
+    const t = [];
+    return e.forEach((n) => {
+      const s = n.replace("0x", "");
+      t.push(parseInt(s, 16));
+    }), new Uint8Array(t);
+  }
+  parseUint8ArrayToString(e) {
+    const t = this.stringArrayToUint8Array(e);
+    e = this.parseUint8ToHex(t);
+    const n = e.map((s) => parseInt(s, 16));
+    return String.fromCharCode(...n).replace(/[\n\r]+/g, "");
+  }
+  hexToAscii(e) {
+    const t = e.toString();
+    let n = "";
+    for (let s = 0; s < t.length; s += 2)
+      n += String.fromCharCode(parseInt(t.substring(s, 2), 16));
+    return n;
+  }
+  asciiToHex(e) {
+    const t = [];
+    for (let n = 0, s = e.length; n < s; n++) {
+      const u = Number(e.charCodeAt(n)).toString(16);
+      t.push(u);
+    }
+    return t.join("");
+  }
+}
+a = new WeakSet(), C = function(e) {
+  return !!(e.readable && e.writable);
+}, g = async function(e) {
+  const t = this.__internal__.serial.port;
+  if (!t || !t.writable)
+    throw new Error("The port is closed or is not writable");
+  const n = this.stringArrayToUint8Array(e), s = t.writable.getWriter();
+  await s.write(n), s.releaseLock();
+}, c = function(e = [], t = null) {
+  if (e && e.length > 0) {
+    this.__internal__.serial.connected || this.dispatch("serial:connected"), this.__internal__.serial.connected = !0, this.__internal__.interval.reconnection && (clearInterval(this.__internal__.interval.reconnection), this.__internal__.interval.reconnection = 0), this.__internal__.timeout.until_response && (clearTimeout(this.__internal__.timeout.until_response), this.__internal__.timeout.until_response = 0);
+    const n = [];
+    for (const s in e)
+      n.push(e[s].toString().padStart(2, "0").toLowerCase());
+    if (this.__internal__.serial.response.as === "hex")
+      this.serialMessage(n);
+    else if (this.__internal__.serial.response.as === "uint8")
+      this.serialMessage(this.parseHexToUint8(this.add0x(n)));
+    else if (this.__internal__.serial.response.as === "string")
+      this.serialMessage(this.parseUint8ArrayToString(this.add0x(n)));
+    else {
+      const s = this.stringToArrayBuffer(
+        this.parseUint8ArrayToString(this.add0x(n))
+      );
+      this.serialMessage(s);
+    }
+  } else
+    this.serialCorruptMessage(e, t);
+  this.__internal__.serial.queue.length !== 0 && this.dispatch("internal:queue", {});
+}, A = async function() {
+  const e = this.serialFilters, t = await navigator.serial.getPorts({ filters: e });
+  return e.length === 0 ? t : t.filter((s) => {
+    const u = s.getInfo();
+    return e.some((y) => u.usbProductId === y.usbProductId && u.usbVendorId === y.usbVendorId);
+  }).filter((s) => !l(this, a, C).call(this, s));
+}, E = function(e) {
+  if (e) {
+    const t = this.__internal__.serial.response.buffer, n = new Uint8Array(t.length + e.byteLength);
+    n.set(t, 0), n.set(new Uint8Array(e), t.length), this.__internal__.serial.response.buffer = n;
+  }
+}, T = async function() {
+  this.__internal__.serial.time_until_send_bytes && (clearTimeout(this.__internal__.serial.time_until_send_bytes), this.__internal__.serial.time_until_send_bytes = 0), this.__internal__.serial.time_until_send_bytes = setTimeout(() => {
+    const e = [];
+    for (const t in this.__internal__.serial.response.buffer)
+      e.push(this.__internal__.serial.response.buffer[t].toString(16));
+    this.__internal__.serial.response.buffer && l(this, a, c).call(this, e), this.__internal__.serial.response.buffer = new Uint8Array(0);
+  }, 400);
+}, U = async function() {
+  if (this.__internal__.serial.response.length !== null) {
+    if (this.__internal__.serial.response.length === this.__internal__.serial.response.buffer.length) {
+      const e = [];
+      for (const t in this.__internal__.serial.response.buffer)
+        e.push(this.__internal__.serial.response.buffer[t].toString(16));
+      l(this, a, c).call(this, e), this.__internal__.serial.response.buffer = new Uint8Array(0);
+    } else if (this.__internal__.serial.response.length < this.__internal__.serial.response.buffer.length) {
+      let e = new Uint8Array(0);
+      for (let n = 0; n < this.__internal__.serial.response.length; n++)
+        e[n] = this.__internal__.serial.response.buffer[n];
+      if (e.length === this.__internal__.serial.response.length) {
+        const n = [];
+        for (const s in e)
+          n.push(e[s].toString(16));
+        l(this, a, c).call(this, n), this.__internal__.serial.response.buffer = new Uint8Array(0);
+        return;
+      }
+      e = new Uint8Array(0);
+      const t = this.__internal__.serial.response.length * 2;
+      if (this.__internal__.serial.response.buffer.length === t) {
+        for (let n = 14; n < t; n++)
+          e[n - this.__internal__.serial.response.length] = this.__internal__.serial.response.buffer[n];
+        if (e.length === this.__internal__.serial.response.length) {
+          const n = [];
+          for (const s in e)
+            n.push(e[s].toString(16));
+          l(this, a, c).call(this, n), this.__internal__.serial.response.buffer = new Uint8Array(0);
+        }
+      }
+    }
+  }
+}, k = async function() {
+  const e = this.__internal__.serial.port;
+  if (!e || !e.readable) throw new Error("Port is not readable");
+  for (; e.readable && this.__internal__.serial.keep_reading; ) {
+    const t = e.readable.getReader();
+    this.__internal__.serial.reader = t;
+    try {
+      let n = !0;
+      for (; n; ) {
+        const { value: s, done: u } = await t.read();
+        if (u) {
+          t.releaseLock(), this.__internal__.serial.keep_reading = !1, n = !1;
+          break;
+        }
+        l(this, a, E).call(this, s), this.__internal__.serial.response.length === null ? await l(this, a, T).call(this) : await l(this, a, U).call(this);
+      }
+    } catch (n) {
+      this.serialErrors(n);
+    } finally {
+      t.releaseLock();
+    }
+  }
+  this.__internal__.serial.keep_reading = !0, this.__internal__.serial.port && await this.__internal__.serial.port.close();
+}, D = async function() {
+  return typeof window > "u" ? !1 : "serial" in navigator && "forget" in SerialPort.prototype && this.__internal__.serial.port ? (await this.__internal__.serial.port.forget(), !0) : !1;
+}, I = function() {
+  [
+    "serial:connected",
+    "serial:connecting",
+    "serial:reconnect",
+    "serial:timeout",
+    "serial:disconnected",
+    "serial:sent",
+    "serial:soft-reload",
+    "serial:message",
+    "unknown",
+    "serial:need-permission",
+    "serial:lost",
+    "serial:unsupported",
+    "serial:error",
+    "debug"
+  ].forEach((t) => {
+    this.serialRegisterAvailableListener(t);
+  });
+}, L = function() {
+  const e = this;
+  this.on("internal:queue", async () => {
+    var t;
+    await l(t = e, a, q).call(t);
+  }), l(this, a, P).call(this);
+}, P = function() {
+  const e = this;
+  navigator.serial.addEventListener("connect", async () => {
+    e.isDisconnected && await e.serialConnect().catch(() => {
+    });
+  });
+}, q = async function() {
+  if (!this.__internal__.serial.connected) {
+    await this.serialConnect();
+    return;
+  }
+  if (this.__internal__.timeout.until_response || this.__internal__.serial.queue.length === 0) return;
+  const e = this.__internal__.serial.queue[0];
+  let t = this.__internal__.time.response_general;
+  e.action === "connect" && (t = this.__internal__.time.response_connection), this.__internal__.timeout.until_response = setTimeout(async () => {
+    await this.timeout(e.bytes, e.action);
+  }, t), this.__internal__.serial.last_action = e.action ?? "unknown", await l(this, a, g).call(this, e.bytes), this.dispatch("serial:sent", {
+    action: e.action,
+    bytes: e.bytes
+  }), this.__internal__.auto_response && l(this, a, c).call(this, ["DD", "DD"], null);
+  const n = [...this.__internal__.serial.queue];
+  this.__internal__.serial.queue = n.splice(1);
+}, R = function(e = 1) {
+  this.__internal__.device_number = e, this.__internal__.serial.bytes_connection = this.serialSetConnectionConstant(e);
+}, M = function() {
+  this.__internal__.last_error = {
+    message: null,
+    action: null,
+    code: null,
+    no_code: 0
+  };
+};
+const o = class o extends S {
+  static typeError(i) {
+    const e = new Error();
+    throw e.message = `Type ${i} is not supported`, e.name = "DeviceTypeError", e;
+  }
+  static registerType(i) {
+    typeof o.devices[i] > "u" && (o.devices[i] = {});
+  }
+  static add(i) {
+    const e = i.typeDevice;
+    typeof o.devices[e] > "u" && (o.devices[e] = {});
+    const t = i.uuid;
+    if (typeof o.devices[e] > "u" && o.typeError(e), this.instance.dispatch("change", o.devices), o.devices[e][t])
+      throw new Error(`Device with id ${t} already exists`);
+    return o.devices[e][t] = i, this.instance.dispatch("change", o.devices), Object.keys(o.devices[e]).indexOf(t);
+  }
+  static get(i, e) {
+    return typeof o.devices[i] > "u" && (o.devices[i] = {}), typeof o.devices[i] > "u" && o.typeError(i), o.devices[i][e];
+  }
+  static getAll(i = null) {
+    return i === null ? o.devices : (typeof o.devices[i] > "u" && o.typeError(i), o.devices[i]);
+  }
+  static getList() {
+    return Object.values(o.devices).map((e) => Object.values(e)).flat();
+  }
+  static getByNumber(i, e) {
+    return typeof o.devices[i] > "u" && o.typeError(i), Object.values(o.devices[i]).find((n) => n.deviceNumber === e) ?? null;
+  }
+  static getCustom(i, e = 1) {
+    return typeof o.devices[i] > "u" && o.typeError(i), Object.values(o.devices[i]).find((n) => n.deviceNumber === e) ?? null;
+  }
+};
+h(o, "instance"), h(o, "devices", {});
+let d = o;
+d.instance || (d.instance = new d());
+export {
+  z as Core,
+  d as Devices,
+  S as Dispatcher
+};

package/dist/webserial-core.umd.cjs

@@ -0,0 +1,4 @@
+(function(_,s){typeof exports=="object"&&typeof module<"u"?s(exports):typeof define=="function"&&define.amd?define(["exports"],s):(_=typeof globalThis<"u"?globalThis:_||self,s(_.WebSerialCore={}))})(this,function(_){"use strict";var V=Object.defineProperty;var C=_=>{throw TypeError(_)};var W=(_,s,u)=>s in _?V(_,s,{enumerable:!0,configurable:!0,writable:!0,value:u}):_[s]=u;var f=(_,s,u)=>W(_,typeof s!="symbol"?s+"":s,u),Q=(_,s,u)=>s.has(_)||C("Cannot "+u);var T=(_,s,u)=>s.has(_)?C("Cannot add the same private member more than once"):s instanceof WeakSet?s.add(_):s.set(_,u);var c=(_,s,u)=>(Q(_,s,"access private method"),u);var a,A,m,h,E,U,D,k,I,L,P,q,M,R,N,O;const s=[];for(let o=0;o<256;++o)s.push((o+256).toString(16).slice(1));function u(o,i=0){return(s[o[i+0]]+s[o[i+1]]+s[o[i+2]]+s[o[i+3]]+"-"+s[o[i+4]]+s[o[i+5]]+"-"+s[o[i+6]]+s[o[i+7]]+"-"+s[o[i+8]]+s[o[i+9]]+"-"+s[o[i+10]]+s[o[i+11]]+s[o[i+12]]+s[o[i+13]]+s[o[i+14]]+s[o[i+15]]).toLowerCase()}let g;const H=new Uint8Array(16);function j(){if(!g){if(typeof crypto>"u"||!crypto.getRandomValues)throw new Error("crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported");g=crypto.getRandomValues.bind(crypto)}return g(H)}const w={randomUUID:typeof crypto<"u"&&crypto.randomUUID&&crypto.randomUUID.bind(crypto)};function B(o,i,e){var n;if(w.randomUUID&&!o)return w.randomUUID();o=o||{};const t=o.random??((n=o.rng)==null?void 0:n.call(o))??j();if(t.length<16)throw new Error("Random bytes length must be >= 16");return t[6]=t[6]&15|64,t[8]=t[8]&63|128,u(t)}class v extends CustomEvent{constructor(i,e){super(i,e)}}class y extends EventTarget{constructor(){super(...arguments);f(this,"__listeners__",{debug:!1});f(this,"__debug__",!1)}dispatch(e,t=null){const n=new v(e,{detail:t});this.dispatchEvent(n),this.__debug__&&this.dispatchEvent(new v("debug",{detail:{type:e,data:t}}))}dispatchAsync(e,t=null,n=100){const r=this;setTimeout(()=>{r.dispatch(e,t)},n)}on(e,t){typeof this.__listeners__[e]<"u"&&!this.__listeners__[e]&&(this.__listeners__[e]=!0),this.addEventListener(e,t)}off(e,t){this.removeEventListener(e,t)}serialRegisterAvailableListener(e){this.__listeners__[e]||(this.__listeners__[e]=!1)}get availableListeners(){return Object.keys(this.__listeners__).sort().map(t=>({type:t,listening:this.__listeners__[t]}))}}function x(o=100){return new Promise(i=>setTimeout(()=>i(),o))}function F(){return"serial"in navigator}const b={baudRate:9600,dataBits:8,stopBits:1,parity:"none",bufferSize:32768,flowControl:"none"};class $ extends y{constructor({filters:e=null,config_port:t=b,no_device:n=1,device_listen_on_channel:r=1}={filters:null,config_port:b,no_device:1,device_listen_on_channel:1}){super();T(this,a);f(this,"__internal__",{auto_response:!1,device_number:1,aux_port_connector:0,last_error:{message:null,action:null,code:null,no_code:0},serial:{connected:!1,port:null,last_action:null,response:{length:null,buffer:new Uint8Array([]),as:"hex"},reader:null,input_done:null,output_done:null,input_stream:null,output_stream:null,keep_reading:!0,time_until_send_bytes:void 0,delay_first_connection:200,bytes_connection:null,filters:[],config_port:b,queue:[]},device:{type:"unknown",id:B(),listen_on_port:null},time:{response_connection:500,response_general:2e3},timeout:{until_response:0},interval:{reconnection:0}});e&&(this.serialFilters=e),t&&(this.serialConfigPort=t),n&&c(this,a,N).call(this,n),r&&["number","string"].includes(typeof r)&&(this.listenOnChannel=r),c(this,a,P).call(this),c(this,a,q).call(this)}set listenOnChannel(e){if(typeof e=="string"&&(e=parseInt(e)),isNaN(e)||e<1||e>255)throw new Error("Invalid port number");this.__internal__.device.listen_on_port=e,this.__internal__.serial.bytes_connection=this.serialSetConnectionConstant(e)}get lastAction(){return this.__internal__.serial.last_action}get listenOnChannel(){return this.__internal__.device.listen_on_port??1}set serialFilters(e){this.__internal__.serial.filters=e}get serialFilters(){return this.__internal__.serial.filters}set serialConfigPort(e){this.__internal__.serial.config_port=e}get serialConfigPort(){return this.__internal__.serial.config_port}get isConnected(){return this.__internal__.serial.connected}get isDisconnected(){return!this.__internal__.serial.connected}get deviceNumber(){return this.__internal__.device_number}get uuid(){return this.__internal__.device.id}get typeDevice(){return this.__internal__.device.type}get queue(){return this.__internal__.serial.queue}async timeout(e,t){this.__internal__.last_error.message="Operation response timed out.",this.__internal__.last_error.action=t,this.__internal__.last_error.code=e,this.__internal__.timeout.until_response&&(clearTimeout(this.__internal__.timeout.until_response),this.__internal__.timeout.until_response=0),t==="connect"?(this.__internal__.serial.connected=!1,this.dispatch("serial:reconnect",{})):t==="connection:start"&&(await this.serialDisconnect(),this.__internal__.serial.connected=!1,this.__internal__.aux_port_connector+=1,await this.serialConnect()),this.dispatch("serial:timeout",{...this.__internal__.last_error,bytes:e,action:t})}async disconnect(e=null){await this.serialDisconnect(),this.__internal__.serial.connected=!1,this.__internal__.aux_port_connector=0,this.dispatch("serial:disconnected",e)}async connect(){return new Promise((e,t)=>{F()||t("Web Serial not supported"),setTimeout(async()=>{await x(499),await this.serialConnect(),this.isConnected?e(`${this.typeDevice} device ${this.deviceNumber} connected`):t(`${this.typeDevice} device ${this.deviceNumber} not connected`)},1)})}async serialDisconnect(){try{const e=this.__internal__.serial.reader,t=this.__internal__.serial.output_stream;e&&(await e.cancel().catch(r=>this.serialErrors(r)),await this.__internal__.serial.input_done),t&&(await t.getWriter().close(),await this.__internal__.serial.output_done),this.__internal__.serial.connected&&this.__internal__.serial&&this.__internal__.serial.port&&await this.__internal__.serial.port.close()}catch(e){this.serialErrors(e)}finally{this.__internal__.serial.reader=null,this.__internal__.serial.input_done=null,this.__internal__.serial.output_stream=null,this.__internal__.serial.output_done=null,this.__internal__.serial.connected=!1,this.__internal__.serial.port=null}}getResponseAsArrayBuffer(){this.__internal__.serial.response.as="arraybuffer"}getResponseAsArrayHex(){this.__internal__.serial.response.as="hex"}getResponseAsUint8Array(){this.__internal__.serial.response.as="uint8"}getResponseAsString(){this.__internal__.serial.response.as="string"}async serialPortsSaved(e){const t=this.serialFilters;if(this.__internal__.aux_port_connector<e.length){const n=this.__internal__.aux_port_connector;this.__internal__.serial.port=e[n]}else this.__internal__.aux_port_connector=0,this.__internal__.serial.port=await navigator.serial.requestPort({filters:t});if(!this.__internal__.serial.port)throw new Error("Select another port please")}serialErrors(e){const t=e.toString().toLowerCase();switch(!0){case t.includes("must be handling a user gesture to show a permission request"):case t.includes("the port is closed."):case t.includes("the port is closed or is not writable"):case t.includes("select another port please"):case t.includes("no port selected by the user"):case t.includes("this readable stream reader has been released and cannot be used to cancel its previous owner stream"):this.dispatch("serial:need-permission",{});break;case t.includes("the port is already open."):case t.includes("failed to open serial port"):this.serialDisconnect().then(async()=>{this.__internal__.aux_port_connector+=1,await this.serialConnect()});break;case t.includes("cannot read properties of undefined (reading 'writable')"):case t.includes("cannot read properties of null (reading 'writable')"):case t.includes("cannot read property 'writable' of null"):case t.includes("cannot read property 'writable' of undefined"):this.serialDisconnect().then(async()=>{await this.serialConnect()});break;case t.includes("'close' on 'serialport': a call to close() is already in progress."):break;case t.includes("failed to execute 'open' on 'serialport': a call to open() is already in progress."):break;case t.includes("the port is already closed."):break;case t.includes("the device has been lost"):this.dispatch("serial:lost",{});break;case t.includes("navigator.serial is undefined"):this.dispatch("serial:unsupported",{});break;default:console.error(e);break}this.dispatch("serial:error",e)}async serialConnect(){try{this.dispatch("serial:connecting",{});const e=await c(this,a,E).call(this);if(e.length>0)await this.serialPortsSaved(e);else{const r=this.serialFilters;this.__internal__.serial.port=await navigator.serial.requestPort({filters:r})}const t=this.__internal__.serial.port;if(!t)throw new Error("No port selected by the user");await t.open(this.serialConfigPort);const n=this;t.onconnect=r=>{n.dispatch("serial:connected",r),n.__internal__.serial.queue.length>0&&n.dispatch("internal:queue",{})},t.ondisconnect=async()=>{await n.disconnect()},await x(this.__internal__.serial.delay_first_connection),this.__internal__.timeout.until_response=setTimeout(async()=>{await n.timeout(n.__internal__.serial.bytes_connection??[],"connection:start")},this.__internal__.time.response_connection),this.__internal__.serial.last_action="connect",await c(this,a,m).call(this,this.__internal__.serial.bytes_connection??[]),this.dispatch("serial:sent",{action:"connect",bytes:this.__internal__.serial.bytes_connection}),this.__internal__.auto_response&&c(this,a,h).call(this,["DD","DD"],null),await c(this,a,I).call(this)}catch(e){this.serialErrors(e)}}async serialForget(){return await c(this,a,L).call(this)}decToHex(e){return typeof e=="string"&&(e=parseInt(e,10)),e.toString(16)}hexToDec(e){return parseInt(e,16)}hexMaker(e="00",t=2){return e.toString().padStart(t,"0").toLowerCase()}add0x(e){const t=[];return e.forEach((n,r)=>{t[r]="0x"+n}),t}bytesToHex(e){return this.add0x(Array.from(e,t=>this.hexMaker(t)))}async appendToQueue(e,t){const n=this.bytesToHex(e);if(["connect","connection:start"].includes(t)){if(this.__internal__.serial.connected)return;await this.serialConnect();return}this.__internal__.serial.queue.push({bytes:n,action:t}),this.dispatch("internal:queue",{})}serialSetConnectionConstant(e=1){throw new Error(`Method not implemented 'serialSetConnectionConstant' to listen on channel ${e}`)}serialMessage(e){throw console.log(e),new Error("Method not implemented 'serialMessage'")}serialCorruptMessage(e,t){throw console.log(e,t),new Error("Method not implemented 'serialCorruptMessage'")}clearSerialQueue(){this.__internal__.serial.queue=[]}sumHex(e){let t=0;return e.forEach(n=>{t+=parseInt(n,16)}),t.toString(16)}toString(){return JSON.stringify({__class:this.typeDevice,device_number:this.deviceNumber,uuid:this.uuid,connected:this.isConnected,connection:this.__internal__.serial.bytes_connection})}softReload(){c(this,a,O).call(this),this.dispatch("serial:soft-reload",{})}async sendConnect(){if(!this.__internal__.serial.bytes_connection)throw new Error("No connection bytes defined");await this.appendToQueue(this.__internal__.serial.bytes_connection,"connect")}async sendCustomCode({code:e=[]}={code:[]}){if(e===null||e.length===0)throw new Error("No data to send");await this.appendToQueue(e,"custom")}stringToArrayHex(e){return Array.from(e).map(t=>t.charCodeAt(0).toString(16))}stringToArrayBuffer(e,t=`
+`){return this.parseStringToTextEncoder(e,t).buffer}parseStringToTextEncoder(e="",t=`
+`){const n=new TextEncoder;return e+=t,n.encode(e)}parseStringToBytes(e="",t=`
+`){const n=this.parseStringToTextEncoder(e,t);return Array.from(n).map(r=>r.toString(16))}parseUint8ToHex(e){return Array.from(e).map(t=>t.toString(16))}parseHexToUint8(e){return new Uint8Array(e.map(t=>parseInt(t,16)))}stringArrayToUint8Array(e){const t=[];return e.forEach(n=>{const r=n.replace("0x","");t.push(parseInt(r,16))}),new Uint8Array(t)}parseUint8ArrayToString(e){const t=this.stringArrayToUint8Array(e);e=this.parseUint8ToHex(t);const n=e.map(r=>parseInt(r,16));return String.fromCharCode(...n).replace(/[\n\r]+/g,"")}hexToAscii(e){const t=e.toString();let n="";for(let r=0;r<t.length;r+=2)n+=String.fromCharCode(parseInt(t.substring(r,2),16));return n}asciiToHex(e){const t=[];for(let n=0,r=e.length;n<r;n++){const p=Number(e.charCodeAt(n)).toString(16);t.push(p)}return t.join("")}}a=new WeakSet,A=function(e){return!!(e.readable&&e.writable)},m=async function(e){const t=this.__internal__.serial.port;if(!t||!t.writable)throw new Error("The port is closed or is not writable");const n=this.stringArrayToUint8Array(e),r=t.writable.getWriter();await r.write(n),r.releaseLock()},h=function(e=[],t=null){if(e&&e.length>0){this.__internal__.serial.connected||this.dispatch("serial:connected"),this.__internal__.serial.connected=!0,this.__internal__.interval.reconnection&&(clearInterval(this.__internal__.interval.reconnection),this.__internal__.interval.reconnection=0),this.__internal__.timeout.until_response&&(clearTimeout(this.__internal__.timeout.until_response),this.__internal__.timeout.until_response=0);const n=[];for(const r in e)n.push(e[r].toString().padStart(2,"0").toLowerCase());if(this.__internal__.serial.response.as==="hex")this.serialMessage(n);else if(this.__internal__.serial.response.as==="uint8")this.serialMessage(this.parseHexToUint8(this.add0x(n)));else if(this.__internal__.serial.response.as==="string")this.serialMessage(this.parseUint8ArrayToString(this.add0x(n)));else{const r=this.stringToArrayBuffer(this.parseUint8ArrayToString(this.add0x(n)));this.serialMessage(r)}}else this.serialCorruptMessage(e,t);this.__internal__.serial.queue.length!==0&&this.dispatch("internal:queue",{})},E=async function(){const e=this.serialFilters,t=await navigator.serial.getPorts({filters:e});return e.length===0?t:t.filter(r=>{const p=r.getInfo();return e.some(S=>p.usbProductId===S.usbProductId&&p.usbVendorId===S.usbVendorId)}).filter(r=>!c(this,a,A).call(this,r))},U=function(e){if(e){const t=this.__internal__.serial.response.buffer,n=new Uint8Array(t.length+e.byteLength);n.set(t,0),n.set(new Uint8Array(e),t.length),this.__internal__.serial.response.buffer=n}},D=async function(){this.__internal__.serial.time_until_send_bytes&&(clearTimeout(this.__internal__.serial.time_until_send_bytes),this.__internal__.serial.time_until_send_bytes=0),this.__internal__.serial.time_until_send_bytes=setTimeout(()=>{const e=[];for(const t in this.__internal__.serial.response.buffer)e.push(this.__internal__.serial.response.buffer[t].toString(16));this.__internal__.serial.response.buffer&&c(this,a,h).call(this,e),this.__internal__.serial.response.buffer=new Uint8Array(0)},400)},k=async function(){if(this.__internal__.serial.response.length!==null){if(this.__internal__.serial.response.length===this.__internal__.serial.response.buffer.length){const e=[];for(const t in this.__internal__.serial.response.buffer)e.push(this.__internal__.serial.response.buffer[t].toString(16));c(this,a,h).call(this,e),this.__internal__.serial.response.buffer=new Uint8Array(0)}else if(this.__internal__.serial.response.length<this.__internal__.serial.response.buffer.length){let e=new Uint8Array(0);for(let n=0;n<this.__internal__.serial.response.length;n++)e[n]=this.__internal__.serial.response.buffer[n];if(e.length===this.__internal__.serial.response.length){const n=[];for(const r in e)n.push(e[r].toString(16));c(this,a,h).call(this,n),this.__internal__.serial.response.buffer=new Uint8Array(0);return}e=new Uint8Array(0);const t=this.__internal__.serial.response.length*2;if(this.__internal__.serial.response.buffer.length===t){for(let n=14;n<t;n++)e[n-this.__internal__.serial.response.length]=this.__internal__.serial.response.buffer[n];if(e.length===this.__internal__.serial.response.length){const n=[];for(const r in e)n.push(e[r].toString(16));c(this,a,h).call(this,n),this.__internal__.serial.response.buffer=new Uint8Array(0)}}}}},I=async function(){const e=this.__internal__.serial.port;if(!e||!e.readable)throw new Error("Port is not readable");for(;e.readable&&this.__internal__.serial.keep_reading;){const t=e.readable.getReader();this.__internal__.serial.reader=t;try{let n=!0;for(;n;){const{value:r,done:p}=await t.read();if(p){t.releaseLock(),this.__internal__.serial.keep_reading=!1,n=!1;break}c(this,a,U).call(this,r),this.__internal__.serial.response.length===null?await c(this,a,D).call(this):await c(this,a,k).call(this)}}catch(n){this.serialErrors(n)}finally{t.releaseLock()}}this.__internal__.serial.keep_reading=!0,this.__internal__.serial.port&&await this.__internal__.serial.port.close()},L=async function(){return typeof window>"u"?!1:"serial"in navigator&&"forget"in SerialPort.prototype&&this.__internal__.serial.port?(await this.__internal__.serial.port.forget(),!0):!1},P=function(){["serial:connected","serial:connecting","serial:reconnect","serial:timeout","serial:disconnected","serial:sent","serial:soft-reload","serial:message","unknown","serial:need-permission","serial:lost","serial:unsupported","serial:error","debug"].forEach(t=>{this.serialRegisterAvailableListener(t)})},q=function(){const e=this;this.on("internal:queue",async()=>{var t;await c(t=e,a,R).call(t)}),c(this,a,M).call(this)},M=function(){const e=this;navigator.serial.addEventListener("connect",async()=>{e.isDisconnected&&await e.serialConnect().catch(()=>{})})},R=async function(){if(!this.__internal__.serial.connected){await this.serialConnect();return}if(this.__internal__.timeout.until_response||this.__internal__.serial.queue.length===0)return;const e=this.__internal__.serial.queue[0];let t=this.__internal__.time.response_general;e.action==="connect"&&(t=this.__internal__.time.response_connection),this.__internal__.timeout.until_response=setTimeout(async()=>{await this.timeout(e.bytes,e.action)},t),this.__internal__.serial.last_action=e.action??"unknown",await c(this,a,m).call(this,e.bytes),this.dispatch("serial:sent",{action:e.action,bytes:e.bytes}),this.__internal__.auto_response&&c(this,a,h).call(this,["DD","DD"],null);const n=[...this.__internal__.serial.queue];this.__internal__.serial.queue=n.splice(1)},N=function(e=1){this.__internal__.device_number=e,this.__internal__.serial.bytes_connection=this.serialSetConnectionConstant(e)},O=function(){this.__internal__.last_error={message:null,action:null,code:null,no_code:0}};const l=class l extends y{static typeError(i){const e=new Error;throw e.message=`Type ${i} is not supported`,e.name="DeviceTypeError",e}static registerType(i){typeof l.devices[i]>"u"&&(l.devices[i]={})}static add(i){const e=i.typeDevice;typeof l.devices[e]>"u"&&(l.devices[e]={});const t=i.uuid;if(typeof l.devices[e]>"u"&&l.typeError(e),this.instance.dispatch("change",l.devices),l.devices[e][t])throw new Error(`Device with id ${t} already exists`);return l.devices[e][t]=i,this.instance.dispatch("change",l.devices),Object.keys(l.devices[e]).indexOf(t)}static get(i,e){return typeof l.devices[i]>"u"&&(l.devices[i]={}),typeof l.devices[i]>"u"&&l.typeError(i),l.devices[i][e]}static getAll(i=null){return i===null?l.devices:(typeof l.devices[i]>"u"&&l.typeError(i),l.devices[i])}static getList(){return Object.values(l.devices).map(e=>Object.values(e)).flat()}static getByNumber(i,e){return typeof l.devices[i]>"u"&&l.typeError(i),Object.values(l.devices[i]).find(n=>n.deviceNumber===e)??null}static getCustom(i,e=1){return typeof l.devices[i]>"u"&&l.typeError(i),Object.values(l.devices[i]).find(n=>n.deviceNumber===e)??null}};f(l,"instance"),f(l,"devices",{});let d=l;d.instance||(d.instance=new d),_.Core=$,_.Devices=d,_.Dispatcher=y,Object.defineProperty(_,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "webserial-core",
+  "description": "Webserial Core to easy connections with serial devices",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "author": "danidoble",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danidoble/webserial-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/danidoble/webserial-core/issues"
+  },
+  "homepage": "https://github.com/danidoble/webserial-core#readme",
+  "keywords": [
+    "webserial",
+    "serial",
+    "core",
+    "web"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/webserial-core.umd.cjs",
+  "module": "./dist/webserial-core.js",
+  "exports": {
+    ".": {
+      "import": "./dist/webserial-core.js",
+      "require": "./dist/webserial-core.umd.cjs"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "prettier --write ./lib/**/*.ts && tsc && vite build",
+    "preview": "vite preview",
+    "lint": "eslint --ext .ts ./lib",
+    "format": "prettier --write ./lib/**/*.ts"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.21.0",
+    "@types/w3c-web-serial": "^1.0.8",
+    "eslint": "^9.21.0",
+    "globals": "^15.15.0",
+    "prettier": "3.4.2",
+    "puppeteer": "^24.4.0",
+    "semantic-release": "^24.2.3",
+    "typescript": "~5.7.3",
+    "typescript-eslint": "^8.26.0",
+    "uuid": "^11.1.0",
+    "vite": "^6.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}