@spatialwalk/avatarkit 1.0.0-beta.1 → 1.0.0-beta.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/CHANGELOG.md +185 -0
  2. package/README.md +450 -148
  3. package/dist/{StreamingAudioPlayer-C2TfYsO8.js → StreamingAudioPlayer-CLFmPod8.js} +88 -62
  4. package/dist/StreamingAudioPlayer-CLFmPod8.js.map +1 -0
  5. package/dist/animation/AnimationWebSocketClient.d.ts.map +1 -1
  6. package/dist/animation/utils/flameConverter.d.ts.map +1 -1
  7. package/dist/audio/AnimationPlayer.d.ts +4 -0
  8. package/dist/audio/AnimationPlayer.d.ts.map +1 -1
  9. package/dist/audio/StreamingAudioPlayer.d.ts +10 -0
  10. package/dist/audio/StreamingAudioPlayer.d.ts.map +1 -1
  11. package/dist/avatar_core_wasm-D4eEi7Eh.js +1666 -0
  12. package/dist/{avatar_core_wasm-DmkU6dYn.js.map → avatar_core_wasm-D4eEi7Eh.js.map} +1 -1
  13. package/dist/avatar_core_wasm.wasm +0 -0
  14. package/dist/config/app-config.d.ts +3 -7
  15. package/dist/config/app-config.d.ts.map +1 -1
  16. package/dist/config/constants.d.ts +19 -3
  17. package/dist/config/constants.d.ts.map +1 -1
  18. package/dist/core/Avatar.d.ts +0 -8
  19. package/dist/core/Avatar.d.ts.map +1 -1
  20. package/dist/core/AvatarController.d.ts +50 -74
  21. package/dist/core/AvatarController.d.ts.map +1 -1
  22. package/dist/core/AvatarDownloader.d.ts +0 -5
  23. package/dist/core/AvatarDownloader.d.ts.map +1 -1
  24. package/dist/core/AvatarKit.d.ts +3 -15
  25. package/dist/core/AvatarKit.d.ts.map +1 -1
  26. package/dist/core/AvatarManager.d.ts.map +1 -1
  27. package/dist/core/AvatarView.d.ts +47 -46
  28. package/dist/core/AvatarView.d.ts.map +1 -1
  29. package/dist/core/NetworkLayer.d.ts +59 -0
  30. package/dist/core/NetworkLayer.d.ts.map +1 -0
  31. package/dist/index-Ck21a9C4.js +5999 -0
  32. package/dist/index-Ck21a9C4.js.map +1 -0
  33. package/dist/index.d.ts +0 -1
  34. package/dist/index.d.ts.map +1 -1
  35. package/dist/index.js +11 -11
  36. package/dist/renderer/RenderSystem.d.ts +4 -2
  37. package/dist/renderer/RenderSystem.d.ts.map +1 -1
  38. package/dist/renderer/webgl/webglRenderer.d.ts.map +1 -1
  39. package/dist/types/index.d.ts +18 -0
  40. package/dist/types/index.d.ts.map +1 -1
  41. package/dist/utils/cls-tracker.d.ts +17 -0
  42. package/dist/utils/cls-tracker.d.ts.map +1 -0
  43. package/dist/utils/logger.d.ts +1 -1
  44. package/dist/utils/logger.d.ts.map +1 -1
  45. package/package.json +14 -18
  46. package/dist/StreamingAudioPlayer-C2TfYsO8.js.map +0 -1
  47. package/dist/avatar_core_wasm-DmkU6dYn.js +0 -1666
  48. package/dist/config/region-config.d.ts +0 -17
  49. package/dist/config/region-config.d.ts.map +0 -1
  50. package/dist/generated/google/protobuf/any.d.ts +0 -145
  51. package/dist/generated/google/protobuf/any.d.ts.map +0 -1
  52. package/dist/generated/jsonapi/v1/base.d.ts +0 -140
  53. package/dist/generated/jsonapi/v1/base.d.ts.map +0 -1
  54. package/dist/generated/platform/v1/asset_groups.d.ts +0 -225
  55. package/dist/generated/platform/v1/asset_groups.d.ts.map +0 -1
  56. package/dist/generated/platform/v1/assets.d.ts +0 -149
  57. package/dist/generated/platform/v1/assets.d.ts.map +0 -1
  58. package/dist/generated/platform/v1/character.d.ts +0 -395
  59. package/dist/generated/platform/v1/character.d.ts.map +0 -1
  60. package/dist/generated/platform/v1/redeem.d.ts +0 -22
  61. package/dist/generated/platform/v1/redeem.d.ts.map +0 -1
  62. package/dist/index-DwhR9l52.js +0 -9712
  63. package/dist/index-DwhR9l52.js.map +0 -1
  64. package/dist/utils/posthog-tracker.d.ts +0 -82
  65. package/dist/utils/posthog-tracker.d.ts.map +0 -1
  66. package/dist/utils/toast.d.ts +0 -74
  67. package/dist/utils/toast.d.ts.map +0 -1
