@spatialwalk/avatarkit 1.0.0-beta.60 → 1.0.0-beta.62

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.0-beta.62] - 2026-01-14
+
+### ✨ New Features
+- **Bezier Curve Transition Animation** - Implemented Bezier curve easing functions for smoother transitions
+  - Added Bezier curve interpolation with different curves for different facial components (jaw, expression, eye, neck, global)
+  - Replaced linear interpolation with Bezier curve interpolation for more natural animation
+  - Split transition duration into start (200ms) and end (1600ms) for different transition types
+
+### 🔧 Improvements
+- **Transition API Enhancement** - Updated `generateTransitionFromIdle()` to support both start and end transitions
+  - Added `transitionType` parameter: `'start'` for Idle -> Flame, `'end'` for Flame -> Idle
+  - Removed deprecated linear interpolation code and unused easing functions
+
+## [1.0.0-beta.61] - 2026-01-14
+
+### 🔧 Improvements
+- **Telemetry Events Update** - Updated telemetry events with new parameters and structure
+  - `sdk_initialized`: Added `env` and `dsm` parameters
+  - `driving_service_latency`: Replaced `driving_latency`, now tracks `tap_0`, `tap_1`, `tap_2`, `tap_f` timestamps (Number type, milliseconds)
+  - `avatar_active`: New event for avatar view activity tracking with `env` and `dsm` parameters, reported on first render and every 10 minutes
+- **Heartbeat Refactoring** - Removed `HeartbeatManager`, integrated heartbeat functionality into `NetworkLayer` (driving service heartbeat) and `AvatarView` (avatar active heartbeat)
+
 ## [1.0.0-beta.60] - 2026-01-14
 
 ### 🔧 Configuration Changes
@@ -240,11 +262,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `LogLevel.warning` - Warning and error logs
   - `LogLevel.all` - All logs (default)
 - **Standardized CLS Logging Events** - All CLS logging events now use standardized field names for better querying
-  - Standard events: `sdk_initialized`, `send_audio_failed`, `message_error`, `heartbeat_failed`, `service_restarted`, `session_token_invalid`, `session_token_expired`, `yield_animation_failed`, `fetch_avatar_metadata_failed`, `download_avatar_assets_failed`
+  - Standard events: `sdk_initialized`, `send_audio_failed`, `message_error`, `heartbeat_failed`, `service_restarted`, `session_token_invalid`, `session_token_expired`, `yield_animation_failed`, `fetch_avatar_metadata_failed`, `download_avatar_assets_failed`, `avatar_active`
   - Standard fields: `req_id`, `con_id`, `avatar_id`, `description`
-- **End-to-End Latency Tracking** - Added `driving_latency` event to track latency metrics for both SDK and Host modes
-  - Tracks: `start`, `tap2`, `tap4`, `end`, `first_frame` timestamps
-  - Automatically reported at key moments during audio/animation processing
+- **End-to-End Latency Tracking** - Added `driving_service_latency` event to track latency metrics for both SDK and Host modes
+  - Tracks: `tap_0`, `tap_1`, `tap_2`, `tap_f` timestamps (Number type, milliseconds)
+  - Automatically reported once per conversation when first frame is received
 
 ### 🔧 Improvements
 - **CLS Configuration Alignment** - Updated CLS endpoints and Topic IDs to match iOS SDK configuration

package/README.md

@@ -1,4 +1,4 @@
-# SPAvatarSDK SDK
+# AvatarKit SDK
 
 Real-time virtual avatar rendering SDK based on 3D Gaussian Splatting, supporting audio-driven animation rendering and high-quality 3D rendering.
 
@@ -97,11 +97,7 @@ avatarView.avatarController.yieldFramesData(animationDataArray, conversationId)
 
 ### Complete Examples
 
