@monoes/monobrowse 1.0.26 → 1.0.28

package/dist/src/browser/browser-lifecycle.js

@@ -0,0 +1,245 @@
+// Split out of browser.ts (file-size sweep). Pure move: no behaviour change.
+import { fetchBrowserWebSocketUrl } from './browser-discovery.js';
+import { launchedPids, launchedUserDataDirs, ownedUserDataDirPorts } from './browser-state.js';
+import { CdpClient, fetchTargets } from './cdp.js';
+import { removeOwnedProfileDir } from './profile-dir.js';
+import { listSessionRecords, loadSessionRecord, removeSessionRecord, } from './ref-cache.js';
+const BROWSER_CLOSE_TIMEOUT_MS = 3000;
+// How long closeBrowser() waits for the process to actually disappear before
+// forcing it, and again after forcing. Bounded so a wedged Chrome cannot hang
+// a caller indefinitely.
+const PROCESS_EXIT_TIMEOUT_MS = 5000;
+const PROCESS_EXIT_POLL_MS = 50;
+// A cross-process persisted PID older than this is not trusted for the
+// SIGKILL fallback in closeBrowser() — see the call site for why.
+const PERSISTED_PID_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+// A browser WE launched that has had no targets for longer than this is
+// reaped at the next launch/attach — see reapIdleLaunchedBrowser().
+const IDLE_REAP_AFTER_MS = 30 * 60 * 1000;
+const REAP_CONNECT_TIMEOUT_MS = 3000;
+/**
+ * Cleanly terminate a Chrome/Chromium instance we launched on `port`.
+ * Sends the `Browser.close` CDP command (the correct graceful shutdown —
+ * closes all tabs and exits the process cleanly) over `client`'s connection.
+ * If that command fails, times out, or the connection is already gone,
+ * falls back to killing the tracked PID directly so a headed/interactive
+ * browser window (e.g. one spawned for a login/CAPTCHA flow) never lingers
+ * as a visible, authenticated, still-debuggable orphan process.
+ *
+ * On the graceful path this resolves only once the process is actually gone,
+ * or after force-killing it when it outlasts PROCESS_EXIT_TIMEOUT_MS. Chrome
+ * acknowledges `Browser.close` well before it exits, and this used to return
+ * on the ack with an unref'd 1s timer as the only force-kill — so it resolved
+ * while Chrome was still running and holding its port and its profile's
+ * singleton lock, and if the caller's process exited first the kill never
+ * happened at all. Callers reasonably read a resolved close() as "that
+ * browser is gone"; on the graceful path it now means that.
+ *
+ * A profile directory monobrowse created for that browser (the default temp
+ * profile, or a CLI session's — never a caller-supplied one) is deleted once
+ * the process is gone, on both paths (#395). In a fresh process the dir and
+ * its ownership come from the persisted session record.
+ */
+export async function closeBrowser(client, port) {
+    let gracefullyClosed = false;
+    let closeTimer;
+    try {
+        await Promise.race([
+            client.send('Browser.close', {}),
+            // Deliberately NOT unref'd, for the same reason waitForProcessExit()'s
+            // poll below is not. This timer is the only thing that settles the race
+            // when Chrome's socket dies without ever acknowledging the close, and
+            // closeBrowser() is actively awaited by callers. An unref'd timer does
+            // not hold the event loop open, so Node would consider the loop drained
+            // and exit — status 0, before the caller's verdict was ever printed.
+            // Cleared in the finally so a close that IS acknowledged does not pin
+            // the loop for the rest of BROWSER_CLOSE_TIMEOUT_MS.
+            new Promise((_, reject) => {
+                closeTimer = setTimeout(() => reject(new Error('Browser.close timed out')), BROWSER_CLOSE_TIMEOUT_MS);
+            }),
+        ]);
+        gracefullyClosed = true;
+    }
+    catch {
+        // fall through to PID-kill fallback below
+    }
+    finally {
+        clearTimeout(closeTimer);
+    }
+    let pid = launchedPids.get(port);
+    let profileDir = ownedUserDataDirPorts.has(port) ? launchedUserDataDirs.get(port) : undefined;
+    if (pid === undefined) {
+        // Fresh process (each CLI invocation is its own node process — see
+        // module header) — launchedPids is per-process and empty here even
+        // though a prior `open` in a DIFFERENT process launched this Chrome.
+        // Fall back to the PID that process persisted via saveSessionRecord().
+        try {
+            const persisted = await loadSessionRecord(port);
+            if (persisted?.launched && persisted.pid) {
+                // Bound how far we trust a cross-process PID: if the Chrome we
+                // launched died outside this flow (OOM-killed, host slept, etc.)
+                // without its session record ever being cleared, the OS can recycle
+                // that PID for an unrelated process. There is no cmdline/start-time
+                // check available portably, so a coarse age bound is the practical
+                // guard — a PID persisted more than a day ago is far more likely to
+                // be stale/reused than to still be the same live Chrome.
+                const age = persisted.savedAt !== undefined ? Date.now() - persisted.savedAt : undefined;
+                if (age === undefined || age <= PERSISTED_PID_MAX_AGE_MS) {
+                    pid = persisted.pid;
+                    if (persisted.ownsUserDataDir)
+                        profileDir = persisted.userDataDir;
+                }
+            }
+        }
+        catch {
+            // best-effort — fall through to "nothing to kill" below
+        }
+    }
+    if (pid === undefined)
+        return; // not a process we launched, or too stale to trust — nothing to kill
+    launchedPids.delete(port);
+    ownedUserDataDirPorts.delete(port);
+    // Liveness-check before every SIGKILL (not just the safety-net path below)
+    // — process.kill(pid, 0) throws ESRCH if the PID is no longer running,
+    // which also catches the case where the PID has already been recycled by
+    // an unrelated process that happens to have exited too.
+    if (!gracefullyClosed) {
+        try {
+            process.kill(pid, 0);
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            /* already exited, or never was — nothing to do */
+        }
+    }
+    else if (!(await waitForProcessExit(pid))) {
+        // Browser.close was acknowledged — wait for the process to actually go
+        // away, then force-kill as a safety net in case it hung.
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            /* raced us to exit — expected */
+        }
+    }
+    // Waits (bounded) for the killed process to be gone before deleting.
+    if (profileDir)
+        await removeOwnedProfileDir(profileDir, { pid });
+}
+/** Poll until `pid` is gone or PROCESS_EXIT_TIMEOUT_MS elapses. Returns
+ *  whether it exited. `process.kill(pid, 0)` throws once the process is no
+ *  longer there, on Windows as well as POSIX.
+ *
+ *  This timer is deliberately NOT unref'd. closeBrowser() awaits this poll
+ *  as part of its own return value — a caller that awaits closeBrowser() is
+ *  actively blocked on it, not doing other work in the background. Once
+ *  Chrome's CDP websocket closes (which happens right around here, as part
+ *  of it shutting down), nothing else may be left holding the event loop
+ *  open; an unref'd timer at that point never fires because Node considers
+ *  the loop drained and exits without running it, leaving this promise (and
+ *  closeBrowser()'s) pending forever — reproduced locally by closing a real
+ *  launched browser with nothing else scheduled. Bounded by
+ *  PROCESS_EXIT_TIMEOUT_MS (5s) either way, so keeping it ref'd only ever
+ *  costs a caller a few seconds, never a hang. */
+async function waitForProcessExit(pid) {
+    const deadline = Date.now() + PROCESS_EXIT_TIMEOUT_MS;
+    for (;;) {
+        try {
+            process.kill(pid, 0);
+        }
+        catch {
+            return true;
+        }
+        if (Date.now() >= deadline)
+            return false;
+        await new Promise((resolve) => {
+            setTimeout(resolve, PROCESS_EXIT_POLL_MS);
+        });
+    }
+}
+/**
+ * Give back the CDP port of a browser we launched that nothing is using any
+ * more. A launched Chrome is deliberately detached and unref'd so it outlives
+ * the command that spawned it and later commands can reattach — but nothing
+ * reaped it afterwards, so an abandoned session kept listening on its port
+ * (9222 by convention, which other local tools want) indefinitely. A foreign
+ * CDP server *answers* there rather than refusing the connection, so those
+ * tools retry the wrong port and report misleading errors instead of moving on.
+ *
+ * Nothing long-lived exists to run this on a timer — every CLI command is its
+ * own short-lived process — so it runs at the next launch/attach instead
+ * (see launchBrowser). A browser is reaped only when ALL of these hold:
+ *   - the persisted session says WE launched it — `connect` records
+ *     launched:false for a browser that belongs to the user, never touched;
+ *   - that session is older than IDLE_REAP_AFTER_MS;
+ *   - the CDP endpoint still answers and reports ZERO targets. An open tab,
+ *     or a client attached to one (Chrome drops webSocketDebuggerUrl from an
+ *     attached target but still lists it), means the session is live and
+ *     reattach-across-commands must keep working.
+ *
+ * Shutdown goes through closeBrowser() on the browser-level websocket — the
+ * only connection left once every target is gone — so a recycled PID can
+ * never be signaled by mistake: graceful `Browser.close` reaches whatever is
+ * actually listening on that port, at any age, and the persisted PID is only
+ * ever used for closeBrowser's own age-bounded force-kill.
+ *
+ * Never throws: a failed reap must not stop a launch. Returns the reaped
+ * port, or null when there was nothing to reap. Sessions are per-port
+ * (#318), so every recorded one is considered, not just the newest.
+ */
+export async function reapIdleLaunchedBrowser() {
+    let reaped = null;
+    for (const session of await listSessionRecords().catch(() => [])) {
+        const port = await reapSession(session);
+        reaped ??= port;
+    }
+    return reaped;
+}
+async function reapSession(session) {
+    try {
+        if (!session.launched || session.savedAt === undefined)
+            return null;
+        if (Date.now() - session.savedAt < IDLE_REAP_AFTER_MS)
+            return null;
+        const wsUrl = await fetchBrowserWebSocketUrl(session.port);
+        if (!wsUrl)
+            return null;
+        if ((await fetchTargets(session.port)).length > 0)
+            return null;
+        const client = new CdpClient();
+        let reapTimer;
+        try {
+            // CdpClient.connect() has no timeout of its own — a socket that never
+            // opens (and never errors) would hang the launch this reap is running
+            // inside of, which is strictly worse than leaving the port squatted.
+            // Not unref'd (see closeBrowser): a socket that never opens and never
+            // errors leaves this timer as the only thing that can settle the race,
+            // and the reap is awaited inside launch/attach. Cleared in the finally
+            // below so a connect that succeeds does not pin the event loop.
+            await Promise.race([
+                client.connect(wsUrl),
+                new Promise((_, reject) => {
+                    reapTimer = setTimeout(() => reject(new Error('Reap: CDP connect timed out')), REAP_CONNECT_TIMEOUT_MS);
+                }),
+            ]);
+            await closeBrowser(client, session.port);
+        }
+        finally {
+            clearTimeout(reapTimer);
+            try {
+                client.close();
+            }
+            catch {
+                /* already gone */
+            }
+        }
+        launchedPids.delete(session.port);
+        launchedUserDataDirs.delete(session.port);
+        await removeSessionRecord(session.port);
+        return session.port;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=browser-lifecycle.js.map

package/dist/src/browser/browser-lifecycle.js.map

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

package/dist/src/browser/browser-page.d.ts

@@ -0,0 +1,13 @@
+import { CdpClient } from './cdp.js';
+import type { CdpTarget } from './types.js';
+export declare function enableSessionDomains(client: CdpClient, sessionId: string): Promise<void>;
+export declare function connectToTarget(port: number, targetId?: string): Promise<{
+    client: CdpClient;
+    target: CdpTarget;
+    sessionId: string;
+}>;
+export declare function openUrl(client: CdpClient, sessionId: string, url: string): Promise<void>;
+export declare function waitForLoad(client: CdpClient, sessionId: string, condition?: 'load' | 'networkidle' | 'domcontentloaded', timeout?: number): Promise<void>;
+export declare function getCurrentUrl(client: CdpClient, sessionId: string): Promise<string>;
+export declare function getCurrentTitle(client: CdpClient, sessionId: string): Promise<string>;
+//# sourceMappingURL=browser-page.d.ts.map

package/dist/src/browser/browser-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-page.d.ts","sourceRoot":"","sources":["../../../src/browser/browser-page.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAgC,MAAM,UAAU,CAAC;AAGnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BtE;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9F;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAM,GAAG,aAAa,GAAG,kBAA2B,EAC/D,OAAO,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAyCf;AAiFD,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3F"}

package/dist/src/browser/browser-page.js

@@ -0,0 +1,179 @@
+// Split out of browser.ts (file-size sweep). Pure move: no behaviour change.
+import { CdpClient, fetchNewTarget, fetchTargets } from './cdp.js';
+import { enableConsoleCapture, setupConsoleCapture } from './console-log.js';
+import { setupDialogAutoHandling } from './dialog.js';
+export async function enableSessionDomains(client, sessionId) {
+    await Promise.all([
+        client.send('Page.enable', {}, sessionId),
+        client.send('Runtime.enable', {}, sessionId),
+        client.send('Network.enable', {}, sessionId),
+        client.send('DOM.enable', {}, sessionId),
+        client.send('Accessibility.enable', {}, sessionId),
+    ]);
+    setupConsoleCapture(client, sessionId);
+    await enableConsoleCapture(client, sessionId);
+    setupDialogAutoHandling(client, sessionId);
+}
+export async function connectToTarget(port, targetId) {
+    const targets = await fetchTargets(port);
+    const pageTargets = targets.filter((t) => t.type === 'page');
+    let target;
+    if (targetId) {
+        const found = pageTargets.find((t) => t.id === targetId);
+        if (!found)
+            throw new Error(`Target ${targetId} not found`);
+        target = found;
+    }
+    else if (pageTargets.length > 0) {
+        target = pageTargets[0];
+    }
+    else {
+        target = await fetchNewTarget(port, 'about:blank');
+    }
+    const wsUrl = target.webSocketDebuggerUrl ?? `ws://127.0.0.1:${port}/devtools/page/${target.id}`;
+    const client = new CdpClient();
+    await client.connect(wsUrl);
+    const { sessionId } = await client.send('Target.attachToTarget', {
+        targetId: target.id,
+        flatten: true,
+    });
+    await enableSessionDomains(client, sessionId);
+    return { client, target, sessionId };
+}
+export async function openUrl(client, sessionId, url) {
+    // Cap to 2 MB to prevent OOM in CDP message serializer (e.g. data: URI attacks)
+    if (url.length > 2_097_152)
+        throw new Error('URL exceeds 2 MB limit');
+    // Page.navigate reports a protocol-level failure (e.g. a refused connection)
+    // via errorText in its own response, before Chrome ever settles on the
+    // chrome-error://chromewebdata/ page — without this check a refused
+    // connection previously reported success against that error page.
+    const nav = await client.send('Page.navigate', { url }, sessionId);
+    if (nav.errorText)
+        throw new Error(`Navigation to ${url} failed: ${nav.errorText}`);
+    await waitForNetworkIdle(client, sessionId, 500, 30_000);
+}
+export async function waitForLoad(client, sessionId, condition = 'load', timeout = 30_000) {
+    if (condition === 'load' || condition === 'domcontentloaded') {
+        // Guard against race where the page loads before the listener is registered
+        const readyExpr = condition === 'load'
+            ? 'document.readyState === "complete"'
+            : 'document.readyState !== "loading"';
+        const readyCheck = await client
+            .send('Runtime.evaluate', {
+            expression: readyExpr,
+            returnByValue: true,
+        }, sessionId)
+            .catch(() => ({ result: { value: false } }));
+        if (readyCheck.result?.value)
+            return;
+        const event = condition === 'load' ? 'Page.loadEventFired' : 'Page.domContentEventFired';
+        const [eventPromise, cancelOnce] = client.onceWithOff(event, sessionId);
+        let timedOut = false;
+        let timeoutHandle;
+        const timeoutPromise = new Promise((resolve) => {
+            timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                resolve();
+            }, timeout);
+        });
+        try {
+            await Promise.race([eventPromise, timeoutPromise]);
+            if (timedOut)
+                throw new Error(`Timeout waiting for ${condition}`);
+        }
+        finally {
+            cancelOnce();
+            clearTimeout(timeoutHandle);
+        }
+        return;
+    }
+    // networkidle: no network requests for 500ms
+    await waitForNetworkIdle(client, sessionId, 500, timeout);
+}
+async function waitForNetworkIdle(client, sessionId, idleMs, timeout) {
+    return new Promise((resolve, reject) => {
+        let pending = 0;
+        const inflight = new Set();
+        let idleTimer = null;
+        const killTimer = setTimeout(() => {
+            cleanup();
+            reject(new Error('Timeout waiting for networkidle'));
+        }, timeout);
+        const cleanup = () => {
+            if (idleTimer) {
+                clearTimeout(idleTimer);
+                idleTimer = null;
+            }
+            clearTimeout(killTimer);
+            offReq();
+            offResp();
+            offFail();
+            offCache();
+            offResp2();
+        };
+        const settle = () => {
+            cleanup();
+            resolve();
+        };
+        const check = () => {
+            if (pending === 0) {
+                if (idleTimer)
+                    clearTimeout(idleTimer);
+                idleTimer = setTimeout(settle, idleMs);
+            }
+            else {
+                if (idleTimer) {
+                    clearTimeout(idleTimer);
+                    idleTimer = null;
+                }
+            }
+        };
+        const offReq = client.on('Network.requestWillBeSent', (params, sid) => {
+            if (sid !== sessionId)
+                return;
+            const id = params.requestId;
+            if (!inflight.has(id)) {
+                inflight.add(id);
+                pending++;
+                check();
+            }
+        });
+        const decrement = (params, sid) => {
+            if (sid !== sessionId)
+                return;
+            const id = params.requestId;
+            if (inflight.delete(id)) {
+                pending = Math.max(0, pending - 1);
+                check();
+            }
+        };
+        const offResp = client.on('Network.loadingFinished', decrement);
+        const offFail = client.on('Network.loadingFailed', decrement);
+        const offCache = client.on('Network.requestServedFromCache', decrement);
+        // Guard against requests that never fire loadingFinished/loadingFailed (e.g. data: URLs)
+        // Skip 3xx redirect responses — the request continues under the same requestId
+        const offResp2 = client.on('Network.responseReceived', (params, sid) => {
+            const p = params;
+            if (p.response.status >= 300 && p.response.status < 400)
+                return;
+            decrement(params, sid);
+        });
+        check();
+    });
+}
+export async function getCurrentUrl(client, sessionId) {
+    const result = await client.send('Runtime.evaluate', {
+        expression: 'location.href',
+        returnByValue: true,
+    }, sessionId);
+    return result.result?.value ?? '';
+}
+export async function getCurrentTitle(client, sessionId) {
+    const result = await client.send('Runtime.evaluate', {
+        expression: 'document.title',
+        returnByValue: true,
+    }, sessionId);
+    return result.result?.value ?? '';
+}
+//# sourceMappingURL=browser-page.js.map

