@spatialwalk/avatarkit 1.0.0-beta.39 → 1.0.0-beta.40

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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.40] - 2025-12-27
+
+### 🔧 API Improvements
+- Extended post-processing parameter configuration interface
+
 ## [1.0.0-beta.39] - 2025-12-27
 
 ### 🔧 Improvements

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

package/dist/config/constants.d.ts

@@ -1,7 +1,14 @@
-export declare const POSTHOG_HOST: string;
-export declare const POSTHOG_API_KEY: string;
+import { Environment } from '../types';
+export declare const POSTHOG_HOST_CN: string;
+export declare const POSTHOG_API_KEY_CN: string;
+export declare const POSTHOG_HOST_INTL: string;
+export declare const POSTHOG_API_KEY_INTL: string;
 export declare const POSTHOG_TRACK_EVENTS: boolean;
 export declare const POSTHOG_PROJECT_NAME: string;
+export declare function getPostHogConfig(environment: Environment): {
+    host: string;
+    apiKey: string;
+};
 export declare const ENV_TEST: boolean;
 
 export declare function isDebugMode(): boolean;

package/dist/core/AvatarController.d.ts

@@ -1,7 +1,7 @@
 import { Flame } from '../generated/driveningress/v1/driveningress';
 import { Avatar } from './Avatar';
 import { AnimationPlayer } from '../audio/AnimationPlayer';
