@blockcast/mmt-container 0.1.0 → 0.3.0

package/node_modules/@blockcast/mmt-fec/dist/block-processor.d.ts

@@ -0,0 +1,106 @@
+/**
+ * FEC Block Processor
+ *
+ * Splits decoded FEC blocks (K symbols concatenated by WASM RaptorQ decoder)
+ * into individual MFU fragments ready for reassembly and decoding.
+ *
+ * Extracted from moqtail.html's inline processFecBlock() for reuse across
+ * both moq-lib and moqtail players. Pure function — no side effects.
+ */
+import { type FecBlockProfile } from "@blockcast/mmt-base";
+/** A single parsed symbol from a decoded FEC block */
+export interface ParsedFecSymbol {
+    /** Symbol index within the block (0..K-1) */
+    index: number;
+    /** MMTP packet ID (1=video, 2=audio) */
+    packetId: number;
+    /** MMTP packet sequence number (for dedup across delivery paths) */
+    packetSequenceNumber: number;
+    /** MPU fragment_type: 0=init (ftyp+moov), 2=MFU data */
+    fragmentType: number;
+    /** MFU fragment ready for MFUReassembler.addFragment() */
+    fragment: {
+        mpuSequenceNumber: number;
+        fragmentationIndicator: number;
+        fragmentCounter: number;
+        data: Uint8Array;
+        timestamp: bigint;
+        rapFlag: boolean;
+        priority?: number;
+        sampleNumber?: number;
+        movieFragmentSequenceNumber?: number;
+        sampleOffset?: number;
+        itemId?: number;
+    };
+    /** Whether this symbol carries keyframe metadata (RAP or high MFU priority). */
+    isKeyframe: boolean;
+    /** Raw symbol data (needed for audio decode path) */
+    rawSymbol: Uint8Array;
+}
+/** Result of processing a decoded FEC block */
+export interface ProcessFecBlockResult {
+    /** All valid parsed symbols for the owning track, sorted by serial packet sequence. */
+    symbols: ParsedFecSymbol[];
+    /** Count of symbols that failed to parse */
+    failedCount: number;
+    /** Failure reasons keyed by category */
+    failReasons: Record<string, number>;
+}
+/** Options for {@link processFecSymbol}. */
+export interface ProcessFecSymbolOptions {
+    /**
+     * The stream's catalog `fec.blockProfile`. Required, never defaulted: the
+     * two profiles lay a packet into a symbol differently, so the same
+     * recovered bytes trim to different packets under each.
+     */
+    blockProfile: FecBlockProfile;
+    /** Symbol index within the block, used only for diagnostics. */
+    index?: number;
+    /** Keep only symbols for this packetId. */
+    ownerPacketId?: number;
+}
+/** Options for {@link processFecBlock}. */
+export interface ProcessFecBlockOptions {
+    /** The stream's catalog `fec.blockProfile`; see {@link ProcessFecSymbolOptions.blockProfile}. */
+    blockProfile: FecBlockProfile;
+    /** Symbol size T in bytes (catalog `fec.symbolSize`). Required: there is no default T. */
+    symbolSize: number;
+    /**
+     * Source symbols in the decoded block: K under `k-padded-v1`, SSB_length
+     * under `iso-ssbg1-v1`. When omitted the block must be a whole number of
+     * T-byte symbols and K is that number; a partial symbol throws.
+     */
+    k?: number;
+    /** Keep only symbols for this packetId. */
+    ownerPacketId?: number;
+}
+/**
+ * Parse one recovered FEC source symbol into an MFU fragment.
+ *
+ * The symbol is laid out by the stream's block profile: under `k-padded-v1`
+ * it is the protected MMTP packet zero-padded to T; under `iso-ssbg1-v1` it is
+ * the ssbg_mode1 `u16 length || packet || zero padding`. Either way the
+ * recovered packet is then parsed identically. Failures are counted by reason
+ * (`bad_ssbg1_length` is the ISO length/padding refusal), never thrown.
+ *
+ * @throws when `options.blockProfile` is absent or not a known profile token.
+ */
+export declare function processFecSymbol(symbolData: Uint8Array, options: ProcessFecSymbolOptions): ProcessFecBlockResult;
+/**
+ * Process a decoded FEC block into individual MFU fragments.
+ *
+ * The WASM RaptorQ decoder returns every source symbol of the block
+ * concatenated (K x T bytes under `k-padded-v1`, SSB_length x T bytes under
+ * `iso-ssbg1-v1`). This function splits them apart, recovers each protected
+ * packet by the stream's block profile (see {@link processFecSymbol}),
+ * extracts the MFU payload via shared extractMFUPayload, and returns
+ * structured results sorted for reassembly.
+ *
+ * @param blockData - Concatenated source symbols from the WASM decoder
+ * @param options - Block profile and symbol size T are required; see {@link ProcessFecBlockOptions}
+ * @throws when the block profile or symbol size is absent or invalid, when an
+ *   omitted `k` cannot be read exactly from the block length, or when an
+ *   `iso-ssbg1-v1` block is not exactly `k` symbols long.
+ */
+export declare function processFecBlock(blockData: Uint8Array, options: ProcessFecBlockOptions): ProcessFecBlockResult;
+//# sourceMappingURL=block-processor.d.ts.map

