prismcast 1.10.2 → 1.11.0

package/dist/browser/blockedPage.js

@@ -0,0 +1,209 @@
+import { consentOverlayPresent } from "./consent.js";
+import { waitWithTimeout } from "../utils/index.js";
+/* When a channel discovery walk returns zero channels, the page it walked is still open - and what is on that page is evidence. This module classifies that
+ * still-open page as a provider authentication wall, a consent overlay, or unknown, so the discovery-outcome policy in precaching.ts can persist the needs-sign-in
+ * domain state on positive evidence rather than guessing from redirects or URL shapes.
+ *
+ * The module follows the pure-decision-core / thin-impure-adapter split (the browserSupervisor / launchGovernor precedent): decideBlockedPage is a pure function
+ * over collected signals, and classifyBlockedPage is the thin adapter that gathers those signals from the live page. The signal gathering itself composes
+ * consentOverlayPresent from consent.ts (never duplicated) plus one in-page collector (collectSignInContainers) that reports candidate sign-in containers.
+ *
+ * Decision order: (a) provider-declared indicators, (b) consent overlay, (c) the generic container-scoped sign-in shape, (d) unknown. Consent is checked before the
+ * generic shape because a CMP banner can mask a wall behind it - we cannot see through the mask, so consent is the more actionable signal. The discovery walk runs
+ * its own consent-overlay poll (see consent.ts), which dismisses the banner proactively, so a consentOverlay classification here means that poll could not clear it
+ * - the banner is the standing obstacle, and dismissing it manually is the actionable next step.
+ *
+ * classifyBlockedPage never throws: classification is best-effort advisory evidence, so any internal failure (the page closed or navigated mid-probe, an evaluate
+ * error) degrades to the unknown classification rather than propagating into the discovery path.
+ */
+// Ancestor depth bound for the container search in collectSignInContainers. Mirrors consent.ts's embed-gate ancestor bound - deep enough to find the form-like
+// wrapper around an input on a real page, shallow enough that the search can never escalate to a page-level container.
+const CONTAINER_SEARCH_DEPTH = 6;
+// Cap on the container text carried back across the evaluate boundary. Sign-in phrasing sits next to the inputs it describes, so a bounded snippet is enough; the
+// cap keeps a pathological container from shipping an entire page of text into Node.
+const CONTAINER_TEXT_LIMIT = 500;
+// Source for the sign-in phrasing that qualifies a candidate container as an authentication wall. Kept narrow and account-flavored so newsletter, search, and other
+// benign text-entry forms never match. The gerund arm ("entering your email") covers walls whose form copy phrases the instruction inside a terms-of-use sentence
+// ("By entering your email and clicking Continue..."), the shape the Fox One wall uses. Held as a source string (rather than a RegExp) to match the consent.ts
+// convention for patterns whose natural home is the page.evaluate boundary, although the decision core applies it Node-side.
+const SIGN_IN_PHRASING_SOURCE = "\\b(sign[ -]?in|log[ -]?in|sign[ -]?on|enter(ing)? your e-?mail|create an? (free )?account)\\b";
+// The compiled sign-in phrasing matcher used by the pure decision core.
+const SIGN_IN_PHRASING_RE = new RegExp(SIGN_IN_PHRASING_SOURCE, "i");
+// Upper bound in milliseconds on the blocked-page classification. classifyBlockedPage bounds its own signal gathering with this budget, so it is never-throwing AND
+// never-hanging: a hung renderer cannot stall a caller's failure path, and no caller needs a timeout wrapper of its own. Four seconds accommodates the DOM probes on
+// a responsive page while keeping the added window negligible inside the callers' own time budgets (the tune's playback-initialization race, the precache cycle).
+const BLOCKED_PAGE_CLASSIFY_TIMEOUT = 4000;
+/**
+ * In-page collector for candidate sign-in containers. For every password, email, or text input on the page, it resolves the input's candidate container - the
+ * enclosing form when one exists, otherwise the nearest ancestor within a bounded depth that carries a submit affordance - and reports the container's structure.
+ * The body and document element are never candidates, which (together with the depth bound) is what makes the shape rule container-scoped: a newsletter form in the
+ * footer and a "Sign In" link in the nav can never merge into one record.
+ *
+ * This function crosses the page.evaluate boundary by source serialization, so it is self-contained: it references only its argument and the page's document
+ * global. Exported so unit tests can run it against a synthetic DOM.
+ * @param args - The depth bound for the ancestor search and the text cap per record.
+ * @returns One record per qualifying input's container. Containers are reported per seeding input, without deduplication - the decision core only asks whether any
+ * record qualifies.
+ */
+export function collectSignInContainers(args) {
+    const records = [];
+    for (const input of Array.from(document.querySelectorAll("input"))) {
+        // Only password, email, and text inputs can seed a sign-in shape. A type-less input defaults to text per the HTML spec.
+        const type = (input.getAttribute("type") ?? "text").toLowerCase();
+        if (!["email", "password", "text"].includes(type)) {
+            continue;
+        }
+        // Skip hidden inputs (and inputs inside hidden subtrees). Autofill honeypots are commonly hidden password or text inputs, and a hidden control is not part of
+        // the wall a viewer would see.
+        if (input.hasAttribute("hidden") || (input.closest("[hidden]") !== null)) {
+            continue;
+        }
+        // Resolve the candidate container: the enclosing form wins; otherwise walk up a bounded number of ancestors looking for one that carries a submit affordance.
+        let container = input.closest("form");
+        if (!container) {
+            let node = input.parentElement;
+            for (let depth = 0; node && (depth < args.maxDepth); depth++) {
+                if ((node === document.body) || (node === document.documentElement)) {
+                    break;
+                }
+                if (node.querySelector("button, input[type=\"submit\"], [role=\"button\"]") !== null) {
+                    container = node;
+                    break;
+                }
+                node = node.parentElement;
+            }
+        }
+        if (!container || (container === document.body) || (container === document.documentElement)) {
+            continue;
+        }
+        /* Compose the container's text from its descendant text nodes joined with single spaces. Raw textContent concatenates adjacent elements without separators (a
+         * heading followed by a button reads "Enter Your EmailContinue"), which would defeat the decision core's word-boundary phrasing match. The numeric whatToShow
+         * value is NodeFilter.SHOW_TEXT, named locally so the collector stays self-contained across the evaluate boundary without relying on the NodeFilter global.
+         */
+        const SHOW_TEXT = 4;
+        const parts = [];
+        const walker = document.createTreeWalker(container, SHOW_TEXT);
+        while (walker.nextNode()) {
+            parts.push(walker.currentNode.textContent ?? "");
+        }
+        const text = parts.join(" ").replace(/\s+/g, " ").trim().slice(0, args.textLimit);
+        records.push({
+            hasPasswordInput: container.querySelector("input[type=\"password\"]") !== null,
+            hasSubmitAffordance: container.querySelector("button, input[type=\"submit\"], [role=\"button\"]") !== null,
+            hasTextEntry: (type === "email") || (type === "text"),
+            text
+        });
+    }
+    return records;
+}
+/**
+ * Extracts the hostname from a URL, or null when the URL does not parse. Pure helper for the host-indicator match and the evidence composition.
+ */
+function hostnameOf(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reduces a URL to its host and path for evidence strings. Sign-in redirects carry per-session tokens (login challenges, device identifiers, API keys) in the
+ * query string - noise with no diagnostic value that does not belong in a log users share when asking for help. Falls back to the raw string when the URL does
+ * not parse, since evidence must always name where discovery landed.
+ */
+function displayUrlOf(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.host + parsed.pathname;
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Matches a hostname against a provider-declared host pattern using cookie-domain semantics: an exact match, or any subdomain of the pattern.
+ */
+const hostMatchesPattern = (hostname, pattern) => (hostname === pattern) || hostname.endsWith("." + pattern);
+/**
+ * The pure decision core: classifies a blocked page from its collected signals. Decision order is (a) provider indicators, (b) consent overlay, (c) the generic
+ * container-scoped sign-in shape, (d) unknown - see the module comment for the (b)-before-(c) rationale. The landed-URL-differs signal strengthens authWall
+ * evidence but never suffices alone: with no indicator, no consent overlay, and no qualifying container, a redirect classifies as unknown.
+ * @param signals - The collected page signals.
+ * @returns The classification.
+ */
+export function decideBlockedPage(signals) {
+    // (a) Provider-declared indicators are authoritative: the provider named its own wall, so no shape inference is needed.
+    if (signals.indicatorHostMatched || signals.indicatorSelectorMatched) {
+        const detail = signals.indicatorHostMatched ? "the landed URL matches the provider's auth wall host" : "a provider auth wall selector matched";
+        return { evidence: detail + " at " + displayUrlOf(signals.landedUrl), kind: "authWall" };
+    }
+    // (b) A consent overlay is present. It may be masking a wall behind it, but we cannot see through the mask - report the actionable signal we can see.
+    if (signals.consentOverlayPresent) {
+        return { kind: "consentOverlay" };
+    }
+    // (c) The generic shape rule, container-scoped: a password input qualifies its container outright; an email or text entry qualifies only alongside a submit
+    // affordance and sign-in phrasing in that container's own text.
+    const match = signals.containers.find((container) => container.hasPasswordInput ||
+        (container.hasTextEntry && container.hasSubmitAffordance && SIGN_IN_PHRASING_RE.test(container.text)));
+    if (match) {
+        const landedHost = hostnameOf(signals.landedUrl);
+        const requestedHost = hostnameOf(signals.requestedUrl);
+        const redirectNote = (landedHost !== null) && (requestedHost !== null) && (landedHost !== requestedHost) ?
+            " instead of the requested " + displayUrlOf(signals.requestedUrl) : "";
+        return { evidence: "a sign-in form is present at " + displayUrlOf(signals.landedUrl) + redirectNote, kind: "authWall" };
+    }
+    // (d) Nothing recognizable - including the URL-change-only case, which never suffices on its own.
+    return { kind: "unknown" };
+}
+/**
+ * Classifies a still-open page whose discovery walk returned zero channels. Gathers signals lazily in decision order - each probe is skipped once an earlier signal
+ * already decides the outcome - and hands them to the pure decision core. The gathering is bounded by BLOCKED_PAGE_CLASSIFY_TIMEOUT internally, so the classifier is
+ * both never-throwing AND never-hanging: every caller gets an advisory result within the budget with no wrapper of its own.
+ * @param page - The still-open discovery page.
+ * @param options - The provider's optional auth wall indicators and the originally requested URL.
+ * @returns The page's classification.
+ */
+export async function classifyBlockedPage(page, options) {
+    /* The signal gathering, in its own never-throwing chain: any internal failure (the page closed or navigated mid-probe, an evaluate error) degrades to the unknown
+     * classification. Because this chain never rejects, a probe that outruns the budget below and settles late - against a page that has since closed - resolves
+     * harmlessly to unknown rather than surfacing an unhandled rejection after the race has already been decided by the timeout.
+     */
+    const gather = async () => {
+        try {
+            const landedUrl = page.url();
+            const landedHost = hostnameOf(landedUrl);
+            const indicatorHostMatched = (landedHost !== null) && (options.indicators?.hosts ?? []).some((pattern) => hostMatchesPattern(landedHost, pattern));
+            // Probe the provider's DOM selectors only when the host indicator has not already decided.
+            let indicatorSelectorMatched = false;
+            if (!indicatorHostMatched) {
+                for (const selector of options.indicators?.selectors ?? []) {
+                    // eslint-disable-next-line no-await-in-loop
+                    if ((await page.$(selector)) !== null) {
+                        indicatorSelectorMatched = true;
+                        break;
+                    }
+                }
+            }
+            const indicatorMatched = indicatorHostMatched || indicatorSelectorMatched;
+            const consentPresent = indicatorMatched ? false : await consentOverlayPresent(page);
+            const containers = (indicatorMatched || consentPresent) ? [] :
+                await page.evaluate(collectSignInContainers, { maxDepth: CONTAINER_SEARCH_DEPTH, textLimit: CONTAINER_TEXT_LIMIT });
+            return decideBlockedPage({ consentOverlayPresent: consentPresent, containers, indicatorHostMatched, indicatorSelectorMatched, landedUrl,
+                requestedUrl: options.requestedUrl });
+        }
+        catch {
+            // The page closed or navigated mid-probe, or an evaluate failed. Classification is advisory evidence - an unreadable page is simply unknown.
+            return { kind: "unknown" };
+        }
+    };
+    // Bound the gathering so a hung renderer cannot stall the caller: on a lapse the rejection lands here and becomes unknown, the same outcome a slow-but-empty
+    // page would produce.
+    try {
+        return await waitWithTimeout(gather(), BLOCKED_PAGE_CLASSIFY_TIMEOUT);
+    }
+    catch {
+        return { kind: "unknown" };
+    }
+}
+//# sourceMappingURL=blockedPage.js.map

package/dist/browser/blockedPage.js.map

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

package/dist/browser/browserSupervisor.d.ts

@@ -0,0 +1,80 @@
+import type { LaunchGovernorPolicy } from "./launchGovernor.ts";
+import type { Browser } from "puppeteer-core";
+import type { Nullable } from "../types/index.ts";
+/**
+ * The browser lifecycle. The Browser reference lives inside the `ready` variant, so "is it ready" cannot desync from "do we have a browser" the way a separate
+ * boolean flag could, and illegal states (ready-and-launching) are unrepresentable. `degraded` is the governor's OPEN state (cooling, not serving); `trialing` is
+ * its HALF-OPEN state (one launch in flight after the cooldown elapsed). `closing` is a teardown of a still-running Chrome draining to completion, and its `until`
+ * is the conservative bound that requests rejected mid-drain carry as their retry horizon.
+ */
+export type BrowserLifecycle = {
+    readonly kind: "absent";
+} | {
+    readonly kind: "launching";
+    readonly promise: Promise<Browser>;
+} | {
+    readonly kind: "ready";
+    readonly browser: Browser;
+    readonly launchTime: number;
+} | {
+    readonly kind: "degraded";
+    readonly reason: string;
+    readonly until: number;
+} | {
+    readonly kind: "trialing";
+    readonly promise: Promise<Browser>;
+} | {
+    readonly kind: "closing";
+    readonly teardown: Promise<void>;
+    readonly until: number;
+};
+/**
+ * The injected dependencies. `launch` performs the real, gated launch - it must resolve only with a capture-ready browser and reject otherwise (the adapter runs
+ * the readiness gate inside it). `now` is the time source (realClock.now in production, a fake in tests). `policy` bounds the governor; it is a getter, read fresh
+ * at each governor decision, so the adapter can source the bounds from live configuration and an operator's change takes effect without reconstructing the
+ * supervisor. `onStateChange` is an optional observer the adapter uses to log transitions and raise the loud degraded alarm; the supervisor itself stays log-free.
+ */
+export interface BrowserSupervisorPorts {
+    readonly close: (browser: Browser) => Promise<void>;
+    readonly launch: () => Promise<Browser>;
+    readonly now: () => number;
+    readonly onStateChange?: (next: BrowserLifecycle, previous: BrowserLifecycle) => void;
+    readonly policy: () => LaunchGovernorPolicy;
+}
+/**
+ * The supervisor surface. acquire() is the lazy, gated launcher (the getCurrentBrowser core); current()/currentLaunchTime() are non-launching reads; the note*
+ * methods feed lifecycle events; noteSustainedHealth() drives the health-gated governor reset; inspect() exposes the state for the adapter and tests.
+ */
+export interface BrowserSupervisor {
+    readonly acquire: () => Promise<Browser>;
+    readonly current: () => Nullable<Browser>;
+    readonly currentLaunchTime: () => Nullable<number>;
+    readonly inspect: () => BrowserLifecycle;
+    readonly noteReadinessLost: () => void;
+    readonly noteSustainedHealth: () => boolean;
+    readonly noteTeardownBegun: (teardown: Promise<void>, drainBoundMs: number) => void;
+}
+/**
+ * Error thrown by acquire() while the governor is cooling (degraded). Carries the timestamp until which launches are blocked so the adapter can surface a
+ * Retry-After and a 503-class back-off rather than spawning Chrome. Distinct from a launch failure (which rejects with the underlying launch error).
+ */
+export declare class BrowserUnavailableError extends Error {
+    readonly retryAfter: number;
+    constructor(retryAfter: number);
+}
+/**
+ * Thrown by acquire() when a launch in flight was superseded by a readiness-loss (a disconnect or an intentional close) before it completed. The browser it
+ * produced has been closed; the caller should retry, which will launch fresh or hit the governor's gate. This keeps an abandoned launch from publishing a browser
+ * the supervisor was told to discard.
+ */
+export declare class BrowserSupersededError extends Error {
+    constructor();
+}
+/**
+ * Creates a browser supervisor over the injected ports. The returned object owns the lifecycle and governor state for the process lifetime; the adapter holds one
+ * instance and routes all browser access through it.
+ * @param ports - The injected launch, clock, policy, and optional transition observer.
+ * @returns The supervisor surface.
+ */
+export declare function createBrowserSupervisor(ports: BrowserSupervisorPorts): BrowserSupervisor;
+//# sourceMappingURL=browserSupervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browserSupervisor.d.ts","sourceRoot":"","sources":["../../src/browser/browserSupervisor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,qBAAqB,CAAC;AAErF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAalD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IAIrC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,oBAAoB,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAIhC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAGzC,QAAQ,CAAC,OAAO,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IAG1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IAGnD,QAAQ,CAAC,OAAO,EAAE,MAAM,gBAAgB,CAAC;IAIzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAIvC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,OAAO,CAAC;IAK5C,QAAQ,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACrF;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAEhD,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAO/B;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;;CAQhD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAoNxF"}

package/dist/browser/browserSupervisor.js

@@ -0,0 +1,186 @@
+import { canAttemptLaunch, createLaunchGovernorState, noteLaunchFailure, noteLaunchSuccess, noteReadinessLost, noteSustainedHealth } from "./launchGovernor.js";
+/**
+ * Error thrown by acquire() while the governor is cooling (degraded). Carries the timestamp until which launches are blocked so the adapter can surface a
+ * Retry-After and a 503-class back-off rather than spawning Chrome. Distinct from a launch failure (which rejects with the underlying launch error).
+ */
+export class BrowserUnavailableError extends Error {
+    retryAfter;
+    constructor(retryAfter) {
+        super("The browser is temporarily unavailable while its capture system recovers.");
+        this.name = "BrowserUnavailableError";
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Thrown by acquire() when a launch in flight was superseded by a readiness-loss (a disconnect or an intentional close) before it completed. The browser it
+ * produced has been closed; the caller should retry, which will launch fresh or hit the governor's gate. This keeps an abandoned launch from publishing a browser
+ * the supervisor was told to discard.
+ */
+export class BrowserSupersededError extends Error {
+    constructor() {
+        super("The browser launch was superseded before it completed.");
+        this.name = "BrowserSupersededError";
+    }
+}
+/**
+ * Creates a browser supervisor over the injected ports. The returned object owns the lifecycle and governor state for the process lifetime; the adapter holds one
+ * instance and routes all browser access through it.
+ * @param ports - The injected launch, clock, policy, and optional transition observer.
+ * @returns The supervisor surface.
+ */
+export function createBrowserSupervisor(ports) {
+    const governor = createLaunchGovernorState();
+    let state = { kind: "absent" };
+    // Monotonic launch epoch. Incremented whenever readiness is lost so an in-flight launch can detect it was superseded and refuse to publish a browser the
+    // supervisor was told to abandon (the stale-launch race). Each launch captures the epoch at its start and checks it before mutating state.
+    let generation = 0;
+    // Single transition chokepoint so every state change flows through one place and notifies the observer. The observer is best-effort - it never affects the
+    // transition - so a throwing logger cannot corrupt the lifecycle.
+    function transition(next) {
+        const previous = state;
+        state = next;
+        ports.onStateChange?.(next, previous);
+    }
+    // Drives one launch attempt to completion, transitioning to ready on success or to degraded/absent on failure, and feeding the governor either way. Returns the
+    // browser on success and rejects with the underlying error on failure. The state is moved to launching/trialing by the caller before this resolves. Whether the
+    // attempt is the post-cooldown trial arrives as a parameter rather than being read back from the state at settle time: the lifecycle may have moved on by then,
+    // and being a trial is a fact about the attempt itself.
+    async function runLaunch(launchGeneration, isTrial) {
+        let browser;
+        try {
+            browser = await ports.launch();
+        }
+        catch (error) {
+            // Record the failure and move the state only if this launch is still the current one. A readiness-loss during the launch supersedes it (a newer epoch owns
+            // the state), and a superseded launch must not count a governor failure or move the state - the caller's request will retry.
+            if (launchGeneration === generation) {
+                const outcome = noteLaunchFailure(governor, ports.now(), ports.policy(), isTrial);
+                // A trip moves us to degraded (cooling, no launches until the cooldown elapses); below the threshold we return to absent so the next request relaunches
+                // immediately - the common transient costs no cooldown.
+                if (outcome.tripped && (outcome.cooldownUntil !== null)) {
+                    transition({ kind: "degraded", reason: "Browser launch failed and the relaunch governor tripped.", until: outcome.cooldownUntil });
+                }
+                else {
+                    transition({ kind: "absent" });
+                }
+            }
+            throw error;
+        }
+        // The launch succeeded. If a readiness-loss superseded it while it was in flight, this browser was abandoned: close it (best effort) so it does not leak a
+        // Chrome process, and signal the caller to retry rather than clobbering the current state with a browser that should never have been published.
+        if (launchGeneration !== generation) {
+            try {
+                await ports.close(browser);
+            }
+            catch {
+                // Best effort: a failed orphan close is the adapter's concern to log; the supervisor still reports supersession.
+            }
+            throw new BrowserSupersededError();
+        }
+        noteLaunchSuccess(governor, ports.now());
+        transition({ browser, kind: "ready", launchTime: ports.now() });
+        return browser;
+    }
+    /* Begins a launch in the given phase (launching for a normal acquire, trialing for a post-cooldown trial) and publishes the in-flight promise into the state so
+     * concurrent acquire() callers join it rather than starting a second Chrome. The body deliberately has no await: it starts runLaunch (which suspends at the
+     * launch port) and publishes the launching/trialing state synchronously, before returning, so single-flight holds. It is async only to satisfy the
+     * promise-returning-function convention; the synchronous publish is what matters for correctness. The phase this begins in is also what tells the attempt
+     * whether it is the trial, so the governor can judge its failure accordingly.
+     */
+    async function beginLaunch(kind) {
+        const promise = runLaunch(generation, kind === "trialing");
+        transition({ kind, promise });
+        return promise;
+    }
+    async function acquire() {
+        switch (state.kind) {
+            case "ready": {
+                return state.browser;
+            }
+            // Join the launch already in flight rather than starting a second one - the single-flight guarantee.
+            case "launching":
+            case "trialing": {
+                return state.promise;
+            }
+            // Cooling: the cooldown gates the relaunch, decoupled from request arrival. If it has elapsed, run one trial (HALF-OPEN); otherwise reject fast without
+            // spawning Chrome (the loop bound).
+            case "degraded": {
+                if (canAttemptLaunch(governor, ports.now())) {
+                    return beginLaunch("trialing");
+                }
+                throw new BrowserUnavailableError(state.until);
+            }
+            // Draining: the retiring Chrome still holds the profile lock, so launching now would spawn a second one against it. Reject on the same retryable class the
+            // cooldown uses, carrying the drain's bound as the retry horizon, and let the caller come back once the process is gone.
+            case "closing": {
+                throw new BrowserUnavailableError(state.until);
+            }
+            case "absent": {
+                // canAttemptLaunch is true from absent (no cooldown is set), but we consult it for symmetry and future-proofing.
+                if (canAttemptLaunch(governor, ports.now())) {
+                    return beginLaunch("launching");
+                }
+                throw new BrowserUnavailableError(ports.now());
+            }
+            default: {
+                return assertNever(state);
+            }
+        }
+    }
+    function current() {
+        return (state.kind === "ready") ? state.browser : null;
+    }
+    function currentLaunchTime() {
+        return (state.kind === "ready") ? state.launchTime : null;
+    }
+    function handleReadinessLost() {
+        // Advance the epoch first so any launch already in flight is superseded and cannot publish its browser over this readiness-loss.
+        generation++;
+        noteReadinessLost(governor);
+        // Only meaningful from ready/launching/trialing; from absent/degraded/closing it is a harmless no-op that keeps the call site simple. Excluding closing is what
+        // keeps a drain intact: that state ends when its teardown settles, not when a caller reports the readiness it has already given up.
+        if ((state.kind === "ready") || (state.kind === "launching") || (state.kind === "trialing")) {
+            transition({ kind: "absent" });
+        }
+    }
+    /* Enters the closing state for a teardown the adapter has begun on the retired session's still-running Chrome, and holds there for the whole drain: acquire
+     * rejects retryable rather than launching a second Chrome against the profile lock the exiting one still holds.
+     *
+     * The method is self-sufficient rather than order-dependent - it advances the epoch and clears the governor's readiness anchor itself - so a teardown published
+     * without a preceding readiness-loss still supersedes an in-flight launch. In the adapter's real order readiness is relinquished first, which makes both
+     * operations redundant repeats here; that is harmless, and cheaper than a contract that only holds when the calls arrive in one particular order.
+     */
+    function handleTeardownBegun(teardown, drainBoundMs) {
+        generation++;
+        noteReadinessLost(governor);
+        const closing = { kind: "closing", teardown, until: ports.now() + drainBoundMs };
+        transition(closing);
+        /* Leave closing when this teardown settles, and only while this exact episode is still the current state. Comparing by identity rather than by kind means a
+         * state reached after the drain - including a second closing episode - cannot be knocked back to absent by an earlier drain settling late. A rejected teardown
+         * exits the same way: a failed close still ends the session, and any Chrome that survived it is reaped by the stale-process sweep at the next launch.
+         */
+        const exit = () => {
+            if (state === closing) {
+                transition({ kind: "absent" });
+            }
+        };
+        void teardown.then(exit, exit);
+    }
+    function noteSustainedHealthTick() {
+        if (state.kind !== "ready") {
+            return false;
+        }
+        return noteSustainedHealth(governor, ports.now(), ports.policy());
+    }
+    return { acquire, current, currentLaunchTime, inspect: () => state, noteReadinessLost: handleReadinessLost, noteSustainedHealth: noteSustainedHealthTick,
+        noteTeardownBegun: handleTeardownBegun };
+}
+/**
+ * Exhaustiveness guard for the lifecycle switch: referencing a `never` makes the compiler flag any unhandled variant if the union grows.
+ * @param value - The unreachable value.
+ * @returns Never returns.
+ */
+function assertNever(value) {
+    throw new Error("Unhandled browser lifecycle state: " + JSON.stringify(value));
+}
+//# sourceMappingURL=browserSupervisor.js.map

package/dist/browser/browserSupervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserSupervisor.js","sourceRoot":"","sources":["../../src/browser/browserSupervisor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAgFhK;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAEhC,UAAU,CAAS;IAEnC,YAAY,UAAkB;QAE5B,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAEnF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAE/C;QAEE,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAEhE,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA6B;IAEnE,MAAM,QAAQ,GAAwB,yBAAyB,EAAE,CAAC;IAElE,IAAI,KAAK,GAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEjD,yJAAyJ;IACzJ,2IAA2I;IAC3I,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,2JAA2J;IAC3J,kEAAkE;IAClE,SAAS,UAAU,CAAC,IAAsB;QAExC,MAAM,QAAQ,GAAG,KAAK,CAAC;QAEvB,KAAK,GAAG,IAAI,CAAC;QAEb,KAAK,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,gKAAgK;IAChK,gKAAgK;IAChK,gKAAgK;IAChK,wDAAwD;IACxD,KAAK,UAAU,SAAS,CAAC,gBAAwB,EAAE,OAAgB;QAEjE,IAAI,OAAgB,CAAC;QAErB,IAAI,CAAC;YAEH,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,CAAC;QAAC,OAAM,KAAK,EAAE,CAAC;YAEd,2JAA2J;YAC3J,6HAA6H;YAC7H,IAAG,gBAAgB,KAAK,UAAU,EAAE,CAAC;gBAEnC,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;gBAElF,wJAAwJ;gBACxJ,wDAAwD;gBACxD,IAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,IAAI,CAAC,EAAE,CAAC;oBAEvD,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,0DAA0D,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;gBACrI,CAAC;qBAAM,CAAC;oBAEN,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;QAED,2JAA2J;QAC3J,gJAAgJ;QAChJ,IAAG,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAEnC,IAAI,CAAC;gBAEH,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBAEP,iHAAiH;YACnH,CAAC;YAED,MAAM,IAAI,sBAAsB,EAAE,CAAC;QACrC,CAAC;QAED,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACzC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAEhE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,UAAU,WAAW,CAAC,IAA8B;QAEvD,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC;QAE3D,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAE9B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,UAAU,OAAO;QAEpB,QAAO,KAAK,CAAC,IAAI,EAAE,CAAC;YAElB,KAAK,OAAO,CAAC,CAAC,CAAC;gBAEb,OAAO,KAAK,CAAC,OAAO,CAAC;YACvB,CAAC;YAED,qGAAqG;YACrG,KAAK,WAAW,CAAC;YACjB,KAAK,UAAU,CAAC,CAAC,CAAC;gBAEhB,OAAO,KAAK,CAAC,OAAO,CAAC;YACvB,CAAC;YAED,wJAAwJ;YACxJ,oCAAoC;YACpC,KAAK,UAAU,CAAC,CAAC,CAAC;gBAEhB,IAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;oBAE3C,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;gBAED,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC;YAED,2JAA2J;YAC3J,yHAAyH;YACzH,KAAK,SAAS,CAAC,CAAC,CAAC;gBAEf,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBAEd,iHAAiH;gBACjH,IAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;oBAE3C,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;gBAClC,CAAC;gBAED,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,CAAC,CAAC,CAAC;gBAER,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,OAAO;QAEd,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,SAAS,iBAAiB;QAExB,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED,SAAS,mBAAmB;QAE1B,iIAAiI;QACjI,UAAU,EAAE,CAAC;QAEb,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE5B,gKAAgK;QAChK,oIAAoI;QACpI,IAAG,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;YAE3F,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,mBAAmB,CAAC,QAAuB,EAAE,YAAoB;QAExE,UAAU,EAAE,CAAC;QAEb,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE5B,MAAM,OAAO,GAAqB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;QAEnG,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpB;;;WAGG;QACH,MAAM,IAAI,GAAG,GAAS,EAAE;YAEtB,IAAG,KAAK,KAAK,OAAO,EAAE,CAAC;gBAErB,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,uBAAuB;QAE9B,IAAG,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAE1B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB;QACtJ,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAY;IAE/B,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/browser/cdp.d.ts

@@ -35,3 +35,4 @@ export declare function resizeAndMinimizeWindow(page: Page): Promise<void>;
  * @param page - The Puppeteer page object.
  */
 export declare function unminimizeWindow(page: Page): Promise<void>;
+//# sourceMappingURL=cdp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../src/browser/cdp.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAuBvD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC/D,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAwCxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAwGvE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhE"}

package/dist/browser/cdp.js

@@ -5,8 +5,8 @@ import { getEffectiveViewport } from "../config/presets.js";
 /* The Chrome DevTools Protocol (CDP) provides low-level access to Chrome's internal state and capabilities. While Puppeteer abstracts most common operations, some
  * features require direct CDP access:
  *
- * - Window management: Setting window size, position, and state (minimized, maximized, fullscreen). Puppeteer's viewport API controls the content area, but we
- *   need CDP to control the entire window including browser chrome.
+ * - Window management: setting window size and normal/minimized state. Puppeteer's viewport API controls the content area, but we need CDP to control the
+ *   entire window including browser chrome.
  *
  * - Browser-level operations: Operations that affect the browser rather than a specific page, like getting the window ID for a page's target.
  *
@@ -107,9 +107,10 @@ export async function resizeAndMinimizeWindow(page) {
         const viewport = getEffectiveViewport(CONFIG);
         const targetHeight = viewport.height + uiSize.height;
         const targetWidth = viewport.width + uiSize.width;
-        // Resize with verification. Each attempt restores the window to "normal" state (idempotent) and sets the target dimensions, then reads back the actual
-        // bounds to confirm. On macOS, NSWindow state transitions are asynchronous - Chrome may acknowledge the "normal" state CDP command before the OS window
-        // manager finishes the transition, causing a subsequent dimension-setting call to be silently ignored. The readback detects this and retries.
+        // Resize with verification. Each attempt restores the window to "normal" state - safe to repeat on every retry attempt - and sets the target dimensions,
+        // then reads back the actual bounds to confirm. On macOS, NSWindow state transitions are asynchronous - Chrome may acknowledge the "normal" state CDP
+        // command before the OS window manager finishes the transition, causing a subsequent dimension-setting call to be silently ignored. The readback detects
+        // this and retries.
         for (let attempt = 0; attempt < 3; attempt++) {
             // Ensure the window is in "normal" state. Setting bounds on a maximized window is ignored, so we must restore it first. On retries, this re-sends the
             // normal state in case the previous transition hadn't completed.

package/dist/browser/cdp.js.map

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