package/dist/src/browser/browser-page.js.map

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

package/dist/src/browser/browser-state.d.ts

@@ -0,0 +1,11 @@
+export declare const launchedPids: Map<number, number>;
+export declare const launchedUserDataDirs: Map<number, string>;
+export declare const ownedUserDataDirPorts: Set<number>;
+/** PID of the Chrome instance *this process* launched on `port`, if any. */
+export declare function getLaunchedPid(port: number): number | undefined;
+/** userDataDir of the Chrome instance *this process* launched on `port`, if any. */
+export declare function getLaunchedUserDataDir(port: number): string | undefined;
+/** Whether the userDataDir of the Chrome *this process* launched on `port`
+ *  was created by monobrowse, and so is deleted when that browser closes. */
+export declare function ownsLaunchedUserDataDir(port: number): boolean;
+//# sourceMappingURL=browser-state.d.ts.map

package/dist/src/browser/browser-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-state.d.ts","sourceRoot":"","sources":["../../../src/browser/browser-state.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY,qBAA4B,CAAC;AAGtD,eAAO,MAAM,oBAAoB,qBAA4B,CAAC;AAG9D,eAAO,MAAM,qBAAqB,aAAoB,CAAC;AAEvD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED;6EAC6E;AAC7E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/src/browser/browser-state.js