package/node_modules/@blockcast/mmt-fec/dist/block-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-processor.d.ts","sourceRoot":"","sources":["../src/block-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAWN,KAAK,eAAe,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC/B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,EAAE;QACT,iBAAiB,EAAE,MAAM,CAAC;QAC1B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,UAAU,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,SAAS,EAAE,UAAU,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACrC,uFAAuF;IACvF,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACvC;;;;OAIG;IACH,YAAY,EAAE,eAAe,CAAC;IAC9B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACtC,iGAAiG;IACjG,YAAY,EAAE,eAAe,CAAC;IAC9B,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AA8MD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,uBAAuB,GAC9B,qBAAqB,CA8BvB;AA4CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,sBAAsB,GAC7B,qBAAqB,CAgCvB"}

package/node_modules/@blockcast/mmt-fec/dist/block-processor.js

@@ -0,0 +1,288 @@
+/**
+ * FEC Block Processor
+ *
+ * Splits decoded FEC blocks (K symbols concatenated by WASM RaptorQ decoder)
+ * into individual MFU fragments ready for reassembly and decoding.
+ *
+ * Extracted from moqtail.html's inline processFecBlock() for reuse across
+ * both moq-lib and moqtail players. Pure function — no side effects.
+ */
+import { MMTP_EXT_TRAILER_HEADER_SIZE, MMTP_EXT_TYPE_ALTA_AUTH, MMTP_HEADER_SIZE, MPU_HEADER_SIZE, SSBG1_LENGTH_FIELD_BYTES, extractMFUPayload, parseFecBlockProfile, parseMPUHeader, parseMMTPHeader, trimSsbg1SourceSymbol, } from "@blockcast/mmt-base";
+function hasUniformPaddingFrom(data, start) {
+    if (start >= data.length)
+        return false;
+    const pad = data[start];
+    if (pad !== 0x00 && pad !== 0xee)
+        return false;
+    for (let i = start + 1; i < data.length; i++) {
+        if (data[i] !== pad)
+            return false;
+    }
+    return true;
+}
+function maybeExtendAltaTrailer(symbolData, packetEnd) {
+    if (packetEnd + MMTP_EXT_TRAILER_HEADER_SIZE > symbolData.length)
+        return packetEnd;
+    const view = new DataView(symbolData.buffer, symbolData.byteOffset + packetEnd, symbolData.byteLength - packetEnd);
+    const extType = view.getUint16(0, false);
+    if (extType !== MMTP_EXT_TYPE_ALTA_AUTH)
+        return packetEnd;
+    const extLen = view.getUint16(2, false);
+    const trailerEnd = packetEnd + MMTP_EXT_TRAILER_HEADER_SIZE + extLen;
+    return trailerEnd <= symbolData.length ? trailerEnd : packetEnd;
+}
+function trimDecodedSourceSymbol(symbolData) {
+    if (symbolData.length < MMTP_HEADER_SIZE + MPU_HEADER_SIZE)
+        return null;
+    const headerLength = parseMMTPHeader(symbolData).headerLength;
+    if (symbolData.length < headerLength + MPU_HEADER_SIZE)
+        return null;
+    const payload = symbolData.subarray(headerLength);
+    const mpu = parseMPUHeader(payload);
+    const trailingMpuHeaderSize = MPU_HEADER_SIZE - 2;
+    if (mpu.payloadLength < trailingMpuHeaderSize)
+        return null;
+    // Recovered source symbols are fixed-width and may be padded, but their wire
+    // boundary is still the ISO length-after-field coordinate. ALTA may extend the
+    // packet from exactly that point; no MFU-content or alternate-length guessing.
+    const declaredEnd = headerLength + 2 + mpu.payloadLength;
+    if (declaredEnd > symbolData.length)
+        return null;
+    const packetEnd = maybeExtendAltaTrailer(symbolData, declaredEnd);
+    if (packetEnd < symbolData.length && !hasUniformPaddingFrom(symbolData, packetEnd)) {
+        return null;
+    }
+    return symbolData.subarray(0, packetEnd);
+}
+function emptyProcessResult() {
+    return {
+        symbols: [],
+        failedCount: 0,
+        failReasons: {},
+    };
+}
+function isMfuKeyframeMetadata(rapFlag, priority) {
+    return rapFlag || (priority ?? 0) > 0x80;
+}
+function comparePacketSequence(a, b) {
+    // MMTP packet_sequence_number is a wrapping u32. A recovered FEC block spans
+    // far less than half the serial-number space, so the signed low 32 bits give
+    // its authored order across 0xffff_ffff -> 0. Index makes duplicate sequence
+    // values deterministic without relying on Array#sort stability.
+    const serialDelta = (a.packetSequenceNumber - b.packetSequenceNumber) | 0;
+    return serialDelta !== 0 ? serialDelta : a.index - b.index;
+}
+function resultFromSymbols(parsed, failedCount, failReasons, ownerPacketId) {
+    // Sort by wrapping packetSequenceNumber to fix FEC interleaving scramble.
+    // Reassembler needs FI=1 before FI=2/3 for the same mpuSequenceNumber.
+    parsed.sort(comparePacketSequence);
+    // When ownerPacketId is set, only keep symbols matching the track that owns
+    // this FEC block. Other packetIds (including 0 from zero-padded recovery slots)
+    // are garbage and must be rejected to prevent decoder crashes.
+    const symbols = ownerPacketId != null
+        ? parsed.filter((s) => s.packetId === ownerPacketId)
+        : parsed;
+    return { symbols, failedCount, failReasons };
+}
+/**
+ * Gate one candidate MMTP packet on its fixed header: long enough, version 0,
+ * parseable, and an MPU packet. Returns the parsed header, or null after
+ * counting why it was refused. Both profiles run this exact gate; they differ
+ * only in which bytes they hand it (the symbol under k-padded-v1, the
+ * length-delimited packet under iso-ssbg1-v1).
+ */
+function gateMpuHeader(data, bump) {
+    if (data.length < MMTP_HEADER_SIZE) {
+        bump("too_short");
+        return null;
+    }
+    if (((data[0] >> 6) & 0x03) !== 0) {
+        bump("bad_hdr");
+        return null;
+    }
+    const hdr = parseMMTPHeader(data);
+    // Only process MPU packets (packetType=0x00). Skip signaling/repair
+    // that may appear in the block due to FEC interleaving.
+    if ((hdr.packetType & 0x0f) !== 0x00) {
+        bump(`type_0x${hdr.packetType.toString(16)}`);
+        return null;
+    }
+    return hdr;
+}
+/**
+ * Parse one exact protected packet (its trimmed bytes) into a ParsedFecSymbol,
+ * or null after counting why its MFU payload was refused.
+ */
+function parseProtectedPacket(packetData, hdr, index, bump) {
+    // WASM-decoded source symbols retain fecType bits from the original FFmpeg
+    // packet (fecType=1 per draft-ramadan-moq-mmt-00 §3.1), but the 4-byte
+    // Source FEC Payload ID (ISO 23008-1 §C.5.2) is never part of the protected
+    // packet (C.4.2). Tell extractMFUPayload to skip FEC PID subtraction so it
+    // does not truncate video data; any ALTA trailer must then consume the
+    // exact suffix after the declared payload.
+    const extraction = extractMFUPayload(packetData, { skipFecId: true });
+    if (!extraction) {
+        bump("extract_fail");
+        return null;
+    }
+    return {
+        index,
+        packetId: hdr.packetId,
+        packetSequenceNumber: hdr.sequenceNumber,
+        fragmentType: extraction.fragmentType,
+        fragment: {
+            mpuSequenceNumber: extraction.mpu.mpuSequenceNumber,
+            fragmentationIndicator: extraction.mpu.fragmentationIndicator,
+            fragmentCounter: extraction.mpu.fragmentCounter,
+            data: extraction.data,
+            timestamp: hdr.timestamp,
+            rapFlag: hdr.rapFlag,
+            priority: extraction.mfuDuHeader?.priority,
+            sampleNumber: extraction.mfuDuHeader?.sampleNumber,
+            movieFragmentSequenceNumber: extraction.mfuDuHeader?.movieFragmentSequenceNumber,
+            sampleOffset: extraction.mfuDuHeader?.offset,
+            itemId: extraction.itemId ?? undefined,
+        },
+        isKeyframe: isMfuKeyframeMetadata(hdr.rapFlag, extraction.mfuDuHeader?.priority),
+        rawSymbol: packetData,
+    };
+}
+/**
+ * k-padded-v1: the symbol is the protected packet zero-padded to T with no
+ * length field, so the packet ends at its ISO-declared MPU boundary (plus an
+ * ALTA trailer starting exactly there) and the rest must be uniform padding.
+ */
+function parseKPaddedSymbol(symbolData, index, bump) {
+    const hdr = gateMpuHeader(symbolData, bump);
+    if (!hdr)
+        return null;
+    const packetData = trimDecodedSourceSymbol(symbolData);
+    if (!packetData) {
+        bump("bad_length");
+        return null;
+    }
+    return parseProtectedPacket(packetData, hdr, index, bump);
+}
+/**
+ * iso-ssbg1-v1 (ISO/IEC 23008-1 C.3.3 ssbg_mode1): the symbol is
+ * `u16be(length) || protected packet || 00h padding`. The length field alone
+ * delimits the packet; a length past the symbol or non-zero padding means the
+ * recovered symbol is not what was sent and is refused, never re-guessed.
+ */
+function parseSsbg1Symbol(symbolData, index, bump) {
+    const packetData = trimSsbg1SourceSymbol(symbolData);
+    if (!packetData) {
+        bump("bad_ssbg1_length");
+        return null;
+    }
+    const hdr = gateMpuHeader(packetData, bump);
+    if (!hdr)
+        return null;
+    return parseProtectedPacket(packetData, hdr, index, bump);
+}
+/**
+ * Parse one recovered FEC source symbol into an MFU fragment.
+ *
+ * The symbol is laid out by the stream's block profile: under `k-padded-v1`
+ * it is the protected MMTP packet zero-padded to T; under `iso-ssbg1-v1` it is
+ * the ssbg_mode1 `u16 length || packet || zero padding`. Either way the
+ * recovered packet is then parsed identically. Failures are counted by reason
+ * (`bad_ssbg1_length` is the ISO length/padding refusal), never thrown.
+ *
+ * @throws when `options.blockProfile` is absent or not a known profile token.
+ */
+export function processFecSymbol(symbolData, options) {
+    const blockProfile = parseFecBlockProfile(options?.blockProfile, "processFecSymbol options.blockProfile");
+    const failReasons = {};
+    let failedCount = 0;
+    const bump = (reason) => {
+        failedCount++;
+        failReasons[reason] = (failReasons[reason] ?? 0) + 1;
+    };
+    if (!symbolData || symbolData.length === 0)
+        return emptyProcessResult();
+    const index = options.index ?? 0;
+    let parsed;
+    try {
+        parsed = blockProfile === "iso-ssbg1-v1"
+            ? parseSsbg1Symbol(symbolData, index, bump)
+            : parseKPaddedSymbol(symbolData, index, bump);
+    }
+    catch {
+        bump("exception");
+        parsed = null;
+    }
+    return resultFromSymbols(parsed ? [parsed] : [], failedCount, failReasons, options.ownerPacketId);
+}
+function requireSymbolSize(symbolSize, blockProfile) {
+    if (symbolSize === undefined) {
+        throw new Error("processFecBlock options.symbolSize is required: name the catalog fec.symbolSize (T)");
+    }
+    if (typeof symbolSize !== "number" || !Number.isSafeInteger(symbolSize) || symbolSize <= 0) {
+        throw new Error(`processFecBlock options.symbolSize must be a positive integer (got ${String(symbolSize)})`);
+    }
+    if (blockProfile === "iso-ssbg1-v1" && symbolSize <= SSBG1_LENGTH_FIELD_BYTES) {
+        throw new Error(`processFecBlock options.symbolSize must exceed the ${SSBG1_LENGTH_FIELD_BYTES}-byte ssbg_mode1 length field (got ${symbolSize})`);
+    }
+    return symbolSize;
+}
+function requireSourceSymbolCount(k, blockLength, symbolSize, blockProfile) {
+    if (k === undefined) {
+        if (blockLength % symbolSize !== 0) {
+            throw new Error(`processFecBlock: ${blockLength} bytes is not a whole number of ${symbolSize}-byte symbols; pass options.k`);
+        }
+        return blockLength / symbolSize;
+    }
+    if (!Number.isSafeInteger(k) || k <= 0) {
+        throw new Error(`processFecBlock options.k must be a positive integer (got ${k})`);
+    }
+    // An iso-ssbg1-v1 block is exactly K' = SSB_length symbols of T bytes
+    // (C.5.3); any other length is not the block the repair symbols described.
+    if (blockProfile === "iso-ssbg1-v1" && blockLength !== k * symbolSize) {
+        throw new Error(`processFecBlock: an iso-ssbg1-v1 block of ${k} symbols of ${symbolSize} bytes is ${k * symbolSize} bytes (got ${blockLength})`);
+    }
+    return k;
+}
+/**
+ * Process a decoded FEC block into individual MFU fragments.
+ *
+ * The WASM RaptorQ decoder returns every source symbol of the block
+ * concatenated (K x T bytes under `k-padded-v1`, SSB_length x T bytes under
+ * `iso-ssbg1-v1`). This function splits them apart, recovers each protected
+ * packet by the stream's block profile (see {@link processFecSymbol}),
+ * extracts the MFU payload via shared extractMFUPayload, and returns
+ * structured results sorted for reassembly.
+ *
+ * @param blockData - Concatenated source symbols from the WASM decoder
+ * @param options - Block profile and symbol size T are required; see {@link ProcessFecBlockOptions}
+ * @throws when the block profile or symbol size is absent or invalid, when an
+ *   omitted `k` cannot be read exactly from the block length, or when an
+ *   `iso-ssbg1-v1` block is not exactly `k` symbols long.
+ */
+export function processFecBlock(blockData, options) {
+    const blockProfile = parseFecBlockProfile(options?.blockProfile, "processFecBlock options.blockProfile");
+    const symbolSize = requireSymbolSize(options.symbolSize, blockProfile);
+    if (!blockData || blockData.length === 0)
+        return emptyProcessResult();
+    const k = requireSourceSymbolCount(options.k, blockData.length, symbolSize, blockProfile);
+    const failReasons = {};
+    let failedCount = 0;
+    const parsed = [];
+    for (let i = 0; i < k; i++) {
+        const symStart = i * symbolSize;
+        if (symStart >= blockData.length)
+            break;
+        const symEnd = Math.min(symStart + symbolSize, blockData.length);
+        const single = processFecSymbol(blockData.subarray(symStart, symEnd), {
+            blockProfile,
+            index: i,
+        });
+        for (const [reason, count] of Object.entries(single.failReasons)) {
+            failReasons[reason] = (failReasons[reason] ?? 0) + count;
+        }
+        failedCount += single.failedCount;
+        parsed.push(...single.symbols);
+    }
+    return resultFromSymbols(parsed, failedCount, failReasons, options.ownerPacketId);
+}
+//# sourceMappingURL=block-processor.js.map

