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

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

@@ -0,0 +1,131 @@
+/**
+ * Hardware-transport abstraction for the Web Serial polyfill.
+ *
+ * `SerialTransport` is the single interface that the `Serial`/`SerialPort`
+ * classes depend on to talk to "the device". The production implementation
+ * (`UsbSerialModule`, backed by the `NativeUsbSerial` TurboModule — see
+ * {@link ./UsbSerial}) and the in-memory test/dev double
+ * (`InMemorySerialTransport` — see {@link ./testing/in-memory-serial-transport}) both
+ * implement it.
+ *
+ * This module is intentionally free of any `react-native` import. That is what
+ * lets the virtual transport — and therefore the conformance suite built on top
+ * of it — run unchanged under Node/Jest, in a browser, and on a device.
+ */
+export type ControlLine = 'RTS' | 'CTS' | 'DTR' | 'DSR' | 'CD' | 'RI';
+export type FlowControl = 'NONE' | 'RTS_CTS' | 'DTR_DSR' | 'XON_XOFF' | 'XON_XOFF_INLINE';
+export type PortFilter = {
+    usbVendorId?: number;
+    usbProductId?: number;
+};
+export type PortPickerLabels = {
+    titleSelectPort?: string;
+    titleNoPortsAvailable?: string;
+    messageNoPortsAvailable?: string;
+};
+export type PortId = {
+    deviceId: number;
+    portNumber: number;
+    usbVendorId: number;
+    usbProductId: number;
+    /**
+     * Whether the app currently holds Android USB permission to access this
+     * device (via the system attach dialog or a prior permission request).
+     */
+    hasPermission: boolean;
+};
+export type DataEvent = {
+    deviceId: number;
+    portNumber: number;
+    data: number[];
+};
+export type ErrorEvent = {
+    deviceId: number;
+    portNumber: number;
+    error: string;
+    /**
+     * Optional spec error name (e.g. "BreakError", "BufferOverrunError",
+     * "FramingError", "ParityError") for a typed read error. When present the
+     * polyfill surfaces a DOMException of that name on the readable stream
+     * (otherwise it defaults to "NetworkError"); the WPT-derived spec tests in
+     * src/__tests__/conformance-suite.ts exercise this (BreakError,
+     * BufferOverrunError).
+     */
+    errorName?: string;
+};
+export type ConnectEvent = {
+    deviceId: number;
+    usbVendorId: number;
+    usbProductId: number;
+};
+export declare const Parity: {
+    readonly NONE: 0;
+    readonly ODD: 1;
+    readonly EVEN: 2;
+    readonly MARK: 3;
+    readonly SPACE: 4;
+};
+export declare const DataBits: {
+    readonly FIVE: 5;
+    readonly SIX: 6;
+    readonly SEVEN: 7;
+    readonly EIGHT: 8;
+};
+export declare const StopBits: {
+    readonly ONE: 1;
+    readonly ONE_FIVE: 3;
+    readonly TWO: 2;
+};
+export type OpenOptions = {
+    baudRate: number;
+    dataBits?: number;
+    stopBits?: number;
+    parity?: number;
+};
+export declare const DEFAULT_OPEN_OPTIONS: Required<Omit<OpenOptions, 'baudRate'>>;
+/** Handle returned by the `on*` subscription methods. */
+export type Subscription = {
+    remove: () => void;
+};
+/**
+ * The contract every serial transport must satisfy. It mirrors the JS-friendly
+ * surface of `UsbSerialModule` exactly, so `UsbSerialModule implements
+ * SerialTransport` is a faithful 1:1 and any conforming double (e.g.
+ * `InMemorySerialTransport`) is a drop-in replacement.
+ *
+ * Ports are addressed by the pair `(deviceId, portNumber)`. Inbound bytes,
+ * read errors and device attach/detach arrive through the `on*` subscriptions.
+ */
+export interface SerialTransport {
+    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(deviceId: number, portNumber: number, value: boolean): Promise<void>;
+    setRTS(deviceId: number, portNumber: number, value: boolean): Promise<void>;
+    getDTR(deviceId: number, portNumber: number): Promise<boolean>;
+    getRTS(deviceId: number, portNumber: number): Promise<boolean>;
+    getCD(deviceId: number, portNumber: number): Promise<boolean>;
+    getCTS(deviceId: number, portNumber: number): Promise<boolean>;
+    getDSR(deviceId: number, portNumber: number): Promise<boolean>;
+    getRI(deviceId: number, portNumber: number): Promise<boolean>;
+    getControlLines(deviceId: number, portNumber: number): Promise<ControlLine[]>;
+    getSupportedControlLines(deviceId: number, portNumber: number): Promise<ControlLine[]>;
+    setFlowControl(deviceId: number, portNumber: number, flowControl: FlowControl): Promise<void>;
+    getFlowControl(deviceId: number, portNumber: number): Promise<FlowControl>;
+    getSupportedFlowControl(deviceId: number, portNumber: number): Promise<FlowControl[]>;
+    setBreak(deviceId: number, portNumber: number, value: boolean): Promise<void>;
+    purgeHwBuffers(deviceId: number, portNumber: number, purgeWriteBuffers: boolean, purgeReadBuffers: boolean): Promise<void>;
+    getSerial(deviceId: number, portNumber: number): Promise<string>;
+    onData(listener: (event: DataEvent) => void): Subscription;
+    onError(listener: (event: ErrorEvent) => void): Subscription;
+    onConnect(listener: (event: ConnectEvent) => void): Subscription;
+    onDisconnect(listener: (event: ConnectEvent) => void): Subscription;
+}
+//# sourceMappingURL=transport.d.ts.map

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

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

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,17 +1,61 @@
 {
   "name": "react-native-web-serial-api",
-  "version": "0.0.3",
+  "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",
   "source": "src/index.ts",
   "types": "lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "react-native": "./lib/commonjs/index.js",
+      "default": "./lib/commonjs/index.js"
+    },
+    "./testing": {
+      "source": "./src/testing/index.ts",
+      "types": "./lib/typescript/src/testing/index.d.ts",
+      "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__",
+    "!**/.*"
+  ],
   "scripts": {
     "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"
   },
   "keywords": [
     "react-native",
@@ -46,6 +90,10 @@
   "dependencies": {
     "web-streams-polyfill": "^4.3.0"
   },
+  "optionalDependencies": {
+    "serialport": "^12.0.0",
+    "ws": "^8.18.0"
+  },
   "peerDependencies": {
     "react": "*",
     "react-native": "*"
@@ -53,7 +101,13 @@
   "devDependencies": {
     "@biomejs/biome": "2.4.16",
     "@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",
     "react-native": "0.85.3",
     "react-native-builder-bob": "^0.41.0",