prismcast 1.9.0 → 1.10.0

package/dist/upgrade/detection.js

@@ -1,75 +1,162 @@
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { isRunningInContainer } from "../utils/platform.js";
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * detection.ts: Installation method detection for PrismCast upgrade.
+ *
+ * The architecture is ports-and-adapters with a strategy registry whose entries are the single source of truth for everything PrismCast knows about its
+ * installation methods - including the InstallMethod type, which is derived from the registry rather than declared in parallel with it.
+ *
+ *   - DetectionContext (this file) - the runtime-input port; what every strategy needs to make its decision
+ *   - ResolvableFields (this file) - the narrow set of InstallInfo fields a strategy's resolver may compute (today: packageDir)
+ *   - InstallStrategy<M> (this file) - a discriminated union over `upgradeable`; non-upgradeable variants carry manualUpgradeMessage
+ *   - INSTALL_STRATEGIES (this file) - the registry; the SSOT for what install methods PrismCast recognizes, in priority order
+ *   - RegisteredMethod, InstallMethod (derived) - the literal-union types produced from the registry; cannot drift from the strategies
+ *   - InstallInfo (this file) - the dispatcher's output; mirrors the strategy union so non-upgradeable infos carry the message
+ *   - detectInstallMethod (this file) - the dispatcher; a fold over the registry that builds the right InstallInfo variant
+ *   - createDefaultDetectionContext (detection.context) - the adapter; the only place that reads import.meta.url, runs subprocesses, or touches the FS
+ *
+ * Adding a new install method is appending one record to INSTALL_STRATEGIES. The InstallMethod type updates automatically. The dispatcher and the adapter never
+ * change. Tests construct DetectionContext literals inline; production calls detectInstallMethod() with no arguments and the default-argument wires through to
+ * createDefaultDetectionContext.
+ *
+ * Why the discriminated union on `upgradeable`. Boolean flags that gate the presence of other fields are a smell - they let callers ask for fields that are not
+ * meaningful in the current state, and they push the responsibility for "is this field present?" onto every consumer's runtime check. Splitting the strategy
+ * (and its corresponding InstallInfo) into upgradeable vs non-upgradeable variants lets TypeScript enforce that manualUpgradeMessage exists exactly when
+ * upgradeable is false. Consumers narrow on `if(!info.upgradeable)` and read the message field with full type safety; the structural impossibility of an
+ * upgradeable strategy carrying manual instructions, or a non-upgradeable one omitting them, is enforced at the type level rather than by convention.
+ */
+import { createDefaultDetectionContext } from "./detection.context.js";
 import path from "node:path";
-import url from "node:url";
-// Docker image name for display in upgrade instructions.
-const DOCKER_IMAGE = "ghcr.io/hjdhjd/prismcast";
+// Path marker that distinguishes Homebrew formula installs from npm-on-Homebrew installs. The npm global directory under Homebrew lives at /opt/homebrew/lib/
+// node_modules/prismcast/ on Apple Silicon, which would otherwise produce a false-positive homebrew match; checking for /Cellar/prismcast/ specifically avoids
+// that.
+const HOMEBREW_MARKER = "/Cellar/prismcast/";
+// Path marker for npm local installs. The package's source files live under <project>/node_modules/prismcast/...; the npm-local resolver extracts the project
+// root by slicing the path before this marker. The npm-global strategy also uses the broader "/node_modules/" substring as a cheap prefilter to skip the
+// subprocess call when the path could not possibly be an npm install.
+const NPM_LOCAL_MARKER = "/node_modules/prismcast/";
+const ANY_NODE_MODULES = "/node_modules/";
 /**
- * Resolves the npm global prefix directory via `npm prefix -g` with a short timeout.
- * @returns The global prefix path, or null if the command fails or npm is not available.
+ * Docker strategy. Matched via the container-environment probe rather than the path - inside a container, path-based detection is irrelevant because the path
+ * looks like any other npm install but the upgrade flow is fundamentally different (recreate the container, not run a package manager). Carries the manual
+ * upgrade message the consumer prints before the indented command.
  */
-function resolveNpmGlobalPrefix() {
-    try {
-        return execSync("npm prefix -g", { encoding: "utf-8", timeout: 5000 }).trim();
-    }
-    catch {
-        return null;
-    }
-}
+const DOCKER_STRATEGY = {
+    displayName: "Docker",
+    id: "docker",
+    manualUpgradeMessage: [
+        "Docker containers cannot be upgraded in-place.",
+        "To upgrade, pull the latest image and recreate the container:"
+    ],
+    matches: (ctx) => ctx.isContainer,
+    upgradeCommand: "docker pull ghcr.io/hjdhjd/prismcast:latest && docker compose up -d",
+    upgradeable: false
+};
 /**
- * Detects how PrismCast was installed by examining the path of the running code. Detection order: Docker container, Homebrew, npm global, npm local, unknown.
- * @returns Installation information including method, whether it is upgradeable, and the appropriate upgrade command.
+ * Homebrew strategy. Matched via the /Cellar/prismcast/ path marker. Homebrew formula installs always live under <prefix>/Cellar/<formula>/<version>/, so the
+ * marker is a reliable discriminator on both Intel (/usr/local/Cellar) and Apple Silicon (/opt/homebrew/Cellar) layouts.
  */
