@heojeongbo/wirestage 0.0.0-stage → 0.1.0

package/dist/features/webrtc/lib/create-webrtc.js

@@ -0,0 +1,123 @@
+import { definePlugin, } from "../../../entities/plugin/index.js";
+import { toBase64, toBytes } from "../../../shared/lib/bytes/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import { installWebRtc } from "./rtc-page-module.js";
+import { toFrame } from "./to-frame.js";
+/**
+ * WebRTC data channels: record what the page sends and receives, drop
+ * messages on one channel while it stays open, and inject messages as the
+ * remote peer.
+ */
+export function webrtc(options = {}) {
+    return definePlugin({
+        name: "webrtc",
+        scope: "Rtc",
+        setup(context) {
+            const { name } = context;
+            const suppressIn = new Map();
+            const blockOut = new Map();
+            const directions = options.record ?? ["in", "out"];
+            const config = {
+                labels: options.labels ?? null,
+                recordIn: directions.includes("in"),
+                recordOut: directions.includes("out"),
+                lifecycle: options.lifecycle ?? true,
+            };
+            context.pages.register({
+                id: name,
+                install: installWebRtc,
+                config,
+                state: () => ({
+                    suppressIn: [...suppressIn.keys()],
+                    blockOut: [...blockOut.keys()],
+                }),
+                receive(entries, origin) {
+                    for (const entry of entries)
+                        context.timeline.append(toFrame(name, entry, origin));
+                },
+            });
+            const refresh = () => context.pages.refresh(name);
+            const hold = (held, label, token) => {
+                const tokens = held.get(label) ?? new Set();
+                tokens.add(token);
+                held.set(label, tokens);
+            };
+            const release = (held, label, token) => {
+                const tokens = held.get(label);
+                // Gone already when `restore` cleared the label first.
+                if (tokens === undefined)
+                    return;
+                tokens.delete(token);
+                if (tokens.size === 0)
+                    held.delete(label);
+            };
+            const api = {
+                async frames(filter = {}) {
+                    await context.sync();
+                    return context.timeline.frames({ ...filter, protocol: name });
+                },
+                async messages(label, messageOptions = {}) {
+                    await context.sync();
+                    return context.timeline.frames({
+                        protocol: name,
+                        kind: "message",
+                        endpoint: label,
+                        ...(messageOptions.direction === undefined
+                            ? {}
+                            : { direction: messageOptions.direction }),
+                    });
+                },
+                async suppress(label, suppressOptions = {}) {
+                    const direction = suppressOptions.direction ?? "in";
+                    const token = Symbol(label);
+                    if (direction !== "out")
+                        hold(suppressIn, label, token);
+                    if (direction !== "in")
+                        hold(blockOut, label, token);
+                    await refresh();
+                    return async () => {
+                        release(suppressIn, label, token);
+                        release(blockOut, label, token);
+                        await refresh();
+                    };
+                },
+                async restore(label) {
+                    if (label === undefined) {
+                        suppressIn.clear();
+                        blockOut.clear();
+                    }
+                    else {
+                        suppressIn.delete(label);
+                        blockOut.delete(label);
+                    }
+                    await refresh();
+                },
+                async inject(label, data, injectOptions = {}) {
+                    const args = typeof data === "string"
+                        ? { label, text: data }
+                        : { label, data: toBase64(toBytes(data)) };
+                    const results = await context.pages.command(name, "inject", args, injectOptions.page === undefined
+                        ? {}
+                        : { page: context.pages.pageId(injectOptions.page) });
+                    return results.reduce((sum, delivered) => sum + Number(delivered), 0);
+                },
+                async waitForChannel(label, waitOptions = {}) {
+                    if (!config.lifecycle)
+                        // It would only ever time out: there is no open frame to wait for.
+                        throw new WirestageError("INVALID_STATE", `waitForChannel("${label}") needs lifecycle frames, and this plugin was created with \`lifecycle: false\``);
+                    const [frame] = await context.waitFor({
+                        protocol: name,
+                        kind: "lifecycle",
+                        endpoint: label,
+                        where: (f) => f.meta["event"] === "open",
+                    }, waitOptions.timeout === undefined
+                        ? {}
+                        : { timeout: waitOptions.timeout });
+                    return frame;
+                },
+            };
+            return { api };
+        },
+    });
+}
+//# sourceMappingURL=create-webrtc.js.map

