@viji-dev/core 0.5.5 → 0.5.7

package/dist/{index-DsJxKERc.js → index-CwwVLcjs.js}

@@ -100,6 +100,13 @@ class IFrameManager {
   iframeReadyPromise = null;
   iframeReadyResolver = null;
   iframeReadyRejecter = null;
+  /**
+   * 5s safety timer that rejects `iframeReadyPromise` if the inline-script
+   * never emits `iframe-ready` (e.g. blob script error). Promoted from
+   * closure-captured local to instance state so `destroy()` can clear it
+   * on cancellation (docs/14 rule 5).
+   */
+  iframeReadyTimeoutId = null;
   lockedOrigin = null;
   // Window message dispatch
   hostMessageListener = null;
@@ -159,6 +166,8 @@ class IFrameManager {
         this.iframeReadyResolver = resolve;
         this.iframeReadyRejecter = reject;
       });
+      this.iframeReadyPromise.catch(() => {
+      });
       this.installHostMessageListener(iframe);
       const iframeContent = this.generateIFrameHTML();
       const blob = new Blob([iframeContent], { type: "text/html" });
@@ -184,7 +193,8 @@ class IFrameManager {
         iframe.style.cssText = `position:absolute;top:0;left:0;width:100%;height:100%;border:none;${visibility}`;
         this.hostContainer.appendChild(iframe);
       }
