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

package/lib/commonjs/testing/install-in-memory-serial-transport.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.installInMemorySerialTransport = installInMemorySerialTransport;
+var _UsbSerial = require("../UsbSerial");
+var _inMemorySerialTransport = require("./in-memory-serial-transport");
+var _simulatedDevice = require("./simulated-device");
+/**
+ * installInMemorySerialTransport — point the library at a simulated device set in one call.
+ *
+ * Built for E2E: call it once at app startup, behind your own env/build flag, to
+ * make `navigator.serial` / this library's `serial` talk to simulated
+ * {@link SimulatedDevice}s instead of real USB hardware while a test driver
+ * (Maestro, Detox, …) exercises the app on a device/emulator.
+ *
+ * @example
+ * // index.js (debug/E2E build only)
+ * import {installInMemorySerialTransport, LoopbackDevice} from 'react-native-web-serial-api/testing';
+ * installInMemorySerialTransport({
+ *   enabled: process.env.RNWS_SERIAL_MOCK === '1',
+ *   devices: [new LoopbackDevice(), new MyThermometer()],
+ * });
+ */
+
+/** A device to register: a SimulatedDevice, optionally with transport options. */
+
+/**
+ * Build an {@link InMemorySerialTransport} from `devices` and install it globally
+ * via {@link setUsbSerial}. SimulatedDevices default to granted USB permission (so
+ * they show up immediately); pass the `{device, options}` form to override.
+ * Returns the transport (handy for driving devices in-test), or `null` when
+ * disabled.
+ */
+function installInMemorySerialTransport(options) {
+  if (options.enabled === false) return null;
+  const transport = new _inMemorySerialTransport.InMemorySerialTransport(options.transport);
+  for (const entry of options.devices) {
+    if (entry instanceof _simulatedDevice.SimulatedDevice) {
+      transport.addDevice(entry, {
+        hasPermission: true
+      });
+    } else {
+      transport.addDevice(entry.device, {
+        hasPermission: true,
+        ...entry.options
+      });
+    }
+  }
+  (0, _UsbSerial.setUsbSerial)(transport);
+  return transport;
+}
+//# sourceMappingURL=install-in-memory-serial-transport.js.map

package/lib/commonjs/testing/install-in-memory-serial-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_UsbSerial","require","_inMemorySerialTransport","_simulatedDevice","installInMemorySerialTransport","options","enabled","transport","InMemorySerialTransport","entry","devices","SimulatedDevice","addDevice","hasPermission","device","setUsbSerial"],"sourceRoot":"../../../src","sources":["testing/install-in-memory-serial-transport.ts"],"mappings":";;;;;;AAgBA,IAAAA,UAAA,GAAAC,OAAA;AAKA,IAAAC,wBAAA,GAAAD,OAAA;AACA,IAAAE,gBAAA,GAAAF,OAAA;AAtBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,8BAA8BA,CAC5CC,OAA8C,EACd;EAChC,IAAIA,OAAO,CAACC,OAAO,KAAK,KAAK,EAAE,OAAO,IAAI;EAE1C,MAAMC,SAAS,GAAG,IAAIC,gDAAuB,CAACH,OAAO,CAACE,SAAS,CAAC;EAChE,KAAK,MAAME,KAAK,IAAIJ,OAAO,CAACK,OAAO,EAAE;IACnC,IAAID,KAAK,YAAYE,gCAAe,EAAE;MACpCJ,SAAS,CAACK,SAAS,CAACH,KAAK,EAAE;QAACI,aAAa,EAAE;MAAI,CAAC,CAAC;IACnD,CAAC,MAAM;MACLN,SAAS,CAACK,SAAS,CAACH,KAAK,CAACK,MAAM,EAAE;QAChCD,aAAa,EAAE,IAAI;QACnB,GAAGJ,KAAK,CAACJ;MACX,CAAC,CAAC;IACJ;EACF;EAEA,IAAAU,uBAAY,EAACR,SAAS,CAAC;EACvB,OAAOA,SAAS;AAClB","ignoreList":[]}

package/lib/commonjs/testing/serial-client.js

