@ricsam/isolate-playwright 0.1.2 → 0.1.5

package/README.md

@@ -1,48 +1,137 @@
 # @ricsam/isolate-playwright
 
-Playwright bridge for running browser tests in a V8 sandbox. Execute untrusted Playwright test code against a real browser page while keeping the test logic isolated.
+Playwright bridge for running browser automation in a V8 sandbox. Execute untrusted Playwright code against a real browser page while keeping the logic isolated.
+
+## Installation
+
+```bash
+npm add @ricsam/isolate-playwright playwright
+```
+
+## Usage with isolate-runtime (Recommended)
+
+The easiest way to use this package is through `@ricsam/isolate-runtime`:
+
+### Script Mode (No Tests)
+
+Run browser automation scripts without a test framework:
+
+```typescript
+import { createRuntime } from "@ricsam/isolate-runtime";
+import { chromium } from "playwright";
+
+const browser = await chromium.launch({ headless: true });
+const page = await browser.newPage();
+
+const runtime = await createRuntime({
+  playwright: {
+    page,
+    baseUrl: "https://example.com",
+    console: true, // Print browser console logs to stdout
+  },
+});
+
+// Run a script - page is available, but expect is not
+await runtime.eval(`
+  await page.goto("/");
+  const title = await page.title();
+  console.log("Page title:", title);
+`);
+
+// Get collected network data
+const data = runtime.playwright.getCollectedData();
+console.log("Network requests:", data.networkRequests.length);
+
+await runtime.dispose();
+await browser.close();
+```
+
+### Test Mode (With Test Framework)
+
+For tests, enable `testEnvironment` which provides `describe`, `it`, and `expect`. Playwright extends `expect` with locator matchers:
+
+```typescript
+import { createRuntime } from "@ricsam/isolate-runtime";
+import { chromium } from "playwright";
+
+const browser = await chromium.launch({ headless: true });
+const page = await browser.newPage();
+
+const runtime = await createRuntime({
+  testEnvironment: true, // Provides describe, it, expect
+  playwright: {
+    page,
+    baseUrl: "https://example.com",
+    onBrowserConsoleLog: (entry) => console.log("[browser]", entry.level, ...entry.args),
+    onNetworkRequest: (info) => console.log("Request:", info.url),
+  },
+});
+
+await runtime.eval(`
+  describe("homepage", () => {
+    it("loads correctly", async () => {
+      await page.goto("/");
+      const heading = page.getByRole("heading", { name: "Example Domain" });
+      await expect(heading).toBeVisible(); // Locator matcher from playwright
+      expect(await page.title()).toBe("Example Domain"); // Primitive matcher from test-environment
+    });
+  });
+`);
+
+// Run tests using test-environment
+const results = await runtime.testEnvironment.runTests();
+console.log(`${results.passed}/${results.total} tests passed`);
+
+// Get collected browser data
+const data = runtime.playwright.getCollectedData();
+console.log("Browser console logs:", data.browserConsoleLogs);
+
+await runtime.dispose();
+await browser.close();
+```
+
+## Low-level Usage (Direct ivm)
+
+For advanced use cases with direct isolated-vm access:
 
 ```typescript
 import ivm from "isolated-vm";
 import { chromium } from "playwright";
-import { setupPlaywright, runPlaywrightTests } from "@ricsam/isolate-playwright";
+import { setupPlaywright } from "@ricsam/isolate-playwright";
+import { setupTestEnvironment, runTests } from "@ricsam/isolate-test-environment";
 
-// Create browser and page
 const browser = await chromium.launch();
 const page = await browser.newPage();
 
-// Create isolate and context
 const isolate = new ivm.Isolate();
 const context = await isolate.createContext();
 
-// Setup playwright bridge
+// Setup test-environment first (provides describe, it, expect)
+await setupTestEnvironment(context);
+
+// Then setup playwright (extends expect with locator matchers)
 const handle = await setupPlaywright(context, {
   page,
   timeout: 30000,
   baseUrl: "https://example.com",
   onNetworkRequest: (info) => console.log("Request:", info.url),
   onNetworkResponse: (info) => console.log("Response:", info.status),
-  onConsoleLog: (level, ...args) => console.log(`[${level}]`, ...args),
+  onBrowserConsoleLog: (entry) => console.log(`[${entry.level}]`, ...entry.args),
 });
 
 // Load and run untrusted test code
 await context.eval(`
