@amalgm/browser 0.1.0

package/dist/src/cookies/secret-file.js

@@ -0,0 +1,80 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { BrowserError } from '../errors.js';
+export class EncryptedSecretFile {
+    file;
+    keyFile;
+    suppliedKey;
+    constructor(file, keyFile, suppliedKey) {
+        this.file = file;
+        this.keyFile = keyFile;
+        this.suppliedKey = suppliedKey;
+    }
+    exists() { return fs.existsSync(this.file); }
+    read() {
+        if (!this.exists())
+            return null;
+        try {
+            try {
+                fs.chmodSync(this.file, 0o600);
+            }
+            catch { }
+            const envelope = JSON.parse(fs.readFileSync(this.file, 'utf8'));
+            if (envelope.version !== 1 || envelope.algorithm !== 'aes-256-gcm')
+                throw new Error('unsupported envelope');
+            const decipher = crypto.createDecipheriv('aes-256-gcm', this.key(), Buffer.from(envelope.iv, 'base64'));
+            decipher.setAuthTag(Buffer.from(envelope.tag, 'base64'));
+            const plaintext = Buffer.concat([
+                decipher.update(Buffer.from(envelope.ciphertext, 'base64')),
+                decipher.final(),
+            ]);
+            return JSON.parse(plaintext.toString('utf8'));
+        }
+        catch {
+            throw new BrowserError('PROCESS_FAILED', 'Encrypted Browser state failed integrity verification.');
+        }
+    }
+    write(value) {
+        const iv = crypto.randomBytes(12);
+        const cipher = crypto.createCipheriv('aes-256-gcm', this.key(), iv);
+        const ciphertext = Buffer.concat([cipher.update(JSON.stringify(value)), cipher.final()]);
+        const envelope = {
+            version: 1,
+            algorithm: 'aes-256-gcm',
+            iv: iv.toString('base64'),
+            tag: cipher.getAuthTag().toString('base64'),
+            ciphertext: ciphertext.toString('base64'),
+        };
+        privateDirectory(path.dirname(this.file));
+        const temporary = `${this.file}.${process.pid}.${Date.now()}.tmp`;
+        fs.writeFileSync(temporary, `${JSON.stringify(envelope)}\n`, { mode: 0o600 });
+        fs.renameSync(temporary, this.file);
+    }
+    key() {
+        if (this.suppliedKey) {
+            if (this.suppliedKey.length !== 32)
+                throw new BrowserError('INVALID_INPUT', 'Browser encryption key must be 32 bytes.');
+            return this.suppliedKey;
+        }
+        privateDirectory(path.dirname(this.keyFile));
+        if (!fs.existsSync(this.keyFile))
+            fs.writeFileSync(this.keyFile, crypto.randomBytes(32), { mode: 0o600, flag: 'wx' });
+        try {
+            fs.chmodSync(this.keyFile, 0o600);
+        }
+        catch { }
+        const key = fs.readFileSync(this.keyFile);
+        if (key.length !== 32)
+            throw new BrowserError('PROCESS_FAILED', 'Browser encryption key is invalid.');
+        return key;
+    }
+}
+function privateDirectory(directory) {
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    try {
+        fs.chmodSync(directory, 0o700);
+    }
+    catch { }
+}
+//# sourceMappingURL=secret-file.js.map

package/dist/src/cookies/secret-file.js.map

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

package/dist/src/cookies/types.d.ts