package/dist/features/webrtc/lib/create-webrtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-webrtc.js","sourceRoot":"","sources":["../../../../src/features/webrtc/lib/create-webrtc.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,GAEZ,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAQrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAKxC;;;;GAIG;AACH,MAAM,UAAU,MAAM,CACrB,UAAyB,EAAE;IAE3B,OAAO,YAAY,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK;QACZ,KAAK,CAAC,OAAO;YACZ,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;YACzB,MAAM,UAAU,GAAiB,IAAI,GAAG,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAiB,IAAI,GAAG,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,MAAM,GAAkB;gBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;gBAC9B,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACnC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACrC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;aACpC,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,QAAQ,CAA8B;gBACnD,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,aAAa;gBACtB,MAAM;gBACN,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;oBACb,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;oBAClC,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;iBAC9B,CAAC;gBACF,OAAO,CAAC,OAAO,EAAE,MAAM;oBACtB,KAAK,MAAM,KAAK,IAAI,OAAO;wBAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;gBACxD,CAAC;aACD,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,CAAC,IAAkB,EAAE,KAAa,EAAE,KAAa,EAAE,EAAE;gBACjE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;gBAC5C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAClB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACzB,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,CAAC,IAAkB,EAAE,KAAa,EAAE,KAAa,EAAE,EAAE;gBACpE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC/B,uDAAuD;gBACvD,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO;gBACjC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACrB,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;oBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC,CAAC;YAEF,MAAM,GAAG,GAAc;gBACtB,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE;oBACvB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/D,CAAC;gBACD,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,EAAE;oBACxC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAC9B,QAAQ,EAAE,IAAI;wBACd,IAAI,EAAE,SAAS;wBACf,QAAQ,EAAE,KAAK;wBACf,GAAG,CAAC,cAAc,CAAC,SAAS,KAAK,SAAS;4BACzC,CAAC,CAAC,EAAE;4BACJ,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,SAAS,EAAE,CAAC;qBAC3C,CAAC,CAAC;gBACJ,CAAC;gBACD,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,EAAE;oBACzC,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,IAAI,IAAI,CAAC;oBACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC5B,IAAI,SAAS,KAAK,KAAK;wBAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;oBACxD,IAAI,SAAS,KAAK,IAAI;wBAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;oBACrD,MAAM,OAAO,EAAE,CAAC;oBAChB,OAAO,KAAK,IAAI,EAAE;wBACjB,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;wBAClC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;wBAChC,MAAM,OAAO,EAAE,CAAC;oBACjB,CAAC,CAAC;gBACH,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,KAAK;oBAClB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACzB,UAAU,CAAC,KAAK,EAAE,CAAC;wBACnB,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAClB,CAAC;yBAAM,CAAC;wBACP,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBACzB,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACxB,CAAC;oBACD,MAAM,OAAO,EAAE,CAAC;gBACjB,CAAC;gBACD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,GAAG,EAAE;oBAC3C,MAAM,IAAI,GACT,OAAO,IAAI,KAAK,QAAQ;wBACvB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;wBACvB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;oBAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAC1C,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,aAAa,CAAC,IAAI,KAAK,SAAS;wBAC/B,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CACrD,CAAC;oBACF,OAAO,OAAO,CAAC,MAAM,CACpB,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,EAC3C,CAAC,CACD,CAAC;gBACH,CAAC;gBACD,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,EAAE;oBAC3C,IAAI,CAAC,MAAM,CAAC,SAAS;wBACpB,mEAAmE;wBACnE,MAAM,IAAI,cAAc,CACvB,eAAe,EACf,mBAAmB,KAAK,kFAAkF,CAC1G,CAAC;oBACH,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,CACpC;wBACC,QAAQ,EAAE,IAAI;wBACd,IAAI,EAAE,WAAW;wBACjB,QAAQ,EAAE,KAAK;wBACf,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM;qBACxC,EACD,WAAW,CAAC,OAAO,KAAK,SAAS;wBAChC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,CACnC,CAAC;oBACF,OAAO,KAAkC,CAAC;gBAC3C,CAAC;aACD,CAAC;YACF,OAAO,EAAE,GAAG,EAAE,CAAC;QAChB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/webrtc/lib/rtc-page-module.d.ts

