@blockcast/mmt-fec 0.3.0 → 0.4.0-main.1d3ea1cc8ff2

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.
Files changed (79) hide show
  1. package/README.md +17 -15
  2. package/dist/block-manager.d.ts +7 -4
  3. package/dist/block-manager.d.ts.map +1 -1
  4. package/dist/block-manager.js +8 -5
  5. package/dist/block-manager.js.map +1 -1
  6. package/dist/block-processor.d.ts +19 -20
  7. package/dist/block-processor.d.ts.map +1 -1
  8. package/dist/block-processor.js +28 -94
  9. package/dist/block-processor.js.map +1 -1
  10. package/dist/fec-block-mapper.d.ts +16 -72
  11. package/dist/fec-block-mapper.d.ts.map +1 -1
  12. package/dist/fec-block-mapper.js +17 -96
  13. package/dist/fec-block-mapper.js.map +1 -1
  14. package/dist/index.d.ts +3 -3
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +3 -3
  17. package/dist/index.js.map +1 -1
  18. package/dist/oti.d.ts +18 -29
  19. package/dist/oti.d.ts.map +1 -1
  20. package/dist/oti.js +9 -39
  21. package/dist/oti.js.map +1 -1
  22. package/dist/repair-group.d.ts +86 -0
  23. package/dist/repair-group.d.ts.map +1 -1
  24. package/dist/repair-group.js +135 -0
  25. package/dist/repair-group.js.map +1 -1
  26. package/package.json +5 -6
  27. package/src/block-manager.ts +9 -6
  28. package/src/block-processor.ts +32 -111
  29. package/src/fec-block-mapper.ts +23 -108
  30. package/src/index.ts +6 -2
  31. package/src/oti.ts +20 -51
  32. package/src/repair-group.ts +176 -0
  33. package/test-vectors/repair-epoch.json +119 -0
  34. package/node_modules/@blockcast/mmt-alta-parse/README.md +0 -181
  35. package/node_modules/@blockcast/mmt-alta-parse/dist/.build-stamp +0 -0
  36. package/node_modules/@blockcast/mmt-alta-parse/dist/index.d.ts +0 -57
  37. package/node_modules/@blockcast/mmt-alta-parse/dist/index.d.ts.map +0 -1
  38. package/node_modules/@blockcast/mmt-alta-parse/dist/index.js +0 -115
  39. package/node_modules/@blockcast/mmt-alta-parse/dist/index.js.map +0 -1
  40. package/node_modules/@blockcast/mmt-alta-parse/package.json +0 -50
  41. package/node_modules/@blockcast/mmt-alta-parse/src/index.ts +0 -136
  42. package/node_modules/@blockcast/mmt-base/README.md +0 -134
  43. package/node_modules/@blockcast/mmt-base/dist/.build-stamp +0 -0
  44. package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.d.ts +0 -55
  45. package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.d.ts.map +0 -1
  46. package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js +0 -128
  47. package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js.map +0 -1
  48. package/node_modules/@blockcast/mmt-base/dist/index.d.ts +0 -7
  49. package/node_modules/@blockcast/mmt-base/dist/index.d.ts.map +0 -1
  50. package/node_modules/@blockcast/mmt-base/dist/index.js +0 -7
  51. package/node_modules/@blockcast/mmt-base/dist/index.js.map +0 -1
  52. package/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts +0 -292
  53. package/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts.map +0 -1
  54. package/node_modules/@blockcast/mmt-base/dist/mmtp.js +0 -612
  55. package/node_modules/@blockcast/mmt-base/dist/mmtp.js.map +0 -1
  56. package/node_modules/@blockcast/mmt-base/dist/net-constants.d.ts +0 -18
  57. package/node_modules/@blockcast/mmt-base/dist/net-constants.d.ts.map +0 -1
  58. package/node_modules/@blockcast/mmt-base/dist/net-constants.js +0 -18
  59. package/node_modules/@blockcast/mmt-base/dist/net-constants.js.map +0 -1
  60. package/node_modules/@blockcast/mmt-base/dist/ntp-short.d.ts +0 -47
  61. package/node_modules/@blockcast/mmt-base/dist/ntp-short.d.ts.map +0 -1
  62. package/node_modules/@blockcast/mmt-base/dist/ntp-short.js +0 -54
  63. package/node_modules/@blockcast/mmt-base/dist/ntp-short.js.map +0 -1
  64. package/node_modules/@blockcast/mmt-base/dist/serial-number.d.ts +0 -57
  65. package/node_modules/@blockcast/mmt-base/dist/serial-number.d.ts.map +0 -1
  66. package/node_modules/@blockcast/mmt-base/dist/serial-number.js +0 -98
  67. package/node_modules/@blockcast/mmt-base/dist/serial-number.js.map +0 -1
  68. package/node_modules/@blockcast/mmt-base/dist/signalling.d.ts +0 -312
  69. package/node_modules/@blockcast/mmt-base/dist/signalling.d.ts.map +0 -1
  70. package/node_modules/@blockcast/mmt-base/dist/signalling.js +0 -637
  71. package/node_modules/@blockcast/mmt-base/dist/signalling.js.map +0 -1
  72. package/node_modules/@blockcast/mmt-base/package.json +0 -49
  73. package/node_modules/@blockcast/mmt-base/src/fec-block-profile.ts +0 -145
  74. package/node_modules/@blockcast/mmt-base/src/index.ts +0 -6
  75. package/node_modules/@blockcast/mmt-base/src/mmtp.ts +0 -892
  76. package/node_modules/@blockcast/mmt-base/src/net-constants.ts +0 -17
  77. package/node_modules/@blockcast/mmt-base/src/ntp-short.ts +0 -67
  78. package/node_modules/@blockcast/mmt-base/src/serial-number.ts +0 -107
  79. package/node_modules/@blockcast/mmt-base/src/signalling.ts +0 -862
