prismcast 1.10.2 → 1.11.0

package/dist/browser/consent.js

@@ -0,0 +1,418 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * consent.ts: Automatic consent-overlay and interstitial handling for externally navigated pages in PrismCast.
+ */
+import { LOG, delay, realClock } from "../utils/index.js";
+import { CONFIG } from "../config/index.js";
+/* This module is the single source of truth for getting consent overlays and interstitials out of the way on any page PrismCast navigates on the viewer's behalf -
+ * a tune's channel-selection walk and video wait, a discovery or precache walk, a static capture. Each distinct overlay class is handled with its own correct
+ * action, because "consent overlay" is not one homogeneous pattern:
+ *
+ * 1. Cookie-consent CMP banners (Didomi, OneTrust, ...). These are vendor-standardized: every site using a given vendor renders the same markup, so a small,
+ *    vendor-keyed registry (CMP_REGISTRY) - not a per-site whitelist - covers thousands of sites with a handful of entries. The correct action is to REJECT, which
+ *    dismisses the banner and is the privacy-protective choice. Adding a vendor is one entry.
+ *
+ * 2. Embedded-player consent gates. These are the GDPR "2-click embed" / content-blocker pattern: the site refuses to create the third-party player iframe (and
+ *    send the viewer to the embed provider) until the viewer consents, painting its own placeholder overlay in the meantime. The markup is SITE-BESPOKE (france24's
+ *    `.o-em-consent`, another site's different class), so there is no global selector - we detect it by SHAPE (a player-blocking overlay whose text matches the
+ *    2-click-embed phrasing AND which carries an accept affordance). The correct action is to ACCEPT, since the gated content cannot play otherwise. Because the
+ *    real player iframe is only created after consent is granted, acceptance is paired with a single page reload by the caller so the player resolves on the second
+ *    pass (consent persists in the Chrome profile, exactly like a TV-provider login).
+ *
+ * 3. Per-site intermittent modals (the existing `dismissSelector` mechanism - Paramount+ "Watch Live", c-span, cbs). These are arbitrary, site-specific modals, so
+ *    they remain per-site configuration rather than a global pattern. They are folded into this one poll so a single mechanism - and a single auto-dismiss logging
+ *    convention - owns all "click an overlay out of the way" behavior.
+ *
+ * Which of the permitted actions a given poll may take, and how long it may run, is not a call-site decision: it is declared by an OverlayPhase and read from the
+ * PHASE_POLICY table below. The video wait is the only phase that composes with an embed-gate accept - accepting a gate is a page-mutating, reload-triggering action
+ * whose only safe home is the caller that owns the reload - so every other phase forbids the accept and never runs the acting gate probe. This keeps the
+ * privacy-sensitive auto-accept structurally confined to the one place that can follow through on it, while cookie rejection and per-site modal dismissal run on every
+ * navigated surface. Detection stays specific by design: the embed-gate heuristic only fires when its 2-click-embed phrasing matches AND no video is already buffered
+ * enough to play (readyState >= HAVE_FUTURE_DATA), so a normal navigation (where nothing blocks the page) never triggers an accept. Where the heuristic cannot resolve
+ * a blocking overlay, the caller falls back to detect-and-guide: it surfaces an actionable message telling the viewer to dismiss the prompt once in setup/login mode,
+ * instead of a cryptic timeout.
+ */
+// Interval in milliseconds between overlay-handling poll checks. This cadence is responsive enough to catch a late-rendering overlay while keeping each tick cheap.
+const OVERLAY_POLL_INTERVAL = 500;
+// Settle delay in milliseconds after scrolling an element into view, before dispatching a coordinate click. Mirrors the shared scrollAndClick helper's settle so
+// lazy-loaded content and scroll animations finish before the pointer-event chain is dispatched. Named here (matching OVERLAY_POLL_INTERVAL's convention) rather than
+// repeated as a bare literal across every coordinate-click site in this module.
+const SCROLL_SETTLE_DELAY = 200;
+// Source for the accept-affordance match - the visible text or aria-label of a button that grants consent. Kept narrow (no "watch"/"play"/"continue") so a generic
+// media-play or navigation button is never mistaken for a consent accept; the embed-gate container phrasing below is the second, decisive guard. Passed to the
+// browser context as a string because a RegExp cannot cross the page.evaluate boundary. Exported so scanForEmbedGate and its DOM-fixture tests consume one definition
+// of the pattern rather than duplicating it.
+export const ACCEPT_AFFORDANCE_SOURCE = "\\b(accept|agree|allow|enable|consent|got it|i understand|load)\\b";
+// Source for the embedded-player consent-gate phrasing - the "2-click embed" / content-blocker wording a site uses when it withholds a third-party player until the
+// viewer enables tracking. This is the decisive specificity guard: a button is only treated as an embed-gate accept when an ancestor container carries this phrasing.
+// It is deliberately limited to tracking / external-content wording and does NOT include generic "to view this content" phrasing, because that is also how age gates,
+// paywalls, and TV-provider sign-in walls read - and those must never be auto-accepted. Anything outside this narrow shape degrades to detect-and-guide. Exported so
+// scanForEmbedGate and its DOM-fixture tests consume one definition of the pattern rather than duplicating it.
+export const EMBED_GATE_SOURCE = "(enable .{0,40}(tracking|cookies)|advertisement tracking|audience measurement|" +
+    "(load|show|display|view|enable) (external|third.?party) content)";
+// Source for the anti-pattern exclusion - phrasing that marks an overlay as a sign-in, subscription, age, or paywall gate rather than a privacy-consent gate. A
+// candidate is skipped when its label or container text matches this, so even a wall that also happens to mention tracking is never auto-accepted; it routes to
+// detect-and-guide instead. Auto-accepting tracking is the privacy-sensitive action, so it is only ever performed on an unambiguous consent overlay. Exported so
+// scanForEmbedGate and its DOM-fixture tests consume one definition of the pattern rather than duplicating it.
+export const EXCLUDE_SOURCE = "\\b(sign[ -]?in|log[ -]?in|subscribe|subscription|paywall|provider|account|18\\+|adults?|age[ -]?gate|years? old|" +
+    "must be (18|over|of)|create an? (free )?account)\\b";
+// Selectors whose configured dismissSelector value proved to be an invalid CSS selector, tracked process-wide so the warning about a malformed selector is emitted
+// exactly once per selector no matter how many poll instances encounter it. The per-poll dismiss state gates the action; this set gates the log.
+const warnedInvalidSelectors = new Set();
+/**
+ * The per-phase overlay policy. This is the single source of truth for which overlay actions each phase permits AND how long that phase's poll may run. A phase
+ * forbids the embed-gate accept unless its reload semantics can follow through on it, so only the video wait sets embedGate true.
+ */
+const PHASE_POLICY = {
+    // A discovery or precache walk. Navigation plus a cold-cache guide walk can span far longer than a single page load, so the 60-second window is generous; the
+    // helper aborts the poll on walk completion, so the window is the backstop, not the terminator. No embed-gate accept: discovery has no reload to pair with one.
+    discovery: { cmpReject: true, dismissSelector: true, embedGate: false, window: 60000 },
+    // The reload the video wait performs after accepting an embed gate. Cookie rejection and per-site modal dismissal stay live on the reloaded page, but the gate
+    // probe is structurally off: a second acceptance would re-detect unrelated consent overlays elsewhere on the page (carousel tiles on a site like france24), scroll
+    // one into view, and yank the main player offscreen. The window tracks the video-wait window (byte-parity with the post-gate second wait).
+    postGateReload: { cmpReject: true, dismissSelector: true, embedGate: false, window: "videoTimeout" },
+    // A static-page capture. The captured pixels ARE the content, so a dismissal click lands in the capture by design. This phase has no abort owner, so the bounded
+    // 30-second load window - long enough for banners to render - is what stops the poll. No embed-gate accept: a static capture never reloads.
+    staticCapture: { cmpReject: true, dismissSelector: true, embedGate: false, window: 30000 },
+    // A tune's channel-selection walk and click-to-play, before the video wait. The caller aborts this poll at the phase boundary, so the 45-second window is only the
+    // backstop. It is a deliberately independent consent-layer value, NOT coupled to setup.ts's playback-initialization race - the two may legitimately diverge, the
+    // abort is the terminator and the window the backstop. No embed-gate accept: the walk phase has no reload to pair with one.
+    tuneSetup: { cmpReject: true, dismissSelector: true, embedGate: false, window: 45000 },
+    // The tune's wait for the player to become ready. The only phase whose reload semantics compose with an embed-gate accept, so the only phase that runs the acting
+    // gate probe. The window derives from the profile's videoTimeout at poll start so a late-rendering gate is still caught; the caller's abort stops it the instant
+    // the wait settles.
+    videoWait: { cmpReject: true, dismissSelector: true, embedGate: true, window: "videoTimeout" }
+};
+/* Compile-time pin: the video wait is the only phase whose policy may accept an embed gate. If a policy edit ever flips a second phase's embedGate to true,
+ * EmbedGatePhase widens past "videoWait", the conditional below collapses to `never`, and the assignment of `true` fails to compile - a build error rather than a
+ * silent widening of the privacy-sensitive auto-accept surface. The binding is read once at module scope purely so the pin is live code, not a dead type alias.
+ */
+const embedGatePhaseIsVideoWaitOnly = true;
+void embedGatePhaseIsVideoWaitOnly;
+/**
+ * Vendor-keyed registry of known cookie-consent CMPs. This is NOT a per-site whitelist - each entry covers every site that embeds the vendor. Seeded with Didomi,
+ * whose reject selector was verified live (france24); additional vendors (OneTrust, Cookiebot, ...) are added here as their reject selectors are verified. Exported so
+ * the DOM-fixture tests build a banner fixture from the same detect and reject selectors the poll uses, rather than duplicating the vendor's markers into the test.
+ */
+export const CMP_REGISTRY = [
+    { detect: ".didomi-popup-notice, #didomi-host", reject: "#didomi-notice-disagree-button", vendor: "Didomi" }
+];
+/**
+ * Emits the unified auto-dismiss log line. Every path that automatically acts on an overlay - CMP reject, embed-gate accept, per-site modal dismiss, and the Comcast
+ * "Watch Now" modal - routes through here so the behavior is reported consistently at INFO with the same voice, plus a verbose DEBUG companion under the
+ * browser:consent category. This is the single source of truth for "we interacted with an on-page prompt on the viewer's behalf" reporting.
+ * @param kind - Which overlay class was handled.
+ * @param detail - Identifying detail for the overlay (vendor, selector, or label).
+ */
+export function logAutoDismiss(kind, detail = {}) {
+    switch (kind) {
+        case "cookie-consent": {
+            LOG.info("Automatically rejected the %s cookie-consent prompt.", detail.vendor ?? "site");
+            break;
+        }
+        case "embed-gate": {
+            LOG.info("Automatically accepted an embedded-player consent prompt so the video could load.");
+            break;
+        }
+        case "modal": {
+            LOG.info("Automatically dismissed an interstitial modal.");
+            break;
+        }
+    }
+    LOG.debug("browser:consent", "Auto-dismiss detail: kind=%s, vendor=%s, selector=%s, label=%s.", kind, detail.vendor ?? "-", detail.selector ?? "-", detail.label ?? "-");
+}
+/**
+ * In-page coordinate resolver for a selector-identified element. Returns the viewport-center coordinates of the element after scrolling it into view, or null when the
+ * element is absent or has zero layout size (display:none, an unlaid-out node) and therefore cannot be coordinate-clicked. This is the read half of
+ * clickSelectorByCoordinate: it resolves where to click, and the Node-side caller dispatches the real pointer-event chain at those coordinates.
+ *
+ * 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,
+ * with every input a parameter and zero outer-scope references - a captured variable would be undefined once the function is stringified into the page. Exported so
+ * unit tests can run it against a synthetic DOM.
+ * @param sel - The CSS selector for the element to locate.
+ * @returns The element's post-scroll viewport-center coordinates, or null when it is absent or has zero layout size.
+ */
+export function locateSelectorCoordinate(sel) {
+    const el = document.querySelector(sel);
+    if (!el) {
+        return null;
+    }
+    const rect = el.getBoundingClientRect();
+    // A present-but-unlaid-out element (display:none, zero size) cannot be coordinate-clicked; skip it and let the caller poll again.
+    if ((rect.width === 0) || (rect.height === 0)) {
+        return null;
+    }
+    el.scrollIntoView({ block: "center" });
+    const scrolled = el.getBoundingClientRect();
+    return { x: scrolled.x + (scrolled.width / 2), y: scrolled.y + (scrolled.height / 2) };
+}
+/**
+ * Clicks an element identified by a CSS selector using a real coordinate mouse click, if the element is present and laid out. Coordinate clicking generates the
+ * full pointer event chain, which consent buttons in SPA frameworks require to register (a synthetic element.click() is silently dropped by some, as observed on
+ * the embed-gate accept button). Returns false when the element is absent or has zero layout size, so callers can keep polling.
+ * @param page - The Puppeteer page.
+ * @param selector - The CSS selector for the element to click.
+ * @returns True if the element was found and clicked.
+ */
+async function clickSelectorByCoordinate(page, selector) {
+    const target = await page.evaluate(locateSelectorCoordinate, selector);
+    if (!target) {
+        return false;
+    }
+    // Brief settle delay after scrolling, mirroring the shared scrollAndClick helper, before dispatching the real pointer-event chain. This paces real page physics
+    // inside an action and is exercised only when a click actually dispatches, so it stays on delay() rather than the injected poll clock.
+    await delay(SCROLL_SETTLE_DELAY);
+    await page.mouse.click(target.x, target.y);
+    return true;
+}
+/**
+ * In-page synthetic click for a selector-identified element. Guards its querySelector so a malformed selector is reported as "invalid-selector" rather than throwing
+ * and killing the poll tick. Reports "clicked" when the element is found and clicked, and "absent" when a valid selector matches nothing this tick.
+ *
+ * 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,
+ * with every input a parameter and zero outer-scope references - a captured variable would be undefined once the function is stringified into the page. Exported so
+ * unit tests can run it against a synthetic DOM.
+ * @param sel - The CSS selector for the element to dismiss.
+ * @returns "clicked" when the element was found and clicked, "absent" when the valid selector matched nothing, "invalid-selector" when the selector is malformed.
+ */
+export function clickSelectorInPage(sel) {
+    let el;
+    try {
+        el = document.querySelector(sel);
+    }
+    catch {
+        // querySelector throws a SyntaxError on a malformed selector. Report it so the caller disables just this action rather than stopping the whole poll.
+        return "invalid-selector";
+    }
+    if (el) {
+        el.click();
+        return "clicked";
+    }
+    return "absent";
+}
+/**
+ * Attempts to dismiss the profile's per-site modal with a synthetic in-page click. The per-site dismissSelector modals (Paramount+ "Watch Live", c-span, cbs) are
+ * reliably dismissed by synthetic clicks, so coordinate clicking is reserved for the consent paths that require it. The in-page function guards its querySelector so
+ * a malformed selector is reported as "invalid-selector" rather than throwing and killing the tick.
+ * @param page - The Puppeteer page.
+ * @param selector - The CSS selector for the modal element to dismiss.
+ * @returns "clicked" when the element was found and clicked, "absent" when the valid selector matched nothing, "invalid-selector" when the selector is malformed.
+ */
+async function clickSelectorSynthetic(page, selector) {
+    return page.evaluate(clickSelectorInPage, selector);
+}
+/**
+ * In-page embed-gate scanner. Recognizes an embedded-player consent gate by shape: a button, a button-role element, or an anchor whose label matches the accept
+ * affordance AND whose ancestor container (within a bounded depth) carries the 2-click-embed phrasing, excluding sign-in/paywall/age walls. Early-outs to null when a
+ * video is already buffered for playback, so it never fires on a page that is succeeding without an overlay. The act flag splits detection from action: act false
+ * reports presence and label only, touching nothing; act true scrolls the matched control into view and returns its viewport-center coordinates for a real click.
+ *
+ * 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,
+ * with every input a parameter - the accept, exclude, and gate regex SOURCES (a RegExp cannot cross the boundary, so they arrive as strings and are compiled here)
+ * and the act flag - and zero outer-scope references, since a captured variable would be undefined once the function is stringified into the page. Exported so unit
+ * tests can run it against a synthetic DOM.
+ * @param args - The accept-affordance, exclude, and embed-gate phrasing regex sources, plus the act flag.
+ * @returns The gate's label (and, on the acting path, its post-scroll center coordinates), or null when no gate is detected.
+ */
+export function scanForEmbedGate(args) {
+    // If a video element is already buffered for playback, the page is not blocked by a consent gate; do not act.
+    const existing = document.querySelector("video");
+    if (existing && (existing.readyState >= 3)) {
+        return null;
+    }
+    const acceptRe = new RegExp(args.accept, "i");
+    const excludeRe = new RegExp(args.exclude, "i");
+    const gateRe = new RegExp(args.gate, "i");
+    const candidates = Array.from(document.querySelectorAll("button, [role=\"button\"], a"));
+    for (const candidate of candidates) {
+        const label = (candidate.textContent + " " + (candidate.getAttribute("aria-label") ?? "")).trim();
+        if (!acceptRe.test(label)) {
+            continue;
+        }
+        // Walk up a bounded number of ancestors looking for the container that carries the 2-click-embed phrasing. The bound is deep enough to reach the typical
+        // wrapper nesting seen on embed-gate sites (verified against france24's markup), shallow enough to avoid matching the whole document body, which would
+        // defeat the specificity guard.
+        let node = candidate.parentElement;
+        let containerText = "";
+        for (let depth = 0; node && (depth < 6); depth++) {
+            if (gateRe.test(node.textContent)) {
+                containerText = node.textContent;
+                break;
+            }
+            node = node.parentElement;
+        }
+        if (!containerText) {
+            continue;
+        }
+        // Skip sign-in, subscription, age, and paywall walls even when they happen to mention tracking. Auto-accepting tracking is the privacy-sensitive action and is
+        // only ever performed on an unambiguous consent overlay; an ambiguous wall routes to detect-and-guide instead.
+        if (excludeRe.test(label) || excludeRe.test(containerText)) {
+            continue;
+        }
+        const rect = candidate.getBoundingClientRect();
+        if ((rect.width === 0) || (rect.height === 0)) {
+            continue;
+        }
+        // Read-only probe: report presence and label without touching the page. The acting path scrolls the control into view and returns post-scroll coordinates.
+        if (!args.act) {
+            return { label: label.slice(0, 80) };
+        }
+        candidate.scrollIntoView({ block: "center" });
+        const scrolled = candidate.getBoundingClientRect();
+        return { label: label.slice(0, 80), x: scrolled.x + (scrolled.width / 2), y: scrolled.y + (scrolled.height / 2) };
+    }
+    return null;
+}
+async function locateEmbedGate(page, act) {
+    return page.evaluate(scanForEmbedGate, { accept: ACCEPT_AFFORDANCE_SOURCE, act, exclude: EXCLUDE_SOURCE, gate: EMBED_GATE_SOURCE });
+}
+/**
+ * Reports whether a consent or cookie prompt is currently present on the page. Used on the failure path to decide whether to replace a cryptic video-selector
+ * timeout with actionable detect-and-guide messaging. A prompt is "present" when a known CMP banner is detected or an embedded-player consent gate is located. The
+ * gate probe runs in read-only mode, so this detection never scrolls or clicks the page it is classifying.
+ * @param page - The Puppeteer page.
+ * @returns True if a consent overlay is present.
+ */
+export async function consentOverlayPresent(page) {
+    try {
+        const cmpPresent = await page.evaluate((selectors) => {
+            return selectors.some((sel) => document.querySelector(sel) !== null);
+        }, CMP_REGISTRY.map((vendor) => vendor.detect));
+        if (cmpPresent) {
+            return true;
+        }
+        return (await locateEmbedGate(page, false)) !== null;
+    }
+    catch {
+        // The page navigated or closed while probing; treat as no detectable overlay.
+        return false;
+    }
+}
+/**
+ * Runs a single overlay-handling poll tick, taking exactly the actions the acting phase's policy permits: reject any known CMP cookie banner, accept an embedded-
+ * player consent gate (terminal, videoWait only), then dismiss a per-site modal. Ordering matters - the embed gate often only becomes interactable after the cookie
+ * banner above it is dismissed, so the CMP reject runs first each tick. The signal is checked between action groups so an in-flight tick cannot keep acting after the
+ * caller has handed the page to the next phase.
+ * @param page - The Puppeteer page.
+ * @param profile - The resolved site profile (supplies the optional per-site dismissSelector).
+ * @param options - The acting phase's policy, the abort signal, and the mutable per-poll state. See OverlayTickOptions.
+ * @returns The tick outcome - "gate" when an embed gate was accepted, "stop" when the poll should end, otherwise "continue".
+ */
+async function runOverlayTick(page, profile, options) {
+    const { policy, signal, state } = options;
+    try {
+        // Reject any known cookie-consent banner, when the phase permits it. Each vendor is acted on at most once.
+        if (policy.cmpReject) {
+            for (const vendor of CMP_REGISTRY) {
+                if (state.handledVendors.has(vendor.vendor)) {
+                    continue;
+                }
+                // eslint-disable-next-line no-await-in-loop
+                const rejected = await clickSelectorByCoordinate(page, vendor.reject);
+                if (rejected) {
+                    state.handledVendors.add(vendor.vendor);
+                    logAutoDismiss("cookie-consent", { selector: vendor.reject, vendor: vendor.vendor });
+                }
+            }
+        }
+        // Stop acting the instant the caller aborts, so an outgoing poll's in-flight tick cannot double-act against the next phase's poll.
+        if (signal?.aborted) {
+            return "stop";
+        }
+        // Accept an embedded-player consent gate, when the phase permits it. This is terminal: the player iframe is only created after consent, so the caller must reload
+        // to resolve the video. Only the video wait reaches here - every other phase's policy forbids the accept, so the acting gate probe never runs for them.
+        if (policy.embedGate) {
+            const gate = await locateEmbedGate(page, true);
+            if (gate) {
+                // The settle after locateEmbedGate's scroll paces real page physics inside an action, exercised only when an accept actually dispatches - so it stays on
+                // delay() rather than the injected poll clock, exactly like the coordinate-click settle.
+                await delay(SCROLL_SETTLE_DELAY);
+                await page.mouse.click(gate.x, gate.y);
+                logAutoDismiss("embed-gate", { label: gate.label });
+                return "gate";
+            }
+        }
+        if (signal?.aborted) {
+            return "stop";
+        }
+        // Dismiss the profile's per-site intermittent modal, if configured, armed, and permitted, using a synthetic click. A malformed selector disables just this
+        // action for the rest of the poll (and warns once per selector per process); an absent element keeps the action armed for a later tick.
+        if (policy.dismissSelector && profile.dismissSelector && (state.dismissSelector === "armed")) {
+            const result = await clickSelectorSynthetic(page, profile.dismissSelector);
+            switch (result) {
+                case "absent": {
+                    break;
+                }
+                case "clicked": {
+                    state.dismissSelector = "done";
+                    logAutoDismiss("modal", { selector: profile.dismissSelector });
+                    break;
+                }
+                case "invalid-selector": {
+                    state.dismissSelector = "disabled";
+                    if (!warnedInvalidSelectors.has(profile.dismissSelector)) {
+                        warnedInvalidSelectors.add(profile.dismissSelector);
+                        LOG.warn("The configured dismiss selector is not a valid CSS selector and will be ignored.", { selector: profile.dismissSelector });
+                    }
+                    break;
+                }
+            }
+        }
+        return "continue";
+    }
+    catch {
+        // Tick-error taxonomy: a closed page or a disconnected browser is terminal, so the poll stops. Any other rejection - most commonly a destroyed execution context
+        // from an in-walk navigation, which is transient - lets the poll survive and try again on the next tick.
+        return (page.isClosed() || !page.browser().connected) ? "stop" : "continue";
+    }
+}
+/**
+ * Launches the fire-and-forget overlay-handling poll for one phase of a page's lifecycle. Runs concurrently with whatever the phase covers, never blocks it, and
+ * never throws - it is the single mechanism that rejects known cookie banners, accepts embedded-player consent gates (video wait only), and dismisses per-site
+ * modals on any externally navigated page. The phase declares which of those actions are safe and how long the poll may run; the caller's abort signal stops it as
+ * soon as its phase settles.
+ *
+ * When an embedded-player consent gate is accepted (only reachable in the videoWait phase), onEmbedGateAccepted() is invoked and the poll stops, because the gate's
+ * acceptance only takes effect on a fresh load - the caller abandons the in-flight wait and reloads.
+ * @param page - The Puppeteer page.
+ * @param profile - The resolved site profile.
+ * @param options - The phase, an optional clock and abort signal, and (videoWait only) the embed-gate callback. See StartOverlayHandlingOptions.
+ */
+export async function startOverlayHandling(page, profile, options) {
+    const { clock = realClock, phase, signal } = options;
+    // Capture the gate callback once, while the union is narrowed: only the videoWait arm carries it. Every other phase forbids the accept, so the tick never returns
+    // "gate" for them and this stays undefined.
+    const onGate = (options.phase === "videoWait") ? options.onEmbedGateAccepted : undefined;
+    const policy = PHASE_POLICY[phase];
+    const state = { dismissSelector: "armed", handledVendors: new Set() };
+    // Resolve the poll window from the phase's policy: a fixed millisecond budget, or the profile-derived video-wait window for the phases whose timing tracks the
+    // wait. One time origin end to end (clock.now() for both the deadline and the loop condition), because realClock.now() is performance.now()-based - a half-migration
+    // that mixed it with Date.now() would invert the loop condition and zero-tick every poll.
+    const windowMs = (policy.window === "videoTimeout") ? (profile.videoTimeout ?? CONFIG.streaming.videoTimeout) : policy.window;
+    const deadline = clock.now() + windowMs;
+    let firstCheck = true;
+    while (clock.now() < deadline) {
+        if (signal?.aborted) {
+            return;
+        }
+        // The first check is immediate; subsequent checks are spaced by the poll interval.
+        if (!firstCheck) {
+            // eslint-disable-next-line no-await-in-loop
+            await clock.sleep(OVERLAY_POLL_INTERVAL);
+            if (signal?.aborted) {
+                return;
+            }
+        }
+        firstCheck = false;
+        // eslint-disable-next-line no-await-in-loop
+        const result = await runOverlayTick(page, profile, { policy, signal, state });
+        if (result === "gate") {
+            onGate?.();
+            return;
+        }
+        if (result === "stop") {
+            return;
+        }
+    }
+}
+//# sourceMappingURL=consent.js.map