@@ -0,0 +1,64 @@
+export interface BrowserCookiePartition {
+    topLevelSite: string;
+    hasCrossSiteAncestor?: boolean;
+}
+export interface BrowserCookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    expires?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    partitionKey?: BrowserCookiePartition;
+}
+export interface BrowserCookieRecord extends BrowserCookie {
+    key: string;
+    sourceId: string;
+    changedAt: string;
+}
+export interface BrowserCookieTombstone {
+    key: string;
+    sourceId: string;
+    changedAt: string;
+}
+export interface BrowserCookieJarData {
+    schemaVersion: 1;
+    records: BrowserCookieRecord[];
+    tombstones: BrowserCookieTombstone[];
+}
+export interface BrowserCookieMutation {
+    sourceId: string;
+    changedAt?: string;
+    upserts?: BrowserCookie[];
+    deletes?: Array<Pick<BrowserCookie, 'name' | 'domain' | 'path' | 'partitionKey'>>;
+}
+export interface BrowserCookieMetadata {
+    key: string;
+    name: string;
+    domain: string;
+    path: string;
+    partitioned: boolean;
+    expires?: number;
+    changedAt: string;
+}
+export interface BrowserCookieJarSnapshot {
+    exists: boolean;
+    healthy: boolean;
+    versionToken: string;
+    cookies: BrowserCookieMetadata[];
+    tombstones: Array<Omit<BrowserCookieTombstone, 'sourceId'>>;
+}
+export interface BrowserCookieAdapter {
+    id: string;
+    supportsPartitionedCookies: boolean;
+    read(signal?: AbortSignal): Promise<BrowserCookie[]>;
+    apply(input: {
+        upserts: BrowserCookie[];
+        deletes: BrowserCookieMutation['deletes'];
+        versionToken: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    subscribe?(changed: () => void): () => void;
+}

package/dist/src/cookies/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/cookies/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cookies/types.ts"],"names":[],"mappings":""}

package/dist/src/cookies.d.ts

@@ -0,0 +1,5 @@
+export { BrowserCookieJar, diffCookies } from './cookies/jar.js';
+export { BrowserCookieCoordinator } from './cookies/coordinator.js';
+export { EncryptedSecretFile } from './cookies/secret-file.js';
+export { cookieHostIsProtected, cookieKey, normalizeCookie, normalizeCookieDomain, normalizePartition, } from './cookies/policy.js';
+export type * from './cookies/types.js';

package/dist/src/cookies.js

@@ -0,0 +1,5 @@
+export { BrowserCookieJar, diffCookies } from './cookies/jar.js';
+export { BrowserCookieCoordinator } from './cookies/coordinator.js';
+export { EncryptedSecretFile } from './cookies/secret-file.js';
+export { cookieHostIsProtected, cookieKey, normalizeCookie, normalizeCookieDomain, normalizePartition, } from './cookies/policy.js';
+//# sourceMappingURL=cookies.js.map

package/dist/src/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/src/defaults.d.ts

@@ -0,0 +1,24 @@
+import { LocalArtifactStore } from './artifacts.js';
+import { BrowserAuthVault } from './auth/vault.js';
+import { BrowserCookieCoordinator } from './cookies/coordinator.js';
+import { BrowserCookieJar } from './cookies/jar.js';
+import { EncryptedSecretFile } from './cookies/secret-file.js';
+import type { BrowserServiceOptions } from './service.js';
+import { BrowserProductService } from './product-service.js';
+import type { BrowserArtifactStore, BrowserDriver, ProcessLauncher } from './ports.js';
+export interface CreateBrowserOptions extends Partial<BrowserServiceOptions> {
+    root?: string;
+    headlessDriver?: BrowserDriver;
+    electronDriver?: BrowserDriver;
+    artifactStore?: BrowserArtifactStore;
+    processLauncher?: ProcessLauncher;
+    cookieJar?: BrowserCookieJar;
+    cookieCoordinator?: BrowserCookieCoordinator;
+    authVault?: BrowserAuthVault;
+    loginSecrets?: EncryptedSecretFile;
+    ffmpegBinary?: string;
+    legacyDatabaseFile?: string | false;
+}
+export declare function browserRoot(env?: NodeJS.ProcessEnv, homedir?: string): string;
+export declare function createBrowser(options?: CreateBrowserOptions): BrowserProductService;
+export declare function createLocalArtifactStore(root?: string): LocalArtifactStore;

package/dist/src/defaults.js

@@ -0,0 +1,107 @@
+import os from 'node:os';
+import path from 'node:path';
+import { resolveProductStateDir } from '@amalgm/core/identity';
+import { LocalArtifactStore } from './artifacts.js';
+import { BrowserAuthVault } from './auth/vault.js';
+import { BrowserCookieCoordinator } from './cookies/coordinator.js';
+import { BrowserCookieJar } from './cookies/jar.js';
+import { EncryptedSecretFile } from './cookies/secret-file.js';
+import { BrowserError } from './errors.js';
+import { AgentBrowserCommand } from './drivers/headless/command.js';
+import { HeadlessBrowserDriver } from './drivers/headless/driver.js';
+import { SqliteBrowserRegistry } from './persistence/sqlite-registry.js';
+import { NodeProcessLauncher } from './process.js';
+import { DefaultRuntimeSelector } from './runtime-selector.js';
+import { BrowserProductService } from './product-service.js';
+import { BrowserEventBus } from './events.js';
+import { migrateLegacyBrowserState } from './migration/legacy-migration.js';
+import { LocalBrowserProfileDirectories } from './profiles/directories.js';
+export function browserRoot(env = process.env, homedir = os.homedir()) {
+    // The resolution law lives in @amalgm/core: AMALGM_BROWSER_DIR verbatim,
+    // then $AMALGM_DIR/browser, then the ratified scoped homedir layout.
+    // AMALGM_BROWSER_ROOT is this package's historical spelling of the
+    // product override and feeds the same first tier.
+    const override = env.AMALGM_BROWSER_DIR || env.AMALGM_BROWSER_ROOT;
+    return resolveProductStateDir({
+        product: 'browser',
+        primitive: 'browser',
+        env: override ? { ...env, AMALGM_BROWSER_DIR: override } : env,
+        homedir: path.join(homedir, '.amalgm'),
+    });
+}
+export function createBrowser(options = {}) {
+    const root = options.root || browserRoot();
+    const launcher = options.processLauncher || new NodeProcessLauncher();
+    const defaultCookieJar = new BrowserCookieJar(new EncryptedSecretFile(path.join(root, 'cookie-jar.enc'), path.join(root, 'browser.key')));
+    const cookieJar = options.cookieJar || options.cookieCoordinator?.jar || defaultCookieJar;
+    if (options.cookieJar && options.cookieCoordinator?.jar !== undefined
+        && options.cookieCoordinator.jar !== options.cookieJar) {
+        throw new BrowserError('INVALID_INPUT', 'Cookie coordinator and cookie jar must share one authority.');
+    }
+    const eventSink = options.eventSink || new BrowserEventBus();
+    const cookieCoordinator = options.cookieCoordinator || new BrowserCookieCoordinator(cookieJar, eventSink);
+    const headless = options.headlessDriver || new HeadlessBrowserDriver(new AgentBrowserCommand({
+        root,
+        launcher,
+        cdpEndpoint: process.env.AMALGM_BROWSER_CDP_URL,
+        headed: /^(1|true|yes)$/i.test(process.env.AMALGM_BROWSER_HEADED || ''),
+    }), root, cookieCoordinator);
+    const electron = options.electronDriver || unavailableElectronDriver;
+    const registry = options.registry || new SqliteBrowserRegistry(path.join(root, 'browser.db'), {
+        legacyJsonFile: path.join(root, 'registry-v1.json'),
+    });
+    const authVault = options.authVault || new BrowserAuthVault(path.join(root, 'auth-bundles'), path.join(root, 'browser.key'));
+    const loginSecrets = options.loginSecrets || new EncryptedSecretFile(path.join(root, 'login-secrets.enc'), path.join(root, 'browser.key'));
+    const legacyDatabaseFile = options.legacyDatabaseFile === false ? null
+        : options.legacyDatabaseFile || (!options.root ? path.join(path.dirname(root), 'amalgm.db') : null);
+    if (!options.registry && registry instanceof SqliteBrowserRegistry && legacyDatabaseFile) {
+        migrateLegacyBrowserState({
+            browserRoot: root,
+            databaseFile: legacyDatabaseFile,
+            registry,
+            authVault,
+            cookieJar,
+            loginSecrets,
+        });
+    }
+    return new BrowserProductService({
+        registry,
+        drivers: options.drivers || { headless, electron },
+        runtimeSelector: options.runtimeSelector || new DefaultRuntimeSelector(),
+        eventSink,
+        clock: options.clock || { now: () => new Date() },
+        logger: options.logger || safeConsoleLogger,
+        authVault,
+        loginSecrets,
+        artifactStore: options.artifactStore || createLocalArtifactStore(root),
+        processLauncher: launcher,
+        ...(options.ffmpegBinary ? { ffmpegBinary: options.ffmpegBinary } : {}),
+        cookieJar,
+        cookieCoordinator,
+        profileDirectories: options.profileDirectories || new LocalBrowserProfileDirectories(path.join(root, 'profiles')),
+        ...(options.authorization ? { authorization: options.authorization } : {}),
+        ...(options.id ? { id: options.id } : {}),
+    });
+}
+export function createLocalArtifactStore(root = browserRoot()) {
+    return new LocalArtifactStore(root);
+}
+const unavailableElectronDriver = {
+    kind: 'electron',
+    capabilities: [],
+    async open() { throw new BrowserError('CAPABILITY_UNSUPPORTED', 'No Electron visible-host adapter was provided.'); },
+    async execute() { throw new BrowserError('CAPABILITY_UNSUPPORTED', 'No Electron visible-host adapter was provided.'); },
+    async close() { },
+};
+const safeConsoleLogger = {
+    debug(message, fields) { if (process.env.AMALGM_BROWSER_DEBUG)
+        console.error(message, safeFields(fields)); },
+    warn(message, fields) { console.error(message, safeFields(fields)); },
+    error(message, fields) { console.error(message, safeFields(fields)); },
+};
+function safeFields(fields) {
+    if (!fields)
+        return undefined;
+    return Object.fromEntries(Object.entries(fields).filter(([key]) => !/(cookie|token|secret|password|authorization)/i.test(key)));
+}
+//# sourceMappingURL=defaults.js.map

package/dist/src/defaults.js.map

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

package/dist/src/drivers/cdp/capture.d.ts

@@ -0,0 +1,5 @@
+import type { BrowserCapture } from '../../types.js';
+import type { CdpClient } from './client.js';
+type CdpConnector = (url: string, signal?: AbortSignal) => Promise<CdpClient>;
+export declare function captureCdpPage(pageUrl: string, fullPage?: boolean, signal?: AbortSignal, connect?: CdpConnector): Promise<BrowserCapture>;
+export {};

package/dist/src/drivers/cdp/capture.js

@@ -0,0 +1,39 @@
+import { BrowserError } from '../../errors.js';
+import { connectCdp } from './client.js';
+export async function captureCdpPage(pageUrl, fullPage = false, signal, connect = connectCdp) {
+    const client = await connect(pageUrl, signal);
+    try {
+        await client.call('Page.enable', {}, 5_000);
+        const metrics = await client.call('Page.getLayoutMetrics', {}, 5_000);
+        const viewport = fullPage ? metrics.cssContentSize : metrics.cssVisualViewport;
+        if (!viewport)
+            throw new BrowserError('PROCESS_FAILED', 'CDP returned no CSS viewport metrics.');
+        const width = Math.max(1, Math.min(Math.ceil('width' in viewport ? viewport.width : viewport.clientWidth), 8_192));
+        const height = Math.max(1, Math.min(Math.ceil('height' in viewport ? viewport.height : viewport.clientHeight), 16_384));
+        const x = fullPage ? 0 : metrics.cssVisualViewport?.pageX || 0;
+        const y = fullPage ? 0 : metrics.cssVisualViewport?.pageY || 0;
+        const result = await client.call('Page.captureScreenshot', {
+            format: 'png', fromSurface: true, captureBeyondViewport: fullPage,
+            clip: { x, y, width, height, scale: 1 },
+            optimizeForSpeed: true,
+        }, 30_000);
+        if (!result.data)
+            throw new BrowserError('PROCESS_FAILED', 'CDP returned no screenshot data.');
+        const image = Buffer.from(result.data, 'base64');
+        const size = pngSize(image);
+        if (size.width !== width || size.height !== height) {
+            throw new BrowserError('PROCESS_FAILED', `Capture size ${size.width}x${size.height} did not match CSS viewport ${width}x${height}.`);
+        }
+        return { mimeType: 'image/png', base64: result.data, bytes: image.length, width, height, coordinateSpace: 'css-pixel' };
+    }
+    finally {
+        client.close();
+    }
+}
+function pngSize(value) {
+    if (value.length < 24 || value.toString('ascii', 1, 4) !== 'PNG') {
+        throw new BrowserError('PROCESS_FAILED', 'CDP screenshot was not a valid PNG.');
+    }
+    return { width: value.readUInt32BE(16), height: value.readUInt32BE(20) };
+}
+//# sourceMappingURL=capture.js.map

package/dist/src/drivers/cdp/capture.js.map

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

package/dist/src/drivers/cdp/client.d.ts

@@ -0,0 +1,8 @@
+export interface CdpClient {
+    call<T = Record<string, unknown>>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    send(method: string, params?: Record<string, unknown>): void;
+    on(method: string, handler: (params: Record<string, unknown>) => void): void;
+    close(): void;
+}
+export declare function connectCdp(url: string, signal?: AbortSignal): Promise<CdpClient>;
+export declare function deadline<T>(promise: Promise<T>, milliseconds: number, label: string): Promise<T>;

package/dist/src/drivers/cdp/client.js

@@ -0,0 +1,88 @@
+import WebSocket from 'ws';
+import { BrowserError } from '../../errors.js';
+export async function connectCdp(url, signal) {
+    if (signal?.aborted)
+        throw new BrowserError('ABORTED', 'CDP connection cancelled.');
+    const socket = new WebSocket(url, { perMessageDeflate: false });
+    let connectAbort;
+    try {
+        await deadline(new Promise((resolve, reject) => {
+            socket.once('open', resolve);
+            socket.once('error', reject);
+            connectAbort = () => reject(new BrowserError('ABORTED', 'CDP connection cancelled.'));
+            signal?.addEventListener('abort', connectAbort, { once: true });
+        }), 10_000, 'CDP connect');
+    }
+    catch (error) {
+        socket.terminate();
+        throw error;
+    }
+    finally {
+        if (connectAbort)
+            signal?.removeEventListener('abort', connectAbort);
+    }
+    let nextId = 0;
+    const pending = new Map();
+    const listeners = new Map();
+    const abort = () => {
+        const error = new BrowserError('ABORTED', 'CDP operation was cancelled.');
+        for (const request of pending.values())
+            request.reject(error);
+        pending.clear();
+        socket.close();
+    };
+    signal?.addEventListener('abort', abort, { once: true });
+    socket.on('message', (data) => {
+        let message;
+        try {
+            message = JSON.parse(data.toString());
+        }
+        catch {
+            return;
+        }
+        if (message.id && pending.has(message.id)) {
+            const request = pending.get(message.id);
+            pending.delete(message.id);
+            if (message.error)
+                request.reject(new BrowserError('PROCESS_FAILED', message.error.message || 'CDP call failed.'));
+            else
+                request.resolve(message.result || {});
+        }
+        else if (message.method)
+            listeners.get(message.method)?.(message.params || {});
+    });
+    socket.on('close', () => {
+        for (const request of pending.values())
+            request.reject(new BrowserError('PROCESS_FAILED', 'CDP connection closed.'));
+        pending.clear();
+        signal?.removeEventListener('abort', abort);
+    });
+    socket.on('error', () => undefined);
+    return {
+        call(method, params = {}, timeoutMs = 15_000) {
+            const id = ++nextId;
+            const result = new Promise((resolve, reject) => pending.set(id, { resolve, reject }));
+            socket.send(JSON.stringify({ id, method, params }));
+            return deadline(result, timeoutMs, method).finally(() => pending.delete(id));
+        },
+        send(method, params = {}) { socket.send(JSON.stringify({ id: ++nextId, method, params })); },
+        on(method, handler) { listeners.set(method, handler); },
+        close() { socket.close(); },
+    };
+}
+export async function deadline(promise, milliseconds, label) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new BrowserError('TIMEOUT', `${label} timed out after ${milliseconds}ms.`)), milliseconds);
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/drivers/cdp/client.js.map

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

