@meframe/core 0.0.40 → 0.0.42

package/dist/cache/storage/opfs/OPFSManager.js

@@ -1,6 +1,16 @@
+import { OPFSQuotaExceededError } from "../../../utils/errors.js";
+function isDOMException(error, name) {
+  return error instanceof Error && "name" in error && error.name === name;
+}
 class OPFSManager {
   opfsRoot = null;
   initPromise = null;
+  maxSizeBytes;
+  quotaThreshold;
+  constructor(maxSizeMB = 5120, quotaThresholdPercent = 0.85) {
+    this.maxSizeBytes = maxSizeMB * 1024 * 1024;
+    this.quotaThreshold = quotaThresholdPercent;
+  }
   async init() {
     if (this.initPromise) return this.initPromise;
     this.initPromise = this.initStorage();
@@ -20,9 +30,52 @@ class OPFSManager {
     return this.opfsRoot.getDirectoryHandle(dirName, { create: true });
   }
   /**
-   * Write file (ArrayBuffer or ReadableStream)
+   * Write file with automatic quota management
+   * Proactively checks quota before write; evicts old projects if threshold exceeded
    */
   async writeFile(path, data) {
+    await this.ensureQuota(path.projectId, path.prefix);
+    try {
+      await this.writeFileInternal(path, data);
+    } catch (error) {
+      if (isDOMException(error, "QuotaExceededError")) {
+        const evictedCount = await this.evictOldestProjects(path.projectId, path.prefix, 1);
+        if (evictedCount === 0) {
+          throw new OPFSQuotaExceededError(path.projectId, path.prefix, false);
+        }
+        if (data instanceof ReadableStream) {
+          throw new OPFSQuotaExceededError(path.projectId, path.prefix, true);
+        }
+        await this.writeFileInternal(path, data);
+      } else {
+        throw error;
+      }
+    }
+  }
+  /**
+   * Ensure quota is within threshold before write
+   * Proactively evicts old projects if usage exceeds threshold
+   */
+  async ensureQuota(currentProjectId, prefix) {
+    const totalSize = await this.getTotalSize(prefix);
+    const usagePercent = totalSize / this.maxSizeBytes;
+    if (usagePercent > this.quotaThreshold) {
+      const needToFreeBytes = totalSize - this.maxSizeBytes * this.quotaThreshold;
+      const projectsToEvict = Math.ceil(needToFreeBytes / (totalSize / 10));
+      console.log(
+        `[OPFSManager] Quota usage ${(usagePercent * 100).toFixed(1)}% exceeds threshold ${(this.quotaThreshold * 100).toFixed(0)}%, evicting old projects`
+      );
+      await this.evictOldestProjects(currentProjectId, prefix, Math.max(1, projectsToEvict));
+    }
+  }
+  /**
+   * Get total size of all projects for a prefix
+   */
+  async getTotalSize(prefix) {
+    const projects = await this.listProjectsWithMetadata(prefix);
+    return projects.reduce((sum, p) => sum + p.size, 0);
+  }
+  async writeFileInternal(path, data) {
     const projectDir = await this.getProjectDir(path.projectId, path.prefix);
     const fileHandle = await projectDir.getFileHandle(path.fileName, { create: true });
     const writable = await fileHandle.createWritable();
@@ -75,7 +128,7 @@ class OPFSManager {
       const projectDir = await this.getProjectDir(path.projectId, path.prefix);
       await projectDir.removeEntry(path.fileName);
     } catch (error) {
-      if (error?.name !== "NotFoundError") {
+      if (!isDOMException(error, "NotFoundError")) {
         console.warn(`[OPFSManager] Failed to delete file ${path.fileName}:`, error);
       }
     }
@@ -89,7 +142,7 @@ class OPFSManager {
       await projectDir.getFileHandle(path.fileName, { create: false });
       return true;
     } catch (error) {
-      if (error?.name === "NotFoundError") {
+      if (isDOMException(error, "NotFoundError")) {
         return false;
       }
       throw error;
@@ -121,11 +174,64 @@ class OPFSManager {
       const dirName = `meframe-${prefix}-${projectId}`;
       await this.opfsRoot.removeEntry(dirName, { recursive: true });
     } catch (error) {
-      if (error?.name !== "NotFoundError") {
+      if (!isDOMException(error, "NotFoundError")) {
         console.warn(`[OPFSManager] Failed to remove directory ${prefix}-${projectId}:`, error);
       }
     }
   }
+  /**
+   * List all projects with size and lastModified metadata
+   * Used for LRU eviction
+   */
+  async listProjectsWithMetadata(prefix) {
+    if (!this.opfsRoot) {
+      throw new Error("[OPFSManager] Not initialized");
+    }
+    const projects = [];
+    const searchPrefix = `meframe-${prefix}-`;
+    for await (const [name, handle] of this.opfsRoot.entries()) {
+      if (handle.kind === "directory" && name.startsWith(searchPrefix)) {
+        const projectId = name.slice(searchPrefix.length);
+        const projectDir = handle;
+        let totalSize = 0;
+        let maxLastModified = 0;
+        for await (const [_fileName, fileHandle] of projectDir.entries()) {
+          if (fileHandle.kind === "file") {
+            const file = await fileHandle.getFile();
+            totalSize += file.size;
+            maxLastModified = Math.max(maxLastModified, file.lastModified);
+          }
+        }
+        if (totalSize > 0) {
+          projects.push({ projectId, size: totalSize, lastModified: maxLastModified });
+        }
+      }
+    }
+    return projects;
+  }
+  /**
+   * Evict oldest projects (by lastModified) excluding current project
+   * Returns number of projects evicted
+   */
+  async evictOldestProjects(currentProjectId, prefix, count) {
+    const projects = await this.listProjectsWithMetadata(prefix);
+    const candidates = projects.filter((p) => p.projectId !== currentProjectId).sort((a, b) => a.lastModified - b.lastModified).slice(0, count);
+    if (candidates.length === 0) {
+      return 0;
+    }
+    let freedBytes = 0;
+    for (const project of candidates) {
+      await this.deleteProjectDirectory(project.projectId, prefix);
+      freedBytes += project.size;
+      console.log(
+        `[OPFSManager] Evicted ${prefix} project ${project.projectId} (${(project.size / 1024 / 1024).toFixed(2)}MB, last modified: ${new Date(project.lastModified).toLocaleString()})`
+      );
+    }
+    console.log(
+      `[OPFSManager] Freed ${(freedBytes / 1024 / 1024).toFixed(2)}MB by evicting ${candidates.length} old project(s)`
+    );
+    return candidates.length;
+  }
 }
 export {
   OPFSManager

package/dist/cache/storage/opfs/OPFSManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"OPFSManager.js","sources":["../../../../src/cache/storage/opfs/OPFSManager.ts"],"sourcesContent":["import type { OPFSPrefix, OPFSPath } from './types';\n\n/**\n * OPFSManager - Unified OPFS management infrastructure\n *\n * Supports:\n * - Directory isolation by prefix (l2/resource)\n * - Range reads for on-demand decoding\n * - Streaming writes\n * - File operations (exists, delete, getFileSize)\n */\nexport class OPFSManager {\n  private opfsRoot: FileSystemDirectoryHandle | 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    this.opfsRoot = await navigator.storage.getDirectory();\n  }\n\n  /**\n   * Get project directory by prefix\n   */\n  async getProjectDir(projectId: string, prefix: OPFSPrefix): Promise<FileSystemDirectoryHandle> {\n    if (!this.opfsRoot) {\n      throw new Error('[OPFSManager] Not initialized');\n    }\n\n    const dirName = `meframe-${prefix}-${projectId}`;\n    return this.opfsRoot.getDirectoryHandle(dirName, { create: true });\n  }\n\n  /**\n   * Write file (ArrayBuffer or ReadableStream)\n   */\n  async writeFile(path: OPFSPath, data: ArrayBuffer | ReadableStream<Uint8Array>): Promise<void> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: true });\n    const writable = await fileHandle.createWritable();\n\n    if (data instanceof ArrayBuffer) {\n      await writable.write(data);\n    } else {\n      // Stream mode\n      const reader = data.getReader();\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          if (value) {\n            // Convert Uint8Array to ArrayBuffer for FileSystemWritableFileStream\n            const buffer = value.buffer.slice(\n              value.byteOffset,\n              value.byteOffset + value.byteLength\n            );\n            await writable.write(buffer as ArrayBuffer);\n          }\n        }\n      } finally {\n        reader.releaseLock();\n      }\n    }\n\n    await writable.close();\n  }\n\n  /**\n   * Read entire file\n   */\n  async readFile(path: OPFSPath): Promise<ArrayBuffer> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: false });\n    const file = await fileHandle.getFile();\n    return await file.arrayBuffer();\n  }\n\n  /**\n   * Read byte range from file (for on-demand decoding)\n   */\n  async readRange(path: OPFSPath, start: number, end: number): Promise<ArrayBuffer> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: false });\n    const file = await fileHandle.getFile();\n    const slice = file.slice(start, end);\n    return await slice.arrayBuffer();\n  }\n\n  /**\n   * Delete file\n   */\n  async deleteFile(path: OPFSPath): Promise<void> {\n    try {\n      const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n      await projectDir.removeEntry(path.fileName);\n    } catch (error) {\n      if ((error as any)?.name !== 'NotFoundError') {\n        console.warn(`[OPFSManager] Failed to delete file ${path.fileName}:`, error);\n      }\n    }\n  }\n\n  /**\n   * Check if file exists\n   */\n  async exists(path: OPFSPath): Promise<boolean> {\n    try {\n      const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n      await projectDir.getFileHandle(path.fileName, { create: false });\n      return true;\n    } catch (error) {\n      if ((error as any)?.name === 'NotFoundError') {\n        return false;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Get file size\n   */\n  async getFileSize(path: OPFSPath): Promise<number> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: false });\n    const file = await fileHandle.getFile();\n    return file.size;\n  }\n\n  /**\n   * Create writable stream for streaming writes\n   */\n  async createWritableStream(path: OPFSPath): Promise<FileSystemWritableFileStream> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: true });\n    return await fileHandle.createWritable();\n  }\n\n  /**\n   * Delete entire project directory\n   */\n  async deleteProjectDirectory(projectId: string, prefix: OPFSPrefix): Promise<void> {\n    if (!this.opfsRoot) return;\n\n    try {\n      const dirName = `meframe-${prefix}-${projectId}`;\n      await this.opfsRoot.removeEntry(dirName, { recursive: true });\n    } catch (error) {\n      if ((error as any)?.name !== 'NotFoundError') {\n        console.warn(`[OPFSManager] Failed to remove directory ${prefix}-${projectId}:`, error);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"OPFSManager.js","sources":["../../../../src/cache/storage/opfs/OPFSManager.ts"],"sourcesContent":["import type { OPFSPrefix, OPFSPath, ProjectMetadata } from './types';\nimport { OPFSQuotaExceededError } from '../../../utils/errors';\n\nfunction isDOMException(error: unknown, name: string): boolean {\n  return error instanceof Error && 'name' in error && error.name === name;\n}\n\n/**\n * OPFSManager - Unified OPFS management infrastructure\n *\n * Supports:\n * - Directory isolation by prefix (l2/resource)\n * - Range reads for on-demand decoding\n * - Streaming writes with automatic quota management\n * - Project-level LRU eviction\n */\nexport class OPFSManager {\n  private opfsRoot: FileSystemDirectoryHandle | null = null;\n  private initPromise: Promise<void> | null = null;\n  readonly maxSizeBytes: number;\n  readonly quotaThreshold: number;\n\n  constructor(maxSizeMB: number = 5120, quotaThresholdPercent: number = 0.85) {\n    this.maxSizeBytes = maxSizeMB * 1024 * 1024;\n    this.quotaThreshold = quotaThresholdPercent;\n  }\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    this.opfsRoot = await navigator.storage.getDirectory();\n  }\n\n  /**\n   * Get project directory by prefix\n   */\n  async getProjectDir(projectId: string, prefix: OPFSPrefix): Promise<FileSystemDirectoryHandle> {\n    if (!this.opfsRoot) {\n      throw new Error('[OPFSManager] Not initialized');\n    }\n\n    const dirName = `meframe-${prefix}-${projectId}`;\n    return this.opfsRoot.getDirectoryHandle(dirName, { create: true });\n  }\n\n  /**\n   * Write file with automatic quota management\n   * Proactively checks quota before write; evicts old projects if threshold exceeded\n   */\n  async writeFile(path: OPFSPath, data: ArrayBuffer | ReadableStream<Uint8Array>): Promise<void> {\n    await this.ensureQuota(path.projectId, path.prefix);\n\n    try {\n      await this.writeFileInternal(path, data);\n    } catch (error) {\n      if (isDOMException(error, 'QuotaExceededError')) {\n        const evictedCount = await this.evictOldestProjects(path.projectId, path.prefix, 1);\n\n        if (evictedCount === 0) {\n          throw new OPFSQuotaExceededError(path.projectId, path.prefix, false);\n        }\n\n        if (data instanceof ReadableStream) {\n          throw new OPFSQuotaExceededError(path.projectId, path.prefix, true);\n        }\n\n        await this.writeFileInternal(path, data);\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Ensure quota is within threshold before write\n   * Proactively evicts old projects if usage exceeds threshold\n   */\n  private async ensureQuota(currentProjectId: string, prefix: OPFSPrefix): Promise<void> {\n    const totalSize = await this.getTotalSize(prefix);\n    const usagePercent = totalSize / this.maxSizeBytes;\n\n    if (usagePercent > this.quotaThreshold) {\n      const needToFreeBytes = totalSize - this.maxSizeBytes * this.quotaThreshold;\n      const projectsToEvict = Math.ceil(needToFreeBytes / (totalSize / 10));\n\n      console.log(\n        `[OPFSManager] Quota usage ${(usagePercent * 100).toFixed(1)}% exceeds threshold ${(this.quotaThreshold * 100).toFixed(0)}%, evicting old projects`\n      );\n\n      await this.evictOldestProjects(currentProjectId, prefix, Math.max(1, projectsToEvict));\n    }\n  }\n\n  /**\n   * Get total size of all projects for a prefix\n   */\n  async getTotalSize(prefix: OPFSPrefix): Promise<number> {\n    const projects = await this.listProjectsWithMetadata(prefix);\n    return projects.reduce((sum, p) => sum + p.size, 0);\n  }\n\n  private async writeFileInternal(\n    path: OPFSPath,\n    data: ArrayBuffer | ReadableStream<Uint8Array>\n  ): Promise<void> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: true });\n    const writable = await fileHandle.createWritable();\n\n    if (data instanceof ArrayBuffer) {\n      await writable.write(data);\n    } else {\n      const reader = data.getReader();\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          if (value) {\n            const buffer = value.buffer.slice(\n              value.byteOffset,\n              value.byteOffset + value.byteLength\n            );\n            await writable.write(buffer as ArrayBuffer);\n          }\n        }\n      } finally {\n        reader.releaseLock();\n      }\n    }\n\n    await writable.close();\n  }\n\n  /**\n   * Read entire file\n   */\n  async readFile(path: OPFSPath): Promise<ArrayBuffer> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: false });\n    const file = await fileHandle.getFile();\n    return await file.arrayBuffer();\n  }\n\n  /**\n   * Read byte range from file (for on-demand decoding)\n   */\n  async readRange(path: OPFSPath, start: number, end: number): Promise<ArrayBuffer> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: false });\n    const file = await fileHandle.getFile();\n    const slice = file.slice(start, end);\n    return await slice.arrayBuffer();\n  }\n\n  /**\n   * Delete file\n   */\n  async deleteFile(path: OPFSPath): Promise<void> {\n    try {\n      const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n      await projectDir.removeEntry(path.fileName);\n    } catch (error) {\n      if (!isDOMException(error, 'NotFoundError')) {\n        console.warn(`[OPFSManager] Failed to delete file ${path.fileName}:`, error);\n      }\n    }\n  }\n\n  /**\n   * Check if file exists\n   */\n  async exists(path: OPFSPath): Promise<boolean> {\n    try {\n      const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n      await projectDir.getFileHandle(path.fileName, { create: false });\n      return true;\n    } catch (error) {\n      if (isDOMException(error, 'NotFoundError')) {\n        return false;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Get file size\n   */\n  async getFileSize(path: OPFSPath): Promise<number> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: false });\n    const file = await fileHandle.getFile();\n    return file.size;\n  }\n\n  /**\n   * Create writable stream for streaming writes\n   */\n  async createWritableStream(path: OPFSPath): Promise<FileSystemWritableFileStream> {\n    const projectDir = await this.getProjectDir(path.projectId, path.prefix);\n    const fileHandle = await projectDir.getFileHandle(path.fileName, { create: true });\n    return await fileHandle.createWritable();\n  }\n\n  /**\n   * Delete entire project directory\n   */\n  async deleteProjectDirectory(projectId: string, prefix: OPFSPrefix): Promise<void> {\n    if (!this.opfsRoot) return;\n\n    try {\n      const dirName = `meframe-${prefix}-${projectId}`;\n      await this.opfsRoot.removeEntry(dirName, { recursive: true });\n    } catch (error) {\n      if (!isDOMException(error, 'NotFoundError')) {\n        console.warn(`[OPFSManager] Failed to remove directory ${prefix}-${projectId}:`, error);\n      }\n    }\n  }\n\n  /**\n   * List all projects with size and lastModified metadata\n   * Used for LRU eviction\n   */\n  async listProjectsWithMetadata(prefix: OPFSPrefix): Promise<ProjectMetadata[]> {\n    if (!this.opfsRoot) {\n      throw new Error('[OPFSManager] Not initialized');\n    }\n\n    const projects: ProjectMetadata[] = [];\n    const searchPrefix = `meframe-${prefix}-`;\n\n    // @ts-expect-error - AsyncIterator type not well-supported\n    for await (const [name, handle] of this.opfsRoot.entries()) {\n      if (handle.kind === 'directory' && name.startsWith(searchPrefix)) {\n        const projectId = name.slice(searchPrefix.length);\n        const projectDir = handle as FileSystemDirectoryHandle;\n        let totalSize = 0;\n        let maxLastModified = 0;\n\n        // @ts-expect-error - AsyncIterator type not well-supported\n        for await (const [_fileName, fileHandle] of projectDir.entries()) {\n          if (fileHandle.kind === 'file') {\n            const file = await (fileHandle as FileSystemFileHandle).getFile();\n            totalSize += file.size;\n            maxLastModified = Math.max(maxLastModified, file.lastModified);\n          }\n        }\n\n        if (totalSize > 0) {\n          projects.push({ projectId, size: totalSize, lastModified: maxLastModified });\n        }\n      }\n    }\n\n    return projects;\n  }\n\n  /**\n   * Evict oldest projects (by lastModified) excluding current project\n   * Returns number of projects evicted\n   */\n  async evictOldestProjects(\n    currentProjectId: string,\n    prefix: OPFSPrefix,\n    count: number\n  ): Promise<number> {\n    const projects = await this.listProjectsWithMetadata(prefix);\n    const candidates = projects\n      .filter((p) => p.projectId !== currentProjectId)\n      .sort((a, b) => a.lastModified - b.lastModified)\n      .slice(0, count);\n\n    if (candidates.length === 0) {\n      return 0;\n    }\n\n    let freedBytes = 0;\n\n    for (const project of candidates) {\n      await this.deleteProjectDirectory(project.projectId, prefix);\n      freedBytes += project.size;\n\n      console.log(\n        `[OPFSManager] Evicted ${prefix} project ${project.projectId} ` +\n          `(${(project.size / 1024 / 1024).toFixed(2)}MB, ` +\n          `last modified: ${new Date(project.lastModified).toLocaleString()})`\n      );\n    }\n\n    console.log(\n      `[OPFSManager] Freed ${(freedBytes / 1024 / 1024).toFixed(2)}MB ` +\n        `by evicting ${candidates.length} old project(s)`\n    );\n\n    return candidates.length;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/cache/storage/opfs/types.d.ts

@@ -13,4 +13,9 @@ export interface ChunkBatch {
     byteLength: number;
     type: 'key' | 'delta';
 }
+export interface ProjectMetadata {
+    projectId: string;
+    size: number;
+    lastModified: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/cache/storage/opfs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cache/storage/opfs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cache/storage/opfs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/config/defaults.js

@@ -11,7 +11,7 @@ const DEFAULT_CONFIG = {
     workerExtension: ".js"
   },
   load: {
-    maxConcurrent: 2,
+    maxConcurrent: 3,
     backpressure: {
       highWaterMark: 64 * 1024,
       // 64 KB

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sources":["../../src/config/defaults.ts"],"sourcesContent":["import type { ResolvedConfig } from './types';\nimport { CANVAS_PRESETS } from './presets';\n\n/**\n * Detect if running in development mode\n * In dev mode, workers are loaded from source (Vite dev server)\n * In prod mode, workers are loaded from dist\n */\nconst isDev = import.meta.env?.DEV ?? false;\n\n/**\n * Default configuration values based on 1080p30 memory budget\n *\n * Note: Canvas dimensions are fixed for the entire project.\n * All video clips will be scaled/fitted to this resolution.\n * Choose based on your primary content type:\n * - 720×1280: Mobile vertical video\n * - 1080×1920: HD vertical video (TikTok, Instagram Reels) ← default\n * - 1920×1080: HD horizontal video (YouTube)\n */\nexport const DEFAULT_CONFIG: ResolvedConfig = {\n  global: {\n    projectId: `project-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n    logLevel: 'info',\n    enablePerfMonitor: false,\n    defaultCanvasWidth: CANVAS_PRESETS.HD_PORTRAIT.width,\n    defaultCanvasHeight: CANVAS_PRESETS.HD_PORTRAIT.height,\n    defaultFps: 30,\n    workerPath: isDev ? '/src' : '/meframe-workers',\n    workerExtension: isDev ? '.ts' : '.js',\n  },\n\n  load: {\n    maxConcurrent: 2,\n    backpressure: {\n      highWaterMark: 64 * 1024, // 64 KB\n      stallTimeoutMs: 500,\n    },\n    retry: {\n      maxAttempts: 3,\n      baseDelayMs: 500,\n    },\n    window: {\n      maxInflightPerClip: 1,\n      maxInflight: 4,\n      chunkSize: 1 * 1024 * 1024, // 1 MB\n    },\n  },\n\n  demux: {\n    backpressure: {\n      highWaterMark: 10, // 10 EncodedChunks\n    },\n  },\n\n  decode: {\n    video: {\n      backpressure: {\n        highWaterMark: 4, // 4 EncodedVideoChunks\n        decodeQueueThreshold: 16, // Pause when decoder has 16+ chunks\n      },\n      maxGOPs: 4, // Cache 4 GOPs for seeking\n    },\n    audio: {\n      backpressure: {\n        highWaterMark: 20, // 20 EncodedAudioChunks\n      },\n    },\n  },\n\n  compose: {\n    visual: {},\n    audio: {\n      enableDucking: false, // Default: no ducking\n    },\n  },\n\n  encode: {\n    video: {},\n    audio: {},\n  },\n\n  cache: {\n    l1: {\n      windowSizeUs: 6_000_000, // ±3 seconds window\n      maxMemoryMB: 200,\n    },\n    l2: {\n      autoFill: true,\n      fillPriority: 'low' as const,\n    },\n    opfs: {\n      enabled: true,\n      resource: {\n        maxSizeMB: 5120, // 5GB for original resources\n        evictionPolicy: 'lru' as const,\n      },\n      l2: {\n        maxSizeMB: 2048, // 2GB for encoded chunks\n      },\n    },\n  },\n\n  mux: {},\n};\n\n/**\n * Tuning presets for common scenarios\n */\nexport const TUNING_PRESETS = {\n  /**\n   * Low-latency live streaming\n   * Minimize buffering for real-time playback\n   */\n  lowLatency: {\n    global: {\n      logLevel: 'info' as const,\n    },\n    load: {\n      backpressure: {\n        highWaterMark: 16 * 1024, // 16 KB\n      },\n    },\n    demux: {\n      backpressure: {\n        highWaterMark: 3,\n      },\n    },\n    decode: {\n      video: {\n        backpressure: {\n          highWaterMark: 2,\n          decodeQueueThreshold: 4,\n        },\n      },\n      audio: {\n        backpressure: {\n          highWaterMark: 10,\n        },\n      },\n    },\n  },\n\n  /**\n   * 4K60 playback/export\n   * Larger buffers for high bitrate content\n   */\n  highQuality: {\n    global: {\n      logLevel: 'info' as const,\n    },\n    load: {\n      backpressure: {\n        highWaterMark: 256 * 1024, // 256 KB\n      },\n      retry: {\n        maxAttempts: 3,\n        baseDelayMs: 500,\n      },\n    },\n    demux: {\n      backpressure: {\n        highWaterMark: 20,\n      },\n    },\n    decode: {\n      video: {\n        backpressure: {\n          highWaterMark: 8,\n          decodeQueueThreshold: 24,\n        },\n        codecHints: ['h264', 'hevc'] as ('h264' | 'hevc')[],\n      },\n      audio: {\n        backpressure: {\n          highWaterMark: 30,\n        },\n      },\n    },\n    cache: {\n      l2: {\n        quotaGb: 1,\n      },\n    },\n  },\n\n  /**\n   * Batch offline transcode\n   * Maximum throughput, memory not a concern\n   */\n  offline: {\n    global: {\n      logLevel: 'warn' as const,\n    },\n    load: {\n      backpressure: {\n        highWaterMark: 512 * 1024, // 512 KB\n      },\n    },\n    demux: {\n      backpressure: {\n        highWaterMark: 25,\n      },\n    },\n    decode: {\n      video: {\n        backpressure: {\n          highWaterMark: 12,\n          decodeQueueThreshold: 32,\n        },\n      },\n      audio: {\n        backpressure: {\n          highWaterMark: 40,\n        },\n      },\n    },\n  },\n} as const;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"defaults.js","sources":["../../src/config/defaults.ts"],"sourcesContent":["import type { ResolvedConfig } from './types';\nimport { CANVAS_PRESETS } from './presets';\n\n/**\n * Detect if running in development mode\n * In dev mode, workers are loaded from source (Vite dev server)\n * In prod mode, workers are loaded from dist\n */\nconst isDev = import.meta.env?.DEV ?? false;\n\n/**\n * Default configuration values based on 1080p30 memory budget\n *\n * Note: Canvas dimensions are fixed for the entire project.\n * All video clips will be scaled/fitted to this resolution.\n * Choose based on your primary content type:\n * - 720×1280: Mobile vertical video\n * - 1080×1920: HD vertical video (TikTok, Instagram Reels) ← default\n * - 1920×1080: HD horizontal video (YouTube)\n */\nexport const DEFAULT_CONFIG: ResolvedConfig = {\n  global: {\n    projectId: `project-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n    logLevel: 'info',\n    enablePerfMonitor: false,\n    defaultCanvasWidth: CANVAS_PRESETS.HD_PORTRAIT.width,\n    defaultCanvasHeight: CANVAS_PRESETS.HD_PORTRAIT.height,\n    defaultFps: 30,\n    workerPath: isDev ? '/src' : '/meframe-workers',\n    workerExtension: isDev ? '.ts' : '.js',\n  },\n\n  load: {\n    maxConcurrent: 3,\n    backpressure: {\n      highWaterMark: 64 * 1024, // 64 KB\n      stallTimeoutMs: 500,\n    },\n    retry: {\n      maxAttempts: 3,\n      baseDelayMs: 500,\n    },\n    window: {\n      maxInflightPerClip: 1,\n      maxInflight: 4,\n      chunkSize: 1 * 1024 * 1024, // 1 MB\n    },\n  },\n\n  demux: {\n    backpressure: {\n      highWaterMark: 10, // 10 EncodedChunks\n    },\n  },\n\n  decode: {\n    video: {\n      backpressure: {\n        highWaterMark: 4, // 4 EncodedVideoChunks\n        decodeQueueThreshold: 16, // Pause when decoder has 16+ chunks\n      },\n      maxGOPs: 4, // Cache 4 GOPs for seeking\n    },\n    audio: {\n      backpressure: {\n        highWaterMark: 20, // 20 EncodedAudioChunks\n      },\n    },\n  },\n\n  compose: {\n    visual: {},\n    audio: {\n      enableDucking: false, // Default: no ducking\n    },\n  },\n\n  encode: {\n    video: {},\n    audio: {},\n  },\n\n  cache: {\n    l1: {\n      windowSizeUs: 6_000_000, // ±3 seconds window\n      maxMemoryMB: 200,\n    },\n    l2: {\n      autoFill: true,\n      fillPriority: 'low' as const,\n    },\n    opfs: {\n      enabled: true,\n      resource: {\n        maxSizeMB: 5120, // 5GB for original resources\n        evictionPolicy: 'lru' as const,\n      },\n      l2: {\n        maxSizeMB: 2048, // 2GB for encoded chunks\n      },\n    },\n  },\n\n  mux: {},\n};\n\n/**\n * Tuning presets for common scenarios\n */\nexport const TUNING_PRESETS = {\n  /**\n   * Low-latency live streaming\n   * Minimize buffering for real-time playback\n   */\n  lowLatency: {\n    global: {\n      logLevel: 'info' as const,\n    },\n    load: {\n      backpressure: {\n        highWaterMark: 16 * 1024, // 16 KB\n      },\n    },\n    demux: {\n      backpressure: {\n        highWaterMark: 3,\n      },\n    },\n    decode: {\n      video: {\n        backpressure: {\n          highWaterMark: 2,\n          decodeQueueThreshold: 4,\n        },\n      },\n      audio: {\n        backpressure: {\n          highWaterMark: 10,\n        },\n      },\n    },\n  },\n\n  /**\n   * 4K60 playback/export\n   * Larger buffers for high bitrate content\n   */\n  highQuality: {\n    global: {\n      logLevel: 'info' as const,\n    },\n    load: {\n      backpressure: {\n        highWaterMark: 256 * 1024, // 256 KB\n      },\n      retry: {\n        maxAttempts: 3,\n        baseDelayMs: 500,\n      },\n    },\n    demux: {\n      backpressure: {\n        highWaterMark: 20,\n      },\n    },\n    decode: {\n      video: {\n        backpressure: {\n          highWaterMark: 8,\n          decodeQueueThreshold: 24,\n        },\n        codecHints: ['h264', 'hevc'] as ('h264' | 'hevc')[],\n      },\n      audio: {\n        backpressure: {\n          highWaterMark: 30,\n        },\n      },\n    },\n    cache: {\n      l2: {\n        quotaGb: 1,\n      },\n    },\n  },\n\n  /**\n   * Batch offline transcode\n   * Maximum throughput, memory not a concern\n   */\n  offline: {\n    global: {\n      logLevel: 'warn' as const,\n    },\n    load: {\n      backpressure: {\n        highWaterMark: 512 * 1024, // 512 KB\n      },\n    },\n    demux: {\n      backpressure: {\n        highWaterMark: 25,\n      },\n    },\n    decode: {\n      video: {\n        backpressure: {\n          highWaterMark: 12,\n          decodeQueueThreshold: 32,\n        },\n      },\n      audio: {\n        backpressure: {\n          highWaterMark: 40,\n        },\n      },\n    },\n  },\n} as const;\n"],"names":[],"mappings":"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"}

package/dist/controllers/PlaybackController.d.ts

@@ -1,5 +1,4 @@
 import { IPlaybackController, PlaybackOptions, IEventBus, PreviewHandle, TimeUs } from './types';
-import { GlobalAudioSession } from '../orchestrator/GlobalAudioSession';
 import { Orchestrator } from '../orchestrator';
 
 /**
@@ -43,7 +42,6 @@ export declare class PlaybackController implements IPlaybackController, PreviewH
     setLoop(loop: boolean): void;
     get duration(): TimeUs;
     get isPlaying(): boolean;
-    setAudioSession(session: GlobalAudioSession): void;
     resume(): void;
     on(event: string, handler: (payload: any) => void): void;
     off(event: string, handler: (payload: any) => void): void;
@@ -76,6 +74,5 @@ export declare class PlaybackController implements IPlaybackController, PreviewH
     private onCacheCover;
     private onModelSet;
     private setupEventListeners;
-    private ensureAudioContext;
 }
 //# sourceMappingURL=PlaybackController.d.ts.map

package/dist/controllers/PlaybackController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybackController.d.ts","sourceRoot":"","sources":["../../src/controllers/PlaybackController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEnB,eAAe,EACf,SAAS,EACT,aAAa,EACb,MAAM,EACP,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB,EAAE,aAAa;IAC3E,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,aAAa,CAA8B;IAGnD,aAAa,EAAE,MAAM,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAa;IAGhC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAmC;IAGvD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,oBAAoB,CAAS;IAGrC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAC9C,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe;IA0C/E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,IAAI,IAAI;YAYE,aAAa;IAoC3B,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IAuBN,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4FzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ7B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5B,IAAI,QAAQ,IAAI,MAAM,CAOrB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKlD,MAAM,IAAI,IAAI;IAId,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIxD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKzD,OAAO,CAAC,YAAY;IAqEpB,OAAO,CAAC,UAAU;IAiClB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;OAIG;YACW,iBAAiB;IA8CzB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCzC,uBAAuB;IA2DrC,OAAO,CAAC,SAAS;IAKjB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,UAAU,CAmBhB;IAEF,OAAO,CAAC,mBAAmB;YAKb,kBAAkB;CAOjC"}
+{"version":3,"file":"PlaybackController.d.ts","sourceRoot":"","sources":["../../src/controllers/PlaybackController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEnB,eAAe,EACf,SAAS,EACT,aAAa,EACb,MAAM,EACP,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB,EAAE,aAAa;IAC3E,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,aAAa,CAA8B;IAGnD,aAAa,EAAE,MAAM,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAa;IAGhC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,oBAAoB,CAAS;IAGrC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAC9C,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe;IA4C/E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,IAAI,IAAI;YAYE,aAAa;IAgC3B,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IAuBN,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0FzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ7B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5B,IAAI,QAAQ,IAAI,MAAM,CAOrB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAGD,MAAM,IAAI,IAAI;IAId,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIxD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKzD,OAAO,CAAC,YAAY;IAiEpB,OAAO,CAAC,UAAU;IAiClB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;OAIG;YACW,iBAAiB;IA0CzB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCzC,uBAAuB;IAyDrC,OAAO,CAAC,SAAS;IAKjB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,UAAU,CAiBhB;IAEF,OAAO,CAAC,mBAAmB;CAI5B"}

package/dist/controllers/PlaybackController.js

@@ -21,8 +21,8 @@ class PlaybackController {
   frameCount = 0;
   lastFrameTime = 0;
   fps = 0;
-  audioContext = null;
-  audioSession = null;
+  audioContext;
+  audioSession;
   // Buffering state
   isBuffering = false;
   currentSeekId = 0;
@@ -36,8 +36,10 @@ class PlaybackController {
   preheatInProgress = false;
   constructor(orchestrator, eventBus, options) {
     this.orchestrator = orchestrator;
+    this.audioSession = orchestrator.audioSession;
     this.eventBus = eventBus;
     this.canvas = options.canvas;
+    this.audioContext = new AudioContext();
     const model = orchestrator.compositionModel;
     const width = model?.renderConfig?.width || this.canvas.width || 720;
     const height = model?.renderConfig?.height || this.canvas.height || 1280;
@@ -69,25 +71,22 @@ class PlaybackController {
   play() {
     if (this.state === "playing") return;
     if (this.state === "ended") {
-      this.audioSession?.resetPlaybackStates();
+      this.audioSession.resetPlaybackStates();
     }
     this.wasPlayingBeforeSeek = true;
-    void this.startPlayback();
+    this.startPlayback();
   }
   async startPlayback() {
     const wasIdle = this.state === "idle";
     const seekId = this.currentSeekId;
+    this.state = "playing";
     try {
       await this.renderCurrentFrame(this.currentTimeUs);
       if (seekId !== this.currentSeekId) {
         return;
       }
-      this.state = "playing";
-      await this.ensureAudioContext();
       this.initWindow(this.currentTimeUs);
-      if (this.audioSession && this.audioContext) {
-        await this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);
-      }
+      await this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);
       this.startTimeUs = this.audioContext.currentTime * 1e6 - this.currentTimeUs / this.playbackRate;
       this.playbackLoop();
       this.eventBus.emit(MeframeEvent.PlaybackPlay);
@@ -105,7 +104,7 @@ class PlaybackController {
       cancelAnimationFrame(this.rafId);
       this.rafId = null;
     }
-    this.audioSession?.stopPlayback();
+    this.audioSession.stopPlayback();
     this.eventBus.emit(MeframeEvent.PlaybackPause);
   }
   stop() {
@@ -119,8 +118,8 @@ class PlaybackController {
     if (ctx && "clearRect" in ctx) {
       ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
     }
-    this.audioSession?.reset();
-    this.audioSession?.resetPlaybackStates();
+    this.audioSession.reset();
+    this.audioSession.resetPlaybackStates();
     this.eventBus.emit(MeframeEvent.PlaybackStop);
   }
   async seek(timeUs) {
@@ -130,8 +129,8 @@ class PlaybackController {
       cancelAnimationFrame(this.rafId);
       this.rafId = null;
     }
-    this.audioSession?.stopPlayback();
-    this.audioSession?.resetPlaybackStates();
+    this.audioSession.stopPlayback();
+    this.audioSession.resetPlaybackStates();
     const clamped = this.clampTime(timeUs);
     this.currentTimeUs = clamped;
     this.currentSeekId++;
@@ -157,9 +156,7 @@ class PlaybackController {
       if (seekId !== this.currentSeekId) {
         return;
       }
-      if (this.audioSession) {
-        await this.audioSession.ensureAudioForTime(clamped, { immediate: false });
-      }
+      await this.audioSession.ensureAudioForTime(clamped, { immediate: false });
       await this.orchestrator.getFrame(clamped, {
         immediate: false,
         preheat: true
@@ -192,18 +189,18 @@ class PlaybackController {
     this.playbackRate = rate;
     this.startTimeUs = this.audioContext.currentTime * 1e6 - currentTimeUs / rate;
     this.eventBus.emit(MeframeEvent.PlaybackRateChange, { rate });
-    this.audioSession?.setPlaybackRate(this.playbackRate);
+    this.audioSession.setPlaybackRate(this.playbackRate);
   }
   setVolume(volume) {
     this.volume = Math.max(0, Math.min(1, volume));
     this.eventBus.emit(MeframeEvent.PlaybackVolumeChange, { volume: this.volume });
-    this.audioSession?.setVolume(this.volume);
+    this.audioSession.setVolume(this.volume);
   }
   setMute(muted) {
     if (muted) {
-      this.audioSession?.stopPlayback();
-    } else if (this.state === "playing" && this.audioContext) {
-      this.audioSession?.startPlayback(this.currentTimeUs, this.audioContext);
+      this.audioSession.stopPlayback();
+    } else if (this.state === "playing") {
+      this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);
     }
   }
   setLoop(loop) {
@@ -219,9 +216,6 @@ class PlaybackController {
   get isPlaying() {
     return this.state === "playing";
   }
-  setAudioSession(session) {
-    this.audioSession = session;
-  }
   // Resume is just an alias for play
   resume() {
     this.play();
@@ -249,12 +243,8 @@ class PlaybackController {
       if (this.state !== "playing") {
         return;
       }
-      if (this.audioSession) {
-        await this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: true });
-      }
-      if (this.audioContext && this.audioSession) {
-        await this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);
-      }
+      await this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: true });
+      await this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);
       await this.renderCurrentFrame(this.currentTimeUs);
       if (this.state !== "playing") {
         return;
@@ -278,7 +268,7 @@ class PlaybackController {
       if (this.loop) {
         this.currentTimeUs = 0;
         this.startTimeUs = this.audioContext.currentTime * 1e6;
-        this.audioSession?.resetPlaybackStates();
+        this.audioSession.resetPlaybackStates();
         this.initWindow(0);
       } else {
         this.pause();
@@ -318,7 +308,7 @@ class PlaybackController {
     }
     if (distanceToWindowEnd > 0 && distanceToWindowEnd <= this.PREHEAT_DISTANCE) {
       this.preheatInProgress = true;
-      void this.preheatNextWindow();
+      this.preheatNextWindow();
     }
   }
   /**
@@ -341,11 +331,7 @@ class PlaybackController {
           this.orchestrator.preheatClipWindow(clip.id, clipWindowStart, clipWindowEnd, windowStart)
         );
       }
-      if (this.audioSession) {
-        preheatPromises.push(
-          this.audioSession.ensureAudioForTime(windowStart, { immediate: false })
-        );
-      }
+      preheatPromises.push(this.audioSession.ensureAudioForTime(windowStart, { immediate: false }));
       await Promise.all(preheatPromises);
       this.windowEnd = windowEnd;
     } catch (error) {
@@ -387,19 +373,17 @@ class PlaybackController {
     this.isBuffering = true;
     this.state = "buffering";
     this.eventBus.emit(MeframeEvent.PlaybackBuffering);
-    this.audioSession?.stopPlayback();
+    this.audioSession.stopPlayback();
     try {
       this.orchestrator.cacheManager.setWindow(timeUs);
       await this.orchestrator.getFrame(timeUs, { immediate: false });
-      await this.orchestrator.audioSession.ensureAudioForTime(timeUs, { immediate: false });
+      await this.audioSession.ensureAudioForTime(timeUs, { immediate: false });
       if (seekId !== this.currentSeekId) {
         return;
       }
       this.state = "playing";
       this.startTimeUs = this.audioContext.currentTime * 1e6 - timeUs / this.playbackRate;
-      if (this.audioContext) {
-        await this.audioSession?.startPlayback(timeUs, this.audioContext);
-      }
+      await this.audioSession.startPlayback(timeUs, this.audioContext);
       this.eventBus.emit(MeframeEvent.PlaybackPlay);
       if (!this.rafId) {
         this.playbackLoop();
@@ -445,21 +429,13 @@ class PlaybackController {
       fps: model.fps || 30,
       backgroundColor: model.renderConfig?.backgroundColor || "#000"
     });
-    if (this.audioSession) {
-      void this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: false });
-    }
-    void this.renderCurrentFrame(this.currentTimeUs);
+    this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: false });
+    this.renderCurrentFrame(this.currentTimeUs);
   };
   setupEventListeners() {
     this.eventBus.on(MeframeEvent.CacheCover, this.onCacheCover);
     this.eventBus.on(MeframeEvent.ModelSet, this.onModelSet);
   }
-  async ensureAudioContext() {
-    if (this.audioContext) {
-      return;
-    }
-    this.audioContext = new AudioContext();
-  }
 }
 export {
   PlaybackController