@meframe/core 0.0.31 → 0.0.33

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 { VideoL1Cache } from './l1/VideoL1Cache';\nimport { MeframeEvent } from '../event/events';\nimport type { EventBus } from '../event/EventBus';\nimport type { EventPayloadMap } from '../event/events';\nimport { AudioL1Cache } from './l1/AudioL1Cache';\nimport { WaiterReplacedError } from '../utils/errors';\nimport { OPFSManager } from './storage/opfs/OPFSManager';\nimport { ResourceCache } from './resource/ResourceCache';\nimport { MP4IndexCache } from './resource/MP4IndexCache';\nimport { AudioSampleCache } from './resource/AudioSampleCache';\nimport { ImageBitmapCache } from './resource/ImageBitmapCache';\nimport type { MP4Index } from '../stages/demux/types';\n\ninterface CacheManagerConfig {\n  l1: {\n    maxMemoryMB: number;\n    maxGOPs?: number;\n    gopIntervalUs?: number;\n  };\n  resource: {\n    projectId: string;\n  };\n}\n\ninterface ClipReadyWaiter {\n  clipId: string;\n  minFrameCount: number;\n  startTimeUs: TimeUs;\n  currentCount: number;\n  resolve: (ready: boolean) => void;\n  reject: (reason?: unknown) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n}\n\n/**\n * CacheManager for Window Cache Architecture\n *\n * Core features:\n * - L1 (VRAM) for composed VideoFrames (window cache ±3s)\n * - ResourceCache (OPFS) for original MP4 files\n * - MP4IndexCache (RAM) for GOP/Sample indexes\n * - AudioSampleCache (RAM) for extracted audio chunks\n * - ImageBitmapCache (RAM) for decoded images\n */\nexport class CacheManager {\n  readonly videoL1Cache: VideoL1Cache;\n  private readonly audioL1Cache: AudioL1Cache;\n  readonly resourceCache: ResourceCache;\n  readonly mp4IndexCache: MP4IndexCache;\n  readonly audioSampleCache: AudioSampleCache;\n  readonly imageBitmapCache: ImageBitmapCache;\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.audioL1Cache = new AudioL1Cache();\n\n    // Initialize resource cache\n    const opfsManager = new OPFSManager();\n    this.resourceCache = new ResourceCache(opfsManager, config.resource.projectId);\n    this.mp4IndexCache = new MP4IndexCache();\n    this.audioSampleCache = new AudioSampleCache();\n    this.imageBitmapCache = new ImageBitmapCache(100); // 100MB default\n\n    this.eventBus = eventBus;\n  }\n\n  async init(): Promise<void> {\n    await this.resourceCache.init();\n  }\n\n  /**\n   * Set window center for L1 cache management\n   * L1 cache uses center ±3s window (defined in VideoL1Cache)\n   */\n  setWindow(centerTimeUs: TimeUs): void {\n    this.videoL1Cache.setWindow(centerTimeUs);\n  }\n\n  /**\n   * Check if resource exists in OPFS cache\n   */\n  async hasResourceInCache(resourceId: string): Promise<boolean> {\n    return await this.resourceCache.hasResource(resourceId);\n  }\n\n  /**\n   * Get MP4 index for a resource\n   */\n  getMP4Index(resourceId: string): MP4Index | null {\n    return this.mp4IndexCache.get(resourceId);\n  }\n\n  // async receiveComposedFrames(\n  //   stream: ReadableStream<VideoFrame>,\n  //   params: {\n  //     clipId: string;\n  //     trackId: string;\n  //     fps: number;\n  //     clipStartUs?: TimeUs;\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;\n  //       const timestamp = frame.timestamp ?? 0;\n\n  //       const rcFrame = this.videoL1Cache.addFrame(\n  //         frame,\n  //         params.clipId,\n  //         frameDuration,\n  //         params.trackId\n  //       );\n\n  //       // Calculate global time for event emission\n  //       const globalTimeUs = (params.clipStartUs ?? 0) + timestamp;\n\n  //       this.checkAndNotifyClipReady(params.clipId, timestamp);\n  //       // Emit cover event only for the first frame of the composition (global time = 0)\n  //       if (globalTimeUs === 0) {\n  //         this.eventBus?.emit(MeframeEvent.CacheCover, {\n  //           timeUs: globalTimeUs,\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: globalTimeUs,\n  //         frameNumber: Math.floor(globalTimeUs / 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  //     console.error('[CacheManager] receiveComposedFrames error: ', 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  //   }\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(clipId: string, audioData: AudioData, clipDurationUs: TimeUs): void {\n    this.audioL1Cache.putClipAudioData(clipId, audioData, clipDurationUs);\n  }\n\n  getClipPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): Float32Array[] | null {\n    return this.audioL1Cache.getPCM(clipId, startUs, endUs);\n  }\n\n  getClipPCMWithMetadata(\n    clipId: string,\n    startUs: TimeUs,\n    endUs: TimeUs\n  ): { planes: Float32Array[]; sampleRate: number; numberOfChannels: number } | null {\n    return this.audioL1Cache.getPCMWithMetadata(clipId, startUs, endUs);\n  }\n\n  hasClipPCM(clipId: string): boolean {\n    return this.audioL1Cache.hasClipPCM(clipId);\n  }\n\n  resetAudioCache(): void {\n    this.audioL1Cache.clear();\n  }\n\n  clearClipAudioData(clipId: string): void {\n    this.audioL1Cache.clearClipPCM(clipId);\n  }\n\n  /**\n   * Add a frame to L1 cache\n   * Handles event notifications (CacheCover, ComposeFrameReady)\n   * @param frame - VideoFrame to add\n   * @param clipId - Clip identifier\n   * @param frameDuration - Frame duration in microseconds\n   * @param trackId - Track identifier\n   * @param globalTimeUs - Global timestamp for event emission and window management\n   */\n  addFrame(\n    frame: VideoFrame,\n    clipId: string,\n    frameDuration: TimeUs,\n    trackId: string,\n    globalTimeUs: TimeUs\n  ): RcFrame {\n    const rcFrame = this.videoL1Cache.addFrame(frame, clipId, frameDuration, trackId, globalTimeUs);\n\n    const relativeTimeUs = frame.timestamp ?? 0;\n\n    // Check and notify clip ready\n    this.checkAndNotifyClipReady(clipId, relativeTimeUs);\n\n    // Emit cover event for first frame (globalTimeUs = 0 in composition)\n    if (globalTimeUs === 0) {\n      this.eventBus?.emit(MeframeEvent.CacheCover, {\n        timeUs: globalTimeUs,\n        clipId,\n        level: 'L1',\n        size: rcFrame.sizeEstimate ?? 0,\n      });\n    }\n\n    // Emit frame ready event\n    this.eventBus?.emit(MeframeEvent.ComposeFrameReady, {\n      timeUs: globalTimeUs,\n      frameNumber: Math.floor(globalTimeUs / frameDuration),\n      renderTimeMs: 0,\n      trackId,\n      clipId,\n    });\n\n    return rcFrame;\n  }\n\n  /**\n   * Get frame from L1 cache\n   * @param timeUs - Clip-relative timestamp (0-based)\n   * @param clipId - Clip identifier\n   */\n  getFrame(timeUs: TimeUs, clipId: string): RcFrame | null {\n    return this.videoL1Cache.get(timeUs, clipId);\n  }\n\n  /**\n   * Wait for frame to be available in cache\n   * @param timeUs - Clip-relative timestamp (0-based)\n   * @param clipId - Clip identifier\n   * @param options - Wait options (timeout, tolerance, etc.)\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    this.videoL1Cache.invalidateClip(clipId);\n  }\n\n  /**\n   * Evict a clip from L1 cache\n   */\n  invalidateClipInL1(clipId: string): void {\n    this.videoL1Cache.invalidateClip(clipId);\n  }\n\n  /**\n   * Check if a clip is cached in L1\n   */\n  hasClipInL1(clipId: string): boolean {\n    return this.videoL1Cache.hasClip(clipId);\n  }\n\n  /**\n   * Wait for a clip to have minimum frames cached\n   * Used by PlaybackController for buffering state\n   * Only one waiter per clip - new waiter replaces old one\n   */\n  waitForClipReady(\n    clipId: string,\n    options: { minFrameCount?: number; timeoutMs?: number; startTimeUs?: TimeUs } = {}\n  ): Promise<boolean> {\n    const minFrameCount = options.minFrameCount ?? 30;\n    const startTimeUs = options.startTimeUs ?? 0;\n\n    // Check if already have enough frames\n    const currentFrameCount = this.videoL1Cache.getClipFrameCount(clipId, startTimeUs);\n    if (currentFrameCount >= minFrameCount) {\n      return Promise.resolve(true);\n    }\n\n    // Cancel previous waiter if exists\n    const oldWaiter = this.clipReadyWaiters.get(clipId);\n    if (oldWaiter) {\n      if (oldWaiter.timeoutId) {\n        clearTimeout(oldWaiter.timeoutId);\n      }\n      oldWaiter.reject(new WaiterReplacedError(clipId));\n    }\n\n    return new Promise<boolean>((resolve, reject) => {\n      const waiter: ClipReadyWaiter = {\n        clipId,\n        minFrameCount,\n        startTimeUs,\n        currentCount: currentFrameCount,\n        resolve,\n        reject,\n      };\n\n      this.clipReadyWaiters.set(clipId, waiter);\n\n      if (options.timeoutMs && options.timeoutMs > 0) {\n        waiter.timeoutId = setTimeout(() => {\n          if (this.clipReadyWaiters.get(clipId) === waiter) {\n            this.clipReadyWaiters.delete(clipId);\n          }\n          resolve(false);\n        }, options.timeoutMs);\n      }\n    });\n  }\n\n  clearL1Cache(): void {\n    this.videoL1Cache.clear();\n    // this.audioL1Cache.clear();\n  }\n\n  async clear(): Promise<void> {\n    this.clearL1Cache();\n  }\n\n  getMetadata() {\n    return {\n      l1: this.videoL1Cache.getMetadata(),\n    };\n  }\n\n  /**\n   * Check if incoming frame satisfies clip ready condition\n   * O(1) complexity - only checks single waiter and increments counter\n   */\n  checkAndNotifyClipReady(clipId: string, frameTimestampUs: TimeUs): void {\n    const waiter = this.clipReadyWaiters.get(clipId);\n    if (!waiter) {\n      return;\n    }\n\n    // Count all frames if startTimeUs is 0 (buffering scenario)\n    // Otherwise only count frames at or after the target start time\n    const shouldCount = waiter.startTimeUs === 0 || frameTimestampUs >= waiter.startTimeUs;\n\n    if (shouldCount) {\n      waiter.currentCount++;\n\n      if (waiter.currentCount >= waiter.minFrameCount) {\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        waiter.resolve(true);\n        this.clipReadyWaiters.delete(clipId);\n      }\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":[],"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 { MeframeEvent } from '../event/events';\nimport type { EventBus } from '../event/EventBus';\nimport type { EventPayloadMap } from '../event/events';\nimport { AudioL1Cache } from './l1/AudioL1Cache';\nimport { WaiterReplacedError } from '../utils/errors';\nimport { OPFSManager } from './storage/opfs/OPFSManager';\nimport { ResourceCache } from './resource/ResourceCache';\nimport { MP4IndexCache } from './resource/MP4IndexCache';\nimport { AudioSampleCache } from './resource/AudioSampleCache';\nimport type { MP4Index } from '../stages/demux/types';\n\ninterface CacheManagerConfig {\n  l1: {\n    maxMemoryMB: number;\n    maxGOPs?: number;\n    gopIntervalUs?: number;\n  };\n  resource: {\n    projectId: string;\n  };\n}\n\ninterface ClipReadyWaiter {\n  clipId: string;\n  minFrameCount: number;\n  startTimeUs: TimeUs;\n  currentCount: number;\n  resolve: (ready: boolean) => void;\n  reject: (reason?: unknown) => void;\n  timeoutId?: ReturnType<typeof setTimeout>;\n}\n\n/**\n * CacheManager for Window Cache Architecture\n *\n * Core features:\n * - L1 (VRAM) for composed VideoFrames (window cache ±3s)\n * - ResourceCache (OPFS) for original MP4 files\n * - MP4IndexCache (RAM) for GOP/Sample indexes\n * - AudioSampleCache (RAM) for extracted audio chunks\n */\nexport class CacheManager {\n  readonly videoL1Cache: VideoL1Cache;\n  private readonly audioL1Cache: AudioL1Cache;\n  readonly resourceCache: ResourceCache;\n  readonly mp4IndexCache: MP4IndexCache;\n  readonly audioSampleCache: AudioSampleCache;\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.audioL1Cache = new AudioL1Cache();\n\n    // Initialize resource cache\n    const opfsManager = new OPFSManager();\n    this.resourceCache = new ResourceCache(opfsManager, config.resource.projectId);\n    this.mp4IndexCache = new MP4IndexCache();\n    this.audioSampleCache = new AudioSampleCache();\n    this.eventBus = eventBus;\n  }\n\n  async init(): Promise<void> {\n    await this.resourceCache.init();\n  }\n\n  /**\n   * Set window center for L1 cache management (unified for video and audio)\n   * L1 cache uses center ±3.5s window for video, ±5s for audio\n   */\n  setWindow(centerTimeUs: TimeUs): void {\n    this.videoL1Cache.setWindow(centerTimeUs);\n    this.audioL1Cache.setWindow(centerTimeUs);\n  }\n\n  /**\n   * Check if resource exists in OPFS cache\n   */\n  async hasResourceInCache(resourceId: string): Promise<boolean> {\n    return await this.resourceCache.hasResource(resourceId);\n  }\n\n  /**\n   * Read byte range from resource (for GOP-level access)\n   */\n  async readResourceRange(resourceId: string, start: number, end: number): Promise<ArrayBuffer> {\n    return await this.resourceCache.readRange(resourceId, start, end);\n  }\n\n  /**\n   * Get MP4 index for a resource\n   */\n  getMP4Index(resourceId: string): MP4Index | null {\n    return this.mp4IndexCache.get(resourceId);\n  }\n\n  putClipAudioData(\n    clipId: string,\n    audioData: AudioData,\n    clipDurationUs: TimeUs,\n    globalTimeUs?: TimeUs\n  ): void {\n    this.audioL1Cache.putClipAudioData(clipId, audioData, clipDurationUs, globalTimeUs);\n  }\n\n  getClipPCMWithMetadata(\n    clipId: string,\n    startUs: TimeUs,\n    endUs: TimeUs\n  ): { planes: Float32Array[]; sampleRate: number; numberOfChannels: number } | null {\n    return this.audioL1Cache.getPCMWithMetadata(clipId, startUs, endUs);\n  }\n\n  hasClipPCM(clipId: string): boolean {\n    return this.audioL1Cache.hasClipPCM(clipId);\n  }\n\n  /**\n   * Check if sufficient PCM data exists for the requested time window\n   * Returns true only if at least 80% of requested duration is available\n   */\n  hasWindowPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): boolean {\n    return this.audioL1Cache.hasWindowData(clipId, startUs, endUs);\n  }\n\n  resetAudioCache(): void {\n    this.audioL1Cache.clear();\n  }\n\n  clearClipAudioData(clipId: string): void {\n    this.audioL1Cache.clearClipPCM(clipId);\n  }\n\n  /**\n   * Add a frame to L1 cache\n   * Handles event notifications (CacheCover, ComposeFrameReady)\n   * @param frame - VideoFrame to add\n   * @param clipId - Clip identifier\n   * @param frameDuration - Frame duration in microseconds\n   * @param trackId - Track identifier\n   * @param globalTimeUs - Global timestamp for event emission and window management\n   */\n  addFrame(\n    frame: VideoFrame,\n    clipId: string,\n    frameDuration: TimeUs,\n    trackId: string,\n    globalTimeUs: TimeUs\n  ): RcFrame {\n    const rcFrame = this.videoL1Cache.addFrame(frame, clipId, frameDuration, trackId, globalTimeUs);\n\n    const relativeTimeUs = frame.timestamp ?? 0;\n\n    // Check and notify clip ready\n    this.checkAndNotifyClipReady(clipId, relativeTimeUs);\n\n    // Emit cover event for first frame (globalTimeUs = 0 in composition)\n    if (globalTimeUs === 0) {\n      this.eventBus?.emit(MeframeEvent.CacheCover, {\n        timeUs: globalTimeUs,\n        clipId,\n        level: 'L1',\n        size: rcFrame.sizeEstimate ?? 0,\n      });\n    }\n\n    // Emit frame ready event\n    this.eventBus?.emit(MeframeEvent.ComposeFrameReady, {\n      timeUs: globalTimeUs,\n      frameNumber: Math.floor(globalTimeUs / frameDuration),\n      renderTimeMs: 0,\n      trackId,\n      clipId,\n    });\n\n    return rcFrame;\n  }\n\n  /**\n   * Get frame from L1 cache\n   * @param timeUs - Clip-relative timestamp (0-based)\n   * @param clipId - Clip identifier\n   */\n  getFrame(timeUs: TimeUs, clipId: string): RcFrame | null {\n    return this.videoL1Cache.get(timeUs, clipId);\n  }\n\n  async invalidateClip(clipId: string): Promise<void> {\n    this.videoL1Cache.invalidateClip(clipId);\n  }\n\n  /**\n   * Evict a clip from L1 cache\n   */\n  invalidateClipInL1(clipId: string): void {\n    this.videoL1Cache.invalidateClip(clipId);\n  }\n\n  /**\n   * Check if a clip is cached in L1\n   */\n  hasClipInL1(clipId: string): boolean {\n    return this.videoL1Cache.hasClip(clipId);\n  }\n\n  /**\n   * Wait for a clip to have minimum frames cached\n   * Used by PlaybackController for buffering state\n   * Only one waiter per clip - new waiter replaces old one\n   */\n  waitForClipReady(\n    clipId: string,\n    options: { minFrameCount?: number; timeoutMs?: number; startTimeUs?: TimeUs } = {}\n  ): Promise<boolean> {\n    const minFrameCount = options.minFrameCount ?? 30;\n    const startTimeUs = options.startTimeUs ?? 0;\n\n    // Check if already have enough frames\n    const currentFrameCount = this.videoL1Cache.getClipFrameCount(clipId, startTimeUs);\n    if (currentFrameCount >= minFrameCount) {\n      return Promise.resolve(true);\n    }\n\n    // Cancel previous waiter if exists\n    const oldWaiter = this.clipReadyWaiters.get(clipId);\n    if (oldWaiter) {\n      if (oldWaiter.timeoutId) {\n        clearTimeout(oldWaiter.timeoutId);\n      }\n      oldWaiter.reject(new WaiterReplacedError(clipId));\n    }\n\n    return new Promise<boolean>((resolve, reject) => {\n      const waiter: ClipReadyWaiter = {\n        clipId,\n        minFrameCount,\n        startTimeUs,\n        currentCount: currentFrameCount,\n        resolve,\n        reject,\n      };\n\n      this.clipReadyWaiters.set(clipId, waiter);\n\n      if (options.timeoutMs && options.timeoutMs > 0) {\n        waiter.timeoutId = setTimeout(() => {\n          if (this.clipReadyWaiters.get(clipId) === waiter) {\n            this.clipReadyWaiters.delete(clipId);\n          }\n          resolve(false);\n        }, options.timeoutMs);\n      }\n    });\n  }\n\n  clearL1Cache(): void {\n    this.videoL1Cache.clear();\n  }\n\n  async clear(): Promise<void> {\n    this.clearL1Cache();\n  }\n\n  getMetadata() {\n    return {\n      l1: this.videoL1Cache.getMetadata(),\n    };\n  }\n\n  /**\n   * Check if incoming frame satisfies clip ready condition\n   * O(1) complexity - only checks single waiter and increments counter\n   */\n  checkAndNotifyClipReady(clipId: string, frameTimestampUs: TimeUs): void {\n    const waiter = this.clipReadyWaiters.get(clipId);\n    if (!waiter) {\n      return;\n    }\n\n    // Count all frames if startTimeUs is 0 (buffering scenario)\n    // Otherwise only count frames at or after the target start time\n    const shouldCount = waiter.startTimeUs === 0 || frameTimestampUs >= waiter.startTimeUs;\n\n    if (shouldCount) {\n      waiter.currentCount++;\n\n      if (waiter.currentCount >= waiter.minFrameCount) {\n        if (waiter.timeoutId) {\n          clearTimeout(waiter.timeoutId);\n        }\n        waiter.resolve(true);\n        this.clipReadyWaiters.delete(clipId);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":";;;;;;;;AA4CO,MAAM,aAAa;AAAA,EACf;AAAA,EACQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACD,uCAAuB,IAAA;AAAA,EACvB;AAAA,EAER,YAAY,QAA4B,UAAsC;AAC5E,SAAK,eAAe,IAAI,aAAa,OAAO,EAAE;AAC9C,SAAK,eAAe,IAAI,aAAA;AAGxB,UAAM,cAAc,IAAI,YAAA;AACxB,SAAK,gBAAgB,IAAI,cAAc,aAAa,OAAO,SAAS,SAAS;AAC7E,SAAK,gBAAgB,IAAI,cAAA;AACzB,SAAK,mBAAmB,IAAI,iBAAA;AAC5B,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,MAAM,OAAsB;AAC1B,UAAM,KAAK,cAAc,KAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAU,cAA4B;AACpC,SAAK,aAAa,UAAU,YAAY;AACxC,SAAK,aAAa,UAAU,YAAY;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBAAmB,YAAsC;AAC7D,WAAO,MAAM,KAAK,cAAc,YAAY,UAAU;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,kBAAkB,YAAoB,OAAe,KAAmC;AAC5F,WAAO,MAAM,KAAK,cAAc,UAAU,YAAY,OAAO,GAAG;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,YAAqC;AAC/C,WAAO,KAAK,cAAc,IAAI,UAAU;AAAA,EAC1C;AAAA,EAEA,iBACE,QACA,WACA,gBACA,cACM;AACN,SAAK,aAAa,iBAAiB,QAAQ,WAAW,gBAAgB,YAAY;AAAA,EACpF;AAAA,EAEA,uBACE,QACA,SACA,OACiF;AACjF,WAAO,KAAK,aAAa,mBAAmB,QAAQ,SAAS,KAAK;AAAA,EACpE;AAAA,EAEA,WAAW,QAAyB;AAClC,WAAO,KAAK,aAAa,WAAW,MAAM;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,QAAgB,SAAiB,OAAwB;AACpE,WAAO,KAAK,aAAa,cAAc,QAAQ,SAAS,KAAK;AAAA,EAC/D;AAAA,EAEA,kBAAwB;AACtB,SAAK,aAAa,MAAA;AAAA,EACpB;AAAA,EAEA,mBAAmB,QAAsB;AACvC,SAAK,aAAa,aAAa,MAAM;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,SACE,OACA,QACA,eACA,SACA,cACS;AACT,UAAM,UAAU,KAAK,aAAa,SAAS,OAAO,QAAQ,eAAe,SAAS,YAAY;AAE9F,UAAM,iBAAiB,MAAM,aAAa;AAG1C,SAAK,wBAAwB,QAAQ,cAAc;AAGnD,QAAI,iBAAiB,GAAG;AACtB,WAAK,UAAU,KAAK,aAAa,YAAY;AAAA,QAC3C,QAAQ;AAAA,QACR;AAAA,QACA,OAAO;AAAA,QACP,MAAM,QAAQ,gBAAgB;AAAA,MAAA,CAC/B;AAAA,IACH;AAGA,SAAK,UAAU,KAAK,aAAa,mBAAmB;AAAA,MAClD,QAAQ;AAAA,MACR,aAAa,KAAK,MAAM,eAAe,aAAa;AAAA,MACpD,cAAc;AAAA,MACd;AAAA,MACA;AAAA,IAAA,CACD;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,SAAS,QAAgB,QAAgC;AACvD,WAAO,KAAK,aAAa,IAAI,QAAQ,MAAM;AAAA,EAC7C;AAAA,EAEA,MAAM,eAAe,QAA+B;AAClD,SAAK,aAAa,eAAe,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,QAAsB;AACvC,SAAK,aAAa,eAAe,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,QAAyB;AACnC,WAAO,KAAK,aAAa,QAAQ,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBACE,QACA,UAAgF,IAC9D;AAClB,UAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,UAAM,cAAc,QAAQ,eAAe;AAG3C,UAAM,oBAAoB,KAAK,aAAa,kBAAkB,QAAQ,WAAW;AACjF,QAAI,qBAAqB,eAAe;AACtC,aAAO,QAAQ,QAAQ,IAAI;AAAA,IAC7B;AAGA,UAAM,YAAY,KAAK,iBAAiB,IAAI,MAAM;AAClD,QAAI,WAAW;AACb,UAAI,UAAU,WAAW;AACvB,qBAAa,UAAU,SAAS;AAAA,MAClC;AACA,gBAAU,OAAO,IAAI,oBAAoB,MAAM,CAAC;AAAA,IAClD;AAEA,WAAO,IAAI,QAAiB,CAAC,SAAS,WAAW;AAC/C,YAAM,SAA0B;AAAA,QAC9B;AAAA,QACA;AAAA,QACA;AAAA,QACA,cAAc;AAAA,QACd;AAAA,QACA;AAAA,MAAA;AAGF,WAAK,iBAAiB,IAAI,QAAQ,MAAM;AAExC,UAAI,QAAQ,aAAa,QAAQ,YAAY,GAAG;AAC9C,eAAO,YAAY,WAAW,MAAM;AAClC,cAAI,KAAK,iBAAiB,IAAI,MAAM,MAAM,QAAQ;AAChD,iBAAK,iBAAiB,OAAO,MAAM;AAAA,UACrC;AACA,kBAAQ,KAAK;AAAA,QACf,GAAG,QAAQ,SAAS;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,eAAqB;AACnB,SAAK,aAAa,MAAA;AAAA,EACpB;AAAA,EAEA,MAAM,QAAuB;AAC3B,SAAK,aAAA;AAAA,EACP;AAAA,EAEA,cAAc;AACZ,WAAO;AAAA,MACL,IAAI,KAAK,aAAa,YAAA;AAAA,IAAY;AAAA,EAEtC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,wBAAwB,QAAgB,kBAAgC;AACtE,UAAM,SAAS,KAAK,iBAAiB,IAAI,MAAM;AAC/C,QAAI,CAAC,QAAQ;AACX;AAAA,IACF;AAIA,UAAM,cAAc,OAAO,gBAAgB,KAAK,oBAAoB,OAAO;AAE3E,QAAI,aAAa;AACf,aAAO;AAEP,UAAI,OAAO,gBAAgB,OAAO,eAAe;AAC/C,YAAI,OAAO,WAAW;AACpB,uBAAa,OAAO,SAAS;AAAA,QAC/B;AACA,eAAO,QAAQ,IAAI;AACnB,aAAK,iBAAiB,OAAO,MAAM;AAAA,MACrC;AAAA,IACF;AAAA,EACF;AACF;"}

package/dist/cache/l1/AudioL1Cache.d.ts

@@ -1,15 +1,22 @@
-import { AudioMetadata, AudioSlot } from './types';
 import { TimeUs } from '../../model/types';
 
+interface AudioDataSlot {
+    timestampUs: TimeUs;
+    durationUs: TimeUs;
+    planes: Float32Array[];
+    sampleRate: number;
+    numberOfChannels: number;
+    globalTimeUs?: TimeUs;
+}
+export type { AudioDataSlot };
 export declare class AudioL1Cache {
-    private slots;
-    private clipPCM;
-    private metadata;
-    private volume;
-    private muted;
-    private maxClips;
-    attachStream(stream: ReadableStream<AudioData>, metadata: AudioMetadata): void;
-    putClipAudioData(clipId: string, audioData: AudioData, clipDurationUs: TimeUs): void;
+    private audioDataByClip;
+    private windowCenter;
+    private readonly WINDOW_RADIUS;
+    private readonly EVICT_THROTTLE_MS;
+    private lastEvictTime;
+    putClipAudioData(clipId: string, audioData: AudioData, _clipDurationUs: TimeUs, globalTimeUs?: TimeUs): void;
+    getSlotsInWindow(clipId: string, startUs: TimeUs, endUs: TimeUs): AudioDataSlot[] | null;
     getPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): Float32Array[] | null;
     getPCMWithMetadata(clipId: string, startUs: TimeUs, endUs: TimeUs): {
         planes: Float32Array[];
@@ -17,19 +24,29 @@ export declare class AudioL1Cache {
         numberOfChannels: number;
     } | null;
     hasClipPCM(clipId: string): boolean;
+    /**
+     * Check if sufficient PCM data exists for the requested time window
+     * Returns true only if at least 80% of requested duration is available
+     */
+    hasWindowData(clipId: string, startUs: TimeUs, endUs: TimeUs): boolean;
     clearClipPCM(clipId: string): void;
-    private evictLRU;
-    private extractPlanesFromAudioData;
-    addAudio(audio: AudioData): void;
-    getClosest(timeUs: number): (AudioSlot & {
-        metadata: AudioMetadata;
-    }) | null;
+    /**
+     * Update window center (unified global window)
+     * Aligned with VideoL1Cache strategy: maintains a window of ±RADIUS around center
+     */
+    setWindow(centerGlobalUs: TimeUs): void;
+    private checkEviction;
+    /**
+     * Evict audio slots outside the global window (aligned with VideoL1Cache)
+     * Skip if eviction is disabled (e.g., during export)
+     */
+    private evictOutOfWindow;
+    /**
+     * Find insertion index for a new slot (aligned with VideoL1Cache)
+     */
+    private findInsertIndex;
     flush(): void;
     clear(): void;
-    setPlaybackRate(_rate: number): void;
-    setVolume(volume: number): void;
-    setMute(muted: boolean): void;
     dispose(): void;
-    private applyGain;
 }
 //# sourceMappingURL=AudioL1Cache.d.ts.map

package/dist/cache/l1/AudioL1Cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioL1Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/l1/AudioL1Cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAYhD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,QAAQ,CAA8D;IAC9E,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAM;IAEtB,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAqB9E,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IA6DpF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,IAAI;IA4C7E,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ;QAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAkBlF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,0BAA0B;IAqIlC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IA6BhC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,SAAS,GAAG;QAAE,QAAQ,EAAE,aAAa,CAAA;KAAE,CAAC,GAAG,IAAI;IAkC5E,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;IAQb,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI7B,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,SAAS;CAiBlB"}
+{"version":3,"file":"AudioL1Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/l1/AudioL1Cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,qBAAa,YAAY;IAEvB,OAAO,CAAC,eAAe,CAAsC;IAI7D,OAAO,CAAC,YAAY,CAAa;IAGjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IACzC,OAAO,CAAC,aAAa,CAAK;IAE1B,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI;IA8CP,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,IAAI;IAmBxF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,IAAI;IA4F7E,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ;QAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoBlF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAoCtE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAKvC,OAAO,CAAC,aAAa;IAQrB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;IAMb,OAAO,IAAI,IAAI;CAGhB"}