package/node_modules/@blockcast/mmt-fec/dist/block-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-processor.js","sourceRoot":"","sources":["../src/block-processor.ts"],"names":[],"mappings":"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"}

package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.d.ts

@@ -0,0 +1,46 @@
+/**
+ * CmafFecRecovery — stateful FEC recovery manager for CMAF chunks and LOC frames.
+ *
+ * Two input paths:
+ * 1. feedSourceChunk(sbn, chunk) — intact unicast delivery. Registers symbols with FEC.
+ * 2. feedSourceSymbol(sbn, esi, symbol) — individual multicast packet. Collects for recovery.
+ * 3. feedRepairSymbol(sbn, esi, symbol) — repair track. Triggers RaptorQ recovery.
+ *
+ * Returns recovered data when a block completes, null otherwise.
+ */
+/** Minimal decoder interface supplied by the composing container/application. */
+export interface FecDecoder {
+    addSourceSymbol(sbn: number, esi: number, symbol: Uint8Array, rawLen?: number): Uint8Array | null;
+    addRepairSymbol(sbn: number, esi: number, symbol: Uint8Array): Uint8Array | null;
+    getSymbolSize(): number;
+}
+export interface CmafFecRecoveryConfig {
+    fecDecoder: FecDecoder;
+    symbolSize: number;
+    k: number;
+}
+export declare class CmafFecRecovery {
+    #private;
+    constructor(config: CmafFecRecoveryConfig);
+    /**
+     * Feed a complete chunk/frame (intact unicast delivery).
+     * Splits into K symbols and registers with FEC state.
+     * Returns the chunk as-is (pass-through — no recovery needed).
+     */
+    feedSourceChunk(sbn: number, chunk: Uint8Array): Uint8Array;
+    /**
+     * Feed individual source symbol (from multicast packet).
+     * Returns recovered chunk if block completes, null otherwise.
+     */
+    feedSourceSymbol(sbn: number, esi: number, symbol: Uint8Array): Uint8Array | null;
+    /**
+     * Feed repair symbol (from repair track).
+     * Returns recovered chunk if block completes, null otherwise.
+     */
+    feedRepairSymbol(sbn: number, esi: number, symbol: Uint8Array): Uint8Array | null;
+    /** Evict old block state to prevent unbounded memory growth. */
+    evictBefore(sbn: number): void;
+    /** Reset all state. */
+    reset(): void;
+}
+//# sourceMappingURL=cmaf-recovery.d.ts.map

