@blockcast/mmt-container 0.3.0 → 0.4.0-main.1cd3cdea89da

package/dist/mmtp-decode-pipeline.js

@@ -1,76 +1,15 @@
-// ../mmt-alta-parse/dist/index.js
+// ../mmt-base/dist/mmtp.js
 var MMTP_HEADER_SIZE = 12;
 var MPU_HEADER_SIZE = 8;
-var MPU_LENGTH_FIELD_SIZE = 2;
-var MPU_HEADER_REMAINDER_SIZE = MPU_HEADER_SIZE - MPU_LENGTH_FIELD_SIZE;
-var TIMED_MFU_DU_HEADER_SIZE = 14;
-var NONTIMED_MFU_DU_HEADER_SIZE = 4;
-var PACKET_TYPE_MPU = 0;
-var MMTP_EXT_TYPE_ALTA_AUTH = 61601;
-var MMTP_EXT_TRAILER_HEADER_SIZE = 4;
-function extractAltaTrailer(mmtpPacket, options) {
-  if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE)
-    return null;
-  const packetType = mmtpPacket[1] & 63;
-  if (packetType !== PACKET_TYPE_MPU)
-    return null;
-  const fecType = mmtpPacket[0] >> 3 & 3;
-  let headerLength = MMTP_HEADER_SIZE;
-  if (fecType < 2 && (mmtpPacket[0] & 32) !== 0)
-    headerLength += 4;
-  if (fecType < 2 && (mmtpPacket[0] & 2) !== 0) {
-    if (headerLength + 4 > mmtpPacket.length)
-      return null;
-    const extensionLength = new DataView(mmtpPacket.buffer, mmtpPacket.byteOffset + headerLength + 2, 2).getUint16(0, false);
-    headerLength += 4 + extensionLength;
-  }
-  if (headerLength + MPU_HEADER_SIZE > mmtpPacket.length)
-    return null;
-  const payload = mmtpPacket.subarray(headerLength);
-  const payloadLength = payload[0] << 8 | payload[1];
-  const flagsByte = payload[2];
-  const fragmentType = flagsByte >> 4 & 15;
-  const timed = (flagsByte >> 3 & 1) === 1;
-  const fragmentationIndicator = flagsByte >> 1 & 3;
-  if (fragmentType !== 2)
-    return null;
-  const dataUnitHeaderSize = fragmentationIndicator <= 1 ? timed ? TIMED_MFU_DU_HEADER_SIZE : NONTIMED_MFU_DU_HEADER_SIZE : 0;
-  if (payloadLength <= MPU_HEADER_REMAINDER_SIZE + dataUnitHeaderSize)
-    return null;
-  if (fecType > 1)
-    return null;
-  const hasFecId = !options?.skipFecId && fecType === 1;
-  const payloadEnd = hasFecId ? payload.length - 4 : payload.length;
-  const declaredEnd = MPU_LENGTH_FIELD_SIZE + payloadLength;
-  if (declaredEnd > payloadEnd)
-    return null;
-  if (declaredEnd + MMTP_EXT_TRAILER_HEADER_SIZE > payloadEnd)
-    return null;
-  const extType = payload[declaredEnd] << 8 | payload[declaredEnd + 1];
-  if (extType !== MMTP_EXT_TYPE_ALTA_AUTH)
-    return null;
-  const extLen = payload[declaredEnd + 2] << 8 | payload[declaredEnd + 3];
-  const authStart = declaredEnd + MMTP_EXT_TRAILER_HEADER_SIZE;
-  if (authStart + extLen !== payloadEnd)
-    return null;
-  return {
-    auth: payload.subarray(authStart, payloadEnd),
-    signedEnd: headerLength + declaredEnd
-  };
-}
-
-// ../mmt-base/dist/mmtp.js
-var MMTP_HEADER_SIZE2 = 12;
-var MPU_HEADER_SIZE2 = 8;
 var MFU_DU_HEADER_SIZE_TIMED = 14;
 var MFU_DU_HEADER_SIZE_NONTIMED = 4;
-var MPU_LENGTH_FIELD_SIZE2 = 2;
-var MPU_HEADER_REMAINDER_SIZE2 = MPU_HEADER_SIZE2 - MPU_LENGTH_FIELD_SIZE2;
+var MPU_LENGTH_FIELD_SIZE = 2;
+var MPU_HEADER_REMAINDER_SIZE = MPU_HEADER_SIZE - MPU_LENGTH_FIELD_SIZE;
 var SOURCE_FEC_PAYLOAD_ID_SIZE = 4;
