@volter/browser-cdp 0.1.47 → 0.1.49

package/dist/chromium-face.d.ts

@@ -0,0 +1,24 @@
+import type { ProtocolPeer } from "@volter/almostcdp/core";
+import type { BrowserProgramRunner } from "@volter/browser-runtime/browser-process-host.js";
+import type { BrowserFileSystem } from "@volter/browser-runtime/browser-filesystem.js";
+/** The program names a placed executable resolves to (a path resolves to its basename). */
+export declare const CHROMIUM_FACE_PROGRAMS: readonly ["chrome", "chrome-headless-shell"];
+/**
+ * Chromium as Playwright launches it: `--remote-debugging-pipe`, CDP as
+ * NUL-terminated JSON read from fd 3 and written to fd 4. The face owns no
+ * protocol behaviour of its own; each launch is one browser-level client of
+ * the tab's CDP endpoint, and `Browser.close` ends the process as it ends
+ * Chromium's.
+ */
+export declare function chromiumFaceRunner(attachClient: (peer: ProtocolPeer) => void): BrowserProgramRunner;
+/** The Chromium revisions pinned by each `playwright-core` installed under the given roots. */
+export declare function playwrightChromiumRevisions(filesystem: BrowserFileSystem, roots: readonly string[]): Promise<string[]>;
+/**
+ * Places the face where Playwright's registry looks for each revision, marked
+ * installed and host-validated as the registry marks what it downloads, so
+ * `playwright install` finds it present and a launch resolves the path to the
+ * registered program: the file is the engine's registered-program stub, which
+ * it relays to the host rather than running.
+ */
+export declare function placeChromiumFace(filesystem: BrowserFileSystem, cacheDirectory: string, revisions: readonly string[]): Promise<void>;
+//# sourceMappingURL=chromium-face.d.ts.map

package/dist/chromium-face.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromium-face.d.ts","sourceRoot":"","sources":["../src/chromium-face.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAQvF,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,8CAA+C,CAAC;AAInF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,oBAAoB,CAqDnG;AAUD,+FAA+F;AAC/F,wBAAsB,2BAA2B,CAAC,UAAU,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa5H;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB1I"}

package/dist/chromium-face.js