@@ -0,0 +1,277 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SerialClient = void 0;
+exports.createSerialClient = createSerialClient;
+var _simulatedDevice = require("./simulated-device");
+/**
+ * A fluent request/response client over a {@link SerialPort} — the host-side
+ * driver every serial test otherwise hand-rolls (reader + writer, a pending
+ * byte buffer, framed reads with timeouts). Works on ANY SerialPort: the
+ * in-memory {@link InMemorySerialTransport}, a real USB device, or a
+ * WebSocket-backed one — so the same test runs in Jest and on a device.
+ *
+ * @example
+ * const {client} = await mountDeviceFixture(new MyDevice());
+ * await client.open({baudRate: 115200});
+ * await client.write('PING\n');
+ * expect(await client.readLine()).toBe('PONG');
+ * await client.close();
+ */
+
+function indexOfSubsequence(haystack, needle) {
+  if (needle.length === 0) return 0;
+  outer: for (let i = 0; i + needle.length <= haystack.length; i++) {
+    for (let j = 0; j < needle.length; j++) {
+      if (haystack[i + j] !== needle[j]) continue outer;
+    }
+    return i;
+  }
+  return -1;
+}
+class SerialClient {
+  #port;
+  #defaultTimeout;
+  #reader = null;
+  #writer = null;
+  #open = false;
+  #done = false;
+  #closed = false;
+  /** Inbound bytes read by the pump but not yet consumed. */
+  #pending = [];
+  /** Resolvers woken whenever #pending grows or the stream ends. */
+  #waiters = [];
+  constructor(port, options = {}) {
+    this.#port = port;
+    this.#defaultTimeout = options.defaultTimeoutMs ?? 2000;
+  }
+  get port() {
+    return this.#port;
+  }
+  get isOpen() {
+    return this.#open;
+  }
+
+  /** True once the underlying stream has ended (device closed or lost). */
+  get ended() {
+    return this.#done;
+  }
+
+  /** Open the port (idempotent) and acquire reader + writer; start reading. */
+  async open(options = {
+    baudRate: 115200
+  }) {
+    if (this.#open) return this;
+    await this.#port.open(options);
+    this.#reader = this.#port.readable.getReader();
+    this.#writer = this.#port.writable.getWriter();
+    this.#open = true;
+    this.#done = false;
+    this.#closed = false;
+    void this.#pump();
+    return this;
+  }
+
+  /** Background reader: drains the stream into #pending and wakes waiters. */
+  async #pump() {
+    const reader = this.#reader;
+    /* istanbul ignore next */
+    if (!reader) return;
+    try {
+      while (!this.#closed) {
+        const {
+          done,
+          value
+        } = await reader.read();
+        if (done) break;
+        /* istanbul ignore else — InMemorySerialTransport never emits empty chunks */
+        if (value && value.length > 0) {
+          for (let i = 0; i < value.length; i++) this.#pending.push(value[i]);
+          this.#wake();
+        }
+      }
+    } catch {
+      // read errored (e.g. device lost) — surface as end-of-stream to waiters
+    } finally {
+      this.#done = true;
+      this.#wake();
+    }
+  }
+  #wake() {
+    const waiters = this.#waiters;
+    this.#waiters = [];
+    for (const w of waiters) w();
+  }
+
+  /** Resolve on the next #pending change / stream end, or reject after `ms`. */
+  #waitForChange(ms) {
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.#waiters = this.#waiters.filter(w => w !== waiter);
+        reject(new Error('read timeout'));
+      }, ms);
+      const waiter = () => {
+        clearTimeout(timer);
+        resolve();
+      };
+      this.#waiters.push(waiter);
+    });
+  }
+
+  /**
+   * Block until `ready(buffer)` returns a non-negative count of bytes to
+   * consume, then splice and return them. Rejects with `label` on timeout.
+   */
+  async #consume(ready, timeoutMs, label) {
+    const deadline = Date.now() + timeoutMs;
+    while (true) {
+      const take = ready(this.#pending);
+      if (take !== false) {
+        return Uint8Array.from(this.#pending.splice(0, take));
+      }
+      if (this.#done) {
+        if (this.#pending.length > 0) {
+          // Return whatever is buffered rather than hang on a closed stream.
+          return Uint8Array.from(this.#pending.splice(0, this.#pending.length));
+        }
+        // The transport can surface end-of-stream before the final queued data
+        // event has been pumped into #pending. Give that last turn a chance to
+        // land before we conclude there is nothing buffered.
+        await new Promise(resolve => setTimeout(resolve, 0));
+        /* istanbul ignore next -- race-guard checks again after yielding */
+        if (this.#pending.length === 0) {
+          return Uint8Array.from([]);
+        }
+        /* istanbul ignore next -- race-guard re-enters the loop after yielding */
+        continue;
+      }
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) throw new Error(label());
+      try {
+        await this.#waitForChange(remaining);
+      } catch {
+        throw new Error(label());
+      }
+    }
+  }
+
+  /** Write bytes (string → char codes & 0xff). */
+  async write(data) {
+    if (!this.#writer) throw new Error('SerialClient is not open.');
+    await this.#writer.write(Uint8Array.from((0, _simulatedDevice.toBytes)(data)));
+  }
+
+  /** Read exactly `n` bytes (fewer only if the stream ends first). */
+  readBytes(n, options = {}) {
+    const timeout = options.timeout ?? this.#defaultTimeout;
+    return this.#consume(buf => buf.length >= n ? n : false, timeout, () => `timed out reading ${n} bytes (got ${this.#pending.length})`);
+  }
+
+  /** Read up to and including `delimiter`; returns the slice (incl. delimiter). */
+  readUntil(delimiter, options = {}) {
+    const needle = (0, _simulatedDevice.toBytes)(delimiter);
+    const timeout = options.timeout ?? this.#defaultTimeout;
+    return this.#consume(buf => {
+      const idx = indexOfSubsequence(buf, needle);
+      return idx < 0 ? false : idx + needle.length;
+    }, timeout, () => `timed out reading until delimiter`);
+  }
+
+  /** Read one `\n`-terminated line as text (trailing CR/LF stripped). */
+  async readLine(options = {}) {
+    const bytes = await this.readUntil('\n', options);
+    let end = bytes.length;
+    if (end > 0 && bytes[end - 1] === 0x0a) end--;
+    if (end > 0 && bytes[end - 1] === 0x0d) end--;
+    return String.fromCharCode(...bytes.subarray(0, end));
+  }
+
+  /**
+   * Frame a message: `predicate(buffer)` returns the number of leading bytes the
+   * next frame occupies (consumed and returned), or `false` to wait for more.
+   */
+  readMatching(predicate, options = {}) {
+    const timeout = options.timeout ?? this.#defaultTimeout;
+    return this.#consume(buf => predicate(Uint8Array.from(buf)), timeout, () => `timed out waiting for a frame`);
+  }
+
+  /**
+   * Resolve with the next chunk of buffered inbound bytes (one or more), or an
+   * empty array once the stream has ended. Rejects on timeout. Use this to layer
+   * your own framing/decoder (SLIP, COBS, length-prefix, …) on the byte stream;
+   * pair it with {@link ended} to stop when the device goes away.
+   */
+  readAvailable(options = {}) {
+    const timeout = options.timeout ?? this.#defaultTimeout;
+    return this.#consume(buf => buf.length > 0 ? buf.length : false, timeout, () => `timed out waiting for data`);
+  }
+
+  /** Assert no inbound bytes arrive for `ms`. Rejects if any do. */
+  async expectIdle(ms) {
+    if (this.#pending.length > 0) {
+      throw new Error(`expected no inbound data but ${this.#pending.length} byte(s) were already buffered`);
+    }
+    try {
+      await this.#waitForChange(ms);
+    } catch {
+      return; // no change within the window — idle, as expected
+    }
+    if (this.#pending.length > 0) {
+      throw new Error(`expected no inbound data for ${ms}ms but received ${this.#pending.length} byte(s)`);
+    }
+    // stream ended with no data — also idle
+  }
+
+  /** Drop any buffered-but-unread inbound bytes. */
+  drain() {
+    this.#pending.length = 0;
+  }
+
+  /** Release reader + writer locks and close the port. Safe to call twice. */
+  async close() {
+    if (this.#closed) return;
+    this.#closed = true;
+    this.#wake();
+    if (this.#reader) {
+      try {
+        await this.#reader.cancel();
+      } catch {
+        // ignore
+      }
+      try {
+        this.#reader.releaseLock();
+      } catch {
+        // already released
+      }
+      this.#reader = null;
+    }
+    if (this.#writer) {
+      try {
+        await this.#writer.close();
+      } catch {
+        // ignore
+      }
+      try {
+        this.#writer.releaseLock();
+      } catch {
+        // already released
+      }
+      this.#writer = null;
+    }
+    this.#open = false;
+    try {
+      await this.#port.close();
+    } catch {
+      // already closed
+    }
+  }
+}
+
+/** Create a {@link SerialClient} for any SerialPort (virtual, real, or WS). */
+exports.SerialClient = SerialClient;
+function createSerialClient(port, options) {
+  return new SerialClient(port, options);
+}
+//# sourceMappingURL=serial-client.js.map

