@torrent-tv/proxy 2.55.5 → 2.55.6

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.55.6
+
+- **Chore**: Every step of the subtitle push chain now logs on success, not only on failure. Field report 2026-08-22, playing `Minions.and.Monsters.1080p.mkv`: a track was switched on over a minute after the seed fetch found nothing (`bytes=7`, an empty `WEBVTT` — expected, the torrent had barely started), and no cues appeared. The proxy log carried no evidence either way — `warmActiveFiles` posted `Event.SUBTITLE_CUES_READY` silently, `publishSubtitleCues` sent (or found no subscriber for) a push silently, and `subscribeSubtitles` registered a channel silently. Confirmed separately by reading WebTorrent's own source that `verified` fires on every live piece completion (`_markVerified` inside `store.put`'s callback in `torrent.js`, not only at startup), so the event source itself is real; what could not be told apart without these lines is subscription, discovery, and delivery. Logs now name each: `subtitle push: channel subscribed to …`, `… cue(s) found, posting to main thread`, `… sent N cue(s) … to M/T channel(s)` (or `found no subscribed channel`).
+
 ## 2.55.5
 
 - **New**: Subtitle cues are now PUSHED to the browser the moment they are read, over the WebRTC data channel — not fetched by the browser on a timer. Every declared track was already being warmed off the piece-`verified` event (2.55.4); what changed is that the result now travels to the browser unprompted instead of sitting on the proxy until the next poll asked for it. `data-channel-handler.js` remembers which channel last asked about a file's subtitles (piggy-backing on the browser's own first `/api/subtitles?trackIndex=` request — no separate subscribe message) and sends new cues there directly (`{ type: "subtitle-cues", fileIndex, trackIndex, cues, language }`), for every track the container declares, not only the one on screen. Rides the existing `proxy-control` data channel — the same one the request itself used, which is never the one carrying segment bytes, so a push cannot queue behind video. `finalizeCues` (end-time synthesis + ASS-dialogue stripping) is factored out of the HTTP route into `services/torrent-worker/subtitle-cues.js` so a pushed cue and a pulled one are built the same way. A browser's one-off seed fetch per track (for whatever is already read at the moment a file opens) and the external-subtitle-FILE path (`.srt`/`.ass` beside the video — a single whole-file read, no incremental delivery to begin with) are unchanged.

package/package.json

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

package/services/data-channel-handler.js

@@ -324,7 +324,11 @@ export function createDataChannelHandler({ proxyPort, onLog, getTransportSnapsho
       set = new Set();
       subtitleSubscribers.set(key, set);
     }
+    const isNew = !set.has(channel);
     set.add(channel);
+    if (isNew) {
+      log(`[dc] subtitle push: channel subscribed to ${key} (${set.size} channel(s) now)`);
+    }
   }
 
   /** @param {DataChannel} channel */
@@ -346,18 +350,29 @@ export function createDataChannelHandler({ proxyPort, onLog, getTransportSnapsho
   function publishSubtitleCues({ sourceKey, fileIndex, trackIndex, cues, language }) {
     const set = subtitleSubscribers.get(`${sourceKey}:${fileIndex}`);
     if (!set || set.size === 0) {
+      log(
+        `[dc] subtitle push: ${cues.length} cue(s) for ${sourceKey.slice(0, 8)}:${fileIndex} track ${trackIndex} ` +
+        "found no subscribed channel"
+      );
       return;
     }
     const message = { type: "subtitle-cues", fileIndex, trackIndex, cues, language };
+    const total = set.size;
+    let sent = 0;
     for (const channel of set) {
       try {
         channel.sendMessage(JSON.stringify(message));
+        sent += 1;
       } catch {
         // Closed between the subscription and this send; onClosed will not
         // fire for a channel that is already gone, so drop it here too.
         set.delete(channel);
       }
     }
+    log(
+      `[dc] subtitle push: sent ${cues.length} cue(s) for ${sourceKey.slice(0, 8)}:${fileIndex} track ${trackIndex} ` +
+      `to ${sent}/${total} channel(s)`
+    );
   }
 
   /** Request id → its ASCII bytes; see {@link requestIdBytes}. */

package/services/torrent-worker/worker.js

@@ -525,6 +525,10 @@ function warmActiveFiles(sourceKey, torrent) {
     warmSubtitleCues(torrent, fileIndex, sourceKey)
       .then((fresh) => {
         for (const entry of fresh) {
+          log(
+            `subtitle push ${sourceKey.slice(0, 8)}:${fileIndex} track ${entry.trackIndex}: ` +
+            `${entry.cues.length} new cue(s) found, posting to main thread`
+          );
           parentPort.postMessage({
             type: Event.SUBTITLE_CUES_READY,
             sourceKey,