@mebius-io/web 0.5.3 → 0.6.0

package/dist/index.d.cts

@@ -149,6 +149,13 @@ interface CaptionSegment {
     durationMs: number;
     /** Original transcript, in the source language. */
     text: string;
+    /**
+     * Language `text` is actually in, as the recogniser identified it. With an
+     * "auto" source this varies per sentence, so a client showing `text` as a
+     * subtitle must check this rather than assume it matches what the viewer
+     * asked for.
+     */
+    srcLang?: string;
     /** The requested {@link CaptionsOptions.lang} translation, if produced yet. */
     translation?: string;
     /** Always `true`. Render a machine-generated indicator — never as a direct quote. */
@@ -417,6 +424,12 @@ declare class MebiusCaptions extends TypedEmitter<CaptionsEventMap> {
     private es;
     private timer;
     private readonly pending;
+    /**
+     * segmentId -> the rev already handed to listeners. Not a Set: with interim
+     * revisions on, a segment stays pending while it is being corrected, and a
+     * plain "have I shown this id" check re-emits the same unchanged text on
+     * every 100ms tick. Comparing revs emits exactly once per actual revision.
+     */
     private readonly shown;
     /** @internal */
     constructor(signaling: SignalingClient, player: MebiusPlayer, opts: CaptionsOptions);

package/dist/index.d.ts

@@ -149,6 +149,13 @@ interface CaptionSegment {
     durationMs: number;
     /** Original transcript, in the source language. */
     text: string;
+    /**
+     * Language `text` is actually in, as the recogniser identified it. With an
+     * "auto" source this varies per sentence, so a client showing `text` as a
+     * subtitle must check this rather than assume it matches what the viewer
+     * asked for.
+     */
+    srcLang?: string;
     /** The requested {@link CaptionsOptions.lang} translation, if produced yet. */
     translation?: string;
     /** Always `true`. Render a machine-generated indicator — never as a direct quote. */
@@ -417,6 +424,12 @@ declare class MebiusCaptions extends TypedEmitter<CaptionsEventMap> {
     private es;
     private timer;
     private readonly pending;
+    /**
+     * segmentId -> the rev already handed to listeners. Not a Set: with interim
+     * revisions on, a segment stays pending while it is being corrected, and a
+     * plain "have I shown this id" check re-emits the same unchanged text on
+     * every 100ms tick. Comparing revs emits exactly once per actual revision.
+     */
     private readonly shown;
     /** @internal */
     constructor(signaling: SignalingClient, player: MebiusPlayer, opts: CaptionsOptions);

package/dist/index.global.js

@@ -43047,7 +43047,7 @@ Schedule: ${scheduleItems.map((seg) => segmentToString(seg))} pos: ${this.timeli
   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) => {
@@ -43177,13 +43177,24 @@ Schedule: ${scheduleItems.map((seg) => segmentToString(seg))} pos: ${this.timeli
       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;
     }
   };
 
@@ -43416,7 +43427,7 @@ Schedule: ${scheduleItems.map((seg) => segmentToString(seg))} pos: ${this.timeli
   // src/captions.ts
   var TICK_MS = 100;
   var STALE_MS = 5e3;
-  var MAX_QUEUE_MS = 4e3;
+  var MAX_QUEUE_MS = 1500;
   var MebiusCaptions = class extends TypedEmitter {
     /** @internal */
     constructor(signaling, player, opts) {
@@ -43427,7 +43438,13 @@ Schedule: ${scheduleItems.map((seg) => segmentToString(seg))} pos: ${this.timeli
       this.es = null;
       this.timer = null;
       this.pending = /* @__PURE__ */ new Map();
-      this.shown = /* @__PURE__ */ new Set();
+      /**
+       * segmentId -> the rev already handed to listeners. Not a Set: with interim
+       * revisions on, a segment stays pending while it is being corrected, and a
+       * plain "have I shown this id" check re-emits the same unchanged text on
+       * every 100ms tick. Comparing revs emits exactly once per actual revision.
+       */
+      this.shown = /* @__PURE__ */ new Map();
     }
     /** Open the SSE connection and begin emitting segments for `streamId`. */
     start(streamId) {
@@ -43476,8 +43493,9 @@ Schedule: ${scheduleItems.map((seg) => segmentToString(seg))} pos: ${this.timeli
           this.emit("cleared", { segmentId: id });
           continue;
         }
-        if (this.shown.has(id) && frame.state === "final") continue;
-        this.shown.add(id);
+        const rev = frame.rev ?? 0;
+        if (this.shown.get(id) === rev) continue;
+        this.shown.set(id, rev);
         this.emit("segment", toSegment(id, frame, this.opts.lang));
       }
     }
@@ -43490,6 +43508,7 @@ Schedule: ${scheduleItems.map((seg) => segmentToString(seg))} pos: ${this.timeli
       epochMs: frame.epochMs ?? 0,
       durationMs: frame.durationMs ?? 0,
       text: frame.text ?? "",
+      srcLang: frame.srcLang,
       translation: frame.translations?.[lang],
       machineGenerated: true
     };