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

package/test-vectors/catalog/README.md

@@ -12,7 +12,16 @@ Negative fixtures are the migration worklist and MUST fail.
 `section-codes.json` lists every negative once: the code and path the
 TypeScript runtime validator and the Rust catalog section (`mmt_fec::catalog`)
 both reject it with, or `outOfSection` when the section does not own the field.
-The Rust section owns only the track MMTP/FEC/repair/timing fields.
+The Rust section owns only the track MMTP and timing fields.
+
+FEC is the draft-ramadan-moq-fec-catalog-00 `fec` **array** of instance
+objects; repair (`fec-repair`) and symbol (`fec-source`) tracks name their
+instance by `source` + `instanceId` (BLO-50171). The schema states what a
+publisher emits. A receiver binds FEC through `validateFecCatalog`, which fails
+closed per instance against `vectors/fec-catalog-00/`;
+`validateCmsfMmtpCatalog` never throws on `fec` or on a repair or symbol track,
+so a fec-01 single object costs only that track's FEC. The fec-01 catalogs the
+runtime resolver still reads live in `fec-01-runtime/`.
 
 The negatives:
 
@@ -41,36 +50,21 @@ The negatives:
 - `multicast-network-source-empty.json`: `networkSource` is optional, but an
   empty array is not a way to say "absent" — omit the key instead.
 - `repair-track-legacy-shape.json`: repair tracks use `packaging: "fec-repair"`.
