react-native-web-serial-api 0.0.3 → 0.2.0

package/lib/commonjs/testing/simulated-device.js

@@ -0,0 +1,164 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SinkDevice = exports.SimulatedDevice = exports.LoopbackDevice = exports.LineBufferedDevice = void 0;
+exports.toBytes = toBytes;
+/**
+ * SimulatedDevice — author a complete simulated serial peripheral.
+ *
+ * Extend the class and override the lifecycle hooks to model a real device's
+ * whole behaviour (firmware/protocol): react to `open()`, to bytes the host
+ * writes, to control-signal changes, and stream data back over time. It is
+ * hosted by an {@link InMemorySerialTransport} ({@link ./virtual-serial}) and is
+ * free of any `react-native` dependency, so the same device runs under Jest,
+ * in a browser, and inside a React Native app on a device/emulator (for E2E).
+ *
+ * @example
+ * class Thermometer extends SimulatedDevice {
+ *   usbVendorId = 0x0403;
+ *   usbProductId = 0x6001;
+ *   #timer?: ReturnType<typeof setInterval>;
+ *   onOpen() {
+ *     this.#timer = setInterval(() => this.send(`${20 + Math.random()}C\r\n`), 1000);
+ *   }
+ *   onData(bytes) {                       // host wrote a command
+ *     if (String.fromCharCode(...bytes).trim() === 'ID?') this.send('ACME-TEMP\r\n');
+ *   }
+ *   onClose() { clearInterval(this.#timer); }
+ * }
+ * transport.addDevice(new Thermometer(), {hasPermission: true});
+ */
+
+/** The negotiated connection parameters (native parity code: 0 none/1 odd/2 even). */
+
+/** Device-asserted input signals — what the host reads via getSignals(). */
+
+/** Host-asserted output signals (DTR/RTS/break) the device observes. */
+
+/**
+ * The handle a {@link SimulatedDevice} uses to talk back to the host. Provided by
+ * the transport; you normally use the `protected` helpers on `SimulatedDevice`
+ * rather than this directly.
+ */
+
+/** Coerce a payload into a byte array (string → char codes, & 0xff). */
+function toBytes(data) {
+  if (typeof data === 'string') {
+    return Array.from(data, c => c.charCodeAt(0) & 0xff);
+  }
+  if (data instanceof Uint8Array) return Array.from(data);
+  return data.map(n => n & 0xff);
+}
+
+/**
+ * Base class for a simulated serial peripheral. Override the `on*` hooks you
+ * care about (all default to no-ops and may be async) and use the `protected`
+ * helpers to drive the host.
+ */
+class SimulatedDevice {
+  /** USB Vendor ID this device reports for enumeration. */
+
+  /** USB Product ID this device reports for enumeration. */
+
+  /** Optional USB serial number. */
+
+  #host = null;
+
+  /** @internal Bind the transport host (called by InMemorySerialTransport). */
+  _bind(host) {
+    this.#host = host;
+  }
+
+  /** Send bytes to the host (they appear on `port.readable`). */
+  send(data) {
+    this.#host?.send(toBytes(data));
+  }
+
+  /**
+   * Raise a typed read error on the host's readable stream. `name` is the W3C
+   * error type, e.g. "BreakError", "BufferOverrunError", "FramingError",
+   * "ParityError" (defaults to "NetworkError").
+   */
+  raiseError(message, name) {
+    this.#host?.raiseError(message, name);
+  }
+
+  /** Set device-asserted input signals (DCD/CTS/RI/DSR) the host can read. */
+  setSignals(signals) {
+    this.#host?.setSignals(signals);
+  }
+
+  /** The parameters the host opened the port with, or null when closed. */
+  get openOptions() {
+    return this.#host?.openOptions ?? null;
+  }
+  get deviceId() {
+    return this.#host?.deviceId ?? -1;
+  }
+  get portNumber() {
+    return this.#host?.portNumber ?? 0;
+  }
+
+  /** The host opened the port. */
+  onOpen(_options) {}
+  /** The host wrote bytes to the device. */
+  onData(_data) {}
+  /** The host changed DTR/RTS/break. */
+  onHostSignals(_signals) {}
+  /** The host closed the port. */
+  onClose() {}
+}
+
+/** Optional USB identity for built-in devices. */
+exports.SimulatedDevice = SimulatedDevice;
+/** A loopback device: every byte written is echoed straight back. */
+class LoopbackDevice extends SimulatedDevice {
+  constructor(identity = {}) {
+    super();
+    this.usbVendorId = identity.usbVendorId ?? 0x0403;
+    this.usbProductId = identity.usbProductId ?? 0x6001;
+    this.serialNumber = identity.serialNumber;
+  }
+  onData(data) {
+    this.send(data);
+  }
+}
+
+/**
+ * Base for a line-oriented command/response device: buffers incoming bytes and
+ * calls {@link onLine} for each `\n`-terminated line (trailing CR/LF stripped).
+ */
+exports.LoopbackDevice = LoopbackDevice;
+class LineBufferedDevice extends SimulatedDevice {
+  #buffer = '';
+
+  /** Handle one line received from the host. */
+
+  onData(data) {
+    for (let i = 0; i < data.length; i++) {
+      this.#buffer += String.fromCharCode(data[i]);
+    }
+    let nl = this.#buffer.indexOf('\n');
+    while (nl >= 0) {
+      const line = this.#buffer.slice(0, nl).replace(/\r$/, '');
+      this.#buffer = this.#buffer.slice(nl + 1);
+      void this.onLine(line);
+      nl = this.#buffer.indexOf('\n');
+    }
+  }
+}
+
+/** A device that accepts writes but never sends anything back. */
+exports.LineBufferedDevice = LineBufferedDevice;
+class SinkDevice extends SimulatedDevice {
+  constructor(identity = {}) {
+    super();
+    this.usbVendorId = identity.usbVendorId ?? 0x0403;
+    this.usbProductId = identity.usbProductId ?? 0x6001;
+    this.serialNumber = identity.serialNumber;
+  }
+}
+exports.SinkDevice = SinkDevice;
+//# sourceMappingURL=simulated-device.js.map

