@ulpi/browse 0.7.5 → 1.0.0

package/src/commands/write.ts

@@ -1,484 +0,0 @@
-/**
- * Write commands — navigate and interact with pages (side effects)
- *
- * goto, back, forward, reload, click, dblclick, fill, select, hover,
- * focus, check, uncheck, type, press, scroll, wait, viewport, cookie,
- * header, useragent, drag, keydown, keyup
- */
-
-import type { BrowserContext } from 'playwright';
-import type { BrowserManager } from '../browser-manager';
-import { resolveDevice, listDevices } from '../browser-manager';
-import type { DomainFilter } from '../domain-filter';
-import { DEFAULTS } from '../constants';
-import * as fs from 'fs';
-
-/**
- * Clear all routes and re-register them in correct order:
- * user routes first, domain filter last (Playwright checks last-registered first).
- */
-async function rebuildRoutes(context: BrowserContext, bm: BrowserManager, domainFilter?: DomainFilter | null): Promise<void> {
-  await context.unrouteAll();
-  // User routes first (checked last by Playwright)
-  for (const r of bm.getUserRoutes()) {
-    if (r.action === 'block') {
-      await context.route(r.pattern, (route) => route.abort('blockedbyclient'));
-    } else {
-      await context.route(r.pattern, (route) => route.fulfill({ status: r.status || 200, body: r.body || '', contentType: 'text/plain' }));
-    }
-  }
-  // Domain filter last (checked first by Playwright)
-  if (domainFilter) {
-    await context.route('**/*', (route) => {
-      const url = route.request().url();
-      if (domainFilter.isAllowed(url)) { route.fallback(); } else { route.abort('blockedbyclient'); }
-    });
-  }
-}
-
-export async function handleWriteCommand(
-  command: string,
-  args: string[],
-  bm: BrowserManager,
-  domainFilter?: DomainFilter | null
-): Promise<string> {
-  const page = bm.getPage();
-
-  switch (command) {
-    case 'goto': {
-      const url = args[0];
-      if (!url) throw new Error('Usage: browse goto <url>');
-      if (domainFilter && !domainFilter.isAllowed(url)) {
-        throw new Error(domainFilter.blockedMessage(url));
-      }
-      const response = await page.goto(url, { waitUntil: 'domcontentloaded', timeout: DEFAULTS.COMMAND_TIMEOUT_MS });
-      const status = response?.status() || 'unknown';
-      return `Navigated to ${url} (${status})`;
-    }
-
-    case 'back': {
-      await page.goBack({ waitUntil: 'domcontentloaded', timeout: DEFAULTS.COMMAND_TIMEOUT_MS });
-      return `Back → ${page.url()}`;
-    }
-
-    case 'forward': {
-      await page.goForward({ waitUntil: 'domcontentloaded', timeout: DEFAULTS.COMMAND_TIMEOUT_MS });
-      return `Forward → ${page.url()}`;
-    }
-
-    case 'reload': {
-      await page.reload({ waitUntil: 'domcontentloaded', timeout: DEFAULTS.COMMAND_TIMEOUT_MS });
-      return `Reloaded ${page.url()}`;
-    }
-
-    case 'click': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse click <selector|x,y>');
-      // Coordinate click: "590,461" or "590, 461"
-      const coordMatch = selector.match(/^(\d+)\s*,\s*(\d+)$/);
-      if (coordMatch) {
-        const x = parseInt(coordMatch[1], 10);
-        const y = parseInt(coordMatch[2], 10);
-        await page.mouse.click(x, y);
-        await page.waitForLoadState('domcontentloaded').catch(() => {});
-        return `Clicked at (${x}, ${y}) → now at ${page.url()}`;
-      }
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.click({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.click(resolved.selector, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      // Wait briefly for any navigation/DOM update
-      await page.waitForLoadState('domcontentloaded').catch(() => {});
-      return `Clicked ${selector} → now at ${page.url()}`;
-    }
-
-    case 'fill': {
-      const [selector, ...valueParts] = args;
-      const value = valueParts.join(' ');
-      if (!selector) throw new Error('Usage: browse fill <selector> <value>');
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.fill(value, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.fill(resolved.selector, value, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Filled ${selector}`;
-    }
-
-    case 'select': {
-      const [selector, ...valueParts] = args;
-      const value = valueParts.join(' ');
-      if (!selector) throw new Error('Usage: browse select <selector> <value>');
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.selectOption(value, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.selectOption(resolved.selector, value, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Selected "${value}" in ${selector}`;
-    }
-
-    case 'hover': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse hover <selector>');
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.hover({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.hover(resolved.selector, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Hovered ${selector}`;
-    }
-
-    case 'type': {
-      const text = args.join(' ');
-      if (!text) throw new Error('Usage: browse type <text>');
-      await page.keyboard.type(text);
-      return `Typed "${text}"`;
-    }
-
-    case 'press': {
-      const key = args[0];
-      if (!key) throw new Error('Usage: browse press <key> (e.g., Enter, Tab, Escape)');
-      await page.keyboard.press(key);
-      return `Pressed ${key}`;
-    }
-
-    case 'scroll': {
-      const selector = args[0];
-      if (selector === 'up') {
-        const scrollCtx = await bm.getFrameContext() || page;
-        await scrollCtx.evaluate(() => window.scrollBy(0, -window.innerHeight));
-        return 'Scrolled up one viewport';
-      }
-      if (selector === 'down') {
-        const scrollCtx = await bm.getFrameContext() || page;
-        await scrollCtx.evaluate(() => window.scrollBy(0, window.innerHeight));
-        return 'Scrolled down one viewport';
-      }
-      if (selector && selector !== 'bottom') {
-        const resolved = bm.resolveRef(selector);
-        if ('locator' in resolved) {
-          await resolved.locator.scrollIntoViewIfNeeded({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-        } else {
-          await page.locator(resolved.selector).scrollIntoViewIfNeeded({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-        }
-        return `Scrolled ${selector} into view`;
-      }
-      // Scroll to bottom (default or explicit "bottom")
-      const scrollCtx = await bm.getFrameContext() || page;
-      await scrollCtx.evaluate(() => window.scrollTo(0, document.body.scrollHeight));
-      return 'Scrolled to bottom';
-    }
-
-    case 'wait': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse wait <selector|--url|--network-idle> [timeout]');
-
-      // wait --network-idle [timeout] — wait for network to settle
-      if (selector === '--network-idle') {
-        const timeout = args[1] ? parseInt(args[1], 10) : DEFAULTS.COMMAND_TIMEOUT_MS;
-        await page.waitForLoadState('networkidle', { timeout });
-        return 'Network idle';
-      }
-
-      // wait --url <pattern> [timeout] — wait for URL to match
-      if (selector === '--url') {
-        const pattern = args[1];
-        if (!pattern) throw new Error('Usage: browse wait --url <pattern> [timeout]');
-        const timeout = args[2] ? parseInt(args[2], 10) : DEFAULTS.COMMAND_TIMEOUT_MS;
-        await page.waitForURL(pattern, { timeout });
-        return `URL matched: ${page.url()}`;
-      }
-
-      const timeout = args[1] ? parseInt(args[1], 10) : DEFAULTS.COMMAND_TIMEOUT_MS;
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.waitFor({ state: 'visible', timeout });
-      } else {
-        await page.waitForSelector(resolved.selector, { timeout });
-      }
-      return `Element ${selector} appeared`;
-    }
-
-    case 'viewport': {
-      const size = args[0];
-      if (!size || !size.includes('x')) throw new Error('Usage: browse viewport <WxH> (e.g., 375x812)');
-      const [w, h] = size.split('x').map(Number);
-      await bm.setViewport(w, h);
-      return `Viewport set to ${w}x${h}`;
-    }
-
-    case 'cookie': {
-      const cookieStr = args[0];
-      if (!cookieStr || !cookieStr.includes('=')) throw new Error('Usage: browse cookie <name>=<value>');
-      const eq = cookieStr.indexOf('=');
-      const name = cookieStr.slice(0, eq);
-      const value = cookieStr.slice(eq + 1);
-      const url = new URL(page.url());
-      await page.context().addCookies([{
-        name,
-        value,
-        domain: url.hostname,
-        path: '/',
-      }]);
-      return `Cookie set: ${name}=${value}`;
-    }
-
-    case 'header': {
-      const headerStr = args[0];
-      if (!headerStr || !headerStr.includes(':')) throw new Error('Usage: browse header <name>:<value>');
-      const sep = headerStr.indexOf(':');
-      const name = headerStr.slice(0, sep).trim();
-      const value = headerStr.slice(sep + 1).trim();
-      await bm.setExtraHeader(name, value);
-      return `Header set: ${name}: ${value}`;
-    }
-
-    case 'useragent': {
-      const ua = args.join(' ');
-      if (!ua) throw new Error('Usage: browse useragent <string>');
-      const prevUA = bm.getUserAgent();
-      bm.setUserAgent(ua);
-      try {
-        await bm.applyUserAgent();
-      } catch (err) {
-        // Rollback: restore previous UA so stored state matches the live context
-        bm.setUserAgent(prevUA || '');
-        throw err;
-      }
-      return `User agent set: ${ua}\nNote: Cookies and tab URLs preserved. localStorage/sessionStorage were reset (Playwright limitation).`;
-    }
-
-    case 'upload': {
-      const [selector, ...filePaths] = args;
-      if (!selector || filePaths.length === 0) throw new Error('Usage: browse upload <selector> <file1> [file2] ...');
-      for (const fp of filePaths) {
-        if (!fs.existsSync(fp)) throw new Error(`File not found: ${fp}`);
-      }
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.setInputFiles(filePaths, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.locator(resolved.selector).setInputFiles(filePaths, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Uploaded ${filePaths.length} file(s) to ${selector}`;
-    }
-
-    case 'dialog-accept': {
-      const value = args.join(' ') || undefined;
-      bm.setAutoDialogAction('accept', value);
-      return `Dialog auto-action set to: accept${value ? ` (with value: "${value}")` : ''}`;
-    }
-
-    case 'dialog-dismiss': {
-      bm.setAutoDialogAction('dismiss');
-      return 'Dialog auto-action set to: dismiss';
-    }
-
-    case 'emulate': {
-      const deviceName = args.join(' ');
-      if (!deviceName) {
-        throw new Error(
-          'Usage: browse emulate <device>\n' +
-          'Examples: browse emulate iPhone 15, browse emulate Pixel 7, browse emulate reset\n' +
-          'Run "browse devices" to see all available devices.'
-        );
-      }
-
-      // Reset to desktop
-      if (deviceName.toLowerCase() === 'reset' || deviceName.toLowerCase() === 'desktop') {
-        await bm.emulateDevice(null);
-        return 'Device emulation reset to desktop (1920x1080)';
-      }
-
-      const device = resolveDevice(deviceName);
-      if (!device) {
-        // Find close matches
-        const all = listDevices();
-        const lower = deviceName.toLowerCase();
-        const suggestions = all.filter(d => d.toLowerCase().includes(lower)).slice(0, 5);
-        throw new Error(
-          `Unknown device: "${deviceName}"\n` +
-          (suggestions.length > 0
-            ? `Did you mean: ${suggestions.join(', ')}?\n`
-            : '') +
-          'Run "browse devices" to see all available devices.'
-        );
-      }
-
-      await bm.emulateDevice(device);
-      return [
-        `Emulating: ${deviceName}`,
-        `  Viewport: ${device.viewport.width}x${device.viewport.height}`,
-        `  Scale: ${device.deviceScaleFactor}x`,
-        `  Mobile: ${device.isMobile}`,
-        `  Touch: ${device.hasTouch}`,
-        `  UA: ${device.userAgent.slice(0, 80)}...`,
-        'Note: Cookies and tab URLs preserved. localStorage/sessionStorage were reset (Playwright limitation).',
-      ].join('\n');
-    }
-
-    case 'dblclick': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse dblclick <selector>');
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.dblclick({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.dblclick(resolved.selector, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Double-clicked ${selector}`;
-    }
-
-    case 'focus': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse focus <selector>');
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.focus({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.locator(resolved.selector).focus({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Focused ${selector}`;
-    }
-
-    case 'check': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse check <selector>');
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.check({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.locator(resolved.selector).check({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Checked ${selector}`;
-    }
-
-    case 'uncheck': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse uncheck <selector>');
-      const resolved = bm.resolveRef(selector);
-      if ('locator' in resolved) {
-        await resolved.locator.uncheck({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      } else {
-        await page.locator(resolved.selector).uncheck({ timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      }
-      return `Unchecked ${selector}`;
-    }
-
-    case 'drag': {
-      const [srcSel, tgtSel] = args;
-      if (!srcSel || !tgtSel) throw new Error('Usage: browse drag <source> <target>');
-      const srcResolved = bm.resolveRef(srcSel);
-      const tgtResolved = bm.resolveRef(tgtSel);
-      const srcLocator = 'locator' in srcResolved ? srcResolved.locator : page.locator(srcResolved.selector);
-      const tgtLocator = 'locator' in tgtResolved ? tgtResolved.locator : page.locator(tgtResolved.selector);
-      await srcLocator.dragTo(tgtLocator, { timeout: DEFAULTS.ACTION_TIMEOUT_MS });
-      return `Dragged ${srcSel} to ${tgtSel}`;
-    }
-
-    case 'keydown': {
-      const key = args[0];
-      if (!key) throw new Error('Usage: browse keydown <key>');
-      await page.keyboard.down(key);
-      return `Key down: ${key}`;
-    }
-
-    case 'keyup': {
-      const key = args[0];
-      if (!key) throw new Error('Usage: browse keyup <key>');
-      await page.keyboard.up(key);
-      return `Key up: ${key}`;
-    }
-
-    case 'highlight': {
-      const selector = args[0];
-      if (!selector) throw new Error('Usage: browse highlight <selector>');
-      const resolved = bm.resolveRef(selector);
-      const locator = 'locator' in resolved ? resolved.locator : page.locator(resolved.selector);
-      await locator.evaluate((el) => {
-        el.style.outline = '3px solid #e11d48';
-        el.style.outlineOffset = '2px';
-      });
-      return `Highlighted ${selector}`;
-    }
-
-    case 'download': {
-      const [selector, savePath] = args;
-      if (!selector) throw new Error('Usage: browse download <selector> [path]');
-      const resolved = bm.resolveRef(selector);
-      const locator = 'locator' in resolved ? resolved.locator : page.locator(resolved.selector);
-      const [download] = await Promise.all([
-        page.waitForEvent('download', { timeout: DEFAULTS.COMMAND_TIMEOUT_MS }),
-        locator.click({ timeout: DEFAULTS.ACTION_TIMEOUT_MS }),
-      ]);
-      const finalPath = savePath || download.suggestedFilename();
-      await download.saveAs(finalPath);
-      return `Downloaded: ${finalPath}`;
-    }
-
-    case 'offline': {
-      const mode = args[0];
-      if (mode === 'on') {
-        await bm.setOffline(true);
-        return 'Offline mode: ON';
-      }
-      if (mode === 'off') {
-        await bm.setOffline(false);
-        return 'Offline mode: OFF';
-      }
-      // Toggle
-      const newState = !bm.isOffline();
-      await bm.setOffline(newState);
-      return `Offline mode: ${newState ? 'ON' : 'OFF'}`;
-    }
-
-    case 'route': {
-      // route <pattern> block — abort matching requests
-      // route <pattern> fulfill <status> [body] — respond with custom data
-      // route clear — remove all routes
-      const pattern = args[0];
-      if (!pattern) throw new Error('Usage: browse route <url-pattern> block | browse route <url-pattern> fulfill <status> [body] | browse route clear');
-
-      const context = bm.getContext();
-      if (!context) throw new Error('No browser context');
-
-      if (pattern === 'clear') {
-        await context.unrouteAll();
-        bm.clearUserRoutes();
-        // Re-apply domain filter route if active
-        if (domainFilter) {
-          await context.route('**/*', (route) => {
-            const url = route.request().url();
-            if (domainFilter!.isAllowed(url)) { route.fallback(); } else { route.abort('blockedbyclient'); }
-          });
-        }
-        return domainFilter ? 'All routes cleared (domain filter preserved)' : 'All routes cleared';
-      }
-
-      const action = args[1] || 'block';
-
-      if (action === 'block') {
-        bm.addUserRoute(pattern, 'block');
-        await rebuildRoutes(context, bm, domainFilter);
-        return `Blocking requests matching: ${pattern}`;
-      }
-
-      if (action === 'fulfill') {
-        const status = parseInt(args[2] || '200', 10);
-        const body = args[3] || '';
-        bm.addUserRoute(pattern, 'fulfill', status, body);
-        await rebuildRoutes(context, bm, domainFilter);
-        return `Mocking requests matching: ${pattern} → ${status}${body ? ` "${body}"` : ''}`;
-      }
-
-      throw new Error('Usage: browse route <pattern> block | browse route <pattern> fulfill <status> [body]');
-    }
-
-    default:
-      throw new Error(`Unknown write command: ${command}`);
-  }
-}

package/src/config.ts

@@ -1,45 +0,0 @@
-/**
- * Config file loader — reads browse.json from project root.
- * Config values serve as defaults — CLI flags and env vars override.
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-
-export interface BrowseConfig {
-  session?: string;
-  json?: boolean;
-  contentBoundaries?: boolean;
-  allowedDomains?: string[];
-  idleTimeout?: number;
-  viewport?: string;
-  device?: string;
-  runtime?: string;
-}
-
-/**
- * Load browse.json from the project root (directory containing .git or .claude).
- * Returns empty config if file doesn't exist or is malformed.
- */
-export function loadConfig(): BrowseConfig {
-  let dir = process.cwd();
-  for (let i = 0; i < 20; i++) {
-    if (fs.existsSync(path.join(dir, '.git')) || fs.existsSync(path.join(dir, '.claude'))) {
-      const configPath = path.join(dir, 'browse.json');
-      if (fs.existsSync(configPath)) {
-        try {
-          const raw = fs.readFileSync(configPath, 'utf-8');
-          return JSON.parse(raw) as BrowseConfig;
-        } catch {
-          // Malformed JSON — silently ignore
-          return {};
-        }
-      }
-      return {};
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return {};
-}

package/src/constants.ts

@@ -1,14 +0,0 @@
-const BROWSE_TIMEOUT = parseInt(process.env.BROWSE_TIMEOUT || '0', 10);
-
-export const DEFAULTS = {
-  PORT_RANGE_START: 9400,
-  PORT_RANGE_END: 10400,
-  IDLE_TIMEOUT_MS: 30 * 60 * 1000,       // 30 min
-  COMMAND_TIMEOUT_MS: BROWSE_TIMEOUT || 15_000,    // 15s for navigation
-  ACTION_TIMEOUT_MS: BROWSE_TIMEOUT || 5_000,      // 5s for clicks/fills
-  HEALTH_CHECK_TIMEOUT_MS: 2_000,
-  BUFFER_HIGH_WATER_MARK: 50_000,
-  BUFFER_FLUSH_INTERVAL_MS: 1_000,
-  NETWORK_SETTLE_MS: 5_000,
-  LOCK_STALE_THRESHOLD_MS: 15_000,
-} as const;

package/src/diff.d.ts

@@ -1,12 +0,0 @@
-declare module 'diff' {
-  interface Change {
-    value: string;
-    added?: boolean;
-    removed?: boolean;
-    count?: number;
-  }
-
-  export function diffLines(oldStr: string, newStr: string): Change[];
-  export function diffWords(oldStr: string, newStr: string): Change[];
-  export function diffChars(oldStr: string, newStr: string): Change[];
-}

package/src/domain-filter.ts

@@ -1,140 +0,0 @@
-/**
- * Domain filter — blocks navigation and sub-resource requests outside an allowlist.
- *
- * Supports:
- *   - Exact domain: "example.com" matches only example.com
- *   - Wildcard: "*.example.com" matches example.com AND any subdomain
- *   - Case-insensitive matching
- */
-
-export class DomainFilter {
-  private domains: string[];
-
-  constructor(domains: string[]) {
-    this.domains = domains.map(d => d.toLowerCase());
-  }
-
-  /**
-   * Check if a URL's domain is in the allowlist.
-   * Returns true if allowed, false if blocked.
-   * Non-HTTP URLs (about:blank, data:, etc.) are always allowed.
-   */
-  isAllowed(url: string): boolean {
-    // Block file:// and javascript: URLs — security risk
-    if (url.startsWith('file://') || url.startsWith('javascript:')) {
-      return false;
-    }
-    // Non-HTTP(S) URLs (about:blank, data:, blob:) are always allowed
-    if (!url.startsWith('http://') && !url.startsWith('https://')) {
-      return true;
-    }
-
-    let hostname: string;
-    try {
-      hostname = new URL(url).hostname.toLowerCase();
-    } catch {
-      return false; // Invalid URL = blocked
-    }
-
-    for (const pattern of this.domains) {
-      if (pattern.startsWith('*.')) {
-        // Wildcard: *.example.com matches example.com itself AND any subdomain
-        const base = pattern.slice(2); // "example.com"
-        if (hostname === base || hostname.endsWith('.' + base)) {
-          return true;
-        }
-      } else {
-        // Exact match
-        if (hostname === pattern) {
-          return true;
-        }
-      }
-    }
-
-    return false;
-  }
-
-  /**
-   * Get a human-readable error message for a blocked URL.
-   */
-  blockedMessage(url: string): string {
-    let hostname = url;
-    try {
-      hostname = new URL(url).hostname;
-    } catch {}
-    return `Domain "${hostname}" is not in the allowed list: ${this.domains.join(', ')}`;
-  }
-
-  /**
-   * Generate a JS init script that wraps WebSocket, EventSource, and
-   * navigator.sendBeacon with domain checks. Playwright's context.route()
-   * only covers HTTP — these JS-level APIs bypass it entirely.
-   *
-   * Injected via context.addInitScript() so it runs before any page JS.
-   */
-  generateInitScript(): string {
-    const domainsJson = JSON.stringify(this.domains);
-    return `(function() {
-  const __allowedDomains = ${domainsJson};
-
-  function __isAllowed(url) {
-    if (!url) return true;
-    var str = String(url);
-    // Normalize ws/wss to http/https for URL parsing
-    if (str.startsWith('ws://')) str = 'http://' + str.slice(5);
-    else if (str.startsWith('wss://')) str = 'https://' + str.slice(6);
-    // Block file:// and javascript: URLs
-    if (str.startsWith('file://') || str.startsWith('javascript:')) return false;
-    // Non-HTTP(S) always allowed (data:, blob:, about:)
-    if (!str.startsWith('http://') && !str.startsWith('https://')) return true;
-    var hostname;
-    try { hostname = new URL(str).hostname.toLowerCase(); } catch(e) { return false; }
-    for (var i = 0; i < __allowedDomains.length; i++) {
-      var pattern = __allowedDomains[i];
-      if (pattern.startsWith('*.')) {
-        var base = pattern.slice(2);
-        if (hostname === base || hostname.endsWith('.' + base)) return true;
-      } else {
-        if (hostname === pattern) return true;
-      }
-    }
-    return false;
-  }
-
-  // Wrap WebSocket
-  var OrigWebSocket = window.WebSocket;
-  if (OrigWebSocket) {
-    window.WebSocket = function(url, protocols) {
-      if (!__isAllowed(url)) throw new Error('WebSocket blocked by domain filter: ' + url);
-      if (protocols !== undefined) return new OrigWebSocket(url, protocols);
-      return new OrigWebSocket(url);
-    };
-    window.WebSocket.prototype = OrigWebSocket.prototype;
-    window.WebSocket.CONNECTING = OrigWebSocket.CONNECTING;
-    window.WebSocket.OPEN = OrigWebSocket.OPEN;
-    window.WebSocket.CLOSING = OrigWebSocket.CLOSING;
-    window.WebSocket.CLOSED = OrigWebSocket.CLOSED;
-  }
-
-  // Wrap EventSource
-  var OrigEventSource = window.EventSource;
-  if (OrigEventSource) {
-    window.EventSource = function(url, opts) {
-      if (!__isAllowed(url)) throw new Error('EventSource blocked by domain filter: ' + url);
-      if (opts !== undefined) return new OrigEventSource(url, opts);
-      return new OrigEventSource(url);
-    };
-    window.EventSource.prototype = OrigEventSource.prototype;
-  }
-
-  // Wrap navigator.sendBeacon
-  if (navigator.sendBeacon) {
-    var origSendBeacon = navigator.sendBeacon.bind(navigator);
-    navigator.sendBeacon = function(url, data) {
-      if (!__isAllowed(url)) return false;
-      return origSendBeacon(url, data);
-    };
-  }
-})();`;
-  }
-}