-var PACKET_TYPE_MPU2 = 0;
+var PACKET_TYPE_MPU = 0;
 var PACKET_TYPE_REPAIR = 3;
 function parseMMTPHeader(buffer) {
-  if (buffer.length < MMTP_HEADER_SIZE2) {
+  if (buffer.length < MMTP_HEADER_SIZE) {
     throw new Error(`MMTP packet too small: ${buffer.length} bytes`);
   }
   const view2 = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
@@ -126,7 +65,7 @@ function parseMMTPHeader(buffer) {
   };
 }
 function parseMPUHeader(payload) {
-  if (payload.length < MPU_HEADER_SIZE2) {
+  if (payload.length < MPU_HEADER_SIZE) {
     throw new Error(`Payload too small for MPU header: ${payload.length} bytes`);
   }
   const view2 = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);
@@ -159,15 +98,15 @@ function parseTimedMfuDuHeader(payload, offset) {
   };
 }
 function resolveMfuPayloadLayout(mpu, fragmentType, payload) {
-  if (mpu.payloadLength < MPU_HEADER_REMAINDER_SIZE2) {
+  if (mpu.payloadLength < MPU_HEADER_REMAINDER_SIZE) {
     return {
       rejection: {
         gate: "mpu-payload-length-below-header-remainder",
-        detail: `payload_length=${mpu.payloadLength} < ${MPU_HEADER_REMAINDER_SIZE2}`
+        detail: `payload_length=${mpu.payloadLength} < ${MPU_HEADER_REMAINDER_SIZE}`
       }
     };
   }
-  const declaredEnd = MPU_LENGTH_FIELD_SIZE2 + mpu.payloadLength;
+  const declaredEnd = MPU_LENGTH_FIELD_SIZE + mpu.payloadLength;
   if (declaredEnd > payload.length) {
     return {
       rejection: {
@@ -178,7 +117,7 @@ function resolveMfuPayloadLayout(mpu, fragmentType, payload) {
   }
   const hasHeader = fragmentType === 2 && mpu.fragmentationIndicator <= 1;
   const mfuHeaderSize = mpu.timedFlag ? MFU_DU_HEADER_SIZE_TIMED : MFU_DU_HEADER_SIZE_NONTIMED;
-  const mfuOffset = MPU_HEADER_SIZE2 + (hasHeader ? mfuHeaderSize : 0);
+  const mfuOffset = MPU_HEADER_SIZE + (hasHeader ? mfuHeaderSize : 0);
   if (mfuOffset >= declaredEnd) {
     return {
       rejection: {
@@ -195,44 +134,46 @@ function resolveMfuPayloadLayout(mpu, fragmentType, payload) {
     }
   };
 }
-function isEmptyOrExactAltaTrailer(payload, start, end) {
+var LEGACY_TRAILER_EXT_TYPE = 61601;
+var LEGACY_TRAILER_HEADER_SIZE = 4;
+function isEmptyOrExactLegacyTrailer(payload, start, end) {
   if (start === end)
     return true;
-  if (start < 0 || end > payload.length || start + MMTP_EXT_TRAILER_HEADER_SIZE > end) {
+  if (start < 0 || end > payload.length || start + LEGACY_TRAILER_HEADER_SIZE > end) {
     return false;
   }
   const view2 = new DataView(payload.buffer, payload.byteOffset + start, end - start);
-  if (view2.getUint16(0, false) !== MMTP_EXT_TYPE_ALTA_AUTH)
+  if (view2.getUint16(0, false) !== LEGACY_TRAILER_EXT_TYPE)
     return false;
   const authLength = view2.getUint16(2, false);
-  return start + MMTP_EXT_TRAILER_HEADER_SIZE + authLength === end;
+  return start + LEGACY_TRAILER_HEADER_SIZE + authLength === end;
 }
 function resolveDeclaredTrailers(payload, declaredEnd, fecType, options) {
   if (declaredEnd > payload.length)
     return null;
   if (options?.skipFecId) {
-    return isEmptyOrExactAltaTrailer(payload, declaredEnd, payload.length) ? { hasFecId: false } : null;
+    return isEmptyOrExactLegacyTrailer(payload, declaredEnd, payload.length) ? { hasFecId: false } : null;
   }
   if (fecType === 1) {
     const fecStart = payload.length - SOURCE_FEC_PAYLOAD_ID_SIZE;
-    if (fecStart < declaredEnd || !isEmptyOrExactAltaTrailer(payload, declaredEnd, fecStart)) {
+    if (fecStart < declaredEnd || !isEmptyOrExactLegacyTrailer(payload, declaredEnd, fecStart)) {
       return null;
     }
     return { hasFecId: true };
   }
   if (fecType !== 0)
     return null;
-  if (isEmptyOrExactAltaTrailer(payload, declaredEnd, payload.length)) {
+  if (isEmptyOrExactLegacyTrailer(payload, declaredEnd, payload.length)) {
     return { hasFecId: false };
   }
   return null;
 }
 function planMfuExtraction(mmtpPacket, options, parsedHeader) {
-  if (mmtpPacket.length < MMTP_HEADER_SIZE2 + MPU_HEADER_SIZE2) {
+  if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE) {
     return {
       rejection: {
         gate: "packet-shorter-than-mmtp-plus-mpu-header",
-        detail: `${mmtpPacket.length} bytes < ${MMTP_HEADER_SIZE2 + MPU_HEADER_SIZE2}`
+        detail: `${mmtpPacket.length} bytes < ${MMTP_HEADER_SIZE + MPU_HEADER_SIZE}`
       }
     };
   }
@@ -251,7 +192,7 @@ function planMfuExtraction(mmtpPacket, options, parsedHeader) {
       };
     }
   }
-  if (header.packetType !== PACKET_TYPE_MPU2) {
+  if (header.packetType !== PACKET_TYPE_MPU) {
     return {
       rejection: {
         gate: "not-an-mpu-packet",
@@ -260,11 +201,11 @@ function planMfuExtraction(mmtpPacket, options, parsedHeader) {
     };
   }
   const payload = mmtpPacket.subarray(header.headerLength);
-  if (payload.length < MPU_HEADER_SIZE2) {
+  if (payload.length < MPU_HEADER_SIZE) {
     return {
       rejection: {
         gate: "payload-shorter-than-mpu-header",
-        detail: `${payload.length} bytes < ${MPU_HEADER_SIZE2}`
+        detail: `${payload.length} bytes < ${MPU_HEADER_SIZE}`
       }
     };
   }
@@ -295,7 +236,7 @@ function planMfuExtraction(mmtpPacket, options, parsedHeader) {
     return {
       rejection: {
         gate: "declared-trailers-unresolved",
-        detail: `trailer bytes [${layout.dataEnd}, ${payload.length}) are neither empty nor an exact ALTA trailer (fecType=${header.fecType})`
+        detail: `trailer bytes [${layout.dataEnd}, ${payload.length}) are neither empty nor an exact legacy authenticator trailer (fecType=${header.fecType})`
       }
     };
   }
@@ -311,8 +252,8 @@ function extractPlannedMfu(mmtpPacket, result) {
   const mfuDuHeaderPresent = layout.hasMfuDuHeader;
   const mfuOffset = layout.mfuOffset;
   const dataEnd = layout.dataEnd;
-  const mfuDuHeader = mfuDuHeaderPresent && mpu.timedFlag === 1 ? parseTimedMfuDuHeader(payload, MPU_HEADER_SIZE2) : null;
-  const itemId = mfuDuHeaderPresent && mpu.timedFlag === 0 ? new DataView(payload.buffer, payload.byteOffset + MPU_HEADER_SIZE2, 4).getUint32(0, false) : null;
+  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 fecPayloadId = trailerLayout.hasFecId ? {
     ssId: new DataView(mmtpPacket.buffer, mmtpPacket.byteOffset + mmtpPacket.length - SOURCE_FEC_PAYLOAD_ID_SIZE, SOURCE_FEC_PAYLOAD_ID_SIZE).getUint32(0, false)
@@ -320,17 +261,17 @@ function extractPlannedMfu(mmtpPacket, result) {
   return { header, mpu, fragmentType, data, mfuDuHeader, itemId, fecPayloadId };
 }
 function sourceFecPayloadIdOf(mmtpPacket, header) {
-  if (mmtpPacket.length < MMTP_HEADER_SIZE2 + MPU_HEADER_SIZE2)
+  if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE)
     return null;
-  if (header.packetType !== PACKET_TYPE_MPU2)
+  if (header.packetType !== PACKET_TYPE_MPU)
     return null;
   const payload = mmtpPacket.subarray(header.headerLength);
-  if (payload.length < MPU_HEADER_SIZE2)
+  if (payload.length < MPU_HEADER_SIZE)
     return null;
   const payloadLength = payload[0] << 8 | payload[1];
-  if (payloadLength < MPU_HEADER_REMAINDER_SIZE2)
+  if (payloadLength < MPU_HEADER_REMAINDER_SIZE)
     return null;
-  const declaredEnd = MPU_LENGTH_FIELD_SIZE2 + payloadLength;
+  const declaredEnd = MPU_LENGTH_FIELD_SIZE + payloadLength;
   if (!resolveDeclaredTrailers(payload, declaredEnd, header.fecType)?.hasFecId)
     return null;
   const off = mmtpPacket.length - SOURCE_FEC_PAYLOAD_ID_SIZE;
@@ -338,7 +279,6 @@ function sourceFecPayloadIdOf(mmtpPacket, header) {
     ssId: (mmtpPacket[off] << 24 | mmtpPacket[off + 1] << 16 | mmtpPacket[off + 2] << 8 | mmtpPacket[off + 3]) >>> 0
   };
 }
-var extractAltaTrailer2 = extractAltaTrailer;
 
 // ../mmt-base/dist/ntp-short.js
 var NTP_SHORT_BITS = 32;
@@ -347,7 +287,6 @@ var NTP_SHORT_HALF_RANGE = 2 ** (NTP_SHORT_BITS - 1);
 
 // ../mmt-base/dist/fec-block-profile.js
 var FEC_BLOCK_PROFILES = Object.freeze([
-  "k-padded-v1",
   "iso-ssbg1-v1"
 ]);
 
@@ -5216,6 +5155,42 @@ var FecReleaseSequencer = class {
     for (const stream of this.#streams.values()) total += stream.buf.length;
     return total;
   }
+  #deferDepth = 0;
+  #deferredStreams = /* @__PURE__ */ new Set();
+  /**
+   * Run `work` with the drains its pushes would run deferred to its end. A
+   * recovered FEC block is routed one frame at a time, and its block is
+   * already resolved when the first frame is pushed: draining on that push
+   * would release past the gap before the block's other recovered frames
+   * arrive (deciding a conceal or stall for media that is about to land),
+   * and those frames would then be dropped as stale. Nests.
+   */
+  defer(work) {
+    this.#deferDepth++;
+    let threw = true;
+    try {
+      work();
+      threw = false;
+    } finally {
+      this.#deferDepth--;
+      if (this.#deferDepth === 0 && this.#deferredStreams.size > 0) {
+        const streams = [...this.#deferredStreams];
+        this.#deferredStreams.clear();
+        if (!threw) {
+          for (const stream of streams) this.#drain(stream);
+        } else {
+          try {
+            for (const stream of streams) this.#drain(stream);
+          } catch {
+          }
+        }
+      }
+    }
+  }
+  #drainUnlessDeferred(stream) {
+    if (this.#deferDepth > 0) this.#deferredStreams.add(stream);
+    else this.#drain(stream);
+  }
   push(streamKey, data, meta, seq) {
     const frame = { data, meta: { ...meta }, seq, arrivedAtMs: performance.now() };
     const stream = this.#streamFor(streamKey, meta);
@@ -5237,7 +5212,7 @@ var FecReleaseSequencer = class {
         return;
       }
       this.#release(stream, frame, void 0);
-      this.#drain(stream);
+      this.#drainUnlessDeferred(stream);
       return;
     }
     let lo = 0;
@@ -5248,7 +5223,23 @@ var FecReleaseSequencer = class {
       else hi = mid;
     }
     stream.buf.splice(lo, 0, frame);
-    this.#drain(stream);
+    this.#drainUnlessDeferred(stream);
+  }
+  /**
+   * Arrival time of the earliest frame a stream of `packetId` holds behind a
+   * gap (the gate forces it out `holdLimitMs` after that), or undefined when
+   * none is held. Without `catalogTrackName`, every stream of the packetId.
+   */
+  earliestHeldArrivalMs(packetId, catalogTrackName) {
+    let earliest;
+    for (const stream of this.#streams.values()) {
+      if (stream.packetId !== packetId) continue;
+      if (catalogTrackName !== void 0 && stream.catalogTrackName !== catalogTrackName) continue;
+      for (const frame of stream.buf) {
+        if (earliest === void 0 || frame.arrivedAtMs < earliest) earliest = frame.arrivedAtMs;
+      }
+    }
+    return earliest;
   }
   /** Re-evaluate held gaps after FEC state changed. */
   poke(streamKey) {
@@ -5301,6 +5292,21 @@ var FecReleaseSequencer = class {
       this.#streams.delete(key);
     }
   }
+  /**
+   * The packet's FEC ended, so no block will resolve a held gap: release its
+   * frames in order, each gap stalled as a discontinuity, and forget its
+   * streams, so FEC configured on it again starts from a fresh one.
+   */
+  endPacket(packetId) {
+    for (const [key, stream] of this.#streams) {
+      if (stream.packetId !== packetId) continue;
+      while (stream.buf.length > 0 && stream.last !== null) {
+        stream.discontinuity = true;
+        this.#drain(stream);
+      }
+      this.#streams.delete(key);
+    }
+  }
   discardPacket(packetId) {
     for (const [key, stream] of this.#streams) {
       if (stream.packetId !== packetId) continue;
@@ -5669,6 +5675,22 @@ var MmtpContainerParser = class _MmtpContainerParser {
       }
     ) : null;
   }
+  /**
+   * Run `work` with the FEC release gate's drains deferred to its end, so
+   * every frame it pushes is in place before any held gap is decided (see
+   * FecReleaseSequencer.defer).
+   */
+  deferFecRelease(work) {
+    if (!this.#fecSequencer) {
+      work();
+      return;
+    }
+    this.#fecSequencer.defer(work);
+  }
+  /** See FecReleaseSequencer.earliestHeldArrivalMs. */
+  fecReleaseEarliestHeldAtMs(packetId, catalogTrackName) {
+    return this.#fecSequencer?.earliestHeldArrivalMs(packetId, catalogTrackName);
+  }
   /** Re-evaluate held gaps after FEC block state changed. */
   pokeFecRelease(packetId, catalogTrackName) {
     if (!this.#fecSequencer) return;
@@ -5683,6 +5705,13 @@ var MmtpContainerParser = class _MmtpContainerParser {
   markFecDiscontinuity(packetId, catalogTrackName) {
     this.#fecSequencer?.markDiscontinuity(this.#streamKey(packetId, catalogTrackName));
   }
+  /**
+   * The FEC of a packet ID ended: release the frames the FEC release gate
+   * holds for it in order, each gap stalled, and forget its gated streams.
+   */
+  endFecRelease(packetId) {
+    this.#fecSequencer?.endPacket(packetId);
+  }
   /**
    * MPU and data-unit identity of one MMTP packet, parsed in place (no copy,
    * no reassembly). Null for non-MPU packets and packets that do not parse.
@@ -5863,7 +5892,7 @@ var MmtpContainerParser = class _MmtpContainerParser {
     const parsed = preParsed !== void 0 && preParsed.skipFecPayloadId === (options?.skipFecPayloadId === true) ? preParsed : this.parsePacket(packet, options);
     if (!parsed) return this.#drop("header-parse-failed");
     const info = parsed.info;
-    if (info.packetType !== PACKET_TYPE_MPU2) {
+    if (info.packetType !== PACKET_TYPE_MPU) {
       return {
         kind: info.isRepair ? "repair" : "non-media",
         packet: info,
@@ -5872,10 +5901,8 @@ var MmtpContainerParser = class _MmtpContainerParser {
     }
     if (info.fecPayloadId !== null && this.#sourceSymbolCb) {
       const rawSymbol = packet.subarray(0, packet.length - 4);
-      const altaTrailer = extractAltaTrailer2(packet);
-      const alta = altaTrailer ? { auth: altaTrailer.auth, payloadEnd: altaTrailer.signedEnd } : void 0;
       try {
-        this.#sourceSymbolCb(info.packetId, info.fecPayloadId.ssId, rawSymbol, alta);
+        this.#sourceSymbolCb(info.packetId, info.fecPayloadId.ssId, rawSymbol);
       } catch {
       }
     }