@@ -0,0 +1,27 @@
+// Split out of browser.ts (file-size sweep). Pure move: no behaviour change.
+// Tracks the PID of Chrome instances *we* spawned, keyed by CDP port, so
+// closeBrowser() has a kill fallback when the graceful `Browser.close` CDP
+// command fails or times out (e.g. a hung renderer). Ports we merely attached
+// to (already-running browser) are never recorded here — we only ever kill
+// processes we launched ourselves.
+export const launchedPids = new Map();
+// userDataDir per launched port, persisted alongside the pid so a later
+// process can clean up the temp profile dir too (#395).
+export const launchedUserDataDirs = new Map();
+// Launched ports whose userDataDir monobrowse created itself (not one the
+// caller supplied). Only these profile dirs are ever deleted on close.
+export const ownedUserDataDirPorts = new Set();
+/** PID of the Chrome instance *this process* launched on `port`, if any. */
+export function getLaunchedPid(port) {
+    return launchedPids.get(port);
+}
+/** userDataDir of the Chrome instance *this process* launched on `port`, if any. */
+export function getLaunchedUserDataDir(port) {
+    return launchedUserDataDirs.get(port);
+}
+/** Whether the userDataDir of the Chrome *this process* launched on `port`
+ *  was created by monobrowse, and so is deleted when that browser closes. */
+export function ownsLaunchedUserDataDir(port) {
+    return ownedUserDataDirPorts.has(port);
+}
+//# sourceMappingURL=browser-state.js.map

