@ricsam/isolate-playwright 0.1.13 → 0.1.14

package/dist/types/handler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared handler code for @ricsam/isolate-playwright
+ * Used by both index.ts (with isolated-vm) and client.ts (without isolated-vm)
+ */
+import type { Page, Locator as PlaywrightLocator, BrowserContext, Response } from "playwright";
+import { type DefaultPlaywrightHandlerMetadata, type DefaultPlaywrightHandlerOptions, type PlaywrightCallback, type PlaywrightSetupOptions } from "./types.ts";
+type ReadFileCallback = NonNullable<PlaywrightSetupOptions['readFile']>;
+type WriteFileCallback = NonNullable<PlaywrightSetupOptions['writeFile']>;
+export interface FileIOCallbacks {
+    readFile?: ReadFileCallback;
+    writeFile?: WriteFileCallback;
+}
+export declare function getLocator(page: Page, selectorType: string, selectorValue: string, optionsJson: string | null): PlaywrightLocator;
+export declare function executeLocatorAction(locator: PlaywrightLocator, action: string, actionArg: unknown, timeout: number, fileIO?: FileIOCallbacks): Promise<unknown>;
+export declare function executeExpectAssertion(locator: PlaywrightLocator, matcher: string, expected: unknown, negated: boolean, timeout: number): Promise<void>;
+export declare function executePageExpectAssertion(page: Page, matcher: string, expected: unknown, negated: boolean, timeout: number): Promise<void>;
+/**
+ * Registry for tracking multiple pages and contexts.
+ */
+export interface PlaywrightRegistry {
+    pages: Map<string, Page>;
+    contexts: Map<string, BrowserContext>;
+    nextPageId: number;
+    nextContextId: number;
+    pendingResponses: Map<string, Promise<Response>>;
+    pendingRequests: Map<string, Promise<import("playwright").Request>>;
+    nextListenerId: number;
+}
+/**
+ * Create a playwright handler from a Page object.
+ * This handler is called by the daemon (via callback) when sandbox needs page operations.
+ * Used for remote runtime where the browser runs on the client.
+ */
+export declare function createPlaywrightHandler(page: Page, options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
+/**
+ * Public helper for handler-first runtime options.
+ * Adds metadata used by adapters for local event capture and collected data.
+ */
+export declare function defaultPlaywrightHandler(page: Page, options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
+/**
+ * Extract metadata from handlers created by defaultPlaywrightHandler().
+ */
+export declare function getDefaultPlaywrightHandlerMetadata(handler: PlaywrightCallback): DefaultPlaywrightHandlerMetadata | undefined;
+export {};

package/dist/types/index.d.ts

@@ -1,92 +1,10 @@
 import ivm from "isolated-vm";
-import type { Page, BrowserContext, BrowserContextOptions } from "playwright";
-import type { PlaywrightOperation, PlaywrightResult, PlaywrightEvent, PlaywrightFileData } from "@ricsam/isolate-protocol";
-import { DEFAULT_PLAYWRIGHT_HANDLER_META, type DefaultPlaywrightHandlerMetadata, type DefaultPlaywrightHandlerOptions } from "./types.ts";
+import { DEFAULT_PLAYWRIGHT_HANDLER_META } from "./types.ts";
+export { createPlaywrightHandler, defaultPlaywrightHandler, getDefaultPlaywrightHandlerMetadata, } from "./handler.ts";
 export type { PlaywrightOperation, PlaywrightResult, PlaywrightEvent, PlaywrightFileData } from "@ricsam/isolate-protocol";
 export { DEFAULT_PLAYWRIGHT_HANDLER_META };
-export type ReadFileCallback = (filePath: string) => Promise<PlaywrightFileData> | PlaywrightFileData;
-export type WriteFileCallback = (filePath: string, data: Buffer) => Promise<void> | void;
-export interface NetworkRequestInfo {
-    url: string;
-    method: string;
-    headers: Record<string, string>;
-    postData?: string;
-    resourceType: string;
-    timestamp: number;
-}
-export interface NetworkResponseInfo {
-    url: string;
-    status: number;
-    statusText: string;
-    headers: Record<string, string>;
-    timestamp: number;
-}
-/**
- * Browser console log entry - logs from the page context (not sandbox).
- */
-export interface BrowserConsoleLogEntry {
-    level: string;
-    stdout: string;
-    timestamp: number;
-}
-/**
- * Callback type for handling playwright operations.
- * Used for remote execution where the page lives on the client.
- */
-export type PlaywrightCallback = (op: PlaywrightOperation) => Promise<PlaywrightResult>;
-/**
- * Options for setting up playwright in an isolate.
- */
-export interface PlaywrightSetupOptions {
-    /** Direct page object (for local use) */
-    page?: Page;
-    /** Handler callback (for remote use - daemon invokes this) */
-    handler?: PlaywrightCallback;
-    /** Default timeout for operations */
-    timeout?: number;
-    /** If true, browser console logs are printed to stdout */
-    console?: boolean;
-    /** Unified event callback for all playwright events */
-    onEvent?: (event: PlaywrightEvent) => void;
-    /**
-     * Callback invoked when context.newPage() is called from within the isolate.
-     * Host creates/configures the new page. If not provided, newPage() will throw an error.
-     * Receives the BrowserContext so you can call context.newPage().
-     * @param context - The BrowserContext that requested the new page
-     * @returns The new Page object
-     */
-    createPage?: (context: BrowserContext) => Promise<Page> | Page;
-    /**
-     * Callback invoked when browser.newContext() is called from within the isolate.
-     * Host creates/configures the new context. If not provided, newContext() will throw an error.
-     * @param options - Browser context options passed from the isolate
-     * @returns The new BrowserContext object
-     */
-    createContext?: (options?: BrowserContextOptions) => Promise<BrowserContext> | BrowserContext;
-}
-export interface PlaywrightHandle {
-    dispose(): void;
-    /** Get browser console logs (from the page, not sandbox) */
-    getBrowserConsoleLogs(): BrowserConsoleLogEntry[];
-    getNetworkRequests(): NetworkRequestInfo[];
-    getNetworkResponses(): NetworkResponseInfo[];
-    clearCollected(): void;
-}
-/**
- * Create a playwright handler from a Page object.
- * This handler is called by the daemon (via callback) when sandbox needs page operations.
- * Used for remote runtime where the browser runs on the client.
- */
-export declare function createPlaywrightHandler(page: Page, options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
-/**
- * Public helper for handler-first runtime options.
- * Adds metadata used by adapter layers for local event capture.
- */
-export declare function defaultPlaywrightHandler(page: Page, options?: DefaultPlaywrightHandlerOptions): PlaywrightCallback;
-/**
- * Extract metadata from handlers created by defaultPlaywrightHandler().
- */
-export declare function getDefaultPlaywrightHandlerMetadata(handler: PlaywrightCallback): DefaultPlaywrightHandlerMetadata | undefined;
+export type { NetworkRequestInfo, NetworkResponseInfo, BrowserConsoleLogEntry, PlaywrightCallback, PlaywrightSetupOptions, PlaywrightHandle, } from "./types.ts";
+import type { PlaywrightSetupOptions, PlaywrightHandle } from "./types.ts";
 /**
  * Set up playwright in an isolate context.
  *

package/dist/types/types.d.ts

@@ -23,7 +23,7 @@ export interface NetworkResponseInfo {
  */
 export interface BrowserConsoleLogEntry {
     level: string;
-    args: string[];
+    stdout: string;
     timestamp: number;
 }
 /**
@@ -51,6 +51,8 @@ export interface DefaultPlaywrightHandlerOptions {
     createPage?: (context: import("playwright").BrowserContext) => Promise<import("playwright").Page> | import("playwright").Page;
     /** Callback to create new contexts when browser.newContext() is called */
     createContext?: (options?: import("playwright").BrowserContextOptions) => Promise<import("playwright").BrowserContext> | import("playwright").BrowserContext;
+    /** Callback to evaluate a predicate function inside the isolate (used by waitForURL/Request/Response with function predicates) */
+    evaluatePredicate?: (predicateId: number, data: unknown) => boolean;
 }
 /**
  * Metadata attached to handlers created by defaultPlaywrightHandler().

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/isolate-playwright",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {