@heojeongbo/wirestage 0.0.0-stage → 0.1.1

package/dist/widgets/stage/lib/page-runtime.js

@@ -0,0 +1,247 @@
+/**
+ * The page half of the page host. Everything in this file that is exported as
+ * a function runs INSIDE the page: it is serialized with `toString()`, so it is
+ * self-contained — no imports, no references to module scope.
+ */
+/**
+ * Install every module, batch what they emit, and answer Node's flushes and
+ * commands.
+ *
+ * Batching is what keeps a 60 Hz channel cheap: one binding call per flush
+ * window instead of one per message. The first entry after a quiet spell is
+ * not held back, though — it leaves at once, so it reaches Node ahead of a
+ * request the page makes right after it and the two land on the timeline in
+ * the order they happened.
+ *
+ * `flush()` returns the binding's promise, so a Node-side `evaluate(flush)`
+ * resolves only after Node has appended the entries: a read that flushes
+ * first sees everything the page recorded before it.
+ *
+ * Nothing the runtime does throws into the page's own code: a module whose
+ * handler throws is reported to Node, and a binding that has been taken away
+ * makes the runtime step aside.
+ */
+export function pageRuntime(scope, init, installers) {
+    scope["__wirestage"] ??= {};
+    const root = scope["__wirestage"];
+    const bind = scope[init.binding];
+    // Init scripts run again in every frame and on every navigation; a second
+    // run in the same realm would double every entry.
+    if (root[init.binding] !== undefined || typeof bind !== "function")
+        return;
+    const send = bind;
+    const queue = [];
+    /** Set once the runtime steps aside: a module still emitting talks to nobody. */
+    let detached = false;
+    let timer;
+    /** When the last batch left; far enough back that the first entry is not held. */
+    let sentAt = Number.NEGATIVE_INFINITY;
+    const commands = new Map();
+    const stateHandlers = new Map();
+    const detachHandlers = [];
+    const now = () => performance.timeOrigin + performance.now();
+    /** Undo every module's hooks, newest first: stacked hooks come off in order. */
+    const unhook = () => {
+        for (const { module, undo } of detachHandlers.splice(0).reverse()) {
+            try {
+                undo();
+            }
+            catch (error) {
+                // One module failing to undo must not keep the rest hooked.
+                report(module, "onDetach", error);
+            }
+        }
+        delete root[init.binding];
+    };
+    /**
+     * Send through the binding. Playwright's throws, synchronously, once it
+     * has been removed — in a document the stage's detach did not reach, one
+     * that loaded while the stage was detaching. Thrown on from `emit`, that
+     * would fail the app's own call (`RTCDataChannel.send()`) or surface as a
+     * page error; nothing the runtime holds can reach Node any more, so it
+     * steps aside instead, putting back what the modules wrapped.
+     */
+    const post = (message) => {
+        try {
+            return send(message);
+        }
+        catch {
+            detached = true;
+            queue.length = 0;
+            unhook();
+            return Promise.resolve(undefined);
+        }
+    };
+    /** Tell Node a module's handler threw, so it is logged against the module. */
+    const report = (module, handler, error) => {
+        // Stepping aside for want of a binding: there is nobody left to tell.
+        if (detached)
+            return;
+        post({ type: "failure", module, handler, error: String(error) }).catch(() => { });
+    };
+    const flush = () => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        if (queue.length === 0)
+            return Promise.resolve(undefined);
+        sentAt = now();
+        return post({ type: "entries", entries: queue.splice(0, queue.length) });
+    };
+    const schedule = () => {
+        const wait = sentAt + init.flushMs - now();
+        if (wait <= 0) {
+            flush().catch(() => { });
+            return;
+        }
+        timer ??= setTimeout(() => {
+            timer = undefined;
+            flush().catch(() => { });
+        }, wait);
+    };
+    const encode = (bytes) => {
+        let binary = "";
+        // Chunked: spreading a large array into fromCharCode overflows the stack.
+        for (let i = 0; i < bytes.length; i += 0x8000)
+            binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+        return btoa(binary);
+    };
+    const decode = (text) => {
+        const binary = atob(text);
+        const out = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++)
+            out[i] = binary.charCodeAt(i);
+        return out;
+    };
+    /** Run each of a module's state handlers, whatever the others do; return what threw. */
+    const applyState = (module, state) => {
+        const failures = [];
+        for (const handler of stateHandlers.get(module) ?? [])
+            try {
+                handler(state);
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        return failures;
+    };
+    for (const module of init.modules) {
+        const install = installers[module.id];
+        if (install === undefined)
+            continue;
+        const emit = (entry) => {
+            if (detached)
+                return;
+            queue.push({ module: module.id, entry });
+            schedule();
+        };
+        try {
+            install({
+                window: scope,
+                config: module.config,
+                emit,
+                now,
+                encode,
+                decode,
+                onCommand: (op, handler) => {
+                    commands.set(`${module.id}\u0000${op}`, handler);
+                },
+                onState: (handler) => {
+                    const list = stateHandlers.get(module.id) ?? [];
+                    list.push(handler);
+                    stateHandlers.set(module.id, list);
+                },
+                onDetach: (handler) => {
+                    detachHandlers.push({ module: module.id, undo: handler });
+                },
+            });
+        }
+        catch (error) {
+            // A broken module must not take the page down with it: an entry puts
+            // the failure on its timeline, and Node logs it against the module.
+            emit({ type: "error", at: now(), text: String(error) });
+            report(module.id, "install", error);
+        }
+    }
+    const handle = {
+        flush,
+        command(module, op, args) {
+            if (op === "__state") {
+                // Every handler gets the state; the command still fails when one
+                // threw, so the `refresh()` that sent it says which module broke.
+                const failures = applyState(module, args);
+                if (failures.length > 0)
+                    throw failures[0];
+                return true;
+            }
+            const handler = commands.get(`${module}\u0000${op}`);
+            return handler === undefined ? undefined : handler(args);
+        },
+        detach() {
+            unhook();
+            // After the undos: what they emit still leaves with the last flush.
+            detached = true;
+            return flush();
+        },
+    };
+    root[init.binding] = handle;
+    // Chromium loses a binding call made from `pagehide` when the main frame
+    // navigates — the document is gone before Node hears of it — while one
+    // made from `beforeunload` still arrives. `pagehide` stays for the ways
+    // out that fire no `beforeunload`: a page closed, an iframe removed.
+    for (const type of ["beforeunload", "pagehide"])
+        scope.addEventListener(type, () => {
+            flush().catch(() => { });
+        });
+    post({ type: "hello" }).then((states) => {
+        const byModule = (states ?? {});
+        for (const module of stateHandlers.keys())
+            if (byModule[module] !== undefined)
+                // No call to fail: Node hears of each failure, and the
+                // modules after this one still get their state.
+                for (const error of applyState(module, byModule[module]))
+                    report(module, "onState", error);
+    }, () => { });
+}
+/** Flush one frame's runtime. Runs in the page via `frame.evaluate`. */
+export function flushRuntime(binding) {
+    const root = globalThis["__wirestage"];
+    return root?.[binding]?.flush();
+}
+/** Detach one frame's runtime. Runs in the page via `frame.evaluate`. */
+export function detachRuntime(binding) {
+    const root = globalThis["__wirestage"];
+    return root?.[binding]?.detach();
+}
+/**
+ * Run one command in one frame's runtime. Runs in the page via
+ * `frame.evaluate`. Undefined when the frame has no runtime (a document the
+ * init script never ran in); otherwise the handler's answer, or its failure
+ * as text — an exception would cross back to Node as a rejected evaluate,
+ * indistinguishable from a frame that went away.
+ */
+export function commandRuntime(arg) {
+    const root = globalThis["__wirestage"];
+    const handle = root?.[arg.binding];
+    if (handle === undefined)
+        return undefined;
+    return Promise.resolve()
+        .then(() => handle.command(arg.module, arg.op, arg.args))
+        .then((value) => ({ value }), (error) => ({ error: String(error) }));
+}
+/**
+ * The init script: the runtime, then every installer, then the call.
+ *
+ * Wrapped in a scope that defines `__name`: esbuild's `keepNames` (on by
+ * default in tsx) rewrites `const f = () => {}` into `__name(() => {}, "f")`,
+ * so code serialized from a tsx-run process calls a helper the page does not
+ * have, and the whole runtime dies with "__name is not defined".
+ */
+export function buildPageScript(init, installers) {
+    const list = Object.entries(installers)
+        .map(([id, install]) => `${JSON.stringify(id)}: (${install.toString()})`)
+        .join(",\n");
+    return `(() => {\nconst __name = (target) => target;\n(${pageRuntime.toString()})(globalThis, ${JSON.stringify(init)}, {\n${list}\n});\n})();`;
+}
+//# sourceMappingURL=page-runtime.js.map