@@ -0,0 +1,22 @@
+import type { PageModuleEnv } from "../../../entities/plugin/index.js";
+import type { RtcPageConfig, RtcPageState } from "../model/types.js";
+/**
+ * Runs INSIDE the page (serialized): self-contained, `function` declaration.
+ *
+ * Three hooks, each placed so the page's own code is untouched:
+ *
+ * - `RTCDataChannel.prototype.send` is wrapped, so every send on every channel
+ *   is seen as it leaves — the last point the page and a real peer agree on.
+ * - `createDataChannel` is wrapped and the constructor is replaced by one that
+ *   adds a `datachannel` listener first, so every channel — page-created or
+ *   remote-created — gets OUR `message` listener before the page's. Only a
+ *   first listener can `stopImmediatePropagation()` the rest, which is what
+ *   suppression needs; wrapping `onmessage` instead would race the page's own
+ *   assignment of it.
+ * - Injected messages are dispatched as real `MessageEvent`s on the channel,
+ *   so the page's handlers cannot tell them from the peer's.
+ *
+ * All three come off again when the stage detaches.
+ */
+export declare function installWebRtc(env: PageModuleEnv<RtcPageState, RtcPageConfig>): void;
+//# sourceMappingURL=rtc-page-module.d.ts.map

package/dist/features/webrtc/lib/rtc-page-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-page-module.d.ts","sourceRoot":"","sources":["../../../../src/features/webrtc/lib/rtc-page-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAEX,aAAa,EACb,YAAY,EACZ,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,aAAa,CAAC,YAAY,EAAE,aAAa,CAAC,GAC7C,IAAI,CAiKN"}

package/dist/features/webrtc/lib/rtc-page-module.js

