@bnhf/prismcast 1.3.4-2026.2.19

package/dist/streaming/mp4Parser.js

@@ -0,0 +1,566 @@
+// Constants.
+// Minimum header size: 4 bytes size + 4 bytes type.
+const MIN_HEADER_SIZE = 8;
+// Extended header size: 4 bytes size (==1) + 4 bytes type + 8 bytes extended size.
+const EXTENDED_HEADER_SIZE = 16;
+// Streaming Parser.
+/**
+ * Creates an MP4 box parser that processes streaming input. The parser buffers incomplete boxes and invokes the callback when a complete box is available.
+ * @param onBox - Callback invoked for each complete box.
+ * @returns The parser interface with push and flush methods.
+ */
+export function createMP4BoxParser(onBox) {
+    // Buffer for accumulating incomplete data.
+    let buffer = Buffer.alloc(0);
+    /**
+     * Attempts to parse and emit complete boxes from the buffer.
+     */
+    function processBuffer() {
+        // Keep parsing while we have enough data for at least a header.
+        while (buffer.length >= MIN_HEADER_SIZE) {
+            // Read the size field (first 4 bytes).
+            const sizeField = buffer.readUInt32BE(0);
+            // Determine actual box size.
+            let boxSize;
+            let headerSize;
+            if (sizeField === 1) {
+                // Extended size: need 16 bytes for full header.
+                if (buffer.length < EXTENDED_HEADER_SIZE) {
+                    // Not enough data yet for extended header.
+                    return;
+                }
+                // Read 64-bit extended size. For practical purposes, we only use the lower 32 bits since JavaScript numbers safely handle up to 2^53, and we're unlikely to
+                // encounter boxes larger than 4GB in streaming scenarios.
+                const extendedSizeHigh = buffer.readUInt32BE(8);
+                const extendedSizeLow = buffer.readUInt32BE(12);
+                // Sanity check: reject impossibly large boxes.
+                if (extendedSizeHigh > 0) {
+                    // Box claims to be > 4GB, which is unrealistic for streaming. Skip this box by advancing 1 byte and trying again.
+                    buffer = buffer.subarray(1);
+                    continue;
+                }
+                boxSize = extendedSizeLow;
+                headerSize = EXTENDED_HEADER_SIZE;
+            }
+            else if (sizeField === 0) {
+                // Size 0 means "extends to end of file" - not applicable for streaming. Skip this byte and try again.
+                buffer = buffer.subarray(1);
+                continue;
+            }
+            else {
+                boxSize = sizeField;
+                headerSize = MIN_HEADER_SIZE;
+            }
+            // Sanity check: box size must be at least the header size.
+            if (boxSize < headerSize) {
+                // Invalid box, skip one byte and try to resync.
+                buffer = buffer.subarray(1);
+                continue;
+            }
+            // Check if we have the complete box.
+            if (buffer.length < boxSize) {
+                // Not enough data yet.
+                return;
+            }
+            // Extract the complete box.
+            const boxData = buffer.subarray(0, boxSize);
+            const boxType = buffer.toString("ascii", 4, 8);
+            // Emit the box.
+            onBox({
+                data: Buffer.from(boxData),
+                size: boxSize,
+                type: boxType
+            });
+            // Advance the buffer past this box.
+            buffer = buffer.subarray(boxSize);
+        }
+    }
+    return {
+        flush: () => {
+            // Clear the buffer. Any remaining data is an incomplete box that we discard.
+            buffer = Buffer.alloc(0);
+        },
+        push: (chunk) => {
+            // Append the new chunk to our buffer.
+            buffer = Buffer.concat([buffer, chunk]);
+            // Try to parse complete boxes.
+            processBuffer();
+        }
+    };
+}
+// Nested Box Parsing.
+/**
+ * Iterates over the immediate child boxes within a container box's payload. Container boxes in ISO 14496-12 (moof, traf, etc.) contain a sequence of child boxes
+ * starting immediately after the parent's 8-byte header. This function parses each child box header and invokes the callback with the child's type, the parent buffer,
+ * and the byte offset/size of the child box within that buffer. The callback receives offsets rather than sub-buffers to avoid memory allocation in the hot path.
+ * @param data - The complete parent box buffer including its own 8-byte header.
+ * @param callback - Called for each child box with (type, data, offset, size). The offset and size describe the child box's position within data.
+ */
+export function iterateChildBoxes(data, callback) {
+    let pos = MIN_HEADER_SIZE;
+    while ((pos + MIN_HEADER_SIZE) <= data.length) {
+        const sizeField = data.readUInt32BE(pos);
+        let boxSize;
+        if (sizeField === 1) {
+            // Extended size box. Need 16 bytes for the full header.
+            if ((pos + EXTENDED_HEADER_SIZE) > data.length) {
+                return;
+            }
+            // Reject impossibly large boxes (>4GB).
+            if (data.readUInt32BE(pos + 8) > 0) {
+                return;
+            }
+            boxSize = data.readUInt32BE(pos + 12);
+        }
+        else if ((sizeField < MIN_HEADER_SIZE) || (sizeField === 0)) {
+            // Invalid size or "extends to end of file" — stop iterating.
+            return;
+        }
+        else {
+            boxSize = sizeField;
+        }
+        // Ensure the child box fits within the parent.
+        if ((pos + boxSize) > data.length) {
+            return;
+        }
+        const boxType = data.toString("ascii", pos + 4, pos + 8);
+        callback(boxType, data, pos, boxSize);
+        pos += boxSize;
+    }
+}
+// Keyframe Detection.
+/**
+ * Evaluates ISO 14496-12 sample flags to determine whether a sample is a sync sample (keyframe). The sample_depends_on field (bits 25-24) is the primary indicator,
+ * with sample_is_non_sync_sample (bit 16) as a secondary check.
+ *
+ * Sample flags layout (32 bits):
+ * - Bits 31-28: reserved
+ * - Bits 27-26: is_leading
+ * - Bits 25-24: sample_depends_on (0=unknown, 1=dependent/not keyframe, 2=independent/keyframe)
+ * - Bits 23-22: sample_is_depended_on
+ * - Bits 21-20: sample_has_redundancy
+ * - Bits 19-17: sample_padding_value
+ * - Bit 16: sample_is_non_sync_sample (0=may be sync, 1=not sync)
+ * - Bits 15-0: sample_degradation_priority
+ *
+ * @param flags - The 32-bit sample flags value.
+ * @returns true if keyframe, false if not keyframe.
+ */
+function evaluateSampleFlags(flags) {
+    const sampleDependsOn = (flags >>> 24) & 0x03;
+    const isNonSync = (flags >>> 16) & 0x01;
+    // sample_depends_on === 1: depends on other samples. This is not independently decodable (not a keyframe).
+    if (sampleDependsOn === 1) {
+        return false;
+    }
+    // sample_depends_on === 2: does not depend on other samples. This is an independently decodable frame (keyframe).
+    if (sampleDependsOn === 2) {
+        return true;
+    }
+    // sample_is_non_sync_sample === 1: explicitly marked as not a sync sample.
+    if (isNonSync === 1) {
+        return false;
+    }
+    // sample_depends_on is unknown (0) and no non-sync marker. Per ISO 14496-12 defaults, treat as a sync sample.
+    return true;
+}
+/**
+ * Parses a tfhd (track fragment header) box and extracts the track ID, default sample duration, and default sample flags. This is the single source of truth for
+ * tfhd field extraction, used by both detectMoofKeyframe() (for sample flags) and rewriteMoofTimestamps() (for track ID and duration).
+ *
+ * tfhd layout (FullBox):
+ * - [0-3] size, [4-7] "tfhd", [8] version, [9-11] flags, [12-15] track_ID
+ * - Optional fields (in order, each present only if its flag bit is set):
+ *   0x000001: base_data_offset (8 bytes)
+ *   0x000002: sample_description_index (4 bytes)
+ *   0x000008: default_sample_duration (4 bytes)
+ *   0x000010: default_sample_size (4 bytes)
+ *   0x000020: default_sample_flags (4 bytes)
+ *
+ * @param data - The buffer containing the tfhd box.
+ * @param offset - The byte offset of the tfhd box within the buffer.
+ * @param size - The total size of the tfhd box.
+ * @returns The parsed tfhd fields, or null if the box is malformed.
+ */
+function parseTfhd(data, offset, size) {
+    // Need at least the FullBox header (12 bytes) plus track_ID (4 bytes) = 16 bytes.
+    if (size < 16) {
+        return null;
+    }
+    const tfhdFlags = data.readUInt32BE(offset + 8) & 0x00FFFFFF;
+    const trackId = data.readUInt32BE(offset + 12);
+    // Walk past optional fields in order. Each field is present only if its corresponding flag bit is set.
+    let pos = offset + 16;
+    if (tfhdFlags & 0x000001) {
+        pos += 8;
+    }
+    if (tfhdFlags & 0x000002) {
+        pos += 4;
+    }
+    // Extract default_sample_duration if present.
+    let defaultSampleDuration = 0;
+    if (tfhdFlags & 0x000008) {
+        if ((pos + 4) > (offset + size)) {
+            return null;
+        }
+        defaultSampleDuration = data.readUInt32BE(pos);
+        pos += 4;
+    }
+    // Skip default_sample_size.
+    if (tfhdFlags & 0x000010) {
+        pos += 4;
+    }
+    // Extract default_sample_flags if present.
+    let defaultSampleFlags = null;
+    if (tfhdFlags & 0x000020) {
+        if ((pos + 4) > (offset + size)) {
+            return null;
+        }
+        defaultSampleFlags = data.readUInt32BE(pos);
+    }
+    return { defaultSampleDuration, defaultSampleFlags, trackId };
+}
+/**
+ * Extracts the sample flags for the first sample in a trun (track fragment run) box. The flags are resolved from three sources in priority order:
+ *
+ * 1. first_sample_flags field in the trun (trun flags bit 0x004) — explicitly overrides the first sample's flags.
+ * 2. Per-sample flags from the first sample entry (trun flags bit 0x400) — individual sample flags are present in each entry.
+ * 3. default_sample_flags from the parent tfhd — applies when neither first_sample_flags nor per-sample flags are available.
+ *
+ * trun layout (FullBox):
+ * - [0-3] size, [4-7] "trun", [8] version, [9-11] flags, [12-15] sample_count
+ * - Optional fields after sample_count:
+ *   0x001: data_offset (4 bytes)
+ *   0x004: first_sample_flags (4 bytes)
+ * - Per-sample entries (each containing optional fields based on flags):
+ *   0x100: sample_duration (4 bytes)
+ *   0x200: sample_size (4 bytes)
+ *   0x400: sample_flags (4 bytes)
+ *   0x800: sample_composition_time_offset (4 bytes)
+ *
+ * @param data - The buffer containing the trun box.
+ * @param offset - The byte offset of the trun box within the buffer.
+ * @param size - The total size of the trun box.
+ * @param defaultSampleFlags - The default_sample_flags from the parent tfhd, or null if not present.
+ * @returns The resolved sample flags for the first sample, or null if no source is available.
+ */
+function extractFirstSampleFlags(data, offset, size, defaultSampleFlags) {
+    // Need at least the FullBox header (12 bytes) plus sample_count (4 bytes) = 16 bytes.
+    if (size < 16) {
+        return null;
+    }
+    const trunFlags = data.readUInt32BE(offset + 8) & 0x00FFFFFF;
+    const sampleCount = data.readUInt32BE(offset + 12);
+    // No samples means no flags to extract.
+    if (sampleCount === 0) {
+        return null;
+    }
+    let pos = offset + 16;
+    // Skip optional data_offset field.
+    if (trunFlags & 0x001) {
+        pos += 4;
+    }
+    // Primary source: first_sample_flags field overrides the first sample's flags when present.
+    if (trunFlags & 0x004) {
+        if ((pos + 4) > (offset + size)) {
+            return null;
+        }
+        return data.readUInt32BE(pos);
+    }
+    // Secondary source: per-sample flags from the first sample entry. The per-sample entry fields appear in order: duration (0x100), size (0x200), flags (0x400),
+    // composition_time_offset (0x800). We skip duration and size to reach the flags field of the first entry.
+    if (trunFlags & 0x400) {
+        // Skip first_sample_flags field position (it's not present since we checked 0x004 above, but the pos is already past it).
+        if (trunFlags & 0x100) {
+            pos += 4;
+        }
+        if (trunFlags & 0x200) {
+            pos += 4;
+        }
+        if ((pos + 4) > (offset + size)) {
+            return null;
+        }
+        return data.readUInt32BE(pos);
+    }
+    // Tertiary source: default_sample_flags from the parent tfhd.
+    return defaultSampleFlags;
+}
+/**
+ * Detects whether a moof box starts with a keyframe (sync sample) by examining the sample flags of the first sample in each trun box. The detection inspects all traf
+ * boxes within the moof to handle multi-track containers (e.g., separate audio and video tracks). A non-keyframe signal from any traf (sample_depends_on === 2) takes
+ * precedence because audio tracks are always independently decodable — the only source of sample_depends_on === 2 is a non-keyframe video track. This avoids needing
+ * to map track IDs back to the moov box's codec metadata.
+ *
+ * The function checks three flag sources in priority order per the ISO 14496-12 spec: trun first_sample_flags (0x004), trun per-sample flags (0x400), and tfhd
+ * default_sample_flags (0x020).
+ *
+ * @param moofData - The complete moof box buffer including its 8-byte header.
+ * @returns true if the moof starts with a keyframe, false if it starts with a non-keyframe, or null if the flags could not be determined.
+ */
+export function detectMoofKeyframe(moofData) {
+    let hasExplicitKeyframe = false;
+    let hasExplicitNonKeyframe = false;
+    // Walk the moof's child boxes looking for traf (track fragment) boxes.
+    iterateChildBoxes(moofData, (type, data, offset, size) => {
+        if (type !== "traf") {
+            return;
+        }
+        // Create a subarray for this traf so we can iterate its child boxes. Buffer.subarray() shares memory with the parent, so this is O(1) with no data copying.
+        const trafData = data.subarray(offset, offset + size);
+        let defaultSampleFlags = null;
+        // Walk the traf's child boxes. We need tfhd for default_sample_flags (fallback) and trun for the actual first-sample flags. tfhd always precedes trun in the
+        // spec-mandated box ordering, so defaultSampleFlags will be populated before any trun is processed.
+        iterateChildBoxes(trafData, (childType, childData, childOffset, childSize) => {
+            if (childType === "tfhd") {
+                defaultSampleFlags = parseTfhd(childData, childOffset, childSize)?.defaultSampleFlags ?? null;
+            }
+            else if (childType === "trun") {
+                const sampleFlags = extractFirstSampleFlags(childData, childOffset, childSize, defaultSampleFlags);
+                if (sampleFlags !== null) {
+                    const isKeyframe = evaluateSampleFlags(sampleFlags);
+                    if (isKeyframe) {
+                        hasExplicitKeyframe = true;
+                    }
+                    else {
+                        hasExplicitNonKeyframe = true;
+                    }
+                }
+            }
+        });
+    });
+    // A non-keyframe traf (video track with sample_depends_on === 2) overrides keyframe trafs. Audio tracks are always sync (sample_depends_on 0 or 1), so the presence
+    // of any non-keyframe signal is the definitive indicator that this fragment does not start with a video keyframe. TypeScript's control flow analysis cannot track
+    // mutations made inside the iterateChildBoxes callback, so these variables appear "always falsy" to the linter despite being set to true at runtime.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (hasExplicitNonKeyframe) {
+        return false;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (hasExplicitKeyframe) {
+        return true;
+    }
+    // No definitive signal from any traf.
+    return null;
+}
+// Timestamp Rewriting.
+/**
+ * Computes the total duration of all samples in a trun (track fragment run) box. The duration is the sum of per-sample durations when present (trun flags bit 0x100),
+ * or sampleCount * defaultSampleDuration as a fallback. The result is returned as a BigInt for safe accumulation into the 64-bit timestamp counter.
+ *
+ * trun layout (FullBox):
+ * - [0-3] size, [4-7] "trun", [8] version, [9-11] flags, [12-15] sample_count
+ * - Optional fields after sample_count:
+ *   0x001: data_offset (4 bytes)
+ *   0x004: first_sample_flags (4 bytes)
+ * - Per-sample entries (each containing optional fields based on flags):
+ *   0x100: sample_duration (4 bytes)
+ *   0x200: sample_size (4 bytes)
+ *   0x400: sample_flags (4 bytes)
+ *   0x800: sample_composition_time_offset (4 bytes)
+ *
+ * @param data - The buffer containing the trun box.
+ * @param offset - The byte offset of the trun box within the buffer.
+ * @param size - The total size of the trun box.
+ * @param defaultSampleDuration - The default sample duration from the parent tfhd, used when per-sample durations are absent.
+ * @returns The total duration of all samples as a BigInt, or 0n if the box is malformed or empty.
+ */
+function extractTrunTotalDuration(data, offset, size, defaultSampleDuration) {
+    // Need at least the FullBox header (12 bytes) plus sample_count (4 bytes) = 16 bytes.
+    if (size < 16) {
+        return 0n;
+    }
+    const trunFlags = data.readUInt32BE(offset + 8) & 0x00FFFFFF;
+    const sampleCount = data.readUInt32BE(offset + 12);
+    if (sampleCount === 0) {
+        return 0n;
+    }
+    // If per-sample durations are not present, use defaultSampleDuration * sampleCount.
+    if (!(trunFlags & 0x100)) {
+        return BigInt(defaultSampleDuration) * BigInt(sampleCount);
+    }
+    // Compute the byte size of each per-sample entry from the trun flags. Each optional field adds 4 bytes to the entry. The duration field (0x100) is always present
+    // here because we returned early above when it was not set.
+    let entrySize = 4;
+    if (trunFlags & 0x200) {
+        entrySize += 4;
+    }
+    if (trunFlags & 0x400) {
+        entrySize += 4;
+    }
+    if (trunFlags & 0x800) {
+        entrySize += 4;
+    }
+    // Walk past the optional header fields to reach the sample entries.
+    let pos = offset + 16;
+    if (trunFlags & 0x001) {
+        pos += 4;
+    }
+    if (trunFlags & 0x004) {
+        pos += 4;
+    }
+    // Sum per-sample durations. The duration field is the first field in each entry (when present), since entry fields appear in order: duration, size, flags,
+    // composition_time_offset.
+    let totalDuration = 0n;
+    const endPos = offset + size;
+    for (let i = 0; i < sampleCount; i++) {
+        if ((pos + 4) > endPos) {
+            break;
+        }
+        totalDuration += BigInt(data.readUInt32BE(pos));
+        pos += entrySize;
+    }
+    return totalDuration;
+}
+/**
+ * Rewrites the baseMediaDecodeTime in every tfdt box within a moof to produce monotonically increasing timestamps. For each traf, the function reads the track ID from
+ * tfhd, writes the current per-track timestamp into tfdt, then advances the counter by the total sample duration extracted from trun. This eliminates timestamp
+ * discontinuities caused by capture restarts (tab replacement, source reload recovery) because Chrome's original timestamps are completely overwritten.
+ *
+ * The rewrite is done in-place on the moof buffer. This is safe because the buffer is an owned copy created by the MP4 box parser (Buffer.from() in createMP4BoxParser).
+ *
+ * Per-track state is necessary because FFmpeg outputs separate moof+mdat pairs for audio and video, and each track may have a different timescale (e.g., 90000 for
+ * video, 48000 for audio). A single counter would produce incorrect timestamps for one track.
+ *
+ * @param moofData - The complete moof box buffer including its 8-byte header. Modified in place.
+ * @param trackTimestamps - Map from track_ID to the next baseMediaDecodeTime value. Updated in place with the advanced timestamps after rewriting.
+ * @returns Map from track_ID to the total duration (in timescale units) computed from trun sample durations. The caller uses this for diagnostics (zero durations
+ * indicate trun parsing issues) and sanity checking (abnormal durations from corrupt trun data). Each entry corresponds to one traf box in the moof.
+ */
+export function rewriteMoofTimestamps(moofData, trackTimestamps) {
+    const trafDurations = new Map();
+    // Walk the moof's child boxes looking for traf (track fragment) boxes.
+    iterateChildBoxes(moofData, (type, data, offset, size) => {
+        if (type !== "traf") {
+            return;
+        }
+        // Create a subarray for this traf so we can iterate its child boxes. Buffer.subarray() shares memory with the parent, so this is O(1) with no data copying.
+        const trafData = data.subarray(offset, offset + size);
+        let tfhdInfo = null;
+        let totalDuration = 0n;
+        // Walk the traf's child boxes. The spec mandates tfhd before tfdt before trun, so we process them in order. The first pass extracts tfhd info and rewrites
+        // tfdt. The trun duration extraction happens in the same pass since tfhd is already available by the time trun is encountered.
+        iterateChildBoxes(trafData, (childType, childData, childOffset, childSize) => {
+            if (childType === "tfhd") {
+                tfhdInfo = parseTfhd(childData, childOffset, childSize);
+            }
+            else if (childType === "tfdt") {
+                // Rewrite baseMediaDecodeTime with the current per-track timestamp. The tfhd must precede tfdt per the ISO 14496-12 box ordering, so tfhdInfo is
+                // available here.
+                if (!tfhdInfo) {
+                    return;
+                }
+                const currentTimestamp = trackTimestamps.get(tfhdInfo.trackId) ?? 0n;
+                // tfdt layout (FullBox): [0-3] size, [4-7] "tfdt", [8] version, [9-11] flags, [12+] baseMediaDecodeTime.
+                // Version 0: 32-bit baseMediaDecodeTime at offset 12. Version 1: 64-bit baseMediaDecodeTime at offset 12.
+                if (childSize < 16) {
+                    return;
+                }
+                const version = childData.readUInt8(childOffset + 8);
+                if (version === 0) {
+                    // Version 0: write as uint32 (truncate to 32 bits). Overflows at ~13 hours for 90000 Hz timescale, but version 0 tfdt boxes are inherently 32-bit.
+                    childData.writeUInt32BE(Number(currentTimestamp & 0xffffffffn), childOffset + 12);
+                }
+                else {
+                    // Version 1: write as uint64 (high 32 bits + low 32 bits). Requires at least 20 bytes in the tfdt box.
+                    if (childSize < 20) {
+                        return;
+                    }
+                    const high = Number((currentTimestamp >> 32n) & 0xffffffffn);
+                    const low = Number(currentTimestamp & 0xffffffffn);
+                    childData.writeUInt32BE(high, childOffset + 12);
+                    childData.writeUInt32BE(low, childOffset + 16);
+                }
+            }
+            else if (childType === "trun") {
+                // Accumulate sample durations from each trun. A traf can contain multiple trun boxes (though rare in practice). The tfhd must precede trun per spec
+                // ordering, so tfhdInfo and its defaultSampleDuration are available here.
+                if (tfhdInfo) {
+                    totalDuration += extractTrunTotalDuration(childData, childOffset, childSize, tfhdInfo.defaultSampleDuration);
+                }
+            }
+        });
+        // Advance the per-track timestamp counter by the total sample duration from this traf. A zero duration with a valid tfhd indicates a trun parsing issue —
+        // the caller should log a warning. We still advance (by zero) to avoid corrupting subsequent timestamps. TypeScript's control flow analysis cannot track
+        // mutations made inside the iterateChildBoxes callback, so tfhdInfo appears "always null" to the linter despite being set at runtime.
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (tfhdInfo) {
+            const info = tfhdInfo;
+            trafDurations.set(info.trackId, totalDuration);
+            const currentTimestamp = trackTimestamps.get(info.trackId) ?? 0n;
+            trackTimestamps.set(info.trackId, currentTimestamp + totalDuration);
+        }
+    });
+    return trafDurations;
+}
+// Moov Timescale Extraction.
+/**
+ * Extracts per-track timescale values from a moov (movie header) box. Each track in the moov contains a tkhd box with the track_ID and an mdia > mdhd box with the
+ * timescale. The timescale converts sample durations (in timescale units) to real seconds: seconds = duration / timescale. For example, a timescale of 16000 means
+ * each unit is 1/16000 of a second.
+ *
+ * Parsing path: moov > trak > { tkhd (track_ID), mdia > mdhd (timescale) }
+ *
+ * @param moovData - The complete moov box buffer including its 8-byte header.
+ * @returns Map from track_ID to timescale. Empty if no valid tracks are found.
+ */
+export function parseMoovTimescales(moovData) {
+    const result = new Map();
+    // Walk the moov's child boxes looking for trak (track) boxes.
+    iterateChildBoxes(moovData, (type, data, offset, size) => {
+        if (type !== "trak") {
+            return;
+        }
+        const trakData = data.subarray(offset, offset + size);
+        let trackId = null;
+        let timescale = null;
+        // Walk the trak's child boxes to find tkhd (track header) and mdia (media container). The spec mandates tkhd before mdia, so trackId is available before we
+        // need it, but we don't depend on ordering — both are extracted independently and combined after iteration.
+        iterateChildBoxes(trakData, (childType, childData, childOffset, childSize) => {
+            if (childType === "tkhd") {
+                // tkhd layout (FullBox): [0-3] size, [4-7] "tkhd", [8] version, [9-11] flags.
+                // Version 0: [12-15] creation_time, [16-19] modification_time, [20-23] track_ID.
+                // Version 1: [12-19] creation_time, [20-27] modification_time, [28-31] track_ID.
+                if (childSize < 16) {
+                    return;
+                }
+                const version = childData.readUInt8(childOffset + 8);
+                if ((version === 0) && (childSize >= 24)) {
+                    trackId = childData.readUInt32BE(childOffset + 20);
+                }
+                else if ((version === 1) && (childSize >= 32)) {
+                    trackId = childData.readUInt32BE(childOffset + 28);
+                }
+            }
+            else if (childType === "mdia") {
+                // Walk the mdia's child boxes to find mdhd (media header) which contains the timescale.
+                const mdiaData = childData.subarray(childOffset, childOffset + childSize);
+                iterateChildBoxes(mdiaData, (mdiaChildType, mdiaChildData, mdiaChildOffset, mdiaChildSize) => {
+                    if (mdiaChildType !== "mdhd") {
+                        return;
+                    }
+                    // mdhd layout (FullBox): [0-3] size, [4-7] "mdhd", [8] version, [9-11] flags.
+                    // Version 0: [12-15] creation_time, [16-19] modification_time, [20-23] timescale.
+                    // Version 1: [12-19] creation_time, [20-27] modification_time, [28-31] timescale.
+                    if (mdiaChildSize < 16) {
+                        return;
+                    }
+                    const mdhdVersion = mdiaChildData.readUInt8(mdiaChildOffset + 8);
+                    if ((mdhdVersion === 0) && (mdiaChildSize >= 24)) {
+                        timescale = mdiaChildData.readUInt32BE(mdiaChildOffset + 20);
+                    }
+                    else if ((mdhdVersion === 1) && (mdiaChildSize >= 32)) {
+                        timescale = mdiaChildData.readUInt32BE(mdiaChildOffset + 28);
+                    }
+                });
+            }
+        });
+        // Store the track if both trackId and timescale were successfully extracted. TypeScript's control flow analysis cannot track mutations made inside the
+        // iterateChildBoxes callbacks, so these variables appear "always null" to the linter despite being set at runtime.
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if ((trackId !== null) && (timescale !== null) && (timescale > 0)) {
+            result.set(trackId, timescale);
+        }
+    });
+    return result;
+}
+//# sourceMappingURL=mp4Parser.js.map