package/dist/src/browser/browser-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-state.js","sourceRoot":"","sources":["../../../src/browser/browser-state.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,yEAAyE;AACzE,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,mCAAmC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;AACtD,wEAAwE;AACxE,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC9D,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;6EAC6E;AAC7E,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/browser/browser.d.ts

@@ -1,69 +1,6 @@
-import { CdpClient } from './cdp.js';
-import type { BrowserConfig, CdpTarget } from './types.js';
-/** PID of the Chrome instance *this process* launched on `port`, if any. */
-export declare function getLaunchedPid(port: number): number | undefined;
-/** userDataDir of the Chrome instance *this process* launched on `port`, if any. */
-export declare function getLaunchedUserDataDir(port: number): string | undefined;
-export declare function isPortOpen(port: number): Promise<boolean>;
-export declare function launchBrowser(config?: BrowserConfig): Promise<number>;
-export declare function enableSessionDomains(client: CdpClient, sessionId: string): Promise<void>;
-export declare function connectToTarget(port: number, targetId?: string): Promise<{
-    client: CdpClient;
-    target: CdpTarget;
-    sessionId: string;
-}>;
-/**
- * Cleanly terminate a Chrome/Chromium instance we launched on `port`.
- * Sends the `Browser.close` CDP command (the correct graceful shutdown —
- * closes all tabs and exits the process cleanly) over `client`'s connection.
- * If that command fails, times out, or the connection is already gone,
- * falls back to killing the tracked PID directly so a headed/interactive
- * browser window (e.g. one spawned for a login/CAPTCHA flow) never lingers
- * as a visible, authenticated, still-debuggable orphan process.
- *
- * On the graceful path this resolves only once the process is actually gone,
- * or after force-killing it when it outlasts PROCESS_EXIT_TIMEOUT_MS. Chrome
- * acknowledges `Browser.close` well before it exits, and this used to return
- * on the ack with an unref'd 1s timer as the only force-kill — so it resolved
- * while Chrome was still running and holding its port and its profile's
- * singleton lock, and if the caller's process exited first the kill never
- * happened at all. Callers reasonably read a resolved close() as "that
- * browser is gone"; on the graceful path it now means that.
- */
-export declare function closeBrowser(client: CdpClient, port: number): Promise<void>;
-/**
- * Give back the CDP port of a browser we launched that nothing is using any
- * more. A launched Chrome is deliberately detached and unref'd so it outlives
- * the command that spawned it and later commands can reattach — but nothing
- * reaped it afterwards, so an abandoned session kept listening on its port
- * (9222 by convention, which other local tools want) indefinitely. A foreign
- * CDP server *answers* there rather than refusing the connection, so those
- * tools retry the wrong port and report misleading errors instead of moving on.
- *
- * Nothing long-lived exists to run this on a timer — every CLI command is its
- * own short-lived process — so it runs at the next launch/attach instead
- * (see launchBrowser). A browser is reaped only when ALL of these hold:
- *   - the persisted session says WE launched it — `connect` records
- *     launched:false for a browser that belongs to the user, never touched;
- *   - that session is older than IDLE_REAP_AFTER_MS;
- *   - the CDP endpoint still answers and reports ZERO targets. An open tab,
- *     or a client attached to one (Chrome drops webSocketDebuggerUrl from an
- *     attached target but still lists it), means the session is live and
- *     reattach-across-commands must keep working.
- *
- * Shutdown goes through closeBrowser() on the browser-level websocket — the
- * only connection left once every target is gone — so a recycled PID can
- * never be signaled by mistake: graceful `Browser.close` reaches whatever is
- * actually listening on that port, at any age, and the persisted PID is only
- * ever used for closeBrowser's own age-bounded force-kill.
- *
- * Never throws: a failed reap must not stop a launch. Returns the reaped
- * port, or null when there was nothing to reap. Sessions are per-port
- * (#318), so every recorded one is considered, not just the newest.
- */
-export declare function reapIdleLaunchedBrowser(): Promise<number | null>;
-export declare function openUrl(client: CdpClient, sessionId: string, url: string): Promise<void>;
-export declare function waitForLoad(client: CdpClient, sessionId: string, condition?: 'load' | 'networkidle' | 'domcontentloaded', timeout?: number): Promise<void>;
-export declare function getCurrentUrl(client: CdpClient, sessionId: string): Promise<string>;
-export declare function getCurrentTitle(client: CdpClient, sessionId: string): Promise<string>;
+export { isPortOpen } from './browser-discovery.js';
+export { launchBrowser } from './browser-launch.js';
+export { closeBrowser, reapIdleLaunchedBrowser } from './browser-lifecycle.js';
+export { connectToTarget, enableSessionDomains, getCurrentTitle, getCurrentUrl, openUrl, waitForLoad, } from './browser-page.js';
+export { getLaunchedPid, getLaunchedUserDataDir, ownsLaunchedUserDataDir, } from './browser-state.js';
 //# sourceMappingURL=browser.d.ts.map

package/dist/src/browser/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser/browser.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAgC,MAAM,UAAU,CAAC;AASnE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8B3D,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AA0BD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAyDD,wBAAsB,aAAa,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyF/E;AAyPD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8EjF;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOtE;AA6DD,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9F;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAM,GAAG,aAAa,GAAG,kBAA2B,EAC/D,OAAO,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAyCf;AAiFD,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3F"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser/browser.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}