package/dist/widgets/stage/lib/page-runtime.js.map

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

package/dist/widgets/stage/lib/reads.d.ts

@@ -0,0 +1,21 @@
+import type { Timeline } from "../../../entities/frame/index.js";
+import type { Clock } from "../../../shared/lib/clock/index.js";
+import type { StageCore } from "../model/stage.js";
+export interface ReadsDeps {
+    readonly timeline: Timeline;
+    readonly clock: Clock;
+    /** Flush every page buffer into the timeline. */
+    readonly sync: () => Promise<void>;
+    /** Defaults for `waitFor`, in milliseconds. */
+    readonly wait: {
+        readonly timeout: number;
+        readonly interval: number;
+    };
+}
+export type StageReads = Pick<StageCore, "frames" | "drain" | "mark" | "since" | "between" | "waitFor" | "report">;
+/**
+ * The stage's reads of its timeline. Every one flushes the page buffers
+ * first: that flush is what makes arrival order the order things happened in.
+ */
+export declare function createReads(deps: ReadsDeps): StageReads;
+//# sourceMappingURL=reads.d.ts.map

package/dist/widgets/stage/lib/reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,QAAQ,EACR,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AASD,MAAM,MAAM,UAAU,GAAG,IAAI,CAC5B,SAAS,EACT,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CACxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAmFvD"}

