@bctrl/sdk 1.0.1

package/dist/drivers/puppeteer/remote-base.d.ts

@@ -0,0 +1,57 @@
+/**
+ * RemoteBase - Base class for all remote Puppeteer objects.
+ *
+ * Provides common functionality:
+ * - Closed state tracking
+ * - RPC wrapper with closed-state checks
+ * - Common dispose/close patterns
+ *
+ * Classes that extend RemoteBase get automatic protection against
+ * calling methods on disposed/closed objects.
+ */
+import type { SimpleRpcSender } from '../../internal/transport.js';
+/**
+ * Base class for remote Puppeteer objects.
+ * Handles common patterns like closed-state checking and RPC wrapping.
+ */
+export declare class RemoteBase {
+    readonly id: string;
+    protected sendRpc: SimpleRpcSender;
+    protected _isClosed: boolean;
+    constructor(id: string, sendRpc: SimpleRpcSender);
+    /**
+     * Protected RPC wrapper that checks closed state before sending.
+     * Use this instead of sendRpc directly to get automatic closed-state protection.
+     */
+    protected rpc<T>(method: string, args: unknown[]): Promise<T>;
+    /**
+     * Check if this object has been closed/disposed.
+     */
+    get isClosed(): boolean;
+    /**
+     * Mark this object as closed.
+     * Called internally after close/dispose operations.
+     */
+    protected markClosed(): void;
+}
+/**
+ * Base class for remote objects that don't have an ID.
+ * Used for nested components like Mouse, Keyboard that operate on their parent.
+ */
+export declare class RemoteComponentBase {
+    protected sendRpc: SimpleRpcSender;
+    protected _isClosed: boolean;
+    constructor(sendRpc: SimpleRpcSender);
+    /**
+     * Protected RPC wrapper that checks closed state before sending.
+     */
+    protected rpc<T>(method: string, args: unknown[]): Promise<T>;
+    /**
+     * Check if this object has been closed/disposed.
+     */
+    get isClosed(): boolean;
+    /**
+     * Mark this object as closed.
+     */
+    protected markClosed(): void;
+}

package/dist/drivers/puppeteer/remote-base.js

@@ -0,0 +1,79 @@
+/**
+ * RemoteBase - Base class for all remote Puppeteer objects.
+ *
+ * Provides common functionality:
+ * - Closed state tracking
+ * - RPC wrapper with closed-state checks
+ * - Common dispose/close patterns
+ *
+ * Classes that extend RemoteBase get automatic protection against
+ * calling methods on disposed/closed objects.
+ */
+/**
+ * Base class for remote Puppeteer objects.
+ * Handles common patterns like closed-state checking and RPC wrapping.
+ */
+export class RemoteBase {
+    id;
+    sendRpc;
+    _isClosed = false;
+    constructor(id, sendRpc) {
+        this.id = id;
+        this.sendRpc = sendRpc;
+    }
+    /**
+     * Protected RPC wrapper that checks closed state before sending.
+     * Use this instead of sendRpc directly to get automatic closed-state protection.
+     */
+    async rpc(method, args) {
+        if (this._isClosed) {
+            throw new Error(`Cannot call ${method}: object is closed`);
+        }
+        return this.sendRpc(method, args);
+    }
+    /**
+     * Check if this object has been closed/disposed.
+     */
+    get isClosed() {
+        return this._isClosed;
+    }
+    /**
+     * Mark this object as closed.
+     * Called internally after close/dispose operations.
+     */
+    markClosed() {
+        this._isClosed = true;
+    }
+}
+/**
+ * Base class for remote objects that don't have an ID.
+ * Used for nested components like Mouse, Keyboard that operate on their parent.
+ */
+export class RemoteComponentBase {
+    sendRpc;
+    _isClosed = false;
+    constructor(sendRpc) {
+        this.sendRpc = sendRpc;
+    }
+    /**
+     * Protected RPC wrapper that checks closed state before sending.
+     */
+    async rpc(method, args) {
+        if (this._isClosed) {
+            throw new Error(`Cannot call ${method}: object is closed`);
+        }
+        return this.sendRpc(method, args);
+    }
+    /**
+     * Check if this object has been closed/disposed.
+     */
+    get isClosed() {
+        return this._isClosed;
+    }
+    /**
+     * Mark this object as closed.
+     */
+    markClosed() {
+        this._isClosed = true;
+    }
+}

