@mebius-io/web 0.5.2 → 0.5.4

package/dist/index.js

@@ -429,7 +429,7 @@ var LIVE_FLV_CONFIG = {
 var MAX_DRIFT_S = 2;
 var EDGE_MARGIN_S = 0.4;
 var AUDIO_RETRY_MS = 2500;
-var ESTIMATED_LATENCY_MS = 3e3;
+var UPSTREAM_LATENCY_MS = 800;
 function stalledWithData(video, ms) {
   if (video.currentTime > 0) return Promise.resolve(false);
   return new Promise((resolve) => {
@@ -559,13 +559,24 @@ var FlvViewTransport = class {
     return { bitrateKbps, framesPerSecond, latencyMs: void 0 };
   }
   /**
-   * Estimate only — see {@link ESTIMATED_LATENCY_MS}. Without this, captions
-   * never render on the FLV route at all: {@link MebiusCaptions} withholds
-   * every segment until the playhead reaches its `epochMs`, and a transport
-   * returning `null` here means the playhead comparison never runs.
+   * Estimate — FLV carries no wall clock, so this is measured where possible
+   * and assumed where not (see {@link UPSTREAM_LATENCY_MS}).
+   *
+   * The measurable half is the decoded media queued ahead of the playhead:
+   * whatever is buffered but not yet shown is, by definition, how far behind
+   * the newest received frame this viewer is watching. A flat guess for the
+   * whole delay was previously used, and being too generous costs real time —
+   * every millisecond of over-estimate is a caption withheld for no reason,
+   * on top of the STT latency the viewer already pays.
    */
   playheadEpochMs() {
-    return Date.now() - ESTIMATED_LATENCY_MS;
+    let bufferedAheadMs = 0;
+    const ranges = this.video?.buffered;
+    if (ranges && ranges.length > 0 && this.video) {
+      const ahead = ranges.end(ranges.length - 1) - this.video.currentTime;
+      if (Number.isFinite(ahead) && ahead > 0) bufferedAheadMs = ahead * 1e3;
+    }
+    return Date.now() - UPSTREAM_LATENCY_MS - bufferedAheadMs;
   }
 };
 
@@ -798,6 +809,7 @@ function normalize(c, fallback) {
 // src/captions.ts
 var TICK_MS = 100;
 var STALE_MS = 5e3;
+var MAX_QUEUE_MS = 1500;
 var MebiusCaptions = class extends TypedEmitter {
   /** @internal */
   constructor(signaling, player, opts) {
@@ -839,22 +851,27 @@ var MebiusCaptions = class extends TypedEmitter {
     if (frame.type !== "caption" || !frame.segmentId) return;
     const prev = this.pending.get(frame.segmentId);
     if (prev && (frame.rev ?? 0) < (prev.rev ?? 0)) return;
+    frame.receivedAtMs = Date.now();
     this.pending.set(frame.segmentId, frame);
   }
   tick() {
     const now = this.player.currentEpochMs();
-    if (now == null) return;
     for (const [id, frame] of this.pending) {
       const due = frame.epochMs ?? 0;
-      if (due > now) continue;
-      if (due < now - STALE_MS) {
+      const waitedMs = Date.now() - (frame.receivedAtMs ?? 0);
+      const dueNow = now == null ? true : due <= now;
+      if (!dueNow) {
+        if (waitedMs < MAX_QUEUE_MS) continue;
+      }
+      if (waitedMs > STALE_MS && this.shown.has(id)) {
         this.pending.delete(id);
-        if (this.shown.delete(id)) this.emit("cleared", { segmentId: id });
+        this.shown.delete(id);
+        this.emit("cleared", { segmentId: id });
         continue;
       }
+      if (this.shown.has(id) && frame.state === "final") continue;
       this.shown.add(id);
       this.emit("segment", toSegment(id, frame, this.opts.lang));
-      if (frame.state === "final") this.pending.delete(id);
     }
   }
 };