package/dist/widgets/stage/lib/reads.js

@@ -0,0 +1,97 @@
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+/**
+ * Frames a report holds unless asked otherwise. A report is read from its
+ * end, and an unbounded one grows with the test: a long run would attach
+ * tens of megabytes, or fail to serialize at all.
+ */
+const REPORT_LIMIT = 1_000;
+/**
+ * The stage's reads of its timeline. Every one flushes the page buffers
+ * first: that flush is what makes arrival order the order things happened in.
+ */
+export function createReads(deps) {
+    const { timeline, clock, sync } = deps;
+    const drainCursor = timeline.cursor();
+    const requireMarker = (name) => {
+        const marker = timeline.marker(name);
+        if (marker === undefined)
+            throw new WirestageError("INVALID_ARGUMENT", timeline.evicted > 0
+                ? `no marker "${name}" on the timeline: it was never placed, or it was among the ${timeline.evicted} frame(s) dropped at capacity`
+                : `no marker "${name}" on the timeline; place one with stage.mark("${name}")`);
+        return marker;
+    };
+    return {
+        async frames(filter) {
+            await sync();
+            return timeline.frames(filter);
+        },
+        async drain(filter) {
+            await sync();
+            return drainCursor.take(filter);
+        },
+        async mark(name, meta) {
+            await sync();
+            return timeline.append({
+                protocol: "wirestage",
+                kind: "marker",
+                direction: "none",
+                endpoint: name,
+                source: "test",
+                ...(meta === undefined ? {} : { meta }),
+            });
+        },
+        async since(marker, filter) {
+            await sync();
+            const after = requireMarker(marker).seq;
+            return timeline.frames({
+                ...filter,
+                after: Math.max(after, filter?.after ?? 0),
+            });
+        },
+        async between(from, to, filter) {
+            await sync();
+            const start = requireMarker(from).seq;
+            const end = requireMarker(to).seq;
+            const where = filter?.where;
+            return timeline.frames({
+                ...filter,
+                after: Math.max(start, filter?.after ?? 0),
+                where: (frame) => frame.seq < end && (where === undefined || where(frame)),
+            });
+        },
+        async waitFor(filter, options = {}) {
+            const count = options.count ?? 1;
+            const timeout = options.timeout ?? deps.wait.timeout;
+            const interval = options.interval ?? deps.wait.interval;
+            const deadline = clock.now() + timeout;
+            for (;;) {
+                await sync();
+                const found = timeline.frames(filter);
+                if (found.length >= count)
+                    return found;
+                const remaining = deadline - clock.now();
+                if (remaining <= 0)
+                    throw new WirestageError("TIMEOUT", `waited ${timeout} ms for ${count} frame(s) matching ${describeFilter(filter)}; ${found.length} matched. Last frames:\n${timeline.format(undefined, { limit: 20 })}`, { details: { count, matched: found.length, timeout } });
+                await clock.sleep(Math.min(interval, remaining));
+            }
+        },
+        report(filter, options = {}) {
+            const limit = options.limit ?? REPORT_LIMIT;
+            return {
+                snapshot: timeline.snapshot(filter, { limit }),
+                text: timeline.format(filter, { limit }),
+            };
+        },
+    };
+}
+/** A filter as JSON, with RegExps and callbacks spelled out instead of lost. */
+function describeFilter(filter) {
+    return JSON.stringify(filter, (_key, value) => {
+        if (value instanceof RegExp)
+            return value.toString();
+        if (typeof value === "function")
+            return "[function]";
+        return value;
+    });
+}
+//# sourceMappingURL=reads.js.map

