@blockcast/mmt-container 0.1.0-main.149f78a4adae

package/test-vectors/align.json

@@ -0,0 +1,199 @@
+{
+  "$comment": [
+    "Cross-language test vectors for group alignment and MMTP subgroup keys.",
+    "",
+    "Every sibling implementation (Go cmd/caddy/sender/group_align.go,",
+    "Rust apps/relay/src/server/abr.rs, TS packages/container/src/align.ts)",
+    "loads this file and asserts its own groupId/driftCheck output matches.",
+    "Any formula change in any language that drifts from this fixture must",
+    "fail CI.",
+    "",
+    "When adding a vector, prefer values that exercise a boundary (exact",
+    "tick, 1-off, negative, large-int near 2^53, prime divisor) rather",
+    "than arbitrary numbers."
+  ],
+  "version": 1,
+  "group_id": [
+    {
+      "name": "t=0 → 0",
+      "ticks": 0,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 0
+    },
+    {
+      "name": "90kHz, dur=4s: 3.9s before boundary → 0",
+      "ticks": 351000,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 0
+    },
+    {
+      "name": "90kHz, dur=4s: exact boundary at 4s → 1",
+      "ticks": 360000,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 1
+    },
+    {
+      "name": "90kHz, dur=4s: 4s + 1 tick → 1",
+      "ticks": 360001,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 1
+    },
+    {
+      "name": "90kHz, dur=4s: second boundary at 8s → 2",
+      "ticks": 720000,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 2
+    },
+    {
+      "name": "48kHz audio, dur=4s: aligned at 192000 ticks → 1",
+      "ticks": 192000,
+      "group_duration_ticks": 192000,
+      "expected_group_id": 1
+    },
+    {
+      "name": "negative clamps to 0 (base-clamp)",
+      "ticks": -1,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 0
+    },
+    {
+      "name": "large negative clamps to 0 (epoch skew)",
+      "ticks": -9000000,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 0
+    },
+    {
+      "name": "1kHz, dur=2s: 10s → 5",
+      "ticks": 10000,
+      "group_duration_ticks": 2000,
+      "expected_group_id": 5
+    },
+    {
+      "name": "1kHz, dur=2s: 10s + 1 tick → 5 (still in bucket 5)",
+      "ticks": 10001,
+      "group_duration_ticks": 2000,
+      "expected_group_id": 5
+    },
+    {
+      "name": "1kHz, dur=2s: 12s → 6",
+      "ticks": 12000,
+      "group_duration_ticks": 2000,
+      "expected_group_id": 6
+    },
+    {
+      "name": "prime divisor (dur=7): ticks=13 → 1",
+      "ticks": 13,
+      "group_duration_ticks": 7,
+      "expected_group_id": 1
+    },
+    {
+      "name": "prime divisor (dur=7): ticks=14 → 2 (exact boundary)",
+      "ticks": 14,
+      "group_duration_ticks": 7,
+      "expected_group_id": 2
+    },
+    {
+      "name": "prime divisor (dur=7): ticks=15 → 2",
+      "ticks": 15,
+      "group_duration_ticks": 7,
+      "expected_group_id": 2
+    },
+    {
+      "name": "large-int (24h @ 90kHz): 7_776_000_000 ticks, dur=4s → 21600",
+      "ticks": 7776000000,
+      "group_duration_ticks": 360000,
+      "expected_group_id": 21600
+    },
+    {
+      "name": "near MAX_SAFE_INTEGER (TS=2^52, dur=2): ticks=2^52 → 2^51",
+      "ticks": 4503599627370496,
+      "group_duration_ticks": 2,
+      "expected_group_id": 2251799813685248
+    }
+  ],
+  "drift": [
+    {
+      "name": "aligned",
+      "expected": 5,
+      "actual": 5,
+      "expected_kind": "aligned",
+      "expected_delta_groups": 0
+    },
+    {
+      "name": "ahead by 1",
+      "expected": 5,
+      "actual": 6,
+      "expected_kind": "drifted",
+      "expected_delta_groups": 1
+    },
+    {
+      "name": "behind by 2",
+      "expected": 5,
+      "actual": 3,
+      "expected_kind": "drifted",
+      "expected_delta_groups": -2
+    },
+    {
+      "name": "large gap",
+      "expected": 100,
+      "actual": 142,
+      "expected_kind": "drifted",
+      "expected_delta_groups": 42
+    },
+    {
+      "name": "zero-zero aligned (off-by-one hot spot)",
+      "expected": 0,
+      "actual": 0,
+      "expected_kind": "aligned",
+      "expected_delta_groups": 0
+    },
+    {
+      "name": "large negative delta",
+      "expected": 1000,
+      "actual": 5,
+      "expected_kind": "drifted",
+      "expected_delta_groups": -995
+    }
+  ],
+  "subgroup_key": [
+    {
+      "name": "MPU metadata always uses subgroup 0",
+      "kind": "mpu-metadata",
+      "expected_subgroup": 0,
+      "expected_key": "metadata:0"
+    },
+    {
+      "name": "timed MFU key keeps movie fragment and sample coordinates",
+      "kind": "timed",
+      "movie_fragment_sequence_number": 7,
+      "sample_number": 19,
+      "expected_key": "timed:7:19"
+    },
+    {
+      "name": "timed MFU key does not alias the next movie fragment",
+      "kind": "timed",
+      "movie_fragment_sequence_number": 8,
+      "sample_number": 1,
+      "expected_key": "timed:8:1"
+    },
+    {
+      "name": "timed MFU preserves maximum uint32 coordinates",
+      "kind": "timed",
+      "movie_fragment_sequence_number": 4294967295,
+      "sample_number": 4294967295,
+      "expected_key": "timed:4294967295:4294967295"
+    },
+    {
+      "name": "non-timed MFU key is Item_ID",
+      "kind": "non-timed",
+      "item_id": 42,
+      "expected_key": "non-timed:42"
+    },
+    {
+      "name": "non-timed MFU preserves maximum uint32 Item_ID",
+      "kind": "non-timed",
+      "item_id": 4294967295,
+      "expected_key": "non-timed:4294967295"
+    }
+  ]
+}