-  test("homepage loads correctly", async () => {
-    await page.goto("/");
-    const heading = page.getByRole("heading", { name: "Example Domain" });
-    await expect(heading).toBeVisible();
-  });
-
-  test("can interact with elements", async () => {
-    const link = page.locator("a");
-    await expect(link).toBeVisible();
-    const text = await link.textContent();
-    expect(text).toContain("More information");
+  describe("homepage", () => {
+    it("loads correctly", async () => {
+      await page.goto("/");
+      const heading = page.getByRole("heading", { name: "Example Domain" });
+      await expect(heading).toBeVisible();
+    });
   });
 `);
 
-// Run tests and get results
-const results = await runPlaywrightTests(context);
+// Run tests
+const results = await runTests(context);
 console.log(`${results.passed}/${results.total} tests passed`);
 
 // Cleanup
@@ -52,18 +141,44 @@ isolate.dispose();
 await browser.close();
 ```
 
-**Injected Globals (in isolate):**
+## Handler-based API (for Remote Execution)
+
+For daemon/client architectures where the browser runs on the client:
+
+```typescript
+import { createPlaywrightHandler, setupPlaywright, type PlaywrightCallback } from "@ricsam/isolate-playwright";
+import { chromium } from "playwright";
+
+// On the client: create handler from page
+const browser = await chromium.launch();
+const page = await browser.newPage();
+const handler: PlaywrightCallback = createPlaywrightHandler(page, {
+  timeout: 30000,
+  baseUrl: "https://example.com",
+});
+
+// On the daemon: setup playwright with handler (instead of page)
+const handle = await setupPlaywright(context, {
+  handler, // Handler callback instead of direct page
+  onBrowserConsoleLog: (entry) => sendToClient("browserConsoleLog", entry),
+});
+```
+
+## Injected Globals (in isolate)
+
 - `page` - Page object with navigation and locator methods
-- `test(name, fn)` - Register a test
-- `expect(actual)` - Assertion helper for locators and primitives
 - `Locator` - Locator class for element interactions
+- `expect` - Extended with locator matchers (only if test-environment is loaded first)
+
+## Page Methods
 
-**Page Methods:**
 - `page.goto(url, options?)` - Navigate to URL
 - `page.reload()` - Reload page
 - `page.url()` - Get current URL (sync)
 - `page.title()` - Get page title
 - `page.content()` - Get page HTML
+- `page.click(selector)` - Click element (shorthand)
+- `page.fill(selector, value)` - Fill input (shorthand)
 - `page.waitForSelector(selector, options?)` - Wait for element
 - `page.waitForTimeout(ms)` - Wait for milliseconds
 - `page.waitForLoadState(state?)` - Wait for load state
@@ -74,43 +189,53 @@ await browser.close();
 - `page.getByLabel(label)` - Get locator by label
 - `page.getByPlaceholder(text)` - Get locator by placeholder
 - `page.getByTestId(id)` - Get locator by test ID
+- `page.request.get(url)` - HTTP GET request with page cookies
+- `page.request.post(url, options?)` - HTTP POST request with page cookies
+
+## Locator Methods
 
-**Locator Methods:**
 - `click()`, `dblclick()`, `hover()`, `focus()`
 - `fill(text)`, `type(text)`, `clear()`, `press(key)`
 - `check()`, `uncheck()`, `selectOption(value)`
 - `textContent()`, `inputValue()`
 - `isVisible()`, `isEnabled()`, `isChecked()`, `count()`
+- `nth(index)` - Get nth matching element
+
+## Expect Matchers (for Locators)
+
+These matchers are available when using playwright with test-environment:
 
-**Expect Matchers (for Locators):**
-- `toBeVisible()`, `toBeEnabled()`, `toBeChecked()`
-- `toContainText(text)`, `toHaveValue(value)`
+- `toBeVisible(options?)`, `toBeEnabled(options?)`, `toBeChecked(options?)`
+- `toContainText(text, options?)`, `toHaveValue(value, options?)`
 - All matchers support `.not` modifier
+- All matchers support `{ timeout: number }` option
 
-**Expect Matchers (for Primitives):**
-- `toBe(expected)`, `toEqual(expected)`
-- `toBeTruthy()`, `toBeFalsy()`
-- `toContain(item)`
+## Handle Methods
 
-**Handle Methods:**
 - `dispose()` - Clean up event listeners
-- `getConsoleLogs()` - Get captured browser console logs
+- `getBrowserConsoleLogs()` - Get captured browser console logs
 - `getNetworkRequests()` - Get captured network requests
 - `getNetworkResponses()` - Get captured network responses
 - `clearCollected()` - Clear all collected data
 
-**Test Results:**
+## Setup Options
 
 ```typescript
-interface PlaywrightExecutionResult {
-  passed: number;
-  failed: number;
-  total: number;
-  results: Array<{
-    name: string;
-    passed: boolean;
-    error?: string;
-    duration: number;
-  }>;
+interface PlaywrightSetupOptions {
+  page?: Page;                    // Direct page object (for local use)
+  handler?: PlaywrightCallback;   // Handler callback (for remote use)
+  timeout?: number;               // Default timeout for operations
+  baseUrl?: string;               // Base URL for relative navigation
+  console?: boolean;              // Route browser console logs through console handler
+  onEvent?: (event: PlaywrightEvent) => void;  // Unified event callback
 }
-```
+
+type PlaywrightEvent =
+  | { type: "browserConsoleLog"; level: string; args: unknown[]; timestamp: number }
+  | { type: "networkRequest"; url: string; method: string; headers: Record<string, string>; ... }
+  | { type: "networkResponse"; url: string; status: number; headers: Record<string, string>; ... };
+```
+
+## License
+
+MIT

package/dist/cjs/client.cjs

@@ -0,0 +1,287 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/playwright/src/client.ts
+var exports_client = {};
+__export(exports_client, {
+  createPlaywrightHandler: () => createPlaywrightHandler
+});
+module.exports = __toCommonJS(exports_client);
+function getLocator(page, selectorType, selectorValue, optionsJson) {
+  const options = optionsJson ? JSON.parse(optionsJson) : undefined;
+  const nthIndex = options?.nth;
+  const roleOptions = options ? { ...options } : undefined;
+  if (roleOptions) {
+    delete roleOptions.nth;
+  }
+  let locator;
+  switch (selectorType) {
+    case "css":
+      locator = page.locator(selectorValue);
+      break;
+    case "role":
+      locator = page.getByRole(selectorValue, roleOptions && Object.keys(roleOptions).length > 0 ? roleOptions : undefined);
+      break;
+    case "text":
+      locator = page.getByText(selectorValue);
+      break;
+    case "label":
+      locator = page.getByLabel(selectorValue);
+      break;
+    case "placeholder":
+      locator = page.getByPlaceholder(selectorValue);
+      break;
+    case "testId":
+      locator = page.getByTestId(selectorValue);
+      break;
+    default:
+      locator = page.locator(selectorValue);
+  }
+  if (nthIndex !== undefined) {
+    locator = locator.nth(nthIndex);
+  }
+  return locator;
+}
+async function executeLocatorAction(locator, action, actionArg, timeout) {
+  switch (action) {
+    case "click":
+      await locator.click({ timeout });
+      return null;
+    case "dblclick":
+      await locator.dblclick({ timeout });
+      return null;
+    case "fill":
+      await locator.fill(String(actionArg ?? ""), { timeout });
+      return null;
+    case "type":
+      await locator.pressSequentially(String(actionArg ?? ""), { timeout });
+      return null;
+    case "check":
+      await locator.check({ timeout });
+      return null;
+    case "uncheck":
+      await locator.uncheck({ timeout });
+      return null;
+    case "selectOption":
+      await locator.selectOption(String(actionArg ?? ""), { timeout });
+      return null;
+    case "clear":
+      await locator.clear({ timeout });
+      return null;
+    case "press":
+      await locator.press(String(actionArg ?? ""), { timeout });
+      return null;
+    case "hover":
+      await locator.hover({ timeout });
+      return null;
+    case "focus":
+      await locator.focus({ timeout });
+      return null;
+    case "getText":
+      return await locator.textContent({ timeout });
+    case "getValue":
+      return await locator.inputValue({ timeout });
+    case "isVisible":
+      return await locator.isVisible();
+    case "isEnabled":
+      return await locator.isEnabled();
+    case "isChecked":
+      return await locator.isChecked();
+    case "count":
+      return await locator.count();
+    default:
+      throw new Error(`Unknown action: ${action}`);
+  }
+}
+async function executeExpectAssertion(locator, matcher, expected, negated, timeout) {
+  switch (matcher) {
+    case "toBeVisible": {
+      const isVisible = await locator.isVisible();
+      if (negated) {
+        if (isVisible)
+          throw new Error("Expected element to not be visible, but it was visible");
+      } else {
+        if (!isVisible)
+          throw new Error("Expected element to be visible, but it was not");
+      }
+      break;
+    }
+    case "toContainText": {
+      const text = await locator.textContent({ timeout });
+      const matches = text?.includes(String(expected)) ?? false;
+      if (negated) {
+        if (matches)
+          throw new Error(`Expected text to not contain "${expected}", but got "${text}"`);
+      } else {
+        if (!matches)
+          throw new Error(`Expected text to contain "${expected}", but got "${text}"`);
+      }
+      break;
+    }
+    case "toHaveValue": {
+      const value = await locator.inputValue({ timeout });
+      const matches = value === String(expected);
+      if (negated) {
+        if (matches)
+          throw new Error(`Expected value to not be "${expected}", but it was`);
+      } else {
+        if (!matches)
+          throw new Error(`Expected value to be "${expected}", but got "${value}"`);
+      }
+      break;
+    }
+    case "toBeEnabled": {
+      const isEnabled = await locator.isEnabled();
+      if (negated) {
+        if (isEnabled)
+          throw new Error("Expected element to be disabled, but it was enabled");
+      } else {
+        if (!isEnabled)
+          throw new Error("Expected element to be enabled, but it was disabled");
+      }
+      break;
+    }
+    case "toBeChecked": {
+      const isChecked = await locator.isChecked();
+      if (negated) {
+        if (isChecked)
+          throw new Error("Expected element to not be checked, but it was checked");
+      } else {
+        if (!isChecked)
+          throw new Error("Expected element to be checked, but it was not");
+      }
+      break;
+    }
+    default:
+      throw new Error(`Unknown matcher: ${matcher}`);
+  }
+}
+function createPlaywrightHandler(page, options) {
+  const timeout = options?.timeout ?? 30000;
+  const baseUrl = options?.baseUrl;
+  return async (op) => {
+    try {
+      switch (op.type) {
+        case "goto": {
+          const [url, waitUntil] = op.args;
+          const targetUrl = baseUrl && !url.startsWith("http") ? `${baseUrl}${url}` : url;
+          await page.goto(targetUrl, {
+            timeout,
+            waitUntil: waitUntil ?? "load"
+          });
+          return { ok: true };
+        }
+        case "reload":
+          await page.reload({ timeout });
+          return { ok: true };
+        case "url":
+          return { ok: true, value: page.url() };
+        case "title":
+          return { ok: true, value: await page.title() };
+        case "content":
+          return { ok: true, value: await page.content() };
+        case "waitForSelector": {
+          const [selector, optionsJson] = op.args;
+          const opts = optionsJson ? JSON.parse(optionsJson) : {};
+          await page.waitForSelector(selector, { timeout, ...opts });
+          return { ok: true };
+        }
+        case "waitForTimeout": {
+          const [ms] = op.args;
+          await page.waitForTimeout(ms);
+          return { ok: true };
+        }
+        case "waitForLoadState": {
+          const [state] = op.args;
+          await page.waitForLoadState(state ?? "load", { timeout });
+          return { ok: true };
+        }
+        case "evaluate": {
+          const [script] = op.args;
+          const result = await page.evaluate(script);
+          return { ok: true, value: result };
+        }
+        case "locatorAction": {
+          const [selectorType, selectorValue, roleOptions, action, actionArg] = op.args;
+          const locator = getLocator(page, selectorType, selectorValue, roleOptions);
+          const result = await executeLocatorAction(locator, action, actionArg, timeout);
+          return { ok: true, value: result };
+        }
+        case "expectLocator": {
+          const [selectorType, selectorValue, roleOptions, matcher, expected, negated, customTimeout] = op.args;
+          const locator = getLocator(page, selectorType, selectorValue, roleOptions);
+          const effectiveTimeout = customTimeout ?? timeout;
+          await executeExpectAssertion(locator, matcher, expected, negated ?? false, effectiveTimeout);
+          return { ok: true };
+        }
+        case "request": {
+          const [url, method, data, headers] = op.args;
+          const targetUrl = baseUrl && !url.startsWith("http") ? `${baseUrl}${url}` : url;
+          const requestOptions = {
+            timeout
+          };
+          if (headers) {
+            requestOptions.headers = headers;
+          }
+          if (data !== undefined && data !== null) {
+            requestOptions.data = data;
+          }
+          const response = await page.request.fetch(targetUrl, {
+            method,
+            ...requestOptions
+          });
+          const text = await response.text();
+          let json = null;
+          try {
+            json = JSON.parse(text);
+          } catch {}
+          return {
+            ok: true,
+            value: {
+              status: response.status(),
+              ok: response.ok(),
+              headers: response.headers(),
+              text,
+              json,
+              body: null
+            }
+          };
+        }
+        default:
+          return { ok: false, error: { name: "Error", message: `Unknown operation: ${op.type}` } };
+      }
+    } catch (err) {
+      const error = err;
+      return { ok: false, error: { name: error.name, message: error.message } };
+    }
+  };
+}
+})
+
+//# debugId=32EDBABEF8B46B5164756E2164756E21

package/dist/cjs/client.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/client.ts"],
+  "sourcesContent": [
+    "/**\n * Client-safe exports for @ricsam/isolate-playwright\n * This module can be imported without loading isolated-vm\n */\n\nimport type { Page, Locator as PlaywrightLocator } from \"playwright\";\nimport type {\n  PlaywrightOperation,\n  PlaywrightResult,\n} from \"@ricsam/isolate-protocol\";\n\n// Re-export types\nexport type {\n  NetworkRequestInfo,\n  NetworkResponseInfo,\n  BrowserConsoleLogEntry,\n  PlaywrightSetupOptions,\n  PlaywrightOptions,\n  PlaywrightHandle,\n} from \"./types.cjs\";\n\n// Import PlaywrightCallback for use in function return type\nimport type { PlaywrightCallback } from \"./types.cjs\";\nexport type { PlaywrightCallback };\n\nexport type { PlaywrightOperation, PlaywrightResult, PlaywrightEvent } from \"@ricsam/isolate-protocol\";\n\n// ============================================================================\n// Helper: Get locator from selector info\n// ============================================================================\n\nfunction getLocator(\n  page: Page,\n  selectorType: string,\n  selectorValue: string,\n  optionsJson: string | null\n): PlaywrightLocator {\n  // Parse options and extract nth if present\n  const options = optionsJson ? JSON.parse(optionsJson) : undefined;\n  const nthIndex = options?.nth;\n\n  // For role selectors, pass options (excluding nth) to getByRole\n  const roleOptions = options ? { ...options } : undefined;\n  if (roleOptions) {\n    delete roleOptions.nth;\n  }\n\n  let locator: PlaywrightLocator;\n  switch (selectorType) {\n    case \"css\":\n      locator = page.locator(selectorValue);\n      break;\n    case \"role\":\n      locator = page.getByRole(\n        selectorValue as Parameters<Page[\"getByRole\"]>[0],\n        roleOptions && Object.keys(roleOptions).length > 0 ? roleOptions : undefined\n      );\n      break;\n    case \"text\":\n      locator = page.getByText(selectorValue);\n      break;\n    case \"label\":\n      locator = page.getByLabel(selectorValue);\n      break;\n    case \"placeholder\":\n      locator = page.getByPlaceholder(selectorValue);\n      break;\n    case \"testId\":\n      locator = page.getByTestId(selectorValue);\n      break;\n    default:\n      locator = page.locator(selectorValue);\n  }\n\n  // Apply nth if specified\n  if (nthIndex !== undefined) {\n    locator = locator.nth(nthIndex);\n  }\n\n  return locator;\n}\n\n// ============================================================================\n// Helper: Execute locator action\n// ============================================================================\n\nasync function executeLocatorAction(\n  locator: PlaywrightLocator,\n  action: string,\n  actionArg: unknown,\n  timeout: number\n): Promise<unknown> {\n  switch (action) {\n    case \"click\":\n      await locator.click({ timeout });\n      return null;\n    case \"dblclick\":\n      await locator.dblclick({ timeout });\n      return null;\n    case \"fill\":\n      await locator.fill(String(actionArg ?? \"\"), { timeout });\n      return null;\n    case \"type\":\n      await locator.pressSequentially(String(actionArg ?? \"\"), { timeout });\n      return null;\n    case \"check\":\n      await locator.check({ timeout });\n      return null;\n    case \"uncheck\":\n      await locator.uncheck({ timeout });\n      return null;\n    case \"selectOption\":\n      await locator.selectOption(String(actionArg ?? \"\"), { timeout });\n      return null;\n    case \"clear\":\n      await locator.clear({ timeout });\n      return null;\n    case \"press\":\n      await locator.press(String(actionArg ?? \"\"), { timeout });\n      return null;\n    case \"hover\":\n      await locator.hover({ timeout });\n      return null;\n    case \"focus\":\n      await locator.focus({ timeout });\n      return null;\n    case \"getText\":\n      return await locator.textContent({ timeout });\n    case \"getValue\":\n      return await locator.inputValue({ timeout });\n    case \"isVisible\":\n      return await locator.isVisible();\n    case \"isEnabled\":\n      return await locator.isEnabled();\n    case \"isChecked\":\n      return await locator.isChecked();\n    case \"count\":\n      return await locator.count();\n    default:\n      throw new Error(`Unknown action: ${action}`);\n  }\n}\n\n// ============================================================================\n// Helper: Execute expect assertion\n// ============================================================================\n\nasync function executeExpectAssertion(\n  locator: PlaywrightLocator,\n  matcher: string,\n  expected: unknown,\n  negated: boolean,\n  timeout: number\n): Promise<void> {\n  switch (matcher) {\n    case \"toBeVisible\": {\n      const isVisible = await locator.isVisible();\n      if (negated) {\n        if (isVisible) throw new Error(\"Expected element to not be visible, but it was visible\");\n      } else {\n        if (!isVisible) throw new Error(\"Expected element to be visible, but it was not\");\n      }\n      break;\n    }\n    case \"toContainText\": {\n      const text = await locator.textContent({ timeout });\n      const matches = text?.includes(String(expected)) ?? false;\n      if (negated) {\n        if (matches) throw new Error(`Expected text to not contain \"${expected}\", but got \"${text}\"`);\n      } else {\n        if (!matches) throw new Error(`Expected text to contain \"${expected}\", but got \"${text}\"`);\n      }\n      break;\n    }\n    case \"toHaveValue\": {\n      const value = await locator.inputValue({ timeout });\n      const matches = value === String(expected);\n      if (negated) {\n        if (matches) throw new Error(`Expected value to not be \"${expected}\", but it was`);\n      } else {\n        if (!matches) throw new Error(`Expected value to be \"${expected}\", but got \"${value}\"`);\n      }\n      break;\n    }\n    case \"toBeEnabled\": {\n      const isEnabled = await locator.isEnabled();\n      if (negated) {\n        if (isEnabled) throw new Error(\"Expected element to be disabled, but it was enabled\");\n      } else {\n        if (!isEnabled) throw new Error(\"Expected element to be enabled, but it was disabled\");\n      }\n      break;\n    }\n    case \"toBeChecked\": {\n      const isChecked = await locator.isChecked();\n      if (negated) {\n        if (isChecked) throw new Error(\"Expected element to not be checked, but it was checked\");\n      } else {\n        if (!isChecked) throw new Error(\"Expected element to be checked, but it was not\");\n      }\n      break;\n    }\n    default:\n      throw new Error(`Unknown matcher: ${matcher}`);\n  }\n}\n\n// ============================================================================\n// Create Playwright Handler (for remote use)\n// ============================================================================\n\n/**\n * Create a playwright handler from a Page object.\n * This handler is called by the daemon (via callback) when sandbox needs page operations.\n * Used for remote runtime where the browser runs on the client.\n */\nexport function createPlaywrightHandler(\n  page: Page,\n  options?: { timeout?: number; baseUrl?: string }\n): PlaywrightCallback {\n  const timeout = options?.timeout ?? 30000;\n  const baseUrl = options?.baseUrl;\n\n  return async (op: PlaywrightOperation): Promise<PlaywrightResult> => {\n    try {\n      switch (op.type) {\n        case \"goto\": {\n          const [url, waitUntil] = op.args as [string, string?];\n          const targetUrl = baseUrl && !url.startsWith(\"http\") ? `${baseUrl}${url}` : url;\n          await page.goto(targetUrl, {\n            timeout,\n            waitUntil: (waitUntil as \"load\" | \"domcontentloaded\" | \"networkidle\") ?? \"load\",\n          });\n          return { ok: true };\n        }\n        case \"reload\":\n          await page.reload({ timeout });\n          return { ok: true };\n        case \"url\":\n          return { ok: true, value: page.url() };\n        case \"title\":\n          return { ok: true, value: await page.title() };\n        case \"content\":\n          return { ok: true, value: await page.content() };\n        case \"waitForSelector\": {\n          const [selector, optionsJson] = op.args as [string, string?];\n          const opts = optionsJson ? JSON.parse(optionsJson) : {};\n          await page.waitForSelector(selector, { timeout, ...opts });\n          return { ok: true };\n        }\n        case \"waitForTimeout\": {\n          const [ms] = op.args as [number];\n          await page.waitForTimeout(ms);\n          return { ok: true };\n        }\n        case \"waitForLoadState\": {\n          const [state] = op.args as [string?];\n          await page.waitForLoadState(\n            (state as \"load\" | \"domcontentloaded\" | \"networkidle\") ?? \"load\",\n            { timeout }\n          );\n          return { ok: true };\n        }\n        case \"evaluate\": {\n          const [script] = op.args as [string];\n          const result = await page.evaluate(script);\n          return { ok: true, value: result };\n        }\n        case \"locatorAction\": {\n          const [selectorType, selectorValue, roleOptions, action, actionArg] = op.args as [\n            string,\n            string,\n            string | null,\n            string,\n            unknown\n          ];\n          const locator = getLocator(page, selectorType, selectorValue, roleOptions);\n          const result = await executeLocatorAction(locator, action, actionArg, timeout);\n          return { ok: true, value: result };\n        }\n        case \"expectLocator\": {\n          const [selectorType, selectorValue, roleOptions, matcher, expected, negated, customTimeout] = op.args as [\n            string,\n            string,\n            string | null,\n            string,\n            unknown,\n            boolean,\n            number?\n          ];\n          const locator = getLocator(page, selectorType, selectorValue, roleOptions);\n          const effectiveTimeout = customTimeout ?? timeout;\n          await executeExpectAssertion(locator, matcher, expected, negated ?? false, effectiveTimeout);\n          return { ok: true };\n        }\n        case \"request\": {\n          const [url, method, data, headers] = op.args as [\n            string,\n            string,\n            unknown,\n            Record<string, string>?\n          ];\n          const targetUrl = baseUrl && !url.startsWith(\"http\") ? `${baseUrl}${url}` : url;\n          const requestOptions: {\n            method?: string;\n            data?: unknown;\n            headers?: Record<string, string>;\n            timeout?: number;\n          } = {\n            timeout,\n          };\n          if (headers) {\n            requestOptions.headers = headers;\n          }\n          if (data !== undefined && data !== null) {\n            requestOptions.data = data;\n          }\n\n          const response = await page.request.fetch(targetUrl, {\n            method: method as \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\" | \"HEAD\" | \"OPTIONS\",\n            ...requestOptions,\n          });\n\n          // Get response data - try to parse as JSON, fall back to text\n          const text = await response.text();\n          let json: unknown = null;\n          try {\n            json = JSON.parse(text);\n          } catch {\n            // Not valid JSON, that's ok\n          }\n\n          return {\n            ok: true,\n            value: {\n              status: response.status(),\n              ok: response.ok(),\n              headers: response.headers(),\n              text,\n              json,\n              body: null, // ArrayBuffer not easily serializable, use text/json instead\n            },\n          };\n        }\n        default:\n          return { ok: false, error: { name: \"Error\", message: `Unknown operation: ${(op as PlaywrightOperation).type}` } };\n      }\n    } catch (err) {\n      const error = err as Error;\n      return { ok: false, error: { name: error.name, message: error.message } };\n    }\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "32EDBABEF8B46B5164756E2164756E21",
+  "names": []
+}