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

package/dist/types/index.d.ts

@@ -1,19 +1,39 @@
-/**
- * 统一公开类型 & 接口
- */
 export declare enum Environment {
     cn = "cn",
-    us = "us",
-    test = "test"
+    intl = "intl"
+}
+export declare enum DrivingServiceMode {
+
+    sdk = "sdk",
+
+    host = "host"
+}
+export declare enum LogLevel {
+
+    off = "off",
+
+    error = "error",
+
+    warning = "warning",
+
+    all = "all"
+}
+export interface AudioFormat {
+    readonly channelCount: 1;
+    readonly sampleRate: number;
 }
 export interface Configuration {
     readonly environment: Environment;
+    readonly drivingServiceMode?: DrivingServiceMode;
+    readonly logLevel?: LogLevel;
+    readonly audioFormat?: AudioFormat;
+    readonly characterApiBaseUrl?: string;
 }
 export interface SdkConfigResponse {
     endpoints: {
         cn?: string;
+        intl?: string;
         us?: string;
-        test?: string;
     };
 }
 export declare enum LoadProgress {
@@ -32,14 +52,31 @@ export declare enum ConnectionState {
     connected = "connected",
     failed = "failed"
 }
-export declare enum AvatarState {
-    idle = "idle",// 空闲状态，呈现呼吸态
-    active = "active",// 活跃中，等待可播放内容
-    playing = "playing"
+export declare enum ConversationState {
+
+    idle = "idle",
+
+    playing = "playing",
+
+    pausing = "pausing"
+}
+export declare enum ErrorCode {
+
+    appIDUnrecognized = "appIDUnrecognized",
+
+    avatarIDUnrecognized = "avatarIDUnrecognized",
+
+    sessionTokenInvalid = "sessionTokenInvalid",
+
+    sessionTokenExpired = "sessionTokenExpired",
+
+    failedToFetchAvatarMetadata = "failedToFetchAvatarMetadata",
+
+    failedToDownloadAvatarAssets = "failedToDownloadAvatarAssets"
 }
 export declare class SPAvatarError extends Error {
-    code?: string | undefined;
-    constructor(message: string, code?: string | undefined);
+    code?: (string | ErrorCode) | undefined;
+    constructor(message: string, code?: (string | ErrorCode) | undefined);
 }
 export interface FlatSplatData {
     positions: Float32Array;
@@ -58,29 +95,28 @@ export interface CameraConfig {
     up?: [number, number, number];
     aspect?: number;
 }
-export interface RenderPerformanceStats {
-    renderTime: number;
-    sortTime: number;
-    backend: 'webgpu' | 'webgl' | null;
-    pointCount?: number;
-}
-/**
- * 播放模式
- */
-export declare enum AvatarPlaybackMode {
-    /** 网络模式：通过 WebSocket 发送音频，接收动画数据 */
-    network = "network",
-    /** 外部数据模式：外部提供音频和动画数据, SDK 负责同步播放 */
-    external = "external"
-}
-/**
- * AvatarView 配置选项
- */
-export interface AvatarViewOptions {
-    /** 播放模式 */
-    playbackMode?: AvatarPlaybackMode;
-    /** Canvas 容器 */
-    container?: HTMLElement;
+
+export interface PostProcessingConfig {
+    rotation?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    neckPose?: {
+        x?: number;
+        y?: number;
+        z?: number;
+        weightX?: number;
+        weightY?: number;
+        weightZ?: number;
+    };
+    jawPose?: {
+        x?: number;
+        y?: number;
+        z?: number;
+        weight?: number;
+    };
+    eyeBlink?: number;
+    expressionWeight?: number;
 }
 export * from './character';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,17 +1,7 @@
 import { Flame } from '../generated/driveningress/v1/driveningress';
-/**
- * Linear interpolation with cosine easing (ease-in-ease-out)
- * 0.5 - cos(progress * π) * 0.5
- */
+
 export declare function linearLerp(from: Flame, to: Flame, progress: number): Flame;
-/**
- * Generate transition keyframes between two Flame states
- * @param durationMs Transition duration (e.g. 400ms)
- * @param fps Frames per second (default 25)
- */
+
 export declare function generateTransitionFrames(from: Flame, to: Flame, durationMs: number, fps?: number): Flame[];
-/**
- * Create a neutral Flame
- */
+
 export declare function createNeutralFlame(): Flame;
-//# sourceMappingURL=animation-interpolation.d.ts.map

package/dist/utils/client-id.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/conversationId.d.ts

@@ -0,0 +1 @@
+export declare function generateConversationId(): string;

package/dist/utils/error-utils.d.ts

@@ -1,27 +1,3 @@
-/**
- * Error Utility Functions
- * Provides consistent error handling and formatting across the application
- */
-/**
- * Convert unknown error to a readable error message string
- *
- * @param err - Unknown error object (could be Error, string, object, etc.)
- * @returns Formatted error message string
- *
- * @example
- * try {
- *   riskyOperation()
- * } catch (err) {
- *   const message = errorToMessage(err)
- *   logger.error('Operation failed:', message)
- * }
- */
 export declare function errorToMessage(err: unknown): string;
-/**
- * Convert unknown error to a detailed error message with stack trace (for logging)
- *
- * @param err - Unknown error object
- * @returns Detailed error message with stack if available
- */
+
 export declare function errorToDetailedMessage(err: unknown): string;
-//# sourceMappingURL=error-utils.d.ts.map

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

@@ -0,0 +1,18 @@
+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 {};

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

@@ -0,0 +1,38 @@
+export interface SdkIds {
+    clientId: string;
+    userId: string | null;
+    appId: string | null;
+    sessionToken: string | null;
+    connectionId: string | null;
+    conversationId: string | null;
+}
+declare class IdManager {
+    private ids;
+    constructor();
+    getClientId(): string;
+    setUserId(userId: string | null): void;
+    getUserId(): string | null;
+    setAppId(appId: string | null): void;
+    getAppId(): string | null;
+    setSessionToken(token: string | null): void;
+    getSessionToken(): string | null;
+    generateConnectionId(): string;
+    setConnectionId(connectionId: string | null): void;
+    getConnectionId(): string | null;
+    clearConnectionId(): void;
+    generateNewConversationId(): string;
+    getConversationId(): string | null;
+    setConversationId(conversationId: string | null): void;
+    clearConversationId(): void;
+    getAllIds(): Readonly<SdkIds>;
+    getLogContext(): {
+        client_id: string;
+        user_id: string;
+        app_id: string;
+        connection_id?: string;
+        conversation_id?: string;
+    };
+    clear(): void;
+}
+export declare const idManager: IdManager;
+export {};

package/dist/utils/logger.d.ts

@@ -1,20 +1,15 @@
-/**
- * Logger Utility
- * Environment-aware logger wrapper
- * - Logs normally in test/dev environment
- * - In production: silently logs to console
- * - Errors and warnings are always reported to CLS (when enabled)
- *
- * Usage: Replace `console.log()` with `logger.log()`
- */
+import { LogLevel as GuiiaiLogLevel } from '@guiiai/logg';
+import { LogLevel } from '../types';
 export declare const logger: import('@guiiai/logg').Logg;
+
+export declare function setLogLevel(level: LogLevel): void;
 export declare const loggerWithUnknown: {
     error: (message: string, error?: unknown) => void;
     warn: (message: string, error?: unknown) => void;
     useGlobalConfig: () => import('@guiiai/logg').Logg;
     child: (fields?: Record<string, any>) => import('@guiiai/logg').Logg;
     withContext: (context: string) => import('@guiiai/logg').Logg;
-    withLogLevel: (logLevel: import('@guiiai/logg').LogLevel) => import('@guiiai/logg').Logg;
+    withLogLevel: (logLevel: GuiiaiLogLevel) => import('@guiiai/logg').Logg;
     withLogLevelString: (logLevelString: import('@guiiai/logg').LogLevelString) => import('@guiiai/logg').Logg;
     withFormat: (format: import('@guiiai/logg').Format) => import('@guiiai/logg').Logg;
     withFields: (fields: Record<string, any>) => import('@guiiai/logg').Logg;
@@ -32,4 +27,3 @@ export declare const loggerWithUnknown: {
     withTimeFormatter: (fn: (inputDate: Date) => string) => import('@guiiai/logg').Logg;
     withErrorProcessor: (fn: (err: Error | unknown) => Error | unknown) => import('@guiiai/logg').Logg;
 };
-//# sourceMappingURL=logger.d.ts.map

package/dist/utils/posthog-tracker.d.ts

@@ -0,0 +1,11 @@
+import { Environment } from '../types';
+
+export declare function initializePostHog(environment: Environment, version: string): void;
+
+export declare function trackEvent(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): void;
+
+export declare function sendEventViaBeacon(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): boolean;
+
+export declare function cleanupPostHog(): void;
+
+export declare function logEvent(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): void;

package/dist/utils/usage-tracker.d.ts

@@ -0,0 +1,5 @@
+export declare function isFirstUse(): boolean;
+
+export declare function isDailyActive(): boolean;
+
+export declare function getLastActiveDate(): string | null;

package/dist/vanilla/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vite').UserConfig;
+export default _default;

package/dist/wasm/avatarCoreAdapter.d.ts

@@ -1,4 +1,3 @@
-import { AvatarCoreMemoryManager } from './avatarCoreMemory';
 export interface WasmModuleConfig {
     baseUrl?: string;
     [key: string]: unknown;
@@ -46,6 +45,8 @@ export declare class AvatarCoreAdapter {
     private wasmModule;
     private memoryManager;
     private coreHandle;
+    private characterHandles;
+    private animationHandles;
     private characterHandle;
     private animationHandle;
     private totalFrames;
@@ -58,131 +59,44 @@ export declare class AvatarCoreAdapter {
     private flameInfo?;
     private characterInfo?;
     constructor(options?: AvatarCoreOptions);
-    /**
-     * 加载 WASM 模块并设置 API
-     * 每次都创建全新的 WASM 实例，确保 C++ 内存是干净的
-     *
-     * 注意：这里使用动态 import() 导入 WASM 模块。
-     * Vite 在构建时会自动为 WASM 文件和 JS glue 代码添加 hash（如 avatar_core_wasm-CxWuw7eS.wasm），
-     * 确保浏览器缓存与版本一致，不会有缓存问题。
-     *
-     * Hash 的作用机制：
-     * - WASM 文件内容变化 → hash 自动变化 → URL 变化 → 浏览器拉取新版本
-     * - WASM 文件内容不变 → hash 保持不变 → URL 不变 → 浏览器使用缓存
-     * - Emscripten 生成的 JS 内部会使用 hard-coded 的 hash 路径加载 .wasm 文件
-     */
     loadWASMModule(): Promise<void>;
-    /**
-     * 验证 WASM 模块功能
-     */
     private validateWASMModule;
-    /**
-     * 初始化内存视图
-     */
     private initializeMemoryViews;
-    /**
-     * 设置 C API 函数包装
-     */
     private setupCAPIFunctions;
-    /**
-     * 读取当前动画帧的 FlameParams（用于过渡或调试）
-     */
-    getCurrentFrameParams(frameIndex?: number): Promise<FlameParams>;
-    /**
-     * 初始化 Avatar Core 核心
-     */
+    getCurrentFrameParams(frameIndex?: number, characterId?: string): Promise<FlameParams>;
     private initializeAvatarCore;
-    /**
-     * 加载模板资源（从预加载的 ArrayBuffers）
-     */
     loadTemplateResourcesFromBuffers(templateResources: Record<string, ArrayBuffer>): Promise<boolean>;
-    /**
-     * 加载角色数据（从预加载的 ArrayBuffers）
-     */
-    loadCharacterFromBuffers(shapeBuffer: ArrayBuffer, pointCloudBuffer: ArrayBuffer): Promise<boolean>;
+    loadCharacterFromBuffers(shapeBuffer: ArrayBuffer, pointCloudBuffer: ArrayBuffer, characterId?: string): Promise<number>;
     private loadAnimationFromData;
-    /**
-     * Load animation from ArrayBuffer (for CDN-based dynamic loading)
-     */
-    loadAnimationFromBuffer(animData: ArrayBuffer): Promise<number>;
+    loadAnimationFromBuffer(animData: ArrayBuffer, characterId?: string): Promise<number>;
     switchAnimationFile(animationFile: string): Promise<number>;
-    /**
-     * 获取动画总帧数
-     */
-    getAnimationTotalFrames(): Promise<number>;
-    /**
-     * 从动画中获取指定帧的参数
-     */
-    getAnimationFrameParams(frameIndex?: number): Promise<number>;
-    /**
-     * 设置眼部追踪配置（对齐 app 实现）
-     */
+    getAnimationTotalFrames(animationHandle?: number): Promise<number>;
+    getAnimationFrameParams(frameIndex?: number, characterId?: string): Promise<number>;
     setEyeTrackingConfig(config: {
         enabled: boolean;
         auto_eyelid_adjustment?: boolean;
         eyelid_threshold?: number;
     }): Promise<boolean>;
-    /**
-     * 设置眼部追踪目标（高级功能）
-     */
     setGazeTarget(x: number, y: number, z: number): Promise<boolean>;
-    /**
-     * 重置眼部追踪
-     */
     resetEyeTracking(): Promise<boolean>;
-    /**
-     * 查询 FLAME 模型信息
-     */
     private queryFlameInfo;
-    /**
-     * 查询角色信息
-     */
     private queryCharacterInfo;
-    /**
-     * 检查错误码并抛出异常
-     */
     private checkError;
-    /**
-     * 更新进度回调
-     */
     private updateProgress;
-    /**
-     * 获取性能指标
-     */
     getPerformanceMetrics(): PerformanceMetrics & {
-        memoryStats?: ReturnType<AvatarCoreMemoryManager['getMemoryStats']>;
         flameInfo?: FlameInfo;
         characterInfo?: CharacterInfo;
         version?: string;
     };
-    /**
-     * 释放当前角色和动画资源（但保留 core）
-     */
+    removeCharacter(characterHandle: number, characterId?: string): void;
     releaseCurrentCharacter(): void;
-    /**
-     * 释放所有资源（包括 core）
-     */
     release(): void;
-    /**
-     * 兼容性接口：提供与 FlameComplete3DGSManager 相同的接口
-     */
     loadFlameModel(_modelData: any): Promise<boolean>;
     load3DGSData(_original3DGSPoints: any, _binding: any, _flameFaces: any): Promise<boolean>;
-    /**
-     * 计算帧并返回 GPU 友好的 flat 格式（零拷贝，协方差预计算）
-     * 🚀 性能优化版本：
-     * - C++ 预计算协方差矩阵
-     * - 零拷贝直接访问 WASM 内存http://localhost:3000/us/
-     * - 直接输出 GPU 格式 [pos3, color4, cov6]
-     */
     computeCompleteFrameFlat(params?: {
         frameIndex?: number;
-    }): Promise<Float32Array | null>;
-    /**
-     * 计算帧并返回 GPU 友好的 flat 格式（从 FLAME 参数）
-     * 🔑 用于 Realtime: 接受自定义 FLAME 参数并计算 Splat
-     */
-    computeFrameFlatFromParams(flameParams: FlameParams): Promise<Float32Array | null>;
+    }, characterHandle?: number): Promise<Float32Array | null>;
+    computeFrameFlatFromParams(flameParams: FlameParams, characterHandle?: number): Promise<Float32Array | null>;
+    getWASMMemoryMB(): number | null;
 }
 export {};
-//# sourceMappingURL=avatarCoreAdapter.d.ts.map

package/dist/wasm/avatarCoreMemory.d.ts

@@ -1,9 +1,3 @@
-/**
- * Avatar Core WASM 内存管理工具
- *
- * 提供高效的内存分配、数据传递和零拷贝访问功能
- * 专门为 avatar_core_wasm 优化
- */
 interface WASMModule {
     _malloc: (size: number) => number;
     _free: (ptr: number) => void;
@@ -47,22 +41,13 @@ export declare class AvatarCoreMemoryManager {
     private allocatedPointers;
     private structPointers;
     constructor(wasmModule: WASMModule);
-    /**
-     * 分配 WASM 内存并复制数据 - 纯 API 方式
-     */
     allocateAndCopy(arrayBuffer: ArrayBuffer): MemoryAllocation;
-    /**
-     * 创建 AvatarTemplateConfig 结构体
-     */
     createTemplateConfig(resources: TemplateResources): number;
-    /**
-     * 创建 AvatarCharacterData 结构体 - 新版 Emscripten 方式
-     */
-    createCharacterData(shapeBuffer: ArrayBuffer, plyBuffer: ArrayBuffer): number;
-    /**
-     * 读取 AvatarFlameParams 结构体数据
-     * Used to extract current animation frame parameters from WASM memory
-     */
+    createCharacterData(shapeBuffer: ArrayBuffer, plyBuffer: ArrayBuffer, characterId?: string): {
+        dataPtr: number;
+        shapePtr: number;
+        plyPtr: number;
+    };
     readFlameParams(paramsPtr: number): {
         shape_params: number[];
         expr_params: number[];
@@ -74,9 +59,6 @@ export declare class AvatarCoreMemoryManager {
         eyelid: number[];
         has_eyelid: boolean;
     };
-    /**
-     * 创建 AvatarFlameParams 结构体 - 新版 Emscripten 方式
-     */
     createFlameParams(params: {
         shape_params?: number[];
         expr_params?: number[];
@@ -88,25 +70,7 @@ export declare class AvatarCoreMemoryManager {
         eyelid?: number[];
         has_eyelid?: boolean;
     }): number;
-    /**
-     * 读取 AvatarSplatPointFlatArray 结构体数据（预计算协方差）
-     *
-     * 结构体布局:
-     * - AvatarSplatPointFlat* points (0-3, 32位指针)
-     * - uint32_t point_count (4-7)
-     * - float compute_time_ms (8-11)
-     *
-     * 每个点布局 (52 bytes):
-     * - position[3]   (12 bytes)
-     * - color[4]      (16 bytes, RGBA)
-     * - covariance[6] (24 bytes, 预计算好的协方差矩阵上三角)
-     *
-     * ⚠️ 使用 getValue 逐个读取，避免动态内存的 HEAPF32 detachment 问题
-     */
     readSplatPointFlatArray(arrayPtr: number): Float32Array | null;
-    /**
-     * 读取AvatarMeshData结构体数据
-     */
     readMeshData(outputPtr: number): {
         vertices: Float32Array;
         vertexCount: number;
@@ -116,21 +80,9 @@ export declare class AvatarCoreMemoryManager {
         landmarkCount: number;
         computeTime: number;
     };
-    /**
-     * 释放指定指针的内存
-     */
     free(ptr: number): void;
-    /**
-     * 释放结构体内存
-     */
     freeStruct(name: string): void;
-    /**
-     * 清理所有分配的内存
-     */
     cleanup(): void;
-    /**
-     * 获取内存使用统计
-     */
     getMemoryStats(): {
         allocatedPointers: number;
         structPointers: number;
@@ -138,4 +90,3 @@ export declare class AvatarCoreMemoryManager {
     };
 }
 export {};
-//# sourceMappingURL=avatarCoreMemory.d.ts.map

package/dist/withJoi/admin/eslint.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;