prismcast 1.12.0 → 1.13.0

package/dist/browser/browserSupervisor.js

@@ -1,4 +1,5 @@
 import { canAttemptLaunch, createLaunchGovernorState, noteLaunchFailure, noteLaunchSuccess, noteReadinessLost, noteSustainedHealth } from "./launchGovernor.js";
+import { assertNever } from "../utils/index.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).
@@ -22,6 +23,18 @@ export class BrowserSupersededError extends Error {
         this.name = "BrowserSupersededError";
     }
 }
+/**
+ * Thrown by acquire() for a capture purpose on a browser that can no longer start captures. The caller maps it to the same 503 back-off class as
+ * BrowserUnavailableError, and it carries no retry horizon because the relaunch that cures it waits on the browser's own streams draining rather than on a clock.
+ */
+export class BrowserCaptureImpairedError extends Error {
+    impairment;
+    constructor(impairment) {
+        super("The browser can no longer start captures and is waiting to relaunch.");
+        this.impairment = impairment;
+        this.name = "BrowserCaptureImpairedError";
+    }
+}
 /**
  * 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.
@@ -78,7 +91,7 @@ export function createBrowserSupervisor(ports) {
             throw new BrowserSupersededError();
         }
         noteLaunchSuccess(governor, ports.now());
-        transition({ browser, kind: "ready", launchTime: ports.now() });
+        transition({ browser, impairment: null, 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
@@ -92,9 +105,14 @@ export function createBrowserSupervisor(ports) {
         transition({ kind, promise });
         return promise;
     }
-    async function acquire() {
+    async function acquire(purpose) {
         switch (state.kind) {
             case "ready": {
+                // A marked browser still opens pages, so only a capture purpose is refused. Refusing here rather than launching is what keeps a second Chrome away from the
+                // profile lock this instance still holds while it serves the captures it started; the relaunch is the adapter's to schedule once nothing depends on it.
+                if ((purpose === "capture") && state.impairment) {
+                    throw new BrowserCaptureImpairedError(state.impairment);
+                }
                 return state.browser;
             }
             // Join the launch already in flight rather than starting a second one - the single-flight guarantee.
@@ -127,6 +145,23 @@ export function createBrowserSupervisor(ports) {
             }
         }
     }
+    function captureImpairment() {
+        return (state.kind === "ready") ? state.impairment : null;
+    }
+    /* Records the capture impairment against the published ready browser, and reports whether this call is the one that recorded it.
+     *
+     * The identity guard is what makes a verdict safe to act on late: the caller confirmed a specific instance, and a disconnect plus relaunch during that
+     * confirmation can have replaced it, so a mark aimed at a superseded instance is dropped rather than applied to the healthy browser that took its place. The
+     * first mark wins for a reason of its own - the adapter's alarm and its status emit both belong to this transition, so a second verdict against the same
+     * instance must not fire either of them again.
+     */
+    function handleCaptureImpaired(browser, reason) {
+        if ((state.kind !== "ready") || (state.browser !== browser) || (state.impairment !== null)) {
+            return false;
+        }
+        transition({ ...state, impairment: { reason, since: ports.now() } });
+        return true;
+    }
     function current() {
         return (state.kind === "ready") ? state.browser : null;
     }
@@ -172,15 +207,7 @@ export function createBrowserSupervisor(ports) {
         }
         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));
+    return { acquire, captureImpairment, current, currentLaunchTime, inspect: () => state, noteCaptureImpaired: handleCaptureImpaired,
+        noteReadinessLost: handleReadinessLost, noteSustainedHealth: noteSustainedHealthTick, noteTeardownBegun: handleTeardownBegun };
 }
 //# sourceMappingURL=browserSupervisor.js.map

