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

package/test-vectors/catalog/positive/multicast-native-ssm-no-network-source.json

@@ -10,20 +10,24 @@
       "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"
-      }
+      "fec": [
+        {
+          "instanceId": 0,
+          "scheme": "raptorq",
+          "blockProfile": "iso-ssbg1-v1",
+          "sourceSymbols": 768,
+          "repairSymbols": 384,
+          "symbolSize": 1312,
+          "interleaveDepthMs": 1000,
+          "repairTrack": "video-repair"
+        }
+      ]
     },
     {
       "name": "video-repair",
       "packaging": "fec-repair",
+      "source": "video",
+      "instanceId": 0,
       "priority": 240
     }
   ],
@@ -35,8 +39,14 @@
         "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
+          }
         ]
       }
     ]

package/test-vectors/catalog/section-codes.json

@@ -1,29 +1,20 @@
 {
-  "description": "What the MMTP/FEC/repair/timing catalog section rejects each negative fixture with. Read by packages/container/src/catalog-schema.test.ts (against validateCmsfMmtpCatalog) and mmt-fec/tests/catalog_section_vectors.rs (against mmt_fec::catalog::validate_tracks): both engines must report the same code at the same JSON path. Every negative fixture is listed exactly once; outOfSection names fields the section does not own, which the embedding catalog validates.",
+  "description": "What the MMTP/timing catalog section rejects each negative fixture with. Read by packages/container/src/catalog-schema.test.ts (against validateCmsfMmtpCatalog) and mmt-fec/tests/catalog_section_vectors.rs (against mmt_fec::catalog::validate_tracks): both engines must report the same code at the same JSON path. Every negative fixture is listed exactly once; outOfSection names fields the section does not own, which the embedding catalog validates. FEC instances, repair and symbol tracks are not in the section: their binding is draft-ramadan-moq-fec-catalog-00's, validated by validateFecCatalog / mmt_fec::fec_catalog against vectors/fec-catalog-00, and no -01 FEC shape is rejected here (BLO-50171).",
   "negative": {
     "archive-origin-with-path.json": { "outOfSection": "archive" },
     "archive-unknown-field.json": { "outOfSection": "archive" },
-    "fec-block-profile-missing.json": { "code": "track_fec_block_profile", "path": "$.tracks[0].fec.blockProfile" },
-    "fec-block-profile-retired.json": { "code": "track_fec_block_profile_unimplemented", "path": "$.tracks[0].fec.blockProfile" },
-    "fec-block-profile-unknown.json": { "code": "track_fec_block_profile_unimplemented", "path": "$.tracks[0].fec.blockProfile" },
-    "fec-enhancement-repair-removed.json": { "code": "track_fec", "path": "$.tracks[0].fec.enhancementRepair" },
-    "fec-iso-symbol-size-below-floor.json": { "code": "track_fec", "path": "$.tracks[0].fec.symbolSize" },
-    "fec-reed-solomon-iso-symbol-size-13.json": { "code": "track_fec", "path": "$.tracks[0].fec.symbolSize" },
-    "fec-reed-solomon-k-plus-p-over-255.json": { "code": "track_fec_bounds", "path": "$.tracks[0].fec.sourceSymbols" },
-    "fec-reed-solomon-overlay-over-255.json": { "code": "track_fec_bounds", "path": "$.tracks[2].repairSymbols" },
-    "fec-repair-layer-geometry.json": { "code": "track_repair_geometry", "path": "$.tracks[2].timescale" },
-    "fec-repair-layer-missing-symbols.json": { "code": "track_repair_layer", "path": "$.tracks[2].repairSymbols" },
-    "fec-repair-multiple-depends.json": { "code": "track_repair_depends", "path": "$.tracks[2].depends" },
-    "fec-repair-overlay-source-symbols-zero.json": { "code": "track_fec_bounds", "path": "$.tracks[2].sourceSymbols" },
-    "fec-repair-overlay-with-layer.json": { "code": "track_repair_overlay", "path": "$.tracks[2].repairLayer" },
-    "fec-repair-priority-out-of-band.json": { "code": "track_repair_priority", "path": "$.tracks[1].priority" },
-    "fec-repair-source-symbols-without-scope.json": { "code": "track_repair_overlay", "path": "$.tracks[2].sourceSymbols" },
-    "fec-repair-symbols-zero.json": { "code": "track_fec", "path": "$.tracks[0].fec.repairSymbols" },
-    "fec-source-symbols-zero.json": { "code": "track_fec", "path": "$.tracks[0].fec.sourceSymbols" },
-    "fec-symbol-size-zero.json": { "code": "track_fec", "path": "$.tracks[0].fec.symbolSize" },
+    "fec-block-profile-missing.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-iso-symbol-size-below-floor.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-reed-solomon-iso-symbol-size-13.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-repair-layer-geometry.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-repair-layer-missing-symbols.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-repair-overlay-source-symbols-zero.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-repair-symbols-zero.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-source-symbols-zero.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "fec-symbol-size-zero.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
     "init-data-inline-without-data.json": { "outOfSection": "root initDataList" },
     "legacy-selection-params.json": { "outOfSection": "common track field selectionParams" },
-    "media-track-repair-layer.json": { "code": "track_repair_layer", "path": "$.tracks[0].repairLayer" },
+    "media-track-repair-layer.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
     "missing-mmtp-fields.json": { "code": "track_mmtp_mode", "path": "$.tracks[0].mmtpMode" },
     "mmtp-mode-mpu.json": { "code": "track_mmtp_mode", "path": "$.tracks[0].mmtpMode" },
     "multicast-amt-dns-without-relay.json": { "outOfSection": "multicast" },
@@ -54,8 +45,8 @@
     "multicast-packet-id-signaling.json": { "outOfSection": "multicast" },
     "network-source-object.json": { "outOfSection": "multicast" },
     "presentation-anchor-unsafe.json": { "code": "track_presentation_anchor", "path": "$.tracks[0].presentationAnchorTicks" },
-    "raptorq-source-symbols-over-max.json": { "code": "track_fec_bounds", "path": "$.tracks[0].fec.sourceSymbols" },
-    "raptorq-unaligned-symbol.json": { "code": "track_fec", "path": "$.tracks[0].fec.symbolSize" },
+    "raptorq-source-symbols-over-max.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
+    "raptorq-unaligned-symbol.json": { "outOfSection": "FEC binding (validateFecCatalog; receiver outcomes in vectors/fec-catalog-00)" },
     "repair-track-legacy-shape.json": { "outOfSection": "the packaging value set (common track field)" },
     "track-role-empty.json": { "outOfSection": "common track field trackRole" },
     "track-role-non-string.json": { "outOfSection": "common track field trackRole" }

package/test-vectors/catalog-timing.json

@@ -316,7 +316,7 @@
       },
       "expect": {
         "interleaveMs": 0,
-        "unavailable": "track_fec"
+        "unavailable": "fec_member"
       }
     },
     {
@@ -326,7 +326,7 @@
       },
       "expect": {
         "interleaveMs": 0,
-        "unavailable": "track_fec"
+        "unavailable": "fec_member"
       }
     },
     {

package/test-vectors/catalog-validation.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "Canonical accept/reject and FEC block budget (span + reorderToleranceMs, fec-01 §9) vectors. Auth validation is intentionally out of scope.",
+  "$comment": "Canonical accept/reject and FEC block budget (interleaveDepthMs + reorderToleranceMs of instance 0) vectors. FEC binding rules (draft-ramadan-moq-fec-catalog-00 5) are validateFecCatalog's, pinned by vectors/fec-catalog-00. Auth validation is intentionally out of scope.",
   "version": 1,
   "cases": [
     {
@@ -18,20 +18,25 @@
             "timescale": 90000,
             "groupDurationMs": 4000,
             "groupDurationTicks": 360000,
-            "fec": {
-              "algorithm": "raptorq",
-              "blockProfile": "iso-ssbg1-v1",
-              "sourceSymbols": 32,
-              "repairSymbols": 8,
-              "symbolSize": 1320,
-              "interleaveDepthMs": 133,
-              "reorderToleranceMs": 40,
-              "repairTrack": "video/repair"
-            }
+            "fec": [
+              {
+                "instanceId": 0,
+                "scheme": "raptorq",
+                "blockProfile": "iso-ssbg1-v1",
+                "sourceSymbols": 32,
+                "repairSymbols": 8,
+                "symbolSize": 1320,
+                "interleaveDepthMs": 133,
+                "reorderToleranceMs": 40,
+                "repairTrack": "video/repair"
+              }
+            ]
           },
           {
             "name": "video/repair",
             "packaging": "fec-repair",
+            "source": "video",
+            "instanceId": 0,
             "isLive": true,
             "priority": 240
           }
@@ -165,155 +170,6 @@
         ]
       }
     },
