@blockcast/mmt-container 0.5.0 → 1.0.0-main.3cb7359ea316

package/README.md

@@ -177,20 +177,26 @@ if (!validateCatalog(catalog)) {
 Implements `draft-law-ramadan-moq-carp-reliability` §3 (FEC), §4 (multicast endpoints), and `draft-ramadan-moq-mmt-01` §4.4.2 (track timing). Plain TypeScript interfaces with type guards — no Zod, no runtime schema dependency. Upstream Zod schemas should derive from these via `z.infer<>`.
 
 ```ts
-type FecAlgorithm = "none" | "raptorq" | "reed-solomon"
-
-interface FecCatalogConfig {
-  algorithm: FecAlgorithm        // §3.1
-  blockProfile?: "iso-ssbg1-v1"  // REQUIRED unless algorithm is "none"; never defaulted (BLO-35597)
-  sourceSymbols: number          // K (REQUIRED): K_max, the largest SSB_length of any block
-  repairSymbols: number          // P (REQUIRED)
-  symbolSize: number             // T, 8-byte aligned (REQUIRED)
-  interleaveDepthMs?: number     // FEC block span in MILLISECONDS, default 0 (single-group blocks)
-  repairTrack: string            // §6.1 — required
-  mode?: "interleaved" | "object"  // extension; "object" (per-frame object blocks) is retired: @blockcast/mmt-fec refuses it
-  uep?: { keyRatio: number; deltaRatio: number }   // Unequal Error Protection — Blockcast extension, not in draft-ramadan-moq-fec-01
-  deltaFailWindowBlocks?: number                   // D-11, base track only
-  deltaProbeIntervalMs?: number                    // D-13, base track only
+// draft-ramadan-moq-fec-catalog-00 3: a track's `fec` is an array of instance
+// objects; an empty array or no `fec` declares no FEC. Usability is
+// validateFecCatalog's per-instance answer; runtime readers take it from
+// resolveFecBindings (both in @blockcast/mmt-base, re-exported here).
+type FecCatalogConfig = readonly FecInstanceConfig[]
+
+interface FecInstanceConfig {
+  instanceId?: number            // 0..255, default 0, unique per track
+  scheme: string                 // "raptorq" | "reed-solomon" | other token (= no FEC here)
+  blockProfile: string           // REQUIRED, never defaulted; this library implements "iso-ssbg1-v1"
+  sourceSymbols: number          // K
+  repairSymbols: number          // P of layer 0, >= 1
+  symbolSize: number             // T
+  interleaveDepthMs?: number
+  reorderToleranceMs?: number
+  repairTrack: string            // layer 0; other layers/overlay are fec-repair tracks (source + instanceId)
+  symbolTrack?: string
+  label?: string                 // display only
+  deltaFailWindowBlocks?: number // Phase-14 extension key (D-11), ignored by the validator
+  deltaProbeIntervalMs?: number  // Phase-14 extension key (D-13), ignored by the validator
 }
 
 interface MulticastEndpoint {
@@ -214,7 +220,6 @@ interface TrackTimingConfig {
   groupDurationTicks?: number      // override when ms × timescale isn't integer
 }
 
-function isFecCatalogConfig(x: unknown): x is FecCatalogConfig
 function isMulticastCatalogConfig(x: unknown): x is MulticastCatalogConfig
 function resolveGroupDurationTicks(timing: TrackTimingConfig, timescale: number): number
 function validateSwitchingSetTiming(...): { ok: true } | { ok: false; ... }
@@ -270,7 +275,7 @@ per-commit `0.1.0-main.<sha>` prerelease from `stamp-prerelease.mjs`), and a
 > Superseded by BLO-40665. Every package is now bumped in lockstep by a `v*`
 > tag and the sibling ranges move with it, so the objection above no longer
 > applies -- it was an argument against bumping *one* package. The set is at
-> `0.5.0`; see `RELEASES.md`.
+> `1.0.0`; see `RELEASES.md`.
 
 #### Track-role convention (Phase 14)