package/lib/commonjs/testing/serial-client.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_simulatedDevice","require","indexOfSubsequence","haystack","needle","length","outer","i","j","SerialClient","port","defaultTimeout","reader","writer","open","done","closed","pending","waiters","constructor","options","defaultTimeoutMs","isOpen","ended","baudRate","readable","getReader","writable","getWriter","pump","#pump","value","read","push","wake","#wake","w","waitForChange","#waitForChange","ms","Promise","resolve","reject","timer","setTimeout","filter","waiter","Error","clearTimeout","consume","#consume","ready","timeoutMs","label","deadline","Date","now","take","Uint8Array","from","splice","remaining","write","data","toBytes","readBytes","n","timeout","buf","readUntil","delimiter","idx","readLine","bytes","end","String","fromCharCode","subarray","readMatching","predicate","readAvailable","expectIdle","drain","close","cancel","releaseLock","exports","createSerialClient"],"sourceRoot":"../../../src","sources":["testing/serial-client.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/testing/{serial-device.js → simulated-device.js}

@@ -3,20 +3,20 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.SilentDevice = exports.SerialDevice = exports.LineDevice = exports.EchoDevice = void 0;
+exports.SinkDevice = exports.SimulatedDevice = exports.LoopbackDevice = exports.LineBufferedDevice = void 0;
 exports.toBytes = toBytes;
 /**
- * SerialDevice — author a complete simulated serial peripheral.
+ * 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 a {@link VirtualSerialTransport} ({@link ./virtual-serial}) and 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 SerialDevice {
+ * class Thermometer extends SimulatedDevice {
  *   usbVendorId = 0x0403;
  *   usbProductId = 0x6001;
  *   #timer?: ReturnType<typeof setInterval>;
@@ -38,8 +38,8 @@ exports.toBytes = toBytes;
 /** Host-asserted output signals (DTR/RTS/break) the device observes. */
 
 /**
- * The handle a {@link SerialDevice} uses to talk back to the host. Provided by
- * the transport; you normally use the `protected` helpers on `SerialDevice`
+ * 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.
  */
 
