@blockcast/mmt-container 0.1.0-main.149f78a4adae

package/dist/multicast-transport.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Thin transport wrapper for SSM multicast — join, socket, watchdog,
+ * takeover/failback.  Delegates raw packets to a callback (MmtpRouter
+ * or any direct consumer).
+ */
+import type { WindowMulticastResolvedTransport } from '@blockcast/mmt-transport';
+export interface MulticastTransportConfig {
+    sourceAddress: string;
+    groupAddress: string;
+    port: number;
+    mode?: 'auto' | 'native' | 'tunnel';
+    amtRelay?: string;
+    amtRelayPort?: number;
+    packetIds?: number[];
+    tracks?: {
+        name: string;
+        packetId: number;
+    }[];
+}
+export type ResolvedMulticastTransport = WindowMulticastResolvedTransport;
+/**
+ * Receive counters plus the ingress-filter drop counters.
+ *
+ * `packetsReceived` / `bytesReceived` count only packets that passed the
+ * allow-list and were handed to the page — a rejected packet must never
+ * inflate them.  The `dropped*` counters are the other half of that story:
+ * without them a filtered PID is indistinguishable from a PID that was never
+ * transmitted, which is exactly the ambiguity that makes an all-zero FEC
+ * repair count unreadable (a repair leg dropped here and a repair leg the
+ * publisher never sent produce byte-identical downstream telemetry).
+ */
+export interface MulticastTransportStats {
+    packetsReceived: number;
+    bytesReceived: number;
+    /** Parsed cleanly, but the packet ID is absent from the join's allow-list. */
+    packetsDroppedUnregisteredPid: number;
+    /** MMTP header did not parse; the packet ID is unknown, so it cannot be attributed. */
+    packetsDroppedUnparseable: number;
+}
+export declare class MulticastTransport<TPacketContext = never> {
+    #private;
+    constructor(onPacket: (packet: Uint8Array, context?: TPacketContext) => void);
+    static isAvailable(): boolean;
+    join(config: MulticastTransportConfig, context?: TPacketContext): Promise<boolean>;
+    /** Feed a raw packet from an external source (e.g., AMT tunnel or ASM subscription). */
+    feedPacket(data: ArrayBuffer | Uint8Array, context?: TPacketContext): void;
+    confirmVideo(): void;
+    confirmAudio(): void;
+    onTakeover(cb: () => void): void;
+    onFailback(cb: () => void): void;
+    setFailbackWindowMs(windowMs: number): void;
+    get stats(): MulticastTransportStats;
+    /**
+     * Per-PID drop breakdown, newest-capped at MAX_TRACKED_DROPPED_PIDS distinct
+     * PIDs.  This is what names the offender: `packetsDroppedUnregisteredPid`
+     * says the ingress filter fired, this says it fired on 0x8001.
+     */
+    get droppedPacketIds(): ReadonlyMap<number, number>;
+    get resolvedTransport(): ResolvedMulticastTransport | undefined;
+    dispose(): void;
+}
+//# sourceMappingURL=multicast-transport.d.ts.map

package/dist/multicast-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicast-transport.d.ts","sourceRoot":"","sources":["../src/multicast-transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,gCAAgC,EAEjC,MAAM,0BAA0B,CAAA;AAGjC,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC9C;AAED,MAAM,MAAM,0BAA0B,GAAG,gCAAgC,CAAA;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,6BAA6B,EAAE,MAAM,CAAA;IACrC,uFAAuF;IACvF,yBAAyB,EAAE,MAAM,CAAA;CAClC;AA6BD,qBAAa,kBAAkB,CAAC,cAAc,GAAG,KAAK;;gBAuBxC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI;IAI5E,MAAM,CAAC,WAAW,IAAI,OAAO;IAIvB,IAAI,CAAC,MAAM,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA0ExF,wFAAwF;IACxF,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAU1E,YAAY,IAAI,IAAI;IAKpB,YAAY,IAAI,IAAI;IAKpB,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU3C,IAAI,KAAK,IAAI,uBAAuB,CAEnC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAElD;IAED,IAAI,iBAAiB,IAAI,0BAA0B,GAAG,SAAS,CAE9D;IAED,OAAO,IAAI,IAAI;CAqFhB"}

package/dist/multicast-transport.js