package/dist/streaming/mp4Parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mp4Parser.js","sourceRoot":"","sources":["../../src/streaming/mp4Parser.ts"],"names":[],"mappings":"AAuDA,aAAa;AAEb,oDAAoD;AACpD,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,mFAAmF;AACnF,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,oBAAoB;AAEpB;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IAEtD,2CAA2C;IAC3C,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE7B;;OAEG;IACH,SAAS,aAAa;QAEpB,gEAAgE;QAChE,OAAM,MAAM,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;YAEvC,uCAAuC;YACvC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAEzC,6BAA6B;YAC7B,IAAI,OAAe,CAAC;YACpB,IAAI,UAAkB,CAAC;YAEvB,IAAG,SAAS,KAAK,CAAC,EAAE,CAAC;gBAEnB,gDAAgD;gBAChD,IAAG,MAAM,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;oBAExC,2CAA2C;oBAC3C,OAAO;gBACT,CAAC;gBAED,4JAA4J;gBAC5J,0DAA0D;gBAC1D,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAChD,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBAEhD,+CAA+C;gBAC/C,IAAG,gBAAgB,GAAG,CAAC,EAAE,CAAC;oBAExB,kHAAkH;oBAClH,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;oBAE5B,SAAS;gBACX,CAAC;gBAED,OAAO,GAAG,eAAe,CAAC;gBAC1B,UAAU,GAAG,oBAAoB,CAAC;YACpC,CAAC;iBAAM,IAAG,SAAS,KAAK,CAAC,EAAE,CAAC;gBAE1B,sGAAsG;gBACtG,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAE5B,SAAS;YACX,CAAC;iBAAM,CAAC;gBAEN,OAAO,GAAG,SAAS,CAAC;gBACpB,UAAU,GAAG,eAAe,CAAC;YAC/B,CAAC;YAED,2DAA2D;YAC3D,IAAG,OAAO,GAAG,UAAU,EAAE,CAAC;gBAExB,gDAAgD;gBAChD,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAE5B,SAAS;YACX,CAAC;YAED,qCAAqC;YACrC,IAAG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;gBAE3B,uBAAuB;gBACvB,OAAO;YACT,CAAC;YAED,4BAA4B;YAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAE/C,gBAAgB;YAChB,KAAK,CAAC;gBAEJ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,OAAO;aACd,CAAC,CAAC;YAEH,oCAAoC;YACpC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO;QAEL,KAAK,EAAE,GAAS,EAAE;YAEhB,6EAA6E;YAC7E,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,EAAE,CAAC,KAAa,EAAQ,EAAE;YAE5B,sCAAsC;YACtC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,MAAM,EAAE,KAAK,CAAE,CAAC,CAAC;YAE1C,+BAA+B;YAC/B,aAAa,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,sBAAsB;AAEtB;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAA4E;IAE1H,IAAI,GAAG,GAAG,eAAe,CAAC;IAE1B,OAAM,CAAC,GAAG,GAAG,eAAe,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAE7C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,OAAe,CAAC;QAEpB,IAAG,SAAS,KAAK,CAAC,EAAE,CAAC;YAEnB,wDAAwD;YACxD,IAAG,CAAC,GAAG,GAAG,oBAAoB,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBAE9C,OAAO;YACT,CAAC;YAED,wCAAwC;YACxC,IAAG,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBAElC,OAAO;YACT,CAAC;YAED,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,IAAG,CAAC,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YAE7D,6DAA6D;YAC7D,OAAO;QACT,CAAC;aAAM,CAAC;YAEN,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;QAED,+CAA+C;QAC/C,IAAG,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAEjC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAEzD,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAEtC,GAAG,IAAI,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,sBAAsB;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,mBAAmB,CAAC,KAAa;IAExC,MAAM,eAAe,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAExC,2GAA2G;IAC3G,IAAG,eAAe,KAAK,CAAC,EAAE,CAAC;QAEzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kHAAkH;IAClH,IAAG,eAAe,KAAK,CAAC,EAAE,CAAC;QAEzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,IAAG,SAAS,KAAK,CAAC,EAAE,CAAC;QAEnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8GAA8G;IAC9G,OAAO,IAAI,CAAC;AACd,CAAC;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY;IAE3D,kFAAkF;IAClF,IAAG,IAAI,GAAG,EAAE,EAAE,CAAC;QAEb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAE/C,uGAAuG;IACvG,IAAI,GAAG,GAAG,MAAM,GAAG,EAAE,CAAC;IAEtB,IAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;QAExB,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,IAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;QAExB,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,8CAA8C;IAC9C,IAAI,qBAAqB,GAAG,CAAC,CAAC;IAE9B,IAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;QAExB,IAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YAE/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,qBAAqB,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC/C,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,4BAA4B;IAC5B,IAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;QAExB,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,2CAA2C;IAC3C,IAAI,kBAAkB,GAAqB,IAAI,CAAC;IAEhD,IAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;QAExB,IAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YAE/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kBAAkB,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAS,uBAAuB,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY,EAAE,kBAAoC;IAE/G,sFAAsF;IACtF,IAAG,IAAI,GAAG,EAAE,EAAE,CAAC;QAEb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC;IAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAEnD,wCAAwC;IACxC,IAAG,WAAW,KAAK,CAAC,EAAE,CAAC;QAErB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,GAAG,GAAG,MAAM,GAAG,EAAE,CAAC;IAEtB,mCAAmC;IACnC,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,4FAA4F;IAC5F,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,IAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YAE/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,8JAA8J;IAC9J,0GAA0G;IAC1G,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,0HAA0H;QAC1H,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;YAErB,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QAED,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;YAErB,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QAED,IAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YAE/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,8DAA8D;IAC9D,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAEjD,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,IAAI,sBAAsB,GAAG,KAAK,CAAC;IAEnC,uEAAuE;IACvE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAEvD,IAAG,IAAI,KAAK,MAAM,EAAE,CAAC;YAEnB,OAAO;QACT,CAAC;QAED,4JAA4J;QAC5J,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;QAEtD,IAAI,kBAAkB,GAAqB,IAAI,CAAC;QAEhD,6JAA6J;QAC7J,oGAAoG;QACpG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;YAE3E,IAAG,SAAS,KAAK,MAAM,EAAE,CAAC;gBAExB,kBAAkB,GAAG,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,kBAAkB,IAAI,IAAI,CAAC;YAChG,CAAC;iBAAM,IAAG,SAAS,KAAK,MAAM,EAAE,CAAC;gBAE/B,MAAM,WAAW,GAAG,uBAAuB,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;gBAEnG,IAAG,WAAW,KAAK,IAAI,EAAE,CAAC;oBAExB,MAAM,UAAU,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;oBAEpD,IAAG,UAAU,EAAE,CAAC;wBAEd,mBAAmB,GAAG,IAAI,CAAC;oBAC7B,CAAC;yBAAM,CAAC;wBAEN,sBAAsB,GAAG,IAAI,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,oKAAoK;IACpK,kKAAkK;IAClK,qJAAqJ;IACrJ,uEAAuE;IACvE,IAAG,sBAAsB,EAAE,CAAC;QAE1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uEAAuE;IACvE,IAAG,mBAAmB,EAAE,CAAC;QAEvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uBAAuB;AAEvB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAS,wBAAwB,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY,EAAE,qBAA6B;IAEzG,sFAAsF;IACtF,IAAG,IAAI,GAAG,EAAE,EAAE,CAAC;QAEb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC;IAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAEnD,IAAG,WAAW,KAAK,CAAC,EAAE,CAAC;QAErB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,oFAAoF;IACpF,IAAG,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC;QAExB,OAAO,MAAM,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED,kKAAkK;IAClK,4DAA4D;IAC5D,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,SAAS,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,SAAS,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,SAAS,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,oEAAoE;IACpE,IAAI,GAAG,GAAG,MAAM,GAAG,EAAE,CAAC;IAEtB,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,IAAG,SAAS,GAAG,KAAK,EAAE,CAAC;QAErB,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,2JAA2J;IAC3J,2BAA2B;IAC3B,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE7B,KAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QAEpC,IAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;YAEtB,MAAM;QACR,CAAC;QAED,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,GAAG,IAAI,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,eAAoC;IAE1F,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,uEAAuE;IACvE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAEvD,IAAG,IAAI,KAAK,MAAM,EAAE,CAAC;YAEnB,OAAO;QACT,CAAC;QAED,4JAA4J;QAC5J,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;QAEtD,IAAI,QAAQ,GAAuB,IAAI,CAAC;QACxC,IAAI,aAAa,GAAG,EAAE,CAAC;QAEvB,2JAA2J;QAC3J,+HAA+H;QAC/H,iBAAiB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;YAE3E,IAAG,SAAS,KAAK,MAAM,EAAE,CAAC;gBAExB,QAAQ,GAAG,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;YAC1D,CAAC;iBAAM,IAAG,SAAS,KAAK,MAAM,EAAE,CAAC;gBAE/B,iJAAiJ;gBACjJ,kBAAkB;gBAClB,IAAG,CAAC,QAAQ,EAAE,CAAC;oBAEb,OAAO;gBACT,CAAC;gBAED,MAAM,gBAAgB,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAErE,yGAAyG;gBACzG,0GAA0G;gBAC1G,IAAG,SAAS,GAAG,EAAE,EAAE,CAAC;oBAElB,OAAO;gBACT,CAAC;gBAED,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;gBAErD,IAAG,OAAO,KAAK,CAAC,EAAE,CAAC;oBAEjB,mJAAmJ;oBACnJ,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,gBAAgB,GAAG,WAAW,CAAC,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;gBACpF,CAAC;qBAAM,CAAC;oBAEN,uGAAuG;oBACvG,IAAG,SAAS,GAAG,EAAE,EAAE,CAAC;wBAElB,OAAO;oBACT,CAAC;oBAED,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,gBAAgB,IAAI,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;oBAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,GAAG,WAAW,CAAC,CAAC;oBAEnD,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;oBAChD,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;iBAAM,IAAG,SAAS,KAAK,MAAM,EAAE,CAAC;gBAE/B,oJAAoJ;gBACpJ,0EAA0E;gBAC1E,IAAG,QAAQ,EAAE,CAAC;oBAEZ,aAAa,IAAI,wBAAwB,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;gBAC/G,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,0JAA0J;QAC1J,yJAAyJ;QACzJ,sIAAsI;QACtI,uEAAuE;QACvE,IAAG,QAAQ,EAAE,CAAC;YAEZ,MAAM,IAAI,GAAG,QAAoB,CAAC;YAElC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAE/C,MAAM,gBAAgB,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAEjE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,6BAA6B;AAE7B;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAElD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,8DAA8D;IAC9D,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAEvD,IAAG,IAAI,KAAK,MAAM,EAAE,CAAC;YAEnB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;QAEtD,IAAI,OAAO,GAAqB,IAAI,CAAC;QACrC,IAAI,SAAS,GAAqB,IAAI,CAAC;QAEvC,4JAA4J;QAC5J,4GAA4G;QAC5G,iBAAiB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;YAE3E,IAAG,SAAS,KAAK,MAAM,EAAE,CAAC;gBAExB,8EAA8E;gBAC9E,iFAAiF;gBACjF,iFAAiF;gBACjF,IAAG,SAAS,GAAG,EAAE,EAAE,CAAC;oBAElB,OAAO;gBACT,CAAC;gBAED,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;gBAErD,IAAG,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;oBAExC,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;gBACrD,CAAC;qBAAM,IAAG,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;oBAE/C,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;iBAAM,IAAG,SAAS,KAAK,MAAM,EAAE,CAAC;gBAE/B,wFAAwF;gBACxF,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC;gBAE1E,iBAAiB,CAAC,QAAQ,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,EAAE;oBAE3F,IAAG,aAAa,KAAK,MAAM,EAAE,CAAC;wBAE5B,OAAO;oBACT,CAAC;oBAED,8EAA8E;oBAC9E,kFAAkF;oBAClF,kFAAkF;oBAClF,IAAG,aAAa,GAAG,EAAE,EAAE,CAAC;wBAEtB,OAAO;oBACT,CAAC;oBAED,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;oBAEjE,IAAG,CAAC,WAAW,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;wBAEhD,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;oBAC/D,CAAC;yBAAM,IAAG,CAAC,WAAW,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;wBAEvD,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,uJAAuJ;QACvJ,mHAAmH;QACnH,uEAAuE;QACvE,IAAG,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;YAEjE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/streaming/mpegts.d.ts

@@ -0,0 +1,14 @@
+import type { Request, Response } from "express";
+/**
+ * Handles MPEG-TS stream requests. Validates the channel, flushes HTTP headers early for new streams, then ensures a capture is running, waits for the init segment,
+ * spawns a per-client FFmpeg remuxer, and streams the output.
+ *
+ * For new streams, headers are flushed before stream setup begins so the client sees an immediate 200 response. This prevents timeout failures during the 4-10+
+ * second startup sequence. The trade-off is that error responses cannot be sent after the flush — failures are logged server-side and the connection is closed.
+ *
+ * Route: GET /stream/:name
+ *
+ * @param req - Express request object.
+ * @param res - Express response object.
+ */
+export declare function handleMpegTsStream(req: Request, res: Response): Promise<void>;