-import { AvatarState, ConnectionState, DrivingServiceMode, ConversationState } from '../types';
+import { AvatarState, ConnectionState, DrivingServiceMode, ConversationState, PostProcessingConfig } from '../types';
 export declare class AvatarController {
     private networkLayer?;
     private readonly playbackMode;
@@ -23,6 +23,7 @@ export declare class AvatarController {
     private eventListeners;
     private renderCallback?;
     private characterHandle;
+    private postProcessingConfig;
     private playbackLoopId;
     private lastRenderedFrameIndex;
     private keyframesOffset;
@@ -42,6 +43,7 @@ export declare class AvatarController {
     close(): void;
     yieldAudioData(data: Uint8Array, isLast?: boolean): string | null;
     yieldFramesData(keyframesDataArray: (Uint8Array | ArrayBuffer)[], conversationId: string): void;
+    yieldKeyframes(keyframes: Flame[], conversationId: string): void;
     pause(): void;
     resume(): Promise<void>;
     interrupt(): void;
@@ -50,6 +52,7 @@ export declare class AvatarController {
     private clearPlaybackData;
     private resetConversationIdState;
     private getEffectiveConversationId;
+    setPostProcessingConfig(config: PostProcessingConfig | null): void;
     setVolume(volume: number): void;
     getVolume(): number;
     private startStreamingPlaybackInternal;
@@ -63,5 +66,6 @@ export declare class AvatarController {
     private addAudioChunkToBuffer;
     private registerEventListener;
     protected emit(event: string, data?: any): void;
+    private applyPostProcessingToParams;
     private reportDrivingLatency;
 }

package/dist/{index-BJ9Cdos-.js → index-BxhQDfJ7.js}

@@ -1253,9 +1253,99 @@ function base64FromBytes$1(arr) {
 function isSet$1(value) {
   return value !== null && value !== void 0;
 }
-const POSTHOG_HOST = "https://i.spatialwalk.ai";
-const POSTHOG_API_KEY = "phc_IFTLa6Z6VhTaNvsxB7klvG2JeNwcSpnnwz8YvZRC96Q";
+var ResourceType = /* @__PURE__ */ ((ResourceType2) => {
+  ResourceType2["CAMERA"] = "camera";
+  ResourceType2["ANIMATION_IDLE"] = "frameIdle";
+  ResourceType2["MODEL_SHAPE"] = "shape";
+  ResourceType2["MODEL_GS"] = "gsStandard";
+  return ResourceType2;
+})(ResourceType || {});
+function extractResourceUrls(meta) {
+  var _a, _b, _c, _d, _e2, _f, _g, _h, _i2, _j, _k;
+  return {
+    ["camera"]: ((_b = (_a = meta.camera) == null ? void 0 : _a.resource) == null ? void 0 : _b.remote) || null,
+    ["frameIdle"]: ((_e2 = (_d = (_c = meta.animations) == null ? void 0 : _c.frameIdle) == null ? void 0 : _d.resource) == null ? void 0 : _e2.remote) || null,
+    ["shape"]: ((_h = (_g = (_f = meta.models) == null ? void 0 : _f.shape) == null ? void 0 : _g.resource) == null ? void 0 : _h.remote) || null,
+    ["gsStandard"]: ((_k = (_j = (_i2 = meta.models) == null ? void 0 : _i2.gsStandard) == null ? void 0 : _j.resource) == null ? void 0 : _k.remote) || null
+  };
+}
+var Environment = /* @__PURE__ */ ((Environment2) => {
+  Environment2["cn"] = "cn";
+  Environment2["intl"] = "intl";
+  return Environment2;
+})(Environment || {});
+var DrivingServiceMode = /* @__PURE__ */ ((DrivingServiceMode2) => {
+  DrivingServiceMode2["sdk"] = "sdk";
+  DrivingServiceMode2["host"] = "host";
+  return DrivingServiceMode2;
+})(DrivingServiceMode || {});
+var LogLevel$1 = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2["off"] = "off";
+  LogLevel2["error"] = "error";
+  LogLevel2["warning"] = "warning";
+  LogLevel2["all"] = "all";
+  return LogLevel2;
+})(LogLevel$1 || {});
+var LoadProgress = /* @__PURE__ */ ((LoadProgress2) => {
+  LoadProgress2["downloading"] = "downloading";
+  LoadProgress2["completed"] = "completed";
+  LoadProgress2["failed"] = "failed";
+  return LoadProgress2;
+})(LoadProgress || {});
+var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
+  ConnectionState2["disconnected"] = "disconnected";
+  ConnectionState2["connecting"] = "connecting";
+  ConnectionState2["connected"] = "connected";
+  ConnectionState2["failed"] = "failed";
+  return ConnectionState2;
+})(ConnectionState || {});
+var ConversationState = /* @__PURE__ */ ((ConversationState2) => {
+  ConversationState2["idle"] = "idle";
+  ConversationState2["playing"] = "playing";
+  ConversationState2["pausing"] = "pausing";
+  return ConversationState2;
+})(ConversationState || {});
+var AvatarState = /* @__PURE__ */ ((AvatarState2) => {
+  AvatarState2["idle"] = "idle";
+  AvatarState2["active"] = "active";
+  AvatarState2["playing"] = "playing";
+  AvatarState2["paused"] = "paused";
+  return AvatarState2;
+})(AvatarState || {});
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["appIDUnrecognized"] = "appIDUnrecognized";
+  ErrorCode2["avatarIDUnrecognized"] = "avatarIDUnrecognized";
+  ErrorCode2["sessionTokenInvalid"] = "sessionTokenInvalid";
+  ErrorCode2["sessionTokenExpired"] = "sessionTokenExpired";
+  ErrorCode2["failedToFetchAvatarMetadata"] = "failedToFetchAvatarMetadata";
+  ErrorCode2["failedToDownloadAvatarAssets"] = "failedToDownloadAvatarAssets";
+  return ErrorCode2;
+})(ErrorCode || {});
+class SPAvatarError extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "SPAvatarError";
+  }
+}
+const POSTHOG_HOST_CN = "https://analytics.spatialwalk.top";
+const POSTHOG_API_KEY_CN = "phc_BwD9QedcHpUJ1j8XwALx2xPWQAswvELygU17J4XO5ZB";
+const POSTHOG_HOST_INTL = "https://i.spatialwalk.ai";
+const POSTHOG_API_KEY_INTL = "phc_IFTLa6Z6VhTaNvsxB7klvG2JeNwcSpnnwz8YvZRC96Q";
 const POSTHOG_PROJECT_NAME = "sdk";