-- `fec-enhancement-repair-removed.json`: `fec.enhancementRepair` does not exist;
-  repair layers are self-describing `fec-repair` tracks.
-- `fec-repair-*.json`: a repair layer or overlay declares `depends` (exactly one
-  source), `repairSymbols`, and a `priority` in 192..255; an overlay declares
-  `scope: "keyframe"` plus `sourceSymbols` and never a `repairLayer`; a repair
-  track carries no block geometry.
-- `media-track-repair-layer.json`: `repairLayer`, `repairSymbols`, `sourceSymbols`,
-  and `scope` are `fec-repair` track fields only.
-- `raptorq-source-symbols-over-max.json`: RaptorQ K is at most 56403 (RFC 6330).
-- `fec-iso-symbol-size-below-floor.json` (RaptorQ T=8, aligned) and
-  `fec-reed-solomon-iso-symbol-size-13.json`: under `iso-ssbg1-v1`
-  `symbolSize` is at least 14, whatever the algorithm; a shorter symbol carries
-  no protected MMTP packet (draft-ramadan-moq-fec-01 6.3.4 rule 13, 7.3).
-- `fec-symbol-size-zero.json`, `fec-source-symbols-zero.json`,
-  `fec-repair-symbols-zero.json` (with a named repair track) and
-  `fec-repair-overlay-source-symbols-zero.json` (`track_fec_bounds` at the
-  overlay's `sourceSymbols`): the rule 13 / 5.1.1 lower bounds of 1.
-- `fec-reed-solomon-k-plus-p-over-255.json` (base K + totalP = 256 across
-  layers 0 and 1) and `fec-reed-solomon-overlay-over-255.json` (overlay
-  K + P = 256): under `reed-solomon` every FEC instance holds at most 255
-  symbols (`track_fec_bounds`, draft-ramadan-moq-fec-01 6.3.4 rule 12, 4.5).
-  The schema cannot state a sum and accepts both.
-- `fec-block-profile-missing.json`: an FEC instance must name its block
-  profile; there is no default (`track_fec_block_profile`).
-- `fec-block-profile-unknown.json`: `fec.blockProfile` is `"iso-ssbg1-v1"`; a
-  near-miss such as `"iso-ssbg1"` is rejected, not normalized
-  (`track_fec_block_profile_unimplemented`).
-- `fec-block-profile-retired.json`: the retired Blockcast-private
-  `"k-padded-v1"` is not a block profile
-  (`track_fec_block_profile_unimplemented`).
+- The FEC negatives are schema-only (`outOfSection` in `section-codes.json`):
+  the publisher schema refuses them, while a receiver fails the one instance
+  closed (`vectors/fec-catalog-00/`, where `recut-*` carry the fec-01 rule-13
+  set's outcomes). `fec-symbol-size-zero.json`, `fec-source-symbols-zero.json`,
+  `fec-repair-symbols-zero.json` and `fec-repair-overlay-source-symbols-zero.json`
+  (the overlay instance's `sourceSymbols`): lower bounds of 1.
+  `fec-iso-symbol-size-below-floor.json` (RaptorQ T=8, aligned) and
+  `fec-reed-solomon-iso-symbol-size-13.json`: under `iso-ssbg1-v1` `symbolSize`
+  is at least 14 (draft-ramadan-moq-mmt-02 7.1). `raptorq-unaligned-symbol.json`
+  and `raptorq-source-symbols-over-max.json`: RaptorQ T is a multiple of 8 and
+  K at most 56403. `fec-block-profile-missing.json`: an instance names its block
+  profile; there is no default. `fec-repair-layer-geometry.json`: a repair track
+  carries no block geometry. `fec-repair-layer-missing-symbols.json`: a layer
+  1..n declares `repairSymbols`. `media-track-repair-layer.json`: `repairLayer`
+  is a `fec-repair` track field only.
 - `archive-origin-with-path.json`: `archive.origin` is scheme and authority
   only. A path would make the derived object URL ambiguous above a codec that
   refuses percent-encoding precisely so each identity has one URL path.
@@ -88,43 +82,20 @@ on the other, so both arms of the `/v1/{ns}/{track}/{group}` derivation stay
 exercised: `{ns}` is the track's own `namespace`, or the MoQ subscription's
 Track Namespace tuple when the track declares none.
 
-Every `fec` object that declares an FEC instance (any `algorithm` other than
-`"none"`) carries `fec.blockProfile` (BLO-35597, ISO/IEC 23008-1 Annex C).
-draft-ramadan-moq-fec §5.1 defines exactly one value, `"iso-ssbg1-v1"`
-(ssbg_mode1, `K' = SSB_length`, consecutive SS_IDs), and it is never defaulted
-and never inferred from the wire. Any other token, the retired
-Blockcast-private `"k-padded-v1"` included, fails validation with
-`track_fec_block_profile_unimplemented`; an absent token on an FEC instance
-fails with `track_fec_block_profile`. A receiver consumes such a track without
-FEC and joins none of its repair tracks, without failing the session or any
-other track's FEC.
-
-`"iso-ssbg1-v1"` bounds a block's location by its span, so a receiver applies
-FEC only when `fec.interleaveDepthMs` is at least 33 ms; without it the track
-resolves to no FEC (`track_fec_block_span` on `interleaveDepthMs`; a declared
-span below the floor is `track_fec`). The schema and the
-CMSF validator do not require the field. Every fixture that carried
-`"k-padded-v1"` now names `"iso-ssbg1-v1"`. The FEC-carrying positives that
-omitted the span (`fec-multicast.json`,
-`multicast-native-ssm-no-network-source.json`) now declare the one-group span
-their omitted field used to mean (`interleaveDepthMs` equal to
-`groupDurationMs`, 1000). `fec-iso-ssbg1.json` is `fec-multicast.json` without
-that span: a valid catalog whose FEC a receiver cannot apply.
-
-On `algorithm: "none"` the field is optional, but a present token must still be
-implemented. Repair tracks carry no `fec`, so they carry no profile; a repair
-layer or overlay inherits its source's. Every negative fixture with an FEC
-source names `"iso-ssbg1-v1"` unless the profile is what it tests, so each still
-fails for exactly the reason listed above.
+Every FEC instance names its `scheme` and `blockProfile`; neither is defaulted
+or inferred from the wire. A scheme or profile the receiver does not implement
+leaves that instance unavailable, never the catalog (draft-ramadan-moq-fec-core-00
+10.3 rule 1); `"none"` is reserved and an absent or empty array is how a track
+declares no FEC. `fec-iso-ssbg1.json` is `fec-multicast.json` without the
+instance's `interleaveDepthMs`.
 
-`fec-layered-repair.json` carries base layers 0..2 and a keyframe overlay for one
-source (draft-ramadan-moq-fec 6.3): layer 0 is `fec.repairTrack`, every further
-repair track names its source in `depends`, and the second endpoint carries only
-repair tracks. Priority is on the MoQT scale (lower first); `audio-repair`
-declares none and so is layer 0 at the default 240.
+`fec-layered-repair.json` carries, for one source, instance 0 with base layers
+0..2 (layer 0 is the instance's `repairTrack`; layers 1..2 name `source` and
+`instanceId` and declare `repairSymbols`) and instance 1, a keyframe overlay
+(`scope: "keyframe"`) with its own repair track; the second endpoint carries
+only repair tracks. Priority is on the MoQT scale (lower first); `audio-repair`
+declares none.
 
-An omitted `fec.interleaveDepthMs` is valid catalog shape, but under
-`"iso-ssbg1-v1"` it leaves the track without FEC at a receiver (see above).
 When present, `groupDurationTicks` overrides the integer millisecond field.
 Switching sets compare `ticks / timescale`, so equal wall-clock durations at
 different timescales are valid. One exception: an intra-only member (group
@@ -173,7 +144,8 @@ digest, and compares the extracted catalog bytes to the committed fixture. The
 fixture is retained byte-identical as the record of what v1 shipped and is now
 expected to **fail** validation: its two repair tracks declare the retired
 `packaging: "condensed"`, which is not a catalog packaging value, and its two
-FEC sources predate the required `fec.blockProfile`. The condensed
+FEC sources carry the fec-01 single `fec` object, which the array-only schema
+refuses by type. The condensed
 FEC repair format itself is unaffected — a catalog declares it as
 `packaging: "fec-repair"` plus `fec.repairContainer`.
 

package/test-vectors/catalog/fec-01-runtime/README.md

@@ -0,0 +1,15 @@
+# fec-01 single-object catalogs (compatibility inputs)
+
+These are the draft-ramadan-moq-fec-01 `fec` object shape, kept byte-identical
+to the `positive/` fixtures they were before the array-only re-cut (BLO-50171).
+They are **not** catalog-contract fixtures: the contract is the
+draft-ramadan-moq-fec-catalog-00 array (`positive/`, `vectors/fec-catalog-00/`).
+
+They exist for one rule: a fec-01 publisher costs only the FEC of the track
+carrying the object. `validateCmsfMmtpCatalog` must not throw on one,
+`validateFecCatalog` gives that track no instance, and the runtime resolver
+(`resolveRepairLayers`, `catalogTrackFecUnavailable`) gives it no FEC with
+`fec_member` at its `fec` (`catalog-schema.test.ts`). That last test is also
+the mutation guard: restoring a fec-01 read in the resolver turns it red.
+
+Delete this directory once no publisher emits the fec-01 object (BLO-50172).

package/test-vectors/catalog/{negative/fec-block-profile-retired.json → fec-01-runtime/fec-iso-ssbg1.json}

@@ -12,7 +12,7 @@
       "groupDurationMs": 1000,
       "fec": {
         "algorithm": "raptorq",
-        "blockProfile": "k-padded-v1",
+        "blockProfile": "iso-ssbg1-v1",
         "sourceSymbols": 768,
         "repairSymbols": 384,
         "symbolSize": 1312,

package/test-vectors/catalog/fec-01-runtime/fec-layered-repair.json

@@ -0,0 +1,106 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000,
+      "fec": {
+        "algorithm": "raptorq",
+        "blockProfile": "iso-ssbg1-v1",
+        "sourceSymbols": 64,
+        "repairSymbols": 8,
+        "symbolSize": 1312,
+        "interleaveDepthMs": 1000,
+        "reorderToleranceMs": 40,
+        "repairTrack": "video/repair"
+      }
+    },
+    {
+      "name": "video/repair",
+      "packaging": "fec-repair",
+      "depends": ["video"],
+      "repairLayer": 0,
+      "priority": 240
+    },
+    {
+      "name": "video/repair/1",
+      "packaging": "fec-repair",
+      "depends": ["video"],
+      "repairLayer": 1,
+      "repairSymbols": 16,
+      "priority": 244
+    },
+    {
+      "name": "video/repair/2",
+      "packaging": "fec-repair",
+      "depends": ["video"],
+      "repairLayer": 2,
+      "repairSymbols": 32,
+      "priority": 248
+    },
+    {
+      "name": "video/keyframe-repair",
+      "packaging": "fec-repair",
+      "depends": ["video"],
+      "scope": "keyframe",
+      "sourceSymbols": 256,
+      "repairSymbols": 32,
+      "priority": 242
+    },
+    {
+      "name": "audio",
+      "packaging": "mmtp",
+      "codec": "mp4a.40.2",
+      "mmtpMode": "mfu",
+      "timescale": 48000,
+      "groupDurationMs": 1000,
+      "fec": {
+        "algorithm": "raptorq",
+        "blockProfile": "iso-ssbg1-v1",
+        "sourceSymbols": 47,
+        "repairSymbols": 4,
+        "symbolSize": 1312,
+        "interleaveDepthMs": 1000,
+        "repairTrack": "audio-repair"
+      }
+    },
+    {
+      "name": "audio-repair",
+      "packaging": "fec-repair"
+    }
+  ],
+  "multicast": {
+    "endpoints": [
+      {
+        "sourceAddress": "192.0.2.10",
+        "groupAddress": "232.1.1.1",
+        "port": 5000,
+        "tracks": [
+          { "name": "video", "packetId": 1 },
+          { "name": "audio", "packetId": 2 },
+          { "name": "video/repair", "packetId": 3 },
+          { "name": "audio-repair", "packetId": 4 }
+        ]
+      },
+      {
+        "sourceAddress": "192.0.2.10",
+        "groupAddress": "232.1.1.2",
+        "port": 5000,
+        "tracks": [
+          { "name": "video/repair/1", "packetId": 5 },
+          { "name": "video/repair/2", "packetId": 6 },
+          { "name": "video/keyframe-repair", "packetId": 7 }
+        ]
+      }
+    ],
+    "networkSource": [
+      { "type": "amt", "discovery": "driad" }
+    ]
+  }
+}

package/test-vectors/catalog/{negative/fec-block-profile-unknown.json → fec-01-runtime/fec-multicast.json}

@@ -12,10 +12,11 @@
       "groupDurationMs": 1000,
       "fec": {
         "algorithm": "raptorq",
-        "blockProfile": "iso-ssbg1",
+        "blockProfile": "iso-ssbg1-v1",
         "sourceSymbols": 768,
         "repairSymbols": 384,
         "symbolSize": 1312,
+        "interleaveDepthMs": 1000,
         "repairTrack": "video-repair",
         "mode": "interleaved"
       }

package/test-vectors/catalog/fec-01-runtime/multicast-native-ssm-no-network-source.json

@@ -0,0 +1,44 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000,
+      "fec": {
+        "algorithm": "raptorq",
+        "blockProfile": "iso-ssbg1-v1",
+        "sourceSymbols": 768,
+        "repairSymbols": 384,
+        "symbolSize": 1312,
+        "interleaveDepthMs": 1000,
+        "repairTrack": "video-repair",
+        "mode": "interleaved"
+      }
+    },
+    {
+      "name": "video-repair",
+      "packaging": "fec-repair",
+      "priority": 240
+    }
+  ],
+  "multicast": {
+    "endpoints": [
+      {
+        "protocol": "ssm",
+        "sourceAddress": "192.0.2.10",
+        "groupAddress": "232.1.1.1",
+        "port": 5000,
+        "tracks": [
+          { "name": "video", "packetId": 1 },
+          { "name": "video-repair", "packetId": 2 }
+        ]
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/fec-block-profile-missing.json

@@ -10,18 +10,22 @@
       "mmtpMode": "mfu",
       "timescale": 90000,
       "groupDurationMs": 1000,
-      "fec": {
-        "algorithm": "raptorq",
-        "sourceSymbols": 768,
-        "repairSymbols": 384,
-        "symbolSize": 1312,
-        "repairTrack": "video-repair",
-        "mode": "interleaved"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "raptorq",
+          "sourceSymbols": 768,
+          "repairSymbols": 384,
+          "symbolSize": 1312,
+          "repairTrack": "video-repair"
+        }
+      ]
     },
     {
       "name": "video-repair",
       "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
       "priority": 240
     }
   ],