@@ -0,0 +1,161 @@
+/**
+ * Runs INSIDE the page (serialized): self-contained, `function` declaration.
+ *
+ * Three hooks, each placed so the page's own code is untouched:
+ *
+ * - `RTCDataChannel.prototype.send` is wrapped, so every send on every channel
+ *   is seen as it leaves — the last point the page and a real peer agree on.
+ * - `createDataChannel` is wrapped and the constructor is replaced by one that
+ *   adds a `datachannel` listener first, so every channel — page-created or
+ *   remote-created — gets OUR `message` listener before the page's. Only a
+ *   first listener can `stopImmediatePropagation()` the rest, which is what
+ *   suppression needs; wrapping `onmessage` instead would race the page's own
+ *   assignment of it.
+ * - Injected messages are dispatched as real `MessageEvent`s on the channel,
+ *   so the page's handlers cannot tell them from the peer's.
+ *
+ * All three come off again when the stage detaches.
+ */
+export function installWebRtc(env) {
+    const win = env.window;
+    const PeerConnection = win.RTCPeerConnection;
+    const DataChannel = win.RTCDataChannel;
+    if (typeof PeerConnection !== "function" || typeof DataChannel !== "function")
+        return;
+    const config = env.config;
+    let suppressIn = new Set();
+    let blockOut = new Set();
+    const open = new Map();
+    const watched = new WeakSet();
+    const injected = new WeakSet();
+    /** Listeners added to the page's channels, to take off on detach. */
+    const unwatch = [];
+    const wanted = (label) => config.labels === null || config.labels.includes(label);
+    const emit = (type, label, data, extra = {}) => {
+        const meta = { label, ...extra };
+        let payload = {};
+        if (typeof data === "string")
+            payload = { text: data };
+        else if (data instanceof ArrayBuffer)
+            payload = { data: env.encode(new Uint8Array(data)) };
+        else if (ArrayBuffer.isView(data))
+            payload = {
+                data: env.encode(new Uint8Array(data.buffer, data.byteOffset, data.byteLength)),
+            };
+        // A Blob would need an async read, which would put it out of order with
+        // the frames around it; it is recorded as skipped instead.
+        else if (data !== undefined)
+            meta["skipped"] = "blob";
+        env.emit({ type, at: env.now(), ...payload, meta });
+    };
+    const watch = (channel) => {
+        if (watched.has(channel))
+            return;
+        watched.add(channel);
+        const label = channel.label;
+        const track = () => {
+            let set = open.get(label);
+            if (set === undefined) {
+                set = new Set();
+                open.set(label, set);
+            }
+            set.add(channel);
+            if (config.lifecycle && wanted(label))
+                emit("open", label, undefined, { id: channel.id });
+        };
+        const untrack = () => {
+            open.get(label)?.delete(channel);
+            if (config.lifecycle && wanted(label))
+                emit("close", label, undefined, { id: channel.id });
+        };
+        const onMessage = (event) => {
+            const mine = injected.has(event);
+            // What the test injects is the point of suppressing the peer:
+            // silence the real one, speak in its place.
+            if (suppressIn.has(label) && !mine) {
+                event.stopImmediatePropagation();
+                if (wanted(label))
+                    emit("suppressed", label, event.data);
+                return;
+            }
+            if (config.recordIn && wanted(label))
+                emit("in", label, event.data, mine ? { injected: true } : {});
+        };
+        if (channel.readyState === "open")
+            track();
+        else
+            channel.addEventListener("open", track, { once: true });
+        channel.addEventListener("close", untrack, { once: true });
+        channel.addEventListener("message", onMessage);
+        unwatch.push(() => {
+            channel.removeEventListener("open", track);
+            channel.removeEventListener("close", untrack);
+            channel.removeEventListener("message", onMessage);
+        });
+    };
+    const send = DataChannel.prototype.send;
+    DataChannel.prototype.send = function wirestageSend(data) {
+        const label = this.label;
+        if (blockOut.has(label)) {
+            if (wanted(label))
+                emit("blocked", label, data);
+            return;
+        }
+        // Recorded once it has left: a send the browser refuses (a channel not
+        // open yet) throws here, and must not land on the timeline as sent.
+        send.call(this, data);
+        if (config.recordOut && wanted(label))
+            emit("out", label, data);
+    };
+    const createDataChannel = PeerConnection.prototype.createDataChannel;
+    PeerConnection.prototype.createDataChannel = function wirestageCreate(label, init) {
+        const channel = createDataChannel.call(this, label, init);
+        watch(channel);
+        return channel;
+    };
+    function WirestagePeerConnection(...args) {
+        // `new.target`, so a page's own subclass still gets its prototype —
+        // and, as with the real constructor, calling it without `new` throws.
+        const connection = Reflect.construct(PeerConnection, args, new.target);
+        connection.addEventListener("datachannel", (event) => watch(event.channel));
+        return connection;
+    }
+    // Same prototype, so `instanceof RTCPeerConnection` and the patched
+    // methods above keep working; statics such as generateCertificate come
+    // through the prototype chain of the function itself.
+    WirestagePeerConnection.prototype = PeerConnection.prototype;
+    Object.setPrototypeOf(WirestagePeerConnection, PeerConnection);
+    win.RTCPeerConnection =
+        WirestagePeerConnection;
+    env.onState((state) => {
+        suppressIn = new Set(state.suppressIn);
+        blockOut = new Set(state.blockOut);
+    });
+    env.onCommand("inject", (args) => {
+        let delivered = 0;
+        for (const channel of open.get(args.label) ?? []) {
+            if (channel.readyState !== "open")
+                continue;
+            let data = args.text;
+            if (data === undefined) {
+                const buffer = env.decode(args.data ?? "").buffer;
+                data = channel.binaryType === "blob" ? new win.Blob([buffer]) : buffer;
+            }
+            const event = new win.MessageEvent("message", { data });
+            injected.add(event);
+            channel.dispatchEvent(event);
+            delivered += 1;
+        }
+        return delivered;
+    });
+    env.onDetach(() => {
+        DataChannel.prototype.send = send;
+        PeerConnection.prototype.createDataChannel = createDataChannel;
+        win.RTCPeerConnection = PeerConnection;
+        for (const undo of unwatch.splice(0))
+            undo();
+        suppressIn = new Set();
+        blockOut = new Set();
+    });
+}
+//# sourceMappingURL=rtc-page-module.js.map

