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

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.42] - 2025-12-29
+
+### ✨ New Features
+- **PostHog Telemetry Configuration** - PostHog telemetry reporting now supports separate configuration for domestic (CN) and international (INTL) environments:
+  - Separate PostHog hosts and API keys for CN and INTL environments
+  - Compression disabled for domestic self-hosted instance, enabled for international official PostHog
+  - Localhost domain filtering to avoid test data pollution
+
+## [1.0.0-beta.41] - 2025-12-29
+
+### 🔄 Breaking Changes
+- **Background Image Support Removed** - Removed background image functionality from `AvatarView`:
+  - Removed `isOpaque` getter/setter property
+  - Removed `setBackgroundImage()` method
+  - Removed background image loading from `AvatarDownloader`
+  - Canvas now always uses transparent background
+
 ## [1.0.0-beta.40] - 2025-12-27
 
 ### 🔧 API Improvements

package/README.md

@@ -49,6 +49,7 @@ const configuration: Configuration = {
     channelCount: 1, // Fixed to 1 (mono)
     sampleRate: 16000 // Supported: 8000, 16000, 22050, 24000, 32000, 44100, 48000 Hz
   }
+  // characterApiBaseUrl: 'https://custom-api.example.com' // Optional, internal debug config, can be ignored
 }
 
 await AvatarSDK.initialize('your-app-id', configuration)
