@bctrl/sdk 1.0.1

package/dist/drivers/puppeteer/generated/browser.js

@@ -0,0 +1,246 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
+ * Run `pnpm generate:puppeteer` to regenerate.
+ */
+import { PuppeteerEventEmitter } from '../event-emitter.js';
+/**
+ * RemotePuppeteerBrowser - Remote Puppeteer Browser API over RPC.
+ *
+ * @see https://pptr.dev/api/puppeteer.browser
+ */
+export class RemotePuppeteerBrowser extends PuppeteerEventEmitter {
+    createPage;
+    createContext;
+    sendRpc;
+    constructor(sendRpc, createPage, createContext) {
+        super();
+        this.sendRpc = sendRpc;
+        this.createPage = createPage;
+        this.createContext = createContext;
+    }
+    _isConnected = true;
+    _pages = new Map();
+    _contexts = new Map();
+    _defaultContext = null;
+    /** Whether the browser is connected. */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * Get all open pages.
+     * @see https://pptr.dev/api/puppeteer.browser.pages
+     */
+    async pages(includeAll) {
+        const pageIds = await this.sendRpc('pages', [includeAll]);
+        return pageIds.map((id) => {
+            let page = this._pages.get(id);
+            if (!page) {
+                page = this.createPage(id);
+                this._pages.set(id, page);
+            }
+            return page;
+        });
+    }
+    /**
+     * Create a new page in the default browser context.
+     * @see https://pptr.dev/api/puppeteer.browser.newpage
+     */
+    async newPage(options) {
+        const pageId = await this.sendRpc('newPage', [options]);
+        const page = this.createPage(pageId);
+        this._pages.set(pageId, page);
+        return page;
+    }
+    /**
+     * Close the browser.
+     * @see https://pptr.dev/api/puppeteer.browser.close
+     */
+    async close() {
+        await this.sendRpc('close', []);
+        this._isConnected = false;
+        // Mark all pages as closed
+        for (const page of this._pages.values()) {
+            if ('markClosed' in page && typeof page.markClosed === 'function') {
+                page.markClosed();
+            }
+        }
+        // Mark all contexts as closed
+        for (const ctx of this._contexts.values()) {
+            if ('markClosed' in ctx && typeof ctx.markClosed === 'function') {
+                ctx.markClosed();
+            }
+        }
+    }
+    /**
+     * Disconnect from the browser (without closing it).
+     * @see https://pptr.dev/api/puppeteer.browser.disconnect
+     */
+    disconnect() {
+        this._isConnected = false;
+        this.emit('disconnected', undefined);
+    }
+    /**
+     * Get the default browser context.
+     * @see https://pptr.dev/api/puppeteer.browser.defaultbrowsercontext
+     */
+    defaultBrowserContext() {
+        if (!this._defaultContext) {
+            this._defaultContext = this.createContext('default', true);
+            this._contexts.set('default', this._defaultContext);
+        }
+        return this._defaultContext;
+    }
+    /**
+     * Create a new browser context.
+     * @see https://pptr.dev/api/puppeteer.browser.createbrowsercontext
+     */
+    async createBrowserContext(options) {
+        const contextId = await this.sendRpc('createBrowserContext', [options]);
+        const context = this.createContext(contextId, false);
+        this._contexts.set(contextId, context);
+        return context;
+    }
+    /**
+     * Get all browser contexts.
+     * @see https://pptr.dev/api/puppeteer.browser.browsercontexts
+     */
+    browserContexts() {
+        // Ensure default context exists
+        this.defaultBrowserContext();
+        return Array.from(this._contexts.values());
+    }
+    /**
+     * Wait for a target matching the filter.
+     * @see https://pptr.dev/api/puppeteer.browser.waitfortarget
+     */
+    async waitForTarget(filter, options) {
+        return this.sendRpc('waitForTarget', [filter, options]);
+    }
+    /**
+     * Get the browser version.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.version
+     */
+    async version() {
+        return this.sendRpc('version', []);
+    }
+    /**
+     * Get the browser's user agent.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.useragent
+     */
+    async userAgent() {
+        return this.sendRpc('userAgent', []);
+    }
+    /**
+     * Get the WebSocket endpoint for the browser.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.wsendpoint
+     */
+    async wsEndpoint() {
+        return this.sendRpc('wsEndpoint', []);
+    }
+    /**
+     * Get browser process info (if available).
+     *
+     * @remarks
+     * Returns serialized process info in RPC mode.
+     */
+    async process() {
+        return this.sendRpc('process', []);
+    }
+    /**
+     * Gets the browser target.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.target
+     */
+    async target() {
+        return this.sendRpc('target', []);
+    }
+    /**
+     * Gets all active targets inside the browser.
+     *
+     * @remarks
+     * Returns serialized target data in RPC mode.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.targets
+     */
+    async targets() {
+        return this.sendRpc('targets', []);
+    }
+    /**
+     * Gets cookies from the default browser context.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.cookies
+     */
+    async cookies(...urls) {
+        return this.sendRpc('cookies', [...urls]);
+    }
+    /**
+     * Sets cookies in the default browser context.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.setcookie
+     */
+    async setCookie(...cookies) {
+        await this.sendRpc('setCookie', [...cookies]);
+    }
+    /**
+     * Deletes cookies from the default browser context.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.deletecookie
+     */
+    async deleteCookie(...cookies) {
+        await this.sendRpc('deleteCookie', [...cookies]);
+    }
+    /**
+     * Deletes cookies matching the filter criteria from the default browser context.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.deletematchingcookies
+     */
+    async deleteMatchingCookies(...filters) {
+        await this.sendRpc('deleteMatchingCookies', [...filters]);
+    }
+    /**
+     * Gets the bounds of a browser window.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.getwindowbounds
+     */
+    async getWindowBounds(windowId) {
+        return this.sendRpc('getWindowBounds', [windowId]);
+    }
+    /**
+     * Sets the bounds of a browser window.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.setwindowbounds
+     */
+    async setWindowBounds(windowId, bounds) {
+        await this.sendRpc('setWindowBounds', [windowId, bounds]);
+    }
+    /**
+     * Installs a browser extension.
+     * @returns The extension ID.
+     *
+     * @remarks
+     * In Chrome, this requires the browser to be launched with `pipe: true`
+     * and the `--enable-unsafe-extension-debugging` flag.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.installextension
+     */
+    async installExtension(path) {
+        return this.sendRpc('installExtension', [path]);
+    }
+    /**
+     * Uninstalls a browser extension.
+     *
+     * @remarks
+     * In Chrome, this requires the browser to be launched with `pipe: true`
+     * and the `--enable-unsafe-extension-debugging` flag.
+     *
+     * @see https://pptr.dev/api/puppeteer.browser.uninstallextension
+     */
+    async uninstallExtension(id) {
+        await this.sendRpc('uninstallExtension', [id]);
+    }
+}

