@meframe/core 0.0.29 → 0.0.30-beta

package/dist/stages/demux/MP4Demuxer.js

@@ -0,0 +1,281 @@
+import "../../node_modules/.pnpm/mp4box@0.5.4/node_modules/mp4box/dist/mp4box.all.js";
+import { __exports as mp4box_all } from "../../_virtual/mp4box.all.js";
+function normalizeAudioCodec(codec) {
+  if (!codec) return "mp4a.40.2";
+  if (codec === "mp4a") {
+    return "mp4a.40.2";
+  }
+  return codec;
+}
+class MP4Demuxer {
+  mp4boxFile;
+  tracks = /* @__PURE__ */ new Map();
+  isReady = false;
+  videoController;
+  audioController;
+  demuxHighWaterMark;
+  onReadyCallback;
+  fileOffset = 0;
+  videoTimestampOffset = null;
+  audioTimestampOffset = null;
+  skipAudio = false;
+  constructor(config = {}) {
+    this.mp4boxFile = mp4box_all.createFile();
+    this.onReadyCallback = config.onReady;
+    this.skipAudio = config.skipAudio ?? false;
+    const DEFAULT_HIGH_WATER_MARK = 10;
+    this.demuxHighWaterMark = config.highWaterMark ?? DEFAULT_HIGH_WATER_MARK;
+    this.setupHandlers();
+  }
+  updateConfig(config) {
+    this.demuxHighWaterMark = config.highWaterMark ?? this.demuxHighWaterMark;
+  }
+  setupHandlers() {
+    this.mp4boxFile.onError = (error) => {
+      console.error("[MP4Demuxer] MP4Box error:", error);
+      const err = new Error(error);
+      this.videoController?.error(err);
+      this.audioController?.error(err);
+    };
+    this.mp4boxFile.onReady = (info) => {
+      this.processTracks(info.tracks);
+      this.isReady = true;
+      if (this.onReadyCallback) {
+        this.onReadyCallback();
+      }
+      this.mp4boxFile.start();
+    };
+    this.mp4boxFile.onSamples = (trackId, _user, samples) => {
+      this.processSamples(trackId, samples);
+    };
+  }
+  processTracks(tracks) {
+    for (const track of tracks) {
+      const trackInfo = {
+        id: track.id,
+        type: track.type === "video" ? "video" : "audio",
+        codec: track.type === "audio" ? normalizeAudioCodec(track.codec) : track.codec,
+        timescale: track.timescale
+      };
+      if (track.type === "video") {
+        trackInfo.width = track.video?.width;
+        trackInfo.height = track.video?.height;
+        trackInfo.description = this.getVideoDescription(track);
+      } else if (track.type === "audio") {
+        trackInfo.sampleRate = track.audio?.sample_rate || track.timescale;
+        trackInfo.numberOfChannels = track.audio?.channel_count;
+        trackInfo.description = this.getAudioDescription(track);
+      }
+      this.tracks.set(track.id, trackInfo);
+      this.mp4boxFile.setExtractionOptions(track.id, track, {
+        nbSamples: Infinity
+      });
+    }
+  }
+  processSamples(trackId, samples) {
+    const track = this.tracks.get(trackId);
+    if (!track) return;
+    const timescale = track.timescale || 9e4;
+    for (const sample of samples) {
+      const rawTimestamp = sample.cts * 1e6 / timescale;
+      const duration = sample.duration * 1e6 / timescale;
+      if (track.type === "video") {
+        if (!this.videoController) {
+          console.error("[MP4Demuxer] videoController is null when trying to output chunk!");
+          return;
+        }
+        if (this.videoTimestampOffset === null) {
+          this.videoTimestampOffset = rawTimestamp;
+        }
+        const timestamp = rawTimestamp - this.videoTimestampOffset;
+        const chunk = new EncodedVideoChunk({
+          type: sample.is_sync ? "key" : "delta",
+          timestamp,
+          duration,
+          data: sample.data
+        });
+        this.videoController.enqueue(chunk);
+      } else if (track.type === "audio") {
+        if (!this.audioController) {
+          const last2 = samples[samples.length - 1].number;
+          this.mp4boxFile.releaseUsedSamples(trackId, last2 + 1);
+          return;
+        }
+        if (this.audioTimestampOffset === null) {
+          this.audioTimestampOffset = rawTimestamp;
+        }
+        const timestamp = rawTimestamp - this.audioTimestampOffset;
+        const chunk = new EncodedAudioChunk({
+          type: "key",
+          timestamp,
+          duration,
+          data: sample.data
+        });
+        this.audioController.enqueue(chunk);
+      }
+    }
+    const last = samples[samples.length - 1].number;
+    this.mp4boxFile.releaseUsedSamples(trackId, last + 1);
+  }
+  getVideoDescription(track) {
+    return MP4Demuxer.extractVideoDescription(this.mp4boxFile, track.id);
+  }
+  /**
+   * Extract video description (avcC/hvcC/etc) for VideoDecoder configuration
+   * Static method for reuse in other components
+   */
+  static extractVideoDescription(mp4boxFile, trackId) {
+    try {
+      const fullTrack = mp4boxFile.getTrackById(trackId);
+      for (const entry of fullTrack.mdia.minf.stbl.stsd.entries) {
+        const box = entry.avcC ?? entry.hvcC ?? entry.av1C ?? entry.vpcC;
+        if (box) {
+          const stream = new mp4box_all.DataStream(
+            void 0,
+            0,
+            mp4box_all.DataStream.BIG_ENDIAN
+            // IMPORTANT: must be BIG_ENDIAN
+          );
+          box.write(stream);
+          return new Uint8Array(stream.buffer.slice(8)).buffer;
+        }
+      }
+    } catch (error) {
+      console.error("Failed to get video description:", error);
+    }
+    return void 0;
+  }
+  // private getVideoDescription(track: any): ArrayBuffer | undefined {
+  //   if (!this.mp4boxFile) return undefined;
+  //   return getVideoDescription(this.mp4boxFile, track);
+  // }
+  getAudioDescription(track) {
+    try {
+      const fullTrack = this.mp4boxFile.getTrackById(track.id);
+      for (const entry of fullTrack.mdia.minf.stbl.stsd.entries) {
+        if (entry.esds) {
+          const decConfigDesc = entry.esds.esd?.descs?.[0];
+          const decSpecInfo = decConfigDesc?.descs?.[0];
+          if (decSpecInfo?.data) {
+            const data = decSpecInfo.data;
+            if (data instanceof Uint8Array) {
+              const buffer = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+              return buffer instanceof ArrayBuffer ? buffer : void 0;
+            } else if (Array.isArray(data)) {
+              return new Uint8Array(data).buffer;
+            }
+          }
+          console.warn("[MP4Demuxer] Could not extract AudioSpecificConfig from esds structure");
+          return void 0;
+        } else if (entry.dOps) {
+          const stream = new mp4box_all.DataStream(
+            void 0,
+            0,
+            mp4box_all.DataStream.BIG_ENDIAN
+          );
+          entry.dOps.write(stream);
+          return new Uint8Array(stream.buffer.slice(8)).buffer;
+        }
+      }
+    } catch (error) {
+      console.error("Failed to get audio description:", error);
+    }
+    return void 0;
+  }
+  /**
+   * Create readable stream for video chunks (output only)
+   */
+  createVideoStream() {
+    return new ReadableStream(
+      {
+        start: (ctrl) => {
+          this.videoController = ctrl;
+        },
+        cancel: () => {
+          this.videoController = void 0;
+        }
+      },
+      {
+        highWaterMark: this.demuxHighWaterMark,
+        size: () => 1
+      }
+    );
+  }
+  /**
+   * Create readable stream for audio chunks (output only)
+   */
+  createAudioStream() {
+    if (this.skipAudio) {
+      return null;
+    }
+    return new ReadableStream(
+      {
+        start: (ctrl) => {
+          this.audioController = ctrl;
+        },
+        cancel: () => {
+          this.audioController = void 0;
+        }
+      },
+      {
+        highWaterMark: this.demuxHighWaterMark,
+        size: () => 1
+      }
+    );
+  }
+  /**
+   * Create writable stream for input data (single source)
+   * This is the only stream that should receive the input data
+   */
+  createInputStream() {
+    return new WritableStream(
+      {
+        write: (chunk) => {
+          const chunkData = new Uint8Array(chunk);
+          this.appendBuffer(chunkData);
+          this.mp4boxFile.flush();
+        },
+        close: async () => {
+          this.mp4boxFile.flush();
+          await new Promise((resolve) => setTimeout(resolve, 100));
+          this.videoController?.close();
+          this.audioController?.close();
+        }
+      },
+      {
+        highWaterMark: this.demuxHighWaterMark
+      }
+    );
+  }
+  appendBuffer(chunk) {
+    const buffer = chunk.buffer;
+    buffer.fileStart = this.fileOffset;
+    this.mp4boxFile.appendBuffer(buffer);
+    this.fileOffset += chunk.byteLength;
+  }
+  /**
+   * Get video track info if available
+   */
+  get videoTrackInfo() {
+    return Array.from(this.tracks.values()).find((track) => track.type === "video");
+  }
+  /**
+   * Get audio track info if available
+   */
+  get audioTrackInfo() {
+    return Array.from(this.tracks.values()).find((track) => track.type === "audio");
+  }
+  destroy() {
+    this.mp4boxFile?.stop();
+    this.mp4boxFile = null;
+    this.tracks.clear();
+    this.isReady = false;
+    this.videoTimestampOffset = null;
+    this.audioTimestampOffset = null;
+  }
+}
+export {
+  MP4Demuxer,
+  normalizeAudioCodec
+};
+//# sourceMappingURL=MP4Demuxer.js.map