package/dist/widgets/stage/lib/reads.js.map

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

package/dist/widgets/stage/lib/response-stream.d.ts

@@ -0,0 +1,23 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ResponseStream, StreamEnd } from "../../../entities/plugin/index.js";
+/** A stream as the stage serves it: the rule's end of it, and the stage's. */
+export interface ServedStream {
+    /** What the rule writes. */
+    readonly stream: ResponseStream;
+    /** The stub asked for the end, and `closed` is on its way. */
+    readonly closing: boolean;
+    /**
+     * The rule writing the stream failed: answer 500 with `body` while
+     * nothing has gone out, and cut the connection after. False when the
+     * response was over first — ended, cut, or let go of by the page.
+     */
+    fail(body: string): boolean;
+}
+/**
+ * A Node response as the stream a rule writes: the adapter between the
+ * stream server's sockets and the plugin contract, which knows nothing of
+ * Node. `onClose` hears how the response ended before `closed` resolves, so
+ * whoever awaits `closed` finds the end already on record.
+ */
+export declare function createResponseStream(request: IncomingMessage, response: ServerResponse, onClose: (end: StreamEnd, failed: boolean) => void): ServedStream;
+//# sourceMappingURL=response-stream.d.ts.map

package/dist/widgets/stage/lib/response-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-stream.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/response-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EAEf,cAAc,EACd,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EACX,cAAc,EACd,SAAS,EACT,MAAM,mCAAmC,CAAC;AAK3C,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAChD,YAAY,CAoGd"}

package/dist/widgets/stage/lib/response-stream.js