package/lib/commonjs/testing/simulated-device.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["toBytes","data","Array","from","c","charCodeAt","Uint8Array","map","n","SimulatedDevice","host","_bind","send","raiseError","message","name","setSignals","signals","openOptions","deviceId","portNumber","onOpen","_options","onData","_data","onHostSignals","_signals","onClose","exports","LoopbackDevice","constructor","identity","usbVendorId","usbProductId","serialNumber","LineBufferedDevice","buffer","i","length","String","fromCharCode","nl","indexOf","line","slice","replace","onLine","SinkDevice"],"sourceRoot":"../../../src","sources":["testing/simulated-device.ts"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAGA;;AAQA;;AAOA;AACA;AACA;AACA;AACA;;AAWA;AACO,SAASA,OAAOA,CAACC,IAAoC,EAAY;EACtE,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;IAC5B,OAAOC,KAAK,CAACC,IAAI,CAACF,IAAI,EAAEG,CAAC,IAAIA,CAAC,CAACC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;EACtD;EACA,IAAIJ,IAAI,YAAYK,UAAU,EAAE,OAAOJ,KAAK,CAACC,IAAI,CAACF,IAAI,CAAC;EACvD,OAAOA,IAAI,CAACM,GAAG,CAACC,CAAC,IAAIA,CAAC,GAAG,IAAI,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAeC,eAAe,CAAC;EACpC;;EAEA;;EAEA;;EAGA,CAACC,IAAI,GAA+B,IAAI;;EAExC;EACAC,KAAKA,CAACD,IAAyB,EAAQ;IACrC,IAAI,CAAC,CAACA,IAAI,GAAGA,IAAI;EACnB;;EAEA;EACUE,IAAIA,CAACX,IAAoC,EAAQ;IACzD,IAAI,CAAC,CAACS,IAAI,EAAEE,IAAI,CAACZ,OAAO,CAACC,IAAI,CAAC,CAAC;EACjC;;EAEA;AACF;AACA;AACA;AACA;EACYY,UAAUA,CAACC,OAAe,EAAEC,IAAa,EAAQ;IACzD,IAAI,CAAC,CAACL,IAAI,EAAEG,UAAU,CAACC,OAAO,EAAEC,IAAI,CAAC;EACvC;;EAEA;EACUC,UAAUA,CAACC,OAA2B,EAAQ;IACtD,IAAI,CAAC,CAACP,IAAI,EAAEM,UAAU,CAACC,OAAO,CAAC;EACjC;;EAEA;EACA,IAAcC,WAAWA,CAAA,EAAsC;IAC7D,OAAO,IAAI,CAAC,CAACR,IAAI,EAAEQ,WAAW,IAAI,IAAI;EACxC;EAEA,IAAcC,QAAQA,CAAA,EAAW;IAC/B,OAAO,IAAI,CAAC,CAACT,IAAI,EAAES,QAAQ,IAAI,CAAC,CAAC;EACnC;EAEA,IAAcC,UAAUA,CAAA,EAAW;IACjC,OAAO,IAAI,CAAC,CAACV,IAAI,EAAEU,UAAU,IAAI,CAAC;EACpC;;EAEA;EACAC,MAAMA,CAACC,QAAoC,EAAwB,CAAC;EACpE;EACAC,MAAMA,CAACC,KAAiB,EAAwB,CAAC;EACjD;EACAC,aAAaA,CAACC,QAAqB,EAAwB,CAAC;EAC5D;EACAC,OAAOA,CAAA,EAAyB,CAAC;AACnC;;AAEA;AAAAC,OAAA,CAAAnB,eAAA,GAAAA,eAAA;AAOA;AACO,MAAMoB,cAAc,SAASpB,eAAe,CAAC;EAKlDqB,WAAWA,CAACC,QAAiC,GAAG,CAAC,CAAC,EAAE;IAClD,KAAK,CAAC,CAAC;IACP,IAAI,CAACC,WAAW,GAAGD,QAAQ,CAACC,WAAW,IAAI,MAAM;IACjD,IAAI,CAACC,YAAY,GAAGF,QAAQ,CAACE,YAAY,IAAI,MAAM;IACnD,IAAI,CAACC,YAAY,GAAGH,QAAQ,CAACG,YAAY;EAC3C;EAEAX,MAAMA,CAACtB,IAAgB,EAAQ;IAC7B,IAAI,CAACW,IAAI,CAACX,IAAI,CAAC;EACjB;AACF;;AAEA;AACA;AACA;AACA;AAHA2B,OAAA,CAAAC,cAAA,GAAAA,cAAA;AAIO,MAAeM,kBAAkB,SAAS1B,eAAe,CAAC;EAC/D,CAAC2B,MAAM,GAAG,EAAE;;EAEZ;;EAGAb,MAAMA,CAACtB,IAAgB,EAAQ;IAC7B,KAAK,IAAIoC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGpC,IAAI,CAACqC,MAAM,EAAED,CAAC,EAAE,EAAE;MACpC,IAAI,CAAC,CAACD,MAAM,IAAIG,MAAM,CAACC,YAAY,CAACvC,IAAI,CAACoC,CAAC,CAAC,CAAC;IAC9C;IACA,IAAII,EAAE,GAAG,IAAI,CAAC,CAACL,MAAM,CAACM,OAAO,CAAC,IAAI,CAAC;IACnC,OAAOD,EAAE,IAAI,CAAC,EAAE;MACd,MAAME,IAAI,GAAG,IAAI,CAAC,CAACP,MAAM,CAACQ,KAAK,CAAC,CAAC,EAAEH,EAAE,CAAC,CAACI,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;MACzD,IAAI,CAAC,CAACT,MAAM,GAAG,IAAI,CAAC,CAACA,MAAM,CAACQ,KAAK,CAACH,EAAE,GAAG,CAAC,CAAC;MACzC,KAAK,IAAI,CAACK,MAAM,CAACH,IAAI,CAAC;MACtBF,EAAE,GAAG,IAAI,CAAC,CAACL,MAAM,CAACM,OAAO,CAAC,IAAI,CAAC;IACjC;EACF;AACF;;AAEA;AAAAd,OAAA,CAAAO,kBAAA,GAAAA,kBAAA;AACO,MAAMY,UAAU,SAAStC,eAAe,CAAC;EAK9CqB,WAAWA,CAACC,QAAiC,GAAG,CAAC,CAAC,EAAE;IAClD,KAAK,CAAC,CAAC;IACP,IAAI,CAACC,WAAW,GAAGD,QAAQ,CAACC,WAAW,IAAI,MAAM;IACjD,IAAI,CAACC,YAAY,GAAGF,QAAQ,CAACE,YAAY,IAAI,MAAM;IACnD,IAAI,CAACC,YAAY,GAAGH,QAAQ,CAACG,YAAY;EAC3C;AACF;AAACN,OAAA,CAAAmB,UAAA,GAAAA,UAAA","ignoreList":[]}

package/lib/commonjs/testing/test-suite.js

@@ -0,0 +1,142 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.compareTestResults = compareTestResults;
+exports.runTestSuite = runTestSuite;
+var _harness = require("./harness");
+var _serialClient = require("./serial-client");
+/**
+ * A runtime-agnostic suite runner for serial device tests. Write a set of
+ * `SerialTest`s once and run them anywhere a {@link SerialPort} exists:
+ *
+ *   - in Jest against a {@link DeviceHandle} simulator (in-memory),
+ *   - on a device / emulator over a real or WebSocket-backed port, and
+ *   - against BOTH, then {@link compareTestResults} to prove the device matches
+ *     the simulator case-for-case.
+ *
+ * Each test receives an opened, host-side {@link SerialClient}; by default one
+ * client is shared across the whole suite (open once, close at the end), which
+ * matches how a request/response protocol session behaves. Pass `shared: false`
+ * to open and close a fresh client per test. The runner never throws — it
+ * collects a {@link SerialTestResult} per case — so it is safe to drive an
+ * on-device Self-Test screen.
+ *
+ * @example One suite, two transports, compared
+ * const sim = await runTestSuite(myTests, await virtualPort());
+ * const dev = await runTestSuite(myTests, realPort);
+ * const rows = compareTestResults(sim, dev); // a row passes when both agree
+ */
+
+/** One test case. `run` receives an already-opened client (typically per the
+ * suite's {@link TestClient}; `SerialClient` by default). */
+
+/** Progress hooks so a UI can render results live as each test completes. */
+
+/**
+ * How to build (and tear down) the per-suite client from a port. Provide this to
+ * run a higher-level protocol client (e.g. an HCI / NMEA framer built on a
+ * {@link SerialClient}) instead of the raw client. `connect` must also open the
+ * port; `disconnect` must release it (a `SerialClient.close()` does both).
+ */
+
+function defaultClientFactory(open) {
+  return {
+    async connect(port) {
+      const client = new _serialClient.SerialClient(port);
+      await client.open(open);
+      return client;
+    },
+    disconnect: client => client.close()
+  };
+}
+
+/**
+ * Run `tests` against an already-acquired `port`, collecting one result per
+ * case. With the default (shared) client the port is opened once and closed at
+ * the end; with `shared: false` each test gets a fresh open/close. Never throws.
+ */
+async function runTestSuite(tests, port, options = {}) {
+  const factory = options.client ?? defaultClientFactory(options.open);
+  const shared = options.shared ?? true;
+  const progress = options.progress;
+  const results = [];
+  let sharedClient = null;
+  if (shared) {
+    try {
+      sharedClient = await factory.connect(port);
+    } catch (e) {
+      const result = {
+        name: 'open serial port',
+        passed: false,
+        error: (0, _harness.errorMessage)(e),
+        durationMs: 0
+      };
+      progress?.onResult?.(result);
+      return [result];
+    }
+  }
+  const total = tests.length;
+  try {
+    for (let i = 0; i < total; i++) {
+      const test = tests[i];
+      progress?.onStart?.(test.name, i, total);
+      const start = Date.now();
+      let perTest = null;
+      let result;
+      try {
+        if (!shared) perTest = await factory.connect(port);
+        const client = shared ? sharedClient : perTest;
+        await test.run(client);
+        result = {
+          name: test.name,
+          passed: true,
+          durationMs: Date.now() - start
+        };
+      } catch (e) {
+        result = {
+          name: test.name,
+          passed: false,
+          error: (0, _harness.errorMessage)(e),
+          durationMs: Date.now() - start
+        };
+      } finally {
+        if (perTest) await factory.disconnect(perTest).catch(() => {});
+      }
+      results.push(result);
+      progress?.onResult?.(result);
+    }
+  } finally {
+    if (sharedClient) await factory.disconnect(sharedClient).catch(() => {});
+  }
+  return results;
+}
+
+/**
+ * Compare two runs of the same suite case-by-case. A row passes when both runs
+ * agree (both passed or both failed), so the `candidate` is judged equivalent to
+ * the `reference` rather than judged on its own. Cases the candidate produced
+ * that the reference never ran are surfaced as failing `candidate: …` rows.
+ */
+function compareTestResults(reference, candidate) {
+  const candidateByName = new Map(candidate.map(r => [r.name, r]));
+  const candidateOnly = candidate.filter(r => !reference.some(s => s.name === r.name)).map(r => ({
+    name: `candidate: ${r.name}`,
+    passed: false,
+    error: r.error ?? 'candidate produced an unexpected result',
+    durationMs: r.durationMs
+  }));
+  const compared = reference.map(s => {
+    const r = candidateByName.get(s.name);
+    const identical = !!r && r.passed === s.passed;
+    return {
+      name: s.name,
+      passed: identical,
+      error: identical ? undefined : `reference ${s.passed ? 'passed' : 'failed'}, candidate ${r ? r.passed ? 'passed' : 'failed' : 'did not respond'}${r?.error ? `: ${r.error}` : ''}`,
+      durationMs: r?.durationMs ?? 0
+    };
+  });
+  return [...candidateOnly, ...compared];
+}
+//# sourceMappingURL=test-suite.js.map

package/lib/commonjs/testing/test-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_harness","require","_serialClient","defaultClientFactory","open","connect","port","client","SerialClient","disconnect","close","runTestSuite","tests","options","factory","shared","progress","results","sharedClient","e","result","name","passed","error","errorMessage","durationMs","onResult","total","length","i","test","onStart","start","Date","now","perTest","run","catch","push","compareTestResults","reference","candidate","candidateByName","Map","map","r","candidateOnly","filter","some","s","compared","get","identical","undefined"],"sourceRoot":"../../../src","sources":["testing/test-suite.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/transport.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.StopBits = exports.Parity = exports.DataBits = exports.DEFAULT_OPEN_OPTIONS = void 0;
+/**
+ * Hardware-transport abstraction for the Web Serial polyfill.
+ *
+ * `SerialTransport` is the single interface that the `Serial`/`SerialPort`
+ * classes depend on to talk to "the device". The production implementation
+ * (`UsbSerialModule`, backed by the `NativeUsbSerial` TurboModule — see
+ * {@link ./UsbSerial}) and the in-memory test/dev double
+ * (`InMemorySerialTransport` — see {@link ./testing/in-memory-serial-transport}) both
+ * implement it.
+ *
+ * This module is intentionally free of any `react-native` import. That is what
+ * lets the virtual transport — and therefore the conformance suite built on top
+ * of it — run unchanged under Node/Jest, in a browser, and on a device.
+ */
+
+// UsbSerialPort.ControlLine enum
+
+// UsbSerialPort.FlowControl enum
+
+const Parity = exports.Parity = {
+  NONE: 0,
+  ODD: 1,
+  EVEN: 2,
+  MARK: 3,
+  SPACE: 4
+};
+const DataBits = exports.DataBits = {
+  FIVE: 5,
+  SIX: 6,
+  SEVEN: 7,
+  EIGHT: 8
+};
+const StopBits = exports.StopBits = {
+  ONE: 1,
+  ONE_FIVE: 3,
+  TWO: 2
+};
+const DEFAULT_OPEN_OPTIONS = exports.DEFAULT_OPEN_OPTIONS = {
+  dataBits: DataBits.EIGHT,
+  stopBits: StopBits.ONE,
+  parity: Parity.NONE
+};
+
+/** Handle returned by the `on*` subscription methods. */
+
+/**
+ * The contract every serial transport must satisfy. It mirrors the JS-friendly
+ * surface of `UsbSerialModule` exactly, so `UsbSerialModule implements
+ * SerialTransport` is a faithful 1:1 and any conforming double (e.g.
+ * `InMemorySerialTransport`) is a drop-in replacement.
+ *
+ * Ports are addressed by the pair `(deviceId, portNumber)`. Inbound bytes,
+ * read errors and device attach/detach arrive through the `on*` subscriptions.
+ */
+//# sourceMappingURL=transport.js.map

package/lib/commonjs/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Parity","exports","NONE","ODD","EVEN","MARK","SPACE","DataBits","FIVE","SIX","SEVEN","EIGHT","StopBits","ONE","ONE_FIVE","TWO","DEFAULT_OPEN_OPTIONS","dataBits","stopBits","parity"],"sourceRoot":"../../src","sources":["transport.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAGA;;AA0DO,MAAMA,MAAM,GAAAC,OAAA,CAAAD,MAAA,GAAG;EACpBE,IAAI,EAAE,CAAC;EACPC,GAAG,EAAE,CAAC;EACNC,IAAI,EAAE,CAAC;EACPC,IAAI,EAAE,CAAC;EACPC,KAAK,EAAE;AACT,CAAU;AAEH,MAAMC,QAAQ,GAAAN,OAAA,CAAAM,QAAA,GAAG;EACtBC,IAAI,EAAE,CAAC;EACPC,GAAG,EAAE,CAAC;EACNC,KAAK,EAAE,CAAC;EACRC,KAAK,EAAE;AACT,CAAU;AAEH,MAAMC,QAAQ,GAAAX,OAAA,CAAAW,QAAA,GAAG;EACtBC,GAAG,EAAE,CAAC;EACNC,QAAQ,EAAE,CAAC;EACXC,GAAG,EAAE;AACP,CAAU;AASH,MAAMC,oBAA6D,GAAAf,OAAA,CAAAe,oBAAA,GAAG;EAC3EC,QAAQ,EAAEV,QAAQ,CAACI,KAAK;EACxBO,QAAQ,EAAEN,QAAQ,CAACC,GAAG;EACtBM,MAAM,EAAEnB,MAAM,CAACE;AACjB,CAAC;;AAED;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}