@blockcast/mmt-container 0.3.0 → 0.4.0-main.d6f2737828fc

package/dist/catalog-fec-params.d.ts

@@ -116,20 +116,52 @@ export type KeyframeCadenceCatalog = GroupDurationCatalog & {
     gopDurationTicks?: number;
     gopDurationMs?: number;
 };
+/**
+ * A rendition's explicit keyframe cadence in ms: `keyframeInterval*`, then
+ * `keyframeDuration*`, then `gopDuration*`, each preferring integer ticks over
+ * the timescale to the ms field. Undefined when none is stated; a group
+ * duration is not a keyframe cadence and is never substituted.
+ */
+export declare function catalogKeyframeCadenceMs(rendition: KeyframeCadenceCatalog | undefined): number | undefined;
+/**
+ * Media units per second an FEC track's block geometry is built on, read only
+ * from what the catalog states: video frames per second from `framerate`;
+ * audio AAC access units (1024 samples) per second from the endpoint sample
+ * rate, then the catalog `sampleRate`, then `timescale` (MP4-shaped audio).
+ * The first value present is the one validated, so a declared but unusable
+ * rate is not replaced by the next. Undefined when no usable rate is stated:
+ * there is no default, since this sizes interleave geometry. A video track
+ * never reads its timescale as a rate.
+ */
+export declare function catalogFecMediaUnitsPerSecond(type: "video" | "audio", rendition: {
+    framerate?: number;
+    sampleRate?: number;
+    timescale?: number;
+} | undefined, endpointSampleRate?: number): number | undefined;
 /**
  * Why a track's catalog `fec` block resolved to no FEC although it is not a
- * plain no-FEC declaration (BLO-35597): it declares an FEC instance but names
- * no `blockProfile`, or it names a token that is not a known profile
- * (`track_fec_block_profile`), or it names `iso-ssbg1-v1` without the block
- * span that bounds that profile's block location (`track_fec`, on
- * `interleaveDepthMs`). The profile selects the block math and is never
- * defaulted or inferred, and the span is never borrowed from another track, so
- * such a track carries no FEC geometry and no repair track, and it is the only
- * track affected: every other track of the catalog resolves as usual.
+ * plain no-FEC declaration (BLO-35597, draft-ramadan-moq-fec §5.1):
+ *
+ * - `track_fec_block_profile_unimplemented`: its `blockProfile` is a token
+ *   this library does not implement. Only `iso-ssbg1-v1` is implemented; the
+ *   retired `k-padded-v1` lands here.
+ * - `track_fec_block_profile`: it declares an FEC instance but names no
+ *   `blockProfile`, or the value is not a non-empty string.
+ * - `track_fec_block_span`: retained for compatibility with older consumers;
+ *   absence no longer disables in-band FEC.
+ * - `track_fec` (on `interleaveDepthMs`): it names `iso-ssbg1-v1` with a
+ *   declared span that is not a non-negative safe integer in milliseconds.
+ *
+ * The profile selects the block math and is never defaulted or inferred, and
+ * the span is never borrowed from another track. Per §5.1 a receiver consumes
+ * such a track's source without FEC and does not join its repair tracks, so it
+ * carries no FEC geometry and no repair track; it is the only track affected,
+ * and neither the session nor any other track's FEC fails on its account.
  */
 export type TrackFecUnavailable = {
-    /** The repair-contract code a catalog validator reports for the same field. */
-    readonly code: "track_fec_block_profile" | "track_fec";
+    /** The repair-contract code a catalog validator reports for the same field
+     *  (`track_fec_block_span` excepted: an omitted span is valid shape). */
+    readonly code: "track_fec_block_profile" | "track_fec_block_profile_unimplemented" | "track_fec_block_span" | "track_fec";
     /** JSON path of the offending field: `blockProfile`, or `interleaveDepthMs`. */
     readonly path: string;
     /** What is wrong, worded as the `RepairContractError` a validator throws. */
@@ -139,13 +171,11 @@ export type TrackFecParams = {
     fecK: number;
     /** The catalog `fec.blockProfile` (BLO-35597, ISO/IEC 23008-1 Annex C).
      *  Present exactly when the track has FEC (`fecK > 0`) and absent on no
-     *  FEC: it selects the block math (`k-padded-v1`: SS_Start = SBN*K over
-     *  zero-padded K-symbol blocks; `iso-ssbg1-v1`: ssbg_mode1, K' =
-     *  SSB_length, consecutive SS_IDs), so it is never defaulted. A declared
-     *  instance that names no known profile has no FEC; `fecUnavailable` says
-     *  why. */
+     *  FEC. The only profile is `iso-ssbg1-v1` (ssbg_mode1, K' = SSB_length,
+     *  consecutive SS_IDs); it is never defaulted. A declared instance that
+     *  names no implemented profile has no FEC; `fecUnavailable` says why. */
     fecBlockProfile?: FecBlockProfile;
-    /** Present exactly when the track's `fec` block names no usable
+    /** Present exactly when the track's `fec` block names no implemented
      *  `blockProfile`, or names `iso-ssbg1-v1` without a usable block span
      *  (see `TrackFecUnavailable`). The track then resolves to
      *  no FEC (`fecK` 0, no `fecBlockProfile`, no repair track) and this is
@@ -205,9 +235,15 @@ export declare function joinedRepairSymbolCount(params: Pick<TrackFecParams, "fe
  *   layer 0 are `repair.renditions` entries that `depend` on it.
  *
  * Returns undefined when the source carries no FEC repair track and nothing
- * depends on it. Throws `RepairContractError` (code + JSON path) on any
- * violation, including a repair rendition whose `depends` names a rendition
- * without FEC, so a player fails closed before joining any repair track.
+ * depends on it, and when the source's FEC is unavailable
+ * (`catalogFecUnavailable`: no implemented `blockProfile`, the retired
+ * `k-padded-v1` included, or an `iso-ssbg1-v1` span it cannot use). Per
+ * draft-ramadan-moq-fec §5.1 a receiver joins none of that source's repair
+ * tracks, so it gets no layers; the catalog's repair contract is still
+ * enforced for it as for every source. Throws `RepairContractError` (code +
+ * JSON path) on any violation, including a repair rendition whose `depends`
+ * names a rendition without FEC, so a player fails closed before joining any
+ * repair track.
  */
 export declare function resolveRepairLayers(catalog: RepairLayerCatalog | undefined, source: string | CatalogTrackRef): RepairLayersResolution | undefined;
 /**
@@ -225,11 +261,33 @@ export declare function resolveRepairLayers(catalog: RepairLayerCatalog | undefi
  *   whose renditions carry no MoQ Transport priority) yields null, and the
  *   keyframe repair FETCH is then sent without the parameter.
  *
- * Returns null when the track has no repair track.
+ * Returns null without a positive elapsed span, or when the track has no repair track, including when its FEC is
+ * unavailable (`catalogFecUnavailable`): draft-ramadan-moq-fec §5.1 forbids
+ * joining that track's repair tracks, so there is nothing to FETCH.
  *
  * @throws RepairContractError exactly as `resolveRepairLayers` does.
  */
 export declare function catalogRepairTarget(catalog: RepairLayerCatalog | undefined, source: string | CatalogTrackRef): RepairTarget | null;
+/**
+ * Whether one catalog `fec` block leaves its track without FEC although it is
+ * not a plain no-FEC declaration (draft-ramadan-moq-fec §5.1), and why: the
+ * one track-scoped availability rule both catalog dialects apply. The hang
+ * resolver (`resolveCatalogTrackFec`, `resolveRepairLayers`) and the MSF
+ * `tracks[]` ingest (`MulticastManager.configureMultiTrack`) read it, so they
+ * cannot disagree about which tracks keep FEC.
+ *
+ * Returns the reason (`TrackFecUnavailable`) when the block names no
+ * implemented `blockProfile` (the retired `k-padded-v1` included; on
+ * `algorithm: "none"` only a present token is read) or, for a declared
+ * `iso-ssbg1-v1` instance, carries no usable block span. Returns undefined for
+ * a non-object and for every block whose FEC is available. It reads only the
+ * profile and the span: malformed geometry (`sourceSymbols`, `symbolSize`, ...)
+ * is the caller's to reject, and takes precedence. Never throws.
+ *
+ * @param fec the track's catalog `fec` value.
+ * @param fecPath JSON path of that `fec` block; the reason's `path` extends it.
+ */
+export declare function catalogFecUnavailable(fec: unknown, fecPath: string): TrackFecUnavailable | undefined;
 /**
  * Resolves per-track FEC geometry from the catalog for the active endpoint tracks.
  *
@@ -240,14 +298,16 @@ export declare function catalogRepairTarget(catalog: RepairLayerCatalog | undefi
  * interleave and repair layers, never the first rendition's. A track with no
  * rendition of its type resolves to no FEC (`fecK` 0) and no media rate.
  *
- * The block profile is track-scoped (BLO-35597). A rendition whose `fec`
- * declares an FEC instance but names no `blockProfile`, or whose `fec` (a
- * `none` block included) names a token that is not a known profile, resolves
- * to no FEC: `fecK` 0, no `fecBlockProfile`, no repair track, and
- * `fecUnavailable` carrying the `track_fec_block_profile` reason at the
- * field's JSON path for the caller to surface. Every other track resolves as
- * usual. The profile is never defaulted or inferred; `algorithm: "none"` may
- * omit it.
+ * The block profile is track-scoped (BLO-35597, draft-ramadan-moq-fec §5.1).
+ * `iso-ssbg1-v1` is the only implemented profile. A rendition whose `fec`
+ * declares an FEC instance but names no `blockProfile`
+ * (`track_fec_block_profile`), or whose `fec` (a `none` block included) names
+ * any other token (`track_fec_block_profile_unimplemented`; the retired
+ * `k-padded-v1` is one), resolves to no FEC: `fecK` 0, no `fecBlockProfile`,
+ * no repair track, layers or overlays, and `fecUnavailable` carrying the
+ * reason at the field's JSON path for the caller to surface. Every other track
+ * resolves as usual. The profile is never defaulted or inferred;
+ * `algorithm: "none"` may omit it.
  *
  * @throws RepairContractError `track_fec` when a rendition's `fec` declares an
  * FEC instance (any `algorithm` but `none`) whose `sourceSymbols` or

package/dist/catalog-fec-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-fec-params.d.ts","sourceRoot":"","sources":["../src/catalog-fec-params.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog-fec-params.d.ts","sourceRoot":"","sources":["../src/catalog-fec-params.ts"],"names":[],"mappings":"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"}

package/dist/catalog-fec-params.js

@@ -15,19 +15,18 @@ var NTP_SHORT_HALF_RANGE = 2 ** (NTP_SHORT_BITS - 1);
 
 // ../mmt-base/dist/fec-block-profile.js
 var FEC_BLOCK_PROFILES = Object.freeze([
-  "k-padded-v1",
   "iso-ssbg1-v1"
 ]);
 function isFecBlockProfile(value) {
-  return value === "k-padded-v1" || value === "iso-ssbg1-v1";
+  return value === "iso-ssbg1-v1";
 }
 function parseFecBlockProfile(value, where) {
   if (isFecBlockProfile(value))
     return value;
   if (value === void 0) {
-    throw new Error(`${where} is required: name the FEC block profile ("k-padded-v1" or "iso-ssbg1-v1")`);
+    throw new Error(`${where} is required: name the FEC block profile ("iso-ssbg1-v1")`);
   }
-  throw new Error(`${where} must be "k-padded-v1" or "iso-ssbg1-v1" (got ${JSON.stringify(value)})`);
+  throw new Error(`${where} must be "iso-ssbg1-v1" (got ${JSON.stringify(value)})`);
 }
 
 // src/catalog-fec-params.ts
@@ -63,6 +62,14 @@ var throwRepairContractError = (code, path, message) => {
 };
 function readFecBlockProfile(value, path, declaresFecInstance, fail) {
   if (value === void 0 && !declaresFecInstance) return void 0;
+  if (isFecBlockProfile(value)) return value;
+  if (typeof value === "string" && value.length > 0) {
+    return fail(
+      "track_fec_block_profile_unimplemented",
+      path,
+      `${JSON.stringify(value)} is not an implemented FEC block profile; only "iso-ssbg1-v1" is implemented`
+    );
+  }
   try {
     return parseFecBlockProfile(value, "blockProfile");
   } catch (error) {
@@ -372,7 +379,6 @@ function resolveGroupDurationMs(timing, timescale) {
 }
 
 // src/fec-state.ts
-var MIN_INTERLEAVE_DEPTH_MS = 33;
 var FEC_INACTIVE_REASONS = Object.freeze([
   "no-catalog-fec",
   "reliable-moq",
@@ -398,7 +404,7 @@ function isoBlockSpanUsable(fec) {
   const block = recordOf(fec);
   if (block === void 0 || block["blockProfile"] !== "iso-ssbg1-v1") return true;
   const ms = block["interleaveDepthMs"];
-  return typeof ms === "number" && Number.isFinite(ms) && ms >= MIN_INTERLEAVE_DEPTH_MS;
+  return ms === void 0 || typeof ms === "number" && Number.isSafeInteger(ms) && ms >= 0;
 }
 
 // src/catalog-fec-params.ts
@@ -420,6 +426,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,
@@ -488,11 +511,12 @@ function resolveRepairLayers(catalog, source) {
         );
       }
     }
-    return assembleRepairLayers(
+    const layers2 = assembleRepairLayers(
       geometryOf(sourceName, `${renditionPath}.fec`, recordOf2(rendition["fec"])),
       descriptors2,
       throwRepairContractError
     );
+    return catalogFecUnavailable(rendition["fec"], `${renditionPath}.fec`) === void 0 ? layers2 : void 0;
   }
   const msf = msfTracks(catalog);
   const msfIndex = msf ? msf.tracks.findIndex((t) => t["name"] === sourceName) : -1;
@@ -531,9 +555,13 @@ function resolveRepairLayers(catalog, source) {
       );
     }
   }
-  return assembleRepairLayers(geometryOf(sourceName, `$.tracks[${msfIndex}].fec`, fec), descriptors, throwRepairContractError, {
-    layerZeroMustBeDeclared: true
-  });
+  const layers = assembleRepairLayers(
+    geometryOf(sourceName, `$.tracks[${msfIndex}].fec`, fec),
+    descriptors,
+    throwRepairContractError,
+    { layerZeroMustBeDeclared: true }
+  );
+  return catalogFecUnavailable(fec, `$.tracks[${msfIndex}].fec`) === void 0 ? layers : void 0;
 }
 function moqtPriority(value) {
   return Number.isSafeInteger(value) && value >= 0 && value <= 255 ? value : null;
@@ -545,6 +573,11 @@ function catalogRepairTarget(catalog, source) {
   const sourceName = typeof source === "string" ? source : source.name;
   const msf = msfTracks(catalog);
   const entry = msf?.tracks.find((t) => t["name"] === sourceName);
+  const hang = catalog;
+  const roles = typeof source === "string" ? ["video", "audio"] : source.type === "video" ? ["video"] : source.type === "audio" ? ["audio"] : ["video", "audio"];
+  const rendition = roles.map((role) => hang[role]?.renditions?.[sourceName]).find((r) => recordOf2(r) !== void 0);
+  const fec = rendition === void 0 ? recordOf2(entry?.["fec"]) : recordOf2(rendition.fec);
+  if (!fec || !(catalogFecInterleaveMs(fec) ?? 0)) return null;
   const sourcePriority = entry === void 0 ? null : moqtPriority(entry["priority"]);
   return { repairTrack: layerZero.repairTrackName, sourcePriority, repairPriority: layerZero.priority };
 }
@@ -571,8 +604,10 @@ function blockProfileUnavailable(value, path, declaresFecInstance) {
     readFecBlockProfile(value, path, declaresFecInstance, throwRepairContractError);
     return void 0;
   } catch (error) {
-    if (!(error instanceof RepairContractError) || error.code !== "track_fec_block_profile") throw error;
-    return Object.freeze({ code: "track_fec_block_profile", path: error.path, message: error.message });
+    if (!(error instanceof RepairContractError) || error.code !== "track_fec_block_profile" && error.code !== "track_fec_block_profile_unimplemented") {
+      throw error;
+    }
+    return Object.freeze({ code: error.code, path: error.path, message: error.message });
   }
 }
 function isoSpanUnavailable(fec, path, declaresFecInstance) {
@@ -580,9 +615,15 @@ function isoSpanUnavailable(fec, path, declaresFecInstance) {
   return Object.freeze({
     code: "track_fec",
     path,
-    message: `[repair-layers:track_fec] ${path}: iso-ssbg1-v1 requires a block span of at least ${MIN_INTERLEAVE_DEPTH_MS} ms, which bounds its block location`
+    message: `[repair-layers:track_fec] ${path}: must be a non-negative safe integer in milliseconds`
   });
 }
+function catalogFecUnavailable(fec, fecPath) {
+  const block = recordOf2(fec);
+  if (block === void 0) return void 0;
+  const declaresFecInstance = block["algorithm"] !== "none";
+  return blockProfileUnavailable(block["blockProfile"], `${fecPath}.blockProfile`, declaresFecInstance) ?? isoSpanUnavailable(block, `${fecPath}.interleaveDepthMs`, declaresFecInstance);
+}
 function fecParams(catalog, track, rendition, fps, sampleRate) {
   const mediaRate = sampleRate === void 0 ? { fps } : { fps, sampleRate };
   const fec = rendition?.fec;
@@ -600,7 +641,7 @@ function fecParams(catalog, track, rendition, fps, sampleRate) {
         "must be a positive integer"
       );
     }
-    const fecUnavailable = blockProfileUnavailable(fec.blockProfile, `${fecPath}.blockProfile`, declaresFecInstance) ?? isoSpanUnavailable(fec, `${fecPath}.interleaveDepthMs`, declaresFecInstance);
+    const fecUnavailable = catalogFecUnavailable(fec, fecPath);
     return fecUnavailable === void 0 ? { ...NO_FEC, ...mediaRate } : { ...NO_FEC, ...mediaRate, fecUnavailable };
   }
   const fecBlockProfile = readFecBlockProfile(fec.blockProfile, `${fecPath}.blockProfile`, true, throwRepairContractError);
@@ -611,9 +652,7 @@ function fecParams(catalog, track, rendition, fps, sampleRate) {
     // The wire RSB_length: every base layer's packets carry the base total (§7.1).
     fecTotalRepairCount: repair?.totalBaseRepairSymbols ?? fec.repairSymbols ?? 0,
     fecSymbolSize: fec.symbolSize ?? 0,
-    // interleaveDepthMs is the FEC block span in MILLISECONDS (§5.1) — the
-    // only interleave key the catalog carries post-BLO-14526. Receivers
-    // derive D by positive round-half-up of span / GOP duration where needed.
+    // Zero/absence leaves the elapsed deadline unknown; geometry stays in-band.
     fecInterleaveMs: catalogFecInterleaveMs(fec) ?? 0,
     // Additive, never a multiplier on the span: jitter belongs to the network
     // path and the span belongs to the encoder, so scaling one by the other
@@ -683,7 +722,10 @@ export {
   assembleRepairLayers,
   assertRepairTrackReachable,
   catalogFecInterleaveMs,
+  catalogFecMediaUnitsPerSecond,
+  catalogFecUnavailable,
   catalogGroupDurationMs,
+  catalogKeyframeCadenceMs,
   catalogRepairTarget,
   dependsTarget,
   describeRepairTrack,