package/dist/drivers/puppeteer/generated/console-message.d.ts

@@ -0,0 +1,54 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
+ * Run `pnpm generate:puppeteer` to regenerate.
+ */
+import type { PuppeteerConsoleMessage, PuppeteerConsoleMessageLocation, PuppeteerConsoleMessageType } from '../types.js';
+/**
+ * RemotePuppeteerConsoleMessage - Remote Puppeteer ConsoleMessage API over RPC.
+ *
+ * @see https://pptr.dev/api/puppeteer.consolemessage
+ */
+export declare class RemotePuppeteerConsoleMessage {
+    private readonly _type;
+    private readonly _text;
+    private readonly _location;
+    private readonly _stackTrace;
+    private readonly _args;
+    constructor(messageData: PuppeteerConsoleMessage);
+    /**
+     * The type of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.type
+     */
+    type(): PuppeteerConsoleMessageType;
+    /**
+     * The text of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.text
+     */
+    text(): string;
+    /**
+     * The location of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.location
+     */
+    location(): PuppeteerConsoleMessageLocation;
+    /**
+     * The array of locations on the stack of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.stacktrace
+     */
+    stackTrace(): PuppeteerConsoleMessageLocation[];
+    /**
+     * An array of arguments passed to the console function call.
+     *
+     * @remarks
+     * In real Puppeteer, this returns JSHandle[]. Since JSHandles cannot be
+     * serialized over RPC, this returns the serialized JSON values instead.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.args
+     */
+    args(): unknown[];
+}

package/dist/drivers/puppeteer/generated/console-message.js