-    {
-      "name": "incomplete active FEC",
-      "valid": false,
-      "error_code": "track_fec",
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 4000,
-            "fec": {
-              "algorithm": "raptorq",
-              "blockProfile": "iso-ssbg1-v1",
-              "sourceSymbols": 32
-            }
-          }
-        ]
-      }
-    },
-    {
-      "name": "disabled FEC needs no repair geometry",
-      "valid": true,
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 4000,
-            "fec": {
-              "algorithm": "none"
-            }
-          }
-        ]
-      }
-    },
-    {
-      "name": "FEC instance without a block profile",
-      "valid": false,
-      "error_code": "track_fec_block_profile",
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 4000,
-            "groupDurationTicks": 360000,
-            "fec": {
-              "algorithm": "raptorq",
-              "sourceSymbols": 32,
-              "repairSymbols": 8,
-              "symbolSize": 1320,
-              "interleaveDepthMs": 133,
-              "repairTrack": "video/repair"
-            }
-          },
-          {
-            "name": "video/repair",
-            "packaging": "fec-repair",
-            "isLive": true,
-            "priority": 240
-          }
-        ]
-      }
-    },
-    {
-      "name": "unknown FEC block profile",
-      "valid": false,
-      "error_code": "track_fec_block_profile_unimplemented",
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 4000,
-            "groupDurationTicks": 360000,
-            "fec": {
-              "algorithm": "raptorq",
-              "blockProfile": "iso-ssbg1",
-              "sourceSymbols": 32,
-              "repairSymbols": 8,
-              "symbolSize": 1320,
-              "interleaveDepthMs": 133,
-              "repairTrack": "video/repair"
-            }
-          },
-          {
-            "name": "video/repair",
-            "packaging": "fec-repair",
-            "isLive": true,
-            "priority": 240
-          }
-        ]
-      }
-    },
-    {
-      "name": "retired k-padded-v1 block profile",
-      "valid": false,
-      "error_code": "track_fec_block_profile_unimplemented",
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 4000,
-            "groupDurationTicks": 360000,
-            "fec": {
-              "algorithm": "raptorq",
-              "blockProfile": "k-padded-v1",
-              "sourceSymbols": 32,
-              "repairSymbols": 8,
-              "symbolSize": 1320,
-              "interleaveDepthMs": 133,
-              "repairTrack": "video/repair"
-            }
-          },
-          {
-            "name": "video/repair",
-            "packaging": "fec-repair",
-            "isLive": true,
-            "priority": 240
-          }
-        ]
-      }
-    },
     {
       "name": "ISO ssbg_mode1 block profile",
       "valid": true,
@@ -329,71 +185,30 @@
             "timescale": 90000,
             "groupDurationMs": 4000,
             "groupDurationTicks": 360000,
-            "fec": {
-              "algorithm": "raptorq",
-              "blockProfile": "iso-ssbg1-v1",
-              "sourceSymbols": 32,
-              "repairSymbols": 8,
-              "symbolSize": 1320,
-              "interleaveDepthMs": 133,
-              "repairTrack": "video/repair"
-            }
+            "fec": [
+              {
+                "instanceId": 0,
+                "scheme": "raptorq",
+                "blockProfile": "iso-ssbg1-v1",
+                "sourceSymbols": 32,
+                "repairSymbols": 8,
+                "symbolSize": 1320,
+                "interleaveDepthMs": 133,
+                "repairTrack": "video/repair"
+              }
+            ]
           },
           {
             "name": "video/repair",
             "packaging": "fec-repair",
+            "source": "video",
+            "instanceId": 0,
             "isLive": true,
             "priority": 240
           }
         ]
       }
     },
