@blockcast/mmt-container 0.3.0-main.4c73d3ecc2db → 0.3.0-main.61f6a400e7ac

package/dist/browser-runtime.js

@@ -6700,7 +6700,7 @@ function validateCmsfMmtpCatalog(value) {
   const tracks = catalog["tracks"];
   const trackRecords = [];
   const positiveInteger2 = (input) => Number.isSafeInteger(input) && input > 0;
-  const positiveNumber = (input) => typeof input === "number" && Number.isFinite(input) && input > 0;
+  const positiveNumber2 = (input) => typeof input === "number" && Number.isFinite(input) && input > 0;
   for (let index = 0; index < tracks.length; index++) {
     const raw = tracks[index];
     const path = `$.tracks[${index}]`;
@@ -6745,7 +6745,7 @@ function validateCmsfMmtpCatalog(value) {
     if (groupDurationTicks !== void 0 && !positiveInteger2(groupDurationTicks)) {
       catalogError("track_group_duration_ticks", `${path}.groupDurationTicks`, "must be a positive integer");
     }
-    if (keyframeIntervalMs !== void 0 && !positiveNumber(keyframeIntervalMs) || keyframeIntervalTicks !== void 0 && !positiveInteger2(keyframeIntervalTicks)) {
+    if (keyframeIntervalMs !== void 0 && !positiveNumber2(keyframeIntervalMs) || keyframeIntervalTicks !== void 0 && !positiveInteger2(keyframeIntervalTicks)) {
       catalogError("track_keyframe_interval", path, "keyframe interval fields must be positive numbers");
     }
     if (packaging === "fec-repair") {
@@ -22299,6 +22299,23 @@ function resolveCatalogTrackGroupDurationMs(catalog, track) {
   const renditions = track.type === "audio" ? catalog?.audio?.renditions : catalog?.video?.renditions;
   return catalogGroupDurationMs(renditions?.[track.name]);
 }
+function positiveNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function catalogKeyframeCadenceMs(rendition) {
+  if (!rendition) return void 0;
+  const timescale = positiveNumber(rendition.timescale);
+  const ticksToMs = (ticks) => {
+    const value = positiveNumber(ticks);
+    return value !== void 0 && timescale !== void 0 ? value * 1e3 / timescale : void 0;
+  };
+  return ticksToMs(rendition.keyframeIntervalTicks) ?? positiveNumber(rendition.keyframeIntervalMs) ?? ticksToMs(rendition.keyframeDurationTicks) ?? positiveNumber(rendition.keyframeDurationMs) ?? ticksToMs(rendition.gopDurationTicks) ?? positiveNumber(rendition.gopDurationMs);
+}
+function catalogFecMediaUnitsPerSecond(type, rendition, endpointSampleRate) {
+  if (type === "video") return positiveNumber(rendition?.framerate);
+  const sampleRate = positiveNumber(endpointSampleRate ?? rendition?.sampleRate ?? rendition?.timescale);
+  return sampleRate === void 0 ? void 0 : sampleRate / 1024;
+}
 var NO_FEC = {
   fecK: 0,
   fecRepairCount: 0,
@@ -24380,6 +24397,28 @@ var TrackSourceConflictError = class extends Error {
 };
 var DEFAULT_CROSSFADE_FRAMES = 10;
 var DEFAULT_MAX_OVERLAY_BUFFER = 128;
+function assertDeltaFallbackConfig(cfg, prefix) {
+  if (!isPositiveFinite2(cfg.framerate)) throw new Error(`${prefix}: framerate required and must be > 0`);
+  if (!isPositiveFinite2(cfg.sourceSymbols))
+    throw new Error(`${prefix}: sourceSymbols (K_delta) required and must be > 0`);
+  if (!isPositiveFinite2(cfg.repairSymbols))
+    throw new Error(`${prefix}: repairSymbols (P_delta) required and must be > 0`);
+  if (cfg.deltaFailWindowBlocks !== void 0 && !(Number.isInteger(cfg.deltaFailWindowBlocks) && cfg.deltaFailWindowBlocks > 0)) {
+    throw new Error(`${prefix}: deltaFailWindowBlocks must be a positive integer when present`);
+  }
+  if (cfg.deltaProbeIntervalMs !== void 0 && !isPositiveFinite2(cfg.deltaProbeIntervalMs))
+    throw new Error(`${prefix}: deltaProbeIntervalMs must be > 0 when present`);
+  if (cfg.interleaveDepthMs !== void 0 && !isPositiveFinite2(cfg.interleaveDepthMs))
+    throw new Error(`${prefix}: interleaveDepthMs must be > 0 when present`);
+  if (cfg.deltaProbeIntervalMs === void 0 && cfg.interleaveDepthMs === void 0) {
+    throw new Error(
+      `${prefix}: either deltaProbeIntervalMs or interleaveDepthMs required for probe interval derivation`
+    );
+  }
+}
+function isPositiveFinite2(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
 var MediaRouter = class {
   #active = "moq";
   #multicastVideoKeyed = false;
@@ -24541,20 +24580,7 @@ var MediaRouter = class {
    * Calling again resets deltaActive=true and clears the window buffer (stream restart).
    */
   configureDelta(cfg) {
-    if (typeof cfg.framerate !== "number" || !Number.isFinite(cfg.framerate) || cfg.framerate <= 0) {
-      throw new Error("[MediaRouter] configureDelta: framerate required and must be > 0");
-    }
-    if (typeof cfg.sourceSymbols !== "number" || cfg.sourceSymbols <= 0) {
-      throw new Error("[MediaRouter] configureDelta: sourceSymbols (K_delta) required and must be > 0");
-    }
-    if (typeof cfg.repairSymbols !== "number" || cfg.repairSymbols <= 0) {
-      throw new Error("[MediaRouter] configureDelta: repairSymbols (P_delta) required and must be > 0");
-    }
-    if (cfg.deltaProbeIntervalMs === void 0 && cfg.interleaveDepthMs === void 0) {
-      throw new Error(
-        "[MediaRouter] configureDelta: either deltaProbeIntervalMs or interleaveDepthMs required for probe interval derivation"
-      );
-    }
+    assertDeltaFallbackConfig(cfg, "[MediaRouter] configureDelta");
     this.#deltaWindowSize = cfg.deltaFailWindowBlocks ?? Math.ceil(cfg.framerate);
     this.#deltaFailThresholdRatio = cfg.repairSymbols / cfg.sourceSymbols;
     this.#deltaRecoverThresholdRatio = this.#deltaFailThresholdRatio / 2;
@@ -24931,6 +24957,35 @@ var MediaRouter = class {
   }
 };
 
+// src/delta-fallback-config.ts
+function resolveDeltaFallback(base, delta) {
+  const repair = base.fec?.repairTrack;
+  if (!repair) throw new Error(`[delta-fallback] base track "${base.name}" missing fec.repairTrack`);
+  const deltaFec = delta.fec;
+  if (!deltaFec?.repairTrack) throw new Error(`[delta-fallback] delta track "${delta.name}" missing fec.repairTrack`);
+  if (deltaFec.repairTrack !== repair)
+    throw new Error(
+      `[delta-fallback] inconsistent repair tracks: ${base.name} references "${repair}" but ${delta.name} references "${deltaFec.repairTrack}"`
+    );
+  if (!(typeof base.framerate === "number" && Number.isFinite(base.framerate) && base.framerate > 0))
+    throw new Error(`[delta-fallback] base track "${base.name}" missing positive framerate`);
+  if (!(isPositive(deltaFec.sourceSymbols) && isPositive(deltaFec.repairSymbols)))
+    throw new Error(`[delta-fallback] delta track "${delta.name}" missing positive fec.sourceSymbols/repairSymbols`);
+  const config = {
+    framerate: base.framerate,
+    sourceSymbols: deltaFec.sourceSymbols,
+    repairSymbols: deltaFec.repairSymbols,
+    deltaFailWindowBlocks: base.fec?.deltaFailWindowBlocks ?? deltaFec.deltaFailWindowBlocks,
+    deltaProbeIntervalMs: base.fec?.deltaProbeIntervalMs ?? deltaFec.deltaProbeIntervalMs,
+    interleaveDepthMs: base.fec?.interleaveDepthMs ?? deltaFec.interleaveDepthMs
+  };
+  assertDeltaFallbackConfig(config, `[delta-fallback] group ${base.name}/${delta.name}`);
+  return { repairTrackName: repair, config };
+}
+function isPositive(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+
 // src/align.ts
 function secondsFromTicks(ticks, timescale) {
   if (!Number.isFinite(ticks)) {
@@ -26356,8 +26411,10 @@ export {
   catalogAmtNetworkSource,
   catalogDeclaresFec,
   catalogFecInterleaveMs,
+  catalogFecMediaUnitsPerSecond,
   catalogFecUnavailable,
   catalogGroupDurationMs,
+  catalogKeyframeCadenceMs,
   catalogRepairTarget,
   classifyH264Keyframe,
   classifyHevcKeyframe,
@@ -26455,6 +26512,7 @@ export {
   repairReachability,
   resolveCatalogTrackFec,
   resolveCatalogTrackGroupDurationMs,
+  resolveDeltaFallback,
   resolveFecState,
   resolveGlobalMmtWasmBindings,
   resolveGroupDurationMs,