@meframe/core 0.0.3 → 0.0.5

package/dist/cache/CacheManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"CacheManager.js","sources":["../../src/cache/CacheManager.ts"],"sourcesContent":["import type { TimeUs } from '../model/types';\nimport { RcFrame } from '../model';\nimport type { GOP } from './types';\nimport { VideoL1Cache } from './l1/VideoL1Cache';\nimport { L2Cache } from './L2Cache';\nimport { MeframeEvent } from '../event/events';\nimport type { EventBus } from '../event/EventBus';\nimport type { EventPayloadMap } from '../event/events';\nimport type { CompositionModel } from '../model';\nimport { AudioL1Cache } from './l1/AudioL1Cache';\nimport { MixedAudioL1Cache } from './l1/MixedAudioL1Cache';\n\ninterface CacheManagerConfig {\n  l1: {\n    maxMemoryMB: number;\n    maxGOPs?: number;\n    gopIntervalUs?: number;\n  };\n  l2: {\n    maxSizeMB: number;\n    projectId: string;\n  };\n}\n\ninterface WaitForFrameOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  toleranceUs?: number;\n}\n\ninterface FrameWaiter {\n  requestKey: string;\n  clipId: string;\n  targetTimeUs: TimeUs;\n  resolve: (result: WaitForFrameResult) => void;\n  reject: (reason?: unknown) => void;\n  toleranceUs: number;\n  timeoutId?: ReturnType<typeof setTimeout>;\n  abortCleanup?: () => void;\n}\n\ninterface ClipReadyWaiter {\n  clipId: string;\n  minFrameCount: number;\n  resolve: (ready: boolean) => void;\n  reject: (reason?: unknown) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n}\n\nconst DEFAULT_WAIT_TOLERANCE_US = 33_333; // ≈1 frame @30fps\n\nexport interface WaitForFrameResult {\n  frame: RcFrame | null;\n  source: 'l1' | 'wait';\n  timestampUs: TimeUs;\n  clipId: string;\n}\n\n/**\n * Simplified CacheManager for 3-Clip strategy\n *\n * Core features:\n * - L1 (VRAM) for composed VideoFrames\n * - L2 (IndexedDB/OPFS) for encoded chunks\n * - Clip-level cache management\n */\nexport class CacheManager {\n  private readonly videoL1Cache: VideoL1Cache;\n  private readonly audioL1Cache: AudioL1Cache;\n  private readonly mixedAudioL1Cache: MixedAudioL1Cache;\n  readonly l2Cache: L2Cache;\n  private pendingFramePromises = new Map<string, Promise<WaitForFrameResult>>();\n  private frameWaiters = new Map<string, Set<FrameWaiter>>();\n  private clipReadyWaiters = new Map<string, ClipReadyWaiter[]>();\n  private eventBus?: EventBus<EventPayloadMap>;\n\n  constructor(config: CacheManagerConfig, eventBus?: EventBus<EventPayloadMap>) {\n    this.videoL1Cache = new VideoL1Cache(config.l1);\n    this.l2Cache = new L2Cache(config.l2);\n    this.audioL1Cache = new AudioL1Cache();\n    this.mixedAudioL1Cache = new MixedAudioL1Cache();\n    this.eventBus = eventBus;\n  }\n\n  async init(): Promise<void> {\n    await this.l2Cache.init();\n  }\n\n  configure(_model: CompositionModel | null): void {\n    // Simplified - no complex window configuration needed\n    // 3-Clip strategy uses fixed memory budget\n  }\n\n  acceptComposedFrames(\n    stream: ReadableStream<VideoFrame | { frame: VideoFrame; metadata?: any }>,\n    params: {\n      clipId: string;\n      trackId: string;\n      fps: number;\n      onFrame: (info: { clipId: string; timeUs: TimeUs }) => void;\n    }\n  ): void {\n    const reader = stream.getReader();\n    const process = async (): Promise<void> => {\n      const { done, value } = await reader.read();\n      if (done) {\n        reader.releaseLock();\n        return;\n      }\n      if (value) {\n        const fps = params.fps > 0 ? params.fps : 30;\n        const frameDuration = Math.round(1_000_000 / fps);\n\n        const frame = (value as any).frame || value;\n        const metadata = (value as any).metadata;\n        const gopSerial = metadata?.gopSerial;\n        const isKeyframe = metadata?.isKeyframe;\n\n        const timestamp = frame.timestamp ?? 0;\n\n        const rcFrame = this.videoL1Cache.addFrame(\n          frame,\n          params.clipId,\n          frameDuration,\n          gopSerial,\n          isKeyframe\n        );\n        if (!rcFrame) {\n          await process();\n          return;\n        }\n\n        this.notifyFrameWaiters(params.clipId, timestamp, frameDuration, rcFrame);\n\n        if (timestamp === 0) {\n          this.eventBus?.emit(MeframeEvent.CacheCover, {\n            timeUs: timestamp,\n            clipId: params.clipId,\n            level: 'L1',\n            size: rcFrame.sizeEstimate ?? 0,\n          });\n        }\n\n        const info = { clipId: params.clipId, timeUs: timestamp };\n        this.eventBus?.emit(MeframeEvent.ComposeFrameReady, {\n          timeUs: timestamp,\n          frameNumber: Math.floor(timestamp / frameDuration),\n          renderTimeMs: 0,\n          trackId: params.trackId,\n          clipId: params.clipId,\n        });\n\n        params.onFrame(info);\n      }\n\n      await process();\n    };\n\n    process().catch((error) => {\n      this.eventBus?.emit(MeframeEvent.ComposeFrameDropped, {\n        timeUs: 0,\n        reason: 'compose_slow',\n      });\n      reader.releaseLock();\n      throw error;\n    });\n  }\n\n  acceptEncodedChunks(\n    stream: ReadableStream<EncodedVideoChunk | EncodedAudioChunk>,\n    clipId: string,\n    track: 'video' | 'audio'\n  ): void {\n    const reader = stream.getReader();\n    const chunks: Array<EncodedVideoChunk | EncodedAudioChunk> = [];\n\n    const process = async (): Promise<void> => {\n      const { done, value } = await reader.read();\n      if (done) {\n        if (chunks.length > 0) {\n          await this.l2Cache.put(clipId, chunks, track);\n        }\n        reader.releaseLock();\n        return;\n      }\n\n      if (value) {\n        chunks.push(value);\n        this.eventBus?.emit(MeframeEvent.EncodeChunkReady, {\n          timeUs: value.timestamp,\n          durationUs: value.duration ?? 0,\n          track,\n          size: value.byteLength,\n        });\n      }\n\n      await process();\n    };\n\n    process().catch((error) => {\n      this.eventBus?.emit(MeframeEvent.EncodeChunkError, {\n        timeUs: 0,\n        track,\n        error,\n      });\n      reader.releaseLock();\n      throw error;\n    });\n  }\n\n  acceptMixedAudio(\n    stream: ReadableStream<AudioData>,\n    metadata: { sampleRate: number; numberOfChannels: number }\n  ): void {\n    this.audioL1Cache.attachStream(stream, metadata);\n  }\n\n  putClipAudioData(\n    clipId: string,\n    audioData: AudioData,\n    clipStartUs: TimeUs,\n    clipDurationUs: TimeUs\n  ): void {\n    this.audioL1Cache.putClipAudioData(clipId, audioData, clipStartUs, clipDurationUs);\n  }\n\n  getClipPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): Float32Array[] | null {\n    return this.audioL1Cache.getPCM(clipId, startUs, endUs);\n  }\n\n  hasClipPCM(clipId: string): boolean {\n    return this.audioL1Cache.hasClipPCM(clipId);\n  }\n\n  putMixedAudio(startUs: TimeUs, endUs: TimeUs, buffer: AudioBuffer): void {\n    this.mixedAudioL1Cache.putMixed(startUs, endUs, buffer);\n  }\n\n  getMixedAudio(startUs: TimeUs, endUs: TimeUs): AudioBuffer | null {\n    return this.mixedAudioL1Cache.getMixed(startUs, endUs);\n  }\n\n  resetAudioCache(): void {\n    this.audioL1Cache.reset();\n    this.mixedAudioL1Cache.clear();\n  }\n\n  async getFrame(timeUs: TimeUs, clipId: string): Promise<RcFrame | null> {\n    const rcFrame = this.videoL1Cache.get(timeUs, clipId);\n    if (rcFrame) {\n      return rcFrame;\n    }\n\n    const decodeKey = this.makeRequestKey(clipId, timeUs);\n    const pending = this.pendingFramePromises.get(decodeKey);\n    if (pending) {\n      const result = await pending;\n      return result.frame;\n    }\n\n    const decodePromise = this.decodeFromL2(timeUs, clipId);\n    const tracked = decodePromise.finally(() => {\n      this.pendingFramePromises.delete(decodeKey);\n    });\n\n    this.pendingFramePromises.set(\n      decodeKey,\n      tracked.then((frame) => ({ frame, source: 'wait' as const, timestampUs: timeUs, clipId }))\n    );\n    return tracked;\n  }\n\n  waitForFrame(\n    timeUs: TimeUs,\n    clipId: string,\n    options: WaitForFrameOptions = {}\n  ): Promise<WaitForFrameResult> {\n    const existing = this.videoL1Cache.get(timeUs, clipId);\n    if (existing) {\n      return Promise.resolve({ frame: existing, source: 'l1', timestampUs: timeUs, clipId });\n    }\n\n    const requestKey = this.makeRequestKey(clipId, timeUs);\n    const existingPromise = this.pendingFramePromises.get(requestKey);\n    if (existingPromise) {\n      return existingPromise;\n    }\n\n    const promise = new Promise<WaitForFrameResult>((resolve, reject) => {\n      const toleranceUs = Math.max(\n        options.toleranceUs ?? DEFAULT_WAIT_TOLERANCE_US,\n        DEFAULT_WAIT_TOLERANCE_US\n      );\n\n      const waiter: FrameWaiter = {\n        requestKey,\n        clipId,\n        targetTimeUs: timeUs,\n        resolve,\n        reject,\n        toleranceUs,\n      };\n\n      let waiters = this.frameWaiters.get(clipId);\n      if (!waiters) {\n        waiters = new Set();\n        this.frameWaiters.set(clipId, waiters);\n      }\n      waiters.add(waiter);\n\n      const signal = options.signal;\n      if (signal) {\n        const onAbort = (): void => {\n          this.removeWaiter(waiter);\n          this.cleanupWaiter(waiter);\n          reject(new DOMException('Render aborted', 'AbortError'));\n        };\n\n        if (signal.aborted) {\n          onAbort();\n          return;\n        }\n\n        signal.addEventListener('abort', onAbort, { once: true });\n        waiter.abortCleanup = () => {\n          signal.removeEventListener('abort', onAbort);\n        };\n      }\n\n      if (options.timeoutMs && options.timeoutMs > 0) {\n        waiter.timeoutId = setTimeout(() => {\n          this.removeWaiter(waiter);\n          this.cleanupWaiter(waiter);\n          reject(new Error('waitForFrame timeout'));\n        }, options.timeoutMs);\n      }\n    });\n\n    const trackedPromise = promise.finally(() => {\n      this.pendingFramePromises.delete(requestKey);\n    });\n\n    this.pendingFramePromises.set(requestKey, trackedPromise);\n    return trackedPromise;\n  }\n\n  async putGOP(gop: GOP): Promise<void> {\n    if (!gop.clipId) {\n      throw new Error('GOP clipId is required for clip-aware caching');\n    }\n    this.videoL1Cache.putGOP(gop, gop.clipId);\n    this.encodeToL2(gop);\n  }\n\n  async putEncodedChunks(\n    clipHash: string,\n    chunks: Array<EncodedVideoChunk | EncodedAudioChunk>,\n    track: 'video' | 'audio'\n  ): Promise<void> {\n    await this.l2Cache.put(clipHash, chunks, track);\n  }\n\n  invalidateRange(startUs: TimeUs, endUs: TimeUs, clipId?: string): void {\n    this.videoL1Cache.invalidateRange(startUs, endUs, clipId);\n    this.l2Cache.invalidateRange(startUs, endUs, clipId);\n  }\n\n  async invalidateClip(clipId: string): Promise<void> {\n    this.videoL1Cache.invalidateRange(0, Infinity, clipId);\n    await this.l2Cache.invalidateClip(clipId);\n  }\n\n  /**\n   * Evict a clip from L1 cache\n   */\n  evictClip(clipId: string): void {\n    this.videoL1Cache.evictClip(clipId);\n  }\n\n  /**\n   * Check if a clip is cached in L1\n   */\n  isClipCached(clipId: string): boolean {\n    return this.videoL1Cache.isClipCached(clipId);\n  }\n\n  /**\n   * Wait for a clip to have minimum frames cached\n   * Used by PlaybackController for buffering state\n   */\n  waitForClipReady(\n    clipId: string,\n    options: { minFrameCount?: number; timeoutMs?: number } = {}\n  ): Promise<boolean> {\n    const minFrameCount = options.minFrameCount ?? 30;\n    const currentFrameCount = this.videoL1Cache.getClipFrameCount(clipId);\n\n    if (currentFrameCount >= minFrameCount) {\n      return Promise.resolve(true);\n    }\n\n    return new Promise<boolean>((resolve, reject) => {\n      const waiter: ClipReadyWaiter = {\n        clipId,\n        minFrameCount,\n        resolve,\n        reject,\n      };\n\n      const waiters = this.clipReadyWaiters.get(clipId) || [];\n      waiters.push(waiter);\n      this.clipReadyWaiters.set(clipId, waiters);\n\n      if (options.timeoutMs && options.timeoutMs > 0) {\n        waiter.timeoutId = setTimeout(() => {\n          const waiters = this.clipReadyWaiters.get(clipId);\n          if (waiters) {\n            const remaining = waiters.filter((w) => w !== waiter);\n            if (remaining.length === 0) {\n              this.clipReadyWaiters.delete(clipId);\n            } else {\n              this.clipReadyWaiters.set(clipId, remaining);\n            }\n          }\n          resolve(false);\n        }, options.timeoutMs);\n      }\n    });\n  }\n\n  async clear(): Promise<void> {\n    this.videoL1Cache.clear();\n    await this.l2Cache.clear();\n  }\n\n  getMetadata() {\n    return {\n      l1: this.videoL1Cache.getMetadata(),\n      l2: this.l2Cache.getMetadata(),\n    };\n  }\n\n  private async decodeFromL2(timeUs: TimeUs, clipId: string): Promise<RcFrame | null> {\n    const encodedChunk = await this.l2Cache.get(timeUs, clipId);\n    if (!encodedChunk) {\n      return null;\n    }\n\n    return null;\n  }\n\n  private async encodeToL2(_gop: GOP): Promise<void> {\n    // Placeholder for L2 encoding\n  }\n\n  private notifyFrameWaiters(\n    clipId: string,\n    timestampUs: TimeUs,\n    frameDurationUs: TimeUs,\n    frame: RcFrame\n  ): void {\n    const waiters = this.frameWaiters.get(clipId);\n    if (!waiters || waiters.size === 0) {\n      return;\n    }\n\n    const resolved: FrameWaiter[] = [];\n\n    for (const waiter of waiters) {\n      const matches = this.matchesTimestamp(\n        waiter.targetTimeUs,\n        timestampUs,\n        frameDurationUs,\n        waiter.toleranceUs\n      );\n\n      if (!matches) continue;\n\n      resolved.push(waiter);\n      this.cleanupWaiter(waiter);\n\n      waiter.resolve({\n        frame,\n        source: 'wait',\n        timestampUs,\n        clipId,\n      });\n    }\n\n    for (const waiter of resolved) {\n      waiters.delete(waiter);\n    }\n\n    if (waiters.size === 0) {\n      this.frameWaiters.delete(clipId);\n    }\n\n    this.notifyClipReadyWaiters(clipId);\n  }\n\n  private notifyClipReadyWaiters(clipId: string): void {\n    const waiters = this.clipReadyWaiters.get(clipId);\n    if (!waiters || waiters.length === 0) {\n      return;\n    }\n\n    const frameCount = this.videoL1Cache.getClipFrameCount(clipId);\n    const resolved: ClipReadyWaiter[] = [];\n\n    for (const waiter of waiters) {\n      if (frameCount >= waiter.minFrameCount) {\n        resolved.push(waiter);\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        waiter.resolve(true);\n      }\n    }\n\n    const remaining = waiters.filter((w) => !resolved.includes(w));\n    if (remaining.length === 0) {\n      this.clipReadyWaiters.delete(clipId);\n    } else {\n      this.clipReadyWaiters.set(clipId, remaining);\n    }\n  }\n\n  private cleanupWaiter(waiter: FrameWaiter): void {\n    if (waiter.timeoutId) {\n      clearTimeout(waiter.timeoutId);\n      waiter.timeoutId = undefined;\n    }\n\n    if (waiter.abortCleanup) {\n      waiter.abortCleanup();\n      waiter.abortCleanup = undefined;\n    }\n  }\n\n  private removeWaiter(waiter: FrameWaiter): void {\n    const waiters = this.frameWaiters.get(waiter.clipId);\n    if (!waiters) return;\n\n    waiters.delete(waiter);\n    if (waiters.size === 0) {\n      this.frameWaiters.delete(waiter.clipId);\n    }\n  }\n\n  private matchesTimestamp(\n    targetTimeUs: TimeUs,\n    actualTimeUs: TimeUs,\n    frameDurationUs: TimeUs,\n    toleranceUs: TimeUs\n  ): boolean {\n    if (targetTimeUs === actualTimeUs) return true;\n\n    const delta = Math.abs(targetTimeUs - actualTimeUs);\n    if (delta <= toleranceUs) {\n      return true;\n    }\n\n    if (actualTimeUs >= targetTimeUs && actualTimeUs < targetTimeUs + frameDurationUs) {\n      return true;\n    }\n\n    return false;\n  }\n\n  private makeRequestKey(clipId: string, timeUs: TimeUs): string {\n    return `${clipId}:${timeUs}`;\n  }\n}\n"],"names":["waiters"],"mappings":"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"}
+{"version":3,"file":"CacheManager.js","sources":["../../src/cache/CacheManager.ts"],"sourcesContent":["import type { TimeUs } from '../model/types';\nimport { RcFrame } from '../model';\nimport { VideoL1Cache } from './l1/VideoL1Cache';\nimport { L2Cache } from './L2Cache';\nimport { MeframeEvent } from '../event/events';\nimport type { EventBus } from '../event/EventBus';\nimport type { EventPayloadMap } from '../event/events';\nimport { AudioL1Cache } from './l1/AudioL1Cache';\nimport { MixedAudioL1Cache } from './l1/MixedAudioL1Cache';\n\ninterface CacheManagerConfig {\n  l1: {\n    maxMemoryMB: number;\n    maxGOPs?: number;\n    gopIntervalUs?: number;\n  };\n  l2: {\n    maxSizeMB: number;\n    projectId: string;\n  };\n}\n\ninterface WaitForFrameOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  toleranceUs?: number;\n}\n\ninterface FrameWaiter {\n  requestKey: string;\n  clipId: string;\n  targetTimeUs: TimeUs;\n  resolve: (result: WaitForFrameResult) => void;\n  reject: (reason?: unknown) => void;\n  toleranceUs: number;\n  timeoutId?: ReturnType<typeof setTimeout>;\n  abortCleanup?: () => void;\n}\n\ninterface ClipReadyWaiter {\n  clipId: string;\n  minFrameCount: number;\n  resolve: (ready: boolean) => void;\n  reject: (reason?: unknown) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n}\n\nconst DEFAULT_WAIT_TOLERANCE_US = 33_333; // ≈1 frame @30fps\n\nexport interface WaitForFrameResult {\n  frame: RcFrame | null;\n  source: 'l1' | 'wait';\n  timestampUs: TimeUs;\n  clipId: string;\n}\n\n/**\n * Simplified CacheManager for 2-Clip strategy\n *\n * Core features:\n * - L1 (VRAM) for composed VideoFrames\n * - L2 (IndexedDB/OPFS) for encoded chunks\n * - Clip-level cache management\n */\nexport class CacheManager {\n  private readonly videoL1Cache: VideoL1Cache;\n  private readonly audioL1Cache: AudioL1Cache;\n  private readonly mixedAudioL1Cache: MixedAudioL1Cache;\n  readonly l2Cache: L2Cache;\n  private pendingFramePromises = new Map<string, Promise<WaitForFrameResult>>();\n  private frameWaiters = new Map<string, Set<FrameWaiter>>();\n  private clipReadyWaiters = new Map<string, ClipReadyWaiter[]>();\n  private eventBus?: EventBus<EventPayloadMap>;\n\n  constructor(config: CacheManagerConfig, eventBus?: EventBus<EventPayloadMap>) {\n    this.videoL1Cache = new VideoL1Cache(config.l1);\n    this.l2Cache = new L2Cache(config.l2);\n    this.audioL1Cache = new AudioL1Cache();\n    this.mixedAudioL1Cache = new MixedAudioL1Cache();\n    this.eventBus = eventBus;\n  }\n\n  async init(): Promise<void> {\n    await this.l2Cache.init();\n  }\n\n  async receiveComposedFrames(\n    stream: ReadableStream<VideoFrame | { frame: VideoFrame; metadata?: any }>,\n    params: {\n      clipId: string;\n      trackId: string;\n      fps: number;\n      onFrame: (info: { clipId: string; timeUs: TimeUs }) => void;\n    }\n  ): Promise<void> {\n    const reader = stream.getReader();\n    const process = async (): Promise<void> => {\n      const { done, value } = await reader.read();\n      if (done) {\n        reader.releaseLock();\n        return;\n      }\n      if (value) {\n        const fps = params.fps > 0 ? params.fps : 30;\n        const frameDuration = Math.round(1_000_000 / fps);\n\n        const frame = (value as any).frame || value;\n        const metadata = (value as any).metadata;\n        const gopSerial = metadata?.gopSerial;\n        const isKeyframe = metadata?.isKeyframe;\n\n        const timestamp = frame.timestamp ?? 0;\n\n        const rcFrame = this.videoL1Cache.addFrame(\n          frame,\n          params.clipId,\n          frameDuration,\n          params.trackId,\n          gopSerial,\n          isKeyframe\n        );\n        if (!rcFrame) {\n          await process();\n          return;\n        }\n\n        this.notifyFrameWaiters(params.clipId, timestamp, frameDuration, rcFrame);\n\n        if (timestamp === 0) {\n          this.eventBus?.emit(MeframeEvent.CacheCover, {\n            timeUs: timestamp,\n            clipId: params.clipId,\n            level: 'L1',\n            size: rcFrame.sizeEstimate ?? 0,\n          });\n        }\n\n        const info = { clipId: params.clipId, timeUs: timestamp };\n        this.eventBus?.emit(MeframeEvent.ComposeFrameReady, {\n          timeUs: timestamp,\n          frameNumber: Math.floor(timestamp / frameDuration),\n          renderTimeMs: 0,\n          trackId: params.trackId,\n          clipId: params.clipId,\n        });\n\n        params.onFrame(info);\n      }\n\n      await process();\n    };\n\n    try {\n      await process();\n    } catch (error) {\n      this.eventBus?.emit(MeframeEvent.ComposeFrameDropped, {\n        timeUs: 0,\n        reason: 'compose_slow',\n      });\n      reader.releaseLock();\n      throw error;\n    }\n  }\n\n  async receiveEncodedChunks(\n    stream: ReadableStream<{ chunk: EncodedVideoChunk; metadata: EncodedVideoChunkMetadata }>,\n    clipId: string,\n    track: 'video' | 'audio',\n    options?: {\n      onComplete?: (metadata: EncodedVideoChunkMetadata) => void;\n      onError?: (error: Error) => void;\n    }\n  ): Promise<void> {\n    const reader = stream.getReader();\n    const chunks: Array<EncodedVideoChunk | EncodedAudioChunk> = [];\n    const batchSize = track === 'video' ? 30 : 50;\n    let decoderConfig: any = null;\n    let metadata: EncodedVideoChunkMetadata | EncodedAudioChunkMetadata | undefined;\n    const process = async (): Promise<void> => {\n      const { done, value } = await reader.read();\n      const { chunk, metadata: chunkMetadata } = value ?? {};\n      if (chunkMetadata) {\n        metadata = chunkMetadata;\n        // Extract decoderConfig from first chunk's metadata\n        if (!decoderConfig && chunkMetadata.decoderConfig) {\n          decoderConfig = chunkMetadata.decoderConfig;\n        }\n      }\n      if (done) {\n        // Flush remaining chunks on stream end\n        if (chunks.length > 0) {\n          await this.l2Cache.put(clipId, chunks, track, {\n            isComplete: true,\n            metadata: decoderConfig,\n          });\n          const firstChunk = chunks[0];\n          if (firstChunk) {\n            this.eventBus?.emit(MeframeEvent.CacheWrite, {\n              clipId,\n              timeUs: firstChunk.timestamp,\n              level: 'L2',\n              size: chunks.reduce((sum, c) => sum + c.byteLength, 0),\n            });\n          }\n        } else {\n          // Mark as complete even if no chunks in final batch\n          await this.l2Cache.markComplete(clipId, track);\n        }\n        reader.releaseLock();\n\n        // Notify completion\n        if (options?.onComplete) {\n          options.onComplete(metadata!);\n        }\n        return;\n      }\n\n      if (chunk) {\n        chunks.push(chunk);\n\n        this.eventBus?.emit(MeframeEvent.EncodeChunkReady, {\n          timeUs: chunk.timestamp,\n          durationUs: chunk.duration ?? 0,\n          track,\n          size: chunk.byteLength,\n        });\n\n        // Batch write to L2 when buffer is full\n        if (chunks.length >= batchSize) {\n          const batchToWrite = chunks.splice(0);\n          if (batchToWrite.length > 0) {\n            await this.l2Cache.put(clipId, batchToWrite, track, {\n              metadata: decoderConfig,\n            });\n            this.eventBus?.emit(MeframeEvent.CacheWrite, {\n              clipId,\n              timeUs: chunk.timestamp,\n              level: 'L2',\n              size: batchToWrite.reduce((sum, c) => sum + c.byteLength, 0),\n            });\n          }\n        }\n      }\n\n      await process();\n    };\n\n    try {\n      await process();\n    } catch (error) {\n      // Flush any accumulated chunks before throwing\n      if (chunks.length > 0) {\n        await this.l2Cache.put(clipId, chunks, track, {\n          metadata: decoderConfig,\n        });\n      }\n      this.eventBus?.emit(MeframeEvent.EncodeChunkError, {\n        timeUs: 0,\n        track,\n        error: error as Error,\n      });\n      reader.releaseLock();\n\n      // Notify error\n      if (options?.onError) {\n        options.onError(error as Error);\n      }\n      throw error;\n    }\n  }\n\n  acceptMixedAudio(\n    stream: ReadableStream<AudioData>,\n    metadata: { sampleRate: number; numberOfChannels: number }\n  ): void {\n    this.audioL1Cache.attachStream(stream, metadata);\n  }\n\n  putClipAudioData(\n    clipId: string,\n    audioData: AudioData,\n    clipStartUs: TimeUs,\n    clipDurationUs: TimeUs\n  ): void {\n    this.audioL1Cache.putClipAudioData(clipId, audioData, clipStartUs, clipDurationUs);\n  }\n\n  getClipPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): Float32Array[] | null {\n    return this.audioL1Cache.getPCM(clipId, startUs, endUs);\n  }\n\n  hasClipPCM(clipId: string): boolean {\n    return this.audioL1Cache.hasClipPCM(clipId);\n  }\n\n  putMixedAudio(startUs: TimeUs, endUs: TimeUs, buffer: AudioBuffer): void {\n    this.mixedAudioL1Cache.putMixed(startUs, endUs, buffer);\n  }\n\n  getMixedAudio(startUs: TimeUs, endUs: TimeUs): AudioBuffer | null {\n    return this.mixedAudioL1Cache.getMixed(startUs, endUs);\n  }\n\n  resetAudioCache(): void {\n    this.audioL1Cache.reset();\n    this.mixedAudioL1Cache.clear();\n  }\n\n  async getFrame(timeUs: TimeUs, clipId: string): Promise<RcFrame | null> {\n    const rcFrame = this.videoL1Cache.get(timeUs, clipId);\n    if (rcFrame) {\n      return rcFrame;\n    }\n\n    const decodeKey = this.makeRequestKey(clipId, timeUs);\n    const pending = this.pendingFramePromises.get(decodeKey);\n    if (pending) {\n      const result = await pending;\n      return result.frame;\n    }\n\n    const decodePromise = this.decodeFromL2(timeUs, clipId);\n    const tracked = decodePromise.finally(() => {\n      this.pendingFramePromises.delete(decodeKey);\n    });\n\n    this.pendingFramePromises.set(\n      decodeKey,\n      tracked.then((frame) => ({ frame, source: 'wait' as const, timestampUs: timeUs, clipId }))\n    );\n    return tracked;\n  }\n\n  waitForFrame(\n    timeUs: TimeUs,\n    clipId: string,\n    options: WaitForFrameOptions = {}\n  ): Promise<WaitForFrameResult> {\n    const existing = this.videoL1Cache.get(timeUs, clipId);\n    if (existing) {\n      return Promise.resolve({ frame: existing, source: 'l1', timestampUs: timeUs, clipId });\n    }\n\n    const requestKey = this.makeRequestKey(clipId, timeUs);\n    const existingPromise = this.pendingFramePromises.get(requestKey);\n    if (existingPromise) {\n      return existingPromise;\n    }\n\n    const promise = new Promise<WaitForFrameResult>((resolve, reject) => {\n      const toleranceUs = Math.max(\n        options.toleranceUs ?? DEFAULT_WAIT_TOLERANCE_US,\n        DEFAULT_WAIT_TOLERANCE_US\n      );\n\n      const waiter: FrameWaiter = {\n        requestKey,\n        clipId,\n        targetTimeUs: timeUs,\n        resolve,\n        reject,\n        toleranceUs,\n      };\n\n      let waiters = this.frameWaiters.get(clipId);\n      if (!waiters) {\n        waiters = new Set();\n        this.frameWaiters.set(clipId, waiters);\n      }\n      waiters.add(waiter);\n\n      const signal = options.signal;\n      if (signal) {\n        const onAbort = (): void => {\n          this.removeWaiter(waiter);\n          this.cleanupWaiter(waiter);\n          reject(new DOMException('Render aborted', 'AbortError'));\n        };\n\n        if (signal.aborted) {\n          onAbort();\n          return;\n        }\n\n        signal.addEventListener('abort', onAbort, { once: true });\n        waiter.abortCleanup = () => {\n          signal.removeEventListener('abort', onAbort);\n        };\n      }\n\n      if (options.timeoutMs && options.timeoutMs > 0) {\n        waiter.timeoutId = setTimeout(() => {\n          this.removeWaiter(waiter);\n          this.cleanupWaiter(waiter);\n          reject(new Error('waitForFrame timeout'));\n        }, options.timeoutMs);\n      }\n    });\n\n    const trackedPromise = promise.finally(() => {\n      this.pendingFramePromises.delete(requestKey);\n    });\n\n    this.pendingFramePromises.set(requestKey, trackedPromise);\n    return trackedPromise;\n  }\n\n  async invalidateClip(clipId: string): Promise<void> {\n    console.log(`[CacheManager] invalidateClip(${clipId}) - clearing L1 and L2`);\n    this.videoL1Cache.invalidateRange(0, Infinity, clipId);\n    await this.l2Cache.invalidateClip(clipId);\n  }\n\n  /**\n   * Evict a clip from L1 cache\n   */\n  evictClip(clipId: string): void {\n    this.videoL1Cache.evictClip(clipId);\n  }\n\n  /**\n   * Check if a clip is cached in L1\n   */\n  isClipCached(clipId: string): boolean {\n    return this.videoL1Cache.isClipCached(clipId);\n  }\n\n  /**\n   * Wait for a clip to have minimum frames cached\n   * Used by PlaybackController for buffering state\n   */\n  waitForClipReady(\n    clipId: string,\n    options: { minFrameCount?: number; timeoutMs?: number } = {}\n  ): Promise<boolean> {\n    const minFrameCount = options.minFrameCount ?? 30;\n    const currentFrameCount = this.videoL1Cache.getClipFrameCount(clipId);\n\n    if (currentFrameCount >= minFrameCount) {\n      return Promise.resolve(true);\n    }\n\n    return new Promise<boolean>((resolve, reject) => {\n      const waiter: ClipReadyWaiter = {\n        clipId,\n        minFrameCount,\n        resolve,\n        reject,\n      };\n\n      const waiters = this.clipReadyWaiters.get(clipId) || [];\n      waiters.push(waiter);\n      this.clipReadyWaiters.set(clipId, waiters);\n\n      if (options.timeoutMs && options.timeoutMs > 0) {\n        waiter.timeoutId = setTimeout(() => {\n          const waiters = this.clipReadyWaiters.get(clipId);\n          if (waiters) {\n            const remaining = waiters.filter((w) => w !== waiter);\n            if (remaining.length === 0) {\n              this.clipReadyWaiters.delete(clipId);\n            } else {\n              this.clipReadyWaiters.set(clipId, remaining);\n            }\n          }\n          resolve(false);\n        }, options.timeoutMs);\n      }\n    });\n  }\n\n  async clear(): Promise<void> {\n    this.videoL1Cache.clear();\n    await this.l2Cache.clear();\n  }\n\n  getMetadata() {\n    return {\n      l1: this.videoL1Cache.getMetadata(),\n      l2: this.l2Cache.getMetadata(),\n    };\n  }\n\n  /**\n   * Create read stream from L2 cache for export\n   */\n  async createL2ReadStream(\n    clipId: string,\n    track: 'video' | 'audio'\n  ): Promise<ReadableStream<EncodedVideoChunk | EncodedAudioChunk> | null> {\n    return this.l2Cache.createReadStream(clipId, track);\n  }\n\n  /**\n   * Check if clip is fully cached in L2\n   * Returns true only if the clip is marked as complete\n   */\n  async hasClipInL2(clipId: string, track: 'video' | 'audio'): Promise<boolean> {\n    const result = await this.l2Cache.hasCompleteClip(clipId, track);\n    return result;\n  }\n\n  /**\n   * Mark clip as complete in L2 cache\n   */\n  async markClipComplete(clipId: string, track: 'video' | 'audio'): Promise<void> {\n    await this.l2Cache.markComplete(clipId, track);\n  }\n\n  /**\n   * Get chunk metadata (decoderConfig) from L2 cache\n   */\n  async getL2Metadata(clipId: string, track: 'video' | 'audio'): Promise<any | null> {\n    return this.l2Cache.getClipMetadata(clipId, track);\n  }\n\n  private async decodeFromL2(timeUs: TimeUs, clipId: string): Promise<RcFrame | null> {\n    const encodedChunk = await this.l2Cache.get(timeUs, clipId);\n    if (!encodedChunk) {\n      return null;\n    }\n\n    return null;\n  }\n\n  private notifyFrameWaiters(\n    clipId: string,\n    timestampUs: TimeUs,\n    frameDurationUs: TimeUs,\n    frame: RcFrame\n  ): void {\n    const waiters = this.frameWaiters.get(clipId);\n    if (!waiters || waiters.size === 0) {\n      return;\n    }\n\n    const resolved: FrameWaiter[] = [];\n\n    for (const waiter of waiters) {\n      const matches = this.matchesTimestamp(\n        waiter.targetTimeUs,\n        timestampUs,\n        frameDurationUs,\n        waiter.toleranceUs\n      );\n\n      if (!matches) continue;\n\n      resolved.push(waiter);\n      this.cleanupWaiter(waiter);\n\n      waiter.resolve({\n        frame,\n        source: 'wait',\n        timestampUs,\n        clipId,\n      });\n    }\n\n    for (const waiter of resolved) {\n      waiters.delete(waiter);\n    }\n\n    if (waiters.size === 0) {\n      this.frameWaiters.delete(clipId);\n    }\n\n    this.notifyClipReadyWaiters(clipId);\n  }\n\n  private notifyClipReadyWaiters(clipId: string): void {\n    const waiters = this.clipReadyWaiters.get(clipId);\n    if (!waiters || waiters.length === 0) {\n      return;\n    }\n\n    const frameCount = this.videoL1Cache.getClipFrameCount(clipId);\n    const resolved: ClipReadyWaiter[] = [];\n\n    for (const waiter of waiters) {\n      if (frameCount >= waiter.minFrameCount) {\n        resolved.push(waiter);\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        waiter.resolve(true);\n      }\n    }\n\n    const remaining = waiters.filter((w) => !resolved.includes(w));\n    if (remaining.length === 0) {\n      this.clipReadyWaiters.delete(clipId);\n    } else {\n      this.clipReadyWaiters.set(clipId, remaining);\n    }\n  }\n\n  private cleanupWaiter(waiter: FrameWaiter): void {\n    if (waiter.timeoutId) {\n      clearTimeout(waiter.timeoutId);\n      waiter.timeoutId = undefined;\n    }\n\n    if (waiter.abortCleanup) {\n      waiter.abortCleanup();\n      waiter.abortCleanup = undefined;\n    }\n  }\n\n  private removeWaiter(waiter: FrameWaiter): void {\n    const waiters = this.frameWaiters.get(waiter.clipId);\n    if (!waiters) return;\n\n    waiters.delete(waiter);\n    if (waiters.size === 0) {\n      this.frameWaiters.delete(waiter.clipId);\n    }\n  }\n\n  private matchesTimestamp(\n    targetTimeUs: TimeUs,\n    actualTimeUs: TimeUs,\n    frameDurationUs: TimeUs,\n    toleranceUs: TimeUs\n  ): boolean {\n    if (targetTimeUs === actualTimeUs) return true;\n\n    const delta = Math.abs(targetTimeUs - actualTimeUs);\n    if (delta <= toleranceUs) {\n      return true;\n    }\n\n    if (actualTimeUs >= targetTimeUs && actualTimeUs < targetTimeUs + frameDurationUs) {\n      return true;\n    }\n\n    return false;\n  }\n\n  private makeRequestKey(clipId: string, timeUs: TimeUs): string {\n    return `${clipId}:${timeUs}`;\n  }\n}\n"],"names":["waiters"],"mappings":"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"}

