prismcast 1.9.0 → 1.10.0

package/dist/native/intercept.js

@@ -1,181 +0,0 @@
-import { LOG, chromeFetch, startTimer } from "../utils/index.js";
-/* This module installs a Chrome DevTools Protocol (CDP) listener on the Network domain to capture HLS manifest URLs as the browser's video player fetches them. Unlike
- * the per-call CDP sessions created by withCDPSession() in cdp.ts, we create a long-lived session here because the listener must remain active across multiple network
- * requests until channel selection is complete.
- *
- * The listener filters for URLs ending in .m3u8 and fetches the manifest body directly via Node.js to inspect the content. Master manifests contain #EXT-X-STREAM-INF
- * directives (variant playlist references), which distinguishes them from variant/media playlists. We use a direct fetch rather than CDP's Network.getResponseBody
- * because Chrome's network cache can evict response bodies before we read them, causing spurious "No data found for resource" failures.
- *
- * For multi-channel sites, the video player may load manifests for channels other than the one requested. The interceptor tracks both the first and latest master
- * manifest URLs to handle two distinct scenarios:
- *
- * - Direct-navigation sites (Fox Sports): The first manifest is the correct one — the player loaded it for the navigated URL. Background prefetches for other channels
- *   may arrive later but should be ignored. finalize(directTune=true) selects the first manifest.
- *
- * - Guide-based sites (Fox.com, Hulu, Sling, YouTube TV): The player loads a default channel's manifest during page navigation, then the guide grid strategy clicks the
- *   correct entry, triggering a new manifest fetch. finalize(directTune=false) selects the latest manifest.
- */
-// Default timeout for manifest interception after installation.
-const INTERCEPTION_TIMEOUT = 15000;
-// Brief delay after finalize() is called to allow any in-flight manifest response to arrive. Applied only for guide-based tunes (directTune=false) where the
-// channel switch may trigger a manifest fetch that arrives milliseconds after the click handler returns. Direct tunes skip this delay and resolve immediately.
-const FINALIZE_SETTLE_DELAY = 1500;
-/**
- * Installs a CDP Network.responseReceived listener on the given page to capture master HLS manifest URLs. The listener tracks both the first and latest master
- * manifest URLs as they arrive. The returned handle provides a promise that resolves when finalize() is called — the caller invokes finalize() after channel
- * selection is complete, passing directTune to control which manifest is selected.
- *
- * For direct-navigation sites (directTune=true), the first master manifest is the correct one — it was loaded for the navigated URL. Background prefetches for
- * other channels are ignored. For guide-based sites (directTune=false), the latest manifest is selected — it corresponds to the channel the user clicked.
- *
- * @param page - The Puppeteer page to monitor.
- * @param timeout - Maximum time in milliseconds to wait for a manifest (default: 15 seconds). Acts as a safety net if finalize() is never called.
- * @returns The interceptor handle, or null if the CDP session could not be created.
- */
-export async function installManifestInterceptor(page, timeout = INTERCEPTION_TIMEOUT) {
-    if (page.isClosed()) {
-        return null;
-    }
-    const elapsed = startTimer();
-    let cdpSession;
-    try {
-        cdpSession = await page.createCDPSession();
-    }
-    catch (error) {
-        LOG.debug("native:intercept", "Failed to create CDP session: %s.", String(error));
-        return null;
-    }
-    // Enable the Network domain to receive request and response events.
-    try {
-        await cdpSession.send("Network.enable");
-    }
-    catch (error) {
-        LOG.debug("native:intercept", "Failed to enable Network domain: %s.", String(error));
-        return null;
-    }
-    LOG.debug("native:intercept", "CDP manifest interceptor installed.");
-    // Track both the first and most recently observed master manifest URLs. For direct-navigation sites (directTune=true), the first manifest is the correct one — the
-    // player loaded it for the navigated URL. Background prefetches for other channels may arrive later and must not overwrite the selection. For guide-based sites
-    // (directTune=false), the last manifest is correct — the guide click triggers a new manifest fetch that replaces whatever the player initially loaded.
-    let firstManifestUrl = null;
-    let latestManifestUrl = null;
-    let resolved = false;
-    let manifestCount = 0;
-    const { promise, resolve } = Promise.withResolvers();
-    // Listen for completed responses. We use Network.responseReceived to capture .m3u8 URLs, then fetch the manifest body directly from Node.js to verify it is
-    // a master manifest. This avoids CDP's Network.getResponseBody which is unreliable — Chrome's network cache can evict response bodies before we read them.
-    const onResponseReceived = async (params) => {
-        if (resolved) {
-            return;
-        }
-        const url = params.response.url;
-        // Filter for .m3u8 URLs. Strip query parameters before checking the extension.
-        const urlPath = url.split("?")[0];
-        if (!urlPath.endsWith(".m3u8")) {
-            return;
-        }
-        LOG.debug("native:intercept", "Observed .m3u8 response: %s.", url.slice(0, 120));
-        // Fetch the manifest body directly to inspect whether this is a master manifest. The URL contains embedded CDN auth tokens, so no cookies or special
-        // headers are needed beyond the Chrome User-Agent injected by chromeFetch().
-        try {
-            const response = await chromeFetch(url, { signal: AbortSignal.timeout(5000) });
-            if (!response.ok) {
-                LOG.debug("native:intercept", "Manifest fetch returned HTTP %s for %s.", response.status, url.slice(0, 120));
-                return;
-            }
-            const body = await response.text();
-            // Master manifests contain #EXT-X-STREAM-INF directives that reference variant playlists. Media/variant playlists contain #EXTINF or #EXT-X-TARGETDURATION
-            // but not #EXT-X-STREAM-INF.
-            if (body.includes("#EXT-X-STREAM-INF")) {
-                manifestCount++;
-                firstManifestUrl ??= url;
-                latestManifestUrl = url;
-                LOG.debug("native:intercept", "Master manifest captured (#%s) in %sms: %s.", manifestCount, elapsed(), url.slice(0, 120));
-            }
-            else {
-                LOG.debug("native:intercept", "Skipping non-master .m3u8 (no #EXT-X-STREAM-INF).");
-            }
-        }
-        catch (error) {
-            LOG.debug("native:intercept", "Could not fetch .m3u8 body: %s.", String(error));
-        }
-    };
-    // Wrap the async handler to avoid no-misused-promises — EventEmitter.on() does not handle returned promises.
-    const wrappedHandler = (...args) => { void onResponseReceived(...args); };
-    cdpSession.on("Network.responseReceived", wrappedHandler);
-    // Timeout guard. If finalize() is never called (defensive), resolve with whatever we have after the timeout.
-    const timer = setTimeout(() => {
-        if (!resolved) {
-            resolved = true;
-            cdpSession.off("Network.responseReceived", wrappedHandler);
-            if (latestManifestUrl) {
-                LOG.debug("native:intercept", "Manifest interception timed out after %sms. Resolving with latest URL (%s captured).", elapsed(), manifestCount);
-                resolve({ cdpSession, masterManifestUrl: latestManifestUrl });
-            }
-            else {
-                LOG.debug("native:intercept", "Manifest interception timed out after %sms. No master manifest captured.", elapsed());
-                removeManifestInterceptor(cdpSession);
-                resolve(null);
-            }
-        }
-    }, timeout);
-    // Finalize function exposed on the returned handle. Called by the stream setup code after channel selection is complete. The resolution strategy depends on
-    // two factors: whether a manifest has already been captured, and whether the tune is direct or guide-based.
-    //
-    // - Manifest captured + direct tune: resolve immediately (A&E, most TVE sites — manifest arrived during page load).
-    // - Manifest captured + guide tune: wait FINALIZE_SETTLE_DELAY (Fox guide, Hulu — a newer manifest from the channel switch may still arrive).
-    // - No manifest captured + either: wait FINALIZE_SETTLE_DELAY (Fox Sports — manifest fetch starts after video element appears, hasn't arrived yet).
-    const finalize = (directTune) => {
-        if (resolved) {
-            return;
-        }
-        // Helper that resolves the promise with the current state. For direct tunes, the first manifest is the correct one (loaded for the navigated URL — background
-        // prefetches for other channels may have overwritten latestManifestUrl). For guide tunes, the last manifest is correct (from the channel switch click).
-        const resolveNow = () => {
-            if (resolved) {
-                return;
-            }
-            resolved = true;
-            clearTimeout(timer);
-            cdpSession.off("Network.responseReceived", wrappedHandler);
-            const selectedUrl = directTune ? firstManifestUrl : latestManifestUrl;
-            if (selectedUrl) {
-                LOG.debug("native:intercept", "Interception finalized in %sms with %s manifest(s). Using %s: %s.", elapsed(), manifestCount, directTune ? "first" : "latest", selectedUrl.slice(0, 120));
-                resolve({ cdpSession, masterManifestUrl: selectedUrl });
-            }
-            else {
-                LOG.debug("native:intercept", "Interception finalized in %sms but no master manifest was captured.", elapsed());
-                removeManifestInterceptor(cdpSession);
-                resolve(null);
-            }
-        };
-        if (directTune && firstManifestUrl) {
-            // Direct tune with manifest already captured: resolve immediately with zero delay. The first manifest arrived during page load and is the correct one.
-            resolveNow();
-        }
-        else {
-            // Either no manifest captured yet (some services fetch the manifest after the video element appears) or a guide-based tune where the channel switch
-            // may produce a newer manifest. Wait briefly for in-flight responses.
-            setTimeout(resolveNow, FINALIZE_SETTLE_DELAY);
-        }
-    };
-    return { finalize, promise };
-}
-/**
- * Removes the Network domain listener and detaches the CDP session. Safe to call multiple times or on an already-detached session.
- *
- * @param cdpSession - The CDP session to clean up.
- */
-export function removeManifestInterceptor(cdpSession) {
-    try {
-        cdpSession.removeAllListeners("Network.responseReceived");
-        void cdpSession.send("Network.disable").catch(() => { });
-        void cdpSession.detach().catch(() => { });
-    }
-    catch (_error) {
-        // Ignore errors during cleanup — the session may already be detached.
-    }
-    LOG.debug("native:intercept", "CDP manifest interceptor removed.");
-}
-//# sourceMappingURL=intercept.js.map

package/dist/native/intercept.js.map

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