@@ -1,82 +0,0 @@
1
- /**
2
- * PostHog Error & Event Tracking Utility
3
- *
4
- * Centralized tracking for realtime mode errors, warnings, and events.
5
- * Provides type-safe event tracking with privacy-aware property filtering.
6
- *
7
- * Environment-aware tracking:
8
- * - Development (DEV=true): Tracking disabled for faster development
9
- * - Test (VITE_ENV_TEST=true): Full detailed tracking enabled
10
- * - Production (default): Minimal tracking without verbose debug info
11
- */
12
- /**
13
- * Event categories for organizing telemetry data
14
- */
15
- export type EventCategory = 'connection' | 'audio' | 'vad' | 'sync' | 'playback' | 'wasm' | 'rendering' | 'user_action';
16
- /**
17
- * Connection tracking functions
18
- */
19
- export declare const PostHogTracker: {
20
- connection: {
21
- connectStart: (characterId: string) => void;
22
- connectSuccess: (characterId: string, durationMs: number) => void;
23
- connectFailed: (characterId: string, error: string, retryCount?: number) => void;
24
- reconnectAttempt: (retryCount: number) => void;
25
- reconnectFailed: (retryCount: number, error: string) => void;
26
- messageSendError: (messageType: string, error: string) => void;
27
- messageDecodeError: (error: string) => void;
28
- stateChange: (oldState: string, newState: string) => void;
29
- };
30
- audio: {
31
- deviceAccessRequest: (deviceType: "microphone" | "speaker") => void;
32
- deviceAccessGranted: (deviceType: "microphone" | "speaker") => void;
33
- deviceAccessDenied: (deviceType: "microphone" | "speaker", error: string) => void;
34
- bufferUnderrun: (bufferSize: number) => void;
35
- decodeError: (error: string) => void;
36
- contextInitFailed: (error: string) => void;
37
- contextSuspended: () => void;
38
- contextResumed: () => void;
39
- };
40
- vad: {
41
- initializeStart: () => void;
42
- initializeSuccess: (durationMs: number) => void;
43
- initializeFailed: (error: string) => void;
44
- speechStart: () => void;
45
- speechEnd: (durationMs: number) => void;
46
- speechReady: (audioDurationMs: number) => void;
47
- blocked: (reason: string) => void;
48
- unblocked: () => void;
49
- restartFailed: (error: string) => void;
50
- };
51
- sync: {
52
- bufferOverflow: (sessionId: string, bufferDurationMs: number) => void;
53
- alignmentIssue: (sessionId: string, driftMs: number) => void;
54
- sessionCreated: (sessionId: string) => void;
55
- sessionCleanup: (sessionId: string, audioChunks: number, flameKeyframes: number) => void;
56
- keyframeStarvation: (sessionId: string) => void;
57
- audioChunkStarvation: (sessionId: string) => void;
58
- };
59
- playback: {
60
- started: (sessionId: string) => void;
61
- ended: (sessionId: string, durationMs: number, chunksPlayed: number) => void;
62
- scheduleFailed: (sessionId: string, error: string) => void;
63
- interrupted: (sessionId: string) => void;
64
- };
65
- wasm: {
66
- computeError: (error: string) => void;
67
- conversionError: (error: string) => void;
68
- loadError: (error: string) => void;
69
- };
70
- rendering: {
71
- renderLoopError: (error: string) => void;
72
- splatLoadError: (error: string) => void;
73
- textOnlyStateDetected: (durationMs: number) => void;
74
- };
75
- user: {
76
- manualInterrupt: () => void;
77
- textSent: (success: boolean, error?: string) => void;
78
- speechSent: (success: boolean, error?: string) => void;
79
- vadToggled: (enabled: boolean) => void;
80
- };
81
- };
82
- //# sourceMappingURL=posthog-tracker.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"posthog-tracker.d.ts","sourceRoot":"","sources":["../../utils/posthog-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH;;GAEG;AACH,MAAM,MAAM,aAAa,GACnB,YAAY,GACZ,OAAO,GACP,KAAK,GACL,MAAM,GACN,UAAU,GACV,MAAM,GACN,WAAW,GACX,aAAa,CAAA;AAyLnB;;GAEG;AACH,eAAO,MAAM,cAAc;;oCAGK,MAAM,KAAG,IAAI;sCAOX,MAAM,cAAc,MAAM,KAAG,IAAI;qCAQlC,MAAM,SAAS,MAAM,eAAc,MAAM,KAAO,IAAI;uCASlD,MAAM,KAAG,IAAI;sCAOd,MAAM,SAAS,MAAM,KAAG,IAAI;wCAQ1B,MAAM,SAAS,MAAM,KAAG,IAAI;oCAOhC,MAAM,KAAG,IAAI;gCAOjB,MAAM,YAAY,MAAM,KAAG,IAAI;;;0CAUrB,YAAY,GAAG,SAAS,KAAG,IAAI;0CAO/B,YAAY,GAAG,SAAS,KAAG,IAAI;yCAQhC,YAAY,GAAG,SAAS,SAAS,MAAM,KAAG,IAAI;qCASlD,MAAM,KAAG,IAAI;6BAOrB,MAAM,KAAG,IAAI;mCAOP,MAAM,KAAG,IAAI;gCAOlB,IAAI;8BAMN,IAAI;;;+BASH,IAAI;wCAOO,MAAM,KAAG,IAAI;kCAQnB,MAAM,KAAG,IAAI;2BAQtB,IAAI;gCAOG,MAAM,KAAG,IAAI;uCAON,MAAM,KAAG,IAAI;0BAO1B,MAAM,KAAG,IAAI;yBAOhB,IAAI;+BAMI,MAAM,KAAG,IAAI;;;oCAUR,MAAM,oBAAoB,MAAM,KAAG,IAAI;oCAQvC,MAAM,WAAW,MAAM,KAAG,IAAI;oCAQ9B,MAAM,KAAG,IAAI;oCAOb,MAAM,eAAe,MAAM,kBAAkB,MAAM,KAAG,IAAI;wCAStD,MAAM,KAAG,IAAI;0CAOX,MAAM,KAAG,IAAI;;;6BAU1B,MAAM,KAAG,IAAI;2BAOf,MAAM,cAAc,MAAM,gBAAgB,MAAM,KAAG,IAAI;oCAS9C,MAAM,SAAS,MAAM,KAAG,IAAI;iCAQ/B,MAAM,KAAG,IAAI;;;8BAUhB,MAAM,KAAG,IAAI;iCAQV,MAAM,KAAG,IAAI;2BAQnB,MAAM,KAAG,IAAI;;;iCAWP,MAAM,KAAG,IAAI;gCAOd,MAAM,KAAG,IAAI;4CAOD,MAAM,KAAG,IAAI;;;+BAU5B,IAAI;4BAQL,OAAO,UAAU,MAAM,KAAG,IAAI;8BAS5B,OAAO,UAAU,MAAM,KAAG,IAAI;8BAS9B,OAAO,KAAG,IAAI;;CAQvC,CAAA"}
@@ -1,74 +0,0 @@
1
- /**
2
- * Toast Utility Library
3
- * 使用原生API替代vue-sonner,提供环境感知的提示功能
4
- * - Only shows debug/info/success toasts in test/dev environment
5
- * - Only shows fatal errors in production environment
6
- * - Loading toasts show detailed content only in test/dev environment
7
- */
8
- /**
9
- * Toast options interface
10
- */
11
- export interface ToastOptions {
12
- description?: string;
13
- duration?: number;
14
- action?: {
15
- label: string;
16
- onClick: () => void;
17
- };
18
- }
19
- /**
20
- * Native Toast Implementation
21
- * 使用原生API替代vue-sonner
22
- */
23
- export declare const toast: {
24
- /**
25
- * Success toast - only shown in test/dev environment
26
- */
27
- success(_message: string, _options?: ToastOptions): string | number | undefined;
28
- /**
29
- * Error toast - only shown for fatal errors in production
30
- * In dev/test, all errors are shown
31
- */
32
- error(_message: string, _options?: ToastOptions): string | number | undefined;
33
- /**
34
- * Info toast - only shown in test/dev environment
35
- */
36
- info(message: string, options?: ToastOptions): string | number | undefined;
37
- /**
38
- * Warning toast - only shown in test/dev environment
39
- */
40
- warning(message: string, options?: ToastOptions): string | number | undefined;
41
- /**
42
- * Loading toast - only shown in test/dev environment
43
- */
44
- loading(_message: string, _options?: ToastOptions): string | number | undefined;
45
- /**
46
- * Dismiss toast
47
- */
48
- dismiss(_toastId: string | number): void;
49
- /**
50
- * Custom toast - only shown in test/dev environment
51
- */
52
- custom(_component: unknown, _options?: ToastOptions): string | number | undefined;
53
- /**
54
- * Promise toast - only shown in test/dev environment
55
- */
56
- promise<T>(promise: Promise<T>, options: {
57
- loading: string;
58
- success: string | ((data: T) => string);
59
- error: string | ((error: unknown) => string);
60
- }): Promise<T>;
61
- };
62
- /**
63
- * Export individual functions for convenience
64
- */
65
- export declare const success: (_message: string, _options?: ToastOptions) => string | number | undefined, error: (_message: string, _options?: ToastOptions) => string | number | undefined, info: (message: string, options?: ToastOptions) => string | number | undefined, warning: (message: string, options?: ToastOptions) => string | number | undefined, loading: (_message: string, _options?: ToastOptions) => string | number | undefined, dismiss: (_toastId: string | number) => void, custom: (_component: unknown, _options?: ToastOptions) => string | number | undefined, promise: <T>(promise: Promise<T>, options: {
66
- loading: string;
67
- success: string | ((data: T) => string);
68
- error: string | ((error: unknown) => string);
69
- }) => Promise<T>;
70
- /**
71
- * Default export
72
- */
73
- export default toast;
74
- //# sourceMappingURL=toast.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../utils/toast.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,IAAI,CAAA;KACpB,CAAA;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK;IAChB;;OAEG;sBACe,MAAM,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAS/E;;;OAGG;oBACa,MAAM,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAU7E;;OAEG;kBACW,MAAM,YAAY,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAS1E;;OAEG;qBACc,MAAM,YAAY,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAS7E;;OAEG;sBACe,MAAM,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ/E;;OAEG;sBACe,MAAM,GAAG,MAAM,GAAG,IAAI;IAMxC;;OAEG;uBACgB,OAAO,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAQjF;;OAEG;YACK,CAAC,WACE,OAAO,CAAC,CAAC,CAAC,WACV;QACP,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAA;QACvC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;KAC7C,GACA,OAAO,CAAC,CAAC,CAAC;CAoBd,CAAA;AAED;;GAEG;AACH,eAAO,MAAQ,OAAO,aAjHF,MAAM,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAiHzD,KAAK,aApGX,MAAM,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAoGhD,IAAI,YAvFnB,MAAM,YAAY,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAuFvC,OAAO,YA3EzB,MAAM,YAAY,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EA2EjC,OAAO,aA/DjC,MAAM,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EA+D1B,OAAO,aApD1C,MAAM,GAAG,MAAM,KAAG,IAAI,EAoDsB,MAAM,eA3CjD,OAAO,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EA2CX,OAAO,GAhCrE,CAAC,WACE,OAAO,CAAC,CAAC,CAAC,WACV;IACP,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAA;IACvC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;CAC7C,KACA,OAAO,CAAC,CAAC,CAyB2E,CAAA;AAEzF;;GAEG;AACH,eAAe,KAAK,CAAA"}