@@ -0,0 +1,338 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+
+// ../mmt-alta-parse/dist/index.js
+var MPU_HEADER_SIZE = 8;
+var MPU_LENGTH_FIELD_SIZE = 2;
+var MPU_HEADER_REMAINDER_SIZE = MPU_HEADER_SIZE - MPU_LENGTH_FIELD_SIZE;
+
+// ../mmt-base/dist/mmtp.js
+var MMTP_HEADER_SIZE = 12;
+var MPU_HEADER_SIZE2 = 8;
+var MPU_LENGTH_FIELD_SIZE2 = 2;
+var MPU_HEADER_REMAINDER_SIZE2 = MPU_HEADER_SIZE2 - MPU_LENGTH_FIELD_SIZE2;
+function parseMMTPHeader(buffer) {
+  if (buffer.length < MMTP_HEADER_SIZE) {
+    throw new Error(`MMTP packet too small: ${buffer.length} bytes`);
+  }
+  const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+  const version = buffer[0] >> 6 & 3;
+  if (version !== 0) {
+    throw new Error(`Unsupported MMTP version: ${version}`);
+  }
+  const fecType = buffer[0] >> 3 & 3;
+  const packetCounterFlag = (buffer[0] & 32) !== 0;
+  const extensionFlag = (buffer[0] & 2) !== 0;
+  const rapFlag = (buffer[0] & 1) === 1;
+  const packetType = buffer[1] & 63;
+  let offset = 2;
+  const packetId = view.getUint16(offset, false);
+  offset += 2;
+  const timestamp = BigInt(view.getUint32(offset, false));
+  offset += 4;
+  const sequenceNumber = view.getUint32(offset, false);
+  offset += 4;
+  let packetCounter;
+  if (packetCounterFlag) {
+    if (offset + 4 > buffer.length)
+      throw new Error("MMTP packet truncated in packet_counter");
+    packetCounter = view.getUint32(offset, false);
+    offset += 4;
+  }
+  let extension;
+  if (extensionFlag) {
+    if (offset + 4 > buffer.length)
+      throw new Error("MMTP packet truncated in header extension");
+    const type = view.getUint16(offset, false);
+    const length = view.getUint16(offset + 2, false);
+    offset += 4;
+    if (offset + length > buffer.length)
+      throw new Error("MMTP packet truncated in header extension value");
+    extension = { type, data: buffer.subarray(offset, offset + length) };
+    offset += length;
+  }
+  return {
+    version,
+    packetType,
+    packetId,
+    timestamp,
+    sequenceNumber,
+    payloadLength: buffer.length - offset,
+    fecType,
+    packetCounterFlag,
+    packetCounter,
+    extensionFlag,
+    extension,
+    headerLength: offset,
+    rapFlag
+  };
+}
+
+// src/multicast-transport.ts
+var MAX_TRACKED_DROPPED_PIDS = 16;
+function getMulticastGlobals() {
+  return globalThis;
+}
+function hasMulticastGateway() {
+  return typeof getMulticastGlobals().multicast?.subscribe === "function";
+}
+function normalizeResolvedTransport(value) {
+  if (value === "native") return "native";
+  if (value === "amt") return "amt";
+  return void 0;
+}
+var _onPacket, _subscription, _bytesListener, _transportListener, _resolvedTransport, _videoConfirmed, _audioConfirmed, _watchdog, _failbackWindowMs, _onTakeover, _onFailback, _disposed, _stats, _droppedPidCounts, _packetIds, _joinGeneration, _MulticastTransport_instances, releaseSubscription_fn, acceptPacket_fn, recordUnregisteredPidDrop_fn, checkTakeover_fn, resetWatchdog_fn;
+var _MulticastTransport = class _MulticastTransport {
+  constructor(onPacket) {
+    __privateAdd(this, _MulticastTransport_instances);
+    __privateAdd(this, _onPacket);
+    __privateAdd(this, _subscription, null);
+    __privateAdd(this, _bytesListener, null);
+    __privateAdd(this, _transportListener, null);
+    __privateAdd(this, _resolvedTransport);
+    __privateAdd(this, _videoConfirmed, false);
+    __privateAdd(this, _audioConfirmed, false);
+    __privateAdd(this, _watchdog, null);
+    __privateAdd(this, _failbackWindowMs, null);
+    __privateAdd(this, _onTakeover, null);
+    __privateAdd(this, _onFailback, null);
+    __privateAdd(this, _disposed, false);
+    __privateAdd(this, _stats, {
+      packetsReceived: 0,
+      bytesReceived: 0,
+      packetsDroppedUnregisteredPid: 0,
+      packetsDroppedUnparseable: 0
+    });
+    __privateAdd(this, _droppedPidCounts, /* @__PURE__ */ new Map());
+    __privateAdd(this, _packetIds, null);
+    __privateAdd(this, _joinGeneration, 0);
+    __privateSet(this, _onPacket, onPacket);
+  }
+  static isAvailable() {
+    return hasMulticastGateway();
+  }
+  async join(config, context) {
+    const generation = ++__privateWrapper(this, _joinGeneration)._;
+    __privateMethod(this, _MulticastTransport_instances, releaseSubscription_fn).call(this);
+    if (__privateGet(this, _disposed)) return false;
+    if (!_MulticastTransport.isAvailable()) {
+      console.warn("[MulticastTransport] Multicast API not available");
+      return false;
+    }
+    try {
+      const packetIds = config.packetIds?.length ? new Set(config.packetIds) : null;
+      console.log(
+        `[MulticastTransport] window.multicast.subscribe(${config.sourceAddress}, ${config.groupAddress}, ${config.port})`
+      );
+      const subscription = await getMulticastGlobals().multicast.subscribe({
+        source: config.sourceAddress,
+        group: config.groupAddress,
+        port: config.port,
+        consume: "bytes",
+        mode: config.mode,
+        amtRelay: config.amtRelay,
+        amtRelayPort: config.amtRelayPort,
+        packetIds: config.packetIds,
+        tracks: config.tracks?.map(({ name, packetId }) => ({ name, packetId }))
+      });
+      console.log(`[MulticastTransport] window.multicast.subscribe returned:`, !!subscription);
+      if (__privateGet(this, _disposed) || generation !== __privateGet(this, _joinGeneration)) {
+        void subscription.unsubscribe();
+        return false;
+      }
+      if (typeof subscription.addEventListener !== "function") {
+        if (typeof subscription.unsubscribe === "function") {
+          void subscription.unsubscribe();
+        }
+        throw new Error("window.multicast subscription does not support bytes events");
+      }
+      const onBytes = (event) => {
+        if (__privateGet(this, _disposed) || generation !== __privateGet(this, _joinGeneration)) return;
+        const detail = event.detail;
+        const packet = detail instanceof Uint8Array ? detail : new Uint8Array(detail);
+        if (!__privateMethod(this, _MulticastTransport_instances, acceptPacket_fn).call(this, packet)) return;
+        __privateGet(this, _stats).packetsReceived++;
+        __privateGet(this, _stats).bytesReceived += packet.byteLength;
+        __privateGet(this, _onPacket).call(this, packet, context);
+        __privateMethod(this, _MulticastTransport_instances, resetWatchdog_fn).call(this);
+      };
+      const onTransportChange = (event) => {
+        if (__privateGet(this, _disposed) || generation !== __privateGet(this, _joinGeneration)) return;
+        const transport = normalizeResolvedTransport(event.detail);
+        if (transport) __privateSet(this, _resolvedTransport, transport);
+      };
+      __privateSet(this, _subscription, subscription);
+      __privateSet(this, _bytesListener, onBytes);
+      __privateSet(this, _transportListener, onTransportChange);
+      __privateSet(this, _packetIds, packetIds);
+      __privateSet(this, _resolvedTransport, normalizeResolvedTransport(subscription.transport));
+      subscription.addEventListener("bytes", onBytes);
+      subscription.addEventListener("transportchange", onTransportChange);
+      __privateMethod(this, _MulticastTransport_instances, resetWatchdog_fn).call(this);
+      console.log(
+        `[MulticastTransport] Joined ${config.groupAddress}:${config.port}`
+      );
+      return true;
+    } catch (err) {
+      if (__privateGet(this, _disposed) || generation !== __privateGet(this, _joinGeneration)) return false;
+      __privateMethod(this, _MulticastTransport_instances, releaseSubscription_fn).call(this);
+      console.error("[MulticastTransport] Failed to join SSM group:", err);
+      return false;
+    }
+  }
+  /** Feed a raw packet from an external source (e.g., AMT tunnel or ASM subscription). */
+  feedPacket(data, context) {
+    if (__privateGet(this, _disposed)) return;
+    const packet = data instanceof Uint8Array ? data : new Uint8Array(data);
+    if (!__privateMethod(this, _MulticastTransport_instances, acceptPacket_fn).call(this, packet)) return;
+    __privateGet(this, _stats).packetsReceived++;
+    __privateGet(this, _stats).bytesReceived += packet.byteLength;
+    __privateGet(this, _onPacket).call(this, packet, context);
+    __privateMethod(this, _MulticastTransport_instances, resetWatchdog_fn).call(this);
+  }
+  confirmVideo() {
+    __privateSet(this, _videoConfirmed, true);
+    __privateMethod(this, _MulticastTransport_instances, checkTakeover_fn).call(this);
+  }
+  confirmAudio() {
+    __privateSet(this, _audioConfirmed, true);
+    __privateMethod(this, _MulticastTransport_instances, checkTakeover_fn).call(this);
+  }
+  onTakeover(cb) {
+    __privateSet(this, _onTakeover, cb);
+  }
+  onFailback(cb) {
+    __privateSet(this, _onFailback, cb);
+  }
+  setFailbackWindowMs(windowMs) {
+    if (!Number.isFinite(windowMs) || windowMs <= 0) {
+      throw new Error(
+        `[MulticastTransport] failbackWindowMs=${windowMs}. Derive a positive failback window from the stream catalog.`
+      );
+    }
+    __privateSet(this, _failbackWindowMs, windowMs);
+  }
+  get stats() {
+    return __privateGet(this, _stats);
+  }
+  /**
+   * Per-PID drop breakdown, newest-capped at MAX_TRACKED_DROPPED_PIDS distinct
+   * PIDs.  This is what names the offender: `packetsDroppedUnregisteredPid`
+   * says the ingress filter fired, this says it fired on 0x8001.
+   */
+  get droppedPacketIds() {
+    return __privateGet(this, _droppedPidCounts);
+  }
+  get resolvedTransport() {
+    return __privateGet(this, _resolvedTransport);
+  }
+  dispose() {
+    ++__privateWrapper(this, _joinGeneration)._;
+    __privateSet(this, _disposed, true);
+    __privateMethod(this, _MulticastTransport_instances, releaseSubscription_fn).call(this);
+  }
+};
+_onPacket = new WeakMap();
+_subscription = new WeakMap();
+_bytesListener = new WeakMap();
+_transportListener = new WeakMap();
+_resolvedTransport = new WeakMap();
+_videoConfirmed = new WeakMap();
+_audioConfirmed = new WeakMap();
+_watchdog = new WeakMap();
+_failbackWindowMs = new WeakMap();
+_onTakeover = new WeakMap();
+_onFailback = new WeakMap();
+_disposed = new WeakMap();
+_stats = new WeakMap();
+_droppedPidCounts = new WeakMap();
+_packetIds = new WeakMap();
+_joinGeneration = new WeakMap();
+_MulticastTransport_instances = new WeakSet();
+releaseSubscription_fn = function() {
+  if (__privateGet(this, _watchdog)) clearTimeout(__privateGet(this, _watchdog));
+  __privateSet(this, _watchdog, null);
+  if (__privateGet(this, _subscription)) {
+    if (__privateGet(this, _bytesListener)) {
+      __privateGet(this, _subscription).removeEventListener("bytes", __privateGet(this, _bytesListener));
+    }
+    if (__privateGet(this, _transportListener)) {
+      __privateGet(this, _subscription).removeEventListener("transportchange", __privateGet(this, _transportListener));
+    }
+    void __privateGet(this, _subscription).unsubscribe();
+  }
+  __privateSet(this, _subscription, null);
+  __privateSet(this, _bytesListener, null);
+  __privateSet(this, _transportListener, null);
+  __privateSet(this, _resolvedTransport, void 0);
+  __privateSet(this, _packetIds, null);
+};
+acceptPacket_fn = function(packet) {
+  if (!__privateGet(this, _packetIds)) return true;
+  let packetId;
+  try {
+    packetId = parseMMTPHeader(packet).packetId;
+  } catch {
+    __privateGet(this, _stats).packetsDroppedUnparseable++;
+    return false;
+  }
+  if (__privateGet(this, _packetIds).has(packetId)) return true;
+  __privateMethod(this, _MulticastTransport_instances, recordUnregisteredPidDrop_fn).call(this, packetId);
+  return false;
+};
+recordUnregisteredPidDrop_fn = function(packetId) {
+  __privateGet(this, _stats).packetsDroppedUnregisteredPid++;
+  const seen = __privateGet(this, _droppedPidCounts).get(packetId);
+  if (seen !== void 0) {
+    __privateGet(this, _droppedPidCounts).set(packetId, seen + 1);
+    return;
+  }
+  if (__privateGet(this, _droppedPidCounts).size >= MAX_TRACKED_DROPPED_PIDS) return;
+  __privateGet(this, _droppedPidCounts).set(packetId, 1);
+  console.warn(
+    `[MulticastTransport] Dropping packetId=${packetId} (0x${packetId.toString(16)}): not in the advertised set [${[...__privateGet(this, _packetIds)].join(", ")}]. If this is an FEC repair leg, the catalog is not advertising its packetId.`
+  );
+};
+checkTakeover_fn = function() {
+  if (__privateGet(this, _videoConfirmed) && __privateGet(this, _audioConfirmed) && __privateGet(this, _onTakeover)) {
+    const cb = __privateGet(this, _onTakeover);
+    __privateSet(this, _onTakeover, null);
+    cb();
+  }
+};
+resetWatchdog_fn = function() {
+  if (__privateGet(this, _watchdog)) clearTimeout(__privateGet(this, _watchdog));
+  if (!__privateGet(this, _onFailback)) return;
+  if (__privateGet(this, _failbackWindowMs) === null) {
+    throw new Error(
+      "[MulticastTransport] Failback watchdog requires a catalog-derived window"
+    );
+  }
+  __privateSet(this, _watchdog, setTimeout(() => {
+    if (!__privateGet(this, _disposed) && __privateGet(this, _onFailback)) {
+      console.warn(
+        `[MulticastTransport] No packets for ${__privateGet(this, _failbackWindowMs)}ms; failing back to MoQ`
+      );
+      __privateGet(this, _onFailback).call(this);
+    }
+  }, __privateGet(this, _failbackWindowMs)));
+};
+var MulticastTransport = _MulticastTransport;
+export {
+  MulticastTransport
+};
+//# sourceMappingURL=multicast-transport.js.map

