jevway 0.0.0-stage → 0.1.2

package/dist/browser/chrome.js

@@ -0,0 +1,147 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { CdpConnection } from './cdp.js';
+export const connectChrome = async (source) => {
+    if (source === 'launch' || source === 'launch-headless')
+        return launchChrome(source === 'launch-headless');
+    const endpoint = source === 'auto' ? autoEndpoint() : await explicitEndpoint(source);
+    const cdp = await CdpConnection.open(endpoint);
+    return { cdp, endpoint, close: async () => cdp.close() };
+};
+/**
+ * The port and browser path Chrome writes to `DevToolsActivePort` while remote debugging is allowed
+ * (chrome://inspect/#remote-debugging). The file can outlive Chrome, so a port here may no longer answer.
+ *
+ * @example
+ * devToolsActivePort() // { port: '9222', path: '/devtools/browser/…', file: '…/Google/Chrome/DevToolsActivePort' }
+ */
+export const devToolsActivePort = () => {
+    const file = chromeProfileDirs()
+        .map((dir) => join(dir, 'DevToolsActivePort'))
+        .find(existsSync);
+    if (!file)
+        return undefined;
+    const [port, path] = readFileSync(file, 'utf8').trim().split('\n');
+    return { port, path, file };
+};
+const autoEndpoint = () => {
+    const active = devToolsActivePort();
+    if (!active) {
+        throw new Error('No running Chrome with remote debugging. Open chrome://inspect/#remote-debugging and allow it.');
+    }
+    return `ws://127.0.0.1:${active.port}${active.path}`;
+};
+const chromeProfileDirs = () => {
+    const home = homedir();
+    if (process.platform === 'darwin')
+        return [join(home, 'Library/Application Support/Google/Chrome')];
+    if (process.platform === 'win32')
+        return [join(process.env.LOCALAPPDATA ?? '', 'Google/Chrome/User Data')];
+    return [join(home, '.config/google-chrome'), join(home, '.config/chromium')];
+};
+const explicitEndpoint = async (url) => {
+    if (url.startsWith('ws'))
+        return url;
+    const version = await fetch(new URL('/json/version', url)).then((response) => response.json());
+    return version.webSocketDebuggerUrl;
+};
+/** The Chrome `launch` starts: `CHROME_PATH`, else the usual install path for this OS; undefined when none exists. */
+export const findChrome = () => [
+    process.env.CHROME_PATH,
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+    '/usr/bin/google-chrome',
+    '/usr/bin/chromium',
+    'C:/Program Files/Google/Chrome/Application/chrome.exe',
+].find((path) => path && existsSync(path));
+const chromeExecutable = () => {
+    const found = findChrome();
+    if (!found)
+        throw new Error('Chrome not found. Set CHROME_PATH.');
+    return found;
+};
+const launchChrome = async (headless) => {
+    const profile = mkdtempSync(join(tmpdir(), 'jevway-'));
+    const args = [
+        `--user-data-dir=${profile}`,
+        '--remote-debugging-port=0',
+        '--no-first-run',
+        '--no-default-browser-check',
+        '--window-size=1120,780',
+        ...(headless ? ['--headless=new'] : []),
+        'about:blank',
+    ];
+    const chrome = spawn(chromeExecutable(), args, { stdio: ['ignore', 'ignore', 'pipe'] });
+    // Any failure before a handle is returned must not leave Chrome or its profile behind.
+    const abandon = async (error) => {
+        await stopChrome(chrome);
+        try {
+            rmSync(profile, { recursive: true, force: true });
+        }
+        catch { }
+        throw error;
+    };
+    const endpoint = await readDevToolsEndpoint(chrome).catch(abandon);
+    const cdp = await CdpConnection.open(endpoint).catch(abandon);
+    return {
+        cdp,
+        endpoint,
+        // Returns even if Chrome already exited; a profile that can't be removed never rejects.
+        close: async () => {
+            cdp.close();
+            await stopChrome(chrome);
+            try {
+                rmSync(profile, { recursive: true, force: true });
+            }
+            catch { }
+        },
+    };
+};
+/**
+ * Stops a launched Chrome and resolves once it is gone, never hanging: a process that already exited returns at
+ * once, one that ignores SIGTERM is killed after `graceMs`. Never rejects. Exported for tests.
+ *
+ * @example
+ * await stopChrome(child); // resolves even if Chrome crashed earlier
+ */
+export const stopChrome = async (child, graceMs = 5_000) => {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    // Listen before signalling, so a fast exit is never missed.
+    const exited = new Promise((resolve) => child.once('exit', () => resolve(true)));
+    child.kill();
+    if (await exitedWithin(exited, graceMs))
+        return;
+    child.kill('SIGKILL');
+    await exitedWithin(exited, 1_000);
+};
+// True if the process exited before `ms` passed; the timer never outlives the wait.
+const exitedWithin = async (exited, ms) => {
+    let timer;
+    const timedOut = new Promise((resolve) => {
+        timer = setTimeout(resolve, ms, false);
+    });
+    try {
+        return await Promise.race([exited, timedOut]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+const readDevToolsEndpoint = (chrome) => new Promise((resolve, reject) => {
+    let output = '';
+    const timer = setTimeout(() => reject(new Error('Chrome did not start within 15s')), 15_000);
+    chrome.stderr.on('data', (chunk) => {
+        output += chunk;
+        const match = output.match(/DevTools listening on (ws:\/\/\S+)/);
+        if (match) {
+            clearTimeout(timer);
+            resolve(match[1]);
+        }
+    });
+    chrome.once('exit', (code) => {
+        clearTimeout(timer);
+        reject(new Error(`Chrome exited (${code}) before DevTools started`));
+    });
+});

package/dist/browser/devices.js

@@ -0,0 +1,20 @@
+export const DEVICES = {
+    desktop: { name: 'desktop', width: 1120, height: 780, deviceScaleFactor: 1, mobile: false },
+    laptop: { name: 'laptop', width: 1440, height: 900, deviceScaleFactor: 1, mobile: false },
+    'iphone-15': {
+        name: 'iphone-15',
+        width: 393,
+        height: 852,
+        deviceScaleFactor: 2,
+        mobile: true,
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/604.1',
+    },
+    'pixel-8': {
+        name: 'pixel-8',
+        width: 412,
+        height: 915,
+        deviceScaleFactor: 2,
+        mobile: true,
+        userAgent: 'Mozilla/5.0 (Linux; Android 15; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Mobile Safari/537.36',
+    },
+};