package/dist/cache/L2Cache.d.ts

@@ -13,13 +13,38 @@ export declare class L2Cache {
     constructor(config: L2Config);
     init(): Promise<void>;
     get(timeUs: TimeUs, clipId: string): Promise<EncodedVideoChunk | EncodedAudioChunk | null>;
-    put(clipId: string, chunks: Array<EncodedVideoChunk | EncodedAudioChunk>, track: 'video' | 'audio'): Promise<void>;
+    put(clipId: string, chunks: Array<EncodedVideoChunk | EncodedAudioChunk>, track: 'video' | 'audio', options?: {
+        isComplete?: boolean;
+        expectedDurationUs?: number;
+        metadata?: any;
+    }): Promise<void>;
     invalidateRange(startUs: TimeUs, endUs: TimeUs, clipId?: string): Promise<void>;
+    /**
+     * Check if clip has cached data in L2
+     */
+    hasClip(clipId: string, track: 'video' | 'audio'): Promise<boolean>;
+    /**
+     * Check if clip has complete cached data in L2
+     */
+    hasCompleteClip(clipId: string, track: 'video' | 'audio'): Promise<boolean>;
+    /**
+     * Mark clip as complete in L2 cache
+     */
+    markComplete(clipId: string, track: 'video' | 'audio'): Promise<void>;
     invalidateClip(clipId: string): Promise<void>;
+    /**
+     * Create a readable stream of encoded chunks for export
+     * Reads chunks in timestamp order from OPFS
+     */
+    createReadStream(clipId: string, track: 'video' | 'audio'): Promise<ReadableStream<EncodedVideoChunk | EncodedAudioChunk> | null>;
     clear(): Promise<void>;
     private initStorage;
     private readFromOPFS;
-    private writeToOPFS;
+    /**
+     * Append chunks to OPFS file (or create new file)
+     * Supports incremental writing for streaming scenarios
+     */
+    private appendToOPFS;
     private chunkToArrayBuffer;
     private createChunk;
     private updateLastAccess;
@@ -34,6 +59,10 @@ export declare class L2Cache {
         hitRate: number;
     };
     hasAvailableQuota(sizeMB: number): Promise<boolean>;
+    /**
+     * Get chunk metadata (decoderConfig) for a specific clip
+     */
+    getClipMetadata(clipId: string, track: 'video' | 'audio'): Promise<any | null>;
 }
 export {};
 //# sourceMappingURL=L2Cache.d.ts.map

