@spatialwalk/avatarkit 1.0.0-beta.6 → 1.0.0-beta.61

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/pwa-cache-manager.d.ts

@@ -0,0 +1,16 @@
+export declare class PwaCacheManager {
+    private static readonly TEMPLATE_RESOURCE_VERSION;
+    private static readonly TEMPLATE_CACHE_NAME;
+    private static readonly TEMPLATE_VERSION_STORAGE_KEY;
+    private static readonly CHARACTER_CACHE_PREFIX;
+    private static readonly CHARACTER_CACHE_SUFFIX;
+    private static readonly MAX_CHARACTER_CACHE_ENTRIES;
+    static isSupported(): boolean;
+    private static getCharacterCacheName;
+    static getCharacterResource(characterId: string, url: string): Promise<ArrayBuffer | null>;
+    static putCharacterResource(characterId: string, url: string, data: ArrayBuffer): Promise<void>;
+    static getTemplateResource(url: string): Promise<ArrayBuffer | null>;
+    static putTemplateResource(url: string, data: ArrayBuffer): Promise<void>;
+    static clearCharacterCache(characterId: string): Promise<void>;
+    static checkTemplateCacheVersion(): Promise<boolean>;
+}

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,45 @@ 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>;
-    /**
-     * 重置眼部追踪
-     */
+    }, characterId?: string): Promise<boolean>;
+    setGazeTarget(x: number, y: number, z: number, characterId?: string): 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）
-     */
+    getPointCount(characterHandle?: number): number | null;
+    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/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.6",
-  "packageManager": "pnpm@10.18.2",
+  "version": "1.0.0-beta.61",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",
   "license": "MIT",
@@ -32,28 +31,31 @@
     "CHANGELOG.md",
     "dist"
   ],
-  "scripts": {
-    "build": "SDK_BUILD=true vite build --mode library",
-    "dev": "vite build --mode library --watch",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit",
-    "test": "cd tests && pnpm test",
-    "test:watch": "cd tests && pnpm run test:watch",
-    "test:e2e": "cd tests && pnpm run test:e2e"
-  },
   "peerDependencies": {
     "@webgpu/types": "*"
   },
   "dependencies": {
     "@bufbuild/protobuf": "^2.10.0",
     "@guiiai/logg": "^1.2.4",
-    "nanoid": "^5.1.6"
+    "nanoid": "^5.1.6",
+    "posthog-js": "^1.310.1"
   },
   "devDependencies": {
     "@types/node": "^20.11.30",
     "@webgpu/types": "^0.1.65",
+    "tsx": "^4.20.6",
     "typescript": "^5.0.0",
     "vite": "^5.0.0",
     "vite-plugin-dts": "^4.5.4"
+  },
+  "scripts": {
+    "build": "SDK_BUILD=true vite build --mode library",
+    "dev": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "cd tests && pnpm test",
+    "test:watch": "cd tests && pnpm run test:watch",
+    "test:e2e": "cd tests && pnpm run test:e2e",
+    "test:perf": "cd tests && pnpm run test:perf"
   }
-}
+}