prismcast 1.5.2 → 1.7.0

package/dist/native/probe.js

@@ -0,0 +1,294 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * probe.ts: DRM probe for HLS manifest encryption classification.
+ */
+import { LOG, chromeFetch, startTimer } from "../utils/index.js";
+/* This module fetches an HLS master manifest, selects the highest-bandwidth variant, and inspects its #EXT-X-KEY tags to classify the encryption type. The result
+ * determines whether PrismCast can consume the stream natively (clear or AES-128) or must fall back to screen capture (Widevine, FairPlay, or other DRM).
+ *
+ * Classification logic:
+ * - No #EXT-X-KEY or METHOD=NONE → "clear" (no encryption, direct pass-through)
+ * - METHOD=AES-128 with accessible key URL → "aes128" (Node can decrypt with crypto.createDecipheriv)
+ * - METHOD=SAMPLE-AES, SAMPLE-AES-CTR, or any other method → "drm" (requires CDM, not viable)
+ */
+// Timeout for individual manifest/key fetches.
+const FETCH_TIMEOUT = 10000;
+// Cache of encryption types keyed by channel name. Stores the classification (clear/aes128/drm) with a timestamp for TTL expiration. Variant URLs and key URLs
+// contain session-bound auth tokens that expire between tunes, so they must never be cached — only the stable encryption type is safe to persist across sessions.
+// The DRM skip optimization in setup.ts uses this cache to avoid installing the CDP interceptor for channels known to use DRM.
+const probeCache = new Map();
+// Cache entries older than this are considered stale and re-probed. 24 hours covers the case where a provider changes a channel's encryption profile (e.g., free →
+// premium DRM). The DRM short-circuit in probeManifest() still applies within the TTL, so frequently-tuned DRM channels avoid repeated probe overhead.
+const PROBE_CACHE_TTL = 24 * 60 * 60 * 1000;
+/**
+ * Returns the cached encryption type for a channel, or null if the channel has not been probed or the cache entry has expired. Used by the stream setup path to skip
+ * CDP interceptor installation for channels already known to use DRM.
+ *
+ * @param channelName - The channel name to look up.
+ * @returns The cached encryption type, or null if not probed or expired.
+ */
+export function getCachedEncryption(channelName) {
+    const entry = probeCache.get(channelName);
+    if (!entry) {
+        return null;
+    }
+    if ((Date.now() - entry.timestamp) > PROBE_CACHE_TTL) {
+        probeCache.delete(channelName);
+        return null;
+    }
+    return entry.encryption;
+}
+/**
+ * Clears the probe cache for a specific channel. Called when a native stream fails, forcing a fresh probe on the next attempt.
+ *
+ * @param channelName - The channel name to clear from the cache.
+ */
+export function clearProbeCache(channelName) {
+    probeCache.delete(channelName);
+}
+/**
+ * Probes an HLS master manifest to determine encryption type and select the best variant. The probe cache is checked for DRM channels only — if a previous probe
+ * classified the channel as DRM, we return the cached result immediately since the caller will bail out regardless of URLs. For viable channels (clear or aes128),
+ * we always run the full probe because the variant URL and key URL contain auth tokens that expire between browser sessions.
+ *
+ * @param masterUrl - The master manifest URL (contains auth tokens from the browser's original request).
+ * @param channelName - The channel name for cache lookup.
+ * @returns The probe result, or null if probing fails.
+ */
+export async function probeManifest(masterUrl, channelName) {
+    // Short-circuit for DRM channels only. The cached DRM classification is stable within the TTL window (providers rarely change DRM type), and the caller returns
+    // null immediately on DRM without using any URLs. For clear/aes128 channels, we must re-probe to get fresh variant and key URLs with current auth tokens.
+    const cached = getCachedEncryption(channelName);
+    if (cached === "drm") {
+        LOG.debug("native:probe", "Probe cache hit for %s: drm.", channelName);
+        return { audioVariantUrl: null, bandwidth: 0, bestVariantUrl: "", codec: null, encryption: "drm", keyUrl: null, resolution: null };
+    }
+    const elapsed = startTimer();
+    try {
+        // Fetch the master manifest.
+        const masterBody = await fetchManifestText(masterUrl);
+        if (!masterBody) {
+            LOG.debug("native:probe", "Failed to fetch master manifest for %s.", channelName);
+            return null;
+        }
+        // Parse variant streams and select the highest bandwidth.
+        const bestVariant = selectBestVariant(masterBody, masterUrl);
+        if (!bestVariant) {
+            LOG.debug("native:probe", "No variant streams found in master manifest for %s.", channelName);
+            return null;
+        }
+        LOG.debug("native:probe", "Best variant selected for %s: %s.", channelName, bestVariant.url.slice(0, 120));
+        // Check for a separate audio rendition in the master manifest.
+        const audioVariantUrl = parseAudioRendition(masterBody, masterUrl);
+        if (audioVariantUrl) {
+            LOG.debug("native:probe", "Separate audio rendition found for %s: %s.", channelName, audioVariantUrl.slice(0, 120));
+        }
+        // Fetch the variant manifest.
+        const variantBody = await fetchManifestText(bestVariant.url);
+        if (!variantBody) {
+            LOG.debug("native:probe", "Failed to fetch variant manifest for %s.", channelName);
+            return null;
+        }
+        // Classify encryption.
+        const result = await classifyEncryption(variantBody, bestVariant, audioVariantUrl, channelName);
+        probeCache.set(channelName, { encryption: result.encryption, timestamp: Date.now() });
+        LOG.debug("native:probe", "Probe completed for %s in %sms: %s.", channelName, elapsed(), result.encryption);
+        return result;
+    }
+    catch (error) {
+        LOG.debug("native:probe", "Probe failed for %s: %s.", channelName, String(error));
+        return null;
+    }
+}
+/**
+ * Fetches a manifest URL and returns the response text. Returns null on failure.
+ *
+ * @param url - The manifest URL to fetch.
+ * @returns The response text, or null on failure.
+ */
+async function fetchManifestText(url) {
+    try {
+        const response = await chromeFetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
+        if (!response.ok) {
+            LOG.debug("native:probe", "Manifest fetch returned HTTP %s.", response.status);
+            return null;
+        }
+        return await response.text();
+    }
+    catch (error) {
+        LOG.debug("native:probe", "Manifest fetch error: %s.", String(error));
+        return null;
+    }
+}
+/**
+ * Parses #EXT-X-STREAM-INF lines from a master manifest and returns the highest-bandwidth variant with its metadata.
+ *
+ * @param masterBody - The master manifest content.
+ * @param masterUrl - The master manifest URL for resolving relative variant URLs.
+ * @returns The selected variant metadata, or null if no variants are found.
+ */
+function selectBestVariant(masterBody, masterUrl) {
+    // Map video codec prefixes from CODECS attribute to human-readable labels. Defined outside the variant iteration loop to avoid per-line allocation.
+    const codecPrefixes = { "av01": "AV1", "avc1": "H264", "avc3": "H264", "hev1": "HEVC", "hvc1": "HEVC", "vp09": "VP9" };
+    const lines = masterBody.split("\n");
+    let bestBandwidth = 0;
+    let bestCodec = null;
+    let bestResolution = null;
+    let bestUrl = null;
+    const bandwidths = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line.startsWith("#EXT-X-STREAM-INF:")) {
+            continue;
+        }
+        // Parse BANDWIDTH attribute.
+        const bandwidthMatch = /BANDWIDTH=(\d+)/.exec(line);
+        const bandwidth = bandwidthMatch ? Number(bandwidthMatch[1]) : 0;
+        // Parse RESOLUTION attribute (e.g., RESOLUTION=1920x1080).
+        const resolutionMatch = /RESOLUTION=(\d+x\d+)/.exec(line);
+        const resolution = resolutionMatch ? resolutionMatch[1] : null;
+        // Parse CODECS attribute and map the video codec prefix to a human-readable label. The CODECS value contains comma-separated codec strings (e.g.,
+        // "avc1.640028,mp4a.40.2"). The video codec is identified by its prefix: avc1/avc3 → H264, hvc1/hev1 → HEVC, av01 → AV1, vp09 → VP9.
+        const codecsMatch = /CODECS="([^"]+)"/.exec(line);
+        let codec = null;
+        if (codecsMatch) {
+            const codecStr = codecsMatch[1].split(",")[0].trim();
+            const prefix = codecStr.split(".")[0];
+            codec = codecPrefixes[prefix] ?? null;
+        }
+        // The variant URL is on the next line.
+        const variantLine = (i + 1 < lines.length) ? lines[i + 1].trim() : "";
+        if (!variantLine || variantLine.startsWith("#")) {
+            continue;
+        }
+        bandwidths.push(bandwidth);
+        if (bandwidth > bestBandwidth) {
+            bestBandwidth = bandwidth;
+            bestCodec = codec;
+            bestResolution = resolution;
+            bestUrl = variantLine;
+        }
+    }
+    LOG.debug("native:probe", "Found %s variant(s) with bandwidths: %s.", bandwidths.length, bandwidths.join(", "));
+    if (!bestUrl) {
+        return null;
+    }
+    // Resolve relative URLs against the master manifest URL.
+    return { bandwidth: bestBandwidth, codec: bestCodec, resolution: bestResolution, url: resolveUrl(bestUrl, masterUrl) };
+}
+/**
+ * Classifies the encryption type of a variant manifest by parsing its #EXT-X-KEY tags.
+ *
+ * @param variantBody - The variant manifest content.
+ * @param variant - The selected variant metadata (URL, bandwidth, resolution).
+ * @param audioVariantUrl - The audio rendition URL, or null when audio is muxed.
+ * @param channelName - The channel name for logging.
+ * @returns The probe result with the classified encryption type.
+ */
+async function classifyEncryption(variantBody, variant, audioVariantUrl, channelName) {
+    const lines = variantBody.split("\n");
+    let encryption = "clear";
+    let keyUrl = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("#EXT-X-KEY:")) {
+            continue;
+        }
+        // Parse METHOD attribute.
+        const methodMatch = /METHOD=([A-Za-z0-9-]+)/.exec(trimmed);
+        const method = methodMatch ? methodMatch[1].toUpperCase() : "NONE";
+        if (method === "NONE") {
+            continue;
+        }
+        if (method === "AES-128") {
+            // Parse URI attribute for the key URL.
+            const uriMatch = /URI="([^"]+)"/.exec(trimmed);
+            if (!uriMatch) {
+                LOG.debug("native:probe", "AES-128 key tag has no URI for %s.", channelName);
+                encryption = "drm";
+                break;
+            }
+            const rawKeyUrl = resolveUrl(uriMatch[1], variant.url);
+            // Test that the key is accessible and is exactly 16 bytes.
+            // eslint-disable-next-line no-await-in-loop
+            const keyAccessible = await testKeyAccessibility(rawKeyUrl);
+            if (keyAccessible) {
+                encryption = "aes128";
+                keyUrl = rawKeyUrl;
+            }
+            else {
+                LOG.debug("native:probe", "AES-128 key inaccessible or wrong size for %s.", channelName);
+                encryption = "drm";
+            }
+            break;
+        }
+        // SAMPLE-AES, SAMPLE-AES-CTR, or any other method indicates DRM.
+        LOG.debug("native:probe", "Unsupported encryption method '%s' for %s.", method, channelName);
+        encryption = "drm";
+        break;
+    }
+    return { audioVariantUrl, bandwidth: variant.bandwidth, bestVariantUrl: variant.url, codec: variant.codec, encryption, keyUrl, resolution: variant.resolution };
+}
+/**
+ * Tests whether an AES-128 key URL is accessible and returns a 16-byte key.
+ *
+ * @param keyUrl - The key URL to test.
+ * @returns True if the key is accessible and exactly 16 bytes.
+ */
+async function testKeyAccessibility(keyUrl) {
+    try {
+        const response = await chromeFetch(keyUrl, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
+        if (!response.ok) {
+            return false;
+        }
+        const buffer = await response.arrayBuffer();
+        LOG.debug("native:probe", "Key fetch returned %s bytes.", buffer.byteLength);
+        return buffer.byteLength === 16;
+    }
+    catch (error) {
+        LOG.debug("native:probe", "Key accessibility test failed: %s.", String(error));
+        return false;
+    }
+}
+/**
+ * Parses the first #EXT-X-MEDIA:TYPE=AUDIO rendition with a URI from a master manifest. Returns the absolute audio variant URL, or null if no separate audio
+ * rendition is declared (audio is muxed into the video variant).
+ *
+ * @param masterBody - The master manifest content.
+ * @param masterUrl - The master manifest URL for resolving relative URIs.
+ * @returns The absolute audio variant URL, or null.
+ */
+function parseAudioRendition(masterBody, masterUrl) {
+    for (const line of masterBody.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("#EXT-X-MEDIA:")) {
+            continue;
+        }
+        // Only match AUDIO renditions.
+        if (!trimmed.includes("TYPE=AUDIO")) {
+            continue;
+        }
+        // Extract the URI attribute. Not all #EXT-X-MEDIA:TYPE=AUDIO tags have a URI — some are descriptive-only when audio is muxed into the video variant.
+        const uriMatch = /URI="([^"]+)"/.exec(trimmed);
+        if (uriMatch) {
+            return resolveUrl(uriMatch[1], masterUrl);
+        }
+    }
+    return null;
+}
+/**
+ * Resolves a potentially relative URL against a base URL. Handles both absolute and relative URLs. Exported for reuse by the proxy module.
+ *
+ * @param url - The URL to resolve (may be relative or absolute).
+ * @param baseUrl - The base URL for resolving relative references.
+ * @returns The resolved absolute URL.
+ */
+export function resolveUrl(url, baseUrl) {
+    // If the URL is already absolute, return it directly.
+    if (url.startsWith("http://") || url.startsWith("https://")) {
+        return url;
+    }
+    // Use the URL constructor to resolve relative URLs against the base.
+    return new URL(url, baseUrl).href;
+}
+//# sourceMappingURL=probe.js.map