@@ -0,0 +1,69 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
+ * Run `pnpm generate:puppeteer` to regenerate.
+ */
+/**
+ * RemotePuppeteerConsoleMessage - Remote Puppeteer ConsoleMessage API over RPC.
+ *
+ * @see https://pptr.dev/api/puppeteer.consolemessage
+ */
+export class RemotePuppeteerConsoleMessage {
+    _type;
+    _text;
+    _location;
+    _stackTrace;
+    _args;
+    constructor(messageData) {
+        this._type = messageData.type;
+        this._text = messageData.text;
+        this._location = messageData.location;
+        this._stackTrace = messageData.stackTrace;
+        this._args = messageData.args;
+    }
+    /**
+     * The type of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.type
+     */
+    type() {
+        return this._type;
+    }
+    /**
+     * The text of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.text
+     */
+    text() {
+        return this._text;
+    }
+    /**
+     * The location of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.location
+     */
+    location() {
+        return this._location;
+    }
+    /**
+     * The array of locations on the stack of the console message.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.stacktrace
+     */
+    stackTrace() {
+        return this._stackTrace;
+    }
+    /**
+     * An array of arguments passed to the console function call.
+     *
+     * @remarks
+     * In real Puppeteer, this returns JSHandle[]. Since JSHandles cannot be
+     * serialized over RPC, this returns the serialized JSON values instead.
+     *
+     * @see https://pptr.dev/api/puppeteer.consolemessage.args
+     */
+    args() {
+        return this._args;
+    }
+}

package/dist/drivers/puppeteer/generated/coverage.d.ts

@@ -0,0 +1,49 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
+ * Run `pnpm generate:puppeteer` to regenerate.
+ */
+import type { SimpleRpcSender } from '../../../internal/transport.js';
+import type { PuppeteerCSSCoverageOptions, PuppeteerCoverageEntry, PuppeteerJSCoverageEntry, PuppeteerJSCoverageOptions } from '../types.js';
+/**
+ * RemotePuppeteerCoverage - Remote Puppeteer Coverage API over RPC.
+ *
+ * @see https://pptr.dev/api/puppeteer.coverage
+ */
+export declare class RemotePuppeteerCoverage {
+    protected sendRpc: SimpleRpcSender;
+    constructor(sendRpc: SimpleRpcSender);
+    /**
+     * Starts CSS coverage.
+     *
+     * @remarks
+     * CSS coverage records which CSS stylesheets and rules were used.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.startcsscoverage
+     */
+    startCSSCoverage(options?: PuppeteerCSSCoverageOptions): Promise<void>;
+    /**
+     * Starts JavaScript coverage.
+     *
+     * @remarks
+     * JS coverage records which JavaScript code was executed.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.startjscoverage
+     */
+    startJSCoverage(options?: PuppeteerJSCoverageOptions): Promise<void>;
+    /**
+     * Stops CSS coverage and returns coverage reports for all stylesheets.
+     * @returns Array of coverage entries for each stylesheet.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.stopcsscoverage
+     */
+    stopCSSCoverage(): Promise<PuppeteerCoverageEntry[]>;
+    /**
+     * Stops JavaScript coverage and returns coverage reports for all scripts.
+     * @returns Array of coverage entries for each script.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.stopjscoverage
+     */
+    stopJSCoverage(): Promise<PuppeteerJSCoverageEntry[]>;
+}

package/dist/drivers/puppeteer/generated/coverage.js

@@ -0,0 +1,57 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
+ * Run `pnpm generate:puppeteer` to regenerate.
+ */
+/**
+ * RemotePuppeteerCoverage - Remote Puppeteer Coverage API over RPC.
+ *
+ * @see https://pptr.dev/api/puppeteer.coverage
+ */
+export class RemotePuppeteerCoverage {
+    sendRpc;
+    constructor(sendRpc) {
+        this.sendRpc = sendRpc;
+    }
+    /**
+     * Starts CSS coverage.
+     *
+     * @remarks
+     * CSS coverage records which CSS stylesheets and rules were used.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.startcsscoverage
+     */
+    async startCSSCoverage(options) {
+        await this.sendRpc('coverage.startCSSCoverage', [options]);
+    }
+    /**
+     * Starts JavaScript coverage.
+     *
+     * @remarks
+     * JS coverage records which JavaScript code was executed.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.startjscoverage
+     */
+    async startJSCoverage(options) {
+        await this.sendRpc('coverage.startJSCoverage', [options]);
+    }
+    /**
+     * Stops CSS coverage and returns coverage reports for all stylesheets.
+     * @returns Array of coverage entries for each stylesheet.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.stopcsscoverage
+     */
+    async stopCSSCoverage() {
+        return this.sendRpc('coverage.stopCSSCoverage', []);
+    }
+    /**
+     * Stops JavaScript coverage and returns coverage reports for all scripts.
+     * @returns Array of coverage entries for each script.
+     *
+     * @see https://pptr.dev/api/puppeteer.coverage.stopjscoverage
+     */
+    async stopJSCoverage() {
+        return this.sendRpc('coverage.stopJSCoverage', []);
+    }
+}