package/dist/browser/browserSupervisor.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserSupervisor.js","sourceRoot":"","sources":["../../src/browser/browserSupervisor.ts"],"names":[],"mappings":"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"}
+{"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;AAGhK,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgHhD;;;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;;;GAGG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAEpC,UAAU,CAAoB;IAE9C,YAAY,UAA6B;QAEvC,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAE9E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,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,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAElF,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,CAAC,OAAuB;QAE5C,QAAO,KAAK,CAAC,IAAI,EAAE,CAAC;YAElB,KAAK,OAAO,CAAC,CAAC,CAAC;gBAEb,4JAA4J;gBAC5J,wJAAwJ;gBACxJ,IAAG,CAAC,OAAO,KAAK,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBAE/C,MAAM,IAAI,2BAA2B,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC1D,CAAC;gBAED,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,iBAAiB;QAExB,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,SAAS,qBAAqB,CAAC,OAAgB,EAAE,MAAc;QAE7D,IAAG,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,EAAE,CAAC;YAE1F,OAAO,KAAK,CAAC;QACf,CAAC;QAED,UAAU,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAErE,OAAO,IAAI,CAAC;IACd,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,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,qBAAqB;QAC/H,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;AACnI,CAAC"}

package/dist/browser/cdp.d.ts

@@ -1,4 +1,8 @@
 import type { CDPSession, Page } from "puppeteer-core";
+import type { Clock } from "homebridge-plugin-utils";
+import type { Nullable } from "../types/index.ts";
+export declare const WINDOW_STATE_POLL_MS = 25;
+export declare const WINDOW_RESTORE_CEILING_MS = 2000;
 /**
  * Executes a CDP (Chrome DevTools Protocol) operation with proper session lifecycle management. This helper handles the common pattern of:
  * 1. Creating a CDP session attached to the page's target
@@ -13,16 +17,64 @@ import type { CDPSession, Page } from "puppeteer-core";
  * @returns The result of the operation, or undefined if the page was closed or an error occurred.
  */
 export declare function withCDPSession<T>(page: Page, operation: (session: CDPSession, windowId: number) => Promise<T>): Promise<T | undefined>;
