@olib-ai/owl-browser-sdk 2.0.5 → 2.0.6

package/dist/playwright/frame.js

@@ -0,0 +1,492 @@
+/**
+ * Playwright-compatible Frame and FrameLocator classes for Owl Browser.
+ *
+ * Provides frame isolation support via browser_switch_to_frame /
+ * browser_switch_to_main_frame tools, wrapping that mechanism into
+ * Playwright's Frame and FrameLocator API surfaces.
+ */
+/**
+ * Frame represents an iframe or the main frame of a page.
+ *
+ * Operations on a Frame are scoped to that frame's DOM.
+ * After switching to a frame, subsequent commands target that frame
+ * until switchToMain() is called.
+ */
+export class Frame {
+    _client;
+    _contextId;
+    _frameSelector;
+    _name;
+    _url;
+    _parentFrame;
+    _detached = false;
+    constructor(client, contextId, frameSelector, name, url, parentFrame) {
+        this._client = client;
+        this._contextId = contextId;
+        this._frameSelector = frameSelector;
+        this._name = name ?? (frameSelector === null ? 'main' : frameSelector);
+        this._url = url ?? '';
+        this._parentFrame = parentFrame ?? null;
+    }
+    /** Frame name attribute or generated identifier. */
+    name() {
+        return this._name;
+    }
+    /** Frame URL. */
+    url() {
+        return this._url;
+    }
+    /** Whether this is the main frame. */
+    isMainFrame() {
+        return this._frameSelector === null;
+    }
+    /** Whether the frame has been detached. */
+    isDetached() {
+        return this._detached;
+    }
+    /** Parent frame, or null for the main frame. */
+    parentFrame() {
+        return this._parentFrame;
+    }
+    /** Child frames. Returns empty array (requires runtime enumeration). */
+    childFrames() {
+        return [];
+    }
+    /**
+     * Switch browser focus to this frame.
+     * Subsequent DOM operations will target this frame's document.
+     */
+    async focus() {
+        if (this._frameSelector === null) {
+            await this._client.execute('browser_switch_to_main_frame', {
+                context_id: this._contextId,
+            });
+        }
+        else {
+            await this._client.execute('browser_switch_to_frame', {
+                context_id: this._contextId,
+                frame_selector: this._frameSelector,
+            });
+        }
+    }
+    /**
+     * Navigate this frame to a URL.
+     *
+     * @param url - Target URL
+     * @param options - Navigation options
+     */
+    async goto(url, options) {
+        await this.focus();
+        const params = {
+            context_id: this._contextId,
+            url,
+        };
+        const waitUntil = mapWaitUntil(options?.waitUntil);
+        if (waitUntil) {
+            params['wait_until'] = waitUntil;
+        }
+        if (options?.timeout !== undefined) {
+            params['timeout'] = String(options.timeout);
+        }
+        await this._client.execute('browser_navigate', params);
+    }
+    /** Click an element within this frame. */
+    async click(selector, options) {
+        void options;
+        await this.focus();
+        await this._client.execute('browser_click', {
+            context_id: this._contextId,
+            selector,
+        });
+    }
+    /** Fill an input within this frame. */
+    async fill(selector, value, options) {
+        void options;
+        await this.focus();
+        await this._client.execute('browser_clear_input', {
+            context_id: this._contextId,
+            selector,
+        });
+        await this._client.execute('browser_type', {
+            context_id: this._contextId,
+            selector,
+            text: value,
+        });
+    }
+    /** Type text into an input within this frame. */
+    async type(selector, text, options) {
+        void options;
+        await this.focus();
+        await this._client.execute('browser_type', {
+            context_id: this._contextId,
+            selector,
+            text,
+        });
+    }
+    /** Check a checkbox within this frame. */
+    async check(selector, options) {
+        void options;
+        await this.focus();
+        const result = await this._client.execute('browser_is_checked', {
+            context_id: this._contextId,
+            selector,
+        });
+        const res = result;
+        if (res['error_code'] !== 'checked' && res['checked'] !== true) {
+            await this._client.execute('browser_click', {
+                context_id: this._contextId,
+                selector,
+            });
+        }
+    }
+    /** Uncheck a checkbox within this frame. */
+    async uncheck(selector, options) {
+        void options;
+        await this.focus();
+        const result = await this._client.execute('browser_is_checked', {
+            context_id: this._contextId,
+            selector,
+        });
+        const res = result;
+        if (res['error_code'] === 'checked' || res['checked'] === true) {
+            await this._client.execute('browser_click', {
+                context_id: this._contextId,
+                selector,
+            });
+        }
+    }
+    /** Select an option from a dropdown within this frame. */
+    async selectOption(selector, values, options) {
+        void options;
+        await this.focus();
+        const value = extractSelectValue(values);
+        await this._client.execute('browser_pick', {
+            context_id: this._contextId,
+            selector,
+            value,
+        });
+        return [value];
+    }
+    /** Wait for a selector within this frame. */
+    async waitForSelector(selector, options) {
+        await this.focus();
+        const params = {
+            context_id: this._contextId,
+            selector,
+        };
+        if (options?.timeout !== undefined) {
+            params['timeout'] = options.timeout;
+        }
+        await this._client.execute('browser_wait_for_selector', params);
+    }
+    /** Extract text content of an element within this frame. */
+    async textContent(selector) {
+        await this.focus();
+        const result = await this._client.execute('browser_extract_text', {
+            context_id: this._contextId,
+            selector,
+        });
+        if (result === null || result === undefined)
+            return null;
+        if (typeof result === 'string')
+            return result;
+        const res = result;
+        return res['text'] ?? String(res['result'] ?? '');
+    }
+    /** Get inner HTML of an element within this frame. */
+    async innerHTML(selector) {
+        await this.focus();
+        const result = await this._client.execute('browser_get_html', {
+            context_id: this._contextId,
+            selector,
+        });
+        if (typeof result === 'string')
+            return result;
+        const res = result;
+        return String(res['html'] ?? res['result'] ?? '');
+    }
+    /** Get an attribute value from an element within this frame. */
+    async getAttribute(selector, name) {
+        await this.focus();
+        const result = await this._client.execute('browser_get_attribute', {
+            context_id: this._contextId,
+            selector,
+            attribute: name,
+        });
+        if (result === null || result === undefined)
+            return null;
+        if (typeof result === 'string')
+            return result;
+        const res = result;
+        const val = res['value'] ?? res['result'];
+        return val === undefined || val === null ? null : String(val);
+    }
+    /** Get bounding box of an element within this frame. */
+    async boundingBox(selector) {
+        await this.focus();
+        try {
+            const result = await this._client.execute('browser_get_bounding_box', {
+                context_id: this._contextId,
+                selector,
+            });
+            const res = result;
+            return {
+                x: Number(res['x'] ?? 0),
+                y: Number(res['y'] ?? 0),
+                width: Number(res['width'] ?? 0),
+                height: Number(res['height'] ?? 0),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Evaluate JavaScript within this frame. */
+    async evaluate(pageFunction, arg) {
+        await this.focus();
+        const expression = typeof pageFunction === 'function'
+            ? `(${pageFunction.toString()})(${arg !== undefined ? JSON.stringify(arg) : ''})`
+            : pageFunction;
+        const result = await this._client.execute('browser_evaluate', {
+            context_id: this._contextId,
+            expression,
+        });
+        return result;
+    }
+    /** Create a Locator scoped to this frame (returns Locator from page). */
+    locator(_selector) {
+        // Implemented in FrameLocator instead; Frame.locator defers to Page
+        throw new Error('Use page.frameLocator(selector).locator(selector) for frame-scoped locators');
+    }
+    /** Mark frame as detached. */
+    _markDetached() {
+        this._detached = true;
+    }
+}
+/**
+ * FrameLocator provides a scoped interface for interacting with iframe content.
+ *
+ * Usage: page.frameLocator('#iframe').locator('#button').click()
+ *
+ * The FrameLocator switches to the target frame before each operation,
+ * then creates a Locator that operates within that frame context.
+ */
+export class FrameLocator {
+    _client;
+    _contextId;
+    _frameSelector;
+    _page;
+    constructor(client, contextId, frameSelector, page) {
+        this._client = client;
+        this._contextId = contextId;
+        this._frameSelector = frameSelector;
+        this._page = page;
+    }
+    /**
+     * Create a Locator for an element inside this frame.
+     *
+     * The returned Locator will switch to this frame before executing operations.
+     *
+     * @param selector - CSS selector within the frame
+     * @returns A FrameScopedLocator that auto-switches to the iframe
+     */
+    locator(selector) {
+        return new FrameScopedLocator(this._client, this._contextId, this._frameSelector, selector, this._page);
+    }
+    /** Create a nested FrameLocator for iframes inside this frame. */
+    frameLocator(selector) {
+        // For nested frames, combine selectors
+        return new FrameLocator(this._client, this._contextId, selector, this._page);
+    }
+    /** Return the first matching frame locator. */
+    first() {
+        return this;
+    }
+    /** Return the last matching frame locator. */
+    last() {
+        return this;
+    }
+    /** Return the nth matching frame locator. */
+    nth(_index) {
+        return this;
+    }
+}
+/**
+ * A Locator that automatically switches to a specific frame before operations.
+ */
+export class FrameScopedLocator {
+    _client;
+    _contextId;
+    _frameSelector;
+    _selector;
+    _page;
+    constructor(client, contextId, frameSelector, selector, page) {
+        this._client = client;
+        this._contextId = contextId;
+        this._frameSelector = frameSelector;
+        this._selector = selector;
+        this._page = page;
+    }
+    async _switchToFrame() {
+        const result = await this._client.execute('browser_switch_to_frame', {
+            context_id: this._contextId,
+            frame_selector: this._frameSelector,
+        });
+        const res = result;
+        if (res['status'] === 'frame_switch_failed' || res['success'] === false) {
+            // The CSS selector was not recognized as a frame name/index.
+            // Resolve it by finding the iframe's index in the parent document.
+            const indexResult = await this._client.execute('browser_evaluate', {
+                context_id: this._contextId,
+                expression: `(() => {
+          const el = document.querySelector('${this._frameSelector.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}');
+          if (!el || el.tagName !== 'IFRAME') return -1;
+          const iframes = document.querySelectorAll('iframe');
+          for (let i = 0; i < iframes.length; i++) {
+            if (iframes[i] === el) return i;
+          }
+          return -1;
+        })()`,
+            });
+            const idx = typeof indexResult === 'number' ? indexResult : -1;
+            if (idx < 0) {
+                throw new Error(`Frame not found: ${this._frameSelector}`);
+            }
+            await this._client.execute('browser_switch_to_frame', {
+                context_id: this._contextId,
+                frame_selector: String(idx),
+            });
+        }
+    }
+    async _switchToMain() {
+        await this._client.execute('browser_switch_to_main_frame', {
+            context_id: this._contextId,
+        });
+    }
+    /** Click the element inside the frame. */
+    async click() {
+        await this._switchToFrame();
+        await this._client.execute('browser_click', {
+            context_id: this._contextId,
+            selector: this._selector,
+        });
+        await this._switchToMain();
+    }
+    /** Fill the element inside the frame. */
+    async fill(value) {
+        await this._switchToFrame();
+        await this._client.execute('browser_clear_input', {
+            context_id: this._contextId,
+            selector: this._selector,
+        });
+        await this._client.execute('browser_type', {
+            context_id: this._contextId,
+            selector: this._selector,
+            text: value,
+        });
+        await this._switchToMain();
+    }
+    /** Type text into element inside the frame. */
+    async type(text) {
+        await this._switchToFrame();
+        await this._client.execute('browser_type', {
+            context_id: this._contextId,
+            selector: this._selector,
+            text,
+        });
+        await this._switchToMain();
+    }
+    /** Get text content of element inside the frame. */
+    async textContent() {
+        await this._switchToFrame();
+        try {
+            const result = await this._client.execute('browser_extract_text', {
+                context_id: this._contextId,
+                selector: this._selector,
+            });
+            if (result === null || result === undefined) {
+                await this._switchToMain();
+                return null;
+            }
+            if (typeof result === 'string') {
+                await this._switchToMain();
+                return result;
+            }
+            const res = result;
+            const text = res['text'] ?? String(res['result'] ?? '');
+            await this._switchToMain();
+            return text;
+        }
+        catch {
+            await this._switchToMain();
+            return null;
+        }
+    }
+    /** Check if element is visible inside the frame. */
+    async isVisible() {
+        await this._switchToFrame();
+        try {
+            const result = await this._client.execute('browser_is_visible', {
+                context_id: this._contextId,
+                selector: this._selector,
+            });
+            await this._switchToMain();
+            const res = result;
+            return res['error_code'] === 'visible' || res['visible'] === true;
+        }
+        catch {
+            await this._switchToMain();
+            return false;
+        }
+    }
+    /** Wait for element inside the frame. */
+    async waitFor(options) {
+        await this._switchToFrame();
+        const params = {
+            context_id: this._contextId,
+            selector: this._selector,
+        };
+        if (options?.timeout !== undefined) {
+            params['timeout'] = options.timeout;
+        }
+        await this._client.execute('browser_wait_for_selector', params);
+        await this._switchToMain();
+    }
+    /** Create a child locator within the frame. */
+    locator(selector) {
+        return new FrameScopedLocator(this._client, this._contextId, this._frameSelector, `${this._selector} ${selector}`, this._page);
+    }
+    toString() {
+        return `FrameScopedLocator(frame=${this._frameSelector}, ${this._selector})`;
+    }
+}
+/** Map Playwright waitUntil values to Owl Browser equivalents. */
+function mapWaitUntil(value) {
+    switch (value) {
+        case 'load':
+            return 'load';
+        case 'domcontentloaded':
+            return 'domcontentloaded';
+        case 'networkidle':
+            return 'networkidle';
+        case 'commit':
+            return '';
+        default:
+            return 'load';
+    }
+}
+/** Extract a single option value from SelectOptionValue. */
+function extractSelectValue(values) {
+    if (typeof values === 'string')
+        return values;
+    if (Array.isArray(values)) {
+        const first = values[0];
+        if (first === undefined)
+            return '';
+        if (typeof first === 'string')
+            return first;
+        return first.value ?? first.label ?? '';
+    }
+    return values.value ?? values.label ?? '';
+}
+//# sourceMappingURL=frame.js.map

package/dist/playwright/frame.js.map

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

package/dist/playwright/index.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Playwright-compatible API for Owl Browser.
+ *
+ * This module provides a drop-in Playwright-style API that translates
+ * Playwright method calls into Owl Browser tool executions. Import
+ * `chromium` (or `firefox`/`webkit` aliases) and use `.connect()` to
+ * establish a connection to a running Owl Browser server.
+ *
+ * @example
+ * ```typescript
+ * import { chromium } from '@olib-ai/owl-browser-sdk/playwright';
+ *
+ * const browser = await chromium.connect({
+ *   wsEndpoint: 'http://localhost:8080',
+ *   token: 'test-token',
+ * });
+ *
+ * const context = await browser.newContext({
+ *   viewport: { width: 1280, height: 720 },
+ *   locale: 'en-US',
+ * });
+ * const page = await context.newPage();
+ *
+ * await page.goto('https://example.com');
+ * await page.click('#submit');
+ * await page.fill('#email', 'user@example.com');
+ *
+ * // Network interception
+ * await page.route('**\/api/**', async route => {
+ *   await route.fulfill({ status: 200, body: '{"mock": true}' });
+ * });
+ *
+ * // Locators
+ * await page.getByRole('button', { name: 'Submit' }).click();
+ * await page.getByText('Welcome').isVisible();
+ *
+ * const title = await page.title();
+ * console.log('Page title:', title);
+ *
+ * await page.screenshot({ path: 'screenshot.png' });
+ *
+ * await context.close();
+ * await browser.close();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Browser } from './browser.js';
+export { BrowserContext } from './context.js';
+export { Page } from './page.js';
+export type { ScrapeOptions } from './page.js';
+export type { ExtractedRecord, FieldSpec, ObjectFieldSpec, MetaData, Transform } from './extractor.js';
+export { queryAll, queryFirst, extractTable, extractMeta, extractStructuredData, countElements, } from './extractor.js';
+export { Locator, NthLocator } from './locator.js';
+export { Frame, FrameLocator, FrameScopedLocator } from './frame.js';
+export { Keyboard } from './keyboard.js';
+export { Mouse } from './mouse.js';
+export { Response, Request } from './response.js';
+export { BrowserType } from './browser-type.js';
+export { Route, RouteRequest, Dialog, ConsoleMessage, Download, Video, } from './page-helpers.js';
+export type { ViewportSize, Position, BoundingBox, GotoOptions, NavigationOptions, MouseButton, KeyboardModifier, ClickOptions, DblClickOptions, HoverOptions, FillOptions, TypeOptions, PressOptions, SelectOptionOptions, SelectOptionValue, CheckOptions, DragAndDropOptions, FocusOptions, SetInputFilesOptions, ScreenshotType, ScreenshotOptions, SetContentOptions, PDFOptions, WaitForSelectorState, WaitForSelectorOptions, WaitForFunctionOptions, WaitForURLOptions, WaitForLoadStateOptions, WaitForEventOptions, LoadState, LocatorWaitForOptions, LocatorFilterOptions, BrowserConnectOptions, LaunchOptions, Cookie, BrowserContextOptions, ProxySettings, Geolocation, ColorScheme, ReducedMotion, ForcedColors, RecordVideoOptions, RecordHarOptions, StorageState, RouteOptions, RouteFulfillOptions, EmulateMediaOptions, DeviceDescriptor, PageFunction, Serializable, } from './types.js';
+export type { PageEventName, EventHandler, RouteEntry, } from './page-helpers.js';
+import { BrowserType } from './browser-type.js';
+/**
+ * Chromium browser type.
+ *
+ * Primary entry point for connecting to Owl Browser.
+ *
+ * @example
+ * ```typescript
+ * const browser = await chromium.connect({
+ *   wsEndpoint: 'http://localhost:8080',
+ *   token: 'test-token',
+ * });
+ * ```
+ */
+export declare const chromium: BrowserType;
+/**
+ * Firefox browser type (alias for chromium).
+ *
+ * Owl Browser uses its own Chromium-based engine regardless of
+ * which browser type is used. This alias exists for Playwright
+ * code compatibility.
+ */
+export declare const firefox: BrowserType;
+/**
+ * WebKit browser type (alias for chromium).
+ *
+ * Owl Browser uses its own Chromium-based engine regardless of
+ * which browser type is used. This alias exists for Playwright
+ * code compatibility.
+ */
+export declare const webkit: BrowserType;
+import type { DeviceDescriptor } from './types.js';
+/**
+ * Device descriptors for device emulation.
+ *
+ * Matches Playwright's `devices` dictionary for common mobile and
+ * tablet devices. Use with browser.newContext() to emulate a device.
+ *
+ * @example
+ * ```typescript
+ * import { chromium, devices } from '@olib-ai/owl-browser-sdk/playwright';
+ *
+ * const browser = await chromium.connect({ wsEndpoint: '...', token: '...' });
+ * const context = await browser.newContext({
+ *   ...devices['iPhone 14'],
+ * });
+ * ```
+ */
+export declare const devices: Record<string, DeviceDescriptor>;
+/**
+ * Selectors utility for registering custom selector engines.
+ *
+ * Provides a Playwright-compatible API for selector engine management.
+ * In Owl Browser, selectors are handled natively by the semantic matcher.
+ */
+export declare const selectors: {
+    /**
+     * Register a custom selector engine.
+     *
+     * Stub: Owl Browser uses its own semantic matching engine.
+     *
+     * @param name - Engine name
+     * @param script - Engine implementation
+     */
+    register(name: string, script: {
+        path?: string;
+        content?: string;
+    } | string): Promise<void>;
+};
+export { OwlBrowserError, ConnectionError, AuthenticationError, ToolExecutionError, TimeoutError, } from '../errors.js';
+/**
+ * Default export matching Playwright's module structure.
+ *
+ * @example
+ * ```typescript
+ * import playwright from '@olib-ai/owl-browser-sdk/playwright';
+ * const browser = await playwright.chromium.connect({ ... });
+ * ```
+ */
+declare const _default: {
+    chromium: BrowserType;
+    firefox: BrowserType;
+    webkit: BrowserType;
+    devices: Record<string, DeviceDescriptor>;
+    selectors: {
+        /**
+         * Register a custom selector engine.
+         *
+         * Stub: Owl Browser uses its own semantic matching engine.
+         *
+         * @param name - Engine name
+         * @param script - Engine implementation
+         */
+        register(name: string, script: {
+            path?: string;
+            content?: string;
+        } | string): Promise<void>;
+    };
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/playwright/index.d.ts.map

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