package/dist/features/webrtc/lib/rtc-page-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-page-module.js","sourceRoot":"","sources":["../../../../src/features/webrtc/lib/rtc-page-module.ts"],"names":[],"mappings":"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"}

package/dist/features/webrtc/lib/to-frame.d.ts

@@ -0,0 +1,9 @@
+import type { FrameInit } from "../../../entities/frame/index.js";
+import type { PageEntry, PageSource } from "../../../entities/plugin/index.js";
+/**
+ * One page entry as a frame. A lifecycle frame says which `event` it was, a
+ * fault says its `reason`, as every protocol's do, and an unknown type (the
+ * runtime's own `error`) still lands as a fault instead of vanishing.
+ */
+export declare function toFrame(protocol: string, entry: PageEntry, origin: PageSource): FrameInit;
+//# sourceMappingURL=to-frame.d.ts.map

package/dist/features/webrtc/lib/to-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-frame.d.ts","sourceRoot":"","sources":["../../../../src/features/webrtc/lib/to-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,SAAS,EAGT,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAuB/E;;;;GAIG;AACH,wBAAgB,OAAO,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,UAAU,GAChB,SAAS,CAwBX"}

package/dist/features/webrtc/lib/to-frame.js

@@ -0,0 +1,43 @@
+import { fromBase64 } from "../../../shared/lib/bytes/index.js";
+/** Page entry types, as the page module emits them. */
+const SHAPES = {
+    out: { kind: "message", direction: "out", source: "page" },
+    in: { kind: "message", direction: "in", source: "network" },
+    open: { kind: "lifecycle", direction: "none", source: "page" },
+    close: { kind: "lifecycle", direction: "none", source: "page" },
+    suppressed: { kind: "fault", direction: "in", source: "stub" },
+    blocked: { kind: "fault", direction: "out", source: "stub" },
+};
+/** An entry type nobody declared: the page runtime's own `error`. */
+const BROKEN = { kind: "fault", direction: "none", source: "page" };
+/**
+ * One page entry as a frame. A lifecycle frame says which `event` it was, a
+ * fault says its `reason`, as every protocol's do, and an unknown type (the
+ * runtime's own `error`) still lands as a fault instead of vanishing.
+ */
+export function toFrame(protocol, entry, origin) {
+    const shape = SHAPES[entry.type] ?? BROKEN;
+    const label = entry.meta?.["label"];
+    return {
+        protocol,
+        kind: shape.kind,
+        direction: shape.direction,
+        endpoint: typeof label === "string" ? label : "",
+        // A message the test injected is the test's, not the peer's.
+        source: entry.meta?.["injected"] === true ? "test" : shape.source,
+        at: entry.at,
+        ...(entry.data === undefined
+            ? entry.text === undefined
+                ? {}
+                : { data: entry.text }
+            : { data: fromBase64(entry.data) }),
+        meta: {
+            ...entry.meta,
+            ...(shape.kind === "lifecycle" ? { event: entry.type } : {}),
+            ...(shape.kind === "fault" ? { reason: entry.type } : {}),
+        },
+        page: origin.page,
+        context: origin.context,
+    };
+}
+//# sourceMappingURL=to-frame.js.map

package/dist/features/webrtc/lib/to-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-frame.js","sourceRoot":"","sources":["../../../../src/features/webrtc/lib/to-frame.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAShE,uDAAuD;AACvD,MAAM,MAAM,GAAoC;IAC/C,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;IAC1D,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE;IAC3D,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAC/D,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAC9D,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;CAC5D,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,GAAU,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACtB,QAAgB,EAChB,KAAgB,EAChB,MAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO;QACN,QAAQ;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAChD,6DAA6D;QAC7D,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM;QACjE,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YAC3B,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;gBACzB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YACvB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,EAAE;YACL,GAAG,KAAK,CAAC,IAAI;YACb,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD;QACD,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;KACvB,CAAC;AACH,CAAC"}

