@spatius/avatarkit 1.0.0 → 1.2.0-beta.1

package/dist/index.js

@@ -1,21 +1,24 @@
-import { j, b, c, n, f, d, m, g, C, k, h, D, E, i, L, R, T, o } from "./index-zTpDp_Pv.js";
+import { k, b, c, o, f, d, n, g, C, m, i, D, E, F, j, L, h, R, p, T, q } from "./index-DHCQ9wsL.js";
 export {
-  j as AnimationType,
+  k as AnimationType,
   b as Avatar,
   c as AvatarController,
-  n as AvatarError,
+  o as AvatarError,
   f as AvatarManager,
   d as AvatarSDK,
-  m as AvatarState,
+  n as AvatarState,
   g as AvatarView,
   C as ConnectionState,
-  k as ConversationState,
-  h as DEFAULT_REGION,
+  m as ConversationState,
+  i as DEFAULT_REGION,
   D as DrivingServiceMode,
   E as ErrorCode,
-  i as LoadProgress,
+  F as FrameStarvationMode,
+  j as LoadProgress,
   L as LogLevel,
-  R as ResourceType,
+  h as RENDER_QUALITY_PARAMS,
+  R as RenderQuality,
+  p as ResourceType,
   T as TransitionType,
-  o as extractResourceUrls
+  q as extractResourceUrls
 };

package/dist/types/character-settings.d.ts

@@ -23,7 +23,6 @@ export interface TransformSettings {
 }
 export interface CharacterSettings {
     eyelid: EyelidSettings;
-    eyefocus?: EyelidSettings;
     camera: CameraSettings;
     transform?: TransformSettings;
 }

package/dist/types/index.d.ts

@@ -3,9 +3,22 @@
  */
 export declare enum DrivingServiceMode {
     /** Driven by SDK directly */
-    sdk = "sdk",
+    direct = "direct",
     /** Driven by host application */
-    host = "host"
+    backend = "backend"
+}
+/**
+ * Strategy for handling animation-frame starvation (animation frames can't keep up
+ * with the audio clock).
+ *
+ * - `audioIndependent` (default): audio keeps playing, animation catches up; starvation
+ *   is only reported as telemetry. This is the historical default behavior.
+ * - `strictSync`: pause audio and wait when frames run out, resume once new frames
+ *   arrive, notifying via `AvatarController.onPlaybackStall`.
+ */
+export declare enum FrameStarvationMode {
+    audioIndependent = "audioIndependent",
+    strictSync = "strictSync"
 }
 export declare enum LogLevel {
     /** Disable all logs */
@@ -23,8 +36,15 @@ export interface AudioFormat {
     /** Sample rate, supported: 8000, 16000, 22050, 24000, 32000, 44100, 48000, default: 16000 */
     readonly sampleRate: number;
 }
+export declare enum RenderQuality {
+    standard = "standard",
+    high = "high",
+    ultra = "ultra"
+}
 export interface Configuration {
-    /** Driving service mode, default is sdk */
+    /** Region used to compose endpoint URLs (default 'us-west'). Not part of the public quickstart. */
+    readonly region?: string;
+    /** Driving service mode, default is direct */
     readonly drivingServiceMode?: DrivingServiceMode;
     /** Log level, default is off */
     readonly logLevel?: LogLevel;
@@ -32,6 +52,8 @@ export interface Configuration {
     readonly audioFormat?: AudioFormat;
     /** Custom endpoint overriding the region-derived host for both character API and driving WebSocket. */
     readonly customEndpoint?: string;
+    /** Render quality tier, default is RenderQuality.ultra */
+    readonly renderQuality?: RenderQuality;
 }
 export declare enum LoadProgress {
     downloading = "downloading",
@@ -81,6 +103,8 @@ export declare enum ErrorCode {
     avatarIDUnrecognized = "avatarIDUnrecognized",
     /** Failed to fetch avatar metadata */
     failedToFetchAvatarMetadata = "failedToFetchAvatarMetadata",
+    /** Avatar metadata format invalid / failed to parse */
+    invalidAvatarMetadata = "invalidAvatarMetadata",
     /** Failed to download avatar assets */
     failedToDownloadAvatarAssets = "failedToDownloadAvatarAssets",
     /** WebSocket connection error (handshake failure, network error) */
@@ -169,13 +193,6 @@ export interface PostProcessingConfig {
     eyeBlink?: number;
     /** Expression weight (0.0-2.0, 0=no expression, 1=normal, >1=enhanced) */
     expressionWeight?: number;
-    /** Eye tracking complete configuration (real-time control of eye_focus, must provide complete configuration) */
-    eyefocus?: {
-        enabled: boolean;
-        auto_eyelid_adjustment?: boolean;
-        eyelid_threshold?: number;
-        targets?: number[];
-    };
 }
 export interface CharacterInfo {
     pointCount: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatius/avatarkit",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.2.0-beta.1",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",
@@ -48,6 +48,7 @@
     "build": "SDK_BUILD=true vite build --mode library && npm run build:vite-plugin && npm run build:next-plugin",
     "build:vite-plugin": "tsc vite.ts --outDir . --module esnext --target es2020 --moduleResolution bundler --esModuleInterop --skipLibCheck --declaration --declarationMap",
     "build:next-plugin": "tsc next.ts --outDir . --module esnext --target es2020 --moduleResolution bundler --esModuleInterop --skipLibCheck --declaration --declarationMap",
+    "prepare": "npm run build",
     "dev": "vite build --mode library --watch",
     "demo": "vite --config demo/vite.config.mjs",
     "demo:benchmark": "vite --config benchmark-demo/vite.config.mjs",
@@ -75,6 +76,12 @@
   "dependencies": {
     "@bufbuild/protobuf": "^2.10.0",
     "@guiiai/logg": "^1.2.4",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/api-logs": "^0.218.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.218.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-logs": "^0.218.0",
+    "@opentelemetry/semantic-conventions": "^1.41.1",
     "nanoid": "^5.1.6",
     "posthog-js": "^1.310.1"
   },