@@ -57,7 +57,7 @@ function toBytes(data) {
  * care about (all default to no-ops and may be async) and use the `protected`
  * helpers to drive the host.
  */
-class SerialDevice {
+class SimulatedDevice {
   /** USB Vendor ID this device reports for enumeration. */
 
   /** USB Product ID this device reports for enumeration. */
@@ -66,7 +66,7 @@ class SerialDevice {
 
   #host = null;
 
-  /** @internal Bind the transport host (called by VirtualSerialTransport). */
+  /** @internal Bind the transport host (called by InMemorySerialTransport). */
   _bind(host) {
     this.#host = host;
   }
@@ -111,10 +111,10 @@ class SerialDevice {
   onClose() {}
 }
 
-/** Optional USB identity for the built-in devices. */
-exports.SerialDevice = SerialDevice;
+/** Optional USB identity for built-in devices. */
+exports.SimulatedDevice = SimulatedDevice;
 /** A loopback device: every byte written is echoed straight back. */
-class EchoDevice extends SerialDevice {
+class LoopbackDevice extends SimulatedDevice {
   constructor(identity = {}) {
     super();
     this.usbVendorId = identity.usbVendorId ?? 0x0403;
@@ -130,8 +130,8 @@ class EchoDevice extends SerialDevice {
  * 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.EchoDevice = EchoDevice;
-class LineDevice extends SerialDevice {
+exports.LoopbackDevice = LoopbackDevice;
+class LineBufferedDevice extends SimulatedDevice {
   #buffer = '';
 
   /** Handle one line received from the host. */
@@ -151,8 +151,8 @@ class LineDevice extends SerialDevice {
 }
 
 /** A device that accepts writes but never sends anything back. */
-exports.LineDevice = LineDevice;
-class SilentDevice extends SerialDevice {
+exports.LineBufferedDevice = LineBufferedDevice;
+class SinkDevice extends SimulatedDevice {
   constructor(identity = {}) {
     super();
     this.usbVendorId = identity.usbVendorId ?? 0x0403;
@@ -160,5 +160,5 @@ class SilentDevice extends SerialDevice {
     this.serialNumber = identity.serialNumber;
   }
 }
-exports.SilentDevice = SilentDevice;
-//# sourceMappingURL=serial-device.js.map
+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":"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","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

@@ -5,13 +5,13 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.StopBits = exports.Parity = exports.DataBits = exports.DEFAULT_OPEN_OPTIONS = void 0;
 /**
- * Hardware-transport seam for the Web Serial polyfill.
+ * 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
- * (`VirtualSerialTransport` — see {@link ./testing/virtual-serial}) both
+ * (`InMemorySerialTransport` — see {@link ./testing/in-memory-serial-transport}) both
  * implement it.
  *
  * This module is intentionally free of any `react-native` import. That is what
@@ -53,7 +53,7 @@ const DEFAULT_OPEN_OPTIONS = exports.DEFAULT_OPEN_OPTIONS = {
  * 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.
- * `VirtualSerialTransport`) is a drop-in replacement.
+ * `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.