@@ -450,6 +451,7 @@ interface Configuration {
   drivingServiceMode?: DrivingServiceMode  // Optional, default is 'sdk' (SDK mode)
   logLevel?: LogLevel  // Optional, default is 'off' (no logs)
   audioFormat?: AudioFormat  // Optional, default is { channelCount: 1, sampleRate: 16000 }
+  characterApiBaseUrl?: string  // Optional, internal debug config, can be ignored
 }
 
 interface AudioFormat {
@@ -488,6 +490,7 @@ enum LogLevel {
   - `sampleRate`: Audio sample rate in Hz (default: 16000)
     - Supported values: 8000, 16000, 22050, 24000, 32000, 44100, 48000
     - The configured sample rate will be used for both audio recording and playback
+- `characterApiBaseUrl`: Internal debug config, can be ignored
 - `sessionToken`: Set separately via `AvatarSDK.setSessionToken()`, not in Configuration
 
 ```typescript

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

package/dist/config/constants.d.ts

@@ -8,6 +8,7 @@ export declare const POSTHOG_PROJECT_NAME: string;
 export declare function getPostHogConfig(environment: Environment): {
     host: string;
     apiKey: string;
+    disableCompression: boolean;
 };
 export declare const ENV_TEST: boolean;
 

package/dist/core/AvatarView.d.ts

@@ -26,7 +26,6 @@ export declare class AvatarView {
     private idleCurrentFrameIndex;
     private characterHandle;
     private characterId;
-    private _isOpaque;
     private alignFlamePair;
     private generateAndAlignTransitionFrames;
     private getCachedIdleFirstFrame;
@@ -58,9 +57,6 @@ export declare class AvatarView {
     private stopRealtimeRendering;
     dispose(): void;
     private handleResize;
-    get isOpaque(): boolean;
-    set isOpaque(value: boolean);
-    setBackgroundImage(image: HTMLImageElement | string | null): void;
     get transform(): {
         x: number;
         y: number;

package/dist/{index-BxhQDfJ7.js → index-Bgw-52f-.js}

@@ -1337,12 +1337,14 @@ function getPostHogConfig(environment) {
   if (environment === Environment.cn) {
     return {
       host: POSTHOG_HOST_CN,
-      apiKey: POSTHOG_API_KEY_CN
+      apiKey: POSTHOG_API_KEY_CN,
+      disableCompression: true
     };
   } else {
     return {
       host: POSTHOG_HOST_INTL,
-      apiKey: POSTHOG_API_KEY_INTL
+      apiKey: POSTHOG_API_KEY_INTL,
+      disableCompression: false
     };
   }
 }
@@ -7388,8 +7390,19 @@ let sdkVersion = "1.0.0";
 let currentEnvironment = null;
 let isInitialized = false;
 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) {
-  const { host, apiKey } = getPostHogConfig(environment);
+  if (shouldFilterHostname()) {
+    logger.log(`[PostHog] Tracking disabled due to filtered hostname: ${window.location.hostname}`);
+    return;
+  }
+  const { host, apiKey, disableCompression } = getPostHogConfig(environment);
   if (!apiKey) {
     logger.warn(`[PostHog] API Key not configured for environment: ${environment}, tracking disabled`);
     return;
@@ -7408,6 +7421,9 @@ function initializePostHog(environment, version) {
       person_profiles: "identified_only",
       capture_pageview: false,
       capture_pageleave: false,
+      disable_compression: disableCompression,
+      disable_session_recording: true,
+      autocapture: false,
       loaded: (posthogInstance) => {
         logger.log(`[PostHog] Initialized successfully - environment: ${environment}, host: ${host}, project: ${POSTHOG_PROJECT_NAME}`);
         isInitialized = true;
@@ -7435,11 +7451,8 @@ function initializePostHog(environment, version) {
   }
 }
 function trackEvent(event, level = "info", contents = {}) {
-  if (typeof window !== "undefined") {
-    const hostname = window.location.hostname;
-    if (FILTERED_HOSTNAMES.includes(hostname)) {
-      return;
-    }
+  if (shouldFilterHostname()) {
+    return;
   }
   if (typeof Vo === "undefined") {
     return;
@@ -7560,7 +7573,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-hJgaKVC3.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-C2x7CaOj.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -8974,7 +8987,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.40");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.42");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = Object.freeze(Object.defineProperty({
@@ -11836,19 +11849,9 @@ class AvatarDownloader {
     });
     return characterData;
   }
-  async loadBackground(characterMeta) {
-    var _a, _b;
-    const backgroundUrl = (_b = (_a = characterMeta.background) == null ? void 0 : _a.resource) == null ? void 0 : _b.remote;
-    if (!backgroundUrl) {
-      logger.log("ℹ️ No background resource URL provided");
-      return void 0;
-    }
-    logger.log(`📥 Background image URL: ${backgroundUrl}`);
-    return backgroundUrl;
-  }
   async preloadResources(characterMeta, options) {
     const { progressCallback = null } = options || {};
-    const [characterData, preloadCameraSettings, background] = await Promise.all([
+    const [characterData, preloadCameraSettings] = await Promise.all([
       this.loadCharacterData(characterMeta, {
         progressCallback: (info) => {
           if (progressCallback) {
@@ -11859,14 +11862,12 @@ class AvatarDownloader {
           }
         }
       }),
-      this.loadCameraSettings(characterMeta),
-      this.loadBackground(characterMeta)
+      this.loadCameraSettings(characterMeta)
     ]);
     return {
       characterData,
       preloadCameraSettings,
-      characterSettings: characterMeta.characterSettings,
-      background
+      characterSettings: characterMeta.characterSettings
     };
   }
   getSdkApiClient() {
@@ -13596,7 +13597,6 @@ class AvatarView {
     __publicField(this, "idleCurrentFrameIndex", 0);
     __publicField(this, "characterHandle", null);
     __publicField(this, "characterId");
-    __publicField(this, "_isOpaque", false);
     this.avatar = avatar;
     this.characterId = `${avatar.id}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
     if (!AvatarSDK.configuration) {
@@ -13693,9 +13693,6 @@ class AvatarView {
     canvas.style.zIndex = "";
     canvas.style.background = "none";
     canvas.style.border = "none";
-    canvas.style.backgroundSize = "cover";
-    canvas.style.backgroundPosition = "center";
-    canvas.style.backgroundRepeat = "no-repeat";
     container.appendChild(canvas);
     container.style.display = "flex";
     container.style.justifyContent = "center";
@@ -13749,11 +13746,6 @@ class AvatarView {
         logger.log("[AvatarView] Initializing render system...");
       const cameraConfig = this.resolveCameraConfig(resources);
       await this.initializeRenderSystem(cameraConfig);
-      if (resources.background) {
-        if (APP_CONFIG.debug)
-          logger.log("[AvatarView] Setting background image from resources");
-        this.setBackgroundImage(resources.background);
-      }
       if (APP_CONFIG.debug)
         logger.log("[AvatarView] Starting rendering...");
       await this.renderFirstFrame();
@@ -13773,12 +13765,11 @@ class AvatarView {
     } else {
       logger.log("[AvatarView] No camera config in resources, using default static config:", this.cameraConfig);
     }
-    const backgroundColor = this._isOpaque ? [0, 0, 0, 1] : [0, 0, 0, 0];
     this.renderSystem = new RenderSystem({
       canvas: this.canvas,
       camera: this.cameraConfig,
-      backgroundColor,
-      alpha: !this._isOpaque
+      backgroundColor: [0, 0, 0, 0],
+      alpha: true
     });
     await this.renderSystem.initialize();
     if (APP_CONFIG.debug)
@@ -14267,37 +14258,6 @@ class AvatarView {
       fps: this.currentFPS
     };
   }
-  get isOpaque() {
-    return this._isOpaque;
-  }
-  set isOpaque(value) {
-    if (this._isOpaque === value) return;
-    this._isOpaque = value;
-    if (this.renderSystem && this.isInitialized) {
-      const bgColor = this._isOpaque ? [0, 0, 0, 1] : [0, 0, 0, 0];
-      this.renderSystem.updateBackgroundColor(bgColor);
-    }
-  }
-  setBackgroundImage(image) {
-    if (image === null) {
-      this.canvas.style.backgroundImage = "";
-    } else {
-      const imageUrl = typeof image === "string" ? image : image.src;
-      const img = new Image();
-      img.onload = () => {
-        this.canvas.style.background = "none";
-        this.canvas.style.backgroundImage = `url("${imageUrl}")`;
-        if (this._isOpaque && this.renderSystem && this.isInitialized) {
-          this.renderSystem.updateBackgroundColor([0, 0, 0, 0]);
-          this._isOpaque = false;
-        }
-      };
-      img.onerror = () => {
-        logger.error(`[AvatarView] Failed to load background image: ${imageUrl}`);
-      };
-      img.src = imageUrl;
-    }
-  }
   get transform() {
     if (!this.renderSystem) {
       throw new Error("Render system not initialized");

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-BxhQDfJ7.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-Bgw-52f-.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.40",
+  "version": "1.0.0-beta.42",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",
   "license": "MIT",

package/dist/playground/apps/web/src/api/auth.d.ts

@@ -1,3 +0,0 @@
-import { LoginResponse } from '../../../../generated/realtime/v1/auth';
-
-export declare function login(username: string, password?: string): Promise<LoginResponse>;

package/dist/playground/apps/web/src/api/character.d.ts

@@ -1,13 +0,0 @@
-import { RealtimeGetCharacterResponse, RealtimeListCharactersResponse } from '../../../../generated/realtime/v2/realtime';
-import { CharacterMeta } from '../types/character';
-export interface GetCharactersOptions {
-    pageSize?: number;
-    pageToken?: string;
-    characterStatus?: string[];
-}
-
-export declare function getCharacters(options?: GetCharactersOptions): Promise<RealtimeListCharactersResponse>;
-
-export declare function getCharacterById(characterId: string): Promise<CharacterMeta>;
-
-export declare function getCharacterRealtimeInfo(characterId: string): Promise<RealtimeGetCharacterResponse>;

package/dist/playground/apps/web/src/api/index.d.ts

@@ -1,3 +0,0 @@
-export * from './auth';
-export * from './character';
-export * from './redeem';

package/dist/playground/apps/web/src/api/redeem.d.ts

@@ -1,3 +0,0 @@
-import { RedeemCharacterResponse } from '../../../../generated/realtime/v1/redeem';
-
-export declare function redeemCharacter(code: string): Promise<RedeemCharacterResponse>;