package/dist/multicast-transport.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../mmt-alta-parse/src/index.ts", "../../mmt-base/src/mmtp.ts", "../src/multicast-transport.ts"],
+  "sourcesContent": ["/**\n * Zero-dependency helper for extracting the detached ALTA authenticator trailer\n * from an MMTP source packet.\n *\n * Lives in its own leaf package so both `@blockcast/mmt-container` (wire-path\n * parsing) and `@blockcast/fec-worker` (FEC-recovered-source parsing) can share\n * one implementation without creating a package cycle between them.\n *\n * Spec: ISO/IEC 23008-1:2023 + draft-ramadan-moq-mmt \u00A712 (detached trailer, Path 2).\n */\n\n// --- Private MMTP/MPU/MFU constants (ISO/IEC 23008-1 \u00A79.2.2\u20139.2.3) ---\n// Duplicated here as immutable spec values so this package stays a leaf with\n// zero `@blockcast/*` dependencies. Re-deriving from `mmt-container` would\n// reintroduce the package cycle this split exists to avoid.\n\nconst MMTP_HEADER_SIZE = 12\nconst MPU_HEADER_SIZE = 8\nconst MPU_LENGTH_FIELD_SIZE = 2\nconst MPU_HEADER_REMAINDER_SIZE = MPU_HEADER_SIZE - MPU_LENGTH_FIELD_SIZE\nconst TIMED_MFU_DU_HEADER_SIZE = 14\nconst NONTIMED_MFU_DU_HEADER_SIZE = 4\nconst PACKET_TYPE_MPU = 0x00\n\n// --- Public ALTA trailer constants ---\n\n/**\n * MMTP header-extension ext_type assigned to the detached ALTA authenticator\n * trailer (Path 2 / 08-07). Carried in an `[ext_type][ext_length][auth]`\n * block appended after the MPU's declared payload bytes, before the 4-byte\n * Source FEC Payload ID. MMTP X-bit stays 0 \u2014 non-ALTA MMTP receivers treat\n * the trailer as bytes past `payload_length` and skip it (per ISO 23008-1\n * \u00A79.2.2 \"may be discarded without impacting correct processing\").\n */\nexport const MMTP_EXT_TYPE_ALTA_AUTH = 0xf0a1\n\n/** Fixed size of the trailer's `[ext_type][ext_length]` prefix (2 + 2 BE). */\nexport const MMTP_EXT_TRAILER_HEADER_SIZE = 4\n\n/** Result of extracting the detached ALTA authenticator from an MMTP packet. */\nexport interface AltaTrailer {\n  /** Authenticator bytes (no ext_type/ext_length prefix, no trailing padding). */\n  auth: Uint8Array\n  /**\n   * Wire-packet byte offset where the signed payload ends, i.e. where the\n   * trailer begins. Caller uses this to produce\n   * `payload = wirePacket.subarray(0, signedEnd)` for verify_detached.\n   */\n  signedEnd: number\n}\n\n/**\n * Extract the detached ALTA authenticator trailer from an MMTP source packet.\n *\n * Wire layout:\n *   `[MMTP hdr][length(2)][remaining MPU hdr(6)][DU?][media][TRAILER][SS_ID?]`\n *   `payload_length = 6 + DU bytes + media bytes`\n *\n * Returns `null` when:\n * - the packet is too small / malformed,\n * - `payload_length` cannot contain the remaining six MPU-header bytes,\n * - the declared payload overruns the packet,\n * - no bytes remain between `payload_length` and the SS_ID,\n * - the trailer's `ext_type` isn't {@link MMTP_EXT_TYPE_ALTA_AUTH},\n * - the declared `ext_length` would extend past the SS_ID boundary.\n *\n * Non-MPU packets (repair, signaling) always return `null`.\n *\n * @param options.skipFecId When true, do NOT reserve 4 trailing bytes for the\n *   Source FEC Payload ID. Use on FEC-recovered symbols where the PID has\n *   already been stripped upstream.\n */\nexport function extractAltaTrailer(\n  mmtpPacket: Uint8Array,\n  options?: { skipFecId?: boolean },\n): AltaTrailer | null {\n  if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE) return null\n  // ISO/IEC 23008-1:2023 Figure 8 places V=0 packet_type in the low six bits.\n  const packetType = mmtpPacket[1]! & 0x3f\n  if (packetType !== PACKET_TYPE_MPU) return null\n\n  const fecType = (mmtpPacket[0]! >> 3) & 0x03\n  let headerLength = MMTP_HEADER_SIZE\n  if (fecType < 2 && (mmtpPacket[0]! & 0x20) !== 0) headerLength += 4\n  if (fecType < 2 && (mmtpPacket[0]! & 0x02) !== 0) {\n    if (headerLength + 4 > mmtpPacket.length) return null\n    const extensionLength = new DataView(\n      mmtpPacket.buffer,\n      mmtpPacket.byteOffset + headerLength + 2,\n      2,\n    ).getUint16(0, false)\n    headerLength += 4 + extensionLength\n  }\n  if (headerLength + MPU_HEADER_SIZE > mmtpPacket.length) return null\n\n  const payload = mmtpPacket.subarray(headerLength)\n\n  // Inline a minimal MPU-header read \u2014 only the fields extractAltaTrailer needs.\n  // payloadLength: 16 BE at bytes 0-1.\n  // Byte 2 packs FT(4) | T(1) | FI(2) | A(1).\n  const payloadLength = (payload[0]! << 8) | payload[1]!\n  const flagsByte = payload[2]!\n  const fragmentType = (flagsByte >> 4) & 0x0f\n  const timed = ((flagsByte >> 3) & 0x01) === 1\n  const fragmentationIndicator = (flagsByte >> 1) & 0x03\n\n  // Only MFU packets (FT=2) carry the detached trailer.\n  if (fragmentType !== 2) return null\n\n  // FI=0/1 structurally carries a DU header; FI=2/3 does not. Require at\n  // least one media byte after that deterministic layout so the bytes at the\n  // declared boundary cannot impersonate ALTA for a header-only fragment.\n  const dataUnitHeaderSize = fragmentationIndicator <= 1\n    ? (timed ? TIMED_MFU_DU_HEADER_SIZE : NONTIMED_MFU_DU_HEADER_SIZE)\n    : 0\n  if (payloadLength <= MPU_HEADER_REMAINDER_SIZE + dataUnitHeaderSize) return null\n\n  if (fecType > 1) return null\n  const hasFecId = !options?.skipFecId && fecType === 1\n  const payloadEnd = hasFecId ? payload.length - 4 : payload.length\n  const declaredEnd = MPU_LENGTH_FIELD_SIZE + payloadLength\n  if (declaredEnd > payloadEnd) return null\n\n  if (declaredEnd + MMTP_EXT_TRAILER_HEADER_SIZE > payloadEnd) return null\n  const extType = (payload[declaredEnd]! << 8) | payload[declaredEnd + 1]!\n  if (extType !== MMTP_EXT_TYPE_ALTA_AUTH) return null\n  const extLen = (payload[declaredEnd + 2]! << 8) | payload[declaredEnd + 3]!\n\n  const authStart = declaredEnd + MMTP_EXT_TRAILER_HEADER_SIZE\n  if (authStart + extLen !== payloadEnd) return null\n\n  return {\n    auth: payload.subarray(authStart, payloadEnd),\n    signedEnd: headerLength + declaredEnd,\n  }\n}\n", "import {\n  MMTP_EXT_TYPE_ALTA_AUTH as _LEAF_MMTP_EXT_TYPE_ALTA_AUTH,\n  MMTP_EXT_TRAILER_HEADER_SIZE as _LEAF_MMTP_EXT_TRAILER_HEADER_SIZE,\n  extractAltaTrailer as _leafExtractAltaTrailer,\n  type AltaTrailer as _LeafAltaTrailer,\n} from '@blockcast/mmt-alta-parse'\n\n/**\n * @mmt/container - MMTP Parser\n *\n * MMTP (MMT Protocol) packet parser based on ISO/IEC 23008-1:2023 Section 9.2\n *\n * MMTP header format (12 bytes):\n * - Byte 0: V(2) | C(1) | FEC_type(2) | r(1) | X(1) | R(1)\n * - Byte 1: reserved(2) | packet_type(6)\n * - Bytes 2-3: packet_id (big-endian)\n * - Bytes 4-7: timestamp (big-endian, 32-bit)\n * - Bytes 8-11: sequence_number (big-endian)\n *\n * FEC_type values:\n * - 0: No FEC / source packet\n * - 1: FEC mode 0 (source with FEC payload ID)\n * - 2: FEC repair packet mode 0\n * - 3: FEC repair packet mode 1\n *\n * @packageDocumentation\n */\n\nexport interface MMTPHeader {\n  version: number\n  /** Packet type: 0x00=MPU, 0x02=Signaling, 0x03=Repair */\n  packetType: number\n  packetId: number\n  timestamp: bigint\n  sequenceNumber: number\n  payloadLength: number\n  fecType: number\n  /** C flag: header carries a 32-bit packet_counter. */\n  packetCounterFlag: boolean\n  packetCounter?: number\n  /** X flag: header carries an extension header and value. */\n  extensionFlag: boolean\n  extension?: { type: number; data: Uint8Array }\n  /** Byte offset at which the MMTP payload begins. */\n  headerLength: number\n  /** Random Access Point flag - indicates keyframe (ISO 23008-1, byte 0 bit 0) */\n  rapFlag: boolean\n}\n\nexport interface MPUHeader {\n  mpuSequenceNumber: number\n  fragmentationIndicator: number // FI: 0=complete, 1=first, 2=middle, 3=last\n  /** 8-bit MPU fragment_counter from byte 3. */\n  fragmentCounter: number\n  /** T flag: 1=timed media (14-byte MFU DU header), 0=non-timed (4-byte header) */\n  timedFlag: number\n  /** A flag: aggregated MPU payload. This strict profile requires A=0. */\n  aggregationFlag: boolean\n  /** MPU payload_length (bytes 0-1): bytes after the length field, including\n   *  the remaining six MPU-header bytes and all data-unit bytes. */\n  payloadLength: number\n}\n\nexport interface MFUDuHeader {\n  movieFragmentSequenceNumber: number\n  sampleNumber: number\n  offset: number\n  priority: number\n  dependencyCounter: number\n}\n\nexport interface MMTPPacket {\n  header: MMTPHeader\n  payload: Uint8Array\n}\n\nexport const MMTP_HEADER_SIZE = 12\nexport const MPU_HEADER_SIZE = 8\nexport const MFU_DU_HEADER_SIZE_TIMED = 14    // T=1: timed media (video/audio samples)\nexport const MFU_DU_HEADER_SIZE_NONTIMED = 4  // T=0: non-timed media (item_id only)\n\nconst MPU_LENGTH_FIELD_SIZE = 2\nconst MPU_HEADER_REMAINDER_SIZE = MPU_HEADER_SIZE - MPU_LENGTH_FIELD_SIZE\nconst SOURCE_FEC_PAYLOAD_ID_SIZE = 4\n\n// MMTP Packet Types (ISO/IEC 23008-1:2023 Section 9.2.2)\nexport const PACKET_TYPE_MPU = 0x00\nexport const PACKET_TYPE_SIGNALING = 0x02\nexport const PACKET_TYPE_REPAIR = 0x03\n\n// AL-FEC Signaling Message ID (ISO/IEC 23008-1:2023 Amendment 1:2025)\nexport const ALFEC_MESSAGE_ID = 0x0203\n\n// FEC Code IDs\nexport const FEC_CODE_XOR = 1\nexport const FEC_CODE_RAPTORQ = 2\n\n/**\n * Parse MMTP header from buffer\n */\nexport function parseMMTPHeader(buffer: Uint8Array): MMTPHeader {\n  if (buffer.length < MMTP_HEADER_SIZE) {\n    throw new Error(`MMTP packet too small: ${buffer.length} bytes`)\n  }\n\n  const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength)\n\n  const version = (buffer[0]! >> 6) & 0x03\n  if (version !== 0) {\n    throw new Error(`Unsupported MMTP version: ${version}`)\n  }\n\n  // Extract FEC type from byte 0, bits 3-4\n  const fecType = (buffer[0]! >> 3) & 0x03\n  const packetCounterFlag = (buffer[0]! & 0x20) !== 0\n  const extensionFlag = (buffer[0]! & 0x02) !== 0\n\n  // Extract RAP flag from byte 0, bit 0 (R bit - Random Access Point)\n  const rapFlag = (buffer[0]! & 0x01) === 1\n\n  // ISO/IEC 23008-1:2023 Figure 8 (V=0) places reserved(2) before\n  // packet_type(6), so packet_type occupies the low six bits of byte 1.\n  const packetType = buffer[1]! & 0x3F\n\n  let offset = 2\n\n  // Packet ID (2 bytes, big-endian)\n  const packetId = view.getUint16(offset, false)\n  offset += 2\n\n  // Timestamp (4 bytes, big-endian)\n  const timestamp = BigInt(view.getUint32(offset, false))\n  offset += 4\n\n  // Sequence number (4 bytes, big-endian)\n  const sequenceNumber = view.getUint32(offset, false)\n  offset += 4\n\n  let packetCounter: number | undefined\n  if (packetCounterFlag) {\n    if (offset + 4 > buffer.length) throw new Error('MMTP packet truncated in packet_counter')\n    packetCounter = view.getUint32(offset, false)\n    offset += 4\n  }\n\n  let extension: { type: number; data: Uint8Array } | undefined\n  if (extensionFlag) {\n    if (offset + 4 > buffer.length) throw new Error('MMTP packet truncated in header extension')\n    const type = view.getUint16(offset, false)\n    const length = view.getUint16(offset + 2, false)\n    offset += 4\n    if (offset + length > buffer.length) throw new Error('MMTP packet truncated in header extension value')\n    extension = { type, data: buffer.subarray(offset, offset + length) }\n    offset += length\n  }\n\n  return {\n    version,\n    packetType,\n    packetId,\n    timestamp,\n    sequenceNumber,\n    payloadLength: buffer.length - offset,\n    fecType,\n    packetCounterFlag,\n    packetCounter,\n    extensionFlag,\n    extension,\n    headerLength: offset,\n    rapFlag,\n  }\n}\n\n/**\n * Unwrap MMTP packet to extract payload\n */\nexport function unwrapMMTP(buffer: Uint8Array): MMTPPacket {\n  const header = parseMMTPHeader(buffer)\n  const payload = buffer.subarray(header.headerLength)\n\n  return { header, payload }\n}\n\n/**\n * Parse MPU header from payload\n * ISO/IEC 23008-1:2023 Section 9.2.3.3\n *\n * MPU Header format (8 bytes) as written by FFmpeg/libmmt:\n * - Bytes 0-1: payload_length (16 bits, big-endian)\n * - Byte 2: FT(4) | T(1) | FI(2) | A(1)\n * - Byte 3: fragment_counter (8 bits)\n * - Bytes 4-7: MPU_sequence_number (32 bits, big-endian)\n */\nexport function parseMPUHeader(payload: Uint8Array): MPUHeader {\n  if (payload.length < MPU_HEADER_SIZE) {\n    throw new Error(`Payload too small for MPU header: ${payload.length} bytes`)\n  }\n\n  const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength)\n\n  // Bytes 0-1: payload_length (16 bits, big-endian)\n  const payloadLength = view.getUint16(0, false)\n\n  // Byte 2: FT(4) | T(1) | FI(2) | A(1)\n  const flagsByte = payload[2]!\n  const timedFlag = (flagsByte >> 3) & 0x01\n  const fragmentationIndicator = (flagsByte >> 1) & 0x03\n  const aggregationFlag = (flagsByte & 0x01) !== 0\n\n  // Byte 3: fragment_counter (8 bits). The high bit is part of the counter in\n  // the current libmmt/FFmpeg writer ABI.\n  const fragmentCounter = payload[3]!\n\n  // Bytes 4-7: MPU_sequence_number (32 bits, big-endian)\n  const mpuSequenceNumber = view.getUint32(4, false)\n\n  return {\n    mpuSequenceNumber,\n    fragmentationIndicator,\n    fragmentCounter,\n    timedFlag,\n    aggregationFlag,\n    payloadLength,\n  }\n}\n\nexport function parseTimedMfuDuHeader(payload: Uint8Array, offset: number): MFUDuHeader | null {\n  if (offset < 0 || offset + MFU_DU_HEADER_SIZE_TIMED > payload.length) return null\n  const view = new DataView(payload.buffer, payload.byteOffset + offset, MFU_DU_HEADER_SIZE_TIMED)\n  return {\n    movieFragmentSequenceNumber: view.getUint32(0, false),\n    sampleNumber: view.getUint32(4, false),\n    offset: view.getUint32(8, false),\n    priority: payload[offset + 12]!,\n    dependencyCounter: payload[offset + 13]!,\n  }\n}\n\n/**\n * Why `extractMFUPayload` refused a packet.\n *\n * These identifiers are part of the public contract: callers surface them in\n * diagnostics, so renaming one is a breaking change.\n */\nexport type MFURejectionGate =\n  | 'packet-shorter-than-mmtp-plus-mpu-header'\n  | 'mmtp-header-unparseable'\n  | 'not-an-mpu-packet'\n  | 'payload-shorter-than-mpu-header'\n  | 'aggregation-flag-set'\n  | 'mpu-payload-length-below-header-remainder'\n  | 'mpu-declared-end-exceeds-payload'\n  | 'mfu-offset-at-or-past-declared-end'\n  | 'source-fec-payload-id-width-mismatch'\n  | 'declared-trailers-unresolved'\n\nexport interface MFURejection {\n  gate: MFURejectionGate\n  /** Human-readable detail, including the byte arithmetic that decided it. */\n  detail: string\n}\n\ninterface MfuPayloadLayout {\n  hasMfuDuHeader: boolean\n  mfuOffset: number\n  dataEnd: number\n}\n\nfunction resolveMfuPayloadLayout(\n  mpu: MPUHeader,\n  fragmentType: number,\n  payload: Uint8Array,\n): { layout: MfuPayloadLayout } | { rejection: MFURejection } {\n  if (mpu.payloadLength < MPU_HEADER_REMAINDER_SIZE) {\n    return {\n      rejection: {\n        gate: 'mpu-payload-length-below-header-remainder',\n        detail: `payload_length=${mpu.payloadLength} < ${MPU_HEADER_REMAINDER_SIZE}`,\n      },\n    }\n  }\n\n  // ISO/IEC 23008-1 defines payload_length from immediately after its own\n  // two-byte field. It therefore includes the remaining six MPU-header bytes.\n  const declaredEnd = MPU_LENGTH_FIELD_SIZE + mpu.payloadLength\n  if (declaredEnd > payload.length) {\n    return {\n      rejection: {\n        gate: 'mpu-declared-end-exceeds-payload',\n        detail:\n          `payload_length=${mpu.payloadLength} implies end=${declaredEnd}, ` +\n          `payload is ${payload.length} bytes`,\n      },\n    }\n  }\n\n  const hasHeader = fragmentType === 2 && mpu.fragmentationIndicator <= 1\n  const mfuHeaderSize = mpu.timedFlag ? MFU_DU_HEADER_SIZE_TIMED : MFU_DU_HEADER_SIZE_NONTIMED\n  const mfuOffset = MPU_HEADER_SIZE + (hasHeader ? mfuHeaderSize : 0)\n  if (mfuOffset >= declaredEnd) {\n    return {\n      rejection: {\n        gate: 'mfu-offset-at-or-past-declared-end',\n        detail: `mfuOffset=${mfuOffset} >= declaredEnd=${declaredEnd}`,\n      },\n    }\n  }\n\n  return {\n    layout: {\n      hasMfuDuHeader: hasHeader,\n      mfuOffset,\n      dataEnd: declaredEnd,\n    },\n  }\n}\n\nfunction isEmptyOrExactAltaTrailer(payload: Uint8Array, start: number, end: number): boolean {\n  if (start === end) return true\n  if (start < 0 || end > payload.length || start + _LEAF_MMTP_EXT_TRAILER_HEADER_SIZE > end) {\n    return false\n  }\n\n  const view = new DataView(\n    payload.buffer,\n    payload.byteOffset + start,\n    end - start,\n  )\n  if (view.getUint16(0, false) !== _LEAF_MMTP_EXT_TYPE_ALTA_AUTH) return false\n\n  const authLength = view.getUint16(2, false)\n  return start + _LEAF_MMTP_EXT_TRAILER_HEADER_SIZE + authLength === end\n}\n\ninterface DeclaredTrailerLayout {\n  hasFecId: boolean\n}\n\nfunction resolveDeclaredTrailers(\n  payload: Uint8Array,\n  declaredEnd: number,\n  fecType: number,\n  options?: { skipFecId?: boolean },\n): DeclaredTrailerLayout | null {\n  if (declaredEnd > payload.length) return null\n\n  if (options?.skipFecId) {\n    return isEmptyOrExactAltaTrailer(payload, declaredEnd, payload.length)\n      ? { hasFecId: false }\n      : null\n  }\n\n  if (fecType === 1) {\n    const fecStart = payload.length - SOURCE_FEC_PAYLOAD_ID_SIZE\n    if (fecStart < declaredEnd || !isEmptyOrExactAltaTrailer(payload, declaredEnd, fecStart)) {\n      return null\n    }\n    return { hasFecId: true }\n  }\n  if (fecType !== 0) return null\n\n  if (isEmptyOrExactAltaTrailer(payload, declaredEnd, payload.length)) {\n    return { hasFecId: false }\n  }\n\n  return null\n}\n\n/**\n * Extract NAL unit payload from MMTP packet\n */\nexport function extractNALUnit(mmtpPacket: Uint8Array): Uint8Array {\n  const extraction = extractMFUPayload(mmtpPacket)\n  if (!extraction) throw new Error('Malformed MMTP MPU payload')\n  return extraction.data\n}\n\n/** Result of extracting MFU payload from an MMTP packet */\nexport interface MFUExtraction {\n  /** MMTP header fields */\n  header: MMTPHeader\n  /** MPU header fields */\n  mpu: MPUHeader\n  /** Fragment type (FT field, 4 bits): 0=metadata, 2=MFU data */\n  fragmentType: number\n  /** MFU payload data (video/audio bytes, headers stripped, FEC ID excluded) */\n  data: Uint8Array\n  /** Parsed timed MFU DU header when present, otherwise null */\n  mfuDuHeader: MFUDuHeader | null\n  /** Non-timed MFU Item_ID when the 4-byte DU header is present. */\n  itemId: number | null\n  /** Source FEC Payload ID if present (`FEC_type == 1`), or null */\n  fecPayloadId: { ssId: number } | null\n}\n\n/**\n * Extract MFU payload from a raw MMTP packet.\n *\n * Handles all the byte arithmetic for:\n * - MMTP header (12 bytes)\n * - MPU sub-header (8 bytes, payloadLength field)\n * - MFU DU header (14 bytes timed / 4 bytes non-timed, only for FI \u2264 1)\n * - Source FEC Payload ID (4 bytes at end, only when `FEC_type == 1`)\n *\n * `payloadLength` is the ISO length-after-field value: six remaining MPU-header\n * bytes, then the MFU DU header when present, then media. ALTA and Source FEC\n * trailers are outside that declared span and must consume the exact suffix.\n *\n * @param mmtpPacket Raw MMTP packet (from multicast or MoQ)\n * @param options.skipFecId When true, do NOT subtract the 4-byte Source FEC Payload ID\n *   from the payload boundary, even if fecType >= 1 in the MMTP header.  Use this for\n *   FEC-recovered symbols where the FEC PID was already stripped before WASM decoding\n *   but the fecType bits in byte 0 still reflect the original packet (FEC Type=1 per\n *   draft-ramadan-moq-mmt-00 \u00A73.1).\n * @returns Extracted MFU data + metadata, or null if packet is too small\n */\ninterface MfuPlan {\n  header: MMTPHeader\n  payload: Uint8Array\n  mpu: MPUHeader\n  fragmentType: number\n  layout: MfuPayloadLayout\n  trailerLayout: DeclaredTrailerLayout\n}\n\n/**\n * Single source of truth for whether a packet yields an MFU payload.\n *\n * `extractMFUPayload` and `explainMFURejection` both delegate here, so the\n * reason reported to operators can never drift from the decision the parser\n * actually made.\n */\nfunction planMfuExtraction(\n  mmtpPacket: Uint8Array,\n  options?: { skipFecId?: boolean },\n): { plan: MfuPlan } | { rejection: MFURejection } {\n  if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE) {\n    return {\n      rejection: {\n        gate: 'packet-shorter-than-mmtp-plus-mpu-header',\n        detail: `${mmtpPacket.length} bytes < ${MMTP_HEADER_SIZE + MPU_HEADER_SIZE}`,\n      },\n    }\n  }\n\n  let header: MMTPHeader\n  try {\n    header = parseMMTPHeader(mmtpPacket)\n  } catch (error) {\n    return {\n      rejection: {\n        gate: 'mmtp-header-unparseable',\n        detail: error instanceof Error ? error.message : String(error),\n      },\n    }\n  }\n  if (header.packetType !== PACKET_TYPE_MPU) {\n    return {\n      rejection: {\n        gate: 'not-an-mpu-packet',\n        detail: `packetType=0x${header.packetType.toString(16).padStart(2, '0')}`,\n      },\n    }\n  }\n\n  const payload = mmtpPacket.subarray(header.headerLength)\n  if (payload.length < MPU_HEADER_SIZE) {\n    return {\n      rejection: {\n        gate: 'payload-shorter-than-mpu-header',\n        detail: `${payload.length} bytes < ${MPU_HEADER_SIZE}`,\n      },\n    }\n  }\n\n  const mpu = parseMPUHeader(payload)\n  if (mpu.aggregationFlag) {\n    return {\n      rejection: { gate: 'aggregation-flag-set', detail: 'strict profile requires A=0' },\n    }\n  }\n\n  // Fragment type from byte 2 upper nibble (not returned by parseMPUHeader)\n  const fragmentType = (payload[2]! >> 4) & 0x0f\n\n  const layoutResult = resolveMfuPayloadLayout(mpu, fragmentType, payload)\n  if ('rejection' in layoutResult) return layoutResult\n  const { layout } = layoutResult\n\n  const trailerLayout = resolveDeclaredTrailers(\n    payload,\n    layout.dataEnd,\n    header.fecType,\n    options,\n  )\n  if (!trailerLayout) {\n    // The most common cause is a producer whose Source FEC Payload ID width\n    // disagrees with ISO/IEC 23008-1 \u00A7C.5.2. Name that explicitly rather than\n    // leaving operators to infer it from a generic trailer error.\n    if (!options?.skipFecId && header.fecType === 1) {\n      const observed = payload.length - layout.dataEnd\n      if (observed !== SOURCE_FEC_PAYLOAD_ID_SIZE) {\n        return {\n          rejection: {\n            gate: 'source-fec-payload-id-width-mismatch',\n            detail:\n              `producer wrote a ${observed}-byte Source FEC Payload ID, ` +\n              `ISO/IEC 23008-1 \u00A7C.5.2 requires ${SOURCE_FEC_PAYLOAD_ID_SIZE} ` +\n              `(payload=${payload.length}, declaredEnd=${layout.dataEnd})`,\n          },\n        }\n      }\n    }\n    return {\n      rejection: {\n        gate: 'declared-trailers-unresolved',\n        detail:\n          `trailer bytes [${layout.dataEnd}, ${payload.length}) are neither empty ` +\n          `nor an exact ALTA trailer (fecType=${header.fecType})`,\n      },\n    }\n  }\n\n  return { plan: { header, payload, mpu, fragmentType, layout, trailerLayout } }\n}\n\n/**\n * Report why `extractMFUPayload` would refuse this packet, or null if it would\n * accept it.\n *\n * `extractMFUPayload` returns bare `null` on ten distinct conditions, which\n * makes a producer/consumer framing disagreement indistinguishable from a\n * publisher that never started \u2014 both render as silence. Use this wherever\n * that distinction matters: diagnostics, contract tests, and operator-facing\n * logs.\n */\nexport function explainMFURejection(\n  mmtpPacket: Uint8Array,\n  options?: { skipFecId?: boolean },\n): MFURejection | null {\n  const result = planMfuExtraction(mmtpPacket, options)\n  return 'rejection' in result ? result.rejection : null\n}\n\nexport function extractMFUPayload(\n  mmtpPacket: Uint8Array,\n  options?: { skipFecId?: boolean },\n): MFUExtraction | null {\n  const result = planMfuExtraction(mmtpPacket, options)\n  if ('rejection' in result) return null\n  const { header, payload, mpu, fragmentType, layout, trailerLayout } = result.plan\n\n  const mfuDuHeaderPresent = layout.hasMfuDuHeader\n  const mfuOffset = layout.mfuOffset\n  const dataEnd = layout.dataEnd\n\n  const mfuDuHeader =\n    mfuDuHeaderPresent && mpu.timedFlag === 1\n      ? parseTimedMfuDuHeader(payload, MPU_HEADER_SIZE)\n      : null\n  const itemId =\n    mfuDuHeaderPresent && mpu.timedFlag === 0\n      ? new DataView(payload.buffer, payload.byteOffset + MPU_HEADER_SIZE, 4).getUint32(0, false)\n      : null\n\n  const data = payload.subarray(mfuOffset, dataEnd)\n\n  const fecPayloadId = trailerLayout.hasFecId\n    ? {\n        ssId: new DataView(\n          mmtpPacket.buffer,\n          mmtpPacket.byteOffset + mmtpPacket.length - SOURCE_FEC_PAYLOAD_ID_SIZE,\n          SOURCE_FEC_PAYLOAD_ID_SIZE,\n        ).getUint32(0, false),\n      }\n    : null\n\n  return { header, mpu, fragmentType, data, mfuDuHeader, itemId, fecPayloadId }\n}\n\n/**\n * Extract timestamp from MMTP packet\n */\nexport function extractTimestamp(mmtpPacket: Uint8Array): bigint {\n  const { header } = unwrapMMTP(mmtpPacket)\n  return header.timestamp\n}\n\n/**\n * Check if MMTP packet is an FEC repair packet\n * FEC_type 2 and 3 are repair packets\n */\nexport function isFecRepairPacket(mmtpPacket: Uint8Array): boolean {\n  if (mmtpPacket.length < 1) return false\n  const fecType = (mmtpPacket[0]! >> 3) & 0x03\n  return fecType >= 2\n}\n\n/**\n * Extract Source FEC Payload ID (SS_ID) from the last 4 bytes of an MMTP\n * source packet per ISO/IEC 23008-1:2023 Section C.5.2 Figure C.10.\n *\n * SS_ID is a flat 32-bit monotonic counter (incremented by 1 per packet\n * for ssbg_mode0 and ssbg_mode1).  Block membership and ESI are derived\n * at recovery time from repair packet SS_Start and SSB_length:\n *   SBN = floor(SS_ID / K),  ESI = SS_ID % K\n *   SS_Start = SBN * K  (first SS_ID of the block)\n *\n * This matches FFmpeg moqenc_mmt.c, the drafts (draft-ramadan-moq-fec \u00A76.2),\n * and ATSC A/331 \u00A78.1.2.5 which defers to ISO 23008-1 Annex C.\n */\nexport function extractFecPayloadId(mmtpPacket: Uint8Array): { ssId: number } | null {\n  if (!hasSourceFecPayloadId(mmtpPacket)) return null\n  // Flat 4-byte SS_ID: encoder writes block_id * K + symbol_id\n  const off = mmtpPacket.length - SOURCE_FEC_PAYLOAD_ID_SIZE\n  const view = new DataView(\n    mmtpPacket.buffer,\n    mmtpPacket.byteOffset + off,\n    SOURCE_FEC_PAYLOAD_ID_SIZE,\n  )\n  return { ssId: view.getUint32(0, false) }\n}\n\n/**\n * Return true when FEC_type=1 and the exact suffix after the ISO-declared MPU\n * payload contains a four-byte Source FEC Payload ID.\n */\nexport function hasSourceFecPayloadId(mmtpPacket: Uint8Array): boolean {\n  if (mmtpPacket.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE) return false\n\n  let header: MMTPHeader\n  try {\n    header = parseMMTPHeader(mmtpPacket)\n  } catch {\n    return false\n  }\n  if (header.packetType !== PACKET_TYPE_MPU) return false\n\n  const payload = mmtpPacket.subarray(header.headerLength)\n  if (payload.length < MPU_HEADER_SIZE) return false\n  const mpu = parseMPUHeader(payload)\n  if (mpu.payloadLength < MPU_HEADER_REMAINDER_SIZE) return false\n  const declaredEnd = MPU_LENGTH_FIELD_SIZE + mpu.payloadLength\n  return resolveDeclaredTrailers(payload, declaredEnd, header.fecType)?.hasFecId ?? false\n}\n\n/**\n * MMTP header-extension ext_type assigned to the detached ALTA authenticator\n * trailer (Path 2 / 08-07). Carried in an `[ext_type][ext_length][auth]`\n * block appended after the MPU's declared payload bytes, before the 4-byte\n * Source FEC Payload ID. MMTP X-bit stays 0 \u2014 non-ALTA MMTP receivers treat\n * the trailer as bytes past `payload_length` and skip it (per ISO 23008-1\n * \u00A79.2.2 \"may be discarded without impacting correct processing\").\n */\n// Re-export the ALTA trailer helper from the zero-dep leaf package. The leaf\n// owns the implementation so container and FEC consumers share one parser\n// without creating a package cycle.\nexport const MMTP_EXT_TYPE_ALTA_AUTH = _LEAF_MMTP_EXT_TYPE_ALTA_AUTH\nexport const MMTP_EXT_TRAILER_HEADER_SIZE = _LEAF_MMTP_EXT_TRAILER_HEADER_SIZE\nexport type AltaTrailer = _LeafAltaTrailer\nexport const extractAltaTrailer = _leafExtractAltaTrailer\n\n/** Size of Repair FEC Payload ID per ISO/IEC 23008-1 Section C.5.3 */\nexport const REPAIR_FEC_PID_SIZE = 13\n\n/** Parse the 13-byte Repair FEC Payload ID after the complete dynamic MMTP header. */\nfunction readRepairFecPayloadIdFields(mmtpPacket: Uint8Array): {\n  packetId: number; ssStart: number; rsbLength: number; rsId: number; ssbLength: number; dataOffset: number\n} | null {\n  let header: MMTPHeader\n  try {\n    header = parseMMTPHeader(mmtpPacket)\n  } catch {\n    return null\n  }\n  if (header.packetType !== PACKET_TYPE_REPAIR || header.fecType !== 2) return null\n\n  const off = header.headerLength\n  if (mmtpPacket.length < off + REPAIR_FEC_PID_SIZE) return null\n  const view = new DataView(mmtpPacket.buffer, mmtpPacket.byteOffset + off, REPAIR_FEC_PID_SIZE)\n  const ssStart = view.getUint32(0, false)  // 32 bits\n  const rsbLength = (mmtpPacket[off + 4]! << 16) | (mmtpPacket[off + 5]! << 8) | mmtpPacket[off + 6]!  // 24 bits\n  const rsId = (mmtpPacket[off + 7]! << 16) | (mmtpPacket[off + 8]! << 8) | mmtpPacket[off + 9]!  // 24 bits\n  const ssbLength = (mmtpPacket[off + 10]! << 16) | (mmtpPacket[off + 11]! << 8) | mmtpPacket[off + 12]!  // 24 bits\n  return {\n    packetId: header.packetId,\n    ssStart,\n    rsbLength,\n    rsId,\n    ssbLength,\n    dataOffset: off + REPAIR_FEC_PID_SIZE,\n  }\n}\n\n/**\n * Extract Repair FEC Payload ID from a raw-multicast MMTP repair packet.\n * Per ISO/IEC 23008-1:2023 Section C.5.3 (ssbg_mode0, one-stage, no FFSRP_TS):\n *   [MMTP header][SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][repair data]\n * OTI is delivered via AL-FEC signaling message (Table C.3), not per-packet.\n *\n * Byte 1 is reserved(2)|packet_type(6) for V=0, so repair type 0x03 is 0x03.\n * Pre-migration high-bits bytes (0x0c) are rejected \u2014 no compatibility decode.\n */\nexport function extractRepairFecPayloadId(mmtpPacket: Uint8Array): {\n  ssStart: number; rsbLength: number; rsId: number; ssbLength: number\n} | null {\n  const fields = readRepairFecPayloadIdFields(mmtpPacket)\n  if (!fields) return null\n  return {\n    ssStart: fields.ssStart,\n    rsbLength: fields.rsbLength,\n    rsId: fields.rsId,\n    ssbLength: fields.ssbLength,\n  }\n}\n\n/** Parsed MoQ repair frame per ISO/IEC 23008-1 Section C.4.3 + C.5.3 */\nexport interface MoqRepairFrame {\n  /** MMTP packetId (1=video, 2=audio) \u2014 for routing to correct FEC decoder */\n  packetId: number\n  /** SS_Start (32 bits): SS_ID of first source symbol in block */\n  ssStart: number\n  /** RSB_length (24 bits): number of repair symbols (P) */\n  rsbLength: number\n  /** RS_ID (24 bits): repair symbol index (0-based) */\n  rsId: number\n  /** SSB_length (24 bits): number of source symbols (K) */\n  ssbLength: number\n  /** Repair symbol data after the dynamic MMTP header and 13-byte FEC payload ID. */\n  symbolData: Uint8Array\n}\n\n/**\n * Parse a MoQ repair frame (ISO/IEC 23008-1 Annex C format).\n *\n * Wire format per ISO 23008-1 \u00A7C.4.3 + \u00A7C.5.3:\n *   MMTP Header: fixed 12 bytes plus C/X optional fields\n *   then SS_Start (4 bytes) \u2192 block identifier\n *   then RSB_length (3 bytes) \u2192 P\n *   then RS_ID (3 bytes) \u2192 ESI = K + RS_ID\n *   then SSB_length (3 bytes) \u2192 K\n *   then Repair Symbol Data (T bytes)\n *\n * @param frame - Raw MoQ repair frame bytes\n * @returns Parsed frame or null if invalid\n */\nexport function parseMoqRepairFrame(frame: Uint8Array): MoqRepairFrame | null {\n  const repairId = readRepairFecPayloadIdFields(frame)\n  if (!repairId) return null\n\n  const symbolData = frame.subarray(repairId.dataOffset)\n  if (\n    repairId.rsbLength === 0 ||\n    repairId.ssbLength === 0 ||\n    repairId.rsId >= repairId.rsbLength ||\n    symbolData.length === 0\n  ) return null\n\n  return {\n    packetId: repairId.packetId,\n    ssStart: repairId.ssStart,\n    rsbLength: repairId.rsbLength,\n    rsId: repairId.rsId,\n    ssbLength: repairId.ssbLength,\n    symbolData,\n  }\n}\n\n/**\n * AL-FEC signaling configuration parsed from ISO/IEC 23008-1:2023 Table C.3 message.\n */\nexport interface AlFecConfig {\n  fecCodeId: number\n  fecPayloadIdMode: 0\n  repairSymbolSize: number\n  maximumK: number\n  maximumP: number\n  interleaveDepth: number\n  oti: Uint8Array\n}\n\nfunction canonicalRaptorQOtiK(oti: Uint8Array, repairSymbolSize: number): number | null {\n  if (oti.length !== 12 || oti[5] !== 0) return null\n  const transferLength = (oti[0]! * 0x1_0000_0000) +\n    (((oti[1]! << 24) | (oti[2]! << 16) | (oti[3]! << 8) | oti[4]!) >>> 0)\n  const symbolSize = (oti[6]! << 8) | oti[7]!\n  const sourceBlocks = oti[8]!\n  const subBlocks = (oti[9]! << 8) | oti[10]!\n  const alignment = oti[11]!\n  if (!Number.isSafeInteger(transferLength) || transferLength <= 0 ||\n      symbolSize !== repairSymbolSize || symbolSize === 0 || symbolSize % 8 !== 0 ||\n      sourceBlocks !== 1 || subBlocks !== 1 || alignment !== 8 ||\n      transferLength % symbolSize !== 0) {\n    return null\n  }\n  const k = transferLength / symbolSize\n  return Number.isInteger(k) && k >= 1 && k <= 56_403 ? k : null\n}\n\n/**\n * Parse AL-FEC signaling message from a full MMTP signaling packet.\n *\n * Wire format (ISO/IEC 23008-1:2023 Table C.3, Amendment 1:2025):\n *   [12-byte MMTP header (packet_type=0x02)]\n *   message_id(2)        = 0x0203\n *   version(1)\n *   message_length(2)    = length of remaining payload\n *   flags(1)             = fec_flag(1) | private_fec_flag(1) | reserved(6)\n *   fec_flow_descriptor:\n *     length(2)\n *     num_flows(1)\n *     per flow:\n *       fec_flow_id(1), source_flow_id(1), num_assets(1), packet_ids(2*N),\n *       coding_params(1), repair_symbol_size(2),\n *       [one-stage]: repair_flow_id(2), fec_code_id(1),\n *       [private_fec_flag]: private_header(1){flag(1)|len(7)},\n *         current RaptorQ profile OTI(12) + interleave_depth(1)\n *       max_k(3), max_p(3), protection_window_time(4), protection_window_size(4)\n *\n * @param mmtpPacket Full MMTP packet including 12-byte header\n * @returns Parsed config or null if not an AL-FEC signaling message\n */\nexport function parseAlFecMessage(mmtpPacket: Uint8Array): AlFecConfig | null {\n  if (mmtpPacket.length < MMTP_HEADER_SIZE + 9) return null\n  let header: MMTPHeader\n  try {\n    header = parseMMTPHeader(mmtpPacket)\n  } catch {\n    return null\n  }\n  if (header.packetType !== PACKET_TYPE_SIGNALING || header.fecType !== 0) return null\n  const payload = mmtpPacket.subarray(header.headerLength)\n  if (payload.length < 9) return null\n  const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength)\n  let off = 0\n\n  const messageId = view.getUint16(off, false); off += 2\n  if (messageId !== ALFEC_MESSAGE_ID) return null\n  const version = payload[off]!; off += 1\n  const messageLength = view.getUint16(off, false); off += 2\n  if (version !== 1 || messageLength === 0 || messageLength !== payload.length - off) return null\n\n  const flags = payload[off]!; off += 1\n  const fecFlag = (flags >> 7) & 1\n  const privateFecFlag = (flags >> 6) & 1\n  if (fecFlag !== 1 || privateFecFlag !== 1 || (flags & 0x3f) !== 0x3f) return null\n\n  if (off + 2 > payload.length) return null\n  const descriptorLength = view.getUint16(off, false); off += 2\n  const descriptorEnd = off + descriptorLength\n  if (descriptorLength === 0 || descriptorEnd !== payload.length) return null\n\n  const numFlows = payload[off]!; off += 1\n  if (numFlows !== 1 || off + 3 > descriptorEnd) return null\n\n  off += 2 // fec_flow_id, source_flow_id\n  const numAssets = payload[off]!; off += 1\n  if (numAssets === 0 || off + (numAssets * 2) > descriptorEnd) return null\n  off += numAssets * 2\n\n  if (off + 3 > descriptorEnd) return null\n  const codingParams = payload[off]!; off += 1\n  const fecCodingStructure = (codingParams >> 4) & 0x0f\n  const ssbgMode = (codingParams >> 2) & 0x03\n  const ffsrptsFlag = (codingParams >> 1) & 0x01\n  const fecPayloadIdMode = codingParams & 0x01\n  if (fecCodingStructure !== 1 || ssbgMode !== 0 || ffsrptsFlag !== 0 || fecPayloadIdMode !== 0) {\n    return null\n  }\n  const repairSymbolSize = view.getUint16(off, false); off += 2\n  if (repairSymbolSize === 0 || repairSymbolSize % 8 !== 0) return null\n\n  if (off + 4 > descriptorEnd) return null\n  off += 2 // Amendment 1:2025 replaces Table C.3 with a 16-bit repair_flow_id\n  const fecCodeId = payload[off]!; off += 1\n  if (fecCodeId !== FEC_CODE_RAPTORQ) return null\n  const privateHeader = payload[off]!; off += 1\n  const privateFlag = privateHeader >> 7\n  const privateFieldLength = privateHeader & 0x7f\n  if (privateFlag !== 1 || privateFieldLength !== 13 || off + 13 > descriptorEnd) return null\n  const oti = payload.slice(off, off + 12); off += 12\n  const interleaveDepth = payload[off]!; off += 1\n  const otiK = canonicalRaptorQOtiK(oti, repairSymbolSize)\n  if (otiK === null || interleaveDepth === 0) return null\n\n  if (off + 14 !== descriptorEnd) return null\n  const maximumK = (payload[off]! << 16) | (payload[off + 1]! << 8) | payload[off + 2]!\n  off += 3\n  const maximumP = (payload[off]! << 16) | (payload[off + 1]! << 8) | payload[off + 2]!\n  off += 3\n  if (maximumK !== otiK || maximumP === 0 || maximumK + maximumP - 1 > 0x00ff_ffff) {\n    return null\n  }\n  off += 8 // protection_window_time, protection_window_size\n  if (off !== descriptorEnd) return null\n\n  return { fecCodeId, fecPayloadIdMode, repairSymbolSize, maximumK, maximumP, interleaveDepth, oti }\n}\n", "/**\n * Thin transport wrapper for SSM multicast \u2014 join, socket, watchdog,\n * takeover/failback.  Delegates raw packets to a callback (MmtpRouter\n * or any direct consumer).\n */\n\nimport type {\n  WindowMulticastGateway,\n  WindowMulticastResolvedTransport,\n  WindowMulticastSubscription,\n} from '@blockcast/mmt-transport'\nimport { parseMMTPHeader } from '@blockcast/mmt-base'\n\nexport interface MulticastTransportConfig {\n  sourceAddress: string\n  groupAddress: string\n  port: number\n  mode?: 'auto' | 'native' | 'tunnel'\n  amtRelay?: string\n  amtRelayPort?: number\n  packetIds?: number[]\n  tracks?: { name: string; packetId: number }[]\n}\n\nexport type ResolvedMulticastTransport = WindowMulticastResolvedTransport\n\n/**\n * Receive counters plus the ingress-filter drop counters.\n *\n * `packetsReceived` / `bytesReceived` count only packets that passed the\n * allow-list and were handed to the page \u2014 a rejected packet must never\n * inflate them.  The `dropped*` counters are the other half of that story:\n * without them a filtered PID is indistinguishable from a PID that was never\n * transmitted, which is exactly the ambiguity that makes an all-zero FEC\n * repair count unreadable (a repair leg dropped here and a repair leg the\n * publisher never sent produce byte-identical downstream telemetry).\n */\nexport interface MulticastTransportStats {\n  packetsReceived: number\n  bytesReceived: number\n  /** Parsed cleanly, but the packet ID is absent from the join's allow-list. */\n  packetsDroppedUnregisteredPid: number\n  /** MMTP header did not parse; the packet ID is unknown, so it cannot be attributed. */\n  packetsDroppedUnparseable: number\n}\n\n/**\n * Distinct unregistered PIDs retained for diagnostics.  A conformant catalog\n * advertises a handful of PIDs per endpoint, so this only has to be large\n * enough to name every leg of a mis-provisioned one; the cap exists so a\n * malformed or hostile stream cycling the 16-bit PID space cannot grow the map\n * without bound.  Drops keep counting in aggregate after the cap.\n */\nconst MAX_TRACKED_DROPPED_PIDS = 16\n\ntype MulticastGlobals = typeof globalThis & {\n  multicast?: WindowMulticastGateway\n}\n\nfunction getMulticastGlobals(): MulticastGlobals {\n  return globalThis as MulticastGlobals\n}\n\nfunction hasMulticastGateway(): boolean {\n  return typeof getMulticastGlobals().multicast?.subscribe === 'function'\n}\n\nfunction normalizeResolvedTransport(value: unknown): ResolvedMulticastTransport | undefined {\n  if (value === 'native') return 'native'\n  if (value === 'amt') return 'amt'\n  return undefined\n}\n\nexport class MulticastTransport<TPacketContext = never> {\n  #onPacket: (packet: Uint8Array, context?: TPacketContext) => void\n  #subscription: WindowMulticastSubscription | null = null\n  #bytesListener: ((event: CustomEvent<ArrayBuffer>) => void) | null = null\n  #transportListener: ((event: CustomEvent<ResolvedMulticastTransport>) => void) | null = null\n  #resolvedTransport: ResolvedMulticastTransport | undefined\n  #videoConfirmed = false\n  #audioConfirmed = false\n  #watchdog: ReturnType<typeof setTimeout> | null = null\n  #failbackWindowMs: number | null = null\n  #onTakeover: (() => void) | null = null\n  #onFailback: (() => void) | null = null\n  #disposed = false\n  #stats: MulticastTransportStats = {\n    packetsReceived: 0,\n    bytesReceived: 0,\n    packetsDroppedUnregisteredPid: 0,\n    packetsDroppedUnparseable: 0,\n  }\n  #droppedPidCounts = new Map<number, number>()\n  #packetIds: ReadonlySet<number> | null = null\n  #joinGeneration = 0\n\n  constructor(onPacket: (packet: Uint8Array, context?: TPacketContext) => void) {\n    this.#onPacket = onPacket\n  }\n\n  static isAvailable(): boolean {\n    return hasMulticastGateway()\n  }\n\n  async join(config: MulticastTransportConfig, context?: TPacketContext): Promise<boolean> {\n    const generation = ++this.#joinGeneration\n    this.#releaseSubscription()\n\n    if (this.#disposed) return false\n    if (!MulticastTransport.isAvailable()) {\n      console.warn('[MulticastTransport] Multicast API not available')\n      return false\n    }\n\n    try {\n      const packetIds = config.packetIds?.length ? new Set(config.packetIds) : null\n      console.log(\n        `[MulticastTransport] window.multicast.subscribe(${config.sourceAddress}, ${config.groupAddress}, ${config.port})`,\n      )\n      const subscription = await getMulticastGlobals().multicast!.subscribe!({\n        source: config.sourceAddress,\n        group: config.groupAddress,\n        port: config.port,\n        consume: 'bytes',\n        mode: config.mode,\n        amtRelay: config.amtRelay,\n        amtRelayPort: config.amtRelayPort,\n        packetIds: config.packetIds,\n        tracks: config.tracks?.map(({ name, packetId }) => ({ name, packetId })),\n      })\n      console.log(`[MulticastTransport] window.multicast.subscribe returned:`, !!subscription)\n\n      if (this.#disposed || generation !== this.#joinGeneration) {\n        void subscription.unsubscribe()\n        return false\n      }\n      if (typeof subscription.addEventListener !== 'function') {\n        if (typeof subscription.unsubscribe === 'function') {\n          void subscription.unsubscribe()\n        }\n        throw new Error('window.multicast subscription does not support bytes events')\n      }\n\n      const onBytes = (event: CustomEvent<ArrayBuffer>) => {\n        if (this.#disposed || generation !== this.#joinGeneration) return\n        const detail = event.detail\n        const packet = detail instanceof Uint8Array ? detail : new Uint8Array(detail)\n        if (!this.#acceptPacket(packet)) return\n        this.#stats.packetsReceived++\n        this.#stats.bytesReceived += packet.byteLength\n        this.#onPacket(packet, context)\n        this.#resetWatchdog()\n      }\n      const onTransportChange = (event: CustomEvent<ResolvedMulticastTransport>) => {\n        if (this.#disposed || generation !== this.#joinGeneration) return\n        const transport = normalizeResolvedTransport(event.detail)\n        if (transport) this.#resolvedTransport = transport\n      }\n      this.#subscription = subscription\n      this.#bytesListener = onBytes\n      this.#transportListener = onTransportChange\n      this.#packetIds = packetIds\n      this.#resolvedTransport = normalizeResolvedTransport(subscription.transport)\n      subscription.addEventListener('bytes', onBytes)\n      subscription.addEventListener('transportchange', onTransportChange)\n      this.#resetWatchdog()\n      console.log(\n        `[MulticastTransport] Joined ${config.groupAddress}:${config.port}`,\n      )\n      return true\n    } catch (err) {\n      if (this.#disposed || generation !== this.#joinGeneration) return false\n      this.#releaseSubscription()\n      console.error('[MulticastTransport] Failed to join SSM group:', err)\n      return false\n    }\n  }\n\n  /** Feed a raw packet from an external source (e.g., AMT tunnel or ASM subscription). */\n  feedPacket(data: ArrayBuffer | Uint8Array, context?: TPacketContext): void {\n    if (this.#disposed) return\n    const packet = data instanceof Uint8Array ? data : new Uint8Array(data)\n    if (!this.#acceptPacket(packet)) return\n    this.#stats.packetsReceived++\n    this.#stats.bytesReceived += packet.byteLength\n    this.#onPacket(packet, context)\n    this.#resetWatchdog()\n  }\n\n  confirmVideo(): void {\n    this.#videoConfirmed = true\n    this.#checkTakeover()\n  }\n\n  confirmAudio(): void {\n    this.#audioConfirmed = true\n    this.#checkTakeover()\n  }\n\n  onTakeover(cb: () => void): void {\n    this.#onTakeover = cb\n  }\n\n  onFailback(cb: () => void): void {\n    this.#onFailback = cb\n  }\n\n  setFailbackWindowMs(windowMs: number): void {\n    if (!Number.isFinite(windowMs) || windowMs <= 0) {\n      throw new Error(\n        `[MulticastTransport] failbackWindowMs=${windowMs}. ` +\n        `Derive a positive failback window from the stream catalog.`,\n      )\n    }\n    this.#failbackWindowMs = windowMs\n  }\n\n  get stats(): MulticastTransportStats {\n    return this.#stats\n  }\n\n  /**\n   * Per-PID drop breakdown, newest-capped at MAX_TRACKED_DROPPED_PIDS distinct\n   * PIDs.  This is what names the offender: `packetsDroppedUnregisteredPid`\n   * says the ingress filter fired, this says it fired on 0x8001.\n   */\n  get droppedPacketIds(): ReadonlyMap<number, number> {\n    return this.#droppedPidCounts\n  }\n\n  get resolvedTransport(): ResolvedMulticastTransport | undefined {\n    return this.#resolvedTransport\n  }\n\n  dispose(): void {\n    ++this.#joinGeneration\n    this.#disposed = true\n    this.#releaseSubscription()\n  }\n\n  #releaseSubscription(): void {\n    if (this.#watchdog) clearTimeout(this.#watchdog)\n    this.#watchdog = null\n    if (this.#subscription) {\n      if (this.#bytesListener) {\n        this.#subscription.removeEventListener('bytes', this.#bytesListener)\n      }\n      if (this.#transportListener) {\n        this.#subscription.removeEventListener('transportchange', this.#transportListener)\n      }\n      void this.#subscription.unsubscribe()\n    }\n    this.#subscription = null\n    this.#bytesListener = null\n    this.#transportListener = null\n    this.#resolvedTransport = undefined\n    this.#packetIds = null\n  }\n\n  #acceptPacket(packet: Uint8Array): boolean {\n    if (!this.#packetIds) return true\n    let packetId: number\n    try {\n      // This early parse is intentional: rejected PIDs must not affect page\n      // delivery, receive statistics, or the failback liveness watchdog.\n      packetId = parseMMTPHeader(packet).packetId\n    } catch {\n      this.#stats.packetsDroppedUnparseable++\n      return false\n    }\n    if (this.#packetIds.has(packetId)) return true\n    this.#recordUnregisteredPidDrop(packetId)\n    return false\n  }\n\n  #recordUnregisteredPidDrop(packetId: number): void {\n    this.#stats.packetsDroppedUnregisteredPid++\n    const seen = this.#droppedPidCounts.get(packetId)\n    if (seen !== undefined) {\n      this.#droppedPidCounts.set(packetId, seen + 1)\n      return\n    }\n    if (this.#droppedPidCounts.size >= MAX_TRACKED_DROPPED_PIDS) return\n    this.#droppedPidCounts.set(packetId, 1)\n    // Warn once per distinct PID. A PID arriving on the wire but missing from\n    // the catalog's advertised set is a provisioning fault, not stream noise,\n    // and it is silent in every downstream counter.\n    console.warn(\n      `[MulticastTransport] Dropping packetId=${packetId} (0x${packetId.toString(16)}): ` +\n      `not in the advertised set [${[...this.#packetIds!].join(', ')}]. ` +\n      `If this is an FEC repair leg, the catalog is not advertising its packetId.`,\n    )\n  }\n\n  #checkTakeover(): void {\n    if (this.#videoConfirmed && this.#audioConfirmed && this.#onTakeover) {\n      const cb = this.#onTakeover\n      this.#onTakeover = null // fire exactly once\n      cb()\n    }\n  }\n\n  #resetWatchdog(): void {\n    if (this.#watchdog) clearTimeout(this.#watchdog)\n    if (!this.#onFailback) return\n    if (this.#failbackWindowMs === null) {\n      throw new Error(\n        '[MulticastTransport] Failback watchdog requires a catalog-derived window',\n      )\n    }\n    this.#watchdog = setTimeout(() => {\n      if (!this.#disposed && this.#onFailback) {\n        console.warn(\n          `[MulticastTransport] No packets for ${this.#failbackWindowMs}ms; failing back to MoQ`,\n        )\n        this.#onFailback()\n      }\n    }, this.#failbackWindowMs)\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["MPU_HEADER_SIZE", "MPU_LENGTH_FIELD_SIZE", "MPU_HEADER_REMAINDER_SIZE", "MPU_HEADER_SIZE"]
+}