package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmaf-recovery.d.ts","sourceRoot":"","sources":["../src/cmaf-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iFAAiF;AACjF,MAAM,WAAW,UAAU;IAC1B,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAClG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IACjF,aAAa,IAAI,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,EAAE,MAAM,CAAC;CACV;AAQD,qBAAa,eAAe;;gBAMf,MAAM,EAAE,qBAAqB;IAMzC;;;;OAIG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU;IAiB3D;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAcjF;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IA2BjF,gEAAgE;IAChE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM9B,uBAAuB;IACvB,KAAK,IAAI,IAAI;CAGb"}

package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.js

@@ -0,0 +1,96 @@
+/**
+ * CmafFecRecovery — stateful FEC recovery manager for CMAF chunks and LOC frames.
+ *
+ * Two input paths:
+ * 1. feedSourceChunk(sbn, chunk) — intact unicast delivery. Registers symbols with FEC.
+ * 2. feedSourceSymbol(sbn, esi, symbol) — individual multicast packet. Collects for recovery.
+ * 3. feedRepairSymbol(sbn, esi, symbol) — repair track. Triggers RaptorQ recovery.
+ *
+ * Returns recovered data when a block completes, null otherwise.
+ */
+import { splitToSymbols, recoverFromSymbols } from "./cmaf-symbols.js";
+export class CmafFecRecovery {
+    #decoder;
+    #symbolSize;
+    #k;
+    #blocks = new Map();
+    constructor(config) {
+        this.#decoder = config.fecDecoder;
+        this.#symbolSize = config.symbolSize;
+        this.#k = config.k;
+    }
+    /**
+     * Feed a complete chunk/frame (intact unicast delivery).
+     * Splits into K symbols and registers with FEC state.
+     * Returns the chunk as-is (pass-through — no recovery needed).
+     */
+    feedSourceChunk(sbn, chunk) {
+        const symbols = splitToSymbols(chunk, { symbolSize: this.#symbolSize, k: this.#k });
+        // Register all symbols with FEC decoder (for cross-block repair)
+        for (let esi = 0; esi < symbols.length; esi++) {
+            this.#decoder.addSourceSymbol(sbn, esi, symbols[esi], chunk.length);
+        }
+        this.#blocks.set(sbn, {
+            originalLength: chunk.length,
+            symbolsReceived: this.#k,
+            recovered: true,
+        });
+        return chunk;
+    }
+    /**
+     * Feed individual source symbol (from multicast packet).
+     * Returns recovered chunk if block completes, null otherwise.
+     */
+    feedSourceSymbol(sbn, esi, symbol) {
+        let block = this.#blocks.get(sbn);
+        if (block?.recovered)
+            return null; // already recovered
+        if (!block) {
+            block = { symbolsReceived: 0, recovered: false };
+            this.#blocks.set(sbn, block);
+        }
+        block.symbolsReceived++;
+        const decoded = this.#decoder.addSourceSymbol(sbn, esi, symbol);
+        return this.#handleDecoded(sbn, decoded);
+    }
+    /**
+     * Feed repair symbol (from repair track).
+     * Returns recovered chunk if block completes, null otherwise.
+     */
+    feedRepairSymbol(sbn, esi, symbol) {
+        const block = this.#blocks.get(sbn);
+        if (block?.recovered)
+            return null;
+        const decoded = this.#decoder.addRepairSymbol(sbn, esi, symbol);
+        return this.#handleDecoded(sbn, decoded);
+    }
+    #handleDecoded(sbn, decoded) {
+        if (!decoded || decoded.length === 0)
+            return null;
+        const block = this.#blocks.get(sbn);
+        if (block)
+            block.recovered = true;
+        // Decoded = K symbols concatenated. Recover original data.
+        const symbols = [];
+        for (let i = 0; i < this.#k; i++) {
+            const start = i * this.#symbolSize;
+            const end = start + this.#symbolSize;
+            symbols.push(decoded.subarray(start, Math.min(end, decoded.length)));
+        }
+        // If we know the original length, strip padding
+        const originalLength = block?.originalLength ?? decoded.length;
+        return recoverFromSymbols(symbols, { originalLength });
+    }
+    /** Evict old block state to prevent unbounded memory growth. */
+    evictBefore(sbn) {
+        for (const key of this.#blocks.keys()) {
+            if (key < sbn)
+                this.#blocks.delete(key);
+        }
+    }
+    /** Reset all state. */
+    reset() {
+        this.#blocks.clear();
+    }
+}
+//# sourceMappingURL=cmaf-recovery.js.map