+export interface WindowPlacement {
+    readonly height: number;
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+    readonly windowState: string;
+}
 /**
- * Minimizes the browser window to reduce GPU usage and keep the desktop clear. Minimizing does not interrupt capture: the capture extension reads the compositor's
- * surface rather than the visible display, and that surface is the page's emulated viewport, which the window's presentation state does not touch.
+ * Reads the window state Chrome reports for the window a page belongs to. Resolves null whenever the state cannot be read at all - a closed page, a target that
+ * yields no window ID, or a CDP failure withCDPSession absorbs - so a caller logging this as a diagnostic never has to tell a missing session apart from a
+ * missing report.
+ * @param page - The Puppeteer page whose window is read.
+ * @returns The window state Chrome reports, or null when it cannot be read.
+ */
+export declare function readWindowState(page: Page): Promise<Nullable<string>>;
+/**
+ * Reads the full placement - frame and state - of the window a page belongs to, for a caller that means to put a second window in the same spot. Resolves null
+ * whenever the placement cannot be read completely: a closed page, a target that yields no window ID, a CDP failure withCDPSession absorbs, or a response
+ * missing any one of the four numbers or the state. That strictness lives here rather than in the shared read, because a partial frame is useless to the one
+ * consumer this exists for while a partial response is still a perfectly good state report.
+ *
+ * Mirroring the shared window's own placement is what keeps a second window from disturbing the profile: Chrome persists the window placement it will relaunch
+ * at from the last window whose bounds changed, within seconds and regardless of which window the user is working in, and any exit that does not flush that
+ * preference - a crash, a forced kill, and the relaunch that follows a crash - carries those bounds into the next launch. A window opened anywhere else writes
+ * its own frame there and the shared window comes back at it (measured 2026-08-31).
+ * @param page - The Puppeteer page whose window is read.
+ * @returns The window's placement, or null when it cannot be read completely.
+ */
+export declare function readWindowPlacement(page: Page): Promise<Nullable<WindowPlacement>>;
+/**
+ * Minimizes the browser window, which keeps the desktop clear and the GPU idle while nothing is capturing. Only the window-visibility executor should call this:
+ * the window has to stay on screen for as long as any capture stream is reading the compositor, and that decision belongs to decideWindowVisibility in
+ * windowSync.ts.
  * @param page - The Puppeteer page object.
  */
 export declare function minimizeWindow(page: Page): Promise<void>;
 /**
- * Un-minimizes the browser window, restoring it to normal state. This is used when the user needs to interact with the browser, such as during the authentication
- * login flow where the user must complete TV provider authentication in the visible browser window.
+ * Un-minimizes the browser window, restoring it to normal state. The window belongs on screen while a capture stream is reading the compositor's output for it, and
+ * while a user is completing TV provider authentication in it. The capability probe calls this directly to make its environment representative of the one capture
+ * runs in; every other caller goes through the window-visibility executor, which owns the policy.
+ *
+ * The contract is a confirmed state, not a fired command: this resolves once Chrome reports the window restored, or once the ceiling lapses with a warning and the
+ * window left in whatever state it does report. On macOS a restore runs asynchronously against the acknowledgement of the command that asked for it, and a capture
+ * requested against a window still mid-restore is the shape of the 2026-08-26 through 08-28 capture-start failures. A window already on screen confirms on its
+ * first read, so the confirmation costs one round trip on the common path.
  * @param page - The Puppeteer page object.
+ * @param clock - Clock driving the confirmation cadence and its elapsed measurement. Defaults to the system clock; tests inject a virtual clock.
+ */
+export declare function unminimizeWindow(page: Page, clock?: Clock): Promise<void>;
+/**
+ * Re-issues a capture page's own declared device metrics. Chrome composes the capture of a selected tab from the window's fitted presentation rather than from the
+ * emulated surface, and the override event is what re-selects the composition target: a capture composing the window's view of the page returns to the full
+ * emulated surface, and a capture already composing that surface is left exactly as it was. Callable at any time, from anywhere, at any frequency, because the
+ * values sent are the ones Puppeteer has already declared on this page - nothing about the page's emulation changes.
+ *
+ * The command is issued raw rather than through page.setViewport, which drops an override whose values match the standing one. It is the event, not a change of
+ * values, that does the work here.
+ * @param page - The page to re-affirm. A page carrying no explicitly declared density is left alone.
+ * @throws Whatever the CDP send rejects with. Each trigger site decides whether that matters to it.
  */
-export declare function unminimizeWindow(page: Page): Promise<void>;
-//# sourceMappingURL=cdp.d.ts.map
+export declare function reaffirmCaptureSurface(page: Page): Promise<void>;

package/dist/browser/cdp.js

@@ -1,10 +1,15 @@
-import { LOG, delay, formatError } from "../utils/index.js";
+import { LOG, delay, formatError, pollUntil } from "../utils/index.js";
+import { systemClock } from "homebridge-plugin-utils";
 /* 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 presentation: moving the shared browser window between its normal and minimized states. That state is the only window property this application
- *   drives. The surface a page renders at belongs to Puppeteer's viewport, which emulates the configured quality preset on every page independently of how large
- *   the OS window is, so window bounds carry no capture meaning...minimizing is about desktop clutter and GPU cost alone.
+ * - Window presentation: moving the shared browser window between its normal and minimized states, and reading the state Chrome reports for it. That state is the
+ *   only window property this application drives, and it is not cosmetic: Chrome's tab capture consumes the compositor's output for the shared window, and a
+ *   minimized window's output is not composed for capture to read. Which state the window should be in is decided in one place, by decideWindowVisibility in
+ *   windowSync.ts; these primitives only carry it out and report back what Chrome says came of it.
+ *
+ * - Capture surface re-affirmation: re-issuing a capture page's own declared device metrics, which is what moves that capture's composition target back to the
+ *   emulated surface.
  *
  * - Browser-level operations: Operations that affect the browser rather than a specific page, like getting the window ID for a page's target.
  *
@@ -15,6 +20,13 @@ import { LOG, delay, formatError } from "../utils/index.js";
  *
  * The withCDPSession helper encapsulates the common pattern of creating a session, getting the window ID, performing an operation, and handling errors.
  */