@@ -32,13 +36,22 @@
         "groupAddress": "232.1.1.1",
         "port": 5000,
         "tracks": [
-          { "name": "video", "packetId": 1 },
-          { "name": "video-repair", "packetId": 2 }
+          {
+            "name": "video",
+            "packetId": 1
+          },
+          {
+            "name": "video-repair",
+            "packetId": 2
+          }
         ]
       }
     ],
     "networkSource": [
-      { "type": "amt", "discovery": "driad" },
+      {
+        "type": "amt",
+        "discovery": "driad"
+      },
       {
         "type": "atsc3",
         "frequency": 587000,

package/test-vectors/catalog/negative/fec-iso-symbol-size-below-floor.json

@@ -10,18 +10,23 @@
       "mmtpMode": "mfu",
       "timescale": 90000,
       "groupDurationMs": 1000,
-      "fec": {
-        "algorithm": "raptorq",
-        "blockProfile": "iso-ssbg1-v1",
-        "sourceSymbols": 32,
-        "repairSymbols": 8,
-        "symbolSize": 8,
-        "repairTrack": "video-repair"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "raptorq",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 32,
+          "repairSymbols": 8,
+          "symbolSize": 8,
+          "repairTrack": "video-repair"
+        }
+      ]
     },
     {
       "name": "video-repair",
       "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
       "priority": 240
     }
   ]