package/dist/native/probe.js.map

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

package/dist/native/proxy.d.ts

@@ -0,0 +1,54 @@
+import { type PrerollCodec } from "../streaming/preroll.js";
+import type { CDPSession } from "puppeteer-core";
+import type { Nullable } from "../types/index.js";
+/**
+ * Options for creating a native HLS proxy.
+ */
+export interface NativeProxyOptions {
+    audioVariantUrl: Nullable<string>;
+    cdpSession: CDPSession;
+    channelName: string;
+    encryption: "aes128" | "clear";
+    keyUrl: Nullable<string>;
+    onError: (error: string) => void;
+    prefetchedKey: Nullable<Buffer>;
+    prerollCodec?: PrerollCodec;
+    prerollSegmentCount?: number;
+    streamId: number;
+    streamIdStr: string;
+    variantUrl: string;
+}
+/**
+ * Public interface returned by createNativeProxy(). Provides start/stop control and health metrics.
+ */
+export interface NativeProxy {
+    getConsecutiveErrors: () => number;
+    hasErrored: () => boolean;
+    getLastSegmentSize: () => Nullable<number>;
+    getLastSegmentTime: () => number;
+    getSegmentIndex: () => number;
+    getStats: () => NativeProxyStats;
+    getTargetDuration: () => number;
+    start: () => void;
+    isStopped: () => boolean;
+    setTokenRefreshTimer: (timer: ReturnType<typeof setTimeout>) => void;
+    stop: () => void;
+    updateAudioVariantUrl: (newUrl: string) => void;
+    updateCdpSession: (session: CDPSession) => void;
+    updateVariantUrl: (newUrl: string) => void;
+}
+/**
+ * Statistics tracked by the native proxy for the termination summary.
+ */
+export interface NativeProxyStats {
+    fetchErrors: number;
+    segmentsFetched: number;
+    tokenRefreshes: number;
+}
+/**
+ * Creates a native HLS proxy that polls a variant manifest, fetches segments, and generates playlists.
+ *
+ * @param options - Proxy configuration.
+ * @returns The native proxy interface.
+ */
+export declare function createNativeProxy(options: NativeProxyOptions): NativeProxy;