-    {
-      "name": "disabled FEC with an unknown block profile",
-      "valid": false,
-      "error_code": "track_fec_block_profile_unimplemented",
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 4000,
-            "fec": {
-              "algorithm": "none",
-              "blockProfile": "k-padded"
-            }
-          }
-        ]
-      }
-    },
-    {
-      "name": "legacy interleave alias",
-      "valid": false,
-      "error_code": "track_fec",
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 4000,
-            "fec": {
-              "algorithm": "none",
-              "interleaveDepth": 4
-            }
-          }
-        ]
-      }
-    },
     {
       "name": "rejects retired commonTrackFields inheritance",
       "valid": false,
@@ -453,34 +268,6 @@
         ]
       }
     },
-    {
-      "name": "dangling FEC repair track",
-      "valid": false,
-      "error_code": "track_repair_track",
-      "catalog": {
-        "version": 1,
-        "tracks": [
-          {
-            "name": "video",
-            "packaging": "mmtp",
-            "isLive": true,
-            "codec": "avc1.640028",
-            "mmtpMode": "mfu",
-            "timescale": 90000,
-            "groupDurationMs": 1000,
-            "fec": {
-              "algorithm": "raptorq",
-              "blockProfile": "iso-ssbg1-v1",
-              "sourceSymbols": 32,
-              "repairSymbols": 8,
-              "symbolSize": 1320,
-              "interleaveDepthMs": 133,
-              "repairTrack": "video/repair"
-            }
-          }
-        ]
-      }
-    },
     {
       "name": "misaligned switching set",
       "valid": false,

package/test-vectors/catalog/negative/fec-enhancement-repair-removed.json

@@ -1,28 +0,0 @@
-{
-  "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,
-        "repairTrack": "video/repair",
-        "enhancementRepair": [
-          { "repairTrack": "video/repair/1", "repairSymbols": 16 }
-        ]
-      }
-    },
-    { "name": "video/repair", "packaging": "fec-repair", "priority": 240 },
-    { "name": "video/repair/1", "packaging": "fec-repair", "priority": 240 }
-  ]
-}