package/dist/src/drivers/cdp/input.d.ts

@@ -0,0 +1,2 @@
+import type { CdpClient } from './client.js';
+export declare function doubleClickCdpPage(pageUrl: string, x: number, y: number, button?: 'left' | 'middle' | 'right', signal?: AbortSignal, connect?: (url: string, signal?: AbortSignal) => Promise<CdpClient>): Promise<void>;

package/dist/src/drivers/cdp/input.js

@@ -0,0 +1,15 @@
+import { connectCdp } from './client.js';
+export async function doubleClickCdpPage(pageUrl, x, y, button = 'left', signal, connect = connectCdp) {
+    const client = await connect(pageUrl, signal);
+    try {
+        await client.call('Input.dispatchMouseEvent', { type: 'mouseMoved', x, y });
+        for (const clickCount of [1, 2]) {
+            await client.call('Input.dispatchMouseEvent', { type: 'mousePressed', x, y, button, clickCount });
+            await client.call('Input.dispatchMouseEvent', { type: 'mouseReleased', x, y, button, clickCount });
+        }
+    }
+    finally {
+        client.close();
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/src/drivers/cdp/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../../src/drivers/cdp/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,CAAS,EACT,CAAS,EACT,SAAsC,MAAM,EAC5C,MAAoB,EACpB,UAAqE,UAAU;IAE/E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5E,KAAK,MAAM,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAClG,MAAM,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;YAAS,CAAC;QAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC/B,CAAC"}

package/dist/src/drivers/cdp/screencast.d.ts

@@ -0,0 +1,2 @@
+export declare function assertCapturable(url: string, signal?: AbortSignal): Promise<void>;
+export declare function startCdpScreencast(url: string, onFrame: (png: Buffer) => void, signal?: AbortSignal): Promise<() => Promise<void>>;

package/dist/src/drivers/cdp/screencast.js

@@ -0,0 +1,39 @@
+import { BrowserError } from '../../errors.js';
+import { connectCdp } from './client.js';
+export async function assertCapturable(url, signal) {
+    const client = await connectCdp(url, signal);
+    try {
+        await client.call('Page.captureScreenshot', {
+            format: 'jpeg',
+            quality: 10,
+            clip: { x: 0, y: 0, width: 8, height: 8, scale: 1 },
+        }, 4_000);
+    }
+    catch (error) {
+        throw new BrowserError('PROCESS_FAILED', `Browser page is not capturable: ${error.message}`);
+    }
+    finally {
+        client.close();
+    }
+}
+export async function startCdpScreencast(url, onFrame, signal) {
+    const client = await connectCdp(url, signal);
+    let stopped = false;
+    client.on('Page.screencastFrame', (params) => {
+        const data = params.data;
+        const sessionId = params.sessionId;
+        if (typeof data === 'string')
+            onFrame(Buffer.from(data, 'base64'));
+        if (typeof sessionId === 'number')
+            client.send('Page.screencastFrameAck', { sessionId });
+    });
+    await client.call('Page.startScreencast', { format: 'png', everyNthFrame: 1 });
+    return async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        await client.call('Page.stopScreencast', {}, 4_000).catch(() => undefined);
+        client.close();
+    };
+}
+//# sourceMappingURL=screencast.js.map

package/dist/src/drivers/cdp/screencast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencast.js","sourceRoot":"","sources":["../../../../src/drivers/cdp/screencast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAoB;IACtE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;YAC1C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;SACpD,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,mCAAoC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC;YAAS,CAAC;QAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,OAA8B,EAC9B,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnE,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/drivers/cdp/target.d.ts

@@ -0,0 +1,4 @@
+import { connectCdp } from './client.js';
+type CdpConnector = typeof connectCdp;
+export declare function resolvePageCdpUrl(browserUrl: string, currentUrl: string, signal?: AbortSignal, connect?: CdpConnector): Promise<string>;
+export {};

package/dist/src/drivers/cdp/target.js

@@ -0,0 +1,34 @@
+import { BrowserError } from '../../errors.js';
+import { connectCdp } from './client.js';
+export async function resolvePageCdpUrl(browserUrl, currentUrl, signal, connect = connectCdp) {
+    const client = await connect(browserUrl, signal);
+    try {
+        const result = await client.call('Target.getTargets', {}, 10_000);
+        const pages = (result.targetInfos || []).filter((target) => target.type === 'page');
+        const candidates = pages.filter((target) => sameLocation(target.url, currentUrl));
+        if (candidates.length !== 1) {
+            throw new BrowserError('SURFACE_IDENTITY_FAILED', `Headless page identity is ambiguous (${candidates.length} matching targets).`);
+        }
+        const endpoint = new URL(browserUrl);
+        endpoint.pathname = `/devtools/page/${encodeURIComponent(candidates[0].targetId)}`;
+        endpoint.search = '';
+        endpoint.hash = '';
+        return endpoint.toString();
+    }
+    finally {
+        client.close();
+    }
+}
+function sameLocation(left, right) {
+    try {
+        const a = new URL(left);
+        const b = new URL(right);
+        a.hash = '';
+        b.hash = '';
+        return a.toString() === b.toString();
+    }
+    catch {
+        return left === right && Boolean(left);
+    }
+}
+//# sourceMappingURL=target.js.map

package/dist/src/drivers/cdp/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../../../src/drivers/cdp/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,UAAkB,EAClB,MAAoB,EACpB,UAAwB,UAAU;IAElC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAiC,mBAAmB,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAClG,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACpF,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;QAClF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,YAAY,CAAC,yBAAyB,EAAE,wCAAwC,UAAU,CAAC,MAAM,qBAAqB,CAAC,CAAC;QACpI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QACrC,QAAQ,CAAC,QAAQ,GAAG,kBAAkB,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpF,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;YAAS,CAAC;QAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAC/C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;AACrD,CAAC"}

package/dist/src/drivers/electron/advertisement.d.ts

@@ -0,0 +1,12 @@
+export interface WriteHostAdvertisementOptions {
+    file: string;
+    cdpUrl: string;
+    cdpPort: number;
+    protocol?: 5 | 6;
+    pid?: number;
+    label?: string;
+    startedAt?: string;
+}
+export declare function writeHostAdvertisement(options: WriteHostAdvertisementOptions): void;
+export declare function removeHostAdvertisement(file: string, pid?: number): boolean;
+export declare function isLoopbackCdpUrl(value: string): boolean;