@spatialwalk/avatarkit 1.0.0-beta.51 → 1.0.0-beta.53

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.0.0-beta.53] - 2025-01-05
+
+### 🐛 Bugfix
+- **Race Condition Fix** - Fixed race condition where `startStreamingPlaybackInternal()` could be called multiple times when `yieldKeyframes` received data rapidly, causing audio chunks to be cleared and playback to freeze after transition animations. Added `isStartingPlayback` flag to prevent concurrent execution.
+
+## [1.0.0-beta.52] - 2025-01-05
+
+### 🔧 Performance Improvements
+- **Telemetry Optimization** - Consolidated resource download telemetry: removed individual `resource_download` events and added cache information (`cache_hit`, `cache_type`) to total duration metrics (`template_resources_load_measure` and `download_avatar_assets_total_measure`). This enables analysis of download times for cache misses while reducing telemetry overhead.
+
 ## [1.0.0-beta.51] - 2025-01-05
 
 ### 🐛 Bugfix

package/dist/{StreamingAudioPlayer-DXKLgGU3.js → StreamingAudioPlayer-DNLrXB1O.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, e as errorToMessage, l as logEvent, a as logger } from "./index-D2_q6K22.js";
+import { A as APP_CONFIG, e as errorToMessage, l as logEvent, a as logger } from "./index-CLKS00Ly.js";
 class StreamingAudioPlayer {
   constructor(options) {
     __publicField(this, "audioContext", null);

package/dist/core/AvatarController.d.ts

@@ -13,6 +13,7 @@ export declare class AvatarController {
         isLast: boolean;
     }>;
     protected isPlaying: boolean;
+    private isStartingPlayback;
     protected isConnected: boolean;
     protected currentState: AvatarState;
     private currentConversationId;

package/dist/{index-D2_q6K22.js → index-CLKS00Ly.js}

@@ -7579,7 +7579,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-DXKLgGU3.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-DNLrXB1O.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -8969,7 +8969,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.51");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.53");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -10619,6 +10619,7 @@ class AvatarController {
     __publicField(this, "currentKeyframes", []);
     __publicField(this, "pendingAudioChunks", []);
     __publicField(this, "isPlaying", false);
+    __publicField(this, "isStartingPlayback", false);
     __publicField(this, "isConnected", false);
     __publicField(this, "currentState", AvatarState.idle);
     __publicField(this, "currentConversationId", null);
@@ -10960,9 +10961,10 @@ class AvatarController {
       this.currentKeyframes.push(...keyframes);
     }
     this.emit("keyframesUpdate", this.currentKeyframes);
-    if (!this.isPlaying && this.pendingAudioChunks.length > 0 && this.currentKeyframes.length > 0) {
+    if (!this.isPlaying && !this.isStartingPlayback && this.pendingAudioChunks.length > 0 && this.currentKeyframes.length > 0) {
       this.startStreamingPlayback().catch((error) => {
         var _a;
+        this.isStartingPlayback = false;
         logger.error("[AvatarController] Failed to auto-start playback:", error);
         (_a = this.onError) == null ? void 0 : _a.call(this, new SPAvatarError("Failed to start playback", "PLAYBACK_START_FAILED"));
       });
@@ -11185,6 +11187,14 @@ class AvatarController {
   }
   async startStreamingPlaybackInternal() {
     var _a, _b, _c;
+    if (this.isPlaying) {
+      this.isStartingPlayback = false;
+      return;
+    }
+    if (this.isStartingPlayback) {
+      return;
+    }
+    this.isStartingPlayback = true;
     if (!this.animationPlayer) {
       this.animationPlayer = new AnimationPlayer();
     }
@@ -11192,6 +11202,7 @@ class AvatarController {
       try {
         await this.animationPlayer.createAndInitializeStreamingPlayer();
       } catch (error) {
+        this.isStartingPlayback = false;
         const message = error instanceof Error ? error.message : String(error);
         logger.error("[AvatarController] Failed to create streaming player:", message);
         logEvent("character_player", "error", {
@@ -11203,6 +11214,7 @@ class AvatarController {
       }
     }
     if (!this.currentKeyframes || this.currentKeyframes.length === 0) {
+      this.isStartingPlayback = false;
       logger.warn("[AvatarController] No animation data to play");
       return;
     }
@@ -11240,6 +11252,7 @@ class AvatarController {
       this.currentState = AvatarState.playing;
       (_a = this.onConversationState) == null ? void 0 : _a.call(this, this.mapToConversationState(AvatarState.playing));
       this.startPlaybackLoop();
+      this.isStartingPlayback = false;
       logEvent("character_player", "info", {
         avatar_id: this.avatar.id,
         event: "playback_started",
@@ -11250,6 +11263,7 @@ class AvatarController {
       logger.error("[AvatarController] Failed to start streaming playback:", message);
       (_c = this.onError) == null ? void 0 : _c.call(this, new SPAvatarError("Failed to start streaming playback", "INIT_FAILED"));
       this.isPlaying = false;
+      this.isStartingPlayback = false;
     }
   }
   checkPlaybackStuck(audioTime) {
@@ -11506,6 +11520,7 @@ class AvatarController {
   stopPlayback() {
     var _a;
     this.stopPlaybackLoop();
+    this.isStartingPlayback = false;
     if (this.animationPlayer) {
       this.animationPlayer.stop();
       const streamingPlayer = this.animationPlayer.getStreamingPlayer();
@@ -11915,24 +11930,16 @@ class AvatarDownloader {
       }
       updateProgress(resourceName, false);
       logger.log(`📥 Loading ${key} from API CDN: ${url}`);
-      const { data: buffer, cacheInfo } = await downloadResource(url, { resourceType: "template" });
+      const { data: buffer } = await downloadResource(url, { resourceType: "template" });
       logger.log(`✅ ${key} loaded: ${buffer.byteLength} bytes`);
       templateResources[key] = buffer;
       updateProgress(resourceName, true);
-      logEvent("resource_download", "info", {
-        resource_type: "template",
-        resource_name: resourceName,
-        cache_hit: cacheInfo.cacheHit,
-        cache_type: cacheInfo.cacheType,
-        pwa_cache_subtype: cacheInfo.pwaCacheSubtype,
-        transfer_size: cacheInfo.transferSize,
-        cdn_cache_status: cacheInfo.cdnCacheStatus
-      });
     });
     await Promise.all(promises);
     return templateResources;
   }
   async loadGlobalFlameResources(progressCallback = null) {
+    var _a;
     await PwaCacheManager.checkTemplateCacheVersion();
     const startTime = Date.now();
     const { cdnBaseUrl, resources } = APP_CONFIG.flame;
@@ -11970,6 +11977,7 @@ class AvatarDownloader {
       }
     };
     const templateResources = {};
+    const cacheInfos = [];
     try {
       const promises = Object.entries(templateFiles).map(async ([key, { url, resourceName }]) => {
         updateProgress(resourceName, false);
@@ -11977,22 +11985,18 @@ class AvatarDownloader {
         const { data: buffer, cacheInfo } = await downloadResource(url, { resourceType: "template" });
         logger.log(`✅ ${key} loaded: ${buffer.byteLength} bytes`);
         templateResources[key] = buffer;
+        cacheInfos.push(cacheInfo);
         updateProgress(resourceName, true);
-        logEvent("resource_download", "info", {
-          resource_type: "template",
-          resource_name: resourceName,
-          cache_hit: cacheInfo.cacheHit,
-          cache_type: cacheInfo.cacheType,
-          pwa_cache_subtype: cacheInfo.pwaCacheSubtype,
-          transfer_size: cacheInfo.transferSize,
-          cdn_cache_status: cacheInfo.cdnCacheStatus
-        });
       });
       await Promise.all(promises);
+      const cacheHit = cacheInfos.length > 0 && cacheInfos.every((info) => info.cacheHit);
+      const cacheType = ((_a = cacheInfos[0]) == null ? void 0 : _a.cacheType) || "none";
       const duration = Date.now() - startTime;
       logEvent("template_resources_load_measure", "info", {
         duration,
-        file_count: totalFiles
+        file_count: totalFiles,
+        cache_hit: cacheHit,
+        cache_type: cacheType
       });
       return templateResources;
     } catch (error) {
@@ -12008,21 +12012,12 @@ class AvatarDownloader {
     }
     try {
       logger.log(`📥 Loading camera info from: ${cameraUrl}`);
-      const { data: arrayBuffer, cacheInfo } = await downloadResource(cameraUrl, {
+      const { data: arrayBuffer } = await downloadResource(cameraUrl, {
         characterId: characterMeta.characterId ?? void 0,
         resourceType: "character"
       });
       const text = new TextDecoder().decode(arrayBuffer);
       const cameraSettings = JSON.parse(text);
-      logEvent("resource_download", "info", {
-        resource_type: "camera_settings",
-        resource_name: "camera.json",
-        cache_hit: cacheInfo.cacheHit,
-        cache_type: cacheInfo.cacheType,
-        pwa_cache_subtype: cacheInfo.pwaCacheSubtype,
-        transfer_size: cacheInfo.transferSize,
-        cdn_cache_status: cacheInfo.cdnCacheStatus
-      });
       logger.log("✅ Camera info loaded:", cameraSettings);
       return cameraSettings;
     } catch (error) {
@@ -12031,7 +12026,7 @@ class AvatarDownloader {
     }
   }
   async loadCharacterData(characterMeta, options) {
-    var _a, _b, _c, _d, _e2, _f, _g, _h, _i2;
+    var _a, _b, _c, _d, _e2, _f, _g, _h, _i2, _j;
     const { progressCallback = null } = options || {};
     const totalStartTime = Date.now();
     const shapeUrl = (_c = (_b = (_a = characterMeta.models) == null ? void 0 : _a.shape) == null ? void 0 : _b.resource) == null ? void 0 : _c.remote;
@@ -12068,6 +12063,7 @@ class AvatarDownloader {
       }
     };
     const characterData = {};
+    const cacheInfos = [];
     const parallelStartTime = Date.now();
     const downloadPromises = filesToLoad.map(async ({ key, url, filename, optional }) => {
       updateProgress(filename, false);
@@ -12083,16 +12079,8 @@ class AvatarDownloader {
         } else if (key === "idleAnimation") {
           characterData.idleAnimation = arrayBuffer;
         }
+        cacheInfos.push(cacheInfo);
         updateProgress(filename, true);
-        logEvent("resource_download", "info", {
-          resource_type: "character_asset",
-          resource_name: filename,
-          cache_hit: cacheInfo.cacheHit,
-          cache_type: cacheInfo.cacheType,
-          pwa_cache_subtype: cacheInfo.pwaCacheSubtype,
-          transfer_size: cacheInfo.transferSize,
-          cdn_cache_status: cacheInfo.cdnCacheStatus
-        });
         return { key, success: true, size: arrayBuffer.byteLength };
       } catch (error) {
         if (!optional) {
@@ -12114,6 +12102,8 @@ class AvatarDownloader {
       });
       throw new Error(reason);
     }
+    const cacheHit = cacheInfos.length > 0 && cacheInfos.every((info) => info.cacheHit);
+    const cacheType = ((_j = cacheInfos[0]) == null ? void 0 : _j.cacheType) || "none";
     const totalSize = Object.values(characterData).reduce((sum, buffer) => {
       return sum + (buffer ? buffer.byteLength : 0);
     }, 0);
@@ -12122,7 +12112,9 @@ class AvatarDownloader {
       total_duration: totalDuration,
       parallel_duration: parallelDuration,
       total_size: totalSize,
-      file_count: filesToLoad.length
+      file_count: filesToLoad.length,
+      cache_hit: cacheHit,
+      cache_type: cacheType
     });
     return characterData;
   }

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-D2_q6K22.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-CLKS00Ly.js";
 export {
   b as Avatar,
   c as AvatarController,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.51",
+  "version": "1.0.0-beta.53",
   "packageManager": "pnpm@10.18.2",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",