@bctrl/sdk 1.0.1

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

@@ -0,0 +1,148 @@
+export type { PlaywrightGotoOptions, PlaywrightReloadOptions, PlaywrightGoBackOptions, PlaywrightGoForwardOptions, PlaywrightNavigationOptions, PlaywrightWaitUntil, WaitUntilState, PlaywrightWaitForSelectorOptions, PlaywrightWaitForLoadStateOptions, PlaywrightWaitForURLOptions, PlaywrightWaitForNavigationOptions, PlaywrightWaitForOptions, PlaywrightWaitForFunctionOptions, PlaywrightMouseButton, PlaywrightMouseClickOptions, PlaywrightMouseDblclickOptions, PlaywrightMouseMoveOptions, PlaywrightMouseDownUpOptions, PlaywrightKeyboardOptions, PlaywrightKeyboardPressOptions, PlaywrightKeyboardTypeOptions, PlaywrightModifiers, PlaywrightPosition, PlaywrightClickOptions, PlaywrightDblclickOptions, PlaywrightFillOptions, PlaywrightTypeOptions, PlaywrightPressOptions, PlaywrightPressSequentiallyOptions, PlaywrightCheckOptions, PlaywrightUncheckOptions, PlaywrightSetCheckedOptions, PlaywrightSelectOptionOptions, PlaywrightSelectOption, PlaywrightSelectOptionValue, PlaywrightHoverOptions, PlaywrightFocusOptions, PlaywrightBlurOptions, PlaywrightTapOptions, PlaywrightClearOptions, PlaywrightTextContentOptions, PlaywrightInnerTextOptions, PlaywrightInnerHTMLOptions, PlaywrightGetAttributeOptions, PlaywrightInputValueOptions, PlaywrightIsOptions, PlaywrightElementState, PlaywrightEvaluateOptions, PlaywrightClipRegion, PlaywrightScreenshotOptions, PlaywrightPageScreenshotOptions, PlaywrightPDFMargin, PlaywrightPDFOptions, PlaywrightGetByRoleOptions, PlaywrightGetByTextOptions, PlaywrightGetByLabelOptions, PlaywrightGetByPlaceholderOptions, PlaywrightGetByAltTextOptions, PlaywrightGetByTitleOptions, PlaywrightGetByTestIdOptions, PlaywrightFilterOptions, PlaywrightAriaRole, PlaywrightViewport, PlaywrightViewportSize, PlaywrightGeolocation, PlaywrightHttpCredentials, PlaywrightHTTPCredentials, PlaywrightNewContextOptions, PlaywrightNewPageOptions, PlaywrightBoundingBoxResult, PlaywrightBoundingBox, PlaywrightBoundingBoxOptions, LocatorChainStep, SerializedLocatorChain, PlaywrightTracingStartOptions, PlaywrightTracingStopOptions, PlaywrightStartTracingOptions, PlaywrightConsoleMessageType, PlaywrightConsoleMessageLocation, PlaywrightStartCSSCoverageOptions, PlaywrightStartJSCoverageOptions, PlaywrightCSSCoverageEntry, PlaywrightJSCoverageEntry, PlaywrightDialogType, PlaywrightCookie, PlaywrightClearCookiesOptions, PlaywrightPermission, PlaywrightGrantPermissionsOptions, PlaywrightRouteOptions, PlaywrightRouteFromHAROptions, PlaywrightUnrouteAllOptions, PlaywrightStorageState, PlaywrightStorageStateOptions, PlaywrightWaitForEventOptions, PlaywrightEventInit, PlaywrightDispatchEventOptions, PlaywrightTimeoutOptions, PlaywrightFilePayload, FilePayload, PlaywrightSetInputFilesOptions, PlaywrightScrollIntoViewOptions, PlaywrightScrollIntoViewIfNeededOptions, PlaywrightDragToOptions, PlaywrightDragAndDropOptions, PlaywrightSetContentOptions, PlaywrightAddScriptTagOptions, PlaywrightAddStyleTagOptions, PlaywrightEmulateMediaOptions, PlaywrightLoadState, LoadState, PlaywrightRequest, PlaywrightResponse, PlaywrightRouteHandler, PlaywrightAPIResponse, PlaywrightAPIRequestOptions, PlaywrightConsoleMessage, PlaywrightWebSocketRoute, PlaywrightAddLocatorHandlerOptions, } from '../../contracts/drivers/playwright.js';
+export type { PageEvents, PlaywrightPageEvents, } from '../../contracts/drivers/playwright.js';
+export type { SelectOption } from '../../base/types.js';
+import type { PlaywrightMouseClickOptions, PlaywrightMouseMoveOptions, PlaywrightKeyboardOptions, PlaywrightClickOptions, PlaywrightFillOptions, PlaywrightTypeOptions, PlaywrightPressOptions, PlaywrightCheckOptions, PlaywrightSelectOptionOptions, PlaywrightHoverOptions, PlaywrightFocusOptions, PlaywrightTextContentOptions, PlaywrightInnerTextOptions, PlaywrightInnerHTMLOptions, PlaywrightGetAttributeOptions, PlaywrightInputValueOptions, PlaywrightIsOptions, PlaywrightWaitForOptions, PlaywrightScreenshotOptions, PlaywrightGetByRoleOptions, PlaywrightGetByTextOptions, PlaywrightGetByLabelOptions, PlaywrightGetByPlaceholderOptions, PlaywrightGetByAltTextOptions, PlaywrightGetByTitleOptions, PlaywrightGotoOptions, PlaywrightReloadOptions, PlaywrightGoBackOptions, PlaywrightGoForwardOptions, PlaywrightWaitForSelectorOptions, PlaywrightWaitForLoadStateOptions, PlaywrightWaitForURLOptions, PlaywrightPageScreenshotOptions, PlaywrightPDFOptions, PlaywrightNewContextOptions, PlaywrightNewPageOptions, PlaywrightBoundingBoxResult, SerializedLocatorChain } from '../../contracts/drivers/playwright.js';
+export interface PlaywrightMouse {
+    click(x: number, y: number, options?: PlaywrightMouseClickOptions): Promise<void>;
+    dblclick(x: number, y: number, options?: PlaywrightMouseClickOptions): Promise<void>;
+    down(options?: {
+        button?: 'left' | 'right' | 'middle';
+    }): Promise<void>;
+    up(options?: {
+        button?: 'left' | 'right' | 'middle';
+    }): Promise<void>;
+    move(x: number, y: number, options?: PlaywrightMouseMoveOptions): Promise<void>;
+    wheel(deltaX: number, deltaY: number): Promise<void>;
+}
+export interface PlaywrightKeyboard {
+    down(key: string): Promise<void>;
+    up(key: string): Promise<void>;
+    press(key: string, options?: PlaywrightKeyboardOptions): Promise<void>;
+    type(text: string, options?: PlaywrightKeyboardOptions): Promise<void>;
+    insertText(text: string): Promise<void>;
+}
+export interface PlaywrightLocatorOptions {
+    has?: PlaywrightLocator | SerializedLocatorChain;
+    hasNot?: PlaywrightLocator | SerializedLocatorChain;
+    hasText?: string | RegExp;
+    hasNotText?: string | RegExp;
+}
+export interface PlaywrightLocatorFilterOptions {
+    has?: PlaywrightLocator | SerializedLocatorChain;
+    hasNot?: PlaywrightLocator | SerializedLocatorChain;
+    hasText?: string | RegExp;
+    hasNotText?: string | RegExp;
+}
+export interface PlaywrightLocator {
+    locator(selector: string, options?: PlaywrightLocatorOptions): PlaywrightLocator;
+    filter(options: PlaywrightLocatorFilterOptions): PlaywrightLocator;
+    first(): PlaywrightLocator;
+    last(): PlaywrightLocator;
+    nth(index: number): PlaywrightLocator;
+    and(locator: PlaywrightLocator): PlaywrightLocator;
+    or(locator: PlaywrightLocator): PlaywrightLocator;
+    getByRole(role: string, options?: PlaywrightGetByRoleOptions): PlaywrightLocator;
+    getByText(text: string | RegExp, options?: PlaywrightGetByTextOptions): PlaywrightLocator;
+    getByLabel(text: string | RegExp, options?: PlaywrightGetByLabelOptions): PlaywrightLocator;
+    getByPlaceholder(text: string | RegExp, options?: PlaywrightGetByPlaceholderOptions): PlaywrightLocator;
+    getByAltText(text: string | RegExp, options?: PlaywrightGetByAltTextOptions): PlaywrightLocator;
+    getByTitle(text: string | RegExp, options?: PlaywrightGetByTitleOptions): PlaywrightLocator;
+    getByTestId(testId: string): PlaywrightLocator;
+    click(options?: PlaywrightClickOptions): Promise<void>;
+    dblclick(options?: PlaywrightClickOptions): Promise<void>;
+    fill(value: string, options?: PlaywrightFillOptions): Promise<void>;
+    type(text: string, options?: PlaywrightTypeOptions): Promise<void>;
+    press(key: string, options?: PlaywrightPressOptions): Promise<void>;
+    check(options?: PlaywrightCheckOptions): Promise<void>;
+    uncheck(options?: PlaywrightCheckOptions): Promise<void>;
+    selectOption(values: string | string[] | {
+        value?: string;
+        label?: string;
+        index?: number;
+    }, options?: PlaywrightSelectOptionOptions): Promise<string[]>;
+    hover(options?: PlaywrightHoverOptions): Promise<void>;
+    focus(options?: PlaywrightFocusOptions): Promise<void>;
+    clear(options?: PlaywrightFillOptions): Promise<void>;
+    count(): Promise<number>;
+    textContent(options?: PlaywrightTextContentOptions): Promise<string | null>;
+    innerText(options?: PlaywrightInnerTextOptions): Promise<string>;
+    innerHTML(options?: PlaywrightInnerHTMLOptions): Promise<string>;
+    getAttribute(name: string, options?: PlaywrightGetAttributeOptions): Promise<string | null>;
+    inputValue(options?: PlaywrightInputValueOptions): Promise<string>;
+    isVisible(options?: PlaywrightIsOptions): Promise<boolean>;
+    isHidden(options?: PlaywrightIsOptions): Promise<boolean>;
+    isEnabled(options?: PlaywrightIsOptions): Promise<boolean>;
+    isDisabled(options?: PlaywrightIsOptions): Promise<boolean>;
+    isChecked(options?: PlaywrightIsOptions): Promise<boolean>;
+    isEditable(options?: PlaywrightIsOptions): Promise<boolean>;
+    waitFor(options?: PlaywrightWaitForOptions): Promise<void>;
+    boundingBox(options?: {
+        timeout?: number;
+    }): Promise<PlaywrightBoundingBoxResult | null>;
+    screenshot(options?: PlaywrightScreenshotOptions): Promise<Buffer>;
+    evaluate<R, Arg = unknown>(pageFunction: (element: Element, arg: Arg) => R | Promise<R>, arg?: Arg): Promise<R>;
+    evaluateAll<R, Arg = unknown>(pageFunction: (elements: Element[], arg: Arg) => R | Promise<R>, arg?: Arg): Promise<R>;
+}
+export interface PlaywrightPage {
+    locator(selector: string, options?: PlaywrightLocatorOptions): PlaywrightLocator;
+    getByRole(role: string, options?: PlaywrightGetByRoleOptions): PlaywrightLocator;
+    getByText(text: string | RegExp, options?: PlaywrightGetByTextOptions): PlaywrightLocator;
+    getByLabel(text: string | RegExp, options?: PlaywrightGetByLabelOptions): PlaywrightLocator;
+    getByPlaceholder(text: string | RegExp, options?: PlaywrightGetByPlaceholderOptions): PlaywrightLocator;
+    getByAltText(text: string | RegExp, options?: PlaywrightGetByAltTextOptions): PlaywrightLocator;
+    getByTitle(text: string | RegExp, options?: PlaywrightGetByTitleOptions): PlaywrightLocator;
+    getByTestId(testId: string): PlaywrightLocator;
+    goto(url: string, options?: PlaywrightGotoOptions): Promise<void>;
+    reload(options?: PlaywrightReloadOptions): Promise<void>;
+    goBack(options?: PlaywrightGoBackOptions): Promise<void>;
+    goForward(options?: PlaywrightGoForwardOptions): Promise<void>;
+    url(): string;
+    title(): Promise<string>;
+    content(): Promise<string>;
+    mouse: PlaywrightMouse;
+    keyboard: PlaywrightKeyboard;
+    click(selector: string, options?: PlaywrightClickOptions): Promise<void>;
+    fill(selector: string, value: string, options?: PlaywrightFillOptions): Promise<void>;
+    check(selector: string, options?: PlaywrightCheckOptions): Promise<void>;
+    uncheck(selector: string, options?: PlaywrightCheckOptions): Promise<void>;
+    isChecked(selector: string, options?: PlaywrightIsOptions): Promise<boolean>;
+    selectOption(selector: string, values: string | string[] | {
+        value?: string;
+        label?: string;
+        index?: number;
+    }, options?: PlaywrightSelectOptionOptions): Promise<string[]>;
+    waitForSelector(selector: string, options?: PlaywrightWaitForSelectorOptions): Promise<void>;
+    waitForLoadState(state?: 'load' | 'domcontentloaded' | 'networkidle', options?: PlaywrightWaitForLoadStateOptions): Promise<void>;
+    waitForTimeout(timeout: number): Promise<void>;
+    waitForURL(url: string | RegExp | ((url: URL) => boolean), options?: PlaywrightWaitForURLOptions): Promise<void>;
+    evaluate<R, Arg>(pageFunction: (arg: Arg) => R | Promise<R>, arg?: Arg): Promise<R>;
+    evaluateHandle<R, Arg>(pageFunction: (arg: Arg) => R | Promise<R>, arg?: Arg): Promise<unknown>;
+    screenshot(options?: PlaywrightPageScreenshotOptions): Promise<Buffer>;
+    pdf(options?: PlaywrightPDFOptions): Promise<Buffer>;
+    close(): Promise<void>;
+    isClosed(): boolean;
+    context(): PlaywrightBrowserContext | null;
+    setViewportSize(viewportSize: {
+        width: number;
+        height: number;
+    }): Promise<void>;
+    viewportSize(): {
+        width: number;
+        height: number;
+    } | null;
+    bringToFront(): Promise<void>;
+}
+export interface PlaywrightBrowserContext {
+    newPage(): Promise<PlaywrightPage>;
+    pages(): PlaywrightPage[];
+    close(): Promise<void>;
+    browser(): PlaywrightBrowser | null;
+}
+export interface PlaywrightBrowser {
+    newContext(options?: PlaywrightNewContextOptions): Promise<PlaywrightBrowserContext>;
+    newPage(options?: PlaywrightNewPageOptions): Promise<PlaywrightPage>;
+    contexts(): PlaywrightBrowserContext[];
+    close(): Promise<void>;
+    isConnected(): boolean;
+    version(): Promise<string>;
+}

