@blockcast/fec-worker 0.3.0 → 0.4.0-main.248efb07e294

package/dist/fec-worker.js

@@ -10,20 +10,6 @@ function toOwnedArrayBuffer(view) {
 // src/block-order.ts
 var SPAN = 4294967296;
 var HALF = 2147483648;
-function blockStart(sbn, k) {
-  return sbn * k % SPAN;
-}
-function precedingDistance(a, b, k) {
-  const distance = (blockStart(b, k) - blockStart(a, k) + SPAN) % SPAN;
-  return distance !== 0 && distance < HALF ? distance : null;
-}
-function blockPrecedes(a, b, k) {
-  return precedingDistance(a, b, k) !== null;
-}
-function blocksBehind(a, b, k) {
-  const distance = precedingDistance(a, b, k);
-  return distance === null ? 0 : Math.ceil(distance / k);
-}
 function serialDistance(from, to) {
   return (to - from + SPAN) % SPAN;
 }
@@ -47,8 +33,6 @@ function isoBlocksBehind(a, b, kMax) {
 // src/fec-worker.ts
 var wasmDecoder = null;
 var config = null;
-var altaEnabled = false;
-var altaVerifier = null;
 var snapshotTimer = null;
 var blockUpdatesSubscribed = false;
 var blocks = /* @__PURE__ */ new Map();
@@ -62,19 +46,12 @@ var SSBG1_LENGTH_FIELD_BYTES = 2;
 var MAX_INTERLEAVE_DEPTH = 255;
 var MAX_SYMBOL_SIZE = 65528;
 var MAX_RAPTORQ_SOURCE_SYMBOLS_PER_BLOCK = 56403;
+var MAX_REED_SOLOMON_SOURCE_SYMBOLS_PER_BLOCK = 254;
 var sourceSymbols = 0;
 var repairSymbols = 0;
 var blocksComplete = 0;
 var blocksRecovered = 0;
 var blocksFailed = 0;
-var altaVerified = 0;
-var altaFailed = 0;
-var altaFailedDetails = [];
-var altaPending = 0;
-var altaPendingEvictedCap = 0;
-var altaPendingEvictedTtl = 0;
-var altaError = 0;
-var altaInitFailed = false;
 var relayBlocksVerified = 0;
 var relayBlocksFailed = 0;
 var liveSbn = 0;
@@ -85,9 +62,6 @@ var sourceDroppedTerminal = 0;
 var sourceDroppedDuplicate = 0;
 var sourceUnplacedRetired = 0;
 var recoveryTimes = [];
-var pendingVerify = /* @__PURE__ */ new Map();
-var pendingVerifyCap = 0;
-var pendingVerifyTtlMs = 0;
 function emit(event, transfer) {
   self.postMessage(event, transfer ?? []);
 }
@@ -106,17 +80,13 @@ function clearBlockTracking() {
   acceptedSourceEsis.clear();
   acceptedRepairEsis.clear();
   unplacedSources.clear();
-  pendingVerify.clear();
   recoveryTimes.length = 0;
   liveSbn = 0;
   liveSbnKnown = false;
 }
 function isRetiredSbn(sbn) {
   if (config === null || !liveSbnKnown) return false;
-  return config.blockProfile === "iso-ssbg1-v1" ? isoBlocksBehind(sbn, liveSbn, config.k) > config.interleaveDepth : blocksBehind(sbn, liveSbn, config.k) > config.interleaveDepth;
-}
-function isIsoProfile() {
-  return config?.blockProfile === "iso-ssbg1-v1";
+  return isoBlocksBehind(sbn, liveSbn, config.k) > config.interleaveDepth;
 }
 function isoKnownLength(block) {
   return block.ssbLength ?? 1;
@@ -128,7 +98,7 @@ function findIsoBlock(ssId) {
   return void 0;
 }
 function isRetiredBlock(key, block) {
-  return isIsoProfile() ? isRetiredSbn((key + isoKnownLength(block) - 1) % SS_ID_SPAN) : isRetiredSbn(key);
+  return isRetiredSbn((key + isoKnownLength(block) - 1) % SS_ID_SPAN);
 }
 function trimBlockRetention() {
   for (const [sbn, block] of blocks) {
@@ -139,10 +109,7 @@ function trimBlockRetention() {
 }
 function advanceMediaHorizon(sbn) {
   if (!config) return;
-  if (liveSbnKnown) {
-    const ahead = config.blockProfile === "iso-ssbg1-v1" ? serialPrecedes(liveSbn, sbn) : blockPrecedes(liveSbn, sbn, config.k);
-    if (!ahead) return;
-  }
+  if (liveSbnKnown && !serialPrecedes(liveSbn, sbn)) return;
   liveSbn = sbn;
   liveSbnKnown = true;
   trimBlockRetention();
@@ -155,8 +122,7 @@ function markBlockTerminal(block, state) {
 }
 function synchronizeDecoderHorizon() {
   if (!wasmDecoder || !liveSbnKnown) return;
-  const iso = isIsoProfile();
-  const expired = iso ? wasmDecoder.cleanup_by_ss_start(liveSbn) : wasmDecoder.cleanup_by_sbn(liveSbn);
+  const expired = wasmDecoder.cleanup_by_ss_start(liveSbn);
   for (const sbn of expired) {
     const block = blocks.get(sbn);
     if (!block || isTerminalBlock(block)) {
@@ -167,7 +133,7 @@ function synchronizeDecoderHorizon() {
     blocksFailed++;
     emitBlockUpdate(block);
   }
-  if (iso) retireUnplacedSources();
+  retireUnplacedSources();
   trimBlockRetention();
 }
 function retireUnplacedSources() {
@@ -192,8 +158,9 @@ function getOrCreateBlock(sbn, isoSsbLength) {
       repairCount: config.repairCount,
       firstSymbolTs: now,
       lastSymbolTs: now,
+      // A positive interleaveMs makes this the catalog completion deadline;
+      // zero makes deliveryWindowMs a receiver-local cleanup bound.
       deadlineTs: now + config.deliveryWindowMs,
-      altaVerified: 0,
       relayBlockSigValid: null
     };
     if (isoSsbLength !== void 0) block.ssbLength = isoSsbLength;
@@ -217,7 +184,7 @@ function buildStatsSnapshot() {
   const avgRecoveryMs = recoveryTimes.length > 0 ? recoveryTimes.reduce((a, b) => a + b, 0) / recoveryTimes.length : 0;
   const maxRecoveryMs = recoveryTimes.length > 0 ? Math.max(...recoveryTimes) : 0;
   const maxBlocks = Math.max(config.interleaveDepth * 3, 24);
-  const blockArray = Array.from(blocks.values()).sort((a, b) => b.sbn - a.sbn).slice(0, maxBlocks);
+  const blockArray = Array.from(blocks.values()).sort((a, b) => serialDistance(a.sbn, liveSbn) - serialDistance(b.sbn, liveSbn)).slice(0, maxBlocks);
   return {
     config,
     sourceSymbols,
@@ -228,15 +195,6 @@ function buildStatsSnapshot() {
     recoveryRate: blocksComplete + blocksRecovered > 0 ? Math.round(
       blocksRecovered / (blocksRecovered + blocksFailed) * 100
     ) || 0 : 0,
-    altaVerified,
-    altaFailed,
-    altaPending,
-    altaPendingEvictedCap,
-    altaPendingEvictedTtl,
-    altaError,
-    altaInitFailed,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    altaFailedDetails: altaFailedDetails.slice(),
     relayBlocksVerified,
     relayBlocksFailed,
     liveSbn,
@@ -248,7 +206,7 @@ function buildStatsSnapshot() {
     sourceDroppedRetired,
     sourceDroppedTerminal,
     sourceDroppedDuplicate,
-    ...config.blockProfile === "iso-ssbg1-v1" ? { sourceUnplacedRetired } : {},
+    sourceUnplacedRetired,
     decoder
   };
 }
@@ -280,25 +238,19 @@ function emitRecoveredSymbols(sbn, recoveredBlock, block) {
     });
     return;
   }
-  const iso = config.blockProfile === "iso-ssbg1-v1";
   for (let i = 0; i < ssbLength; i++) {
     const symbol = recoveredBlock.subarray(i * symbolSize, (i + 1) * symbolSize);
-    if (iso) {
-      const invalid = invalidSsbg1Symbol(symbol, symbolSize);
-      if (invalid !== null) {
-        emit({
-          type: "error",
-          code: "recovered-ssbg1-symbol-invalid",
-          message: `[FecWorker] Dropping recovered ssbg_mode1 symbol (ssStart=${sbn}, esi=${i}, SSB_length=${ssbLength}): ${invalid}`
-        });
-        continue;
-      }
+    const invalid = invalidSsbg1Symbol(symbol, symbolSize);
+    if (invalid !== null) {
+      emit({
+        type: "error",
+        code: "recovered-ssbg1-symbol-invalid",
+        message: `[FecWorker] Dropping recovered ssbg_mode1 symbol (ssStart=${sbn}, esi=${i}, SSB_length=${ssbLength}): ${invalid}`
+      });
+      continue;
     }
-    const recoveredAltaVerified = null;
-    if (altaEnabled) altaPending++;
     const buf = toOwnedArrayBuffer(symbol);
     const meta = {
-      altaVerified: recoveredAltaVerified,
       recovered: true,
       sbn,
       esi: i,
@@ -411,7 +363,6 @@ function feedIsoSource(cmd, view, decoder, cfg) {
     advanceMediaHorizon(cmd.ssId);
     unplacedSources.set(cmd.ssId, performance.now());
     sourceSymbols++;
-    if (altaEnabled) altaPending++;
     if (result2 && result2.byteLength > 0) {
       emit({
         type: "error",
@@ -442,7 +393,6 @@ function feedIsoSource(cmd, view, decoder, cfg) {
   block.sourceReceived++;
   block.lastSymbolTs = performance.now();
   sourceSymbols++;
-  if (altaEnabled) altaPending++;
   settleSourceArrival(key, block, result);
 }
 function findOverlappingIsoBlock(ssStart, ssbLength) {
@@ -510,22 +460,23 @@ async function handleConfigure(cmd) {
   const blockProfile = cmd.config.blockProfile;
   if (blockProfile === void 0) {
     throw new Error(
-      '[FecWorker] configure: blockProfile is required: name the FEC block profile ("k-padded-v1" or "iso-ssbg1-v1")'
+      '[FecWorker] configure: blockProfile is required: name the FEC block profile ("iso-ssbg1-v1")'
     );
   }
-  if (blockProfile !== "k-padded-v1" && blockProfile !== "iso-ssbg1-v1") {
+  if (blockProfile !== "iso-ssbg1-v1") {
     throw new Error(
-      `[FecWorker] configure: blockProfile must be "k-padded-v1" or "iso-ssbg1-v1" (got ${JSON.stringify(blockProfile)})`
+      `[FecWorker] configure: blockProfile must be "iso-ssbg1-v1" (got ${JSON.stringify(blockProfile)})`
     );
   }
+  const algorithm = cmd.config.algorithm === "reed-solomon" ? "reed-solomon" : "raptorq";
   if (!Number.isFinite(cmd.config.interleaveDepth) || !Number.isInteger(cmd.config.interleaveDepth) || cmd.config.interleaveDepth <= 0 || cmd.config.interleaveDepth > MAX_INTERLEAVE_DEPTH) {
     throw new Error(
       `[FecWorker] configure: interleaveDepth must be an integer in 1..${MAX_INTERLEAVE_DEPTH} (got ${cmd.config.interleaveDepth})`
     );
   }
-  if (!Number.isFinite(cmd.config.interleaveMs) || cmd.config.interleaveMs <= 0) {
+  if (!Number.isFinite(cmd.config.interleaveMs) || !Number.isSafeInteger(cmd.config.interleaveMs) || cmd.config.interleaveMs < 0) {
     throw new Error(
-      `[FecWorker] configure: interleaveMs must be finite and > 0 (got ${cmd.config.interleaveMs})`
+      `[FecWorker] configure: interleaveMs must be a finite non-negative integer (got ${cmd.config.interleaveMs})`
     );
   }
   if (!Number.isFinite(cmd.config.deliveryWindowMs) || cmd.config.deliveryWindowMs <= 0) {
@@ -533,14 +484,13 @@ async function handleConfigure(cmd) {
       `[FecWorker] configure: deliveryWindowMs must be > 0 (got ${cmd.config.deliveryWindowMs})`
     );
   }
-  if (!Number.isInteger(cmd.config.k) || cmd.config.k <= 0 || cmd.config.k > MAX_RAPTORQ_SOURCE_SYMBOLS_PER_BLOCK) {
-    throw new Error(
-      `[FecWorker] configure: k must be an integer in 1..${MAX_RAPTORQ_SOURCE_SYMBOLS_PER_BLOCK} (got ${cmd.config.k})`
-    );
+  const maxK = algorithm === "raptorq" ? MAX_RAPTORQ_SOURCE_SYMBOLS_PER_BLOCK : MAX_REED_SOLOMON_SOURCE_SYMBOLS_PER_BLOCK;
+  if (!Number.isInteger(cmd.config.k) || cmd.config.k <= 0 || cmd.config.k > maxK) {
+    throw new Error(`[FecWorker] configure: ${algorithm} k must be an integer in 1..${maxK} (got ${cmd.config.k})`);
   }
-  if (!Number.isInteger(cmd.config.symbolSize) || cmd.config.symbolSize <= 0 || cmd.config.symbolSize > MAX_SYMBOL_SIZE || cmd.config.symbolSize % 8 !== 0) {
+  if (!Number.isInteger(cmd.config.symbolSize) || cmd.config.symbolSize <= 0 || cmd.config.symbolSize > MAX_SYMBOL_SIZE || algorithm === "raptorq" && cmd.config.symbolSize % 8 !== 0) {
     throw new Error(
-      `[FecWorker] configure: symbolSize must be an 8-byte-aligned integer in 8..${MAX_SYMBOL_SIZE} (got ${cmd.config.symbolSize})`
+      `[FecWorker] configure: ${algorithm} symbolSize must be ${algorithm === "raptorq" ? "an 8-byte-aligned integer in 8" : "an integer in 1"}..${MAX_SYMBOL_SIZE} (got ${cmd.config.symbolSize})`
     );
   }
   const wasm = resolveWasmBindings();
@@ -548,32 +498,15 @@ async function handleConfigure(cmd) {
   wasmDecoder?.free();
   wasmDecoder = null;
   clearBlockTracking();
-  const decoder = new wasm.MmtFecDecoder(cmd.config.interleaveDepth, blockProfile);
+  const decoder = new wasm.MmtFecDecoder(cmd.config.interleaveDepth, blockProfile, algorithm);
   verifyDecoderProfile(decoder, blockProfile);
+  const decoderAlgorithm = decoder.get_algorithm?.() ?? "raptorq";
+  if (decoderAlgorithm !== algorithm) {
+    decoder.free();
+    throw new Error(`[FecWorker] configure: decoder runs ${JSON.stringify(decoderAlgorithm)}, not the configured "${algorithm}"`);
+  }
   wasmDecoder = decoder;
   config = cmd.config;
-  altaEnabled = !!cmd.altaPublicKey;
-  pendingVerifyCap = Math.ceil(config.interleaveDepth * 1.5);
-  pendingVerifyTtlMs = Math.ceil(config.interleaveMs * config.k * 1.5);
-  altaVerifier = null;
-  altaInitFailed = false;
-  if (cmd.altaPublicKey && cmd.altaWasmModule) {
-    try {
-      const altaGlueUrl = "/wasm/alta/alta_rs.js";
-      const altaGlue = await import(
-        /* webpackIgnore: true */
-        altaGlueUrl
-      );
-      altaGlue.initSync({ module: cmd.altaWasmModule });
-      const keyBytes = new Uint8Array(cmd.altaPublicKey);
-      altaVerifier = new altaGlue.JsAltaVerifier(keyBytes);
-    } catch (e) {
-      console.warn("[FecWorker] ALTA WASM init failed, verification disabled:", e);
-      altaVerifier = null;
-      altaEnabled = false;
-      altaInitFailed = true;
-    }
-  }
   wasmDecoder.configure_params(config.k, config.symbolSize);
   emit({ type: "capabilities", commands: ["feedSymbols", "subscribeBlockUpdates"] });
   startSnapshotTimer();
@@ -589,40 +522,7 @@ function handleFeedSource(cmd) {
   if (!isUint32(cmd.ssId) || !(cmd.data instanceof ArrayBuffer)) {
     throw new Error("[FecWorker] feedSource: invalid source symbol");
   }
-  const view = new Uint8Array(cmd.data);
-  if (config.blockProfile === "iso-ssbg1-v1") {
-    feedIsoSource(cmd, view, wasmDecoder, config);
-    return;
-  }
-  const sbn = config.k > 0 ? Math.floor(cmd.ssId / config.k) : cmd.ssId;
-  const esi = cmd.ssId % config.k;
-  if (isRetiredSbn(sbn)) {
-    sourceDroppedRetired++;
-    return;
-  }
-  const existingBlock = blocks.get(sbn);
-  if (existingBlock && isTerminalBlock(existingBlock)) {
-    sourceDroppedTerminal++;
-    return;
-  }
-  if (acceptedSourceEsis.get(sbn)?.has(esi)) {
-    sourceDroppedDuplicate++;
-    return;
-  }
-  const result = wasmDecoder.add_source(cmd.ssId, view, cmd.ts);
-  advanceMediaHorizon(sbn);
-  let sourceEsis = acceptedSourceEsis.get(sbn);
-  if (!sourceEsis) {
-    sourceEsis = /* @__PURE__ */ new Set();
-    acceptedSourceEsis.set(sbn, sourceEsis);
-  }
-  sourceEsis.add(esi);
-  const block = getOrCreateBlock(sbn);
-  block.sourceReceived++;
-  block.lastSymbolTs = performance.now();
-  sourceSymbols++;
-  if (altaEnabled) altaPending++;
-  settleSourceArrival(sbn, block, result);
+  feedIsoSource(cmd, new Uint8Array(cmd.data), wasmDecoder, config);
 }
 function handleFeedRepair(cmd) {
   if (!wasmDecoder) {
@@ -631,8 +531,7 @@ function handleFeedRepair(cmd) {
   if (!config) {
     throw new Error("[FecWorker] feedRepair: config missing");
   }
-  const iso = config.blockProfile === "iso-ssbg1-v1";
-  if (!isUint32(cmd.ssStart) || !isUint32(cmd.ssbLength) || cmd.ssbLength <= 0 || cmd.ssbLength > config.k || !iso && cmd.ssStart % config.k !== 0 || !isUint32(cmd.rsId) || (iso ? cmd.ssbLength : config.k) + cmd.rsId > UINT24_MAX || !(cmd.data instanceof ArrayBuffer)) {
+  if (!isUint32(cmd.ssStart) || !isUint32(cmd.ssbLength) || cmd.ssbLength <= 0 || cmd.ssbLength > config.k || !isUint32(cmd.rsId) || cmd.ssbLength + cmd.rsId > UINT24_MAX || !(cmd.data instanceof ArrayBuffer)) {
     throw new Error("[FecWorker] feedRepair: invalid repair symbol");
   }
   const view = new Uint8Array(cmd.data);
@@ -647,44 +546,7 @@ function handleFeedRepair(cmd) {
     }
     return;
   }
-  if (iso) {
-    feedIsoRepair(cmd, view, wasmDecoder);
-    return;
-  }
-  const sbn = Math.floor(cmd.ssStart / config.k);
-  const repairEsi = config.k + cmd.rsId;
-  if (isRetiredSbn(sbn)) return;
-  const existingBlock = blocks.get(sbn);
-  if (existingBlock && isTerminalBlock(existingBlock)) return;
-  if (acceptedRepairEsis.get(sbn)?.has(repairEsi)) return;
-  if (existingBlock?.ssbLength !== void 0 && existingBlock.ssbLength !== cmd.ssbLength) {
-    emit({
-      type: "error",
-      code: "repair-ssb-length-conflict",
-      message: `[FecWorker] Dropping repair symbol whose SSB_length ${cmd.ssbLength} conflicts with ${existingBlock.ssbLength} (sbn=${sbn})`
-    });
-    return;
-  }
-  const result = wasmDecoder.add_repair(
-    cmd.ssStart,
-    cmd.ssbLength,
-    cmd.rsId,
-    view,
-    cmd.ts
-  );
-  advanceMediaHorizon(sbn);
-  let repairEsis = acceptedRepairEsis.get(sbn);
-  if (!repairEsis) {
-    repairEsis = /* @__PURE__ */ new Set();
-    acceptedRepairEsis.set(sbn, repairEsis);
-  }
-  repairEsis.add(repairEsi);
-  const block = getOrCreateBlock(sbn);
-  block.ssbLength = cmd.ssbLength;
-  block.repairReceived++;
-  block.lastSymbolTs = performance.now();
-  repairSymbols++;
-  settleRepairArrival(sbn, block, cmd.ssbLength, result);
+  feedIsoRepair(cmd, view, wasmDecoder);
 }
 function handleRelayBlockSig(cmd) {
   const block = blocks.get(cmd.sbn);
@@ -713,7 +575,7 @@ function handleCleanup(cmd) {
         continue;
       }
       currentBlock ??= getOrCreateBlock(sbn);
-      const authoredLength = isIsoProfile() ? currentBlock.ssbLength : currentBlock.k;
+      const authoredLength = currentBlock.ssbLength;
       if (authoredLength !== void 0 && currentBlock.sourceReceived >= authoredLength) {
         markBlockTerminal(currentBlock, "complete");
         blocksComplete++;
@@ -732,20 +594,10 @@ function handleDispose() {
     clearInterval(snapshotTimer);
     snapshotTimer = null;
   }
-  if (altaVerifier) {
-    try {
-      altaVerifier.free();
-    } catch (_e) {
-    }
-    altaVerifier = null;
-  }
   if (wasmDecoder) {
     wasmDecoder.free();
     wasmDecoder = null;
   }
-  pendingVerify.clear();
-  pendingVerifyCap = 0;
-  pendingVerifyTtlMs = 0;
   config = null;
   clearBlockTracking();
 }
@@ -767,13 +619,6 @@ function handleReset() {
   blocksComplete = 0;
   blocksRecovered = 0;
   blocksFailed = 0;
-  altaVerified = 0;
-  altaFailed = 0;
-  altaFailedDetails.length = 0;
-  altaPending = 0;
-  altaPendingEvictedCap = 0;
-  altaPendingEvictedTtl = 0;
-  altaError = 0;
   relayBlocksVerified = 0;
   relayBlocksFailed = 0;
   repairSymbolSizeMismatch = 0;