@blockcast/fec-worker 0.3.0-main.d9354616fdf2 → 0.3.0-main.e4bf1a9cc227

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;
 }
@@ -113,10 +99,7 @@ function clearBlockTracking() {
 }
 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 +111,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 +122,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 +135,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 +146,7 @@ function synchronizeDecoderHorizon() {
     blocksFailed++;
     emitBlockUpdate(block);
   }
-  if (iso) retireUnplacedSources();
+  retireUnplacedSources();
   trimBlockRetention();
 }
 function retireUnplacedSources() {
@@ -192,6 +171,8 @@ 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
@@ -217,7 +198,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,
@@ -248,7 +229,7 @@ function buildStatsSnapshot() {
     sourceDroppedRetired,
     sourceDroppedTerminal,
     sourceDroppedDuplicate,
-    ...config.blockProfile === "iso-ssbg1-v1" ? { sourceUnplacedRetired } : {},
+    sourceUnplacedRetired,
     decoder
   };
 }
@@ -280,19 +261,16 @@ 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++;
@@ -510,12 +488,12 @@ 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)})`
     );
   }
   if (!Number.isFinite(cmd.config.interleaveDepth) || !Number.isInteger(cmd.config.interleaveDepth) || cmd.config.interleaveDepth <= 0 || cmd.config.interleaveDepth > MAX_INTERLEAVE_DEPTH) {
@@ -523,9 +501,9 @@ async function handleConfigure(cmd) {
       `[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) {
@@ -554,7 +532,8 @@ async function handleConfigure(cmd) {
   config = cmd.config;
   altaEnabled = !!cmd.altaPublicKey;
   pendingVerifyCap = Math.ceil(config.interleaveDepth * 1.5);
-  pendingVerifyTtlMs = Math.ceil(config.interleaveMs * config.k * 1.5);
+  const verifyWindowMs = config.interleaveMs > 0 ? config.interleaveMs * config.k : config.deliveryWindowMs;
+  pendingVerifyTtlMs = Math.ceil(verifyWindowMs * 1.5);
   altaVerifier = null;
   altaInitFailed = false;
   if (cmd.altaPublicKey && cmd.altaWasmModule) {
@@ -589,40 +568,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 +577,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 +592,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 +621,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++;