+function getPostHogConfig(environment) {
+  if (environment === Environment.cn) {
+    return {
+      host: POSTHOG_HOST_CN,
+      apiKey: POSTHOG_API_KEY_CN
+    };
+  } else {
+    return {
+      host: POSTHOG_HOST_INTL,
+      apiKey: POSTHOG_API_KEY_INTL
+    };
+  }
+}
 function hasDebugParam() {
   if (typeof window === "undefined") {
     return false;
@@ -6514,14 +6604,14 @@ const mix = (del = delimiter) => {
 };
 const posix = /* @__PURE__ */ mix(":");
 const win32 = /* @__PURE__ */ mix(";");
-var LogLevel$1 = /* @__PURE__ */ ((LogLevel2) => {
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
   LogLevel2[LogLevel2["Error"] = 0] = "Error";
   LogLevel2[LogLevel2["Warning"] = 1] = "Warning";
   LogLevel2[LogLevel2["Log"] = 2] = "Log";
   LogLevel2[LogLevel2["Verbose"] = 3] = "Verbose";
   LogLevel2[LogLevel2["Debug"] = 4] = "Debug";
   return LogLevel2;
-})(LogLevel$1 || {});
+})(LogLevel || {});
 var LogLevelString = /* @__PURE__ */ ((LogLevelString2) => {
   LogLevelString2["Error"] = "error";
   LogLevelString2["Warning"] = "warn";
@@ -6581,18 +6671,18 @@ function createColors(enabled = isColorSupported) {
 }
 const pc = createColors();
 const logLevelStringToLogLevelMap = {
-  [LogLevelString.Error]: LogLevel$1.Error,
-  [LogLevelString.Warning]: LogLevel$1.Warning,
-  [LogLevelString.Log]: LogLevel$1.Log,
-  [LogLevelString.Verbose]: LogLevel$1.Verbose,
-  [LogLevelString.Debug]: LogLevel$1.Debug
+  [LogLevelString.Error]: LogLevel.Error,
+  [LogLevelString.Warning]: LogLevel.Warning,
+  [LogLevelString.Log]: LogLevel.Log,
+  [LogLevelString.Verbose]: LogLevel.Verbose,
+  [LogLevelString.Debug]: LogLevel.Debug
 };
 const logLevelToLogLevelStringMap = {
-  [LogLevel$1.Error]: LogLevelString.Error,
-  [LogLevel$1.Warning]: LogLevelString.Warning,
-  [LogLevel$1.Log]: LogLevelString.Log,
-  [LogLevel$1.Verbose]: LogLevelString.Verbose,
-  [LogLevel$1.Debug]: LogLevelString.Debug
+  [LogLevel.Error]: LogLevelString.Error,
+  [LogLevel.Warning]: LogLevelString.Warning,
+  [LogLevel.Log]: LogLevelString.Log,
+  [LogLevel.Verbose]: LogLevelString.Verbose,
+  [LogLevel.Debug]: LogLevelString.Debug
 };
 const availableLogLevelStrings = [
   LogLevelString.Error,
@@ -6602,18 +6692,18 @@ const availableLogLevelStrings = [
   LogLevelString.Debug
 ];
 const logLevelToColorMap = {
-  [LogLevel$1.Error]: pc.red,
-  [LogLevel$1.Warning]: pc.yellow,
-  [LogLevel$1.Log]: pc.blue,
-  [LogLevel$1.Verbose]: pc.cyan,
-  [LogLevel$1.Debug]: pc.green
+  [LogLevel.Error]: pc.red,
+  [LogLevel.Warning]: pc.yellow,
+  [LogLevel.Log]: pc.blue,
+  [LogLevel.Verbose]: pc.cyan,
+  [LogLevel.Debug]: pc.green
 };
 const availableLogLevels = [
-  LogLevel$1.Error,
-  LogLevel$1.Warning,
-  LogLevel$1.Log,
-  LogLevel$1.Verbose,
-  LogLevel$1.Debug
+  LogLevel.Error,
+  LogLevel.Warning,
+  LogLevel.Log,
+  LogLevel.Verbose,
+  LogLevel.Debug
 ];
 const availableFormats = [Format.JSON, Format.Pretty];
 function parseErrorStacks(errorLike) {
@@ -6773,19 +6863,19 @@ ${log.error.stack}`;
   return message;
 }
 function shouldOutputDebugLevelLogWhenLogLevelIsOneOf(logLevel) {
-  return logLevel >= LogLevel$1.Debug;
+  return logLevel >= LogLevel.Debug;
 }
 function shouldOutputVerboseLevelLogWhenLogLevelIsOneOf(logLevel) {
-  return logLevel >= LogLevel$1.Verbose;
+  return logLevel >= LogLevel.Verbose;
 }
 function shouldOutputLogLevelLogWhenLogLevelIsOneOf(logLevel) {
-  return logLevel >= LogLevel$1.Log;
+  return logLevel >= LogLevel.Log;
 }
 function shouldOutputWarningLevelLogWhenLogLevelIsOneOf(logLevel) {
-  return logLevel >= LogLevel$1.Warning;
+  return logLevel >= LogLevel.Warning;
 }
 function shouldOutputErrorLevelLogWhenLogLevelIsOneOf(logLevel) {
-  return logLevel >= LogLevel$1.Error;
+  return logLevel >= LogLevel.Error;
 }
 function isBrowser() {
   return typeof window !== "undefined";
@@ -6798,7 +6888,7 @@ function withHyperlink(basePath, context) {
 }
 const GLOBAL_CONFIG = {
   configured: false,
-  logLevel: LogLevel$1.Debug,
+  logLevel: LogLevel.Debug,
   format: Format.JSON,
   timeFormatter: (inputDate) => inputDate.toISOString()
 };
@@ -6827,7 +6917,7 @@ function createLogg(context) {
   const logObj = {
     fields: {},
     context,
-    logLevel: LogLevel$1.Debug,
+    logLevel: LogLevel.Debug,
     format: Format.JSON,
     shouldUseGlobalConfig: false,
     errorProcessor: (err) => err,
@@ -7093,83 +7183,8 @@ function createLogger(context) {
   return createLogg(withHyperlink(basePath, context));
 }
 const useLogger = (context) => createLogger(context).useGlobalConfig();
-var ResourceType = /* @__PURE__ */ ((ResourceType2) => {
-  ResourceType2["CAMERA"] = "camera";
-  ResourceType2["ANIMATION_IDLE"] = "frameIdle";
-  ResourceType2["MODEL_SHAPE"] = "shape";
-  ResourceType2["MODEL_GS"] = "gsStandard";
-  return ResourceType2;
-})(ResourceType || {});
-function extractResourceUrls(meta) {
-  var _a, _b, _c, _d, _e2, _f, _g, _h, _i2, _j, _k;
-  return {
-    ["camera"]: ((_b = (_a = meta.camera) == null ? void 0 : _a.resource) == null ? void 0 : _b.remote) || null,
-    ["frameIdle"]: ((_e2 = (_d = (_c = meta.animations) == null ? void 0 : _c.frameIdle) == null ? void 0 : _d.resource) == null ? void 0 : _e2.remote) || null,
-    ["shape"]: ((_h = (_g = (_f = meta.models) == null ? void 0 : _f.shape) == null ? void 0 : _g.resource) == null ? void 0 : _h.remote) || null,
-    ["gsStandard"]: ((_k = (_j = (_i2 = meta.models) == null ? void 0 : _i2.gsStandard) == null ? void 0 : _j.resource) == null ? void 0 : _k.remote) || null
-  };
-}
-var Environment = /* @__PURE__ */ ((Environment2) => {
-  Environment2["cn"] = "cn";
-  Environment2["intl"] = "intl";
-  return Environment2;
-})(Environment || {});
-var DrivingServiceMode = /* @__PURE__ */ ((DrivingServiceMode2) => {
-  DrivingServiceMode2["sdk"] = "sdk";
-  DrivingServiceMode2["host"] = "host";
-  return DrivingServiceMode2;
-})(DrivingServiceMode || {});
-var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2["off"] = "off";
-  LogLevel2["error"] = "error";
-  LogLevel2["warning"] = "warning";
-  LogLevel2["all"] = "all";
-  return LogLevel2;
-})(LogLevel || {});
-var LoadProgress = /* @__PURE__ */ ((LoadProgress2) => {
-  LoadProgress2["downloading"] = "downloading";
-  LoadProgress2["completed"] = "completed";
-  LoadProgress2["failed"] = "failed";
-  return LoadProgress2;
-})(LoadProgress || {});
-var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
-  ConnectionState2["disconnected"] = "disconnected";
-  ConnectionState2["connecting"] = "connecting";
-  ConnectionState2["connected"] = "connected";
-  ConnectionState2["failed"] = "failed";
-  return ConnectionState2;
-})(ConnectionState || {});
-var ConversationState = /* @__PURE__ */ ((ConversationState2) => {
-  ConversationState2["idle"] = "idle";
-  ConversationState2["playing"] = "playing";
-  ConversationState2["pausing"] = "pausing";
-  return ConversationState2;
-})(ConversationState || {});
-var AvatarState = /* @__PURE__ */ ((AvatarState2) => {
-  AvatarState2["idle"] = "idle";
-  AvatarState2["active"] = "active";
-  AvatarState2["playing"] = "playing";
-  AvatarState2["paused"] = "paused";
-  return AvatarState2;
-})(AvatarState || {});
-var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
-  ErrorCode2["appIDUnrecognized"] = "appIDUnrecognized";
-  ErrorCode2["avatarIDUnrecognized"] = "avatarIDUnrecognized";
-  ErrorCode2["sessionTokenInvalid"] = "sessionTokenInvalid";
-  ErrorCode2["sessionTokenExpired"] = "sessionTokenExpired";
-  ErrorCode2["failedToFetchAvatarMetadata"] = "failedToFetchAvatarMetadata";
-  ErrorCode2["failedToDownloadAvatarAssets"] = "failedToDownloadAvatarAssets";
-  return ErrorCode2;
-})(ErrorCode || {});
-class SPAvatarError extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "SPAvatarError";
-  }
-}
 {
-  setGlobalLogLevel(LogLevel$1.Warning);
+  setGlobalLogLevel(LogLevel.Warning);
 }
 const logger = useLogger("Web").withErrorProcessor((err) => {
   captureErrorContext("error", err);
@@ -7178,7 +7193,7 @@ const logger = useLogger("Web").withErrorProcessor((err) => {
 let originalLogger = null;
 function setLogLevel(level) {
   switch (level) {
-    case LogLevel.off:
+    case LogLevel$1.off:
       if (!originalLogger) {
         originalLogger = { ...logger };
       }
@@ -7197,33 +7212,33 @@ function setLogLevel(level) {
         }
       });
       break;
-    case LogLevel.error:
+    case LogLevel$1.error:
       if (originalLogger) {
         Object.assign(logger, originalLogger);
         originalLogger = null;
       }
-      setGlobalLogLevel(LogLevel$1.Error);
+      setGlobalLogLevel(LogLevel.Error);
       break;
-    case LogLevel.warning:
+    case LogLevel$1.warning:
       if (originalLogger) {
         Object.assign(logger, originalLogger);
         originalLogger = null;
       }
-      setGlobalLogLevel(LogLevel$1.Warning);
+      setGlobalLogLevel(LogLevel.Warning);
       break;
-    case LogLevel.all:
+    case LogLevel$1.all:
       if (originalLogger) {
         Object.assign(logger, originalLogger);
         originalLogger = null;
       }
-      setGlobalLogLevel(LogLevel$1.Debug);
+      setGlobalLogLevel(LogLevel.Debug);
       break;
     default:
       if (originalLogger) {
         Object.assign(logger, originalLogger);
         originalLogger = null;
       }
-      setGlobalLogLevel(LogLevel$1.Warning);
+      setGlobalLogLevel(LogLevel.Warning);
       break;
   }
 }
@@ -7374,6 +7389,11 @@ let currentEnvironment = null;
 let isInitialized = false;
 const FILTERED_HOSTNAMES = ["localhost", "127.0.0.1", "0.0.0.0"];
 function initializePostHog(environment, version) {
+  const { host, apiKey } = getPostHogConfig(environment);
+  if (!apiKey) {
+    logger.warn(`[PostHog] API Key not configured for environment: ${environment}, tracking disabled`);
+    return;
+  }
   if (isInitialized) {
     logger.log("[PostHog] Already initialized, skipping");
     return;
@@ -7382,14 +7402,14 @@ function initializePostHog(environment, version) {
   sdkVersion = version;
   try {
     const logContext = idManager.getLogContext();
-    Vo.init(POSTHOG_API_KEY, {
-      api_host: POSTHOG_HOST,
+    Vo.init(apiKey, {
+      api_host: host,
       name: POSTHOG_PROJECT_NAME,
       person_profiles: "identified_only",
       capture_pageview: false,
       capture_pageleave: false,
       loaded: (posthogInstance) => {
-        logger.log(`[PostHog] Initialized successfully - environment: ${environment}, project: ${POSTHOG_PROJECT_NAME}`);
+        logger.log(`[PostHog] Initialized successfully - environment: ${environment}, host: ${host}, project: ${POSTHOG_PROJECT_NAME}`);
         isInitialized = true;
         if (logContext.user_id) {
           posthogInstance.identify(logContext.user_id, {
@@ -7540,7 +7560,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-BD-LSSrW.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-hJgaKVC3.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -8769,7 +8789,7 @@ class AvatarSDK {
       }
       logger.log(`[AvatarSDK] Initializing with appId: ${appId}, environment: ${configuration.environment}`);
       this._configuration = configuration;
-      setLogLevel(configuration.logLevel ?? LogLevel.off);
+      setLogLevel(configuration.logLevel ?? LogLevel$1.off);
       idManager.setAppId(appId);
       logger.log(`[AvatarSDK] Client ID: ${idManager.getClientId()}`);
       initializePostHog(configuration.environment, this._version);
@@ -8954,7 +8974,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.39");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.40");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -10417,7 +10437,7 @@ class NetworkLayer {
     if (this.isFallbackMode) {
       if (this.currentConversationId) {
         logger.warn("[NetworkLayer] Fallback mode: skipping WebSocket send, triggering audio-only mode");
-        this.dataController.yieldFramesDataInternal([], this.currentConversationId);
+        this.dataController.yieldKeyframes([], this.currentConversationId);
       }
       return;
     }
@@ -10538,7 +10558,7 @@ class NetworkLayer {
     if ((animation == null ? void 0 : animation.keyframes) && animation.keyframes.length > 0) {
       const keyframes = animation.keyframes;
       try {
-        this.dataController.yieldFramesDataInternal(keyframes, conversationId);
+        this.dataController.yieldKeyframes(keyframes, conversationId);
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         logger.error(`[NetworkLayer] Failed to yield animation data: ${errorMessage}`);
@@ -10608,7 +10628,7 @@ class NetworkLayer {
     ));
     if (this.currentConversationId && conversationId === this.currentConversationId) {
       logger.warn("[NetworkLayer] Server error for current conversation - triggering audio-only mode via empty animation data");
-      this.dataController.yieldFramesDataInternal([], conversationId);
+      this.dataController.yieldKeyframes([], conversationId);
     }
   }
   createAudioMetrics() {
@@ -10665,6 +10685,7 @@ class AvatarController {
     __publicField(this, "eventListeners", /* @__PURE__ */ new Map());
     __publicField(this, "renderCallback");
     __publicField(this, "characterHandle", null);
+    __publicField(this, "postProcessingConfig", null);
     __publicField(this, "playbackLoopId", null);
     __publicField(this, "lastRenderedFrameIndex", -1);
     __publicField(this, "keyframesOffset", 0);
@@ -10895,7 +10916,7 @@ class AvatarController {
   yieldFramesData(keyframesDataArray, conversationId) {
     var _a, _b;
     if (!keyframesDataArray || keyframesDataArray.length === 0) {
-      this.yieldFramesDataInternal([], conversationId);
+      this.yieldKeyframes([], conversationId);
       return;
     }
     let allKeyframes = [];
@@ -10930,11 +10951,11 @@ class AvatarController {
     if (allKeyframes.length === 0) {
       logger.warn(`[AvatarController] No keyframes decoded from ${keyframesDataArray.length} message chunks`);
     }
-    this.yieldFramesDataInternal(allKeyframes, conversationId);
+    this.yieldKeyframes(allKeyframes, conversationId);
   }
-  yieldFramesDataInternal(keyframes, conversationId) {
+  yieldKeyframes(keyframes, conversationId) {
     if (!conversationId || typeof conversationId !== "string") {
-      logger.error(`[AvatarController] yieldFramesData requires a valid conversationId. Use getCurrentConversationId() to get the current conversationId.`);
+      logger.error(`[AvatarController] yieldKeyframes requires a valid conversationId. Use getCurrentConversationId() to get the current conversationId.`);
       logEvent("character_manager", "error", {
         avatar_id: this.avatar.id,
         event: "keyframes_missing_conversationid",
@@ -11130,6 +11151,9 @@ class AvatarController {
       this.characterHandle = characterHandle;
     }
   }
+  setPostProcessingConfig(config) {
+    this.postProcessingConfig = config;
+  }
   onTransitionComplete() {
     var _a;
     const streamingPlayer = (_a = this.animationPlayer) == null ? void 0 : _a.getStreamingPlayer();
@@ -11296,7 +11320,10 @@ class AvatarController {
         }
         if (arrayIndex >= 0 && arrayIndex < this.currentKeyframes.length) {
           const currentFrame = this.currentKeyframes[arrayIndex];
-          const wasmParams = convertProtoFlameToWasmParams(currentFrame);
+          let wasmParams = convertProtoFlameToWasmParams(currentFrame);
+          if (this.postProcessingConfig) {
+            wasmParams = this.applyPostProcessingToParams(wasmParams);
+          }
           const avatarCore = AvatarSDK.getAvatarCore();
           if (avatarCore) {
             const splatData = await avatarCore.computeFrameFlatFromParams(wasmParams, this.characterHandle ?? void 0);
@@ -11455,6 +11482,68 @@ class AvatarController {
       listeners.forEach((callback) => callback(data));
     }
   }
+  applyPostProcessingToFlame(flame) {
+    if (!this.postProcessingConfig) {
+      return flame;
+    }
+    let wasmParams = convertProtoFlameToWasmParams(flame);
+    wasmParams = this.applyPostProcessingToParams(wasmParams);
+    return convertWasmParamsToProtoFlame(wasmParams);
+  }
+  applyPostProcessingToParams(baseParams) {
+    if (!this.postProcessingConfig) {
+      return baseParams;
+    }
+    const result2 = {
+      shape_params: baseParams.shape_params || Array.from({ length: 300 }, () => 0),
+      expr_params: baseParams.expr_params ? [...baseParams.expr_params] : Array.from({ length: 100 }, () => 0),
+      rotation: baseParams.rotation ? [...baseParams.rotation] : [0, 0, 0],
+      translation: baseParams.translation ? [...baseParams.translation] : [0, 0, 0],
+      neck_pose: baseParams.neck_pose ? [...baseParams.neck_pose] : [0, 0, 0],
+      jaw_pose: baseParams.jaw_pose ? [...baseParams.jaw_pose] : [0, 0, 0],
+      eyes_pose: baseParams.eyes_pose ? [...baseParams.eyes_pose] : [0, 0, 0, 0, 0, 0],
+      eyelid: baseParams.eyelid ? [...baseParams.eyelid] : [0, 0],
+      has_eyelid: baseParams.has_eyelid || false
+    };
+    if (this.postProcessingConfig.rotation && result2.rotation) {
+      result2.rotation[0] += this.postProcessingConfig.rotation.x ?? 0;
+      result2.rotation[1] += this.postProcessingConfig.rotation.y ?? 0;
+      result2.rotation[2] += this.postProcessingConfig.rotation.z ?? 0;
+    }
+    if (this.postProcessingConfig.neckPose && result2.neck_pose) {
+      const biasX = this.postProcessingConfig.neckPose.x ?? 0;
+      const biasY = this.postProcessingConfig.neckPose.y ?? 0;
+      const biasZ = this.postProcessingConfig.neckPose.z ?? 0;
+      const weightX = this.postProcessingConfig.neckPose.weightX ?? 1;
+      const weightY = this.postProcessingConfig.neckPose.weightY ?? 1;
+      const weightZ = this.postProcessingConfig.neckPose.weightZ ?? 1;
+      result2.neck_pose[0] = result2.neck_pose[0] * weightX + biasX;
+      result2.neck_pose[1] = result2.neck_pose[1] * weightY + biasY;
+      result2.neck_pose[2] = result2.neck_pose[2] * weightZ + biasZ;
+    }
+    if (this.postProcessingConfig.jawPose && result2.jaw_pose) {
+      const biasX = this.postProcessingConfig.jawPose.x ?? 0;
+      const biasY = this.postProcessingConfig.jawPose.y ?? 0;
+      const biasZ = this.postProcessingConfig.jawPose.z ?? 0;
+      const weight = this.postProcessingConfig.jawPose.weight ?? 1;
+      result2.jaw_pose[0] = result2.jaw_pose[0] * weight + biasX;
+      result2.jaw_pose[1] = result2.jaw_pose[1] * weight + biasY;
+      result2.jaw_pose[2] = result2.jaw_pose[2] * weight + biasZ;
+    }
+    if (this.postProcessingConfig.eyeBlink !== void 0 && result2.eyelid) {
+      const blinkValue = this.postProcessingConfig.eyeBlink;
+      result2.eyelid[0] = blinkValue;
+      result2.eyelid[1] = blinkValue;
+      result2.has_eyelid = true;
+    }
+    if (this.postProcessingConfig.expressionWeight !== void 0 && result2.expr_params) {
+      const weight = this.postProcessingConfig.expressionWeight;
+      for (let i2 = 0; i2 < result2.expr_params.length; i2++) {
+        result2.expr_params[i2] *= weight;
+      }
+    }
+    return result2;
+  }
   reportDrivingLatency(conversationId) {
     if (!conversationId || this.playbackMode !== DrivingServiceMode.host) {
       return;
@@ -11783,8 +11872,9 @@ class AvatarDownloader {
   getSdkApiClient() {
     return {
       async request(url, options = {}) {
-        const config = AvatarSDK.getEnvironmentConfig();
-        const baseUrl = config.sdkApiBaseUrl;
+        var _a;
+        const customBaseUrl = (_a = AvatarSDK.configuration) == null ? void 0 : _a.characterApiBaseUrl;
+        const baseUrl = customBaseUrl || AvatarSDK.getEnvironmentConfig().sdkApiBaseUrl;
         const fullUrl = baseUrl + url;
         const headers = {
           "Content-Type": "application/json"
@@ -14030,7 +14120,8 @@ class AvatarView {
         const idleFrameProto = convertWasmParamsToProtoFlame(idleParams);
         await this.getCachedIdleFirstFrame();
         const firstSpeaking = keyframes[0];
-        this.transitionKeyframes = this.generateAndAlignTransitionFrames(idleFrameProto, firstSpeaking);
+        const firstSpeakingWithPostProcessing = this.avatarController.applyPostProcessingToFlame(firstSpeaking);
+        this.transitionKeyframes = this.generateAndAlignTransitionFrames(idleFrameProto, firstSpeakingWithPostProcessing);
         this.transitionStartTime = performance.now();
         if (this.transitionKeyframes.length === 0) {
           this.setState("speaking");
@@ -14079,7 +14170,8 @@ class AvatarView {
         }
         const avatarCore = AvatarSDK.getAvatarCore();
         if (avatarCore && this.currentKeyframes.length > 0) {
-          const lastSpeaking = this.lastRealtimeProtoFrame || this.currentKeyframes[Math.max(0, this.lastRenderedFrameIndex)];
+          const lastSpeakingRaw = this.lastRealtimeProtoFrame || this.currentKeyframes[Math.max(0, this.lastRenderedFrameIndex)];
+          const lastSpeaking = this.avatarController.applyPostProcessingToFlame(lastSpeakingRaw);
           const idleFirstProto = await this.getCachedIdleFirstFrame();
           if (idleFirstProto) {
             this.transitionKeyframes = this.generateAndAlignTransitionFrames(lastSpeaking, idleFirstProto);
@@ -14229,7 +14321,7 @@ export {
   ConnectionState as C,
   DrivingServiceMode as D,
   Environment as E,
-  LogLevel as L,
+  LogLevel$1 as L,
   ResourceType as R,
   SPAvatarError as S,
   logger as a,