package/dist/drivers/puppeteer/generated/dialog.d.ts

@@ -0,0 +1,46 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
+ * Run `pnpm generate:puppeteer` to regenerate.
+ */
+import type { SimpleRpcSender } from '../../../internal/transport.js';
+import type { PuppeteerDialog, PuppeteerDialogType } from '../types.js';
+/**
+ * RemotePuppeteerDialog - Remote Puppeteer Dialog API over RPC.
+ *
+ * @see https://pptr.dev/api/puppeteer.dialog
+ */
+export declare class RemotePuppeteerDialog {
+    private sendRpc;
+    private readonly _dialogId;
+    private readonly _type;
+    private readonly _message;
+    private readonly _defaultValue;
+    constructor(sendRpc: SimpleRpcSender, dialogData: PuppeteerDialog);
+    /**
+     * Accept the dialog. For prompt dialogs, optionally provide text to enter.
+     * @see https://pptr.dev/api/puppeteer.dialog.accept
+     */
+    accept(promptText?: string): Promise<void>;
+    /**
+     * Dismiss the dialog.
+     * @see https://pptr.dev/api/puppeteer.dialog.dismiss
+     */
+    dismiss(): Promise<void>;
+    /**
+     * Returns the default value of the prompt, or empty string if not a prompt.
+     * @see https://pptr.dev/api/puppeteer.dialog.defaultvalue
+     */
+    defaultValue(): string;
+    /**
+     * The message displayed in the dialog.
+     * @see https://pptr.dev/api/puppeteer.dialog.message
+     */
+    message(): string;
+    /**
+     * The type of the dialog (alert, confirm, prompt, beforeunload).
+     * @see https://pptr.dev/api/puppeteer.dialog.type
+     */
+    type(): PuppeteerDialogType;
+}

package/dist/drivers/puppeteer/generated/dialog.js

@@ -0,0 +1,60 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
+ * Run `pnpm generate:puppeteer` to regenerate.
+ */
+/**
+ * RemotePuppeteerDialog - Remote Puppeteer Dialog API over RPC.
+ *
+ * @see https://pptr.dev/api/puppeteer.dialog
+ */
+export class RemotePuppeteerDialog {
+    sendRpc;
+    _dialogId;
+    _type;
+    _message;
+    _defaultValue;
+    constructor(sendRpc, dialogData) {
+        this.sendRpc = sendRpc;
+        this._dialogId = dialogData.dialogId;
+        this._type = dialogData.type;
+        this._message = dialogData.message;
+        this._defaultValue = dialogData.defaultValue;
+    }
+    /**
+     * Accept the dialog. For prompt dialogs, optionally provide text to enter.
+     * @see https://pptr.dev/api/puppeteer.dialog.accept
+     */
+    async accept(promptText) {
+        await this.sendRpc('dialog.accept', [this._dialogId, promptText]);
+    }
+    /**
+     * Dismiss the dialog.
+     * @see https://pptr.dev/api/puppeteer.dialog.dismiss
+     */
+    async dismiss() {
+        await this.sendRpc('dialog.dismiss', [this._dialogId]);
+    }
+    /**
+     * Returns the default value of the prompt, or empty string if not a prompt.
+     * @see https://pptr.dev/api/puppeteer.dialog.defaultvalue
+     */
+    defaultValue() {
+        return this._defaultValue;
+    }
+    /**
+     * The message displayed in the dialog.
+     * @see https://pptr.dev/api/puppeteer.dialog.message
+     */
+    message() {
+        return this._message;
+    }
+    /**
+     * The type of the dialog (alert, confirm, prompt, beforeunload).
+     * @see https://pptr.dev/api/puppeteer.dialog.type
+     */
+    type() {
+        return this._type;
+    }
+}