package/test-vectors/catalog/negative/fec-reed-solomon-iso-symbol-size-13.json

@@ -10,18 +10,23 @@
       "mmtpMode": "mfu",
       "timescale": 90000,
       "groupDurationMs": 1000,
-      "fec": {
-        "algorithm": "reed-solomon",
-        "blockProfile": "iso-ssbg1-v1",
-        "sourceSymbols": 32,
-        "repairSymbols": 8,
-        "symbolSize": 13,
-        "repairTrack": "video-repair"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "reed-solomon",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 32,
+          "repairSymbols": 8,
+          "symbolSize": 13,
+          "repairTrack": "video-repair"
+        }
+      ]
     },
     {
       "name": "video-repair",
       "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
       "priority": 240
     }
   ]

package/test-vectors/catalog/negative/fec-repair-layer-geometry.json

@@ -10,20 +10,30 @@
       "mmtpMode": "mfu",
       "timescale": 90000,
       "groupDurationMs": 1000,
-      "fec": {
-        "algorithm": "raptorq",
-        "blockProfile": "iso-ssbg1-v1",
-        "sourceSymbols": 64,
-        "repairSymbols": 8,
-        "symbolSize": 1312,
-        "repairTrack": "video/repair"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "raptorq",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 64,
+          "repairSymbols": 8,
+          "symbolSize": 1312,
+          "repairTrack": "video/repair"
+        }
+      ]
+    },
+    {
+      "name": "video/repair",
+      "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
+      "priority": 240
     },