package/test-vectors/catalog/negative/fec-reed-solomon-k-plus-p-over-255.json

@@ -1,39 +0,0 @@
-{
-  "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": {
-        "blockProfile": "iso-ssbg1-v1",
-        "symbolSize": 1316,
-        "interleaveDepthMs": 1000,
-        "repairTrack": "video/repair",
-        "algorithm": "reed-solomon",
-        "sourceSymbols": 200,
-        "repairSymbols": 15
-      }
-    },
-    {
-      "name": "video/repair",
-      "packaging": "fec-repair",
-      "priority": 240
-    },
-    {
-      "name": "video/repair/1",
-      "packaging": "fec-repair",
-      "depends": [
-        "video"
-      ],
-      "repairLayer": 1,
-      "repairSymbols": 41,
-      "priority": 244
-    }
-  ]
-}

package/test-vectors/catalog/negative/fec-reed-solomon-overlay-over-255.json

@@ -1,40 +0,0 @@
-{
-  "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": {
-        "blockProfile": "iso-ssbg1-v1",
-        "symbolSize": 1316,
-        "interleaveDepthMs": 1000,
-        "repairTrack": "video/repair",
-        "algorithm": "reed-solomon",
-        "sourceSymbols": 32,
-        "repairSymbols": 8
-      }
-    },
-    {
-      "name": "video/repair",
-      "packaging": "fec-repair",
-      "priority": 240
-    },
-    {
-      "name": "video/keyframe-repair",
-      "packaging": "fec-repair",
-      "depends": [
-        "video"
-      ],
-      "scope": "keyframe",
-      "sourceSymbols": 224,
-      "repairSymbols": 32,
-      "priority": 242
-    }
-  ]
-}

package/test-vectors/catalog/negative/fec-repair-multiple-depends.json

@@ -1,32 +0,0 @@
-{
-  "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,
-        "repairTrack": "video/repair"
-      }
-    },
-    { "name": "video/repair", "packaging": "fec-repair", "priority": 240 },
-    {
-      "name": "video/repair/1",
-      "packaging": "fec-repair",
-      "depends": ["video", "audio"],
-      "repairLayer": 1,
-      "repairSymbols": 16,
-      "priority": 244
-    }
-  ]
-}

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

@@ -1,34 +0,0 @@
-{
-  "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,
-        "repairTrack": "video/repair"
-      }
-    },
-    { "name": "video/repair", "packaging": "fec-repair", "priority": 240 },
-    {
-      "name": "video/keyframe-repair",
-      "packaging": "fec-repair",
-      "depends": ["video"],
-      "scope": "keyframe",
-      "repairLayer": 1,
-      "sourceSymbols": 256,
-      "repairSymbols": 32,
-      "priority": 242
-    }
-  ]
-}

package/test-vectors/catalog/negative/fec-repair-priority-out-of-band.json

@@ -1,24 +0,0 @@
-{
-  "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,
-        "repairTrack": "video/repair"
-      }
-    },
-    { "name": "video/repair", "packaging": "fec-repair", "priority": 100 }
-  ]
-}