package/dist/drivers/puppeteer/types.d.ts

@@ -0,0 +1,178 @@
+export type { PuppeteerGotoOptions, PuppeteerWaitForNavigationOptions, PuppeteerReloadOptions, PuppeteerWaitForNetworkIdleOptions, PuppeteerWaitUntil, PuppeteerWaitUntilOption, PuppeteerHTTPResponse, PuppeteerRemoteAddress, PuppeteerSecurityDetails, PuppeteerResourceTiming, PuppeteerMouseButton, PuppeteerPoint, PuppeteerOffset, PuppeteerMouseOptions, PuppeteerMouseClickOptions, PuppeteerClickOptions, PuppeteerMouseMoveOptions, PuppeteerMouseWheelOptions, PuppeteerDragDataItem, PuppeteerDragData, PuppeteerKeyInput, PuppeteerKeyboardTypeOptions, PuppeteerKeyDownOptions, PuppeteerKeyPressOptions, PuppeteerWaitForOptions, PuppeteerScreenshotClip, PuppeteerClipRegion, // deprecated alias
+PuppeteerImageFormat, PuppeteerScreenshotOptions, PuppeteerPDFMargin, PuppeteerPaperFormat, PuppeteerPDFOptions, PuppeteerCookiePartitionKey, PuppeteerCookieSameSite, PuppeteerCookiePriority, PuppeteerCookieSourceScheme, PuppeteerCookie, PuppeteerCookieData, PuppeteerDeleteCookiesRequest, PuppeteerWindowState, PuppeteerWindowBounds, PuppeteerTargetType, PuppeteerTarget, PuppeteerWaitForTargetOptions, PuppeteerTargetFilter, PuppeteerDownloadPolicy, PuppeteerDownloadBehavior, PuppeteerBrowserContextOptions, PuppeteerPermission, PuppeteerDevice, PuppeteerIdleOverrides, PuppeteerMediaFeature, PuppeteerNetworkConditions, PuppeteerVisionDeficiency, PuppeteerResourceType, PuppeteerErrorCode, PuppeteerInterceptResolutionAction, PuppeteerInterceptResolutionState, PuppeteerContinueRequestOverrides, PuppeteerResponseForRequest, PuppeteerInitiatorType, PuppeteerInitiator, PuppeteerHTTPRequest, PuppeteerFrame, PuppeteerWebWorker, PuppeteerViewport, PuppeteerGeolocation, PuppeteerBoundingBox, PuppeteerBoxModel, PuppeteerSelectOption, PuppeteerSelectValue, PuppeteerSerializedElement, PuppeteerCreditCard, PuppeteerAutofillData, PuppeteerWaitForSelectorOptions, PuppeteerFrameAddScriptTagOptions, PuppeteerFrameAddStyleTagOptions, PuppeteerVisibilityOption, PuppeteerActionOptions, PuppeteerLocatorScrollOptions, PuppeteerLocatorClickOptions, PuppeteerSerializedAXNode, PuppeteerSnapshotOptions, PuppeteerTracingOptions, PuppeteerDialogType, PuppeteerDialog, PuppeteerConsoleMessageType, PuppeteerConsoleMessageLocation, PuppeteerConsoleMessage, PuppeteerRemoteObjectType, PuppeteerRemoteObjectSubtype, PuppeteerRemoteObject, PuppeteerTouchHandle, PuppeteerCSSCoverageOptions, PuppeteerJSCoverageOptions, PuppeteerCoverageRange, PuppeteerCoverageEntry, PuppeteerJSCoverageEntry, PuppeteerEventType, PuppeteerPageEvent, PuppeteerBrowserEvent, PuppeteerBrowserContextEvent, } from '../../contracts/drivers/puppeteer.js';
+import type { PuppeteerClickOptions, PuppeteerKeyInput, PuppeteerKeyboardTypeOptions, PuppeteerKeyPressOptions, PuppeteerScreenshotOptions, PuppeteerBoundingBox, PuppeteerBoxModel, PuppeteerDragData, PuppeteerAutofillData, PuppeteerWaitForSelectorOptions, PuppeteerPoint, PuppeteerHTTPRequest, PuppeteerHTTPResponse, PuppeteerConsoleMessage, PuppeteerDialog, PuppeteerFrame, PuppeteerTarget, PuppeteerWebWorker } from '../../contracts/drivers/puppeteer.js';
+export interface PuppeteerElementHandle {
+    click(options?: PuppeteerClickOptions): Promise<void>;
+    tap(): Promise<void>;
+    hover(): Promise<void>;
+    focus(): Promise<void>;
+    type(text: string, options?: PuppeteerKeyboardTypeOptions): Promise<void>;
+    press(key: PuppeteerKeyInput, options?: PuppeteerKeyPressOptions): Promise<void>;
+    select(...values: string[]): Promise<string[]>;
+    uploadFile(...filePaths: string[]): Promise<void>;
+    scrollIntoView(): Promise<void>;
+    autofill(data: PuppeteerAutofillData): Promise<void>;
+    $(selector: string): Promise<PuppeteerElementHandle | null>;
+    $$(selector: string): Promise<PuppeteerElementHandle[]>;
+    $x(expression: string): Promise<PuppeteerElementHandle[]>;
+    getProperty(propertyName: string): Promise<unknown>;
+    jsonValue(): Promise<unknown>;
+    backendNodeId(): Promise<number>;
+    isVisible(): Promise<boolean>;
+    isHidden(): Promise<boolean>;
+    isIntersectingViewport(options?: {
+        threshold?: number;
+    }): Promise<boolean>;
+    boundingBox(): Promise<PuppeteerBoundingBox | null>;
+    boxModel(): Promise<PuppeteerBoxModel | null>;
+    clickablePoint(offset?: PuppeteerPoint): Promise<PuppeteerPoint>;
+    screenshot(options?: PuppeteerScreenshotOptions): Promise<string | Buffer>;
+    evaluate<T = unknown>(pageFunction: string | ((element: Element, ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
+    $eval<T = unknown>(selector: string, pageFunction: string | ((element: Element, ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
+    $$eval<T = unknown>(selector: string, pageFunction: string | ((elements: Element[], ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
+    contentFrame(): Promise<unknown | null>;
+    frame(): Promise<unknown | null>;
+    drag(target: PuppeteerPoint | PuppeteerElementHandle): Promise<PuppeteerDragData | void>;
+    /** @deprecated Do not use. `dragenter` will automatically be performed during dragging. */
+    dragEnter(data?: PuppeteerDragData): Promise<void>;
+    /** @deprecated Do not use. `dragover` will automatically be performed during dragging. */
+    dragOver(data?: PuppeteerDragData): Promise<void>;
+    dragAndDrop(target: PuppeteerElementHandle | PuppeteerPoint, options?: {
+        delay?: number;
+    }): Promise<void>;
+    drop(element: PuppeteerElementHandle): Promise<void>;
+    touchStart(): Promise<TouchHandle>;
+    touchMove(touch?: TouchHandle): Promise<void>;
+    touchEnd(): Promise<void>;
+    waitForSelector(selector: string, options?: PuppeteerWaitForSelectorOptions): Promise<PuppeteerElementHandle | null>;
+    toElement<K extends keyof HTMLElementTagNameMap>(tagName: K): Promise<PuppeteerElementHandle>;
+    asLocator(): unknown;
+    dispose(): Promise<void>;
+}
+export interface TouchHandle {
+    /**
+     * Dispatches a `touchMove` event for this touch.
+     * @see https://pptr.dev/api/puppeteer.touchhandle.move
+     */
+    move(x: number, y: number): Promise<void>;
+    /**
+     * Dispatches a `touchend` event for this touch.
+     * @see https://pptr.dev/api/puppeteer.touchhandle.end
+     */
+    end(): Promise<void>;
+}
+export type EvaluateFunc<V = void, T = unknown> = V extends void ? string | ((...args: unknown[]) => T | Promise<T>) : string | ((first: V, ...args: unknown[]) => T | Promise<T>);
+export type PuppeteerEvaluateFunction<T = unknown> = EvaluateFunc<void, T>;
+export type PuppeteerEvalFunction<T = unknown> = EvaluateFunc<Element, T>;
+export type PuppeteerEvalAllFunction<T = unknown> = EvaluateFunc<Element[], T>;
+import type { PuppeteerGotoOptions, PuppeteerWaitForNavigationOptions, PuppeteerReloadOptions, PuppeteerWaitForOptions, PuppeteerViewport, PuppeteerCookie, PuppeteerPDFOptions, PuppeteerSelectValue } from '../../contracts/drivers/puppeteer.js';
+export interface PuppeteerPage {
+    goto(url: string, options?: PuppeteerGotoOptions): Promise<PuppeteerHTTPResponse | null>;
+    reload(options?: PuppeteerReloadOptions): Promise<PuppeteerHTTPResponse | null>;
+    goBack(options?: PuppeteerWaitForNavigationOptions): Promise<PuppeteerHTTPResponse | null>;
+    goForward(options?: PuppeteerWaitForNavigationOptions): Promise<PuppeteerHTTPResponse | null>;
+    url(): string;
+    title(): Promise<string>;
+    content(): Promise<string>;
+    click(selector: string, options?: PuppeteerClickOptions): Promise<void>;
+    type(selector: string, text: string, options?: PuppeteerKeyboardTypeOptions): Promise<void>;
+    focus(selector: string): Promise<void>;
+    hover(selector: string): Promise<void>;
+    select(selector: string, ...values: PuppeteerSelectValue[]): Promise<string[]>;
+    $(selector: string): Promise<PuppeteerElementHandle | null>;
+    $$(selector: string): Promise<PuppeteerElementHandle[]>;
+    $eval<T>(selector: string, pageFunction: PuppeteerEvalFunction<T>, ...args: unknown[]): Promise<T>;
+    $$eval<T>(selector: string, pageFunction: PuppeteerEvalAllFunction<T>, ...args: unknown[]): Promise<T>;
+    waitForSelector(selector: string, options?: PuppeteerWaitForOptions): Promise<PuppeteerElementHandle | null>;
+    waitForNavigation(options?: PuppeteerWaitForNavigationOptions): Promise<PuppeteerHTTPResponse | null>;
+    waitForTimeout(timeout: number): Promise<void>;
+    evaluate<T>(pageFunction: PuppeteerEvaluateFunction<T>, ...args: unknown[]): Promise<T>;
+    evaluateHandle<T>(pageFunction: PuppeteerEvaluateFunction<T>, ...args: unknown[]): Promise<unknown>;
+    screenshot(options?: PuppeteerScreenshotOptions): Promise<string | Buffer>;
+    pdf(options?: PuppeteerPDFOptions): Promise<Buffer>;
+    setViewport(viewport: PuppeteerViewport | null): Promise<void>;
+    viewport(): PuppeteerViewport | null;
+    cookies(...urls: string[]): Promise<PuppeteerCookie[]>;
+    setCookie(...cookies: PuppeteerCookie[]): Promise<void>;
+    deleteCookie(...cookies: {
+        name: string;
+        domain?: string;
+        path?: string;
+    }[]): Promise<void>;
+    close(): Promise<void>;
+    isClosed(): boolean;
+    bringToFront(): Promise<void>;
+}
+/**
+ * PageEvents - maps event names to their payload types.
+ * @see https://pptr.dev/api/puppeteer.pageevents
+ */
+export interface PageEvents extends Record<string, unknown> {
+    /** Emitted when the page closes. */
+    close: undefined;
+    /** Emitted when JavaScript within the page calls console API methods. */
+    console: PuppeteerConsoleMessage;
+    /** Emitted when a JavaScript dialog appears (alert, prompt, confirm, beforeunload). */
+    dialog: PuppeteerDialog;
+    /** Emitted when the JavaScript DOMContentLoaded event is dispatched. */
+    domcontentloaded: undefined;
+    /** Emitted when the page crashes. */
+    error: Error;
+    /** Emitted when a frame is attached. */
+    frameattached: PuppeteerFrame;
+    /** Emitted when a frame is detached. */
+    framedetached: PuppeteerFrame;
+    /** Emitted when a frame is navigated to a new URL. */
+    framenavigated: PuppeteerFrame;
+    /** Emitted when the JavaScript load event is dispatched. */
+    load: undefined;
+    /** Emitted when console.timeStamp is called. */
+    metrics: {
+        title: string;
+        metrics: Record<string, number>;
+    };
+    /** Emitted when an uncaught exception happens within the page. */
+    pageerror: Error | unknown;
+    /** Emitted when the page opens a new tab or window. */
+    popup: PuppeteerPage | null;
+    /** Emitted when a page issues a request. */
+    request: PuppeteerHTTPRequest;
+    /** Emitted when a request fails. */
+    requestfailed: PuppeteerHTTPRequest;
+    /** Emitted when a request finishes successfully. */
+    requestfinished: PuppeteerHTTPRequest;
+    /** Emitted when a request is served from cache. */
+    requestservedfromcache: PuppeteerHTTPRequest;
+    /** Emitted when a response is received. */
+    response: PuppeteerHTTPResponse;
+    /** Emitted when a dedicated WebWorker is spawned by the page. */
+    workercreated: PuppeteerWebWorker;
+    /** Emitted when a dedicated WebWorker is destroyed by the page. */
+    workerdestroyed: PuppeteerWebWorker;
+}
+/**
+ * BrowserEvents - maps event names to their payload types.
+ * @see https://pptr.dev/api/puppeteer.browserevents
+ */
+export interface BrowserEvents extends Record<string, unknown> {
+    /** Emitted when the browser is disconnected. */
+    disconnected: undefined;
+    /** Emitted when the URL of a target changes. */
+    targetchanged: PuppeteerTarget;
+    /** Emitted when a target is created. */
+    targetcreated: PuppeteerTarget;
+    /** Emitted when a target is destroyed. */
+    targetdestroyed: PuppeteerTarget;
+}
+/**
+ * BrowserContextEvents - maps event names to their payload types.
+ * @see https://pptr.dev/api/puppeteer.browsercontextevents
+ */
+export interface BrowserContextEvents extends Record<string, unknown> {
+    /** Emitted when the URL of a target inside the context changes. */
+    targetchanged: PuppeteerTarget;
+    /** Emitted when a target is created inside the context. */
+    targetcreated: PuppeteerTarget;
+    /** Emitted when a target is destroyed inside the context. */
+    targetdestroyed: PuppeteerTarget;
+}

package/dist/drivers/puppeteer/types.js

@@ -0,0 +1,8 @@
+// ============================================================================
+// Puppeteer Type Definitions
+// ============================================================================
+//
+// Driver option and payload types live in the SDK-local generated contract module.
+// This file contains interface definitions for runtime objects with methods.
+// ============================================================================
+export {};

package/dist/drivers/selenium/driver.d.ts

@@ -0,0 +1,28 @@
+import type { WebDriver, WebElement, LocatorStrategy, Navigation, Options, TargetLocator } from './types.js';
+import { type RpcSender } from '../../internal/transport.js';
+/**
+ * Remote WebDriver implementation over RPC.
+ * Implements the Selenium WebDriver interface.
+ */
+export declare class RemoteWebDriver implements WebDriver {
+    private sendRpc;
+    readonly pageId: string;
+    constructor(pageId: string, sendRpc: RpcSender);
+    private rpc;
+    get(url: string): Promise<void>;
+    getCurrentUrl(): Promise<string>;
+    getTitle(): Promise<string>;
+    getPageSource(): Promise<string>;
+    close(): Promise<void>;
+    quit(): Promise<void>;
+    findElement(locator: LocatorStrategy): Promise<WebElement>;
+    findElements(locator: LocatorStrategy): Promise<WebElement[]>;
+    executeScript<T>(script: string | ((...args: unknown[]) => T), ...args: unknown[]): Promise<T>;
+    executeAsyncScript<T>(script: string | ((...args: unknown[]) => T), ...args: unknown[]): Promise<T>;
+    takeScreenshot(): Promise<string>;
+    getWindowHandle(): Promise<string>;
+    getAllWindowHandles(): Promise<string[]>;
+    navigate(): Navigation;
+    manage(): Options;
+    switchTo(): TargetLocator;
+}

package/dist/drivers/selenium/driver.js

@@ -0,0 +1,169 @@
+// ============================================================================
+// RemoteWebDriver - WebDriver over RPC
+// ============================================================================
+import { RemoteWebElement } from './element.js';
+import { serializeFunctionSource } from '../../internal/transport.js';
+/**
+ * Remote WebDriver implementation over RPC.
+ * Implements the Selenium WebDriver interface.
+ */
+export class RemoteWebDriver {
+    sendRpc;
+    pageId;
+    constructor(pageId, sendRpc) {
+        this.sendRpc = sendRpc;
+        this.pageId = pageId;
+    }
+    rpc(method, args = []) {
+        return this.sendRpc('selenium', method, args, { pageId: this.pageId });
+    }
+    // Navigation
+    async get(url) {
+        await this.rpc('get', [url]);
+    }
+    async getCurrentUrl() {
+        return this.rpc('getCurrentUrl');
+    }
+    async getTitle() {
+        return this.rpc('getTitle');
+    }
+    async getPageSource() {
+        return this.rpc('getPageSource');
+    }
+    async close() {
+        await this.rpc('close');
+    }
+    async quit() {
+        await this.rpc('quit');
+    }
+    // Element finding
+    async findElement(locator) {
+        const elementId = await this.rpc('findElement', [locator]);
+        return new RemoteWebElement(elementId, this.pageId, this.sendRpc);
+    }
+    async findElements(locator) {
+        const elementIds = await this.rpc('findElements', [locator]);
+        return elementIds.map((id) => new RemoteWebElement(id, this.pageId, this.sendRpc));
+    }
+    // Script execution
+    async executeScript(script, ...args) {
+        const scriptStr = serializeFunctionSource(script);
+        return this.rpc('executeScript', [scriptStr, args]);
+    }
+    async executeAsyncScript(script, ...args) {
+        const scriptStr = serializeFunctionSource(script);
+        return this.rpc('executeAsyncScript', [scriptStr, args]);
+    }
+    // Screenshot
+    async takeScreenshot() {
+        return this.rpc('takeScreenshot');
+    }
+    // Window handles
+    async getWindowHandle() {
+        return this.rpc('getWindowHandle');
+    }
+    async getAllWindowHandles() {
+        return this.rpc('getAllWindowHandles');
+    }
+    // Navigation sub-interface
+    navigate() {
+        return {
+            to: async (url) => {
+                await this.rpc('navigate.to', [url]);
+            },
+            back: async () => {
+                await this.rpc('navigate.back');
+            },
+            forward: async () => {
+                await this.rpc('navigate.forward');
+            },
+            refresh: async () => {
+                await this.rpc('navigate.refresh');
+            },
+        };
+    }
+    // Options/manage sub-interface
+    manage() {
+        // Use arrow function to preserve 'this' and generic types
+        const rpc = (method, args = []) => this.rpc(method, args);
+        return {
+            addCookie: async (cookie) => {
+                await rpc('manage.addCookie', [cookie]);
+            },
+            deleteAllCookies: async () => {
+                await rpc('manage.deleteAllCookies');
+            },
+            deleteCookie: async (name) => {
+                await rpc('manage.deleteCookie', [name]);
+            },
+            getCookie: async (name) => {
+                return rpc('manage.getCookie', [name]);
+            },
+            getCookies: async () => {
+                return rpc('manage.getCookies');
+            },
+            window: () => ({
+                getRect: async () => {
+                    return rpc('manage.window.getRect');
+                },
+                setRect: async (rect) => {
+                    await rpc('manage.window.setRect', [rect]);
+                },
+                maximize: async () => {
+                    await rpc('manage.window.maximize');
+                },
+                minimize: async () => {
+                    await rpc('manage.window.minimize');
+                },
+                fullscreen: async () => {
+                    await rpc('manage.window.fullscreen');
+                },
+            }),
+        };
+    }
+    // Target locator (switchTo)
+    switchTo() {
+        // Use arrow function to preserve 'this' and generic types
+        const rpc = (method, args = []) => this.rpc(method, args);
+        const sendRpc = this.sendRpc;
+        const pageId = this.pageId;
+        return {
+            window: async (nameOrHandle) => {
+                await rpc('switchTo.window', [nameOrHandle]);
+            },
+            frame: async (indexOrElement) => {
+                const arg = indexOrElement instanceof RemoteWebElement
+                    ? { elementId: indexOrElement.id }
+                    : indexOrElement;
+                await rpc('switchTo.frame', [arg]);
+            },
+            parentFrame: async () => {
+                await rpc('switchTo.parentFrame');
+            },
+            activeElement: async () => {
+                const elementId = await rpc('switchTo.activeElement');
+                return new RemoteWebElement(elementId, pageId, sendRpc);
+            },
+            alert: async () => {
+                await rpc('switchTo.alert');
+                return {
+                    accept: async () => {
+                        await rpc('alert.accept');
+                    },
+                    dismiss: async () => {
+                        await rpc('alert.dismiss');
+                    },
+                    getText: async () => {
+                        return rpc('alert.getText');
+                    },
+                    sendKeys: async (text) => {
+                        await rpc('alert.sendKeys', [text]);
+                    },
+                };
+            },
+            defaultContent: async () => {
+                await rpc('switchTo.defaultContent');
+            },
+        };
+    }
+}

package/dist/drivers/selenium/element.d.ts

@@ -0,0 +1,34 @@
+import type { WebElement, LocatorStrategy } from './types.js';
+import type { RpcSender } from '../../internal/transport.js';
+/**
+ * Remote WebElement implementation over RPC.
+ * Implements the WebDriver WebElement interface.
+ */
+export declare class RemoteWebElement implements WebElement {
+    private elementId;
+    private pageId;
+    private sendRpc;
+    constructor(elementId: string, pageId: string, sendRpc: RpcSender);
+    get id(): string;
+    private rpc;
+    click(): Promise<void>;
+    sendKeys(...text: string[]): Promise<void>;
+    clear(): Promise<void>;
+    getText(): Promise<string>;
+    getAttribute(name: string): Promise<string | null>;
+    getCssValue(propertyName: string): Promise<string>;
+    getTagName(): Promise<string>;
+    isDisplayed(): Promise<boolean>;
+    isEnabled(): Promise<boolean>;
+    isSelected(): Promise<boolean>;
+    submit(): Promise<void>;
+    getRect(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    takeScreenshot(): Promise<string>;
+    findElement(locator: LocatorStrategy): Promise<WebElement>;
+    findElements(locator: LocatorStrategy): Promise<WebElement[]>;
+}

package/dist/drivers/selenium/element.js

@@ -0,0 +1,73 @@
+// ============================================================================
+// RemoteWebElement - WebDriver Element over RPC
+// ============================================================================
+/**
+ * Remote WebElement implementation over RPC.
+ * Implements the WebDriver WebElement interface.
+ */
+export class RemoteWebElement {
+    elementId;
+    pageId;
+    sendRpc;
+    constructor(elementId, pageId, sendRpc) {
+        this.elementId = elementId;
+        this.pageId = pageId;
+        this.sendRpc = sendRpc;
+    }
+    get id() {
+        return this.elementId;
+    }
+    rpc(method, args = []) {
+        return this.sendRpc('selenium-element', method, [this.elementId, ...args], {
+            pageId: this.pageId,
+        });
+    }
+    async click() {
+        await this.rpc('click');
+    }
+    async sendKeys(...text) {
+        await this.rpc('sendKeys', [text.join('')]);
+    }
+    async clear() {
+        await this.rpc('clear');
+    }
+    async getText() {
+        return this.rpc('getText');
+    }
+    async getAttribute(name) {
+        return this.rpc('getAttribute', [name]);
+    }
+    async getCssValue(propertyName) {
+        return this.rpc('getCssValue', [propertyName]);
+    }
+    async getTagName() {
+        return this.rpc('getTagName');
+    }
+    async isDisplayed() {
+        return this.rpc('isDisplayed');
+    }
+    async isEnabled() {
+        return this.rpc('isEnabled');
+    }
+    async isSelected() {
+        return this.rpc('isSelected');
+    }
+    async submit() {
+        await this.rpc('submit');
+    }
+    async getRect() {
+        return this.rpc('getRect');
+    }
+    async takeScreenshot() {
+        return this.rpc('takeScreenshot');
+    }
+    // Additional methods for finding child elements
+    async findElement(locator) {
+        const elementId = await this.rpc('findElement', [locator]);
+        return new RemoteWebElement(elementId, this.pageId, this.sendRpc);
+    }
+    async findElements(locator) {
+        const elementIds = await this.rpc('findElements', [locator]);
+        return elementIds.map((id) => new RemoteWebElement(id, this.pageId, this.sendRpc));
+    }
+}

package/dist/drivers/selenium/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export { RemoteWebDriver } from './driver.js';
+export { RemoteWebElement } from './element.js';

package/dist/drivers/selenium/index.js

@@ -0,0 +1,5 @@
+// Selenium driver exports.
+// Re-export types and classes
+export * from './types.js';
+export { RemoteWebDriver } from './driver.js';
+export { RemoteWebElement } from './element.js';

package/dist/drivers/selenium/types.d.ts

@@ -0,0 +1,2 @@
+export { SeleniumCookieSchema, SeleniumRectSchema, SeleniumSetRectSchema, LocatorByCssSchema, LocatorByXpathSchema, LocatorByIdSchema, LocatorByNameSchema, LocatorByClassNameSchema, LocatorByLinkTextSchema, LocatorByPartialLinkTextSchema, LocatorByTagNameSchema, LocatorStrategySchema, By, } from '../../contracts/drivers/selenium.js';
+export type { Cookie, SeleniumRect, SeleniumSetRect, LocatorStrategy, WebElement, Navigation, Window, Options, Alert, TargetLocator, WebDriver, } from '../../contracts/drivers/selenium.js';

package/dist/drivers/selenium/types.js

@@ -0,0 +1,12 @@
+// ============================================================================
+// Selenium/WebDriver Type Definitions
+// ============================================================================
+//
+// Public Selenium types are localized into the SDK so the package ships without
+// internal workspace dependencies.
+// ============================================================================
+export { 
+// Zod schemas (for validation)
+SeleniumCookieSchema, SeleniumRectSchema, SeleniumSetRectSchema, LocatorByCssSchema, LocatorByXpathSchema, LocatorByIdSchema, LocatorByNameSchema, LocatorByClassNameSchema, LocatorByLinkTextSchema, LocatorByPartialLinkTextSchema, LocatorByTagNameSchema, LocatorStrategySchema, 
+// Runtime helper
+By, } from '../../contracts/drivers/selenium.js';