@@ -0,0 +1,108 @@
+import { createDeferred } from "../../../shared/lib/async/index.js";
+import { toBytes } from "../../../shared/lib/bytes/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+/**
+ * A Node response as the stream a rule writes: the adapter between the
+ * stream server's sockets and the plugin contract, which knows nothing of
+ * Node. `onClose` hears how the response ended before `closed` resolves, so
+ * whoever awaits `closed` finds the end already on record.
+ */
+export function createResponseStream(request, response, onClose) {
+    let state = "open";
+    let failed = false;
+    const closed = createDeferred();
+    response.once("close", () => {
+        // Not ended and not cut: the page let go of it.
+        const end = state === "open" ? "cancelled" : state;
+        onClose(end, failed);
+        closed.resolve(end);
+    });
+    /** The stream server's own headers (CORS, `connection`), before the rule's. */
+    const own = Object.entries(response.getHeaders());
+    /** Back to those: what a rule's head set is gone, what it replaced is back. */
+    const restore = () => {
+        for (const name of response.getHeaderNames())
+            response.removeHeader(name);
+        for (const [name, value] of own)
+            response.setHeader(name, value);
+    };
+    /**
+     * Whether a write can reach the page. Node drops a write — callback and
+     * all — into a socket destroyed or closed for writing, which is what the
+     * page letting go leaves, well before the response reports its close.
+     */
+    const writable = () => state === "open" && response.socket?.writable === true;
+    const requestHeaders = {};
+    for (const [name, value] of Object.entries(request.headers))
+        requestHeaders[name] = String(value);
+    return {
+        stream: {
+            requestHeaders,
+            head(status, headers = {}) {
+                // Node checks a status only as the head goes out, and refused by
+                // `end()` it leaves the response broken: a 500 after it has no body.
+                if (!Number.isInteger(status) || status < 100 || status > 999)
+                    throw new WirestageError("INVALID_ARGUMENT", `a response status is an integer from 100 to 999, got ${status}`);
+                // Kept off the wire until the first write or flush, so a rule that
+                // fails before then can still be answered with its 500.
+                restore();
+                response.statusCode = status;
+                for (const [name, value] of Object.entries(headers)) {
+                    // The stream server's to say: one response per connection.
+                    if (name.toLowerCase() === "connection")
+                        continue;
+                    // Several values, one per line (`set-cookie`): Node sends a
+                    // header line for each, and refuses a value with a newline.
+                    const values = value.split("\n");
+                    response.setHeader(name, values.length > 1 ? values : value);
+                }
+            },
+            flush() {
+                response.flushHeaders();
+            },
+            write(chunk) {
+                return new Promise((resolve, reject) => {
+                    if (!writable()) {
+                        reject(new WirestageError("CLOSED", "the response stream is closed"));
+                        return;
+                    }
+                    response.write(toBytes(chunk), (error) => error ? reject(error) : resolve());
+                });
+            },
+            async end() {
+                if (writable()) {
+                    state = "ended";
+                    response.end();
+                }
+                await closed.promise;
+            },
+            cut() {
+                if (!writable())
+                    return;
+                state = "cut";
+                response.destroy();
+            },
+            closed: closed.promise,
+        },
+        get closing() {
+            return state !== "open" && !closed.settled;
+        },
+        fail(body) {
+            if (!writable())
+                return false;
+            failed = true;
+            if (response.headersSent) {
+                state = "cut";
+                response.destroy();
+                return true;
+            }
+            state = "ended";
+            restore();
+            response
+                .writeHead(500, { "content-type": "text/plain; charset=utf-8" })
+                .end(body);
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=response-stream.js.map

package/dist/widgets/stage/lib/response-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-stream.js","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/response-stream.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAgBrE;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAAwB,EACxB,QAAwB,EACxB,OAAkD;IAElD,IAAI,KAAK,GAA6B,MAAM,CAAC;IAC7C,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,MAAM,GAAG,cAAc,EAAa,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QAC3B,gDAAgD;QAChD,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;QACnD,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,+EAA+E;IAC/E,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,+EAA+E;IAC/E,MAAM,OAAO,GAAG,GAAG,EAAE;QACpB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,cAAc,EAAE;YAAE,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC1E,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG;YAC9B,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,KAA2B,CAAC,CAAC;IACxD,CAAC,CAAC;IACF;;;;OAIG;IACH,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,KAAK,KAAK,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC9E,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1D,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO;QACN,MAAM,EAAE;YACP,cAAc;YACd,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE;gBACxB,iEAAiE;gBACjE,qEAAqE;gBACrE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,GAAG;oBAC5D,MAAM,IAAI,cAAc,CACvB,kBAAkB,EAClB,wDAAwD,MAAM,EAAE,CAChE,CAAC;gBACH,mEAAmE;gBACnE,wDAAwD;gBACxD,OAAO,EAAE,CAAC;gBACV,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;gBAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBACrD,2DAA2D;oBAC3D,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY;wBAAE,SAAS;oBAClD,4DAA4D;oBAC5D,4DAA4D;oBAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACjC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC9D,CAAC;YACF,CAAC;YACD,KAAK;gBACJ,QAAQ,CAAC,YAAY,EAAE,CAAC;YACzB,CAAC;YACD,KAAK,CAAC,KAAK;gBACV,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC5C,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;wBACjB,MAAM,CACL,IAAI,cAAc,CAAC,QAAQ,EAAE,+BAA+B,CAAC,CAC7D,CAAC;wBACF,OAAO;oBACR,CAAC;oBACD,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CACxC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CACjC,CAAC;gBACH,CAAC,CAAC,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,GAAG;gBACR,IAAI,QAAQ,EAAE,EAAE,CAAC;oBAChB,KAAK,GAAG,OAAO,CAAC;oBAChB,QAAQ,CAAC,GAAG,EAAE,CAAC;gBAChB,CAAC;gBACD,MAAM,MAAM,CAAC,OAAO,CAAC;YACtB,CAAC;YACD,GAAG;gBACF,IAAI,CAAC,QAAQ,EAAE;oBAAE,OAAO;gBACxB,KAAK,GAAG,KAAK,CAAC;gBACd,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpB,CAAC;YACD,MAAM,EAAE,MAAM,CAAC,OAAO;SACtB;QACD,IAAI,OAAO;YACV,OAAO,KAAK,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,IAAI;YACR,IAAI,CAAC,QAAQ,EAAE;gBAAE,OAAO,KAAK,CAAC;YAC9B,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC1B,KAAK,GAAG,KAAK,CAAC;gBACd,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,IAAI,CAAC;YACb,CAAC;YACD,KAAK,GAAG,OAAO,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,QAAQ;iBACN,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC;iBAC/D,GAAG,CAAC,IAAI,CAAC,CAAC;YACZ,OAAO,IAAI,CAAC;QACb,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/widgets/stage/lib/socket-router.d.ts

@@ -0,0 +1,25 @@
+import type { Timeline } from "../../../entities/frame/index.js";
+import type { SocketRouter } from "../../../entities/plugin/index.js";
+import type { ScopedLogger } from "../../../shared/lib/logger/index.js";
+import type { AttachedContext } from "./attached-context.js";
+export interface SocketRouterDeps {
+    readonly timeline: Timeline;
+    readonly log: ScopedLogger;
+    readonly correlation: () => string;
+}
+export interface SocketRouterEngine extends SocketRouter {
+    attach(attachment: AttachedContext): Promise<void>;
+    detach(attachment: AttachedContext): void;
+}
+/**
+ * Turns WebSocket rules into ONE Playwright WebSocket route per attached
+ * context, whose predicate asks the live rule list.
+ *
+ * One route, because Playwright cannot take a WebSocket route out again: a
+ * removed rule, or a detached context, simply stops matching, which sends the
+ * socket to the real server. And not before it is needed, because routing
+ * replaces `WebSocket` in every document of the context — the first rule
+ * installs it, or `prepare()` does at attach.
+ */
+export declare function createSocketRouter(deps: SocketRouterDeps): SocketRouterEngine;
+//# sourceMappingURL=socket-router.d.ts.map

package/dist/widgets/stage/lib/socket-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-router.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/socket-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAEX,YAAY,EAIZ,MAAM,mCAAmC,CAAC;AAI3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACvD,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AA8CD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CA2N7E"}