package/test-vectors/catalog/README.md

@@ -0,0 +1,25 @@
+# Golden MMTP catalog fixtures
+
+These files define the strict catalog shape emitted by new publishers. The
+catalog itself is delivered on a MoQ track whose track name is exactly
+`catalog`; aliases such as `catalog.json` and `.catalog` are not conformant.
+
+Positive fixtures MUST validate against `schemas/catalog.schema.json`.
+Negative fixtures are the migration worklist and MUST fail:
+
+- `legacy-selection-params.json`: rendition fields must be flat.
+- `missing-mmtp-fields.json`: MMTP tracks require mode, timescale, and duration.
+- `network-source-object.json`: `networkSource` is always an array.
+- `repair-track-legacy-shape.json`: repair tracks use `fec-repair` and priority 240.
+
+An omitted `fec.interleaveDepthMs` means one group (`D=1`); it does not disable
+FEC. When present, `groupDurationTicks` overrides the integer millisecond field.
+Switching sets compare `ticks / timescale`, so equal wall-clock durations at
+different timescales are valid.
+
+`releases/moqcast-native-v16-v1/catalog.json` is copied byte-for-byte from the
+`moqcast-native-v16-v1` release in `Blockcast/hang-mmt-fec`. The adjacent
+archive checksum pins the content-addressed release asset; CI downloads that
+asset from the byte-identical `libmmt` consumer mirror, checks the archive
+digest, and compares the extracted catalog bytes to the committed fixture
+before validating it.

package/test-vectors/catalog/negative/legacy-selection-params.json

