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

package/lib/typescript/src/lib/event-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-target.d.ts","sourceRoot":"","sources":["../../../../src/lib/event-target.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;IAClC,aAAa,EAAE,WAAW,GAAG,IAAI,CAAQ;IAEzC,gBAAgB,EAAE,OAAO,CAAS;IAClC,YAAY,EAAE,OAAO,CAAS;IAC9B,6BAA6B,EAAE,OAAO,CAAS;IAE/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAc;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAS;IAEpC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK;IACzB,MAAM,CAAC,QAAQ,CAAC,eAAe,KAAK;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK;IAC9B,MAAM,CAAC,QAAQ,CAAC,cAAc,KAAK;IAEnC,QAAQ,CAAC,IAAI,KAAK;IAClB,QAAQ,CAAC,eAAe,KAAK;IAC7B,QAAQ,CAAC,SAAS,KAAK;IACvB,QAAQ,CAAC,cAAc,KAAK;IAE5B,UAAU,EAAE,MAAM,CAAc;gBAEpB,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;IAO7C,cAAc,IAAI,IAAI;IAMtB,eAAe,IAAI,IAAI;IAIvB,wBAAwB,IAAI,IAAI;IAKhC,YAAY,IAAI,WAAW,EAAE;IAI7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI;CAKvE;AAID,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAE5C,UAAU,mBAAmB;IAC3B,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACjC;AAED,KAAK,kCAAkC,GAAG,aAAa,GAAG,mBAAmB,CAAC;AAE9E,KAAK,eAAe,GAChB;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAC,GACtD,OAAO,GACP,SAAS,CAAC;AAmBd,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAE5E;AAgCD,qBAAa,WAAW;;IAKtB,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kCAAkC,EAC5C,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI;IAeP,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAoBpC,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kCAAkC,EAC5C,QAAQ,CAAC,EAAE,eAAe,GACzB,IAAI;CAYR"}
+{"version":3,"file":"event-target.d.ts","sourceRoot":"","sources":["../../../../src/lib/event-target.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;IAClC,aAAa,EAAE,WAAW,GAAG,IAAI,CAAQ;IAEzC,gBAAgB,EAAE,OAAO,CAAS;IAClC,YAAY,EAAE,OAAO,CAAS;IAC9B,6BAA6B,EAAE,OAAO,CAAS;IAE/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAc;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAS;IAEpC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK;IACzB,MAAM,CAAC,QAAQ,CAAC,eAAe,KAAK;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK;IAC9B,MAAM,CAAC,QAAQ,CAAC,cAAc,KAAK;IAEnC,QAAQ,CAAC,IAAI,KAAK;IAClB,QAAQ,CAAC,eAAe,KAAK;IAC7B,QAAQ,CAAC,SAAS,KAAK;IACvB,QAAQ,CAAC,cAAc,KAAK;IAE5B,UAAU,EAAE,MAAM,CAAc;gBAEpB,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;IAO7C,cAAc,IAAI,IAAI;IAMtB,eAAe,IAAI,IAAI;IAIvB,wBAAwB,IAAI,IAAI;IAKhC,YAAY,IAAI,WAAW,EAAE;IAI7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI;CAKvE;AAID,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAE5C,UAAU,mBAAmB;IAC3B,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACjC;AAED,KAAK,kCAAkC,GAAG,aAAa,GAAG,mBAAmB,CAAC;AAE9E,KAAK,eAAe,GAChB;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAC,GACtD,OAAO,GACP,SAAS,CAAC;AAmBd,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAE5E;AAgCD,qBAAa,WAAW;;IAKtB,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kCAAkC,EAC5C,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI;IAeP,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAoBpC,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kCAAkC,EAC5C,QAAQ,CAAC,EAAE,eAAe,GACzB,IAAI;CAYR;AAID,eAAO,MAAM,SAAS,cAGX,CAAC;AAEZ,eAAO,MAAM,eAAe,oBAGX,CAAC"}

package/lib/typescript/src/lib/web-streams.d.ts

@@ -0,0 +1,9 @@
+import { ByteLengthQueuingStrategy as ByteLengthQueuingStrategyPolyfill, ReadableStream as ReadableStreamPolyfill, WritableStream as WritableStreamPolyfill } from 'web-streams-polyfill';
+export { ByteLengthQueuingStrategyPolyfill, ReadableStreamPolyfill, WritableStreamPolyfill, };
+export declare const ReadableStreamImpl: typeof ReadableStreamPolyfill;
+export declare const WritableStreamImpl: typeof WritableStreamPolyfill;
+export declare const ByteLengthQueuingStrategyImpl: typeof ByteLengthQueuingStrategyPolyfill;
+export type ReadableStreamImpl<R = unknown> = ReadableStreamPolyfill<R>;
+export type WritableStreamImpl<W = unknown> = WritableStreamPolyfill<W>;
+export type ByteLengthQueuingStrategyImpl = ByteLengthQueuingStrategyPolyfill;
+//# sourceMappingURL=web-streams.d.ts.map

package/lib/typescript/src/lib/web-streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-streams.d.ts","sourceRoot":"","sources":["../../../../src/lib/web-streams.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,IAAI,iCAAiC,EAC9D,cAAc,IAAI,sBAAsB,EACxC,cAAc,IAAI,sBAAsB,EACzC,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,sBAAsB,GACvB,CAAC;AAEF,eAAO,MAAM,kBAAkB,+BAG9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,+BAG9B,CAAC;AAEF,eAAO,MAAM,6BAA6B,0CAGzC,CAAC;AAQF,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAAC;AACxE,MAAM,MAAM,6BAA6B,GAAG,iCAAiC,CAAC"}

package/lib/typescript/src/testing/device-fixture.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `createDeviceFixture` — the one-call fixture for testing serial code. It wires a
+ * {@link SimulatedDevice} simulator to an {@link InMemorySerialTransport} + `Serial`,
+ * and hands back everything a test needs to drive *both* sides:
+ *
+ *   - `serial`/`port` — what the app-under-test consumes,
+ *   - `simulatedDevice` (typed) + `device` handle — drive the device (inject data,
+ *     move the GPS, inject faults),
+ *   - `client` — a host-side {@link SerialClient} (for protocol tests), and
+ *   - `whenOpened()/whenClosed()` — `await` the app connecting.
+ *
+ * @example Test how your app reacts to a device event
+ * const {simulatedDevice, device, whenOpened} = await createDeviceFixture(new MyGps());
+ * renderMyApp(); // opens the port itself
+ * await whenOpened();
+ * simulatedDevice.update({latitude: 51.48, longitude: 0});
+ * // …assert your app's UI updated
+ */
+import type { SerialPort } from '../WebSerial';
+import { Serial } from '../WebSerial';
+import type { DeviceOptions, InMemorySerialTransportOptions } from './in-memory-serial-transport';
+import { type DeviceHandle, InMemorySerialTransport } from './in-memory-serial-transport';
+import { SerialClient } from './serial-client';
+import type { SimulatedDevice, SimulatedDeviceOpenOptions } from './simulated-device';
+export type DeviceFixtureOptions = {
+    /** Per-device transport knobs (single-device form). */
+    device?: DeviceOptions;
+    /** Per-device transport knobs, by index (multi-device form). */
+    devices?: DeviceOptions[];
+    /** Transport-level options (latencyMs, chunkSize, autoGrantPermission). */
+    transport?: InMemorySerialTransportOptions;
+    /** Whether each device is already permitted. Defaults to true (so it lists). */
+    hasPermission?: boolean;
+    /** Also `setUsbSerial(transport)` so a running app's `serial` sees it. Default false. */
+    installGlobally?: boolean;
+    /** Options for the host-side {@link SerialClient}. */
+    client?: {
+        defaultTimeoutMs?: number;
+    };
+};
+export type MountedDeviceFixture<D extends SimulatedDevice = SimulatedDevice> = {
+    transport: InMemorySerialTransport;
+    serial: Serial;
+    port: SerialPort;
+    /** The transport-side handle: push/emitError/failNext/written/attach/detach/… */
+    device: DeviceHandle;
+    /** The concrete device simulator, typed (e.g. call `gps.update(...)`). */
+    simulatedDevice: D;
+    /** A host-side client bound to `port` — NOT opened (call `client.open()`). */
+    client: SerialClient;
+    /** Resolve when the app opens the port (now if already open). */
+    whenOpened(): Promise<SimulatedDeviceOpenOptions>;
+    /** Resolve when the app closes the port (now if not open). */
+    whenClosed(): Promise<void>;
+};
+export type MountedDeviceFixtures = {
+    transport: InMemorySerialTransport;
+    serial: Serial;
+    ports: SerialPort[];
+    devices: DeviceHandle[];
+    simulatedDevices: SimulatedDevice[];
+    clients: SerialClient[];
+    /** Resolve when device `index` opens, or any device when `index` is omitted. */
+    whenOpened(index?: number): Promise<SimulatedDeviceOpenOptions>;
+    /** Resolve when device `index` closes, or any device when `index` is omitted. */
+    whenClosed(index?: number): Promise<void>;
+};
+export declare function createDeviceFixture<D extends SimulatedDevice>(device: D, options?: DeviceFixtureOptions): Promise<MountedDeviceFixture<D>>;
+export declare function createDeviceFixture(devices: SimulatedDevice[], options?: DeviceFixtureOptions): Promise<MountedDeviceFixtures>;
+//# sourceMappingURL=device-fixture.d.ts.map

package/lib/typescript/src/testing/device-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-fixture.d.ts","sourceRoot":"","sources":["../../../../src/testing/device-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAC,MAAM,EAAC,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EACV,aAAa,EACb,8BAA8B,EAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,YAAY,EACjB,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,oBAAoB,GAAG;IACjC,uDAAuD;IACvD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,8BAA8B,CAAC;IAC3C,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yFAAyF;IACzF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,MAAM,CAAC,EAAE;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAC1E;IACE,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,iFAAiF;IACjF,MAAM,EAAE,YAAY,CAAC;IACrB,0EAA0E;IAC1E,eAAe,EAAE,CAAC,CAAC;IACnB,8EAA8E;IAC9E,MAAM,EAAE,YAAY,CAAC;IACrB,iEAAiE;IACjE,UAAU,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAClD,8DAA8D;IAC9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gFAAgF;IAChF,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAChE,iFAAiF;IACjF,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAAC"}

package/lib/typescript/src/testing/expose.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `exposeSimulatedDevice` — run a {@link SimulatedDevice} simulator behind a WebSocket
+ * server so a real app (on a device/emulator) can connect to it with
+ * `new Serial(new WebSocketSerialTransport(url))` and drive the *same* simulated
+ * peripheral your Jest tests drive. The test process keeps the
+ * {@link DeviceHandle} handle, so it can inject frames / move the GPS and
+ * `await whenOpened()` for the app to connect — turning an in-memory device
+ * suite into an on-device E2E without changing the device code.
+ *
+ * `ws` is an *optional* dependency: it is loaded lazily (and only in Node), via
+ * an indirect require so app bundlers never pull it into a mobile bundle. Pass
+ * `options.WebSocketServer` to inject your own (e.g. `import {WebSocketServer}
+ * from 'ws'`) and skip the lazy load entirely.
+ *
+ * @example
+ * import {WebSocketServer} from 'ws';
+ * const ex = exposeSimulatedDevice(new WMBusGateway('iU891A-XL'), {
+ *   port: 8090,
+ *   WebSocketServer,
+ * });
+ * // …app connects to ex.url…
+ * await ex.whenOpened();
+ * ex.simulatedDevice.addMeter(meter);
+ * meter.sendTelegram(); // the app receives the 0x20 telegram event
+ * await ex.close();
+ */
+import { type WsLike } from '../websocket';
+import type { DeviceOptions } from './in-memory-serial-transport';
+import { type DeviceHandle, InMemorySerialTransport } from './in-memory-serial-transport';
+import type { SimulatedDevice, SimulatedDeviceOpenOptions } from './simulated-device';
+/** The `ws` WebSocketServer surface this helper uses. */
+export type WebSocketServerLike = {
+    on(event: 'connection', listener: (socket: WsLike) => void): void;
+    close(cb?: () => void): void;
+};
+/** A `ws`-compatible `WebSocketServer` constructor. */
+export type WebSocketServerCtor = new (options: {
+    port: number;
+    host?: string;
+}) => WebSocketServerLike;
+export type ExposeSimulatedDeviceOptions = {
+    /** TCP port for the WebSocket server. */
+    port: number;
+    /** Listen address. Defaults to `localhost`. Use `0.0.0.0` for an emulator. */
+    host?: string;
+    /** Inject a `ws`-compatible `WebSocketServer` (skips the lazy `require('ws')`). */
+    WebSocketServer?: WebSocketServerCtor;
+    /** Forward device→client data before the app sends startReading. Default true. */
+    readingByDefault?: boolean;
+    /** Diagnostics logger. */
+    log?: (message: string) => void;
+    /** Transport-side device options (hasPermission defaults to true). */
+    device?: DeviceOptions;
+};
+export type ExposedDevice<D extends SimulatedDevice = SimulatedDevice> = {
+    /** The URL the app connects to, e.g. `ws://localhost:8090`. */
+    url: string;
+    transport: InMemorySerialTransport;
+    /** The transport-side handle: push/emitError/whenOpened/whenClosed/… */
+    device: DeviceHandle;
+    /** The concrete device simulator, typed (drive it from the test). */
+    simulatedDevice: D;
+    /** Resolve when the app opens the port (now if already open). */
+    whenOpened(): Promise<SimulatedDeviceOpenOptions>;
+    /** Resolve when the app closes the port (now if not open). */
+    whenClosed(): Promise<void>;
+    /** Stop the WebSocket server. */
+    close(): Promise<void>;
+};
+export declare function exposeSimulatedDevice<D extends SimulatedDevice>(simulatedDevice: D, options: ExposeSimulatedDeviceOptions): ExposedDevice<D>;
+//# sourceMappingURL=expose.d.ts.map

package/lib/typescript/src/testing/expose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expose.d.ts","sourceRoot":"","sources":["../../../../src/testing/expose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAIL,KAAK,MAAM,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACL,KAAK,YAAY,EACjB,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,eAAe,EACf,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAE5B,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,mBAAmB,GAAG,KAAK,OAAO,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KAAK,mBAAmB,CAAC;AAE1B,MAAM,MAAM,4BAA4B,GAAG;IACzC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0BAA0B;IAC1B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IACvE,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,uBAAuB,CAAC;IACnC,wEAAwE;IACxE,MAAM,EAAE,YAAY,CAAC;IACrB,qEAAqE;IACrE,eAAe,EAAE,CAAC,CAAC;IACnB,iEAAiE;IACjE,UAAU,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAClD,8DAA8D;IAC9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AA+BF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,eAAe,EAC7D,eAAe,EAAE,CAAC,EAClB,OAAO,EAAE,4BAA4B,GACpC,aAAa,CAAC,CAAC,CAAC,CA4BlB"}

package/lib/typescript/src/testing/harness.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tiny, dependency-free test helpers for driving serial devices — shared by the
+ * library's own conformance suite, the {@link SerialClient}, and consumers' app
+ * tests. Free of `jest` and `react-native`, so they run under any test runner
+ * and on a real device (e.g. an on-device Self-Test screen).
+ */
+/** Throw `message` if `condition` is falsy. */
+export declare function assert(condition: unknown, message: string): asserts condition;
+/** Throw if `actual !== expected`, including both values in the message. */
+export declare function assertEqual<T>(actual: T, expected: T, message: string): void;
+/** Byte-for-byte equality of two sequences. */
+export declare function bytesEqual(a: ArrayLike<number>, b: ArrayLike<number>): boolean;
+/** What {@link assertRejects} may additionally check about the thrown error. */
+export type RejectionExpectation = {
+    name?: string;
+    type?: new (...args: never[]) => Error;
+    message?: string | RegExp;
+};
+/** Assert `fn()` rejects (optionally matching the error name/type/message). */
+export declare function assertRejects(fn: () => Promise<unknown>, message: string, expected?: RejectionExpectation): Promise<void>;
+/** Normalise any thrown value into a `"Name: message"` string. */
+export declare function errorMessage(e: unknown): string;
+/** Reject if `promise` doesn't settle within `ms`; `label` names it on timeout. */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T>;
+/** The slice of `ReadableStreamDefaultReader` the helpers need. */
+export type ByteReader = {
+    read(): Promise<{
+        done: boolean;
+        value?: Uint8Array;
+    }>;
+};
+/** Read exactly `count` bytes from a reader (accumulating chunks), with a timeout. */
+export declare function readBytes(reader: ByteReader, count: number, timeoutMs?: number): Promise<number[]>;
+//# sourceMappingURL=harness.d.ts.map

package/lib/typescript/src/testing/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../../src/testing/harness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAE7E;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CACxB,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GACnB,OAAO,CAIT;AAED,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B,CAAC;AAEF,+EAA+E;AAC/E,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,IAAI,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAA;KAAC,CAAC,CAAC;CACtD,CAAC;AAEF,sFAAsF;AACtF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,SAAO,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB"}

package/lib/typescript/src/testing/{virtual-serial.d.ts → in-memory-serial-transport.d.ts}

@@ -1,5 +1,5 @@
 /**
- * VirtualSerialTransport — an in-memory {@link SerialTransport} for tests and
+ * InMemorySerialTransport — an in-memory {@link SerialTransport} for tests and
  * on-device demos.
  *
  * It implements the exact same interface the production `UsbSerialModule` does,
@@ -13,17 +13,17 @@
  * Inject it via `new Serial(transport)` or globally with `setUsbSerial(transport)`.
  *
  * @example
- * const transport = new VirtualSerialTransport();
- * transport.addDevice(new EchoDevice(), {hasPermission: true});
+ * const transport = new InMemorySerialTransport();
+ * transport.addDevice(new LoopbackDevice(), {hasPermission: true});
  * const serial = new Serial(transport);
  * const [port] = await serial.getPorts();
  * await port.open({baudRate: 115200});
  * // writes to port.writable now come back on port.readable (echo)
  */
 import type { ConnectEvent, ControlLine, DataEvent, ErrorEvent, FlowControl, OpenOptions, PortFilter, PortId, PortPickerLabels, SerialTransport, Subscription } from '../transport';
-import type { SerialDevice } from './serial-device';
-/** Transport-side knobs when registering a {@link SerialDevice}. */
-export type VirtualDeviceOptions = {
+import type { SimulatedDevice } from './simulated-device';
+/** Transport-side knobs when registering a {@link SimulatedDevice}. */
+export type DeviceOptions = {
     /** Whether the app already holds USB permission. Defaults to false. */
     hasPermission?: boolean;
     /** Defaults to 0. A USB device may expose several ports. */
@@ -43,9 +43,9 @@ export type VirtualDeviceOptions = {
      */
     flowControlThreshold?: number;
 };
-export type VirtualSerialOptions = {
+export type InMemorySerialTransportOptions = {
     /** Devices to register on construction (same as calling addDevice). */
-    devices?: SerialDevice[];
+    devices?: SimulatedDevice[];
     /**
      * Delay (ms) applied to async operations and to inbound data delivery.
      * 0 (default) resolves on a microtask — deterministic for Jest. A small
@@ -78,11 +78,11 @@ type InputSignals = {
     dsr: boolean;
 };
 /**
- * A simulated USB-serial device. Returned by {@link VirtualSerialTransport.addDevice}.
+ * A simulated USB-serial device. Returned by {@link InMemorySerialTransport.addDevice}.
  * The mutable fields and the helper methods let a test or demo drive the device
  * the way physical hardware (and a human plugging cables) otherwise would.
  */
-export declare class VirtualDevice {
+export declare class DeviceHandle {
     #private;
     readonly usbVendorId: number;
     readonly usbProductId: number;
@@ -95,7 +95,7 @@ export declare class VirtualDevice {
     isOpen: boolean;
     reading: boolean;
     /** The hosted behaviour. */
-    readonly serialDevice: SerialDevice;
+    readonly simulatedDevice: SimulatedDevice;
     loopbackSignals: boolean;
     flowControl: FlowControl;
     flowControlThreshold: number;
@@ -112,7 +112,7 @@ export declare class VirtualDevice {
     readonly input: InputSignals;
     /** Every byte frame the host has written to this device, in order. */
     readonly written: number[][];
-    constructor(transport: VirtualSerialTransport, deviceId: number, device: SerialDevice, options: VirtualDeviceOptions);
+    constructor(transport: InMemorySerialTransport, deviceId: number, device: SimulatedDevice, options: DeviceOptions);
     /** Push inbound bytes to the host as if the device sent them unprompted. */
     push(bytes: number[] | Uint8Array): void;
     /**
@@ -138,38 +138,49 @@ export declare class VirtualDevice {
     detach(): void;
     /** Simulate an unplug while open: errors the open stream, then disconnects. */
     loseDevice(): void;
+    /**
+     * Resolve when the host opens this port (immediately if already open). Lets a
+     * test `await` the app connecting before driving the device.
+     */
+    whenOpened(): Promise<Required<OpenOptions>>;
+    /** Resolve when the host closes this port (immediately if not open). */
+    whenClosed(): Promise<void>;
+    /** @internal The transport calls this right after the port opens. */
+    _notifyOpen(options: Required<OpenOptions>): void;
+    /** @internal The transport calls this right after the port closes/detaches. */
+    _notifyClose(): void;
 }
 type Listener<E> = (event: E) => void;
 /**
- * In-memory transport backing one or more {@link VirtualDevice}s.
+ * In-memory transport backing one or more {@link DeviceHandle}s.
  */
-export declare class VirtualSerialTransport implements SerialTransport {
+export declare class InMemorySerialTransport implements SerialTransport {
     #private;
-    constructor(options?: VirtualSerialOptions);
+    constructor(options?: InMemorySerialTransportOptions);
     /** All devices known to the transport (attached or not). */
-    get devices(): readonly VirtualDevice[];
+    get devices(): readonly DeviceHandle[];
     /**
-     * Register a {@link SerialDevice}. It starts attached but does not fire
+     * Register a {@link SimulatedDevice}. It starts attached but does not fire
      * "connect"; its identity (usbVendorId/usbProductId/serialNumber) is read from
      * the device, and `options` carries the transport-side knobs.
      */
-    addDevice(serialDevice: SerialDevice, options?: VirtualDeviceOptions): VirtualDevice;
+    addDevice(simulatedDevice: SimulatedDevice, options?: DeviceOptions): DeviceHandle;
     /** Remove a device entirely; detaches it first if attached. */
-    removeDevice(device: VirtualDevice): void;
+    removeDevice(device: DeviceHandle): void;
     /** (Re)attach a device, assigning it a fresh deviceId, and fire "connect". */
-    attach(device: VirtualDevice): void;
+    attach(device: DeviceHandle): void;
     /** Detach a device and fire "disconnect"; any open port becomes closed. */
-    detach(device: VirtualDevice): void;
+    detach(device: DeviceHandle, lost?: boolean): void;
     /** Simulate an unplug while open: error the stream first, then disconnect. */
-    loseDevice(device: VirtualDevice): void;
+    loseDevice(device: DeviceHandle): void;
     /** Script the next showPortPicker() resolution (a device or a predicate). */
-    selectNextPort(target: VirtualDevice | ((d: VirtualDevice) => boolean)): void;
+    selectNextPort(target: DeviceHandle | ((d: DeviceHandle) => boolean)): void;
     /** Make the next showPortPicker() reject (user cancelled / no port). */
     rejectNextPortPicker(): void;
     /** @internal deliver inbound bytes to the host's readable stream. */
-    _deliver(device: VirtualDevice, data: number[]): void;
+    _deliver(device: DeviceHandle, data: number[]): void;
     /** @internal raise a read error for a device's open port. */
-    _error(device: VirtualDevice, message: string, name?: string): void;
+    _error(device: DeviceHandle, message: string, name?: string): void;
     findAllDrivers(): Promise<ReadonlyArray<PortId>>;
     showPortPicker(filter: ReadonlyArray<PortFilter>, _labels?: PortPickerLabels): Promise<PortId>;
     requestPermission(deviceId: number): Promise<boolean>;
@@ -202,4 +213,4 @@ export declare class VirtualSerialTransport implements SerialTransport {
     onDisconnect(listener: Listener<ConnectEvent>): Subscription;
 }
 export {};
-//# sourceMappingURL=virtual-serial.d.ts.map
+//# sourceMappingURL=in-memory-serial-transport.d.ts.map

package/lib/typescript/src/testing/in-memory-serial-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-serial-transport.d.ts","sourceRoot":"","sources":["../../../../src/testing/in-memory-serial-transport.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/testing/index.d.ts

@@ -3,21 +3,31 @@
  *
  * Imported via the package subpath:
  *
- *   import {VirtualSerialTransport, installSerialMock}
+ *   import {InMemorySerialTransport, installInMemorySerialTransport}
  *     from 'react-native-web-serial-api/testing';
  *
  * These are reusable building blocks for *consumers'* tests and demos — an
- * in-memory transport and an authorable `SerialDevice` peripheral model — so
+ * in-memory transport and an authorable `SimulatedDevice` peripheral model — so
  * they ship with the package. The library's own spec-compliance suite is NOT
  * here: it lives in `src/__tests__/conformance-suite.ts` (test-only, excluded
  * from the build and the published package). None of this is in the main bundle.
  */
 export type { SerialTransport } from '../transport';
 export { getUsbSerial, resetUsbSerial, setUsbSerial } from '../UsbSerial';
-export type { InstallSerialMockOptions, SerialMockDevice } from './install';
-export { installSerialMock } from './install';
-export type { DeviceIdentity, SerialDeviceHost, SerialDeviceOpenOptions, SerialHostSignals, SerialInputSignals, } from './serial-device';
-export { EchoDevice, LineDevice, SerialDevice, SilentDevice, } from './serial-device';
-export type { FailableOp, VirtualDeviceOptions, VirtualSerialOptions, } from './virtual-serial';
-export { VirtualDevice, VirtualSerialTransport } from './virtual-serial';
+export type { DeviceFixtureOptions, MountedDeviceFixture, MountedDeviceFixtures, } from './device-fixture';
+export { createDeviceFixture } from './device-fixture';
+export type { ExposedDevice, ExposeSimulatedDeviceOptions, WebSocketServerCtor, WebSocketServerLike, } from './expose';
+export { exposeSimulatedDevice } from './expose';
+export type { ByteReader, RejectionExpectation } from './harness';
+export { assert, assertEqual, assertRejects, bytesEqual, errorMessage, readBytes, withTimeout, } from './harness';
+export type { DeviceOptions, FailableOp, InMemorySerialTransportOptions, } from './in-memory-serial-transport';
+export { DeviceHandle, InMemorySerialTransport, } from './in-memory-serial-transport';
+export type { InstallInMemorySerialTransportOptions, SimulatedTransportDevice, } from './install-in-memory-serial-transport';
+export { installInMemorySerialTransport } from './install-in-memory-serial-transport';
+export type { ReadOptions, SerialClientOptions } from './serial-client';
+export { createSerialClient, SerialClient, } from './serial-client';
+export type { HostSignals, SerialInputSignals, SimulatedDeviceHost, SimulatedDeviceIdentity, SimulatedDeviceOpenOptions, } from './simulated-device';
+export { LineBufferedDevice, LoopbackDevice, SimulatedDevice, SinkDevice, } from './simulated-device';
+export type { RunTestSuiteOptions, SerialTest, SerialTestProgress, SerialTestResult, TestClient, } from './test-suite';
+export { compareTestResults, runTestSuite } from './test-suite';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC;AACxE,YAAY,EAAC,wBAAwB,EAAE,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAC,iBAAiB,EAAC,MAAM,WAAW,CAAC;AAC5C,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAC,aAAa,EAAE,sBAAsB,EAAC,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC;AAExE,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAC,mBAAmB,EAAC,MAAM,kBAAkB,CAAC;AAGrD,YAAY,EACV,aAAa,EACb,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAC,qBAAqB,EAAC,MAAM,UAAU,CAAC;AAE/C,YAAY,EAAC,UAAU,EAAE,oBAAoB,EAAC,MAAM,WAAW,CAAC;AAChE,OAAO,EACL,MAAM,EACN,WAAW,EACX,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,aAAa,EACb,UAAU,EACV,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,YAAY,EACZ,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qCAAqC,EACrC,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAC,8BAA8B,EAAC,MAAM,sCAAsC,CAAC;AAEpF,YAAY,EAAC,WAAW,EAAE,mBAAmB,EAAC,MAAM,iBAAiB,CAAC;AACtE,OAAO,EACL,kBAAkB,EAClB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,kBAAkB,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC"}

package/lib/typescript/src/testing/install-in-memory-serial-transport.d.ts

@@ -0,0 +1,25 @@
+import type { DeviceOptions, InMemorySerialTransportOptions } from './in-memory-serial-transport';
+import { InMemorySerialTransport } from './in-memory-serial-transport';
+import { SimulatedDevice } from './simulated-device';
+/** A device to register: a SimulatedDevice, optionally with transport options. */
+export type SimulatedTransportDevice = SimulatedDevice | {
+    device: SimulatedDevice;
+    options?: DeviceOptions;
+};
+export type InstallInMemorySerialTransportOptions = {
+    /** The simulated devices to expose. */
+    devices: SimulatedTransportDevice[];
+    /** When false, no mock is installed and `null` is returned. Defaults to true. */
+    enabled?: boolean;
+    /** Transport-level options (latency, chunkSize, …). */
+    transport?: InMemorySerialTransportOptions;
+};
+/**
+ * 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.
+ */
+export declare function installInMemorySerialTransport(options: InstallInMemorySerialTransportOptions): InMemorySerialTransport | null;
+//# sourceMappingURL=install-in-memory-serial-transport.d.ts.map

package/lib/typescript/src/testing/install-in-memory-serial-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-in-memory-serial-transport.d.ts","sourceRoot":"","sources":["../../../../src/testing/install-in-memory-serial-transport.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,aAAa,EACb,8BAA8B,EAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAC,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAEnD,kFAAkF;AAClF,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAC,CAAC;AAEvD,MAAM,MAAM,qCAAqC,GAAG;IAClD,uCAAuC;IACvC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,8BAA8B,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,uBAAuB,GAAG,IAAI,CAiBhC"}

package/lib/typescript/src/testing/serial-client.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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();
+ */
+import type { SerialOptions, SerialPort } from '../WebSerial';
+export type ReadOptions = {
+    /** Per-call timeout in ms (overrides the client default). */
+    timeout?: number;
+};
+export type SerialClientOptions = {
+    /** Default per-read timeout in ms. Default 2000. */
+    defaultTimeoutMs?: number;
+};
+export declare class SerialClient {
+    #private;
+    constructor(port: SerialPort, options?: SerialClientOptions);
+    get port(): SerialPort;
+    get isOpen(): boolean;
+    /** True once the underlying stream has ended (device closed or lost). */
+    get ended(): boolean;
+    /** Open the port (idempotent) and acquire reader + writer; start reading. */
+    open(options?: SerialOptions): Promise<this>;
+    /** Write bytes (string → char codes & 0xff). */
+    write(data: number[] | Uint8Array | string): Promise<void>;
+    /** Read exactly `n` bytes (fewer only if the stream ends first). */
+    readBytes(n: number, options?: ReadOptions): Promise<Uint8Array>;
+    /** Read up to and including `delimiter`; returns the slice (incl. delimiter). */
+    readUntil(delimiter: number[] | Uint8Array | string, options?: ReadOptions): Promise<Uint8Array>;
+    /** Read one `\n`-terminated line as text (trailing CR/LF stripped). */
+    readLine(options?: ReadOptions): Promise<string>;
+    /**
+     * 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: (buffer: Uint8Array) => number | false, options?: ReadOptions): Promise<Uint8Array>;
+    /**
+     * 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?: ReadOptions): Promise<Uint8Array>;
+    /** Assert no inbound bytes arrive for `ms`. Rejects if any do. */
+    expectIdle(ms: number): Promise<void>;
+    /** Drop any buffered-but-unread inbound bytes. */
+    drain(): void;
+    /** Release reader + writer locks and close the port. Safe to call twice. */
+    close(): Promise<void>;
+}
+/** Create a {@link SerialClient} for any SerialPort (virtual, real, or WS). */
+export declare function createSerialClient(port: SerialPort, options?: SerialClientOptions): SerialClient;
+//# sourceMappingURL=serial-client.d.ts.map

package/lib/typescript/src/testing/serial-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-client.d.ts","sourceRoot":"","sources":["../../../../src/testing/serial-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,aAAa,EAAE,UAAU,EAAC,MAAM,cAAc,CAAC;AAG5D,MAAM,MAAM,WAAW,GAAG;IACxB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAaF,qBAAa,YAAY;;gBAcX,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB;IAK/D,IAAI,IAAI,IAAI,UAAU,CAErB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,yEAAyE;IACzE,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,6EAA6E;IACvE,IAAI,CAAC,OAAO,GAAE,aAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiGtE,gDAAgD;IAC1C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,oEAAoE;IACpE,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IASpE,iFAAiF;IACjF,SAAS,CACP,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,MAAM,EACzC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAatB,uEAAuE;IACjE,QAAQ,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ1D;;;OAGG;IACH,YAAY,CACV,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,GAAG,KAAK,EACjD,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAStB;;;;;OAKG;IACH,aAAa,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAS7D,kEAAkE;IAC5D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3C,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAIb,4EAA4E;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqC7B;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAEd"}