package/dist/features/webrtc/model/types.d.ts

@@ -0,0 +1,70 @@
+import type { Frame, FrameFilter } from "../../../entities/frame/index.js";
+import type { PagePort } from "../../../shared/api/playwright/index.js";
+export interface WebRtcOptions {
+    /**
+     * Data channel labels to record. Every channel when omitted. Recording a
+     * 60 Hz channel nobody asserts on costs a base64 copy per frame.
+     */
+    readonly labels?: readonly string[];
+    /** Directions to record. Both by default. */
+    readonly record?: readonly ("in" | "out")[];
+    /** Record channel open/close as lifecycle frames. Default true. */
+    readonly lifecycle?: boolean;
+}
+export type RtcDirection = "in" | "out" | "both";
+export interface WebRtcApi {
+    /** Every WebRTC frame (messages, lifecycle, faults), narrowed by `filter`. */
+    frames(filter?: Omit<FrameFilter, "protocol">): Promise<Frame[]>;
+    /** Messages on one channel, oldest first. */
+    messages(label: string, options?: {
+        readonly direction?: "in" | "out";
+    }): Promise<Frame[]>;
+    /**
+     * Drop messages on `label` while the channel stays open — the lossy-link
+     * case no server-side knob can produce, because the server is behaving.
+     * `in` (the default) swallows what the peer sends the page; `out` swallows
+     * what the page sends. Injected messages still get through, so a test can
+     * silence the real peer and speak in its place.
+     *
+     * Returns a function that undoes exactly this call: the label stays
+     * suppressed for as long as another call on it is still in force.
+     */
+    suppress(label: string, options?: {
+        readonly direction?: RtcDirection;
+    }): Promise<() => Promise<void>>;
+    /** Undo every suppression on `label`, or on every label. */
+    restore(label?: string): Promise<void>;
+    /**
+     * Deliver a message to the page as if the remote peer sent it, on every
+     * open channel with this label (or one page's). Returns how many channels
+     * received it.
+     */
+    inject(label: string, data: Uint8Array | string, options?: {
+        readonly page?: PagePort;
+    }): Promise<number>;
+    /**
+     * Resolve with the channel's open frame. Needs `lifecycle` recording, and
+     * says so at once when it is off.
+     */
+    waitForChannel(label: string, options?: {
+        readonly timeout?: number;
+    }): Promise<Frame>;
+}
+/** The page module's fixed configuration. */
+export interface RtcPageConfig {
+    readonly labels: readonly string[] | null;
+    readonly recordIn: boolean;
+    readonly recordOut: boolean;
+    readonly lifecycle: boolean;
+}
+/** The page module's live state, pushed to every page on change. */
+export interface RtcPageState {
+    readonly suppressIn: readonly string[];
+    readonly blockOut: readonly string[];
+}
+export interface RtcInjectArgs {
+    readonly label: string;
+    readonly data?: string;
+    readonly text?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/webrtc/model/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/features/webrtc/model/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAExE,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,SAAS;IACzB,8EAA8E;IAC9E,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACjE,6CAA6C;IAC7C,QAAQ,CACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAA;KAAE,GAC7C,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACpB;;;;;;;;;OASG;IACH,QAAQ,CACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAA;KAAE,GAC7C,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,MAAM,CACL,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,GACpC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB;;;OAGG;IACH,cAAc,CACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACrC,OAAO,CAAC,KAAK,CAAC,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/features/webrtc/model/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/webrtc/model/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/features/webrtc/model/types.ts"],"names":[],"mappings":""}

package/dist/features/websocket/index.d.ts

@@ -0,0 +1,3 @@
+export { websocket } from "./lib/create-websocket.js";
+export type { WebSocketApi, WebSocketOptions, WsCloseInfo, WsCloseOptions, WsConnection, WsData, WsMessage, WsMock, WsMockOptions, WsProxy, WsProxyConnection, WsProxyOptions, } from "./model/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,MAAM,EACN,SAAS,EACT,MAAM,EACN,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,cAAc,GACd,MAAM,kBAAkB,CAAC"}

package/dist/features/websocket/index.js