+// The wait between one read of the window's state and the next while a restore is in flight. This is a cadence rather than a settle - nothing is being given time
+// to happen, Chrome is simply being asked again - and the measured macOS restore completes in roughly a quarter second, so a genuine restore costs about ten reads
+// and a window already on screen costs exactly one.
+export const WINDOW_STATE_POLL_MS = 25;
+// The bound on how long a restore may take to report itself complete. Eight times the measured restore, so a lapse is a genuine fault worth a warning rather than
+// a slow-but-healthy transition. Lapsing never blocks the caller: capture proceeds against whatever state Chrome reports.
+export const WINDOW_RESTORE_CEILING_MS = 2000;
 /**
  * Executes a CDP (Chrome DevTools Protocol) operation with proper session lifecycle management. This helper handles the common pattern of:
  * 1. Creating a CDP session attached to the page's target
@@ -59,8 +71,72 @@ export async function withCDPSession(page, operation) {
     }
 }
 /**
- * Minimizes the browser window to reduce GPU usage and keep the desktop clear. Minimizing does not interrupt capture: the capture extension reads the compositor's
- * surface rather than the visible display, and that surface is the page's emulated viewport, which the window's presentation state does not touch.
+ * Reads the bounds Chrome reports for a window, through a session that is already open. Private to this module and the one place the frame is read: the state
+ * derivation below, the restore confirmation, and the page-level placement read all take their answer from this single call, so no other site composes the
+ * request. A response carrying no bounds reads as null rather than throwing, because an absent report is an answer every derivation already branches on. The
+ * frame comes back for a minimized window too - Chrome reports the frame it is resting at, which is exactly what a window created beside it needs.
+ * @param session - An open CDP session attached to the page's target.
+ * @param windowId - The browser window ID that session resolved.
+ * @returns The bounds Chrome reports, with every field as optional as Chrome leaves it, or null when the response carries none.
+ */
+async function readWindowBoundsWith(session, windowId) {
+    const response = await session.send("Browser.getWindowBounds", { windowId });
+    return response?.bounds ?? null;
+}
+/**
+ * Reads the window state Chrome reports for a window, through a session that is already open. Private to this module: the restore confirmation below and the
+ * page-level readWindowState both ask Chrome through the shared read above, so no other site composes the request. A response carrying no bounds, or bounds
+ * carrying no state, reads as null rather than throwing, because an absent report is an answer its callers already branch on.
+ * @param session - An open CDP session attached to the page's target.
+ * @param windowId - The browser window ID that session resolved.
+ * @returns The window state Chrome reports, or null when the response carries none.
+ */
+async function readWindowStateWith(session, windowId) {
+    return (await readWindowBoundsWith(session, windowId))?.windowState ?? null;
+}
+/**
+ * Reads the window state Chrome reports for the window a page belongs to. Resolves null whenever the state cannot be read at all - a closed page, a target that
+ * yields no window ID, or a CDP failure withCDPSession absorbs - so a caller logging this as a diagnostic never has to tell a missing session apart from a
+ * missing report.
+ * @param page - The Puppeteer page whose window is read.
+ * @returns The window state Chrome reports, or null when it cannot be read.
+ */
+export async function readWindowState(page) {
+    return (await withCDPSession(page, readWindowStateWith)) ?? null;
+}
+/**
+ * Reads the full placement - frame and state - of the window a page belongs to, for a caller that means to put a second window in the same spot. Resolves null
+ * whenever the placement cannot be read completely: a closed page, a target that yields no window ID, a CDP failure withCDPSession absorbs, or a response
+ * missing any one of the four numbers or the state. That strictness lives here rather than in the shared read, because a partial frame is useless to the one
+ * consumer this exists for while a partial response is still a perfectly good state report.
+ *
+ * Mirroring the shared window's own placement is what keeps a second window from disturbing the profile: Chrome persists the window placement it will relaunch
+ * at from the last window whose bounds changed, within seconds and regardless of which window the user is working in, and any exit that does not flush that
+ * preference - a crash, a forced kill, and the relaunch that follows a crash - carries those bounds into the next launch. A window opened anywhere else writes
+ * its own frame there and the shared window comes back at it (measured 2026-08-31).
+ * @param page - The Puppeteer page whose window is read.
+ * @returns The window's placement, or null when it cannot be read completely.
+ */
+export async function readWindowPlacement(page) {
+    return (await withCDPSession(page, async (session, windowId) => {
+        const bounds = await readWindowBoundsWith(session, windowId);
+        if (!bounds) {
+            return null;
+        }
+        const { height, left, top, width, windowState } = bounds;
+        // Each field's presence is a type test rather than a truthiness test: a window flush against the top or the left edge of the screen reports that
+        // coordinate as 0, which a truthiness test would discard as a missing placement.
+        if ((typeof height !== "number") || (typeof left !== "number") || (typeof top !== "number") || (typeof width !== "number") ||
+            (typeof windowState !== "string")) {
+            return null;
+        }
+        return { height, left, top, width, windowState };
+    })) ?? null;
+}
+/**
+ * Minimizes the browser window, which keeps the desktop clear and the GPU idle while nothing is capturing. Only the window-visibility executor should call this:
+ * the window has to stay on screen for as long as any capture stream is reading the compositor, and that decision belongs to decideWindowVisibility in
+ * windowSync.ts.
  * @param page - The Puppeteer page object.
  */
 export async function minimizeWindow(page) {
@@ -81,11 +157,18 @@ export async function minimizeWindow(page) {
     });
 }
 /**
- * Un-minimizes the browser window, restoring it to normal state. This is used when the user needs to interact with the browser, such as during the authentication
- * login flow where the user must complete TV provider authentication in the visible browser window.
+ * Un-minimizes the browser window, restoring it to normal state. The window belongs on screen while a capture stream is reading the compositor's output for it, and
+ * while a user is completing TV provider authentication in it. The capability probe calls this directly to make its environment representative of the one capture
+ * runs in; every other caller goes through the window-visibility executor, which owns the policy.
+ *
+ * The contract is a confirmed state, not a fired command: this resolves once Chrome reports the window restored, or once the ceiling lapses with a warning and the
+ * window left in whatever state it does report. On macOS a restore runs asynchronously against the acknowledgement of the command that asked for it, and a capture
+ * requested against a window still mid-restore is the shape of the 2026-08-26 through 08-28 capture-start failures. A window already on screen confirms on its
+ * first read, so the confirmation costs one round trip on the common path.
  * @param page - The Puppeteer page object.
+ * @param clock - Clock driving the confirmation cadence and its elapsed measurement. Defaults to the system clock; tests inject a virtual clock.
  */