@@ -8,17 +8,10 @@
8
8
  * It deliberately does NOT map MoQ media groups to FEC blocks. A recovered
9
9
  * packet's media group is read from its own MMTP/MPU header
10
10
  * ({@link recoveredPacketMediaGroup}), never from SBN arithmetic, and a source
11
- * symbol's block comes from the wire:
12
- *
13
- * - `k-padded-v1`: `SBN = floor(SS_ID / K)`, `ESI = SS_ID mod K`
14
- * ({@link FecBlockMapper.fromSsId}).
15
- * - `iso-ssbg1-v1`: a block is the SS_ID range `[SS_Start, SS_Start +
16
- * SSB_length)` its Repair FEC Payload ID states (ISO/IEC 23008-1 C.5.3), so
17
- * SS_ID alone locates nothing and `fromSsId` throws.
18
- *
19
- * Object FEC (draft-ramadan-moq-fec §9.1) is the one exception: there each MoQ
20
- * group IS its own FEC block, so {@link ObjectBlockMapper} keeps its identity
21
- * `derive`.
11
+ * symbol's block comes from the wire: under `iso-ssbg1-v1` a block is the SS_ID
12
+ * range `[SS_Start, SS_Start + SSB_length)` its Repair FEC Payload ID states
13
+ * (ISO/IEC 23008-1 C.5.3), so SS_ID alone locates nothing and `fromSsId`
14
+ * throws for every stream with an FEC instance.
22
15
  */
23
16
  import { type FecBlockProfile } from "@blockcast/mmt-base";
24
17
  /** Configuration from catalog FEC parameters. */
@@ -27,10 +20,7 @@ export interface FecBlockConfig {
27
20
  interleaveDepthMs: number;
28
21
  /** GOP/frame duration (milliseconds). Measured from actual MMTP timestamps. */
29
22
  gopDurationMs: number;
30
- /**
31
- * K from catalog fec.sourceSymbols: the source symbols per block under
32
- * `k-padded-v1`, the maximum SSB_length under `iso-ssbg1-v1`.
33
- */
23
+ /** K from catalog fec.sourceSymbols: the maximum SSB_length of a block. */
34
24
  k: number;
35
25
  /**
36
26
  * The catalog `fec.blockProfile`. Required and validated with
@@ -38,7 +28,7 @@ export interface FecBlockConfig {
38
28
  */
39
29
  blockProfile: FecBlockProfile;
40
30
  }