-Check the example code in the GitHub repository for complete usage flows for both modes.
-
-**Example Project:** [AvatarSDK-Web-Demo](https://github.com/spatialwalk/AvatarSDK-Web-Demo)
-
-This repository contains complete examples for Vanilla JS, Vue 3, and React, demonstrating:
+This SDK supports two usage modes:
 - SDK mode: Real-time audio input with automatic animation data reception
 - Host mode: Custom data sources with manual audio/animation data management
 
@@ -652,6 +648,5 @@ Issues and Pull Requests are welcome!
 ## 📞 Support
 
 For questions, please contact:
-- Email: support@spavatar.com
+- Email: code@spatialwalk.net
 - Documentation: https://docs.spatialreal.ai
-- GitHub: https://github.com/spavatar/sdk

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

package/dist/core/AvatarController.d.ts

@@ -76,5 +76,5 @@ export declare class AvatarController {
     private registerEventListener;
     protected emit(event: string, data?: any): void;
     private applyPostProcessingToParams;
-    private reportDrivingLatency;
+    private reportDrivingServiceLatency;
 }

package/dist/core/AvatarView.d.ts

@@ -22,12 +22,15 @@ export declare class AvatarView {
     private currentFPS;
     private transitionKeyframes;
     private transitionStartTime;
-    private readonly transitionDurationMs;
+    private readonly startTransitionDurationMs;
+    private readonly endTransitionDurationMs;
     private cachedIdleFirstFrame;
     private idleCurrentFrameIndex;
     private characterHandle;
     private characterId;
     private isPureRenderingMode;
+    private avatarActiveTimer;
+    private readonly AVATAR_ACTIVE_INTERVAL;
     private alignFlamePair;
     private generateAndAlignTransitionFrames;
     private getCachedIdleFirstFrame;
@@ -59,7 +62,7 @@ export declare class AvatarView {
     private stopRealtimeRendering;
     dispose(): void;
     renderFlame(flame: Flame, enableIdleRendering?: boolean): Promise<void>;
-    generateTransitionFromIdle(toFlame: Flame, frameCount: number): Promise<Flame[]>;
+    generateTransitionFromIdle(toFlame: Flame, frameCount: number, transitionType?: 'start' | 'end'): Promise<Flame[]>;
     private rerenderCurrentFrameWithNewCamera;
     private handleResize;
     get transform(): {
@@ -72,4 +75,7 @@ export declare class AvatarView {
         y: number;
         scale: number;
     });
+    private reportAvatarActive;
+    private startAvatarActiveHeartbeat;
+    private stopAvatarActiveHeartbeat;
 }

package/dist/{index-D9nprBw2.js → index-Bhjn1nq3.js}

@@ -7387,7 +7387,19 @@ let isInitialized = false;
 const SDK_POSTHOG_INSTANCE_NAME = "spatialwalk-posthog";
 let sdkPosthogInstance = null;
 const eventQueue = [];
+const FILTERED_HOSTNAMES = ["localhost", "127.0.0.1", "0.0.0.0"];
+function shouldFilterHostname() {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  const hostname = window.location.hostname;
+  return FILTERED_HOSTNAMES.includes(hostname);
+}
 function initializePostHog(environment, version) {
+  if (shouldFilterHostname()) {
+    logger.log(`[PostHog] Tracking disabled due to filtered hostname: ${window.location.hostname}`);
+    return;
+  }
   const { host, apiKey, disableCompression } = getPostHogConfig();
   if (isInitialized) {
     logger.log("[PostHog] Already initialized, skipping");
@@ -7478,6 +7490,9 @@ function flushEventQueue() {
   }, 0);
 }
 function trackEvent(event, level = "info", contents = {}) {
+  if (shouldFilterHostname()) {
+    return;
+  }
   const instance = getSdkPosthogInstance();
   if (!instance) {
     eventQueue.push({ event, level, contents });
@@ -7609,7 +7624,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CH89JZHk.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-BWsAt_s7.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -7828,95 +7843,6 @@ function isFirstUse() {
     return false;
   }
 }
-class HeartbeatManager {
-  constructor() {
-    __publicField(this, "heartbeatTimer", null);
-    __publicField(this, "visibilityChangeHandler", null);
-    __publicField(this, "isInitialized", false);
-    __publicField(this, "currentEnvironment", null);
-    __publicField(this, "currentAppId", null);
-    __publicField(this, "failureCount", 0);
-  }
-  start(environment) {
-    if (this.isInitialized) {
-      return;
-    }
-    this.isInitialized = true;
-    this.currentEnvironment = environment;
-    this.currentAppId = idManager.getAppId();
-    this.startHeartbeatTimer();
-    this.setupVisibilityListener();
-    logger.log("[HeartbeatManager] Started");
-  }
-  stop() {
-    if (!this.isInitialized) {
-      return;
-    }
-    this.stopHeartbeatTimer();
-    this.removeVisibilityListener();
-    this.isInitialized = false;
-    this.currentEnvironment = null;
-    this.currentAppId = null;
-    logger.log("[HeartbeatManager] Stopped");
-  }
-  startHeartbeatTimer() {
-    if (this.heartbeatTimer !== null) {
-      return;
-    }
-    const HEARTBEAT_INTERVAL = 12e4;
-    this.heartbeatTimer = window.setInterval(() => {
-      if (this.isInitialized && typeof document !== "undefined" && document.visibilityState === "visible") {
-        this.reportHeartbeat();
-      }
-    }, HEARTBEAT_INTERVAL);
-  }
-  stopHeartbeatTimer() {
-    if (this.heartbeatTimer !== null) {
-      clearInterval(this.heartbeatTimer);
-      this.heartbeatTimer = null;
-    }
-  }
-  reportHeartbeat(additionalData) {
-    try {
-      trackEvent("sdk_heartbeat", "info", {
-        appId: this.currentAppId || idManager.getAppId(),
-        environment: this.currentEnvironment,
-        ...additionalData
-      });
-      this.failureCount = 0;
-    } catch (error) {
-      this.failureCount++;
-      logger.warn(`[HeartbeatManager] Heartbeat failed (count: ${this.failureCount})`);
-      if (this.failureCount >= 3) {
-        trackEvent("heartbeat_failed", "warning", {
-          con_id: idManager.getConnectionId() || "",
-          description: `Heartbeat failed ${this.failureCount} times`
-        });
-        this.failureCount = 0;
-      }
-    }
-  }
-  setupVisibilityListener() {
-    if (typeof window === "undefined" || typeof document === "undefined") {
-      return;
-    }
-    this.removeVisibilityListener();
-    this.visibilityChangeHandler = () => {
-      if (document.visibilityState === "visible" && this.isInitialized) {
-        this.reportHeartbeat({ resumed: true });
-      }
-    };
-    document.addEventListener("visibilitychange", this.visibilityChangeHandler);
-  }
-  removeVisibilityListener() {
-    if (typeof window === "undefined" || typeof document === "undefined" || !this.visibilityChangeHandler) {
-      return;
-    }
-    document.removeEventListener("visibilitychange", this.visibilityChangeHandler);
-    this.visibilityChangeHandler = null;
-  }
-}
-const heartbeatManager = new HeartbeatManager();
 class AvatarCoreMemoryManager {
   constructor(wasmModule) {
     __publicField(this, "module");
@@ -8869,14 +8795,16 @@ class AvatarSDK {
       await this.initializeWASMModule();
       await this.initializeTemplateResources();
       this._isInitialized = true;
-      logEvent("sdk_initialized", "info", {});
+      logEvent("sdk_initialized", "info", {
+        env: configuration.environment,
+        dsm: configuration.drivingServiceMode || DrivingServiceMode.sdk
+      });
       if (isFirstUse()) {
         logEvent("sdk_first_use", "info", {
           appId: idManager.getAppId(),
           environment: (_a = this._configuration) == null ? void 0 : _a.environment
         });
       }
-      heartbeatManager.start(this._configuration.environment);
       logger.log(`[AvatarSDK] Successfully initialized`);
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
@@ -8983,7 +8911,6 @@ class AvatarSDK {
       return;
     }
     try {
-      heartbeatManager.stop();
       if (this._avatarCore) {
         this._avatarCore.release();
         this._avatarCore = null;
@@ -9034,7 +8961,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.60");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.62");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -10362,6 +10289,10 @@ class NetworkLayer {
     __publicField(this, "audioMetrics", this.createAudioMetrics());
     __publicField(this, "isFallbackMode", false);
     __publicField(this, "isConnecting", false);
+    __publicField(this, "heartbeatTimer", null);
+    __publicField(this, "visibilityChangeHandler", null);
+    __publicField(this, "heartbeatFailureCount", 0);
+    __publicField(this, "HEARTBEAT_INTERVAL", 12e4);
     this.dataController = dataController;
     const config = AvatarSDK.getEnvironmentConfig();
     this.wsClient = new AnimationWebSocketClient({
@@ -10372,6 +10303,7 @@ class NetworkLayer {
       clientId: idManager.getClientId()
     });
     this.setupWebSocketListeners();
+    this.startHeartbeatCheck();
   }
   getAudioBytesPerSecond() {
     const audioFormat = AvatarSDK.getAudioFormat();
@@ -10435,28 +10367,16 @@ class NetworkLayer {
       });
     }
     const metrics = this.audioMetrics;
-    let shouldReportMetrics = false;
     if (metrics.startTimestamp === 0) {
       metrics.startTimestamp = Date.now();
-      metrics.cachedStartTimestamp = String(metrics.startTimestamp);
-      shouldReportMetrics = true;
     }
     metrics.accumulatedBytes += audioData.byteLength;
     const currentDuration = metrics.accumulatedBytes / this.getAudioBytesPerSecond();
+    if (currentDuration >= 1 && metrics.tap1Timestamp === 0) {
+      metrics.tap1Timestamp = Date.now();
+    }
     if (currentDuration >= 2 && metrics.tap2Timestamp === 0) {
       metrics.tap2Timestamp = Date.now();
-      metrics.cachedTap2Timestamp = String(metrics.tap2Timestamp);
-      shouldReportMetrics = true;
-    }
-    if (currentDuration >= 4 && metrics.tap4Timestamp === 0) {
-      metrics.tap4Timestamp = Date.now();
-      metrics.cachedTap4Timestamp = String(metrics.tap4Timestamp);
-      shouldReportMetrics = true;
-    }
-    if (isLast && metrics.endTimestamp === 0) {
-      metrics.endTimestamp = Date.now();
-      metrics.cachedEndTimestamp = String(metrics.endTimestamp);
-      shouldReportMetrics = true;
     }
     if (audioData.byteLength === 0 && !isLast) {
       logger.warn("[NetworkLayer] Warning: sending empty audio data (size=0, end=false)");
@@ -10479,15 +10399,13 @@ class NetworkLayer {
       });
       return;
     }
-    if (shouldReportMetrics && this.currentConversationId) {
-      this.reportDrivingLatency(this.currentConversationId);
-    }
   }
   disconnect() {
     this.isFallbackMode = false;
     this.isConnecting = false;
     this.wsClient.removeAllListeners();
     this.wsClient.disconnect();
+    this.stopHeartbeatCheck();
     idManager.clearConnectionId();
     this.currentConversationId = null;
   }
@@ -10582,9 +10500,9 @@ class NetworkLayer {
       if (!this.audioMetrics.didRecvFirstFlame) {
         this.audioMetrics.didRecvFirstFlame = true;
         this.audioMetrics.recvFirstFlameTimestamp = Date.now();
-        this.audioMetrics.cachedFirstFrameTimestamp = String(this.audioMetrics.recvFirstFlameTimestamp);
-        if (this.currentConversationId) {
-          this.reportDrivingLatency(this.currentConversationId);
+        if (this.currentConversationId && !this.audioMetrics.didReportLatency) {
+          this.reportDrivingServiceLatency(this.currentConversationId);
+          this.audioMetrics.didReportLatency = true;
         }
       }
     } else {
@@ -10644,36 +10562,94 @@ class NetworkLayer {
     return {
       accumulatedBytes: 0,
       startTimestamp: 0,
+      tap1Timestamp: 0,
       tap2Timestamp: 0,
-      tap4Timestamp: 0,
-      endTimestamp: 0,
       recvFirstFlameTimestamp: 0,
       didRecvFirstFlame: false,
-      cachedStartTimestamp: "",
-      cachedTap2Timestamp: "",
-      cachedTap4Timestamp: "",
-      cachedEndTimestamp: "",
-      cachedFirstFrameTimestamp: ""
+      didReportLatency: false
     };
   }
   resetAudioMetrics() {
     this.audioMetrics = this.createAudioMetrics();
   }
-  reportDrivingLatency(conversationId) {
+  reportDrivingServiceLatency(conversationId) {
     if (!conversationId) {
       return;
     }
     const metrics = this.audioMetrics;
-    logEvent("driving_latency", "info", {
-      driving_service_mode: "sdk",
+    logEvent("driving_service_latency", "info", {
       req_id: conversationId,
-      start: metrics.cachedStartTimestamp || "",
-      tap2: metrics.cachedTap2Timestamp || "",
-      tap4: metrics.cachedTap4Timestamp || "",
-      end: metrics.cachedEndTimestamp || "",
-      first_frame: metrics.cachedFirstFrameTimestamp || ""
+      dsm: "sdk",
+      tap_0: metrics.startTimestamp || 0,
+      tap_1: metrics.tap1Timestamp || 0,
+      tap_2: metrics.tap2Timestamp || 0,
+      tap_f: metrics.recvFirstFlameTimestamp || 0
     });
   }
+  startHeartbeatCheck() {
+    this.stopHeartbeatCheck();
+    this.heartbeatTimer = window.setInterval(() => {
+      if (typeof document !== "undefined" && document.visibilityState === "visible") {
+        this.performHeartbeatCheck();
+      }
+    }, this.HEARTBEAT_INTERVAL);
+    this.setupVisibilityListener();
+  }
+  stopHeartbeatCheck() {
+    if (this.heartbeatTimer !== null) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+    this.removeVisibilityListener();
+    this.heartbeatFailureCount = 0;
+  }
+  performHeartbeatCheck() {
+    try {
+      const isConnected = this.wsClient.isConnected();
+      if (isConnected) {
+        this.heartbeatFailureCount = 0;
+      } else {
+        this.heartbeatFailureCount++;
+        logger.warn(`[NetworkLayer] Driving service heartbeat failed (count: ${this.heartbeatFailureCount})`);
+        if (this.heartbeatFailureCount >= 3) {
+          logEvent("heartbeat_failed", "warning", {
+            con_id: idManager.getConnectionId() || "",
+            description: `Driving service heartbeat failed ${this.heartbeatFailureCount} times`
+          });
+          this.heartbeatFailureCount = 0;
+        }
+      }
+    } catch (error) {
+      this.heartbeatFailureCount++;
+      logger.warn(`[NetworkLayer] Heartbeat check error (count: ${this.heartbeatFailureCount}):`, error instanceof Error ? error.message : String(error));
+      if (this.heartbeatFailureCount >= 3) {
+        logEvent("heartbeat_failed", "warning", {
+          con_id: idManager.getConnectionId() || "",
+          description: `Heartbeat check error: ${error instanceof Error ? error.message : String(error)}`
+        });
+        this.heartbeatFailureCount = 0;
+      }
+    }
+  }
+  setupVisibilityListener() {
+    if (typeof window === "undefined" || typeof document === "undefined") {
+      return;
+    }
+    this.removeVisibilityListener();
+    this.visibilityChangeHandler = () => {
+      if (document.visibilityState === "visible") {
+        this.performHeartbeatCheck();
+      }
+    };
+    document.addEventListener("visibilitychange", this.visibilityChangeHandler);
+  }
+  removeVisibilityListener() {
+    if (typeof window === "undefined" || typeof document === "undefined" || !this.visibilityChangeHandler) {
+      return;
+    }
+    document.removeEventListener("visibilitychange", this.visibilityChangeHandler);
+    this.visibilityChangeHandler = null;
+  }
 }
 class AvatarController {
   constructor(avatar, options) {
@@ -10717,16 +10693,11 @@ class AvatarController {
     __publicField(this, "hostModeMetrics", {
       accumulatedBytes: 0,
       startTimestamp: 0,
+      tap1Timestamp: 0,
       tap2Timestamp: 0,
-      tap4Timestamp: 0,
-      endTimestamp: 0,
       recvFirstFlameTimestamp: 0,
       didRecvFirstFlame: false,
-      cachedStartTimestamp: "",
-      cachedTap2Timestamp: "",
-      cachedTap4Timestamp: "",
-      cachedEndTimestamp: "",
-      cachedFirstFrameTimestamp: ""
+      didReportLatency: false
     });
     __publicField(this, "audioBytesPerSecond", 16e3 * 2);
     this.avatar = avatar;
@@ -10896,31 +10867,16 @@ class AvatarController {
     }
     if (this.playbackMode === DrivingServiceMode.host) {
       const metrics = this.hostModeMetrics;
-      let shouldReportMetrics = false;
       if (metrics.startTimestamp === 0) {
         metrics.startTimestamp = Date.now();
-        metrics.cachedStartTimestamp = String(metrics.startTimestamp);
-        shouldReportMetrics = true;
       }
       metrics.accumulatedBytes += data.length;
       const currentDuration = metrics.accumulatedBytes / this.audioBytesPerSecond;
+      if (currentDuration >= 1 && metrics.tap1Timestamp === 0) {
+        metrics.tap1Timestamp = Date.now();
+      }
       if (currentDuration >= 2 && metrics.tap2Timestamp === 0) {
         metrics.tap2Timestamp = Date.now();
-        metrics.cachedTap2Timestamp = String(metrics.tap2Timestamp);
-        shouldReportMetrics = true;
-      }
-      if (currentDuration >= 4 && metrics.tap4Timestamp === 0) {
-        metrics.tap4Timestamp = Date.now();
-        metrics.cachedTap4Timestamp = String(metrics.tap4Timestamp);
-        shouldReportMetrics = true;
-      }
-      if (isLast && metrics.endTimestamp === 0) {
-        metrics.endTimestamp = Date.now();
-        metrics.cachedEndTimestamp = String(metrics.endTimestamp);
-        shouldReportMetrics = true;
-      }
-      if (shouldReportMetrics && this.currentConversationId) {
-        this.reportDrivingLatency(this.currentConversationId);
       }
     }
     if (this.isPlaying && ((_a = this.animationPlayer) == null ? void 0 : _a.isStreamingReady())) {
@@ -11018,9 +10974,9 @@ class AvatarController {
       if (this.playbackMode === DrivingServiceMode.host && !this.hostModeMetrics.didRecvFirstFlame) {
         this.hostModeMetrics.didRecvFirstFlame = true;
         this.hostModeMetrics.recvFirstFlameTimestamp = Date.now();
-        this.hostModeMetrics.cachedFirstFrameTimestamp = String(this.hostModeMetrics.recvFirstFlameTimestamp);
-        if (conversationId) {
-          this.reportDrivingLatency(conversationId);
+        if (conversationId && !this.hostModeMetrics.didReportLatency) {
+          this.reportDrivingServiceLatency(conversationId);
+          this.hostModeMetrics.didReportLatency = true;
         }
       }
     } else {
@@ -11117,16 +11073,11 @@ class AvatarController {
       this.hostModeMetrics = {
         accumulatedBytes: 0,
         startTimestamp: 0,
+        tap1Timestamp: 0,
         tap2Timestamp: 0,
-        tap4Timestamp: 0,
-        endTimestamp: 0,
         recvFirstFlameTimestamp: 0,
         didRecvFirstFlame: false,
-        cachedStartTimestamp: "",
-        cachedTap2Timestamp: "",
-        cachedTap4Timestamp: "",
-        cachedEndTimestamp: "",
-        cachedFirstFrameTimestamp: ""
+        didReportLatency: false
       };
     }
   }
@@ -11142,16 +11093,11 @@ class AvatarController {
       this.hostModeMetrics = {
         accumulatedBytes: 0,
         startTimestamp: 0,
+        tap1Timestamp: 0,
         tap2Timestamp: 0,
-        tap4Timestamp: 0,
-        endTimestamp: 0,
         recvFirstFlameTimestamp: 0,
         didRecvFirstFlame: false,
-        cachedStartTimestamp: "",
-        cachedTap2Timestamp: "",
-        cachedTap4Timestamp: "",
-        cachedEndTimestamp: "",
-        cachedFirstFrameTimestamp: ""
+        didReportLatency: false
       };
     }
   }
@@ -11742,19 +11688,18 @@ class AvatarController {
     }
     return result2;
   }
-  reportDrivingLatency(conversationId) {
+  reportDrivingServiceLatency(conversationId) {
     if (!conversationId || this.playbackMode !== DrivingServiceMode.host) {
       return;
     }
     const metrics = this.hostModeMetrics;
-    logEvent("driving_latency", "info", {
-      driving_service_mode: "host",
+    logEvent("driving_service_latency", "info", {
       req_id: conversationId,
-      start: metrics.cachedStartTimestamp || "",
-      tap2: metrics.cachedTap2Timestamp || "",
-      tap4: metrics.cachedTap4Timestamp || "",
-      end: metrics.cachedEndTimestamp || "",
-      first_frame: metrics.cachedFirstFrameTimestamp || ""
+      dsm: "host",
+      tap_0: metrics.startTimestamp || 0,
+      tap_1: metrics.tap1Timestamp || 0,
+      tap_2: metrics.tap2Timestamp || 0,
+      tap_f: metrics.recvFirstFlameTimestamp || 0
     });
   }
 }
@@ -13906,31 +13851,82 @@ function lerpArrays(from, to2, progress) {
   }
   return result2;
 }
-function linearLerp(from, to2, progress) {
-  const easedProgress = 0.5 - Math.cos(progress * Math.PI) * 0.5;
+const clamp01 = (x2) => Math.max(0, Math.min(1, x2));
+function createBezierEasing(x1, y1, x2, y2) {
+  const cx = 3 * x1;
+  const bx = 3 * (x2 - x1) - cx;
+  const ax = 1 - cx - bx;
+  const cy = 3 * y1;
+  const by = 3 * (y2 - y1) - cy;
+  const ay = 1 - cy - by;
+  const sampleCurveX = (t2) => ((ax * t2 + bx) * t2 + cx) * t2;
+  const sampleCurveY = (t2) => ((ay * t2 + by) * t2 + cy) * t2;
+  const sampleCurveDerivativeX = (t2) => (3 * ax * t2 + 2 * bx) * t2 + cx;
+  const solveCurveX = (x3) => {
+    let t2 = x3;
+    for (let i2 = 0; i2 < 8; i2++) {
+      const error = sampleCurveX(t2) - x3;
+      if (Math.abs(error) < 1e-6) break;
+      const d2 = sampleCurveDerivativeX(t2);
+      if (Math.abs(d2) < 1e-6) break;
+      t2 -= error / d2;
+    }
+    return t2;
+  };
+  return (x3) => {
+    if (x3 <= 0) return 0;
+    if (x3 >= 1) return 1;
+    return sampleCurveY(solveCurveX(x3));
+  };
+}
+const BEZIER_CURVES = {
+  jaw: createBezierEasing(0.2, 0.8, 0.3, 1),
+  expression: createBezierEasing(0.4, 0, 0.2, 1),
+  eye: createBezierEasing(0.3, 0, 0.1, 1),
+  neck: createBezierEasing(0.1, 0.2, 0.2, 1),
+  global: createBezierEasing(0.42, 0, 0.58, 1)
+};
+const TIME_SCALE = {
+  jaw: 2.5,
+  expression: 1.6,
+  eye: 1.3,
+  neck: 1,
+  global: 1
+};
+function bezierLerp(from, to2, progress) {
+  const getT = (key) => {
+    const scaledProgress = clamp01(progress * TIME_SCALE[key]);
+    return BEZIER_CURVES[key](scaledProgress);
+  };
   return {
-    translation: lerpArrays(from.translation || [0, 0, 0], to2.translation || [0, 0, 0], easedProgress),
-    rotation: lerpArrays(from.rotation || [0, 0, 0], to2.rotation || [0, 0, 0], easedProgress),
-    neckPose: lerpArrays(from.neckPose || [0, 0, 0], to2.neckPose || [0, 0, 0], easedProgress),
-    jawPose: lerpArrays(from.jawPose || [0, 0, 0], to2.jawPose || [0, 0, 0], easedProgress),
-    eyePose: lerpArrays(from.eyePose || [0, 0, 0, 0, 0, 0], to2.eyePose || [0, 0, 0, 0, 0, 0], easedProgress),
+    translation: lerpArrays(from.translation || [0, 0, 0], to2.translation || [0, 0, 0], getT("global")),
+    rotation: lerpArrays(from.rotation || [0, 0, 0], to2.rotation || [0, 0, 0], getT("global")),
+    neckPose: lerpArrays(from.neckPose || [0, 0, 0], to2.neckPose || [0, 0, 0], getT("neck")),
+    jawPose: lerpArrays(from.jawPose || [0, 0, 0], to2.jawPose || [0, 0, 0], getT("jaw")),
+    eyePose: lerpArrays(from.eyePose || [0, 0, 0, 0, 0, 0], to2.eyePose || [0, 0, 0, 0, 0, 0], getT("eye")),
     eyeLid: (() => {
       const fromEyelid = from.eyeLid;
       const toEyelid = to2.eyeLid;
-      if (fromEyelid && fromEyelid.length > 0 && toEyelid && toEyelid.length > 0)
-        return lerpArrays(fromEyelid, toEyelid, easedProgress);
+      if ((fromEyelid == null ? void 0 : fromEyelid.length) && (toEyelid == null ? void 0 : toEyelid.length))
+        return lerpArrays(fromEyelid, toEyelid, getT("eye"));
       return fromEyelid || toEyelid || [];
     })(),
-    expression: lerpArrays(from.expression || [], to2.expression || [], easedProgress)
+    expression: lerpArrays(from.expression || [], to2.expression || [], getT("expression"))
   };
 }
 function generateTransitionFrames(from, to2, durationMs, fps = 25) {
   const steps = Math.max(1, Math.floor(durationMs / 1e3 * fps));
   const frames = Array.from({ length: steps });
+  if (steps === 1) {
+    frames[0] = to2;
+    return frames;
+  }
   for (let i2 = 0; i2 < steps; i2++) {
     const progress = i2 / (steps - 1);
-    frames[i2] = linearLerp(from, to2, progress);
+    frames[i2] = bezierLerp(from, to2, progress);
   }
+  frames[0] = from;
+  frames[frames.length - 1] = to2;
   return frames;
 }
 class AvatarView {
@@ -13955,12 +13951,15 @@ class AvatarView {
     __publicField(this, "currentFPS", 0);
     __publicField(this, "transitionKeyframes", []);
     __publicField(this, "transitionStartTime", 0);
-    __publicField(this, "transitionDurationMs", 400);
+    __publicField(this, "startTransitionDurationMs", 200);
+    __publicField(this, "endTransitionDurationMs", 1600);
     __publicField(this, "cachedIdleFirstFrame", null);
     __publicField(this, "idleCurrentFrameIndex", 0);
     __publicField(this, "characterHandle", null);
     __publicField(this, "characterId");
     __publicField(this, "isPureRenderingMode", false);
+    __publicField(this, "avatarActiveTimer", null);
+    __publicField(this, "AVATAR_ACTIVE_INTERVAL", 6e5);
     this.avatar = avatar;
     this.characterId = `${avatar.id}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
     if (!AvatarSDK.configuration) {
@@ -14010,12 +14009,12 @@ class AvatarView {
     toFixed.expression = ensureLen(toFixed.expression, exprLen);
     return { from: fromFixed, to: toFixed };
   }
-  generateAndAlignTransitionFrames(from, to2) {
+  generateAndAlignTransitionFrames(from, to2, durationMs) {
     const aligned = this.alignFlamePair(from, to2);
     let keyframes = generateTransitionFrames(
       aligned.from,
       aligned.to,
-      this.transitionDurationMs,
+      durationMs,
       APP_CONFIG.animation.fps
     );
     if (keyframes.length < 2) {
@@ -14260,6 +14259,8 @@ class AvatarView {
       if (APP_CONFIG.debug)
         logger.log("[AvatarView] First frame rendered successfully");
       (_a = this.onFirstRendering) == null ? void 0 : _a.call(this);
+      this.reportAvatarActive();
+      this.startAvatarActiveHeartbeat();
     } else {
       throw new Error("Failed to compute first frame splat data");
     }
@@ -14372,7 +14373,8 @@ class AvatarView {
             return;
           }
           const elapsed = performance.now() - this.transitionStartTime;
-          const progress = Math.min(1, Math.max(0, elapsed / this.transitionDurationMs));
+          const currentTransitionDurationMs = state === "transitioningToSpeaking" ? this.startTransitionDurationMs : this.endTransitionDurationMs;
+          const progress = Math.min(1, Math.max(0, elapsed / currentTransitionDurationMs));
           const steps = this.transitionKeyframes.length;
           const idx = Math.min(steps - 1, Math.floor(progress * (steps - 1)));
           const currentFrame = this.transitionKeyframes[idx];
@@ -14398,7 +14400,7 @@ class AvatarView {
               return;
             }
           }
-          if (state === "transitioningToSpeaking" && this.transitionStartTime > 0 && this.transitionKeyframes.length > 0 && elapsed >= this.transitionDurationMs + 100) {
+          if (state === "transitioningToSpeaking" && this.transitionStartTime > 0 && this.transitionKeyframes.length > 0 && elapsed >= this.startTransitionDurationMs + 100) {
             this.setState("speaking");
             this.transitionKeyframes = [];
             this.avatarController.onTransitionComplete();
@@ -14528,7 +14530,7 @@ class AvatarView {
         await this.getCachedIdleFirstFrame();
         const firstSpeaking = keyframes[0];
         const firstSpeakingWithPostProcessing = this.avatarController.applyPostProcessingToFlame(firstSpeaking);
-        this.transitionKeyframes = this.generateAndAlignTransitionFrames(idleFrameProto, firstSpeakingWithPostProcessing);
+        this.transitionKeyframes = this.generateAndAlignTransitionFrames(idleFrameProto, firstSpeakingWithPostProcessing, this.startTransitionDurationMs);
         this.transitionStartTime = performance.now();
         if (this.transitionKeyframes.length === 0) {
           this.setState("speaking");
@@ -14581,7 +14583,7 @@ class AvatarView {
           const lastSpeaking = this.avatarController.applyPostProcessingToFlame(lastSpeakingRaw);
           const idleFirstProto = await this.getCachedIdleFirstFrame();
           if (idleFirstProto) {
-            this.transitionKeyframes = this.generateAndAlignTransitionFrames(lastSpeaking, idleFirstProto);
+            this.transitionKeyframes = this.generateAndAlignTransitionFrames(lastSpeaking, idleFirstProto, this.endTransitionDurationMs);
             this.transitionStartTime = performance.now();
             if (this.transitionKeyframes.length > 0 && this.renderingState === "transitioningToIdle") {
               if (APP_CONFIG.debug)
@@ -14615,6 +14617,7 @@ class AvatarView {
       this.avatarController.dispose();
     }
     this.stopAllAnimationLoops();
+    this.stopAvatarActiveHeartbeat();
     this.setState("idle");
     this.cachedIdleFirstFrame = null;
     this.idleCurrentFrameIndex = 0;
@@ -14690,7 +14693,7 @@ class AvatarView {
       throw error;
     }
   }
-  async generateTransitionFromIdle(toFlame, frameCount) {
+  async generateTransitionFromIdle(toFlame, frameCount, transitionType = "start") {
     if (!this.isInitialized) {
       throw new Error("AvatarView not initialized");
     }
@@ -14706,16 +14709,18 @@ class AvatarView {
       const idleFrameProto = convertWasmParamsToProtoFlame(idleParams);
       const toFlameWithPostProcessing = this.avatarController.applyPostProcessingToFlame(toFlame);
       const aligned = this.alignFlamePair(idleFrameProto, toFlameWithPostProcessing);
+      const from = transitionType === "start" ? aligned.from : aligned.to;
+      const to2 = transitionType === "start" ? aligned.to : aligned.from;
       const fps = APP_CONFIG.animation.fps;
       const durationMs = frameCount / fps * 1e3;
       const transitionFrames = generateTransitionFrames(
-        aligned.from,
-        aligned.to,
+        from,
+        to2,
         durationMs,
         fps
       );
-      transitionFrames[0] = aligned.from;
-      transitionFrames[transitionFrames.length - 1] = aligned.to;
+      transitionFrames[0] = from;
+      transitionFrames[transitionFrames.length - 1] = to2;
       return transitionFrames;
     } catch (error) {
       logger.error("[AvatarView] Failed to generate transition from idle:", error instanceof Error ? error.message : String(error));
@@ -14761,6 +14766,28 @@ class AvatarView {
       this.renderSystem.renderFrame();
     }
   }
+  reportAvatarActive() {
+    var _a, _b;
+    logEvent("avatar_active", "info", {
+      avatar_id: this.avatar.id,
+      env: (_a = AvatarSDK.configuration) == null ? void 0 : _a.environment,
+      dsm: ((_b = AvatarSDK.configuration) == null ? void 0 : _b.drivingServiceMode) || DrivingServiceMode.sdk
+    });
+  }
+  startAvatarActiveHeartbeat() {
+    this.stopAvatarActiveHeartbeat();
+    this.avatarActiveTimer = window.setInterval(() => {
+      if (this.isInitialized && typeof document !== "undefined" && document.visibilityState === "visible") {
+        this.reportAvatarActive();
+      }
+    }, this.AVATAR_ACTIVE_INTERVAL);
+  }
+  stopAvatarActiveHeartbeat() {
+    if (this.avatarActiveTimer !== null) {
+      clearInterval(this.avatarActiveTimer);
+      this.avatarActiveTimer = null;
+    }
+  }
 }
 export {
   APP_CONFIG as A,

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-D9nprBw2.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-Bhjn1nq3.js";
 export {
   b as Avatar,
   c as AvatarController,

package/dist/utils/animation-interpolation.d.ts

@@ -1,6 +1,6 @@
 import { Flame } from '../generated/driveningress/v1/driveningress';
 
-export declare function linearLerp(from: Flame, to: Flame, progress: number): Flame;
+export declare function bezierLerp(from: Flame, to: Flame, progress: number): Flame;
 
 export declare function generateTransitionFrames(from: Flame, to: Flame, durationMs: number, fps?: number): Flame[];
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.60",
+  "version": "1.0.0-beta.62",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",
   "license": "MIT",

package/dist/utils/heartbeat-manager.d.ts

@@ -1,18 +0,0 @@
-import { Environment } from '../types';
-declare class HeartbeatManager {
-    private heartbeatTimer;
-    private visibilityChangeHandler;
-    private isInitialized;
-    private currentEnvironment;
-    private currentAppId;
-    private failureCount;
-    start(environment: Environment): void;
-    stop(): void;
-    private startHeartbeatTimer;
-    private stopHeartbeatTimer;
-    private reportHeartbeat;
-    private setupVisibilityListener;
-    private removeVisibilityListener;
-}
-export declare const heartbeatManager: HeartbeatManager;
-export {};