@meframe/core 0.0.1

package/dist/cache/CacheManager.js

@@ -0,0 +1,388 @@
+import { VideoL1Cache } from "./l1/VideoL1Cache.js";
+import { L2Cache } from "./L2Cache.js";
+import { MeframeEvent } from "../event/events.js";
+import { AudioL1Cache } from "./l1/AudioL1Cache.js";
+import { MixedAudioL1Cache } from "./l1/MixedAudioL1Cache.js";
+const DEFAULT_WAIT_TOLERANCE_US = 33333;
+class CacheManager {
+  videoL1Cache;
+  audioL1Cache;
+  mixedAudioL1Cache;
+  l2Cache;
+  pendingFramePromises = /* @__PURE__ */ new Map();
+  frameWaiters = /* @__PURE__ */ new Map();
+  clipReadyWaiters = /* @__PURE__ */ new Map();
+  eventBus;
+  constructor(config, eventBus) {
+    this.videoL1Cache = new VideoL1Cache(config.l1);
+    this.l2Cache = new L2Cache(config.l2);
+    this.audioL1Cache = new AudioL1Cache();
+    this.mixedAudioL1Cache = new MixedAudioL1Cache();
+    this.eventBus = eventBus;
+  }
+  async init() {
+    await this.l2Cache.init();
+  }
+  configure(_model) {
+  }
+  acceptComposedFrames(stream, params) {
+    console.log("[CacheManager] acceptComposedFrames", params.clipId);
+    const reader = stream.getReader();
+    const process = async () => {
+      const { done, value } = await reader.read();
+      if (done) {
+        reader.releaseLock();
+        return;
+      }
+      if (value) {
+        const fps = params.fps > 0 ? params.fps : 30;
+        const frameDuration = Math.round(1e6 / fps);
+        const frame = value.frame || value;
+        const metadata = value.metadata;
+        const gopSerial = metadata?.gopSerial;
+        const isKeyframe = metadata?.isKeyframe;
+        const timestamp = frame.timestamp ?? 0;
+        const rcFrame = this.videoL1Cache.addFrame(
+          frame,
+          params.clipId,
+          frameDuration,
+          gopSerial,
+          isKeyframe
+        );
+        if (!rcFrame) {
+          await process();
+          return;
+        }
+        this.notifyFrameWaiters(params.clipId, timestamp, frameDuration, rcFrame);
+        const info = { clipId: params.clipId, timeUs: timestamp };
+        this.eventBus?.emit(MeframeEvent.ComposeFrameReady, {
+          timeUs: timestamp,
+          frameNumber: Math.floor(timestamp / frameDuration),
+          renderTimeMs: 0,
+          trackId: params.trackId,
+          clipId: params.clipId
+        });
+        params.onFrame(info);
+      }
+      await process();
+    };
+    process().catch((error) => {
+      this.eventBus?.emit(MeframeEvent.ComposeFrameDropped, {
+        timeUs: 0,
+        reason: "compose_slow"
+      });
+      reader.releaseLock();
+      throw error;
+    });
+  }
+  acceptEncodedChunks(stream, clipId, track) {
+    const reader = stream.getReader();
+    const chunks = [];
+    const process = async () => {
+      const { done, value } = await reader.read();
+      if (done) {
+        if (chunks.length > 0) {
+          await this.l2Cache.put(clipId, chunks, track);
+        }
+        reader.releaseLock();
+        return;
+      }
+      if (value) {
+        chunks.push(value);
+        this.eventBus?.emit(MeframeEvent.EncodeChunkReady, {
+          timeUs: value.timestamp,
+          durationUs: value.duration ?? 0,
+          track,
+          size: value.byteLength
+        });
+      }
+      await process();
+    };
+    process().catch((error) => {
+      this.eventBus?.emit(MeframeEvent.EncodeChunkError, {
+        timeUs: 0,
+        track,
+        error
+      });
+      reader.releaseLock();
+      throw error;
+    });
+  }
+  acceptMixedAudio(stream, metadata) {
+    this.audioL1Cache.attachStream(stream, metadata);
+  }
+  putClipAudioData(clipId, audioData, clipStartUs, clipDurationUs) {
+    this.audioL1Cache.putClipAudioData(clipId, audioData, clipStartUs, clipDurationUs);
+  }
+  getClipPCM(clipId, startUs, endUs) {
+    return this.audioL1Cache.getPCM(clipId, startUs, endUs);
+  }
+  hasClipPCM(clipId) {
+    return this.audioL1Cache.hasClipPCM(clipId);
+  }
+  putMixedAudio(startUs, endUs, buffer) {
+    this.mixedAudioL1Cache.putMixed(startUs, endUs, buffer);
+  }
+  getMixedAudio(startUs, endUs) {
+    return this.mixedAudioL1Cache.getMixed(startUs, endUs);
+  }
+  resetAudioCache() {
+    this.audioL1Cache.reset();
+    this.mixedAudioL1Cache.clear();
+  }
+  async getFrame(timeUs, clipId) {
+    const rcFrame = this.videoL1Cache.get(timeUs, clipId);
+    if (rcFrame) {
+      return rcFrame;
+    }
+    const decodeKey = this.makeRequestKey(clipId, timeUs);
+    const pending = this.pendingFramePromises.get(decodeKey);
+    if (pending) {
+      const result = await pending;
+      return result.frame;
+    }
+    const decodePromise = this.decodeFromL2(timeUs, clipId);
+    const tracked = decodePromise.finally(() => {
+      this.pendingFramePromises.delete(decodeKey);
+    });
+    this.pendingFramePromises.set(
+      decodeKey,
+      tracked.then((frame) => ({ frame, source: "wait", timestampUs: timeUs, clipId }))
+    );
+    return tracked;
+  }
+  waitForFrame(timeUs, clipId, options = {}) {
+    const existing = this.videoL1Cache.get(timeUs, clipId);
+    if (existing) {
+      return Promise.resolve({ frame: existing, source: "l1", timestampUs: timeUs, clipId });
+    }
+    const requestKey = this.makeRequestKey(clipId, timeUs);
+    const existingPromise = this.pendingFramePromises.get(requestKey);
+    if (existingPromise) {
+      return existingPromise;
+    }
+    const promise = new Promise((resolve, reject) => {
+      const toleranceUs = Math.max(
+        options.toleranceUs ?? DEFAULT_WAIT_TOLERANCE_US,
+        DEFAULT_WAIT_TOLERANCE_US
+      );
+      const waiter = {
+        requestKey,
+        clipId,
+        targetTimeUs: timeUs,
+        resolve,
+        reject,
+        toleranceUs
+      };
+      let waiters = this.frameWaiters.get(clipId);
+      if (!waiters) {
+        waiters = /* @__PURE__ */ new Set();
+        this.frameWaiters.set(clipId, waiters);
+      }
+      waiters.add(waiter);
+      const signal = options.signal;
+      if (signal) {
+        const onAbort = () => {
+          this.removeWaiter(waiter);
+          this.cleanupWaiter(waiter);
+          reject(new DOMException("Render aborted", "AbortError"));
+        };
+        if (signal.aborted) {
+          onAbort();
+          return;
+        }
+        signal.addEventListener("abort", onAbort, { once: true });
+        waiter.abortCleanup = () => {
+          signal.removeEventListener("abort", onAbort);
+        };
+      }
+      if (options.timeoutMs && options.timeoutMs > 0) {
+        waiter.timeoutId = setTimeout(() => {
+          this.removeWaiter(waiter);
+          this.cleanupWaiter(waiter);
+          reject(new Error("waitForFrame timeout"));
+        }, options.timeoutMs);
+      }
+    });
+    const trackedPromise = promise.finally(() => {
+      this.pendingFramePromises.delete(requestKey);
+    });
+    this.pendingFramePromises.set(requestKey, trackedPromise);
+    return trackedPromise;
+  }
+  async putGOP(gop) {
+    if (!gop.clipId) {
+      throw new Error("GOP clipId is required for clip-aware caching");
+    }
+    this.videoL1Cache.putGOP(gop, gop.clipId);
+    this.encodeToL2(gop);
+  }
+  async putEncodedChunks(clipHash, chunks, track) {
+    await this.l2Cache.put(clipHash, chunks, track);
+  }
+  invalidateRange(startUs, endUs, clipId) {
+    this.videoL1Cache.invalidateRange(startUs, endUs, clipId);
+    this.l2Cache.invalidateRange(startUs, endUs, clipId);
+  }
+  async invalidateClip(clipId) {
+    this.videoL1Cache.invalidateRange(0, Infinity, clipId);
+    await this.l2Cache.invalidateClip(clipId);
+  }
+  /**
+   * Evict a clip from L1 cache
+   */
+  evictClip(clipId) {
+    this.videoL1Cache.evictClip(clipId);
+  }
+  /**
+   * Check if a clip is cached in L1
+   */
+  isClipCached(clipId) {
+    return this.videoL1Cache.isClipCached(clipId);
+  }
+  /**
+   * Wait for a clip to have minimum frames cached
+   * Used by PlaybackController for buffering state
+   */
+  waitForClipReady(clipId, options = {}) {
+    const minFrameCount = options.minFrameCount ?? 30;
+    const currentFrameCount = this.videoL1Cache.getClipFrameCount(clipId);
+    if (currentFrameCount >= minFrameCount) {
+      return Promise.resolve(true);
+    }
+    return new Promise((resolve, reject) => {
+      const waiter = {
+        clipId,
+        minFrameCount,
+        resolve,
+        reject
+      };
+      const waiters = this.clipReadyWaiters.get(clipId) || [];
+      waiters.push(waiter);
+      this.clipReadyWaiters.set(clipId, waiters);
+      if (options.timeoutMs && options.timeoutMs > 0) {
+        waiter.timeoutId = setTimeout(() => {
+          const waiters2 = this.clipReadyWaiters.get(clipId);
+          if (waiters2) {
+            const remaining = waiters2.filter((w) => w !== waiter);
+            if (remaining.length === 0) {
+              this.clipReadyWaiters.delete(clipId);
+            } else {
+              this.clipReadyWaiters.set(clipId, remaining);
+            }
+          }
+          resolve(false);
+        }, options.timeoutMs);
+      }
+    });
+  }
+  async clear() {
+    this.videoL1Cache.clear();
+    await this.l2Cache.clear();
+  }
+  getMetadata() {
+    return {
+      l1: this.videoL1Cache.getMetadata(),
+      l2: this.l2Cache.getMetadata()
+    };
+  }
+  async decodeFromL2(timeUs, clipId) {
+    const encodedChunk = await this.l2Cache.get(timeUs, clipId);
+    if (!encodedChunk) {
+      return null;
+    }
+    return null;
+  }
+  async encodeToL2(_gop) {
+  }
+  notifyFrameWaiters(clipId, timestampUs, frameDurationUs, frame) {
+    const waiters = this.frameWaiters.get(clipId);
+    if (!waiters || waiters.size === 0) {
+      return;
+    }
+    const resolved = [];
+    for (const waiter of waiters) {
+      const matches = this.matchesTimestamp(
+        waiter.targetTimeUs,
+        timestampUs,
+        frameDurationUs,
+        waiter.toleranceUs
+      );
+      if (!matches) continue;
+      resolved.push(waiter);
+      this.cleanupWaiter(waiter);
+      waiter.resolve({
+        frame,
+        source: "wait",
+        timestampUs,
+        clipId
+      });
+    }
+    for (const waiter of resolved) {
+      waiters.delete(waiter);
+    }
+    if (waiters.size === 0) {
+      this.frameWaiters.delete(clipId);
+    }
+    this.notifyClipReadyWaiters(clipId);
+  }
+  notifyClipReadyWaiters(clipId) {
+    const waiters = this.clipReadyWaiters.get(clipId);
+    if (!waiters || waiters.length === 0) {
+      return;
+    }
+    const frameCount = this.videoL1Cache.getClipFrameCount(clipId);
+    const resolved = [];
+    for (const waiter of waiters) {
+      if (frameCount >= waiter.minFrameCount) {
+        resolved.push(waiter);
+        if (waiter.timeoutId) {
+          clearTimeout(waiter.timeoutId);
+        }
+        waiter.resolve(true);
+      }
+    }
+    const remaining = waiters.filter((w) => !resolved.includes(w));
+    if (remaining.length === 0) {
+      this.clipReadyWaiters.delete(clipId);
+    } else {
+      this.clipReadyWaiters.set(clipId, remaining);
+    }
+  }
+  cleanupWaiter(waiter) {
+    if (waiter.timeoutId) {
+      clearTimeout(waiter.timeoutId);
+      waiter.timeoutId = void 0;
+    }
+    if (waiter.abortCleanup) {
+      waiter.abortCleanup();
+      waiter.abortCleanup = void 0;
+    }
+  }
+  removeWaiter(waiter) {
+    const waiters = this.frameWaiters.get(waiter.clipId);
+    if (!waiters) return;
+    waiters.delete(waiter);
+    if (waiters.size === 0) {
+      this.frameWaiters.delete(waiter.clipId);
+    }
+  }
+  matchesTimestamp(targetTimeUs, actualTimeUs, frameDurationUs, toleranceUs) {
+    if (targetTimeUs === actualTimeUs) return true;
+    const delta = Math.abs(targetTimeUs - actualTimeUs);
+    if (delta <= toleranceUs) {
+      return true;
+    }
+    if (actualTimeUs >= targetTimeUs && actualTimeUs < targetTimeUs + frameDurationUs) {
+      return true;
+    }
+    return false;
+  }
+  makeRequestKey(clipId, timeUs) {
+    return `${clipId}:${timeUs}`;
+  }
+}
+export {
+  CacheManager
+};
+//# sourceMappingURL=CacheManager.js.map

