@blockcast/mmt-container 2.1.0 → 2.2.0-main.0f6aad7bb803

package/dist/mmtp-container-parser.no-modules.js

@@ -73,6 +73,8 @@ var BlockcastMmt = (() => {
   var PACKET_TYPE_REPAIR = 3;
   var MMTP_SIGNALING_PACKET_ID = 0;
   var MMTP_PACKET_ID_MAX = 65535;
+  var FEC_CODE_REED_SOLOMON = 1;
+  var FEC_CODE_RAPTORQ = 3;
   function parseMMTPHeader(buffer) {
     if (buffer.length < MMTP_HEADER_SIZE) {
       throw new Error(`MMTP packet too small: ${buffer.length} bytes`);
@@ -213,30 +215,26 @@ var BlockcastMmt = (() => {
     const authLength = view2.getUint16(2, false);
     return start + LEGACY_TRAILER_HEADER_SIZE + authLength === end;
   }
-  function resolveDeclaredTrailers(payload, declaredEnd, fecType, options, rapFlag = false) {
+  function resolveDeclaredTrailers(payload, declaredEnd, fecType, options) {
     if (declaredEnd > payload.length)
       return null;
     if (options?.skipFecId) {
-      return isEmptyOrExactLegacyTrailer(payload, declaredEnd, payload.length) ? { hasFecId: false, hasOverlayFecId: false } : null;
+      return isEmptyOrExactLegacyTrailer(payload, declaredEnd, payload.length) ? { hasFecId: false } : null;
     }
-    const overlay = options?.overlayDeclared === true && rapFlag;
     if (fecType === 1) {
-      const fecStart = payload.length - sourceFecTrailerSize(overlay);
+      const fecStart = payload.length - SOURCE_FEC_PAYLOAD_ID_SIZE;
       if (fecStart < declaredEnd || !isEmptyOrExactLegacyTrailer(payload, declaredEnd, fecStart)) {
         return null;
       }
-      return { hasFecId: true, hasOverlayFecId: overlay };
+      return { hasFecId: true };
     }
-    if (fecType !== 0 || overlay)
+    if (fecType !== 0)
       return null;
     if (isEmptyOrExactLegacyTrailer(payload, declaredEnd, payload.length)) {
-      return { hasFecId: false, hasOverlayFecId: false };
+      return { hasFecId: false };
     }
     return null;
   }
-  function sourceFecTrailerSize(overlay) {
-    return overlay ? 2 * SOURCE_FEC_PAYLOAD_ID_SIZE : SOURCE_FEC_PAYLOAD_ID_SIZE;
-  }
   function planMfuExtraction(mmtpPacket, options, parsedHeader) {
     if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE) {
       return {
@@ -289,11 +287,11 @@ var BlockcastMmt = (() => {
     if ("rejection" in layoutResult)
       return layoutResult;
     const { layout } = layoutResult;
-    const trailerLayout = resolveDeclaredTrailers(payload, layout.dataEnd, header.fecType, options, header.rapFlag);
+    const trailerLayout = resolveDeclaredTrailers(payload, layout.dataEnd, header.fecType, options);
     if (!trailerLayout) {
       if (!options?.skipFecId && header.fecType === 1) {
         const observed = payload.length - layout.dataEnd;
-        const expected = sourceFecTrailerSize(options?.overlayDeclared === true && header.rapFlag);
+        const expected = SOURCE_FEC_PAYLOAD_ID_SIZE;
         if (observed !== expected) {
           return {
             rejection: {
@@ -325,13 +323,10 @@ var BlockcastMmt = (() => {
     const mfuDuHeader = mfuDuHeaderPresent && mpu.timedFlag === 1 ? parseTimedMfuDuHeader(payload, MPU_HEADER_SIZE) : null;
     const itemId = mfuDuHeaderPresent && mpu.timedFlag === 0 ? new DataView(payload.buffer, payload.byteOffset + MPU_HEADER_SIZE, 4).getUint32(0, false) : null;
     const data = payload.subarray(mfuOffset, dataEnd);
-    const trailerStart = mmtpPacket.length - sourceFecTrailerSize(trailerLayout.hasOverlayFecId);
-    const ssIdAt = (offset) => ({
-      ssId: new DataView(mmtpPacket.buffer, mmtpPacket.byteOffset + offset, 4).getUint32(0, false)
-    });
-    const fecPayloadId = trailerLayout.hasFecId ? ssIdAt(trailerStart) : null;
-    const overlayFecPayloadId = trailerLayout.hasOverlayFecId ? ssIdAt(trailerStart + SOURCE_FEC_PAYLOAD_ID_SIZE) : null;
-    return { header, mpu, fragmentType, data, mfuDuHeader, itemId, fecPayloadId, overlayFecPayloadId };
+    const fecPayloadId = trailerLayout.hasFecId ? {
+      ssId: new DataView(mmtpPacket.buffer, mmtpPacket.byteOffset + mmtpPacket.length - SOURCE_FEC_PAYLOAD_ID_SIZE, 4).getUint32(0, false)
+    } : null;
+    return { header, mpu, fragmentType, data, mfuDuHeader, itemId, fecPayloadId };
   }
   function sourceFecPayloadIdOf(mmtpPacket, header) {
     if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE)
@@ -423,6 +418,50 @@ var BlockcastMmt = (() => {
   var NTP_SHORT_MODULUS = 2 ** NTP_SHORT_BITS;
   var NTP_SHORT_HALF_RANGE = 2 ** (NTP_SHORT_BITS - 1);
 
+  // ../mmt-base/dist/signalling.js
+  var FEC_CODING_STRUCTURE_ONE_STAGE = 1;
+  var SSBG_MODE_1 = 1;
+  var RAPTORQ_MAX_SOURCE_SYMBOLS = 56403;
+  var REPAIR_SYMBOL_ID_MAX = 16777215;
+  var MIN_REPAIR_SYMBOL_SIZE = 14;
+  var REED_SOLOMON_MAX_BLOCK = 255;
+  function alFecRaptorQFlowConfig(flow) {
+    if (flow.fecCodingStructure !== FEC_CODING_STRUCTURE_ONE_STAGE || flow.repairFlows.length !== 1)
+      return null;
+    if (flow.ssbgMode !== SSBG_MODE_1 || flow.ffsrptsFlag !== 0 || flow.fecPayloadIdMode !== 0)
+      return null;
+    if (flow.packetIds.length !== 1)
+      return null;
+    const repair = flow.repairFlows[0];
+    const { fecCodeId, maximumK: k, maximumP: p } = repair;
+    const t = flow.repairSymbolSize;
+    if (t < MIN_REPAIR_SYMBOL_SIZE || k < 1 || p < 1 || k + p - 1 > REPAIR_SYMBOL_ID_MAX)
+      return null;
+    if (fecCodeId === FEC_CODE_RAPTORQ) {
+      if (t % 8 !== 0 || k > RAPTORQ_MAX_SOURCE_SYMBOLS)
+        return null;
+    } else if (fecCodeId === FEC_CODE_REED_SOLOMON) {
+      if (k + p > REED_SOLOMON_MAX_BLOCK)
+        return null;
+    } else {
+      return null;
+    }
+    if (repair.repairFlowId === MMTP_SIGNALING_PACKET_ID || repair.repairFlowId === flow.packetIds[0])
+      return null;
+    return {
+      sourcePacketIds: [...flow.packetIds],
+      repairFlowId: repair.repairFlowId,
+      fecCodeId,
+      ssbgMode: flow.ssbgMode,
+      fecPayloadIdMode: flow.fecPayloadIdMode,
+      repairSymbolSize: t,
+      maximumK: k,
+      maximumP: p,
+      protectionWindowTime: repair.protectionWindowTime,
+      protectionWindowSize: repair.protectionWindowSize
+    };
+  }
+
   // ../mmt-base/dist/serial-number.js
   var SERIAL32_SPAN = 4294967296;
   var SERIAL32_HALF = 2147483648;
@@ -8217,7 +8256,7 @@ var BlockcastMmt = (() => {
   // src/mmtp-fec-session.ts
   var PATH_BITS = { moq: 1, multicast: 2 };
   var MIXED_PATHS = PATH_BITS.moq | PATH_BITS.multicast;
-  var _decoder, _blocks, _settled, _have, _newest, _prunedAt, _repairPacketId, _newestSource, _heldLayers, _anchorHorizon, _stats3, _MmtpFecSession_instances, drop_fn2, noteNewest_fn, blockStartOf_fn, countHeld_fn, noteMixed_fn, behindHorizon_fn, settle_fn, settleClean_fn, settleDecoded_fn, retireBehindHorizon_fn;
+  var _decoder, _repairSymbols, _message, _blocks, _settled, _have, _newest, _prunedAt, _repairPacketId, _newestSource, _heldLayers, _anchorHorizon, _stats3, _MmtpFecSession_instances, trackFor_fn, drop_fn2, noteNewest_fn, blockStartOf_fn, countHeld_fn, noteMixed_fn, behindHorizon_fn, settle_fn, settleClean_fn, settleDecoded_fn, retireBehindHorizon_fn;
   var MmtpFecSession = class {
     /**
      * @throws when the instance lacks or misstates a field the session needs:
@@ -8227,6 +8266,9 @@ var BlockcastMmt = (() => {
     constructor(config) {
       __privateAdd(this, _MmtpFecSession_instances);
       __privateAdd(this, _decoder);
+      __privateAdd(this, _repairSymbols);
+      /** The message entry a catalog-less session was built from; undefined under a catalog. */
+      __privateAdd(this, _message);
       /** Blocks a repair has defined and that are not settled yet, by SS_Start. */
       __privateAdd(this, _blocks, /* @__PURE__ */ new Map());
       /** SS_Starts of settled blocks, so a later repair for one is refused. */
@@ -8258,6 +8300,24 @@ var BlockcastMmt = (() => {
         mixedPath: { clean: 0, recovered: 0, failed: 0, released: 0 },
         failClosed: null
       });
+      if (config && "alFecFlow" in config) {
+        const message = alFecRaptorQFlowConfig(config.alFecFlow);
+        if (!message) {
+          throw new Error("MmtpFecSession: the AL-FEC entry is outside draft-ramadan-moq-mmt-02 8.3 (iso-ssbg1-v1)");
+        }
+        __privateSet(this, _message, message);
+        this.blockProfile = parseFecBlockProfile("iso-ssbg1-v1", "alFecFlow");
+        this.algorithm = message.fecCodeId === FEC_CODE_RAPTORQ ? "raptorq" : "reed-solomon";
+        this.sourceSymbols = message.maximumK;
+        __privateSet(this, _repairSymbols, message.maximumP);
+        this.symbolSize = message.repairSymbolSize;
+        this.retentionBlocks = requirePositiveInteger(config.retentionBlocks, "retentionBlocks");
+        __privateSet(this, _repairPacketId, message.repairFlowId);
+        __privateSet(this, _heldLayers, layerZero(message.maximumP));
+        __privateSet(this, _anchorHorizon, heldLayerAnchorHorizon(this.retentionBlocks, this.sourceSymbols));
+        __privateSet(this, _decoder, buildDecoder(config.Decoder, this));
+        return;
+      }
       const fec = config?.fec;
       if (!fec || typeof fec !== "object") {
         throw new Error("MmtpFecSession: the catalog fec instance is required");
@@ -8268,7 +8328,7 @@ var BlockcastMmt = (() => {
       }
       this.algorithm = fec.scheme;
       this.sourceSymbols = requirePositiveInteger(fec.sourceSymbols, "fec.sourceSymbols");
-      this.repairSymbols = requirePositiveInteger(fec.repairSymbols, "fec.repairSymbols");
+      __privateSet(this, _repairSymbols, requirePositiveInteger(fec.repairSymbols, "fec.repairSymbols"));
       this.symbolSize = requirePositiveInteger(fec.symbolSize, "fec.symbolSize");
       const interleaveDepthMs = requireNumber(fec.interleaveDepthMs, "fec.interleaveDepthMs");
       const reorderToleranceMs = requireNumber(fec.reorderToleranceMs, "fec.reorderToleranceMs");
@@ -8288,17 +8348,34 @@ var BlockcastMmt = (() => {
         config.heldLayers
       ));
       __privateSet(this, _anchorHorizon, heldLayerAnchorHorizon(this.retentionBlocks, this.sourceSymbols));
-      if (typeof config.Decoder !== "function") {
-        throw new Error("MmtpFecSession: a decoder constructor (wasm_bindgen.MmtFecDecoder) is required");
-      }
-      const decoder = new config.Decoder(this.retentionBlocks, this.blockProfile, this.algorithm);
-      try {
-        decoder.configure_params(this.sourceSymbols, this.symbolSize);
-      } catch (error) {
-        decoder.free();
-        throw error;
-      }
-      __privateSet(this, _decoder, decoder);
+      __privateSet(this, _decoder, buildDecoder(config.Decoder, this));
+    }
+    /** P_0 = B_0, the held total every repair packet is checked against. */
+    get repairSymbols() {
+      return __privateGet(this, _repairSymbols);
+    }
+    /**
+     * A later version of the AL-FEC message, catalog-less sessions only. A
+     * maximum_p_for_repair_flow above the held total raises it (`raised`): the
+     * anchored check restarts at the new total, so a block generated under the
+     * previous one stays valid before the first block carrying the new total
+     * (fec-core-00 7.3.2, mmt-02 8.3). A field at or below it changes nothing
+     * (`unchanged`): no publisher lowers it, and the check catches a wire that
+     * does. An entry with another asset, repair flow, code point, K or T, or
+     * one outside 8.3, is `refused`: that is a new source encoding, which needs
+     * a new session. A latched fail-closed stays latched either way.
+     */
+    updateAlFecFlow(flow) {
+      const held = __privateGet(this, _message);
+      if (!held) throw new Error("MmtpFecSession: updateAlFecFlow() needs a session built from an AL-FEC entry");
+      const next = alFecRaptorQFlowConfig(flow);
+      if (!next || next.sourcePacketIds[0] !== held.sourcePacketIds[0] || next.repairFlowId !== held.repairFlowId || next.fecCodeId !== held.fecCodeId || next.maximumK !== held.maximumK || next.repairSymbolSize !== held.repairSymbolSize) {
+        return "refused";
+      }
+      if (next.maximumP <= __privateGet(this, _repairSymbols)) return "unchanged";
+      __privateSet(this, _repairSymbols, next.maximumP);
+      __privateSet(this, _heldLayers, layerZero(next.maximumP));
+      return "raised";
     }
     /** True once release() ran. */
     get released() {
@@ -8393,7 +8470,7 @@ var BlockcastMmt = (() => {
       }
       if (admission.reject) {
         const verdict2 = __privateGet(this, _heldLayers).failsClosed(
-          repairTrackName,
+          __privateMethod(this, _MmtpFecSession_instances, trackFor_fn).call(this, repairTrackName),
           frame.ssStart,
           frame.rsbLength,
           __privateGet(this, _anchorHorizon),
@@ -8408,7 +8485,7 @@ var BlockcastMmt = (() => {
       __privateGet(this, _repairPacketId) ?? __privateSet(this, _repairPacketId, frame.packetId);
       if (frame.ssbLength > this.sourceSymbols) return __privateMethod(this, _MmtpFecSession_instances, drop_fn2).call(this, "repair:ssb-length");
       const verdict = __privateGet(this, _heldLayers).admit(
-        repairTrackName,
+        __privateMethod(this, _MmtpFecSession_instances, trackFor_fn).call(this, repairTrackName),
         frame.ssStart,
         frame.rsbLength,
         __privateGet(this, _anchorHorizon),
@@ -8469,6 +8546,8 @@ var BlockcastMmt = (() => {
     }
   };
   _decoder = new WeakMap();
+  _repairSymbols = new WeakMap();
+  _message = new WeakMap();
   _blocks = new WeakMap();
   _settled = new WeakMap();
   _have = new WeakMap();
@@ -8480,6 +8559,10 @@ var BlockcastMmt = (() => {
   _anchorHorizon = new WeakMap();
   _stats3 = new WeakMap();
   _MmtpFecSession_instances = new WeakSet();
+  /** Catalog-less: layer 0 has no own-track clause (mmt-02 8.3), so no track name is judged. */
+  trackFor_fn = function(repairTrackName) {
+    return __privateGet(this, _message) ? void 0 : repairTrackName;
+  };
   drop_fn2 = function(reason) {
     __privateGet(this, _stats3).dropped[reason] = (__privateGet(this, _stats3).dropped[reason] ?? 0) + 1;
     return [];
@@ -8600,6 +8683,22 @@ var BlockcastMmt = (() => {
       if (__privateMethod(this, _MmtpFecSession_instances, behindHorizon_fn).call(this, start)) __privateGet(this, _settled).delete(start);
     }
   };
+  function layerZero(total) {
+    return new HeldLayerAdmission([{ layer: 0, repairTrackName: "", rsIdOffset: 0, repairSymbols: total }]);
+  }
+  function buildDecoder(Decoder, session) {
+    if (typeof Decoder !== "function") {
+      throw new Error("MmtpFecSession: a decoder constructor (wasm_bindgen.MmtFecDecoder) is required");
+    }
+    const decoder = new Decoder(session.retentionBlocks, session.blockProfile, session.algorithm);
+    try {
+      decoder.configure_params(session.sourceSymbols, session.symbolSize);
+    } catch (error) {
+      decoder.free();
+      throw error;
+    }
+    return decoder;
+  }
   function requirePositiveInteger(value, path) {
     if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
       throw new Error(`MmtpFecSession: ${path} must be a positive integer (got ${String(value)})`);