[4.2.2] - 2026-03-09

Changed

Stream Mapping Refresh
Master playlist refreshes now rebuild StreamInfosByUrl, resolution lists, usher params, and related backup caches after every successful usher fetch. This keeps backup selection aligned with Twitch’s latest rotated playlist URLs instead of relying on stale stream metadata.

Relative Variant URL Mapping
Stream metadata now stores both raw and resolved variant URLs from master playlists, improving compatibility with Twitch manifests that return relative playlist paths.

Fallback Resolution Recovery
Ad processing now falls back to the best known resolution entry when the current media playlist URL is missing from the active stream map, instead of immediately giving up on backup selection.

GraphQL Hash Sync
The main-page fetch hook now extracts PlaybackAccessToken persisted-query hashes from both fetch(Request) and fetch(url, opts) traffic, keeping backup token requests synchronized with Twitch hash rotations across both request styles.

Forced Native Token Alignment
Native page PlaybackAccessToken requests are now rewritten to the configured forced player type and matching platform, keeping the main player on the intended recovery path instead of falling back to Twitch’s default token flow during ad handling.

Worker URL Compatibility
Worker interception now normalizes relative worker URLs and URL objects before Twitch-origin checks and injected worker bootstrap loading.

Conservative Playlist Stripping
Media playlist stripping now relies on explicit ad metadata and known ad-segment URL patterns instead of treating broad classes of non-live segments as ads. This reduces false-positive stripping on current Twitch playlists.

Explicit Ad Marker Detection
Ad detection now requires concrete Twitch ad markers instead of treating generic stitched text as an ad signal, reducing false-positive recovery and refresh loops during normal playback.

Segment-Level Ad Detection
Recovery now also detects ad playlists from known ad segment URLs, restoring effective ad blocking for playlists that no longer expose strong top-level ad markers.

Fallback Ad Validation Alignment
Fallback selection now uses the same explicit metadata and segment-level ad checks as playlist stripping, preventing ad-bearing backup playlists from being treated as clean candidates.

Adaptive Backup Selection
Backup recovery now tracks the last native PlaybackAccessToken player type Twitch used and prioritizes that player type first during ad recovery, reducing wasted retries before a usable backup path is found.

Ad-Cycle Backup Pinning
Once a backup player type is selected for an active ad cycle, that choice now stays pinned across worker restarts so recovery does not restart from a cold state on every reload.

Duplicate Recovery Reload Suppression
Player reload requests are now globally debounced and rate-limited during ad recovery, reducing repeated reload loops within the same ad window.