package/dist/cache/CacheManager.js.map

@@ -0,0 +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    console.log('[CacheManager] acceptComposedFrames', params.clipId);\n    const reader = stream.getReader();\n    const process = async (): Promise<void> => {\n      const { done, value } = await reader.read();\n      // console.log('[CacheManager] acceptComposedFrames', params.clipId, 'value: ', value?.frame?.timestamp);\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        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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"}

package/dist/cache/CacheStatsDecorator.d.ts

@@ -0,0 +1,27 @@
+import { VideoL1Cache } from './l1/VideoL1Cache';
+import { L2Cache } from './L2Cache';
+
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    hitRate: number;
+    missRate: number;
+}
+/**
+ * AOP decorator for cache statistics
+ * Can be applied through plugin system
+ */
+export declare class CacheStatsDecorator {
+    private stats;
+    decorateL1Cache(cache: VideoL1Cache): VideoL1Cache;
+    decorateL2Cache(cache: L2Cache): L2Cache;
+    getStats(): {
+        l1: CacheStats;
+        l2: CacheStats;
+        combined: CacheStats;
+    };
+    reset(): void;
+    private calculateStats;
+}
+//# sourceMappingURL=CacheStatsDecorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheStatsDecorator.d.ts","sourceRoot":"","sources":["../../src/cache/CacheStatsDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAGX;IAEF,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IAyBlD,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAgBxC,QAAQ,IAAI;QAAE,EAAE,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,UAAU,CAAA;KAAE;IAuBpE,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,cAAc;CAavB"}

package/dist/cache/L2Cache.d.ts

@@ -0,0 +1,39 @@
+import { TimeUs } from '../model/types';
+
+interface L2Config {
+    maxSizeMB: number;
+    projectId: string;
+}
+export declare class L2Cache {
+    private db;
+    private opfsRoot;
+    readonly maxSize: number;
+    readonly projectId: string;
+    private initPromise;
+    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>;
+    invalidateRange(startUs: TimeUs, endUs: TimeUs, clipId?: string): Promise<void>;
+    invalidateClip(clipId: string): Promise<void>;
+    clear(): Promise<void>;
+    private initStorage;
+    private readFromOPFS;
+    private writeToOPFS;
+    private chunkToArrayBuffer;
+    private createChunk;
+    private updateLastAccess;
+    private deleteEntry;
+    private enforceQuota;
+    private collectRecords;
+    private promisifyRequest;
+    getMetadata(): {
+        maxSizeMB: number;
+        usedSizeMB: number;
+        entries: number;
+        hitRate: number;
+    };
+    hasAvailableQuota(sizeMB: number): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=L2Cache.d.ts.map

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

@@ -0,0 +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"}