-      const timeoutId = setTimeout(() => {
+      this.iframeReadyTimeoutId = setTimeout(() => {
+        this.iframeReadyTimeoutId = null;
         if (this.iframeReadyRejecter) {
           const r = this.iframeReadyRejecter;
           this.iframeReadyResolver = null;
@@ -192,11 +202,6 @@ class IFrameManager {
           r(new VijiCoreError("IFrame load timeout", "IFRAME_TIMEOUT"));
         }
       }, 5e3);
-      const originalResolver = this.iframeReadyResolver;
-      this.iframeReadyResolver = () => {
-        clearTimeout(timeoutId);
-        originalResolver();
-      };
       iframe.onerror = () => {
         if (this.iframeReadyRejecter) {
           this.iframeReadyRejecter(
@@ -323,6 +328,10 @@ class IFrameManager {
     switch (msg.type) {
       case "iframe-ready": {
         this.lockedOrigin = OPAQUE_ORIGIN;
+        if (this.iframeReadyTimeoutId !== null) {
+          clearTimeout(this.iframeReadyTimeoutId);
+          this.iframeReadyTimeoutId = null;
+        }
         if (this.iframeReadyResolver) {
           const r = this.iframeReadyResolver;
           this.iframeReadyResolver = null;
@@ -463,6 +472,16 @@ class IFrameManager {
    */
   destroy() {
     try {
+      if (this.iframeReadyTimeoutId !== null) {
+        clearTimeout(this.iframeReadyTimeoutId);
+        this.iframeReadyTimeoutId = null;
+      }
+      if (this.iframeReadyRejecter) {
+        const r = this.iframeReadyRejecter;
+        this.iframeReadyResolver = null;
+        this.iframeReadyRejecter = null;
+        r(new VijiCoreError("Initialization cancelled", "INITIALIZATION_CANCELLED"));
+      }
       if (this.iframe?.contentWindow && this.lockedOrigin) {
         try {
           this.postEnvelope({ type: "viji-terminate" });
@@ -670,6 +689,20 @@ class WorkerManager {
    */
   controlPort = null;
   onControlPortMessageBound = null;
+  /**
+   * Bootstrap-window cancellation state. The 10s `viji-ready` timer and
+   * the in-flight `vijiReady` rejecter are tracked on the instance so
+   * `destroy()` can cancel an in-progress bootstrap synchronously
+   * (clearing the timer + rejecting the awaiter with
+   * `INITIALIZATION_CANCELLED`). `isDestroyed` is the synchronous flag
+   * the outer catch in `createWorker` consults to distinguish a
+   * destroy-mid-init from a genuine bootstrap failure (e.g. the
+   * `postEnvelope` synchronous throw path, where no cancellation error
+   * was rejected through the awaiter).
+   */
+  bootstrapTimeoutId = null;
+  bootstrapReject = null;
+  isDestroyed = false;
   /**
    * Bootstraps the worker inside the iframe.
    *
@@ -723,7 +756,9 @@ class WorkerManager {
         }
       };
       const vijiReady = new Promise((resolve, reject) => {
-        const timeoutId = setTimeout(() => {
+        this.bootstrapReject = reject;
+        this.bootstrapTimeoutId = setTimeout(() => {
+          this.bootstrapTimeoutId = null;
           reject(
             new VijiCoreError(
               "viji-ready timeout",
@@ -732,15 +767,29 @@ class WorkerManager {
           );
         }, 1e4);
         this.iframeManager.onVijiReady(() => {
-          clearTimeout(timeoutId);
+          if (this.bootstrapTimeoutId !== null) {
+            clearTimeout(this.bootstrapTimeoutId);
+            this.bootstrapTimeoutId = null;
+          }
+          this.bootstrapReject = null;
           resolve();
         });
       });
-      this.iframeManager.postEnvelope(
-        bootstrap,
-        collectBootstrapTransferables(bootstrap)
-      );
-      await vijiReady;
+      vijiReady.catch(() => {
+      });
+      try {
+        this.iframeManager.postEnvelope(
+          bootstrap,
+          collectBootstrapTransferables(bootstrap)
+        );
+        await vijiReady;
+      } finally {
+        if (this.bootstrapTimeoutId !== null) {
+          clearTimeout(this.bootstrapTimeoutId);
+          this.bootstrapTimeoutId = null;
+        }
+        this.bootstrapReject = null;
+      }
       this.controlPort = this.iframeManager.getControlPort1();
       if (this.controlPort && this.onWorkerMessageBound) {
         const dispatcher = this.onWorkerMessageBound;
@@ -752,6 +801,15 @@ class WorkerManager {
       this.postMessage("set-scene-code", { sceneCode: this.sceneCode });
       this.isInitialized = true;
     } catch (error) {
+      if (error instanceof VijiCoreError && error.code === "INITIALIZATION_CANCELLED") {
+        throw error;
+      }
+      if (this.isDestroyed) {
+        throw new VijiCoreError(
+          "Initialization cancelled",
+          "INITIALIZATION_CANCELLED"
+        );
+      }
       throw new VijiCoreError(
         `Failed to create worker: ${error}`,
         "WORKER_CREATION_ERROR",
@@ -856,6 +914,16 @@ class WorkerManager {
    */
   destroy() {
     try {
+      this.isDestroyed = true;
+      if (this.bootstrapTimeoutId !== null) {
+        clearTimeout(this.bootstrapTimeoutId);
+        this.bootstrapTimeoutId = null;
+      }
+      if (this.bootstrapReject) {
+        const r = this.bootstrapReject;
+        this.bootstrapReject = null;
+        r(new VijiCoreError("Initialization cancelled", "INITIALIZATION_CANCELLED"));
+      }
       this.pendingMessages.forEach(({ timeout, reject }) => {
         clearTimeout(timeout);
         reject(new VijiCoreError("Worker destroyed", "WORKER_DESTROYED"));
@@ -1897,7 +1965,7 @@ class EssentiaOnsetDetection {
     this.initPromise = (async () => {
       try {
         const essentiaModule = await import("./essentia.js-core.es-DnrJE0uR.js");
-        const wasmModule = await import("./essentia-wasm.web-C58CPq4U.js").then((n) => n.e);
+        const wasmModule = await import("./essentia-wasm.web-htE1Skqw.js").then((n) => n.e);
         const EssentiaClass = essentiaModule.Essentia || essentiaModule.default?.Essentia || essentiaModule.default;
         let WASMModule = wasmModule.default || wasmModule.EssentiaWASM || wasmModule.default?.EssentiaWASM;
         if (!WASMModule) {
@@ -7422,6 +7490,7 @@ class AudioChannel {
     if (this.workletNode) {
       try {
         this.workletNode.port.onmessage = null;
+        this.workletNode.port.close();
         this.workletNode.disconnect();
       } catch (_) {
       }
@@ -7471,6 +7540,14 @@ class AudioSystem {
   onsetLogBuffer = [];
   // Debug logging control
   debugMode = false;
+  /**
+   * One-way lifecycle flag flipped at the top of `resetAudioState()`.
+   * Gates re-entry into `ensureAudioContext()` and the public stream-mutation
+   * entry points so an in-flight async caller (e.g. a worker RPC firing
+   * mid-teardown) cannot resurrect a fresh `AudioContext` after destroy
+   * has already nulled the field. AudioSystem is single-use after reset.
+   */
+  destroyed = false;
   // Diagnostic logger
   diagnosticLogger = new DiagnosticLogger();
   // Industry-grade audio analysis modules (4-layer architecture)
@@ -8056,6 +8133,7 @@ class AudioSystem {
    * Handle audio stream update for main stream (called from VijiCore)
    */
   handleAudioStreamUpdate(data) {
+    if (this.destroyed) return;
     try {
       if (data.audioStream) {
         this.setAudioStream(data.audioStream);
@@ -8072,6 +8150,9 @@ class AudioSystem {
    * Ensure the shared AudioContext is created and resumed.
    */
   async ensureAudioContext() {
+    if (this.destroyed) {
+      throw new Error("AudioSystem is destroyed");
+    }
     if (!this.audioContext) {
       this.audioContext = new AudioContext();
     }
@@ -8123,6 +8204,7 @@ class AudioSystem {
             if (ch.workletNode) {
               try {
                 ch.workletNode.port.onmessage = null;
+                ch.workletNode.port.close();
                 ch.workletNode.disconnect();
               } catch {
               }
@@ -8173,6 +8255,7 @@ class AudioSystem {
    * Set the main audio stream for analysis (preserves original public API surface).
    */
   async setAudioStream(audioStream) {
+    if (this.destroyed) return;
     this.disconnectMainStream();
     this.resetEssentiaBandHistories();
     await this.connectChannel(this.mainChannel, audioStream, true);
@@ -8444,8 +8527,14 @@ class AudioSystem {
   /**
    * Reset all audio state (called when destroying).
    * Disconnects all channels, closes AudioContext, resets all modules.
+   *
+   * Returns a Promise that resolves once `AudioContext.close()` has fully
+   * transitioned the context to `closed`. Callers tearing the system down
+   * (e.g. `VijiCore.destroy()`) MUST await this; otherwise Blink keeps the
+   * context alive in `Pending activities` and leaks ~4 MB per cycle.
    */
-  resetAudioState() {
+  async resetAudioState() {
+    this.destroyed = true;
     this.stopAnalysisLoop();
     this.stopStalenessTimer();
     this.stopIdleTicker();
@@ -8458,9 +8547,14 @@ class AudioSystem {
     this.mainChannel.audioState.isConnected = false;
     this.mainChannel.isAnalysisRunning = false;
     this.mainChannel.currentStream = null;
-    if (this.audioContext && this.audioContext.state !== "closed") {
-      this.audioContext.close();
-      this.audioContext = null;
+    const ctxToClose = this.audioContext;
+    this.audioContext = null;
+    if (ctxToClose && ctxToClose.state !== "closed") {
+      try {
+        await ctxToClose.close();
+      } catch (e) {
+        this.debugLog(`AudioContext.close() rejected: ${e?.message ?? e}`);
+      }
     }
     this.workletRegistered = false;
     this.onsetDetection.reset();
@@ -8482,6 +8576,7 @@ class AudioSystem {
    * @param stream The MediaStream to analyze
    */
   async addStream(streamIndex, stream) {
+    if (this.destroyed) return;
     if (this.additionalChannels.has(streamIndex)) {
       this.removeStream(streamIndex);
     }
@@ -8511,6 +8606,7 @@ class AudioSystem {
    * Mirrors video's reinitializeAdditionalCoordinators pattern.
    */
   async reinitializeAdditionalChannels(streams, baseIndex) {
+    if (this.destroyed) return;
     const toRemove = [];
     for (const [idx, ch] of this.additionalChannels) {
       if (idx >= baseIndex && idx < baseIndex + 100) {
@@ -8628,6 +8724,7 @@ class AudioSystem {
   // do when audio is active.
   // ─────────────────────────────────────────────────────────────────────────
   startIdleTicker() {
+    if (this.destroyed) return;
     if (this.idleTickerHandle !== null) return;
     if (typeof requestAnimationFrame === "undefined") return;
     this.idleTickerLastTime = performance.now();
@@ -8642,6 +8739,7 @@ class AudioSystem {
   }
   tickIdle(now) {
     this.idleTickerHandle = null;
+    if (this.destroyed) return;
     if (this.mainChannel.audioState.isConnected) return;
     const dtMs = Math.min(100, now - this.idleTickerLastTime);
     this.idleTickerLastTime = now;
@@ -10018,6 +10116,9 @@ class VijiCore {
     } catch (error) {
       this.isInitializing = false;
       await this.cleanup();
+      if (error instanceof VijiCoreError && (error.code === "INITIALIZATION_CANCELLED" || error.code === "INSTANCE_DESTROYED")) {
+        throw error;
+      }
       throw new VijiCoreError(
         `Failed to initialize VijiCore: ${error}`,
         "INITIALIZATION_ERROR",
@@ -11630,7 +11731,7 @@ class VijiCore {
     }
     this.deviceAudioStreamIndices.clear();
     if (this.audioSystem) {
-      this.audioSystem.resetAudioState();
+      await this.audioSystem.resetAudioState();
       this.audioSystem = null;
     }
     this.currentAudioStream = null;
@@ -11723,7 +11824,7 @@ function validateCoreStatePayload(state) {
   }
   return null;
 }
-const VERSION = "0.5.5";
+const VERSION = "0.5.7";
 export {
   AudioSystem as A,
   VERSION as V,
@@ -11731,4 +11832,4 @@ export {
   VijiCoreError as b,
   getDefaultExportFromCjs as g
 };
-//# sourceMappingURL=index-DsJxKERc.js.map
+//# sourceMappingURL=index-CwwVLcjs.js.map