package/dist/stages/demux/MP4Demuxer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MP4Demuxer.js","sources":["../../../src/stages/demux/MP4Demuxer.ts"],"sourcesContent":["import * as MP4Box from 'mp4box';\nimport type { DemuxConfig, TrackInfo } from './types';\n\n/**\n * Normalize audio codec string for WebCodecs compatibility\n * Fixes incomplete AAC codec strings from mp4box.js\n */\nexport function normalizeAudioCodec(codec?: string): string {\n  if (!codec) return 'mp4a.40.2'; // Default AAC-LC\n\n  // Incomplete mp4a → complete as AAC-LC\n  if (codec === 'mp4a') {\n    return 'mp4a.40.2';\n  }\n\n  // Already complete or other format, return as-is\n  return codec;\n}\n\n/**\n * MP4 Demuxer - Extract encoded chunks from MP4 container\n * Simplified implementation following Stream API pattern\n */\nexport class MP4Demuxer {\n  private mp4boxFile: any;\n  tracks = new Map<number, TrackInfo>();\n  isReady = false;\n  private videoController?: ReadableStreamDefaultController<EncodedVideoChunk>;\n  private audioController?: ReadableStreamDefaultController<EncodedAudioChunk>;\n  private demuxHighWaterMark: number;\n  private onReadyCallback?: () => void;\n  private fileOffset = 0;\n  private videoTimestampOffset: number | null = null;\n  private audioTimestampOffset: number | null = null;\n  private skipAudio: boolean = false;\n\n  constructor(config: DemuxConfig & { onReady?: () => void } = {}) {\n    this.mp4boxFile = MP4Box.createFile();\n    this.onReadyCallback = config.onReady;\n    this.skipAudio = config.skipAudio ?? false;\n\n    // Use provided config with local default as fallback\n    const DEFAULT_HIGH_WATER_MARK = 10; // Default for video chunks\n    this.demuxHighWaterMark = config.highWaterMark ?? DEFAULT_HIGH_WATER_MARK;\n\n    this.setupHandlers();\n  }\n\n  updateConfig(config: DemuxConfig): void {\n    this.demuxHighWaterMark = config.highWaterMark ?? this.demuxHighWaterMark;\n  }\n\n  private setupHandlers(): void {\n    this.mp4boxFile.onError = (error: string) => {\n      console.error('[MP4Demuxer] MP4Box error:', error);\n      const err = new Error(error);\n      this.videoController?.error(err);\n      this.audioController?.error(err);\n    };\n\n    this.mp4boxFile.onReady = (info: any) => {\n      this.processTracks(info.tracks);\n      this.isReady = true;\n\n      // Call the ready callback before starting\n      if (this.onReadyCallback) {\n        this.onReadyCallback();\n      }\n\n      // Start processing samples after callback\n      // Note: start() enables extraction, actual samples will be output\n      // when flush() is called (by TransformStream's flush callback)\n      this.mp4boxFile.start();\n    };\n\n    this.mp4boxFile.onSamples = (trackId: number, _user: any, samples: any[]) => {\n      this.processSamples(trackId, samples);\n    };\n  }\n\n  private processTracks(tracks: any[]): void {\n    for (const track of tracks) {\n      const trackInfo: TrackInfo = {\n        id: track.id,\n        type: track.type === 'video' ? 'video' : 'audio',\n        codec: track.type === 'audio' ? normalizeAudioCodec(track.codec) : track.codec,\n        timescale: track.timescale,\n      };\n\n      if (track.type === 'video') {\n        trackInfo.width = track.video?.width;\n        trackInfo.height = track.video?.height;\n        trackInfo.description = this.getVideoDescription(track);\n      } else if (track.type === 'audio') {\n        trackInfo.sampleRate = track.audio?.sample_rate || track.timescale;\n        trackInfo.numberOfChannels = track.audio?.channel_count;\n        trackInfo.description = this.getAudioDescription(track);\n      }\n\n      this.tracks.set(track.id, trackInfo);\n\n      // Configure extraction - use Infinity to extract all samples\n      // Note: onSamples will be called multiple times as data is appended,\n      // but we don't need to manually request more batches\n      this.mp4boxFile.setExtractionOptions(track.id, track, {\n        nbSamples: Infinity,\n      });\n    }\n  }\n\n  private processSamples(trackId: number, samples: any[]): void {\n    const track = this.tracks.get(trackId);\n    if (!track) return;\n\n    const timescale = track.timescale || 90000;\n    for (const sample of samples) {\n      const rawTimestamp = (sample.cts * 1000000) / timescale;\n      const duration = (sample.duration * 1000000) / timescale;\n\n      if (track.type === 'video') {\n        if (!this.videoController) {\n          console.error('[MP4Demuxer] videoController is null when trying to output chunk!');\n          // Should not happen - stream should be created before appendBuffer\n          return;\n        }\n\n        // Normalize timestamp: first frame starts at 0\n        if (this.videoTimestampOffset === null) {\n          this.videoTimestampOffset = rawTimestamp;\n        }\n        const timestamp = rawTimestamp - this.videoTimestampOffset;\n\n        const chunk = new EncodedVideoChunk({\n          type: sample.is_sync ? 'key' : 'delta',\n          timestamp,\n          duration,\n          data: sample.data,\n        });\n        this.videoController.enqueue(chunk);\n      } else if (track.type === 'audio') {\n        // Skip audio processing if skipAudio enabled or no controller\n        if (!this.audioController) {\n          // Still release samples immediately to avoid memory accumulation in mp4box.js\n          const last = samples[samples.length - 1].number;\n          this.mp4boxFile.releaseUsedSamples(trackId, last + 1);\n          return;\n        }\n\n        // Normalize timestamp: first frame starts at 0\n        if (this.audioTimestampOffset === null) {\n          this.audioTimestampOffset = rawTimestamp;\n        }\n        const timestamp = rawTimestamp - this.audioTimestampOffset;\n\n        const chunk = new EncodedAudioChunk({\n          type: 'key',\n          timestamp,\n          duration,\n          data: sample.data,\n        });\n        this.audioController.enqueue(chunk);\n      }\n    }\n\n    const last = samples[samples.length - 1].number;\n    // Release memory immediately\n    this.mp4boxFile.releaseUsedSamples(trackId, last + 1);\n  }\n\n  private getVideoDescription(track: any): ArrayBuffer | undefined {\n    return MP4Demuxer.extractVideoDescription(this.mp4boxFile, track.id);\n  }\n\n  /**\n   * Extract video description (avcC/hvcC/etc) for VideoDecoder configuration\n   * Static method for reuse in other components\n   */\n  static extractVideoDescription(mp4boxFile: any, trackId: number): ArrayBuffer | undefined {\n    try {\n      const fullTrack = mp4boxFile.getTrackById(trackId);\n      for (const entry of fullTrack.mdia.minf.stbl.stsd.entries) {\n        const box = entry.avcC ?? entry.hvcC ?? entry.av1C ?? entry.vpcC;\n        if (box) {\n          const stream = new (MP4Box as any).DataStream(\n            undefined,\n            0,\n            (MP4Box as any).DataStream.BIG_ENDIAN // IMPORTANT: must be BIG_ENDIAN\n          );\n          box.write(stream);\n          return new Uint8Array(stream.buffer.slice(8)).buffer;\n        }\n      }\n    } catch (error) {\n      console.error('Failed to get video description:', error);\n    }\n    return undefined;\n  }\n\n  // private getVideoDescription(track: any): ArrayBuffer | undefined {\n  //   if (!this.mp4boxFile) return undefined;\n  //   return getVideoDescription(this.mp4boxFile, track);\n  // }\n\n  private getAudioDescription(track: any): ArrayBuffer | undefined {\n    try {\n      const fullTrack = this.mp4boxFile.getTrackById(track.id);\n      for (const entry of fullTrack.mdia.minf.stbl.stsd.entries) {\n        if (entry.esds) {\n          // Use mp4box.js parsed structure to get AudioSpecificConfig\n          // esds.esd.descs[0] = DecoderConfigDescriptor\n          // esds.esd.descs[0].descs[0].data = DecoderSpecificInfo (AudioSpecificConfig)\n          const decConfigDesc = entry.esds.esd?.descs?.[0];\n          const decSpecInfo = decConfigDesc?.descs?.[0];\n\n          if (decSpecInfo?.data) {\n            // Convert Uint8Array to ArrayBuffer\n            const data = decSpecInfo.data;\n            if (data instanceof Uint8Array) {\n              const buffer = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);\n              return buffer instanceof ArrayBuffer ? buffer : undefined;\n            } else if (Array.isArray(data)) {\n              // Some versions of mp4box.js return Array instead of Uint8Array\n              return new Uint8Array(data).buffer;\n            }\n          }\n\n          console.warn('[MP4Demuxer] Could not extract AudioSpecificConfig from esds structure');\n          return undefined;\n        } else if (entry.dOps) {\n          // For Opus, use the full dOps box\n          const stream = new (MP4Box as any).DataStream(\n            undefined,\n            0,\n            (MP4Box as any).DataStream.BIG_ENDIAN\n          );\n          entry.dOps.write(stream);\n          return new Uint8Array(stream.buffer.slice(8)).buffer;\n        }\n      }\n    } catch (error) {\n      console.error('Failed to get audio description:', error);\n    }\n    return undefined;\n  }\n\n  /**\n   * Create readable stream for video chunks (output only)\n   */\n  createVideoStream(): ReadableStream<EncodedVideoChunk> {\n    return new ReadableStream<EncodedVideoChunk>(\n      {\n        start: (ctrl) => {\n          this.videoController = ctrl as any;\n        },\n        cancel: () => {\n          this.videoController = undefined;\n        },\n      },\n      {\n        highWaterMark: this.demuxHighWaterMark,\n        size: () => 1,\n      }\n    );\n  }\n\n  /**\n   * Create readable stream for audio chunks (output only)\n   */\n  createAudioStream(): ReadableStream<EncodedAudioChunk> | null {\n    if (this.skipAudio) {\n      return null;\n    }\n\n    return new ReadableStream<EncodedAudioChunk>(\n      {\n        start: (ctrl) => {\n          this.audioController = ctrl as any;\n        },\n        cancel: () => {\n          this.audioController = undefined;\n        },\n      },\n      {\n        highWaterMark: this.demuxHighWaterMark,\n        size: () => 1,\n      }\n    );\n  }\n\n  /**\n   * Create writable stream for input data (single source)\n   * This is the only stream that should receive the input data\n   */\n  createInputStream(): WritableStream<Uint8Array | ArrayBuffer> {\n    return new WritableStream<Uint8Array | ArrayBuffer>(\n      {\n        write: (chunk) => {\n          // Create a copy to avoid buffer reuse issues (required for mp4box 0.5.x)\n          const chunkData = new Uint8Array(chunk);\n          this.appendBuffer(chunkData);\n\n          // Flush after each append to trigger sample extraction immediately\n          this.mp4boxFile.flush();\n        },\n        close: async () => {\n          // Trigger final MP4Box flush\n          this.mp4boxFile.flush();\n\n          // Wait for MP4Box to complete sample extraction (onSamples callbacks)\n          await new Promise((resolve) => setTimeout(resolve, 100));\n          this.videoController?.close();\n          this.audioController?.close();\n        },\n      },\n      {\n        highWaterMark: this.demuxHighWaterMark,\n      }\n    );\n  }\n\n  appendBuffer(chunk: Uint8Array): void {\n    const buffer = chunk.buffer as ArrayBuffer & { fileStart: number };\n    buffer.fileStart = this.fileOffset;\n    this.mp4boxFile.appendBuffer(buffer);\n    this.fileOffset += chunk.byteLength;\n  }\n\n  /**\n   * Get video track info if available\n   */\n  get videoTrackInfo(): TrackInfo | undefined {\n    return Array.from(this.tracks.values()).find((track) => track.type === 'video');\n  }\n\n  /**\n   * Get audio track info if available\n   */\n  get audioTrackInfo(): TrackInfo | undefined {\n    return Array.from(this.tracks.values()).find((track) => track.type === 'audio');\n  }\n\n  destroy(): void {\n    this.mp4boxFile?.stop();\n    this.mp4boxFile = null;\n    this.tracks.clear();\n    this.isReady = false;\n    this.videoTimestampOffset = null;\n    this.audioTimestampOffset = null;\n  }\n}\n"],"names":["MP4Box.createFile","last","MP4Box.DataStream"],"mappings":"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"}

package/dist/stages/demux/MP4IndexParser.d.ts

@@ -0,0 +1,71 @@
+import { MP4Index } from './types';
+
+export interface MP4ParseResult {
+    index: MP4Index;
+    audioSamples?: EncodedAudioChunk[];
+    audioMetadata?: AudioDecoderConfig;
+}
+export interface ParseStreamOptions {
+    onFirstFrameReady?: (index: MP4Index, firstGOPChunks: EncodedVideoChunk[]) => void;
+}
+/**
+ * MP4IndexParser - Parse MP4 moov box and build time→byte index
+ *
+ * Features:
+ * - Stream-based moov parsing (stop after moov found)
+ * - Build sample table with byte offsets
+ * - Build GOP index for keyframe positions
+ * - Extract all audio samples (encoded) for memory caching
+ * - Extract first GOP for fast cover rendering
+ */
+export declare class MP4IndexParser {
+    /**
+     * Parse from streaming download
+     * Returns video index + all audio samples
+     * Can optionally extract first GOP for fast cover rendering
+     */
+    parseFromStream(stream: ReadableStream<Uint8Array>, options?: ParseStreamOptions): Promise<MP4ParseResult>;
+    private processStreamData;
+    private prepareBuffer;
+    private handleFirstGOPExtraction;
+    private setupAudioExtraction;
+    /**
+     * Parse from file/ArrayBuffer (for already cached resources)
+     */
+    parseFromFile(data: File | ArrayBuffer): Promise<MP4Index>;
+    /**
+     * Build MP4Index from mp4box.js parsed data
+     */
+    private buildIndex;
+    /**
+     * Build video track index with sample table and GOP boundaries
+     */
+    private buildVideoTrackIndex;
+    /**
+     * Build audio track index
+     */
+    private buildAudioTrackIndex;
+    /**
+     * Build sample table from mp4box track samples
+     *
+     * IMPORTANT: Keep samples in DTS (decode) order, not PTS (presentation) order!
+     * VideoDecoder requires chunks in decode order. It will output frames in PTS order.
+     */
+    private buildSampleTable;
+    /**
+     * Extract video description (avcC/hvcC/etc) for VideoDecoder
+     * Reuses MP4Demuxer.extractVideoDescription for consistency
+     */
+    private getVideoDescription;
+    /**
+     * Build GOP index from samples
+     * GOP = Group of Pictures, starts with a keyframe
+     */
+    private buildGOPIndex;
+    /**
+     * Extract first GOP chunks from accumulated buffer
+     * Used for fast cover rendering during streaming download
+     */
+    private extractFirstGOP;
+}
+//# sourceMappingURL=MP4IndexParser.d.ts.map

package/dist/stages/demux/MP4IndexParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MP4IndexParser.d.ts","sourceRoot":"","sources":["../../../src/stages/demux/MP4IndexParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAiD,MAAM,SAAS,CAAC;AAIvF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;CACpF;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB;;;;OAIG;IACG,eAAe,CACnB,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC;YAuKZ,iBAAiB;IA0C/B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,wBAAwB;IA6ChC,OAAO,CAAC,oBAAoB;IAmC5B;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiChE;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAwCxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAsCrB;;;OAGG;IACH,OAAO,CAAC,eAAe;CAkDxB"}