@spatialwalk/avatarkit-rtc 1.0.0-beta.8 → 1.0.0-beta.9

package/README.md

@@ -1,577 +1,8 @@
 # @spatialwalk/avatarkit-rtc
 
-Unified RTC adapter for avatarkit - supports LiveKit, Agora and other RTC providers.
+RTC adapter for [avatarkit](https://www.npmjs.com/package/@spatialwalk/avatarkit) - currently supports LiveKit and Agora.
 
-📚 **Documentation**: [https://docs.spatialreal.ai/web-sdk/introduction](https://docs.spatialreal.ai/web-sdk/introduction)
-
-> For server-side RTC SDK integration, please refer to the [online documentation](https://docs.spatialreal.ai/web-sdk/introduction).
-
-## Installation
-
-**⚠️ IMPORTANT: This package does NOT work standalone. You MUST install the dependencies below.**
-
-### Required Dependencies
-
-| Package | Purpose | Required |
-|---------|---------|----------|
-| `@spatialwalk/avatarkit` | Web SDK for avatar rendering | ✅ Yes |
-| `@spatialwalk/avatarkit-rtc` | This package - RTC adapter | ✅ Yes |
-| `livekit-client@2.16.1` | LiveKit RTC SDK (must be exact version) | ⚡ Choose one |
-| `agora-rtc-sdk-ng` | Agora RTC SDK | ⚡ Choose one |
-
-### One-line Installation (Recommended)
-
-```bash
-# With LiveKit (version 2.16.1 required)
-pnpm add @spatialwalk/avatarkit @spatialwalk/avatarkit-rtc livekit-client@2.16.1
-
-# With Agora
-pnpm add @spatialwalk/avatarkit @spatialwalk/avatarkit-rtc agora-rtc-sdk-ng
-```
-
-### Step-by-step Installation
-
-**Step 1:** Install the Web SDK (required dependency)
-
-```bash
-pnpm add @spatialwalk/avatarkit
-```
-
-**Step 2:** Install the RTC adapter
-
-```bash
-pnpm add @spatialwalk/avatarkit-rtc
-```
-
-**Step 3:** Install your chosen RTC provider SDK
-
-```bash
-# For LiveKit (version 2.16.1 required)
-pnpm add livekit-client@2.16.1
-
-# For Agora
-pnpm add agora-rtc-sdk-ng
-```
-
-### Common Installation Errors
-
-| Error | Cause | Solution |
-|-------|-------|----------|
-| `No matching version found for @spatialwalk/avatarkit-rtc@^0.x.x` | Wrong version number | Use `pnpm add @spatialwalk/avatarkit-rtc` (no version) |
-| `No matching version found for @spatialwalk/avatarkit@^0.x.x` | Wrong version number | Use `pnpm add @spatialwalk/avatarkit` (no version) |
-| `Cannot find module '@spatialwalk/avatarkit'` | Missing dependency | Install it: `pnpm add @spatialwalk/avatarkit` |
-| `Avatar placeholder - SDK integration required` | SDK not initialized | Call `AvatarSDK.initialize()` before creating AvatarView |
-
-## Get Credentials
-
-Before using the SDK, you need to obtain authentication credentials:
-
-### App ID
-
-- Visit the [Developer Platform](https://dash.spatialreal.ai) to create your App
-- Get your App ID from the platform dashboard
-- The App ID is required for SDK initialization
-
-### Session Token
-
-- Session Token is required for avatar loading and SDK authentication
-- Session Token should be obtained from **your backend server**
-- Your backend server should request the Session Token from the AvatarKit Server
-- Session Token has a **maximum validity of 1 hour**
-
-### Authentication Flow
-
-```
-Your Client → Your Backend Server → AvatarKit Server → returns Session Token (max 1 hour)
-```
-
-> **Note:** App ID and Session Token are paired and must be used together. Each App ID corresponds to a specific list of avatars that can be driven.
-
-## Quick Start
-
-When initializing `@spatialwalk/avatarkit`, use `DrivingServiceMode.host` since network communication is managed by this SDK.
-
-```typescript
-import { AvatarPlayer, LiveKitProvider, AgoraProvider } from '@spatialwalk/avatarkit-rtc';
-import { AvatarSDK, AvatarView, AvatarManager, DrivingServiceMode, Environment } from '@spatialwalk/avatarkit';
-
-// 0. Initialize SDK (use host mode)
-await AvatarSDK.initialize(appId, {
-  environment: Environment.cn,  // or Environment.intl
-  drivingServiceMode: DrivingServiceMode.host,
-});
-
-// 1. Set session token (required for avatar loading)
-AvatarSDK.setSessionToken(sessionToken);
-
-// 2. Create Avatar and AvatarView
-const avatar = await AvatarManager.shared.load(characterId);
-const avatarView = new AvatarView(avatar, container);
-
-// 3. Create Provider (choose LiveKit or Agora)
-const provider = new LiveKitProvider();  // or new AgoraProvider()
-
-// 4. Create Player
-const player = new AvatarPlayer(provider, avatarView, {
-  logLevel: 'warning',  // optional
-});
-
-// 5. Connect to RTC server
-await player.connect({
-  url: 'wss://your-livekit-server.com',
-  token: 'your-token',
-  roomName: 'room-name',
-});
-
-// 6. Start microphone
-await player.startPublishing();
-
-// 7. Stop microphone
-await player.stopPublishing();
-
-// 8. Disconnect
-await player.disconnect();
-```
-
-## API Reference
-
-### AvatarPlayer
-
-Main entry class that manages RTC connection and avatar rendering.
-
-#### Constructor
-
-```typescript
-new AvatarPlayer(provider: RTCProvider, avatarView: AvatarView, options?: AvatarPlayerOptions)
-```
-
-**Parameters:**
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `provider` | `LiveKitProvider \| AgoraProvider` | RTC provider instance |
-| `avatarView` | `AvatarView` | AvatarView instance from avatarkit |
-| `options` | `AvatarPlayerOptions` | Optional configuration |
-
-#### AvatarPlayerOptions
-
-```typescript
-interface AvatarPlayerOptions {
-  /** Start speaking transition frames, default 5 (~200ms at 25fps) */
-  transitionStartFrameCount?: number;
-  
-  /** End speaking transition frames, default 40 (~1600ms at 25fps) */
-  transitionEndFrameCount?: number;
-  
-  /** Log level: 'info' | 'warning' | 'error' | 'none', default 'warning' */
-  logLevel?: LogLevel;
-}
-```
-
-#### Properties
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `isConnected` | `boolean` | Whether connected to RTC server |
-
-#### Methods
-
-##### connect(config)
-
-Connect to RTC server.
-
-```typescript
-await player.connect(config: RTCConnectionConfig): Promise<void>
-```
-
-**LiveKit Config:**
-
-```typescript
-interface LiveKitConnectionConfig {
-  url: string;      // LiveKit server URL (wss://...)
-  token: string;    // Auth token
-  roomName: string; // Room name
-}
-```
-
-**Agora Config:**
-
-```typescript
-interface AgoraConnectionConfig {
-  appId: string;    // Agora App ID
-  channel: string;  // Channel name
-  token?: string;   // Auth token (required in production)
-  uid?: number;     // User ID (optional, 0 = auto assign)
-}
-```
-
-##### disconnect()
-
-Disconnect RTC connection and clean up all resources.
-
-```typescript
-await player.disconnect(): Promise<void>
-```
-
-##### reconnect()
-
-Reconnect to RTC server using the last connection configuration. Useful for recovering from connection issues or stream stalls.
-
-```typescript
-await player.reconnect(): Promise<void>
-```
-
-**Note:** Throws an error if no previous connection exists. Call `connect()` first.
-
-##### startPublishing()
-
-Start publishing microphone audio. Automatically requests microphone permission.
-
-```typescript
-await player.startPublishing(): Promise<void>
-```
-
-##### stopPublishing()
-
-Stop publishing microphone audio and release the device.
-
-```typescript
-await player.stopPublishing(): Promise<void>
-```
-
-##### publishAudio(track)
-
-Publish custom audio track (advanced usage). For non-microphone audio sources like audio file playback.
-
-```typescript
-await player.publishAudio(track: MediaStreamTrack): Promise<void>
-```
-
-**Supported audio sources:**
-
-| Source | How to obtain |
-|--------|---------------|
-| 🎤 Microphone | Use `startPublishing()` for convenience |
-| 🎵 `<audio>` element | `audioElement.captureStream()` |
-| 🖥️ Screen share audio | `getDisplayMedia({ audio: true })` |
-| 🎹 Web Audio API | `audioContext.createMediaStreamDestination().stream` |
-
-**Example:**
-
-```typescript
-// Play audio from browser <audio> element
-const audioEl = document.querySelector('audio');
-const stream = audioEl.captureStream();
-await player.publishAudio(stream.getAudioTracks()[0]);
-```
-
-##### unpublishAudio()
-
-Stop publishing custom audio track.
-
-```typescript
-await player.unpublishAudio(): Promise<void>
-```
-
-**Note:** `unpublishAudio()` does not stop the track - caller is responsible for managing track lifecycle:
-
-```typescript
-await player.unpublishAudio();
-stream.getTracks().forEach(t => t.stop()); // Clean up externally
-```
-
-##### getConnectionState()
-
-Get current connection state.
-
-```typescript
-player.getConnectionState(): ConnectionState
-```
-
-**ConnectionState enum:**
-
-| Value | Description |
-|-------|-------------|
-| `'disconnected'` | Not connected |
-| `'connecting'` | Connecting |
-| `'connected'` | Connected |
-| `'reconnecting'` | Reconnecting |
-| `'failed'` | Connection failed |
-
-##### getNativeClient()
-
-Get underlying RTC client object for platform-specific features.
-
-```typescript
-player.getNativeClient(): unknown
-```
-
-**Return value:**
-
-| Provider | Return type |
-|----------|-------------|
-| LiveKit | `Room` instance (exported as `LiveKitRoom`) |
-| Agora | `IAgoraRTCClient` instance (exported as `AgoraClient`) |
-
-**Type safety notes:**
-
-- **Direct Provider usage**: Returns concrete type, no assertion needed
-- **Via AvatarPlayer**: Returns `unknown`, requires manual type assertion
-
-**Example:**
-
-```typescript
-// Method 1: Use Provider directly (recommended, full type hints)
-import { LiveKitProvider, LiveKitRoom } from '@spatialwalk/avatarkit-rtc';
-
-const provider = new LiveKitProvider();
-const room = provider.getNativeClient();  // Type: LiveKitRoom | null
-console.log('Remote participants:', room?.remoteParticipants.size);
-
-// Method 2: Via AvatarPlayer (requires assertion)
-import { AvatarPlayer, LiveKitRoom } from '@spatialwalk/avatarkit-rtc';
-
-const room = player.getNativeClient() as LiveKitRoom | null;
-console.log('Remote participants:', room?.remoteParticipants.size);
-
-// Agora example
-import { AgoraProvider, AgoraClient } from '@spatialwalk/avatarkit-rtc';
-
-const provider = new AgoraProvider();
-const client = provider.getNativeClient();  // Type: AgoraClient | null
-console.log('Connection state:', client?.connectionState);
-```
-
-##### on(event, handler)
-
-Listen to events.
-
-```typescript
-player.on(event: string, handler: Function): void
-```
-
-**Supported events:**
-
-| Event | Callback params | Description |
-|-------|-----------------|-------------|
-| `'connected'` | `()` | Connection successful |
-| `'disconnected'` | `()` | Disconnected |
-| `'error'` | `(error: Error)` | Error occurred |
-| `'connection-state-changed'` | `(state: ConnectionState)` | Connection state changed |
-| `'stalled'` | `()` | Data stream stalled (no frames for 3s). Avatar auto-transitions to idle. |
-
-**Example: Handling stream stalls**
-
-```typescript
-player.on('stalled', async () => {
-  console.log('Stream stalled, attempting reconnection...');
-  try {
-    await player.reconnect();
-  } catch (error) {
-    console.error('Reconnection failed:', error);
-  }
-});
-```
-
-##### off(event, handler)
-
-Remove event listener.
-
-```typescript
-player.off(event: string, handler: Function): void
-```
-
----
-
-### LiveKitProvider
-
-LiveKit RTC provider implementation.
-
-```typescript
-import { LiveKitProvider } from '@spatialwalk/avatarkit-rtc';
-
-const provider = new LiveKitProvider();
-```
-
----
-
-### AgoraProvider
-
-Agora RTC provider implementation.
-
-```typescript
-import { AgoraProvider } from '@spatialwalk/avatarkit-rtc';
-
-const provider = new AgoraProvider({
-  debugLogging: true,  // optional: enable debug logs
-});
-```
-
-**AgoraProviderOptions:**
-
-```typescript
-interface AgoraProviderOptions {
-  /** Enable verbose debug logging, default false */
-  debugLogging?: boolean;
-}
-```
-
----
-
-### Type Guards
-
-Type guard functions for config type checking.
-
-```typescript
-import { isLiveKitConfig, isAgoraConfig } from '@spatialwalk/avatarkit-rtc';
-
-if (isLiveKitConfig(config)) {
-  // config is LiveKitConnectionConfig
-}
-
-if (isAgoraConfig(config)) {
-  // config is AgoraConnectionConfig
-}
-```
-
----
-
-### Native Client Types
-
-SDK exports type aliases for underlying RTC clients, useful when using `getNativeClient()`:
-
-```typescript
-import type { LiveKitRoom, AgoraClient } from '@spatialwalk/avatarkit-rtc';
-
-// LiveKitRoom = Room type from livekit-client
-// AgoraClient = IAgoraRTCClient type from agora-rtc-sdk-ng
-```
-
----
-
-## Log Levels
-
-SDK log level is configured via `AvatarPlayerOptions.logLevel`:
-
-| Level | Output |
-|-------|--------|
-| `'info'` | All logs (connection state, frame processing, debug info) |
-| `'warning'` | Warnings + errors (**default**) |
-| `'error'` | Errors only |
-| `'none'` | Disable all logs |
-
-```typescript
-const player = new AvatarPlayer(provider, avatarView, {
-  logLevel: 'info',  // Enable for debugging
-});
-```
-
----
-
-## Complete Example
-
-### LiveKit Integration
-
-```typescript
-import { AvatarPlayer, LiveKitProvider } from '@spatialwalk/avatarkit-rtc';
-import { AvatarSDK, AvatarView, AvatarManager, DrivingServiceMode, Environment } from '@spatialwalk/avatarkit';
-
-async function initLiveKit() {
-  // Initialize SDK (use host mode)
-  await AvatarSDK.initialize('your-app-id', {
-    environment: Environment.cn,
-    drivingServiceMode: DrivingServiceMode.host,
-  });
-
-  // Set session token (required)
-  AvatarSDK.setSessionToken('your-session-token');
-
-  // Create Avatar
-  const avatar = await AvatarManager.shared.load('character-id');
-  const container = document.getElementById('avatar-container')!;
-  const avatarView = new AvatarView(avatar, container);
-
-  // Create Player
-  const provider = new LiveKitProvider();
-  const player = new AvatarPlayer(provider, avatarView, {
-    logLevel: 'info',
-    transitionStartFrameCount: 5,
-    transitionEndFrameCount: 40,
-  });
-
-  // Listen to events
-  player.on('connected', () => console.log('Connected!'));
-  player.on('disconnected', () => console.log('Disconnected!'));
-  player.on('error', (err) => console.error('Error:', err));
-
-  // Connect
-  await player.connect({
-    url: 'wss://your-livekit-server.com',
-    token: 'your-token',
-    roomName: 'my-room',
-  });
-
-  // Start microphone
-  await player.startPublishing();
-
-  // Stop microphone
-  // await player.stopPublishing();
-
-  // Disconnect
-  // await player.disconnect();
-}
-```
-
-### Agora Integration
-
-```typescript
-import { AvatarPlayer, AgoraProvider } from '@spatialwalk/avatarkit-rtc';
-import { AvatarSDK, AvatarView, AvatarManager, DrivingServiceMode, Environment } from '@spatialwalk/avatarkit';
-
-async function initAgora() {
-  // Initialize SDK (use host mode)
-  await AvatarSDK.initialize('your-app-id', {
-    environment: Environment.cn,
-    drivingServiceMode: DrivingServiceMode.host,
-  });
-
-  // Set session token (required)
-  AvatarSDK.setSessionToken('your-session-token');
-
-  // Create Avatar
-  const avatar = await AvatarManager.shared.load('character-id');
-  const container = document.getElementById('avatar-container')!;
-  const avatarView = new AvatarView(avatar, container);
-
-  // Create Player
-  const provider = new AgoraProvider({ debugLogging: true });
-  const player = new AvatarPlayer(provider, avatarView);
-
-  // Connect
-  await player.connect({
-    appId: 'your-agora-app-id',
-    channel: 'my-channel',
-    token: 'your-token',  // Required in production
-    uid: 0,  // 0 = auto assign
-  });
-
-  // Start microphone
-  await player.startPublishing();
-}
-```
-
----
-
-## Browser Compatibility
-
-| Feature | Chrome | Firefox | Safari | Edge |
-|---------|--------|---------|--------|------|
-| LiveKit (VP8 + RTCRtpScriptTransform) | ✅ 94+ | ✅ 117+ | ✅ 15.4+ | ✅ 94+ |
-| Agora (H.264 + SEI) | ✅ 74+ | ✅ 78+ | ✅ 14.1+ | ✅ 79+ |
-
-**Note:** LiveKit requires browser support for `RTCRtpScriptTransform` API (Safari 15.4+ supported).
-
----
+📚 **Documentation**: [https://docs.spatialreal.ai/guide/rtc-mode](https://docs.spatialreal.ai/guide/rtc-mode)
 
 ## License
 

package/dist/assets/animation-worker-DOGeTjF0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-worker-DOGeTjF0.js","sources":["../src/providers/livekit/animation-worker.ts"],"sourcesContent":["/**\n * RTCRtpScriptTransform Worker for Animation Track (VP8 Video)\n *\n * This worker handles extracting animation data from VP8 video frames.\n * The server prepends a minimal VP8 header to trick the browser's depacketizer.\n *\n * Frame format after depacketization (VP8 descriptor is stripped by depacketizer):\n * [0-9]     VP8 frame header (10 bytes) - minimal keyframe structure, skipped\n * [10]      flags (uint8) - packet flags\n * [11-14]   msgLen (little-endian u32) - length of protobuf message\n * [15..15+msgLen)  protobuf Message binary\n */\n\n// Type declarations for RTCRtpScriptTransform API (experimental)\ndeclare interface RTCTransformEvent extends Event {\n  transformer: {\n    readable: ReadableStream;\n    writable: WritableStream;\n    options?: unknown;\n  };\n}\n\n// Worker global scope with RTCRtpScriptTransform support\ndeclare const self: DedicatedWorkerGlobalScope & {\n  onrtctransform?: ((event: RTCTransformEvent) => void) | null;\n};\n\n// VP8 header size (frame tag + sync code + dimensions, descriptor already stripped)\nconst VP8_FRAME_HEADER_SIZE = 10;\n\n// Protocol constants (must match egress-server/metadata_track.go)\nconst METADATA_FIXED_HEADER_SIZE = 5; // 1B flags + 4B length\n\n// Packet flags\nconst PACKET_FLAG_IDLE = 0x01;\nconst PACKET_FLAG_START = 0x02;\nconst PACKET_FLAG_END = 0x04;\nconst PACKET_FLAG_GZIPPED = 0x08;\nconst PACKET_FLAG_TRANSITION = 0x10; // Transition packet - contains target frame for generating transition from idle\nconst PACKET_FLAG_TRANSITION_END = 0x20; // Transition end packet - contains last frame for generating transition back to idle\nconst PACKET_FLAG_REDUNDANT = 0x40; // Packet contains redundant previous frame for ALR loss recovery\n\ninterface FrameMetadata {\n  flags: number;\n  protobufLength: number;\n  protobufData: Uint8Array;\n  // ALR (Application-Level Redundancy) data\n  hasRedundant: boolean;\n  redundantLength: number;\n  redundantData: Uint8Array | null;\n}\n\ninterface TransformOptions {\n  operation: 'receiver';\n}\n\n// State for receiver\nlet receiverMetaCount = 0;\nlet lastLogTime = 0;\nlet totalFrames = 0;\nlet framesWithMeta = 0;\nlet wasIdle = false; // Track idle state for transition detection\nlet isInStartTransition = false; // Dedup consecutive transition-start packets\nlet isInEndTransition = false; // Dedup consecutive transition-end packets\n\n// ALR (Application-Level Redundancy) state for loss detection\nlet lastReceivedTimestamp: number | null = null;\nlet framesRecovered = 0;\nlet framesLost = 0;\n// Expected timestamp increment per animation frame (90000 Hz * 40ms = 3600)\n// Animation is sent every 2nd audio frame (40ms intervals)\nconst EXPECTED_TIMESTAMP_INCREMENT = 3600;\n\n// Sequence tracking for out-of-order detection\nlet lastRenderedSeq: number = -1; // Last sequence number sent to main thread\nlet framesOutOfOrder = 0; // Count of out-of-order frames detected\nlet framesDuplicate = 0; // Count of duplicate frames skipped\nlet framesDropped = 0; // Count of frames that were permanently lost (gaps in sequence)\nlet framesSent = 0; // Total frames successfully sent to main thread\n\nfunction parseMetadataHeader(\n  data: Uint8Array,\n): { meta: FrameMetadata; headerSize: number } | null {\n  if (data.byteLength < METADATA_FIXED_HEADER_SIZE) return null;\n  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n  const flags = data[0];\n  const msgLen = view.getUint32(1, true); // little-endian\n\n  // Calculate minimum size needed\n  const headerSize = METADATA_FIXED_HEADER_SIZE + msgLen;\n  if (data.byteLength < headerSize) return null;\n\n  // The compressed payload (will be decompressed later)\n  const compressedData = data.slice(\n    METADATA_FIXED_HEADER_SIZE,\n    METADATA_FIXED_HEADER_SIZE + msgLen,\n  );\n\n  // Note: With the new ALR optimization, both frames are gzipped together\n  // The format INSIDE the gzip (after decompression) is:\n  // - ALR: [currentLen (4B)][currentData][prevLen (4B)][prevData]\n  // - Non-ALR: just the raw protobuf data\n  // We return the compressed data here; decompression and ALR parsing happens in receiverTransform\n\n  const hasRedundant = (flags & PACKET_FLAG_REDUNDANT) !== 0;\n\n  return {\n    meta: {\n      flags,\n      protobufLength: msgLen,\n      protobufData: compressedData, // This is still compressed at this point\n      hasRedundant,\n      redundantLength: 0, // Will be determined after decompression\n      redundantData: null, // Will be extracted after decompression\n    },\n    headerSize,\n  };\n}\n\nfunction isIdlePacket(flags: number): boolean {\n  return (flags & PACKET_FLAG_IDLE) !== 0;\n}\n\nfunction isStartPacket(flags: number): boolean {\n  return (flags & PACKET_FLAG_START) !== 0;\n}\n\nfunction isEndPacket(flags: number): boolean {\n  return (flags & PACKET_FLAG_END) !== 0;\n}\n\nfunction isGzipped(flags: number): boolean {\n  return (flags & PACKET_FLAG_GZIPPED) !== 0;\n}\n\nfunction isTransitionPacket(flags: number): boolean {\n  return (flags & PACKET_FLAG_TRANSITION) !== 0;\n}\n\nfunction isTransitionEndPacket(flags: number): boolean {\n  return (flags & PACKET_FLAG_TRANSITION_END) !== 0;\n}\n\n// Decompress gzipped data using DecompressionStream API\nasync function decompressGzip(data: Uint8Array): Promise<Uint8Array> {\n  const ds = new DecompressionStream('gzip');\n  const writer = ds.writable.getWriter();\n  // Create a copy to ensure we have a plain ArrayBuffer, not SharedArrayBuffer\n  const copy = new Uint8Array(data);\n  writer.write(copy);\n  writer.close();\n\n  const reader = ds.readable.getReader();\n  const chunks: Uint8Array[] = [];\n  let totalLength = 0;\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n    totalLength += value.length;\n  }\n\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.length;\n  }\n\n  return result;\n}\n\n// Compression stats for logging\nlet totalCompressedBytes = 0;\nlet totalUncompressedBytes = 0;\n\n// ALR payload structure after decompression\ninterface ALRPayload {\n  frameSeq: number; // Sequence number of current frame\n  currentData: Uint8Array; // Current frame (N)\n  prev1Data: Uint8Array | null; // Previous frame (N-1)\n  prev2Data: Uint8Array | null; // Frame before previous (N-2)\n}\n\n// Parse ALR payload after decompression\n// ALR format: [frameSeq (4B)][currentLen (4B)][currentData][prev1Len (4B)][prev1Data][prev2Len (4B)][prev2Data]\n// Non-ALR format: [frameSeq (4B)][raw protobuf data]\n// Returns { frameSeq, currentData, prev1Data, prev2Data } or null if parsing fails\nfunction parseALRPayload(\n  decompressed: Uint8Array,\n  hasRedundant: boolean,\n): ALRPayload | null {\n  if (decompressed.byteLength < 4) return null;\n\n  const view = new DataView(\n    decompressed.buffer,\n    decompressed.byteOffset,\n    decompressed.byteLength,\n  );\n  let offset = 0;\n\n  // Parse frame sequence number\n  const frameSeq = view.getUint32(offset, true);\n  offset += 4;\n\n  if (!hasRedundant) {\n    // Non-ALR: rest is raw protobuf\n    const currentData = decompressed.slice(offset);\n    return { frameSeq, currentData, prev1Data: null, prev2Data: null };\n  }\n\n  // ALR format: parse current frame\n  if (decompressed.byteLength < offset + 4) return null;\n  const currentLen = view.getUint32(offset, true);\n  offset += 4;\n  if (decompressed.byteLength < offset + currentLen) return null;\n  const currentData = decompressed.slice(offset, offset + currentLen);\n  offset += currentLen;\n\n  // Parse prev1 (N-1) if available\n  let prev1Data: Uint8Array | null = null;\n  if (decompressed.byteLength >= offset + 4) {\n    const prev1Len = view.getUint32(offset, true);\n    offset += 4;\n    if (prev1Len > 0 && decompressed.byteLength >= offset + prev1Len) {\n      prev1Data = decompressed.slice(offset, offset + prev1Len);\n      offset += prev1Len;\n    }\n  }\n\n  // Parse prev2 (N-2) if available\n  let prev2Data: Uint8Array | null = null;\n  if (decompressed.byteLength >= offset + 4) {\n    const prev2Len = view.getUint32(offset, true);\n    offset += 4;\n    if (prev2Len > 0 && decompressed.byteLength >= offset + prev2Len) {\n      prev2Data = decompressed.slice(offset, offset + prev2Len);\n    }\n  }\n\n  return { frameSeq, currentData, prev1Data, prev2Data };\n}\n\n// Helper to send animation data to main thread with sequence tracking\n// Returns true if frame was sent, false if skipped (duplicate/out-of-order)\nfunction sendAnimationToMainThread(\n  protobufData: Uint8Array,\n  flags: number,\n  frameSeq: number,\n  isRecovered: boolean = false,\n): boolean {\n  const isIdle = isIdlePacket(flags);\n  const isStart = isStartPacket(flags);\n  const isEnd = isEndPacket(flags);\n\n  // Check for out-of-order or duplicate frames\n  if (frameSeq <= lastRenderedSeq && lastRenderedSeq !== -1 && !isStart) {\n    if (frameSeq === lastRenderedSeq) {\n      framesDuplicate++;\n    } else {\n      framesOutOfOrder++;\n    }\n    return false;\n  }\n\n  // Check for gap (frames we never received and couldn't recover) - these are DROPPED\n  if (lastRenderedSeq !== -1 && frameSeq > lastRenderedSeq + 1 && !isStart) {\n    const gap = frameSeq - lastRenderedSeq - 1;\n    framesDropped += gap;\n  }\n\n  framesSent++;\n\n  lastRenderedSeq = frameSeq;\n\n  const protobufBuffer = new ArrayBuffer(protobufData.byteLength);\n  new Uint8Array(protobufBuffer).set(protobufData);\n\n  self.postMessage(\n    {\n      type: 'animation',\n      flags,\n      isIdle,\n      isStart,\n      isEnd,\n      isRecovered,\n      frameSeq,\n      protobufData: protobufBuffer,\n    },\n    { transfer: [protobufBuffer] },\n  );\n\n  return true;\n}\n\n// Receiver transform: extract animation data from video frames\n// Uses ALR (Application-Level Redundancy) to recover lost frames\nfunction receiverTransform(\n  frame: RTCEncodedVideoFrame,\n  _controller: TransformStreamDefaultController<RTCEncodedVideoFrame>,\n) {\n  totalFrames++;\n  const data = new Uint8Array(frame.data);\n  const currentTimestamp = frame.timestamp;\n\n  // Skip the VP8 frame header (10 bytes) - the VP8 descriptor is already stripped by depacketizer\n  // Check if we have enough data for VP8 header + at least 1 byte of animation data\n  if (data.length <= VP8_FRAME_HEADER_SIZE) {\n    return; // Frame too small, skip\n  }\n\n  // Extract animation data after VP8 header\n  const animData = data.subarray(VP8_FRAME_HEADER_SIZE);\n\n  const parsed = parseMetadataHeader(animData);\n\n  if (parsed) {\n    const { meta } = parsed;\n    framesWithMeta++;\n    receiverMetaCount++;\n\n    const isIdle = isIdlePacket(meta.flags);\n    const isStart = isStartPacket(meta.flags);\n    const isEnd = isEndPacket(meta.flags);\n\n    // ALR: Detect frame loss and recover using redundant data\n    // Check if we missed frames by looking at timestamp gap\n    if (lastReceivedTimestamp !== null && !isIdle && !isStart) {\n      const timestampDelta = currentTimestamp - lastReceivedTimestamp;\n      // Allow some tolerance (1.5x expected increment) for timing variations\n      if (timestampDelta > EXPECTED_TIMESTAMP_INCREMENT * 1.5) {\n        const missedFrames =\n          Math.round(timestampDelta / EXPECTED_TIMESTAMP_INCREMENT) - 1;\n        framesLost += missedFrames;\n\n        // Try to recover using redundant data from current packet\n        // With ALR optimization, up to 3 frames are gzipped together\n        if (meta.hasRedundant && isGzipped(meta.flags)) {\n          // Decompress to get all frames, then recover\n          totalCompressedBytes += meta.protobufData.byteLength;\n\n          decompressGzip(meta.protobufData)\n            .then((decompressed) => {\n              totalUncompressedBytes += decompressed.byteLength;\n\n              const parsed = parseALRPayload(decompressed, true);\n              if (parsed) {\n                const currentSeq = parsed.frameSeq;\n\n                // Determine how many frames we can recover based on how many were lost\n                // and how many redundant frames we have\n                const framesToRecover: Array<{\n                  data: Uint8Array;\n                  seq: number;\n                }> = [];\n\n                if (missedFrames >= 2 && parsed.prev2Data) {\n                  framesToRecover.push({\n                    data: parsed.prev2Data,\n                    seq: currentSeq - 2,\n                  });\n                }\n                if (missedFrames >= 1 && parsed.prev1Data) {\n                  framesToRecover.push({\n                    data: parsed.prev1Data,\n                    seq: currentSeq - 1,\n                  });\n                }\n\n                const recovered = framesToRecover.length;\n                if (recovered > 0) {\n                  framesRecovered += recovered;\n\n                  // Send recovered frames in chronological order (oldest first)\n                  for (const frame of framesToRecover) {\n                    sendAnimationToMainThread(\n                      frame.data,\n                      meta.flags & ~PACKET_FLAG_REDUNDANT,\n                      frame.seq,\n                      true,\n                    );\n                  }\n                }\n\n                // Then send current frame\n                sendAnimationToMainThread(\n                  parsed.currentData,\n                  meta.flags & ~PACKET_FLAG_REDUNDANT,\n                  currentSeq,\n                  false,\n                );\n              }\n            })\n            .catch((err) => {\n              console.error(`[Animation Worker] ALR decompression error:`, err);\n            });\n\n          // Update timestamp and return early (we've handled this frame)\n          lastReceivedTimestamp = currentTimestamp;\n          return;\n        }\n      }\n    }\n\n    // Update last received timestamp (skip for idle packets to avoid false loss detection)\n    if (!isIdle) {\n      lastReceivedTimestamp = currentTimestamp;\n    }\n\n    // Reset state on session start\n    if (isStart) {\n      lastReceivedTimestamp = currentTimestamp;\n      framesRecovered = 0;\n      framesLost = 0;\n      lastRenderedSeq = -1;\n      framesOutOfOrder = 0;\n      framesDuplicate = 0;\n      framesDropped = 0;\n      framesSent = 0;\n    }\n\n    const isTransition = isTransitionPacket(meta.flags);\n    const isTransitionEnd = isTransitionEndPacket(meta.flags);\n\n    if (isIdle) {\n      // First idle packet - post idleStart event\n      if (!wasIdle) {\n        self.postMessage({ type: 'idleStart' });\n        wasIdle = true;\n      }\n      isInStartTransition = false;\n      isInEndTransition = false;\n    } else if (isTransition && meta.protobufLength > 0) {\n      // Transition packet - contains target frame for smooth transition from idle\n      wasIdle = false;\n\n      // Dedup: only emit first packet in a consecutive transition-start run.\n      if (!isInStartTransition) {\n        isInStartTransition = true;\n        isInEndTransition = false;\n\n        // Decompress if gzipped (transition packets are always gzipped)\n        const gzipped = isGzipped(meta.flags);\n        if (gzipped) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n\n          decompressGzip(meta.protobufData)\n            .then((decompressed) => {\n              totalUncompressedBytes += decompressed.byteLength;\n\n              const protobufBuffer = new ArrayBuffer(decompressed.byteLength);\n              new Uint8Array(protobufBuffer).set(decompressed);\n\n              // Post transition event - main thread will generate transition frames\n              self.postMessage(\n                {\n                  type: 'transition',\n                  flags: meta.flags,\n                  protobufData: protobufBuffer,\n                },\n                { transfer: [protobufBuffer] },\n              );\n            })\n            .catch((err) => {\n              console.error(\n                `[Animation Worker] Gzip decompress error (transition):`,\n                err,\n              );\n            });\n        } else {\n          const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n          new Uint8Array(protobufBuffer).set(meta.protobufData);\n\n          self.postMessage(\n            {\n              type: 'transition',\n              flags: meta.flags,\n              protobufData: protobufBuffer,\n            },\n            { transfer: [protobufBuffer] },\n          );\n        }\n      }\n    } else if (isTransitionEnd && meta.protobufLength > 0) {\n      // Transition end packet - contains last frame for smooth transition back to idle\n\n      // Dedup: only emit first packet in a consecutive transition-end run.\n      if (!isInEndTransition) {\n        isInEndTransition = true;\n        isInStartTransition = false;\n\n        // Decompress if gzipped (transition end packets are always gzipped)\n        const gzipped = isGzipped(meta.flags);\n        if (gzipped) {\n          totalCompressedBytes += meta.protobufData.byteLength;\n\n          decompressGzip(meta.protobufData)\n            .then((decompressed) => {\n              totalUncompressedBytes += decompressed.byteLength;\n\n              const protobufBuffer = new ArrayBuffer(decompressed.byteLength);\n              new Uint8Array(protobufBuffer).set(decompressed);\n\n              // Post transition end event - main thread will generate reverse transition frames\n              self.postMessage(\n                {\n                  type: 'transitionEnd',\n                  flags: meta.flags,\n                  protobufData: protobufBuffer,\n                },\n                { transfer: [protobufBuffer] },\n              );\n            })\n            .catch((err) => {\n              console.error(\n                `[Animation Worker] Gzip decompress error (transitionEnd):`,\n                err,\n              );\n            });\n        } else {\n          const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n          new Uint8Array(protobufBuffer).set(meta.protobufData);\n\n          self.postMessage(\n            {\n              type: 'transitionEnd',\n              flags: meta.flags,\n              protobufData: protobufBuffer,\n            },\n            { transfer: [protobufBuffer] },\n          );\n        }\n      }\n    } else if (meta.protobufLength > 0) {\n      // Normal animation packet\n      // Transition from idle to streaming (if not already transitioned via transition packet)\n      if (wasIdle) {\n        wasIdle = false;\n      }\n      isInStartTransition = false;\n      isInEndTransition = false;\n\n      // Decompress if gzipped\n      const gzipped = isGzipped(meta.flags);\n      if (gzipped) {\n        // Track compression stats\n        totalCompressedBytes += meta.protobufData.byteLength;\n\n        // Async decompression\n        decompressGzip(meta.protobufData)\n          .then((decompressed) => {\n            totalUncompressedBytes += decompressed.byteLength;\n\n            // Parse ALR format to get frame sequence and data\n            // Format: [frameSeq (4B)][currentLen (4B)][currentData]... or [frameSeq (4B)][raw protobuf]\n            const parsed = parseALRPayload(decompressed, meta.hasRedundant);\n            if (parsed) {\n              sendAnimationToMainThread(\n                parsed.currentData,\n                meta.flags & ~PACKET_FLAG_REDUNDANT,\n                parsed.frameSeq,\n                false,\n              );\n            }\n          })\n          .catch(() => {});\n      } else {\n        // Uncompressed - this shouldn't happen in normal operation but handle it\n        const protobufBuffer = new ArrayBuffer(meta.protobufData.byteLength);\n        new Uint8Array(protobufBuffer).set(meta.protobufData);\n\n        self.postMessage(\n          {\n            type: 'animation',\n            flags: meta.flags,\n            isIdle: false,\n            isStart,\n            isEnd,\n            frameSeq: -1, // Unknown sequence\n            protobufData: protobufBuffer,\n          },\n          { transfer: [protobufBuffer] },\n        );\n      }\n    }\n\n    // Report stats every second\n    const now = performance.now();\n    if (now - lastLogTime > 1000) {\n      lastLogTime = now;\n      self.postMessage({\n        type: 'metadata',\n        protobufLength: meta.protobufLength,\n        framesPerSec: receiverMetaCount,\n        totalFrames,\n        framesWithMeta,\n        framesLost,\n        framesRecovered,\n        totalCompressedBytes,\n        totalUncompressedBytes,\n        framesOutOfOrder,\n        framesDuplicate,\n        framesDropped,\n        framesSent,\n        lastRenderedSeq,\n      });\n      receiverMetaCount = 0;\n    }\n  }\n\n  // For video, we don't enqueue the frame since it's not real video\n  // The browser's VP8 decoder would fail on our custom data anyway\n  // controller.enqueue(frame);\n}\n\n// Handle rtctransform event (RTCRtpScriptTransform)\nself.onrtctransform = (event: RTCTransformEvent) => {\n  const transformer = event.transformer;\n  const options = transformer.options as TransformOptions;\n\n  try {\n    if (options.operation === 'receiver') {\n      // Reset state\n      receiverMetaCount = 0;\n      lastLogTime = 0;\n      totalFrames = 0;\n      framesWithMeta = 0;\n      wasIdle = false;\n      isInStartTransition = false;\n      isInEndTransition = false;\n      lastReceivedTimestamp = null;\n      framesRecovered = 0;\n      framesLost = 0;\n      lastRenderedSeq = -1;\n      framesOutOfOrder = 0;\n      framesDuplicate = 0;\n      framesDropped = 0;\n      framesSent = 0;\n\n      transformer.readable\n        .pipeThrough(new TransformStream({ transform: receiverTransform }))\n        .pipeTo(transformer.writable)\n        .catch((err: unknown) => {\n          console.error('[Animation Worker] Pipeline error:', err);\n          self.postMessage({\n            type: 'error',\n            error: `Animation receiver pipe error: ${err}`,\n          });\n        });\n\n      self.postMessage({ type: 'ready', operation: 'receiver' });\n    }\n  } catch (err) {\n    console.error('[Animation Worker] Setup error:', err);\n    self.postMessage({\n      type: 'error',\n      error: `Animation transform setup error: ${err}`,\n    });\n  }\n};\n\n// Handle message-based initialization for fallback\nself.onmessage = (event: MessageEvent) => {\n  const { type } = event.data;\n  if (type === 'init') {\n    self.postMessage({ type: 'initialized' });\n  }\n};\n\nexport {};\n"],"names":["currentData","parsed","frame"],"mappings":"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"}

package/dist/core/AvatarPlayer.d.ts

@@ -1,5 +1,5 @@
 import { RTCProvider } from './RTCProvider';
-import { RTCConnectionConfig } from '../types';
+import { RTCConnectionConfig, RTCPrepareConnectionConfig } from '../types';
 import { LogLevel } from '../utils';
 import { AvatarView } from '@spatialwalk/avatarkit';
 /**
@@ -83,6 +83,11 @@ export declare class AvatarPlayer {
      * @throws Error if already connected or connection fails
      */
     connect(config: RTCConnectionConfig): Promise<void>;
+    /**
+     * Pre-warm a future RTC connection when the provider supports it.
+     * This is best-effort and does not change the connected state.
+     */
+    prepareConnection(config: RTCPrepareConnectionConfig): Promise<void>;
     /**
      * Disconnect from RTC server.
      * Stops all tracks and cleans up resources.
@@ -172,13 +177,13 @@ export declare class AvatarPlayer {
      * @param event - Event name ('connected', 'disconnected', 'error', 'stalled', etc.)
      * @param handler - Event handler function
      */
-    on(event: string, handler: Function): void;
+    on(event: string, handler: (...args: unknown[]) => void): void;
     /**
      * Remove event listener.
      * @param event - Event name
      * @param handler - Event handler function (must be same reference as added)
      */
-    off(event: string, handler: Function): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
     /**
      * Reconnect to RTC server using the last connection configuration.
      * Useful for recovering from connection issues or stream stalls.

package/dist/core/AvatarPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarPlayer.d.ts","sourceRoot":"","sources":["../../src/core/AvatarPlayer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,wBAAwB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,YAAY;IAkCvB;;;;;OAKG;gBAED,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,mBAAmB;IA6B/B;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1D;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IASrC;;;;;;;;;;;;;;OAcG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtC;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrC;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAa1C;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAyB3C;;;;;;;;;;;;;OAaG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAkKjC"}
+{"version":3,"file":"AvatarPlayer.d.ts","sourceRoot":"","sources":["../../src/core/AvatarPlayer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAGhF,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,wBAAwB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,YAAY;IAmCvB;;;;;OAKG;gBAED,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,mBAAmB;IA6B/B;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1D;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IASrC;;;;;;;;;;;;;;OAcG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtC;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrC;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAa9D;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAyB/D;;;;;;;;;;;;;OAaG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAiLjC"}