package/dist/drivers/playwright/types.js

@@ -0,0 +1,8 @@
+// ============================================================================
+// Playwright 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/puppeteer/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Base error class for all Puppeteer errors.
+ * @see https://pptr.dev/api/puppeteer.puppeteererror
+ */
+export declare class PuppeteerError extends Error {
+    constructor(message?: string);
+}
+/**
+ * TimeoutError is thrown when an operation times out.
+ *
+ * @example
+ * ```typescript
+ * import { TimeoutError } from 'bctrl';
+ *
+ * try {
+ *   await page.waitForSelector('.element', { timeout: 5000 });
+ * } catch (error) {
+ *   if (error instanceof TimeoutError) {
+ *     console.log('Element did not appear in time');
+ *   }
+ * }
+ * ```
+ *
+ * @see https://pptr.dev/api/puppeteer.timeouterror
+ */
+export declare class TimeoutError extends PuppeteerError {
+    constructor(message?: string);
+}
+/**
+ * ProtocolError is thrown when a CDP protocol error occurs.
+ * @see https://pptr.dev/api/puppeteer.protocolerror
+ */
+export declare class ProtocolError extends PuppeteerError {
+    /**
+     * The original CDP error code, if available.
+     */
+    code?: number;
+    /**
+     * The original CDP error message, if available.
+     */
+    originalMessage?: string;
+    constructor(message?: string, code?: number, originalMessage?: string);
+}
+/**
+ * UnsupportedOperation is thrown when an operation is not supported.
+ * @see https://pptr.dev/api/puppeteer.unsupportedoperation
+ */
+export declare class UnsupportedOperation extends PuppeteerError {
+    constructor(message?: string);
+}

