@meframe/core 0.0.32 → 0.0.34

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

@@ -1 +1 @@
-{"version":3,"file":"MP4IndexParser.js","sources":["../../../src/stages/demux/MP4IndexParser.ts"],"sourcesContent":["import { MP4Box } from '../../utils/mp4box';\nimport type { MP4BoxFile } from 'mp4box';\nimport type { MP4Index, VideoTrackIndex, AudioTrackIndex, Sample, GOP } from './types';\nimport type { TimeUs } from '../../model/types';\nimport { MP4Demuxer } from './MP4Demuxer';\n\nexport interface MP4ParseResult {\n  index: MP4Index;\n  audioSamples?: EncodedAudioChunk[];\n  audioMetadata?: AudioDecoderConfig;\n}\n\nexport interface ParseStreamOptions {\n  onFirstFrameReady?: (index: MP4Index, firstGOPChunks: EncodedVideoChunk[]) => void;\n}\n\n/**\n * MP4IndexParser - Parse MP4 moov box and build time→byte index\n *\n * Features:\n * - Stream-based moov parsing (stop after moov found)\n * - Build sample table with byte offsets\n * - Build GOP index for keyframe positions\n * - Extract all audio samples (encoded) for memory caching\n * - Extract first GOP for fast cover rendering\n */\nexport class MP4IndexParser {\n  /**\n   * Parse from streaming download\n   * Returns video index + all audio samples\n   * Can optionally extract first GOP for fast cover rendering\n   */\n  async parseFromStream(\n    stream: ReadableStream<Uint8Array>,\n    options?: ParseStreamOptions\n  ): Promise<MP4ParseResult> {\n    const mp4boxFile = MP4Box.createFile();\n    let resolveResult: ((result: MP4ParseResult) => void) | null = null;\n    let rejectResult: ((error: Error) => void) | null = null;\n\n    const audioChunks: EncodedAudioChunk[] = [];\n    let audioConfig: AudioDecoderConfig | undefined;\n    let audioTrackId: number | null = null;\n    let expectedAudioSamples = 0;\n    let savedInfo: any = null;\n\n    const resultPromise = new Promise<MP4ParseResult>((resolve, reject) => {\n      resolveResult = resolve;\n      rejectResult = reject;\n    });\n\n    // First GOP extraction state\n    const firstGOPState = {\n      byteEnd: 0,\n      extracted: !options?.onFirstFrameReady,\n      index: null as MP4Index | null,\n      buffer: new Uint8Array(0),\n    };\n\n    const streamState = {\n      fileOffset: 0,\n      moovParsed: false,\n      audioComplete: false,\n    };\n\n    mp4boxFile.onError = (error: string) => {\n      rejectResult?.(new Error(`MP4Box error: ${error}`));\n    };\n\n    mp4boxFile.onReady = (info: any) => {\n      try {\n        // Set moovParsed immediately\n        streamState.moovParsed = true;\n\n        // Save info for later use in audio extraction\n        savedInfo = info;\n\n        // Build video index\n        const index = this.buildIndex(mp4boxFile, info);\n        firstGOPState.index = index;\n\n        // Check if this is a fast-start format (moov at beginning)\n        const isFastStart = info.isProgressive === true;\n\n        // Only extract first GOP for fast-start videos (moov-at-end videos will read from OPFS)\n        if (isFastStart && options?.onFirstFrameReady && index.tracks.video?.gopIndex[0]) {\n          const firstGOP = index.tracks.video.gopIndex[0];\n          const samples = index.tracks.video.samples;\n          const startIdx = firstGOP.keyframeSampleIndex;\n          const endIdx = startIdx + firstGOP.sampleCount;\n\n          const endSample = samples[endIdx - 1];\n          if (endSample) {\n            firstGOPState.byteEnd = endSample.byteOffset + endSample.byteLength;\n          }\n        }\n\n        // Setup audio extraction if audio track exists\n        const { config, trackId, expectedSamples, isComplete } = this.setupAudioExtraction(\n          mp4boxFile,\n          info\n        );\n        audioConfig = config;\n        audioTrackId = trackId ?? null;\n        expectedAudioSamples = expectedSamples;\n        streamState.audioComplete = isComplete;\n\n        if (isComplete) {\n          // No audio track, resolve immediately if firstGOP extracted or not needed\n          // Use setTimeout to allow stack to unwind and ensure consistency\n          setTimeout(() => {\n            if (streamState.moovParsed && streamState.audioComplete && firstGOPState.extracted) {\n              resolveResult?.({ index });\n            }\n          }, 0);\n        }\n      } catch (error) {\n        rejectResult?.(error as Error);\n      }\n    };\n\n    // Handle audio sample extraction\n    mp4boxFile.onSamples = (trackId: number, _user: any, samples: any[]) => {\n      if (trackId === audioTrackId && audioConfig) {\n        const timescale = audioConfig.sampleRate;\n\n        // Process samples if any\n        if (samples && samples.length > 0) {\n          for (const sample of samples) {\n            try {\n              const chunk = new EncodedAudioChunk({\n                type: sample.is_sync ? 'key' : 'delta',\n                timestamp: Math.round((sample.cts / timescale) * 1_000_000),\n                duration: Math.round((sample.duration / timescale) * 1_000_000),\n                data: sample.data,\n              });\n              audioChunks.push(chunk);\n            } catch (error) {\n              console.warn('[MP4IndexParser] Failed to create audio chunk:', error);\n            }\n          }\n        }\n\n        // Check if we have all samples\n        if (expectedAudioSamples !== Infinity && audioChunks.length >= expectedAudioSamples) {\n          streamState.audioComplete = true;\n        }\n      }\n    };\n\n    await this.processStreamData(stream, mp4boxFile, options, firstGOPState, streamState);\n\n    // Flush remaining data\n    mp4boxFile.flush();\n\n    // Wait for MP4Box to complete sample extraction (onReady/onSamples are async)\n    // Reference: MP4Demuxer.ts line 302\n    await new Promise((resolve) => setTimeout(resolve, 100));\n\n    // If audio extraction finished normally (or there was no audio), resolve now\n    if (streamState.moovParsed && streamState.audioComplete) {\n      const index = firstGOPState.index || this.buildIndex(mp4boxFile, savedInfo);\n      resolveResult!({\n        index,\n        audioSamples: audioChunks,\n        audioMetadata: audioConfig,\n      });\n    }\n    // If moov is parsed but audio extraction hasn't completed yet, force complete\n    else if (streamState.moovParsed && !streamState.audioComplete && savedInfo) {\n      streamState.audioComplete = true;\n      const index = this.buildIndex(mp4boxFile, savedInfo);\n\n      // Check if we have audio chunks\n      if (audioChunks.length > 0 && audioConfig) {\n        resolveResult!({\n          index,\n          audioSamples: audioChunks,\n          audioMetadata: audioConfig,\n        });\n      } else {\n        // No audio or extraction failed, just return index\n        resolveResult!({ index });\n      }\n    }\n\n    // Wait for result with timeout (5s max)\n    const parseTimeout = new Promise<never>((_, reject) => {\n      setTimeout(() => {\n        reject(\n          new Error(\n            `MP4Box parsing timeout after reading ${streamState.fileOffset} bytes. ` +\n              `moovParsed=${streamState.moovParsed}, audioExtractionComplete=${streamState.audioComplete}`\n          )\n        );\n      }, 5000);\n    });\n\n    // Wait for either resultPromise or timeout\n    return await Promise.race([resultPromise, parseTimeout]);\n  }\n\n  private async processStreamData(\n    stream: ReadableStream<Uint8Array>,\n    mp4boxFile: MP4BoxFile,\n    options: ParseStreamOptions | undefined,\n    firstGOPState: any,\n    streamState: any\n  ): Promise<void> {\n    const reader = stream.getReader();\n\n    try {\n      let hasData = false;\n\n      while (true) {\n        const { done, value } = await reader.read();\n\n        if (done) {\n          break;\n        }\n\n        if (value) {\n          hasData = true;\n          const buffer = this.prepareBuffer(value, streamState.fileOffset);\n\n          this.handleFirstGOPExtraction(buffer, value, options, firstGOPState, streamState);\n\n          mp4boxFile.appendBuffer(buffer);\n          streamState.fileOffset += buffer.byteLength;\n\n          if (streamState.moovParsed && streamState.audioComplete && firstGOPState.extracted) {\n            break;\n          }\n        }\n      }\n\n      if (!hasData) {\n        throw new Error('Empty stream received');\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  private prepareBuffer(value: Uint8Array, fileOffset: number): ArrayBuffer {\n    let buffer: ArrayBuffer;\n    if (value.byteOffset === 0 && value.byteLength === value.buffer.byteLength) {\n      buffer = value.buffer as ArrayBuffer;\n    } else {\n      buffer = value.buffer.slice(\n        value.byteOffset,\n        value.byteOffset + value.byteLength\n      ) as ArrayBuffer;\n    }\n    (buffer as any).fileStart = fileOffset;\n    return buffer;\n  }\n\n  private handleFirstGOPExtraction(\n    buffer: ArrayBuffer,\n    value: Uint8Array,\n    options: ParseStreamOptions | undefined,\n    firstGOPState: any,\n    streamState: any\n  ): void {\n    if (!firstGOPState.extracted && options?.onFirstFrameReady) {\n      // Safety: Cap accumulation to 10MB\n      if (firstGOPState.buffer.length + value.length < 10 * 1024 * 1024) {\n        const newBuffer = new Uint8Array(firstGOPState.buffer.length + value.length);\n        newBuffer.set(firstGOPState.buffer);\n        newBuffer.set(value, firstGOPState.buffer.length);\n        firstGOPState.buffer = newBuffer;\n      } else if (!streamState.moovParsed) {\n        firstGOPState.extracted = true;\n        firstGOPState.buffer = new Uint8Array(0);\n      }\n\n      if (\n        streamState.moovParsed &&\n        firstGOPState.byteEnd > 0 &&\n        firstGOPState.index &&\n        streamState.fileOffset + buffer.byteLength >= firstGOPState.byteEnd\n      ) {\n        try {\n          const currentIndex = firstGOPState.index as MP4Index;\n          const videoTrack = currentIndex.tracks.video;\n\n          if (videoTrack) {\n            const chunks = this.extractFirstGOP(firstGOPState.buffer, videoTrack, 0);\n            options.onFirstFrameReady?.(currentIndex, chunks);\n          }\n\n          firstGOPState.extracted = true;\n          firstGOPState.buffer = new Uint8Array(0);\n        } catch (error) {\n          console.warn('[MP4IndexParser] Failed to extract first GOP:', error);\n          firstGOPState.extracted = true;\n          firstGOPState.buffer = new Uint8Array(0);\n        }\n      }\n    }\n  }\n\n  private setupAudioExtraction(\n    mp4boxFile: MP4BoxFile,\n    info: any\n  ): {\n    config?: AudioDecoderConfig;\n    trackId?: number;\n    expectedSamples: number;\n    isComplete: boolean;\n  } {\n    const audioTrack = info.tracks.find((t: any) => t.type === 'audio');\n    if (audioTrack) {\n      const trackId: number = audioTrack.id;\n      const config = {\n        codec: audioTrack.codec.startsWith('mp4a') ? 'mp4a.40.2' : audioTrack.codec,\n        sampleRate: audioTrack.audio.sample_rate || audioTrack.timescale,\n        numberOfChannels: audioTrack.audio.channel_count,\n      };\n\n      // Extract all audio samples\n      mp4boxFile.setExtractionOptions(trackId, null as any, {\n        nbSamples: Infinity, // Extract all samples\n      });\n      mp4boxFile.start();\n\n      return {\n        config,\n        trackId,\n        expectedSamples: audioTrack.nb_samples || Infinity,\n        isComplete: false,\n      };\n    }\n\n    return { expectedSamples: 0, isComplete: true };\n  }\n\n  /**\n   * Parse from file/ArrayBuffer (for already cached resources)\n   */\n  async parseFromFile(data: File | ArrayBuffer): Promise<MP4Index> {\n    const mp4boxFile = MP4Box.createFile();\n\n    const indexPromise = new Promise<MP4Index>((resolve, reject) => {\n      mp4boxFile.onError = (error: string) => {\n        reject(new Error(`MP4Box error: ${error}`));\n      };\n\n      mp4boxFile.onReady = (info: any) => {\n        try {\n          const index = this.buildIndex(mp4boxFile, info);\n          resolve(index);\n        } catch (error) {\n          reject(error);\n        }\n      };\n    });\n\n    // Read file data\n    let buffer: ArrayBuffer;\n    if (data instanceof File) {\n      buffer = await data.arrayBuffer();\n    } else {\n      buffer = data;\n    }\n\n    (buffer as any).fileStart = 0;\n    mp4boxFile.appendBuffer(buffer);\n    mp4boxFile.flush();\n\n    return indexPromise;\n  }\n\n  /**\n   * Build MP4Index from mp4box.js parsed data\n   */\n  private buildIndex(mp4boxFile: MP4BoxFile, info: any): MP4Index {\n    const index: MP4Index = {\n      resourceId: '', // Will be set by caller\n      moovOffset: 0, // mp4box doesn't expose this directly\n      moovSize: 0,\n      durationUs: (info.duration / info.timescale) * 1_000_000,\n      tracks: {},\n    };\n\n    for (const trackInfo of info.tracks) {\n      if (trackInfo.type === 'video') {\n        index.tracks.video = this.buildVideoTrackIndex(mp4boxFile, trackInfo);\n      } else if (trackInfo.type === 'audio') {\n        index.tracks.audio = this.buildAudioTrackIndex(mp4boxFile, trackInfo);\n      }\n    }\n\n    return index;\n  }\n\n  /**\n   * Build video track index with sample table and GOP boundaries\n   */\n  private buildVideoTrackIndex(mp4boxFile: MP4BoxFile, trackInfo: any): VideoTrackIndex {\n    const samples = this.buildSampleTable(mp4boxFile, trackInfo.id, trackInfo.timescale);\n    const gopIndex = this.buildGOPIndex(samples);\n    const description = this.getVideoDescription(mp4boxFile, trackInfo);\n\n    return {\n      trackId: trackInfo.id,\n      codec: trackInfo.codec,\n      width: trackInfo.track_width || trackInfo.video?.width || 0,\n      height: trackInfo.track_height || trackInfo.video?.height || 0,\n      timescale: trackInfo.timescale,\n      description,\n      samples,\n      gopIndex,\n    };\n  }\n\n  /**\n   * Build audio track index\n   */\n  private buildAudioTrackIndex(mp4boxFile: MP4BoxFile, trackInfo: any): AudioTrackIndex {\n    const samples = this.buildSampleTable(mp4boxFile, trackInfo.id, trackInfo.timescale);\n\n    return {\n      trackId: trackInfo.id,\n      codec: trackInfo.codec,\n      sampleRate: trackInfo.audio?.sample_rate || 48000,\n      numberOfChannels: trackInfo.audio?.channel_count || 2,\n      timescale: trackInfo.timescale,\n      samples,\n    };\n  }\n\n  /**\n   * Build sample table from mp4box track samples\n   *\n   * IMPORTANT: Keep samples in DTS (decode) order, not PTS (presentation) order!\n   * VideoDecoder requires chunks in decode order. It will output frames in PTS order.\n   */\n  private buildSampleTable(mp4boxFile: MP4BoxFile, trackId: number, timescale: number): Sample[] {\n    const samples: Sample[] = [];\n\n    // Get track box\n    const trak = mp4boxFile.getTrackById(trackId);\n    if (!trak) return samples;\n\n    // Access sample table (already in DTS order)\n    const sampleTable = trak.samples || [];\n\n    // Calculate PTS from CTS and normalize to start at 0\n    let timestampOffset: number | null = null;\n\n    for (const sample of sampleTable) {\n      const durationUs = ((sample.duration || 0) / timescale) * 1_000_000;\n\n      // Use CTS (Composition Time Stamp = PTS) for display timestamp\n      const rawTimestampUs = ((sample.cts || 0) / timescale) * 1_000_000;\n\n      // Normalize: first frame starts at 0 (like MP4Demuxer does)\n      if (timestampOffset === null) {\n        timestampOffset = rawTimestampUs;\n      }\n      const timestampUs = rawTimestampUs - timestampOffset;\n\n      samples.push({\n        timestamp: timestampUs, // Normalized PTS (display timestamp)\n        duration: durationUs,\n        byteOffset: sample.offset || 0,\n        byteLength: sample.size || 0,\n        isKeyframe: sample.is_sync || false,\n      });\n    }\n\n    // DO NOT SORT! Samples must stay in DTS (decode) order for VideoDecoder\n    // Decoder will output frames in PTS order automatically\n\n    return samples;\n  }\n\n  /**\n   * Extract video description (avcC/hvcC/etc) for VideoDecoder\n   * Reuses MP4Demuxer.extractVideoDescription for consistency\n   */\n  private getVideoDescription(mp4boxFile: MP4BoxFile, trackInfo: any): ArrayBuffer | undefined {\n    return MP4Demuxer.extractVideoDescription(mp4boxFile, trackInfo.id);\n  }\n\n  /**\n   * Build GOP index from samples\n   * GOP = Group of Pictures, starts with a keyframe\n   */\n  private buildGOPIndex(samples: Sample[]): GOP[] {\n    const gopIndex: GOP[] = [];\n    let currentGOP: {\n      startTimeUs: TimeUs;\n      keyframeSampleIndex: number;\n      sampleCount: number;\n    } | null = null;\n\n    for (let i = 0; i < samples.length; i++) {\n      const sample = samples[i];\n      if (!sample) continue;\n\n      if (sample.isKeyframe) {\n        // Save previous GOP if exists\n        if (currentGOP) {\n          gopIndex.push(currentGOP);\n        }\n\n        // Start new GOP\n        currentGOP = {\n          startTimeUs: sample.timestamp,\n          keyframeSampleIndex: i,\n          sampleCount: 1,\n        };\n      } else if (currentGOP) {\n        // Add sample to current GOP\n        currentGOP.sampleCount++;\n      }\n    }\n\n    // Save last GOP\n    if (currentGOP) {\n      gopIndex.push(currentGOP);\n    }\n\n    return gopIndex;\n  }\n\n  /**\n   * Extract first GOP chunks from accumulated buffer\n   * Used for fast cover rendering during streaming download\n   */\n  private extractFirstGOP(\n    buffer: Uint8Array,\n    videoTrack: VideoTrackIndex,\n    byteStart: number\n  ): EncodedVideoChunk[] {\n    const chunks: EncodedVideoChunk[] = [];\n    const firstGOP = videoTrack.gopIndex[0];\n    if (!firstGOP) {\n      return chunks;\n    }\n\n    const samples = videoTrack.samples;\n\n    for (let i = 0; i < firstGOP.sampleCount; i++) {\n      const sampleIdx = firstGOP.keyframeSampleIndex + i;\n      const sample = samples[sampleIdx];\n      if (!sample) continue;\n\n      const relativeOffset = sample.byteOffset - byteStart;\n\n      // Validate offset is within buffer\n      if (relativeOffset < 0 || relativeOffset + sample.byteLength > buffer.length) {\n        console.warn('[MP4IndexParser] Sample outside buffer:', {\n          sampleOffset: sample.byteOffset,\n          sampleLength: sample.byteLength,\n          byteStart,\n          relativeOffset,\n          bufferLength: buffer.length,\n        });\n        continue;\n      }\n\n      const sampleData = buffer.slice(relativeOffset, relativeOffset + sample.byteLength);\n\n      try {\n        chunks.push(\n          new EncodedVideoChunk({\n            type: sample.isKeyframe ? 'key' : 'delta',\n            timestamp: sample.timestamp,\n            duration: sample.duration,\n            data: sampleData,\n          })\n        );\n      } catch (error) {\n        console.warn('[MP4IndexParser] Failed to create EncodedVideoChunk:', error);\n      }\n    }\n\n    return chunks;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"MP4IndexParser.js","sources":["../../../src/stages/demux/MP4IndexParser.ts"],"sourcesContent":["import { MP4Box } from '../../utils/mp4box';\nimport type { MP4BoxFile } from 'mp4box';\nimport type { MP4Index, VideoTrackIndex, AudioTrackIndex, Sample, GOP } from './types';\nimport type { TimeUs } from '../../model/types';\nimport { MP4Demuxer, normalizeVideoCodec } from './MP4Demuxer';\n\nexport interface MP4ParseResult {\n  index: MP4Index;\n  audioSamples?: EncodedAudioChunk[];\n  audioMetadata?: AudioDecoderConfig;\n}\n\nexport interface ParseStreamOptions {\n  onFirstFrameReady?: (index: MP4Index, firstGOPChunks: EncodedVideoChunk[]) => void;\n}\n\n/**\n * MP4IndexParser - Parse MP4 moov box and build time→byte index\n *\n * Features:\n * - Stream-based moov parsing (stop after moov found)\n * - Build sample table with byte offsets\n * - Build GOP index for keyframe positions\n * - Extract all audio samples (encoded) for memory caching\n * - Extract first GOP for fast cover rendering\n */\nexport class MP4IndexParser {\n  /**\n   * Parse from streaming download\n   * Returns video index + all audio samples\n   * Can optionally extract first GOP for fast cover rendering\n   */\n  async parseFromStream(\n    stream: ReadableStream<Uint8Array>,\n    options?: ParseStreamOptions\n  ): Promise<MP4ParseResult> {\n    const mp4boxFile = MP4Box.createFile();\n    let resolveResult: ((result: MP4ParseResult) => void) | null = null;\n    let rejectResult: ((error: Error) => void) | null = null;\n\n    const audioChunks: EncodedAudioChunk[] = [];\n    let audioConfig: AudioDecoderConfig | undefined;\n    let audioTrackId: number | null = null;\n    let expectedAudioSamples = 0;\n    let savedInfo: any = null;\n\n    const resultPromise = new Promise<MP4ParseResult>((resolve, reject) => {\n      resolveResult = resolve;\n      rejectResult = reject;\n    });\n\n    // First GOP extraction state\n    const firstGOPState = {\n      byteEnd: 0,\n      extracted: !options?.onFirstFrameReady,\n      index: null as MP4Index | null,\n      buffer: new Uint8Array(0),\n    };\n\n    const streamState = {\n      fileOffset: 0,\n      moovParsed: false,\n      audioComplete: false,\n    };\n\n    mp4boxFile.onError = (error: string) => {\n      rejectResult?.(new Error(`MP4Box error: ${error}`));\n    };\n\n    mp4boxFile.onReady = (info: any) => {\n      try {\n        // Set moovParsed immediately\n        streamState.moovParsed = true;\n\n        // Save info for later use in audio extraction\n        savedInfo = info;\n\n        // Build video index\n        const index = this.buildIndex(mp4boxFile, info);\n        firstGOPState.index = index;\n\n        // Check if this is a fast-start format (moov at beginning)\n        const isFastStart = info.isProgressive === true;\n\n        // Only extract first GOP for fast-start videos (moov-at-end videos will read from OPFS)\n        if (isFastStart && options?.onFirstFrameReady && index.tracks.video?.gopIndex[0]) {\n          const firstGOP = index.tracks.video.gopIndex[0];\n          const samples = index.tracks.video.samples;\n          const startIdx = firstGOP.keyframeSampleIndex;\n          const endIdx = startIdx + firstGOP.sampleCount;\n\n          const endSample = samples[endIdx - 1];\n          if (endSample) {\n            firstGOPState.byteEnd = endSample.byteOffset + endSample.byteLength;\n          }\n        }\n\n        // Setup audio extraction if audio track exists\n        const { config, trackId, expectedSamples, isComplete } = this.setupAudioExtraction(\n          mp4boxFile,\n          info\n        );\n        audioConfig = config;\n        audioTrackId = trackId ?? null;\n        expectedAudioSamples = expectedSamples;\n        streamState.audioComplete = isComplete;\n\n        if (isComplete) {\n          // No audio track, resolve immediately if firstGOP extracted or not needed\n          // Use setTimeout to allow stack to unwind and ensure consistency\n          setTimeout(() => {\n            if (streamState.moovParsed && streamState.audioComplete && firstGOPState.extracted) {\n              resolveResult?.({ index });\n            }\n          }, 0);\n        }\n      } catch (error) {\n        rejectResult?.(error as Error);\n      }\n    };\n\n    // Handle audio sample extraction\n    mp4boxFile.onSamples = (trackId: number, _user: any, samples: any[]) => {\n      if (trackId === audioTrackId && audioConfig) {\n        const timescale = audioConfig.sampleRate;\n\n        // Process samples if any\n        if (samples && samples.length > 0) {\n          for (const sample of samples) {\n            try {\n              const chunk = new EncodedAudioChunk({\n                type: sample.is_sync ? 'key' : 'delta',\n                timestamp: Math.round((sample.cts / timescale) * 1_000_000),\n                duration: Math.round((sample.duration / timescale) * 1_000_000),\n                data: sample.data,\n              });\n              audioChunks.push(chunk);\n            } catch (error) {\n              console.warn('[MP4IndexParser] Failed to create audio chunk:', error);\n            }\n          }\n        }\n\n        // Check if we have all samples\n        if (expectedAudioSamples !== Infinity && audioChunks.length >= expectedAudioSamples) {\n          streamState.audioComplete = true;\n        }\n      }\n    };\n\n    await this.processStreamData(stream, mp4boxFile, options, firstGOPState, streamState);\n\n    // Flush remaining data\n    mp4boxFile.flush();\n\n    // Wait for MP4Box to complete sample extraction (onReady/onSamples are async)\n    // Reference: MP4Demuxer.ts line 302\n    await new Promise((resolve) => setTimeout(resolve, 100));\n\n    // If audio extraction finished normally (or there was no audio), resolve now\n    if (streamState.moovParsed && streamState.audioComplete) {\n      const index = firstGOPState.index || this.buildIndex(mp4boxFile, savedInfo);\n      resolveResult!({\n        index,\n        audioSamples: audioChunks,\n        audioMetadata: audioConfig,\n      });\n    }\n    // If moov is parsed but audio extraction hasn't completed yet, force complete\n    else if (streamState.moovParsed && !streamState.audioComplete && savedInfo) {\n      streamState.audioComplete = true;\n      const index = this.buildIndex(mp4boxFile, savedInfo);\n\n      // Check if we have audio chunks\n      if (audioChunks.length > 0 && audioConfig) {\n        resolveResult!({\n          index,\n          audioSamples: audioChunks,\n          audioMetadata: audioConfig,\n        });\n      } else {\n        // No audio or extraction failed, just return index\n        resolveResult!({ index });\n      }\n    }\n\n    // Wait for result with timeout (5s max)\n    const parseTimeout = new Promise<never>((_, reject) => {\n      setTimeout(() => {\n        reject(\n          new Error(\n            `MP4Box parsing timeout after reading ${streamState.fileOffset} bytes. ` +\n              `moovParsed=${streamState.moovParsed}, audioExtractionComplete=${streamState.audioComplete}`\n          )\n        );\n      }, 5000);\n    });\n\n    // Wait for either resultPromise or timeout\n    return await Promise.race([resultPromise, parseTimeout]);\n  }\n\n  private async processStreamData(\n    stream: ReadableStream<Uint8Array>,\n    mp4boxFile: MP4BoxFile,\n    options: ParseStreamOptions | undefined,\n    firstGOPState: any,\n    streamState: any\n  ): Promise<void> {\n    const reader = stream.getReader();\n\n    try {\n      let hasData = false;\n\n      while (true) {\n        const { done, value } = await reader.read();\n\n        if (done) {\n          break;\n        }\n\n        if (value) {\n          hasData = true;\n          const buffer = this.prepareBuffer(value, streamState.fileOffset);\n\n          this.handleFirstGOPExtraction(buffer, value, options, firstGOPState, streamState);\n\n          mp4boxFile.appendBuffer(buffer);\n          streamState.fileOffset += buffer.byteLength;\n\n          if (streamState.moovParsed && streamState.audioComplete && firstGOPState.extracted) {\n            break;\n          }\n        }\n      }\n\n      if (!hasData) {\n        throw new Error('Empty stream received');\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  private prepareBuffer(value: Uint8Array, fileOffset: number): ArrayBuffer {\n    let buffer: ArrayBuffer;\n    if (value.byteOffset === 0 && value.byteLength === value.buffer.byteLength) {\n      buffer = value.buffer as ArrayBuffer;\n    } else {\n      buffer = value.buffer.slice(\n        value.byteOffset,\n        value.byteOffset + value.byteLength\n      ) as ArrayBuffer;\n    }\n    (buffer as any).fileStart = fileOffset;\n    return buffer;\n  }\n\n  private handleFirstGOPExtraction(\n    buffer: ArrayBuffer,\n    value: Uint8Array,\n    options: ParseStreamOptions | undefined,\n    firstGOPState: any,\n    streamState: any\n  ): void {\n    if (!firstGOPState.extracted && options?.onFirstFrameReady) {\n      // Safety: Cap accumulation to 10MB\n      if (firstGOPState.buffer.length + value.length < 10 * 1024 * 1024) {\n        const newBuffer = new Uint8Array(firstGOPState.buffer.length + value.length);\n        newBuffer.set(firstGOPState.buffer);\n        newBuffer.set(value, firstGOPState.buffer.length);\n        firstGOPState.buffer = newBuffer;\n      } else if (!streamState.moovParsed) {\n        firstGOPState.extracted = true;\n        firstGOPState.buffer = new Uint8Array(0);\n      }\n\n      if (\n        streamState.moovParsed &&\n        firstGOPState.byteEnd > 0 &&\n        firstGOPState.index &&\n        streamState.fileOffset + buffer.byteLength >= firstGOPState.byteEnd\n      ) {\n        try {\n          const currentIndex = firstGOPState.index as MP4Index;\n          const videoTrack = currentIndex.tracks.video;\n\n          if (videoTrack && videoTrack.gopIndex[0]) {\n            // buffer accumulated from file start (position 0)\n            // sample.byteOffset is absolute offset from file start\n            // So byteStart should be 0 to match buffer's starting position\n            const chunks = this.extractFirstGOP(firstGOPState.buffer, videoTrack, 0);\n\n            if (chunks.length > 0) {\n              options.onFirstFrameReady?.(currentIndex, chunks);\n            }\n          }\n\n          firstGOPState.extracted = true;\n          firstGOPState.buffer = new Uint8Array(0);\n        } catch (error) {\n          console.warn('[MP4IndexParser] Failed to extract first GOP:', error);\n          firstGOPState.extracted = true;\n          firstGOPState.buffer = new Uint8Array(0);\n        }\n      }\n    }\n  }\n\n  private setupAudioExtraction(\n    mp4boxFile: MP4BoxFile,\n    info: any\n  ): {\n    config?: AudioDecoderConfig;\n    trackId?: number;\n    expectedSamples: number;\n    isComplete: boolean;\n  } {\n    const audioTrack = info.tracks.find((t: any) => t.type === 'audio');\n    if (audioTrack) {\n      const trackId: number = audioTrack.id;\n      const config = {\n        codec: audioTrack.codec.startsWith('mp4a') ? 'mp4a.40.2' : audioTrack.codec,\n        sampleRate: audioTrack.audio.sample_rate || audioTrack.timescale,\n        numberOfChannels: audioTrack.audio.channel_count,\n      };\n\n      // Extract all audio samples\n      mp4boxFile.setExtractionOptions(trackId, null as any, {\n        nbSamples: Infinity, // Extract all samples\n      });\n      mp4boxFile.start();\n\n      return {\n        config,\n        trackId,\n        expectedSamples: audioTrack.nb_samples || Infinity,\n        isComplete: false,\n      };\n    }\n\n    return { expectedSamples: 0, isComplete: true };\n  }\n\n  /**\n   * Parse from file/ArrayBuffer (for already cached resources)\n   */\n  async parseFromFile(data: File | ArrayBuffer): Promise<MP4Index> {\n    const mp4boxFile = MP4Box.createFile();\n\n    const indexPromise = new Promise<MP4Index>((resolve, reject) => {\n      mp4boxFile.onError = (error: string) => {\n        reject(new Error(`MP4Box error: ${error}`));\n      };\n\n      mp4boxFile.onReady = (info: any) => {\n        try {\n          const index = this.buildIndex(mp4boxFile, info);\n          resolve(index);\n        } catch (error) {\n          reject(error);\n        }\n      };\n    });\n\n    // Read file data\n    let buffer: ArrayBuffer;\n    if (data instanceof File) {\n      buffer = await data.arrayBuffer();\n    } else {\n      buffer = data;\n    }\n\n    (buffer as any).fileStart = 0;\n    mp4boxFile.appendBuffer(buffer);\n    mp4boxFile.flush();\n\n    return indexPromise;\n  }\n\n  /**\n   * Build MP4Index from mp4box.js parsed data\n   */\n  private buildIndex(mp4boxFile: MP4BoxFile, info: any): MP4Index {\n    const index: MP4Index = {\n      resourceId: '', // Will be set by caller\n      moovOffset: 0, // mp4box doesn't expose this directly\n      moovSize: 0,\n      durationUs: (info.duration / info.timescale) * 1_000_000,\n      tracks: {},\n    };\n\n    for (const trackInfo of info.tracks) {\n      if (trackInfo.type === 'video') {\n        index.tracks.video = this.buildVideoTrackIndex(mp4boxFile, trackInfo);\n      } else if (trackInfo.type === 'audio') {\n        index.tracks.audio = this.buildAudioTrackIndex(mp4boxFile, trackInfo);\n      }\n    }\n\n    return index;\n  }\n\n  /**\n   * Build video track index with sample table and GOP boundaries\n   */\n  private buildVideoTrackIndex(mp4boxFile: MP4BoxFile, trackInfo: any): VideoTrackIndex {\n    const samples = this.buildSampleTable(mp4boxFile, trackInfo.id, trackInfo.timescale);\n    const gopIndex = this.buildGOPIndex(samples);\n    const description = this.getVideoDescription(mp4boxFile, trackInfo);\n\n    return {\n      trackId: trackInfo.id,\n      codec: normalizeVideoCodec(trackInfo.codec, description),\n      width: trackInfo.track_width || trackInfo.video?.width || 0,\n      height: trackInfo.track_height || trackInfo.video?.height || 0,\n      timescale: trackInfo.timescale,\n      description,\n      samples,\n      gopIndex,\n    };\n  }\n\n  /**\n   * Build audio track index\n   */\n  private buildAudioTrackIndex(mp4boxFile: MP4BoxFile, trackInfo: any): AudioTrackIndex {\n    const samples = this.buildSampleTable(mp4boxFile, trackInfo.id, trackInfo.timescale);\n\n    return {\n      trackId: trackInfo.id,\n      codec: trackInfo.codec,\n      sampleRate: trackInfo.audio?.sample_rate || 48000,\n      numberOfChannels: trackInfo.audio?.channel_count || 2,\n      timescale: trackInfo.timescale,\n      samples,\n    };\n  }\n\n  /**\n   * Build sample table from mp4box track samples\n   *\n   * IMPORTANT: Keep samples in DTS (decode) order, not PTS (presentation) order!\n   * VideoDecoder requires chunks in decode order. It will output frames in PTS order.\n   */\n  private buildSampleTable(mp4boxFile: MP4BoxFile, trackId: number, timescale: number): Sample[] {\n    const samples: Sample[] = [];\n\n    // Get track box\n    const trak = mp4boxFile.getTrackById(trackId);\n    if (!trak) return samples;\n\n    // Access sample table (already in DTS order)\n    const sampleTable = trak.samples || [];\n\n    // Calculate PTS from CTS and normalize to start at 0\n    let timestampOffset: number | null = null;\n\n    for (const sample of sampleTable) {\n      const durationUs = ((sample.duration || 0) / timescale) * 1_000_000;\n\n      // Use CTS (Composition Time Stamp = PTS) for display timestamp\n      const rawTimestampUs = ((sample.cts || 0) / timescale) * 1_000_000;\n\n      // Normalize: first frame starts at 0 (like MP4Demuxer does)\n      if (timestampOffset === null) {\n        timestampOffset = rawTimestampUs;\n      }\n      const timestampUs = rawTimestampUs - timestampOffset;\n\n      samples.push({\n        timestamp: timestampUs, // Normalized PTS (display timestamp)\n        duration: durationUs,\n        byteOffset: sample.offset || 0,\n        byteLength: sample.size || 0,\n        isKeyframe: sample.is_sync || false,\n      });\n    }\n\n    // DO NOT SORT! Samples must stay in DTS (decode) order for VideoDecoder\n    // Decoder will output frames in PTS order automatically\n\n    return samples;\n  }\n\n  /**\n   * Extract video description (avcC/hvcC/etc) for VideoDecoder\n   * Reuses MP4Demuxer.extractVideoDescription for consistency\n   */\n  private getVideoDescription(mp4boxFile: MP4BoxFile, trackInfo: any): ArrayBuffer | undefined {\n    return MP4Demuxer.extractVideoDescription(mp4boxFile, trackInfo.id);\n  }\n\n  /**\n   * Build GOP index from samples\n   * GOP = Group of Pictures, starts with a keyframe\n   */\n  private buildGOPIndex(samples: Sample[]): GOP[] {\n    const gopIndex: GOP[] = [];\n    let currentGOP: {\n      startTimeUs: TimeUs;\n      keyframeSampleIndex: number;\n      sampleCount: number;\n    } | null = null;\n\n    for (let i = 0; i < samples.length; i++) {\n      const sample = samples[i];\n      if (!sample) continue;\n\n      if (sample.isKeyframe) {\n        // Save previous GOP if exists\n        if (currentGOP) {\n          gopIndex.push(currentGOP);\n        }\n\n        // Start new GOP\n        currentGOP = {\n          startTimeUs: sample.timestamp,\n          keyframeSampleIndex: i,\n          sampleCount: 1,\n        };\n      } else if (currentGOP) {\n        // Add sample to current GOP\n        currentGOP.sampleCount++;\n      }\n    }\n\n    // Save last GOP\n    if (currentGOP) {\n      gopIndex.push(currentGOP);\n    }\n\n    return gopIndex;\n  }\n\n  /**\n   * Extract first GOP chunks from accumulated buffer\n   * Used for fast cover rendering during streaming download\n   */\n  private extractFirstGOP(\n    buffer: Uint8Array,\n    videoTrack: VideoTrackIndex,\n    byteStart: number\n  ): EncodedVideoChunk[] {\n    const chunks: EncodedVideoChunk[] = [];\n    const firstGOP = videoTrack.gopIndex[0];\n    if (!firstGOP) {\n      return chunks;\n    }\n\n    const samples = videoTrack.samples;\n\n    for (let i = 0; i < firstGOP.sampleCount; i++) {\n      const sampleIdx = firstGOP.keyframeSampleIndex + i;\n      const sample = samples[sampleIdx];\n      if (!sample) continue;\n\n      const relativeOffset = sample.byteOffset - byteStart;\n\n      // Validate offset is within buffer\n      if (relativeOffset < 0 || relativeOffset + sample.byteLength > buffer.length) {\n        // Critical: If first sample (keyframe) is not fully downloaded, return empty array\n        // to avoid decoding error \"A key frame is required after configure()\"\n        if (i === 0) {\n          console.warn(\n            '[MP4IndexParser] First GOP keyframe not fully downloaded, skipping cover decode'\n          );\n          return []; // Return empty array to avoid sending non-keyframe as first chunk\n        }\n\n        console.warn('[MP4IndexParser] Sample outside buffer:', {\n          sampleOffset: sample.byteOffset,\n          sampleLength: sample.byteLength,\n          byteStart,\n          relativeOffset,\n          bufferLength: buffer.length,\n          isKeyframe: sample.isKeyframe,\n          sampleIndex: i,\n        });\n\n        // If not first sample, safe to skip (keyframe already present)\n        continue;\n      }\n\n      const sampleData = buffer.slice(relativeOffset, relativeOffset + sample.byteLength);\n\n      try {\n        chunks.push(\n          new EncodedVideoChunk({\n            type: sample.isKeyframe ? 'key' : 'delta',\n            timestamp: sample.timestamp,\n            duration: sample.duration,\n            data: sampleData,\n          })\n        );\n      } catch (error) {\n        console.warn('[MP4IndexParser] Failed to create EncodedVideoChunk:', error);\n      }\n    }\n\n    // Additional safety check: ensure first chunk is keyframe\n    if (chunks.length > 0 && chunks[0]?.type !== 'key') {\n      console.error('[MP4IndexParser] First chunk is not a keyframe, discarding all chunks');\n      return [];\n    }\n\n    return chunks;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/load/ResourceLoader.d.ts

@@ -23,6 +23,34 @@ export declare class ResourceLoader {
     private processPreloadQueue;
     private enqueueLoad;
     private processQueue;
+    /**
+     * Check if resource is cached and ready (without loading)
+     */
+    private isResourceCached;
+    /**
+     * Transfer video stream to worker
+     */
+    private transferVideoToWorker;
+    /**
+     * Transfer image to worker
+     */
+    private transferImageToWorker;
+    /**
+     * Load video resource (download + cache or read from cache)
+     */
+    private loadVideoResource;
+    /**
+     * Load audio resource (download + parse or reuse cache)
+     */
+    private loadAudioResource;
+    /**
+     * Load image resource (download + cache or read from cache) and transfer to worker
+     */
+    private loadImageResource;
+    /**
+     * Load text resource (json/text)
+     */
+    private loadTextResource;
     /**
      * Start loading a resource
      * Handles state management (loading → ready/error) for all resource types
@@ -60,31 +88,11 @@ export declare class ResourceLoader {
      * Parse moov from stream and cache index + audio samples + decode first frame
      */
     private parseIndexFromStream;
-    /**
-     * Load text-based resources (json, text)
-     * Just download the content - state management is handled by startLoad()
-     */
-    private loadTextResource;
     loadImage(resource: Resource): Promise<ImageBitmap>;
-    /**
-     * Load image resource: fetch blob → create ImageBitmap → cache in CacheManager
-     * Note: Images don't need streaming (typically < 5MB)
-     *
-     * Strategy for window cache architecture:
-     * - Store ImageBitmap in CacheManager.imageBitmapCache (main thread accessible)
-     * - OnDemandComposeSession retrieves from cache for composition
-     * - No longer transfer to Worker (composition is in main thread)
-     */
-    private loadImageBitmap;
     /**
      * Fetch resource as blob (for images, json, etc.)
      */
     private fetchBlob;
-    /**
-     * Transfer cached image to a session
-     * Creates new ImageBitmap from cached Blob and transfers to worker
-     */
-    private transferCachedImage;
     /**
      * Transfer stream to demux worker (for audio files)
      */
@@ -102,7 +110,7 @@ export declare class ResourceLoader {
      * 2. processQueue() → startLoad() executes async in background
      * 3. startLoad() completes → finally → completeTask() → task.resolve()/reject()
      */
-    fetch(resourceId?: string, options?: ResourceLoadOptions): Promise<void>;
+    load(resourceId?: string, options?: ResourceLoadOptions): Promise<void>;
     cancel(resourceId: string): void;
     /**
      * Check if a resource is currently being loaded
@@ -113,5 +121,10 @@ export declare class ResourceLoader {
     get activeTasks(): Map<string, LoadTask>;
     get taskQueue(): LoadTask[];
     dispose(): void;
+    /**
+     * Check if a clip needs cover extraction (first GOP decode)
+     * Only clips starting at time 0 need fast cover rendering
+     */
+    private shouldExtractCover;
 }
 //# sourceMappingURL=ResourceLoader.d.ts.map

package/dist/stages/load/ResourceLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceLoader.d.ts","sourceRoot":"","sources":["../../../src/stages/load/ResourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAiB,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWpF,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAA4B;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAyD;IAC/E,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,YAAY,CAAgB;gBAExB,OAAO,EAAE,qBAAqB;IAYpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAO5C,eAAe,IAAI,IAAI;IA0BvB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,YAAY;IAQpB;;;OAGG;YACW,SAAS;IAsDvB;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC1D;;;OAGG;YACW,oBAAoB;IAclC;;;;;;;OAOG;YACW,iBAAiB;IA6C/B;;OAEG;YACW,WAAW;IAIzB;;;;OAIG;YACW,qBAAqB;IA8CnC;;OAEG;YACW,oBAAoB;IA8DlC;;;OAGG;YACW,gBAAgB;IAMxB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAazD;;;;;;;;OAQG;YACW,eAAe;IAe7B;;OAEG;YACW,SAAS;IAUvB;;;OAGG;YACW,mBAAmB;IAsBjC;;OAEG;YACW,qBAAqB;IAyBnC,OAAO,CAAC,mBAAmB;IAgB3B;;;;;;;;;;;OAWG;IACG,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9E,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI9C,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOzB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9E,IAAI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAEvC;IAED,IAAI,SAAS,IAAI,QAAQ,EAAE,CAE1B;IAED,OAAO,IAAI,IAAI;CAIhB"}
+{"version":3,"file":"ResourceLoader.d.ts","sourceRoot":"","sources":["../../../src/stages/load/ResourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAiB,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWpF,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAA4B;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAyD;IAC/E,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,YAAY,CAAgB;gBAExB,OAAO,EAAE,qBAAqB;IAYpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAO5C,eAAe,IAAI,IAAI;IA0BvB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,YAAY;IAQpB;;OAEG;YACW,gBAAgB;IAuB9B;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;YACW,iBAAiB;IAQ/B;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;YACW,gBAAgB;IAM9B;;;OAGG;YACW,SAAS;IA4CvB;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC1D;;;OAGG;YACW,oBAAoB;IAclC;;;;;;;OAOG;YACW,iBAAiB;IA6C/B;;OAEG;YACW,WAAW;IAIzB;;;;OAIG;YACW,qBAAqB;IA8CnC;;OAEG;YACW,oBAAoB;IAgE5B,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBzD;;OAEG;YACW,SAAS;IAUvB;;OAEG;YACW,qBAAqB;IAyBnC,OAAO,CAAC,mBAAmB;IAgB3B;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuG7E,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI9C,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOzB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9E,IAAI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAEvC;IAED,IAAI,SAAS,IAAI,QAAQ,EAAE,CAE1B;IAED,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/stages/load/ResourceLoader.js

@@ -33,7 +33,7 @@ class ResourceLoader {
     this.model = model;
     const mainTrack = model.tracks.find((track) => track.id === (model.mainTrackId || "main"));
     if (mainTrack?.clips?.[0] && hasResourceId(mainTrack.clips[0])) {
-      await this.fetch(mainTrack.clips[0].resourceId, {
+      await this.load(mainTrack.clips[0].resourceId, {
         priority: "high",
         clipId: mainTrack.clips[0].id,
         trackId: mainTrack.id
@@ -60,7 +60,7 @@ class ResourceLoader {
       if (!resource || resource.state === "ready" || resource.state === "loading" || resource.state === "error") {
         continue;
       }
-      this.fetch(resource.id, { priority: "low" });
+      this.load(resource.id, { priority: "low" });
     }
   }
   processPreloadQueue() {
@@ -68,7 +68,7 @@ class ResourceLoader {
     while (this.preloadQueue.length > 0) {
       const resourceId = this.preloadQueue.shift();
       if (!resourceId) break;
-      this.fetch(resourceId, { priority: "low" }).finally(() => {
+      this.load(resourceId, { priority: "low" }).finally(() => {
         this.processPreloadQueue();
       });
     }
@@ -89,6 +89,103 @@ class ResourceLoader {
       this.startLoad(task);
     }
   }
+  /**
+   * Check if resource is cached and ready (without loading)
+   */
+  async isResourceCached(resourceId, type) {
+    switch (type) {
+      case "video": {
+        const hasOPFS = await this.cacheManager.hasResourceInCache(resourceId);
+        const hasIndex = this.cacheManager.mp4IndexCache.has(resourceId);
+        return hasOPFS && hasIndex;
+      }
+      case "audio":
+        return this.cacheManager.audioSampleCache.has(resourceId);
+      case "image":
+        return this.blobCache.has(resourceId);
+      case "json":
+      case "text":
+        return this.blobCache.has(resourceId);
+      default:
+        return false;
+    }
+  }
+  /**
+   * Transfer video stream to worker
+   */
+  async transferVideoToWorker(resourceId, sessionId) {
+    const stream = await this.createOPFSReadStream(resourceId);
+    const demuxWorker = await this.workerPool.get("videoDemux", sessionId);
+    if (demuxWorker) {
+      await demuxWorker.sendStream(stream, {
+        sessionId,
+        resourceId
+      });
+    } else {
+      stream.cancel();
+    }
+  }
+  /**
+   * Transfer image to worker
+   */
+  async transferImageToWorker(resourceId, sessionId, imageBitmap) {
+    const composeWorker = await this.workerPool.get("videoCompose", sessionId);
+    await composeWorker?.send?.(
+      "receive_image",
+      { resourceId, sessionId, imageBitmap },
+      { transfer: [imageBitmap] }
+    );
+  }
+  /**
+   * Load video resource (download + cache or read from cache)
+   */
+  async loadVideoResource(task) {
+    const cached = await this.cacheManager.hasResourceInCache(task.resourceId);
+    if (cached) {
+      await this.ensureIndexParsed(task.resourceId);
+      if (task.sessionId) {
+        await this.transferVideoToWorker(task.resourceId, task.sessionId);
+      }
+    } else {
+      await this.loadWithOPFSCache(task);
+    }
+  }
+  /**
+   * Load audio resource (download + parse or reuse cache)
+   */
+  async loadAudioResource(task) {
+    if (!this.cacheManager.audioSampleCache.has(task.resourceId)) {
+      await this.loadAndParseAudioFile(task);
+    }
+  }
+  /**
+   * Load image resource (download + cache or read from cache) and transfer to worker
+   */
+  async loadImageResource(task) {
+    let blob = this.blobCache.get(task.resourceId);
+    if (!blob) {
+      if (task.controller) {
+        blob = await this.fetchBlob(task.resource.uri, task.controller.signal);
+        this.blobCache.set(task.resourceId, blob);
+      } else {
+        return null;
+      }
+    }
+    const imageBitmap = await createImageBitmapFromBlob(blob);
+    if (task.sessionId) {
+      await this.transferImageToWorker(task.resourceId, task.sessionId, imageBitmap);
+      return null;
+    }
+    return imageBitmap;
+  }
+  /**
+   * Load text resource (json/text)
+   */
+  async loadTextResource(task) {
+    if (task.controller) {
+      await this.fetchBlob(task.resource.uri, task.controller.signal);
+    }
+  }
   /**
    * Start loading a resource
    * Handles state management (loading → ready/error) for all resource types
@@ -99,29 +196,24 @@ class ResourceLoader {
     try {
       this.updateResourceState(task.resourceId, "loading");
       task.controller = new AbortController();
-      if (task.resource.type === "image") {
-        await this.loadImageBitmap(task);
-        if (task.sessionId) {
-          this.transferCachedImage(task);
-        }
-      } else if (task.resource.type === "video") {
-        const cached = await this.cacheManager.hasResourceInCache(task.resourceId);
-        if (cached) {
-          await this.ensureIndexParsed(task.resourceId);
-          if (task.sessionId) {
-            const stream = await this.createOPFSReadStream(task.resourceId);
-            task.stream = stream;
-            await this.transferToDemuxWorker(task);
+      switch (task.resource.type) {
+        case "image": {
+          const image = await this.loadImageResource(task);
+          if (image) {
+            image.close();
           }
-        } else {
-          await this.loadWithOPFSCache(task);
+          break;
         }
-      } else if (task.resource.type === "audio") {
-        if (!this.cacheManager.audioSampleCache.has(task.resourceId)) {
-          await this.loadAndParseAudioFile(task);
-        }
-      } else if (task.resource.type === "json" || task.resource.type === "text") {
-        await this.loadTextResource(task);
+        case "video":
+          await this.loadVideoResource(task);
+          break;
+        case "audio":
+          await this.loadAudioResource(task);
+          break;
+        case "json":
+        case "text":
+          await this.loadTextResource(task);
+          break;
       }
       this.updateResourceState(task.resourceId, "ready");
     } catch (error) {
@@ -263,19 +355,18 @@ class ResourceLoader {
     const { resourceId, clipId } = task;
     try {
       const parser = new MP4IndexParser();
+      const shouldExtractFirstGOP = clipId ? this.shouldExtractCover(clipId) : false;
       const result = await parser.parseFromStream(stream, {
-        onFirstFrameReady: async (index, chunks) => {
+        onFirstFrameReady: shouldExtractFirstGOP ? async (index, chunks) => {
           index.resourceId = resourceId;
           this.cacheManager.mp4IndexCache.set(resourceId, index);
-          if (clipId) {
-            this.eventBus?.emit(MeframeEvent.ResourceFirstFrameReady, {
-              resourceId,
-              clipId,
-              index,
-              chunks
-            });
-          }
-        }
+          this.eventBus?.emit(MeframeEvent.ResourceFirstFrameReady, {
+            resourceId,
+            clipId,
+            index,
+            chunks
+          });
+        } : void 0
       });
       result.index.resourceId = resourceId;
       if (!this.cacheManager.mp4IndexCache.has(resourceId)) {
@@ -294,13 +385,6 @@ class ResourceLoader {
       throw error;
     }
   }
-  /**
-   * Load text-based resources (json, text)
-   * Just download the content - state management is handled by startLoad()
-   */
-  async loadTextResource(task) {
-    await this.fetchBlob(task.resource.uri, task.controller.signal);
-  }
   async loadImage(resource) {
     const task = {
       resourceId: resource.id,
@@ -311,24 +395,10 @@ class ResourceLoader {
       priority: "normal",
       controller: new AbortController()
     };
-    return this.loadImageBitmap(task);
-  }
-  /**
-   * Load image resource: fetch blob → create ImageBitmap → cache in CacheManager
-   * Note: Images don't need streaming (typically < 5MB)
-   *
-   * Strategy for window cache architecture:
-   * - Store ImageBitmap in CacheManager.imageBitmapCache (main thread accessible)
-   * - OnDemandComposeSession retrieves from cache for composition
-   * - No longer transfer to Worker (composition is in main thread)
-   */
-  async loadImageBitmap(task) {
-    let blob = this.blobCache.get(task.resourceId);
-    if (!blob) {
-      blob = await this.fetchBlob(task.resource.uri, task.controller.signal);
-      this.blobCache.set(task.resourceId, blob);
+    const imageBitmap = await this.loadImageResource(task);
+    if (!imageBitmap) {
+      throw new Error(`Failed to load image ${resource.id}`);
     }
-    const imageBitmap = await createImageBitmapFromBlob(blob);
     return imageBitmap;
   }
   /**
@@ -341,26 +411,6 @@ class ResourceLoader {
     }
     return response.blob();
   }
-  /**
-   * Transfer cached image to a session
-   * Creates new ImageBitmap from cached Blob and transfers to worker
-   */
-  async transferCachedImage(task) {
-    const { resourceId, sessionId } = task;
-    const blob = this.blobCache.get(resourceId);
-    if (!blob || !sessionId) return;
-    const imageBitmap = await createImageBitmapFromBlob(blob);
-    const composeWorker = await this.workerPool.get("videoCompose", sessionId);
-    await composeWorker?.send?.(
-      "receive_image",
-      {
-        resourceId,
-        sessionId,
-        imageBitmap
-      },
-      { transfer: [imageBitmap] }
-    );
-  }
   /**
    * Transfer stream to demux worker (for audio files)
    */
@@ -409,7 +459,7 @@ class ResourceLoader {
    * 2. processQueue() → startLoad() executes async in background
    * 3. startLoad() completes → finally → completeTask() → task.resolve()/reject()
    */
-  async fetch(resourceId, options) {
+  async load(resourceId, options) {
     if (!resourceId) {
       return;
     }
@@ -418,6 +468,64 @@ class ResourceLoader {
       console.warn(`Resource ${resourceId} not found in model`);
       return;
     }
+    if (resource.state === "ready") {
+      if (!options?.sessionId) {
+        return;
+      }
+      const isCached = await this.isResourceCached(resourceId, resource.type);
+      const hasActiveTaskForSession = this.taskManager.hasActiveTaskForSession(
+        resourceId,
+        options.sessionId
+      );
+      if (isCached && !hasActiveTaskForSession) {
+        switch (resource.type) {
+          case "video":
+            await this.transferVideoToWorker(resourceId, options.sessionId);
+            break;
+          case "image": {
+            const blob = this.blobCache.get(resourceId);
+            if (blob) {
+              const imageBitmap = await createImageBitmapFromBlob(blob);
+              await this.transferImageToWorker(resourceId, options.sessionId, imageBitmap);
+            }
+            break;
+          }
+        }
+        return;
+      }
+    }
+    if (resource.state === "loading") {
+      const existingTask2 = this.taskManager.getActiveTask(resourceId);
+      if (existingTask2) {
+        if (!options?.sessionId || existingTask2.sessionId === options.sessionId) {
+          return existingTask2.promise;
+        }
+      }
+    }
+    const existingTask = this.taskManager.getActiveTask(resourceId);
+    if (existingTask) {
+      if (options?.sessionId && !existingTask.sessionId) {
+        await existingTask.promise;
+        const isCached = await this.isResourceCached(resourceId, resource.type);
+        if (isCached) {
+          switch (resource.type) {
+            case "video":
+              await this.transferVideoToWorker(resourceId, options.sessionId);
+              break;
+            case "image": {
+              const blob = this.blobCache.get(resourceId);
+              if (blob) {
+                const imageBitmap = await createImageBitmapFromBlob(blob);
+                await this.transferImageToWorker(resourceId, options.sessionId, imageBitmap);
+              }
+              break;
+            }
+          }
+        }
+        return;
+      }
+      return existingTask.promise;
+    }
     const task = this.enqueueLoad(
       resource,
       options?.priority || "normal",
@@ -458,7 +566,7 @@ class ResourceLoader {
         options?.trackId
       );
     } else {
-      await this.fetch(resourceId, options);
+      await this.load(resourceId, options);
     }
   }
   get activeTasks() {
@@ -471,6 +579,15 @@ class ResourceLoader {
     this.taskManager.clear();
     this.blobCache.clear();
   }
+  /**
+   * Check if a clip needs cover extraction (first GOP decode)
+   * Only clips starting at time 0 need fast cover rendering
+   */
+  shouldExtractCover(clipId) {
+    if (!this.model) return false;
+    const clip = this.model.findClip(clipId);
+    return clip?.startUs === 0;
+  }
 }
 export {
   ResourceLoader