@spatialwalk/avatarkit 1.0.0-beta.50 → 1.0.0-beta.52

package/CHANGELOG.md

@@ -5,6 +5,21 @@ 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.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
+- **Character Settings Update** - Fixed issue where cached Avatar instances would not update `characterSettings` in resources when `characterMeta` was updated. Now `resources.characterSettings` is synchronized when `characterMeta` changes, ensuring new `AvatarView` instances use the latest configuration.
+
+### ✨ New Features
+- **Post-Processing Config Enhancement** - Added `translation` and `eyePose` fields to `PostProcessingConfig` interface:
+  - `translation`: Position offset (x, y, z)
+  - `eyePose`: Eye pose offset with bias and weights (x, y, z, weightX, weightY, weightZ), applied to both left and right eyes
+
 ## [1.0.0-beta.50] - 2025-01-05
 
 ### 🔧 Performance Improvements

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

package/dist/{index-BHk2NbFu.js → index-DmQOISG3.js}

@@ -15,6 +15,9 @@ class Avatar {
   }
   updateCharacterMeta(newMeta) {
     this.characterMeta = newMeta;
+    if (this.resources.characterSettings !== newMeta.characterSettings) {
+      this.resources.characterSettings = newMeta.characterSettings;
+    }
   }
   getResources() {
     return this.resources;
@@ -7576,7 +7579,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-DTpMpES9.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-DZfQ6O5L.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -8966,7 +8969,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.50");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.52");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -11569,6 +11572,11 @@ class AvatarController {
       result2.rotation[1] += this.postProcessingConfig.rotation.y ?? 0;
       result2.rotation[2] += this.postProcessingConfig.rotation.z ?? 0;
     }
+    if (this.postProcessingConfig.translation && result2.translation) {
+      result2.translation[0] += this.postProcessingConfig.translation.x ?? 0;
+      result2.translation[1] += this.postProcessingConfig.translation.y ?? 0;
+      result2.translation[2] += this.postProcessingConfig.translation.z ?? 0;
+    }
     if (this.postProcessingConfig.neckPose && result2.neck_pose) {
       const biasX = this.postProcessingConfig.neckPose.x ?? 0;
       const biasY = this.postProcessingConfig.neckPose.y ?? 0;
@@ -11589,6 +11597,20 @@ class AvatarController {
       result2.jaw_pose[1] = result2.jaw_pose[1] * weight + biasY;
       result2.jaw_pose[2] = result2.jaw_pose[2] * weight + biasZ;
     }
+    if (this.postProcessingConfig.eyePose && result2.eyes_pose) {
+      const biasX = this.postProcessingConfig.eyePose.x ?? 0;
+      const biasY = this.postProcessingConfig.eyePose.y ?? 0;
+      const biasZ = this.postProcessingConfig.eyePose.z ?? 0;
+      const weightX = this.postProcessingConfig.eyePose.weightX ?? 1;
+      const weightY = this.postProcessingConfig.eyePose.weightY ?? 1;
+      const weightZ = this.postProcessingConfig.eyePose.weightZ ?? 1;
+      result2.eyes_pose[0] = result2.eyes_pose[0] * weightX + biasX;
+      result2.eyes_pose[1] = result2.eyes_pose[1] * weightY + biasY;
+      result2.eyes_pose[2] = result2.eyes_pose[2] * weightZ + biasZ;
+      result2.eyes_pose[3] = result2.eyes_pose[3] * weightX + biasX;
+      result2.eyes_pose[4] = result2.eyes_pose[4] * weightY + biasY;
+      result2.eyes_pose[5] = result2.eyes_pose[5] * weightZ + biasZ;
+    }
     if (this.postProcessingConfig.eyeBlink !== void 0 && result2.eyelid) {
       const blinkValue = this.postProcessingConfig.eyeBlink;
       result2.eyelid[0] = blinkValue;
@@ -11893,24 +11915,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;
@@ -11948,6 +11962,7 @@ class AvatarDownloader {
       }
     };
     const templateResources = {};
+    const cacheInfos = [];
     try {
       const promises = Object.entries(templateFiles).map(async ([key, { url, resourceName }]) => {
         updateProgress(resourceName, false);
@@ -11955,22 +11970,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) {
@@ -11986,21 +11997,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) {
@@ -12009,7 +12011,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;
@@ -12046,6 +12048,7 @@ class AvatarDownloader {
       }
     };
     const characterData = {};
+    const cacheInfos = [];
     const parallelStartTime = Date.now();
     const downloadPromises = filesToLoad.map(async ({ key, url, filename, optional }) => {
       updateProgress(filename, false);
@@ -12061,16 +12064,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) {
@@ -12092,6 +12087,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);
@@ -12100,7 +12097,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-BHk2NbFu.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-DmQOISG3.js";
 export {
   b as Avatar,
   c as AvatarController,

package/dist/types/index.d.ts

@@ -102,6 +102,11 @@ export interface PostProcessingConfig {
         y?: number;
         z?: number;
     };
+    translation?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
     neckPose?: {
         x?: number;
         y?: number;
@@ -116,6 +121,14 @@ export interface PostProcessingConfig {
         z?: number;
         weight?: number;
     };
+    eyePose?: {
+        x?: number;
+        y?: number;
+        z?: number;
+        weightX?: number;
+        weightY?: number;
+        weightZ?: number;
+    };
     eyeBlink?: number;
     expressionWeight?: number;
 }

package/package.json

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