@@ -0,0 +1,2 @@
+export { websocket } from "./lib/create-websocket.js";
+//# sourceMappingURL=index.js.map

package/dist/features/websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/features/websocket/lib/create-websocket.d.ts

@@ -0,0 +1,9 @@
+import { type WirePlugin } from "../../../entities/plugin/index.js";
+import type { WebSocketApi, WebSocketOptions } from "../model/types.js";
+/**
+ * WebSockets: fake servers driven from the test, and pass-through proxies
+ * that record and can drop messages. Both are rules on the stage's socket
+ * router, which owns the browser's side of it.
+ */
+export declare function websocket(options?: WebSocketOptions): WirePlugin<"websocket", WebSocketApi>;
+//# sourceMappingURL=create-websocket.d.ts.map

package/dist/features/websocket/lib/create-websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-websocket.d.ts","sourceRoot":"","sources":["../../../../src/features/websocket/lib/create-websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,UAAU,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIxE;;;;GAIG;AACH,wBAAgB,SAAS,CACxB,OAAO,GAAE,gBAAqB,GAC5B,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,CAyBvC"}

package/dist/features/websocket/lib/create-websocket.js

@@ -0,0 +1,34 @@
+import { definePlugin, } from "../../../entities/plugin/index.js";
+import { createMock } from "./mock.js";
+import { createProxy } from "./proxy.js";
+/**
+ * WebSockets: fake servers driven from the test, and pass-through proxies
+ * that record and can drop messages. Both are rules on the stage's socket
+ * router, which owns the browser's side of it.
+ */
+export function websocket(options = {}) {
+    return definePlugin({
+        name: "websocket",
+        scope: "Ws",
+        setup(context) {
+            const { name } = context;
+            if (!options.lazy)
+                context.sockets.prepare();
+            const api = {
+                mock: (url, mockOptions = {}) => createMock(context, name, url, mockOptions),
+                proxy: (url, proxyOptions = {}) => createProxy(context, name, url, proxyOptions),
+                async frames(filter = {}) {
+                    await context.sync();
+                    return context.timeline.frames({
+                        protocol: name,
+                        ...(filter.endpoint === undefined
+                            ? {}
+                            : { endpoint: filter.endpoint }),
+                    });
+                },
+            };
+            return { api };
+        },
+    });
+}
+//# sourceMappingURL=create-websocket.js.map

package/dist/features/websocket/lib/create-websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-websocket.js","sourceRoot":"","sources":["../../../../src/features/websocket/lib/create-websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,GAEZ,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACxB,UAA4B,EAAE;IAE9B,OAAO,YAAY,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,IAAI;QACX,KAAK,CAAC,OAAO;YACZ,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,IAAI;gBAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAiB;gBACzB,IAAI,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,EAAE,EAAE,EAAE,CAC/B,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC;gBAC5C,KAAK,EAAE,CAAC,GAAG,EAAE,YAAY,GAAG,EAAE,EAAE,EAAE,CACjC,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC;gBAC9C,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE;oBACvB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAC9B,QAAQ,EAAE,IAAI;wBACd,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;4BAChC,CAAC,CAAC,EAAE;4BACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;qBACjC,CAAC,CAAC;gBACJ,CAAC;aACD,CAAC;YACF,OAAO,EAAE,GAAG,EAAE,CAAC;QAChB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/websocket/lib/mock.d.ts

@@ -0,0 +1,6 @@
+import type { PluginContext } from "../../../entities/plugin/index.js";
+import type { UrlMatcher } from "../../../shared/lib/match/index.js";
+import type { WsMock, WsMockOptions } from "../model/types.js";
+/** A fake server: every matching socket becomes a connection the test drives. */
+export declare function createMock(context: PluginContext, protocol: string, url: UrlMatcher, options: WsMockOptions): Promise<WsMock>;
+//# sourceMappingURL=mock.d.ts.map

package/dist/features/websocket/lib/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../../src/features/websocket/lib/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAKvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAIX,MAAM,EACN,aAAa,EACb,MAAM,mBAAmB,CAAC;AAQ3B,iFAAiF;AACjF,wBAAsB,UAAU,CAC/B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CAuFjB"}