@spatius/avatarkit 1.2.0-beta.2 → 1.2.0-beta.4

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0-beta.4] - 2026-06-28
+
+### Fixed
+- Avatars without body-fixation support no longer render a malformed body. Such avatars now correctly render the head only, matching pre-1.2.0-beta.3 behavior. Body-fixation avatars are unaffected.
+
+## [1.2.0-beta.3] - 2026-06-25
+
+### Added
+- New `ErrorCode.unsupportedAvatarAsset`. When loading an avatar whose asset requires a newer SDK, the load now fails fast with this error (surfaced via the existing `AvatarError` / `onError` path) instead of rendering incorrectly, prompting an SDK upgrade.
+
 ## [1.2.0-beta.2] - 2026-06-23
 
 ### Removed

package/dist/{StreamingAudioPlayer-CqzPGdy5.js → StreamingAudioPlayer-C4-OVsz9.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-BnubRaUR.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-BIjiLtOM.js";
 class StreamingAudioPlayer {
   // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {
@@ -75,7 +75,7 @@ class StreamingAudioPlayer {
         const context = event.target;
         if (context.state === "suspended" && this.isPlaying && !this.isPaused) {
           this.ensureAudioContextRunning().catch((err) => {
-            logger.errorWithError("[StreamingAudioPlayer] Failed to auto-resume AudioContext after external suspend:", err);
+            logger.error("[StreamingAudioPlayer] Failed to auto-resume AudioContext after external suspend:", err);
           });
         }
       };
@@ -142,7 +142,7 @@ class StreamingAudioPlayer {
           state: this.audioContext.state
         });
       } catch (err) {
-        logger.errorWithError("[StreamingAudioPlayer] Failed to resume AudioContext:", err);
+        logger.error("[StreamingAudioPlayer] Failed to resume AudioContext:", err);
         logEvent("audio_context_resume_failed", "error", {
           session_id: this.sessionId,
           reason: err instanceof Error ? err.message : String(err)
@@ -162,7 +162,7 @@ class StreamingAudioPlayer {
     }
     if (this.isPlaying && !this.isPaused && this.audioContext.state === "suspended") {
       this.ensureAudioContextRunning().catch((err) => {
-        logger.errorWithError("[StreamingAudioPlayer] Failed to ensure AudioContext running in addChunk:", err);
+        logger.error("[StreamingAudioPlayer] Failed to ensure AudioContext running in addChunk:", err);
       });
     }
     this.audioChunks.push({ data: pcmData, isLast });
@@ -177,13 +177,13 @@ class StreamingAudioPlayer {
       this.log("[StreamingAudioPlayer] autoContinue=true, auto-resuming playback");
       this.autoContinue = false;
       this.resume().catch((err) => {
-        logger.errorWithError("Failed to auto-resume playback:", err);
+        logger.error("Failed to auto-resume playback:", err);
       });
     }
     if (!this.isPlaying && this.autoStartEnabled && this.audioChunks.length > 0) {
       this.log("[StreamingAudioPlayer] Auto-starting playback from addChunk");
       this.startPlayback().catch((err) => {
-        logger.errorWithError("[StreamingAudioPlayer] Failed to start playback from addChunk:", err);
+        logger.error("[StreamingAudioPlayer] Failed to start playback from addChunk:", err);
       });
     } else if (this.isPlaying && !this.isPaused) {
       this.log("[StreamingAudioPlayer] Already playing, scheduling next chunk");
@@ -195,7 +195,7 @@ class StreamingAudioPlayer {
   /**
    * Start new session (stop current and start fresh)
    */
-  async startNewSession(audioChunks) {
+  async startNewSession(audioChunks, leadingSilenceMs = 0) {
     this.stop();
     this.sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
     this.audioChunks = [];
@@ -205,8 +205,14 @@ class StreamingAudioPlayer {
     this.pausedAudioContextTime = 0;
     this.autoContinue = false;
     this.log("Starting new session", {
-      chunks: audioChunks.length
+      chunks: audioChunks.length,
+      leadingSilenceMs
     });
+    if (leadingSilenceMs > 0) {
+      const silenceSamples = Math.floor(leadingSilenceMs / 1e3 * this.sampleRate) * this.channelCount;
+      const silencePcm = new Uint8Array(silenceSamples * 2);
+      this.addChunk(silencePcm, false);
+    }
     for (const chunk of audioChunks) {
       this.addChunk(chunk.data, chunk.isLast);
     }
@@ -261,7 +267,7 @@ class StreamingAudioPlayer {
     }
     if (this.audioContext.state === "suspended") {
       this.ensureAudioContextRunning().catch((err) => {
-        logger.errorWithError("[StreamingAudioPlayer] Failed to ensure AudioContext running in scheduleNextChunk:", err);
+        logger.error("[StreamingAudioPlayer] Failed to ensure AudioContext running in scheduleNextChunk:", err);
       });
     }
     const chunkIndex = this.scheduledChunks;
@@ -326,7 +332,7 @@ class StreamingAudioPlayer {
         activeSources: this.activeSources.size
       });
     } catch (err) {
-      logger.errorWithError("Failed to schedule audio chunk:", err);
+      logger.error("Failed to schedule audio chunk:", err);
       logEvent("schedule_chunk_failed", "error", {
         session_id: this.sessionId,
         reason: err instanceof Error ? err.message : String(err)
@@ -440,7 +446,7 @@ class StreamingAudioPlayer {
     this.isPaused = true;
     if (this.audioContext.state === "running") {
       this.audioContext.suspend().catch((err) => {
-        logger.errorWithError("Failed to suspend AudioContext:", err);
+        logger.error("Failed to suspend AudioContext:", err);
         this.isPaused = false;
       });
     }
@@ -462,7 +468,7 @@ class StreamingAudioPlayer {
       try {
         await this.audioContext.resume();
       } catch (err) {
-        logger.errorWithError("Failed to resume AudioContext:", err);
+        logger.error("Failed to resume AudioContext:", err);
         throw err;
       }
     }
@@ -525,14 +531,16 @@ class StreamingAudioPlayer {
    * Start playback manually (for delayed start scenarios)
    * This allows starting playback after transition animation completes
    */
-  play() {
+  async play() {
     if (this.isPlaying) {
       return;
     }
     this.autoStartEnabled = true;
-    this.startPlayback().catch((err) => {
-      logger.errorWithError("[StreamingAudioPlayer] Failed to start playback from play():", err);
-    });
+    try {
+      await this.startPlayback();
+    } catch (err) {
+      logger.error("[StreamingAudioPlayer] Failed to start playback from play():", err);
+    }
   }
   /**
    * Mark playback as ended