@meframe/core 0.0.29 → 0.0.30-beta

package/dist/cache/resource/ImageBitmapCache.d.ts

@@ -0,0 +1,65 @@
+export interface ImageBitmapRecord {
+    resourceId: string;
+    bitmap: ImageBitmap;
+    width: number;
+    height: number;
+    sizeBytes: number;
+}
+/**
+ * ImageBitmapCache - Resource-level image bitmap cache
+ *
+ * Caches decoded ImageBitmap for image resources in main thread
+ * Used by OnDemandComposeSession for image clip composition
+ *
+ * Strategy:
+ * - Store ImageBitmap after ResourceLoader downloads image
+ * - Keep in main thread memory for direct access
+ * - Close and evict when memory pressure is high
+ *
+ * Memory usage:
+ * - Typical image (1080p): width * height * 4 bytes = ~8MB
+ * - Cache ~10 images max to stay under ~100MB
+ */
+export declare class ImageBitmapCache {
+    private cache;
+    private maxCacheSizeMB;
+    private currentSizeBytes;
+    constructor(maxCacheSizeMB?: number);
+    /**
+     * Set image bitmap for a resource
+     */
+    set(resourceId: string, bitmap: ImageBitmap): void;
+    /**
+     * Get image bitmap for a resource
+     */
+    get(resourceId: string): ImageBitmap | null;
+    /**
+     * Get full record with metadata
+     */
+    getRecord(resourceId: string): ImageBitmapRecord | null;
+    /**
+     * Check if resource has bitmap cached
+     */
+    has(resourceId: string): boolean;
+    /**
+     * Delete bitmap for a resource
+     */
+    delete(resourceId: string): void;
+    /**
+     * Clear all cached bitmaps
+     */
+    clear(): void;
+    /**
+     * Get total memory usage in bytes
+     */
+    getTotalBytes(): number;
+    /**
+     * Get total memory usage in MB
+     */
+    getTotalMB(): number;
+    /**
+     * Evict oldest entries if over size limit
+     */
+    private evictIfNeeded;
+}
+//# sourceMappingURL=ImageBitmapCache.d.ts.map

package/dist/cache/resource/ImageBitmapCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageBitmapCache.d.ts","sourceRoot":"","sources":["../../../src/cache/resource/ImageBitmapCache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,cAAc,SAAM;IAIhC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IA0BlD;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAK3C;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAIvD;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAShC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;CAetB"}

package/dist/cache/resource/ImageBitmapCache.js

@@ -0,0 +1,101 @@
+class ImageBitmapCache {
+  cache = /* @__PURE__ */ new Map();
+  maxCacheSizeMB = 100;
+  // Default 100MB
+  currentSizeBytes = 0;
+  constructor(maxCacheSizeMB = 100) {
+    this.maxCacheSizeMB = maxCacheSizeMB;
+  }
+  /**
+   * Set image bitmap for a resource
+   */
+  set(resourceId, bitmap) {
+    const existing = this.cache.get(resourceId);
+    if (existing) {
+      existing.bitmap.close();
+      this.currentSizeBytes -= existing.sizeBytes;
+    }
+    const sizeBytes = bitmap.width * bitmap.height * 4;
+    const record = {
+      resourceId,
+      bitmap,
+      width: bitmap.width,
+      height: bitmap.height,
+      sizeBytes
+    };
+    this.cache.set(resourceId, record);
+    this.currentSizeBytes += sizeBytes;
+    this.evictIfNeeded();
+  }
+  /**
+   * Get image bitmap for a resource
+   */
+  get(resourceId) {
+    const record = this.cache.get(resourceId);
+    return record ? record.bitmap : null;
+  }
+  /**
+   * Get full record with metadata
+   */
+  getRecord(resourceId) {
+    return this.cache.get(resourceId) || null;
+  }
+  /**
+   * Check if resource has bitmap cached
+   */
+  has(resourceId) {
+    return this.cache.has(resourceId);
+  }
+  /**
+   * Delete bitmap for a resource
+   */
+  delete(resourceId) {
+    const record = this.cache.get(resourceId);
+    if (record) {
+      record.bitmap.close();
+      this.currentSizeBytes -= record.sizeBytes;
+      this.cache.delete(resourceId);
+    }
+  }
+  /**
+   * Clear all cached bitmaps
+   */
+  clear() {
+    for (const record of this.cache.values()) {
+      record.bitmap.close();
+    }
+    this.cache.clear();
+    this.currentSizeBytes = 0;
+  }
+  /**
+   * Get total memory usage in bytes
+   */
+  getTotalBytes() {
+    return this.currentSizeBytes;
+  }
+  /**
+   * Get total memory usage in MB
+   */
+  getTotalMB() {
+    return this.currentSizeBytes / (1024 * 1024);
+  }
+  /**
+   * Evict oldest entries if over size limit
+   */
+  evictIfNeeded() {
+    const maxBytes = this.maxCacheSizeMB * 1024 * 1024;
+    if (this.currentSizeBytes > maxBytes) {
+      const entries = Array.from(this.cache.entries());
+      let evictIndex = 0;
+      while (this.currentSizeBytes > maxBytes && evictIndex < entries.length) {
+        const [resourceId] = entries[evictIndex];
+        this.delete(resourceId);
+        evictIndex++;
+      }
+    }
+  }
+}
+export {
+  ImageBitmapCache
+};
+//# sourceMappingURL=ImageBitmapCache.js.map