package/dist/multicast-unwrap.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @mmt/container - Container-aware multicast MMTP unwrapper
+ *
+ * Dispatches raw multicast MMTP packets into typed media or Annex C repair
+ * frames. Handles FEC source payload ID extraction and repair packet parsing.
+ *
+ * @packageDocumentation
+ */
+import { type MMTPHeader, type MFUExtraction } from '@blockcast/mmt-base';
+/** The immutable reader contract selected by a multicast consumer. */
+export interface MulticastContainerContract {
+    version: 1;
+    kind: 'mmtp';
+}
+export type MulticastContainerErrorCode = 'unsupported_version' | 'unsupported_kind' | 'ambiguous_kind' | 'malformed_selector';
+/** Versioned, fail-closed contract selection error. */
+export declare class MulticastContainerContractError extends TypeError {
+    readonly version = 1;
+    readonly code: MulticastContainerErrorCode;
+    constructor(code: MulticastContainerErrorCode, detail: string);
+}
+/** Validate the only reader currently frozen by the container contract. */
+export declare function validateMulticastContainerContract(contract: unknown): MulticastContainerContract;
+/** Source FEC Payload ID — flat 32-bit SS_ID per ISO 23008-1 §C.5.2 */
+export interface FecPayloadId {
+    ssId: number;
+}
+/** Discriminated union of unwrapped multicast frames */
+export type MulticastFrame = {
+    kind: 'mmtp';
+    header: MMTPHeader;
+    mfu: MFUExtraction;
+    fecId: FecPayloadId | null;
+} | {
+    kind: 'repair';
+    header: MMTPHeader;
+    ssStart: number;
+    rsbLength: number;
+    rsId: number;
+    ssbLength: number;
+    data: Uint8Array;
+};
+/**
+ * Unwrap a raw MMTP multicast packet into a typed MulticastFrame.
+ *
+ * This function handles MMTP-framed multicast only (container 0x01). The
+ * versioned contract is validated before any packet bytes are parsed, so an
+ * unsupported version or container kind fails closed rather than being
+ * reinterpreted under a reader that does not match the wire format.
+ *
+ * @param packet - Raw MMTP packet bytes from multicast UDP
+ * @param contract - Required `multicast-container/v1` selector
+ * @throws {MulticastContainerContractError} if the selector is absent or unsupported
+ * @returns Parsed frame, or null if the packet is too small / malformed
+ */
+export declare function unwrapMulticastPacket(packet: Uint8Array, contract: unknown): MulticastFrame | null;
+//# sourceMappingURL=multicast-unwrap.d.ts.map

package/dist/multicast-unwrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicast-unwrap.d.ts","sourceRoot":"","sources":["../src/multicast-unwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAOnB,MAAM,qBAAqB,CAAA;AAE5B,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,2BAA2B,GACnC,qBAAqB,GACrB,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB,CAAA;AAExB,uDAAuD;AACvD,qBAAa,+BAAgC,SAAQ,SAAS;IAC5D,QAAQ,CAAC,OAAO,KAAI;IACpB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;gBAE9B,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM;CAK9D;AAED,2EAA2E;AAC3E,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,OAAO,GAChB,0BAA0B,CAgB5B;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wDAAwD;AACxD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GACpF;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,UAAU,CAAA;CACjB,CAAA;AAEL;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,OAAO,GAChB,cAAc,GAAG,IAAI,CAgCvB"}