@blockcast/mmt-wasm 0.3.0 → 0.4.0

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blockcast/mmt-wasm",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "wasm-bindgen builds of the libmmt Rust core (RaptorQ FEC, MMTP MFU reassembly): `pkg` for ESM bundlers and `pkg-no-modules` as a global script for Closure-compiled pages",
5
5
  "main": "pkg/mmt_wasm.js",
6
6
  "types": "pkg/mmt_wasm.d.ts",
package/pkg/mmt_wasm.d.ts CHANGED
@@ -45,6 +45,12 @@ export class FecStats {
45
45
  * Blocks that expired with fewer than K symbols (delivery issue, not FEC issue)
46
46
  */
47
47
  blocks_delivery_failed: bigint;
48
+ /**
49
+ * `iso-ssbg1-v1` held sources evicted, oldest arrival first, because the
50
+ * unplaced pool was at its `(interleave_depth + 1) * K` cap: no sweep
51
+ * (`cleanup_by_ss_start` / `retire_unplaced`) retired them first.
52
+ */
53
+ unplaced_evicted: bigint;
48
54
  }
49
55
 
50
56
  export class MfuFragmentJs {
@@ -100,27 +106,15 @@ export class MmtFecDecoder {
100
106
  /**
101
107
  * Add a repair symbol per ISO 23008-1 §C.5.3.
102
108
  *
103
- * Repair carries (SS_Start, SSB_length, RS_ID).
104
- * SS_Start = SS_ID of first source in block = SBN * K.
105
- * SSB_length = the authored source-symbol count in this block (1..=K).
106
- * SBN = SS_Start / configured K.
107
- * Repair ESI = K + RS_ID.
108
- *
109
- * The decoder's configured K is the fixed RaptorQ geometry. A short
110
- * authored block (`SSB_length < K`) is the producer's K-symbol RaptorQ
111
- * block with ESIs `SSB_length..K` zero-filled and never transmitted
112
- * (fec-raptorq `InterleavedEncoder::force_complete`). The block records
113
- * `SSB_length`, completes once that many source symbols arrived, and
114
- * recovers from `SSB_length` received symbols by supplying the known
115
- * padding itself. A conflicting `SSB_length` for one block is rejected
116
- * without changing that block.
117
- *
118
- * Under `iso-ssbg1-v1` the block is `[SS_Start, SS_Start + SSB_length)`
119
- * with `1 <= SSB_length <= K` (K is only the maximum), its RaptorQ geometry
120
- * is K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID
121
- * (C.5.3). The first repair defines the block and claims every held source
122
- * in range. A conflicting SSB_length, or a range overlapping a different
123
- * known block, is refused without changing any block. Output is the K'*T
109
+ * Repair carries (SS_Start, SSB_length, RS_ID). The block is
110
+ * `[SS_Start, SS_Start + SSB_length)` with `1 <= SSB_length <= K` (the
111
+ * configured K is only the maximum), its RaptorQ geometry is
112
+ * K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID.
113
+ * The first repair defines the block and claims every held source in
114
+ * range. A conflicting SSB_length, a range overlapping a different known
115
+ * block, or a start more than `interleave_depth` blocks behind the last
116
+ * `cleanup_by_ss_start`'s `current` (`iso_blocks_behind_lower_bound`), is
117
+ * refused without changing any block. Output is the K'*T
124
118
  * concatenated ssbg_mode1 symbols: split by T and trim by the length field.
125
119
  */
126
120
  add_repair(ss_start: number, ssb_length: number, rs_id: number, data: Uint8Array, timestamp: number): Uint8Array | undefined;
@@ -130,13 +124,12 @@ export class MmtFecDecoder {
130
124
  * SS_ID is a flat 32-bit counter. An unconfigured decoder rejects the
131
125
  * packet.
132
126
  *
133
- * - `k-padded-v1`: derives SBN = floor(SS_ID / K), ESI = SS_ID % K and
134
- * zero-pads `data` to T.
135
- * - `iso-ssbg1-v1`: builds the C.3.3 ssbg_mode1 symbol
136
- * `u16be(len) || data || zero padding` (refusing `len + 2 > T`) and
137
- * places it at ESI = serial distance from the start of the known block
138
- * whose `[SS_Start, SS_Start + SSB_length)` contains SS_ID. A source
139
- * whose block no repair has defined yet is held by SS_ID until one does.
127
+ * Builds the C.3.3 ssbg_mode1 symbol `u16be(len) || data || zero padding`
128
+ * (refusing `len + 2 > T`) and places it at ESI = serial distance from the
129
+ * start of the known block whose `[SS_Start, SS_Start + SSB_length)`
130
+ * contains SS_ID. A source whose block no repair has defined yet is held
131
+ * by SS_ID until one does; at most `(interleave_depth + 1) * K` are held, and
132
+ * the oldest arrival is evicted first (`FecStats::unplaced_evicted`).
140
133
  *
141
134
  * # Arguments
142
135
  * * `ss_id` - Source symbol ID (32-bit monotonic counter)
@@ -152,18 +145,6 @@ export class MmtFecDecoder {
152
145
  * Get alignment (Al) parameter from OTI
153
146
  */
154
147
  get_alignment(): number;
155
- /**
156
- * `k-padded-v1` only: cleanup blocks more than `interleave_depth` blocks
157
- * behind `current_sbn`. Refused under `iso-ssbg1-v1`, which has no SBN
158
- * (use `cleanup_by_ss_start`).
159
- *
160
- * Blocks are ordered by RFC 1982 serial comparison of their first SS_ID
161
- * (`sbn * K mod 2^32`, ISO/IEC 23008-1 C.5.2; BLO-35597 iso:5). For a
162
- * stream that has not wrapped SS_ID that is exactly the old
163
- * `sbn < current_sbn - interleave_depth`; after the wrap it still retires
164
- * the pre-wrap blocks instead of keeping them forever.
165
- */
166
- cleanup_by_sbn(current_sbn: number): Uint32Array;
167
148
  /**
168
149
  * Get sub-blocks (N) parameter from OTI
169
150
  */
@@ -177,11 +158,11 @@ export class MmtFecDecoder {
177
158
  */
178
159
  get_symbol_size(): number;
179
160
  /**
180
- * `iso-ssbg1-v1` only: retire the held source symbols that no repair can
181
- * place any more, by the same rule as `cleanup_by_ss_start`, without
182
- * retiring any block. For a caller that retires blocks itself, by their
183
- * deadlines (`cleanup_blocks_detailed`), and needs only this half. Returns
184
- * how many it retired.
161
+ * Retire the held source symbols that no repair can place any more, by
162
+ * the same rule as `cleanup_by_ss_start`, without retiring any block. For
163
+ * a caller that retires blocks itself, by their deadlines
164
+ * (`cleanup_blocks_detailed`), and needs only this half. Returns how many
165
+ * it retired.
185
166
  */
186
167
  retire_unplaced(current: number): number;
187
168
  /**
@@ -201,11 +182,11 @@ export class MmtFecDecoder {
201
182
  */
202
183
  get_source_blocks(): number;
203
184
  /**
204
- * `iso-ssbg1-v1` only: retire every block, and every held source symbol,
205
- * lying more than `interleave_depth` blocks behind SS_ID `current`, the
206
- * newest SS_ID the caller has seen (no block start or held source follows
207
- * it). A block start or held source that `current` has moved at least
208
- * half the SS_ID space past no longer precedes it and is retired too
185
+ * Retire every block, and every held source symbol, lying more than
186
+ * `interleave_depth` blocks behind SS_ID `current`, the newest SS_ID the
187
+ * caller has seen (no block start or held source follows it). A block
188
+ * start or held source that `current` has moved at least half the SS_ID
189
+ * space past no longer precedes it and is retired too
209
190
  * (`iso_past_horizon`).
210
191
  *
211
192
  * Blocks have no SBN under ssbg_mode1, so distance is measured on the
@@ -221,21 +202,21 @@ export class MmtFecDecoder {
221
202
  */
222
203
  get_interleave_depth(): number;
223
204
  /**
224
- * Finalize only the source blocks whose host-owned deadlines fired.
225
- * Keys are SBNs under `k-padded-v1` and SS_Starts under `iso-ssbg1-v1`.
205
+ * Finalize only the source blocks whose host-owned deadlines fired,
206
+ * named by their SS_Starts.
226
207
  *
227
208
  * The JavaScript FEC manager owns per-block repair grace. A timeout for one
228
209
  * block must therefore not run the decoder's global age scan and evict a
229
210
  * peer block that is still waiting for fetched repair.
230
211
  */
231
- cleanup_blocks_detailed(sbns: Uint32Array): void;
212
+ cleanup_blocks_detailed(ss_starts: Uint32Array): void;
232
213
  /**
233
214
  * Create a new FEC decoder
234
215
  *
235
216
  * # Arguments
236
217
  * * `interleave_depth` - Explicit positive number of interleaved blocks.
237
- * * `block_profile` - Catalog `fec.blockProfile`: `"k-padded-v1"` or
238
- * `"iso-ssbg1-v1"`. Required; any other value is refused.
218
+ * * `block_profile` - Catalog `fec.blockProfile`: `"iso-ssbg1-v1"`.
219
+ * Required; any other value is refused.
239
220
  */
240
221
  constructor(interleave_depth: number, block_profile: string);
241
222
  /**
@@ -270,33 +251,28 @@ export class MmtFecEncoder {
270
251
  * `[SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][symbol: T]`.
271
252
  * Callers split on that stride; `entry i` is at `i * (13 + T)`.
272
253
  *
273
- * `k-padded-v1`: `block` is the Source Block Number and `source_block`
274
- * MUST be exactly `K * symbol_size` bytes — the caller pads the final
275
- * (short) block with zeros, mirroring `InterleavedEncoder` and the FFmpeg
276
- * path. `SS_Start = block * K` (wrapping), `SSB_length = K`.
277
- *
278
- * `iso-ssbg1-v1`: `block` is the SS_Start (the block's first SS_ID) and
279
- * `source_block` is the block's K' ssbg_mode1 symbols (`1 <= K' <= K`,
280
- * `len % T == 0`, each a well-formed C.3.3 symbol). RaptorQ runs over K'
281
- * symbols (F = K'*T) and `SSB_length = K'`.
254
+ * `ss_start` is the block's first SS_ID and `source_block` is the
255
+ * block's K' ssbg_mode1 symbols (`1 <= K' <= K`, `len % T == 0`, each a
256
+ * well-formed C.3.3 symbol). RaptorQ runs over K' symbols (F = K'*T) and
257
+ * `SSB_length = K'`.
282
258
  *
283
259
  * # Arguments
284
- * * `block` - SBN (`k-padded-v1`) or SS_Start (`iso-ssbg1-v1`).
260
+ * * `ss_start` - SS_Start: the block's first SS_ID.
285
261
  * * `source_block` - The block's source symbols, as described above.
286
262
  * * `repair_count` - Number of repair symbols (P) to generate.
287
263
  */
288
- encode_repair(block: number, source_block: Uint8Array, repair_count: number): Uint8Array;
264
+ encode_repair(ss_start: number, source_block: Uint8Array, repair_count: number): Uint8Array;
289
265
  /**
290
266
  * Create an encoder for a fixed `(K, symbol_size)` block geometry.
291
267
  *
292
268
  * Builds the OTI as `ObjectTransmissionInformation::new(K*T, T, 1, 1, 8)`
293
- * (single source block, single sub-block, byte alignment) — matching the
294
- * decoder's recovery model in [`FecBlock::try_decode`] — and pre-computes
295
- * the shared `SourceBlockEncodingPlan` so per-block encoding is cheap.
269
+ * (single source block, single sub-block, byte alignment) — the geometry
270
+ * [`MmtFecDecoder::configure`] reads back. K is the maximum SSB_length;
271
+ * each block is encoded over its own K' symbols (see
272
+ * [`MmtFecEncoder::encode_repair`]).
296
273
  *
297
- * `block_profile` is the catalog `fec.blockProfile` (`"k-padded-v1"` or
298
- * `"iso-ssbg1-v1"`); any other value is refused. Under `iso-ssbg1-v1`, K
299
- * is the maximum SSB_length.
274
+ * `block_profile` is the catalog `fec.blockProfile` (`"iso-ssbg1-v1"`);
275
+ * any other value is refused.
300
276
  */
301
277
  constructor(k: number, symbol_size: number, block_profile: string);
302
278
  /**
@@ -808,7 +784,7 @@ export interface InitOutput {
808
784
  readonly __wbg_get_fecstats_bytes_recovered: (a: number) => bigint;
809
785
  readonly __wbg_get_fecstats_repair_packets: (a: number) => bigint;
810
786
  readonly __wbg_get_fecstats_source_packets: (a: number) => bigint;
811
- readonly __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
787
+ readonly __wbg_get_fecstats_unplaced_evicted: (a: number) => bigint;
812
788
  readonly __wbg_mfufragmentjs_free: (a: number, b: number) => void;
813
789
  readonly __wbg_mmtfecdecoder_free: (a: number, b: number) => void;
814
790
  readonly __wbg_mmtfecencoder_free: (a: number, b: number) => void;
@@ -821,7 +797,6 @@ export interface InitOutput {
821
797
  readonly __wbg_moqfecencoder_free: (a: number, b: number) => void;
822
798
  readonly __wbg_moqfecstatsjs_free: (a: number, b: number) => void;
823
799
  readonly __wbg_reassembledmfujs_free: (a: number, b: number) => void;
824
- readonly __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
825
800
  readonly __wbg_recoveredset_free: (a: number, b: number) => void;
826
801
  readonly __wbg_samplecombinerstatsjs_free: (a: number, b: number) => void;
827
802
  readonly __wbg_set_fecstats_blocks_complete: (a: number, b: bigint) => void;
@@ -831,7 +806,7 @@ export interface InitOutput {
831
806
  readonly __wbg_set_fecstats_bytes_recovered: (a: number, b: bigint) => void;
832
807
  readonly __wbg_set_fecstats_repair_packets: (a: number, b: bigint) => void;
833
808
  readonly __wbg_set_fecstats_source_packets: (a: number, b: bigint) => void;
834
- readonly __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
809
+ readonly __wbg_set_fecstats_unplaced_evicted: (a: number, b: bigint) => void;
835
810
  readonly __wbg_shredfecbuffer_free: (a: number, b: number) => void;
836
811
  readonly __wbg_shredreassembler_free: (a: number, b: number) => void;
837
812
  readonly annexb_access_unit_is_keyframe: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -862,7 +837,6 @@ export interface InitOutput {
862
837
  readonly mmtfecdecoder_add_repair: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
863
838
  readonly mmtfecdecoder_add_source: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
864
839
  readonly mmtfecdecoder_cleanup_blocks_detailed: (a: number, b: number, c: number) => void;
865
- readonly mmtfecdecoder_cleanup_by_sbn: (a: number, b: number) => [number, number, number, number];
866
840
  readonly mmtfecdecoder_cleanup_by_ss_start: (a: number, b: number) => [number, number, number, number];
867
841
  readonly mmtfecdecoder_configure: (a: number, b: number, c: number) => [number, number];
868
842
  readonly mmtfecdecoder_configure_params: (a: number, b: number, c: number) => [number, number];
@@ -957,7 +931,6 @@ export interface InitOutput {
957
931
  readonly reassembledmfujs_sample_number: (a: number) => number;
958
932
  readonly reassembledmfujs_stream_identity: (a: number) => number;
959
933
  readonly reassembledmfujs_timestamp: (a: number) => number;
960
- readonly recoveredset_fec_set_index: (a: number) => number;
961
934
  readonly recoveredset_payload: (a: number) => [number, number];
962
935
  readonly recoveredset_slot: (a: number) => bigint;
963
936
  readonly shredfecbuffer_add_shred: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
@@ -974,7 +947,9 @@ export interface InitOutput {
974
947
  readonly moqfecstatsjs_blocksComplete: (a: number) => number;
975
948
  readonly moqfecstatsjs_blocksIncomplete: (a: number) => number;
976
949
  readonly moqfecstatsjs_totalSymbolsReceived: (a: number) => number;
950
+ readonly recoveredset_fec_set_index: (a: number) => number;
977
951
  readonly shredreassembler_pending_fec_sets: (a: number) => number;
952
+ readonly __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
978
953
  readonly __wbg_get_reassemblerstatsjs_duplicate_fragments: (a: number) => bigint;
979
954
  readonly __wbg_get_reassemblerstatsjs_evicted_data_units: (a: number) => bigint;
980
955
  readonly __wbg_get_reassemblerstatsjs_evicted_memory_limit: (a: number) => bigint;
@@ -986,6 +961,8 @@ export interface InitOutput {
986
961
  readonly __wbg_get_samplecombinerstatsjs_evicted_samples: (a: number) => bigint;
987
962
  readonly __wbg_get_samplecombinerstatsjs_passthrough_samples: (a: number) => bigint;
988
963
  readonly __wbg_get_samplecombinerstatsjs_timed_out_samples: (a: number) => bigint;
964
+ readonly __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
965
+ readonly __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
989
966
  readonly __wbg_set_reassemblerstatsjs_duplicate_fragments: (a: number, b: bigint) => void;
990
967
  readonly __wbg_set_reassemblerstatsjs_evicted_data_units: (a: number, b: bigint) => void;
991
968
  readonly __wbg_set_reassemblerstatsjs_evicted_memory_limit: (a: number, b: bigint) => void;
package/pkg/mmt_wasm.js CHANGED
@@ -529,6 +529,25 @@ export class FecStats {
529
529
  set blocks_delivery_failed(arg0) {
530
530
  wasm.__wbg_set_fecstats_blocks_delivery_failed(this.__wbg_ptr, arg0);
531
531
  }
532
+ /**
533
+ * `iso-ssbg1-v1` held sources evicted, oldest arrival first, because the
534
+ * unplaced pool was at its `(interleave_depth + 1) * K` cap: no sweep
535
+ * (`cleanup_by_ss_start` / `retire_unplaced`) retired them first.
536
+ * @returns {bigint}
537
+ */
538
+ get unplaced_evicted() {
539
+ const ret = wasm.__wbg_get_fecstats_unplaced_evicted(this.__wbg_ptr);
540
+ return BigInt.asUintN(64, ret);
541
+ }
542
+ /**
543
+ * `iso-ssbg1-v1` held sources evicted, oldest arrival first, because the
544
+ * unplaced pool was at its `(interleave_depth + 1) * K` cap: no sweep
545
+ * (`cleanup_by_ss_start` / `retire_unplaced`) retired them first.
546
+ * @param {bigint} arg0
547
+ */
548
+ set unplaced_evicted(arg0) {
549
+ wasm.__wbg_set_fecstats_unplaced_evicted(this.__wbg_ptr, arg0);
550
+ }
532
551
  /**
533
552
  * Recovery rate as percentage (0-100)
534
553
  * Counts all blocks: complete + recovered + FEC-failed + delivery-failed
@@ -670,27 +689,15 @@ export class MmtFecDecoder {
670
689
  /**
671
690
  * Add a repair symbol per ISO 23008-1 §C.5.3.
672
691
  *
673
- * Repair carries (SS_Start, SSB_length, RS_ID).
674
- * SS_Start = SS_ID of first source in block = SBN * K.
675
- * SSB_length = the authored source-symbol count in this block (1..=K).
676
- * SBN = SS_Start / configured K.
677
- * Repair ESI = K + RS_ID.
678
- *
679
- * The decoder's configured K is the fixed RaptorQ geometry. A short
680
- * authored block (`SSB_length < K`) is the producer's K-symbol RaptorQ
681
- * block with ESIs `SSB_length..K` zero-filled and never transmitted
682
- * (fec-raptorq `InterleavedEncoder::force_complete`). The block records
683
- * `SSB_length`, completes once that many source symbols arrived, and
684
- * recovers from `SSB_length` received symbols by supplying the known
685
- * padding itself. A conflicting `SSB_length` for one block is rejected
686
- * without changing that block.
687
- *
688
- * Under `iso-ssbg1-v1` the block is `[SS_Start, SS_Start + SSB_length)`
689
- * with `1 <= SSB_length <= K` (K is only the maximum), its RaptorQ geometry
690
- * is K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID
691
- * (C.5.3). The first repair defines the block and claims every held source
692
- * in range. A conflicting SSB_length, or a range overlapping a different
693
- * known block, is refused without changing any block. Output is the K'*T
692
+ * Repair carries (SS_Start, SSB_length, RS_ID). The block is
693
+ * `[SS_Start, SS_Start + SSB_length)` with `1 <= SSB_length <= K` (the
694
+ * configured K is only the maximum), its RaptorQ geometry is
695
+ * K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID.
696
+ * The first repair defines the block and claims every held source in
697
+ * range. A conflicting SSB_length, a range overlapping a different known
698
+ * block, or a start more than `interleave_depth` blocks behind the last
699
+ * `cleanup_by_ss_start`'s `current` (`iso_blocks_behind_lower_bound`), is
700
+ * refused without changing any block. Output is the K'*T
694
701
  * concatenated ssbg_mode1 symbols: split by T and trim by the length field.
695
702
  * @param {number} ss_start
696
703
  * @param {number} ssb_length
@@ -719,13 +726,12 @@ export class MmtFecDecoder {
719
726
  * SS_ID is a flat 32-bit counter. An unconfigured decoder rejects the
720
727
  * packet.
721
728
  *
722
- * - `k-padded-v1`: derives SBN = floor(SS_ID / K), ESI = SS_ID % K and
723
- * zero-pads `data` to T.
724
- * - `iso-ssbg1-v1`: builds the C.3.3 ssbg_mode1 symbol
725
- * `u16be(len) || data || zero padding` (refusing `len + 2 > T`) and
726
- * places it at ESI = serial distance from the start of the known block
727
- * whose `[SS_Start, SS_Start + SSB_length)` contains SS_ID. A source
728
- * whose block no repair has defined yet is held by SS_ID until one does.
729
+ * Builds the C.3.3 ssbg_mode1 symbol `u16be(len) || data || zero padding`
730
+ * (refusing `len + 2 > T`) and places it at ESI = serial distance from the
731
+ * start of the known block whose `[SS_Start, SS_Start + SSB_length)`
732
+ * contains SS_ID. A source whose block no repair has defined yet is held
733
+ * by SS_ID until one does; at most `(interleave_depth + 1) * K` are held, and
734
+ * the oldest arrival is evicted first (`FecStats::unplaced_evicted`).
729
735
  *
730
736
  * # Arguments
731
737
  * * `ss_id` - Source symbol ID (32-bit monotonic counter)
@@ -767,28 +773,6 @@ export class MmtFecDecoder {
767
773
  }
768
774
  return ret[0];
769
775
  }
770
- /**
771
- * `k-padded-v1` only: cleanup blocks more than `interleave_depth` blocks
772
- * behind `current_sbn`. Refused under `iso-ssbg1-v1`, which has no SBN
773
- * (use `cleanup_by_ss_start`).
774
- *
775
- * Blocks are ordered by RFC 1982 serial comparison of their first SS_ID
776
- * (`sbn * K mod 2^32`, ISO/IEC 23008-1 C.5.2; BLO-35597 iso:5). For a
777
- * stream that has not wrapped SS_ID that is exactly the old
778
- * `sbn < current_sbn - interleave_depth`; after the wrap it still retires
779
- * the pre-wrap blocks instead of keeping them forever.
780
- * @param {number} current_sbn
781
- * @returns {Uint32Array}
782
- */
783
- cleanup_by_sbn(current_sbn) {
784
- const ret = wasm.mmtfecdecoder_cleanup_by_sbn(this.__wbg_ptr, current_sbn);
785
- if (ret[3]) {
786
- throw takeFromExternrefTable0(ret[2]);
787
- }
788
- var v1 = getArrayU32FromWasm0(ret[0], ret[1]).slice();
789
- wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
790
- return v1;
791
- }
792
776
  /**
793
777
  * Get sub-blocks (N) parameter from OTI
794
778
  * @returns {number}
@@ -820,11 +804,11 @@ export class MmtFecDecoder {
820
804
  return ret[0];
821
805
  }
822
806
  /**
823
- * `iso-ssbg1-v1` only: retire the held source symbols that no repair can
824
- * place any more, by the same rule as `cleanup_by_ss_start`, without
825
- * retiring any block. For a caller that retires blocks itself, by their
826
- * deadlines (`cleanup_blocks_detailed`), and needs only this half. Returns
827
- * how many it retired.
807
+ * Retire the held source symbols that no repair can place any more, by
808
+ * the same rule as `cleanup_by_ss_start`, without retiring any block. For
809
+ * a caller that retires blocks itself, by their deadlines
810
+ * (`cleanup_blocks_detailed`), and needs only this half. Returns how many
811
+ * it retired.
828
812
  * @param {number} current
829
813
  * @returns {number}
830
814
  */
@@ -878,11 +862,11 @@ export class MmtFecDecoder {
878
862
  return ret[0];
879
863
  }
880
864
  /**
881
- * `iso-ssbg1-v1` only: retire every block, and every held source symbol,
882
- * lying more than `interleave_depth` blocks behind SS_ID `current`, the
883
- * newest SS_ID the caller has seen (no block start or held source follows
884
- * it). A block start or held source that `current` has moved at least
885
- * half the SS_ID space past no longer precedes it and is retired too
865
+ * Retire every block, and every held source symbol, lying more than
866
+ * `interleave_depth` blocks behind SS_ID `current`, the newest SS_ID the
867
+ * caller has seen (no block start or held source follows it). A block
868
+ * start or held source that `current` has moved at least half the SS_ID
869
+ * space past no longer precedes it and is retired too
886
870
  * (`iso_past_horizon`).
887
871
  *
888
872
  * Blocks have no SBN under ssbg_mode1, so distance is measured on the
@@ -912,16 +896,16 @@ export class MmtFecDecoder {
912
896
  return ret >>> 0;
913
897
  }
914
898
  /**
915
- * Finalize only the source blocks whose host-owned deadlines fired.
916
- * Keys are SBNs under `k-padded-v1` and SS_Starts under `iso-ssbg1-v1`.
899
+ * Finalize only the source blocks whose host-owned deadlines fired,
900
+ * named by their SS_Starts.
917
901
  *
918
902
  * The JavaScript FEC manager owns per-block repair grace. A timeout for one
919
903
  * block must therefore not run the decoder's global age scan and evict a
920
904
  * peer block that is still waiting for fetched repair.
921
- * @param {Uint32Array} sbns
905
+ * @param {Uint32Array} ss_starts
922
906
  */
923
- cleanup_blocks_detailed(sbns) {
924
- const ptr0 = passArray32ToWasm0(sbns, wasm.__wbindgen_malloc);
907
+ cleanup_blocks_detailed(ss_starts) {
908
+ const ptr0 = passArray32ToWasm0(ss_starts, wasm.__wbindgen_malloc);
925
909
  const len0 = WASM_VECTOR_LEN;
926
910
  wasm.mmtfecdecoder_cleanup_blocks_detailed(this.__wbg_ptr, ptr0, len0);
927
911
  }
@@ -930,8 +914,8 @@ export class MmtFecDecoder {
930
914
  *
931
915
  * # Arguments
932
916
  * * `interleave_depth` - Explicit positive number of interleaved blocks.
933
- * * `block_profile` - Catalog `fec.blockProfile`: `"k-padded-v1"` or
934
- * `"iso-ssbg1-v1"`. Required; any other value is refused.
917
+ * * `block_profile` - Catalog `fec.blockProfile`: `"iso-ssbg1-v1"`.
918
+ * Required; any other value is refused.
935
919
  * @param {number} interleave_depth
936
920
  * @param {string} block_profile
937
921
  */
@@ -1011,21 +995,16 @@ if (Symbol.dispose) MmtFecDecoder.prototype[Symbol.dispose] = MmtFecDecoder.prot
1011
995
  * [SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][repair symbol: T]
1012
996
  * ```
1013
997
  *
1014
- * with, for a block with Source Block Number `sbn` and `K` source symbols:
1015
- * - `SS_Start = sbn * K` (32-bit) — first SS_ID of the block. The decoder
1016
- * derives `SBN = SS_Start / K`, so this MUST be `sbn * K`.
998
+ * with, for an `iso-ssbg1-v1` block of K' ssbg_mode1 source symbols
999
+ * (ISO/IEC 23008-1 C.3.3, C.5.2, C.5.3):
1000
+ * - `SS_Start = ` the block's first SS_ID (SS_IDs are consecutive, 32-bit)
1017
1001
  * - `RSB_length = P` (repair count for this block)
1018
- * - `RS_ID = i` (0-based repair index) ⇒ RaptorQ ESI = `K + i`
1019
- * - `SSB_length <= K` (authored source symbols in this block)
1020
- *
1021
- * OTI (Z=1, N=1, Al=8) is delivered out-of-band via the catalog / AL-FEC
1022
- * signaling message — see [`MmtFecEncoder::oti`] — never per-packet.
1002
+ * - `RS_ID = i` (0-based repair index) ⇒ RaptorQ ESI = `K' + i`
1003
+ * - `SSB_length = K'` (`1..=K`; the configured K is only the maximum)
1023
1004
  *
1024
- * That framing is the `k-padded-v1` profile. Under `iso-ssbg1-v1` the same
1025
- * fields carry ISO/IEC 23008-1 C.5.3 semantics: `SS_Start` is the first SS_ID
1026
- * of a block of consecutive SS_IDs, `SSB_length = K'` (`1..=K`), the RaptorQ
1027
- * block is K' symbols with no padding (F = K'*T), and RS_ID `i` is ESI
1028
- * `K' + i`.
1005
+ * The RaptorQ block is K' symbols with no padding (F = K'*T). The configured
1006
+ * OTI (F = K*T, Z=1, N=1, Al=8) is delivered out-of-band via the catalog /
1007
+ * AL-FEC signaling message — see [`MmtFecEncoder::oti`] — never per-packet.
1029
1008
  */
1030
1009
  export class MmtFecEncoder {
1031
1010
  __destroy_into_raw() {
@@ -1070,29 +1049,24 @@ export class MmtFecEncoder {
1070
1049
  * `[SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][symbol: T]`.
1071
1050
  * Callers split on that stride; `entry i` is at `i * (13 + T)`.
1072
1051
  *
1073
- * `k-padded-v1`: `block` is the Source Block Number and `source_block`
1074
- * MUST be exactly `K * symbol_size` bytes — the caller pads the final
1075
- * (short) block with zeros, mirroring `InterleavedEncoder` and the FFmpeg
1076
- * path. `SS_Start = block * K` (wrapping), `SSB_length = K`.
1077
- *
1078
- * `iso-ssbg1-v1`: `block` is the SS_Start (the block's first SS_ID) and
1079
- * `source_block` is the block's K' ssbg_mode1 symbols (`1 <= K' <= K`,
1080
- * `len % T == 0`, each a well-formed C.3.3 symbol). RaptorQ runs over K'
1081
- * symbols (F = K'*T) and `SSB_length = K'`.
1052
+ * `ss_start` is the block's first SS_ID and `source_block` is the
1053
+ * block's K' ssbg_mode1 symbols (`1 <= K' <= K`, `len % T == 0`, each a
1054
+ * well-formed C.3.3 symbol). RaptorQ runs over K' symbols (F = K'*T) and
1055
+ * `SSB_length = K'`.
1082
1056
  *
1083
1057
  * # Arguments
1084
- * * `block` - SBN (`k-padded-v1`) or SS_Start (`iso-ssbg1-v1`).
1058
+ * * `ss_start` - SS_Start: the block's first SS_ID.
1085
1059
  * * `source_block` - The block's source symbols, as described above.
1086
1060
  * * `repair_count` - Number of repair symbols (P) to generate.
1087
- * @param {number} block
1061
+ * @param {number} ss_start
1088
1062
  * @param {Uint8Array} source_block
1089
1063
  * @param {number} repair_count
1090
1064
  * @returns {Uint8Array}
1091
1065
  */
1092
- encode_repair(block, source_block, repair_count) {
1066
+ encode_repair(ss_start, source_block, repair_count) {
1093
1067
  const ptr0 = passArray8ToWasm0(source_block, wasm.__wbindgen_malloc);
1094
1068
  const len0 = WASM_VECTOR_LEN;
1095
- const ret = wasm.mmtfecencoder_encode_repair(this.__wbg_ptr, block, ptr0, len0, repair_count);
1069
+ const ret = wasm.mmtfecencoder_encode_repair(this.__wbg_ptr, ss_start, ptr0, len0, repair_count);
1096
1070
  if (ret[3]) {
1097
1071
  throw takeFromExternrefTable0(ret[2]);
1098
1072
  }
@@ -1112,13 +1086,13 @@ export class MmtFecEncoder {
1112
1086
  * Create an encoder for a fixed `(K, symbol_size)` block geometry.
1113
1087
  *
1114
1088
  * Builds the OTI as `ObjectTransmissionInformation::new(K*T, T, 1, 1, 8)`
1115
- * (single source block, single sub-block, byte alignment) — matching the
1116
- * decoder's recovery model in [`FecBlock::try_decode`] — and pre-computes
1117
- * the shared `SourceBlockEncodingPlan` so per-block encoding is cheap.
1089
+ * (single source block, single sub-block, byte alignment) — the geometry
1090
+ * [`MmtFecDecoder::configure`] reads back. K is the maximum SSB_length;
1091
+ * each block is encoded over its own K' symbols (see
1092
+ * [`MmtFecEncoder::encode_repair`]).
1118
1093
  *
1119
- * `block_profile` is the catalog `fec.blockProfile` (`"k-padded-v1"` or
1120
- * `"iso-ssbg1-v1"`); any other value is refused. Under `iso-ssbg1-v1`, K
1121
- * is the maximum SSB_length.
1094
+ * `block_profile` is the catalog `fec.blockProfile` (`"iso-ssbg1-v1"`);
1095
+ * any other value is refused.
1122
1096
  * @param {number} k
1123
1097
  * @param {number} symbol_size
1124
1098
  * @param {string} block_profile
@@ -2286,14 +2260,14 @@ export class ReassemblerStatsJs {
2286
2260
  * @returns {bigint}
2287
2261
  */
2288
2262
  get ambiguous_fallback_fragments() {
2289
- const ret = wasm.__wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments(this.__wbg_ptr);
2263
+ const ret = wasm.__wbg_get_fecstats_unplaced_evicted(this.__wbg_ptr);
2290
2264
  return BigInt.asUintN(64, ret);
2291
2265
  }
2292
2266
  /**
2293
2267
  * @param {bigint} arg0
2294
2268
  */
2295
2269
  set ambiguous_fallback_fragments(arg0) {
2296
- wasm.__wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments(this.__wbg_ptr, arg0);
2270
+ wasm.__wbg_set_fecstats_unplaced_evicted(this.__wbg_ptr, arg0);
2297
2271
  }
2298
2272
  }
2299
2273
  if (Symbol.dispose) ReassemblerStatsJs.prototype[Symbol.dispose] = ReassemblerStatsJs.prototype.free;
@@ -2338,7 +2312,7 @@ export class RecoveredSet {
2338
2312
  * @returns {number}
2339
2313
  */
2340
2314
  get fec_set_index() {
2341
- const ret = wasm.recoveredset_fec_set_index(this.__wbg_ptr);
2315
+ const ret = wasm.mmtfecencoder_k(this.__wbg_ptr);
2342
2316
  return ret >>> 0;
2343
2317
  }
2344
2318
  /**
Binary file
@@ -10,7 +10,7 @@ export const __wbg_get_fecstats_blocks_recovered: (a: number) => bigint;
10
10
  export const __wbg_get_fecstats_bytes_recovered: (a: number) => bigint;
11
11
  export const __wbg_get_fecstats_repair_packets: (a: number) => bigint;
12
12
  export const __wbg_get_fecstats_source_packets: (a: number) => bigint;
13
- export const __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
13
+ export const __wbg_get_fecstats_unplaced_evicted: (a: number) => bigint;
14
14
  export const __wbg_mfufragmentjs_free: (a: number, b: number) => void;
15
15
  export const __wbg_mmtfecdecoder_free: (a: number, b: number) => void;
16
16
  export const __wbg_mmtfecencoder_free: (a: number, b: number) => void;
@@ -23,7 +23,6 @@ export const __wbg_moqfecdecoder_free: (a: number, b: number) => void;
23
23
  export const __wbg_moqfecencoder_free: (a: number, b: number) => void;
24
24
  export const __wbg_moqfecstatsjs_free: (a: number, b: number) => void;
25
25
  export const __wbg_reassembledmfujs_free: (a: number, b: number) => void;
26
- export const __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
27
26
  export const __wbg_recoveredset_free: (a: number, b: number) => void;
28
27
  export const __wbg_samplecombinerstatsjs_free: (a: number, b: number) => void;
29
28
  export const __wbg_set_fecstats_blocks_complete: (a: number, b: bigint) => void;
@@ -33,7 +32,7 @@ export const __wbg_set_fecstats_blocks_recovered: (a: number, b: bigint) => void
33
32
  export const __wbg_set_fecstats_bytes_recovered: (a: number, b: bigint) => void;
34
33
  export const __wbg_set_fecstats_repair_packets: (a: number, b: bigint) => void;
35
34
  export const __wbg_set_fecstats_source_packets: (a: number, b: bigint) => void;
36
- export const __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
35
+ export const __wbg_set_fecstats_unplaced_evicted: (a: number, b: bigint) => void;
37
36
  export const __wbg_shredfecbuffer_free: (a: number, b: number) => void;
38
37
  export const __wbg_shredreassembler_free: (a: number, b: number) => void;
39
38
  export const annexb_access_unit_is_keyframe: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -64,7 +63,6 @@ export const mfufragmentjs_with_sample_identity: (a: number, b: number, c: numbe
64
63
  export const mmtfecdecoder_add_repair: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
65
64
  export const mmtfecdecoder_add_source: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
66
65
  export const mmtfecdecoder_cleanup_blocks_detailed: (a: number, b: number, c: number) => void;
67
- export const mmtfecdecoder_cleanup_by_sbn: (a: number, b: number) => [number, number, number, number];
68
66
  export const mmtfecdecoder_cleanup_by_ss_start: (a: number, b: number) => [number, number, number, number];
69
67
  export const mmtfecdecoder_configure: (a: number, b: number, c: number) => [number, number];
70
68
  export const mmtfecdecoder_configure_params: (a: number, b: number, c: number) => [number, number];
@@ -159,7 +157,6 @@ export const reassembledmfujs_repaired_packet_sequence_numbers: (a: number) => [
159
157
  export const reassembledmfujs_sample_number: (a: number) => number;
160
158
  export const reassembledmfujs_stream_identity: (a: number) => number;
161
159
  export const reassembledmfujs_timestamp: (a: number) => number;
162
- export const recoveredset_fec_set_index: (a: number) => number;
163
160
  export const recoveredset_payload: (a: number) => [number, number];
164
161
  export const recoveredset_slot: (a: number) => bigint;
165
162
  export const shredfecbuffer_add_shred: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
@@ -176,7 +173,9 @@ export const moqencodedblock_p: (a: number) => number;
176
173
  export const moqfecstatsjs_blocksComplete: (a: number) => number;
177
174
  export const moqfecstatsjs_blocksIncomplete: (a: number) => number;
178
175
  export const moqfecstatsjs_totalSymbolsReceived: (a: number) => number;
176
+ export const recoveredset_fec_set_index: (a: number) => number;
179
177
  export const shredreassembler_pending_fec_sets: (a: number) => number;
178
+ export const __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
180
179
  export const __wbg_get_reassemblerstatsjs_duplicate_fragments: (a: number) => bigint;
181
180
  export const __wbg_get_reassemblerstatsjs_evicted_data_units: (a: number) => bigint;
182
181
  export const __wbg_get_reassemblerstatsjs_evicted_memory_limit: (a: number) => bigint;
@@ -188,6 +187,8 @@ export const __wbg_get_samplecombinerstatsjs_combined_samples: (a: number) => bi
188
187
  export const __wbg_get_samplecombinerstatsjs_evicted_samples: (a: number) => bigint;
189
188
  export const __wbg_get_samplecombinerstatsjs_passthrough_samples: (a: number) => bigint;
190
189
  export const __wbg_get_samplecombinerstatsjs_timed_out_samples: (a: number) => bigint;
190
+ export const __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
191
+ export const __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
191
192
  export const __wbg_set_reassemblerstatsjs_duplicate_fragments: (a: number, b: bigint) => void;
192
193
  export const __wbg_set_reassemblerstatsjs_evicted_data_units: (a: number, b: bigint) => void;
193
194
  export const __wbg_set_reassemblerstatsjs_evicted_memory_limit: (a: number, b: bigint) => void;
@@ -46,6 +46,12 @@ declare namespace wasm_bindgen {
46
46
  * Blocks that expired with fewer than K symbols (delivery issue, not FEC issue)
47
47
  */
48
48
  blocks_delivery_failed: bigint;
49
+ /**
50
+ * `iso-ssbg1-v1` held sources evicted, oldest arrival first, because the
51
+ * unplaced pool was at its `(interleave_depth + 1) * K` cap: no sweep
52
+ * (`cleanup_by_ss_start` / `retire_unplaced`) retired them first.
53
+ */
54
+ unplaced_evicted: bigint;
49
55
  }
50
56
 
51
57
  export class MfuFragmentJs {
@@ -101,27 +107,15 @@ declare namespace wasm_bindgen {
101
107
  /**
102
108
  * Add a repair symbol per ISO 23008-1 §C.5.3.
103
109
  *
104
- * Repair carries (SS_Start, SSB_length, RS_ID).
105
- * SS_Start = SS_ID of first source in block = SBN * K.
106
- * SSB_length = the authored source-symbol count in this block (1..=K).
107
- * SBN = SS_Start / configured K.
108
- * Repair ESI = K + RS_ID.
109
- *
110
- * The decoder's configured K is the fixed RaptorQ geometry. A short
111
- * authored block (`SSB_length < K`) is the producer's K-symbol RaptorQ
112
- * block with ESIs `SSB_length..K` zero-filled and never transmitted
113
- * (fec-raptorq `InterleavedEncoder::force_complete`). The block records
114
- * `SSB_length`, completes once that many source symbols arrived, and
115
- * recovers from `SSB_length` received symbols by supplying the known
116
- * padding itself. A conflicting `SSB_length` for one block is rejected
117
- * without changing that block.
118
- *
119
- * Under `iso-ssbg1-v1` the block is `[SS_Start, SS_Start + SSB_length)`
120
- * with `1 <= SSB_length <= K` (K is only the maximum), its RaptorQ geometry
121
- * is K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID
122
- * (C.5.3). The first repair defines the block and claims every held source
123
- * in range. A conflicting SSB_length, or a range overlapping a different
124
- * known block, is refused without changing any block. Output is the K'*T
110
+ * Repair carries (SS_Start, SSB_length, RS_ID). The block is
111
+ * `[SS_Start, SS_Start + SSB_length)` with `1 <= SSB_length <= K` (the
112
+ * configured K is only the maximum), its RaptorQ geometry is
113
+ * K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID.
114
+ * The first repair defines the block and claims every held source in
115
+ * range. A conflicting SSB_length, a range overlapping a different known
116
+ * block, or a start more than `interleave_depth` blocks behind the last
117
+ * `cleanup_by_ss_start`'s `current` (`iso_blocks_behind_lower_bound`), is
118
+ * refused without changing any block. Output is the K'*T
125
119
  * concatenated ssbg_mode1 symbols: split by T and trim by the length field.
126
120
  */
127
121
  add_repair(ss_start: number, ssb_length: number, rs_id: number, data: Uint8Array, timestamp: number): Uint8Array | undefined;
@@ -131,13 +125,12 @@ declare namespace wasm_bindgen {
131
125
  * SS_ID is a flat 32-bit counter. An unconfigured decoder rejects the
132
126
  * packet.
133
127
  *
134
- * - `k-padded-v1`: derives SBN = floor(SS_ID / K), ESI = SS_ID % K and
135
- * zero-pads `data` to T.
136
- * - `iso-ssbg1-v1`: builds the C.3.3 ssbg_mode1 symbol
137
- * `u16be(len) || data || zero padding` (refusing `len + 2 > T`) and
138
- * places it at ESI = serial distance from the start of the known block
139
- * whose `[SS_Start, SS_Start + SSB_length)` contains SS_ID. A source
140
- * whose block no repair has defined yet is held by SS_ID until one does.
128
+ * Builds the C.3.3 ssbg_mode1 symbol `u16be(len) || data || zero padding`
129
+ * (refusing `len + 2 > T`) and places it at ESI = serial distance from the
130
+ * start of the known block whose `[SS_Start, SS_Start + SSB_length)`
131
+ * contains SS_ID. A source whose block no repair has defined yet is held
132
+ * by SS_ID until one does; at most `(interleave_depth + 1) * K` are held, and
133
+ * the oldest arrival is evicted first (`FecStats::unplaced_evicted`).
141
134
  *
142
135
  * # Arguments
143
136
  * * `ss_id` - Source symbol ID (32-bit monotonic counter)
@@ -153,18 +146,6 @@ declare namespace wasm_bindgen {
153
146
  * Get alignment (Al) parameter from OTI
154
147
  */
155
148
  get_alignment(): number;
156
- /**
157
- * `k-padded-v1` only: cleanup blocks more than `interleave_depth` blocks
158
- * behind `current_sbn`. Refused under `iso-ssbg1-v1`, which has no SBN
159
- * (use `cleanup_by_ss_start`).
160
- *
161
- * Blocks are ordered by RFC 1982 serial comparison of their first SS_ID
162
- * (`sbn * K mod 2^32`, ISO/IEC 23008-1 C.5.2; BLO-35597 iso:5). For a
163
- * stream that has not wrapped SS_ID that is exactly the old
164
- * `sbn < current_sbn - interleave_depth`; after the wrap it still retires
165
- * the pre-wrap blocks instead of keeping them forever.
166
- */
167
- cleanup_by_sbn(current_sbn: number): Uint32Array;
168
149
  /**
169
150
  * Get sub-blocks (N) parameter from OTI
170
151
  */
@@ -178,11 +159,11 @@ declare namespace wasm_bindgen {
178
159
  */
179
160
  get_symbol_size(): number;
180
161
  /**
181
- * `iso-ssbg1-v1` only: retire the held source symbols that no repair can
182
- * place any more, by the same rule as `cleanup_by_ss_start`, without
183
- * retiring any block. For a caller that retires blocks itself, by their
184
- * deadlines (`cleanup_blocks_detailed`), and needs only this half. Returns
185
- * how many it retired.
162
+ * Retire the held source symbols that no repair can place any more, by
163
+ * the same rule as `cleanup_by_ss_start`, without retiring any block. For
164
+ * a caller that retires blocks itself, by their deadlines
165
+ * (`cleanup_blocks_detailed`), and needs only this half. Returns how many
166
+ * it retired.
186
167
  */
187
168
  retire_unplaced(current: number): number;
188
169
  /**
@@ -202,11 +183,11 @@ declare namespace wasm_bindgen {
202
183
  */
203
184
  get_source_blocks(): number;
204
185
  /**
205
- * `iso-ssbg1-v1` only: retire every block, and every held source symbol,
206
- * lying more than `interleave_depth` blocks behind SS_ID `current`, the
207
- * newest SS_ID the caller has seen (no block start or held source follows
208
- * it). A block start or held source that `current` has moved at least
209
- * half the SS_ID space past no longer precedes it and is retired too
186
+ * Retire every block, and every held source symbol, lying more than
187
+ * `interleave_depth` blocks behind SS_ID `current`, the newest SS_ID the
188
+ * caller has seen (no block start or held source follows it). A block
189
+ * start or held source that `current` has moved at least half the SS_ID
190
+ * space past no longer precedes it and is retired too
210
191
  * (`iso_past_horizon`).
211
192
  *
212
193
  * Blocks have no SBN under ssbg_mode1, so distance is measured on the
@@ -222,21 +203,21 @@ declare namespace wasm_bindgen {
222
203
  */
223
204
  get_interleave_depth(): number;
224
205
  /**
225
- * Finalize only the source blocks whose host-owned deadlines fired.
226
- * Keys are SBNs under `k-padded-v1` and SS_Starts under `iso-ssbg1-v1`.
206
+ * Finalize only the source blocks whose host-owned deadlines fired,
207
+ * named by their SS_Starts.
227
208
  *
228
209
  * The JavaScript FEC manager owns per-block repair grace. A timeout for one
229
210
  * block must therefore not run the decoder's global age scan and evict a
230
211
  * peer block that is still waiting for fetched repair.
231
212
  */
232
- cleanup_blocks_detailed(sbns: Uint32Array): void;
213
+ cleanup_blocks_detailed(ss_starts: Uint32Array): void;
233
214
  /**
234
215
  * Create a new FEC decoder
235
216
  *
236
217
  * # Arguments
237
218
  * * `interleave_depth` - Explicit positive number of interleaved blocks.
238
- * * `block_profile` - Catalog `fec.blockProfile`: `"k-padded-v1"` or
239
- * `"iso-ssbg1-v1"`. Required; any other value is refused.
219
+ * * `block_profile` - Catalog `fec.blockProfile`: `"iso-ssbg1-v1"`.
220
+ * Required; any other value is refused.
240
221
  */
241
222
  constructor(interleave_depth: number, block_profile: string);
242
223
  /**
@@ -271,33 +252,28 @@ declare namespace wasm_bindgen {
271
252
  * `[SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][symbol: T]`.
272
253
  * Callers split on that stride; `entry i` is at `i * (13 + T)`.
273
254
  *
274
- * `k-padded-v1`: `block` is the Source Block Number and `source_block`
275
- * MUST be exactly `K * symbol_size` bytes — the caller pads the final
276
- * (short) block with zeros, mirroring `InterleavedEncoder` and the FFmpeg
277
- * path. `SS_Start = block * K` (wrapping), `SSB_length = K`.
278
- *
279
- * `iso-ssbg1-v1`: `block` is the SS_Start (the block's first SS_ID) and
280
- * `source_block` is the block's K' ssbg_mode1 symbols (`1 <= K' <= K`,
281
- * `len % T == 0`, each a well-formed C.3.3 symbol). RaptorQ runs over K'
282
- * symbols (F = K'*T) and `SSB_length = K'`.
255
+ * `ss_start` is the block's first SS_ID and `source_block` is the
256
+ * block's K' ssbg_mode1 symbols (`1 <= K' <= K`, `len % T == 0`, each a
257
+ * well-formed C.3.3 symbol). RaptorQ runs over K' symbols (F = K'*T) and
258
+ * `SSB_length = K'`.
283
259
  *
284
260
  * # Arguments
285
- * * `block` - SBN (`k-padded-v1`) or SS_Start (`iso-ssbg1-v1`).
261
+ * * `ss_start` - SS_Start: the block's first SS_ID.
286
262
  * * `source_block` - The block's source symbols, as described above.
287
263
  * * `repair_count` - Number of repair symbols (P) to generate.
288
264
  */
289
- encode_repair(block: number, source_block: Uint8Array, repair_count: number): Uint8Array;
265
+ encode_repair(ss_start: number, source_block: Uint8Array, repair_count: number): Uint8Array;
290
266
  /**
291
267
  * Create an encoder for a fixed `(K, symbol_size)` block geometry.
292
268
  *
293
269
  * Builds the OTI as `ObjectTransmissionInformation::new(K*T, T, 1, 1, 8)`
294
- * (single source block, single sub-block, byte alignment) — matching the
295
- * decoder's recovery model in [`FecBlock::try_decode`] — and pre-computes
296
- * the shared `SourceBlockEncodingPlan` so per-block encoding is cheap.
270
+ * (single source block, single sub-block, byte alignment) — the geometry
271
+ * [`MmtFecDecoder::configure`] reads back. K is the maximum SSB_length;
272
+ * each block is encoded over its own K' symbols (see
273
+ * [`MmtFecEncoder::encode_repair`]).
297
274
  *
298
- * `block_profile` is the catalog `fec.blockProfile` (`"k-padded-v1"` or
299
- * `"iso-ssbg1-v1"`); any other value is refused. Under `iso-ssbg1-v1`, K
300
- * is the maximum SSB_length.
275
+ * `block_profile` is the catalog `fec.blockProfile` (`"iso-ssbg1-v1"`);
276
+ * any other value is refused.
301
277
  */
302
278
  constructor(k: number, symbol_size: number, block_profile: string);
303
279
  /**
@@ -811,7 +787,7 @@ declare interface InitOutput {
811
787
  readonly __wbg_get_fecstats_bytes_recovered: (a: number) => bigint;
812
788
  readonly __wbg_get_fecstats_repair_packets: (a: number) => bigint;
813
789
  readonly __wbg_get_fecstats_source_packets: (a: number) => bigint;
814
- readonly __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
790
+ readonly __wbg_get_fecstats_unplaced_evicted: (a: number) => bigint;
815
791
  readonly __wbg_mfufragmentjs_free: (a: number, b: number) => void;
816
792
  readonly __wbg_mmtfecdecoder_free: (a: number, b: number) => void;
817
793
  readonly __wbg_mmtfecencoder_free: (a: number, b: number) => void;
@@ -824,7 +800,6 @@ declare interface InitOutput {
824
800
  readonly __wbg_moqfecencoder_free: (a: number, b: number) => void;
825
801
  readonly __wbg_moqfecstatsjs_free: (a: number, b: number) => void;
826
802
  readonly __wbg_reassembledmfujs_free: (a: number, b: number) => void;
827
- readonly __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
828
803
  readonly __wbg_recoveredset_free: (a: number, b: number) => void;
829
804
  readonly __wbg_samplecombinerstatsjs_free: (a: number, b: number) => void;
830
805
  readonly __wbg_set_fecstats_blocks_complete: (a: number, b: bigint) => void;
@@ -834,7 +809,7 @@ declare interface InitOutput {
834
809
  readonly __wbg_set_fecstats_bytes_recovered: (a: number, b: bigint) => void;
835
810
  readonly __wbg_set_fecstats_repair_packets: (a: number, b: bigint) => void;
836
811
  readonly __wbg_set_fecstats_source_packets: (a: number, b: bigint) => void;
837
- readonly __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
812
+ readonly __wbg_set_fecstats_unplaced_evicted: (a: number, b: bigint) => void;
838
813
  readonly __wbg_shredfecbuffer_free: (a: number, b: number) => void;
839
814
  readonly __wbg_shredreassembler_free: (a: number, b: number) => void;
840
815
  readonly annexb_access_unit_is_keyframe: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -865,7 +840,6 @@ declare interface InitOutput {
865
840
  readonly mmtfecdecoder_add_repair: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
866
841
  readonly mmtfecdecoder_add_source: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
867
842
  readonly mmtfecdecoder_cleanup_blocks_detailed: (a: number, b: number, c: number) => void;
868
- readonly mmtfecdecoder_cleanup_by_sbn: (a: number, b: number) => [number, number, number, number];
869
843
  readonly mmtfecdecoder_cleanup_by_ss_start: (a: number, b: number) => [number, number, number, number];
870
844
  readonly mmtfecdecoder_configure: (a: number, b: number, c: number) => [number, number];
871
845
  readonly mmtfecdecoder_configure_params: (a: number, b: number, c: number) => [number, number];
@@ -960,7 +934,6 @@ declare interface InitOutput {
960
934
  readonly reassembledmfujs_sample_number: (a: number) => number;
961
935
  readonly reassembledmfujs_stream_identity: (a: number) => number;
962
936
  readonly reassembledmfujs_timestamp: (a: number) => number;
963
- readonly recoveredset_fec_set_index: (a: number) => number;
964
937
  readonly recoveredset_payload: (a: number) => [number, number];
965
938
  readonly recoveredset_slot: (a: number) => bigint;
966
939
  readonly shredfecbuffer_add_shred: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
@@ -977,7 +950,9 @@ declare interface InitOutput {
977
950
  readonly moqfecstatsjs_blocksComplete: (a: number) => number;
978
951
  readonly moqfecstatsjs_blocksIncomplete: (a: number) => number;
979
952
  readonly moqfecstatsjs_totalSymbolsReceived: (a: number) => number;
953
+ readonly recoveredset_fec_set_index: (a: number) => number;
980
954
  readonly shredreassembler_pending_fec_sets: (a: number) => number;
955
+ readonly __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
981
956
  readonly __wbg_get_reassemblerstatsjs_duplicate_fragments: (a: number) => bigint;
982
957
  readonly __wbg_get_reassemblerstatsjs_evicted_data_units: (a: number) => bigint;
983
958
  readonly __wbg_get_reassemblerstatsjs_evicted_memory_limit: (a: number) => bigint;
@@ -989,6 +964,8 @@ declare interface InitOutput {
989
964
  readonly __wbg_get_samplecombinerstatsjs_evicted_samples: (a: number) => bigint;
990
965
  readonly __wbg_get_samplecombinerstatsjs_passthrough_samples: (a: number) => bigint;
991
966
  readonly __wbg_get_samplecombinerstatsjs_timed_out_samples: (a: number) => bigint;
967
+ readonly __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
968
+ readonly __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
992
969
  readonly __wbg_set_reassemblerstatsjs_duplicate_fragments: (a: number, b: bigint) => void;
993
970
  readonly __wbg_set_reassemblerstatsjs_evicted_data_units: (a: number, b: bigint) => void;
994
971
  readonly __wbg_set_reassemblerstatsjs_evicted_memory_limit: (a: number, b: bigint) => void;
@@ -529,6 +529,25 @@ let wasm_bindgen;
529
529
  set blocks_delivery_failed(arg0) {
530
530
  wasm.__wbg_set_fecstats_blocks_delivery_failed(this.__wbg_ptr, arg0);
531
531
  }
532
+ /**
533
+ * `iso-ssbg1-v1` held sources evicted, oldest arrival first, because the
534
+ * unplaced pool was at its `(interleave_depth + 1) * K` cap: no sweep
535
+ * (`cleanup_by_ss_start` / `retire_unplaced`) retired them first.
536
+ * @returns {bigint}
537
+ */
538
+ get unplaced_evicted() {
539
+ const ret = wasm.__wbg_get_fecstats_unplaced_evicted(this.__wbg_ptr);
540
+ return BigInt.asUintN(64, ret);
541
+ }
542
+ /**
543
+ * `iso-ssbg1-v1` held sources evicted, oldest arrival first, because the
544
+ * unplaced pool was at its `(interleave_depth + 1) * K` cap: no sweep
545
+ * (`cleanup_by_ss_start` / `retire_unplaced`) retired them first.
546
+ * @param {bigint} arg0
547
+ */
548
+ set unplaced_evicted(arg0) {
549
+ wasm.__wbg_set_fecstats_unplaced_evicted(this.__wbg_ptr, arg0);
550
+ }
532
551
  /**
533
552
  * Recovery rate as percentage (0-100)
534
553
  * Counts all blocks: complete + recovered + FEC-failed + delivery-failed
@@ -672,27 +691,15 @@ let wasm_bindgen;
672
691
  /**
673
692
  * Add a repair symbol per ISO 23008-1 §C.5.3.
674
693
  *
675
- * Repair carries (SS_Start, SSB_length, RS_ID).
676
- * SS_Start = SS_ID of first source in block = SBN * K.
677
- * SSB_length = the authored source-symbol count in this block (1..=K).
678
- * SBN = SS_Start / configured K.
679
- * Repair ESI = K + RS_ID.
680
- *
681
- * The decoder's configured K is the fixed RaptorQ geometry. A short
682
- * authored block (`SSB_length < K`) is the producer's K-symbol RaptorQ
683
- * block with ESIs `SSB_length..K` zero-filled and never transmitted
684
- * (fec-raptorq `InterleavedEncoder::force_complete`). The block records
685
- * `SSB_length`, completes once that many source symbols arrived, and
686
- * recovers from `SSB_length` received symbols by supplying the known
687
- * padding itself. A conflicting `SSB_length` for one block is rejected
688
- * without changing that block.
689
- *
690
- * Under `iso-ssbg1-v1` the block is `[SS_Start, SS_Start + SSB_length)`
691
- * with `1 <= SSB_length <= K` (K is only the maximum), its RaptorQ geometry
692
- * is K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID
693
- * (C.5.3). The first repair defines the block and claims every held source
694
- * in range. A conflicting SSB_length, or a range overlapping a different
695
- * known block, is refused without changing any block. Output is the K'*T
694
+ * Repair carries (SS_Start, SSB_length, RS_ID). The block is
695
+ * `[SS_Start, SS_Start + SSB_length)` with `1 <= SSB_length <= K` (the
696
+ * configured K is only the maximum), its RaptorQ geometry is
697
+ * K' = SSB_length with no padding, and repair ESI = SSB_length + RS_ID.
698
+ * The first repair defines the block and claims every held source in
699
+ * range. A conflicting SSB_length, a range overlapping a different known
700
+ * block, or a start more than `interleave_depth` blocks behind the last
701
+ * `cleanup_by_ss_start`'s `current` (`iso_blocks_behind_lower_bound`), is
702
+ * refused without changing any block. Output is the K'*T
696
703
  * concatenated ssbg_mode1 symbols: split by T and trim by the length field.
697
704
  * @param {number} ss_start
698
705
  * @param {number} ssb_length
@@ -721,13 +728,12 @@ let wasm_bindgen;
721
728
  * SS_ID is a flat 32-bit counter. An unconfigured decoder rejects the
722
729
  * packet.
723
730
  *
724
- * - `k-padded-v1`: derives SBN = floor(SS_ID / K), ESI = SS_ID % K and
725
- * zero-pads `data` to T.
726
- * - `iso-ssbg1-v1`: builds the C.3.3 ssbg_mode1 symbol
727
- * `u16be(len) || data || zero padding` (refusing `len + 2 > T`) and
728
- * places it at ESI = serial distance from the start of the known block
729
- * whose `[SS_Start, SS_Start + SSB_length)` contains SS_ID. A source
730
- * whose block no repair has defined yet is held by SS_ID until one does.
731
+ * Builds the C.3.3 ssbg_mode1 symbol `u16be(len) || data || zero padding`
732
+ * (refusing `len + 2 > T`) and places it at ESI = serial distance from the
733
+ * start of the known block whose `[SS_Start, SS_Start + SSB_length)`
734
+ * contains SS_ID. A source whose block no repair has defined yet is held
735
+ * by SS_ID until one does; at most `(interleave_depth + 1) * K` are held, and
736
+ * the oldest arrival is evicted first (`FecStats::unplaced_evicted`).
731
737
  *
732
738
  * # Arguments
733
739
  * * `ss_id` - Source symbol ID (32-bit monotonic counter)
@@ -769,28 +775,6 @@ let wasm_bindgen;
769
775
  }
770
776
  return ret[0];
771
777
  }
772
- /**
773
- * `k-padded-v1` only: cleanup blocks more than `interleave_depth` blocks
774
- * behind `current_sbn`. Refused under `iso-ssbg1-v1`, which has no SBN
775
- * (use `cleanup_by_ss_start`).
776
- *
777
- * Blocks are ordered by RFC 1982 serial comparison of their first SS_ID
778
- * (`sbn * K mod 2^32`, ISO/IEC 23008-1 C.5.2; BLO-35597 iso:5). For a
779
- * stream that has not wrapped SS_ID that is exactly the old
780
- * `sbn < current_sbn - interleave_depth`; after the wrap it still retires
781
- * the pre-wrap blocks instead of keeping them forever.
782
- * @param {number} current_sbn
783
- * @returns {Uint32Array}
784
- */
785
- cleanup_by_sbn(current_sbn) {
786
- const ret = wasm.mmtfecdecoder_cleanup_by_sbn(this.__wbg_ptr, current_sbn);
787
- if (ret[3]) {
788
- throw takeFromExternrefTable0(ret[2]);
789
- }
790
- var v1 = getArrayU32FromWasm0(ret[0], ret[1]).slice();
791
- wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
792
- return v1;
793
- }
794
778
  /**
795
779
  * Get sub-blocks (N) parameter from OTI
796
780
  * @returns {number}
@@ -822,11 +806,11 @@ let wasm_bindgen;
822
806
  return ret[0];
823
807
  }
824
808
  /**
825
- * `iso-ssbg1-v1` only: retire the held source symbols that no repair can
826
- * place any more, by the same rule as `cleanup_by_ss_start`, without
827
- * retiring any block. For a caller that retires blocks itself, by their
828
- * deadlines (`cleanup_blocks_detailed`), and needs only this half. Returns
829
- * how many it retired.
809
+ * Retire the held source symbols that no repair can place any more, by
810
+ * the same rule as `cleanup_by_ss_start`, without retiring any block. For
811
+ * a caller that retires blocks itself, by their deadlines
812
+ * (`cleanup_blocks_detailed`), and needs only this half. Returns how many
813
+ * it retired.
830
814
  * @param {number} current
831
815
  * @returns {number}
832
816
  */
@@ -880,11 +864,11 @@ let wasm_bindgen;
880
864
  return ret[0];
881
865
  }
882
866
  /**
883
- * `iso-ssbg1-v1` only: retire every block, and every held source symbol,
884
- * lying more than `interleave_depth` blocks behind SS_ID `current`, the
885
- * newest SS_ID the caller has seen (no block start or held source follows
886
- * it). A block start or held source that `current` has moved at least
887
- * half the SS_ID space past no longer precedes it and is retired too
867
+ * Retire every block, and every held source symbol, lying more than
868
+ * `interleave_depth` blocks behind SS_ID `current`, the newest SS_ID the
869
+ * caller has seen (no block start or held source follows it). A block
870
+ * start or held source that `current` has moved at least half the SS_ID
871
+ * space past no longer precedes it and is retired too
888
872
  * (`iso_past_horizon`).
889
873
  *
890
874
  * Blocks have no SBN under ssbg_mode1, so distance is measured on the
@@ -914,16 +898,16 @@ let wasm_bindgen;
914
898
  return ret >>> 0;
915
899
  }
916
900
  /**
917
- * Finalize only the source blocks whose host-owned deadlines fired.
918
- * Keys are SBNs under `k-padded-v1` and SS_Starts under `iso-ssbg1-v1`.
901
+ * Finalize only the source blocks whose host-owned deadlines fired,
902
+ * named by their SS_Starts.
919
903
  *
920
904
  * The JavaScript FEC manager owns per-block repair grace. A timeout for one
921
905
  * block must therefore not run the decoder's global age scan and evict a
922
906
  * peer block that is still waiting for fetched repair.
923
- * @param {Uint32Array} sbns
907
+ * @param {Uint32Array} ss_starts
924
908
  */
925
- cleanup_blocks_detailed(sbns) {
926
- const ptr0 = passArray32ToWasm0(sbns, wasm.__wbindgen_malloc);
909
+ cleanup_blocks_detailed(ss_starts) {
910
+ const ptr0 = passArray32ToWasm0(ss_starts, wasm.__wbindgen_malloc);
927
911
  const len0 = WASM_VECTOR_LEN;
928
912
  wasm.mmtfecdecoder_cleanup_blocks_detailed(this.__wbg_ptr, ptr0, len0);
929
913
  }
@@ -932,8 +916,8 @@ let wasm_bindgen;
932
916
  *
933
917
  * # Arguments
934
918
  * * `interleave_depth` - Explicit positive number of interleaved blocks.
935
- * * `block_profile` - Catalog `fec.blockProfile`: `"k-padded-v1"` or
936
- * `"iso-ssbg1-v1"`. Required; any other value is refused.
919
+ * * `block_profile` - Catalog `fec.blockProfile`: `"iso-ssbg1-v1"`.
920
+ * Required; any other value is refused.
937
921
  * @param {number} interleave_depth
938
922
  * @param {string} block_profile
939
923
  */
@@ -1014,21 +998,16 @@ let wasm_bindgen;
1014
998
  * [SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][repair symbol: T]
1015
999
  * ```
1016
1000
  *
1017
- * with, for a block with Source Block Number `sbn` and `K` source symbols:
1018
- * - `SS_Start = sbn * K` (32-bit) — first SS_ID of the block. The decoder
1019
- * derives `SBN = SS_Start / K`, so this MUST be `sbn * K`.
1001
+ * with, for an `iso-ssbg1-v1` block of K' ssbg_mode1 source symbols
1002
+ * (ISO/IEC 23008-1 C.3.3, C.5.2, C.5.3):
1003
+ * - `SS_Start = ` the block's first SS_ID (SS_IDs are consecutive, 32-bit)
1020
1004
  * - `RSB_length = P` (repair count for this block)
1021
- * - `RS_ID = i` (0-based repair index) ⇒ RaptorQ ESI = `K + i`
1022
- * - `SSB_length <= K` (authored source symbols in this block)
1023
- *
1024
- * OTI (Z=1, N=1, Al=8) is delivered out-of-band via the catalog / AL-FEC
1025
- * signaling message — see [`MmtFecEncoder::oti`] — never per-packet.
1005
+ * - `RS_ID = i` (0-based repair index) ⇒ RaptorQ ESI = `K' + i`
1006
+ * - `SSB_length = K'` (`1..=K`; the configured K is only the maximum)
1026
1007
  *
1027
- * That framing is the `k-padded-v1` profile. Under `iso-ssbg1-v1` the same
1028
- * fields carry ISO/IEC 23008-1 C.5.3 semantics: `SS_Start` is the first SS_ID
1029
- * of a block of consecutive SS_IDs, `SSB_length = K'` (`1..=K`), the RaptorQ
1030
- * block is K' symbols with no padding (F = K'*T), and RS_ID `i` is ESI
1031
- * `K' + i`.
1008
+ * The RaptorQ block is K' symbols with no padding (F = K'*T). The configured
1009
+ * OTI (F = K*T, Z=1, N=1, Al=8) is delivered out-of-band via the catalog /
1010
+ * AL-FEC signaling message — see [`MmtFecEncoder::oti`] — never per-packet.
1032
1011
  */
1033
1012
  class MmtFecEncoder {
1034
1013
  __destroy_into_raw() {
@@ -1073,29 +1052,24 @@ let wasm_bindgen;
1073
1052
  * `[SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][symbol: T]`.
1074
1053
  * Callers split on that stride; `entry i` is at `i * (13 + T)`.
1075
1054
  *
1076
- * `k-padded-v1`: `block` is the Source Block Number and `source_block`
1077
- * MUST be exactly `K * symbol_size` bytes — the caller pads the final
1078
- * (short) block with zeros, mirroring `InterleavedEncoder` and the FFmpeg
1079
- * path. `SS_Start = block * K` (wrapping), `SSB_length = K`.
1080
- *
1081
- * `iso-ssbg1-v1`: `block` is the SS_Start (the block's first SS_ID) and
1082
- * `source_block` is the block's K' ssbg_mode1 symbols (`1 <= K' <= K`,
1083
- * `len % T == 0`, each a well-formed C.3.3 symbol). RaptorQ runs over K'
1084
- * symbols (F = K'*T) and `SSB_length = K'`.
1055
+ * `ss_start` is the block's first SS_ID and `source_block` is the
1056
+ * block's K' ssbg_mode1 symbols (`1 <= K' <= K`, `len % T == 0`, each a
1057
+ * well-formed C.3.3 symbol). RaptorQ runs over K' symbols (F = K'*T) and
1058
+ * `SSB_length = K'`.
1085
1059
  *
1086
1060
  * # Arguments
1087
- * * `block` - SBN (`k-padded-v1`) or SS_Start (`iso-ssbg1-v1`).
1061
+ * * `ss_start` - SS_Start: the block's first SS_ID.
1088
1062
  * * `source_block` - The block's source symbols, as described above.
1089
1063
  * * `repair_count` - Number of repair symbols (P) to generate.
1090
- * @param {number} block
1064
+ * @param {number} ss_start
1091
1065
  * @param {Uint8Array} source_block
1092
1066
  * @param {number} repair_count
1093
1067
  * @returns {Uint8Array}
1094
1068
  */
1095
- encode_repair(block, source_block, repair_count) {
1069
+ encode_repair(ss_start, source_block, repair_count) {
1096
1070
  const ptr0 = passArray8ToWasm0(source_block, wasm.__wbindgen_malloc);
1097
1071
  const len0 = WASM_VECTOR_LEN;
1098
- const ret = wasm.mmtfecencoder_encode_repair(this.__wbg_ptr, block, ptr0, len0, repair_count);
1072
+ const ret = wasm.mmtfecencoder_encode_repair(this.__wbg_ptr, ss_start, ptr0, len0, repair_count);
1099
1073
  if (ret[3]) {
1100
1074
  throw takeFromExternrefTable0(ret[2]);
1101
1075
  }
@@ -1115,13 +1089,13 @@ let wasm_bindgen;
1115
1089
  * Create an encoder for a fixed `(K, symbol_size)` block geometry.
1116
1090
  *
1117
1091
  * Builds the OTI as `ObjectTransmissionInformation::new(K*T, T, 1, 1, 8)`
1118
- * (single source block, single sub-block, byte alignment) — matching the
1119
- * decoder's recovery model in [`FecBlock::try_decode`] — and pre-computes
1120
- * the shared `SourceBlockEncodingPlan` so per-block encoding is cheap.
1092
+ * (single source block, single sub-block, byte alignment) — the geometry
1093
+ * [`MmtFecDecoder::configure`] reads back. K is the maximum SSB_length;
1094
+ * each block is encoded over its own K' symbols (see
1095
+ * [`MmtFecEncoder::encode_repair`]).
1121
1096
  *
1122
- * `block_profile` is the catalog `fec.blockProfile` (`"k-padded-v1"` or
1123
- * `"iso-ssbg1-v1"`); any other value is refused. Under `iso-ssbg1-v1`, K
1124
- * is the maximum SSB_length.
1097
+ * `block_profile` is the catalog `fec.blockProfile` (`"iso-ssbg1-v1"`);
1098
+ * any other value is refused.
1125
1099
  * @param {number} k
1126
1100
  * @param {number} symbol_size
1127
1101
  * @param {string} block_profile
@@ -2300,14 +2274,14 @@ let wasm_bindgen;
2300
2274
  * @returns {bigint}
2301
2275
  */
2302
2276
  get ambiguous_fallback_fragments() {
2303
- const ret = wasm.__wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments(this.__wbg_ptr);
2277
+ const ret = wasm.__wbg_get_fecstats_unplaced_evicted(this.__wbg_ptr);
2304
2278
  return BigInt.asUintN(64, ret);
2305
2279
  }
2306
2280
  /**
2307
2281
  * @param {bigint} arg0
2308
2282
  */
2309
2283
  set ambiguous_fallback_fragments(arg0) {
2310
- wasm.__wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments(this.__wbg_ptr, arg0);
2284
+ wasm.__wbg_set_fecstats_unplaced_evicted(this.__wbg_ptr, arg0);
2311
2285
  }
2312
2286
  }
2313
2287
  if (Symbol.dispose) ReassemblerStatsJs.prototype[Symbol.dispose] = ReassemblerStatsJs.prototype.free;
@@ -2353,7 +2327,7 @@ let wasm_bindgen;
2353
2327
  * @returns {number}
2354
2328
  */
2355
2329
  get fec_set_index() {
2356
- const ret = wasm.recoveredset_fec_set_index(this.__wbg_ptr);
2330
+ const ret = wasm.mmtfecencoder_k(this.__wbg_ptr);
2357
2331
  return ret >>> 0;
2358
2332
  }
2359
2333
  /**
Binary file
@@ -10,7 +10,7 @@ export const __wbg_get_fecstats_blocks_recovered: (a: number) => bigint;
10
10
  export const __wbg_get_fecstats_bytes_recovered: (a: number) => bigint;
11
11
  export const __wbg_get_fecstats_repair_packets: (a: number) => bigint;
12
12
  export const __wbg_get_fecstats_source_packets: (a: number) => bigint;
13
- export const __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
13
+ export const __wbg_get_fecstats_unplaced_evicted: (a: number) => bigint;
14
14
  export const __wbg_mfufragmentjs_free: (a: number, b: number) => void;
15
15
  export const __wbg_mmtfecdecoder_free: (a: number, b: number) => void;
16
16
  export const __wbg_mmtfecencoder_free: (a: number, b: number) => void;
@@ -23,7 +23,6 @@ export const __wbg_moqfecdecoder_free: (a: number, b: number) => void;
23
23
  export const __wbg_moqfecencoder_free: (a: number, b: number) => void;
24
24
  export const __wbg_moqfecstatsjs_free: (a: number, b: number) => void;
25
25
  export const __wbg_reassembledmfujs_free: (a: number, b: number) => void;
26
- export const __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
27
26
  export const __wbg_recoveredset_free: (a: number, b: number) => void;
28
27
  export const __wbg_samplecombinerstatsjs_free: (a: number, b: number) => void;
29
28
  export const __wbg_set_fecstats_blocks_complete: (a: number, b: bigint) => void;
@@ -33,7 +32,7 @@ export const __wbg_set_fecstats_blocks_recovered: (a: number, b: bigint) => void
33
32
  export const __wbg_set_fecstats_bytes_recovered: (a: number, b: bigint) => void;
34
33
  export const __wbg_set_fecstats_repair_packets: (a: number, b: bigint) => void;
35
34
  export const __wbg_set_fecstats_source_packets: (a: number, b: bigint) => void;
36
- export const __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
35
+ export const __wbg_set_fecstats_unplaced_evicted: (a: number, b: bigint) => void;
37
36
  export const __wbg_shredfecbuffer_free: (a: number, b: number) => void;
38
37
  export const __wbg_shredreassembler_free: (a: number, b: number) => void;
39
38
  export const annexb_access_unit_is_keyframe: (a: number, b: number, c: number, d: number) => [number, number, number];
@@ -64,7 +63,6 @@ export const mfufragmentjs_with_sample_identity: (a: number, b: number, c: numbe
64
63
  export const mmtfecdecoder_add_repair: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
65
64
  export const mmtfecdecoder_add_source: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
66
65
  export const mmtfecdecoder_cleanup_blocks_detailed: (a: number, b: number, c: number) => void;
67
- export const mmtfecdecoder_cleanup_by_sbn: (a: number, b: number) => [number, number, number, number];
68
66
  export const mmtfecdecoder_cleanup_by_ss_start: (a: number, b: number) => [number, number, number, number];
69
67
  export const mmtfecdecoder_configure: (a: number, b: number, c: number) => [number, number];
70
68
  export const mmtfecdecoder_configure_params: (a: number, b: number, c: number) => [number, number];
@@ -159,7 +157,6 @@ export const reassembledmfujs_repaired_packet_sequence_numbers: (a: number) => [
159
157
  export const reassembledmfujs_sample_number: (a: number) => number;
160
158
  export const reassembledmfujs_stream_identity: (a: number) => number;
161
159
  export const reassembledmfujs_timestamp: (a: number) => number;
162
- export const recoveredset_fec_set_index: (a: number) => number;
163
160
  export const recoveredset_payload: (a: number) => [number, number];
164
161
  export const recoveredset_slot: (a: number) => bigint;
165
162
  export const shredfecbuffer_add_shred: (a: number, b: bigint, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number];
@@ -176,7 +173,9 @@ export const moqencodedblock_p: (a: number) => number;
176
173
  export const moqfecstatsjs_blocksComplete: (a: number) => number;
177
174
  export const moqfecstatsjs_blocksIncomplete: (a: number) => number;
178
175
  export const moqfecstatsjs_totalSymbolsReceived: (a: number) => number;
176
+ export const recoveredset_fec_set_index: (a: number) => number;
179
177
  export const shredreassembler_pending_fec_sets: (a: number) => number;
178
+ export const __wbg_get_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number) => bigint;
180
179
  export const __wbg_get_reassemblerstatsjs_duplicate_fragments: (a: number) => bigint;
181
180
  export const __wbg_get_reassemblerstatsjs_evicted_data_units: (a: number) => bigint;
182
181
  export const __wbg_get_reassemblerstatsjs_evicted_memory_limit: (a: number) => bigint;
@@ -188,6 +187,8 @@ export const __wbg_get_samplecombinerstatsjs_combined_samples: (a: number) => bi
188
187
  export const __wbg_get_samplecombinerstatsjs_evicted_samples: (a: number) => bigint;
189
188
  export const __wbg_get_samplecombinerstatsjs_passthrough_samples: (a: number) => bigint;
190
189
  export const __wbg_get_samplecombinerstatsjs_timed_out_samples: (a: number) => bigint;
190
+ export const __wbg_reassemblerstatsjs_free: (a: number, b: number) => void;
191
+ export const __wbg_set_reassemblerstatsjs_ambiguous_fallback_fragments: (a: number, b: bigint) => void;
191
192
  export const __wbg_set_reassemblerstatsjs_duplicate_fragments: (a: number, b: bigint) => void;
192
193
  export const __wbg_set_reassemblerstatsjs_evicted_data_units: (a: number, b: bigint) => void;
193
194
  export const __wbg_set_reassemblerstatsjs_evicted_memory_limit: (a: number, b: bigint) => void;