package/dist/cache/resource/ImageBitmapCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageBitmapCache.js","sources":["../../../src/cache/resource/ImageBitmapCache.ts"],"sourcesContent":["export interface ImageBitmapRecord {\n  resourceId: string;\n  bitmap: ImageBitmap;\n  width: number;\n  height: number;\n  sizeBytes: number; // Estimated memory usage\n}\n\n/**\n * ImageBitmapCache - Resource-level image bitmap cache\n *\n * Caches decoded ImageBitmap for image resources in main thread\n * Used by OnDemandComposeSession for image clip composition\n *\n * Strategy:\n * - Store ImageBitmap after ResourceLoader downloads image\n * - Keep in main thread memory for direct access\n * - Close and evict when memory pressure is high\n *\n * Memory usage:\n * - Typical image (1080p): width * height * 4 bytes = ~8MB\n * - Cache ~10 images max to stay under ~100MB\n */\nexport class ImageBitmapCache {\n  private cache = new Map<string, ImageBitmapRecord>();\n  private maxCacheSizeMB = 100; // Default 100MB\n  private currentSizeBytes = 0;\n\n  constructor(maxCacheSizeMB = 100) {\n    this.maxCacheSizeMB = maxCacheSizeMB;\n  }\n\n  /**\n   * Set image bitmap for a resource\n   */\n  set(resourceId: string, bitmap: ImageBitmap): void {\n    // Close existing bitmap if present\n    const existing = this.cache.get(resourceId);\n    if (existing) {\n      existing.bitmap.close();\n      this.currentSizeBytes -= existing.sizeBytes;\n    }\n\n    // Estimate memory usage (RGBA format)\n    const sizeBytes = bitmap.width * bitmap.height * 4;\n\n    const record: ImageBitmapRecord = {\n      resourceId,\n      bitmap,\n      width: bitmap.width,\n      height: bitmap.height,\n      sizeBytes,\n    };\n\n    this.cache.set(resourceId, record);\n    this.currentSizeBytes += sizeBytes;\n\n    // Evict if over limit (simple FIFO for now)\n    this.evictIfNeeded();\n  }\n\n  /**\n   * Get image bitmap for a resource\n   */\n  get(resourceId: string): ImageBitmap | null {\n    const record = this.cache.get(resourceId);\n    return record ? record.bitmap : null;\n  }\n\n  /**\n   * Get full record with metadata\n   */\n  getRecord(resourceId: string): ImageBitmapRecord | null {\n    return this.cache.get(resourceId) || null;\n  }\n\n  /**\n   * Check if resource has bitmap cached\n   */\n  has(resourceId: string): boolean {\n    return this.cache.has(resourceId);\n  }\n\n  /**\n   * Delete bitmap for a resource\n   */\n  delete(resourceId: string): void {\n    const record = this.cache.get(resourceId);\n    if (record) {\n      record.bitmap.close();\n      this.currentSizeBytes -= record.sizeBytes;\n      this.cache.delete(resourceId);\n    }\n  }\n\n  /**\n   * Clear all cached bitmaps\n   */\n  clear(): void {\n    for (const record of this.cache.values()) {\n      record.bitmap.close();\n    }\n    this.cache.clear();\n    this.currentSizeBytes = 0;\n  }\n\n  /**\n   * Get total memory usage in bytes\n   */\n  getTotalBytes(): number {\n    return this.currentSizeBytes;\n  }\n\n  /**\n   * Get total memory usage in MB\n   */\n  getTotalMB(): number {\n    return this.currentSizeBytes / (1024 * 1024);\n  }\n\n  /**\n   * Evict oldest entries if over size limit\n   */\n  private evictIfNeeded(): void {\n    const maxBytes = this.maxCacheSizeMB * 1024 * 1024;\n\n    // Simple FIFO eviction: remove oldest entries until under limit\n    if (this.currentSizeBytes > maxBytes) {\n      const entries = Array.from(this.cache.entries());\n      let evictIndex = 0;\n\n      while (this.currentSizeBytes > maxBytes && evictIndex < entries.length) {\n        const [resourceId] = entries[evictIndex]!;\n        this.delete(resourceId);\n        evictIndex++;\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"AAuBO,MAAM,iBAAiB;AAAA,EACpB,4BAAY,IAAA;AAAA,EACZ,iBAAiB;AAAA;AAAA,EACjB,mBAAmB;AAAA,EAE3B,YAAY,iBAAiB,KAAK;AAChC,SAAK,iBAAiB;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAAoB,QAA2B;AAEjD,UAAM,WAAW,KAAK,MAAM,IAAI,UAAU;AAC1C,QAAI,UAAU;AACZ,eAAS,OAAO,MAAA;AAChB,WAAK,oBAAoB,SAAS;AAAA,IACpC;AAGA,UAAM,YAAY,OAAO,QAAQ,OAAO,SAAS;AAEjD,UAAM,SAA4B;AAAA,MAChC;AAAA,MACA;AAAA,MACA,OAAO,OAAO;AAAA,MACd,QAAQ,OAAO;AAAA,MACf;AAAA,IAAA;AAGF,SAAK,MAAM,IAAI,YAAY,MAAM;AACjC,SAAK,oBAAoB;AAGzB,SAAK,cAAA;AAAA,EACP;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAAwC;AAC1C,UAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,WAAO,SAAS,OAAO,SAAS;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,YAA8C;AACtD,WAAO,KAAK,MAAM,IAAI,UAAU,KAAK;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAA6B;AAC/B,WAAO,KAAK,MAAM,IAAI,UAAU;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,YAA0B;AAC/B,UAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,QAAI,QAAQ;AACV,aAAO,OAAO,MAAA;AACd,WAAK,oBAAoB,OAAO;AAChC,WAAK,MAAM,OAAO,UAAU;AAAA,IAC9B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,eAAW,UAAU,KAAK,MAAM,OAAA,GAAU;AACxC,aAAO,OAAO,MAAA;AAAA,IAChB;AACA,SAAK,MAAM,MAAA;AACX,SAAK,mBAAmB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAwB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,aAAqB;AACnB,WAAO,KAAK,oBAAoB,OAAO;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKQ,gBAAsB;AAC5B,UAAM,WAAW,KAAK,iBAAiB,OAAO;AAG9C,QAAI,KAAK,mBAAmB,UAAU;AACpC,YAAM,UAAU,MAAM,KAAK,KAAK,MAAM,SAAS;AAC/C,UAAI,aAAa;AAEjB,aAAO,KAAK,mBAAmB,YAAY,aAAa,QAAQ,QAAQ;AACtE,cAAM,CAAC,UAAU,IAAI,QAAQ,UAAU;AACvC,aAAK,OAAO,UAAU;AACtB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;"}

package/dist/cache/resource/MP4IndexCache.d.ts

@@ -0,0 +1,48 @@
+import { MP4Index, Sample, GOPRange } from '../../stages/demux/types';
+import { TimeUs } from '../../model/types';
+
+/**
+ * MP4IndexCache - In-memory cache for MP4 indexes
+ *
+ * Provides fast lookup for:
+ * - Sample at specific timestamp
+ * - GOP range for time range
+ * - Nearest keyframe
+ */
+export declare class MP4IndexCache {
+    private indexes;
+    /**
+     * Set index for a resource
+     */
+    set(resourceId: string, index: MP4Index): void;
+    /**
+     * Get index for a resource
+     */
+    get(resourceId: string): MP4Index | null;
+    /**
+     * Check if index exists for a resource
+     */
+    has(resourceId: string): boolean;
+    /**
+     * Get GOP range (byte range) for a specific time
+     * Returns the GOP that contains the target time
+     */
+    getGOPRangeForTime(resourceId: string, timeUs: TimeUs): GOPRange | null;
+    /**
+     * Get sample at specific timestamp
+     */
+    getSampleAtTime(resourceId: string, timeUs: TimeUs): Sample | null;
+    /**
+     * Get nearest keyframe before or at the target time
+     */
+    getNearestKeyframe(resourceId: string, timeUs: TimeUs): Sample | null;
+    /**
+     * Clear all cached indexes
+     */
+    clear(): void;
+    /**
+     * Remove index for a specific resource
+     */
+    remove(resourceId: string): void;
+}
+//# sourceMappingURL=MP4IndexCache.d.ts.map

package/dist/cache/resource/MP4IndexCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MP4IndexCache.d.ts","sourceRoot":"","sources":["../../../src/cache/resource/MP4IndexCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA+B;IAE9C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI9C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAIxC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IA0CvE;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAclE;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBrE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGjC"}

package/dist/cache/resource/MP4IndexCache.js

@@ -0,0 +1,104 @@
+import { binarySearchRange, binarySearchFirst } from "../../utils/binary-search.js";
+class MP4IndexCache {
+  indexes = /* @__PURE__ */ new Map();
+  /**
+   * Set index for a resource
+   */
+  set(resourceId, index) {
+    this.indexes.set(resourceId, index);
+  }
+  /**
+   * Get index for a resource
+   */
+  get(resourceId) {
+    return this.indexes.get(resourceId) || null;
+  }
+  /**
+   * Check if index exists for a resource
+   */
+  has(resourceId) {
+    return this.indexes.has(resourceId);
+  }
+  /**
+   * Get GOP range (byte range) for a specific time
+   * Returns the GOP that contains the target time
+   */
+  getGOPRangeForTime(resourceId, timeUs) {
+    const index = this.indexes.get(resourceId);
+    if (!index?.tracks.video) return null;
+    const { samples, gopIndex } = index.tracks.video;
+    const targetGOP = binarySearchRange(gopIndex, timeUs, (gop, idx) => {
+      const nextGOP = gopIndex[idx + 1];
+      return {
+        start: gop.startTimeUs,
+        end: nextGOP ? nextGOP.startTimeUs : Infinity
+      };
+    });
+    if (!targetGOP) {
+      console.warn("[MP4IndexCache] No GOP found for timeUs:", timeUs);
+      return null;
+    }
+    const startSample = samples[targetGOP.keyframeSampleIndex];
+    const endSampleIndex = targetGOP.keyframeSampleIndex + targetGOP.sampleCount - 1;
+    const endSample = samples[endSampleIndex];
+    if (!startSample || !endSample) {
+      console.error("[MP4IndexCache] Missing samples for GOP:", {
+        keyframeSampleIndex: targetGOP.keyframeSampleIndex,
+        sampleCount: targetGOP.sampleCount,
+        totalSamples: samples.length
+      });
+      return null;
+    }
+    return {
+      byteStart: startSample.byteOffset,
+      byteEnd: endSample.byteOffset + endSample.byteLength,
+      startTimeUs: startSample.timestamp,
+      endTimeUs: endSample.timestamp + endSample.duration
+    };
+  }
+  /**
+   * Get sample at specific timestamp
+   */
+  getSampleAtTime(resourceId, timeUs) {
+    const index = this.indexes.get(resourceId);
+    if (!index?.tracks.video) return null;
+    const { samples } = index.tracks.video;
+    const result = binarySearchRange(samples, timeUs, (sample, _index) => ({
+      start: sample.timestamp,
+      end: sample.timestamp + sample.duration
+    }));
+    return result || null;
+  }
+  /**
+   * Get nearest keyframe before or at the target time
+   */
+  getNearestKeyframe(resourceId, timeUs) {
+    const index = this.indexes.get(resourceId);
+    if (!index?.tracks.video) return null;
+    const { samples, gopIndex } = index.tracks.video;
+    const firstGOPAfterIndex = binarySearchFirst(gopIndex, (gop) => gop.startTimeUs > timeUs);
+    const targetGOPIndex = firstGOPAfterIndex - 1;
+    if (targetGOPIndex < 0) {
+      return null;
+    }
+    const targetGOP = gopIndex[targetGOPIndex];
+    if (!targetGOP) return null;
+    return samples[targetGOP.keyframeSampleIndex] ?? null;
+  }
+  /**
+   * Clear all cached indexes
+   */
+  clear() {
+    this.indexes.clear();
+  }
+  /**
+   * Remove index for a specific resource
+   */
+  remove(resourceId) {
+    this.indexes.delete(resourceId);
+  }
+}
+export {
+  MP4IndexCache
+};
+//# sourceMappingURL=MP4IndexCache.js.map

package/dist/cache/resource/MP4IndexCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MP4IndexCache.js","sources":["../../../src/cache/resource/MP4IndexCache.ts"],"sourcesContent":["import type { MP4Index, Sample, GOPRange } from '../../stages/demux/types';\nimport type { TimeUs } from '../../model/types';\nimport { binarySearchRange, binarySearchFirst } from '../../utils/binary-search';\n\n/**\n * MP4IndexCache - In-memory cache for MP4 indexes\n *\n * Provides fast lookup for:\n * - Sample at specific timestamp\n * - GOP range for time range\n * - Nearest keyframe\n */\nexport class MP4IndexCache {\n  private indexes = new Map<string, MP4Index>();\n\n  /**\n   * Set index for a resource\n   */\n  set(resourceId: string, index: MP4Index): void {\n    this.indexes.set(resourceId, index);\n  }\n\n  /**\n   * Get index for a resource\n   */\n  get(resourceId: string): MP4Index | null {\n    return this.indexes.get(resourceId) || null;\n  }\n\n  /**\n   * Check if index exists for a resource\n   */\n  has(resourceId: string): boolean {\n    return this.indexes.has(resourceId);\n  }\n\n  /**\n   * Get GOP range (byte range) for a specific time\n   * Returns the GOP that contains the target time\n   */\n  getGOPRangeForTime(resourceId: string, timeUs: TimeUs): GOPRange | null {\n    const index = this.indexes.get(resourceId);\n    if (!index?.tracks.video) return null;\n\n    const { samples, gopIndex } = index.tracks.video;\n\n    // Find GOP that contains this timestamp using binary search\n    const targetGOP = binarySearchRange(gopIndex, timeUs, (gop, idx) => {\n      const nextGOP = gopIndex[idx + 1];\n      return {\n        start: gop.startTimeUs,\n        end: nextGOP ? nextGOP.startTimeUs : Infinity,\n      };\n    });\n\n    if (!targetGOP) {\n      console.warn('[MP4IndexCache] No GOP found for timeUs:', timeUs);\n      return null;\n    }\n\n    // Calculate byte range for this GOP\n    const startSample = samples[targetGOP.keyframeSampleIndex];\n    const endSampleIndex = targetGOP.keyframeSampleIndex + targetGOP.sampleCount - 1;\n    const endSample = samples[endSampleIndex];\n\n    if (!startSample || !endSample) {\n      console.error('[MP4IndexCache] Missing samples for GOP:', {\n        keyframeSampleIndex: targetGOP.keyframeSampleIndex,\n        sampleCount: targetGOP.sampleCount,\n        totalSamples: samples.length,\n      });\n      return null;\n    }\n\n    return {\n      byteStart: startSample.byteOffset,\n      byteEnd: endSample.byteOffset + endSample.byteLength,\n      startTimeUs: startSample.timestamp,\n      endTimeUs: endSample.timestamp + endSample.duration,\n    };\n  }\n\n  /**\n   * Get sample at specific timestamp\n   */\n  getSampleAtTime(resourceId: string, timeUs: TimeUs): Sample | null {\n    const index = this.indexes.get(resourceId);\n    if (!index?.tracks.video) return null;\n\n    const { samples } = index.tracks.video;\n\n    const result = binarySearchRange(samples, timeUs, (sample, _index) => ({\n      start: sample.timestamp,\n      end: sample.timestamp + sample.duration,\n    }));\n\n    return result || null;\n  }\n\n  /**\n   * Get nearest keyframe before or at the target time\n   */\n  getNearestKeyframe(resourceId: string, timeUs: TimeUs): Sample | null {\n    const index = this.indexes.get(resourceId);\n    if (!index?.tracks.video) return null;\n\n    const { samples, gopIndex } = index.tracks.video;\n\n    // Find the first GOP that starts after timeUs using binary search\n    const firstGOPAfterIndex = binarySearchFirst(gopIndex, (gop) => gop.startTimeUs > timeUs);\n\n    // The nearest keyframe is in the GOP before firstGOPAfterIndex\n    const targetGOPIndex = firstGOPAfterIndex - 1;\n\n    if (targetGOPIndex < 0) {\n      // timeUs is before the first GOP\n      return null;\n    }\n\n    const targetGOP = gopIndex[targetGOPIndex];\n    if (!targetGOP) return null;\n\n    // Return the keyframe sample of this GOP\n    return samples[targetGOP.keyframeSampleIndex] ?? null;\n  }\n\n  /**\n   * Clear all cached indexes\n   */\n  clear(): void {\n    this.indexes.clear();\n  }\n\n  /**\n   * Remove index for a specific resource\n   */\n  remove(resourceId: string): void {\n    this.indexes.delete(resourceId);\n  }\n}\n"],"names":[],"mappings":";AAYO,MAAM,cAAc;AAAA,EACjB,8BAAc,IAAA;AAAA;AAAA;AAAA;AAAA,EAKtB,IAAI,YAAoB,OAAuB;AAC7C,SAAK,QAAQ,IAAI,YAAY,KAAK;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAAqC;AACvC,WAAO,KAAK,QAAQ,IAAI,UAAU,KAAK;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAA6B;AAC/B,WAAO,KAAK,QAAQ,IAAI,UAAU;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,mBAAmB,YAAoB,QAAiC;AACtE,UAAM,QAAQ,KAAK,QAAQ,IAAI,UAAU;AACzC,QAAI,CAAC,OAAO,OAAO,MAAO,QAAO;AAEjC,UAAM,EAAE,SAAS,SAAA,IAAa,MAAM,OAAO;AAG3C,UAAM,YAAY,kBAAkB,UAAU,QAAQ,CAAC,KAAK,QAAQ;AAClE,YAAM,UAAU,SAAS,MAAM,CAAC;AAChC,aAAO;AAAA,QACL,OAAO,IAAI;AAAA,QACX,KAAK,UAAU,QAAQ,cAAc;AAAA,MAAA;AAAA,IAEzC,CAAC;AAED,QAAI,CAAC,WAAW;AACd,cAAQ,KAAK,4CAA4C,MAAM;AAC/D,aAAO;AAAA,IACT;AAGA,UAAM,cAAc,QAAQ,UAAU,mBAAmB;AACzD,UAAM,iBAAiB,UAAU,sBAAsB,UAAU,cAAc;AAC/E,UAAM,YAAY,QAAQ,cAAc;AAExC,QAAI,CAAC,eAAe,CAAC,WAAW;AAC9B,cAAQ,MAAM,4CAA4C;AAAA,QACxD,qBAAqB,UAAU;AAAA,QAC/B,aAAa,UAAU;AAAA,QACvB,cAAc,QAAQ;AAAA,MAAA,CACvB;AACD,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,WAAW,YAAY;AAAA,MACvB,SAAS,UAAU,aAAa,UAAU;AAAA,MAC1C,aAAa,YAAY;AAAA,MACzB,WAAW,UAAU,YAAY,UAAU;AAAA,IAAA;AAAA,EAE/C;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,YAAoB,QAA+B;AACjE,UAAM,QAAQ,KAAK,QAAQ,IAAI,UAAU;AACzC,QAAI,CAAC,OAAO,OAAO,MAAO,QAAO;AAEjC,UAAM,EAAE,QAAA,IAAY,MAAM,OAAO;AAEjC,UAAM,SAAS,kBAAkB,SAAS,QAAQ,CAAC,QAAQ,YAAY;AAAA,MACrE,OAAO,OAAO;AAAA,MACd,KAAK,OAAO,YAAY,OAAO;AAAA,IAAA,EAC/B;AAEF,WAAO,UAAU;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,YAAoB,QAA+B;AACpE,UAAM,QAAQ,KAAK,QAAQ,IAAI,UAAU;AACzC,QAAI,CAAC,OAAO,OAAO,MAAO,QAAO;AAEjC,UAAM,EAAE,SAAS,SAAA,IAAa,MAAM,OAAO;AAG3C,UAAM,qBAAqB,kBAAkB,UAAU,CAAC,QAAQ,IAAI,cAAc,MAAM;AAGxF,UAAM,iBAAiB,qBAAqB;AAE5C,QAAI,iBAAiB,GAAG;AAEtB,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,SAAS,cAAc;AACzC,QAAI,CAAC,UAAW,QAAO;AAGvB,WAAO,QAAQ,UAAU,mBAAmB,KAAK;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,SAAK,QAAQ,MAAA;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,YAA0B;AAC/B,SAAK,QAAQ,OAAO,UAAU;AAAA,EAChC;AACF;"}

package/dist/cache/resource/ResourceCache.d.ts

@@ -0,0 +1,46 @@
+import { OPFSManager } from '../storage/opfs/OPFSManager';
+
+/**
+ * ResourceCache - Original video resource OPFS cache
+ *
+ * Stores original MP4/video files for on-demand decoding
+ * Supports range reads for GOP-level access
+ */
+export declare class ResourceCache {
+    private opfsManager;
+    private projectId;
+    constructor(opfsManager: OPFSManager, projectId: string);
+    init(): Promise<void>;
+    /**
+     * Write resource to OPFS (streaming)
+     */
+    writeResource(resourceId: string, stream: ReadableStream<Uint8Array>): Promise<void>;
+    /**
+     * Read byte range from resource (for GOP-level access)
+     */
+    readRange(resourceId: string, start: number, end: number): Promise<ArrayBuffer>;
+    /**
+     * Check if resource exists in OPFS
+     */
+    hasResource(resourceId: string): Promise<boolean>;
+    /**
+     * Get resource file size
+     */
+    getResourceSize(resourceId: string): Promise<number>;
+    /**
+     * Delete a resource from OPFS
+     */
+    deleteResource(resourceId: string): Promise<void>;
+    /**
+     * Clear all resources for current project
+     */
+    clear(): Promise<void>;
+    /**
+     * LRU eviction to free up space
+     * Note: This is a simplified implementation
+     * Full implementation would track access times in IndexedDB
+     */
+    evictLRU(_targetBytes: number): Promise<void>;
+    private getFileName;
+}
+//# sourceMappingURL=ResourceCache.d.ts.map

package/dist/cache/resource/ResourceCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceCache.d.ts","sourceRoot":"","sources":["../../../src/cache/resource/ResourceCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;IAKjD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1F;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAWrF;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvD;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW1D;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;OAIG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,OAAO,CAAC,WAAW;CAIpB"}

package/dist/cache/resource/ResourceCache.js

@@ -0,0 +1,92 @@
+class ResourceCache {
+  opfsManager;
+  projectId;
+  constructor(opfsManager, projectId) {
+    this.opfsManager = opfsManager;
+    this.projectId = projectId;
+  }
+  async init() {
+    await this.opfsManager.init();
+  }
+  /**
+   * Write resource to OPFS (streaming)
+   */
+  async writeResource(resourceId, stream) {
+    const fileName = this.getFileName(resourceId);
+    const path = {
+      projectId: this.projectId,
+      prefix: "resource",
+      fileName
+    };
+    await this.opfsManager.writeFile(path, stream);
+  }
+  /**
+   * Read byte range from resource (for GOP-level access)
+   */
+  async readRange(resourceId, start, end) {
+    const fileName = this.getFileName(resourceId);
+    const path = {
+      projectId: this.projectId,
+      prefix: "resource",
+      fileName
+    };
+    return await this.opfsManager.readRange(path, start, end);
+  }
+  /**
+   * Check if resource exists in OPFS
+   */
+  async hasResource(resourceId) {
+    const fileName = this.getFileName(resourceId);
+    const path = {
+      projectId: this.projectId,
+      prefix: "resource",
+      fileName
+    };
+    return await this.opfsManager.exists(path);
+  }
+  /**
+   * Get resource file size
+   */
+  async getResourceSize(resourceId) {
+    const fileName = this.getFileName(resourceId);
+    const path = {
+      projectId: this.projectId,
+      prefix: "resource",
+      fileName
+    };
+    return await this.opfsManager.getFileSize(path);
+  }
+  /**
+   * Delete a resource from OPFS
+   */
+  async deleteResource(resourceId) {
+    const fileName = this.getFileName(resourceId);
+    const path = {
+      projectId: this.projectId,
+      prefix: "resource",
+      fileName
+    };
+    await this.opfsManager.deleteFile(path);
+  }
+  /**
+   * Clear all resources for current project
+   */
+  async clear() {
+    await this.opfsManager.deleteProjectDirectory(this.projectId, "resource");
+  }
+  /**
+   * LRU eviction to free up space
+   * Note: This is a simplified implementation
+   * Full implementation would track access times in IndexedDB
+   */
+  async evictLRU(_targetBytes) {
+    console.warn("[ResourceCache] LRU eviction not yet implemented");
+  }
+  getFileName(resourceId) {
+    return `${resourceId}.mp4`;
+  }
+}
+export {
+  ResourceCache
+};
+//# sourceMappingURL=ResourceCache.js.map

package/dist/cache/resource/ResourceCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceCache.js","sources":["../../../src/cache/resource/ResourceCache.ts"],"sourcesContent":["import { OPFSManager } from '../storage/opfs/OPFSManager';\nimport type { OPFSPath } from '../storage/opfs/types';\n\n/**\n * ResourceCache - Original video resource OPFS cache\n *\n * Stores original MP4/video files for on-demand decoding\n * Supports range reads for GOP-level access\n */\nexport class ResourceCache {\n  private opfsManager: OPFSManager;\n  private projectId: string;\n\n  constructor(opfsManager: OPFSManager, projectId: string) {\n    this.opfsManager = opfsManager;\n    this.projectId = projectId;\n  }\n\n  async init(): Promise<void> {\n    await this.opfsManager.init();\n  }\n\n  /**\n   * Write resource to OPFS (streaming)\n   */\n  async writeResource(resourceId: string, stream: ReadableStream<Uint8Array>): Promise<void> {\n    const fileName = this.getFileName(resourceId);\n    const path: OPFSPath = {\n      projectId: this.projectId,\n      prefix: 'resource',\n      fileName,\n    };\n\n    await this.opfsManager.writeFile(path, stream);\n  }\n\n  /**\n   * Read byte range from resource (for GOP-level access)\n   */\n  async readRange(resourceId: string, start: number, end: number): Promise<ArrayBuffer> {\n    const fileName = this.getFileName(resourceId);\n    const path: OPFSPath = {\n      projectId: this.projectId,\n      prefix: 'resource',\n      fileName,\n    };\n\n    return await this.opfsManager.readRange(path, start, end);\n  }\n\n  /**\n   * Check if resource exists in OPFS\n   */\n  async hasResource(resourceId: string): Promise<boolean> {\n    const fileName = this.getFileName(resourceId);\n    const path: OPFSPath = {\n      projectId: this.projectId,\n      prefix: 'resource',\n      fileName,\n    };\n\n    return await this.opfsManager.exists(path);\n  }\n\n  /**\n   * Get resource file size\n   */\n  async getResourceSize(resourceId: string): Promise<number> {\n    const fileName = this.getFileName(resourceId);\n    const path: OPFSPath = {\n      projectId: this.projectId,\n      prefix: 'resource',\n      fileName,\n    };\n\n    return await this.opfsManager.getFileSize(path);\n  }\n\n  /**\n   * Delete a resource from OPFS\n   */\n  async deleteResource(resourceId: string): Promise<void> {\n    const fileName = this.getFileName(resourceId);\n    const path: OPFSPath = {\n      projectId: this.projectId,\n      prefix: 'resource',\n      fileName,\n    };\n\n    await this.opfsManager.deleteFile(path);\n  }\n\n  /**\n   * Clear all resources for current project\n   */\n  async clear(): Promise<void> {\n    await this.opfsManager.deleteProjectDirectory(this.projectId, 'resource');\n  }\n\n  /**\n   * LRU eviction to free up space\n   * Note: This is a simplified implementation\n   * Full implementation would track access times in IndexedDB\n   */\n  async evictLRU(_targetBytes: number): Promise<void> {\n    // TODO: Implement LRU eviction when resource metadata tracking is added\n    console.warn('[ResourceCache] LRU eviction not yet implemented');\n  }\n\n  private getFileName(resourceId: string): string {\n    // Simple filename mapping - could be enhanced with extension detection\n    return `${resourceId}.mp4`;\n  }\n}\n"],"names":[],"mappings":"AASO,MAAM,cAAc;AAAA,EACjB;AAAA,EACA;AAAA,EAER,YAAY,aAA0B,WAAmB;AACvD,SAAK,cAAc;AACnB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,MAAM,OAAsB;AAC1B,UAAM,KAAK,YAAY,KAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAc,YAAoB,QAAmD;AACzF,UAAM,WAAW,KAAK,YAAY,UAAU;AAC5C,UAAM,OAAiB;AAAA,MACrB,WAAW,KAAK;AAAA,MAChB,QAAQ;AAAA,MACR;AAAA,IAAA;AAGF,UAAM,KAAK,YAAY,UAAU,MAAM,MAAM;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAU,YAAoB,OAAe,KAAmC;AACpF,UAAM,WAAW,KAAK,YAAY,UAAU;AAC5C,UAAM,OAAiB;AAAA,MACrB,WAAW,KAAK;AAAA,MAChB,QAAQ;AAAA,MACR;AAAA,IAAA;AAGF,WAAO,MAAM,KAAK,YAAY,UAAU,MAAM,OAAO,GAAG;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,YAAsC;AACtD,UAAM,WAAW,KAAK,YAAY,UAAU;AAC5C,UAAM,OAAiB;AAAA,MACrB,WAAW,KAAK;AAAA,MAChB,QAAQ;AAAA,MACR;AAAA,IAAA;AAGF,WAAO,MAAM,KAAK,YAAY,OAAO,IAAI;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,YAAqC;AACzD,UAAM,WAAW,KAAK,YAAY,UAAU;AAC5C,UAAM,OAAiB;AAAA,MACrB,WAAW,KAAK;AAAA,MAChB,QAAQ;AAAA,MACR;AAAA,IAAA;AAGF,WAAO,MAAM,KAAK,YAAY,YAAY,IAAI;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,YAAmC;AACtD,UAAM,WAAW,KAAK,YAAY,UAAU;AAC5C,UAAM,OAAiB;AAAA,MACrB,WAAW,KAAK;AAAA,MAChB,QAAQ;AAAA,MACR;AAAA,IAAA;AAGF,UAAM,KAAK,YAAY,WAAW,IAAI;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AAC3B,UAAM,KAAK,YAAY,uBAAuB,KAAK,WAAW,UAAU;AAAA,EAC1E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAS,cAAqC;AAElD,YAAQ,KAAK,kDAAkD;AAAA,EACjE;AAAA,EAEQ,YAAY,YAA4B;AAE9C,WAAO,GAAG,UAAU;AAAA,EACtB;AACF;"}

package/dist/cache/storage/indexeddb/ChunkRecordStore.d.ts

@@ -0,0 +1,75 @@
+import { ChunkBatch } from '../opfs/types';
+
+export type { ChunkBatch };
+export interface ChunkRecord {
+    projectId: string;
+    clipId: string;
+    track: 'video' | 'audio';
+    fileName: string;
+    batches: ChunkBatch[];
+    lastAccess: number;
+    totalBytes: number;
+    isComplete: boolean;
+    expectedDurationUs?: number;
+    metadata?: {
+        codec?: string;
+        description?: Uint8Array;
+        codedWidth?: number;
+        codedHeight?: number;
+        displayAspectWidth?: number;
+        displayAspectHeight?: number;
+        colorSpace?: VideoColorSpaceInit;
+        hardwareAcceleration?: HardwareAcceleration;
+        optimizeForLatency?: boolean;
+        sampleRate?: number;
+        numberOfChannels?: number;
+    };
+}
+/**
+ * IndexedDB storage for L2 cache metadata
+ * Handles all database operations for chunk records
+ */
+export declare class ChunkRecordStore {
+    private db;
+    private initPromise;
+    init(): Promise<void>;
+    private initStorage;
+    /**
+     * Get a chunk record
+     */
+    getRecord(projectId: string, clipId: string, track: string): Promise<ChunkRecord | null>;
+    /**
+     * Put/update a chunk record
+     */
+    putRecord(record: ChunkRecord): Promise<void>;
+    /**
+     * Delete a chunk record
+     */
+    deleteRecord(projectId: string, clipId: string, track: string): Promise<void>;
+    /**
+     * Update last access time for a record
+     */
+    updateLastAccess(projectId: string, clipId: string, track: string): Promise<void>;
+    /**
+     * Collect all records for a specific clip
+     */
+    collectRecordsByClipId(projectId: string, clipId: string): Promise<ChunkRecord[]>;
+    /**
+     * Get all records for a specific project
+     */
+    getRecordsByProjectId(projectId: string): Promise<ChunkRecord[]>;
+    /**
+     * Get all records sorted by lastAccess (for quota enforcement)
+     */
+    getAllRecordsSortedByAccess(): Promise<ChunkRecord[]>;
+    /**
+     * Get all records (for project statistics)
+     */
+    getAllRecords(): Promise<ChunkRecord[]>;
+    /**
+     * Clear all data from chunks and meta stores
+     */
+    clear(): Promise<void>;
+    private promisifyRequest;
+}
+//# sourceMappingURL=ChunkRecordStore.d.ts.map

package/dist/cache/storage/indexeddb/ChunkRecordStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChunkRecordStore.d.ts","sourceRoot":"","sources":["../../../../src/cache/storage/indexeddb/ChunkRecordStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,UAAU,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;QAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,WAAW,CAA8B;IAE3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,WAAW;IAqCzB;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAU9F;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnD;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnF;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavF;;OAEG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4BvF;;OAEG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAatE;;OAEG;IACG,2BAA2B,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAyB3D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAwB7C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/cache/{l2/IndexedDBStore.js → storage/indexeddb/ChunkRecordStore.js}

@@ -1,4 +1,4 @@
-class IndexedDBStore {
+class ChunkRecordStore {
   db = null;
   initPromise = null;
   async init() {
@@ -175,6 +175,6 @@ class IndexedDBStore {
   }
 }
 export {
-  IndexedDBStore
+  ChunkRecordStore
 };
-//# sourceMappingURL=IndexedDBStore.js.map
+//# sourceMappingURL=ChunkRecordStore.js.map

package/dist/cache/storage/indexeddb/ChunkRecordStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChunkRecordStore.js","sources":["../../../../src/cache/storage/indexeddb/ChunkRecordStore.ts"],"sourcesContent":["import type { ChunkBatch } from '../opfs/types';\n\nexport type { ChunkBatch };\n\nexport interface ChunkRecord {\n  projectId: string;\n  clipId: string;\n  track: 'video' | 'audio';\n  fileName: string;\n  batches: ChunkBatch[];\n  lastAccess: number;\n  totalBytes: number;\n  isComplete: boolean;\n  expectedDurationUs?: number;\n  metadata?: {\n    codec?: string;\n    description?: Uint8Array;\n    codedWidth?: number;\n    codedHeight?: number;\n    displayAspectWidth?: number;\n    displayAspectHeight?: number;\n    colorSpace?: VideoColorSpaceInit;\n    hardwareAcceleration?: HardwareAcceleration;\n    optimizeForLatency?: boolean;\n    sampleRate?: number;\n    numberOfChannels?: number;\n  };\n}\n\n/**\n * IndexedDB storage for L2 cache metadata\n * Handles all database operations for chunk records\n */\nexport class ChunkRecordStore {\n  private db: IDBDatabase | null = null;\n  private initPromise: Promise<void> | null = null;\n\n  async init(): Promise<void> {\n    if (this.initPromise) return this.initPromise;\n\n    this.initPromise = this.initStorage();\n    return this.initPromise;\n  }\n\n  private async initStorage(): Promise<void> {\n    // meframe_cache schema v1.1 (IndexedDB version 2)\n    // - Added projectId support for multi-project isolation\n    // - Composite key: [projectId, clipId, track]\n    const request = indexedDB.open('meframe_cache', 2);\n\n    request.onupgradeneeded = (event) => {\n      const db = (event.target as IDBOpenDBRequest).result;\n      const oldVersion = event.oldVersion;\n\n      // Version 1→2: Add projectId support\n      if (oldVersion < 2) {\n        // Delete old chunks store if exists\n        if (db.objectStoreNames.contains('chunks')) {\n          db.deleteObjectStore('chunks');\n        }\n\n        // Create new chunks store with composite key [projectId, clipId, track]\n        const store = db.createObjectStore('chunks', {\n          keyPath: ['projectId', 'clipId', 'track'],\n        });\n        store.createIndex('lastAccess', 'lastAccess');\n        store.createIndex('projectId', 'projectId'); // New: query by project\n      }\n\n      // meta store (unchanged)\n      if (!db.objectStoreNames.contains('meta')) {\n        db.createObjectStore('meta', { keyPath: 'projectId' });\n      }\n    };\n\n    this.db = await new Promise((resolve, reject) => {\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  /**\n   * Get a chunk record\n   */\n  async getRecord(projectId: string, clipId: string, track: string): Promise<ChunkRecord | null> {\n    if (!this.db) return null;\n\n    const tx = this.db.transaction('chunks', 'readonly');\n    const store = tx.objectStore('chunks');\n    const record = await this.promisifyRequest<ChunkRecord>(store.get([projectId, clipId, track]));\n\n    return record || null;\n  }\n\n  /**\n   * Put/update a chunk record\n   */\n  async putRecord(record: ChunkRecord): Promise<void> {\n    if (!this.db) return;\n\n    const tx = this.db.transaction('chunks', 'readwrite');\n    const store = tx.objectStore('chunks');\n    store.put(record);\n\n    // Wait for transaction to complete\n    await new Promise<void>((resolve, reject) => {\n      tx.oncomplete = () => resolve();\n      tx.onerror = () => reject(tx.error);\n    });\n  }\n\n  /**\n   * Delete a chunk record\n   */\n  async deleteRecord(projectId: string, clipId: string, track: string): Promise<void> {\n    if (!this.db) return;\n\n    const tx = this.db.transaction('chunks', 'readwrite');\n    const store = tx.objectStore('chunks');\n    await this.promisifyRequest(store.delete([projectId, clipId, track]));\n  }\n\n  /**\n   * Update last access time for a record\n   */\n  async updateLastAccess(projectId: string, clipId: string, track: string): Promise<void> {\n    if (!this.db) return;\n\n    const tx = this.db.transaction('chunks', 'readwrite');\n    const store = tx.objectStore('chunks');\n    const record = await this.promisifyRequest<ChunkRecord>(store.get([projectId, clipId, track]));\n\n    if (record) {\n      record.lastAccess = Date.now();\n      await this.promisifyRequest(store.put(record));\n    }\n  }\n\n  /**\n   * Collect all records for a specific clip\n   */\n  async collectRecordsByClipId(projectId: string, clipId: string): Promise<ChunkRecord[]> {\n    if (!this.db) return [];\n\n    const tx = this.db.transaction('chunks', 'readonly');\n    const store = tx.objectStore('chunks');\n    const records: ChunkRecord[] = [];\n    const cursor = store.openCursor();\n\n    await new Promise<void>((resolve) => {\n      cursor.onsuccess = (event) => {\n        const cursor = (event.target as IDBRequest).result;\n        if (!cursor) {\n          resolve();\n          return;\n        }\n\n        const record: ChunkRecord = cursor.value;\n        if (record.projectId === projectId && record.clipId === clipId) {\n          records.push(record);\n        }\n\n        cursor.continue();\n      };\n    });\n\n    return records;\n  }\n\n  /**\n   * Get all records for a specific project\n   */\n  async getRecordsByProjectId(projectId: string): Promise<ChunkRecord[]> {\n    if (!this.db) return [];\n\n    const tx = this.db.transaction('chunks', 'readonly');\n    const store = tx.objectStore('chunks');\n    const index = store.index('projectId');\n    const records = await this.promisifyRequest<ChunkRecord[]>(\n      index.getAll(IDBKeyRange.only(projectId))\n    );\n\n    return records;\n  }\n\n  /**\n   * Get all records sorted by lastAccess (for quota enforcement)\n   */\n  async getAllRecordsSortedByAccess(): Promise<ChunkRecord[]> {\n    if (!this.db) return [];\n\n    const tx = this.db.transaction('chunks', 'readonly');\n    const store = tx.objectStore('chunks');\n    const index = store.index('lastAccess');\n    const records: ChunkRecord[] = [];\n\n    const cursor = index.openCursor();\n    await new Promise<void>((resolve) => {\n      cursor.onsuccess = (event) => {\n        const cursor = (event.target as IDBRequest).result;\n        if (!cursor) {\n          resolve();\n          return;\n        }\n\n        records.push(cursor.value);\n        cursor.continue();\n      };\n    });\n\n    return records;\n  }\n\n  /**\n   * Get all records (for project statistics)\n   */\n  async getAllRecords(): Promise<ChunkRecord[]> {\n    if (!this.db) return [];\n\n    const tx = this.db.transaction('chunks', 'readonly');\n    const store = tx.objectStore('chunks');\n    const records: ChunkRecord[] = [];\n\n    const cursor = store.openCursor();\n    await new Promise<void>((resolve) => {\n      cursor.onsuccess = (event) => {\n        const cursor = (event.target as IDBRequest).result;\n        if (!cursor) {\n          resolve();\n          return;\n        }\n\n        records.push(cursor.value);\n        cursor.continue();\n      };\n    });\n\n    return records;\n  }\n\n  /**\n   * Clear all data from chunks and meta stores\n   */\n  async clear(): Promise<void> {\n    if (!this.db) return;\n\n    const tx = this.db.transaction(['chunks', 'meta'], 'readwrite');\n    await this.promisifyRequest(tx.objectStore('chunks').clear());\n    await this.promisifyRequest(tx.objectStore('meta').clear());\n  }\n\n  private promisifyRequest<T>(request: IDBRequest): Promise<T> {\n    return new Promise((resolve, reject) => {\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => reject(request.error);\n    });\n  }\n}\n"],"names":["cursor"],"mappings":"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"}