@myned-ai/avatar-chat-widget 0.11.0 → 0.13.0

package/dist/avatar-chat-widget.js

@@ -1790,7 +1790,15 @@ const _AudioContextManagerImpl = class _AudioContextManagerImpl {
     return _AudioContextManagerImpl._instance;
   }
   /**
-   * Get or create the shared AudioContext
+   * Set the sample rate for when the AudioContext is eventually created.
+   * Call this early (e.g., from server config) before any audio session starts.
+   */
+  setSampleRate(sampleRate) {
+    this._sampleRate = sampleRate;
+  }
+  /**
+   * Get the shared AudioContext. Creates lazily if needed.
+   * Prefer ensureAudioReady() from user-gesture handlers to guarantee iOS unlock.
    * @param sampleRate Optional sample rate (only used on first creation)
    */
   getContext(sampleRate) {
@@ -1800,6 +1808,33 @@ const _AudioContextManagerImpl = class _AudioContextManagerImpl {
     if (sampleRate) {
       this._sampleRate = sampleRate;
     }
+    return this.createContext();
+  }
+  /**
+   * Single idempotent entry point: create (if needed) + resume AudioContext.
+   * Call this synchronously from any user-gesture handler (pointerdown, touchend,
+   * click, keydown) to guarantee iOS audio unlock.
+   */
+  ensureAudioReady(source) {
+    const tag = source ? `[${source}]` : "";
+    if (!this._context) {
+      this.createContext();
+    }
+    const ctx = this._context;
+    if (!ctx) return;
+    if (ctx.state === "running") return;
+    log$c.debug(`${tag} Attempting AudioContext unlock, current state=${ctx.state}`);
+    ctx.resume().then(() => {
+      log$c.info(`${tag} AudioContext unlocked via ensureAudioReady`);
+      this.removeResumeListeners();
+    }).catch((error2) => {
+      log$c.warn(`${tag} ensureAudioReady resume failed (will retry on next gesture):`, error2);
+    });
+  }
+  /**
+   * Internal: create the AudioContext and wire up fallback document listeners.
+   */
+  createContext() {
     try {
       const AudioContextClass = window.AudioContext || window.webkitAudioContext;
       if (!AudioContextClass) {
@@ -1808,12 +1843,16 @@ const _AudioContextManagerImpl = class _AudioContextManagerImpl {
       this._context = new AudioContextClass({
         sampleRate: this._sampleRate,
         latencyHint: "interactive"
-        // Optimize for real-time
       });
       log$c.info(`AudioContext created: sampleRate=${this._context.sampleRate}, state=${this._context.state}`);
-      this.setupResumeListener();
+      if (this._context.state !== "running") {
+        this.setupResumeListener();
+      }
       this._context.onstatechange = () => {
         log$c.debug(`AudioContext state changed: ${this._context?.state}`);
+        if (this._context?.state === "running") {
+          this.removeResumeListeners();
+        }
       };
     } catch (error2) {
       errorBoundary.handleError(error2, "audio-context-manager");
@@ -1822,26 +1861,29 @@ const _AudioContextManagerImpl = class _AudioContextManagerImpl {
     return this._context;
   }
   /**
-   * Setup a single click listener to resume AudioContext (browser policy)
-   * This replaces multiple listeners scattered across services
+   * Fallback document-level listeners for audio unlock.
+   * These are a safety net — primary unlock happens via ensureAudioReady()
+   * called from widget gesture handlers.
    */
   setupResumeListener() {
     if (this._isResumeListenerAdded) {
       return;
     }
-    this._listenerEvents = ["click", "touchstart", "keydown"];
-    this._interactionHandler = async () => {
-      this.removeResumeListeners();
-      await this.resume();
+    this._listenerEvents = ["pointerdown", "touchend", "keydown"];
+    this._interactionHandler = () => {
+      if (this._context && this._context.state !== "running") {
+        this._context.resume().catch(() => {
+        });
+      }
     };
     this._listenerEvents.forEach((event) => {
-      document.addEventListener(event, this._interactionHandler, { once: true, passive: true });
+      document.addEventListener(event, this._interactionHandler, { passive: true });
     });
     this._isResumeListenerAdded = true;
-    log$c.debug("Audio resume listeners added");
+    log$c.debug("Audio resume fallback listeners added");
   }
   /**
-   * Remove resume listeners (called after first interaction or on cleanup)
+   * Remove resume listeners (only after context is running, or on cleanup)
    */
   removeResumeListeners() {
     if (this._interactionHandler) {
@@ -1850,6 +1892,8 @@ const _AudioContextManagerImpl = class _AudioContextManagerImpl {
       });
       this._interactionHandler = null;
       this._listenerEvents = [];
+      this._isResumeListenerAdded = false;
+      log$c.debug("Audio resume fallback listeners removed");
     }
   }
   /**
@@ -1870,6 +1914,7 @@ const _AudioContextManagerImpl = class _AudioContextManagerImpl {
       try {
         await this._context.resume();
         log$c.info("AudioContext resumed successfully");
+        this.removeResumeListeners();
       } catch (error2) {
         log$c.error("Failed to resume AudioContext:", error2);
         errorBoundary.handleError(error2, "audio-context-manager");
@@ -1998,7 +2043,7 @@ class AudioOutput {
     this.chunkDurationMs = 100;
     this.audioBuffer = new CircularBuffer(CONFIG.audio.output.maxBufferFrames);
     this.adaptiveBuffer = new AdaptiveBuffer(100, 50, 500);
-    AudioContextManager.getContext(this.sampleRate);
+    AudioContextManager.setSampleRate(this.sampleRate);
   }
   /**
    * Get the shared AudioContext
@@ -2011,6 +2056,7 @@ class AudioOutput {
    */
   setDefaultSampleRate(sampleRate) {
     this.sampleRate = sampleRate;
+    AudioContextManager.setSampleRate(sampleRate);
     log$b.info(`Output sample rate set to ${sampleRate}Hz`);
   }
   startSession(sessionId, sampleRate) {
@@ -2024,6 +2070,7 @@ class AudioOutput {
     this.isPlaying = false;
     this.nextPlayTime = 0;
     AudioContextManager.resume().catch(() => {
+      log$b.warn("AudioContext resume failed in startSession — will retry on next user gesture");
     });
   }
   addAudioChunk(data, timestamp) {
@@ -2535,7 +2582,7 @@ class SyncPlayback {
     this.floatBuffer = new Float32Array(this.maxSamplesPerFrame);
     this.visibilityHandler = this.handleVisibilityChange.bind(this);
     document.addEventListener("visibilitychange", this.visibilityHandler);
-    AudioContextManager.getContext(this.sampleRate);
+    AudioContextManager.setSampleRate(this.sampleRate);
   }
   /**
    * Get the shared AudioContext
@@ -2572,6 +2619,7 @@ class SyncPlayback {
    */
   setDefaultSampleRate(sampleRate) {
     this.sampleRate = sampleRate;
+    AudioContextManager.setSampleRate(sampleRate);
     log$8.info(`SyncPlayback sample rate set to ${sampleRate}Hz`);
   }
   startSession(sessionId, sampleRate) {
@@ -2585,6 +2633,7 @@ class SyncPlayback {
       this.sampleRate = sampleRate;
     }
     AudioContextManager.resume().catch(() => {
+      log$8.warn("AudioContext resume failed in startSession — will retry on next user gesture");
     });
     try {
       const ctx = this.audioContext;
@@ -5871,8 +5920,18 @@ class AvatarChatElement extends HTMLElement {
    * Setup UI event listeners
    */
   setupUIEvents() {
+    const unlockAudio = (e) => {
+      AudioContextManager.ensureAudioReady(`widget:${e.type}`);
+    };
+    this.shadow.addEventListener("pointerdown", unlockAudio, { capture: true, passive: true });
+    this.shadow.addEventListener("touchend", unlockAudio, { capture: true, passive: true });
+    this.shadow.addEventListener("click", unlockAudio, { capture: true, passive: true });
+    this.shadow.addEventListener("focusin", unlockAudio, { capture: true });
     const minimizeBtn = this.shadow.getElementById("minimizeBtn");
-    minimizeBtn?.addEventListener("click", () => this.collapse());
+    minimizeBtn?.addEventListener("click", () => {
+      AudioContextManager.ensureAudioReady();
+      this.collapse();
+    });
     const chatInput = this.shadow.getElementById("chatInput");
     const inputControls = this.shadow.querySelector(".chat-input-controls");
     if (chatInput && inputControls) {
@@ -5884,6 +5943,7 @@ class AvatarChatElement extends HTMLElement {
         }
       });
       chatInput.addEventListener("focus", () => {
+        AudioContextManager.ensureAudioReady();
         const root = this.shadow.querySelector(".widget-root");
         if (root) root.classList.add("input-focused");
       });
@@ -5914,6 +5974,7 @@ class AvatarChatElement extends HTMLElement {
       const handleChipClick = (e) => {
         const target = e.target;
         if (target.classList.contains("suggestion-chip")) {
+          AudioContextManager.ensureAudioReady();
           this.markHasMessages();
           hideSuggestions();
           const text = target.textContent;
@@ -5927,11 +5988,13 @@ class AvatarChatElement extends HTMLElement {
       quickReplies?.addEventListener("click", handleChipClick);
       avatarSuggestions?.addEventListener("click", handleChipClick);
       micBtn?.addEventListener("click", () => {
+        AudioContextManager.ensureAudioReady();
         this.markHasMessages();
         hideSuggestions();
       });
       chatInput.addEventListener("keydown", (e) => {
         if (e.key === "Enter") {
+          AudioContextManager.ensureAudioReady();
           this.markHasMessages();
           hideSuggestions();
           setTimeout(() => {
@@ -6065,6 +6128,7 @@ class AvatarChatElement extends HTMLElement {
       return;
     }
     expandBtn.addEventListener("click", () => {
+      AudioContextManager.ensureAudioReady();
       const isExpanded = widgetRoot.classList.toggle("expanded");
       expandBtn.setAttribute("aria-label", isExpanded ? "Collapse chat" : "Expand chat");
       expandBtn.setAttribute("title", isExpanded ? "Collapse" : "Expand");
@@ -6082,6 +6146,7 @@ class AvatarChatElement extends HTMLElement {
       return;
     }
     viewModeBtn.addEventListener("click", (e) => {
+      AudioContextManager.ensureAudioReady();
       e.stopPropagation();
       if (this.drawerController) {
         const currentState = this.drawerController.getState();
@@ -6133,6 +6198,7 @@ class AvatarChatElement extends HTMLElement {
    */
   async expand() {
     if (!this._isCollapsed) return;
+    AudioContextManager.ensureAudioReady("widget:expand");
     this._isCollapsed = false;
     this.classList.remove("collapsed");
     this.style.width = `${this.config.width}px`;