@blockcast/mmt-container 0.1.0

package/dist/mfu-reassembler.js

@@ -0,0 +1,320 @@
+/**
+ * @mmt/container - MFU Fragment Reassembler
+ *
+ * Handles out-of-order delivery of fragmented MFUs (Media Fragment Units)
+ * according to ISO/IEC 23008-1:2023 Section 9.2.3.3
+ *
+ * Fragmentation Indicator (FI) values:
+ * - 0: Complete MFU (single packet, no fragmentation)
+ * - 1: First fragment
+ * - 2: Middle fragment
+ * - 3: Last fragment
+ *
+ * @packageDocumentation
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _MFUReassembler_instances, _MFUReassembler_buffers, _MFUReassembler_timeouts, _MFUReassembler_timeoutMs, _MFUReassembler_maxBuffered, _MFUReassembler_tryReassemble, _MFUReassembler_setTimeout, _MFUReassembler_clearTimeout, _MFUReassembler_onTimeout, _MFUReassembler_enforceMemoryLimit;
+import { unwrapMMTP, parseMPUHeader, isFecRepairPacket, MPU_HEADER_SIZE, MFU_DU_HEADER_SIZE, } from './mmtp.js';
+/**
+ * MFU Reassembler for out-of-order fragment delivery
+ * Based on ISO/IEC 23008-1:2023 Section 9.2.3.3
+ */
+export class MFUReassembler {
+    constructor(options) {
+        _MFUReassembler_instances.add(this);
+        _MFUReassembler_buffers.set(this, new Map());
+        _MFUReassembler_timeouts.set(this, new Map());
+        _MFUReassembler_timeoutMs.set(this, void 0);
+        _MFUReassembler_maxBuffered.set(this, void 0);
+        /** Statistics for debugging */
+        this.stats = {
+            totalFragments: 0,
+            reassembledMFUs: 0,
+            timedOutMFUs: 0,
+            outOfOrderFragments: 0,
+        };
+        __classPrivateFieldSet(this, _MFUReassembler_timeoutMs, options?.timeoutMs ?? 1000, "f");
+        __classPrivateFieldSet(this, _MFUReassembler_maxBuffered, options?.maxBuffered ?? 100, "f");
+    }
+    /**
+     * Add a fragment and return reassembled MFU if complete
+     */
+    addFragment(fragment) {
+        this.stats.totalFragments++;
+        const { mpuSequenceNumber, fragmentationIndicator, fragmentCounter } = fragment;
+        // Handle complete MFU (FI=0)
+        if (fragmentationIndicator === 0) {
+            this.stats.reassembledMFUs++;
+            return {
+                mpuSequenceNumber,
+                data: fragment.data,
+                timestamp: fragment.timestamp,
+                fragmentCount: 1,
+                rapFlag: fragment.rapFlag,
+            };
+        }
+        // Get or create fragment buffer for this MPU
+        let fragments = __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").get(mpuSequenceNumber);
+        if (!fragments) {
+            fragments = [];
+            __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").set(mpuSequenceNumber, fragments);
+            __classPrivateFieldGet(this, _MFUReassembler_instances, "m", _MFUReassembler_setTimeout).call(this, mpuSequenceNumber);
+        }
+        // Check for duplicate fragment
+        const existingIdx = fragments.findIndex((f) => f.fragmentCounter === fragmentCounter);
+        if (existingIdx >= 0) {
+            fragments[existingIdx] = fragment;
+        }
+        else {
+            fragments.push(fragment);
+        }
+        // Track out-of-order delivery
+        if (fragments.length > 1) {
+            const lastFI = fragments[fragments.length - 2].fragmentationIndicator;
+            if (fragmentationIndicator !== lastFI + 1) {
+                this.stats.outOfOrderFragments++;
+            }
+        }
+        // Enforce memory limits
+        __classPrivateFieldGet(this, _MFUReassembler_instances, "m", _MFUReassembler_enforceMemoryLimit).call(this);
+        // Try to reassemble
+        return __classPrivateFieldGet(this, _MFUReassembler_instances, "m", _MFUReassembler_tryReassemble).call(this, mpuSequenceNumber);
+    }
+    /**
+     * Flush all buffered fragments
+     */
+    flush() {
+        for (const mpuSeq of __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").keys()) {
+            __classPrivateFieldGet(this, _MFUReassembler_instances, "m", _MFUReassembler_clearTimeout).call(this, mpuSeq);
+        }
+        __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").clear();
+        __classPrivateFieldGet(this, _MFUReassembler_timeouts, "f").clear();
+    }
+    /**
+     * Get number of pending MFUs
+     */
+    get pendingCount() {
+        return __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").size;
+    }
+    /**
+     * Get current buffer status
+     */
+    getStatus() {
+        let pendingFragments = 0;
+        for (const fragments of __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").values()) {
+            pendingFragments += fragments.length;
+        }
+        return {
+            bufferedMFUs: __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").size,
+            pendingFragments,
+            stats: { ...this.stats },
+        };
+    }
+}
+_MFUReassembler_buffers = new WeakMap(), _MFUReassembler_timeouts = new WeakMap(), _MFUReassembler_timeoutMs = new WeakMap(), _MFUReassembler_maxBuffered = new WeakMap(), _MFUReassembler_instances = new WeakSet(), _MFUReassembler_tryReassemble = function _MFUReassembler_tryReassemble(mpuSequenceNumber) {
+    const fragments = __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").get(mpuSequenceNumber);
+    if (!fragments || fragments.length === 0) {
+        return null;
+    }
+    // Sort by fragment counter
+    fragments.sort((a, b) => a.fragmentCounter - b.fragmentCounter);
+    const firstFI = fragments[0].fragmentationIndicator;
+    const lastFI = fragments[fragments.length - 1].fragmentationIndicator;
+    // Need first (FI=1) and last (FI=3) fragments
+    if (firstFI !== 1 || lastFI !== 3) {
+        return null;
+    }
+    // Verify middle fragments have FI=2
+    for (let i = 1; i < fragments.length - 1; i++) {
+        if (fragments[i].fragmentationIndicator !== 2) {
+            return null;
+        }
+    }
+    // Reassemble: concatenate all fragment data
+    const totalSize = fragments.reduce((sum, f) => sum + f.data.length, 0);
+    const data = new Uint8Array(totalSize);
+    let offset = 0;
+    for (const fragment of fragments) {
+        data.set(fragment.data, offset);
+        offset += fragment.data.length;
+    }
+    // Cleanup
+    __classPrivateFieldGet(this, _MFUReassembler_instances, "m", _MFUReassembler_clearTimeout).call(this, mpuSequenceNumber);
+    __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").delete(mpuSequenceNumber);
+    this.stats.reassembledMFUs++;
+    return {
+        mpuSequenceNumber,
+        data,
+        timestamp: fragments[0].timestamp,
+        fragmentCount: fragments.length,
+        rapFlag: fragments[0].rapFlag,
+    };
+}, _MFUReassembler_setTimeout = function _MFUReassembler_setTimeout(mpuSequenceNumber) {
+    const timeoutId = setTimeout(() => {
+        __classPrivateFieldGet(this, _MFUReassembler_instances, "m", _MFUReassembler_onTimeout).call(this, mpuSequenceNumber);
+    }, __classPrivateFieldGet(this, _MFUReassembler_timeoutMs, "f"));
+    __classPrivateFieldGet(this, _MFUReassembler_timeouts, "f").set(mpuSequenceNumber, timeoutId);
+}, _MFUReassembler_clearTimeout = function _MFUReassembler_clearTimeout(mpuSequenceNumber) {
+    const timeoutId = __classPrivateFieldGet(this, _MFUReassembler_timeouts, "f").get(mpuSequenceNumber);
+    if (timeoutId !== undefined) {
+        clearTimeout(timeoutId);
+        __classPrivateFieldGet(this, _MFUReassembler_timeouts, "f").delete(mpuSequenceNumber);
+    }
+}, _MFUReassembler_onTimeout = function _MFUReassembler_onTimeout(mpuSequenceNumber) {
+    const fragments = __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").get(mpuSequenceNumber);
+    if (!fragments)
+        return;
+    this.stats.timedOutMFUs++;
+    __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").delete(mpuSequenceNumber);
+    __classPrivateFieldGet(this, _MFUReassembler_timeouts, "f").delete(mpuSequenceNumber);
+}, _MFUReassembler_enforceMemoryLimit = function _MFUReassembler_enforceMemoryLimit() {
+    if (__classPrivateFieldGet(this, _MFUReassembler_buffers, "f").size <= __classPrivateFieldGet(this, _MFUReassembler_maxBuffered, "f"))
+        return;
+    const sequences = Array.from(__classPrivateFieldGet(this, _MFUReassembler_buffers, "f").keys()).sort((a, b) => a - b);
+    const toRemove = sequences.slice(0, sequences.length - __classPrivateFieldGet(this, _MFUReassembler_maxBuffered, "f"));
+    for (const mpuSeq of toRemove) {
+        __classPrivateFieldGet(this, _MFUReassembler_instances, "m", _MFUReassembler_clearTimeout).call(this, mpuSeq);
+        __classPrivateFieldGet(this, _MFUReassembler_buffers, "f").delete(mpuSeq);
+        this.stats.timedOutMFUs++;
+    }
+};
+/**
+ * Create MFU fragment from MMTP packet for reassembly
+ */
+export function createFragment(mmtpPacket) {
+    const { header, payload } = unwrapMMTP(mmtpPacket);
+    const mpuHeader = parseMPUHeader(payload);
+    const { mpuSequenceNumber, fragmentationIndicator, fragmentCounter } = mpuHeader;
+    // MFU DU header is present only for FI = 0 (complete) or FI = 1 (first)
+    const hasMfuHeader = fragmentationIndicator === 0 || fragmentationIndicator === 1;
+    const headerSize = MPU_HEADER_SIZE + (hasMfuHeader ? MFU_DU_HEADER_SIZE : 0);
+    if (payload.length < headerSize) {
+        throw new Error(`Payload too small for headers: ${payload.length} bytes (need ${headerSize})`);
+    }
+    const data = payload.subarray(headerSize);
+    return {
+        fragmentationIndicator,
+        mpuSequenceNumber,
+        fragmentCounter,
+        data,
+        timestamp: header.timestamp,
+        receivedAt: typeof performance !== 'undefined' ? performance.now() : Date.now(),
+        rapFlag: header.rapFlag,
+    };
+}
+/**
+ * Process MMTP packet with fragment reassembly
+ */
+export function processMMTPWithReassembly(mmtpPacket, reassembler) {
+    // Skip FEC repair packets
+    if (isFecRepairPacket(mmtpPacket)) {
+        return null;
+    }
+    const fragment = createFragment(mmtpPacket);
+    return reassembler.addFragment(fragment);
+}
+// =============================================================================
+// Inline Tests (vitest)
+// =============================================================================
+if (import.meta.vitest) {
+    const { describe, test, expect } = import.meta.vitest;
+    describe('MFUReassembler', () => {
+        test('should return complete MFU for FI=0', () => {
+            const reassembler = new MFUReassembler();
+            const result = reassembler.addFragment({
+                fragmentationIndicator: 0,
+                mpuSequenceNumber: 1,
+                fragmentCounter: 0,
+                data: new Uint8Array([1, 2, 3, 4]),
+                timestamp: 1000n,
+                receivedAt: 0,
+                rapFlag: true,
+            });
+            expect(result).not.toBeNull();
+            expect(result?.data).toEqual(new Uint8Array([1, 2, 3, 4]));
+            expect(result?.fragmentCount).toBe(1);
+            expect(result?.rapFlag).toBe(true);
+        });
+        test('should buffer and reassemble 2 fragments', () => {
+            const reassembler = new MFUReassembler();
+            // First fragment (FI=1)
+            const result1 = reassembler.addFragment({
+                fragmentationIndicator: 1,
+                mpuSequenceNumber: 1,
+                fragmentCounter: 0,
+                data: new Uint8Array([1, 2]),
+                timestamp: 1000n,
+                receivedAt: 0,
+                rapFlag: true,
+            });
+            expect(result1).toBeNull();
+            // Last fragment (FI=3)
+            const result2 = reassembler.addFragment({
+                fragmentationIndicator: 3,
+                mpuSequenceNumber: 1,
+                fragmentCounter: 1,
+                data: new Uint8Array([3, 4]),
+                timestamp: 1000n,
+                receivedAt: 0,
+                rapFlag: false,
+            });
+            expect(result2).not.toBeNull();
+            expect(result2?.data).toEqual(new Uint8Array([1, 2, 3, 4]));
+            expect(result2?.fragmentCount).toBe(2);
+            expect(result2?.rapFlag).toBe(true); // Should use first fragment's rapFlag
+        });
+        test('should handle out-of-order fragments', () => {
+            const reassembler = new MFUReassembler();
+            // Last fragment first (FI=3)
+            reassembler.addFragment({
+                fragmentationIndicator: 3,
+                mpuSequenceNumber: 1,
+                fragmentCounter: 1,
+                data: new Uint8Array([3, 4]),
+                timestamp: 1000n,
+                receivedAt: 0,
+                rapFlag: false,
+            });
+            // Then first fragment (FI=1)
+            const result = reassembler.addFragment({
+                fragmentationIndicator: 1,
+                mpuSequenceNumber: 1,
+                fragmentCounter: 0,
+                data: new Uint8Array([1, 2]),
+                timestamp: 1000n,
+                receivedAt: 0,
+                rapFlag: true,
+            });
+            expect(result).not.toBeNull();
+            expect(result?.data).toEqual(new Uint8Array([1, 2, 3, 4]));
+            expect(result?.rapFlag).toBe(true);
+        });
+        test('should track pending count', () => {
+            const reassembler = new MFUReassembler();
+            expect(reassembler.pendingCount).toBe(0);
+            reassembler.addFragment({
+                fragmentationIndicator: 1,
+                mpuSequenceNumber: 1,
+                fragmentCounter: 0,
+                data: new Uint8Array([1]),
+                timestamp: 1000n,
+                receivedAt: 0,
+                rapFlag: false,
+            });
+            expect(reassembler.pendingCount).toBe(1);
+            reassembler.flush();
+            expect(reassembler.pendingCount).toBe(0);
+        });
+    });
+}
+//# sourceMappingURL=mfu-reassembler.js.map