41
- /** FEC coordinates of one MoQ object, for the mappers whose groups are blocks. */
31
+ /** FEC coordinates of one MoQ object, for the mapper whose groups are blocks. */
42
32
  export interface FecCoordinates {
43
33
  /** Source Block Number */
44
34
  sbn: number;
@@ -76,7 +66,7 @@ interface NoFecInstanceConfig {
76
66
  export declare class FecBlockMapper {
77
67
  /** Media units (GOPs/frames) per FEC block, recovered with positive round-half-up semantics. */
78
68
  readonly d: number;
79
- /** K: source symbols per block (`k-padded-v1`) or the maximum SSB_length (`iso-ssbg1-v1`). */
69
+ /** K: the maximum SSB_length of a block (catalog `fec.sourceSymbols`). */
80
70
  readonly k: number;
81
71
  /** Block time span (ms) — used as pacing threshold */
82
72
  readonly interleaveDepthMs: number;
@@ -94,14 +84,13 @@ export declare class FecBlockMapper {
94
84
  */
95
85
  constructor(config: FecBlockConfig | NoFecInstanceConfig);
96
86
  /**
97
- * The `k-padded-v1` locator: SS_ID → (SBN, ESI) with `SBN = floor(SS_ID / K)`
98
- * and `ESI = SS_ID mod K`, for MMTP over multicast UDP where the Source FEC
99
- * Payload ID carries SS_ID directly.
87
+ * SS_ID → (SBN, ESI). Only {@link NullBlockMapper} answers: a stream with an
88
+ * FEC instance is `iso-ssbg1-v1`, whose blocks are located by
89
+ * `(SS_Start, SSB_length)` range membership and never from SS_ID alone.
100
90
  *
101
- * @throws under `iso-ssbg1-v1`, where a block is located by
102
- * `(SS_Start, SSB_length)` range membership and never from SS_ID alone
91
+ * @throws for every stream with an FEC instance
103
92
  */
104
- fromSsId(ssId: number): {
93
+ fromSsId(_ssId: number): {
105
94
  sbn: number;
106
95
  esi: number;
107
96
  };
@@ -137,53 +126,6 @@ export declare class NullBlockMapper extends FecBlockMapper {
137
126
  /** No FEC: nothing to wait for, so pacing never sleeps. */
138
127
  get pacingThresholdMs(): number;
139
128
  }
140
- /**
141
- * Object-level FEC (§9.1): each MoQ group (frame) is its own FEC block.
142
- * K_actual = ceil(frame_bytes / symbolSize) — varies per block.
143
- *
144
- * SBN = group_id, ESI = object_id.
145
- * SS_ID = Group_ID * sourceSymbols + Object_ID (§9.1.2).
146
- *
147
- * That SS_ID is the K-stride numbering of `k-padded-v1`; `iso-ssbg1-v1`
148
- * numbers SS_IDs consecutively per source packet (ISO/IEC 23008-1 C.5.2), so
149
- * §9.1 object FEC is defined only under `k-padded-v1` and the constructor
150
- * refuses any other profile.
151
- *
152
- * The stride of that numbering is the catalog `sourceSymbols`, never a
153
- * block's own K: a short block (K_actual < sourceSymbols) still starts at
154
- * `Group_ID * sourceSymbols` (its repair's SS_Start) and leaves the rest of
155
- * its stride unused, which is exactly `k-padded-v1` with `SSB_length =
156
- * K_actual`. So the SS_ID locator is the inherited
157
- * {@link FecBlockMapper.fromSsId} over `k = sourceSymbols`, the exact inverse
158
- * of {@link ObjectBlockMapper.derive}; it needs no per-block K and infers
159
- * nothing.
160
- *
161
- * This mapper does NOT carry per-block K. Each block discovers its own K from:
162
- * 1. Clean reception: counting source objects per group
163
- * 2. Repair packets: SSB_length in the Repair FEC Payload ID (ISO 23008-1 C.5.3)
164
- *
165
- * Callers MUST pass per-block K to FecBlockManager.addSourcePacket/addRepairPacket.
166
- * Created once per stream, GC'd on stream close (Effect cleanup).
167
- */
168
- export declare class ObjectBlockMapper extends FecBlockMapper {
169
- /** Catalog sourceSymbols (max K) — used ONLY for SS_ID encoding (§9.1.2).
170
- * Actual per-block K varies: K_actual = ceil(frame_bytes / symbolSize). */
171
- readonly sourceSymbolsMax: number;
172
- /**
173
- * @param gopDurationMs - GOP/frame duration (ms)
174
- * @param sourceSymbolsMax - Catalog `fec.sourceSymbols`
175
- * @param blockProfile - Catalog `fec.blockProfile`; must be `k-padded-v1`
176
- */
177
- constructor(gopDurationMs: number, sourceSymbolsMax: number, blockProfile: FecBlockProfile);
178
- /**
179
- * SBN = group_id, ESI = object_id. SS_ID per §9.1.2. Its inverse is the
180
- * inherited `fromSsId` (SBN = floor(SS_ID / sourceSymbols), ESI = SS_ID mod
181
- * sourceSymbols).
182
- */
183
- derive(groupId: number, objectId: number): FecCoordinates;
184
- /** One frame of latency: each frame is its own block. */
185
- get pacingThresholdMs(): number;
186
- }
187
129
  /**
188
130
  * Create a FecBlockMapper from catalog FEC config + measured GOP duration.
189
131
  *
@@ -191,8 +133,10 @@ export declare class ObjectBlockMapper extends FecBlockMapper {
191
133
  * {@link NullBlockMapper}; `fec.blockProfile` is not read, since a stream
192
134
  * without FEC names none.
193
135
  * - Otherwise `fec.blockProfile` is required (validated with
194
- * `parseFecBlockProfile`, throwing when absent or unknown), and
195
- * `mode: 'object'` → {@link ObjectBlockMapper}, else {@link FecBlockMapper}.
136
+ * `parseFecBlockProfile`, throwing unless it is `iso-ssbg1-v1`) and the
137
+ * result is a {@link FecBlockMapper}. `mode: 'object'` (per-group object
138
+ * FEC, SS_ID = Group_ID * K + Object_ID) throws: that numbering is the
139
+ * retired `k-padded-v1` stride, which `iso-ssbg1-v1` does not define.
196
140
  */
197
141
  export declare function createMapper(fecConfig: {
198
142
  interleaveDepthMs?: number;
@@ -1 +1 @@
1
- {"version":3,"file":"fec-block-mapper.d.ts","sourceRoot":"","sources":["../src/fec-block-mapper.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"fec-block-mapper.d.ts","sourceRoot":"","sources":["../src/fec-block-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAA;AAG5B,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAA;IACzB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,CAAC,EAAE,MAAM,CAAA;IACT;;;OAGG;IACH,YAAY,EAAE,eAAe,CAAA;CAC9B;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAQpE;AAED;;;;;GAKG;AACH,QAAA,MAAM,eAAe,EAAE,OAAO,MAAkC,CAAA;AAEhE,2EAA2E;AAC3E,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,YAAY,EAAE,OAAO,eAAe,CAAA;CAC9C;AAED,iEAAiE;AACjE,qBAAa,cAAc;IACzB,gGAAgG;IAChG,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,8BAA8B;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,CAAA;IAE7C;;;;OAIG;gBACS,MAAM,EAAE,cAAc,GAAG,mBAAmB;IAWxD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAOrD;;;OAGG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;CAGzC;AAED;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,cAAc;IACjD,2FAA2F;gBAC/E,aAAa,EAAE,MAAM;IAMjC,4FAA4F;IAC5F,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAQzD,8FAA8F;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAI7D,2DAA2D;IAC3D,IAAa,iBAAiB,IAAI,MAAM,CAEvC;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE;IACT,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,GAAG,SAAS,EACb,aAAa,EAAE,MAAM,GACpB,cAAc,CAkBhB"}
@@ -8,17 +8,10 @@
8
8
  * It deliberately does NOT map MoQ media groups to FEC blocks. A recovered
9
9
  * packet's media group is read from its own MMTP/MPU header
10
10
  * ({@link recoveredPacketMediaGroup}), never from SBN arithmetic, and a source
11
- * symbol's block comes from the wire:
12
- *
13
- * - `k-padded-v1`: `SBN = floor(SS_ID / K)`, `ESI = SS_ID mod K`
14
- * ({@link FecBlockMapper.fromSsId}).
15
- * - `iso-ssbg1-v1`: a block is the SS_ID range `[SS_Start, SS_Start +
16
- * SSB_length)` its Repair FEC Payload ID states (ISO/IEC 23008-1 C.5.3), so
17
- * SS_ID alone locates nothing and `fromSsId` throws.
18
- *
19
- * Object FEC (draft-ramadan-moq-fec §9.1) is the one exception: there each MoQ
20
- * group IS its own FEC block, so {@link ObjectBlockMapper} keeps its identity
21
- * `derive`.
11
+ * symbol's block comes from the wire: under `iso-ssbg1-v1` a block is the SS_ID
12
+ * range `[SS_Start, SS_Start + SSB_length)` its Repair FEC Payload ID states
13
+ * (ISO/IEC 23008-1 C.5.3), so SS_ID alone locates nothing and `fromSsId`
14
+ * throws for every stream with an FEC instance.
22
15
  */
23
16
  import { PACKET_TYPE_MPU, parseFecBlockProfile, parseMMTPHeader, parseMPUHeader, } from "@blockcast/mmt-base";
24
17
  import { deriveFecInterleaveDepth } from "./oti.js";
@@ -50,7 +43,7 @@ const NO_FEC_INSTANCE = Symbol("no FEC instance");
50
43
  export class FecBlockMapper {
51
44
  /** Media units (GOPs/frames) per FEC block, recovered with positive round-half-up semantics. */
52
45
  d;
53
- /** K: source symbols per block (`k-padded-v1`) or the maximum SSB_length (`iso-ssbg1-v1`). */
46
+ /** K: the maximum SSB_length of a block (catalog `fec.sourceSymbols`). */
54
47
  k;
55
48
  /** Block time span (ms) — used as pacing threshold */
56
49
  interleaveDepthMs;
@@ -78,22 +71,15 @@ export class FecBlockMapper {
78
71
  this.d = deriveFecInterleaveDepth(config.interleaveDepthMs, config.gopDurationMs);
79
72
  }
80
73
  /**
81
- * The `k-padded-v1` locator: SS_ID → (SBN, ESI) with `SBN = floor(SS_ID / K)`
82
- * and `ESI = SS_ID mod K`, for MMTP over multicast UDP where the Source FEC
83
- * Payload ID carries SS_ID directly.
74
+ * SS_ID → (SBN, ESI). Only {@link NullBlockMapper} answers: a stream with an
75
+ * FEC instance is `iso-ssbg1-v1`, whose blocks are located by
76
+ * `(SS_Start, SSB_length)` range membership and never from SS_ID alone.
84
77
  *
85
- * @throws under `iso-ssbg1-v1`, where a block is located by
86
- * `(SS_Start, SSB_length)` range membership and never from SS_ID alone
78
+ * @throws for every stream with an FEC instance
87
79
  */
88
- fromSsId(ssId) {
89
- if (this.blockProfile !== 'k-padded-v1') {
90
- throw new Error(`fromSsId is the k-padded-v1 locator; a ${this.blockProfile ?? 'non-FEC'} stream locates a block by ` +
91
- '(SS_Start, SSB_length) range membership, never from SS_ID alone');
92
- }
93
- return {
94
- sbn: Math.floor(ssId / this.k),
95
- esi: ssId % this.k,
96
- };
80
+ fromSsId(_ssId) {
81
+ throw new Error(`fromSsId: a ${this.blockProfile ?? 'non-FEC'} stream locates a block by ` +
82
+ '(SS_Start, SSB_length) range membership, never from SS_ID alone');
97
83
  }
98
84
  /**
99
85
  * Pacing threshold: one full block duration = interleaveDepthMs.
@@ -143,72 +129,6 @@ export class NullBlockMapper extends FecBlockMapper {
143
129
  return 0;
144
130
  }
145
131
  }
146
- /**
147
- * Object-level FEC (§9.1): each MoQ group (frame) is its own FEC block.
148
- * K_actual = ceil(frame_bytes / symbolSize) — varies per block.
149
- *
150
- * SBN = group_id, ESI = object_id.
151
- * SS_ID = Group_ID * sourceSymbols + Object_ID (§9.1.2).
152
- *
153
- * That SS_ID is the K-stride numbering of `k-padded-v1`; `iso-ssbg1-v1`
154
- * numbers SS_IDs consecutively per source packet (ISO/IEC 23008-1 C.5.2), so
155
- * §9.1 object FEC is defined only under `k-padded-v1` and the constructor
156
- * refuses any other profile.
157
- *
158
- * The stride of that numbering is the catalog `sourceSymbols`, never a
159
- * block's own K: a short block (K_actual < sourceSymbols) still starts at
160
- * `Group_ID * sourceSymbols` (its repair's SS_Start) and leaves the rest of
161
- * its stride unused, which is exactly `k-padded-v1` with `SSB_length =
162
- * K_actual`. So the SS_ID locator is the inherited
163
- * {@link FecBlockMapper.fromSsId} over `k = sourceSymbols`, the exact inverse
164
- * of {@link ObjectBlockMapper.derive}; it needs no per-block K and infers
165
- * nothing.
166
- *
167
- * This mapper does NOT carry per-block K. Each block discovers its own K from:
168
- * 1. Clean reception: counting source objects per group
169
- * 2. Repair packets: SSB_length in the Repair FEC Payload ID (ISO 23008-1 C.5.3)
170
- *
171
- * Callers MUST pass per-block K to FecBlockManager.addSourcePacket/addRepairPacket.
172
- * Created once per stream, GC'd on stream close (Effect cleanup).
173
- */
174
- export class ObjectBlockMapper extends FecBlockMapper {
175
- /** Catalog sourceSymbols (max K) — used ONLY for SS_ID encoding (§9.1.2).
176
- * Actual per-block K varies: K_actual = ceil(frame_bytes / symbolSize). */
177
- sourceSymbolsMax;
178
- /**
179
- * @param gopDurationMs - GOP/frame duration (ms)
180
- * @param sourceSymbolsMax - Catalog `fec.sourceSymbols`
181
- * @param blockProfile - Catalog `fec.blockProfile`; must be `k-padded-v1`
182
- */
183
- constructor(gopDurationMs, sourceSymbolsMax, blockProfile) {
184
- if (sourceSymbolsMax <= 0)
185
- throw new Error('ObjectBlockMapper: sourceSymbolsMax must be > 0 (from catalog)');
186
- const profile = parseFecBlockProfile(blockProfile, 'ObjectBlockMapper fec.blockProfile');
187
- if (profile !== 'k-padded-v1') {
188
- throw new Error(`ObjectBlockMapper: §9.1 object FEC numbers SS_ID = Group_ID * K + Object_ID, the k-padded-v1 stride; ` +
189
- `it is not defined under ${profile}`);
190
- }
191
- // D=1, K=sourceSymbolsMax for SS_ID math only — actual block K varies
192
- super({ interleaveDepthMs: gopDurationMs, gopDurationMs, k: sourceSymbolsMax, blockProfile: profile });
193
- this.sourceSymbolsMax = sourceSymbolsMax;
194
- }
195
- /**
196
- * SBN = group_id, ESI = object_id. SS_ID per §9.1.2. Its inverse is the
197
- * inherited `fromSsId` (SBN = floor(SS_ID / sourceSymbols), ESI = SS_ID mod
198
- * sourceSymbols).
199
- */
200
- derive(groupId, objectId) {
201
- return {
202
- sbn: groupId,
203
- esi: objectId,
204
- ssId: groupId * this.sourceSymbolsMax + objectId,
205
- };
206
- }
207
- /** One frame of latency: each frame is its own block. */
208
- get pacingThresholdMs() {
209
- return this.gopDurationMs; // one frame latency
210
- }
211
- }
212
132
  /**
213
133
  * Create a FecBlockMapper from catalog FEC config + measured GOP duration.
214
134
  *
@@ -216,17 +136,18 @@ export class ObjectBlockMapper extends FecBlockMapper {
216
136
  * {@link NullBlockMapper}; `fec.blockProfile` is not read, since a stream
217
137
  * without FEC names none.
218
138
  * - Otherwise `fec.blockProfile` is required (validated with
219
- * `parseFecBlockProfile`, throwing when absent or unknown), and
220
- * `mode: 'object'` → {@link ObjectBlockMapper}, else {@link FecBlockMapper}.
139
+ * `parseFecBlockProfile`, throwing unless it is `iso-ssbg1-v1`) and the
140
+ * result is a {@link FecBlockMapper}. `mode: 'object'` (per-group object
141
+ * FEC, SS_ID = Group_ID * K + Object_ID) throws: that numbering is the
142
+ * retired `k-padded-v1` stride, which `iso-ssbg1-v1` does not define.
221
143
  */
222
144
  export function createMapper(fecConfig, gopDurationMs) {
223
145
  if (!fecConfig || !fecConfig.sourceSymbols) {
224
146
  return new NullBlockMapper(gopDurationMs);
225
147
  }
226
148
  const blockProfile = parseFecBlockProfile(fecConfig.blockProfile, 'fec.blockProfile');
227
- // extensions feature — see moqcast-draft docs/fec-extensions-material.md, not in public -00
228
149
  if (fecConfig.mode === 'object') {
229
- return new ObjectBlockMapper(gopDurationMs, fecConfig.sourceSymbols, blockProfile);
150
+ throw new Error(`createMapper: object FEC numbers SS_ID = Group_ID * K + Object_ID, which ${blockProfile} does not define`);
230
151
  }
231
152
  return new FecBlockMapper({
232
153
  interleaveDepthMs: fecConfig.interleaveDepthMs && fecConfig.interleaveDepthMs > 0
@@ -1 +1 @@
1
- {"version":3,"file":"fec-block-mapper.js","sourceRoot":"","sources":["../src/fec-block-mapper.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"fec-block-mapper.js","sourceRoot":"","sources":["../src/fec-block-mapper.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -17,12 +17,12 @@ export { ReorderBuffer, type ReorderBufferConfig, } from "./reorder-buffer.js";
17
17
  export { splitToSymbols, recoverFromSymbols, computeK, } from "./cmaf-symbols.js";
18
18
  export { splitFrameToSymbol, recoverFrameFromSymbol, } from "./loc-symbols.js";
19
19
  export { CmafFecRecovery, type CmafFecRecoveryConfig, type FecDecoder, } from "./cmaf-recovery.js";
20
- export { buildOTI, buildOTIFromCatalog, parseOTI, computeFecTimeout, deriveFecInterleaveDepth, catalogFecInterleaveMs, type FecInterleaveCatalog, parseRepairPacket, type OTIParams, fecBlockDeadlineMs, fecBlockBudgetMs, deriveFecRetentionBlocks, tryDeriveFecRetentionBlocks, MAX_FEC_RETENTION_BLOCKS, playbackLatencyMs, } from "./oti.js";
21
- export { FecBlockMapper, NullBlockMapper, ObjectBlockMapper, createMapper, recoveredPacketMediaGroup, type FecBlockConfig, type FecCoordinates, } from "./fec-block-mapper.js";
20
+ export { buildOTI, buildOTIFromCatalog, parseOTI, deriveFecInterleaveDepth, catalogFecInterleaveMs, type FecInterleaveCatalog, parseRepairPacket, type OTIParams, fecBlockDeadlineMs, fecBlockBudgetMs, deriveFecRetentionBlocks, tryDeriveFecRetentionBlocks, MAX_FEC_RETENTION_BLOCKS, LOCAL_FEC_RETENTION_BLOCKS, LOCAL_FEC_TIMEOUT_MS, playbackLatencyMs, } from "./oti.js";
21
+ export { FecBlockMapper, NullBlockMapper, createMapper, recoveredPacketMediaGroup, type FecBlockConfig, type FecCoordinates, } from "./fec-block-mapper.js";
22
22
  /**
23
23
  * MoQ repair group ids for `iso-ssbg1-v1` blocks: the 62-bit
24
24
  * wrap-epoch-extended SS_Start, the repair FETCH range for a lost SS_ID, and
25
25
  * the check a received repair object's Group ID must pass.
26
26
  */
27
- export { extSsStart, extendSsId, repairFetchRange, repairGroupIdMatches, type RepairFetchAnchor, type RepairFetchRange, } from "./repair-group.js";
27
+ export { extSsStart, extendSsId, repairFetchRange, repairGroupIdMatches, RepairEpochReferences, type RepairEpochStats, type RepairFetchAnchor, type RepairFetchRange, type RepairGroupPlan, type RepairLargestOutcome, } from "./repair-group.js";
28
28
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,eAAe,EACf,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,aAAa,EACb,KAAK,mBAAmB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,QAAQ,GACR,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,QAAQ,EACR,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,KAAK,SAAS,EACd,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACN,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,cAAc,GACnB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,OAAO,EACN,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACrB,MAAM,mBAAmB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,eAAe,EACf,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,aAAa,EACb,KAAK,mBAAmB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,QAAQ,GACR,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,QAAQ,EACR,mBAAmB,EACnB,QAAQ,EACR,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,KAAK,SAAS,EACd,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACN,cAAc,EACd,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,cAAc,GACnB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,OAAO,EACN,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GACzB,MAAM,mBAAmB,CAAC"}
package/dist/index.js CHANGED
@@ -17,12 +17,12 @@ export { ReorderBuffer, } from "./reorder-buffer.js";
17
17
  export { splitToSymbols, recoverFromSymbols, computeK, } from "./cmaf-symbols.js";
18
18
  export { splitFrameToSymbol, recoverFrameFromSymbol, } from "./loc-symbols.js";
19
19
  export { CmafFecRecovery, } from "./cmaf-recovery.js";
20
- export { buildOTI, buildOTIFromCatalog, parseOTI, computeFecTimeout, deriveFecInterleaveDepth, catalogFecInterleaveMs, parseRepairPacket, fecBlockDeadlineMs, fecBlockBudgetMs, deriveFecRetentionBlocks, tryDeriveFecRetentionBlocks, MAX_FEC_RETENTION_BLOCKS, playbackLatencyMs, } from "./oti.js";
21
- export { FecBlockMapper, NullBlockMapper, ObjectBlockMapper, createMapper, recoveredPacketMediaGroup, } from "./fec-block-mapper.js";
20
+ export { buildOTI, buildOTIFromCatalog, parseOTI, deriveFecInterleaveDepth, catalogFecInterleaveMs, parseRepairPacket, fecBlockDeadlineMs, fecBlockBudgetMs, deriveFecRetentionBlocks, tryDeriveFecRetentionBlocks, MAX_FEC_RETENTION_BLOCKS, LOCAL_FEC_RETENTION_BLOCKS, LOCAL_FEC_TIMEOUT_MS, playbackLatencyMs, } from "./oti.js";
21
+ export { FecBlockMapper, NullBlockMapper, createMapper, recoveredPacketMediaGroup, } from "./fec-block-mapper.js";
22
22
  /**
23
23
  * MoQ repair group ids for `iso-ssbg1-v1` blocks: the 62-bit
24
24
  * wrap-epoch-extended SS_Start, the repair FETCH range for a lost SS_ID, and
25
25
  * the check a received repair object's Group ID must pass.
26
26
  */
27
- export { extSsStart, extendSsId, repairFetchRange, repairGroupIdMatches, } from "./repair-group.js";
27
+ export { extSsStart, extendSsId, repairFetchRange, repairGroupIdMatches, RepairEpochReferences, } from "./repair-group.js";
28
28
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,eAAe,EACf,SAAS,GAIT,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,eAAe,EACf,gBAAgB,GAKhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,aAAa,GAEb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,QAAQ,GACR,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,eAAe,GAGf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,QAAQ,EACR,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EAEtB,iBAAiB,EAEjB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACN,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,GAGzB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,OAAO,EACN,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,oBAAoB,GAGpB,MAAM,mBAAmB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,eAAe,EACf,SAAS,GAIT,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,eAAe,EACf,gBAAgB,GAKhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,aAAa,GAEb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,QAAQ,GACR,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,eAAe,GAGf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,QAAQ,EACR,mBAAmB,EACnB,QAAQ,EACR,wBAAwB,EACxB,sBAAsB,EAEtB,iBAAiB,EAEjB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACN,cAAc,EACd,eAAe,EACf,YAAY,EACZ,yBAAyB,GAGzB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,OAAO,EACN,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GAMrB,MAAM,mBAAmB,CAAC"}
package/dist/oti.d.ts CHANGED
@@ -44,15 +44,16 @@ export declare function parseOTI(oti: Uint8Array): OTIParams & {
44
44
  * Resolve a catalog FEC block's span in milliseconds.
45
45
  *
46
46
  * The catalog carries exactly ONE interleave field: `interleaveDepthMs`, the
47
- * full FEC block span in MILLISECONDS (draft-ramadan-moq-fec §5.1). Receivers
48
- * derive D -- the MEDIA UNITS per block, not a block count -- with
49
- * `deriveFecInterleaveDepth`. Reading D as a block count is BLO-35597.
50
- *
51
- * Absent, non-finite or non-positive → undefined; callers treat that as
52
- * unconfigured and error rather than guess. Finiteness is checked separately
53
- * from `> 0` because `Infinity` satisfies `> 0`: a JSON catalog cannot spell
54
- * `Infinity`, but any overflowing literal (`1e999`) parses to it, and it would
55
- * then reach `fecBlockBudgetMs` as an unbounded span. The legacy
47
+ * full FEC block send span in MILLISECONDS (draft-ramadan-moq-fec §5.1).
48
+ * Block boundaries still come from the wire's SS_Start and SSB_length; this
49
+ * field never supplies a group count or replaces those coordinates.
50
+ *
51
+ * Absent → undefined. An explicit zero is returned as zero: it is the
52
+ * catalog's no-elapsed-deadline sentinel, not an invitation to infer a span.
53
+ * Positive values must be safe integer milliseconds. Finiteness is checked
54
+ * separately from the range because `Infinity` satisfies `> 0`: a JSON catalog
55
+ * cannot spell `Infinity`, but any overflowing literal (`1e999`) parses to it,
56
+ * and it would then reach `fecBlockBudgetMs` as an unbounded span. The legacy
56
57
  * `interleaveDepth` frame-count key and
57
58
  * the `interleaveMs` alias were removed in the BLO-14526 clean cut — producers
58
59
  * emit milliseconds only, and there is deliberately NO fallback read.
@@ -75,26 +76,6 @@ export declare function catalogFecInterleaveMs(fec: FecInterleaveCatalog | undef
75
76
  * but represents D=120 rather than D=121.
76
77
  */
77
78
  export declare function deriveFecInterleaveDepth(interleaveDepthMs: number, mediaUnitDurationMs: number): number;
78
- /**
79
- * Compute the full FEC block completion timeout from the catalog block span.
80
- *
81
- * The catalog's `interleaveDepthMs` IS the full FEC block span in
82
- * milliseconds (draft-ramadan-moq-fec §5.1): producers emit
83
- * D × unit-duration, and every symbol of a block — source and repair —
84
- * arrives within that span. The full-block timeout is therefore
85
- * K-INDEPENDENT:
86
- *
87
- * timeout = interleaveDepthMs * safetyFactor
88
- *
89
- * A caller that genuinely needs a per-sub-block deadline scales the block
90
- * span by K_sub / K. Never scale it by a symbol count: the span already
91
- * covers every symbol of the block.
92
- *
93
- * @param interleaveDepthMs - Full FEC block span in ms (catalog fec.interleaveDepthMs)
94
- * @param safetyFactor - Jitter margin (default 3.0)
95
- * @returns Timeout in milliseconds
96
- */
97
- export declare function computeFecTimeout(interleaveDepthMs: number, safetyFactor?: number): number;
98
79
  /**
99
80
  * Absolute deadline for one FEC block.
100
81
  *
@@ -209,6 +190,14 @@ export declare function deriveFecRetentionBlocks(deliveryWindowMs: number, inter
209
190
  * anywhere else.
210
191
  */
211
192
  export declare const MAX_FEC_RETENTION_BLOCKS = 255;
193
+ /**
194
+ * Receiver-local block retention used when the catalog carries no elapsed-time
195
+ * FEC window. This is a memory/cleanup bound only; it is never derived from
196
+ * media rate and never treated as a catalog deadline.
197
+ */
198
+ export declare const LOCAL_FEC_RETENTION_BLOCKS = 2;
199
+ /** Receiver-local cleanup budget used when the catalog has no elapsed span. */
200
+ export declare const LOCAL_FEC_TIMEOUT_MS = 500;
212
201
  /**
213
202
  * `deriveFecRetentionBlocks` without the throw: the block count, or `undefined`
214
203
  * when the geometry cannot define one.
package/dist/oti.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"oti.d.ts","sourceRoot":"","sources":["../src/oti.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,SAAS;IACzB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAwBtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAWpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAYnE;AAwBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,oBAAoB,GAAG,SAAS,GACnC,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACvC,iBAAiB,EAAE,MAAM,EACzB,mBAAmB,EAAE,MAAM,GACzB,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAChC,iBAAiB,EAAE,MAAM,EACzB,YAAY,GAAE,MAAY,GACxB,MAAM,CAkBR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAMT;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAkB9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,wBAAwB,CACvC,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACvB,MAAM,CAmCR;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,MAAO,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAC1C,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACvB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAYtG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;IACtD,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;CACzE,GAAG,IAAI,CASP"}
1
+ {"version":3,"file":"oti.d.ts","sourceRoot":"","sources":["../src/oti.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,SAAS;IACzB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAwBtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAWpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAYnE;AAwBD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,oBAAoB,GAAG,SAAS,GACnC,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACvC,iBAAiB,EAAE,MAAM,EACzB,mBAAmB,EAAE,MAAM,GACzB,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAMT;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAkB9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,wBAAwB,CACvC,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACvB,MAAM,CAmCR;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,MAAO,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAC1C,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACvB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAYtG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;IACtD,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;CACzE,GAAG,IAAI,CASP"}
package/dist/oti.js CHANGED
@@ -93,7 +93,7 @@ function validateOTIFields(F, T, Z, N, Al) {
93
93
  }
94
94
  export function catalogFecInterleaveMs(fec) {
95
95
  const ms = fec?.interleaveDepthMs;
96
- return typeof ms === "number" && ms > 0 && Number.isFinite(ms) ? ms : undefined;
96
+ return typeof ms === "number" && Number.isSafeInteger(ms) && ms >= 0 ? ms : undefined;
97
97
  }
98
98
  /**
99
99
  * Derive the integer FEC interleave depth D from a catalog block span and the
@@ -117,44 +117,6 @@ export function deriveFecInterleaveDepth(interleaveDepthMs, mediaUnitDurationMs)
117
117
  }
118
118
  return Math.max(1, Math.floor(interleaveDepthMs / mediaUnitDurationMs + 0.5));
119
119
  }
120
- /**
121
- * Compute the full FEC block completion timeout from the catalog block span.
122
- *
123
- * The catalog's `interleaveDepthMs` IS the full FEC block span in
124
- * milliseconds (draft-ramadan-moq-fec §5.1): producers emit
125
- * D × unit-duration, and every symbol of a block — source and repair —
126
- * arrives within that span. The full-block timeout is therefore
127
- * K-INDEPENDENT:
128
- *
129
- * timeout = interleaveDepthMs * safetyFactor
130
- *
131
- * A caller that genuinely needs a per-sub-block deadline scales the block
132
- * span by K_sub / K. Never scale it by a symbol count: the span already
133
- * covers every symbol of the block.
134
- *
135
- * @param interleaveDepthMs - Full FEC block span in ms (catalog fec.interleaveDepthMs)
136
- * @param safetyFactor - Jitter margin (default 3.0)
137
- * @returns Timeout in milliseconds
138
- */
139
- export function computeFecTimeout(interleaveDepthMs, safetyFactor = 3.0) {
140
- // Finite, not merely > 0, and on BOTH arguments: the product is the caller's
141
- // expiry deadline, so a non-finite either side makes every `now > deadline`
142
- // comparison false and the block never expires -- strictly worse than
143
- // expiring late. `NaN <= 0` is false, so a bare `> 0` guard passes it
144
- // through. Both values reach here from JSON (the catalog span, and the
145
- // safety factor via test-vectors/catalog-validation.json), where an
146
- // overflowing literal such as `1e999` parses to Infinity -- JSON has no
147
- // Infinity literal, so there is no other way to spell it.
148
- if (!Number.isFinite(interleaveDepthMs) || interleaveDepthMs <= 0) {
149
- throw new Error(`[FEC] interleaveDepthMs must be a finite value > 0 (got ${interleaveDepthMs}ms). Fix encoder config.`);
150
- }
151
- if (!Number.isFinite(safetyFactor) || safetyFactor <= 0) {
152
- throw new Error(`[FEC] safetyFactor must be a finite value > 0 (got ${safetyFactor}). Fix encoder config.`);
153
- }
154
- // interleaveDepthMs IS the block span. K=4, D=4 at 30fps:
155
- // interleaveDepthMs = 133ms → timeout = ceil(133 * 3) = 399ms.
156
- return Math.ceil(interleaveDepthMs * safetyFactor);
157
- }
158
120
  /**
159
121
  * Absolute deadline for one FEC block.
160
122
  *
@@ -314,6 +276,14 @@ export function deriveFecRetentionBlocks(deliveryWindowMs, interleaveDepthMs) {
314
276
  * anywhere else.
315
277
  */
316
278
  export const MAX_FEC_RETENTION_BLOCKS = 0xff;
279
+ /**
280
+ * Receiver-local block retention used when the catalog carries no elapsed-time
281
+ * FEC window. This is a memory/cleanup bound only; it is never derived from
282
+ * media rate and never treated as a catalog deadline.
283
+ */
284
+ export const LOCAL_FEC_RETENTION_BLOCKS = 2;
285
+ /** Receiver-local cleanup budget used when the catalog has no elapsed span. */
286
+ export const LOCAL_FEC_TIMEOUT_MS = 500;
317
287
  /**
318
288
  * `deriveFecRetentionBlocks` without the throw: the block count, or `undefined`
319
289
  * when the geometry cannot define one.
package/dist/oti.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"oti.js","sourceRoot":"","sources":["../src/oti.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"oti.js","sourceRoot":"","sources":["../src/oti.ts"],"names":[],"mappings":"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"}