@@ -0,0 +1,15 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "selectionParams": { "codec": "avc1.640028" },
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ]
+}

package/test-vectors/catalog/negative/missing-mmtp-fields.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028"
+    }
+  ]
+}

package/test-vectors/catalog/negative/multicast-auth-padded-key.json

@@ -0,0 +1,37 @@
+{
+  "version": 1,
+  "tracks": [
+    {
+      "name": "video/base",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "video/manifest",
+      "packaging": "mmtp",
+      "codec": "application/x-bc-provenance",
+      "mmtpMode": "mfu",
+      "timescale": 1000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast.auth": {
+    "scheme": "bc-provenance",
+    "hash": "blake3",
+    "sig": "ed25519",
+    "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg=",
+    "keyId": "2026-08",
+    "compaction": "merkle",
+    "tracks": [
+      {
+        "mediaTrack": "video/base",
+        "manifestTrack": "video/manifest",
+        "authScope": "vzeasoXcabuvmWJ2X9DmT_z0gU381kdYRVwL0RAuhok",
+        "sourceSymbolFormat": "full-mmtp-packet"
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-auth-reused-track-format.json

@@ -0,0 +1,53 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video/base",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "video/manifest",
+      "packaging": "mmtp",
+      "codec": "application/x-bc-provenance",
+      "mmtpMode": "mfu",
+      "timescale": 1000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "video/alternate-manifest",
+      "packaging": "mmtp",
+      "codec": "application/x-bc-provenance",
+      "mmtpMode": "mfu",
+      "timescale": 1000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast.auth": {
+    "scheme": "bc-provenance",
+    "hash": "blake3",
+    "sig": "ed25519",
+    "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+    "keyId": "2026-08",
+    "compaction": "merkle",
+    "tracks": [
+      {
+        "mediaTrack": "video/base",
+        "manifestTrack": "video/manifest",
+        "authScope": "vzeasoXcabuvmWJ2X9DmT_z0gU381kdYRVwL0RAuhok",
+        "sourceSymbolFormat": "full-mmtp-packet"
+      },
+      {
+        "mediaTrack": "video/base",
+        "manifestTrack": "video/alternate-manifest",
+        "authScope": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+        "sourceSymbolFormat": "full-mmtp-packet"
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-auth-trailing-pad-bits.json

@@ -0,0 +1,37 @@
+{
+  "version": 1,
+  "tracks": [
+    {
+      "name": "video/base",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "video/manifest",
+      "packaging": "mmtp",
+      "codec": "application/x-bc-provenance",
+      "mmtpMode": "mfu",
+      "timescale": 1000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast.auth": {
+    "scheme": "bc-provenance",
+    "hash": "blake3",
+    "sig": "ed25519",
+    "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbh",
+    "keyId": "2026-08",
+    "compaction": "merkle",
+    "tracks": [
+      {
+        "mediaTrack": "video/base",
+        "manifestTrack": "video/manifest",
+        "authScope": "vzeasoXcabuvmWJ2X9DmT_z0gU381kdYRVwL0RAuhok",
+        "sourceSymbolFormat": "full-mmtp-packet"
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-endpoint-missing-protocol-and-source.json

@@ -0,0 +1,24 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "endpoints": [
+      {
+        "groupAddress": "232.1.1.1",
+        "port": 5000,
+        "tracks": [{ "name": "video", "packetId": 1 }]
+      }
+    ],
+    "networkSource": "direct"
+  }
+}

package/test-vectors/catalog/negative/network-source-object.json

@@ -0,0 +1,25 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "endpoints": [
+      {
+        "protocol": "asm",
+        "groupAddress": "239.1.1.1",
+        "port": 5000,
+        "tracks": [{ "name": "video", "packetId": 1 }]
+      }
+    ],
+    "networkSource": { "type": "amt", "discovery": "driad" }
+  }
+}

package/test-vectors/catalog/negative/raptorq-unaligned-symbol.json

@@ -0,0 +1,26 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000,
+      "fec": {
+        "algorithm": "raptorq",
+        "sourceSymbols": 32,
+        "repairSymbols": 8,
+        "symbolSize": 1310,
+        "repairTrack": "video-repair"
+      }
+    },
+    {
+      "name": "video-repair",
+      "packaging": "fec-repair",
+      "priority": 240
+    }
+  ]
+}

package/test-vectors/catalog/negative/repair-track-legacy-shape.json

@@ -0,0 +1,18 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "video-repair",
+      "packaging": "fec-repair"
+    }
+  ]
+}

package/test-vectors/catalog/negative/track-role-empty.json

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "trackRole": "",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ]
+}