@@ -0,0 +1,144 @@
+/** Where Playwright's registry keeps each Chromium it launches, under its cache directory. */
+const PLACEMENTS = [
+    { browser: "chromium", directory: "chromium", executable: "chrome-linux64/chrome" },
+    { browser: "chromium-headless-shell", directory: "chromium_headless_shell", executable: "chrome-headless-shell-linux64/chrome-headless-shell" },
+];
+/** The program names a placed executable resolves to (a path resolves to its basename). */
+export const CHROMIUM_FACE_PROGRAMS = ["chrome", "chrome-headless-shell"];
+const encoder = new TextEncoder();
+/**
+ * Chromium as Playwright launches it: `--remote-debugging-pipe`, CDP as
+ * NUL-terminated JSON read from fd 3 and written to fd 4. The face owns no
+ * protocol behaviour of its own; each launch is one browser-level client of
+ * the tab's CDP endpoint, and `Browser.close` ends the process as it ends
+ * Chromium's.
+ */
+export function chromiumFaceRunner(attachClient) {
+    return async (argv, options) => {
+        const name = argv[0]?.slice(argv[0].lastIndexOf("/") + 1) ?? "chrome";
+        if (!argv.includes("--remote-debugging-pipe")) {
+            return { stdout: "", stderr: `${name}: the tab's Chromium is driven over --remote-debugging-pipe only\n`, exitCode: 1 };
+        }
+        const commands = options.descriptors?.[3];
+        const replies = options.descriptors?.[4];
+        if (!commands || !replies) {
+            return { stdout: "", stderr: `${name}: --remote-debugging-pipe needs pipes on fds 3 and 4\n`, exitCode: 1 };
+        }
+        const messageListeners = [];
+        const closeListeners = [];
+        let open = true;
+        let finished;
+        const done = new Promise((resolve) => { finished = resolve; });
+        const end = () => {
+            if (!open)
+                return;
+            open = false;
+            replies.end();
+            for (const listener of closeListeners)
+                listener();
+            finished();
+        };
+        const peer = {
+            get readyState() { return open ? 1 : 3; },
+            send: (data) => { if (open)
+                replies.write(encoder.encode(`${data}\0`)); },
+            close: () => end(),
+            on: ((event, listener) => {
+                if (event === "message")
+                    messageListeners.push(listener);
+                else
+                    closeListeners.push(listener);
+            }),
+        };
+        options.signal?.addEventListener("abort", end, { once: true });
+        attachClient(peer);
+        void (async () => {
+            const decoder = new TextDecoder();
+            let buffered = "";
+            for await (const chunk of commands.input) {
+                buffered += decoder.decode(chunk, { stream: true });
+                for (let boundary = buffered.indexOf("\0"); boundary >= 0; boundary = buffered.indexOf("\0")) {
+                    const message = buffered.slice(0, boundary);
+                    buffered = buffered.slice(boundary + 1);
+                    const closing = browserClose(message);
+                    if (closing !== undefined) {
+                        peer.send(JSON.stringify({ id: closing, result: {} }));
+                        end();
+                        return;
+                    }
+                    for (const listener of messageListeners)
+                        listener(message);
+                    if (!open)
+                        return;
+                }
+            }
+            end();
+        })().catch(end);
+        await done;
+        return { stdout: "", stderr: "", exitCode: 0 };
+    };
+}
+/** The id of a browser-level `Browser.close`, which ends the process rather than reaching the endpoint. */
+function browserClose(message) {
+    try {
+        const parsed = JSON.parse(message);
+        return parsed.method === "Browser.close" && parsed.sessionId === undefined && typeof parsed.id === "number" ? parsed.id : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The Chromium revisions pinned by each `playwright-core` installed under the given roots. */
+export async function playwrightChromiumRevisions(filesystem, roots) {
+    const revisions = new Set();
+    for (const root of roots) {
+        const path = `${root.replace(/\/$/u, "")}/node_modules/playwright-core/browsers.json`;
+        if (!filesystem.existsSync(path))
+            continue;
+        try {
+            const pinned = JSON.parse(await filesystem.readFile(path, "utf8"));
+            for (const entry of pinned.browsers ?? []) {
+                if ((entry.name === "chromium" || entry.name === "chromium-headless-shell") && typeof entry.revision === "string")
+                    revisions.add(entry.revision);
+            }
+        }
+        catch { /* A browsers.json that does not parse pins nothing. */ }
+    }
+    return [...revisions];
+}
+/**
+ * Places the face where Playwright's registry looks for each revision, marked
+ * installed and host-validated as the registry marks what it downloads, so
+ * `playwright install` finds it present and a launch resolves the path to the
+ * registered program: the file is the engine's registered-program stub, which
+ * it relays to the host rather than running.
+ */
+export async function placeChromiumFace(filesystem, cacheDirectory, revisions) {
+    for (const revision of revisions) {
+        for (const placement of PLACEMENTS) {
+            const root = `${cacheDirectory}/${placement.directory}-${revision}`;
+            const executable = `${root}/${placement.executable}`;
+            filesystem.mkdirSync(executable.slice(0, executable.lastIndexOf("/")), { recursive: true });
+            // The registered-program stub the engine relays to the host, which maps
+            // the pathname to the face by its basename.
+            const name = placement.executable.slice(placement.executable.lastIndexOf("/") + 1);
+            const stub = `#!/bin/sh\n# ${name}: runtime-registered program\n`;
+            let current;
+            try {
+                current = filesystem.existsSync(executable) ? await filesystem.readFile(executable, "utf8") : undefined;
+            }
+            catch {
+                current = undefined;
+            }
+            if (current !== stub) {
+                filesystem.writeFileSync(executable, stub);
+                filesystem.chmodSync?.(executable, 0o755);
+            }
+            for (const marker of ["INSTALLATION_COMPLETE", "DEPENDENCIES_VALIDATED"]) {
+                if (!filesystem.existsSync(`${root}/${marker}`))
+                    filesystem.writeFileSync(`${root}/${marker}`, "");
+            }
+        }
+    }
+}
+//# sourceMappingURL=chromium-face.js.map

package/dist/chromium-face.js.map

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

package/dist/preview-browser-host.d.ts

@@ -0,0 +1,42 @@
+import type { DispatcherOptions, ProtocolPeer } from "@volter/almostcdp/core";
+import { type BrowserSandboxBridgeOptions } from "@volter/browser-runtime/browser-sandbox-bridge.js";
+type BrowserContextHost = NonNullable<DispatcherOptions["contextHost"]>;
+type BrowserPageHost = NonNullable<DispatcherOptions["pageHost"]>;
+type SharedBridgeOptions = Omit<BrowserSandboxBridgeOptions, "preview" | "origin" | "nonce" | "port" | "onReady" | "onPreviewLoad">;
+export interface PreviewBrowserHostOptions {
+    /** Where page frames are mounted; the embedding decides how they are shown. */
+    mount: HTMLElement;
+    /** The deployment's sandbox origin: the default context's pages live on it. */
+    sandboxOrigin: string;
+    /** The sandbox bootstrap document every page frame loads. */
+    sandboxPath?: string;
+    /**
+     * The origin a context's label is served at, where the deployment's sandbox
+     * has its own zone of hosts. By default the label is a subdomain of the
+     * sandbox host, which a loopback name (`c-1.localhost`) or a zone apex serves.
+     */
+    contextOrigin?(label: string): string;
+    bridge: SharedBridgeOptions;
+    /** Registers a created page's surface with the endpoint; resolves once the endpoint lists it. */
+    attachSurface(peer: ProtocolPeer, id: string, signal: AbortSignal): Promise<void>;
+}
+export interface PreviewBrowserHost {
+    readonly contextHost: BrowserContextHost;
+    readonly pageHost: BrowserPageHost;
+    dispose(): Promise<void>;
+}
+/**
+ * Browser contexts and pages for the tab's CDP endpoint. A context is its own
+ * origin, a sibling of the sandbox origin, so its storage and cookies are the
+ * browser's own partition; its pages are sandbox frames on that origin, each
+ * lent to the endpoint like the preview. A closed context's origin is emptied
+ * and given to the next context, keeping its service worker: a fresh origin
+ * per context registered a worker per context, and a browser with a debugger
+ * attached keeps every one of them running (a suite run reached about 985
+ * renderers in ten minutes). Every context shares the tab's container: the
+ * servers a page reaches are the project's, as they are for a real browser's
+ * contexts.
+ */
+export declare function createPreviewBrowserHost(options: PreviewBrowserHostOptions): PreviewBrowserHost;
+export {};
+//# sourceMappingURL=preview-browser-host.d.ts.map

package/dist/preview-browser-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-browser-host.d.ts","sourceRoot":"","sources":["../src/preview-browser-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAwB,KAAK,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAI3H,KAAK,kBAAkB,GAAG,WAAW,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;AACxE,KAAK,eAAe,GAAG,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;AAClE,KAAK,mBAAmB,GAAG,IAAI,CAAC,2BAA2B,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,CAAC,CAAC;AAEpI,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,KAAK,EAAE,WAAW,CAAC;IACnB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,iGAAiG;IACjG,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAoM/F"}

package/dist/preview-browser-host.js

@@ -0,0 +1,270 @@
+import { BrowserSandboxBridge } from "@volter/browser-runtime/browser-sandbox-bridge.js";
+import { SANDBOX_CHANNEL } from "@volter/browser-runtime/sandbox-protocol.js";
+import { MessagePortTransport } from "@volter/almostcdp/message-port";
+const CLEAR_TIMEOUT_MS = 15_000;
+/** The page's record of the context origins it made, in its own storage. */
+const ORIGINS_RECORD = "browser-substrate.context-origins";
+/** A context origin in use is held under this lock by the tab using it. */
+const ORIGIN_LOCK = "browser-substrate.context-origin:";
+/** Emptied origins kept for the next contexts; past this, one is emptied for good. */
+const SPARE_ORIGINS = 4;
+/**
+ * Browser contexts and pages for the tab's CDP endpoint. A context is its own
+ * origin, a sibling of the sandbox origin, so its storage and cookies are the
+ * browser's own partition; its pages are sandbox frames on that origin, each
+ * lent to the endpoint like the preview. A closed context's origin is emptied
+ * and given to the next context, keeping its service worker: a fresh origin
+ * per context registered a worker per context, and a browser with a debugger
+ * attached keeps every one of them running (a suite run reached about 985
+ * renderers in ten minutes). Every context shares the tab's container: the
+ * servers a page reaches are the project's, as they are for a real browser's
+ * contexts.
+ */
+export function createPreviewBrowserHost(options) {
+    const sandboxPath = options.sandboxPath ?? "/sandbox.html";
+    const contexts = new Map();
+    /** Closed contexts' origins, each usable once its emptying has succeeded. */
+    const emptied = [];
+    const held = new Map();
+    // A tab that ends before its contexts are closed leaves their origins, each
+    // with its worker registered and its storage, and no page knew them again
+    // (a morning's work left eight). The page records every origin it makes and
+    // holds a lock on each while it lives: a recorded origin whose lock is free
+    // belongs to no tab, and is taken for the next context or emptied for good.
+    const recorded = () => {
+        try {
+            const value = JSON.parse(localStorage.getItem(ORIGINS_RECORD) ?? "[]");
+            return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+        }
+        catch {
+            return [];
+        }
+    };
+    const record = (origins) => {
+        try {
+            localStorage.setItem(ORIGINS_RECORD, JSON.stringify([...new Set(origins)]));
+        }
+        catch { /* storage refused: the origin is still usable */ }
+    };
+    /** Takes an origin's lock, or with `ifFree` only if no tab holds it; resolves whether it is held. */
+    const hold = (origin, ifFree) => new Promise((acquired) => {
+        if (!("locks" in navigator)) {
+            acquired(!ifFree);
+            return;
+        }
+        void navigator.locks.request(`${ORIGIN_LOCK}${origin}`, { ifAvailable: ifFree }, (lock) => {
+            if (!lock) {
+                acquired(false);
+                return undefined;
+            }
+            acquired(true);
+            return new Promise((release) => held.set(origin, release));
+        });
+    });
+    /** Empties an origin for good: its worker too. It leaves the record once that succeeded. */
+    const retire = (origin) => clearOrigin(origin).then(() => { record(recorded().filter((item) => item !== origin)); }, () => undefined).finally(() => { held.get(origin)?.(); held.delete(origin); });
+    /** A closed context's origin, emptied for the next context, or for good past the spares. */
+    const release = (origin) => {
+        if (emptied.length >= SPARE_ORIGINS) {
+            void retire(origin);
+            return;
+        }
+        emptied.push({ origin, ready: clearOrigin(origin, "reuse").then(() => true, () => false) });
+    };
+    let adopting = Promise.resolve();
+    for (const origin of recorded()) {
+        // One at a time: each is a frame of its origin loaded to empty it.
+        adopting = adopting.then(async () => { if (await hold(origin, true))
+            release(origin); });
+    }
+    const pages = new Map();
+    const contextOrigin = () => {
+        const label = `c-${[...crypto.getRandomValues(new Uint8Array(8))].map((byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+        if (options.contextOrigin)
+            return new URL(options.contextOrigin(label)).origin;
+        const base = new URL(options.sandboxOrigin);
+        if (/^[0-9.]+$/u.test(base.hostname) || base.hostname.startsWith("[")) {
+            throw new Error(`Isolated browser contexts need a sandbox host name; ${base.hostname} is an address.`);
+        }
+        // workers.dev serves one level of names: a context host under the
+        // sandbox's own name does not exist there.
+        if (base.hostname.endsWith(".workers.dev")) {
+            throw new Error(`Isolated browser contexts need the sandbox on a zone of its own; ${base.hostname} is a workers.dev host.`);
+        }
+        return `${base.protocol}//${label}.${base.host}`;
+    };
+    const frameFor = (origin, query) => {
+        const frame = document.createElement("iframe");
+        frame.style.cssText = "border:0;width:1280px;height:720px;display:block";
+        const url = new URL(sandboxPath, origin);
+        for (const [key, value] of Object.entries(query))
+            url.searchParams.set(key, value);
+        frame.src = url.href;
+        options.mount.append(frame);
+        return frame;
+    };
+    const closePage = async (id) => {
+        const page = pages.get(id);
+        if (!page)
+            return;
+        pages.delete(id);
+        page.bridge.dispose();
+        page.frame.remove();
+    };
+    /** Empties an origin's storage from a frame of that origin, then removes the frame. */
+    const clearOrigin = async (origin, clear = "1") => {
+        const nonce = crypto.randomUUID();
+        const frame = frameFor(origin, { parentOrigin: location.origin, nonce, clear });
+        try {
+            await new Promise((resolve, reject) => {
+                const timer = setTimeout(() => { cleanup(); reject(new Error(`Clearing ${origin} timed out.`)); }, CLEAR_TIMEOUT_MS);
+                const receive = (event) => {
+                    if (event.origin !== origin || event.source !== frame.contentWindow)
+                        return;
+                    const data = event.data;
+                    if (data?.channel !== SANDBOX_CHANNEL || data.nonce !== nonce)
+                        return;
+                    if (data.type === "cleared") {
+                        cleanup();
+                        resolve();
+                    }
+                    else if (data.type === "error") {
+                        cleanup();
+                        reject(new Error(data.payload?.message ?? `Clearing ${origin} failed.`));
+                    }
+                };
+                const cleanup = () => { clearTimeout(timer); window.removeEventListener("message", receive); };
+                window.addEventListener("message", receive);
+            });
+        }
+        finally {
+            frame.remove();
+        }
+    };
+    const contextHost = {
+        async createContext(context, signal) {
+            if (context.proxyServer !== undefined || context.proxyBypassList !== undefined) {
+                throw new Error("A context's network is the tab's; a per-context proxy is unavailable.");
+            }
+            if (context.originsWithUniversalNetworkAccess?.length) {
+                throw new Error("Universal network access for named origins is unavailable in the tab.");
+            }
+            signal.throwIfAborted();
+            let origin;
+            while (!origin && emptied.length > 0) {
+                const candidate = emptied.shift();
+                if (await candidate.ready)
+                    origin = candidate.origin;
+                // Not emptied: it stays recorded, and a later page tries again.
+                else {
+                    held.get(candidate.origin)?.();
+                    held.delete(candidate.origin);
+                }
+                signal.throwIfAborted();
+            }
+            if (!origin) {
+                origin = contextOrigin();
+                await hold(origin, false);
+                record([...recorded(), origin]);
+            }
+            contexts.set(context.id, { origin });
+        },
+        async disposeContext(id) {
+            const context = contexts.get(id);
+            if (!context)
+                return;
+            await Promise.all([...pages].filter(([, page]) => page.contextId === id).map(([pageId]) => closePage(pageId)));
+            contexts.delete(id);
+            // The context is closed once its pages are, so emptying its storage
+            // (a frame of the origin loaded to do it) goes on after the answer, as
+            // Chromium's closing does not wait on disk: awaited, it held
+            // Playwright's context teardown past a test's timeout. The next context
+            // waits for it instead; an origin that could not be emptied is never
+            // given out again.
+            release(context.origin);
+        },
+    };
+    const pageHost = {
+        async createPage(page, signal) {
+            const context = page.browserContextId === undefined ? undefined : contexts.get(page.browserContextId);
+            if (page.browserContextId !== undefined && !context)
+                throw new Error("No browser context with given id");
+            const origin = context?.origin ?? new URL(options.sandboxOrigin).origin;
+            const nonce = crypto.randomUUID();
+            // A page opens blank, is attached, and is then taken to the guest
+            // server it names under that port's prefix, the way a client's own
+            // first navigation takes it there, as Chromium's page starts blank and
+            // then loads its URL. Opened on the guest's port and navigated before
+            // attaching, a page never attached (a window.open's popup,
+            // Target.createTarget with a URL): creation hung.
+            const opening = guestAddress(page.url);
+            const port = 0;
+            const frame = frameFor(origin, { parentOrigin: location.origin, nonce, port: String(port) });
+            const bridge = new BrowserSandboxBridge({ ...options.bridge, preview: frame, origin, nonce, port });
+            pages.set(page.id, { frame, bridge, ...(page.browserContextId !== undefined ? { contextId: page.browserContextId } : {}) });
+            const abort = () => { void closePage(page.id); };
+            signal.addEventListener("abort", abort, { once: true });
+            try {
+                // The surface registers under the target id before creation resolves.
+                const channel = await bridge.connectProtocol(page.id);
+                const transport = new MessagePortTransport(channel.port);
+                void channel.closed.then((reason) => transport.close(1001, reason));
+                // A page is handed over once its first document has loaded, as
+                // Chromium's is committed before `Target.createTarget` answers: a
+                // client's first navigation otherwise interrupts the frame's own.
+                await bridge.initialPreviewReady;
+                signal.throwIfAborted();
+                await options.attachSurface(transport, page.id, signal);
+                // Attached first, then taken to its URL: a navigation while the
+                // surface attached kept it from ever attaching.
+                if (opening)
+                    await bridge.navigate(`${origin}/__virtual__/${opening.port}${opening.path}`);
+            }
+            catch (cause) {
+                await closePage(page.id);
+                throw cause;
+            }
+            finally {
+                signal.removeEventListener("abort", abort);
+            }
+        },
+        closePage,
+    };
+    return {
+        contextHost,
+        pageHost,
+        async dispose() {
+            await Promise.allSettled([...pages.keys()].map(closePage));
+            const origins = [...contexts.values()].map((context) => context.origin);
+            contexts.clear();
+            await adopting;
+            for (const entry of emptied.splice(0))
+                if (await entry.ready)
+                    origins.push(entry.origin);
+            await Promise.allSettled(origins.map(retire));
+        },
+    };
+}
+/**
+ * The guest server a page is opened on: `about:blank` opens the default port,
+ * a loopback URL opens its own port and path. Anything else is not served in
+ * the tab.
+ */
+function guestAddress(url) {
+    if (url === "" || url === "about:blank")
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid page URL: ${url}`);
+    }
+    const loopback = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "[::1]";
+    if ((parsed.protocol !== "http:" && parsed.protocol !== "https:") || !loopback) {
+        throw new Error(`A page opens on a guest server of the tab; ${url} is not one.`);
+    }
+    const port = Number(parsed.port || (parsed.protocol === "https:" ? 443 : 80));
+    return { port, path: `${parsed.pathname}${parsed.search}${parsed.hash}` };
+}
+//# sourceMappingURL=preview-browser-host.js.map

package/dist/preview-browser-host.js.map

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

package/dist/preview-cdp-endpoint.d.ts

@@ -0,0 +1,84 @@
+import { type ByteSocket } from "@volter/almostcdp/socket";
+import type { ProtocolPeer } from "@volter/almostcdp/core";
+import type { BrowserSandboxBridge } from "@volter/browser-runtime/browser-sandbox-bridge.js";
+import type { BrowserServerBridge } from "@volter/browser-runtime/browser-http.js";
+import type { BrowserVirtualWebSocketRegistry } from "@volter/browser-runtime/browser-virtual-websocket.js";
+import { type PreviewBrowserHostOptions } from "./preview-browser-host.js";
+/** A loopback listener of the tab: WALI's `listenTcp`, a Node container's `listenNet`. */
+export type PreviewCdpListener = (port: number, accept: (socket: ByteSocket) => void) => () => void;
+export interface PreviewCdpPublication {
+    readonly port: number;
+    /** What a client inside the tab passes to `connectOverCDP`. */
+    readonly url: string;
+    /** A browser-level client over a transport the host decodes, such as a launch pipe. */
+    attachClient(peer: ProtocolPeer): void;
+    close(): Promise<void>;
+}
+/**
+ * The preview as a Chrome DevTools Protocol endpoint on a loopback port of the
+ * tab. AlmostCDP serves discovery and the DevTools WebSockets on each accepted
+ * connection; the preview's surface is lent through the authenticated sandbox
+ * bridge and lent again whenever the sandbox document is replaced, which a
+ * client sees as its page target closing and a new one appearing.
+ */
+export declare function publishPreviewCdp(options: {
+    /**
+     * The preview's bridge, which lends the preview as a page target. Without
+     * one the endpoint still serves contexts and pages a client creates, which
+     * is all a launched browser needs.
+     */
+    bridge?: BrowserSandboxBridge;
+    port: number;
+    listen: PreviewCdpListener;
+    targetId?: string;
+    /**
+     * Browser contexts and pages beyond the preview: `Target.createBrowserContext`
+     * and `Target.createTarget` open sandbox frames here. Without it they refuse.
+     */
+    browser?: Omit<PreviewBrowserHostOptions, "attachSurface">;
+    /**
+     * The same endpoint as a server in the tab's port table, so a page of the
+     * tab reaches it and a live tunnel of that port carries it off the machine.
+     */
+    portTable?: {
+        port: number;
+        ports: Pick<BrowserServerBridge, "registerServer" | "unregisterServer">;
+        webSockets: BrowserVirtualWebSocketRegistry;
+    };
+    /**
+     * The endpoint's discovery documents alone (`/json/version`, `/json/list`)
+     * in the tab's port table, where a program's `fetch` to a loopback port
+     * goes: Puppeteer reads `browserURL` so. The WebSocket they name stays on
+     * the listener, which the tab's programs reach and a page of the tab does
+     * not, so a page learns the address and cannot drive the browser.
+     */
+    discoveryTable?: {
+        port: number;
+        ports: Pick<BrowserServerBridge, "registerServer" | "unregisterServer">;
+    };
+    /**
+     * Where a download a page makes is written: the path Playwright names in
+     * its client's filesystem, which is the container's. Without it the
+     * endpoint refuses download policy by name.
+     */
+    downloads?: {
+        write(path: string, bytes: Uint8Array): Promise<void>;
+    };
+    /**
+     * Reads a file a client names by path for a page's file input
+     * (DOM.setFileInputFiles): the client's filesystem, the container's. The
+     * page is given those files' bytes alone. Without it the endpoint refuses
+     * file paths by name.
+     */
+    files?: {
+        read(path: string): Promise<{
+            data: Uint8Array;
+            name?: string;
+            type?: string;
+            lastModified?: number;
+        }>;
+        /** A directory's files by their paths relative to it (a folder upload); undefined for a file. */
+        list?(path: string): Promise<string[] | undefined>;
+    };
+}): PreviewCdpPublication;
+//# sourceMappingURL=preview-cdp-endpoint.d.ts.map

package/dist/preview-cdp-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-cdp-endpoint.d.ts","sourceRoot":"","sources":["../src/preview-cdp-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,UAAU,EAAuB,MAAM,0BAA0B,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,KAAK,EAAE,+BAA+B,EAA4B,MAAM,sDAAsD,CAAC;AACtI,OAAO,EAA4B,KAAK,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAErG,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;AAEpG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;IAC3D;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,kBAAkB,CAAC,CAAC;QAAC,UAAU,EAAE,+BAA+B,CAAA;KAAE,CAAC;IACnJ;;;;;;OAMG;IACH,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,GAAG,kBAAkB,CAAC,CAAA;KAAE,CAAC;IAC3G;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACtE;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,UAAU,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvG,iGAAiG;QACjG,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;KACpD,CAAC;CACH,GAAG,qBAAqB,CAmDxB"}