package/dist/drivers/puppeteer/errors.js

@@ -0,0 +1,71 @@
+// ============================================================================
+// Puppeteer Error Classes
+// ============================================================================
+//
+// Custom error classes matching Puppeteer's error hierarchy.
+// @see https://pptr.dev/api/puppeteer.puppeteererror
+// ============================================================================
+/**
+ * Base error class for all Puppeteer errors.
+ * @see https://pptr.dev/api/puppeteer.puppeteererror
+ */
+export class PuppeteerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PuppeteerError';
+    }
+}
+/**
+ * TimeoutError is thrown when an operation times out.
+ *
+ * @example
+ * ```typescript
+ * import { TimeoutError } from 'bctrl';
+ *
+ * try {
+ *   await page.waitForSelector('.element', { timeout: 5000 });
+ * } catch (error) {
+ *   if (error instanceof TimeoutError) {
+ *     console.log('Element did not appear in time');
+ *   }
+ * }
+ * ```
+ *
+ * @see https://pptr.dev/api/puppeteer.timeouterror
+ */
+export class TimeoutError extends PuppeteerError {
+    constructor(message) {
+        super(message ?? 'Timeout exceeded');
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * ProtocolError is thrown when a CDP protocol error occurs.
+ * @see https://pptr.dev/api/puppeteer.protocolerror
+ */
+export class ProtocolError extends PuppeteerError {
+    /**
+     * The original CDP error code, if available.
+     */
+    code;
+    /**
+     * The original CDP error message, if available.
+     */
+    originalMessage;
+    constructor(message, code, originalMessage) {
+        super(message);
+        this.name = 'ProtocolError';
+        this.code = code;
+        this.originalMessage = originalMessage;
+    }
+}
+/**
+ * UnsupportedOperation is thrown when an operation is not supported.
+ * @see https://pptr.dev/api/puppeteer.unsupportedoperation
+ */
+export class UnsupportedOperation extends PuppeteerError {
+    constructor(message) {
+        super(message ?? 'This operation is not supported');
+        this.name = 'UnsupportedOperation';
+    }
+}

package/dist/drivers/puppeteer/event-emitter.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Handler function type for event listeners.
+ * @see https://pptr.dev/api/puppeteer.handler
+ */
+export type Handler<T = unknown> = (event: T) => void;
+/**
+ * The EventEmitter class that many Puppeteer classes extend.
+ *
+ * This provides a familiar event-driven interface for handling browser events
+ * like page load, console messages, dialogs, network requests, etc.
+ *
+ * @example
+ * ```ts
+ * page.on('console', msg => {
+ *   console.log('Page logged:', msg.text());
+ * });
+ *
+ * page.once('load', () => {
+ *   console.log('Page loaded!');
+ * });
+ * ```
+ *
+ * @see https://pptr.dev/api/puppeteer.eventemitter
+ */
+export declare class PuppeteerEventEmitter<Events extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * Map of event types to their listeners.
+     * @internal
+     */
+    private _listeners;
+    private notifyFirstListener;
+    private notifyNoListeners;
+    /**
+     * Bind an event listener to fire when an event occurs.
+     *
+     * @param type - The event type to listen for.
+     * @param handler - The function to call when the event occurs.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * page.on('request', request => {
+     *   console.log('Request:', request.url());
+     * });
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.on
+     */
+    on<Key extends keyof Events>(type: Key, handler: Handler<Events[Key]>): this;
+    /**
+     * Remove an event listener.
+     *
+     * If `handler` is provided, only that specific listener is removed.
+     * If `handler` is not provided, all listeners for that event type are removed.
+     *
+     * @param type - The event type.
+     * @param handler - Optional specific handler to remove.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * const handler = msg => console.log(msg);
+     * page.on('console', handler);
+     * // Later...
+     * page.off('console', handler);
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.off
+     */
+    off<Key extends keyof Events>(type: Key, handler?: Handler<Events[Key]>): this;
+    /**
+     * Bind an event listener that will fire only once.
+     *
+     * After the handler is called once, it is automatically removed.
+     *
+     * @param type - The event type to listen for.
+     * @param handler - The function to call when the event occurs.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * page.once('load', () => {
+     *   console.log('Page loaded for the first time!');
+     * });
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.once
+     */
+    once<Key extends keyof Events>(type: Key, handler: Handler<Events[Key]>): this;
+    /**
+     * Emit an event, calling all registered handlers.
+     *
+     * This method is typically used internally by Puppeteer classes to dispatch
+     * events. Users rarely need to call this directly.
+     *
+     * @param type - The event type to emit.
+     * @param event - The event data to pass to handlers.
+     * @returns `true` if there were listeners for this event, `false` otherwise.
+     *
+     * @example
+     * ```ts
+     * // Internal usage example
+     * this.emit('console', consoleMessage);
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.emit
+     */
+    emit<Key extends keyof Events>(type: Key, event: Events[Key]): boolean;
+    /**
+     * Get the count of listeners for a specific event type.
+     *
+     * @param type - The event type.
+     * @returns The number of registered listeners.
+     *
+     * @example
+     * ```ts
+     * const count = page.listenerCount('request');
+     * console.log(`There are ${count} request listeners`);
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.listenercount
+     */
+    listenerCount<Key extends keyof Events>(type: Key): number;
+    /**
+     * Remove all listeners.
+     *
+     * If `type` is provided, only listeners for that event type are removed.
+     * If `type` is not provided, all listeners for all event types are removed.
+     *
+     * @param type - Optional event type to remove listeners for.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * // Remove all 'request' listeners
+     * page.removeAllListeners('request');
+     *
+     * // Remove ALL listeners
+     * page.removeAllListeners();
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.removealllisteners
+     */
+    removeAllListeners<Key extends keyof Events>(type?: Key): this;
+}

package/dist/drivers/puppeteer/event-emitter.js

@@ -0,0 +1,259 @@
+// ============================================================================
+// PuppeteerEventEmitter - EventEmitter base class for Puppeteer SDK
+// ============================================================================
+//
+// This class provides an EventEmitter implementation that matches the real
+// Puppeteer EventEmitter API 1:1. It supports local event handling on the SDK
+// side and can be extended by Page, Browser, and other classes.
+//
+// @see https://pptr.dev/api/puppeteer.eventemitter
+// ============================================================================
+import { getRemoteListenerBinding } from '../../base/event-binding.js';
+/**
+ * The EventEmitter class that many Puppeteer classes extend.
+ *
+ * This provides a familiar event-driven interface for handling browser events
+ * like page load, console messages, dialogs, network requests, etc.
+ *
+ * @example
+ * ```ts
+ * page.on('console', msg => {
+ *   console.log('Page logged:', msg.text());
+ * });
+ *
+ * page.once('load', () => {
+ *   console.log('Page loaded!');
+ * });
+ * ```
+ *
+ * @see https://pptr.dev/api/puppeteer.eventemitter
+ */
+export class PuppeteerEventEmitter {
+    /**
+     * Map of event types to their listeners.
+     * @internal
+     */
+    _listeners = new Map();
+    notifyFirstListener(event) {
+        const binding = getRemoteListenerBinding(this);
+        if (!binding)
+            return;
+        binding.onFirstListener(String(event));
+    }
+    notifyNoListeners(event) {
+        const binding = getRemoteListenerBinding(this);
+        if (!binding)
+            return;
+        binding.onNoListeners(String(event));
+    }
+    /**
+     * Bind an event listener to fire when an event occurs.
+     *
+     * @param type - The event type to listen for.
+     * @param handler - The function to call when the event occurs.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * page.on('request', request => {
+     *   console.log('Request:', request.url());
+     * });
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.on
+     */
+    on(type, handler) {
+        const listeners = this._listeners.get(type) ?? [];
+        const hadListeners = listeners.length > 0;
+        listeners.push({ handler: handler, once: false });
+        this._listeners.set(type, listeners);
+        if (!hadListeners) {
+            this.notifyFirstListener(type);
+        }
+        return this;
+    }
+    /**
+     * Remove an event listener.
+     *
+     * If `handler` is provided, only that specific listener is removed.
+     * If `handler` is not provided, all listeners for that event type are removed.
+     *
+     * @param type - The event type.
+     * @param handler - Optional specific handler to remove.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * const handler = msg => console.log(msg);
+     * page.on('console', handler);
+     * // Later...
+     * page.off('console', handler);
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.off
+     */
+    off(type, handler) {
+        if (!handler) {
+            // Remove all listeners for this type
+            const hadListeners = (this._listeners.get(type)?.length ?? 0) > 0;
+            this._listeners.delete(type);
+            if (hadListeners) {
+                this.notifyNoListeners(type);
+            }
+            return this;
+        }
+        const listeners = this._listeners.get(type);
+        if (!listeners) {
+            return this;
+        }
+        const filtered = listeners.filter((entry) => entry.handler !== handler);
+        if (filtered.length === 0) {
+            this._listeners.delete(type);
+            if (listeners.length > 0) {
+                this.notifyNoListeners(type);
+            }
+        }
+        else {
+            this._listeners.set(type, filtered);
+        }
+        return this;
+    }
+    /**
+     * Bind an event listener that will fire only once.
+     *
+     * After the handler is called once, it is automatically removed.
+     *
+     * @param type - The event type to listen for.
+     * @param handler - The function to call when the event occurs.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * page.once('load', () => {
+     *   console.log('Page loaded for the first time!');
+     * });
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.once
+     */
+    once(type, handler) {
+        const listeners = this._listeners.get(type) ?? [];
+        const hadListeners = listeners.length > 0;
+        listeners.push({ handler: handler, once: true });
+        this._listeners.set(type, listeners);
+        if (!hadListeners) {
+            this.notifyFirstListener(type);
+        }
+        return this;
+    }
+    /**
+     * Emit an event, calling all registered handlers.
+     *
+     * This method is typically used internally by Puppeteer classes to dispatch
+     * events. Users rarely need to call this directly.
+     *
+     * @param type - The event type to emit.
+     * @param event - The event data to pass to handlers.
+     * @returns `true` if there were listeners for this event, `false` otherwise.
+     *
+     * @example
+     * ```ts
+     * // Internal usage example
+     * this.emit('console', consoleMessage);
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.emit
+     */
+    emit(type, event) {
+        const listeners = this._listeners.get(type);
+        if (!listeners || listeners.length === 0) {
+            return false;
+        }
+        // Create a copy to avoid issues if handlers modify the listener list
+        const listenersCopy = [...listeners];
+        const toRemove = [];
+        for (const entry of listenersCopy) {
+            try {
+                entry.handler(event);
+            }
+            catch (error) {
+                // Log but don't throw to allow other handlers to run
+                console.error(`Error in event handler for "${String(type)}":`, error);
+            }
+            if (entry.once) {
+                toRemove.push(entry);
+            }
+        }
+        // Remove once listeners
+        if (toRemove.length > 0) {
+            const remaining = listeners.filter((entry) => !toRemove.includes(entry));
+            if (remaining.length === 0) {
+                this._listeners.delete(type);
+                if (listeners.length > 0) {
+                    this.notifyNoListeners(type);
+                }
+            }
+            else {
+                this._listeners.set(type, remaining);
+            }
+        }
+        return true;
+    }
+    /**
+     * Get the count of listeners for a specific event type.
+     *
+     * @param type - The event type.
+     * @returns The number of registered listeners.
+     *
+     * @example
+     * ```ts
+     * const count = page.listenerCount('request');
+     * console.log(`There are ${count} request listeners`);
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.listenercount
+     */
+    listenerCount(type) {
+        const listeners = this._listeners.get(type);
+        return listeners?.length ?? 0;
+    }
+    /**
+     * Remove all listeners.
+     *
+     * If `type` is provided, only listeners for that event type are removed.
+     * If `type` is not provided, all listeners for all event types are removed.
+     *
+     * @param type - Optional event type to remove listeners for.
+     * @returns `this` to allow for method chaining.
+     *
+     * @example
+     * ```ts
+     * // Remove all 'request' listeners
+     * page.removeAllListeners('request');
+     *
+     * // Remove ALL listeners
+     * page.removeAllListeners();
+     * ```
+     *
+     * @see https://pptr.dev/api/puppeteer.eventemitter.removealllisteners
+     */
+    removeAllListeners(type) {
+        if (type === undefined) {
+            const existingEvents = Array.from(this._listeners.entries())
+                .filter(([, listeners]) => listeners.length > 0)
+                .map(([eventName]) => eventName);
+            this._listeners.clear();
+            for (const eventName of existingEvents) {
+                this.notifyNoListeners(eventName);
+            }
+        }
+        else {
+            const hadListeners = (this._listeners.get(type)?.length ?? 0) > 0;
+            this._listeners.delete(type);
+            if (hadListeners) {
+                this.notifyNoListeners(type);
+            }
+        }
+        return this;
+    }
+}