package/node_modules/@blockcast/mmt-fec/dist/cmaf-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmaf-recovery.js","sourceRoot":"","sources":["../src/cmaf-recovery.ts"],"names":[],"mappings":"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"}

package/node_modules/@blockcast/mmt-fec/dist/cmaf-symbols.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CMAF Symbol Splitter — split CMAF chunks into FEC source symbols.
+ *
+ * Per CARP draft §6.1: "Each chunk is divided into K source symbols of
+ * symbolSize bytes." The last symbol is zero-padded if the chunk size
+ * isn't evenly divisible.
+ *
+ * Also used for LOC frames (raw codec bitstream) — same algorithm,
+ * no container overhead to account for.
+ *
+ * Pure functions — no side effects, no state.
+ */
+/**
+ * Split a byte array (CMAF chunk or LOC frame) into K source symbols.
+ * Each symbol is exactly `symbolSize` bytes, zero-padded if needed.
+ */
+export declare function splitToSymbols(data: Uint8Array, config: {
+    symbolSize: number;
+    k: number;
+}): Uint8Array[];
+/**
+ * Recover original data from K source symbols.
+ * Strips zero-padding using the known original length.
+ */
+export declare function recoverFromSymbols(symbols: Uint8Array[], config: {
+    originalLength: number;
+}): Uint8Array;
+/**
+ * Compute K (number of source symbols) for a given data length and symbol size.
+ * K = ceil(dataLength / symbolSize)
+ */
+export declare function computeK(dataLength: number, symbolSize: number): number;
+//# sourceMappingURL=cmaf-symbols.d.ts.map