package/dist/browser/consent.js.map

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

package/dist/browser/display.d.ts

@@ -47,3 +47,4 @@ export declare function setGpuCapabilities(capabilities: GpuCapabilities): void;
  * @returns The GPU capabilities, or null before detection.
  */
 export declare function getGpuCapabilities(): Nullable<GpuCapabilities>;
+//# sourceMappingURL=display.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/browser/display.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAiBlD;;GAEG;AACH,MAAM,WAAW,eAAe;IAG9B,mBAAmB,EAAE,OAAO,CAAC;IAG7B,oBAAoB,EAAE,OAAO,CAAC;IAG9B,oBAAoB,EAAE,OAAO,CAAC;IAG9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG3E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAGrF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAG9E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,CAGtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,eAAe,CAAC,CAG9D"}

package/dist/browser/hlsPlaylistObserver.d.ts

@@ -0,0 +1,55 @@
+import type { Nullable } from "../types/index.ts";
+import type { Page } from "puppeteer-core";
+/**
+ * A recognized HLS playlist observed by the tab, delivered as a discriminated union on kind so master-only and media-only facts each live on the arm that owns
+ * them. Every arm carries the URL the player loaded and the wire-arrival sequence; the master arm adds its declared child playlist URLs, the media arm its
+ * liveness. Unknown bodies (no `#EXT-X-STREAM-INF` and no `#EXTINF`/`#EXT-X-TARGETDURATION`) are never delivered.
+ */
+export type ObservedHlsPlaylist = ObservedHlsMasterPlaylist | ObservedHlsMediaPlaylist;
+/**
+ * The master (multivariant) arm of ObservedHlsPlaylist, delivered for a body carrying `#EXT-X-STREAM-INF`.
+ */
+export interface ObservedHlsMasterPlaylist {
+    readonly childUrls: readonly string[];
+    readonly kind: "master";
+    readonly sequence: number;
+    readonly url: string;
+}
+/**
+ * The media (segment) arm of ObservedHlsPlaylist, delivered for a body carrying `#EXTINF` / `#EXT-X-TARGETDURATION`.
+ */
+export interface ObservedHlsMediaPlaylist {
+    readonly kind: "media";
+    readonly live: boolean;
+    readonly sequence: number;
+    readonly url: string;
+}
+/**
+ * Options accepted by observeHlsPlaylists(). The callback fires once per unique HLS playlist URL observed during the observer's lifetime.
+ */
+export interface HlsPlaylistObserverOptions {
+    readonly logCategory: string;
+    readonly onPlaylist: (playlist: ObservedHlsPlaylist) => void;
+}
+/**
+ * Handle returned by observeHlsPlaylists(). Implements both the project's dispose() convention and TC39 Symbol.dispose so callers may use either an explicit
+ * dispose() call or the "using" keyword. Disposal is safe to call more than once and tears down the underlying tab network observer.
+ */
+export interface HlsPlaylistObserver extends Disposable {
+    readonly currentSequence: () => number;
+    readonly dispose: () => void;
+    readonly [Symbol.dispose]: () => void;
+}
+/**
+ * Installs an HLS playlist observer on the given page. The callback fires once per unique recognized HLS playlist URL observed across the tab's entire target
+ * tree (top frame, iframes including OOPIFs, workers, service workers). The OOPIF-aware transport is provided by tabNetworkObserver underneath; this observer
+ * adds the HLS-specific filter, body fetch, classification dispatch, and per-URL dedup.
+ *
+ * Returns null when the underlying tab network observer could not be installed (page closed, root CDP session creation failed).
+ *
+ * @param page - The puppeteer page to observe.
+ * @param options - Observer options including the playlist callback and the debug log category.
+ * @returns The observer handle, or null if installation failed.
+ */
+export declare function observeHlsPlaylists(page: Page, options: HlsPlaylistObserverOptions): Promise<Nullable<HlsPlaylistObserver>>;
+//# sourceMappingURL=hlsPlaylistObserver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hlsPlaylistObserver.d.ts","sourceRoot":"","sources":["../../src/browser/hlsPlaylistObserver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AA8B3C;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,GAAG,wBAAwB,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IAGxC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAGtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAGxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IAGvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAGvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAGvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAIzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAG7B,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC9D;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IAIrD,QAAQ,CAAC,eAAe,EAAE,MAAM,MAAM,CAAC;IAGvC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAG7B,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAgIjI"}