package/test-vectors/catalog/negative/track-role-non-string.json

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "trackRole": 1,
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ]
+}

package/test-vectors/catalog/positive/fec-multicast.json

@@ -0,0 +1,51 @@
+{
+  "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",
+        "sourceSymbols": 768,
+        "repairSymbols": 384,
+        "symbolSize": 1312,
+        "repairTrack": "video-repair",
+        "mode": "interleaved"
+      }
+    },
+    {
+      "name": "video-repair",
+      "packaging": "fec-repair",
+      "priority": 240
+    }
+  ],
+  "multicast": {
+    "endpoints": [
+      {
+        "sourceAddress": "192.0.2.10",
+        "groupAddress": "232.1.1.1",
+        "port": 5000,
+        "tracks": [
+          { "name": "video", "packetId": 1 },
+          { "name": "video-repair", "packetId": 2 }
+        ]
+      }
+    ],
+    "networkSource": [
+      { "type": "amt", "discovery": "driad" },
+      {
+        "type": "atsc3",
+        "frequency": 587000000,
+        "plpId": 0,
+        "serviceId": 101,
+        "slsUri": "https://example.test/atsc3/service/101/sls.xml"
+      }
+    ]
+  }
+}

package/test-vectors/catalog/positive/flat-av.json

@@ -0,0 +1,30 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "isLive": true,
+      "codec": "avc1.640028",
+      "framerate": 30,
+      "width": 1920,
+      "height": 1080,
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "audio",
+      "packaging": "mmtp",
+      "isLive": true,
+      "codec": "mp4a.40.2",
+      "samplerate": 48000,
+      "channelConfig": "2",
+      "mmtpMode": "mfu",
+      "timescale": 48000,
+      "groupDurationMs": 1000
+    }
+  ]
+}

package/test-vectors/catalog/positive/multicast-auth-rotation.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-00",
+  "tracks": [
+    {
+      "name": "video/base",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "video/manifest",
+      "packaging": "mmtp",
+      "codec": "application/x-bc-provenance",
+      "mmtpMode": "mfu",
+      "timescale": 1000,
+      "groupDurationMs": 1000
+    },
+    {
+      "name": "video/recovery-manifest",
+      "packaging": "mmtp",
+      "codec": "application/x-bc-provenance",
+      "mmtpMode": "mfu",
+      "timescale": 1000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast.auth": {
+    "scheme": "bc-provenance",
+    "hash": "blake3",
+    "sig": "ed25519",
+    "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+    "keyId": "2026-08",
+    "previousKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+    "compaction": "merkle",
+    "enforcement": "shadow",
+    "tracks": [
+      {
+        "mediaTrack": "video/base",
+        "manifestTrack": "video/manifest",
+        "authScope": "vzeasoXcabuvmWJ2X9DmT_z0gU381kdYRVwL0RAuhok",
+        "sourceSymbolFormat": "full-mmtp-packet"
+      },
+      {
+        "mediaTrack": "video/base",
+        "manifestTrack": "video/recovery-manifest",
+        "authScope": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+        "sourceSymbolFormat": "fec-padded-recovery"
+      }
+    ]
+  }
+}