package/node_modules/@blockcast/mmt-fec/dist/cmaf-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmaf-symbols.d.ts","sourceRoot":"","sources":["../src/cmaf-symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,UAAU,EAAE,CAed;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAChC,UAAU,CAeZ;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE"}

package/node_modules/@blockcast/mmt-fec/dist/cmaf-symbols.js

@@ -0,0 +1,57 @@
+/**
+ * CMAF Symbol Splitter — split CMAF chunks into FEC source symbols.
+ *
+ * Per CARP draft §6.1: "Each chunk is divided into K source symbols of
+ * symbolSize bytes." The last symbol is zero-padded if the chunk size
+ * isn't evenly divisible.
+ *
+ * Also used for LOC frames (raw codec bitstream) — same algorithm,
+ * no container overhead to account for.
+ *
+ * Pure functions — no side effects, no state.
+ */
+/**
+ * Split a byte array (CMAF chunk or LOC frame) into K source symbols.
+ * Each symbol is exactly `symbolSize` bytes, zero-padded if needed.
+ */
+export function splitToSymbols(data, config) {
+    const { symbolSize, k } = config;
+    const symbols = [];
+    for (let i = 0; i < k; i++) {
+        const start = i * symbolSize;
+        const symbol = new Uint8Array(symbolSize); // zero-initialized
+        const end = Math.min(start + symbolSize, data.length);
+        if (start < data.length) {
+            symbol.set(data.subarray(start, end));
+        }
+        symbols.push(symbol);
+    }
+    return symbols;
+}
+/**
+ * Recover original data from K source symbols.
+ * Strips zero-padding using the known original length.
+ */
+export function recoverFromSymbols(symbols, config) {
+    const { originalLength } = config;
+    const result = new Uint8Array(originalLength);
+    let offset = 0;
+    for (const sym of symbols) {
+        const copyLen = Math.min(sym.length, originalLength - offset);
+        if (copyLen > 0) {
+            result.set(sym.subarray(0, copyLen), offset);
+        }
+        offset += sym.length;
+        if (offset >= originalLength)
+            break;
+    }
+    return result;
+}
+/**
+ * Compute K (number of source symbols) for a given data length and symbol size.
+ * K = ceil(dataLength / symbolSize)
+ */
+export function computeK(dataLength, symbolSize) {
+    return Math.ceil(dataLength / symbolSize);
+}
+//# sourceMappingURL=cmaf-symbols.js.map