package/dist/cache/L2Cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"L2Cache.d.ts","sourceRoot":"","sources":["../../src/cache/L2Cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAoB7C,UAAU,QAAQ;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,QAAQ;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,iBAAiB,GAAG,IAAI,CAAC;IA+B1F,GAAG,CACP,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,KAAK,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,EACpD,KAAK,EAAE,OAAO,GAAG,OAAO,GACvB,OAAO,CAAC,IAAI,CAAC;IAgCV,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C/E,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBd,WAAW;YA8BX,YAAY;YAYZ,WAAW;YAiCX,kBAAkB;IAQhC,OAAO,CAAC,WAAW;YAoBL,gBAAgB;YAahB,WAAW;YAoBX,YAAY;YAkCZ,cAAc;IAsB5B,OAAO,CAAC,gBAAgB;IAOxB,WAAW,IAAI;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB;IAWK,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAU1D"}
+{"version":3,"file":"L2Cache.d.ts","sourceRoot":"","sources":["../../src/cache/L2Cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAoC7C,UAAU,QAAQ;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,QAAQ;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,iBAAiB,GAAG,IAAI,CAAC;IA+B1F,GAAG,CACP,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,KAAK,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,EACpD,KAAK,EAAE,OAAO,GAAG,OAAO,EACxB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,GACA,OAAO,CAAC,IAAI,CAAC;IA0FV,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CrF;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAYzE;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBjF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnD;;;OAGG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GAAG,OAAO,GACvB,OAAO,CAAC,cAAc,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAqDlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkCd,WAAW;YA8BX,YAAY;IAY1B;;;OAGG;YACW,YAAY;YA4CZ,kBAAkB;IAQhC,OAAO,CAAC,WAAW;YAwBL,gBAAgB;YAahB,WAAW;YAgCX,YAAY;YA0CZ,cAAc;IAsB5B,OAAO,CAAC,gBAAgB;IAOxB,WAAW,IAAI;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB;IAWK,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzD;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;CAWrF"}

package/dist/cache/L2Cache.js

@@ -31,27 +31,77 @@ class L2Cache {
       const chunkData = await this.readFromOPFS(record.fileName, batch);
       if (!chunkData) continue;
       this.updateLastAccess(record.clipId, record.track);
-      return this.createChunk(chunkData, timeUs, record.track);
+      return this.createChunk(chunkData, timeUs, record.track, batch.type, batch.durationUs);
     }
     return null;
   }
