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

package/lib/typescript/src/testing/{serial-device.d.ts → simulated-device.d.ts}

@@ -1,15 +1,15 @@
 /**
- * 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>;
@@ -25,7 +25,7 @@
  */
 import type { OpenOptions } from '../transport';
 /** The negotiated connection parameters (native parity code: 0 none/1 odd/2 even). */
-export type SerialDeviceOpenOptions = Required<OpenOptions>;
+export type SimulatedDeviceOpenOptions = Required<OpenOptions>;
 /** Device-asserted input signals — what the host reads via getSignals(). */
 export type SerialInputSignals = {
     dataCarrierDetect?: boolean;
@@ -34,21 +34,21 @@ export type SerialInputSignals = {
     dataSetReady?: boolean;
 };
 /** Host-asserted output signals (DTR/RTS/break) the device observes. */
-export type SerialHostSignals = {
+export type HostSignals = {
     dataTerminalReady: boolean;
     requestToSend: boolean;
     break: boolean;
 };
 /**
- * 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.
  */
-export interface SerialDeviceHost {
+export interface SimulatedDeviceHost {
     readonly deviceId: number;
     readonly portNumber: number;
     readonly isOpen: boolean;
-    readonly openOptions: SerialDeviceOpenOptions | null;
+    readonly openOptions: SimulatedDeviceOpenOptions | null;
     send(bytes: number[]): void;
     raiseError(message: string, name?: string): void;
     setSignals(signals: SerialInputSignals): void;
@@ -60,7 +60,7 @@ export declare function toBytes(data: number[] | Uint8Array | string): number[];
  * care about (all default to no-ops and may be async) and use the `protected`
  * helpers to drive the host.
  */
-export declare abstract class SerialDevice {
+export declare abstract class SimulatedDevice {
     #private;
     /** USB Vendor ID this device reports for enumeration. */
     abstract readonly usbVendorId: number;
@@ -68,8 +68,8 @@ export declare abstract class SerialDevice {
     abstract readonly usbProductId: number;
     /** Optional USB serial number. */
     readonly serialNumber?: string;
-    /** @internal Bind the transport host (called by VirtualSerialTransport). */
-    _bind(host: SerialDeviceHost): void;
+    /** @internal Bind the transport host (called by InMemorySerialTransport). */
+    _bind(host: SimulatedDeviceHost): void;
     /** Send bytes to the host (they appear on `port.readable`). */
     protected send(data: number[] | Uint8Array | string): void;
     /**
@@ -81,47 +81,47 @@ export declare abstract class SerialDevice {
     /** Set device-asserted input signals (DCD/CTS/RI/DSR) the host can read. */
     protected setSignals(signals: SerialInputSignals): void;
     /** The parameters the host opened the port with, or null when closed. */
-    protected get openOptions(): SerialDeviceOpenOptions | null;
+    protected get openOptions(): SimulatedDeviceOpenOptions | null;
     protected get deviceId(): number;
     protected get portNumber(): number;
     /** The host opened the port. */
-    onOpen(_options: SerialDeviceOpenOptions): void | Promise<void>;
+    onOpen(_options: SimulatedDeviceOpenOptions): void | Promise<void>;
     /** The host wrote bytes to the device. */
     onData(_data: Uint8Array): void | Promise<void>;
     /** The host changed DTR/RTS/break. */
-    onHostSignals(_signals: SerialHostSignals): void | Promise<void>;
+    onHostSignals(_signals: HostSignals): void | Promise<void>;
     /** The host closed the port. */
     onClose(): void | Promise<void>;
 }
-/** Optional USB identity for the built-in devices. */
-export type DeviceIdentity = {
+/** Optional USB identity for built-in devices. */
+export type SimulatedDeviceIdentity = {
     usbVendorId?: number;
     usbProductId?: number;
     serialNumber?: string;
 };
 /** A loopback device: every byte written is echoed straight back. */
-export declare class EchoDevice extends SerialDevice {
+export declare class LoopbackDevice extends SimulatedDevice {
     readonly usbVendorId: number;
     readonly usbProductId: number;
     readonly serialNumber?: string;
-    constructor(identity?: DeviceIdentity);
+    constructor(identity?: SimulatedDeviceIdentity);
     onData(data: Uint8Array): void;
 }
 /**
  * Base for a line-oriented command/response device: buffers incoming bytes and
  * calls {@link onLine} for each `\n`-terminated line (trailing CR/LF stripped).
  */
-export declare abstract class LineDevice extends SerialDevice {
+export declare abstract class LineBufferedDevice extends SimulatedDevice {
     #private;
     /** Handle one line received from the host. */
     abstract onLine(line: string): void | Promise<void>;
     onData(data: Uint8Array): void;
 }
 /** A device that accepts writes but never sends anything back. */
-export declare class SilentDevice extends SerialDevice {
+export declare class SinkDevice extends SimulatedDevice {
     readonly usbVendorId: number;
     readonly usbProductId: number;
     readonly serialNumber?: string;
-    constructor(identity?: DeviceIdentity);
+    constructor(identity?: SimulatedDeviceIdentity);
 }
-//# sourceMappingURL=serial-device.d.ts.map
+//# sourceMappingURL=simulated-device.d.ts.map

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

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

package/lib/typescript/src/testing/test-suite.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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
+ */
+import type { SerialOptions, SerialPort } from '../WebSerial';
+import { SerialClient } from './serial-client';
+export type SerialTestResult = {
+    name: string;
+    passed: boolean;
+    error?: string;
+    durationMs: number;
+};
+/** One test case. `run` receives an already-opened client (typically per the
+ * suite's {@link TestClient}; `SerialClient` by default). */
+export type SerialTest<C = SerialClient> = {
+    name: string;
+    run(client: C): Promise<void>;
+};
+/** Progress hooks so a UI can render results live as each test completes. */
+export type SerialTestProgress = {
+    /** Called just before a test starts running. */
+    onStart?: (name: string, index: number, total: number) => void;
+    /** Called after each test completes (pass or fail). */
+    onResult?: (result: SerialTestResult) => void;
+};
+/**
+ * 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).
+ */
+export type TestClient<C> = {
+    connect(port: SerialPort): Promise<C>;
+    disconnect(client: C): Promise<void>;
+};
+export type RunTestSuiteOptions<C = SerialClient> = {
+    /** `SerialOptions` for the default client's `open()`. Default {baudRate: 115200}. */
+    open?: SerialOptions;
+    /** Open/close a fresh client per test instead of sharing one. Default false. */
+    shared?: boolean;
+    /** Build a protocol client over the port (defaults to an opened SerialClient). */
+    client?: TestClient<C>;
+    progress?: SerialTestProgress;
+};
+/**
+ * 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.
+ */
+export declare function runTestSuite<C = SerialClient>(tests: SerialTest<C>[], port: SerialPort, options?: RunTestSuiteOptions<C>): Promise<SerialTestResult[]>;
+/**
+ * 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.
+ */
+export declare function compareTestResults(reference: SerialTestResult[], candidate: SerialTestResult[]): SerialTestResult[];
+//# sourceMappingURL=test-suite.d.ts.map

package/lib/typescript/src/testing/test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-suite.d.ts","sourceRoot":"","sources":["../../../../src/testing/test-suite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAE,UAAU,EAAC,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;6DAC6D;AAC7D,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,YAAY,IAAI;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtC,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,YAAY,IAAI;IAClD,qFAAqF;IACrF,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B,CAAC;AAaF;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,YAAY,EACjD,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EACtB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,mBAAmB,CAAC,CAAC,CAAM,GACnC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyD7B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,SAAS,EAAE,gBAAgB,EAAE,GAC5B,gBAAgB,EAAE,CA4BpB"}

package/lib/typescript/src/transport.d.ts

@@ -1,11 +1,11 @@
 /**
- * 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
@@ -91,7 +91,7 @@ export type Subscription = {
  * 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.

package/lib/typescript/src/websocket/WebSocketSerialTransport.d.ts

@@ -0,0 +1,111 @@
+/**
+ * A {@link SerialTransport} that talks to a remote serial port over a WebSocket
+ * bridge (run `expose-serial-websocket` on the host — see `bin/expose-serial.js`).
+ *
+ * Because it implements the same transport contract as the native `UsbSerialModule` and the
+ * in-memory `InMemorySerialTransport`, it's a drop-in: the whole `Serial` /
+ * `SerialPort` polyfill (streams, signals, reconnect, the conformance suite)
+ * works on top of it unchanged.
+ *
+ * **Resilience.** The socket is supervised: an unexpected drop (server restart,
+ * network blip) is handled transparently — the transport reconnects with
+ * exponential backoff and *restores the session* (line coding, control signals,
+ * and read state) so the app's open `SerialPort` keeps working. A transient
+ * drop is therefore invisible to the polyfill (reads pause and resume; writes
+ * issued during the gap wait for the reconnection). Only a real remote
+ * disconnect (the host's serial port going away) or giving up after
+ * `maxReconnectAttempts` surfaces as a serial disconnect.
+ *
+ * @example
+ * import {Serial} from 'react-native-web-serial-api';
+ * import {WebSocketSerialTransport} from 'react-native-web-serial-api/websocket';
+ *
+ * const serial = new Serial(new WebSocketSerialTransport('ws://localhost:8080'));
+ * const [port] = await serial.getPorts();
+ * await port.open({baudRate: 115200});
+ */
+import type { ConnectEvent, ControlLine, DataEvent, ErrorEvent, FlowControl, OpenOptions, PortFilter, PortId, PortPickerLabels, SerialTransport, Subscription } from '../transport';
+/** Minimal structural WebSocket shape (browser & React Native both provide it). */
+export interface WebSocketLike {
+    binaryType: string;
+    send(data: string | ArrayBufferLike | ArrayBufferView): void;
+    close(): void;
+    addEventListener(type: string, listener: (event: {
+        data?: unknown;
+    }) => void): void;
+}
+export type WebSocketCtor = new (url: string) => WebSocketLike;
+export type WebSocketConnectionState = 'connecting' | 'open' | 'reconnecting' | 'suspended' | 'closed';
+export type WebSocketSerialOptions = {
+    /** USB identity to report from getInfo() (cosmetic; default 0/0). */
+    usbVendorId?: number;
+    usbProductId?: number;
+    /** Serial number returned by getSerial(). */
+    serialNumber?: string;
+    /** WebSocket implementation (defaults to the global). Injectable for tests. */
+    WebSocket?: WebSocketCtor;
+    /** Auto-reconnect when the socket drops unexpectedly. Default `true`. */
+    reconnect?: boolean;
+    /** Initial reconnect backoff in ms; doubles each attempt. Default 250. */
+    reconnectInitialDelayMs?: number;
+    /** Cap on the reconnect backoff in ms. Default 10000. */
+    reconnectMaxDelayMs?: number;
+    /** Give up (surface a disconnect) after this many consecutive failures. Default Infinity. */
+    maxReconnectAttempts?: number;
+    /** How long write()/commands wait for a (re)connection before failing. Default 10000. */
+    connectTimeoutMs?: number;
+    /** How long a control command waits for its response before failing. Default 10000. */
+    commandTimeoutMs?: number;
+    /** Notified before each reconnect attempt (1-based attempt + the chosen delay). */
+    onReconnecting?: (attempt: number, delayMs: number) => void;
+    /** Notified once (re)connected; `reconnected` is false only for the first connect. */
+    onConnected?: (info: {
+        reconnected: boolean;
+    }) => void;
+    /** Notified when the transport is permanently closed (gave up, or `disconnect()`). */
+    onClosed?: (reason: string) => void;
+};
+type Listener<E> = (event: E) => void;
+export declare class WebSocketSerialTransport implements SerialTransport {
+    #private;
+    constructor(url: string, options?: WebSocketSerialOptions);
+    /** Current connection state (advisory; the polyfill keeps working across reconnects). */
+    get connectionState(): WebSocketConnectionState;
+    findAllDrivers(): Promise<ReadonlyArray<PortId>>;
+    showPortPicker(_filter: ReadonlyArray<PortFilter>, _labels?: PortPickerLabels): Promise<PortId>;
+    requestPermission(_deviceId: number): Promise<boolean>;
+    open(_deviceId: number, _portNumber: number, options: OpenOptions): Promise<void>;
+    close(_deviceId: number, _portNumber: number): Promise<void>;
+    isOpen(_deviceId: number, _portNumber: number): boolean;
+    write(_deviceId: number, _portNumber: number, data: number[], _timeout?: number): Promise<void>;
+    startReading(_deviceId: number, _portNumber: number): Promise<void>;
+    stopReading(_deviceId: number, _portNumber: number): Promise<void>;
+    setParameters(_deviceId: number, _portNumber: number, options: OpenOptions): Promise<void>;
+    setDTR(_d: number, _p: number, value: boolean): Promise<void>;
+    setRTS(_d: number, _p: number, value: boolean): Promise<void>;
+    getDTR(_d: number, _p: number): Promise<boolean>;
+    getRTS(_d: number, _p: number): Promise<boolean>;
+    getCD(_d: number, _p: number): Promise<boolean>;
+    getCTS(_d: number, _p: number): Promise<boolean>;
+    getDSR(_d: number, _p: number): Promise<boolean>;
+    getRI(_d: number, _p: number): Promise<boolean>;
+    getControlLines(_d: number, _p: number): Promise<ControlLine[]>;
+    getSupportedControlLines(_d: number, _p: number): Promise<ControlLine[]>;
+    setFlowControl(_d: number, _p: number, _flowControl: FlowControl): Promise<void>;
+    getFlowControl(_d: number, _p: number): Promise<FlowControl>;
+    getSupportedFlowControl(_d: number, _p: number): Promise<FlowControl[]>;
+    setBreak(_d: number, _p: number, value: boolean): Promise<void>;
+    purgeHwBuffers(_d: number, _p: number, _purgeWrite: boolean, _purgeRead: boolean): Promise<void>;
+    getSerial(_d: number, _p: number): Promise<string>;
+    onData(listener: Listener<DataEvent>): Subscription;
+    onError(listener: Listener<ErrorEvent>): Subscription;
+    onConnect(listener: Listener<ConnectEvent>): Subscription;
+    onDisconnect(listener: Listener<ConnectEvent>): Subscription;
+    /**
+     * Permanently close the transport (and the remote port session). Cancels any
+     * pending reconnect and stops auto-reconnecting.
+     */
+    disconnect(): void;
+}
+export {};
+//# sourceMappingURL=WebSocketSerialTransport.d.ts.map

package/lib/typescript/src/websocket/WebSocketSerialTransport.d.ts.map

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

package/lib/typescript/src/websocket/bridge.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Server-side core of the WebSocket serial bridge — deliberately free of any
+ * `serialport`/`ws`/Node imports so it is unit-testable with fakes. The thin
+ * `bin/expose-serial.js` wrapper supplies the real `serialport` port and `ws`
+ * socket objects and calls {@link attachBridge} for each connection.
+ */
+import { type PortInfo } from './protocol';
+/** The subset of a `serialport` SerialPort that the bridge uses (callback API). */
+export interface SerialLike {
+    write(data: Uint8Array, cb?: (err?: Error | null) => void): void;
+    set(opts: {
+        dtr?: boolean;
+        rts?: boolean;
+        brk?: boolean;
+    }, cb?: (err?: Error | null) => void): void;
+    get(cb: (err: Error | null, signals?: {
+        cts?: boolean;
+        dsr?: boolean;
+        dcd?: boolean;
+        ri?: boolean;
+    }) => void): void;
+    update(opts: {
+        baudRate: number;
+    }, cb?: (err?: Error | null) => void): void;
+    flush(cb?: (err?: Error | null) => void): void;
+    drain(cb?: (err?: Error | null) => void): void;
+    close(cb?: (err?: Error | null) => void): void;
+    on(event: 'data', listener: (data: Uint8Array) => void): void;
+    on(event: 'error', listener: (err: Error) => void): void;
+    on(event: 'open' | 'close', listener: () => void): void;
+    removeListener(event: string, listener: (...args: never[]) => void): void;
+}
+/** The subset of a `ws` WebSocket that the bridge uses. */
+export interface WsLike {
+    send(data: string | Uint8Array): void;
+    on(event: 'message', listener: (data: unknown, isBinary: boolean) => void): void;
+    on(event: 'close', listener: () => void): void;
+    on(event: 'error', listener: (err: Error) => void): void;
+}
+export type BridgeOptions = {
+    /** Whether the port forwards serial→client data before `startReading`. */
+    readingByDefault?: boolean;
+    /** Optional logger for diagnostics. */
+    log?: (message: string) => void;
+    /** Optional static metadata or callback exposed via `getPortInfo`. */
+    portInfo?: PortInfo | (() => PortInfo | null | undefined);
+};
+/**
+ * Wire a single WebSocket connection to a single serial port: binary frames are
+ * piped both ways, JSON control frames invoke the corresponding serial method
+ * and get a response, and the port's data/error/close are surfaced as frames.
+ * Returns a teardown function that detaches the serial listeners.
+ */
+export declare function attachBridge(serial: SerialLike, ws: WsLike, options?: BridgeOptions): () => void;
+export type BridgeArgs = {
+    port?: string;
+    baudRate: number;
+    wsPort: number;
+    host: string;
+    allowRemote: boolean;
+    help: boolean;
+};
+/** Parse `expose-serial` CLI args + env into a normalised options object. */
+export declare function parseBridgeArgs(argv: readonly string[], env?: Record<string, string | undefined>): BridgeArgs;
+export declare const USAGE = "expose-serial-websocket \u2014 bridge a serial port to a WebSocket\n\nUsage:\n  expose-serial-websocket --port <path> [--baudrate 115200] [--ws-port 8080]\n                          [--host 127.0.0.1] [--allow-remote]\n\nOptions:\n  -p, --port <path>       Serial device (e.g. /dev/ttyUSB0, COM3)   [env SERIAL_PORT]\n  -b, --baudrate <n>      Baud rate (default 115200)                [env BAUD_RATE]\n  -w, --ws-port <n>       WebSocket port (default 8080)             [env WS_PORT]\n      --host <addr>       Listen address (default 127.0.0.1)        [env HOST]\n      --allow-remote      Bind 0.0.0.0 (exposes the port to the network!)\n  -h, --help              Show this help\n\nConnect from the app with:\n  new Serial(new WebSocketSerialTransport('ws://localhost:8080'))\n";
+//# sourceMappingURL=bridge.d.ts.map

package/lib/typescript/src/websocket/bridge.d.ts.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Remote-serial-over-WebSocket entry point.
+ *
+ *   import {WebSocketSerialTransport}
+ *     from 'react-native-web-serial-api/websocket';
+ *
+ * Client side: `WebSocketSerialTransport` connects an app to a remote serial
+ * port. Server side: {@link attachBridge} pipes a WebSocket to a serial port,
+ * and {@link SimulatedDeviceToSerialLike} lets that "serial port" be an in-memory
+ * {@link SimulatedDevice} simulator (used by `testing/exposeSimulatedDevice`). The
+ * wire protocol is in {@link ./protocol}; the bridge core in {@link ./bridge}.
+ */
+export type { BridgeOptions, SerialLike, WsLike } from './bridge';
+export { attachBridge } from './bridge';
+export type { CommandMessage, CommandName, ControlMessage, EventMessage, InputSignals, LineCoding, Parity, PortInfo, ResponseMessage, } from './protocol';
+export { portInfoFromDevice, SimulatedDeviceToSerialLike, } from './serial-device-bridge';
+export type { WebSocketCtor, WebSocketLike, WebSocketSerialOptions, } from './WebSocketSerialTransport';
+export { WebSocketSerialTransport } from './WebSocketSerialTransport';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/websocket/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,YAAY,EAAC,aAAa,EAAE,UAAU,EAAE,MAAM,EAAC,MAAM,UAAU,CAAC;AAChE,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AACtC,YAAY,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,MAAM,EACN,QAAQ,EACR,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAC,wBAAwB,EAAC,MAAM,4BAA4B,CAAC"}

package/lib/typescript/src/websocket/protocol.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Wire protocol shared by the WebSocket serial bridge (Node, see
+ * {@link ./bridge}) and the client transport ({@link ./WebSocketSerialTransport}).
+ *
+ * A single WebSocket carries two kinds of frame:
+ *   - **binary** frames are raw serial bytes (client→bridge = data to write to the
+ *     port; bridge→client = data read from the port), and
+ *   - **text** frames are JSON control messages (this module).
+ *
+ * Control flow is request/response: the client tags each {@link CommandMessage}
+ * with an incrementing `id` and the bridge replies with a {@link ResponseMessage}
+ * carrying the same `id`. The bridge may also push unsolicited
+ * {@link EventMessage}s (port open/close/error).
+ */
+import type { Parity } from '../WebSerial';
+export type { Parity } from '../WebSerial';
+/** Connection parameters for `setLineCoding`. */
+export type LineCoding = {
+    baudRate: number;
+    dataBits?: number;
+    stopBits?: number;
+    parity?: Parity;
+};
+/** Input control-signal state returned by `getSignals`. */
+export type InputSignals = {
+    cts: boolean;
+    dsr: boolean;
+    dcd: boolean;
+    ri: boolean;
+};
+/** Optional serial-port metadata returned by `getPortInfo`. */
+export type PortInfo = {
+    usbVendorId?: number;
+    usbProductId?: number;
+    serialNumber?: string;
+};
+/** Every control command the bridge understands. */
+export type CommandName = 'setLineCoding' | 'setBaudRate' | 'setSignals' | 'getSignals' | 'getPortInfo' | 'startReading' | 'stopReading' | 'flush' | 'drain' | 'break' | 'close';
+/** client → bridge */
+export type CommandMessage = {
+    type: 'command';
+    id: number;
+    command: CommandName;
+    args?: Record<string, unknown>;
+};
+/** bridge → client, answering a {@link CommandMessage} with the same `id`. */
+export type ResponseMessage = {
+    type: 'response';
+    id: number;
+    error: string | null;
+    result?: unknown;
+};
+/** An unsolicited port lifecycle event the bridge emits to the client. */
+export type BridgeEventName = 'open' | 'close' | 'error';
+/** bridge → client */
+export type EventMessage = {
+    type: 'event';
+    event: BridgeEventName;
+    error?: string;
+};
+export type ControlMessage = CommandMessage | ResponseMessage | EventMessage;
+/** Parse a text frame into a {@link ControlMessage}, or null if it isn't one. */
+export declare function parseControlMessage(text: string): ControlMessage | null;
+//# sourceMappingURL=protocol.d.ts.map

package/lib/typescript/src/websocket/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/websocket/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,cAAc,CAAC;AAEzC,YAAY,EAAC,MAAM,EAAC,MAAM,cAAc,CAAC;AAEzC,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;CACb,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,cAAc,GACd,aAAa,GACb,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ,sBAAsB;AACtB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzD,sBAAsB;AACtB,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC;AAE7E,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAevE"}

package/lib/typescript/src/websocket/serial-device-bridge.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Adapt an in-memory {@link DeviceHandle} simulator to the
+ * `serialport`-style {@link SerialLike} that {@link attachBridge} consumes, so a
+ * test can expose a *simulated* device over a WebSocket and have a real app
+ * connect to it with `new WebSocketSerialTransport(url)`. This is what makes the
+ * *same* device-driving test run in Jest (in-memory) and on a device/emulator
+ * (over the socket).
+ *
+ * Pure — no `ws`/`serialport`/Node imports — so it unit-tests with the same
+ * `FakeWs` + `attachBridge` fakes the bridge core uses. The lazy-`ws` server
+ * wrapper lives in `react-native-web-serial-api/testing` (`exposeSimulatedDevice`).
+ *
+ * Mapping (host app ⇄ simulator):
+ *   - client binary frame → `write` → `device.onData`,
+ *   - `setLineCoding`/`setBaudRate` → `update` → opens the sim + starts reading,
+ *   - `setSignals` → `set` → `device.onHostSignals`,
+ *   - `getSignals` → `get` → the device's asserted input signals,
+ *   - `device.send(...)` → `'data'` → client binary frame,
+ *   - `getPortInfo` → {@link portInfoFromDevice}.
+ */
+import type { DeviceHandle, InMemorySerialTransport } from '../testing/in-memory-serial-transport';
+import type { SerialLike } from './bridge';
+import type { PortInfo } from './protocol';
+/** The bridge's `getPortInfo` metadata, taken from the device's USB identity. */
+export declare function portInfoFromDevice(device: DeviceHandle): PortInfo;
+/**
+ * Build a {@link SerialLike} backed by `device` (already registered on
+ * `transport` via `addDevice`). One adapter per WebSocket connection; its
+ * transport subscriptions are released when the bridge tears down its listeners.
+ */
+export declare function SimulatedDeviceToSerialLike(transport: InMemorySerialTransport, device: DeviceHandle): SerialLike;
+//# sourceMappingURL=serial-device-bridge.d.ts.map

package/lib/typescript/src/websocket/serial-device-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-device-bridge.d.ts","sourceRoot":"","sources":["../../../../src/websocket/serial-device-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACxB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEzC,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,uBAAuB,EAClC,MAAM,EAAE,YAAY,GACnB,UAAU,CAiHZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-web-serial-api",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "W3C Web Serial API (navigator.serial) for React Native on Android, backed by a USB-serial TurboModule (built on mik3y/usb-serial-for-android).",
   "main": "lib/commonjs/index.js",
   "react-native": "lib/commonjs/index.js",
@@ -19,15 +19,26 @@
       "react-native": "./lib/commonjs/testing/index.js",
       "default": "./lib/commonjs/testing/index.js"
     },
+    "./websocket": {
+      "source": "./src/websocket/index.ts",
+      "types": "./lib/typescript/src/websocket/index.d.ts",
+      "react-native": "./lib/commonjs/websocket/index.js",
+      "default": "./lib/commonjs/websocket/index.js"
+    },
     "./package.json": "./package.json"
   },
+  "bin": {
+    "expose-serial-websocket": "bin/expose-serial.js"
+  },
   "files": [
     "src",
     "lib",
     "android",
+    "bin",
     "react-native.config.js",
     "TESTING.md",
     "!android/build",
+    "!android/src/test",
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__",
@@ -37,11 +48,12 @@
     "prepare": "bob build",
     "clean": "node -e \"require('fs').rm(\\\"./lib\\\", { recursive: true }, () => {console.log(\\\"'lib' folder deleted\\\")})\"",
     "typecheck": "tsc --noEmit",
-    "lint": "biome check src",
-    "format": "biome check --write src",
+    "lint": "biome check",
+    "format": "biome check --write",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
+    "test:android": "cd example/android && ./gradlew :react-native-web-serial-api:testDebugUnitTest",
     "test:emulator:e2e": "npm --prefix example run e2e",
     "test:host+emulator": "node ./node_modules/jest/bin/jest.js && npm --prefix example run e2e"
   },
@@ -78,6 +90,10 @@
   "dependencies": {
     "web-streams-polyfill": "^4.3.0"
   },
+  "optionalDependencies": {
+    "serialport": "^12.0.0",
+    "ws": "^8.18.0"
+  },
   "peerDependencies": {
     "react": "*",
     "react-native": "*"
@@ -87,7 +103,9 @@
     "@react-native/babel-preset": "0.85.3",
     "@react-native/jest-preset": "0.85.3",
     "@types/jest": "^29.5.14",
+    "@types/node": "^25.9.2",
     "@types/react": "^19.2.6",
+    "@types/ws": "^8.18.1",
     "babel-jest": "29.6.3",
     "jest": "29.6.3",
     "react": "19.2.3",