@react-native-harness/bridge 1.5.0 → 1.7.0

package/dist/link/standard-websocket.js

@@ -0,0 +1,214 @@
+import { globalClock } from "./ports.js";
+export { globalClock } from "./ports.js";
+const OPEN = 1;
+const DEFAULT_POLL_MS = 4;
+export class StandardWebSocketConnection {
+    #socket;
+    #clock;
+    #pollMs;
+    #dataListeners = new Set();
+    #binaryListeners = new Set();
+    #closeListeners = new Set();
+    #errorListeners = new Set();
+    #sentListeners = new Set();
+    #pending = [];
+    #waiters = [];
+    #queued = 0;
+    #flushed = 0;
+    #checkScheduled = false;
+    #timer;
+    #closed = false;
+    constructor(socket, options = {}) {
+        this.#socket = socket;
+        this.#clock = options.clock ?? globalClock;
+        this.#pollMs = options.pollMs ?? DEFAULT_POLL_MS;
+        // why: the default, "blob", cannot be read without awaiting, which would reorder messages.
+        socket.binaryType = "arraybuffer";
+        const onMessage = (event) => {
+            this.#onMessage(event.data);
+        };
+        const onClose = () => this.#markClosed();
+        const onError = (event) => {
+            const error = event.error instanceof Error ? event.error : new Error("WebSocket error");
+            for (const listener of this.#errorListeners)
+                listener(error);
+            this.#markClosed();
+        };
+        socket.addEventListener("message", onMessage);
+        socket.addEventListener("close", onClose);
+        socket.addEventListener("error", onError);
+    }
+    get closed() {
+        return this.#closed;
+    }
+    get #buffered() {
+        return this.#socket.bufferedAmount ?? 0;
+    }
+    get unsentBytes() {
+        return this.#buffered;
+    }
+    onData(listener) {
+        this.#dataListeners.add(listener);
+        if (this.#pending.length > 0) {
+            for (const chunk of this.#pending.splice(0))
+                listener(chunk);
+        }
+        return () => {
+            this.#dataListeners.delete(listener);
+        };
+    }
+    onBinary(listener) {
+        this.#binaryListeners.add(listener);
+        return () => {
+            this.#binaryListeners.delete(listener);
+        };
+    }
+    onClose(listener) {
+        if (this.#closed) {
+            listener();
+            return () => undefined;
+        }
+        this.#closeListeners.add(listener);
+        return () => {
+            this.#closeListeners.delete(listener);
+        };
+    }
+    onError(listener) {
+        this.#errorListeners.add(listener);
+        return () => {
+            this.#errorListeners.delete(listener);
+        };
+    }
+    onSent(listener) {
+        this.#sentListeners.add(listener);
+        return () => {
+            this.#sentListeners.delete(listener);
+        };
+    }
+    write(contents) {
+        return this.#send(contents);
+    }
+    writeBinary(bytes) {
+        return this.#send(bytes);
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#socket.close();
+        this.#markClosed();
+    }
+    #send(data) {
+        if (this.#closed || this.#socket.readyState !== OPEN)
+            return Promise.resolve();
+        // why: the standard send() has no completion callback, so what has left the buffer is worked out from bufferedAmount.
+        const before = this.#buffered;
+        this.#socket.send(data);
+        this.#queued += Math.max(0, this.#buffered - before);
+        return new Promise((resolve) => {
+            this.#waiters.push({ resolve, target: this.#queued });
+            this.#scheduleCheck();
+        });
+    }
+    #onMessage(data) {
+        if (typeof data === "string") {
+            if (this.#dataListeners.size === 0) {
+                this.#pending.push(data);
+            }
+            else {
+                for (const listener of this.#dataListeners)
+                    listener(data);
+            }
+        }
+        else if (data instanceof ArrayBuffer) {
+            const bytes = new Uint8Array(data);
+            for (const listener of this.#binaryListeners)
+                listener(bytes);
+        }
+        else if (ArrayBuffer.isView(data)) {
+            const bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+            for (const listener of this.#binaryListeners)
+                listener(bytes);
+        }
+        // why: a peer's message, a credit most of all, says bytes are moving, and is a cheaper look than a timer.
+        if (this.#waiters.length > 0 || this.#flushed < this.#queued)
+            this.#check();
+    }
+    #scheduleCheck() {
+        if (this.#checkScheduled)
+            return;
+        // why: a write must not settle, or report sent, before the call that made it has returned.
+        this.#checkScheduled = true;
+        void Promise.resolve().then(() => {
+            this.#checkScheduled = false;
+            this.#check();
+        });
+    }
+    #check() {
+        if (this.#closed)
+            return;
+        const buffered = this.#buffered;
+        const flushed = Math.max(this.#flushed, this.#queued - buffered);
+        const moved = flushed > this.#flushed;
+        this.#flushed = flushed;
+        if (this.#waiters.some((waiter) => waiter.target <= flushed)) {
+            const due = this.#waiters.filter((waiter) => waiter.target <= flushed);
+            this.#waiters = this.#waiters.filter((waiter) => waiter.target > flushed);
+            for (const waiter of due)
+                waiter.resolve();
+        }
+        if (moved)
+            for (const listener of this.#sentListeners)
+                listener();
+        if (buffered === 0 && this.#timer !== undefined) {
+            this.#clock.cancel(this.#timer);
+            this.#timer = undefined;
+        }
+        // why: a background tab throttles timers to about one a second, so a large transfer there slows until the tab is shown again.
+        if (buffered > 0 && this.#timer === undefined) {
+            this.#timer = this.#clock.setTimer(this.#pollMs, () => {
+                this.#timer = undefined;
+                this.#check();
+            });
+        }
+    }
+    #markClosed() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        if (this.#timer !== undefined) {
+            this.#clock.cancel(this.#timer);
+            this.#timer = undefined;
+        }
+        for (const waiter of this.#waiters.splice(0))
+            waiter.resolve();
+        for (const listener of this.#closeListeners)
+            listener();
+    }
+}
+export async function connectStandardWebSocket(options) {
+    const create = options.createSocket ??
+        ((url, protocols) => new WebSocket(url, protocols));
+    const socket = create(options.url, options.protocols);
+    const connection = new StandardWebSocketConnection(socket, options);
+    await new Promise((resolve, reject) => {
+        if (socket.readyState === OPEN)
+            return resolve();
+        const onOpen = () => {
+            cleanup();
+            resolve();
+        };
+        const onFail = () => {
+            cleanup();
+            reject(new Error(`could not open a WebSocket to ${options.url}`));
+        };
+        const cleanup = () => {
+            socket.removeEventListener("open", onOpen);
+            socket.removeEventListener("error", onFail);
+            socket.removeEventListener("close", onFail);
+        };
+        socket.addEventListener("open", onOpen);
+        socket.addEventListener("error", onFail);
+        socket.addEventListener("close", onFail);
+    });
+    return connection;
+}

package/dist/link/streams.d.ts

@@ -0,0 +1,4 @@
+export declare const LinkReadableStream: typeof globalThis.ReadableStream;
+export declare const LinkWritableStream: typeof globalThis.WritableStream;
+export declare const LinkByteLengthQueuingStrategy: typeof globalThis.ByteLengthQueuingStrategy;
+//# sourceMappingURL=streams.d.ts.map

package/dist/link/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/link/streams.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,kBAAkB,EAAE,OAAO,UAAU,CAAC,cAEwB,CAAC;AAE5E,eAAO,MAAM,kBAAkB,EAAE,OAAO,UAAU,CAAC,cAEwB,CAAC;AAE5E,eAAO,MAAM,6BAA6B,EAAE,OAAO,UAAU,CAAC,yBAEmC,CAAC"}

package/dist/link/streams.js

@@ -0,0 +1,15 @@
+import { ByteLengthQueuingStrategy as PonyfillByteLengthQueuingStrategy, ReadableStream as PonyfillReadableStream, WritableStream as PonyfillWritableStream, } from "web-streams-polyfill";
+const host = globalThis;
+// why: one source for all three, so a native stream never meets a ponyfilled strategy.
+const native = typeof host.ReadableStream === "function" &&
+    typeof host.WritableStream === "function" &&
+    typeof host.ByteLengthQueuingStrategy === "function";
+export const LinkReadableStream = native
+    ? host.ReadableStream
+    : PonyfillReadableStream;
+export const LinkWritableStream = native
+    ? host.WritableStream
+    : PonyfillWritableStream;
+export const LinkByteLengthQueuingStrategy = native
+    ? host.ByteLengthQueuingStrategy
+    : PonyfillByteLengthQueuingStrategy;

package/dist/protocol.d.ts

@@ -32,15 +32,20 @@ export type BridgeReadyMessage = {
     type: 'ready';
     device: DeviceDescriptor;
 };
-export type BridgePingMessage = {
-    type: 'ping';
+/**
+ * Sent by the server to check that the app's JS thread is getting a turn to
+ * run. Only JS answers it, unlike WebSocket protocol pings, which the native
+ * WebSocket answers.
+ */
+export type BridgeJsProbeMessage = {
+    type: 'js-probe';
     id: number;
 };
-export type BridgePongMessage = {
-    type: 'pong';
+export type BridgeJsProbeAckMessage = {
+    type: 'js-probe-ack';
     id: number;
 };
-export type BridgeControlMessage = BridgeReadyMessage | BridgePingMessage | BridgePongMessage;
+export type BridgeControlMessage = BridgeReadyMessage | BridgeJsProbeMessage | BridgeJsProbeAckMessage;
 export type BridgeMessage<Event extends {
     type: string;
 } = BridgeEvents> = BridgeInvokeMessage | BridgeReturnMessage | BridgeEventMessage<Event> | BridgeControlMessage;

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,qBAAqB,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,IAAI;IAC9E,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,IACnE,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,CAAC,KAAK,CAAC,GACzB,oBAAoB,CAAC;AAmEzB,eAAO,MAAM,sBAAsB,GACjC,SAAS,aAAa,KACrB,MAEF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,aAiDhD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,OAAO,KACb,qBA+BF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,YAAY,qBAAqB,KAChC,KAYF,CAAC"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,qBAAqB,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,IAAI;IAC9E,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,oBAAoB,GACpB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,IACnE,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,CAAC,KAAK,CAAC,GACzB,oBAAoB,CAAC;AAmEzB,eAAO,MAAM,sBAAsB,GACjC,SAAS,aAAa,KACrB,MAEF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,aAiDhD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,OAAO,KACb,qBA+BF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,YAAY,qBAAqB,KAChC,KAYF,CAAC"}

package/dist/protocol.js

@@ -84,8 +84,8 @@ export const parseBridgeMessage = (raw) => {
             readDeviceDescriptor(parsed.device);
             return parsed;
         }
-        case 'ping':
-        case 'pong': {
+        case 'js-probe':
+        case 'js-probe-ack': {
             readNumber(parsed.id, 'id');
             return parsed;
         }

package/dist/rpc-peer.d.ts

@@ -1,5 +1,7 @@
 import { type BridgeControlMessage } from './protocol.js';
-import type { RpcTransport } from './transport.js';
+export type RpcTransport = {
+    send: (message: string) => void;
+};
 type RpcMethod = {
     bivarianceHack(...args: unknown[]): unknown;
 }['bivarianceHack'];

package/dist/rpc-peer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-peer.d.ts","sourceRoot":"","sources":["../src/rpc-peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,KAAK,SAAS,GAAG;IACf,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CAC7C,CAAC,gBAAgB,CAAC,CAAC;AACpB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAU5C,MAAM,MAAM,OAAO,CACjB,MAAM,SAAS,UAAU,EACzB,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAC5B;IACF,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAC7B,MAAM,EAAE,CAAC,EACT,GAAG,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAC3B,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACrE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,KAAK,SAAS,UAAU,EACxB,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAC5B;IACF,YAAY,EAAE,KAAK,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IACnF,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC;CACjE,CAAC;AAMF,eAAO,MAAM,aAAa,GACxB,KAAK,SAAS,UAAU,EACxB,MAAM,SAAS,UAAU,EACzB,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAE9B,SAAS,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,KAC1C,OAAO,CAAC,MAAM,EAAE,KAAK,CA0KvB,CAAC"}
+{"version":3,"file":"rpc-peer.d.ts","sourceRoot":"","sources":["../src/rpc-peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CAC7C,CAAC,gBAAgB,CAAC,CAAC;AACpB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAU5C,MAAM,MAAM,OAAO,CACjB,MAAM,SAAS,UAAU,EACzB,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAC5B;IACF,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAC7B,MAAM,EAAE,CAAC,EACT,GAAG,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAC3B,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACrE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,KAAK,SAAS,UAAU,EACxB,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAC5B;IACF,YAAY,EAAE,KAAK,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IACnF,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC;CACjE,CAAC;AAMF,eAAO,MAAM,aAAa,GACxB,KAAK,SAAS,UAAU,EACxB,MAAM,SAAS,UAAU,EACzB,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAE9B,SAAS,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,KAC1C,OAAO,CAAC,MAAM,EAAE,KAAK,CA0KvB,CAAC"}

package/dist/rpc-peer.js

@@ -139,8 +139,8 @@ export const createRpcPeer = (options) => {
                     return null;
                 }
                 case 'ready':
-                case 'ping':
-                case 'pong':
+                case 'js-probe':
+                case 'js-probe-ack':
                     return message;
             }
         },

package/dist/server.d.ts

@@ -1,8 +1,10 @@
 import { WebSocketServer } from 'ws';
 import type { Server as HttpServer } from 'node:http';
 import type { Server as HttpsServer } from 'node:https';
+import { type AppLivenessOverrides } from './app-liveness.js';
 import type { DeviceDescriptor, BridgeEvents, HarnessContext, TestExecutionOptions, TestSuiteResult } from './shared.js';
 export { AppBridgeDisconnectedError, DeviceNotRespondingError, } from './errors.js';
+export { DEFAULT_APP_LIVENESS_OPTIONS, type AppLivenessOverrides, } from './app-liveness.js';
 export type AppConnection = {
     readonly device: DeviceDescriptor;
     runTests: (path: string, options: TestExecutionOptions) => Promise<TestSuiteResult>;
@@ -25,6 +27,8 @@ type TransportOptions = {
 export type HarnessBridgeOptions = TransportOptions & {
     timeout?: number;
     context: HarnessContext;
+    /** Overrides for the connection check and JS watchdog limits. */
+    liveness?: AppLivenessOverrides;
 };
 export type HarnessBridge = {
     readonly ws: WebSocketServer;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,IAAI,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AAoBxD,OAAO,KAAK,EAGV,gBAAgB,EAChB,YAAY,EAGZ,cAAc,EACd,oBAAoB,EACpB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAKrB,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACpF,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,KAAK,gBAAgB,GACjB;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9F,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC/F,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAsCF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,aAAa,CA4OvB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,IAAI,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AAWxD,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAW3B,OAAO,KAAK,EAGV,gBAAgB,EAChB,YAAY,EAGZ,cAAc,EACd,oBAAoB,EACpB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAK3B,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACpF,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,KAAK,gBAAgB,GACjB;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9F,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC/F,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAsCF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,aAAa,CAgQvB,CAAC"}

package/dist/server.js

@@ -5,15 +5,15 @@ import os from 'node:os';
 import path from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { logger } from '@react-native-harness/tools';
-import { BinaryStore, parseBinaryFrame } from './binary-transfer.js';
+import { receiveBinary } from './binary.js';
 import { AppBridgeDisconnectedError, DeviceNotRespondingError, } from './errors.js';
-import { createHeartbeat } from './heartbeat.js';
+import { createAppLiveness, resolveAppLivenessOptions, } from './app-liveness.js';
 import { matchImageSnapshot } from './image-snapshot.js';
+import { createLink, globalClock, StandardWebSocketConnection, } from './link/index.js';
 import { serializeBridgeMessage } from './protocol.js';
 import { createRpcPeer } from './rpc-peer.js';
-import { createRpcTransport, } from './transport.js';
-import { createNodeWebSocketTransport } from './websocket-server-transport.js';
 export { AppBridgeDisconnectedError, DeviceNotRespondingError, } from './errors.js';
+export { DEFAULT_APP_LIVENESS_OPTIONS, } from './app-liveness.js';
 const bridgeLogger = logger.child('bridge');
 const noop = () => undefined;
 const createWss = (transport) => {
@@ -26,21 +26,24 @@ const createWss = (transport) => {
         ? { server: transport.server, path: transport.path }
         : { noServer: true }));
 };
-const receiveScreenshot = async (binaryStore, reference) => {
-    const data = binaryStore.get(reference.transferId);
-    if (!data) {
-        throw new Error(`Binary data for transfer ${reference.transferId} not found or expired`);
+const receiveScreenshot = async (link, reference) => {
+    const data = await receiveBinary(link, reference.channelId);
+    if (data.length !== reference.size) {
+        throw new Error(`Screenshot transfer ended after ${data.length} of ${reference.size} bytes`);
     }
-    binaryStore.delete(reference.transferId);
     const file = path.join(os.tmpdir(), `harness-screenshot-${randomUUID()}.png`);
     await fs.writeFile(file, data);
     return { path: file };
 };
 export const createHarnessBridge = async (options) => {
-    const { timeout, context, ...transportOptions } = options;
+    const { timeout, context, liveness, ...transportOptions } = options;
+    const livenessOptions = resolveAppLivenessOptions(liveness);
     const wss = await createWss(transportOptions);
     bridgeLogger.debug('bridge server ready');
     const emitter = new EventEmitter();
+    // Screenshot files written by this bridge that have not been compared yet.
+    const receivedScreenshots = new Set();
+    const removeScreenshot = (file) => fs.rm(file, { force: true }).catch(() => undefined);
     let currentConnection = null;
     let activeSession = null;
     const connectionWaiters = [];
@@ -50,26 +53,42 @@ export const createHarnessBridge = async (options) => {
             activeSession.disconnect(new AppBridgeDisconnectedError('app-replaced'));
         }
         bridgeLogger.debug('app connected');
-        const transport = createNodeWebSocketTransport(ws);
-        const binaryStore = new BinaryStore();
+        const link = createLink(new StandardWebSocketConnection(ws), {
+            end: 'gateway',
+            clock: globalClock,
+            logger: bridgeLogger.child('link'),
+        });
         let readyConnection = null;
         let disconnected = false;
         let offMessage = noop;
         let offClose = noop;
         let offError = noop;
-        const closeTransport = () => {
-            if (transport.state === 'closing' || transport.state === 'closed') {
-                return;
-            }
-            transport.close(1012);
-        };
         const rpc = createRpcPeer({
             localMethods: {
-                'device.screenshot.receive': (ref) => receiveScreenshot(binaryStore, ref),
-                'test.matchImageSnapshot': (screenshot, testPath, opts) => matchImageSnapshot(screenshot, testPath, opts, context.platform.name),
+                'device.screenshot.receive': async (ref) => {
+                    const file = await receiveScreenshot(link, ref);
+                    receivedScreenshots.add(file.path);
+                    return file;
+                },
+                'test.matchImageSnapshot': async (screenshot, testPath, opts) => {
+                    try {
+                        return await matchImageSnapshot(screenshot, testPath, opts, context.platform.name, context.updateSnapshot ?? 'new');
+                    }
+                    finally {
+                        // Only delete files this bridge created, never a client-supplied path.
+                        if (receivedScreenshots.delete(screenshot.path)) {
+                            await removeScreenshot(screenshot.path);
+                        }
+                    }
+                },
+            },
+            transport: {
+                send: (message) => {
+                    void link.write(message);
+                },
             },
-            transport: createRpcTransport(transport),
             onEvent: (event) => {
+                appLiveness.handleEvent(event);
                 emitter.emit('event', event);
             },
             callTimeoutMs: (method) => method === 'runTests' ? undefined : timeout,
@@ -77,14 +96,24 @@ export const createHarnessBridge = async (options) => {
                 return new DeviceNotRespondingError(functionName, args);
             },
         });
-        const heartbeat = createHeartbeat({
-            sendPing: (id) => {
-                transport.send(serializeBridgeMessage({ type: 'ping', id }));
+        const appLiveness = createAppLiveness({
+            socket: ws,
+            sendProbe: (id) => {
+                void link.write(serializeBridgeMessage({ type: 'js-probe', id }));
             },
-            onTimeout: () => {
-                bridgeLogger.warn('app heartbeat timed out');
-                disconnect(new AppBridgeDisconnectedError('heartbeat-timeout'));
+            onLost: (error) => {
+                if (error.reason === 'connection-lost') {
+                    bridgeLogger.warn('app connection lost (no response to WebSocket ping)');
+                }
+                else {
+                    bridgeLogger.warn('app JS thread unresponsive: %s', error.detail);
+                }
+                disconnect(error);
+                // Neither a half-open socket nor a blocked JS thread completes a
+                // close handshake, so drop the socket instead of waiting for one.
+                ws.terminate();
             },
+            config: livenessOptions,
         });
         const disconnect = (reason) => {
             if (disconnected) {
@@ -95,21 +124,20 @@ export const createHarnessBridge = async (options) => {
             offClose();
             offError();
             bridgeLogger.debug('app disconnected');
-            heartbeat.dispose();
-            binaryStore.dispose();
-            if (activeSession?.transport === transport) {
+            appLiveness.dispose();
+            if (activeSession?.link === link) {
                 activeSession = null;
             }
             if (currentConnection === readyConnection) {
                 currentConnection = null;
             }
             rpc.close(reason ?? new AppBridgeDisconnectedError('app-disconnected'));
-            closeTransport();
+            void link.close();
             if (readyConnection) {
                 emitter.emit('disconnected');
             }
         };
-        activeSession = { disconnect, transport };
+        activeSession = { disconnect, link };
         const handleControlMessage = async (message) => {
             const controlMessage = await rpc.handleMessage(message);
             if (!controlMessage) {
@@ -134,30 +162,13 @@ export const createHarnessBridge = async (options) => {
                     }
                     return;
                 }
-                case 'ping': {
-                    transport.send(serializeBridgeMessage({ type: 'pong', id: controlMessage.id }));
-                    return;
-                }
-                case 'pong': {
-                    heartbeat.notifyPong(controlMessage.id);
+                case 'js-probe-ack': {
+                    appLiveness.handleProbeAck(controlMessage.id);
                     return;
                 }
             }
         };
-        const handleBinaryMessage = (message) => {
-            try {
-                const { transferId, data } = parseBinaryFrame(message);
-                binaryStore.add(transferId, data);
-            }
-            catch (error) {
-                bridgeLogger.warn('failed to parse binary frame: %s', error);
-            }
-        };
-        offMessage = transport.onMessage((message) => {
-            if (typeof message !== 'string') {
-                handleBinaryMessage(message);
-                return;
-            }
+        offMessage = link.onData((message) => {
             void handleControlMessage(message).catch((error) => {
                 bridgeLogger.warn('failed to handle bridge message: %s', error);
                 disconnect(error instanceof Error
@@ -165,14 +176,14 @@ export const createHarnessBridge = async (options) => {
                     : new Error('Received invalid app bridge message'));
             });
         });
-        offClose = transport.onClose(() => {
-            disconnect();
-        });
-        offError = transport.onError((error) => {
+        offError = link.onError((error) => {
             disconnect(error instanceof Error
                 ? error
                 : new AppBridgeDisconnectedError('socket-error'));
         });
+        offClose = link.onClose(() => {
+            disconnect();
+        });
     });
     return {
         get ws() {
@@ -213,6 +224,10 @@ export const createHarnessBridge = async (options) => {
             }
             wss.close();
             emitter.removeAllListeners();
+            for (const file of receivedScreenshots) {
+                void removeScreenshot(file);
+            }
+            receivedScreenshots.clear();
         },
     };
 };

package/dist/shared/test-runner.d.ts

@@ -11,6 +11,7 @@ export type TestResultStatus = 'passed' | 'failed' | 'skipped' | 'todo';
 export type SerializedError = {
     name: string;
     message: string;
+    diff?: string;
     codeFrame?: CodeFrame;
     diagnostics?: {
         pendingPromises?: {
@@ -36,6 +37,11 @@ export type TestRunnerSuiteStartedEvent = {
     type: 'suite-started';
     name: string;
     file: string;
+    /**
+     * The timeout in ms of the suite's `beforeAll`/`afterAll` hooks. Absent
+     * for suites that are skipped or todo.
+     */
+    timeout?: number;
 };
 export type TestRunnerTestStartedEvent = {
     type: 'test-started';
@@ -46,6 +52,11 @@ export type TestRunnerTestStartedEvent = {
     fullName: string;
     startedAt: number;
     declarationMode?: TestDeclarationMode;
+    /**
+     * The test's timeout in ms, covering its `beforeEach`/`afterEach` hooks.
+     * Absent for tests that are skipped or todo.
+     */
+    timeout?: number;
 };
 export type TestRunnerTestFinishedEvent = {
     type: 'test-finished';

package/dist/shared/test-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../src/shared/test-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE;QACZ,eAAe,CAAC,EAAE;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,KAAK,CAAC;gBACX,EAAE,EAAE,MAAM,CAAC;gBACX,SAAS,EAAE,MAAM,CAAC;gBAClB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,0BAA0B,GAC1B,2BAA2B,GAC3B,0BAA0B,GAC1B,2BAA2B,GAC3B,2BAA2B,GAC3B,4BAA4B,CAAC;AAEjC,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC"}
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../src/shared/test-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE;QACZ,eAAe,CAAC,EAAE;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,KAAK,CAAC;gBACX,EAAE,EAAE,MAAM,CAAC;gBACX,SAAS,EAAE,MAAM,CAAC;gBAClB,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,0BAA0B,GAC1B,2BAA2B,GAC3B,0BAA0B,GAC1B,2BAA2B,GAC3B,2BAA2B,GAC3B,4BAA4B,CAAC;AAEjC,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/dist/shared.d.ts

@@ -96,7 +96,8 @@ export type BridgeClientFunctions = {
 };
 export type BinaryDataReference = {
     type: 'binary';
-    transferId: number;
+    /** The link channel carrying the bytes. */
+    channelId: string;
     size: number;
     mimeType: 'image/png';
 };
@@ -111,7 +112,10 @@ export type BridgeServerFunctions = {
         message: string;
     }>;
 };
+export type SnapshotUpdateState = 'all' | 'new' | 'none';
 export type HarnessContext = {
     platform: HarnessPlatform;
+    /** Jest's snapshot update state; when absent, a missing image snapshot is written. */
+    updateSnapshot?: SnapshotUpdateState;
 };
 //# sourceMappingURL=shared.d.ts.map