@blockcast/mmt-container 0.3.0 → 0.4.0-main.71d61b2a53f2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -16
- package/dist/browser-runtime.js +14743 -14412
- package/dist/browser-runtime.js.map +4 -4
- package/dist/carp-catalog.d.ts +24 -19
- package/dist/carp-catalog.d.ts.map +1 -1
- package/dist/carp-catalog.js +29 -14
- package/dist/carp-catalog.js.map +4 -4
- package/dist/catalog-fec-params.d.ts +88 -28
- package/dist/catalog-fec-params.d.ts.map +1 -1
- package/dist/catalog-fec-params.js +60 -23
- package/dist/catalog-fec-params.js.map +4 -4
- package/dist/catalog-network-source.js +1 -7
- package/dist/catalog-network-source.js.map +4 -4
- package/dist/cmaf-block-assembler.d.ts +0 -2
- package/dist/cmaf-block-assembler.d.ts.map +1 -1
- package/dist/cmaf-block-assembler.js +0 -1
- package/dist/cmaf-block-assembler.js.map +2 -2
- package/dist/cmcd-producer.d.ts.map +1 -1
- package/dist/cmcd-producer.js +0 -4
- package/dist/cmcd-producer.js.map +2 -2
- package/dist/delivery-catalog.d.ts +124 -0
- package/dist/delivery-catalog.d.ts.map +1 -0
- package/dist/delivery-catalog.js +1857 -0
- package/dist/delivery-catalog.js.map +7 -0
- package/dist/delta-fallback-config.d.ts +42 -0
- package/dist/delta-fallback-config.d.ts.map +1 -0
- package/dist/delta-fallback-config.js +59 -0
- package/dist/delta-fallback-config.js.map +7 -0
- package/dist/fec-manager.d.ts +36 -30
- package/dist/fec-manager.d.ts.map +1 -1
- package/dist/fec-manager.js +303 -293
- package/dist/fec-manager.js.map +4 -4
- package/dist/fec-state.d.ts +19 -31
- package/dist/fec-state.d.ts.map +1 -1
- package/dist/fec-state.js +4 -10
- package/dist/fec-state.js.map +4 -4
- package/dist/fec-worker-setup.d.ts +18 -14
- package/dist/fec-worker-setup.d.ts.map +1 -1
- package/dist/fec-worker-setup.js +81 -96
- package/dist/fec-worker-setup.js.map +4 -4
- package/dist/index.d.ts +5 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +16 -0
- package/dist/index.js.map +2 -2
- package/dist/iso-block-locator.js +1 -7
- package/dist/iso-block-locator.js.map +4 -4
- package/dist/media-router.d.ts +20 -8
- package/dist/media-router.d.ts.map +1 -1
- package/dist/media-router.js +46 -21
- package/dist/media-router.js.map +2 -2
- package/dist/mfu-reassembler.js +24 -30
- package/dist/mfu-reassembler.js.map +4 -4
- package/dist/mmtp-container-parser.d.ts +6 -11
- package/dist/mmtp-container-parser.d.ts.map +1 -1
- package/dist/mmtp-container-parser.js +56 -97
- package/dist/mmtp-container-parser.js.map +4 -4
- package/dist/mmtp-container-parser.no-modules.js +78 -105
- package/dist/mmtp-container-parser.no-modules.js.map +4 -4
- package/dist/mmtp-decode-pipeline.js +56 -97
- package/dist/mmtp-decode-pipeline.js.map +4 -4
- package/dist/mmtp-router.d.ts +37 -26
- package/dist/mmtp-router.d.ts.map +1 -1
- package/dist/mmtp-router.js +162 -313
- package/dist/mmtp-router.js.map +4 -4
- package/dist/multicast-input.js +1 -7
- package/dist/multicast-input.js.map +4 -4
- package/dist/multicast-manager.d.ts +34 -6
- package/dist/multicast-manager.d.ts.map +1 -1
- package/dist/multicast-manager.js +709 -658
- package/dist/multicast-manager.js.map +4 -4
- package/dist/multicast-transport.d.ts +1 -1
- package/dist/multicast-transport.d.ts.map +1 -1
- package/dist/multicast-transport.js +44 -26
- package/dist/multicast-transport.js.map +4 -4
- package/dist/multicast-unwrap.js +29 -35
- package/dist/multicast-unwrap.js.map +4 -4
- package/dist/no-modules.js +77 -104
- package/dist/no-modules.js.map +4 -4
- package/dist/repair-fetch.d.ts +30 -19
- package/dist/repair-fetch.d.ts.map +1 -1
- package/dist/repair-fetch.js +33 -24
- package/dist/repair-fetch.js.map +4 -4
- package/dist/repair-layers.d.ts +18 -7
- package/dist/repair-layers.d.ts.map +1 -1
- package/dist/repair-layers.js +12 -10
- package/dist/repair-layers.js.map +4 -4
- package/dist/signaling.js +2 -11
- package/dist/signaling.js.map +4 -4
- package/dist/timestamp-codec.js +24 -30
- package/dist/timestamp-codec.js.map +4 -4
- package/dist/track-session.d.ts +7 -0
- package/dist/track-session.d.ts.map +1 -1
- package/dist/track-session.js +15 -8
- package/dist/track-session.js.map +2 -2
- package/dist/wasm-mfu-reassembler.js +1 -7
- package/dist/wasm-mfu-reassembler.js.map +4 -4
- package/dist/wasm-mmtp-container-parser.js +56 -97
- package/dist/wasm-mmtp-container-parser.js.map +4 -4
- package/package.json +7 -14
- package/schemas/catalog.schema.json +3 -3
- package/src/carp-catalog.ts +46 -24
- package/src/catalog-fec-params.ts +173 -64
- package/src/cmaf-block-assembler.ts +1 -4
- package/src/cmcd-producer.ts +0 -6
- package/src/delivery-catalog.ts +498 -0
- package/src/delta-fallback-config.ts +72 -0
- package/src/fec-manager.ts +414 -334
- package/src/fec-state.ts +20 -32
- package/src/fec-worker-setup.ts +109 -90
- package/src/index.ts +32 -0
- package/src/media-router.ts +59 -21
- package/src/mmtp-container-parser.ts +27 -18
- package/src/mmtp-router.ts +146 -313
- package/src/multicast-manager.ts +184 -83
- package/src/multicast-transport.ts +16 -9
- package/src/repair-fetch.ts +46 -27
- package/src/repair-layers.ts +28 -8
- package/src/track-session.ts +28 -9
- package/test-vectors/catalog/README.md +37 -17
- package/test-vectors/catalog/negative/fec-block-profile-retired.json +52 -0
- package/test-vectors/catalog/negative/fec-enhancement-repair-removed.json +1 -1
- package/test-vectors/catalog/negative/fec-repair-layer-geometry.json +1 -1
- package/test-vectors/catalog/negative/fec-repair-layer-missing-symbols.json +1 -1
- package/test-vectors/catalog/negative/fec-repair-multiple-depends.json +1 -1
- package/test-vectors/catalog/negative/fec-repair-overlay-with-layer.json +1 -1
- package/test-vectors/catalog/negative/fec-repair-priority-out-of-band.json +1 -1
- package/test-vectors/catalog/negative/fec-repair-source-symbols-without-scope.json +1 -1
- package/test-vectors/catalog/negative/multicast-endpoint-relay-address.json +39 -0
- package/test-vectors/catalog/negative/multicast-network-source-empty.json +1 -1
- package/test-vectors/catalog/negative/raptorq-source-symbols-over-max.json +1 -1
- package/test-vectors/catalog/negative/raptorq-unaligned-symbol.json +1 -1
- package/test-vectors/catalog/positive/fec-layered-repair.json +2 -2
- package/test-vectors/catalog/positive/fec-multicast.json +2 -1
- package/test-vectors/catalog/positive/multicast-amt-manual-relay.json +38 -0
- package/test-vectors/catalog/positive/multicast-native-ssm-no-network-source.json +2 -1
- package/test-vectors/catalog-timing.json +356 -0
- package/test-vectors/catalog-validation.json +40 -5
- package/test-vectors/delivery-catalog/README.md +11 -0
- package/test-vectors/delivery-catalog/negative/missing-block-profile.json +58 -0
- package/test-vectors/delivery-catalog/negative/packet-id-signaling.json +59 -0
- package/test-vectors/delivery-catalog/negative/retired-k-padded-block-profile.json +59 -0
- package/test-vectors/delivery-catalog/positive/dash.json +56 -0
- package/test-vectors/delivery-catalog/positive/mmtp-source-only.json +43 -0
- package/node_modules/@blockcast/fec-worker/README.md +0 -223
- package/node_modules/@blockcast/fec-worker/dist/.build-stamp +0 -0
- package/node_modules/@blockcast/fec-worker/dist/block-order.d.ts +0 -38
- package/node_modules/@blockcast/fec-worker/dist/block-order.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/block-order.js +0 -78
- package/node_modules/@blockcast/fec-worker/dist/block-order.js.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-client.d.ts +0 -93
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-client.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-client.js +0 -346
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-client.js.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-types.d.ts +0 -380
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-types.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-types.js +0 -11
- package/node_modules/@blockcast/fec-worker/dist/fec-worker-types.js.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/fec-worker.d.ts +0 -14
- package/node_modules/@blockcast/fec-worker/dist/fec-worker.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/fec-worker.js +0 -859
- package/node_modules/@blockcast/fec-worker/dist/fec-worker.js.map +0 -7
- package/node_modules/@blockcast/fec-worker/dist/index.d.ts +0 -10
- package/node_modules/@blockcast/fec-worker/dist/index.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/index.js +0 -8
- package/node_modules/@blockcast/fec-worker/dist/index.js.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/shred-fec-worker.d.ts +0 -20
- package/node_modules/@blockcast/fec-worker/dist/shred-fec-worker.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/shred-fec-worker.js +0 -370
- package/node_modules/@blockcast/fec-worker/dist/shred-fec-worker.js.map +0 -7
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-client.d.ts +0 -104
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-client.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-client.js +0 -181
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-client.js.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-types.d.ts +0 -194
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-types.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-types.js +0 -62
- package/node_modules/@blockcast/fec-worker/dist/shred-worker-types.js.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/transfer.d.ts +0 -9
- package/node_modules/@blockcast/fec-worker/dist/transfer.d.ts.map +0 -1
- package/node_modules/@blockcast/fec-worker/dist/transfer.js +0 -13
- package/node_modules/@blockcast/fec-worker/dist/transfer.js.map +0 -1
- package/node_modules/@blockcast/fec-worker/package.json +0 -59
- package/node_modules/@blockcast/fec-worker/src/block-order.ts +0 -93
- package/node_modules/@blockcast/fec-worker/src/fec-worker-client.ts +0 -392
- package/node_modules/@blockcast/fec-worker/src/fec-worker-types.ts +0 -399
- package/node_modules/@blockcast/fec-worker/src/fec-worker.ts +0 -1502
- package/node_modules/@blockcast/fec-worker/src/index.ts +0 -35
- package/node_modules/@blockcast/fec-worker/src/shred-fec-worker.ts +0 -589
- package/node_modules/@blockcast/fec-worker/src/shred-worker-client.ts +0 -222
- package/node_modules/@blockcast/fec-worker/src/shred-worker-types.ts +0 -209
- package/node_modules/@blockcast/fec-worker/src/transfer.ts +0 -12
- package/node_modules/@blockcast/mmt-alta-parse/README.md +0 -181
- package/node_modules/@blockcast/mmt-alta-parse/dist/.build-stamp +0 -0
- package/node_modules/@blockcast/mmt-alta-parse/dist/index.d.ts +0 -57
- package/node_modules/@blockcast/mmt-alta-parse/dist/index.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-alta-parse/dist/index.js +0 -115
- package/node_modules/@blockcast/mmt-alta-parse/dist/index.js.map +0 -1
- package/node_modules/@blockcast/mmt-alta-parse/package.json +0 -50
- package/node_modules/@blockcast/mmt-alta-parse/src/index.ts +0 -136
- package/node_modules/@blockcast/mmt-base/README.md +0 -134
- package/node_modules/@blockcast/mmt-base/dist/.build-stamp +0 -0
- package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.d.ts +0 -55
- package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js +0 -128
- package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/index.d.ts +0 -7
- package/node_modules/@blockcast/mmt-base/dist/index.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/index.js +0 -7
- package/node_modules/@blockcast/mmt-base/dist/index.js.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts +0 -292
- package/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/mmtp.js +0 -612
- package/node_modules/@blockcast/mmt-base/dist/mmtp.js.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/net-constants.d.ts +0 -18
- package/node_modules/@blockcast/mmt-base/dist/net-constants.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/net-constants.js +0 -18
- package/node_modules/@blockcast/mmt-base/dist/net-constants.js.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/ntp-short.d.ts +0 -47
- package/node_modules/@blockcast/mmt-base/dist/ntp-short.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/ntp-short.js +0 -54
- package/node_modules/@blockcast/mmt-base/dist/ntp-short.js.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/serial-number.d.ts +0 -57
- package/node_modules/@blockcast/mmt-base/dist/serial-number.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/serial-number.js +0 -98
- package/node_modules/@blockcast/mmt-base/dist/serial-number.js.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/signalling.d.ts +0 -312
- package/node_modules/@blockcast/mmt-base/dist/signalling.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-base/dist/signalling.js +0 -637
- package/node_modules/@blockcast/mmt-base/dist/signalling.js.map +0 -1
- package/node_modules/@blockcast/mmt-base/package.json +0 -49
- package/node_modules/@blockcast/mmt-base/src/fec-block-profile.ts +0 -145
- package/node_modules/@blockcast/mmt-base/src/index.ts +0 -6
- package/node_modules/@blockcast/mmt-base/src/mmtp.ts +0 -892
- package/node_modules/@blockcast/mmt-base/src/net-constants.ts +0 -17
- package/node_modules/@blockcast/mmt-base/src/ntp-short.ts +0 -67
- package/node_modules/@blockcast/mmt-base/src/serial-number.ts +0 -107
- package/node_modules/@blockcast/mmt-base/src/signalling.ts +0 -862
- package/node_modules/@blockcast/mmt-fec/README.md +0 -271
- package/node_modules/@blockcast/mmt-fec/dist/.build-stamp +0 -0
- package/node_modules/@blockcast/mmt-fec/dist/block-manager.d.ts +0 -82
- package/node_modules/@blockcast/mmt-fec/dist/block-manager.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/block-manager.js +0 -296
- package/node_modules/@blockcast/mmt-fec/dist/block-manager.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/block-processor.d.ts +0 -106
- package/node_modules/@blockcast/mmt-fec/dist/block-processor.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/block-processor.js +0 -288
- package/node_modules/@blockcast/mmt-fec/dist/block-processor.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.d.ts +0 -46
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.js +0 -96
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-symbols.d.ts +0 -33
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-symbols.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-symbols.js +0 -57
- package/node_modules/@blockcast/mmt-fec/dist/cmaf-symbols.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/fec-block-mapper.d.ts +0 -205
- package/node_modules/@blockcast/mmt-fec/dist/fec-block-mapper.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/fec-block-mapper.js +0 -240
- package/node_modules/@blockcast/mmt-fec/dist/fec-block-mapper.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/index.d.ts +0 -28
- package/node_modules/@blockcast/mmt-fec/dist/index.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/index.js +0 -28
- package/node_modules/@blockcast/mmt-fec/dist/index.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/loc-symbols.d.ts +0 -20
- package/node_modules/@blockcast/mmt-fec/dist/loc-symbols.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/loc-symbols.js +0 -28
- package/node_modules/@blockcast/mmt-fec/dist/loc-symbols.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/oti.d.ts +0 -258
- package/node_modules/@blockcast/mmt-fec/dist/oti.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/oti.js +0 -382
- package/node_modules/@blockcast/mmt-fec/dist/oti.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/reorder-buffer.d.ts +0 -41
- package/node_modules/@blockcast/mmt-fec/dist/reorder-buffer.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/reorder-buffer.js +0 -81
- package/node_modules/@blockcast/mmt-fec/dist/reorder-buffer.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/repair-group.d.ts +0 -82
- package/node_modules/@blockcast/mmt-fec/dist/repair-group.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/dist/repair-group.js +0 -170
- package/node_modules/@blockcast/mmt-fec/dist/repair-group.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/README.md +0 -181
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/dist/.build-stamp +0 -0
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/dist/index.d.ts +0 -57
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/dist/index.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/dist/index.js +0 -115
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/dist/index.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/package.json +0 -50
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-alta-parse/src/index.ts +0 -136
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/README.md +0 -134
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/.build-stamp +0 -0
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/fec-block-profile.d.ts +0 -55
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/fec-block-profile.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js +0 -128
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/index.d.ts +0 -7
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/index.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/index.js +0 -7
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/index.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts +0 -292
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/mmtp.js +0 -612
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/mmtp.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/net-constants.d.ts +0 -18
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/net-constants.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/net-constants.js +0 -18
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/net-constants.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/ntp-short.d.ts +0 -47
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/ntp-short.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/ntp-short.js +0 -54
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/ntp-short.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/serial-number.d.ts +0 -57
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/serial-number.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/serial-number.js +0 -98
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/serial-number.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/signalling.d.ts +0 -312
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/signalling.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/signalling.js +0 -637
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/dist/signalling.js.map +0 -1
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/package.json +0 -49
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/src/fec-block-profile.ts +0 -145
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/src/index.ts +0 -6
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/src/mmtp.ts +0 -892
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/src/net-constants.ts +0 -17
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/src/ntp-short.ts +0 -67
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/src/serial-number.ts +0 -107
- package/node_modules/@blockcast/mmt-fec/node_modules/@blockcast/mmt-base/src/signalling.ts +0 -862
- package/node_modules/@blockcast/mmt-fec/package.json +0 -79
- package/node_modules/@blockcast/mmt-fec/src/block-manager.ts +0 -371
- package/node_modules/@blockcast/mmt-fec/src/block-processor.ts +0 -439
- package/node_modules/@blockcast/mmt-fec/src/cmaf-recovery.ts +0 -127
- package/node_modules/@blockcast/mmt-fec/src/cmaf-symbols.ts +0 -68
- package/node_modules/@blockcast/mmt-fec/src/fec-block-mapper.ts +0 -310
- package/node_modules/@blockcast/mmt-fec/src/index.ts +0 -94
- package/node_modules/@blockcast/mmt-fec/src/loc-symbols.ts +0 -34
- package/node_modules/@blockcast/mmt-fec/src/oti.ts +0 -463
- package/node_modules/@blockcast/mmt-fec/src/reorder-buffer.ts +0 -101
- package/node_modules/@blockcast/mmt-fec/src/repair-group.ts +0 -195
- package/node_modules/@blockcast/mmt-manifest-verify/dist/.build-stamp +0 -0
- package/node_modules/@blockcast/mmt-manifest-verify/dist/admission.d.ts +0 -28
- package/node_modules/@blockcast/mmt-manifest-verify/dist/admission.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/dist/admission.js +0 -128
- package/node_modules/@blockcast/mmt-manifest-verify/dist/admission.js.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/dist/index.d.ts +0 -4
- package/node_modules/@blockcast/mmt-manifest-verify/dist/index.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/dist/index.js +0 -4
- package/node_modules/@blockcast/mmt-manifest-verify/dist/index.js.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/dist/source-auth.d.ts +0 -37
- package/node_modules/@blockcast/mmt-manifest-verify/dist/source-auth.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/dist/source-auth.js +0 -179
- package/node_modules/@blockcast/mmt-manifest-verify/dist/source-auth.js.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/dist/verifier.d.ts +0 -99
- package/node_modules/@blockcast/mmt-manifest-verify/dist/verifier.d.ts.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/dist/verifier.js +0 -492
- package/node_modules/@blockcast/mmt-manifest-verify/dist/verifier.js.map +0 -1
- package/node_modules/@blockcast/mmt-manifest-verify/package.json +0 -45
- package/node_modules/@blockcast/mmt-manifest-verify/src/admission.ts +0 -171
- package/node_modules/@blockcast/mmt-manifest-verify/src/index.ts +0 -3
- package/node_modules/@blockcast/mmt-manifest-verify/src/source-auth.ts +0 -230
- package/node_modules/@blockcast/mmt-manifest-verify/src/verifier.ts +0 -669
- package/node_modules/@noble/hashes/LICENSE +0 -21
- package/node_modules/@noble/hashes/README.md +0 -521
- package/node_modules/@noble/hashes/_assert.d.ts +0 -17
- package/node_modules/@noble/hashes/_assert.d.ts.map +0 -1
- package/node_modules/@noble/hashes/_assert.js +0 -18
- package/node_modules/@noble/hashes/_assert.js.map +0 -1
- package/node_modules/@noble/hashes/_blake.d.ts +0 -14
- package/node_modules/@noble/hashes/_blake.d.ts.map +0 -1
- package/node_modules/@noble/hashes/_blake.js +0 -50
- package/node_modules/@noble/hashes/_blake.js.map +0 -1
- package/node_modules/@noble/hashes/_md.d.ts +0 -51
- package/node_modules/@noble/hashes/_md.d.ts.map +0 -1
- package/node_modules/@noble/hashes/_md.js +0 -162
- package/node_modules/@noble/hashes/_md.js.map +0 -1
- package/node_modules/@noble/hashes/_u64.d.ts +0 -55
- package/node_modules/@noble/hashes/_u64.d.ts.map +0 -1
- package/node_modules/@noble/hashes/_u64.js +0 -90
- package/node_modules/@noble/hashes/_u64.js.map +0 -1
- package/node_modules/@noble/hashes/argon2.d.ts +0 -32
- package/node_modules/@noble/hashes/argon2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/argon2.js +0 -401
- package/node_modules/@noble/hashes/argon2.js.map +0 -1
- package/node_modules/@noble/hashes/blake1.d.ts +0 -106
- package/node_modules/@noble/hashes/blake1.d.ts.map +0 -1
- package/node_modules/@noble/hashes/blake1.js +0 -459
- package/node_modules/@noble/hashes/blake1.js.map +0 -1
- package/node_modules/@noble/hashes/blake2.d.ts +0 -116
- package/node_modules/@noble/hashes/blake2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/blake2.js +0 -420
- package/node_modules/@noble/hashes/blake2.js.map +0 -1
- package/node_modules/@noble/hashes/blake2b.d.ts +0 -11
- package/node_modules/@noble/hashes/blake2b.d.ts.map +0 -1
- package/node_modules/@noble/hashes/blake2b.js +0 -14
- package/node_modules/@noble/hashes/blake2b.js.map +0 -1
- package/node_modules/@noble/hashes/blake2s.d.ts +0 -20
- package/node_modules/@noble/hashes/blake2s.d.ts.map +0 -1
- package/node_modules/@noble/hashes/blake2s.js +0 -24
- package/node_modules/@noble/hashes/blake2s.js.map +0 -1
- package/node_modules/@noble/hashes/blake3.d.ts +0 -54
- package/node_modules/@noble/hashes/blake3.d.ts.map +0 -1
- package/node_modules/@noble/hashes/blake3.js +0 -255
- package/node_modules/@noble/hashes/blake3.js.map +0 -1
- package/node_modules/@noble/hashes/crypto.d.ts +0 -2
- package/node_modules/@noble/hashes/crypto.d.ts.map +0 -1
- package/node_modules/@noble/hashes/crypto.js +0 -5
- package/node_modules/@noble/hashes/crypto.js.map +0 -1
- package/node_modules/@noble/hashes/cryptoNode.d.ts +0 -2
- package/node_modules/@noble/hashes/cryptoNode.d.ts.map +0 -1
- package/node_modules/@noble/hashes/cryptoNode.js +0 -18
- package/node_modules/@noble/hashes/cryptoNode.js.map +0 -1
- package/node_modules/@noble/hashes/eskdf.d.ts +0 -47
- package/node_modules/@noble/hashes/eskdf.d.ts.map +0 -1
- package/node_modules/@noble/hashes/eskdf.js +0 -166
- package/node_modules/@noble/hashes/eskdf.js.map +0 -1
- package/node_modules/@noble/hashes/esm/_assert.d.ts +0 -17
- package/node_modules/@noble/hashes/esm/_assert.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/_assert.js +0 -15
- package/node_modules/@noble/hashes/esm/_assert.js.map +0 -1
- package/node_modules/@noble/hashes/esm/_blake.d.ts +0 -14
- package/node_modules/@noble/hashes/esm/_blake.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/_blake.js +0 -45
- package/node_modules/@noble/hashes/esm/_blake.js.map +0 -1
- package/node_modules/@noble/hashes/esm/_md.d.ts +0 -51
- package/node_modules/@noble/hashes/esm/_md.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/_md.js +0 -155
- package/node_modules/@noble/hashes/esm/_md.js.map +0 -1
- package/node_modules/@noble/hashes/esm/_u64.d.ts +0 -55
- package/node_modules/@noble/hashes/esm/_u64.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/_u64.js +0 -67
- package/node_modules/@noble/hashes/esm/_u64.js.map +0 -1
- package/node_modules/@noble/hashes/esm/argon2.d.ts +0 -32
- package/node_modules/@noble/hashes/esm/argon2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/argon2.js +0 -392
- package/node_modules/@noble/hashes/esm/argon2.js.map +0 -1
- package/node_modules/@noble/hashes/esm/blake1.d.ts +0 -106
- package/node_modules/@noble/hashes/esm/blake1.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/blake1.js +0 -452
- package/node_modules/@noble/hashes/esm/blake1.js.map +0 -1
- package/node_modules/@noble/hashes/esm/blake2.d.ts +0 -116
- package/node_modules/@noble/hashes/esm/blake2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/blake2.js +0 -413
- package/node_modules/@noble/hashes/esm/blake2.js.map +0 -1
- package/node_modules/@noble/hashes/esm/blake2b.d.ts +0 -11
- package/node_modules/@noble/hashes/esm/blake2b.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/blake2b.js +0 -11
- package/node_modules/@noble/hashes/esm/blake2b.js.map +0 -1
- package/node_modules/@noble/hashes/esm/blake2s.d.ts +0 -20
- package/node_modules/@noble/hashes/esm/blake2s.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/blake2s.js +0 -21
- package/node_modules/@noble/hashes/esm/blake2s.js.map +0 -1
- package/node_modules/@noble/hashes/esm/blake3.d.ts +0 -54
- package/node_modules/@noble/hashes/esm/blake3.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/blake3.js +0 -251
- package/node_modules/@noble/hashes/esm/blake3.js.map +0 -1
- package/node_modules/@noble/hashes/esm/crypto.d.ts +0 -2
- package/node_modules/@noble/hashes/esm/crypto.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/crypto.js +0 -2
- package/node_modules/@noble/hashes/esm/crypto.js.map +0 -1
- package/node_modules/@noble/hashes/esm/cryptoNode.d.ts +0 -2
- package/node_modules/@noble/hashes/esm/cryptoNode.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/cryptoNode.js +0 -15
- package/node_modules/@noble/hashes/esm/cryptoNode.js.map +0 -1
- package/node_modules/@noble/hashes/esm/eskdf.d.ts +0 -47
- package/node_modules/@noble/hashes/esm/eskdf.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/eskdf.js +0 -160
- package/node_modules/@noble/hashes/esm/eskdf.js.map +0 -1
- package/node_modules/@noble/hashes/esm/hkdf.d.ts +0 -36
- package/node_modules/@noble/hashes/esm/hkdf.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/hkdf.js +0 -82
- package/node_modules/@noble/hashes/esm/hkdf.js.map +0 -1
- package/node_modules/@noble/hashes/esm/hmac.d.ts +0 -35
- package/node_modules/@noble/hashes/esm/hmac.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/hmac.js +0 -86
- package/node_modules/@noble/hashes/esm/hmac.js.map +0 -1
- package/node_modules/@noble/hashes/esm/index.d.ts +0 -2
- package/node_modules/@noble/hashes/esm/index.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/index.js +0 -33
- package/node_modules/@noble/hashes/esm/index.js.map +0 -1
- package/node_modules/@noble/hashes/esm/legacy.d.ts +0 -71
- package/node_modules/@noble/hashes/esm/legacy.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/legacy.js +0 -281
- package/node_modules/@noble/hashes/esm/legacy.js.map +0 -1
- package/node_modules/@noble/hashes/esm/package.json +0 -10
- package/node_modules/@noble/hashes/esm/pbkdf2.d.ts +0 -23
- package/node_modules/@noble/hashes/esm/pbkdf2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/pbkdf2.js +0 -97
- package/node_modules/@noble/hashes/esm/pbkdf2.js.map +0 -1
- package/node_modules/@noble/hashes/esm/ripemd160.d.ts +0 -13
- package/node_modules/@noble/hashes/esm/ripemd160.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/ripemd160.js +0 -13
- package/node_modules/@noble/hashes/esm/ripemd160.js.map +0 -1
- package/node_modules/@noble/hashes/esm/scrypt.d.ts +0 -34
- package/node_modules/@noble/hashes/esm/scrypt.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/scrypt.js +0 -228
- package/node_modules/@noble/hashes/esm/scrypt.js.map +0 -1
- package/node_modules/@noble/hashes/esm/sha1.d.ts +0 -11
- package/node_modules/@noble/hashes/esm/sha1.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/sha1.js +0 -11
- package/node_modules/@noble/hashes/esm/sha1.js.map +0 -1
- package/node_modules/@noble/hashes/esm/sha2.d.ts +0 -159
- package/node_modules/@noble/hashes/esm/sha2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/sha2.js +0 -375
- package/node_modules/@noble/hashes/esm/sha2.js.map +0 -1
- package/node_modules/@noble/hashes/esm/sha256.d.ts +0 -20
- package/node_modules/@noble/hashes/esm/sha256.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/sha256.js +0 -20
- package/node_modules/@noble/hashes/esm/sha256.js.map +0 -1
- package/node_modules/@noble/hashes/esm/sha3-addons.d.ts +0 -142
- package/node_modules/@noble/hashes/esm/sha3-addons.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/sha3-addons.js +0 -393
- package/node_modules/@noble/hashes/esm/sha3-addons.js.map +0 -1
- package/node_modules/@noble/hashes/esm/sha3.d.ts +0 -53
- package/node_modules/@noble/hashes/esm/sha3.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/sha3.js +0 -234
- package/node_modules/@noble/hashes/esm/sha3.js.map +0 -1
- package/node_modules/@noble/hashes/esm/sha512.d.ts +0 -26
- package/node_modules/@noble/hashes/esm/sha512.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/sha512.js +0 -26
- package/node_modules/@noble/hashes/esm/sha512.js.map +0 -1
- package/node_modules/@noble/hashes/esm/utils.d.ts +0 -161
- package/node_modules/@noble/hashes/esm/utils.d.ts.map +0 -1
- package/node_modules/@noble/hashes/esm/utils.js +0 -281
- package/node_modules/@noble/hashes/esm/utils.js.map +0 -1
- package/node_modules/@noble/hashes/hkdf.d.ts +0 -36
- package/node_modules/@noble/hashes/hkdf.d.ts.map +0 -1
- package/node_modules/@noble/hashes/hkdf.js +0 -88
- package/node_modules/@noble/hashes/hkdf.js.map +0 -1
- package/node_modules/@noble/hashes/hmac.d.ts +0 -35
- package/node_modules/@noble/hashes/hmac.d.ts.map +0 -1
- package/node_modules/@noble/hashes/hmac.js +0 -91
- package/node_modules/@noble/hashes/hmac.js.map +0 -1
- package/node_modules/@noble/hashes/index.d.ts +0 -1
- package/node_modules/@noble/hashes/index.d.ts.map +0 -1
- package/node_modules/@noble/hashes/index.js +0 -33
- package/node_modules/@noble/hashes/index.js.map +0 -1
- package/node_modules/@noble/hashes/legacy.d.ts +0 -71
- package/node_modules/@noble/hashes/legacy.d.ts.map +0 -1
- package/node_modules/@noble/hashes/legacy.js +0 -287
- package/node_modules/@noble/hashes/legacy.js.map +0 -1
- package/node_modules/@noble/hashes/package.json +0 -266
- package/node_modules/@noble/hashes/pbkdf2.d.ts +0 -23
- package/node_modules/@noble/hashes/pbkdf2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/pbkdf2.js +0 -101
- package/node_modules/@noble/hashes/pbkdf2.js.map +0 -1
- package/node_modules/@noble/hashes/ripemd160.d.ts +0 -13
- package/node_modules/@noble/hashes/ripemd160.d.ts.map +0 -1
- package/node_modules/@noble/hashes/ripemd160.js +0 -16
- package/node_modules/@noble/hashes/ripemd160.js.map +0 -1
- package/node_modules/@noble/hashes/scrypt.d.ts +0 -34
- package/node_modules/@noble/hashes/scrypt.d.ts.map +0 -1
- package/node_modules/@noble/hashes/scrypt.js +0 -232
- package/node_modules/@noble/hashes/scrypt.js.map +0 -1
- package/node_modules/@noble/hashes/sha1.d.ts +0 -11
- package/node_modules/@noble/hashes/sha1.d.ts.map +0 -1
- package/node_modules/@noble/hashes/sha1.js +0 -14
- package/node_modules/@noble/hashes/sha1.js.map +0 -1
- package/node_modules/@noble/hashes/sha2.d.ts +0 -159
- package/node_modules/@noble/hashes/sha2.d.ts.map +0 -1
- package/node_modules/@noble/hashes/sha2.js +0 -384
- package/node_modules/@noble/hashes/sha2.js.map +0 -1
- package/node_modules/@noble/hashes/sha256.d.ts +0 -20
- package/node_modules/@noble/hashes/sha256.d.ts.map +0 -1
- package/node_modules/@noble/hashes/sha256.js +0 -23
- package/node_modules/@noble/hashes/sha256.js.map +0 -1
- package/node_modules/@noble/hashes/sha3-addons.d.ts +0 -142
- package/node_modules/@noble/hashes/sha3-addons.d.ts.map +0 -1
- package/node_modules/@noble/hashes/sha3-addons.js +0 -402
- package/node_modules/@noble/hashes/sha3-addons.js.map +0 -1
- package/node_modules/@noble/hashes/sha3.d.ts +0 -53
- package/node_modules/@noble/hashes/sha3.d.ts.map +0 -1
- package/node_modules/@noble/hashes/sha3.js +0 -239
- package/node_modules/@noble/hashes/sha3.js.map +0 -1
- package/node_modules/@noble/hashes/sha512.d.ts +0 -26
- package/node_modules/@noble/hashes/sha512.d.ts.map +0 -1
- package/node_modules/@noble/hashes/sha512.js +0 -29
- package/node_modules/@noble/hashes/sha512.js.map +0 -1
- package/node_modules/@noble/hashes/src/_assert.ts +0 -22
- package/node_modules/@noble/hashes/src/_blake.ts +0 -50
- package/node_modules/@noble/hashes/src/_md.ts +0 -176
- package/node_modules/@noble/hashes/src/_u64.ts +0 -91
- package/node_modules/@noble/hashes/src/argon2.ts +0 -497
- package/node_modules/@noble/hashes/src/blake1.ts +0 -534
- package/node_modules/@noble/hashes/src/blake2.ts +0 -486
- package/node_modules/@noble/hashes/src/blake2b.ts +0 -10
- package/node_modules/@noble/hashes/src/blake2s.ts +0 -20
- package/node_modules/@noble/hashes/src/blake3.ts +0 -272
- package/node_modules/@noble/hashes/src/crypto.ts +0 -9
- package/node_modules/@noble/hashes/src/cryptoNode.ts +0 -15
- package/node_modules/@noble/hashes/src/eskdf.ts +0 -187
- package/node_modules/@noble/hashes/src/hkdf.ts +0 -88
- package/node_modules/@noble/hashes/src/hmac.ts +0 -94
- package/node_modules/@noble/hashes/src/index.ts +0 -31
- package/node_modules/@noble/hashes/src/legacy.ts +0 -293
- package/node_modules/@noble/hashes/src/pbkdf2.ts +0 -122
- package/node_modules/@noble/hashes/src/ripemd160.ts +0 -12
- package/node_modules/@noble/hashes/src/scrypt.ts +0 -257
- package/node_modules/@noble/hashes/src/sha1.ts +0 -10
- package/node_modules/@noble/hashes/src/sha2.ts +0 -402
- package/node_modules/@noble/hashes/src/sha256.ts +0 -24
- package/node_modules/@noble/hashes/src/sha3-addons.ts +0 -499
- package/node_modules/@noble/hashes/src/sha3.ts +0 -258
- package/node_modules/@noble/hashes/src/sha512.ts +0 -34
- package/node_modules/@noble/hashes/src/utils.ts +0 -395
- package/node_modules/@noble/hashes/utils.d.ts +0 -161
- package/node_modules/@noble/hashes/utils.d.ts.map +0 -1
- package/node_modules/@noble/hashes/utils.js +0 -313
- package/node_modules/@noble/hashes/utils.js.map +0 -1
package/src/fec-manager.ts
CHANGED
|
@@ -9,20 +9,18 @@
|
|
|
9
9
|
* MMTP packet parsing and frame routing.
|
|
10
10
|
*/
|
|
11
11
|
|
|
12
|
-
import { computeFecDeliveryWindowMs } from './track-session.js'
|
|
12
|
+
import { computeFecDeliveryWindowMs, fecSpanDeliveryWindowMs } from './track-session.js'
|
|
13
13
|
import { DeliveryGapEstimator } from './delivery-gap.js'
|
|
14
14
|
import {
|
|
15
15
|
deriveFecInterleaveDepth,
|
|
16
16
|
deriveFecRetentionBlocks,
|
|
17
17
|
tryDeriveFecRetentionBlocks,
|
|
18
|
+
LOCAL_FEC_RETENTION_BLOCKS,
|
|
19
|
+
LOCAL_FEC_TIMEOUT_MS,
|
|
18
20
|
} from '@blockcast/mmt-fec'
|
|
19
21
|
import {
|
|
20
|
-
isKStrideBlock,
|
|
21
22
|
isoBlockContains,
|
|
22
23
|
isoBlocksBehindLowerBound,
|
|
23
|
-
kStrideBlockPrecedes,
|
|
24
|
-
kStrideBlocksBehind,
|
|
25
|
-
kStrideNextBlock,
|
|
26
24
|
parseFecBlockProfile,
|
|
27
25
|
serial32Distance,
|
|
28
26
|
serial32Precedes,
|
|
@@ -86,7 +84,7 @@ export type WasmFecDecoder = {
|
|
|
86
84
|
configure(oti: Uint8Array): void
|
|
87
85
|
cleanup(current_time: number): Uint8Array
|
|
88
86
|
/** Retire the named blocks from the decoder (last-chance decode + stats). */
|
|
89
|
-
cleanup_blocks_detailed(
|
|
87
|
+
cleanup_blocks_detailed(ss_starts: Uint32Array): unknown
|
|
90
88
|
/**
|
|
91
89
|
* iso-ssbg1-v1 only: retire the source symbols the decoder holds before a
|
|
92
90
|
* repair states their block, once no repair can place them any more, by the
|
|
@@ -112,7 +110,8 @@ export interface FecStats {
|
|
|
112
110
|
blocksComplete: number
|
|
113
111
|
mixedPathBlocks: number
|
|
114
112
|
recentBlockPathCounts: FecBlockPathCount[]
|
|
115
|
-
k
|
|
113
|
+
/** The stream-global K a configure() call stated; undefined when none did. Per-track K is tracks[].k. */
|
|
114
|
+
k: number | undefined
|
|
116
115
|
/** Of blocks with loss, what percentage were recovered (0-100). */
|
|
117
116
|
recoveryRate: number
|
|
118
117
|
/** What percentage of blocks had any loss (0-100). */
|
|
@@ -136,7 +135,8 @@ export interface FecPacketStats {
|
|
|
136
135
|
blocksRecovered: number
|
|
137
136
|
blocksFailed: number
|
|
138
137
|
blocksComplete: number
|
|
139
|
-
|
|
138
|
+
/** The track's configured K; undefined for a packetId never configured (it does no FEC work). */
|
|
139
|
+
k: number | undefined
|
|
140
140
|
recoveryRate: number
|
|
141
141
|
packetLossRate: number
|
|
142
142
|
}
|
|
@@ -217,10 +217,11 @@ type FecLifecycleTrace = {
|
|
|
217
217
|
export interface FECManagerConfig {
|
|
218
218
|
/**
|
|
219
219
|
* The catalog `fec.blockProfile` of the track (BLO-35597). Required for every
|
|
220
|
-
* configured track: there is no default, and nothing infers it.
|
|
221
|
-
* `
|
|
222
|
-
*
|
|
223
|
-
*
|
|
220
|
+
* configured track: there is no default, and nothing infers it. The only
|
|
221
|
+
* profile is `iso-ssbg1-v1`: ISO/IEC 23008-1 ssbg_mode1 with K' = SSB_length
|
|
222
|
+
* blocks keyed by SS_Start and located by `(SS_Start, SSB_length)` range
|
|
223
|
+
* membership, `k` being only their maximum. The retired `k-padded-v1` token
|
|
224
|
+
* is refused.
|
|
224
225
|
*/
|
|
225
226
|
blockProfile?: FecBlockProfile
|
|
226
227
|
k?: number
|
|
@@ -373,7 +374,6 @@ export interface FecDecoderUnavailableEvent {
|
|
|
373
374
|
export class FECManager {
|
|
374
375
|
// Per-track WASM RaptorQ decoders, keyed by physical stream identity.
|
|
375
376
|
#fecDecoders = new Map<string, { client: WasmFecDecoder; k: number }>()
|
|
376
|
-
/** @deprecated Use setFecDecoder(packetId, ...). Backwards-compat shim. */
|
|
377
377
|
|
|
378
378
|
// Per-track Worker-backed FEC decoders, keyed by physical stream identity.
|
|
379
379
|
// Worker-backed tracks use async decode — recovered frames arrive via onFrame callback,
|
|
@@ -393,9 +393,12 @@ export class FECManager {
|
|
|
393
393
|
conflicted: boolean
|
|
394
394
|
}>>()
|
|
395
395
|
|
|
396
|
-
|
|
396
|
+
// The stream-global K a configure() call stated, reported as fecStats.k.
|
|
397
|
+
// It never resolves a packetId: a packetId has only its own track config
|
|
398
|
+
// (BLO-45953), and K does not feed the delivery-window math.
|
|
399
|
+
#streamK: number | undefined
|
|
397
400
|
#fecSymbolSize = 0
|
|
398
|
-
#fecTimeoutMs =
|
|
401
|
+
#fecTimeoutMs = LOCAL_FEC_TIMEOUT_MS // local default; refined by setFramerate() when fps known
|
|
399
402
|
#trackConfigs = new Map<number, ResolvedFECTrackConfig>()
|
|
400
403
|
#fecStats = newFecCounters()
|
|
401
404
|
#fecTrackStats = new Map<number, MutableFecCounters>()
|
|
@@ -436,10 +439,10 @@ export class FECManager {
|
|
|
436
439
|
#blockSourceEsis = new Map<string, Set<number>>()
|
|
437
440
|
// Authored SSB_length per block (ISO/IEC 23008-1 §C.5.3), learned from the
|
|
438
441
|
// first repair symbol. The FFmpeg moq_mmt publisher closes a block every D
|
|
439
|
-
// media units, usually before it holds K symbols
|
|
440
|
-
//
|
|
441
|
-
// SSB_length
|
|
442
|
-
//
|
|
442
|
+
// media units, usually before it holds K symbols; under iso-ssbg1-v1
|
|
443
|
+
// (ssbg_mode1) that block is K' = SSB_length symbols, its repair ESIs start
|
|
444
|
+
// at SSB_length, and K is only the maximum. Such a block is clean at
|
|
445
|
+
// SSB_length source arrivals and recoverable from SSB_length received
|
|
443
446
|
// symbols; waiting for K fails every one of them.
|
|
444
447
|
#blockAuthoredLengths = new Map<string, number>()
|
|
445
448
|
#ssbLengthConflictCount = 0
|
|
@@ -558,14 +561,16 @@ export class FECManager {
|
|
|
558
561
|
#resolvedBlockClasses = new Map<string, BlockClass>()
|
|
559
562
|
// Blocks already reported through onBlockRepaired (once per block).
|
|
560
563
|
#repairedBlocks = new Set<string>()
|
|
561
|
-
// Blocks created
|
|
564
|
+
// Blocks created before any symbol of theirs was tracked: the repair-less
|
|
565
|
+
// spans placeIsoRepair materializes (onBlockVanished).
|
|
562
566
|
#materializedBlocks = new Set<string>()
|
|
563
567
|
// packetIds whose ordered-relay horizon became underivable and fell back to
|
|
564
568
|
// the datagram deadline. Bounds the warn in #derivableOrderedHorizon to once
|
|
565
569
|
// per stream. Not only throws: the ordinary out-of-range case is detected by
|
|
566
570
|
// arithmetic and never throws at all.
|
|
567
571
|
#orderedHorizonWarnedFor = new Set<number>()
|
|
568
|
-
//
|
|
572
|
+
// Newest block start (SS_Start) seen per stream and when: the frontier for
|
|
573
|
+
// source-discontinuity detection and isoSpanResolution.
|
|
569
574
|
#highestSbn = new Map<string, { sbn: number; atMs: number }>()
|
|
570
575
|
// iso-ssbg1-v1 block location per stream (streamKey). A source belongs to a
|
|
571
576
|
// block only once a repair symbol stated the block's (SS_Start, SSB_length).
|
|
@@ -829,7 +834,8 @@ export class FECManager {
|
|
|
829
834
|
this.#completedBlocks.add(key)
|
|
830
835
|
if (clean) this.#cleanlyCompletedBlocks.add(key)
|
|
831
836
|
this.#indexBlockKey(key, sbn, packetId)
|
|
832
|
-
const
|
|
837
|
+
const config = this.#trackConfig(packetId)
|
|
838
|
+
const expiresAtMs = nowMs + config.interleaveDepthMs + 2 * this.#blockLifetimeMs(config)
|
|
833
839
|
this.#terminalExpiryMs.set(key, expiresAtMs)
|
|
834
840
|
let queue = this.#terminalQueues.get(packetId)
|
|
835
841
|
if (!queue) {
|
|
@@ -877,8 +883,9 @@ export class FECManager {
|
|
|
877
883
|
* retention the Worker and the WASM decoder are configured with, because it
|
|
878
884
|
* comes from the same function they do (`deriveFecRetentionBlocks`, over the
|
|
879
885
|
* block's delivery window and its span). The decoder retires every block
|
|
880
|
-
* more than this many
|
|
881
|
-
*
|
|
886
|
+
* more than this many blocks behind the newest SS_Start it saw, counted
|
|
887
|
+
* from below by `isoBlocksBehindLowerBound` (`cleanup_by_ss_start`), so
|
|
888
|
+
* settling earlier than this would decide a block the decoder would still
|
|
882
889
|
* have recovered.
|
|
883
890
|
*
|
|
884
891
|
* This used to call `deriveFecInterleaveDepth`, which returns D -- MEDIA
|
|
@@ -891,6 +898,18 @@ export class FECManager {
|
|
|
891
898
|
* derivation; do not re-derive a horizon at either call site.
|
|
892
899
|
*/
|
|
893
900
|
#orderedHorizonBlocksFor(packetId: number, config: ResolvedFECTrackConfig): number {
|
|
901
|
+
// An absent/zero catalog span has no elapsed-time horizon. Ordered relay
|
|
902
|
+
// still needs a bounded local cleanup distance, so use the shared local
|
|
903
|
+
// count without treating it as a catalog-derived deadline.
|
|
904
|
+
if (config.interleaveDepthMs === 0) {
|
|
905
|
+
if (Number.isFinite(config.timeoutMs) && config.timeoutMs > 0) {
|
|
906
|
+
return LOCAL_FEC_RETENTION_BLOCKS
|
|
907
|
+
}
|
|
908
|
+
throw new Error(
|
|
909
|
+
`[FECManager] packetId=${packetId}: local FEC cleanup requires a positive timeout ` +
|
|
910
|
+
`(got ${config.timeoutMs})`,
|
|
911
|
+
)
|
|
912
|
+
}
|
|
894
913
|
if (!FECManager.#hasOrderedGeometry(config)) {
|
|
895
914
|
throw new Error(
|
|
896
915
|
`[FECManager] packetId=${packetId}: ordered-relay settlement derives the ` +
|
|
@@ -913,7 +932,7 @@ export class FECManager {
|
|
|
913
932
|
*/
|
|
914
933
|
static #hasOrderedGeometry(config: ResolvedFECTrackConfig): boolean {
|
|
915
934
|
return (
|
|
916
|
-
config
|
|
935
|
+
FECManager.#hasCatalogTiming(config) &&
|
|
917
936
|
// `fps` is no longer an input to the horizon, but it still gates WHICH
|
|
918
937
|
// streams settle by stream order at all: a track with no usable
|
|
919
938
|
// media-unit rate fell back to datagram semantics before this and must
|
|
@@ -960,6 +979,11 @@ export class FECManager {
|
|
|
960
979
|
* argument: narrower IS the failing direction.
|
|
961
980
|
*/
|
|
962
981
|
#derivableOrderedHorizon(config: ResolvedFECTrackConfig, packetId: number): number | undefined {
|
|
982
|
+
if (config.interleaveDepthMs === 0) {
|
|
983
|
+
return Number.isFinite(config.timeoutMs) && config.timeoutMs > 0
|
|
984
|
+
? LOCAL_FEC_RETENTION_BLOCKS
|
|
985
|
+
: undefined
|
|
986
|
+
}
|
|
963
987
|
if (!FECManager.#hasOrderedGeometry(config)) return undefined
|
|
964
988
|
try {
|
|
965
989
|
// `tryDeriveFecRetentionBlocks`, not the throwing variant: this is the
|
|
@@ -1016,19 +1040,20 @@ export class FECManager {
|
|
|
1016
1040
|
/**
|
|
1017
1041
|
* The stream's interleave horizon, or undefined when its geometry cannot
|
|
1018
1042
|
* define one. Two different streams reach that case, with different causes:
|
|
1019
|
-
* a packetId that was never configured,
|
|
1020
|
-
*
|
|
1043
|
+
* a packetId that was never configured, which has no geometry at all
|
|
1044
|
+
* (explicitly configured tracks are refused an underivable geometry
|
|
1021
1045
|
* at config time — #upsertTrackConfig, setMulticastSymbolDelivery); or a
|
|
1022
1046
|
* configured track whose timeoutMs was later widened past the 255-block
|
|
1023
1047
|
* ceiling without re-validating, which #derivableOrderedHorizon catches
|
|
1024
1048
|
* rather than throwing from the packet-feed path. Either way the stream
|
|
1025
|
-
* keeps datagram semantics instead of throwing.
|
|
1049
|
+
* keeps datagram semantics instead of throwing. A track's configuration can
|
|
1026
1050
|
* also change under a stream that already holds blocks, so a caller cannot
|
|
1027
1051
|
* assume a horizon that was defined when a block was held is still defined
|
|
1028
1052
|
* (see #advanceOrderedFrontier).
|
|
1029
1053
|
*/
|
|
1030
1054
|
#orderedHorizonBlocks(packetId: number): number | undefined {
|
|
1031
|
-
|
|
1055
|
+
const config = this.#trackConfigs.get(packetId)
|
|
1056
|
+
return config === undefined ? undefined : this.#derivableOrderedHorizon(config, packetId)
|
|
1032
1057
|
}
|
|
1033
1058
|
|
|
1034
1059
|
/** True while a block of an ordered-relay stream can still receive symbols. */
|
|
@@ -1073,7 +1098,7 @@ export class FECManager {
|
|
|
1073
1098
|
catalogTrackName?: string,
|
|
1074
1099
|
): void {
|
|
1075
1100
|
const previous = this.#orderedFrontiers.get(streamKey)
|
|
1076
|
-
const frontier = previous === undefined || this.#blockPrecedes(previous, sbn
|
|
1101
|
+
const frontier = previous === undefined || this.#blockPrecedes(previous, sbn)
|
|
1077
1102
|
? sbn
|
|
1078
1103
|
: previous
|
|
1079
1104
|
if (frontier !== previous) this.#orderedFrontiers.set(streamKey, frontier)
|
|
@@ -1081,10 +1106,9 @@ export class FECManager {
|
|
|
1081
1106
|
if (!pending) return
|
|
1082
1107
|
const blocks = this.#orderedHorizonBlocks(packetId)
|
|
1083
1108
|
if (blocks === undefined) {
|
|
1084
|
-
//
|
|
1085
|
-
//
|
|
1086
|
-
// one
|
|
1087
|
-
// validation (#derivableOrderedHorizon). Stream
|
|
1109
|
+
// A configured stream whose timeoutMs was widened past the 255-block
|
|
1110
|
+
// ceiling after validation (#derivableOrderedHorizon); an unconfigured
|
|
1111
|
+
// one never gets here (feedSymbolFromSource refuses it). Stream
|
|
1088
1112
|
// order can no longer settle its held blocks, so hand them to the
|
|
1089
1113
|
// datagram deadline -- as setMulticastSymbolDelivery('datagram') does --
|
|
1090
1114
|
// rather than settle them a horizon early or hold them with no timer.
|
|
@@ -1130,6 +1154,7 @@ export class FECManager {
|
|
|
1130
1154
|
(this.#blockSourceCounts.get(key) ?? 0) +
|
|
1131
1155
|
(this.#blockRepairRsIds.get(key)?.size ?? 0)
|
|
1132
1156
|
if (
|
|
1157
|
+
this.#hasCatalogTimingForPacket(packetId) &&
|
|
1133
1158
|
this.onRepairNeeded &&
|
|
1134
1159
|
(authoredLength === undefined || received < authoredLength)
|
|
1135
1160
|
) {
|
|
@@ -1343,6 +1368,7 @@ export class FECManager {
|
|
|
1343
1368
|
const key = this.#blockKey(sbn, packetId, catalogTrackName)
|
|
1344
1369
|
if (
|
|
1345
1370
|
this.#completedBlocks.has(key) ||
|
|
1371
|
+
!this.#hasCatalogTimingForPacket(packetId) ||
|
|
1346
1372
|
!this.onRepairNeeded ||
|
|
1347
1373
|
this.#repairRequestedBlocks.has(key)
|
|
1348
1374
|
) return
|
|
@@ -1450,6 +1476,7 @@ export class FECManager {
|
|
|
1450
1476
|
|
|
1451
1477
|
/** A block's live class without creating classifier state for the stream. */
|
|
1452
1478
|
#peekClass(sbn: number, packetId: number, catalogTrackName?: string): BlockClass {
|
|
1479
|
+
if (!this.#hasCatalogTimingForPacket(packetId)) return 'unknown'
|
|
1453
1480
|
const classifier = this.#classifiers.get(this.#streamKey(packetId, catalogTrackName))
|
|
1454
1481
|
if (classifier) return classifier.classOf(sbn)
|
|
1455
1482
|
return this.#geometryFor(packetId, catalogTrackName).trackKind === 'audio' ? 'audio' : 'unknown'
|
|
@@ -1479,8 +1506,8 @@ export class FECManager {
|
|
|
1479
1506
|
// Deliberately one block tighter than deriveFecRetentionBlocks over the same
|
|
1480
1507
|
// inputs (that function's `+ 1`). Different question: the retention horizon
|
|
1481
1508
|
// asks how long the decoder still ACCEPTS symbols for a block, this asks how
|
|
1482
|
-
//
|
|
1483
|
-
// #noteSbnSeen).
|
|
1509
|
+
// many blocks a stream can live behind (or ahead of) its frontier before a
|
|
1510
|
+
// source symbol there is a discontinuity rather than loss (see #noteSbnSeen).
|
|
1484
1511
|
// The extra block of retention is slack for a block still being fed; a block
|
|
1485
1512
|
// nothing has been heard from does not get it. Not the units defect — but it
|
|
1486
1513
|
// is the next place the two can drift, so change both or neither.
|
|
@@ -1490,27 +1517,28 @@ export class FECManager {
|
|
|
1490
1517
|
}
|
|
1491
1518
|
|
|
1492
1519
|
/**
|
|
1493
|
-
* Record that a symbol for block `sbn`
|
|
1494
|
-
*
|
|
1520
|
+
* Record that a symbol for block `sbn` (the block's SS_Start) arrived and
|
|
1521
|
+
* advance the stream's frontier, the newest block start seen.
|
|
1495
1522
|
*
|
|
1496
|
-
*
|
|
1497
|
-
*
|
|
1498
|
-
*
|
|
1499
|
-
*
|
|
1500
|
-
*
|
|
1501
|
-
* its last symbol, is a source discontinuity, not loss. A repair symbol can
|
|
1502
|
-
* only advance the frontier: a D-28 fetch legitimately answers for an old
|
|
1503
|
-
* block, so it never signals a discontinuity.
|
|
1523
|
+
* A SOURCE symbol whose block goes back further than one live window, or
|
|
1524
|
+
* jumps further than the stream could have produced since its last symbol,
|
|
1525
|
+
* is a source discontinuity, not loss. A repair symbol can only advance the
|
|
1526
|
+
* frontier: a D-28 fetch legitimately answers for an old block, so it never
|
|
1527
|
+
* signals a discontinuity.
|
|
1504
1528
|
*
|
|
1505
1529
|
* The producer closes a block at its Dth media-unit boundary OR when K
|
|
1506
|
-
* source symbols filled it, so one interleave span can start several
|
|
1507
|
-
*
|
|
1508
|
-
*
|
|
1509
|
-
*
|
|
1510
|
-
*
|
|
1511
|
-
*
|
|
1512
|
-
*
|
|
1513
|
-
*
|
|
1530
|
+
* source symbols filled it, so one interleave span can start several blocks
|
|
1531
|
+
* (every large keyframe does). What bounds a forward jump is therefore
|
|
1532
|
+
* packet evidence, not a block rate: SS_ID advances by one per FEC source
|
|
1533
|
+
* packet (ISO/IEC 23008-1 C.5.2) and the MMTP packet_sequence_number by one
|
|
1534
|
+
* per packet of the packet_id, so with both source symbols'
|
|
1535
|
+
* packet_sequence_number a block start can move at most the packets sent
|
|
1536
|
+
* between them plus the anchor's own offset into its block (< K). Without
|
|
1537
|
+
* it, only the D-close rate is known.
|
|
1538
|
+
*
|
|
1539
|
+
* Vanished blocks are not enumerated here: their starts are unknown until a
|
|
1540
|
+
* repair states them. The SS_IDs between two stated blocks become one
|
|
1541
|
+
* repair-less span when the later block's repair arrives (placeIsoRepair).
|
|
1514
1542
|
*/
|
|
1515
1543
|
#noteSbnSeen(
|
|
1516
1544
|
sbn: number,
|
|
@@ -1531,7 +1559,7 @@ export class FECManager {
|
|
|
1531
1559
|
? packetSequenceNumber
|
|
1532
1560
|
: undefined
|
|
1533
1561
|
const anchorHere = (): void => {
|
|
1534
|
-
if (psn !== undefined && (anchor === undefined || !this.#blockPrecedes(sbn, anchor.sbn
|
|
1562
|
+
if (psn !== undefined && (anchor === undefined || !this.#blockPrecedes(sbn, anchor.sbn))) {
|
|
1535
1563
|
this.#sourceAnchors.set(streamKey, { sbn, psn, atMs: now })
|
|
1536
1564
|
}
|
|
1537
1565
|
}
|
|
@@ -1549,9 +1577,9 @@ export class FECManager {
|
|
|
1549
1577
|
anchorHere()
|
|
1550
1578
|
return
|
|
1551
1579
|
}
|
|
1552
|
-
const config = this.#
|
|
1580
|
+
const config = this.#trackConfig(packetId)
|
|
1553
1581
|
const window = this.#liveWindowBlocks(config)
|
|
1554
|
-
if (!this.#blockPrecedes(previous.sbn, sbn
|
|
1582
|
+
if (!this.#blockPrecedes(previous.sbn, sbn)) {
|
|
1555
1583
|
if (symbol === 'source' && window !== null &&
|
|
1556
1584
|
this.#blocksBehind(sbn, previous.sbn, packetId) > window) {
|
|
1557
1585
|
discontinuity()
|
|
@@ -1566,30 +1594,16 @@ export class FECManager {
|
|
|
1566
1594
|
// A packet_sequence_number that did not advance says nothing (a
|
|
1567
1595
|
// producer that does not maintain it); only then is the D-close rate
|
|
1568
1596
|
// the whole bound.
|
|
1569
|
-
if (
|
|
1570
|
-
this.#blockPrecedes(anchor.sbn, sbn
|
|
1571
|
-
//
|
|
1572
|
-
//
|
|
1573
|
-
//
|
|
1574
|
-
//
|
|
1597
|
+
if (psn !== undefined && anchor !== undefined &&
|
|
1598
|
+
this.#blockPrecedes(anchor.sbn, sbn) && psn !== anchor.psn) {
|
|
1599
|
+
// A block start can move at most the packets sent since the anchor,
|
|
1600
|
+
// plus the anchor's own offset into its block (< K). Packets sent
|
|
1601
|
+
// from the anchor packet to this one, serial arithmetic (RFC 1982):
|
|
1602
|
+
// more than half the space means it went backwards.
|
|
1575
1603
|
const sent = (psn - anchor.psn) >>> 0
|
|
1576
1604
|
plausible =
|
|
1577
1605
|
sent <= 0x7fff_ffff &&
|
|
1578
1606
|
serial32Distance(anchor.sbn, sbn) <= sent + config.k
|
|
1579
|
-
} else if (psn !== undefined && anchor !== undefined &&
|
|
1580
|
-
this.#blockPrecedes(anchor.sbn, sbn, packetId) && psn !== anchor.psn) {
|
|
1581
|
-
// Packets sent from the anchor packet to this one, serial arithmetic
|
|
1582
|
-
// (RFC 1982): more than half the space means it went backwards.
|
|
1583
|
-
const sent = (psn - anchor.psn) >>> 0
|
|
1584
|
-
const between = this.#blocksBehind(anchor.sbn, sbn, packetId) - 1
|
|
1585
|
-
const dCloses = window + Math.ceil((now - anchor.atMs) / config.interleaveDepthMs)
|
|
1586
|
-
// Each K-close consumes K of the packets sent; with K unknown,
|
|
1587
|
-
// every packet may have closed one.
|
|
1588
|
-
const kCloses = config.k > 0 ? Math.ceil(sent / config.k) : sent
|
|
1589
|
-
plausible =
|
|
1590
|
-
sent <= 0x7fff_ffff &&
|
|
1591
|
-
between <= sent - 1 &&
|
|
1592
|
-
between <= dCloses + kCloses
|
|
1593
1607
|
} else {
|
|
1594
1608
|
plausible = missing <= window + Math.ceil((now - previous.atMs) / config.interleaveDepthMs)
|
|
1595
1609
|
}
|
|
@@ -1601,53 +1615,25 @@ export class FECManager {
|
|
|
1601
1615
|
}
|
|
1602
1616
|
this.#highestSbn.set(streamKey, { sbn, atMs: now })
|
|
1603
1617
|
anchorHere()
|
|
1604
|
-
// iso-ssbg1-v1 cannot enumerate vanished blocks by key: their starts are
|
|
1605
|
-
// unknown. The SS_IDs between two stated blocks become one repair-less
|
|
1606
|
-
// span when the later block's repair arrives (placeIsoRepair).
|
|
1607
|
-
if (this.#isIso(packetId)) return
|
|
1608
|
-
if (missing <= 0 || window === null) return
|
|
1609
|
-
let vanished = previous.sbn
|
|
1610
|
-
for (let i = 0; i < missing; i++) {
|
|
1611
|
-
vanished = this.#nextBlock(vanished, packetId)
|
|
1612
|
-
this.#materializeBlock(
|
|
1613
|
-
vanished,
|
|
1614
|
-
packetId,
|
|
1615
|
-
catalogTrackName,
|
|
1616
|
-
this.#blocksBehind(vanished, sbn, packetId) <= window,
|
|
1617
|
-
)
|
|
1618
|
-
}
|
|
1619
1618
|
}
|
|
1620
1619
|
|
|
1621
1620
|
/*
|
|
1622
|
-
* Block order for one stream (BLO-35597 iso:5).
|
|
1623
|
-
* number (ISO/IEC 23008-1 C.5.2), so
|
|
1624
|
-
*
|
|
1625
|
-
*
|
|
1626
|
-
* the order across the wrap changes. A block outside K-stride geometry has
|
|
1627
|
-
* no SS_ID position, so it keeps the SBN order it always had.
|
|
1621
|
+
* Block order for one stream (BLO-35597 iso:5). A block is keyed by its
|
|
1622
|
+
* SS_Start and SS_ID is a 32-bit serial number (ISO/IEC 23008-1 C.5.2), so
|
|
1623
|
+
* blocks are ordered by RFC 1982 comparison of their starts. Only configured
|
|
1624
|
+
* streams hold blocks: every entry point refuses an unconfigured packetId.
|
|
1628
1625
|
*/
|
|
1629
|
-
#blockPrecedes(a: number, b: number
|
|
1630
|
-
|
|
1631
|
-
if (this.#isIso(packetId)) return serial32Precedes(a, b)
|
|
1632
|
-
const k = this.kForPacket(packetId)
|
|
1633
|
-
return isKStrideBlock(a, k) && isKStrideBlock(b, k) ? kStrideBlockPrecedes(a, b, k) : a < b
|
|
1626
|
+
#blockPrecedes(a: number, b: number): boolean {
|
|
1627
|
+
return serial32Precedes(a, b)
|
|
1634
1628
|
}
|
|
1635
1629
|
|
|
1636
|
-
/**
|
|
1630
|
+
/**
|
|
1631
|
+
* Blocks `a` lies behind `b` (0 when it does not precede it). Blocks vary
|
|
1632
|
+
* in length (K' = SSB_length <= K), so only a lower bound is known: the one
|
|
1633
|
+
* metric the decoder and the worker retire by too.
|
|
1634
|
+
*/
|
|
1637
1635
|
#blocksBehind(a: number, b: number, packetId: number): number {
|
|
1638
|
-
|
|
1639
|
-
// one metric the decoder and the worker retire by too.
|
|
1640
|
-
if (this.#isIso(packetId)) return isoBlocksBehindLowerBound(a, b, this.kForPacket(packetId))
|
|
1641
|
-
const k = this.kForPacket(packetId)
|
|
1642
|
-
return isKStrideBlock(a, k) && isKStrideBlock(b, k)
|
|
1643
|
-
? kStrideBlocksBehind(a, b, k)
|
|
1644
|
-
: Math.max(0, b - a)
|
|
1645
|
-
}
|
|
1646
|
-
|
|
1647
|
-
/** The block after `sbn`, stepping to block 0 where SS_ID wraps. */
|
|
1648
|
-
#nextBlock(sbn: number, packetId: number): number {
|
|
1649
|
-
const k = this.kForPacket(packetId)
|
|
1650
|
-
return isKStrideBlock(sbn, k) ? kStrideNextBlock(sbn, k) : sbn + 1
|
|
1636
|
+
return isoBlocksBehindLowerBound(a, b, this.#trackConfig(packetId).k)
|
|
1651
1637
|
}
|
|
1652
1638
|
|
|
1653
1639
|
#materializeBlock(
|
|
@@ -1659,7 +1645,9 @@ export class FECManager {
|
|
|
1659
1645
|
const key = this.#blockKey(sbn, packetId, catalogTrackName)
|
|
1660
1646
|
if (this.#blockResolutionFor(key) !== 'untracked') return
|
|
1661
1647
|
this.#materializedBlocks.add(key)
|
|
1662
|
-
this.#
|
|
1648
|
+
if (this.#hasCatalogTimingForPacket(packetId)) {
|
|
1649
|
+
this.#classifierFor(packetId, catalogTrackName).touch(sbn)
|
|
1650
|
+
}
|
|
1663
1651
|
this.onBlockVanished?.(sbn, packetId, catalogTrackName)
|
|
1664
1652
|
if (repairable) {
|
|
1665
1653
|
this.noteBlockActivity(sbn, packetId, catalogTrackName, true)
|
|
@@ -1723,18 +1711,37 @@ export class FECManager {
|
|
|
1723
1711
|
if (this.#lifecycleTrace.length > 64) this.#lifecycleTrace.splice(0, 32)
|
|
1724
1712
|
}
|
|
1725
1713
|
|
|
1726
|
-
|
|
1727
|
-
|
|
1728
|
-
|
|
1729
|
-
|
|
1730
|
-
|
|
1731
|
-
|
|
1732
|
-
|
|
1714
|
+
/**
|
|
1715
|
+
* A configured packetId's track config. There is no manager-wide default
|
|
1716
|
+
* (BLO-45953): an unconfigured packetId does no FEC work, so every caller
|
|
1717
|
+
* here is reached only behind a configuration gate and this throw marks a
|
|
1718
|
+
* broken invariant, never a packet-path outcome.
|
|
1719
|
+
*/
|
|
1720
|
+
#trackConfig(packetId: number): ResolvedFECTrackConfig {
|
|
1721
|
+
const config = this.#trackConfigs.get(packetId)
|
|
1722
|
+
if (config === undefined) {
|
|
1723
|
+
throw new Error(
|
|
1724
|
+
`[FECManager] packetId=${packetId} was never configured; ` +
|
|
1725
|
+
'configure the track from its catalog (configureTrack/setFecWorker/setFecDecoder) first',
|
|
1726
|
+
)
|
|
1733
1727
|
}
|
|
1728
|
+
return config
|
|
1734
1729
|
}
|
|
1735
1730
|
|
|
1736
|
-
|
|
1737
|
-
|
|
1731
|
+
/**
|
|
1732
|
+
* Whether this track has the catalog's elapsed-time FEC policy. A zero span
|
|
1733
|
+
* is a deliberate no-deadline signal; it still leaves the wire geometry
|
|
1734
|
+
* usable for in-band decode, but it cannot drive classification, repair
|
|
1735
|
+
* fetches or layer adaptation.
|
|
1736
|
+
*/
|
|
1737
|
+
static #hasCatalogTiming(config: Pick<ResolvedFECTrackConfig, 'interleaveDepthMs'>): boolean {
|
|
1738
|
+
return Number.isSafeInteger(config.interleaveDepthMs) &&
|
|
1739
|
+
config.interleaveDepthMs >= MIN_INTERLEAVE_DEPTH_MS
|
|
1740
|
+
}
|
|
1741
|
+
|
|
1742
|
+
#hasCatalogTimingForPacket(packetId: number): boolean {
|
|
1743
|
+
const config = this.#trackConfigs.get(packetId)
|
|
1744
|
+
return config !== undefined && FECManager.#hasCatalogTiming(config)
|
|
1738
1745
|
}
|
|
1739
1746
|
|
|
1740
1747
|
#computeTimeout(config: {
|
|
@@ -1743,11 +1750,15 @@ export class FECManager {
|
|
|
1743
1750
|
fps?: number
|
|
1744
1751
|
timeoutMs?: number
|
|
1745
1752
|
}): number {
|
|
1746
|
-
if (config.timeoutMs && config.timeoutMs > 0)
|
|
1747
|
-
|
|
1748
|
-
|
|
1749
|
-
//
|
|
1750
|
-
|
|
1753
|
+
if (typeof config.timeoutMs === 'number' && Number.isFinite(config.timeoutMs) && config.timeoutMs > 0) {
|
|
1754
|
+
return config.timeoutMs
|
|
1755
|
+
}
|
|
1756
|
+
// Only a valid non-negative integer §5.1 ms interleave drives the timeout;
|
|
1757
|
+
// zero has no catalog deadline, so retain the local manager default.
|
|
1758
|
+
if (
|
|
1759
|
+
Number.isSafeInteger(config.interleaveDepthMs) &&
|
|
1760
|
+
config.interleaveDepthMs >= MIN_INTERLEAVE_DEPTH_MS
|
|
1761
|
+
) {
|
|
1751
1762
|
return Math.max(
|
|
1752
1763
|
this.#fecTimeoutMs,
|
|
1753
1764
|
computeFecDeliveryWindowMs({
|
|
@@ -1773,14 +1784,17 @@ export class FECManager {
|
|
|
1773
1784
|
*/
|
|
1774
1785
|
#refreshDeliveryGapWindow(): void {
|
|
1775
1786
|
let windowMs: number | undefined
|
|
1776
|
-
const consider = (geometry: BlockClassifierGeometry | undefined): void => {
|
|
1787
|
+
const consider = (geometry: BlockClassifierGeometry | undefined, packetId: number): void => {
|
|
1788
|
+
if (!this.#hasCatalogTimingForPacket(packetId)) return
|
|
1777
1789
|
if (geometry?.trackKind !== 'video' || geometry.mode !== 'classifying') return
|
|
1778
1790
|
const { ticks, timescale } = geometry.keyframeInterval
|
|
1779
1791
|
const ms = (ticks / timescale) * 1000
|
|
1780
1792
|
if (Number.isFinite(ms) && ms > 0 && (windowMs === undefined || ms > windowMs)) windowMs = ms
|
|
1781
1793
|
}
|
|
1782
|
-
for (const geometry of this.#streamGeometries
|
|
1783
|
-
|
|
1794
|
+
for (const [streamKey, geometry] of this.#streamGeometries) {
|
|
1795
|
+
consider(geometry, this.#parseStreamKey(streamKey).packetId)
|
|
1796
|
+
}
|
|
1797
|
+
for (const [packetId, config] of this.#trackConfigs) consider(config.geometry, packetId)
|
|
1784
1798
|
this.#deliveryGaps.setWindowMs(windowMs)
|
|
1785
1799
|
}
|
|
1786
1800
|
|
|
@@ -1815,6 +1829,10 @@ export class FECManager {
|
|
|
1815
1829
|
config: ResolvedFECTrackConfig,
|
|
1816
1830
|
waitMs = this.#multicastWaitMs(config),
|
|
1817
1831
|
): number {
|
|
1832
|
+
// No catalog span means no D-28 repair deadline. The local timeout still
|
|
1833
|
+
// bounds cleanup, and returning the whole wait makes the derived grace
|
|
1834
|
+
// zero (rather than exposing half of a local timeout as a repair budget).
|
|
1835
|
+
if (!FECManager.#hasCatalogTiming(config)) return waitMs
|
|
1818
1836
|
const halfFailBoundMs = Math.ceil(waitMs / 2)
|
|
1819
1837
|
if (
|
|
1820
1838
|
config.k > 0 &&
|
|
@@ -1836,10 +1854,12 @@ export class FECManager {
|
|
|
1836
1854
|
|
|
1837
1855
|
/**
|
|
1838
1856
|
* One block lifetime: the inactivity fail bound plus the D-28 repair grace,
|
|
1839
|
-
* at the widest wait the catalog allows (#maxMulticastWaitMs).
|
|
1840
|
-
*
|
|
1841
|
-
*
|
|
1842
|
-
*
|
|
1857
|
+
* at the widest wait the catalog allows (#maxMulticastWaitMs). For a track
|
|
1858
|
+
* without a catalog span this is receiver-local cleanup time only; no repair
|
|
1859
|
+
* grace is added. Everything derived from it (terminal retention, the
|
|
1860
|
+
* release gate's hold ceiling, the duplicate ledgers, the owed-cleanup
|
|
1861
|
+
* bound) is compared across time, so it must not follow the live
|
|
1862
|
+
* measurement.
|
|
1843
1863
|
*/
|
|
1844
1864
|
#blockLifetimeMs(config: ResolvedFECTrackConfig): number {
|
|
1845
1865
|
const waitMs = this.#maxMulticastWaitMs(config)
|
|
@@ -1857,6 +1877,7 @@ export class FECManager {
|
|
|
1857
1877
|
}
|
|
1858
1878
|
|
|
1859
1879
|
#repairGraceMs(config: ResolvedFECTrackConfig, waitMs: number): number {
|
|
1880
|
+
if (!FECManager.#hasCatalogTiming(config)) return 0
|
|
1860
1881
|
return Math.max(1, waitMs - this.#repairDeadlineMs(config, waitMs))
|
|
1861
1882
|
}
|
|
1862
1883
|
|
|
@@ -1977,7 +1998,15 @@ export class FECManager {
|
|
|
1977
1998
|
config: FECManagerConfig,
|
|
1978
1999
|
catalogTrackName?: string,
|
|
1979
2000
|
): ResolvedFECTrackConfig {
|
|
1980
|
-
const
|
|
2001
|
+
const previousTrack = this.#trackConfigs.get(packetId)
|
|
2002
|
+
const k = config.k ?? previousTrack?.k
|
|
2003
|
+
if (k === undefined || !Number.isSafeInteger(k) || k <= 0) {
|
|
2004
|
+
throw new Error(
|
|
2005
|
+
`[FECManager] packetId=${packetId}: fec.k=${String(k)} must be a positive integer; ` +
|
|
2006
|
+
'configure the track from its catalog',
|
|
2007
|
+
)
|
|
2008
|
+
}
|
|
2009
|
+
const previous: Partial<ResolvedFECTrackConfig> = previousTrack ?? {}
|
|
1981
2010
|
const streamScopedGeometry =
|
|
1982
2011
|
catalogTrackName !== undefined && config.geometry !== undefined ? config.geometry : undefined
|
|
1983
2012
|
if (streamScopedGeometry !== undefined) {
|
|
@@ -1988,6 +2017,14 @@ export class FECManager {
|
|
|
1988
2017
|
config.k !== undefined ||
|
|
1989
2018
|
config.interleaveDepthMs !== undefined ||
|
|
1990
2019
|
config.fps !== undefined
|
|
2020
|
+
if (
|
|
2021
|
+
config.timeoutMs !== undefined &&
|
|
2022
|
+
(!Number.isFinite(config.timeoutMs) || config.timeoutMs < 0)
|
|
2023
|
+
) {
|
|
2024
|
+
throw new Error(
|
|
2025
|
+
`[FECManager] packetId=${packetId}: timeoutMs=${config.timeoutMs} must be a finite non-negative cleanup budget`,
|
|
2026
|
+
)
|
|
2027
|
+
}
|
|
1991
2028
|
if (config.blockProfile !== undefined) {
|
|
1992
2029
|
parseFecBlockProfile(config.blockProfile, `packetId=${packetId} fec.blockProfile`)
|
|
1993
2030
|
}
|
|
@@ -1995,38 +2032,35 @@ export class FECManager {
|
|
|
1995
2032
|
if (blockProfile === undefined) {
|
|
1996
2033
|
throw new Error(
|
|
1997
2034
|
`[FECManager] packetId=${packetId}: fec.blockProfile is required ` +
|
|
1998
|
-
'("
|
|
2035
|
+
'("iso-ssbg1-v1"); configure the track from its catalog',
|
|
1999
2036
|
)
|
|
2000
2037
|
}
|
|
2001
|
-
|
|
2002
|
-
|
|
2003
|
-
|
|
2004
|
-
|
|
2005
|
-
|
|
2006
|
-
|
|
2007
|
-
|
|
2008
|
-
|
|
2009
|
-
|
|
2010
|
-
|
|
2011
|
-
|
|
2012
|
-
|
|
2013
|
-
|
|
2014
|
-
|
|
2015
|
-
`(>= ${MIN_INTERLEAVE_DEPTH_MS} ms; got ${String(ownInterleaveDepthMs)}): it bounds how long ` +
|
|
2016
|
-
'block location keeps stated blocks and held sources',
|
|
2017
|
-
)
|
|
2018
|
-
}
|
|
2038
|
+
// iso-ssbg1-v1 block location keeps what it holds for a horizon derived
|
|
2039
|
+
// from this packet's own catalog span, or from a fixed receiver-local
|
|
2040
|
+
// count when the catalog has no elapsed-time span. The manager-wide span
|
|
2041
|
+
// is never borrowed by a track whose catalog omitted it.
|
|
2042
|
+
const ownInterleaveDepthMs =
|
|
2043
|
+
config.interleaveDepthMs ?? previousTrack?.interleaveDepthMs ?? 0
|
|
2044
|
+
if (
|
|
2045
|
+
!Number.isSafeInteger(ownInterleaveDepthMs) ||
|
|
2046
|
+
(ownInterleaveDepthMs !== 0 && ownInterleaveDepthMs < MIN_INTERLEAVE_DEPTH_MS)
|
|
2047
|
+
) {
|
|
2048
|
+
throw new Error(
|
|
2049
|
+
`[FECManager] packetId=${packetId}: fec.interleaveDepthMs must be absent, 0, or ` +
|
|
2050
|
+
`a finite value >= ${MIN_INTERLEAVE_DEPTH_MS} ms (got ${String(ownInterleaveDepthMs)})`,
|
|
2051
|
+
)
|
|
2019
2052
|
}
|
|
2053
|
+
const hasCatalogTiming = FECManager.#hasCatalogTiming({ interleaveDepthMs: ownInterleaveDepthMs })
|
|
2020
2054
|
const next: ResolvedFECTrackConfig = {
|
|
2021
2055
|
blockProfile,
|
|
2022
|
-
k
|
|
2056
|
+
k,
|
|
2023
2057
|
symbolSize:
|
|
2024
2058
|
config.symbolSize != null && config.symbolSize > 0
|
|
2025
2059
|
? config.symbolSize
|
|
2026
|
-
:
|
|
2027
|
-
interleaveDepthMs:
|
|
2028
|
-
fps: config.fps ?? previous.fps,
|
|
2029
|
-
timeoutMs: config.timeoutMs ?? (timingChanged ? 0 : previous.timeoutMs),
|
|
2060
|
+
: previousTrack?.symbolSize ?? 0,
|
|
2061
|
+
interleaveDepthMs: ownInterleaveDepthMs,
|
|
2062
|
+
fps: config.fps ?? previous.fps ?? this.#fecFps,
|
|
2063
|
+
timeoutMs: config.timeoutMs ?? (timingChanged ? 0 : previous.timeoutMs ?? 0),
|
|
2030
2064
|
...((config.trackKind ?? previous.trackKind) === undefined
|
|
2031
2065
|
? {}
|
|
2032
2066
|
: { trackKind: config.trackKind ?? previous.trackKind }),
|
|
@@ -2037,24 +2071,44 @@ export class FECManager {
|
|
|
2037
2071
|
? {}
|
|
2038
2072
|
: { geometry: config.geometry ?? previous.geometry }),
|
|
2039
2073
|
}
|
|
2040
|
-
|
|
2074
|
+
if (!hasCatalogTiming) {
|
|
2075
|
+
// A missing/zero span has no catalog deadline. Keep an explicitly
|
|
2076
|
+
// supplied local cleanup budget, preserve a prior local budget on a
|
|
2077
|
+
// metadata-only update, and otherwise use the manager's fixed local
|
|
2078
|
+
// default. A positive catalog track's timeout must never leak here.
|
|
2079
|
+
next.timeoutMs = config.timeoutMs !== undefined && config.timeoutMs > 0
|
|
2080
|
+
? config.timeoutMs
|
|
2081
|
+
: previousTrack !== undefined && previousTrack.interleaveDepthMs === 0
|
|
2082
|
+
? previousTrack.timeoutMs
|
|
2083
|
+
: LOCAL_FEC_TIMEOUT_MS
|
|
2084
|
+
} else {
|
|
2085
|
+
next.timeoutMs = this.#computeTimeout(next)
|
|
2086
|
+
}
|
|
2041
2087
|
if (this.#multicastSymbolDelivery === 'ordered-relay') {
|
|
2042
2088
|
// Error on bad init: an ordered-relay stream settles its blocks by the
|
|
2043
2089
|
// decoder's interleave horizon, which this geometry must define.
|
|
2044
2090
|
this.#orderedHorizonBlocksFor(packetId, next)
|
|
2045
2091
|
}
|
|
2046
|
-
|
|
2047
|
-
previous.
|
|
2048
|
-
|
|
2049
|
-
|
|
2050
|
-
//
|
|
2051
|
-
//
|
|
2052
|
-
//
|
|
2092
|
+
const timingPolicyChanged =
|
|
2093
|
+
FECManager.#hasCatalogTiming({ interleaveDepthMs: previous.interleaveDepthMs ?? 0 }) !== hasCatalogTiming
|
|
2094
|
+
if (timingPolicyChanged && !hasCatalogTiming) {
|
|
2095
|
+
// A D-28 timer belongs to the positive catalog timing policy. Once a
|
|
2096
|
+
// track becomes local-only, cancel it instead of merely relying on the
|
|
2097
|
+
// request callback's policy guard; the local cleanup timer is the only
|
|
2098
|
+
// deadline allowed to remain armed for the block.
|
|
2099
|
+
for (const key of [...this.#repairDeadlines.keys()]) {
|
|
2100
|
+
if (this.#belongsToPacket(key, packetId)) this.#clearRepairDeadline(key)
|
|
2101
|
+
}
|
|
2102
|
+
}
|
|
2103
|
+
if (previous.blockProfile !== undefined && previous.k !== next.k) {
|
|
2104
|
+
// A different maximum K is a different block geometry: the stream's
|
|
2105
|
+
// blocks must not be read under the old one's rules.
|
|
2053
2106
|
this.#dropIsoLocators(packetId)
|
|
2054
2107
|
}
|
|
2055
2108
|
this.#trackConfigs.set(packetId, next)
|
|
2056
2109
|
this.#refreshDeliveryGapWindow()
|
|
2057
2110
|
let policyChanged =
|
|
2111
|
+
timingPolicyChanged ||
|
|
2058
2112
|
(config.geometry !== undefined &&
|
|
2059
2113
|
JSON.stringify(config.geometry) !== JSON.stringify(previous.geometry)) ||
|
|
2060
2114
|
(config.trackKind !== undefined && config.trackKind !== previous.trackKind)
|
|
@@ -2077,8 +2131,12 @@ export class FECManager {
|
|
|
2077
2131
|
if (!this.#belongsToPacket(key, packetId)) continue
|
|
2078
2132
|
const stream = this.#parseStreamKey(key)
|
|
2079
2133
|
const geometry = this.#geometryFor(stream.packetId, stream.catalogTrackName)
|
|
2080
|
-
if (
|
|
2134
|
+
if (
|
|
2135
|
+
hasCatalogTiming &&
|
|
2136
|
+
JSON.stringify(geometry) === JSON.stringify(classifier.geometry)
|
|
2137
|
+
) continue
|
|
2081
2138
|
this.#classifiers.delete(key)
|
|
2139
|
+
if (!hasCatalogTiming) continue
|
|
2082
2140
|
// Blocks still unresolved lose the evidence their class rested on:
|
|
2083
2141
|
// under the fresh classifier they read `unknown`. Say so, so a queued
|
|
2084
2142
|
// or running P2 repair for a former delta block is promoted to P0
|
|
@@ -2089,14 +2147,6 @@ export class FECManager {
|
|
|
2089
2147
|
return next
|
|
2090
2148
|
}
|
|
2091
2149
|
|
|
2092
|
-
#normalizeSymbolData(packetId: number, data: Uint8Array): Uint8Array {
|
|
2093
|
-
const symbolSize = this.symbolSizeForPacket(packetId)
|
|
2094
|
-
if (symbolSize <= 0 || data.byteLength === symbolSize) return data
|
|
2095
|
-
const normalized = new Uint8Array(symbolSize)
|
|
2096
|
-
normalized.set(data.subarray(0, symbolSize))
|
|
2097
|
-
return normalized
|
|
2098
|
-
}
|
|
2099
|
-
|
|
2100
2150
|
#blockKeysFor(sbn: number, packetId?: number, catalogTrackName?: string): string[] {
|
|
2101
2151
|
if (packetId != null && catalogTrackName !== undefined) {
|
|
2102
2152
|
return [this.#blockKey(sbn, packetId, catalogTrackName)]
|
|
@@ -2169,7 +2219,7 @@ export class FECManager {
|
|
|
2169
2219
|
...stats,
|
|
2170
2220
|
packetId,
|
|
2171
2221
|
blocksComplete: trackTotal,
|
|
2172
|
-
k: this.#
|
|
2222
|
+
k: this.#trackConfigs.get(packetId)?.k,
|
|
2173
2223
|
recoveryRate: trackAffected > 0
|
|
2174
2224
|
? (stats.blocksRecovered / trackAffected) * 100
|
|
2175
2225
|
: 100,
|
|
@@ -2183,7 +2233,7 @@ export class FECManager {
|
|
|
2183
2233
|
(block) => block.multicastSymbols > 0 && block.moqSymbols > 0,
|
|
2184
2234
|
).length,
|
|
2185
2235
|
recentBlockPathCounts: Array.from(this.#blockPathCounts.values()).slice(-24),
|
|
2186
|
-
k: this.#
|
|
2236
|
+
k: this.#streamK,
|
|
2187
2237
|
// True recovery rate: of blocks that HAD loss, how many were recovered?
|
|
2188
2238
|
recoveryRate: affected > 0 ? (s.blocksRecovered / affected) * 100 : 100,
|
|
2189
2239
|
packetLossRate: total > 0 ? (affected / total) * 100 : 0,
|
|
@@ -2198,7 +2248,6 @@ export class FECManager {
|
|
|
2198
2248
|
},
|
|
2199
2249
|
blocks: stats.blocks.map((block) => ({ ...block })),
|
|
2200
2250
|
decoder: stats.decoder ? { ...stats.decoder } : undefined,
|
|
2201
|
-
altaFailedDetails: stats.altaFailedDetails?.map((detail) => ({ ...detail })),
|
|
2202
2251
|
packetId,
|
|
2203
2252
|
})),
|
|
2204
2253
|
repairSymbolSizeMismatches: this.#repairSymbolSizeMismatchCount,
|
|
@@ -2521,7 +2570,12 @@ export class FECManager {
|
|
|
2521
2570
|
}
|
|
2522
2571
|
}
|
|
2523
2572
|
|
|
2524
|
-
/**
|
|
2573
|
+
/**
|
|
2574
|
+
* Record a transport symbol and reject later duplicates of the same
|
|
2575
|
+
* packetId/SBN/ESI. `sbn` is the block's SS_Start. A packetId with no
|
|
2576
|
+
* configured block profile has no block geometry: its symbol is refused
|
|
2577
|
+
* (false) and no block state is created for it.
|
|
2578
|
+
*/
|
|
2525
2579
|
feedSymbolFromSource(
|
|
2526
2580
|
packetId: number,
|
|
2527
2581
|
sbn: number,
|
|
@@ -2530,6 +2584,7 @@ export class FECManager {
|
|
|
2530
2584
|
source: FecSymbolSource,
|
|
2531
2585
|
catalogTrackName?: string,
|
|
2532
2586
|
): boolean {
|
|
2587
|
+
if (!this.#hasBlockProfile(packetId)) return false
|
|
2533
2588
|
const blockKey = this.#blockKey(sbn, packetId, catalogTrackName)
|
|
2534
2589
|
const streamKey = this.#streamKey(packetId, catalogTrackName)
|
|
2535
2590
|
if (source === 'multicast' && this.#multicastSymbolDelivery === 'ordered-relay') {
|
|
@@ -2537,12 +2592,10 @@ export class FECManager {
|
|
|
2537
2592
|
// one refused below as a join partial or a duplicate.
|
|
2538
2593
|
this.#advanceOrderedFrontier(streamKey, sbn, packetId, catalogTrackName)
|
|
2539
2594
|
}
|
|
2540
|
-
|
|
2541
|
-
//
|
|
2542
|
-
|
|
2543
|
-
|
|
2544
|
-
? this.#isoLocatorFor(packetId, catalogTrackName).blockAt(sbn)?.length ?? k
|
|
2545
|
-
: k
|
|
2595
|
+
// Repair ESIs start at the block's own SSB_length (K'), which its locator
|
|
2596
|
+
// states once a repair placed it; before that, K is the only bound.
|
|
2597
|
+
const sourceSymbols =
|
|
2598
|
+
this.#isoLocatorFor(packetId, catalogTrackName).blockAt(sbn)?.length ?? this.#trackConfig(packetId).k
|
|
2546
2599
|
const isSourceSymbol = esi >= 0 && esi < sourceSymbols
|
|
2547
2600
|
const isStartupPartial = this.#startupPartialBlocks.has(blockKey)
|
|
2548
2601
|
const isReadyMulticastRepair =
|
|
@@ -2711,7 +2764,7 @@ export class FECManager {
|
|
|
2711
2764
|
for (const [key] of this.#activeBlocks) {
|
|
2712
2765
|
const { packetId, sbn } = this.#parseBlockKey(key);
|
|
2713
2766
|
const count = this.#blockSourceCounts.get(key) ?? 0;
|
|
2714
|
-
const k = this.#blockAuthoredLengths.get(key) ?? this
|
|
2767
|
+
const k = this.#blockAuthoredLengths.get(key) ?? this.#trackConfig(packetId).k;
|
|
2715
2768
|
blocks.push({ sbn, packetId, state: 'collecting', sourceCount: count, k, progress: k > 0 ? Math.min(count / k, 1) : 0 });
|
|
2716
2769
|
}
|
|
2717
2770
|
// Recently completed blocks (last 16)
|
|
@@ -2719,7 +2772,7 @@ export class FECManager {
|
|
|
2719
2772
|
for (const key of completed) {
|
|
2720
2773
|
const { packetId, sbn } = this.#parseBlockKey(key);
|
|
2721
2774
|
if (!this.#activeBlocks.has(key)) {
|
|
2722
|
-
const k = this
|
|
2775
|
+
const k = this.#trackConfig(packetId).k;
|
|
2723
2776
|
blocks.push({ sbn, packetId, state: 'complete', sourceCount: k, k, progress: 1 });
|
|
2724
2777
|
}
|
|
2725
2778
|
}
|
|
@@ -2732,14 +2785,16 @@ export class FECManager {
|
|
|
2732
2785
|
return this.#fecDecoders.values().next().value?.client ?? null
|
|
2733
2786
|
}
|
|
2734
2787
|
|
|
2735
|
-
|
|
2736
|
-
kForPacket(packetId: number): number { return this.#
|
|
2788
|
+
/** A configured packetId's K; undefined for an unconfigured one (no FEC work). */
|
|
2789
|
+
kForPacket(packetId: number): number | undefined { return this.#trackConfigs.get(packetId)?.k }
|
|
2737
2790
|
/** FEC symbol size in bytes. */
|
|
2738
2791
|
get symbolSize(): number { return this.#fecSymbolSize }
|
|
2739
|
-
symbolSizeForPacket(packetId: number): number { return this.#
|
|
2792
|
+
symbolSizeForPacket(packetId: number): number | undefined { return this.#trackConfigs.get(packetId)?.symbolSize }
|
|
2740
2793
|
/** FEC block span in milliseconds (0 = no interleaving). */
|
|
2741
2794
|
get interleaveDepthMs(): number { return this.#fecInterleaveDepthMs }
|
|
2742
|
-
interleaveDepthMsForPacket(packetId: number): number
|
|
2795
|
+
interleaveDepthMsForPacket(packetId: number): number | undefined {
|
|
2796
|
+
return this.#trackConfigs.get(packetId)?.interleaveDepthMs
|
|
2797
|
+
}
|
|
2743
2798
|
/**
|
|
2744
2799
|
* Record one multicast MMTP packet arrival (every packet of the leg, FEC
|
|
2745
2800
|
* symbol or not) for the delivery-gap measurement. `packetSequenceNumber`
|
|
@@ -2755,8 +2810,9 @@ export class FECManager {
|
|
|
2755
2810
|
* Resolved per-track multicast late-symbol wait in milliseconds: the span
|
|
2756
2811
|
* plus the larger of the catalog tolerance and the measured delivery gap.
|
|
2757
2812
|
*/
|
|
2758
|
-
timeoutMsForPacket(packetId: number): number {
|
|
2759
|
-
|
|
2813
|
+
timeoutMsForPacket(packetId: number): number | undefined {
|
|
2814
|
+
const config = this.#trackConfigs.get(packetId)
|
|
2815
|
+
return config === undefined ? undefined : this.#multicastWaitMs(config)
|
|
2760
2816
|
}
|
|
2761
2817
|
/**
|
|
2762
2818
|
* Largest multicast delivery gap measured over the current window (ms), and
|
|
@@ -2817,28 +2873,32 @@ export class FECManager {
|
|
|
2817
2873
|
this.#applyBlockDeadline(key, sbn, packetId, catalogTrackName)
|
|
2818
2874
|
}
|
|
2819
2875
|
/** Resolved per-track D-28 repair request deadline in milliseconds. */
|
|
2820
|
-
repairDeadlineMsForPacket(packetId: number): number {
|
|
2821
|
-
|
|
2876
|
+
repairDeadlineMsForPacket(packetId: number): number | undefined {
|
|
2877
|
+
const config = this.#trackConfigs.get(packetId)
|
|
2878
|
+
return config === undefined ? undefined : this.#repairDeadlineMs(config)
|
|
2822
2879
|
}
|
|
2823
2880
|
/**
|
|
2824
2881
|
* One block lifetime: the longest a block stays open after its last symbol
|
|
2825
2882
|
* (inactivity fail bound plus D-28 repair grace).
|
|
2826
2883
|
*/
|
|
2827
|
-
blockLifetimeMsForPacket(packetId: number): number {
|
|
2828
|
-
|
|
2884
|
+
blockLifetimeMsForPacket(packetId: number): number | undefined {
|
|
2885
|
+
const config = this.#trackConfigs.get(packetId)
|
|
2886
|
+
return config === undefined ? undefined : this.#blockLifetimeMs(config)
|
|
2829
2887
|
}
|
|
2830
2888
|
/**
|
|
2831
2889
|
* How long a terminal (clean, recovered or failed) block stays authoritative,
|
|
2832
2890
|
* for late symbols and for the in-order release gate. It is also the gate's
|
|
2833
2891
|
* hold ceiling (MmtpRouter's holdLimitMs): a retired block reads back as
|
|
2834
2892
|
* untracked, which the gate counts as lost, so no frame may still be waiting
|
|
2835
|
-
* on a block that can retire.
|
|
2836
|
-
*
|
|
2837
|
-
*
|
|
2838
|
-
*
|
|
2893
|
+
* on a block that can retire. With a positive catalog span the window is one
|
|
2894
|
+
* interleave depth for a gap's last block to finish arriving, one block
|
|
2895
|
+
* lifetime to fail it, and one more for an owed Worker cleanup. With an
|
|
2896
|
+
* absent/zero span it is a receiver-local cleanup bound only; it creates no
|
|
2897
|
+
* catalog FEC deadline.
|
|
2839
2898
|
*/
|
|
2840
|
-
terminalRetentionMsForPacket(packetId: number): number {
|
|
2841
|
-
const config = this.#
|
|
2899
|
+
terminalRetentionMsForPacket(packetId: number): number | undefined {
|
|
2900
|
+
const config = this.#trackConfigs.get(packetId)
|
|
2901
|
+
if (config === undefined) return undefined
|
|
2842
2902
|
return config.interleaveDepthMs + 2 * this.#blockLifetimeMs(config)
|
|
2843
2903
|
}
|
|
2844
2904
|
/** Remaining fetch budget for a specific repair-requested block. */
|
|
@@ -2846,14 +2906,15 @@ export class FECManager {
|
|
|
2846
2906
|
sbn: number,
|
|
2847
2907
|
packetId: number,
|
|
2848
2908
|
catalogTrackName?: string,
|
|
2849
|
-
): number {
|
|
2909
|
+
): number | undefined {
|
|
2850
2910
|
const deadlineMs = this.#activeBlockDeadlinesMs.get(
|
|
2851
2911
|
this.#blockKey(sbn, packetId, catalogTrackName),
|
|
2852
2912
|
)
|
|
2853
2913
|
if (deadlineMs !== undefined) {
|
|
2854
2914
|
return Math.max(1, Math.ceil(deadlineMs - performance.now()))
|
|
2855
2915
|
}
|
|
2856
|
-
const trackConfig = this.#
|
|
2916
|
+
const trackConfig = this.#trackConfigs.get(packetId)
|
|
2917
|
+
if (trackConfig === undefined) return undefined
|
|
2857
2918
|
return Math.max(1, trackConfig.timeoutMs - this.#repairDeadlineMs(trackConfig))
|
|
2858
2919
|
}
|
|
2859
2920
|
|
|
@@ -2867,15 +2928,20 @@ export class FECManager {
|
|
|
2867
2928
|
return this.#trackConfigs.get(packetId)?.blockProfile
|
|
2868
2929
|
}
|
|
2869
2930
|
|
|
2870
|
-
|
|
2871
|
-
|
|
2931
|
+
/**
|
|
2932
|
+
* Whether a packetId has a configured block geometry. iso-ssbg1-v1 is the
|
|
2933
|
+
* only profile, so every configured track has it; a packetId never
|
|
2934
|
+
* configured (or released) has none and gets no FEC block tracking.
|
|
2935
|
+
*/
|
|
2936
|
+
#hasBlockProfile(packetId: number): boolean {
|
|
2937
|
+
return this.#trackConfigs.get(packetId)?.blockProfile !== undefined
|
|
2872
2938
|
}
|
|
2873
2939
|
|
|
2874
2940
|
#isoLocatorFor(packetId: number, catalogTrackName?: string): IsoBlockLocator<IsoHeldSource> {
|
|
2875
2941
|
const streamKey = this.#streamKey(packetId, catalogTrackName)
|
|
2876
2942
|
let locator = this.#isoLocators.get(streamKey)
|
|
2877
2943
|
if (!locator) {
|
|
2878
|
-
locator = new IsoBlockLocator<IsoHeldSource>(this
|
|
2944
|
+
locator = new IsoBlockLocator<IsoHeldSource>(this.#trackConfig(packetId).k, this.#isoRetentionBlocks(packetId))
|
|
2879
2945
|
this.#isoLocators.set(streamKey, locator)
|
|
2880
2946
|
}
|
|
2881
2947
|
return locator
|
|
@@ -2909,12 +2975,14 @@ export class FECManager {
|
|
|
2909
2975
|
*/
|
|
2910
2976
|
#isoRetentionBlocks(packetId: number): number {
|
|
2911
2977
|
const config = this.#trackConfigs.get(packetId)
|
|
2912
|
-
if (config?.blockProfile
|
|
2978
|
+
if (config?.blockProfile === undefined) {
|
|
2913
2979
|
throw new Error(
|
|
2914
|
-
`[FECManager] packetId=${packetId} has no iso-ssbg1-v1 block
|
|
2980
|
+
`[FECManager] packetId=${packetId} has no configured iso-ssbg1-v1 block profile`,
|
|
2915
2981
|
)
|
|
2916
2982
|
}
|
|
2917
|
-
|
|
2983
|
+
if (!FECManager.#hasCatalogTiming(config)) return LOCAL_FEC_RETENTION_BLOCKS
|
|
2984
|
+
const terminalRetentionMs = config.interleaveDepthMs + 2 * this.#blockLifetimeMs(config)
|
|
2985
|
+
const blocks = Math.ceil(terminalRetentionMs / config.interleaveDepthMs) + 1
|
|
2918
2986
|
if (!Number.isSafeInteger(blocks) || blocks <= 0) {
|
|
2919
2987
|
throw new Error(`[FECManager] packetId=${packetId} iso-ssbg1-v1 retention of ${blocks} blocks is not derivable`)
|
|
2920
2988
|
}
|
|
@@ -2923,7 +2991,8 @@ export class FECManager {
|
|
|
2923
2991
|
|
|
2924
2992
|
/** Whether an iso-ssbg1-v1 protected packet fits one ssbg_mode1 symbol (len + 2 <= T). */
|
|
2925
2993
|
isoSourceFits(packetId: number, packetLength: number): boolean {
|
|
2926
|
-
|
|
2994
|
+
const symbolSize = this.#trackConfigs.get(packetId)?.symbolSize
|
|
2995
|
+
return symbolSize !== undefined && ssbg1FitsSymbol(packetLength, symbolSize)
|
|
2927
2996
|
}
|
|
2928
2997
|
|
|
2929
2998
|
/**
|
|
@@ -3010,11 +3079,11 @@ export class FECManager {
|
|
|
3010
3079
|
* that could hold them is pending or not yet stated by a repair, else the
|
|
3011
3080
|
* starts of the blocks that failed or vanished.
|
|
3012
3081
|
*
|
|
3013
|
-
* `untracked` reads
|
|
3014
|
-
*
|
|
3015
|
-
*
|
|
3016
|
-
*
|
|
3017
|
-
* an SS_Start
|
|
3082
|
+
* `untracked` reads as the release gate reads it (MmtpRouter
|
|
3083
|
+
* #createFecReleaseGate): a block holding either released frame's SS_ID
|
|
3084
|
+
* (`fromSsId` or `toSsId`) delivered that frame, so untracked there means it
|
|
3085
|
+
* resolved and retired; a block starting after the stream's frontier
|
|
3086
|
+
* (`highestSbn`, an SS_Start) may still be heard from; a block at or behind the
|
|
3018
3087
|
* frontier that no symbol of this manager ever reached vanished, and its
|
|
3019
3088
|
* media is lost.
|
|
3020
3089
|
*/
|
|
@@ -3107,6 +3176,10 @@ export class FECManager {
|
|
|
3107
3176
|
packetId: number,
|
|
3108
3177
|
catalogTrackName?: string,
|
|
3109
3178
|
): { mode: ClassifierMode; reason: ClassifierReason | null } {
|
|
3179
|
+
// A no-span stream has no catalog timing with which to classify blocks.
|
|
3180
|
+
// Keep the existing fail-closed shape for callers that still query this
|
|
3181
|
+
// accessor, while the span sentinel tells them this mode is local-only.
|
|
3182
|
+
if (!this.#hasCatalogTimingForPacket(packetId)) return { mode: 'all-protected', reason: null }
|
|
3110
3183
|
const classifier = this.#classifierFor(packetId, catalogTrackName)
|
|
3111
3184
|
return { mode: classifier.mode, reason: classifier.reason }
|
|
3112
3185
|
}
|
|
@@ -3117,11 +3190,13 @@ export class FECManager {
|
|
|
3117
3190
|
* it does not. A stream with no classifier yet has shown nothing against it.
|
|
3118
3191
|
*/
|
|
3119
3192
|
mpuBoundsRapsFor(packetId: number, catalogTrackName?: string): boolean {
|
|
3193
|
+
if (!this.#hasCatalogTimingForPacket(packetId)) return false
|
|
3120
3194
|
return this.#classifiers.get(this.#streamKey(packetId, catalogTrackName))?.mpuBoundsRaps ?? true
|
|
3121
3195
|
}
|
|
3122
3196
|
|
|
3123
3197
|
/** A block's class now, or frozen at its resolution. */
|
|
3124
3198
|
blockClassFor(sbn: number, packetId: number, catalogTrackName?: string): BlockClass {
|
|
3199
|
+
if (!this.#hasCatalogTimingForPacket(packetId)) return 'unknown'
|
|
3125
3200
|
const frozen = this.#resolvedBlockClasses.get(this.#blockKey(sbn, packetId, catalogTrackName))
|
|
3126
3201
|
if (frozen !== undefined) return frozen
|
|
3127
3202
|
return this.#peekClass(sbn, packetId, catalogTrackName)
|
|
@@ -3152,7 +3227,7 @@ export class FECManager {
|
|
|
3152
3227
|
presentationTime: bigint,
|
|
3153
3228
|
mediaTimescale: number,
|
|
3154
3229
|
): void {
|
|
3155
|
-
if (!this.#trackConfigs.has(packetId)) return
|
|
3230
|
+
if (!this.#trackConfigs.has(packetId) || !this.#hasCatalogTimingForPacket(packetId)) return
|
|
3156
3231
|
this.#applyClassifierChanges(
|
|
3157
3232
|
packetId,
|
|
3158
3233
|
catalogTrackName,
|
|
@@ -3170,36 +3245,56 @@ export class FECManager {
|
|
|
3170
3245
|
|
|
3171
3246
|
/** Configure FEC parameters. */
|
|
3172
3247
|
configure(config: FECManagerConfig): void {
|
|
3173
|
-
|
|
3248
|
+
// Validate timing before changing any manager-global field. A malformed
|
|
3249
|
+
// value must not leave a partially applied configuration (especially an
|
|
3250
|
+
// infinite local cleanup budget, which would never expire).
|
|
3251
|
+
if (
|
|
3252
|
+
config.interleaveDepthMs != null &&
|
|
3253
|
+
(!Number.isSafeInteger(config.interleaveDepthMs) || config.interleaveDepthMs < 0)
|
|
3254
|
+
) {
|
|
3255
|
+
throw new Error(
|
|
3256
|
+
`[FECManager] interleaveDepthMs=${config.interleaveDepthMs} must be a non-negative safe integer in milliseconds`,
|
|
3257
|
+
)
|
|
3258
|
+
}
|
|
3259
|
+
if (
|
|
3260
|
+
config.timeoutMs != null &&
|
|
3261
|
+
(!Number.isFinite(config.timeoutMs) || config.timeoutMs < 0)
|
|
3262
|
+
) {
|
|
3263
|
+
throw new Error(
|
|
3264
|
+
`[FECManager] timeoutMs=${config.timeoutMs} must be a finite non-negative cleanup budget`,
|
|
3265
|
+
)
|
|
3266
|
+
}
|
|
3267
|
+
if (config.k != null && (!Number.isSafeInteger(config.k) || config.k <= 0)) {
|
|
3268
|
+
throw new Error(`[FECManager] k=${config.k} must be a positive integer`)
|
|
3269
|
+
}
|
|
3270
|
+
if (config.k != null) this.#streamK = config.k
|
|
3174
3271
|
if (config.symbolSize != null && config.symbolSize > 0) this.#fecSymbolSize = config.symbolSize
|
|
3175
3272
|
if (config.interleaveDepthMs != null) this.#fecInterleaveDepthMs = config.interleaveDepthMs
|
|
3176
3273
|
if (config.fps != null && Number.isFinite(config.fps) && config.fps > 0) {
|
|
3177
3274
|
this.#fecFps = config.fps
|
|
3178
3275
|
}
|
|
3179
|
-
// interleaveDepthMs is in milliseconds per spec §5.1.
|
|
3180
|
-
// Valid range: 33ms (interactive/gaming) to 10000ms (broadcast ATSC 3.0).
|
|
3181
|
-
// Warn if value looks like frame count instead of ms (common misconfiguration).
|
|
3182
|
-
if (config.interleaveDepthMs != null && config.interleaveDepthMs > 0 && config.interleaveDepthMs < MIN_INTERLEAVE_DEPTH_MS) {
|
|
3183
|
-
console.warn(`[FECManager] interleaveDepthMs=${config.interleaveDepthMs} looks like frame count, not milliseconds (§5.1 requires ms). Expected range: ${MIN_INTERLEAVE_DEPTH_MS}-10000ms.`)
|
|
3184
|
-
}
|
|
3185
3276
|
if (config.timeoutMs != null && config.timeoutMs > 0) {
|
|
3186
3277
|
this.#fecTimeoutMs = config.timeoutMs
|
|
3278
|
+
} else if (config.interleaveDepthMs === 0) {
|
|
3279
|
+
// An explicit zero span removes the catalog deadline. Reset the global
|
|
3280
|
+
// budget to the bounded receiver-local fallback unless this call also
|
|
3281
|
+
// supplied an explicit positive local timeout above.
|
|
3282
|
+
this.#fecTimeoutMs = LOCAL_FEC_TIMEOUT_MS
|
|
3187
3283
|
} else if (
|
|
3188
3284
|
config.interleaveDepthMs != null &&
|
|
3285
|
+
Number.isSafeInteger(config.interleaveDepthMs) &&
|
|
3189
3286
|
config.interleaveDepthMs >= MIN_INTERLEAVE_DEPTH_MS
|
|
3190
3287
|
) {
|
|
3191
|
-
|
|
3192
|
-
|
|
3193
|
-
sourceSymbols: this.#fecK,
|
|
3194
|
-
symbolSize: this.#fecSymbolSize,
|
|
3195
|
-
mediaUnitsPerSecond: config.fps,
|
|
3196
|
-
})
|
|
3288
|
+
// The stream has no K (a K is per track, BLO-45953); none feeds the window.
|
|
3289
|
+
this.#fecTimeoutMs = fecSpanDeliveryWindowMs(config.interleaveDepthMs)
|
|
3197
3290
|
}
|
|
3198
3291
|
// A shared multicast parser receives every packetId. Keep existing track
|
|
3199
3292
|
// deadlines at least as wide as the selected video delivery envelope so a
|
|
3200
3293
|
// short audio interleave cannot expire during browser/AMT scheduling gaps.
|
|
3201
3294
|
for (const [packetId, track] of this.#trackConfigs) {
|
|
3202
|
-
|
|
3295
|
+
// A track without a positive catalog span owns only its receiver-local
|
|
3296
|
+
// cleanup budget; never widen it with another track's catalog timing.
|
|
3297
|
+
if (FECManager.#hasCatalogTiming(track) && track.timeoutMs < this.#fecTimeoutMs) {
|
|
3203
3298
|
this.#trackConfigs.set(packetId, { ...track, timeoutMs: this.#fecTimeoutMs })
|
|
3204
3299
|
}
|
|
3205
3300
|
}
|
|
@@ -3277,7 +3372,7 @@ export class FECManager {
|
|
|
3277
3372
|
)
|
|
3278
3373
|
}
|
|
3279
3374
|
if (config) this.#upsertTrackConfig(packetId, config, catalogTrackName)
|
|
3280
|
-
const workerK = this.#
|
|
3375
|
+
const workerK = this.#trackConfig(packetId).k
|
|
3281
3376
|
this.#workerClients.set(streamKey, client)
|
|
3282
3377
|
this.#releasedWorkerClients.delete(client)
|
|
3283
3378
|
|
|
@@ -3289,7 +3384,8 @@ export class FECManager {
|
|
|
3289
3384
|
// ESI-less event as recovered would report healthy FEC while dropping
|
|
3290
3385
|
// the media. Enforce the Worker contract before any recovery metric.
|
|
3291
3386
|
// The Worker names the recovered block's authored SSB_length; ESIs
|
|
3292
|
-
//
|
|
3387
|
+
// at or past it are not source symbols of the block and are never
|
|
3388
|
+
// emitted.
|
|
3293
3389
|
if (
|
|
3294
3390
|
!Number.isInteger(meta.ssbLength) ||
|
|
3295
3391
|
meta.ssbLength! <= 0 ||
|
|
@@ -3520,7 +3616,7 @@ export class FECManager {
|
|
|
3520
3616
|
return
|
|
3521
3617
|
}
|
|
3522
3618
|
this.#settleOwedCleanup(key, 'cleanup-ack-timeout')
|
|
3523
|
-
}, Math.ceil(this.#liveBlockLifetimeMs(this.#
|
|
3619
|
+
}, Math.ceil(this.#liveBlockLifetimeMs(this.#trackConfig(packetId)))),
|
|
3524
3620
|
}
|
|
3525
3621
|
this.#pendingWorkerCleanupBounds.set(key, bound)
|
|
3526
3622
|
}
|
|
@@ -3568,18 +3664,20 @@ export class FECManager {
|
|
|
3568
3664
|
if (this.#fpsDetected || fps <= 0) return
|
|
3569
3665
|
this.#fpsDetected = true
|
|
3570
3666
|
this.#fecFps = fps
|
|
3571
|
-
// Only a valid §5.1 ms interleave refines the
|
|
3572
|
-
//
|
|
3573
|
-
if (
|
|
3574
|
-
this.#
|
|
3575
|
-
|
|
3576
|
-
|
|
3577
|
-
|
|
3578
|
-
mediaUnitsPerSecond: fps,
|
|
3579
|
-
})
|
|
3667
|
+
// Only a valid non-negative integer §5.1 ms interleave refines the
|
|
3668
|
+
// timeout; zero is the no-deadline sentinel.
|
|
3669
|
+
if (
|
|
3670
|
+
Number.isSafeInteger(this.#fecInterleaveDepthMs) &&
|
|
3671
|
+
this.#fecInterleaveDepthMs >= MIN_INTERLEAVE_DEPTH_MS
|
|
3672
|
+
) {
|
|
3673
|
+
this.#fecTimeoutMs = fecSpanDeliveryWindowMs(this.#fecInterleaveDepthMs)
|
|
3580
3674
|
}
|
|
3581
3675
|
for (const [packetId, config] of this.#trackConfigs) {
|
|
3582
|
-
if (
|
|
3676
|
+
if (
|
|
3677
|
+
config.fps !== undefined ||
|
|
3678
|
+
!Number.isSafeInteger(config.interleaveDepthMs) ||
|
|
3679
|
+
config.interleaveDepthMs < MIN_INTERLEAVE_DEPTH_MS
|
|
3680
|
+
) continue
|
|
3583
3681
|
this.#trackConfigs.set(packetId, {
|
|
3584
3682
|
...config,
|
|
3585
3683
|
fps,
|
|
@@ -3614,36 +3712,31 @@ export class FECManager {
|
|
|
3614
3712
|
packetId: number,
|
|
3615
3713
|
ssId: number,
|
|
3616
3714
|
symbolData: Uint8Array,
|
|
3617
|
-
alta?: { auth: Uint8Array; payloadEnd: number },
|
|
3618
3715
|
catalogTrackName?: string,
|
|
3619
3716
|
): Uint8Array | null {
|
|
3620
3717
|
this.#fecStats.sourcePackets++
|
|
3621
3718
|
this.#statsForPacket(packetId).sourcePackets++
|
|
3622
|
-
|
|
3623
|
-
|
|
3624
|
-
|
|
3625
|
-
|
|
3626
|
-
|
|
3627
|
-
|
|
3628
|
-
|
|
3629
|
-
|
|
3630
|
-
|
|
3631
|
-
|
|
3632
|
-
|
|
3633
|
-
|
|
3634
|
-
|
|
3635
|
-
|
|
3636
|
-
|
|
3637
|
-
|
|
3638
|
-
|
|
3639
|
-
|
|
3640
|
-
|
|
3641
|
-
sbn = located.block.start
|
|
3642
|
-
fecData = symbolData
|
|
3643
|
-
} else {
|
|
3644
|
-
fecData = this.#normalizeSymbolData(packetId, symbolData)
|
|
3645
|
-
sbn = Math.floor(ssId / this.kForPacket(packetId))
|
|
3719
|
+
// A packetId with no configured block profile has no block geometry and
|
|
3720
|
+
// no decoder (setFecDecoder/setFecWorker configure the track): nothing to
|
|
3721
|
+
// decode.
|
|
3722
|
+
if (!this.#hasBlockProfile(packetId)) return null
|
|
3723
|
+
// The decoder builds the ssbg_mode1 symbol from the exact protected
|
|
3724
|
+
// packet, so the packet travels unpadded. Its block must already be
|
|
3725
|
+
// stated (MmtpRouter holds a source until a repair places it).
|
|
3726
|
+
const locator = this.#isoLocatorFor(packetId, catalogTrackName)
|
|
3727
|
+
const located = locator.locate(ssId)
|
|
3728
|
+
if (located === null) {
|
|
3729
|
+
throw new Error(
|
|
3730
|
+
`[FECManager] iso-ssbg1-v1 source SS_ID=${ssId} (packetId=${packetId}) has no stated block; ` +
|
|
3731
|
+
'hold it until a repair places it (placeIsoRepair)',
|
|
3732
|
+
)
|
|
3733
|
+
}
|
|
3734
|
+
locator.observe(ssId)
|
|
3735
|
+
if (!ssbg1FitsSymbol(symbolData.byteLength, this.#trackConfig(packetId).symbolSize)) {
|
|
3736
|
+
this.#isoSourceOversizeCount++
|
|
3737
|
+
return null
|
|
3646
3738
|
}
|
|
3739
|
+
const sbn = located.block.start
|
|
3647
3740
|
const blockKey = this.#blockKey(sbn, packetId, catalogTrackName)
|
|
3648
3741
|
const syncBlockOwner = this.#syncDecoderBlockOwners.get(blockKey)
|
|
3649
3742
|
|
|
@@ -3651,36 +3744,19 @@ export class FECManager {
|
|
|
3651
3744
|
const workerClient = this.#routableWorkerForPacket(packetId, catalogTrackName)
|
|
3652
3745
|
if (workerClient && !syncBlockOwner) {
|
|
3653
3746
|
if (!this.#claimDecoderBlock(workerClient, sbn, catalogTrackName)) return null
|
|
3654
|
-
// Transfer an ArrayBuffer nothing else references.
|
|
3655
|
-
//
|
|
3656
|
-
//
|
|
3657
|
-
|
|
3658
|
-
|
|
3659
|
-
|
|
3660
|
-
|
|
3661
|
-
|
|
3662
|
-
|
|
3663
|
-
) as ArrayBuffer
|
|
3664
|
-
// Pass the flat SS_ID through to the worker. The WASM decoder derives
|
|
3665
|
-
// SBN/ESI internally per ISO 23008-1 §C.5.2; the WASM add_source
|
|
3747
|
+
// Transfer an ArrayBuffer nothing else references. The source travels
|
|
3748
|
+
// unpadded, and a caller's buffer may be a view into a larger packet,
|
|
3749
|
+
// so it is copied first (T-03-06).
|
|
3750
|
+
const buf = symbolData.buffer.slice(
|
|
3751
|
+
symbolData.byteOffset,
|
|
3752
|
+
symbolData.byteOffset + symbolData.byteLength,
|
|
3753
|
+
) as ArrayBuffer
|
|
3754
|
+
// Pass the flat SS_ID through to the worker. The WASM decoder places
|
|
3755
|
+
// the source in its block by SS_ID (ISO 23008-1 §C.5.2); the WASM add_source
|
|
3666
3756
|
// signature is (ss_id, data, timestamp) — pre-computing sbn/esi on this
|
|
3667
3757
|
// side produces wrong WASM argument alignment and silently breaks
|
|
3668
3758
|
// block assembly.
|
|
3669
|
-
|
|
3670
|
-
// Copy auth into a fresh ArrayBuffer to transfer zero-copy. The
|
|
3671
|
-
// underlying buffer of the parsed trailer view belongs to the wire
|
|
3672
|
-
// packet, which may be transferred separately or reused.
|
|
3673
|
-
const authBuf = alta.auth.buffer.slice(
|
|
3674
|
-
alta.auth.byteOffset,
|
|
3675
|
-
alta.auth.byteOffset + alta.auth.byteLength,
|
|
3676
|
-
) as ArrayBuffer
|
|
3677
|
-
workerClient.feedSource(ssId, buf, performance.now(), {
|
|
3678
|
-
auth: authBuf,
|
|
3679
|
-
payloadEnd: alta.payloadEnd,
|
|
3680
|
-
})
|
|
3681
|
-
} else {
|
|
3682
|
-
workerClient.feedSource(ssId, buf, performance.now())
|
|
3683
|
-
}
|
|
3759
|
+
workerClient.feedSource(ssId, buf, performance.now())
|
|
3684
3760
|
return null
|
|
3685
3761
|
}
|
|
3686
3762
|
|
|
@@ -3693,7 +3769,7 @@ export class FECManager {
|
|
|
3693
3769
|
|
|
3694
3770
|
let recovered: Uint8Array | null = null
|
|
3695
3771
|
try {
|
|
3696
|
-
recovered = client.add_source(ssId,
|
|
3772
|
+
recovered = client.add_source(ssId, symbolData, performance.now())
|
|
3697
3773
|
} catch {
|
|
3698
3774
|
// WASM RefCell panic — decoder instance shared with multicast repair path
|
|
3699
3775
|
}
|
|
@@ -3722,7 +3798,10 @@ export class FECManager {
|
|
|
3722
3798
|
): Uint8Array | null {
|
|
3723
3799
|
this.#fecStats.repairPackets++
|
|
3724
3800
|
this.#statsForPacket(packetId).repairPackets++
|
|
3725
|
-
|
|
3801
|
+
// A packetId with no configured block profile has no block geometry: its
|
|
3802
|
+
// repair names no block this manager can track or decode.
|
|
3803
|
+
if (!this.#hasBlockProfile(packetId)) return null
|
|
3804
|
+
const symbolSize = this.#trackConfig(packetId).symbolSize
|
|
3726
3805
|
if (symbolSize > 0 && repairData.byteLength !== symbolSize) {
|
|
3727
3806
|
this.#repairSymbolSizeMismatchCount++
|
|
3728
3807
|
if (this.#repairSymbolSizeMismatchCount <= 5 || this.#repairSymbolSizeMismatchCount % 100 === 0) {
|
|
@@ -3734,25 +3813,17 @@ export class FECManager {
|
|
|
3734
3813
|
}
|
|
3735
3814
|
const fecData = repairData
|
|
3736
3815
|
|
|
3737
|
-
//
|
|
3738
|
-
//
|
|
3739
|
-
//
|
|
3740
|
-
// Keep the wire tuple unchanged when calling the
|
|
3741
|
-
|
|
3742
|
-
|
|
3743
|
-
|
|
3744
|
-
|
|
3745
|
-
|
|
3746
|
-
// placed the block before feeding its repair (placeIsoRepair).
|
|
3747
|
-
const block = this.#isoLocatorFor(packetId, catalogTrackName).blockAt(ssStart)
|
|
3748
|
-
if (ssbLength <= 0 || ssbLength > k || block === undefined || block.span || block.length !== ssbLength) {
|
|
3749
|
-
return null
|
|
3750
|
-
}
|
|
3751
|
-
sbn = ssStart
|
|
3752
|
-
} else {
|
|
3753
|
-
if (ssbLength <= 0 || ssbLength > k || ssStart % k !== 0) return null
|
|
3754
|
-
sbn = Math.floor(ssStart / k)
|
|
3816
|
+
// ISO/IEC 23008-1 C.5.3: the block is [SS_Start, SS_Start + SSB_length),
|
|
3817
|
+
// K' = SSB_length, and the catalog K is only its maximum. The block is
|
|
3818
|
+
// keyed by its SS_Start. MmtpRouter placed the block before feeding its
|
|
3819
|
+
// repair (placeIsoRepair). Keep the wire tuple unchanged when calling the
|
|
3820
|
+
// decoder below.
|
|
3821
|
+
const k = this.#trackConfig(packetId).k
|
|
3822
|
+
const block = this.#isoLocatorFor(packetId, catalogTrackName).blockAt(ssStart)
|
|
3823
|
+
if (ssbLength <= 0 || ssbLength > k || block === undefined || block.span || block.length !== ssbLength) {
|
|
3824
|
+
return null
|
|
3755
3825
|
}
|
|
3826
|
+
const sbn = ssStart
|
|
3756
3827
|
this.#noteSbnSeen(sbn, packetId, catalogTrackName, 'repair')
|
|
3757
3828
|
|
|
3758
3829
|
// Repair symbols are block activity: refresh the inactivity fail bound so
|
|
@@ -3802,8 +3873,9 @@ export class FECManager {
|
|
|
3802
3873
|
* Record a block's authored SSB_length from a repair symbol. Returns false,
|
|
3803
3874
|
* leaving the block unchanged, when the symbol contradicts the block: a
|
|
3804
3875
|
* different SSB_length than an earlier repair symbol declared is dropped,
|
|
3805
|
-
* and an SSB_length that places an already-received source ESI
|
|
3806
|
-
*
|
|
3876
|
+
* and an SSB_length that places an already-received source ESI at or past
|
|
3877
|
+
* the block's end fails the block, since its geometry can no longer be
|
|
3878
|
+
* trusted.
|
|
3807
3879
|
*/
|
|
3808
3880
|
#noteAuthoredLength(
|
|
3809
3881
|
blockKey: string,
|
|
@@ -3910,7 +3982,7 @@ export class FECManager {
|
|
|
3910
3982
|
packetId: number,
|
|
3911
3983
|
catalogTrackName: string | undefined,
|
|
3912
3984
|
): void {
|
|
3913
|
-
if (!this.#
|
|
3985
|
+
if (!this.#hasBlockProfile(packetId)) return
|
|
3914
3986
|
const newest = this.#isoLocators.get(this.#streamKey(packetId, catalogTrackName))?.newest
|
|
3915
3987
|
if (newest === undefined) return
|
|
3916
3988
|
try {
|
|
@@ -3963,19 +4035,21 @@ export class FECManager {
|
|
|
3963
4035
|
|
|
3964
4036
|
this.#noteSbnSeen(sbn, packetId, catalogTrackName, 'source', evidence.packetSequenceNumber)
|
|
3965
4037
|
|
|
3966
|
-
// A source ESI
|
|
3967
|
-
//
|
|
4038
|
+
// A source ESI at or past the block's authored SSB_length contradicts it;
|
|
4039
|
+
// its geometry can no longer be trusted, so fail it closed.
|
|
3968
4040
|
const authoredLength = this.#blockAuthoredLengths.get(key) ?? k
|
|
3969
4041
|
if (Number.isInteger(esi) && esi! >= authoredLength) {
|
|
3970
4042
|
this.#failBlock(sbn, packetId, catalogTrackName)
|
|
3971
4043
|
return
|
|
3972
4044
|
}
|
|
3973
4045
|
|
|
3974
|
-
|
|
3975
|
-
|
|
3976
|
-
|
|
3977
|
-
|
|
3978
|
-
|
|
4046
|
+
if (FECManager.#hasCatalogTiming(trackConfig)) {
|
|
4047
|
+
this.#applyClassifierChanges(
|
|
4048
|
+
packetId,
|
|
4049
|
+
catalogTrackName,
|
|
4050
|
+
this.#classifierFor(packetId, catalogTrackName).observe(sbn, evidence),
|
|
4051
|
+
)
|
|
4052
|
+
}
|
|
3979
4053
|
|
|
3980
4054
|
// Count source symbols per block
|
|
3981
4055
|
const count = (this.#blockSourceCounts.get(key) ?? 0) + 1
|
|
@@ -4049,6 +4123,9 @@ export class FECManager {
|
|
|
4049
4123
|
catalogTrackName?: string,
|
|
4050
4124
|
sourceProgress = false,
|
|
4051
4125
|
): void {
|
|
4126
|
+
// An unconfigured packetId does no FEC work: no deadline is armed at an
|
|
4127
|
+
// assumed geometry (BLO-45953).
|
|
4128
|
+
if (!this.#trackConfigs.has(packetId)) return
|
|
4052
4129
|
const key = this.#blockKey(sbn, packetId, catalogTrackName)
|
|
4053
4130
|
|
|
4054
4131
|
// Late symbols must not resurrect a block that already completed or failed.
|
|
@@ -4070,7 +4147,7 @@ export class FECManager {
|
|
|
4070
4147
|
return
|
|
4071
4148
|
}
|
|
4072
4149
|
|
|
4073
|
-
const trackConfig = this.#
|
|
4150
|
+
const trackConfig = this.#trackConfig(packetId)
|
|
4074
4151
|
const timeoutMs = this.#multicastWaitMs(trackConfig)
|
|
4075
4152
|
// #computeTimeout never yields <= 0 (computeFecDeliveryWindowMs throws on
|
|
4076
4153
|
// a non-positive interleave or K). Returning here would leave a block
|
|
@@ -4087,6 +4164,7 @@ export class FECManager {
|
|
|
4087
4164
|
// most K+P accepted symbols can move the wait, so the block stays bounded.
|
|
4088
4165
|
const repairDeadline = this.#repairDeadlines.get(key)
|
|
4089
4166
|
if (
|
|
4167
|
+
this.#hasCatalogTimingForPacket(packetId) &&
|
|
4090
4168
|
this.onRepairNeeded &&
|
|
4091
4169
|
!repairRequested &&
|
|
4092
4170
|
(repairDeadline === undefined || sourceProgress)
|
|
@@ -4169,6 +4247,8 @@ export class FECManager {
|
|
|
4169
4247
|
|
|
4170
4248
|
/** Mark a block as completed externally (e.g., after routing recovered data). */
|
|
4171
4249
|
markBlockCompleted(sbn: number, packetId?: number, catalogTrackName?: string): void {
|
|
4250
|
+
// An unconfigured packetId has no FEC blocks to complete (BLO-45953).
|
|
4251
|
+
if (packetId != null && !this.#trackConfigs.has(packetId)) return
|
|
4172
4252
|
for (const key of this.#blockKeysFor(sbn, packetId, catalogTrackName)) {
|
|
4173
4253
|
this.#resolveCompleted(key)
|
|
4174
4254
|
}
|