@torrent-tv/proxy 2.9.63 → 2.9.64

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.9.64
+
+- **Fix**: The 2.9.63 pull-to-lowest-awaited-segment dragged the encoder to the start of the file. A seek to #1354 restarted at **#123** — the position of the *previous* watch — because requests outstanding from before the seek still counted toward `lowestAwaitedIndex`. Two fixes: the awaited floor is cleared the moment a new seek arrives (earlier requests describe where the player used to be, not where it is going), and the pull is bounded by `SEEK_PULL_LIMIT_SEGMENTS` (120) below the target — anything deeper is a leftover, not the preceding keyframe.
+
 ## 2.9.63
 
 - **Fix**: A seek landed the encoder on exactly the requested segment, which is the one position the player never asks for — so it produced files nobody was waiting for and playback hung. Per Apple HLS authoring guidance, a player given a position locates the nearest keyframe **preceding** it, decodes from there, and only then presents from the requested point; it therefore always fetches segments **below** the target. Measured on iOS: a seek to #1082 fetched from #1074 (8 back), one to #1358 fetched from #1301 (57 back) and asked for **nothing at or above** the target. The encoder now starts `SEEK_BACKOFF_SEGMENTS` (12) before the requested segment, and — since the needed depth varies and no fixed number covers it — is pulled down further to the lowest segment the player is actually waiting on, which its own requests report exactly (`lowestAwaitedIndex`). Only ever moves the start earlier, never later. Costs a few seconds of extra encoding per seek.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@torrent-tv/proxy",
-  "version": "2.9.63",
+  "version": "2.9.64",
   "description": "Torrent proxy client that exposes webseed-like HTTP stream endpoint.",
   "license": "GPL-3.0-or-later",
   "publishConfig": {

package/services/hls-session-manager.js

@@ -85,6 +85,13 @@ const ENCODER_STALL_MS = 12_000;
 // player is actually waiting on when that is lower still. Costs a few seconds
 // of extra encoding per seek.
 const SEEK_BACKOFF_SEGMENTS = 12;
+// Hard limit on how far below the requested segment the start may be pulled by
+// `lowestAwaitedIndex`. Without it a stale request from earlier playback drags
+// the encoder across the whole file: field 2026-08-02, a seek to #1354 was
+// pulled to #123 — the start of the previous watch — because requests from
+// before the seek were still counted. Anything deeper than this is not the
+// preceding keyframe, it is a leftover.
+const SEEK_PULL_LIMIT_SEGMENTS = 120;
 const SEEK_SETTLE_MS = 1_200;
 // Hard cap on the total settle wait, measured from the first far request of a
 // burst, so a still-moving scrubber cannot delay a genuine seek forever.
@@ -2063,6 +2070,10 @@ export class HlsSessionManager {
     // player needs a segment containing the preceding keyframe, so one that
     // begins exactly at the target is useless to it.
     const startIndex = Math.max(0, index - SEEK_BACKOFF_SEGMENTS);
+    // A new seek invalidates everything the player was waiting for before it:
+    // those requests describe where it USED to be. Clearing here is what keeps
+    // the pull below anchored to this seek.
+    session.lowestAwaitedIndex = -1;
     logger.info(
       `transcode ${session.id} viewer seek to ${positionSeconds.toFixed(1)}s → segment #${index}, ` +
         `starting at #${startIndex} (${SEEK_BACKOFF_SEGMENTS} back for the preceding keyframe)`
@@ -2168,7 +2179,8 @@ export class HlsSessionManager {
     // requests say exactly how far back it needs the keyframe, so honour that
     // rather than a guess. Only ever pulls the start EARLIER, never later.
     const awaited = session.lowestAwaitedIndex;
-    const effectiveTarget = awaited >= 0 && awaited < target ? awaited : target;
+    const pullFloor = Math.max(0, target - SEEK_PULL_LIMIT_SEGMENTS);
+    const effectiveTarget = awaited >= pullFloor && awaited < target ? awaited : target;
     if (effectiveTarget !== target) {
       logger.info(
         `transcode ${session.id} pulling encode start #${target} → #${effectiveTarget} ` +