-export async function unminimizeWindow(page) {
+export async function unminimizeWindow(page, clock = systemClock) {
     // Early exit if the page is already closed.
     if (page.isClosed()) {
         return;
@@ -96,6 +179,61 @@ export async function unminimizeWindow(page) {
             bounds: { windowState: "normal" },
             windowId
         });
+        // Confirm the restore against Chrome's own report rather than against the acknowledgement above, which arrives while the window manager is still working.
+        const startedAt = clock.now();
+        const outcome = await pollUntil({ cadenceMs: WINDOW_STATE_POLL_MS, ceilingMs: WINDOW_RESTORE_CEILING_MS, clock,
+            read: () => readWindowStateWith(session, windowId), until: (state) => state === "normal" });
+        if (outcome.status === "lapsed") {
+            /* A lapse is reported and then stepped past. The window's presentation is the caller's precondition, not its permission: blocking capture on a window that
+             * will not report itself restored would convert a presentation fault into a stream failure, which is strictly worse than capturing against a window whose
+             * state we have named in the log.
+             */
+            LOG.warn("The browser window did not report a completed restore within %dms; continuing with the window in its reported state.", WINDOW_RESTORE_CEILING_MS, { windowState: outcome.value });
+        }
+        else {
+            LOG.debug("browser:lifecycle", "The window reported its restore complete after %dms (%d reads).", clock.now() - startedAt, outcome.reads);
+        }
     });
 }