-  async put(clipId, chunks, track) {
+  async put(clipId, chunks, track, options) {
     await this.init();
-    if (!this.db || !this.opfsRoot) return;
+    if (!this.db || !this.opfsRoot) {
+      console.warn(`[L2Cache] put aborted: db=${!!this.db}, opfsRoot=${!!this.opfsRoot}`);
+      return;
+    }
+    if (chunks.length === 0) return;
     const fileName = `clip-${clipId}-${track[0]}1.${track === "video" ? "webm" : "m4a"}`;
-    const batches = await this.writeToOPFS(fileName, chunks);
-    const totalBytes = batches.reduce((sum, b) => sum + b.byteLength, 0);
-    const tx = this.db.transaction("chunks", "readwrite");
-    const store = tx.objectStore("chunks");
-    const record = {
-      clipId,
-      track,
-      fileName,
-      batches,
-      lastAccess: Date.now(),
-      totalBytes
-    };
-    await this.promisifyRequest(store.put(record));
+    let existingRecord;
+    {
+      const tx = this.db.transaction("chunks", "readonly");
+      const store = tx.objectStore("chunks");
+      existingRecord = await this.promisifyRequest(store.get([clipId, track]));
+    }
+    if (existingRecord) {
+      const projectDir = await this.opfsRoot.getDirectoryHandle(
+        `meframe-project-${this.projectId}`,
+        {
+          create: true
+        }
+      );
+      try {
+        await projectDir.getFileHandle(existingRecord.fileName, { create: false });
+      } catch (error) {
+        if (error?.name === "NotFoundError") {
+          await this.deleteEntry(clipId, track);
+          existingRecord = void 0;
+        }
+      }
+    }
+    let chunksToWrite = chunks;
+    if (existingRecord && existingRecord.batches.length > 0) {
+      const lastBatch = existingRecord.batches[existingRecord.batches.length - 1];
+      if (lastBatch) {
+        const lastTimestamp = lastBatch.startUs;
+        chunksToWrite = chunks.filter((chunk) => chunk.timestamp > lastTimestamp);
+        if (chunksToWrite.length === 0) {
+          return;
+        }
+      }
+    }
+    const newBatches = await this.appendToOPFS(fileName, chunksToWrite, existingRecord?.batches);
+    {
+      const tx = this.db.transaction("chunks", "readwrite");
+      const store = tx.objectStore("chunks");
+      const record = {
+        clipId,
+        track,
+        fileName,
+        batches: existingRecord?.batches ? [...existingRecord.batches, ...newBatches] : newBatches,
+        lastAccess: Date.now(),
+        totalBytes: (existingRecord?.totalBytes || 0) + newBatches.reduce((sum, b) => sum + b.byteLength, 0),
+        isComplete: options?.isComplete ?? existingRecord?.isComplete ?? false,
+        expectedDurationUs: options?.expectedDurationUs ?? existingRecord?.expectedDurationUs,
+        metadata: options?.metadata ?? existingRecord?.metadata
+      };
+      store.put(record);
+      await new Promise((resolve, reject) => {
+        tx.oncomplete = () => {
+          resolve();
+        };
+        tx.onerror = () => {
+          console.error(`[L2Cache] Transaction error for ${clipId} ${track}:`, tx.error);
+          reject(tx.error);
+        };
+      });
+    }
     await this.enforceQuota();
   }
   async invalidateRange(startUs, endUs, clipId) {
@@ -87,26 +137,137 @@ class L2Cache {
       await this.deleteEntry(key[0], key[1]);
     }
   }
-  async invalidateClip(clipId) {
+  /**
+   * Check if clip has cached data in L2
+   */
+  async hasClip(clipId, track) {
+    await this.init();
+    if (!this.db) return false;
+    const tx = this.db.transaction("chunks", "readonly");
+    const store = tx.objectStore("chunks");
+    const record = await this.promisifyRequest(store.get([clipId, track]));
+    return record !== void 0 && record.batches && record.batches.length > 0;
+  }
+  /**
+   * Check if clip has complete cached data in L2
+   */
+  async hasCompleteClip(clipId, track) {
+    await this.init();
+    if (!this.db) {
+      console.warn(`[L2Cache] hasCompleteClip: db not initialized`);
+      return false;
+    }
+    const tx = this.db.transaction("chunks", "readonly");
+    const store = tx.objectStore("chunks");
+    const record = await this.promisifyRequest(store.get([clipId, track]));
+    const result = record?.isComplete === true;
+    return result;
+  }
+  /**
+   * Mark clip as complete in L2 cache
+   */
+  async markComplete(clipId, track) {
     await this.init();
     if (!this.db) return;
     const tx = this.db.transaction("chunks", "readwrite");
     const store = tx.objectStore("chunks");
-    const records = await this.collectRecords(store, clipId);
-    for (const record of records) {
+    const record = await this.promisifyRequest(store.get([clipId, track]));
+    if (record) {
+      record.isComplete = true;
+      record.lastAccess = Date.now();
+      store.put(record);
+      await new Promise((resolve, reject) => {
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => reject(tx.error);
+      });
+      console.log(`[L2Cache] markComplete(${clipId}, ${track}): marked successfully`);
+    } else {
+      console.warn(`[L2Cache] markComplete(${clipId}, ${track}): no record found, cannot mark`);
+    }
+  }
+  async invalidateClip(clipId) {
+    await this.init();
+    if (!this.db) return;
+    const recordsToDelete = [];
+    {
+      const tx = this.db.transaction("chunks", "readonly");
+      const store = tx.objectStore("chunks");
+      recordsToDelete.push(...await this.collectRecords(store, clipId));
+    }
+    for (const record of recordsToDelete) {
       await this.deleteEntry(record.clipId, record.track);
     }
   }
-  async clear() {
+  /**
+   * Create a readable stream of encoded chunks for export
+   * Reads chunks in timestamp order from OPFS
+   */
+  async createReadStream(clipId, track) {
     await this.init();
-    if (!this.db || !this.opfsRoot) return;
-    const tx = this.db.transaction(["chunks", "meta"], "readwrite");
-    await this.promisifyRequest(tx.objectStore("chunks").clear());
-    await this.promisifyRequest(tx.objectStore("meta").clear());
-    const projectDir = await this.opfsRoot.getDirectoryHandle(`meframe-project-${this.projectId}`, {
-      create: false
+    if (!this.db || !this.opfsRoot) return null;
+    const tx = this.db.transaction("chunks", "readonly");
+    const store = tx.objectStore("chunks");
+    const record = await this.promisifyRequest(store.get([clipId, track]));
+    if (!record || record.batches.length === 0) {
+      return null;
+    }
+    const batches = [...record.batches];
+    let batchIndex = 0;
+    return new ReadableStream({
+      pull: async (controller) => {
+        if (batchIndex >= batches.length) {
+          controller.close();
+          return;
+        }
+        const batch = batches[batchIndex];
+        if (!batch) {
+          controller.close();
+          return;
+        }
+        const chunkData = await this.readFromOPFS(record.fileName, batch);
+        if (!chunkData) {
+          controller.error(new Error(`Failed to read chunk at index ${batchIndex}`));
+          return;
+        }
+        const chunk = this.createChunk(
+          chunkData,
+          batch.startUs,
+          track,
+          batch.type,
+          batch.durationUs
+        );
+        controller.enqueue(chunk);
+        batchIndex++;
+      }
     });
-    await this.opfsRoot.removeEntry(projectDir.name, { recursive: true });
+  }
+  async clear() {
+    await this.init();
+    if (!this.db || !this.opfsRoot) {
+      console.warn("[L2Cache] clear() called but db or opfsRoot not available");
+      return;
+    }
+    try {
+      const tx = this.db.transaction(["chunks", "meta"], "readwrite");
+      await this.promisifyRequest(tx.objectStore("chunks").clear());
+      await this.promisifyRequest(tx.objectStore("meta").clear());
+    } catch (error) {
+      console.error("[L2Cache] Failed to clear IndexedDB:", error);
+      throw error;
+    }
+    try {
+      const projectDir = await this.opfsRoot.getDirectoryHandle(
+        `meframe-project-${this.projectId}`,
+        {
+          create: false
+        }
+      );
+      await this.opfsRoot.removeEntry(projectDir.name, { recursive: true });
+    } catch (error) {
+      if (error?.name !== "NotFoundError") {
+        console.warn("[L2Cache] Failed to clear OPFS:", error);
+      }
+    }
   }
   async initStorage() {
     this.opfsRoot = await navigator.storage.getDirectory();
@@ -138,15 +299,25 @@ class L2Cache {
     const slice = file.slice(batch.byteOffset, batch.byteOffset + batch.byteLength);
     return await slice.arrayBuffer();
   }
-  async writeToOPFS(fileName, chunks) {
+  /**
+   * Append chunks to OPFS file (or create new file)
+   * Supports incremental writing for streaming scenarios
+   */
+  async appendToOPFS(fileName, chunks, existingBatches) {
     if (!this.opfsRoot) return [];
     const projectDir = await this.opfsRoot.getDirectoryHandle(`meframe-project-${this.projectId}`, {
       create: true
     });
     const fileHandle = await projectDir.getFileHandle(fileName, { create: true });
-    const writable = await fileHandle.createWritable();
-    const batches = [];
     let offset = 0;
+    if (existingBatches && existingBatches.length > 0) {
+      const lastBatch = existingBatches[existingBatches.length - 1];
+      if (lastBatch) {
+        offset = lastBatch.byteOffset + lastBatch.byteLength;
+      }
+    }
+    const writable = await fileHandle.createWritable({ keepExistingData: true });
+    const batches = [];
     for (const chunk of chunks) {
       const data = await this.chunkToArrayBuffer(chunk);
       await writable.write({ type: "write", position: offset, data });
@@ -154,7 +325,8 @@ class L2Cache {
         startUs: chunk.timestamp,
         durationUs: chunk.duration || 0,
         byteOffset: offset,
-        byteLength: data.byteLength
+        byteLength: data.byteLength,
+        type: chunk.type
       });
       offset += data.byteLength;
     }
@@ -166,18 +338,19 @@ class L2Cache {
     chunk.copyTo(buffer);
     return buffer;
   }
-  createChunk(data, timeUs, track) {
+  createChunk(data, timeUs, track, chunkType = "key", durationUs = 0) {
     if (track === "video") {
       return new EncodedVideoChunk({
-        type: "key",
-        // Should be determined from metadata
+        type: chunkType,
         timestamp: timeUs,
+        duration: durationUs,
         data
       });
     } else {
       return new EncodedAudioChunk({
-        type: "key",
+        type: chunkType,
         timestamp: timeUs,
+        duration: durationUs,
         data
       });
     }
@@ -194,22 +367,39 @@ class L2Cache {
   }
   async deleteEntry(clipId, track) {
     if (!this.db) return;
-    const tx = this.db.transaction("chunks", "readwrite");
-    const store = tx.objectStore("chunks");
-    const record = await this.promisifyRequest(store.get([clipId, track]));
+    let record;
+    {
+      const tx = this.db.transaction("chunks", "readonly");
+      const store = tx.objectStore("chunks");
+      record = await this.promisifyRequest(store.get([clipId, track]));
+    }
     if (record && this.opfsRoot) {
-      const projectDir = await this.opfsRoot.getDirectoryHandle(
-        `meframe-project-${this.projectId}`,
-        { create: false }
-      );
-      await projectDir.removeEntry(record.fileName);
+      try {
+        const projectDir = await this.opfsRoot.getDirectoryHandle(
+          `meframe-project-${this.projectId}`,
+          { create: false }
+        );
+        await projectDir.removeEntry(record.fileName);
+      } catch (error) {
+        console.warn(`[L2Cache] Failed to delete OPFS file ${record.fileName}:`, error);
+      }
+    }
+    {
+      const tx = this.db.transaction("chunks", "readwrite");
+      const store = tx.objectStore("chunks");
+      await this.promisifyRequest(store.delete([clipId, track]));
     }
-    await this.promisifyRequest(store.delete([clipId, track]));
   }
   async enforceQuota() {
     const estimate = await navigator.storage.estimate();
     const usage = estimate.usage || 0;
+    console.log(
+      `[L2Cache] enforceQuota: usage=${(usage / 1024 / 1024).toFixed(2)}MB, maxSize=${(this.maxSize / 1024 / 1024).toFixed(2)}MB`
+    );
     if (usage <= this.maxSize) return;
+    console.warn(
+      `[L2Cache] Quota exceeded! Deleting oldest entries: usage=${usage}, maxSize=${this.maxSize}`
+    );
     if (!this.db) return;
     const tx = this.db.transaction("chunks", "readwrite");
     const store = tx.objectStore("chunks");
@@ -275,6 +465,17 @@ class L2Cache {
     const availableMB = ((estimate.quota || 0) - (estimate.usage || 0)) / (1024 * 1024);
     return availableMB >= sizeMB;
   }
+  /**
+   * Get chunk metadata (decoderConfig) for a specific clip
+   */
+  async getClipMetadata(clipId, track) {
+    await this.init();
+    if (!this.db) return null;
+    const tx = this.db.transaction("chunks", "readonly");
+    const store = tx.objectStore("chunks");
+    const record = await this.promisifyRequest(store.get([clipId, track]));
+    return record?.metadata || null;
+  }
 }
 export {
   L2Cache