craftdriver 0.0.3 → 0.2.0

package/dist/lib/bidi/logs.d.ts

@@ -0,0 +1,104 @@
+/**
+ * BiDi Log Monitor
+ * Real-time console and JavaScript error monitoring
+ */
+import type { BiDiConnection } from './connection.js';
+import type { BrowsingContext, LogLevel } from './types.js';
+export interface ConsoleMessage {
+    type: 'console';
+    level: LogLevel;
+    text: string;
+    timestamp: Date;
+    method: string;
+    args: unknown[];
+    stackTrace?: StackFrame[];
+    context?: BrowsingContext;
+}
+export interface JavaScriptError {
+    type: 'javascript';
+    level: 'error';
+    text: string;
+    timestamp: Date;
+    stackTrace?: StackFrame[];
+    context?: BrowsingContext;
+}
+export interface StackFrame {
+    functionName: string;
+    url: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+export type LogMessage = ConsoleMessage | JavaScriptError;
+export type LogHandler = (message: LogMessage) => void;
+export type ConsoleHandler = (message: ConsoleMessage) => void;
+export type ErrorHandler = (error: JavaScriptError) => void;
+export declare class LogMonitor {
+    private connection;
+    private subscribed;
+    private context?;
+    private allHandlers;
+    private levelHandlers;
+    private consoleHandlers;
+    private errorHandlers;
+    private logs;
+    private maxLogs;
+    constructor(connection: BiDiConnection, context?: BrowsingContext);
+    /**
+     * Initialize log event subscriptions
+     */
+    initialize(): Promise<void>;
+    /**
+     * Listen to all log messages
+     */
+    onLog(handler: LogHandler): () => void;
+    /**
+     * Listen to console messages only
+     */
+    onConsole(handler: ConsoleHandler): () => void;
+    /**
+     * Listen to JavaScript errors only
+     */
+    onError(handler: ErrorHandler): () => void;
+    /**
+     * Listen to specific log levels
+     */
+    on(level: LogLevel, handler: LogHandler): () => void;
+    /**
+     * Get all captured logs
+     */
+    getLogs(): LogMessage[];
+    /**
+     * Get logs filtered by level
+     */
+    getLogsByLevel(level: LogLevel): LogMessage[];
+    /**
+     * Get all captured console messages.
+     */
+    getMessages(): ConsoleMessage[];
+    /**
+     * Get all JavaScript errors
+     */
+    getErrors(): JavaScriptError[];
+    /**
+     * Clear captured logs
+     */
+    clearLogs(): void;
+    /**
+     * Wait for a console message matching predicate
+     */
+    waitForConsole(predicate: (msg: ConsoleMessage) => boolean, timeout?: number): Promise<ConsoleMessage>;
+    /**
+     * Wait for a JavaScript error
+     */
+    waitForError(predicate?: (err: JavaScriptError) => boolean, timeout?: number): Promise<JavaScriptError>;
+    /**
+     * Assert no JavaScript errors occurred
+     */
+    assertNoErrors(): void;
+    private handleLogEntry;
+    private convertLogEntry;
+    private convertStackTrace;
+    private deserializeValue;
+    private notifyHandlers;
+}
+//# sourceMappingURL=logs.d.ts.map

package/dist/lib/bidi/logs.d.ts.map

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

package/dist/lib/bidi/logs.js

@@ -0,0 +1,273 @@
+/**
+ * BiDi Log Monitor
+ * Real-time console and JavaScript error monitoring
+ */
+export class LogMonitor {
+    connection;
+    subscribed = false;
+    context;
+    allHandlers = new Set();
+    levelHandlers = new Map();
+    consoleHandlers = new Set();
+    errorHandlers = new Set();
+    logs = [];
+    maxLogs = 1000;
+    constructor(connection, context) {
+        this.connection = connection;
+        this.context = context;
+    }
+    /**
+     * Initialize log event subscriptions
+     */
+    async initialize() {
+        if (this.subscribed)
+            return;
+        await this.connection.subscribe(['log.entryAdded'], this.context ? [this.context] : undefined);
+        this.connection.on('log.entryAdded', (params) => {
+            this.handleLogEntry(params);
+        });
+        this.subscribed = true;
+    }
+    /**
+     * Listen to all log messages
+     */
+    onLog(handler) {
+        this.allHandlers.add(handler);
+        return () => this.allHandlers.delete(handler);
+    }
+    /**
+     * Listen to console messages only
+     */
+    onConsole(handler) {
+        this.consoleHandlers.add(handler);
+        return () => this.consoleHandlers.delete(handler);
+    }
+    /**
+     * Listen to JavaScript errors only
+     */
+    onError(handler) {
+        this.errorHandlers.add(handler);
+        return () => this.errorHandlers.delete(handler);
+    }
+    /**
+     * Listen to specific log levels
+     */
+    on(level, handler) {
+        if (!this.levelHandlers.has(level)) {
+            this.levelHandlers.set(level, new Set());
+        }
+        this.levelHandlers.get(level).add(handler);
+        return () => this.levelHandlers.get(level)?.delete(handler);
+    }
+    /**
+     * Get all captured logs
+     */
+    getLogs() {
+        return [...this.logs];
+    }
+    /**
+     * Get logs filtered by level
+     */
+    getLogsByLevel(level) {
+        return this.logs.filter((log) => log.level === level);
+    }
+    /**
+     * Get all captured console messages.
+     */
+    getMessages() {
+        return this.logs.filter((log) => log.type === 'console');
+    }
+    /**
+     * Get all JavaScript errors
+     */
+    getErrors() {
+        return this.logs.filter((log) => log.type === 'javascript');
+    }
+    /**
+     * Clear captured logs
+     */
+    clearLogs() {
+        this.logs = [];
+    }
+    /**
+     * Wait for a console message matching predicate
+     */
+    waitForConsole(predicate, timeout = 30000) {
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                unsubscribe();
+                reject(new Error('Timeout waiting for console message'));
+            }, timeout);
+            const unsubscribe = this.onConsole((msg) => {
+                if (predicate(msg)) {
+                    clearTimeout(timeoutId);
+                    unsubscribe();
+                    resolve(msg);
+                }
+            });
+        });
+    }
+    /**
+     * Wait for a JavaScript error
+     */
+    waitForError(predicate, timeout = 30000) {
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                unsubscribe();
+                reject(new Error('Timeout waiting for JavaScript error'));
+            }, timeout);
+            const unsubscribe = this.onError((err) => {
+                if (!predicate || predicate(err)) {
+                    clearTimeout(timeoutId);
+                    unsubscribe();
+                    resolve(err);
+                }
+            });
+        });
+    }
+    /**
+     * Assert no JavaScript errors occurred
+     */
+    assertNoErrors() {
+        const errors = this.getErrors();
+        if (errors.length > 0) {
+            const errorMessages = errors.map((e) => e.text).join('\n');
+            throw new Error(`JavaScript errors detected:\n${errorMessages}`);
+        }
+    }
+    handleLogEntry(entry) {
+        const message = this.convertLogEntry(entry);
+        // Store log
+        this.logs.push(message);
+        if (this.logs.length > this.maxLogs) {
+            this.logs.shift();
+        }
+        // Notify handlers
+        this.notifyHandlers(message);
+    }
+    convertLogEntry(entry) {
+        const stackTrace = entry.stackTrace
+            ? this.convertStackTrace(entry.stackTrace)
+            : undefined;
+        if (entry.type === 'javascript') {
+            const error = {
+                type: 'javascript',
+                level: 'error',
+                text: entry.text,
+                timestamp: new Date(entry.timestamp),
+                stackTrace,
+                context: entry.source.context,
+            };
+            return error;
+        }
+        const consoleMsg = {
+            type: 'console',
+            level: entry.level,
+            text: entry.text,
+            timestamp: new Date(entry.timestamp),
+            method: entry.method || entry.level,
+            args: entry.args ? entry.args.map((arg) => this.deserializeValue(arg)) : [],
+            stackTrace,
+            context: entry.source.context,
+        };
+        return consoleMsg;
+    }
+    convertStackTrace(trace) {
+        return trace.callFrames.map((frame) => ({
+            functionName: frame.functionName,
+            url: frame.url,
+            lineNumber: frame.lineNumber,
+            columnNumber: frame.columnNumber,
+        }));
+    }
+    deserializeValue(value) {
+        switch (value.type) {
+            case 'undefined':
+                return undefined;
+            case 'null':
+                return null;
+            case 'string':
+                return value.value;
+            case 'number':
+                if (value.value === 'NaN')
+                    return NaN;
+                if (value.value === 'Infinity')
+                    return Infinity;
+                if (value.value === '-Infinity')
+                    return -Infinity;
+                if (value.value === '-0')
+                    return -0;
+                return value.value;
+            case 'boolean':
+                return value.value;
+            case 'bigint':
+                return BigInt(value.value);
+            case 'array':
+                return value.value?.map((v) => this.deserializeValue(v)) ?? [];
+            case 'object':
+                if (!value.value)
+                    return {};
+                return Object.fromEntries(value.value.map(([k, v]) => [
+                    typeof k === 'string' ? k : this.deserializeValue(k),
+                    this.deserializeValue(v),
+                ]));
+            case 'regexp':
+                return new RegExp(value.value.pattern, value.value.flags);
+            case 'date':
+                return new Date(value.value);
+            case 'function':
+                return '[Function]';
+            case 'node':
+                return `[${value.value.nodeName || 'Node'}]`;
+            case 'window':
+                return `[Window: ${value.value.context}]`;
+            default:
+                return '[Unknown]';
+        }
+    }
+    notifyHandlers(message) {
+        // All handlers
+        for (const handler of this.allHandlers) {
+            try {
+                handler(message);
+            }
+            catch (err) {
+                console.error('Error in log handler:', err);
+            }
+        }
+        // Level-specific handlers
+        const levelHandlers = this.levelHandlers.get(message.level);
+        if (levelHandlers) {
+            for (const handler of levelHandlers) {
+                try {
+                    handler(message);
+                }
+                catch (err) {
+                    console.error('Error in level log handler:', err);
+                }
+            }
+        }
+        // Type-specific handlers
+        if (message.type === 'console') {
+            for (const handler of this.consoleHandlers) {
+                try {
+                    handler(message);
+                }
+                catch (err) {
+                    console.error('Error in console handler:', err);
+                }
+            }
+        }
+        else if (message.type === 'javascript') {
+            for (const handler of this.errorHandlers) {
+                try {
+                    handler(message);
+                }
+                catch (err) {
+                    console.error('Error in error handler:', err);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/lib/bidi/logs.js.map

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

package/dist/lib/bidi/network.d.ts

@@ -0,0 +1,165 @@
+/**
+ * BiDi Network Interceptor
+ * Provides request interception, mocking, and modification capabilities
+ */
+import type { BiDiConnection } from './connection.js';
+import type { BrowsingContext, InterceptPhase, NetworkIntercept, UrlPattern } from './types.js';
+export interface MockResponse {
+    status?: number;
+    statusText?: string;
+    headers?: Record<string, string>;
+    body?: string | Buffer | object;
+}
+export interface RequestHandler {
+    (request: InterceptedRequest): MockResponse | void | Promise<MockResponse | void>;
+}
+export interface InterceptedRequest {
+    id: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    postData?: string;
+    resourceType?: string;
+    isBlocked: boolean;
+    context: BrowsingContext | null;
+}
+export interface InterceptedResponse {
+    url: string;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    mimeType: string;
+    fromCache: boolean;
+    request: Pick<InterceptedRequest, 'id' | 'url' | 'method' | 'headers'>;
+}
+export interface InterceptRule {
+    id: NetworkIntercept;
+    patterns: UrlPattern[];
+    phases: InterceptPhase[];
+    handler?: RequestHandler;
+}
+export declare class NetworkInterceptor {
+    private connection;
+    private intercepts;
+    private handlers;
+    private subscribed;
+    private context?;
+    private requestListeners;
+    private responseListeners;
+    /** Set of request IDs currently in-flight (sent but not yet completed/errored). */
+    private inFlightRequests;
+    /** Callbacks to notify when inFlightRequests changes — used by waitForNetworkIdle. */
+    private idleListeners;
+    constructor(connection: BiDiConnection, context?: BrowsingContext);
+    /**
+     * Initialize network event subscriptions
+     */
+    initialize(): Promise<void>;
+    /**
+     * Add a network intercept for specific URL patterns
+     */
+    intercept(patterns: string | string[] | UrlPattern | UrlPattern[], handler: RequestHandler, phases?: InterceptPhase[], contexts?: BrowsingContext[]): Promise<string>;
+    /**
+     * Mock all requests matching pattern with a fixed response
+     */
+    mock(pattern: string | string[] | UrlPattern | UrlPattern[], response: MockResponse | ((req: InterceptedRequest) => MockResponse)): Promise<string>;
+    /**
+     * Block all requests matching pattern
+     */
+    block(pattern: string | string[]): Promise<string>;
+    /**
+     * Modify request headers for matching patterns
+     */
+    setExtraHeaders(headers: Record<string, string>, contexts?: BrowsingContext[]): Promise<void>;
+    /**
+     * Continue a blocked request (optionally with modifications)
+     */
+    continueRequest(requestId: string, options?: {
+        url?: string;
+        method?: string;
+        headers?: Record<string, string>;
+        body?: string;
+    }): Promise<void>;
+    /**
+     * Provide a custom response for a blocked request
+     */
+    provideResponse(requestId: string, response: MockResponse): Promise<void>;
+    /**
+     * Fail a blocked request
+     */
+    failRequest(requestId: string): Promise<void>;
+    /**
+     * Number of network requests currently in-flight (sent but no response yet).
+     * Used to implement `waitForNetworkIdle`.
+     */
+    get inFlightCount(): number;
+    /**
+     * Resolves when no network requests have been in-flight for `idleDuration` ms.
+     * Event-driven: subscribes to network events internally; no polling.
+     *
+     * @param idleDuration Milliseconds of network silence required (default: 500)
+     */
+    waitForNetworkIdle(opts?: {
+        idleDuration?: number;
+        timeout?: number;
+    }): Promise<void>;
+    private _notifyIdleListeners;
+    /**
+     * Subscribe to **every** matching request or response. Returns an
+     * `off()` function that unsubscribes the listener.
+     *
+     * Unlike {@link waitForRequest} / {@link waitForResponse}, this is
+     * persistent — the callback fires for the lifetime of the browser
+     * session (or until you call `off()`).
+     *
+     * @example
+     * const off = network.on('response', (res) => {
+     *   console.log(res.status, res.url);
+     * });
+     * // …
+     * off();
+     */
+    on(event: 'request', listener: (req: InterceptedRequest) => void): () => void;
+    on(event: 'response', listener: (res: InterceptedResponse) => void): () => void;
+    /**
+     * Wait for the first request matching a URL glob or predicate.
+     * Must be registered **before** the action that triggers the request.
+     */
+    waitForRequest(pattern: string | ((req: InterceptedRequest) => boolean), opts?: {
+        timeout?: number;
+    }): Promise<InterceptedRequest>;
+    /**
+     * Wait for the first completed response matching a URL glob or predicate.
+     * Must be registered **before** the action that triggers the request.
+     *
+     * @example
+     * ```ts
+     * const [res] = await Promise.all([
+     *   browser.waitForResponse('/api/users'),
+     *   browser.click('#load-btn'),
+     * ]);
+     * expect(res.status).toBe(200);
+     * ```
+     */
+    waitForResponse(pattern: string | ((res: InterceptedResponse) => boolean), opts?: {
+        timeout?: number;
+    }): Promise<InterceptedResponse>;
+    private _waitFor;
+    private _matchesGlob;
+    /**
+     * Remove an intercept
+     */
+    removeIntercept(interceptId: string): Promise<void>;
+    /**
+     * Remove all intercepts
+     */
+    removeAllIntercepts(): Promise<void>;
+    /**
+     * Set cache behavior
+     */
+    setCacheBehavior(behavior: 'default' | 'bypass', contexts?: BrowsingContext[]): Promise<void>;
+    private handleBeforeRequestSent;
+    private normalizePatterns;
+    private headersToObject;
+}
+//# sourceMappingURL=network.d.ts.map

package/dist/lib/bidi/network.d.ts.map

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