@blockcast/fec-worker 0.1.0 → 0.3.0-main.288475b64b3e
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +19 -9
- package/dist/block-order.d.ts +22 -0
- package/dist/block-order.d.ts.map +1 -0
- package/dist/block-order.js +48 -0
- package/dist/block-order.js.map +1 -0
- package/dist/fec-worker-client.d.ts +19 -7
- package/dist/fec-worker-client.d.ts.map +1 -1
- package/dist/fec-worker-client.js +105 -30
- package/dist/fec-worker-client.js.map +1 -1
- package/dist/fec-worker-types.d.ts +146 -25
- package/dist/fec-worker-types.d.ts.map +1 -1
- package/dist/fec-worker.js +326 -127
- package/dist/fec-worker.js.map +4 -4
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/shred-fec-worker.js +23 -2
- package/dist/shred-fec-worker.js.map +2 -2
- package/dist/shred-worker-types.d.ts +16 -1
- package/dist/shred-worker-types.d.ts.map +1 -1
- package/dist/shred-worker-types.js +16 -1
- package/dist/shred-worker-types.js.map +1 -1
- package/package.json +8 -3
- package/src/block-order.ts +59 -0
- package/src/fec-worker-client.ts +114 -32
- package/src/fec-worker-types.ts +145 -21
- package/src/fec-worker.ts +518 -180
- package/src/index.ts +3 -0
- package/src/shred-fec-worker.ts +34 -3
- package/src/shred-worker-types.ts +16 -1
- package/src/__tests__/fec-worker-alta.test.ts +0 -231
- package/src/__tests__/fec-worker-cleanup-integration.test.ts +0 -250
- package/src/__tests__/fec-worker-pending-queue.test.ts +0 -315
- package/src/__tests__/fec-worker-repair-size.test.ts +0 -1029
- package/src/__tests__/fec-worker-wasm-contract.test.ts +0 -84
- package/src/__tests__/shred-fec-worker.test.ts +0 -448
- package/src/fec-worker-client.test.ts +0 -530
- package/src/fec-worker-types.test.ts +0 -400
- package/src/shred-worker-client.test.ts +0 -182
- package/src/transfer.test.ts +0 -24
package/README.md
CHANGED
|
@@ -38,7 +38,8 @@ const config: FecTrackConfig = {
|
|
|
38
38
|
resolution: { w: 1920, h: 1080 },
|
|
39
39
|
framerate: 30,
|
|
40
40
|
algorithm: "raptor",
|
|
41
|
-
|
|
41
|
+
blockProfile: "iso-ssbg1-v1", // catalog fec.blockProfile: required, never defaulted; the only profile (the retired "k-padded-v1" is refused)
|
|
42
|
+
k: 32, // the maximum SSB_length of a block
|
|
42
43
|
repairCount: 8,
|
|
43
44
|
symbolSize: 1312,
|
|
44
45
|
interleaveDepth: 30,
|
|
@@ -114,11 +115,12 @@ All messages are typed as discriminated unions in `fec-worker-types.ts`. Both th
|
|
|
114
115
|
| `feedRepair` | `ssStart: number`, `ssbLength: number`, `rsId: number`, `data: ArrayBuffer`, `ts: number` | `data` |
|
|
115
116
|
| `relayBlockSig` | `sbn: number`, `sig: ArrayBuffer`, `hash: ArrayBuffer` | `sig`, `hash` |
|
|
116
117
|
| `cleanup` | `sbns: number[]` (all timed-out blocks covered by this coalesced barrier) | none |
|
|
118
|
+
| `subscribeBlockUpdates` | — (send only after `capabilities` lists it) | none |
|
|
117
119
|
| `dispose` | — | none |
|
|
118
120
|
|
|
119
|
-
`feedSource` carries the **
|
|
121
|
+
`feedSource` carries the **32-bit Source Symbol ID** from the MMTP Source FEC Payload ID (ISO 23008-1 §C.5.2), consecutive per FEC source packet and wrapping at 2^32, and as `data` the protected packet itself, at most T-2 bytes (ssbg_mode1, §C.3.3). A source belongs to the block a repair states; until one does, the Worker and the decoder hold it unplaced. Never derive a block from an SS_ID.
|
|
120
122
|
|
|
121
|
-
`feedRepair` carries the wire-level Repair FEC Payload ID fields directly (ISO 23008-1 §C.5.3): `ssStart` is the SS_ID of the first source symbol in the block, `ssbLength`
|
|
123
|
+
`feedRepair` carries the wire-level Repair FEC Payload ID fields directly (ISO 23008-1 §C.5.3): `ssStart` is the SS_ID of the first source symbol in the block (any uint32; the block key), `ssbLength` is the authored source-symbol count in `1..configured K`, and `rsId` is the repair index within the block. The block is `[ssStart, ssStart + ssbLength)` with K' = `ssbLength` and repair ESI = `ssbLength + rsId`; the configured K is only the maximum `ssbLength`; K is never inferred from repair traffic.
|
|
122
124
|
|
|
123
125
|
### Outbound — `FecWorkerEvent` (worker → main)
|
|
124
126
|
|
|
@@ -126,11 +128,13 @@ All messages are typed as discriminated unions in `fec-worker-types.ts`. Both th
|
|
|
126
128
|
|--------|---------|------------------|
|
|
127
129
|
| `frame` | `data: ArrayBuffer`, `meta: FrameMeta` | `data` |
|
|
128
130
|
| `snapshot` | `stats: FecTrackStats` | none (structured clone) |
|
|
129
|
-
| `
|
|
130
|
-
| `
|
|
131
|
+
| `capabilities` | `commands: FecWorkerOptionalCommand[]` (after `configure`) | none |
|
|
132
|
+
| `blockUpdate` | `block: FecBlockSnapshot` (only after `subscribeBlockUpdates`) | none |
|
|
131
133
|
| `cleanupComplete` | `sbns: number[]` | none |
|
|
132
134
|
| `error` | `message: string` | none |
|
|
133
135
|
|
|
136
|
+
The Worker posts `blockUpdate` only to a client that sent `subscribeBlockUpdates`: each one is a structured clone and a page-thread task, and the snapshot already counts every transition. `FecWorkerClient` subscribes when `onBlockUpdate` is registered and the Worker has announced the command. A Worker that predates the command posts `blockUpdate` unasked and is never sent it (BLO-36599).
|
|
137
|
+
|
|
134
138
|
`FrameMeta` carries `recovered: boolean` (this frame came out of the FEC decode, not the direct path), `sbn: number`, and `altaVerified: boolean | null` (signature outcome, or `null` when ALTA is not configured / verification is pending).
|
|
135
139
|
|
|
136
140
|
## Lifecycle
|
|
@@ -140,7 +144,8 @@ new FecWorkerClient(url)
|
|
|
140
144
|
│ worker spawned with { type: "module" }
|
|
141
145
|
▼
|
|
142
146
|
client.configure(config, wasmModule [, altaPublicKey, altaWasmModule])
|
|
143
|
-
│ worker initSyncs WASM, instantiates MmtFecDecoder(interleaveDepth,
|
|
147
|
+
│ worker initSyncs WASM, instantiates MmtFecDecoder(interleaveDepth, blockProfile),
|
|
148
|
+
│ refuses a decoder whose get_block_profile() differs,
|
|
144
149
|
│ immediately configures exact catalog K/T (no decoder defaults),
|
|
145
150
|
│ derives pendingVerifyCap = ceil(D × 1.5) and TTL = ceil(K × interleaveMs × 1.5)
|
|
146
151
|
│ from catalog values, throws if any of K / D / interleaveMs ≤ 0,
|
|
@@ -154,7 +159,9 @@ client.feedSource(...) / feedRepair(...) ◄── steady state
|
|
|
154
159
|
client.cleanup(sbn) ◄── per-block inactivity deadline
|
|
155
160
|
│ coalesces queued SBNs behind one worker queue-drain barrier
|
|
156
161
|
│ evicts blocks relative to max(sbns) − D × 3
|
|
157
|
-
│
|
|
162
|
+
│ retires exactly those SBNs via WASM cleanup_blocks_detailed(); a lost
|
|
163
|
+
│ block is never answered with a synthesised frame (sinks hold the last
|
|
164
|
+
│ good frame, per @blockcast/mmt-container conceal-timeline)
|
|
158
165
|
│ acknowledges every SBN in {type:"cleanupComplete", sbns}
|
|
159
166
|
│ any block still in "collecting" at eviction time is counted as failed
|
|
160
167
|
▼
|
|
@@ -179,13 +186,16 @@ The `snapshot` event delivers a `FecTrackStats` every 200 ms (catalog-derived; n
|
|
|
179
186
|
| `blocksComplete` | Block had all K source symbols without needing repair |
|
|
180
187
|
| `blocksRecovered` | Block was recovered using ≥1 repair symbol |
|
|
181
188
|
| `blocksFailed` | Block aged out before reaching K |
|
|
182
|
-
| `greenFillFrames` | Frames substituted with green-fill on unrecoverable loss |
|
|
183
189
|
| `recoveryRate` | `recovered / (recovered + failed)`, 0–100 |
|
|
184
190
|
| `avgRecoveryMs`, `maxRecoveryMs` | Rolling decode latency (capped at 1000 samples) |
|
|
185
|
-
| `liveSbn` |
|
|
191
|
+
| `liveSbn` | Newest accepted SS_ID or SS_Start, in RFC 1982 serial order |
|
|
192
|
+
| `repairSymbolSizeMismatch` | Repair symbols rejected before WASM because their byte length did not match `T` |
|
|
193
|
+
| `sourceDroppedRetired` / `sourceDroppedTerminal` / `sourceDroppedDuplicate` | Source symbols dropped before WASM, by **first matching** cause (see below) |
|
|
186
194
|
| `blocks` | Up to `max(D × 3, 24)` recent `FecBlockSnapshot`s for live visualization |
|
|
187
195
|
| `interleaveWindowBlocks` | `D` from config |
|
|
188
196
|
|
|
197
|
+
The three `sourceDropped*` counters split by cause for the same reason the ALTA four-way split exists — so a dashboard can tell the failure modes apart. They are tested in a fixed order, each returning early — `Retired` → `Terminal` → `Duplicate` — so a symbol counts once, under the **first** cause that matches: a symbol that is both past retention and a repeat counts only as `Retired`, and `Terminal` absorbs every post-settle duplicate. A block that settles at K-1 source symbols (BLO-35597 defect 2) is explained by a late symbol past retention (`Retired`), a symbol for a block that had already settled — complete, recovered **or failed** (`Terminal`), or a repeated SS_ID (`Duplicate`). `Retired` and `Terminal` narrow the cause; they do not attribute it. `Duplicate` does: it cannot fire once a block settles — the `Terminal` check returns first, and `markBlockTerminal` retires the block's accepted-ESI set anyway — so a non-zero `Duplicate` is positive evidence that a repeated SS_ID reached the worker while the block was **still collecting** — a duplicate packet on the wire (an ESI is the SS_ID's serial distance from SS_Start, so no derivation can collide). It attributes the **timing**, not the origin. A symbol lost in transit never reaches the worker and increments nothing, so **all three reading zero is not evidence of a publisher defect** — wire loss produces an identical shape. Separate those with `FecBlockSnapshot.ssbLength`: below `k` is a genuinely short authored block, equal to `k` with fewer accepted is loss-or-late, undefined (no repair symbol yet) leaves both open. All three are cumulative across decoder epochs, so they stay comparable against the `sourceSymbols` denominator; only a reset zeroes them.
|
|
198
|
+
|
|
189
199
|
When ALTA is enabled, the snapshot also carries the four-state verification accounting — `altaVerified` (crypto passed), `altaFailed` (tamper-confirmed), `altaPending` (unverifiable, e.g. missing trailer / late-joiner anchor gap), `altaError` (verifier threw — infrastructure flake, not tamper) — plus `altaInitFailed` (true if the ALTA WASM didn't initialize), `altaPendingEvictedCap` / `altaPendingEvictedTtl` (deferred-queue eviction reasons), and a bounded `altaFailedDetails[]` ring with the last ≤16 tamper events. The four-way split exists so ops alerting can distinguish a network problem (`altaPending` rising) from an attack (`altaFailed` rising) from a runtime bug (`altaError` rising).
|
|
190
200
|
|
|
191
201
|
`FecTrackStats` is also the shape consumed downstream by `@blockcast/mmt-container`'s `CmcdProducer` and the diagnostics `fec-panel` — keep it stable when you extend it.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Order of iso-ssbg1-v1 FEC blocks on the 32-bit SS_ID (ISO/IEC 23008-1:2023
|
|
3
|
+
* C.5.2/C.5.3; RFC 1982 serial arithmetic, SERIAL_BITS = 32; BLO-35597 iso:5).
|
|
4
|
+
* The K-stride (SBN * K) order of the retired k-padded-v1 profile is gone.
|
|
5
|
+
*/
|
|
6
|
+
/** Forward RFC 1982 distance from `from` to `to` on the 32-bit SS_ID, in 0..2^32-1. */
|
|
7
|
+
export declare function serialDistance(from: number, to: number): number;
|
|
8
|
+
/** Whether `a` precedes `b` under RFC 1982 serial comparison (SERIAL_BITS = 32). */
|
|
9
|
+
export declare function serialPrecedes(a: number, b: number): boolean;
|
|
10
|
+
/** Whether `ssId` is one of the `ssbLength` consecutive SS_IDs starting at `ssStart`, mod 2^32. */
|
|
11
|
+
export declare function isoBlockContains(ssStart: number, ssbLength: number, ssId: number): boolean;
|
|
12
|
+
/** Whether two SS_ID ranges `[start, start + length)` share any SS_ID, mod 2^32. */
|
|
13
|
+
export declare function isoBlocksOverlap(aStart: number, aLength: number, bStart: number, bLength: number): boolean;
|
|
14
|
+
/**
|
|
15
|
+
* How many blocks SS_ID `a` lies behind SS_ID `b` (0 unless `a` precedes `b`):
|
|
16
|
+
* a lower bound, because an iso-ssbg1-v1 block holds at most `kMax` source
|
|
17
|
+
* symbols, so `n * kMax` SS_IDs always span at least `n` blocks. This is the
|
|
18
|
+
* one interleave-horizon metric every ISO receiver layer shares (decoder
|
|
19
|
+
* retention, worker retirement, ordered-relay settlement).
|
|
20
|
+
*/
|
|
21
|
+
export declare function isoBlocksBehind(a: number, b: number, kMax: number): number;
|
|
22
|
+
//# sourceMappingURL=block-order.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"block-order.d.ts","sourceRoot":"","sources":["../src/block-order.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1F;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACb,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1E"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Order of iso-ssbg1-v1 FEC blocks on the 32-bit SS_ID (ISO/IEC 23008-1:2023
|
|
3
|
+
* C.5.2/C.5.3; RFC 1982 serial arithmetic, SERIAL_BITS = 32; BLO-35597 iso:5).
|
|
4
|
+
* The K-stride (SBN * K) order of the retired k-padded-v1 profile is gone.
|
|
5
|
+
*/
|
|
6
|
+
const SPAN = 0x1_0000_0000;
|
|
7
|
+
const HALF = 0x8000_0000;
|
|
8
|
+
// --- iso-ssbg1-v1 (ISO/IEC 23008-1 C.3.3 ssbg_mode1; C.5.2/C.5.3) ---------
|
|
9
|
+
//
|
|
10
|
+
// Under the ISO profile SS_ID increments by one per FEC source packet and
|
|
11
|
+
// wraps at 2^32, and a block is the SSB_length consecutive SS_IDs
|
|
12
|
+
// `[SS_Start, SS_Start + SSB_length)`. Blocks are keyed and ordered by their
|
|
13
|
+
// SS_Start, never by an SBN derived from K: the catalog K is only the maximum
|
|
14
|
+
// block length (kMax). The canonical helpers are @blockcast/mmt-base
|
|
15
|
+
// `serial32Distance` / `serial32Precedes` / `isoBlockContains` /
|
|
16
|
+
// `isoBlocksBehindLowerBound`; this bundle carries its own copies (it does not
|
|
17
|
+
// depend on mmt-base), and block-order.test.ts pins them to the same vectors.
|
|
18
|
+
/** Forward RFC 1982 distance from `from` to `to` on the 32-bit SS_ID, in 0..2^32-1. */
|
|
19
|
+
export function serialDistance(from, to) {
|
|
20
|
+
return (to - from + SPAN) % SPAN;
|
|
21
|
+
}
|
|
22
|
+
/** Whether `a` precedes `b` under RFC 1982 serial comparison (SERIAL_BITS = 32). */
|
|
23
|
+
export function serialPrecedes(a, b) {
|
|
24
|
+
const distance = serialDistance(a, b);
|
|
25
|
+
return distance !== 0 && distance < HALF;
|
|
26
|
+
}
|
|
27
|
+
/** Whether `ssId` is one of the `ssbLength` consecutive SS_IDs starting at `ssStart`, mod 2^32. */
|
|
28
|
+
export function isoBlockContains(ssStart, ssbLength, ssId) {
|
|
29
|
+
return serialDistance(ssStart, ssId) < ssbLength;
|
|
30
|
+
}
|
|
31
|
+
/** Whether two SS_ID ranges `[start, start + length)` share any SS_ID, mod 2^32. */
|
|
32
|
+
export function isoBlocksOverlap(aStart, aLength, bStart, bLength) {
|
|
33
|
+
return isoBlockContains(aStart, aLength, bStart) || isoBlockContains(bStart, bLength, aStart);
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* How many blocks SS_ID `a` lies behind SS_ID `b` (0 unless `a` precedes `b`):
|
|
37
|
+
* a lower bound, because an iso-ssbg1-v1 block holds at most `kMax` source
|
|
38
|
+
* symbols, so `n * kMax` SS_IDs always span at least `n` blocks. This is the
|
|
39
|
+
* one interleave-horizon metric every ISO receiver layer shares (decoder
|
|
40
|
+
* retention, worker retirement, ordered-relay settlement).
|
|
41
|
+
*/
|
|
42
|
+
export function isoBlocksBehind(a, b, kMax) {
|
|
43
|
+
if (!Number.isSafeInteger(kMax) || kMax <= 0) {
|
|
44
|
+
throw new Error(`iso-ssbg1-v1 block horizon needs a positive maximum K (got ${kMax})`);
|
|
45
|
+
}
|
|
46
|
+
return serialPrecedes(a, b) ? Math.floor(serialDistance(a, b) / kMax) : 0;
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=block-order.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"block-order.js","sourceRoot":"","sources":["../src/block-order.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,IAAI,GAAG,aAAa,CAAC;AAC3B,MAAM,IAAI,GAAG,WAAW,CAAC;AAEzB,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,kEAAkE;AAClE,6EAA6E;AAC7E,8EAA8E;AAC9E,qEAAqE;AACrE,iEAAiE;AACjE,+EAA+E;AAC/E,8EAA8E;AAE9E,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,EAAU;IACtD,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAClC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,OAAO,QAAQ,KAAK,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC;AAC1C,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,SAAiB,EAAE,IAAY;IAChF,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;AAClD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAC/B,MAAc,EACd,OAAe,EACf,MAAc,EACd,OAAe;IAEf,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS,EAAE,IAAY;IACjE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,8DAA8D,IAAI,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC"}
|
|
@@ -25,7 +25,8 @@ export declare class FecWorkerClient {
|
|
|
25
25
|
configure(config: FecTrackConfig, wasmModule: WebAssembly.Module, altaPublicKey?: ArrayBuffer, altaWasmModule?: WebAssembly.Module): void;
|
|
26
26
|
/**
|
|
27
27
|
* Feed a source symbol to the Worker. data ArrayBuffer is transferred (zero-copy).
|
|
28
|
-
* Caller must not access data after this call — it is
|
|
28
|
+
* Caller must not access data after this call — it is transferred with the
|
|
29
|
+
* task's symbol batch, before any later command of this client.
|
|
29
30
|
*
|
|
30
31
|
* Optional `alta` carries the detached ALTA authenticator bytes and the
|
|
31
32
|
* byte offset in `data` where the signed payload ends. The auth buffer is
|
|
@@ -41,8 +42,8 @@ export declare class FecWorkerClient {
|
|
|
41
42
|
* Caller must not access data after this call — it is detached.
|
|
42
43
|
*
|
|
43
44
|
* Carries the wire-level Repair FEC Payload ID fields (ISO 23008-1 §C.5.3):
|
|
44
|
-
* - ssStart: SS_ID of first source symbol in the block (
|
|
45
|
-
* - ssbLength:
|
|
45
|
+
* - ssStart: SS_ID of first source symbol in the block (any uint32; the block key)
|
|
46
|
+
* - ssbLength: authored source-symbol count (1..configured K)
|
|
46
47
|
* - rsId: repair symbol index within the block
|
|
47
48
|
*/
|
|
48
49
|
feedRepair(ssStart: number, ssbLength: number, rsId: number, data: ArrayBuffer, ts: number): void;
|
|
@@ -51,7 +52,8 @@ export declare class FecWorkerClient {
|
|
|
51
52
|
*/
|
|
52
53
|
relayBlockSig(sbn: number, sig: ArrayBuffer, hash: ArrayBuffer): void;
|
|
53
54
|
/**
|
|
54
|
-
* Trigger cleanup after a block's inactivity deadline.
|
|
55
|
+
* Trigger cleanup after a block's inactivity deadline. `currentSbn` is the
|
|
56
|
+
* block key, the block's SS_Start.
|
|
55
57
|
*
|
|
56
58
|
* While one queue-drain barrier is in flight, later SBNs are coalesced into
|
|
57
59
|
* the next command without losing their individual acknowledgement identity.
|
|
@@ -63,14 +65,24 @@ export declare class FecWorkerClient {
|
|
|
63
65
|
onFrame(cb: (data: ArrayBuffer, meta: FrameMeta) => void): void;
|
|
64
66
|
/** Register callback for periodic stats snapshots (FEC-04). */
|
|
65
67
|
onSnapshot(cb: (stats: FecTrackStats) => void): void;
|
|
66
|
-
/**
|
|
68
|
+
/**
|
|
69
|
+
* Register callback for individual block state changes. The Worker posts
|
|
70
|
+
* them only once asked, so registering subscribes (after the Worker
|
|
71
|
+
* announces `subscribeBlockUpdates`). An older Worker that does not
|
|
72
|
+
* announce it posts them unasked.
|
|
73
|
+
*/
|
|
67
74
|
onBlockUpdate(cb: (block: FecBlockSnapshot) => void): void;
|
|
68
|
-
/** Register callback for green-fill frames. */
|
|
69
|
-
onGreenFill(cb: (sbn: number, data: ArrayBuffer) => void): void;
|
|
70
75
|
/** Register callback fired after the Worker drains all commands queued before cleanup. */
|
|
71
76
|
onCleanupComplete(cb: (sbn: number) => void): void;
|
|
72
77
|
/** Register callback for Worker errors. */
|
|
73
78
|
onError(cb: (message: string, code?: FecWorkerErrorCode) => void): void;
|
|
79
|
+
/**
|
|
80
|
+
* True once dispose() ran. A disposed client cannot decode, fill, or
|
|
81
|
+
* acknowledge anything, so routing symbols to it discards them; every
|
|
82
|
+
* command method (feedSource, feedRepair, relayBlockSig, cleanup, reset)
|
|
83
|
+
* throws rather than pretend otherwise. Callers check this first.
|
|
84
|
+
*/
|
|
85
|
+
get disposed(): boolean;
|
|
74
86
|
/**
|
|
75
87
|
* Dispose the Worker. Sends dispose command then terminates.
|
|
76
88
|
* Idempotent — safe to call multiple times.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fec-worker-client.d.ts","sourceRoot":"","sources":["../src/fec-worker-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"fec-worker-client.d.ts","sourceRoot":"","sources":["../src/fec-worker-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAIX,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,eAAe;;IA2B3B;;;OAGG;gBACS,WAAW,EAAE,MAAM,GAAG,GAAG;IAgBrC;;;;;;OAMG;IACH,SAAS,CACR,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,WAAW,CAAC,MAAM,EAC9B,aAAa,CAAC,EAAE,WAAW,EAC3B,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,GACjC,IAAI;IAmBP;;;;;;;;;OASG;IACH,UAAU,CACT,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAC9C,IAAI;IAoBP;;;;;;;;OAQG;IACH,UAAU,CACT,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,GACR,IAAI;IAqCP;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IASrE;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAgBjC,8EAA8E;IAC9E,KAAK,IAAI,IAAI;IAoBb,+DAA+D;IAC/D,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAI/D,+DAA+D;IAC/D,UAAU,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAIpD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAkB1D,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIlD,2CAA2C;IAC3C,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAIvE;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI;CA6Df"}
|
|
@@ -12,7 +12,6 @@ export class FecWorkerClient {
|
|
|
12
12
|
#onFrame = null;
|
|
13
13
|
#onSnapshot = null;
|
|
14
14
|
#onBlockUpdate = null;
|
|
15
|
-
#onGreenFill = null;
|
|
16
15
|
#onCleanupComplete = null;
|
|
17
16
|
#onError = null;
|
|
18
17
|
#cleanupInFlight = null;
|
|
@@ -20,6 +19,20 @@ export class FecWorkerClient {
|
|
|
20
19
|
#pendingResets = 0;
|
|
21
20
|
#resetFailed = false;
|
|
22
21
|
#disposed = false;
|
|
22
|
+
// Symbols fed during the current task, sent as one feedSymbols message
|
|
23
|
+
// when the task's microtasks run (BLO-36599). A packet stream delivers many
|
|
24
|
+
// symbols per task, and each postMessage is a structured-clone round trip
|
|
25
|
+
// on the page thread; the batch boundary is the task, not a size or timer.
|
|
26
|
+
#pendingSymbols = [];
|
|
27
|
+
#pendingTransfer = [];
|
|
28
|
+
#flushQueued = false;
|
|
29
|
+
// Batching starts only once the Worker announced it accepts feedSymbols.
|
|
30
|
+
#batchSymbols = false;
|
|
31
|
+
// The Worker posts blockUpdate events only to a client that subscribed,
|
|
32
|
+
// which this client does once a callback is registered and the Worker
|
|
33
|
+
// announced the command (BLO-36599).
|
|
34
|
+
#blockUpdatesAnnounced = false;
|
|
35
|
+
#blockUpdatesSubscribed = false;
|
|
23
36
|
/**
|
|
24
37
|
* Create a FecWorkerClient.
|
|
25
38
|
* @param workerOrUrl - Either a Worker instance (for testing) or a URL to create one
|
|
@@ -49,6 +62,7 @@ export class FecWorkerClient {
|
|
|
49
62
|
configure(config, wasmModule, altaPublicKey, altaWasmModule) {
|
|
50
63
|
if (this.#disposed)
|
|
51
64
|
throw new Error("[FecWorkerClient] disposed");
|
|
65
|
+
this.#flushSymbols();
|
|
52
66
|
const cmd = {
|
|
53
67
|
type: "configure",
|
|
54
68
|
config,
|
|
@@ -67,7 +81,8 @@ export class FecWorkerClient {
|
|
|
67
81
|
}
|
|
68
82
|
/**
|
|
69
83
|
* Feed a source symbol to the Worker. data ArrayBuffer is transferred (zero-copy).
|
|
70
|
-
* Caller must not access data after this call — it is
|
|
84
|
+
* Caller must not access data after this call — it is transferred with the
|
|
85
|
+
* task's symbol batch, before any later command of this client.
|
|
71
86
|
*
|
|
72
87
|
* Optional `alta` carries the detached ALTA authenticator bytes and the
|
|
73
88
|
* byte offset in `data` where the signed payload ends. The auth buffer is
|
|
@@ -76,58 +91,84 @@ export class FecWorkerClient {
|
|
|
76
91
|
*/
|
|
77
92
|
feedSource(ssId, data, ts, alta) {
|
|
78
93
|
if (this.#disposed)
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
94
|
+
throw new Error("[FecWorkerClient] feedSource on a disposed client");
|
|
95
|
+
if (alta) {
|
|
96
|
+
this.#queueSymbol({
|
|
82
97
|
type: "feedSource",
|
|
83
98
|
ssId,
|
|
84
99
|
data,
|
|
85
100
|
ts,
|
|
86
101
|
altaAuth: alta.auth,
|
|
87
102
|
altaPayloadEnd: alta.payloadEnd,
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
103
|
+
}, data, alta.auth);
|
|
104
|
+
}
|
|
105
|
+
else {
|
|
106
|
+
this.#queueSymbol({ type: "feedSource", ssId, data, ts }, data);
|
|
107
|
+
}
|
|
92
108
|
}
|
|
93
109
|
/**
|
|
94
110
|
* Feed a repair symbol to the Worker. data ArrayBuffer is transferred (zero-copy).
|
|
95
111
|
* Caller must not access data after this call — it is detached.
|
|
96
112
|
*
|
|
97
113
|
* Carries the wire-level Repair FEC Payload ID fields (ISO 23008-1 §C.5.3):
|
|
98
|
-
* - ssStart: SS_ID of first source symbol in the block (
|
|
99
|
-
* - ssbLength:
|
|
114
|
+
* - ssStart: SS_ID of first source symbol in the block (any uint32; the block key)
|
|
115
|
+
* - ssbLength: authored source-symbol count (1..configured K)
|
|
100
116
|
* - rsId: repair symbol index within the block
|
|
101
117
|
*/
|
|
102
118
|
feedRepair(ssStart, ssbLength, rsId, data, ts) {
|
|
103
119
|
if (this.#disposed)
|
|
120
|
+
throw new Error("[FecWorkerClient] feedRepair on a disposed client");
|
|
121
|
+
this.#queueSymbol({ type: "feedRepair", ssStart, ssbLength, rsId, data, ts }, data);
|
|
122
|
+
}
|
|
123
|
+
#queueSymbol(symbol, data, auth) {
|
|
124
|
+
if (!this.#batchSymbols) {
|
|
125
|
+
this.#worker.postMessage(symbol, auth ? [data, auth] : [data]);
|
|
104
126
|
return;
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
127
|
+
}
|
|
128
|
+
this.#pendingSymbols.push(symbol);
|
|
129
|
+
this.#pendingTransfer.push(data);
|
|
130
|
+
if (auth)
|
|
131
|
+
this.#pendingTransfer.push(auth);
|
|
132
|
+
if (this.#flushQueued)
|
|
133
|
+
return;
|
|
134
|
+
this.#flushQueued = true;
|
|
135
|
+
queueMicrotask(() => {
|
|
136
|
+
this.#flushQueued = false;
|
|
137
|
+
this.#flushSymbols();
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* Send the symbols fed so far. Every other command calls this first, so a
|
|
142
|
+
* cleanup barrier, reset or signature still follows all earlier symbols.
|
|
143
|
+
*/
|
|
144
|
+
#flushSymbols() {
|
|
145
|
+
if (this.#pendingSymbols.length === 0 || this.#disposed)
|
|
146
|
+
return;
|
|
147
|
+
const symbols = this.#pendingSymbols;
|
|
148
|
+
const transfer = this.#pendingTransfer;
|
|
149
|
+
this.#pendingSymbols = [];
|
|
150
|
+
this.#pendingTransfer = [];
|
|
151
|
+
this.#worker.postMessage({ type: "feedSymbols", symbols }, transfer);
|
|
113
152
|
}
|
|
114
153
|
/**
|
|
115
154
|
* Submit relay block signature for verification. sig and hash are transferred.
|
|
116
155
|
*/
|
|
117
156
|
relayBlockSig(sbn, sig, hash) {
|
|
118
157
|
if (this.#disposed)
|
|
119
|
-
|
|
158
|
+
throw new Error("[FecWorkerClient] relayBlockSig on a disposed client");
|
|
159
|
+
this.#flushSymbols();
|
|
120
160
|
this.#worker.postMessage({ type: "relayBlockSig", sbn, sig, hash }, [sig, hash]);
|
|
121
161
|
}
|
|
122
162
|
/**
|
|
123
|
-
* Trigger cleanup after a block's inactivity deadline.
|
|
163
|
+
* Trigger cleanup after a block's inactivity deadline. `currentSbn` is the
|
|
164
|
+
* block key, the block's SS_Start.
|
|
124
165
|
*
|
|
125
166
|
* While one queue-drain barrier is in flight, later SBNs are coalesced into
|
|
126
167
|
* the next command without losing their individual acknowledgement identity.
|
|
127
168
|
*/
|
|
128
169
|
cleanup(currentSbn) {
|
|
129
170
|
if (this.#disposed)
|
|
130
|
-
|
|
171
|
+
throw new Error("[FecWorkerClient] cleanup on a disposed client");
|
|
131
172
|
if (!Number.isInteger(currentSbn) ||
|
|
132
173
|
currentSbn < 0 ||
|
|
133
174
|
currentSbn > 0xffff_ffff) {
|
|
@@ -142,13 +183,17 @@ export class FecWorkerClient {
|
|
|
142
183
|
/** Reset this track's decoder epoch while preserving Worker configuration. */
|
|
143
184
|
reset() {
|
|
144
185
|
if (this.#disposed)
|
|
145
|
-
|
|
186
|
+
throw new Error("[FecWorkerClient] reset on a disposed client");
|
|
187
|
+
this.#flushSymbols();
|
|
146
188
|
this.#pendingResets++;
|
|
147
189
|
this.#cleanupInFlight = null;
|
|
148
190
|
this.#queuedCleanupSbns.clear();
|
|
149
191
|
this.#worker.postMessage({ type: "reset" });
|
|
150
192
|
}
|
|
151
193
|
#postCleanup(sbns) {
|
|
194
|
+
// The cleanup is a queue-drain barrier: every symbol fed before it is
|
|
195
|
+
// posted must reach the Worker first.
|
|
196
|
+
this.#flushSymbols();
|
|
152
197
|
this.#cleanupInFlight = sbns;
|
|
153
198
|
const orderedSbns = [...sbns].sort((a, b) => a - b);
|
|
154
199
|
this.#worker.postMessage({ type: "cleanup", sbns: orderedSbns });
|
|
@@ -161,13 +206,24 @@ export class FecWorkerClient {
|
|
|
161
206
|
onSnapshot(cb) {
|
|
162
207
|
this.#onSnapshot = cb;
|
|
163
208
|
}
|
|
164
|
-
/**
|
|
209
|
+
/**
|
|
210
|
+
* Register callback for individual block state changes. The Worker posts
|
|
211
|
+
* them only once asked, so registering subscribes (after the Worker
|
|
212
|
+
* announces `subscribeBlockUpdates`). An older Worker that does not
|
|
213
|
+
* announce it posts them unasked.
|
|
214
|
+
*/
|
|
165
215
|
onBlockUpdate(cb) {
|
|
166
216
|
this.#onBlockUpdate = cb;
|
|
217
|
+
this.#subscribeBlockUpdates();
|
|
167
218
|
}
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
219
|
+
#subscribeBlockUpdates() {
|
|
220
|
+
if (this.#disposed ||
|
|
221
|
+
this.#blockUpdatesSubscribed ||
|
|
222
|
+
!this.#blockUpdatesAnnounced ||
|
|
223
|
+
!this.#onBlockUpdate)
|
|
224
|
+
return;
|
|
225
|
+
this.#blockUpdatesSubscribed = true;
|
|
226
|
+
this.#worker.postMessage({ type: "subscribeBlockUpdates" });
|
|
171
227
|
}
|
|
172
228
|
/** Register callback fired after the Worker drains all commands queued before cleanup. */
|
|
173
229
|
onCleanupComplete(cb) {
|
|
@@ -177,6 +233,15 @@ export class FecWorkerClient {
|
|
|
177
233
|
onError(cb) {
|
|
178
234
|
this.#onError = cb;
|
|
179
235
|
}
|
|
236
|
+
/**
|
|
237
|
+
* True once dispose() ran. A disposed client cannot decode, fill, or
|
|
238
|
+
* acknowledge anything, so routing symbols to it discards them; every
|
|
239
|
+
* command method (feedSource, feedRepair, relayBlockSig, cleanup, reset)
|
|
240
|
+
* throws rather than pretend otherwise. Callers check this first.
|
|
241
|
+
*/
|
|
242
|
+
get disposed() {
|
|
243
|
+
return this.#disposed;
|
|
244
|
+
}
|
|
180
245
|
/**
|
|
181
246
|
* Dispose the Worker. Sends dispose command then terminates.
|
|
182
247
|
* Idempotent — safe to call multiple times.
|
|
@@ -185,12 +250,25 @@ export class FecWorkerClient {
|
|
|
185
250
|
if (this.#disposed)
|
|
186
251
|
return;
|
|
187
252
|
this.#disposed = true;
|
|
253
|
+
// A terminated Worker decodes nothing; symbols still batched are dropped.
|
|
254
|
+
this.#pendingSymbols = [];
|
|
255
|
+
this.#pendingTransfer = [];
|
|
188
256
|
this.#cleanupInFlight = null;
|
|
189
257
|
this.#queuedCleanupSbns.clear();
|
|
190
258
|
this.#worker.postMessage({ type: "dispose" });
|
|
191
259
|
this.#worker.terminate();
|
|
192
260
|
}
|
|
193
261
|
#handleEvent(event) {
|
|
262
|
+
if (event.type === "capabilities") {
|
|
263
|
+
if (Array.isArray(event.commands) && event.commands.includes("feedSymbols")) {
|
|
264
|
+
this.#batchSymbols = true;
|
|
265
|
+
}
|
|
266
|
+
if (Array.isArray(event.commands) && event.commands.includes("subscribeBlockUpdates")) {
|
|
267
|
+
this.#blockUpdatesAnnounced = true;
|
|
268
|
+
this.#subscribeBlockUpdates();
|
|
269
|
+
}
|
|
270
|
+
return;
|
|
271
|
+
}
|
|
194
272
|
if (event.type === "resetComplete") {
|
|
195
273
|
this.#pendingResets = Math.max(0, this.#pendingResets - 1);
|
|
196
274
|
this.#resetFailed = false;
|
|
@@ -219,9 +297,6 @@ export class FecWorkerClient {
|
|
|
219
297
|
case "blockUpdate":
|
|
220
298
|
this.#onBlockUpdate?.(event.block);
|
|
221
299
|
break;
|
|
222
|
-
case "greenFill":
|
|
223
|
-
this.#onGreenFill?.(event.sbn, event.data);
|
|
224
|
-
break;
|
|
225
300
|
case "cleanupComplete":
|
|
226
301
|
for (const sbn of event.sbns) {
|
|
227
302
|
this.#onCleanupComplete?.(sbn);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fec-worker-client.js","sourceRoot":"","sources":["../src/fec-worker-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;
|
|
1
|
+
{"version":3,"file":"fec-worker-client.js","sourceRoot":"","sources":["../src/fec-worker-client.ts"],"names":[],"mappings":"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"}
|