+/**
+ * Re-issues a capture page's own declared device metrics. Chrome composes the capture of a selected tab from the window's fitted presentation rather than from the
+ * emulated surface, and the override event is what re-selects the composition target: a capture composing the window's view of the page returns to the full
+ * emulated surface, and a capture already composing that surface is left exactly as it was. Callable at any time, from anywhere, at any frequency, because the
+ * values sent are the ones Puppeteer has already declared on this page - nothing about the page's emulation changes.
+ *
+ * The command is issued raw rather than through page.setViewport, which drops an override whose values match the standing one. It is the event, not a change of
+ * values, that does the work here.
+ * @param page - The page to re-affirm. A page carrying no explicitly declared density is left alone.
+ * @throws Whatever the CDP send rejects with. Each trigger site decides whether that matters to it.
+ */
+export async function reaffirmCaptureSurface(page) {
+    /* An explicitly declared, positive density is precisely the mark of a capture page, which is what makes this function safe to fire at any page from any trigger.
+     * A page PrismCast has not emulated carries no viewport at all and falls out on the first test; a page emulated for layout declares the display's own density
+     * through Chrome's disable value of 0, which the positive test excludes. The narrowing runs in two steps because the send forwards the page's own dimensions as
+     * well: the record is nullable, and its density is optional where CDP's field is required.
+     */
+    const viewport = page.viewport();
+    if (!viewport) {
+        return;
+    }
+    const deviceScaleFactor = viewport.deviceScaleFactor;
+    if ((typeof deviceScaleFactor !== "number") || !(deviceScaleFactor > 0)) {
+        return;
+    }
+    const session = await page.createCDPSession();
+    try {
+        await session.send("Emulation.setDeviceMetricsOverride", { deviceScaleFactor, height: viewport.height, mobile: false, width: viewport.width });
+    }
+    finally {
+        /* The detach carries a catch of its own. A page that dies mid-send takes its session with it, and a throw raised out of this finally would replace the send's
+         * rejection with a detach failure the caller can do nothing about - the send's own reason has to reach the caller unaltered.
+         */
+        try {
+            await session.detach();
+        }
+        catch {
+            // The session is already gone, which is the state the detach was asking for.
+        }
+    }
+}
 //# sourceMappingURL=cdp.js.map

package/dist/browser/cdp.js.map