package/dist/mfu-reassembler.js.map

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

package/dist/mmtp.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @mmt/container - MMTP Parser
+ *
+ * MMTP (MMT Protocol) packet parser based on ISO/IEC 23008-1:2023 Section 9.2
+ *
+ * MMTP header format (12 bytes):
+ * - Byte 0: V(2) | C(1) | FEC_type(2) | r(1) | X(1) | R(1)
+ * - Byte 1: packet_type(6) | reserved(2)
+ * - Bytes 2-3: packet_id (big-endian)
+ * - Bytes 4-7: timestamp (big-endian, 32-bit)
+ * - Bytes 8-11: sequence_number (big-endian)
+ *
+ * FEC_type values:
+ * - 0: No FEC / source packet
+ * - 1: FEC mode 0 (source with FEC payload ID)
+ * - 2: FEC repair packet mode 0
+ * - 3: FEC repair packet mode 1
+ *
+ * @packageDocumentation
+ */
+export interface MMTPHeader {
+    version: number;
+    packetId: number;
+    timestamp: bigint;
+    sequenceNumber: number;
+    payloadLength: number;
+    fecType: number;
+    /** Random Access Point flag - indicates keyframe (ISO 23008-1, byte 0 bit 0) */
+    rapFlag: boolean;
+}
+export interface MPUHeader {
+    mpuSequenceNumber: number;
+    fragmentationIndicator: number;
+    fragmentCounter: number;
+}
+export interface MMTPPacket {
+    header: MMTPHeader;
+    payload: Uint8Array;
+}
+export declare const MMTP_HEADER_SIZE = 12;
+export declare const MPU_HEADER_SIZE = 8;
+export declare const MFU_DU_HEADER_SIZE = 14;
+/**
+ * Parse MMTP header from buffer
+ */
+export declare function parseMMTPHeader(buffer: Uint8Array): MMTPHeader;
+/**
+ * Unwrap MMTP packet to extract payload
+ */
+export declare function unwrapMMTP(buffer: Uint8Array): MMTPPacket;
+/**
+ * Parse MPU header from payload
+ * ISO/IEC 23008-1:2023 Section 9.2.3.3
+ */
+export declare function parseMPUHeader(payload: Uint8Array): MPUHeader;
+/**
+ * Extract NAL unit payload from MMTP packet
+ */
+export declare function extractNALUnit(mmtpPacket: Uint8Array): Uint8Array;
+/**
+ * Extract timestamp from MMTP packet
+ */
+export declare function extractTimestamp(mmtpPacket: Uint8Array): bigint;
+/**
+ * Check if MMTP packet is an FEC repair packet
+ * FEC_type 2 and 3 are repair packets
+ */
+export declare function isFecRepairPacket(mmtpPacket: Uint8Array): boolean;
+/**
+ * Check if MMTP packet has FEC payload ID (FEC_type 1 or higher)
+ */
+export declare function hasFecPayloadId(mmtpPacket: Uint8Array): boolean;
+//# sourceMappingURL=mmtp.d.ts.map

