@floegence/flowersec-core 0.27.0 → 2.0.0

package/dist/proxy/integration.js

@@ -1,350 +1,47 @@
-import { resolveProxyPreset } from "./preset.js";
+import { connect } from "../browser/connectSession.js";
+import { createProxyRuntime } from "./runtime.js";
 import { registerServiceWorkerAndEnsureControl } from "./registerServiceWorker.js";
-import { createProxyRuntime, ensureServiceWorkerRuntimeRegistered } from "./runtime.js";
-import { createProxyServiceWorkerScript } from "./serviceWorker.js";
-function dedupeStrings(values) {
-    const out = [];
-    const seen = new Set();
-    for (const v of values) {
-        const n = String(v ?? "").trim();
-        if (n === "" || seen.has(n))
-            continue;
-        seen.add(n);
-        out.push(n);
-    }
-    return out;
-}
-function parseRepairAttemptFromHref(href, queryKey) {
-    try {
-        const u = new URL(href);
-        const raw = String(u.searchParams.get(queryKey) ?? "").trim();
-        const n = raw === "" ? 0 : Number(raw);
-        if (!Number.isFinite(n) || n < 0)
-            return 0;
-        return Math.min(9, Math.floor(n));
-    }
-    catch {
-        return 0;
-    }
-}
-function buildHrefWithRepairAttempt(href, queryKey, attempt) {
-    const u = new URL(href);
-    u.searchParams.set(queryKey, String(Math.max(0, Math.floor(attempt))));
-    return u.toString();
-}
-function isServiceWorkerScriptPathSuffix(raw, suffix) {
-    const script = String(raw ?? "").trim();
-    if (script === "")
-        return false;
-    const wanted = String(suffix ?? "").trim();
-    if (wanted === "")
-        return false;
+import { registerProxyControllerWindow, } from "./windowBridge.js";
+export async function connectProxyBrowser(lease, options = {}) {
+    const session = await connect(lease, options.connect);
+    let runtime;
     try {
-        const u = new URL(script);
-        return u.pathname.endsWith(wanted);
-    }
-    catch {
-        return script.endsWith(wanted);
-    }
-}
-async function waitForControllerSuffix(suffix, timeoutMs) {
-    const sw = globalThis.navigator?.serviceWorker;
-    if (!sw)
-        return false;
-    const isMatch = () => isServiceWorkerScriptPathSuffix(String(sw.controller?.scriptURL ?? ""), suffix);
-    if (isMatch())
-        return true;
-    const ms = Math.max(0, Math.floor(timeoutMs));
-    return await new Promise((resolve) => {
-        let done = false;
-        let timer = null;
-        const finish = (ok) => {
-            if (done)
-                return;
-            done = true;
-            if (timer != null)
-                window.clearTimeout(timer);
-            sw.removeEventListener("controllerchange", onChange);
-            resolve(ok);
-        };
-        const onChange = () => {
-            if (isMatch())
-                finish(true);
-        };
-        sw.addEventListener("controllerchange", onChange);
-        if (isMatch()) {
-            finish(true);
-            return;
-        }
-        if (ms > 0)
-            timer = window.setTimeout(() => finish(isMatch()), ms);
-    });
-}
-async function uninstallConflictingServiceWorkers(conflicts) {
-    if (conflicts?.uninstallOnMismatch === false)
-        return;
-    const sw = globalThis.navigator?.serviceWorker;
-    if (!sw || typeof sw.getRegistrations !== "function")
-        return;
-    const keep = dedupeStrings(conflicts?.keepScriptPathSuffixes ?? []);
-    const regs = await sw.getRegistrations();
-    for (const reg of regs) {
-        const script = String(reg?.active?.scriptURL ?? reg?.waiting?.scriptURL ?? reg?.installing?.scriptURL ?? "").trim();
-        if (script === "")
-            continue;
-        let shouldKeep = false;
-        for (const suffix of keep) {
-            if (isServiceWorkerScriptPathSuffix(script, suffix)) {
-                shouldKeep = true;
-                break;
-            }
-        }
-        if (shouldKeep)
-            continue;
-        try {
-            await reg.unregister();
-        }
-        catch {
-            // Best effort cleanup.
-        }
-    }
-}
-async function maybeRepairNavigation(opts) {
-    const attempt = parseRepairAttemptFromHref(window.location.href, opts.queryKey);
-    if (attempt >= opts.maxAttempts)
-        return;
-    if (opts.strategy === "reload") {
-        window.location.reload();
-        await new Promise(() => {
-            // keep pending on navigation
+        if (options.serviceWorker !== undefined)
+            await registerServiceWorkerAndEnsureControl(options.serviceWorker);
+        runtime = createProxyRuntime({ session, ...options.runtime });
+        return Object.freeze({
+            session,
+            runtime,
+            dispose: async () => {
+                runtime.dispose();
+                await session.close();
+            },
         });
-        return;
-    }
-    const next = buildHrefWithRepairAttempt(window.location.href, opts.queryKey, attempt + 1);
-    window.location.replace(next);
-    await new Promise(() => {
-        // keep pending on navigation
-    });
-}
-function applyPluginMutations(opts, plugins) {
-    let out = opts;
-    for (const plugin of plugins) {
-        if (!plugin.mutateOptions)
-            continue;
-        out = plugin.mutateOptions(out);
-    }
-    return out;
-}
-function mergeConflictPolicy(base, plugins) {
-    const keep = dedupeStrings([
-        ...(base?.keepScriptPathSuffixes ?? []),
-        ...plugins.flatMap((p) => p.serviceWorkerConflictPolicy?.keepScriptPathSuffixes ?? []),
-    ]);
-    let uninstallOnMismatch = base?.uninstallOnMismatch;
-    for (const p of plugins) {
-        if (p.serviceWorkerConflictPolicy?.uninstallOnMismatch != null) {
-            uninstallOnMismatch = p.serviceWorkerConflictPolicy.uninstallOnMismatch;
-        }
     }
-    if (keep.length === 0 && uninstallOnMismatch == null)
-        return base;
-    const out = {};
-    if (keep.length > 0)
-        out.keepScriptPathSuffixes = keep;
-    if (uninstallOnMismatch != null)
-        out.uninstallOnMismatch = uninstallOnMismatch;
-    return out;
-}
-function shouldIgnoreMismatch(plugins, ctx) {
-    for (const plugin of plugins) {
-        const action = plugin.onControllerMismatch?.(ctx);
-        if (action === "ignore")
-            return true;
+    catch (error) {
+        runtime?.dispose();
+        await session.close().catch(() => undefined);
+        throw error;
     }
-    return false;
 }
-function resolveIntegrationPreset(opts) {
-    if (opts.preset !== undefined)
-        return resolveProxyPreset(opts.preset);
-    return resolveProxyPreset();
-}
-function buildRuntimeOptions(preset, runtime) {
-    return {
-        maxJsonFrameBytes: runtime?.maxJsonFrameBytes ?? preset.limits.max_json_frame_bytes,
-        maxChunkBytes: runtime?.maxChunkBytes ?? preset.limits.max_chunk_bytes,
-        maxBodyBytes: runtime?.maxBodyBytes ?? preset.limits.max_body_bytes,
-        maxWsFrameBytes: runtime?.maxWsFrameBytes ?? preset.limits.max_ws_frame_bytes,
-        ...(runtime?.maxWsBufferedAmountBytes === undefined
-            ? {}
-            : { maxWsBufferedAmountBytes: runtime.maxWsBufferedAmountBytes }),
-        timeoutMs: runtime?.timeoutMs ?? preset.limits.timeout_ms ?? 0,
-        ...(runtime?.maxConcurrentHttpStreams === undefined
-            ? {}
-            : { maxConcurrentHttpStreams: runtime.maxConcurrentHttpStreams }),
-        ...(runtime?.maxQueuedHttpRequests === undefined
-            ? {}
-            : { maxQueuedHttpRequests: runtime.maxQueuedHttpRequests }),
-        ...(runtime?.maxQueuedHttpBodyBytes === undefined
-            ? {}
-            : { maxQueuedHttpBodyBytes: runtime.maxQueuedHttpBodyBytes }),
-        ...(runtime?.pathPolicy === undefined ? {} : { pathPolicy: runtime.pathPolicy }),
-        ...(runtime?.externalOrigin === undefined ? {} : { externalOrigin: runtime.externalOrigin }),
-        ...(runtime?.runtimeRegistrationToken === undefined ? {} : { runtimeRegistrationToken: runtime.runtimeRegistrationToken }),
-    };
-}
-function bindRuntimeGlobal(runtime, key) {
-    const runtimeGlobalKey = String(key ?? "").trim();
-    if (runtimeGlobalKey === "")
-        return null;
-    const target = globalThis;
-    target[runtimeGlobalKey] = runtime;
-    return () => {
-        if (target[runtimeGlobalKey] === runtime) {
-            delete target[runtimeGlobalKey];
-        }
-    };
-}
-export function createProxyIntegrationServiceWorkerScript(opts = {}) {
-    const plugins = opts.plugins ?? [];
-    let scriptOpts = opts.baseOptions ?? {};
-    for (const plugin of plugins) {
-        if (!plugin.extendServiceWorkerScriptOptions)
-            continue;
-        scriptOpts = plugin.extendServiceWorkerScriptOptions(scriptOpts);
-    }
-    const forwarded = dedupeStrings([
-        ...(scriptOpts.forwardFetchMessageTypes ?? []),
-        ...plugins.flatMap((p) => p.forwardFetchMessageTypes ?? []),
-    ]);
-    const keepSuffixes = dedupeStrings([
-        ...(scriptOpts.conflictHints?.keepScriptPathSuffixes ?? []),
-        ...plugins.flatMap((p) => p.serviceWorkerConflictPolicy?.keepScriptPathSuffixes ?? []),
-    ]);
-    const finalOpts = {
-        ...scriptOpts,
-        forwardFetchMessageTypes: forwarded,
-    };
-    if (keepSuffixes.length > 0) {
-        return createProxyServiceWorkerScript({
-            ...finalOpts,
-            conflictHints: { keepScriptPathSuffixes: keepSuffixes },
-        });
-    }
-    if (scriptOpts.conflictHints != null) {
-        return createProxyServiceWorkerScript({
-            ...finalOpts,
-            conflictHints: scriptOpts.conflictHints,
+export async function connectProxyControllerBrowser(lease, options) {
+    const base = await connectProxyBrowser(lease, options);
+    let controller;
+    try {
+        controller = registerProxyControllerWindow({ runtime: base.runtime, ...options.controller });
+        return Object.freeze({
+            session: base.session,
+            runtime: base.runtime,
+            controller,
+            dispose: async () => {
+                controller.dispose();
+                await base.dispose();
+            },
         });
     }
-    return createProxyServiceWorkerScript(finalOpts);
-}
-export async function registerProxyIntegration(input) {
-    const plugins = input.plugins ?? [];
-    const opts = applyPluginMutations(input, plugins);
-    const preset = resolveIntegrationPreset(opts);
-    const runtimeOpts = buildRuntimeOptions(preset, opts.runtime);
-    const runtime = createProxyRuntime({ ...runtimeOpts, client: opts.client });
-    const releaseRuntimeGlobal = bindRuntimeGlobal(runtime, opts.runtimeGlobalKey);
-    const swCfg = opts.serviceWorker;
-    const repairQueryKey = String(swCfg.repair?.queryKey ?? "_flowersec_sw_repair").trim() || "_flowersec_sw_repair";
-    const maxRepairAttempts = Math.max(0, Math.floor(swCfg.repair?.maxAttempts ?? 2));
-    const controllerTimeoutMs = Math.max(0, Math.floor(swCfg.repair?.controllerTimeoutMs ?? 8_000));
-    const strategy = swCfg.repair?.strategy ?? "replace";
-    const conflicts = mergeConflictPolicy(swCfg.conflicts, plugins);
-    const finalScope = String(swCfg.scope ?? "/").trim() || "/";
-    const expectedScriptPathSuffix = String(swCfg.expectedScriptPathSuffix ?? "").trim();
-    await uninstallConflictingServiceWorkers(conflicts);
-    await registerServiceWorkerAndEnsureControl({
-        scriptUrl: swCfg.scriptUrl,
-        scope: finalScope,
-        repairQueryKey,
-        maxRepairAttempts,
-        controllerTimeoutMs,
-    });
-    await ensureServiceWorkerRuntimeRegistered({
-        timeoutMs: controllerTimeoutMs,
-        ...(runtimeOpts.runtimeRegistrationToken === undefined ? {} : { runtimeRegistrationToken: runtimeOpts.runtimeRegistrationToken }),
-    });
-    if (expectedScriptPathSuffix !== "") {
-        const ok = await waitForControllerSuffix(expectedScriptPathSuffix, controllerTimeoutMs);
-        if (!ok) {
-            const actual = String(globalThis.navigator?.serviceWorker?.controller?.scriptURL ?? "").trim();
-            const ctx = {
-                expectedScriptPathSuffix,
-                actualScriptURL: actual,
-                stage: "register",
-            };
-            if (!shouldIgnoreMismatch(plugins, ctx)) {
-                await uninstallConflictingServiceWorkers(conflicts);
-                await maybeRepairNavigation({ queryKey: repairQueryKey, maxAttempts: maxRepairAttempts, strategy });
-                throw new Error("Proxy Service Worker is installed but not controlling this page");
-            }
-        }
+    catch (error) {
+        controller?.dispose();
+        await base.dispose();
+        throw error;
     }
-    const monitorEnabled = swCfg.monitor?.enabled ?? true;
-    const monitorThrottleMs = Math.max(0, Math.floor(swCfg.monitor?.throttleMs ?? 10_000));
-    const sw = globalThis.navigator?.serviceWorker;
-    let monitorHandler = null;
-    let lastMonitorRepairAt = 0;
-    if (monitorEnabled && sw && expectedScriptPathSuffix !== "") {
-        monitorHandler = () => {
-            const actual = String(sw.controller?.scriptURL ?? "").trim();
-            if (isServiceWorkerScriptPathSuffix(actual, expectedScriptPathSuffix))
-                return;
-            const ctx = {
-                expectedScriptPathSuffix,
-                actualScriptURL: actual,
-                stage: "monitor",
-            };
-            if (shouldIgnoreMismatch(plugins, ctx))
-                return;
-            const now = Date.now();
-            if (monitorThrottleMs > 0 && now - lastMonitorRepairAt <= monitorThrottleMs)
-                return;
-            lastMonitorRepairAt = now;
-            void maybeRepairNavigation({ queryKey: repairQueryKey, maxAttempts: maxRepairAttempts, strategy });
-        };
-        sw.addEventListener("controllerchange", monitorHandler);
-    }
-    const ctx = {
-        runtime,
-        options: opts,
-        preset,
-    };
-    for (const plugin of plugins) {
-        await plugin.onRegistered?.(ctx);
-    }
-    return {
-        runtime,
-        dispose: async () => {
-            let firstError = null;
-            if (monitorHandler && sw) {
-                sw.removeEventListener("controllerchange", monitorHandler);
-            }
-            try {
-                runtime.dispose();
-            }
-            catch (error) {
-                firstError = error;
-            }
-            for (const plugin of plugins) {
-                try {
-                    await plugin.onDisposed?.();
-                }
-                catch (error) {
-                    if (firstError == null)
-                        firstError = error;
-                }
-            }
-            try {
-                releaseRuntimeGlobal?.();
-            }
-            catch (error) {
-                if (firstError == null)
-                    firstError = error;
-            }
-            if (firstError != null)
-                throw firstError;
-        },
-    };
 }

package/dist/proxy/registerServiceWorker.d.ts

@@ -5,13 +5,4 @@ export type RegisterServiceWorkerOptions = Readonly<{
     maxRepairAttempts?: number;
     controllerTimeoutMs?: number;
 }>;
-declare function parseRepairAttemptFromHref(href: string, queryKey: string): number;
-declare function buildHrefWithRepairAttempt(href: string, queryKey: string, attempt: number): string;
-declare function buildHrefWithoutRepairQueryParam(href: string, queryKey: string): string;
-export declare function registerServiceWorkerAndEnsureControl(opts: RegisterServiceWorkerOptions): Promise<void>;
-export declare const __testOnly: {
-    parseRepairAttemptFromHref: typeof parseRepairAttemptFromHref;
-    buildHrefWithRepairAttempt: typeof buildHrefWithRepairAttempt;
-    buildHrefWithoutRepairQueryParam: typeof buildHrefWithoutRepairQueryParam;
-};
-export {};
+export declare function registerServiceWorkerAndEnsureControl(options: RegisterServiceWorkerOptions): Promise<void>;

package/dist/proxy/registerServiceWorker.js

@@ -1,116 +1,54 @@
-function parseRepairAttemptFromHref(href, queryKey) {
+function currentAttempt(key) {
     try {
-        const u = new URL(href);
-        const raw = String(u.searchParams.get(queryKey) ?? "").trim();
-        const n = raw ? Number(raw) : 0;
-        if (!Number.isFinite(n) || n < 0)
-            return 0;
-        return Math.min(9, Math.floor(n));
+        const value = Number(new URL(globalThis.location.href).searchParams.get(key) ?? "0");
+        return Number.isSafeInteger(value) && value >= 0 ? value : 0;
     }
     catch {
         return 0;
     }
 }
-function buildHrefWithRepairAttempt(href, queryKey, attempt) {
-    const u = new URL(href);
-    u.searchParams.set(queryKey, String(Math.max(0, Math.floor(attempt))));
-    return u.toString();
+function repairNavigation(key, attempt) {
+    const target = new URL(globalThis.location.href);
+    target.searchParams.set(key, String(attempt));
+    globalThis.location.replace(target.toString());
+    throw new Error("service worker controller navigation started");
 }
-function buildHrefWithoutRepairQueryParam(href, queryKey) {
-    const u = new URL(href);
-    u.searchParams.delete(queryKey);
-    const search = u.searchParams.toString();
-    return u.pathname + (search ? `?${search}` : "") + u.hash;
-}
-function waitForController(timeoutMs) {
-    if (navigator.serviceWorker.controller)
-        return Promise.resolve(true);
-    const ms = Math.max(0, Math.floor(timeoutMs));
-    return new Promise((resolve) => {
-        let done = false;
-        let t = null;
-        function finish(ok) {
-            if (done)
-                return;
-            done = true;
-            if (t != null)
-                window.clearTimeout(t);
-            navigator.serviceWorker.removeEventListener("controllerchange", onChange);
-            resolve(ok);
-        }
-        function onChange() {
-            finish(true);
-        }
-        navigator.serviceWorker.addEventListener("controllerchange", onChange);
-        // Avoid race: controller can become available before/after the listener registration.
-        if (navigator.serviceWorker.controller) {
-            finish(true);
-            return;
-        }
-        if (ms > 0) {
-            t = window.setTimeout(() => finish(Boolean(navigator.serviceWorker.controller)), ms);
-        }
-    });
-}
-// registerServiceWorkerAndEnsureControl registers a Service Worker and ensures the current page load is controlled.
-//
-// In DevTools hard reload flows, the SW may be installed but not control the current page load.
-// When this happens, we perform a limited "soft navigation" repair to recover control.
-export async function registerServiceWorkerAndEnsureControl(opts) {
-    const scriptUrl = String(opts.scriptUrl ?? "").trim();
-    if (!scriptUrl)
-        throw new Error("scriptUrl is required");
-    if (globalThis.navigator?.serviceWorker == null) {
-        throw new Error("service worker is not available in this environment");
+export async function registerServiceWorkerAndEnsureControl(options) {
+    const serviceWorker = globalThis.navigator?.serviceWorker;
+    if (serviceWorker === undefined)
+        throw new Error("service workers are unavailable");
+    const scriptUrl = options.scriptUrl.trim();
+    const scope = options.scope?.trim() || "/";
+    if (scriptUrl === "" || scope === "")
+        throw new TypeError("service worker script and scope are required");
+    const timeoutMs = options.controllerTimeoutMs ?? 8_000;
+    const maxAttempts = options.maxRepairAttempts ?? 2;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 60_000 || !Number.isSafeInteger(maxAttempts) || maxAttempts < 0 || maxAttempts > 5) {
+        throw new TypeError("invalid service worker control policy");
     }
-    const scope = String(opts.scope ?? "/").trim() || "/";
-    const queryKey = String(opts.repairQueryKey ?? "_flowersec_sw_repair").trim() || "_flowersec_sw_repair";
-    const maxRepairAttempts = Math.max(0, Math.floor(opts.maxRepairAttempts ?? 2));
-    const controllerTimeoutMs = Math.max(0, Math.floor(opts.controllerTimeoutMs ?? 2_000));
-    await navigator.serviceWorker.register(scriptUrl, { scope });
-    await navigator.serviceWorker.ready;
-    const attempt = parseRepairAttemptFromHref(window.location.href, queryKey);
-    if (navigator.serviceWorker.controller) {
-        if (attempt > 0) {
-            try {
-                const next = buildHrefWithoutRepairQueryParam(window.location.href, queryKey);
-                history.replaceState(null, document.title, next);
-            }
-            catch {
-                // ignore
-            }
-        }
+    await serviceWorker.register(scriptUrl, { scope });
+    await serviceWorker.ready;
+    if (serviceWorker.controller !== null)
         return;
-    }
-    const controlled = await waitForController(controllerTimeoutMs);
-    if (controlled) {
-        if (attempt > 0) {
-            try {
-                const next = buildHrefWithoutRepairQueryParam(window.location.href, queryKey);
-                history.replaceState(null, document.title, next);
-            }
-            catch {
-                // ignore
-            }
-        }
+    const controlled = await new Promise((resolve) => {
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            serviceWorker.removeEventListener("controllerchange", onChange);
+            resolve(value);
+        };
+        const onChange = () => finish(serviceWorker.controller !== null);
+        serviceWorker.addEventListener("controllerchange", onChange);
+        const timer = setTimeout(() => finish(serviceWorker.controller !== null), timeoutMs);
+    });
+    if (controlled)
         return;
-    }
-    if (attempt < maxRepairAttempts) {
-        try {
-            const next = buildHrefWithRepairAttempt(window.location.href, queryKey, attempt + 1);
-            window.location.replace(next);
-        }
-        catch {
-            window.location.reload();
-        }
-        // Navigation will interrupt JS; keep pending so callers don't proceed with dependent work.
-        await new Promise(() => { });
-    }
-    throw new Error("Service Worker is installed but not controlling this page");
+    const key = options.repairQueryKey?.trim() || "_flowersec_sw_repair";
+    const attempt = currentAttempt(key);
+    if (attempt >= maxAttempts)
+        throw new Error("service worker did not take control");
+    repairNavigation(key, attempt + 1);
 }
-// Test-only exports (not re-exported from the public proxy entrypoint).
-export const __testOnly = {
-    parseRepairAttemptFromHref,
-    buildHrefWithRepairAttempt,
-    buildHrefWithoutRepairQueryParam,
-};

package/dist/proxy/runtime.d.ts

@@ -1,67 +1,7 @@
-import type { Client } from "../client.js";
-import type { YamuxStream } from "../yamux/stream.js";
-import { CookieJar } from "./cookieJar.js";
-import type { Header } from "./types.js";
-type ProxyFetchReq = Readonly<{
-    id: string;
-    method: string;
-    path: string;
-    headers: readonly Header[];
-    external_origin?: string;
-    response_flow_control?: "chunk_credit_v1";
-    body?: ArrayBuffer;
-}>;
-export type ProxyRuntimeLimits = Readonly<{
-    maxJsonFrameBytes: number;
-    maxChunkBytes: number;
-    maxBodyBytes: number;
-    maxWsFrameBytes: number;
-    maxWsBufferedAmountBytes: number;
-    maxConcurrentHttpStreams: number;
-    maxQueuedHttpRequests: number;
-    maxQueuedHttpBodyBytes: number;
-}>;
-export type ProxyRuntime = Readonly<{
-    limits: ProxyRuntimeLimits;
-    dispose: () => void;
-    dispatchFetch: (req: ProxyFetchReq, port: MessagePort) => void;
-    openWebSocketStream: (path: string, opts?: Readonly<{
-        protocols?: readonly string[];
-        signal?: AbortSignal;
-    }>) => Promise<Readonly<{
-        stream: YamuxStream;
-        protocol: string;
-    }>>;
-}>;
-export type ProxyRuntimePathPolicy = Readonly<{
-    allowedPathPrefixes?: readonly string[];
-    deniedPathPrefixes?: readonly string[];
-    allowedWebSocketPathPrefixes?: readonly string[];
-    deniedWebSocketPathPrefixes?: readonly string[];
-}>;
-export type ProxyRuntimeOptions = Readonly<{
-    client: Client;
-    maxJsonFrameBytes?: number;
-    maxChunkBytes?: number;
-    maxBodyBytes?: number;
-    maxWsFrameBytes?: number;
-    maxWsBufferedAmountBytes?: number;
-    maxConcurrentHttpStreams?: number;
-    maxQueuedHttpRequests?: number;
-    maxQueuedHttpBodyBytes?: number;
-    timeoutMs?: number;
-    extraRequestHeaders?: readonly string[];
-    extraResponseHeaders?: readonly string[];
-    extraWsHeaders?: readonly string[];
-    cookieJar?: CookieJar;
-    pathPolicy?: ProxyRuntimePathPolicy;
-    externalOrigin?: string;
-    runtimeRegistrationToken?: string;
-}>;
+import type { ProxyRuntime, ProxyRuntimeOptions } from "./types.js";
+export declare function createProxyRuntime(options: ProxyRuntimeOptions): ProxyRuntime;
 export type EnsureServiceWorkerRuntimeRegisteredOptions = Readonly<{
     timeoutMs?: number;
     runtimeRegistrationToken?: string;
 }>;
-export declare function createProxyRuntime(opts: ProxyRuntimeOptions): ProxyRuntime;
-export declare function ensureServiceWorkerRuntimeRegistered(opts?: EnsureServiceWorkerRuntimeRegisteredOptions): Promise<void>;
-export {};
+export declare function ensureServiceWorkerRuntimeRegistered(options?: EnsureServiceWorkerRuntimeRegisteredOptions): Promise<void>;