-export function detectInstallMethod() {
-    // Docker detection comes first — inside a container, path-based detection is irrelevant.
-    if (isRunningInContainer()) {
-        return {
-            method: "docker",
-            upgradeCommand: "docker pull " + DOCKER_IMAGE + ":latest && docker compose up -d",
-            upgradeable: false
-        };
-    }
-    // Resolve the path of the currently running code via import.meta.url. At runtime this file is dist/upgrade/detection.js.
-    const currentFile = url.fileURLToPath(import.meta.url);
-    // Homebrew detection: Homebrew formula installs live under /Cellar/prismcast/. We check specifically for /Cellar/prismcast/ rather than a broad /homebrew/ match
-    // because npm global installs on Homebrew-managed Node also live under /opt/homebrew/ (e.g., /opt/homebrew/lib/node_modules/prismcast/).
-    if (currentFile.includes("/Cellar/prismcast/")) {
-        return {
-            method: "homebrew",
-            upgradeCommand: "brew update && brew upgrade prismcast",
-            upgradeable: true
-        };
-    }
-    // npm global detection: the code path starts with the global prefix (e.g., /usr/local/lib/node_modules/prismcast/...).
-    const globalPrefix = resolveNpmGlobalPrefix();
-    if (globalPrefix && currentFile.startsWith(globalPrefix)) {
-        return {
-            method: "npm-global",
-            upgradeCommand: "npm install -g prismcast@latest",
-            upgradeable: true
-        };
-    }
-    // npm local detection: the path contains /node_modules/prismcast/ indicating a local project install.
-    const localMarker = "/node_modules/prismcast/";
-    const localIndex = currentFile.indexOf(localMarker);
-    if (localIndex !== -1) {
-        // Extract the package directory (the project root containing package.json) from the path before node_modules.
-        const projectRoot = currentFile.slice(0, localIndex);
-        // Verify the project root actually has a package.json.
-        const packageDir = existsSync(path.join(projectRoot, "package.json")) ? projectRoot : undefined;
-        return {
-            method: "npm-local",
-            packageDir,
-            upgradeCommand: "npm install prismcast@latest",
-            upgradeable: true
+const HOMEBREW_STRATEGY = {
+    displayName: "Homebrew",
+    id: "homebrew",
+    matches: (ctx) => ctx.currentFile.includes(HOMEBREW_MARKER),
+    upgradeCommand: "brew update && brew upgrade prismcast",
+    upgradeable: true
+};
+/**
+ * npm global strategy. Matched in two stages: a cheap path prefilter (the running file must be under SOME node_modules tree), then the authoritative subprocess
+ * call to `npm prefix -g`. The prefilter avoids spawning npm for paths that obviously can not be an npm install (e.g., a development checkout, a Homebrew Cellar
+ * path), keeping the matches predicate inexpensive in the common no-match case.
+ */
+const NPM_GLOBAL_STRATEGY = {
+    displayName: "npm (global)",
+    id: "npm-global",
+    matches: (ctx) => {
+        if (!ctx.currentFile.includes(ANY_NODE_MODULES)) {
+            return false;
+        }
+        const globalPrefix = ctx.runCommand("npm prefix -g");
+        if (!globalPrefix) {
+            return false;
+        }
+        return ctx.currentFile.startsWith(globalPrefix);
+    },
+    upgradeCommand: "npm install -g prismcast@latest",
+    upgradeable: true
+};
+/**
+ * npm local strategy. Matched via the /node_modules/prismcast/ path marker; the resolver computes packageDir as the directory above node_modules, but only when
+ * that directory actually has a package.json (some weird layouts have an orphaned node_modules without a manifest, and the upgrade runner needs the right cwd
+ * for npm install).
+ */
+const NPM_LOCAL_STRATEGY = {
+    displayName: "npm (local)",
+    id: "npm-local",
+    matches: (ctx) => ctx.currentFile.includes(NPM_LOCAL_MARKER),
+    resolve: (ctx) => {
+        const localIndex = ctx.currentFile.indexOf(NPM_LOCAL_MARKER);
+        const projectRoot = ctx.currentFile.slice(0, localIndex);
+        return ctx.fileExists(path.join(projectRoot, "package.json")) ? { packageDir: projectRoot } : {};
+    },
+    upgradeCommand: "npm install prismcast@latest",
+    upgradeable: true
+};
+/* The strategy registry as a narrow tuple. Declared `as const` so each entry retains its literal id type, which the RegisteredMethod type derivation below
+ * harvests. This name is module-private because consumers don't need the narrow tuple type - they iterate via INSTALL_STRATEGIES (the public, wide-typed alias)
+ * which carries the InstallStrategy<RegisteredMethod> shape they want.
+ */
+const STRATEGY_TUPLE = [
+    DOCKER_STRATEGY,
+    HOMEBREW_STRATEGY,
+    NPM_GLOBAL_STRATEGY,
+    NPM_LOCAL_STRATEGY
+];
+/**
+ * The install-method strategy registry. Same runtime data as STRATEGY_TUPLE; the public name carries the wide InstallStrategy<RegisteredMethod> type so the
+ * dispatcher (and any future consumer that iterates) sees the union uniformly. Order is priority order: docker first (container probe is unambiguous), homebrew
+ * (path marker is unambiguous), npm-global (requires successful npm prefix lookup), npm-local (broader path marker). Adding a new install method is appending an
+ * entry to STRATEGY_TUPLE.
+ */
+export const INSTALL_STRATEGIES = STRATEGY_TUPLE;
+/**
+ * The fallback InstallInfo returned when no strategy in the registry matches. Development builds, npx invocations, and unrecognized layouts land here. The
+ * upgrade command points at the canonical npm-global install path because that is the most likely successful manual upgrade, but upgradeable is false so the
+ * tool prints instructions rather than running the command.
+ */
+export const UNKNOWN_INSTALL = {
+    displayName: "Unknown",
+    manualUpgradeMessage: ["Unable to detect installation method. Please upgrade manually:"],
+    method: "unknown",
+    upgradeCommand: "npm install -g prismcast@latest",
+    upgradeable: false
+};
+/**
+ * Detects the installation method. Walks INSTALL_STRATEGIES in priority order; on the first match, builds an InstallInfo by composing the strategy's optional
+ * resolver output with the strategy's constant fields. The resolver's return type is restricted to ResolvableFields, so it cannot override id, displayName,
+ * upgradeCommand, or upgradeable; the spread order also places constants after the resolved fields as belt-and-suspenders. The strategy's `upgradeable`
+ * discriminator selects which InstallInfo variant the dispatcher emits, carrying manualUpgradeMessage through for the non-upgradeable case.
+ *
+ * Pure function of DetectionContext - all I/O happens inside the context's runCommand and fileExists callbacks, which the default adapter wires to real system
+ * calls and tests stub inline. Falls back to UNKNOWN_INSTALL when no strategy matches.
+ *
+ * @param ctx - The runtime context. Defaults to createDefaultDetectionContext() which builds one from real I/O.
+ * @returns Installation information.
+ */
+export function detectInstallMethod(ctx = createDefaultDetectionContext()) {
+    for (const strategy of INSTALL_STRATEGIES) {
+        if (!strategy.matches(ctx)) {
+            continue;
+        }
+        const base = {
+            ...strategy.resolve?.(ctx),
+            displayName: strategy.displayName,
+            method: strategy.id,
+            upgradeCommand: strategy.upgradeCommand
         };
+        if (strategy.upgradeable) {
+            return { ...base, upgradeable: true };
+        }
+        return { ...base, manualUpgradeMessage: strategy.manualUpgradeMessage, upgradeable: false };
     }
-    // Unknown: development build, npx, or an unrecognized installation layout.
-    return {
-        method: "unknown",
-        upgradeCommand: "npm install -g prismcast@latest",
-        upgradeable: false
-    };
+    return UNKNOWN_INSTALL;
 }
 //# sourceMappingURL=detection.js.map

package/dist/upgrade/detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/upgrade/detection.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,GAAG,MAAM,UAAU,CAAC;AAgB3B,yDAAyD;AACzD,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD;;;GAGG;AACH,SAAS,sBAAsB;IAE7B,IAAI,CAAC;QAEH,OAAO,QAAQ,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QAEP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IAEjC,yFAAyF;IACzF,IAAG,oBAAoB,EAAE,EAAE,CAAC;QAE1B,OAAO;YAEL,MAAM,EAAE,QAAQ;YAChB,cAAc,EAAE,cAAc,GAAG,YAAY,GAAG,iCAAiC;YACjF,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,yHAAyH;IACzH,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvD,iKAAiK;IACjK,yIAAyI;IACzI,IAAG,WAAW,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAE9C,OAAO;YAEL,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,uCAAuC;YACvD,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,uHAAuH;IACvH,MAAM,YAAY,GAAG,sBAAsB,EAAE,CAAC;IAE9C,IAAG,YAAY,IAAI,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAExD,OAAO;YAEL,MAAM,EAAE,YAAY;YACpB,cAAc,EAAE,iCAAiC;YACjD,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,sGAAsG;IACtG,MAAM,WAAW,GAAG,0BAA0B,CAAC;IAC/C,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAG,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QAErB,8GAA8G;QAC9G,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAErD,uDAAuD;QACvD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAEhG,OAAO;YAEL,MAAM,EAAE,WAAW;YACnB,UAAU;YACV,cAAc,EAAE,8BAA8B;YAC9C,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,OAAO;QAEL,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,iCAAiC;QACjD,WAAW,EAAE,KAAK;KACnB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/upgrade/detection.ts"],"names":[],"mappings":"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"}

package/dist/upgrade/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./commands.js";
-export * from "./detection.js";
+export * from "./commands.ts";
+export * from "./detection.ts";

package/dist/utils/chromeFetch.d.ts

@@ -1,4 +1,4 @@
-import type { Nullable } from "../types/index.js";
+import type { Nullable } from "../types/index.ts";
 /**
  * Sets the Chrome User-Agent string. Called by browser/index.ts when the browser launches (with the UA) and when it disconnects or closes (with null).
  * @param ua - The User-Agent string from the Chrome browser, or null to clear.

package/dist/utils/chromeFetch.js

@@ -1,6 +1,6 @@
 /* When PrismCast fetches manifests, segments, decryption keys, and other resources from service CDNs, the requests should appear to originate from the same Chrome
  * browser that is rendering the page. This module stores the Chrome User-Agent string (captured at browser launch) and provides a drop-in fetch() wrapper that
- * injects it into outgoing requests. The setter/getter pattern avoids a circular dependency between utils/ and browser/ — browser/index.ts calls the setter at
+ * injects it into outgoing requests. The setter/getter pattern avoids a circular dependency between utils/ and browser/ - browser/index.ts calls the setter at
  * launch and cleanup, while consumer modules import chromeFetch() without importing from browser/.
  */
 // The Chrome User-Agent string captured at browser launch. Null when the browser is not running.

package/dist/utils/clock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The time-dependent capability set: sleep, race-with-timeout, and read-the-clock. Decision logic that consumes a Clock is a pure function of this shape -
+ * production wires it from real I/O via realClock, tests pass a fake clock literal.
+ */
+export interface Clock {
+    readonly now: () => number;
+    readonly raceWithTimeout: <T>(promise: Promise<T>, timeoutMs: number, timeoutError?: Error) => Promise<T>;
+    readonly sleep: (ms: number) => Promise<void>;
+}
+/**
+ * The default Clock implementation. Delegates to performance.now() for current time, to raceWithTimeout() in delay.ts for promise-vs-timeout races, and to
+ * delay() in delay.ts for sleeps. Production callers consume this via the default-arg pattern; tests bypass it by passing a fake-clock literal.
+ */
+export declare const realClock: Clock;

package/dist/utils/clock.js

@@ -0,0 +1,28 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * clock.ts: The Clock port - the project's abstraction for time-dependent operations. Production code that needs to sleep, race a promise against a timeout, or
+ * read the high-resolution clock should consume a Clock when those operations live inside an async chain that tests need to control deterministically. The
+ * default realClock delegates to delay() and raceWithTimeout() in delay.ts and to performance.now() in the runtime; tests pass a fake-clock literal that resolves
+ * sleeps instantly and chooses raceWithTimeout outcomes explicitly.
+ *
+ * Why this exists. Node's built-in node:test mock.timers exposes only synchronous tick() and runAll() - it has never shipped a tickAsync/runAllAsync variant on
+ * any version. Synchronous tick advances the fake clock but does not drain microtask chains across nested Promise.race / .finally / await delay() patterns; the
+ * promises stay pending past the tick. retryOperation is the canonical case: its internal raceWithTimeout -> Promise.race -> .finally -> await delay() chain is
+ * exactly the shape mock.timers cannot deterministically resolve. Injecting a Clock sidesteps the runtime gap entirely - tests provide a sleep() that resolves
+ * immediately and a raceWithTimeout() that forwards or rejects on demand.
+ *
+ * When to use a Clock vs. a direct delay()/raceWithTimeout() import. Use the direct imports when the production code's tests can fake time with mock.timers and
+ * the call sites are shallow enough for synchronous tick() to drain. Reach for Clock injection only when nested async chains break that pattern, or when the
+ * test surface needs to assert on the *schedule* (number and durations of sleeps) rather than just the eventual outcome.
+ */
+import { delay, raceWithTimeout } from "./delay.js";
+/**
+ * The default Clock implementation. Delegates to performance.now() for current time, to raceWithTimeout() in delay.ts for promise-vs-timeout races, and to
+ * delay() in delay.ts for sleeps. Production callers consume this via the default-arg pattern; tests bypass it by passing a fake-clock literal.
+ */
+export const realClock = {
+    now: () => performance.now(),
+    raceWithTimeout,
+    sleep: delay
+};
+//# sourceMappingURL=clock.js.map

package/dist/utils/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/utils/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuBpD;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAU;IAE9B,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;IAC5B,eAAe;IACf,KAAK,EAAE,KAAK;CACb,CAAC"}

package/dist/utils/debugFilter.d.ts

@@ -28,6 +28,6 @@ export interface DebugCategory {
 }
 /**
  * Static registry of all known debug categories with descriptions. Sorted alphabetically by category. The /debug endpoint uses this to render hierarchical checkboxes.
- * Parent groups (e.g., "streaming", "timing", "tuning") are derived by the UI from the colon-separated namespaces — only leaf categories are declared here.
+ * Parent groups (e.g., "streaming", "timing", "tuning") are derived by the UI from the colon-separated namespaces - only leaf categories are declared here.
  */
 export declare const DEBUG_CATEGORIES: readonly DebugCategory[];

package/dist/utils/debugFilter.js

@@ -17,7 +17,7 @@
  */
 // Whether any debug output is configured at all. Fast-path check avoids category string work when debug is off.
 let anyEnabled = false;
-// Whether wildcard (*) was specified — all categories pass unless explicitly excluded.
+// Whether wildcard (*) was specified - all categories pass unless explicitly excluded.
 let wildcardEnabled = false;
 // Categories to include (exact or prefix match).
 const includeSet = new Set();
@@ -117,7 +117,7 @@ export function getCurrentPattern() {
 }
 /**
  * Static registry of all known debug categories with descriptions. Sorted alphabetically by category. The /debug endpoint uses this to render hierarchical checkboxes.
- * Parent groups (e.g., "streaming", "timing", "tuning") are derived by the UI from the colon-separated namespaces — only leaf categories are declared here.
+ * Parent groups (e.g., "streaming", "timing", "tuning") are derived by the UI from the colon-separated namespaces - only leaf categories are declared here.
  */
 export const DEBUG_CATEGORIES = [
     { category: "browser:lifecycle", description: "Browser lifecycle: launch, close, stale page cleanup, restart." },
@@ -126,14 +126,15 @@ export const DEBUG_CATEGORIES = [
     { category: "native:coordinator", description: "Native streaming decisions: interception result, probe result, capture teardown, proxy start." },
     { category: "native:decrypt", description: "AES-128 decryption: key fetch, IV source (explicit vs. sequence), segment sizes." },
     { category: "native:intercept", description: "CDP manifest interception: listener installed, .m3u8 URLs observed, master identified, timeout." },
-    { category: "native:manifest", description: "Raw variant manifest body from service — verbose, use for diagnosing DAI/ad stitching issues." },
+    { category: "native:manifest", description: "Raw variant manifest body from service - verbose, use for diagnosing DAI/ad stitching issues." },
     { category: "native:monitor", description: "Native health: segment staleness, error counts, L2/L3 recovery actions, capture fallback." },
     { category: "native:probe", description: "DRM probe: variant count, bandwidths, encryption classification, key accessibility, cache hit/miss." },
     { category: "native:proxy", description: "Manifest polling, segment fetch/store, playlist generation, segment rotation, key rotation." },
     { category: "native:token", description: "Token refresh: expiry parsed, timer scheduled, refresh triggered, manifest acquired." },
+    { category: "persistence:write", description: "File store writes: per-mutation save to disk after successful atomic temp+rename and integrity check." },
     { category: "precache", description: "Channel lineup precaching: deferred runs, service filter skips." },
-    { category: "recovery:general", description: "General recovery: browser re-minimize, monitor abort." },
     { category: "recovery:context", description: "Video context: frame detachment, re-search." },
+    { category: "recovery:general", description: "General recovery: browser re-minimize, monitor abort." },
     { category: "recovery:nav", description: "Page navigation recovery: new tab detection, URL validation." },
     { category: "recovery:resolution", description: "Video resolution monitoring: ABR degradation detection, grace periods, recovery escalation." },
     { category: "recovery:segments", description: "Segment production: self-heal detection." },
@@ -158,6 +159,7 @@ export const DEBUG_CATEGORIES = [
     { category: "timing:tune", description: "Tune waterfall: navigation, channel selection, video ready." },
     { category: "tuning:cox", description: "Cox Contour TV: channelmap API interception, SPA channel switching, Watch Now modal dismissal." },
     { category: "tuning:directv", description: "DirecTV Stream: interceptor tuning, cache, logo click fallback." },
+    { category: "tuning:fox", description: "Fox.com guide grid: console bridge, page errors, request failures, channel-switch diagnostics." },
     { category: "tuning:hbo", description: "HBO Max: tab URL discovery, channel rail, navigation." },
     { category: "tuning:hulu", description: "Hulu Live guide grid: binary search, cache, click retries." },
     { category: "tuning:sling", description: "Sling TV guide grid: binary search, cache, click retries." },

package/dist/utils/debugFilter.js.map

@@ -1 +1 @@
-{"version":3,"file":"debugFilter.js","sourceRoot":"","sources":["../../src/utils/debugFilter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,gHAAgH;AAChH,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,uFAAuF;AACvF,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,iDAAiD;AACjD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AAErC,4FAA4F;AAC5F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AAErC;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,QAAgB,EAAE,QAAqB;IAEzD,IAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAE1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAI,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAE9B,IAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YAEtC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAE7C,eAAe;IACf,UAAU,CAAC,KAAK,EAAE,CAAC;IACnB,UAAU,CAAC,KAAK,EAAE,CAAC;IACnB,eAAe,GAAG,KAAK,CAAC;IACxB,UAAU,GAAG,KAAK,CAAC;IAEnB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAElF,IAAG,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAEtB,OAAO;IACT,CAAC;IAED,KAAI,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAExB,IAAG,IAAI,KAAK,GAAG,EAAE,CAAC;YAEhB,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,IAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAE/B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YAEN,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAEhD,IAAG,CAAC,UAAU,EAAE,CAAC;QAEf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,IAAG,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QAEpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAG,eAAe,EAAE,CAAC;QAEnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAE/B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAE/B,IAAG,CAAC,UAAU,EAAE,CAAC;QAEf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAG,eAAe,EAAE,CAAC;QAEnB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,yCAAyC;IACzC,KAAI,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAE9B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,2CAA2C;IAC3C,KAAI,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAE9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAaD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IAExD,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,gEAAgE,EAAE;IAChH,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,sDAAsD,EAAE;IAClG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,mCAAmC,EAAE;IAChF,EAAE,QAAQ,EAAE,oBAAoB,EAAE,WAAW,EAAE,+FAA+F,EAAE;IAChJ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,kFAAkF,EAAE;IAC/H,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,iGAAiG,EAAE;IAChJ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,+FAA+F,EAAE;IAC7I,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,2FAA2F,EAAE;IACxI,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,qGAAqG,EAAE;IAChJ,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,6FAA6F,EAAE;IACxI,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,sFAAsF,EAAE;IACjI,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,iEAAiE,EAAE;IACxG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACtG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,6CAA6C,EAAE;IAC5F,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,8DAA8D,EAAE;IACzG,EAAE,QAAQ,EAAE,qBAAqB,EAAE,WAAW,EAAE,6FAA6F,EAAE;IAC/I,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAC1F,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,8DAA8D,EAAE;IACzG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,qEAAqE,EAAE;IACnH,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,qCAAqC,EAAE;IACzE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,oCAAoC,EAAE;IACnF,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACrF,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,mFAAmF,EAAE;IACjI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,8DAA8D,EAAE;IAC7G,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,4FAA4F,EAAE;IAC5I,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,iFAAiF,EAAE;IACjI,EAAE,QAAQ,EAAE,qBAAqB,EAAE,WAAW,EAAE,4DAA4D,EAAE;IAC9G,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,oEAAoE,EAAE;IAClH,EAAE,QAAQ,EAAE,oBAAoB,EAAE,WAAW,EAAE,iDAAiD,EAAE;IAClG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,mEAAmE,EAAE;IAChH,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,6BAA6B,EAAE;IACtE,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,yFAAyF,EAAE;IACrI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,wDAAwD,EAAE;IACtG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,8DAA8D,EAAE;IAC3G,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,sDAAsD,EAAE;IAC/F,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,6DAA6D,EAAE;IACvG,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,gGAAgG,EAAE;IACzI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,iEAAiE,EAAE;IAC9G,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,uDAAuD,EAAE;IAChG,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,4DAA4D,EAAE;IACtG,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,2DAA2D,EAAE;IACtG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,0EAA0E,EAAE;IACxH,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,4FAA4F,EAAE;IAC3I,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,gGAAgG,EAAE;IAC7I,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,iCAAiC,EAAE;CAC5E,CAAC"}
+{"version":3,"file":"debugFilter.js","sourceRoot":"","sources":["../../src/utils/debugFilter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,gHAAgH;AAChH,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,uFAAuF;AACvF,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,iDAAiD;AACjD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AAErC,4FAA4F;AAC5F,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AAErC;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,QAAgB,EAAE,QAAqB;IAEzD,IAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAE1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAI,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAE9B,IAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YAEtC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAE7C,eAAe;IACf,UAAU,CAAC,KAAK,EAAE,CAAC;IACnB,UAAU,CAAC,KAAK,EAAE,CAAC;IACnB,eAAe,GAAG,KAAK,CAAC;IACxB,UAAU,GAAG,KAAK,CAAC;IAEnB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAElF,IAAG,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAEtB,OAAO;IACT,CAAC;IAED,KAAI,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAExB,IAAG,IAAI,KAAK,GAAG,EAAE,CAAC;YAEhB,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,IAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAE/B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YAEN,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAEhD,IAAG,CAAC,UAAU,EAAE,CAAC;QAEf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,IAAG,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QAEpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAG,eAAe,EAAE,CAAC;QAEnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAE/B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAE/B,IAAG,CAAC,UAAU,EAAE,CAAC;QAEf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAG,eAAe,EAAE,CAAC;QAEnB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,yCAAyC;IACzC,KAAI,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAE9B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,2CAA2C;IAC3C,KAAI,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAE9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAaD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IAExD,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,gEAAgE,EAAE;IAChH,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,sDAAsD,EAAE;IAClG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,mCAAmC,EAAE;IAChF,EAAE,QAAQ,EAAE,oBAAoB,EAAE,WAAW,EAAE,+FAA+F,EAAE;IAChJ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,kFAAkF,EAAE;IAC/H,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,iGAAiG,EAAE;IAChJ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,+FAA+F,EAAE;IAC7I,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,2FAA2F,EAAE;IACxI,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,qGAAqG,EAAE;IAChJ,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,6FAA6F,EAAE;IACxI,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,sFAAsF,EAAE;IACjI,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,uGAAuG,EAAE;IACvJ,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,iEAAiE,EAAE;IACxG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,6CAA6C,EAAE;IAC5F,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACtG,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,8DAA8D,EAAE;IACzG,EAAE,QAAQ,EAAE,qBAAqB,EAAE,WAAW,EAAE,6FAA6F,EAAE;IAC/I,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAC1F,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,8DAA8D,EAAE;IACzG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,qEAAqE,EAAE;IACnH,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,qCAAqC,EAAE;IACzE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,oCAAoC,EAAE;IACnF,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACrF,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,mFAAmF,EAAE;IACjI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,8DAA8D,EAAE;IAC7G,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,4FAA4F,EAAE;IAC5I,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,iFAAiF,EAAE;IACjI,EAAE,QAAQ,EAAE,qBAAqB,EAAE,WAAW,EAAE,4DAA4D,EAAE;IAC9G,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,oEAAoE,EAAE;IAClH,EAAE,QAAQ,EAAE,oBAAoB,EAAE,WAAW,EAAE,iDAAiD,EAAE;IAClG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,mEAAmE,EAAE;IAChH,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,6BAA6B,EAAE;IACtE,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,yFAAyF,EAAE;IACrI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,wDAAwD,EAAE;IACtG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,8DAA8D,EAAE;IAC3G,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,sDAAsD,EAAE;IAC/F,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,6DAA6D,EAAE;IACvG,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,gGAAgG,EAAE;IACzI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,iEAAiE,EAAE;IAC9G,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,gGAAgG,EAAE;IACzI,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,uDAAuD,EAAE;IAChG,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,4DAA4D,EAAE;IACtG,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,2DAA2D,EAAE;IACtG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,0EAA0E,EAAE;IACxH,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,4FAA4F,EAAE;IAC3I,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,gGAAgG,EAAE;IAC7I,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,iCAAiC,EAAE;CAC5E,CAAC"}

package/dist/utils/delay.d.ts

@@ -8,8 +8,7 @@ export interface CancellableTimeout {
 }
 /**
  * Creates a cancellable timeout for use with Promise.race. Returns a promise that resolves to false after the specified delay, and a cancel function that clears
- * the timer. This avoids the split declaration-then-assignment pattern that requires definite assignment assertions when managing timer IDs alongside
- * Promise.race.
+ * the timer so it does not hold an event loop reference after the race is won by another promise.
  * @param ms - The timeout duration in milliseconds.
  * @returns An object with the timeout promise and a cancel function.
  */
@@ -27,7 +26,7 @@ export declare function cancellableTimeout(ms: number): CancellableTimeout;
  */
 export declare function raceWithTimeout<T>(promise: Promise<T>, timeoutMs: number, timeoutError?: Error): Promise<T>;
 /**
- * Creates a promise that resolves after the specified delay. This is a convenience wrapper around setTimeout that allows using async/await syntax for delays.
+ * Creates a promise that resolves after the specified delay. Wraps node:timers/promises.setTimeout so the codebase has a single canonical "sleep" name.
  * @param ms - The delay duration in milliseconds.
  * @returns A promise that resolves after the specified delay.
  */

package/dist/utils/delay.js

@@ -2,18 +2,16 @@
  *
  * delay.ts: Async delay and timeout utilities for PrismCast.
  */
+import { setTimeout as nodeSleep } from "node:timers/promises";
 /**
  * Creates a cancellable timeout for use with Promise.race. Returns a promise that resolves to false after the specified delay, and a cancel function that clears
- * the timer. This avoids the split declaration-then-assignment pattern that requires definite assignment assertions when managing timer IDs alongside
- * Promise.race.
+ * the timer so it does not hold an event loop reference after the race is won by another promise.
  * @param ms - The timeout duration in milliseconds.
  * @returns An object with the timeout promise and a cancel function.
  */
 export function cancellableTimeout(ms) {
-    let timer;
-    const promise = new Promise((resolve) => {
-        timer = setTimeout(() => { resolve(false); }, ms);
-    });
+    const { promise, resolve } = Promise.withResolvers();
+    const timer = setTimeout(() => { resolve(false); }, ms);
     return { cancel: () => { clearTimeout(timer); }, promise };
 }
 /**
@@ -28,22 +26,18 @@ export function cancellableTimeout(ms) {
  * @returns The resolved value of the promise.
  */
 export async function raceWithTimeout(promise, timeoutMs, timeoutError) {
-    let timer;
-    const timeoutPromise = new Promise((_, reject) => {
-        timer = setTimeout(() => {
-            reject(timeoutError ?? new Error("Operation timed out after " + String(timeoutMs) + "ms."));
-        }, timeoutMs);
-    });
+    const { promise: timeoutPromise, reject: signalTimeout } = Promise.withResolvers();
+    const timer = setTimeout(() => {
+        signalTimeout(timeoutError ?? new Error("Operation timed out after " + String(timeoutMs) + "ms."));
+    }, timeoutMs);
     return Promise.race([promise, timeoutPromise]).finally(() => { clearTimeout(timer); });
 }
 /**
- * Creates a promise that resolves after the specified delay. This is a convenience wrapper around setTimeout that allows using async/await syntax for delays.
+ * Creates a promise that resolves after the specified delay. Wraps node:timers/promises.setTimeout so the codebase has a single canonical "sleep" name.
  * @param ms - The delay duration in milliseconds.
  * @returns A promise that resolves after the specified delay.
  */
 export async function delay(ms) {
-    return new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
+    await nodeSleep(ms);
 }
 //# sourceMappingURL=delay.js.map

package/dist/utils/delay.js.map

@@ -1 +1 @@
-{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/utils/delay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAE3C,IAAI,KAAoC,CAAC;IAEzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,EAAE;QAE7C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,GAAS,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;AACnE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAI,OAAmB,EAAE,SAAiB,EAAE,YAAoB;IAEnG,IAAI,KAAoC,CAAC;IAEzC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAEtD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAEtB,MAAM,CAAC,YAAY,IAAI,IAAI,KAAK,CAAC,4BAA4B,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAC9F,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAE,OAAO,EAAE,cAAc,CAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IAEpC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAEnC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/utils/delay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAY/D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAE3C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAExD,OAAO,EAAE,MAAM,EAAE,GAAS,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;AACnE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAI,OAAmB,EAAE,SAAiB,EAAE,YAAoB;IAEnG,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC1F,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAE5B,aAAa,CAAC,YAAY,IAAI,IAAI,KAAK,CAAC,4BAA4B,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IACrG,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,OAAO,OAAO,CAAC,IAAI,CAAC,CAAE,OAAO,EAAE,cAAc,CAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IAEpC,MAAM,SAAS,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC"}

package/dist/utils/evaluate.js

@@ -8,11 +8,11 @@ import { raceWithTimeout } from "./delay.js";
  * 2. Timeout: A configurable timeout (default 15 seconds) provides a safety net for evaluate calls that hang. This catches cases where the browser is unresponsive but
  *    the stream hasn't been explicitly terminated yet.
  *
- * The wrapper automatically retrieves the abort signal from the stream registry using the stream context from AsyncLocalStorage. If no stream context is available
- * (e.g., during browser initialization), it falls back to timeout-only behavior.
+ * The wrapper automatically retrieves the abort signal from this module's local AbortController map using the stream context from AsyncLocalStorage. If no
+ * stream context is available (e.g., during browser initialization), it falls back to timeout-only behavior.
  *
- * IMPORTANT: When aborting or timing out, the underlying CDP call is still pending in Puppeteer - we just stop waiting for it locally. We attach a no-op .catch() to
- * the evaluate promise to suppress unhandled rejection warnings when the CDP call eventually completes or times out.
+ * When aborting or timing out, the underlying CDP call is still pending in Puppeteer - we just stop waiting for it locally. We attach a no-op .catch() to the
+ * evaluate promise to suppress unhandled rejection warnings when the CDP call eventually completes or times out.
  */
 // Default timeout for evaluate calls in milliseconds.
 const DEFAULT_EVALUATE_TIMEOUT = 15000;
@@ -102,16 +102,14 @@ export async function evaluateWithAbort(context, pageFunction, args, timeoutMs)
     const timeoutRace = raceWithTimeout(evaluatePromise, timeout, new EvaluateTimeoutError(timeout));
     // If we have an abort signal, add a third racer that rejects when the abort fires.
     if (signal) {
-        const abortPromise = new Promise((_, reject) => {
-            // Check if already aborted (race condition protection).
-            if (signal.aborted) {
-                reject(new EvaluateAbortError());
-                return;
-            }
-            signal.addEventListener("abort", () => {
-                reject(new EvaluateAbortError());
-            }, { once: true });
-        });
+        const { promise: abortPromise, reject: rejectAbort } = Promise.withResolvers();
+        // Check if already aborted (race condition protection).
+        if (signal.aborted) {
+            rejectAbort(new EvaluateAbortError());
+        }
+        else {
+            signal.addEventListener("abort", () => { rejectAbort(new EvaluateAbortError()); }, { once: true });
+        }
         return Promise.race([timeoutRace, abortPromise]);
     }
     return timeoutRace;

package/dist/utils/evaluate.js.map

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

package/dist/utils/ffmpeg.context.d.ts

@@ -0,0 +1,6 @@
+import type { FFmpegContext } from "./ffmpeg.ts";
+/**
+ * Builds the default FFmpegContext from real runtime I/O.
+ * @returns An FFmpegContext populated from the live process.
+ */
+export declare function createDefaultFFmpegContext(): FFmpegContext;

package/dist/utils/ffmpeg.context.js

@@ -0,0 +1,31 @@
+import bundledFFmpegPath from "ffmpeg-for-homebridge";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { spawn } from "node:child_process";
+/**
+ * Probes whether FFmpeg works at the given path by running it with -version. Resolves to true when the spawn succeeds and exit code is 0; false on any spawn
+ * error (binary not found, permission denied) or non-zero exit. Used by the path-resolution loop to confirm a candidate path actually launches.
+ * @param pathToCheck - Full path to the FFmpeg executable.
+ * @returns Promise resolving to true if FFmpeg runs successfully at this path.
+ */
+async function checkFFmpegAtPath(pathToCheck) {
+    const { promise, resolve } = Promise.withResolvers();
+    const ffmpeg = spawn(pathToCheck, ["-version"], { stdio: ["ignore", "ignore", "ignore"] });
+    ffmpeg.on("error", () => { resolve(false); });
+    ffmpeg.on("exit", (code) => { resolve(code === 0); });
+    return promise;
+}
+/**
+ * Builds the default FFmpegContext from real runtime I/O.
+ * @returns An FFmpegContext populated from the live process.
+ */
+export function createDefaultFFmpegContext() {
+    return {
+        bundledPath: bundledFFmpegPath,
+        exists: existsSync,
+        homedir,
+        platform: process.platform,
+        probe: checkFFmpegAtPath
+    };
+}
+//# sourceMappingURL=ffmpeg.context.js.map

package/dist/utils/ffmpeg.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.context.js","sourceRoot":"","sources":["../../src/utils/ffmpeg.context.ts"],"names":[],"mappings":"AAOA,OAAO,iBAAiB,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;;GAKG;AACH,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IAElD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAW,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,CAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAE,EAAE,CAAC,CAAC;IAE7F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IAExC,OAAO;QAEL,WAAW,EAAE,iBAAiB;QAC9B,MAAM,EAAE,UAAU;QAClB,OAAO;QACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,iBAAiB;KACzB,CAAC;AACJ,CAAC"}