-    { "name": "video/repair", "packaging": "fec-repair", "priority": 240 },
     {
       "name": "video/repair/1",
       "packaging": "fec-repair",
-      "depends": ["video"],
+      "source": "video",
+      "instanceId": 0,
       "repairLayer": 1,
       "repairSymbols": 16,
       "priority": 244,

package/test-vectors/catalog/negative/fec-repair-layer-missing-symbols.json

@@ -10,20 +10,30 @@
       "mmtpMode": "mfu",
       "timescale": 90000,
       "groupDurationMs": 1000,
-      "fec": {
-        "algorithm": "raptorq",
-        "blockProfile": "iso-ssbg1-v1",
-        "sourceSymbols": 64,
-        "repairSymbols": 8,
-        "symbolSize": 1312,
-        "repairTrack": "video/repair"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "raptorq",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 64,
+          "repairSymbols": 8,
+          "symbolSize": 1312,
+          "repairTrack": "video/repair"
+        }
+      ]
+    },
+    {
+      "name": "video/repair",
+      "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
+      "priority": 240
     },
-    { "name": "video/repair", "packaging": "fec-repair", "priority": 240 },
     {
       "name": "video/repair/1",
       "packaging": "fec-repair",
-      "depends": ["video"],
+      "source": "video",
+      "instanceId": 0,
       "repairLayer": 1,
       "priority": 244
     }

package/test-vectors/catalog/negative/fec-repair-overlay-source-symbols-zero.json

@@ -10,33 +10,41 @@
       "mmtpMode": "mfu",
       "timescale": 90000,
       "groupDurationMs": 1000,
-      "fec": {
-        "algorithm": "raptorq",
-        "blockProfile": "iso-ssbg1-v1",
-        "sourceSymbols": 32,
-        "repairSymbols": 8,
-        "symbolSize": 1312,
-        "repairTrack": "video-repair"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "raptorq",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 32,
+          "repairSymbols": 8,
+          "symbolSize": 1312,
+          "repairTrack": "video-repair"
+        },
+        {
+          "instanceId": 1,
+          "scope": "keyframe",
+          "scheme": "raptorq",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 0,
+          "repairSymbols": 32,
+          "symbolSize": 1312,
+          "repairTrack": "video/keyframe-repair"
+        }
+      ]
     },
     {
       "name": "video-repair",
       "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
       "priority": 240,
-      "depends": [
-        "video"
-      ],
       "repairLayer": 0
     },
     {
       "name": "video/keyframe-repair",
       "packaging": "fec-repair",
-      "depends": [
-        "video"
-      ],
-      "scope": "keyframe",
-      "sourceSymbols": 0,
-      "repairSymbols": 32,
+      "source": "video",
+      "instanceId": 1,
       "priority": 242
     }
   ]

package/test-vectors/catalog/negative/fec-repair-symbols-zero.json

@@ -10,18 +10,23 @@
       "mmtpMode": "mfu",
       "timescale": 90000,
       "groupDurationMs": 1000,
-      "fec": {
-        "algorithm": "raptorq",
-        "blockProfile": "iso-ssbg1-v1",
-        "sourceSymbols": 32,
-        "repairSymbols": 0,
-        "symbolSize": 1312,
-        "repairTrack": "video-repair"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "raptorq",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 32,
+          "repairSymbols": 0,
+          "symbolSize": 1312,
+          "repairTrack": "video-repair"
+        }
+      ]
     },
     {
       "name": "video-repair",
       "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
       "priority": 240
     }
   ]