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

package/lib/commonjs/transport.js

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

package/lib/commonjs/transport.js.map

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

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

@@ -1,68 +1,7 @@
-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;
-};
-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;
-};
-type Subscription = {
-    remove: () => void;
-};
-export declare class UsbSerialModule {
+import type { ConnectEvent, ControlLine, DataEvent, ErrorEvent, FlowControl, OpenOptions, PortFilter, PortId, PortPickerLabels, SerialTransport, Subscription } from './transport';
+export type { ConnectEvent, ControlLine, DataEvent, ErrorEvent, FlowControl, OpenOptions, PortFilter, PortId, PortPickerLabels, SerialTransport, } from './transport';
+export { DataBits, Parity, StopBits } from './transport';
+export declare class UsbSerialModule implements SerialTransport {
     private readonly native;
     private readonly emitter;
     constructor();
@@ -97,6 +36,24 @@ export declare class UsbSerialModule {
     onConnect(listener: (event: ConnectEvent) => void): Subscription;
     onDisconnect(listener: (event: ConnectEvent) => void): Subscription;
 }
-export declare function getUsbSerial(): UsbSerialModule;
-export {};
+/**
+ * Resolve the active serial transport. Returns the override set via
+ * {@link setUsbSerial} if present (used by tests and by the example's on-device
+ * "virtual device" mode); otherwise lazily constructs the real native-backed
+ * {@link UsbSerialModule}.
+ */
+export declare function getUsbSerial(): SerialTransport;
+/**
+ * Override the transport returned by {@link getUsbSerial}. Pass a
+ * {@link SerialTransport} (e.g. a `VirtualSerialTransport`) to make the
+ * singleton `serial` instance — and any `new Serial()` created without an
+ * explicit transport — talk to it instead of real hardware. Pass `null` to
+ * clear the override.
+ *
+ * Inject before the first `getPorts()` / `requestPort()` / `addEventListener()`
+ * call so the lazy initialisation in `Serial` picks it up.
+ */
+export declare function setUsbSerial(transport: SerialTransport | null): void;
+/** Clear any override and drop the cached native instance (test teardown). */
+export declare function resetUsbSerial(): void;
 //# sourceMappingURL=UsbSerial.d.ts.map

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

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

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

@@ -1,6 +1,6 @@
 import { ReadableStream, WritableStream } from 'web-streams-polyfill';
 import { Event, EventTarget } from './lib/event-target';
-import type { UsbSerialModule } from './UsbSerial';
+import type { SerialTransport } from './transport';
 /**
  * @see https://wicg.github.io/serial/#dom-paritytype
  *
@@ -149,7 +149,7 @@ export type SerialPortRequestOptions = {
  */
 export declare class SerialPort extends EventTarget {
     #private;
-    constructor(usb: UsbSerialModule, deviceId: number, portNumber: number, usbVendorId: number, usbProductId: number);
+    constructor(usb: SerialTransport, deviceId: number, portNumber: number, usbVendorId: number, usbProductId: number);
     /**
      * @see https://wicg.github.io/serial/#dom-serialport-onconnect
      */
@@ -212,6 +212,15 @@ export declare class SerialPort extends EventTarget {
  */
 export declare class Serial extends EventTarget {
     #private;
+    /**
+     * @param transport Optional transport override. When provided, this `Serial`
+     * talks to it instead of the global native module — the seam used by tests
+     * and the virtual-device harness (`new Serial(new VirtualSerialTransport())`).
+     * Omit it for the normal native-backed instance; the singleton `serial`
+     * export is created this way and can still be redirected globally via
+     * `setUsbSerial()`.
+     */
+    constructor(transport?: SerialTransport);
     /**
      * Subscribing to "connect"/"disconnect" must wire up the native USB state
      * listeners, so a consumer can receive attach/detach/permission events

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

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

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

@@ -1,4 +1,6 @@
 export { default as serial } from './serial';
+export type { SerialTransport } from './transport';
+export { resetUsbSerial, setUsbSerial } from './UsbSerial';
 export type { SerialInputSignals, SerialOptions, SerialOutputSignals, SerialPortFilter, SerialPortInfo, SerialPortRequestOptions, } from './WebSerial';
 export { Serial, SerialPort } from './WebSerial';
 import * as UsbSerial from './UsbSerial';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,UAAU,CAAC;AAC3C,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,aAAa,CAAC;AAK/C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAC,KAAK,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAC,SAAS,EAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,cAAc,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AACzD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAC,KAAK,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAC,SAAS,EAAC,CAAC"}

package/lib/typescript/src/lib/dom-exception.d.ts

@@ -0,0 +1,100 @@
+/**
+ * DOMException Polyfill
+ *
+ * Provides a spec-compliant DOMException implementation for environments
+ * where it is missing or incomplete (e.g. Node.js < 17, some older browsers).
+ *
+ * Spec: https://webidl.spec.whatwg.org/#idl-DOMException
+ */
+declare const DOM_EXCEPTION_CODES: Record<string, number>;
+declare const DOM_EXCEPTION_NAMES: Record<number, string>;
+export interface DOMExceptionConstructor {
+    new (message?: string, name?: string): DOMException;
+    readonly prototype: DOMException;
+    readonly INDEX_SIZE_ERR: 1;
+    readonly DOMSTRING_SIZE_ERR: 2;
+    readonly HIERARCHY_REQUEST_ERR: 3;
+    readonly WRONG_DOCUMENT_ERR: 4;
+    readonly INVALID_CHARACTER_ERR: 5;
+    readonly NO_DATA_ALLOWED_ERR: 6;
+    readonly NO_MODIFICATION_ALLOWED_ERR: 7;
+    readonly NOT_FOUND_ERR: 8;
+    readonly NOT_SUPPORTED_ERR: 9;
+    readonly INUSE_ATTRIBUTE_ERR: 10;
+    readonly INVALID_STATE_ERR: 11;
+    readonly SYNTAX_ERR: 12;
+    readonly INVALID_MODIFICATION_ERR: 13;
+    readonly NAMESPACE_ERR: 14;
+    readonly INVALID_ACCESS_ERR: 15;
+    readonly VALIDATION_ERR: 16;
+    readonly TYPE_MISMATCH_ERR: 17;
+    readonly SECURITY_ERR: 18;
+    readonly NETWORK_ERR: 19;
+    readonly ABORT_ERR: 20;
+    readonly URL_MISMATCH_ERR: 21;
+    readonly QUOTA_EXCEEDED_ERR: 22;
+    readonly TIMEOUT_ERR: 23;
+    readonly INVALID_NODE_TYPE_ERR: 24;
+    readonly DATA_CLONE_ERR: 25;
+}
+declare class DOMExceptionPolyfill extends Error {
+    readonly code: number;
+    readonly name: string;
+    static readonly INDEX_SIZE_ERR: 1;
+    static readonly DOMSTRING_SIZE_ERR: 2;
+    static readonly HIERARCHY_REQUEST_ERR: 3;
+    static readonly WRONG_DOCUMENT_ERR: 4;
+    static readonly INVALID_CHARACTER_ERR: 5;
+    static readonly NO_DATA_ALLOWED_ERR: 6;
+    static readonly NO_MODIFICATION_ALLOWED_ERR: 7;
+    static readonly NOT_FOUND_ERR: 8;
+    static readonly NOT_SUPPORTED_ERR: 9;
+    static readonly INUSE_ATTRIBUTE_ERR: 10;
+    static readonly INVALID_STATE_ERR: 11;
+    static readonly SYNTAX_ERR: 12;
+    static readonly INVALID_MODIFICATION_ERR: 13;
+    static readonly NAMESPACE_ERR: 14;
+    static readonly INVALID_ACCESS_ERR: 15;
+    static readonly VALIDATION_ERR: 16;
+    static readonly TYPE_MISMATCH_ERR: 17;
+    static readonly SECURITY_ERR: 18;
+    static readonly NETWORK_ERR: 19;
+    static readonly ABORT_ERR: 20;
+    static readonly URL_MISMATCH_ERR: 21;
+    static readonly QUOTA_EXCEEDED_ERR: 22;
+    static readonly TIMEOUT_ERR: 23;
+    static readonly INVALID_NODE_TYPE_ERR: 24;
+    static readonly DATA_CLONE_ERR: 25;
+    constructor(message?: string, name?: string);
+    /** Mirror static constants on the prototype (spec §3.1.2) */
+    get INDEX_SIZE_ERR(): number;
+    get DOMSTRING_SIZE_ERR(): number;
+    get HIERARCHY_REQUEST_ERR(): number;
+    get WRONG_DOCUMENT_ERR(): number;
+    get INVALID_CHARACTER_ERR(): number;
+    get NO_DATA_ALLOWED_ERR(): number;
+    get NO_MODIFICATION_ALLOWED_ERR(): number;
+    get NOT_FOUND_ERR(): number;
+    get NOT_SUPPORTED_ERR(): number;
+    get INUSE_ATTRIBUTE_ERR(): number;
+    get INVALID_STATE_ERR(): number;
+    get SYNTAX_ERR(): number;
+    get INVALID_MODIFICATION_ERR(): number;
+    get NAMESPACE_ERR(): number;
+    get INVALID_ACCESS_ERR(): number;
+    get VALIDATION_ERR(): number;
+    get TYPE_MISMATCH_ERR(): number;
+    get SECURITY_ERR(): number;
+    get NETWORK_ERR(): number;
+    get ABORT_ERR(): number;
+    get URL_MISMATCH_ERR(): number;
+    get QUOTA_EXCEEDED_ERR(): number;
+    get TIMEOUT_ERR(): number;
+    get INVALID_NODE_TYPE_ERR(): number;
+    get DATA_CLONE_ERR(): number;
+    /** Canonical string representation */
+    toString(): string;
+}
+export declare const DOMExceptionImpl: DOMExceptionConstructor;
+export { DOM_EXCEPTION_CODES, DOM_EXCEPTION_NAMES, DOMExceptionImpl as DOMException, DOMExceptionPolyfill, };
+//# sourceMappingURL=dom-exception.d.ts.map

package/lib/typescript/src/lib/dom-exception.d.ts.map

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

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

@@ -0,0 +1,53 @@
+export interface EventInit {
+    bubbles?: boolean;
+    cancelable?: boolean;
+    composed?: boolean;
+}
+export declare class Event {
+    readonly type: string;
+    readonly bubbles: boolean;
+    readonly cancelable: boolean;
+    readonly composed: boolean;
+    target: EventTarget | null;
+    currentTarget: EventTarget | null;
+    defaultPrevented: boolean;
+    cancelBubble: boolean;
+    _stopImmediatePropagationFlag: boolean;
+    readonly timeStamp: number;
+    readonly isTrusted: boolean;
+    static readonly NONE = 0;
+    static readonly CAPTURING_PHASE = 1;
+    static readonly AT_TARGET = 2;
+    static readonly BUBBLING_PHASE = 3;
+    readonly NONE = 0;
+    readonly CAPTURING_PHASE = 1;
+    readonly AT_TARGET = 2;
+    readonly BUBBLING_PHASE = 3;
+    eventPhase: number;
+    constructor(type: string, options?: EventInit);
+    preventDefault(): void;
+    stopPropagation(): void;
+    stopImmediatePropagation(): void;
+    composedPath(): EventTarget[];
+    initEvent(type: string, bubbles?: boolean, cancelable?: boolean): void;
+}
+type EventListener = (event: Event) => void;
+interface EventListenerObject {
+    handleEvent(event: Event): void;
+}
+type EventListenerOrEventListenerObject = EventListener | EventListenerObject;
+type ListenerOptions = {
+    once?: boolean;
+    capture?: boolean;
+    passive?: boolean;
+} | boolean | undefined;
+/** Make events dispatched on `child` also bubble to `parent`'s listeners. */
+export declare function setEventParent(child: EventTarget, parent: EventTarget): void;
+export declare class EventTarget {
+    constructor();
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: ListenerOptions): void;
+    dispatchEvent(event: Event): boolean;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, _options?: ListenerOptions): void;
+}
+export {};
+//# sourceMappingURL=event-target.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,11 @@
+type DeferredPromise<T> = {
+    promise: Promise<T>;
+    resolve: (value?: T) => void;
+    reject: (reason?: unknown) => void;
+};
+/**
+ * @returns An object containing a promise and its resolve/reject methods.
+ */
+export declare function createDeferredPromise<T>(): DeferredPromise<T>;
+export {};
+//# sourceMappingURL=promise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../../../../src/lib/promise.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,CAAC,CAAC,IAAI;IACxB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,CAS7D"}

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

@@ -0,0 +1,23 @@
+/**
+ * Testing & on-device-demo entry point.
+ *
+ * Imported via the package subpath:
+ *
+ *   import {VirtualSerialTransport, installSerialMock}
+ *     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
+ * 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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,25 @@
+import { SerialDevice } from './serial-device';
+import type { VirtualDeviceOptions, VirtualSerialOptions } from './virtual-serial';
+import { VirtualSerialTransport } from './virtual-serial';
+/** A device to register: a SerialDevice, optionally with transport options. */
+export type SerialMockDevice = SerialDevice | {
+    device: SerialDevice;
+    options?: VirtualDeviceOptions;
+};
+export type InstallSerialMockOptions = {
+    /** The simulated devices to expose. */
+    devices: SerialMockDevice[];
+    /** When false, no mock is installed and `null` is returned. Defaults to true. */
+    enabled?: boolean;
+    /** Transport-level options (latency, chunkSize, …). */
+    transport?: VirtualSerialOptions;
+};
+/**
+ * Build a {@link VirtualSerialTransport} from `devices` and install it globally
+ * via {@link setUsbSerial}. SerialDevices 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 installSerialMock(options: InstallSerialMockOptions): VirtualSerialTransport | null;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../src/testing/install.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAC,sBAAsB,EAAC,MAAM,kBAAkB,CAAC;AAExD,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;CAAC,CAAC;AAE3D,MAAM,MAAM,wBAAwB,GAAG;IACrC,uCAAuC;IACvC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,sBAAsB,GAAG,IAAI,CAiB/B"}

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

@@ -0,0 +1,127 @@
+/**
+ * SerialDevice — 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
+ * 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 {
+ *   usbVendorId = 0x0403;
+ *   usbProductId = 0x6001;
+ *   #timer?: ReturnType<typeof setInterval>;
+ *   onOpen() {
+ *     this.#timer = setInterval(() => this.send(`${20 + Math.random()}C\r\n`), 1000);
+ *   }
+ *   onData(bytes) {                       // host wrote a command
+ *     if (String.fromCharCode(...bytes).trim() === 'ID?') this.send('ACME-TEMP\r\n');
+ *   }
+ *   onClose() { clearInterval(this.#timer); }
+ * }
+ * transport.addDevice(new Thermometer(), {hasPermission: true});
+ */
+import type { OpenOptions } from '../transport';
+/** The negotiated connection parameters (native parity code: 0 none/1 odd/2 even). */
+export type SerialDeviceOpenOptions = Required<OpenOptions>;
+/** Device-asserted input signals — what the host reads via getSignals(). */
+export type SerialInputSignals = {
+    dataCarrierDetect?: boolean;
+    clearToSend?: boolean;
+    ringIndicator?: boolean;
+    dataSetReady?: boolean;
+};
+/** Host-asserted output signals (DTR/RTS/break) the device observes. */
+export type SerialHostSignals = {
+    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`
+ * rather than this directly.
+ */
+export interface SerialDeviceHost {
+    readonly deviceId: number;
+    readonly portNumber: number;
+    readonly isOpen: boolean;
+    readonly openOptions: SerialDeviceOpenOptions | null;
+    send(bytes: number[]): void;
+    raiseError(message: string, name?: string): void;
+    setSignals(signals: SerialInputSignals): void;
+}
+/** Coerce a payload into a byte array (string → char codes, & 0xff). */
+export declare function toBytes(data: number[] | Uint8Array | string): number[];
+/**
+ * Base class for a simulated serial peripheral. Override the `on*` hooks you
+ * care about (all default to no-ops and may be async) and use the `protected`
+ * helpers to drive the host.
+ */
+export declare abstract class SerialDevice {
+    #private;
+    /** USB Vendor ID this device reports for enumeration. */
+    abstract readonly usbVendorId: number;
+    /** USB Product ID this device reports for enumeration. */
+    abstract readonly usbProductId: number;
+    /** Optional USB serial number. */
+    readonly serialNumber?: string;
+    /** @internal Bind the transport host (called by VirtualSerialTransport). */
+    _bind(host: SerialDeviceHost): void;
+    /** Send bytes to the host (they appear on `port.readable`). */
+    protected send(data: number[] | Uint8Array | string): void;
+    /**
+     * Raise a typed read error on the host's readable stream. `name` is the W3C
+     * error type, e.g. "BreakError", "BufferOverrunError", "FramingError",
+     * "ParityError" (defaults to "NetworkError").
+     */
+    protected raiseError(message: string, name?: string): void;
+    /** 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 deviceId(): number;
+    protected get portNumber(): number;
+    /** The host opened the port. */
+    onOpen(_options: SerialDeviceOpenOptions): 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>;
+    /** The host closed the port. */
+    onClose(): void | Promise<void>;
+}
+/** Optional USB identity for the built-in devices. */
+export type DeviceIdentity = {
+    usbVendorId?: number;
+    usbProductId?: number;
+    serialNumber?: string;
+};
+/** A loopback device: every byte written is echoed straight back. */
+export declare class EchoDevice extends SerialDevice {
+    readonly usbVendorId: number;
+    readonly usbProductId: number;
+    readonly serialNumber?: string;
+    constructor(identity?: DeviceIdentity);
+    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 {
+    #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 {
+    readonly usbVendorId: number;
+    readonly usbProductId: number;
+    readonly serialNumber?: string;
+    constructor(identity?: DeviceIdentity);
+}
+//# sourceMappingURL=serial-device.d.ts.map

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

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