package/dist/mmtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmtp.d.ts","sourceRoot":"","sources":["../src/mmtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,UAAU,CAAA;CACpB;AAED,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAqC9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAKzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAqB7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAmBjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAIjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAI/D"}

package/dist/mmtp.js

@@ -0,0 +1,210 @@
+/**
+ * @mmt/container - MMTP Parser
+ *
+ * MMTP (MMT Protocol) packet parser based on ISO/IEC 23008-1:2023 Section 9.2
+ *
+ * MMTP header format (12 bytes):
+ * - Byte 0: V(2) | C(1) | FEC_type(2) | r(1) | X(1) | R(1)
+ * - Byte 1: packet_type(6) | reserved(2)
+ * - Bytes 2-3: packet_id (big-endian)
+ * - Bytes 4-7: timestamp (big-endian, 32-bit)
+ * - Bytes 8-11: sequence_number (big-endian)
+ *
+ * FEC_type values:
+ * - 0: No FEC / source packet
+ * - 1: FEC mode 0 (source with FEC payload ID)
+ * - 2: FEC repair packet mode 0
+ * - 3: FEC repair packet mode 1
+ *
+ * @packageDocumentation
+ */
+export const MMTP_HEADER_SIZE = 12;
+export const MPU_HEADER_SIZE = 8;
+export const MFU_DU_HEADER_SIZE = 14;
+/**
+ * Parse MMTP header from buffer
+ */
+export 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);
+    // Extract FEC type from byte 0, bits 3-4
+    const fecType = (buffer[0] >> 3) & 0x03;
+    // Extract RAP flag from byte 0, bit 0 (R bit - Random Access Point)
+    const rapFlag = (buffer[0] & 0x01) === 1;
+    // Skip bytes 0-1 (flags and packet_type)
+    let offset = 2;
+    // Packet ID (2 bytes, big-endian)
+    const packetId = view.getUint16(offset, false);
+    offset += 2;
+    // Timestamp (4 bytes, big-endian)
+    const timestamp = BigInt(view.getUint32(offset, false));
+    offset += 4;
+    // Sequence number (4 bytes, big-endian)
+    const sequenceNumber = view.getUint32(offset, false);
+    offset += 4;
+    return {
+        version: 1,
+        packetId,
+        timestamp,
+        sequenceNumber,
+        payloadLength: buffer.length - offset,
+        fecType,
+        rapFlag,
+    };
+}
+/**
+ * Unwrap MMTP packet to extract payload
+ */
+export function unwrapMMTP(buffer) {
+    const header = parseMMTPHeader(buffer);
+    const payload = buffer.subarray(MMTP_HEADER_SIZE);
+    return { header, payload };
+}
+/**
+ * Parse MPU header from payload
+ * ISO/IEC 23008-1:2023 Section 9.2.3.3
+ */
+export function parseMPUHeader(payload) {
+    if (payload.length < MPU_HEADER_SIZE) {
+        throw new Error(`Payload too small for MPU header: ${payload.length} bytes`);
+    }
+    const view = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);
+    // MPU sequence number (4 bytes, big-endian)
+    const mpuSequenceNumber = view.getUint32(0, false);
+    // Fragmentation indicator (byte 5, bits 0-1)
+    const fragmentationIndicator = payload[5] & 0x03;
+    // Fragment counter (bytes 6-7, big-endian)
+    const fragmentCounter = view.getUint16(6, false);
+    return {
+        mpuSequenceNumber,
+        fragmentationIndicator,
+        fragmentCounter,
+    };
+}
+/**
+ * Extract NAL unit payload from MMTP packet
+ */
+export function extractNALUnit(mmtpPacket) {
+    const { payload } = unwrapMMTP(mmtpPacket);
+    if (payload.length < MPU_HEADER_SIZE) {
+        throw new Error(`Payload too small for MPU header: ${payload.length} bytes`);
+    }
+    // Parse MPU header to check fragmentation indicator
+    const fragmentationIndicator = payload[5] & 0x03;
+    // MFU DU header is present only for FI = 0 (complete) or FI = 1 (first)
+    const hasMfuHeader = fragmentationIndicator === 0 || fragmentationIndicator === 1;
+    const headerSize = MPU_HEADER_SIZE + (hasMfuHeader ? MFU_DU_HEADER_SIZE : 0);
+    if (payload.length < headerSize) {
+        throw new Error(`Payload too small for headers: ${payload.length} bytes (need ${headerSize})`);
+    }
+    return payload.subarray(headerSize);
+}
+/**
+ * Extract timestamp from MMTP packet
+ */
+export function extractTimestamp(mmtpPacket) {
+    const { header } = unwrapMMTP(mmtpPacket);
+    return header.timestamp;
+}
+/**
+ * Check if MMTP packet is an FEC repair packet
+ * FEC_type 2 and 3 are repair packets
+ */
+export function isFecRepairPacket(mmtpPacket) {
+    if (mmtpPacket.length < 1)
+        return false;
+    const fecType = (mmtpPacket[0] >> 3) & 0x03;
+    return fecType >= 2;
+}
+/**
+ * Check if MMTP packet has FEC payload ID (FEC_type 1 or higher)
+ */
+export function hasFecPayloadId(mmtpPacket) {
+    if (mmtpPacket.length < 1)
+        return false;
+    const fecType = (mmtpPacket[0] >> 3) & 0x03;
+    return fecType >= 1;
+}
+// =============================================================================
+// Inline Tests (vitest)
+// =============================================================================
+if (import.meta.vitest) {
+    const { describe, test, expect } = import.meta.vitest;
+    describe('MMTP Parser', () => {
+        // Helper to create a minimal MMTP packet
+        function createTestPacket(opts) {
+            const fecType = opts.fecType ?? 0;
+            const packetId = opts.packetId ?? 1;
+            const timestamp = opts.timestamp ?? 12345;
+            const sequenceNumber = opts.sequenceNumber ?? 1;
+            const payload = opts.payload ?? new Uint8Array([0x00, 0x00, 0x00, 0x01]);
+            const header = new Uint8Array(12);
+            const view = new DataView(header.buffer);
+            // Byte 0: V=1, C=0, FEC_type, r=0, X=0, R=0
+            header[0] = (1 << 6) | (fecType << 3);
+            // Byte 1: packet_type=0 (MPU)
+            header[1] = 0;
+            view.setUint16(2, packetId, false);
+            view.setUint32(4, timestamp, false);
+            view.setUint32(8, sequenceNumber, false);
+            const result = new Uint8Array(header.length + payload.length);
+            result.set(header, 0);
+            result.set(payload, header.length);
+            return result;
+        }
+        describe('parseMMTPHeader', () => {
+            test('should parse MMTP header correctly', () => {
+                const packet = createTestPacket({
+                    packetId: 42,
+                    timestamp: 1000000,
+                    sequenceNumber: 100,
+                });
+                const header = parseMMTPHeader(packet);
+                expect(header.packetId).toBe(42);
+                expect(header.timestamp).toBe(1000000n);
+                expect(header.sequenceNumber).toBe(100);
+                expect(header.fecType).toBe(0);
+            });
+            test('should extract FEC type', () => {
+                const packet = createTestPacket({ fecType: 2 });
+                const header = parseMMTPHeader(packet);
+                expect(header.fecType).toBe(2);
+            });
+            test('should throw on too small packet', () => {
+                expect(() => parseMMTPHeader(new Uint8Array(10))).toThrow();
+            });
+        });
+        describe('isFecRepairPacket', () => {
+            test('should return false for source packets (FEC type 0)', () => {
+                const packet = createTestPacket({ fecType: 0 });
+                expect(isFecRepairPacket(packet)).toBe(false);
+            });
+            test('should return false for FEC mode 0 source (FEC type 1)', () => {
+                const packet = createTestPacket({ fecType: 1 });
+                expect(isFecRepairPacket(packet)).toBe(false);
+            });
+            test('should return true for repair packets (FEC type 2)', () => {
+                const packet = createTestPacket({ fecType: 2 });
+                expect(isFecRepairPacket(packet)).toBe(true);
+            });
+            test('should return true for repair packets (FEC type 3)', () => {
+                const packet = createTestPacket({ fecType: 3 });
+                expect(isFecRepairPacket(packet)).toBe(true);
+            });
+        });
+        describe('hasFecPayloadId', () => {
+            test('should return false for no FEC (type 0)', () => {
+                const packet = createTestPacket({ fecType: 0 });
+                expect(hasFecPayloadId(packet)).toBe(false);
+            });
+            test('should return true for FEC type 1+', () => {
+                expect(hasFecPayloadId(createTestPacket({ fecType: 1 }))).toBe(true);
+                expect(hasFecPayloadId(createTestPacket({ fecType: 2 }))).toBe(true);
+                expect(hasFecPayloadId(createTestPacket({ fecType: 3 }))).toBe(true);
+            });
+        });
+    });
+}
+//# sourceMappingURL=mmtp.js.map

package/dist/mmtp.js.map

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