@@ -1 +1 @@
-{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../src/browser/cdp.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAU,EACV,SAAgE;IAGhE,oHAAoH;IACpH,IAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAEnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QAEH,sJAAsJ;QACtJ,0EAA0E;QAC1E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9C,2JAA2J;QAC3J,sGAAsG;QACtG,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAA0B,CAAC;QAC/F,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;QAEvC,2IAA2I;QAC3I,IAAG,CAAC,QAAQ,EAAE,CAAC;YAEb,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,iEAAiE;QACjE,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAM,KAAK,EAAE,CAAC;QAEd,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAEnC,oJAAoJ;QACpJ,+IAA+I;QAC/I,IAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAEpE,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAE7C,4CAA4C;IAC5C,IAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAEnB,OAAO;IACT,CAAC;IAED,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAErD;;;WAGG;QACH,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAE5C,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE;YACpC,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAU;IAE/C,4CAA4C;IAC5C,IAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAEnB,OAAO;IACT,CAAC;IAED,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAErD,gDAAgD;QAChD,MAAM,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAE5C,MAAM,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE;YACjC,QAAQ;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../src/browser/cdp.ts"],"names":[],"mappings":"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"}

package/dist/browser/channelSelection.d.ts

@@ -1,4 +1,5 @@
-import type { ChannelSelectorResult, Nullable, ProviderModule, ResolvedSiteProfile } from "../types/index.ts";
+import type { ChannelSelectorResult, Nullable, ProviderModule, ResolvedSiteProfile, StrategyNavigator } from "../types/index.ts";
+import type { Clock } from "homebridge-plugin-utils";
 import type { Page } from "puppeteer-core";
 /**
  * Returns a direct watch URL for the channel specified in the profile, if one can be resolved. Looks up the strategy entry's resolveDirectUrl hook and calls it
@@ -32,8 +33,8 @@ export declare function resolveDirectUrl(profile: ResolvedSiteProfile, page: Pag
  */
 export declare function invalidateDirectUrl(profile: ResolvedSiteProfile, cause: unknown): boolean;
 /**
- * Clears all channel selection caches. Called by relinquishBrowserReadiness() in browser/index.ts (shared by the disconnect handler and invalidateBrowser)
- * whenever the browser is torn down, since cached state (guide row positions, discovered page URLs, watch URLs) may be stale in a new browser session.
+ * Clears all channel selection caches. Called by browser/index.ts wherever a browser session ends - the disconnect handler's readiness relinquish and the restart
+ * routine's relaunch - since cached state (guide row positions, discovered page URLs, watch URLs) may be stale in a new browser session.
  */
 export declare function clearChannelSelectionCaches(): void;
 /**
@@ -50,6 +51,13 @@ export declare function getProviderBySlug(slug: string): ProviderModule | undefi
  * @returns The matching provider module or undefined.
  */
 export declare function getProviderByStrategy(strategyName: string): ProviderModule | undefined;
+/**
+ * Returns the strategy's own navigator for the given profile, when its provider declares one. The navigation and reload functions in video.ts read this ahead of
+ * every document load, so a provider that owns its route into its site is honored on every path without the callers knowing which provider it is.
+ * @param profile - The resolved site profile.
+ * @returns The navigator, or undefined when the strategy loads its pages by URL.
+ */
+export declare function getStrategyNavigator(profile: ResolvedSiteProfile): StrategyNavigator | undefined;
 /**
  * Returns all registered provider module slugs. Used for validation in the checkboxList setting for precache providers.
  * @returns Array of provider slugs.
@@ -110,6 +118,11 @@ export { logAvailableChannels, normalizeChannelName, resolveMatchSelector, scrol
  * Options that callers may supply to selectChannel(). All fields are optional; selectChannel() may be called with no options.
  */
 export interface SelectChannelOptions {
+    /**
+     * The clock the pre-selection scroll poll's cadence and ceiling read. Defaults to the system clock, so a caller that holds no clock passes nothing. The tune
+     * orchestrator threads its own clock here, while the provider strategies behind the shared strategy types keep running on the poll policy's default.
+     */
+    readonly clock?: Clock;
     /**
      * Callback invoked when the resolution layer converts a category selector to a concrete per-user channel identifier. The framework calls this with the resolved
      * call sign so the caller can persist the value to the user's channel store. After persistence, subsequent tunes start with the concrete selector and skip the
@@ -122,7 +135,7 @@ export interface SelectChannelOptions {
      * Null/undefined means "do not persist." The resolution still happens and the resolved selector is used for this tune; it just isn't saved. Useful for ad-hoc
      * tunes (no associated channel record) and for testing.
      */
-    persistResolution?: (resolvedSelector: string) => Promise<void>;
+    readonly persistResolution?: (resolvedSelector: string) => Promise<void>;
 }
 /**
  * Selects a channel from a multi-channel player UI using the strategy specified in the profile. This is the main entry point for channel selection, called by
@@ -140,8 +153,7 @@ export interface SelectChannelOptions {
  * - Strategy dispatch based on profile.channelSelection.strategy.
  * @param page - The Puppeteer page object.
  * @param profile - The resolved site profile containing channelSelection config and channelSelector slug.
- * @param options - Optional callbacks for the resolution layer. Currently the only field is persistResolution.
+ * @param options - The clock the scroll poll runs on and the resolution layer's persistence callback. See SelectChannelOptions.
  * @returns Result object with success status and optional failure reason.
  */
 export declare function selectChannel(page: Page, profile: ResolvedSiteProfile, options?: SelectChannelOptions): Promise<ChannelSelectorResult>;
-//# sourceMappingURL=channelSelection.d.ts.map