@spatialwalk/avatarkit-rtc 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/index6.js.map

@@ -1 +1 @@
-{"version":3,"file":"index6.js","sources":["../src/core/AnimationHandler.ts"],"sourcesContent":["/**\n * Animation Handler - Orchestrates animation playback and transitions.\n *\n * This module handles:\n * - Animation frame rendering\n * - Transition playback from idle to animation and back\n * - Frame timing at 25fps\n * - Session state tracking\n *\n * The handler relies on server-sent packet flags (Transition, TransitionEnd, Idle)\n * to determine when to generate transitions, rather than maintaining complex internal state.\n *\n * @internal\n * @packageDocumentation\n */\n\nimport type { Flame } from '../proto/animation';\nimport { decodeAnimationKeyframes } from '../proto/animation';\nimport { logger } from '../utils';\n\n/**\n * Interface for decoding protobuf animation data.\n * Allows custom decoder implementation if needed.\n * @internal\n */\nexport type AnimationDecoder = (protobufData: ArrayBuffer) => Flame[] | null;\n\n/**\n * Interface that applications must implement to render avatar frames.\n * The SDK calls these methods to control the avatar.\n * @internal\n */\nexport interface AvatarRenderer {\n  /**\n   * Render a single animation frame.\n   * @param flame - The frame to render, or undefined to render idle\n   * @param startIdle - If true and flame is undefined, start idle animation loop\n   */\n  renderFrame(flame: Flame | undefined, startIdle?: boolean): void;\n\n  /**\n   * Generate transition frames from idle position to target frame.\n   * @param targetFrame - The target frame to transition to\n   * @param frameCount - Number of transition frames to generate\n   * @returns Promise resolving to array of transition frames\n   */\n  generateTransitionFromIdle(\n    targetFrame: Flame,\n    frameCount: number\n  ): Promise<Flame[]>;\n\n  /**\n   * Check if the renderer is available and ready.\n   * @returns true if renderer is ready to accept frames\n   */\n  isReady(): boolean;\n}\n\n/**\n * Configuration for AnimationHandler.\n * @internal\n */\nexport interface AnimationHandlerConfig {\n  /**\n   * Number of transition frames when starting animation.\n   * Default: 8 (~320ms at 25fps)\n   */\n  transitionStartFrameCount?: number;\n\n  /**\n   * Number of transition frames when ending animation.\n   * Default: 12 (~480ms at 25fps)\n   */\n  transitionEndFrameCount?: number;\n\n  /**\n   * Custom decoder function.\n   * Uses built-in protobuf decoder if not provided.\n   */\n  decoder?: AnimationDecoder;\n}\n\n/**\n * AnimationHandler manages all animation playback and transition logic.\n *\n * @internal\n * This class is used internally by AvatarPlayer.\n * Applications should not instantiate this class directly.\n */\nexport class AnimationHandler {\n  /** @internal */\n  private renderer: AvatarRenderer;\n  /** @internal */\n  private decoder: AnimationDecoder;\n  /** @internal */\n  private config: Required<Omit<AnimationHandlerConfig, 'decoder'>>;\n\n  // Frame tracking\n  /** @internal */\n  private animationFrameCount = 0;\n  /** @internal */\n  private lastRenderedFrameSeq = -1;\n  /** @internal */\n  private renderedFrameCount = 0;\n\n  // Transition state\n  /** @internal */\n  private isPlayingTransition = false;\n  /** @internal */\n  private isTransitioningToIdle = false;\n  /** @internal */\n  private transitionFrames: Flame[] = [];\n  /** @internal */\n  private transitionFrameIndex = 0;\n  /** @internal */\n  private transitionTimeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  // Guards against race conditions during async transition generation\n  /** @internal */\n  private isGeneratingStartTransition = false;\n  /** @internal */\n  private isGeneratingEndTransition = false;\n\n  // Session-level flags to prevent duplicate handling\n  // These are reset in resetTracking() for new sessions\n  /** @internal */\n  private hasHandledTransitionStart = false;\n  /** @internal */\n  private hasHandledTransitionEnd = false;\n\n  /**\n   * @internal\n   */\n  constructor(renderer: AvatarRenderer, config: AnimationHandlerConfig = {}) {\n    this.renderer = renderer;\n    this.decoder = config.decoder ?? decodeAnimationKeyframes;\n    this.config = {\n      transitionStartFrameCount: config.transitionStartFrameCount ?? 8,\n      transitionEndFrameCount: config.transitionEndFrameCount ?? 12,\n    };\n  }\n\n  /**\n   * Handle animation data received from RTC provider.\n   * @param protobufData - Raw protobuf bytes\n   * @param frameSeq - Frame sequence number (optional)\n   * @param isRecovered - Whether this frame was recovered via ALR\n   * @internal\n   */\n  handleAnimationData(\n    protobufData: ArrayBuffer,\n    frameSeq?: number,\n    isRecovered?: boolean\n  ): void {\n    // If we were in transition, stop it and play normal animation\n    if (this.isPlayingTransition) {\n      this.stopTransition();\n    }\n\n    this.animationFrameCount++;\n    this.renderedFrameCount++;\n\n    // Check for out-of-order delivery (info level - expected with marker frames)\n    if (frameSeq !== undefined && this.lastRenderedFrameSeq !== -1) {\n      if (frameSeq <= this.lastRenderedFrameSeq) {\n        logger.info(\n          'AnimationHandler',\n          `OUT-OF-ORDER/DUPLICATE: seq=${frameSeq}, lastRendered=${this.lastRenderedFrameSeq}${isRecovered ? ' [RECOVERED]' : ''}`\n        );\n      } else if (frameSeq > this.lastRenderedFrameSeq + 1) {\n        const gap = frameSeq - this.lastRenderedFrameSeq - 1;\n        logger.info(\n          'AnimationHandler',\n          `GAP: ${gap} frame(s) between ${this.lastRenderedFrameSeq} and ${frameSeq}${isRecovered ? ' [RECOVERED]' : ''}`\n        );\n      }\n    }\n\n    if (frameSeq !== undefined) {\n      this.lastRenderedFrameSeq = frameSeq;\n    }\n\n    // Decode and render\n    const keyframes = this.decoder(protobufData);\n\n    if (keyframes && keyframes.length > 0) {\n      this.renderer.renderFrame(keyframes[0]);\n    }\n  }\n\n  /**\n   * Handle transition packet - generate and play transition from idle to target.\n   * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n   * @param protobufData - Protobuf data containing target frame\n   * @param frameCount - Number of transition frames (overrides config if provided)\n   * @internal\n   */\n  async handleTransitionData(\n    protobufData: ArrayBuffer,\n    frameCount?: number\n  ): Promise<void> {\n    // Ignore if we've already handled a transition start for this session\n    if (this.hasHandledTransitionStart) {\n      return;\n    }\n    // Ignore if already playing or generating a start transition\n    if (this.isPlayingTransition && !this.isTransitioningToIdle) {\n      return;\n    }\n    if (this.isGeneratingStartTransition) {\n      return;\n    }\n\n    if (!this.renderer.isReady()) {\n      logger.warn('AnimationHandler', 'Renderer not ready for transition');\n      return;\n    }\n\n    // Decode target frame\n    const keyframes = this.decoder(protobufData);\n    if (!keyframes || keyframes.length === 0) {\n      logger.warn('AnimationHandler', 'No target keyframe in transition data');\n      return;\n    }\n\n    // Mark that we've handled transition start for this session\n    this.hasHandledTransitionStart = true;\n    // Reset transition end flag since we're starting a new transition\n    this.hasHandledTransitionEnd = false;\n\n    const targetFrame = keyframes[0];\n    const frames = frameCount ?? this.config.transitionStartFrameCount;\n    logger.info('AnimationHandler', `Generating ${frames} transition frames to target`);\n\n    // Set guard flag before async operation\n    this.isGeneratingStartTransition = true;\n\n    try {\n      // Generate transition frames from idle to target\n      const transitionFrames = await this.renderer.generateTransitionFromIdle(\n        targetFrame,\n        frames\n      );\n      logger.info('AnimationHandler', `Generated ${transitionFrames.length} transition frames`);\n\n      // Start playing transition frames at 25fps\n      this.isPlayingTransition = true;\n      this.isTransitioningToIdle = false;\n      this.transitionFrames = transitionFrames;\n      this.transitionFrameIndex = 0;\n\n      this.playTransitionFrame();\n    } catch (error) {\n      logger.error('AnimationHandler', 'Failed to generate transition:', error);\n      // Fallback: render target directly\n      this.renderer.renderFrame(targetFrame);\n    } finally {\n      this.isGeneratingStartTransition = false;\n    }\n  }\n\n  /**\n   * Handle transition end - generate and play reverse transition back to idle.\n   * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n   * @param protobufData - Protobuf data containing last animation frame\n   * @param frameCount - Number of transition frames (overrides config if provided)\n   * @internal\n   */\n  async handleTransitionToIdle(\n    protobufData: ArrayBuffer,\n    frameCount?: number\n  ): Promise<void> {\n    // Ignore if we've already handled a transition end for this session\n    if (this.hasHandledTransitionEnd) {\n      return;\n    }\n    // Ignore if already playing or generating an end transition\n    if (this.isPlayingTransition && this.isTransitioningToIdle) {\n      return;\n    }\n    if (this.isGeneratingEndTransition) {\n      return;\n    }\n\n    if (!this.renderer.isReady()) {\n      logger.warn('AnimationHandler', 'Renderer not ready for transition to idle');\n      this.renderer.renderFrame(undefined, true);\n      return;\n    }\n\n    // Decode last animation frame\n    const keyframes = this.decoder(protobufData);\n    if (!keyframes || keyframes.length === 0) {\n      logger.warn('AnimationHandler', 'No last keyframe in transition end data, starting idle directly');\n      this.renderer.renderFrame(undefined, true);\n      return;\n    }\n\n    // Mark that we've handled transition end for this session\n    this.hasHandledTransitionEnd = true;\n\n    const lastFrame = keyframes[0];\n    const frames = frameCount ?? this.config.transitionEndFrameCount;\n    logger.info('AnimationHandler', `Generating ${frames} reverse transition frames to idle`);\n\n    // Set guard flag before async operation\n    this.isGeneratingEndTransition = true;\n\n    try {\n      // Generate transition frames from idle to last frame, then reverse\n      const transitionFrames = await this.renderer.generateTransitionFromIdle(\n        lastFrame,\n        frames\n      );\n      logger.info('AnimationHandler', `Generated ${transitionFrames.length} transition frames, reversing for playback`);\n\n      // Reverse frames to play from last animation frame back to idle\n      const reversedFrames = transitionFrames.slice().reverse();\n\n      // Start playing reversed transition at 25fps\n      this.isPlayingTransition = true;\n      this.isTransitioningToIdle = true;\n      this.transitionFrames = reversedFrames;\n      this.transitionFrameIndex = 0;\n\n      this.playTransitionFrame();\n    } catch (error) {\n      logger.error('AnimationHandler', 'Failed to generate reverse transition:', error);\n      this.renderer.renderFrame(undefined, true);\n    } finally {\n      this.isGeneratingEndTransition = false;\n    }\n  }\n\n  /**\n   * Start idle animation.\n   * @internal\n   */\n  startIdle(): void {\n    this.renderer.renderFrame(undefined, true);\n  }\n\n  /**\n   * Reset animation frame tracking (call on session start).\n   * @internal\n   */\n  resetTracking(): void {\n    this.lastRenderedFrameSeq = -1;\n    this.renderedFrameCount = 0;\n    this.animationFrameCount = 0;\n    // Reset session-level transition flags for new session\n    this.hasHandledTransitionStart = false;\n    this.hasHandledTransitionEnd = false;\n    logger.info('AnimationHandler', 'Frame tracking reset');\n  }\n\n  /**\n   * Check if currently playing transition frames.\n   * @internal\n   */\n  isInTransition(): boolean {\n    return this.isPlayingTransition;\n  }\n\n  /**\n   * Stop transition playback.\n   * @internal\n   */\n  stopTransition(): void {\n    if (\n      this.isPlayingTransition ||\n      this.isGeneratingStartTransition ||\n      this.isGeneratingEndTransition\n    ) {\n      logger.info('AnimationHandler', 'Stopping transition playback');\n    }\n    this.isPlayingTransition = false;\n    this.isTransitioningToIdle = false;\n    this.isGeneratingStartTransition = false;\n    this.isGeneratingEndTransition = false;\n    // Note: We intentionally do NOT reset hasHandledTransitionStart/End here\n    // Those are session-level flags, only reset in resetTracking()\n    this.transitionFrames = [];\n    this.transitionFrameIndex = 0;\n    if (this.transitionTimeoutId !== null) {\n      clearTimeout(this.transitionTimeoutId);\n      this.transitionTimeoutId = null;\n    }\n  }\n\n  /**\n   * Clean up resources.\n   * @internal\n   */\n  dispose(): void {\n    this.stopTransition();\n  }\n\n  /**\n   * Play a single transition frame and schedule the next one.\n   * @internal\n   */\n  private playTransitionFrame(): void {\n    if (\n      !this.isPlayingTransition ||\n      this.transitionFrameIndex >= this.transitionFrames.length\n    ) {\n      // Transition complete\n      const wasTransitioningToIdle = this.isTransitioningToIdle;\n      this.isPlayingTransition = false;\n      this.isTransitioningToIdle = false;\n      this.transitionFrames = [];\n      this.transitionFrameIndex = 0;\n      if (this.transitionTimeoutId !== null) {\n        clearTimeout(this.transitionTimeoutId);\n        this.transitionTimeoutId = null;\n      }\n      logger.info('AnimationHandler', 'Transition playback complete');\n\n      // If transitioning to idle, start idle animation\n      if (wasTransitioningToIdle) {\n        logger.info('AnimationHandler', 'Starting idle animation after transition');\n        this.renderer.renderFrame(undefined, true);\n      }\n      return;\n    }\n\n    if (!this.renderer.isReady()) {\n      this.isPlayingTransition = false;\n      this.isTransitioningToIdle = false;\n      return;\n    }\n\n    const frame = this.transitionFrames[this.transitionFrameIndex];\n    this.renderer.renderFrame(frame);\n    this.transitionFrameIndex++;\n\n    // Schedule next frame at 25fps (40ms)\n    this.transitionTimeoutId = setTimeout(() => {\n      if (this.isPlayingTransition) {\n        this.playTransitionFrame();\n      }\n    }, 40);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index6.js","sources":["../src/core/AnimationHandler.ts"],"sourcesContent":["/**\n * Animation Handler - Orchestrates animation playback and transitions.\n *\n * This module handles:\n * - Animation frame rendering\n * - Transition playback from idle to animation and back\n * - Frame timing at 25fps\n * - Session state tracking\n *\n * The handler relies on server-sent packet flags (Transition, TransitionEnd, Idle)\n * to determine when to generate transitions, rather than maintaining complex internal state.\n *\n * @internal\n * @packageDocumentation\n */\n\nimport { logger, trackEvent } from '../utils';\n\n/**\n * Opaque animation frame data.\n * The actual shape is defined in web-sdk (KeyframeData).\n * rtc-sdk treats these as opaque — it only stores and passes them to the renderer.\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnimationFrame = any;\n\n/**\n * Interface that applications must implement to render avatar frames.\n * The SDK calls these methods to control the avatar.\n * @internal\n */\nexport interface AvatarRenderer {\n  /**\n   * Render a single animation frame from raw protobuf data.\n   * The renderer decodes the protobuf internally.\n   * @param protobufData - Raw protobuf bytes containing animation keyframes\n   */\n  renderFromProtobuf(protobufData: ArrayBuffer): void;\n\n  /**\n   * Render a pre-decoded animation frame (e.g., transition frame).\n   * @param frame - Opaque frame data, or undefined to render idle\n   * @param startIdle - If true and frame is undefined, start idle animation loop\n   */\n  renderFrame(frame: AnimationFrame | undefined, startIdle?: boolean): void;\n\n  /**\n   * Generate transition frames from idle to the target in the protobuf data.\n   * The renderer decodes the protobuf and generates interpolated frames internally.\n   * @param protobufData - Raw protobuf bytes containing the target frame\n   * @param frameCount - Number of transition frames to generate\n   * @returns Promise resolving to array of opaque transition frames\n   */\n  generateTransitionFromProtobuf(\n    protobufData: ArrayBuffer,\n    frameCount: number,\n  ): Promise<AnimationFrame[]>;\n\n  /**\n   * Check if the renderer is available and ready.\n   * @returns true if renderer is ready to accept frames\n   */\n  isReady(): boolean;\n}\n\n/**\n * Configuration for AnimationHandler.\n * @internal\n */\nexport interface AnimationHandlerConfig {\n  /**\n   * Number of transition frames when starting animation.\n   * Default: 8 (~320ms at 25fps)\n   */\n  transitionStartFrameCount?: number;\n\n  /**\n   * Number of transition frames when ending animation.\n   * Default: 12 (~480ms at 25fps)\n   */\n  transitionEndFrameCount?: number;\n\n  /**\n   * Callback when data stream stalls and fallback to idle is triggered.\n   * Called when no animation frames received for 5 seconds during speaking session.\n   */\n  onStreamStalled?: () => void;\n\n  /**\n   * Enable jitter buffer for smoother playback.\n   * When enabled, frames are buffered and rendered in sequence order at a steady 25fps,\n   * absorbing network jitter and out-of-order delivery.\n   * Default: true\n   */\n  enableJitterBuffer?: boolean;\n\n  /**\n   * Maximum delay (in ms) a frame can sit in the jitter buffer before being rendered.\n   * Also controls how long to wait for a missing frame before skipping ahead.\n   * Default: 80 (2 frames at 25fps)\n   */\n  maxBufferDelayMs?: number;\n\n  /**\n   * Provider name for telemetry.\n   */\n  providerName?: string;\n}\n\n/**\n * Jitter buffer state machine.\n * @internal\n */\ntype BufferState = 'direct' | 'filling' | 'draining' | 'starved';\n\n/**\n * A frame held in the jitter buffer awaiting playback.\n * @internal\n */\ninterface BufferedFrame {\n  protobufData: ArrayBuffer;\n  seq: number;\n  receivedAt: number;\n}\n\n/**\n * AnimationHandler manages all animation playback and transition logic.\n *\n * @internal\n * This class is used internally by AvatarPlayer.\n * Applications should not instantiate this class directly.\n */\nexport class AnimationHandler {\n  /** @internal */\n  private renderer: AvatarRenderer;\n  /** @internal */\n  private config: Required<\n    Omit<AnimationHandlerConfig, 'onStreamStalled' | 'providerName'>\n  >;\n\n  // Frame tracking\n  /** @internal */\n  private animationFrameCount = 0;\n  /** @internal */\n  private lastRenderedFrameSeq = -1;\n  /** @internal */\n  private renderedFrameCount = 0;\n\n  // Transition state\n  /** @internal */\n  private isPlayingTransition = false;\n  /** @internal */\n  private isTransitioningToIdle = false;\n  /** @internal */\n  private transitionFrames: AnimationFrame[] = [];\n  /** @internal */\n  private transitionFrameIndex = 0;\n  /** @internal */\n  private transitionTimeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  // Guards against race conditions during async transition generation\n  /** @internal */\n  private isGeneratingStartTransition = false;\n  /** @internal */\n  private isGeneratingEndTransition = false;\n\n  // Session-level flags to prevent duplicate handling\n  // These are reset in resetTracking() for new sessions\n  /** @internal */\n  private hasHandledTransitionStart = false;\n  /** @internal */\n  private hasHandledTransitionEnd = false;\n\n  // Watchdog for detecting stalled data stream\n  /** @internal */\n  private lastFrameReceivedTime = 0;\n  /** @internal */\n  private isInSession = false;\n  /** @internal */\n  private watchdogTimer: ReturnType<typeof setInterval> | null = null;\n  /** @internal */\n  private hasReportedStall = false;\n  /** @internal */\n  private static readonly STALL_TIMEOUT_MS = 5000;\n  /** @internal */\n  private onStreamStalledCallback: (() => void) | null = null;\n  /** @internal */\n  private providerName: string = '';\n  /** @internal */\n  private isStalledFallback = false; // True when fallback to idle was triggered due to stall\n\n  // Playback stats\n  /** @internal */\n  private playbackStatsTimer: ReturnType<typeof setInterval> | null = null;\n  /** @internal */\n  private playbackFrameCount = 0;\n  /** @internal */\n  private playbackFrameTimestamps: number[] = [];\n  /** @internal */\n  private playbackGapCount = 0;\n  /** @internal */\n  private playbackExpectedSeq = -1;\n\n  // Jitter buffer\n  /** @internal */\n  private bufferState: BufferState = 'direct';\n  /** @internal */\n  private frameBuffer = new Map<number, BufferedFrame>();\n  /** @internal */\n  private bufferNextSeq = -1;\n  /** @internal */\n  private bufferDrainTimer: ReturnType<typeof setTimeout> | null = null;\n  /** @internal */\n  private bufferLastDrainTime = 0;\n  /** @internal */\n  private static readonly BUFFER_MAX_SIZE = 4;\n  /** @internal */\n  private static readonly BUFFER_INITIAL_FILL = 2;\n  /** @internal */\n  private static readonly BUFFER_FRAME_INTERVAL_MS = 40;\n\n  // Cumulative session stats (never reset until getSessionSummary)\n  /** @internal */\n  private cumulativeTotalFrames = 0;\n  /** @internal */\n  private cumulativeLost = 0;\n  /** @internal */\n  private cumulativeRecovered = 0;\n  /** @internal */\n  private cumulativeDropped = 0;\n  /** @internal */\n  private cumulativeFpsReadings: number[] = [];\n\n  // Per-conversation stats for rtc_playback_stats\n  /** @internal */\n  private conversationFrameCount = 0;\n  /** @internal */\n  private conversationLost = 0;\n  /** @internal */\n  private conversationRecovered = 0;\n  /** @internal */\n  private conversationDropped = 0;\n  /** @internal */\n  private conversationFpsReadings: number[] = [];\n  /** @internal */\n  private conversationStartTime = 0;\n\n  /**\n   * @internal\n   */\n  constructor(renderer: AvatarRenderer, config: AnimationHandlerConfig = {}) {\n    this.renderer = renderer;\n    this.config = {\n      transitionStartFrameCount: config.transitionStartFrameCount ?? 8,\n      transitionEndFrameCount: config.transitionEndFrameCount ?? 12,\n      enableJitterBuffer: config.enableJitterBuffer ?? true,\n      maxBufferDelayMs: config.maxBufferDelayMs ?? 80,\n    };\n    this.onStreamStalledCallback = config.onStreamStalled ?? null;\n    this.providerName = config.providerName ?? '';\n  }\n\n  /**\n   * Handle animation data received from RTC provider.\n   * @param protobufData - Raw protobuf bytes\n   * @param frameSeq - Frame sequence number (optional)\n   * @param isRecovered - Whether this frame was recovered via ALR\n   * @internal\n   */\n  handleAnimationData(\n    protobufData: ArrayBuffer,\n    frameSeq?: number,\n    isRecovered?: boolean,\n  ): void {\n    // If we were in transition, stop it and play normal animation\n    if (this.isPlayingTransition) {\n      this.stopTransition();\n    }\n\n    // Update watchdog state\n    const now = Date.now();\n    if (this.hasReportedStall) {\n      // Recovered from stall\n      const stallDuration = now - this.lastFrameReceivedTime;\n      logger.info(\n        'AnimationHandler',\n        `Data stream resumed after ${stallDuration}ms stall`,\n      );\n      this.hasReportedStall = false;\n    }\n    // If we were in stalled fallback, clear the flag (data has resumed, no transition needed)\n    if (this.isStalledFallback) {\n      logger.info(\n        'AnimationHandler',\n        'Resuming from stall fallback, rendering directly without transition',\n      );\n      this.isStalledFallback = false;\n    }\n    this.lastFrameReceivedTime = now;\n\n    this.animationFrameCount++;\n\n    // In lossy networks the transition packet may be delayed/lost.\n    // Ensure session-level watchdog/stats still start on first valid playback frame.\n    this.ensureSessionActive(frameSeq);\n\n    // Jitter buffer path: insert into buffer instead of rendering directly\n    if (this.config.enableJitterBuffer && frameSeq !== undefined) {\n      this.bufferFrame(protobufData, frameSeq);\n      return;\n    }\n\n    // Direct path (no buffer)\n    // Check for out-of-order delivery\n    if (frameSeq !== undefined && this.lastRenderedFrameSeq !== -1) {\n      if (frameSeq < this.lastRenderedFrameSeq) {\n        // Out-of-order frame - discard (already rendered a later frame)\n        logger.warn(\n          'AnimationHandler',\n          `OUT-OF-ORDER: seq=${frameSeq}, lastRendered=${this.lastRenderedFrameSeq}${isRecovered ? ' [RECOVERED]' : ''}, discarding`,\n        );\n        this.conversationDropped++;\n        return;\n      } else if (frameSeq === this.lastRenderedFrameSeq) {\n        // Duplicate frame - skip silently (expected when server sends redundant frames)\n        return;\n      } else if (frameSeq > this.lastRenderedFrameSeq + 1) {\n        const gap = frameSeq - this.lastRenderedFrameSeq - 1;\n        logger.warn(\n          'AnimationHandler',\n          `GAP: ${gap} frame(s) between ${this.lastRenderedFrameSeq} and ${frameSeq}${isRecovered ? ' [RECOVERED]' : ''}`,\n        );\n      }\n    }\n\n    if (frameSeq !== undefined) {\n      this.lastRenderedFrameSeq = frameSeq;\n    }\n\n    // Render directly (decoding happens inside the renderer)\n    this.renderedFrameCount++;\n    if (isRecovered) this.conversationRecovered++;\n    this.renderer.renderFromProtobuf(protobufData);\n    this.logRenderedFrame('direct', frameSeq, isRecovered);\n\n    // Collect playback stats\n    this.playbackFrameTimestamps.push(performance.now());\n    this.playbackFrameCount++;\n    if (frameSeq !== undefined) {\n      if (\n        this.playbackExpectedSeq >= 0 &&\n        frameSeq > this.playbackExpectedSeq\n      ) {\n        this.playbackGapCount += frameSeq - this.playbackExpectedSeq;\n      }\n      this.playbackExpectedSeq = frameSeq + 1;\n    }\n  }\n\n  /**\n   * Handle transition packet - generate and play transition from idle to target.\n   * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n   * @param protobufData - Protobuf data containing target frame\n   * @param frameCount - Number of transition frames (overrides config if provided)\n   * @internal\n   */\n  async handleTransitionData(\n    protobufData: ArrayBuffer,\n    frameCount?: number,\n  ): Promise<void> {\n    logger.info(\n      'AnimationHandler',\n      `Start transition packet received (bytes=${protobufData.byteLength}, requestedFrames=${frameCount ?? this.config.transitionStartFrameCount}, hasHandledStart=${this.hasHandledTransitionStart}, isInSession=${this.isInSession}, isPlayingTransition=${this.isPlayingTransition}, isGeneratingStart=${this.isGeneratingStartTransition}, lastRenderedSeq=${this.lastRenderedFrameSeq}, bufferState=${this.bufferState}, buffered=${this.frameBuffer.size})`,\n    );\n\n    // Ignore if we've already handled a transition start for this session\n    if (this.hasHandledTransitionStart) {\n      return;\n    }\n    // Ignore if already playing or generating a start transition\n    if (this.isPlayingTransition && !this.isTransitioningToIdle) {\n      return;\n    }\n    if (this.isGeneratingStartTransition) {\n      return;\n    }\n\n    if (!this.renderer.isReady()) {\n      logger.warn('AnimationHandler', 'Renderer not ready for transition');\n      return;\n    }\n\n    // Once streaming playback has started, start-transition packets are stale.\n    // Ignore them to avoid jumping back into transition and causing visual jitter.\n    if (\n      this.isInSession &&\n      (this.lastRenderedFrameSeq >= 0 ||\n        this.frameBuffer.size > 0 ||\n        this.bufferState !== 'direct')\n    ) {\n      this.hasHandledTransitionStart = true;\n      logger.warn(\n        'AnimationHandler',\n        `Ignoring late transition packet after playback start (lastRenderedSeq=${this.lastRenderedFrameSeq}, bufferState=${this.bufferState}, buffered=${this.frameBuffer.size})`,\n      );\n      return;\n    }\n\n    // Mark that we've handled transition start for this session\n    this.hasHandledTransitionStart = true;\n    // Reset transition end flag since we're starting a new transition\n    this.hasHandledTransitionEnd = false;\n\n    // Start session and watchdog\n    this.ensureSessionActive();\n\n    const frames = frameCount ?? this.config.transitionStartFrameCount;\n    logger.info(\n      'AnimationHandler',\n      `Generating ${frames} transition frames to target`,\n    );\n\n    // Set guard flag before async operation\n    this.isGeneratingStartTransition = true;\n\n    try {\n      // Generate transition frames (renderer decodes protobuf internally)\n      const transitionFrames = await this.renderer.generateTransitionFromProtobuf(\n        protobufData,\n        frames,\n      );\n      logger.info(\n        'AnimationHandler',\n        `Generated ${transitionFrames.length} transition frames`,\n      );\n\n      // Start playing transition frames at 25fps\n      this.isPlayingTransition = true;\n      this.isTransitioningToIdle = false;\n      this.transitionFrames = transitionFrames;\n      this.transitionFrameIndex = 0;\n\n      this.playTransitionFrame();\n    } catch (error) {\n      logger.error('AnimationHandler', 'Failed to generate transition:', error);\n      // Fallback: render protobuf directly\n      this.renderer.renderFromProtobuf(protobufData);\n      this.logRenderedFrame('transition-fallback');\n    } finally {\n      this.isGeneratingStartTransition = false;\n    }\n  }\n\n  /**\n   * Handle transition end - generate and play reverse transition back to idle.\n   * Only starts transition on the first packet; subsequent packets are ignored while transitioning.\n   * @param protobufData - Protobuf data containing last animation frame\n   * @param frameCount - Number of transition frames (overrides config if provided)\n   * @internal\n   */\n  async handleTransitionToIdle(\n    protobufData: ArrayBuffer,\n    frameCount?: number,\n  ): Promise<void> {\n    // Ignore stale transition-end packets after session has already returned to idle.\n    if (!this.isInSession) {\n      logger.info(\n        'AnimationHandler',\n        'Ignoring transition end packet with no active session',\n      );\n      return;\n    }\n\n    // Ignore if we've already handled a transition end for this session\n    if (this.hasHandledTransitionEnd) {\n      return;\n    }\n    // Ignore if already playing or generating an end transition\n    if (this.isPlayingTransition && this.isTransitioningToIdle) {\n      return;\n    }\n    if (this.isGeneratingEndTransition) {\n      return;\n    }\n\n    if (!this.renderer.isReady()) {\n      logger.warn(\n        'AnimationHandler',\n        'Renderer not ready for transition to idle',\n      );\n      this.renderer.renderFrame(undefined, true);\n      this.logRenderedFrame('idle');\n      return;\n    }\n\n    // Mark that we've handled transition end for this session\n    this.hasHandledTransitionEnd = true;\n\n    // Drop any queued speaking frames so they cannot interleave with end transition playback.\n    this.flushBuffer();\n\n    const frames = frameCount ?? this.config.transitionEndFrameCount;\n    logger.info(\n      'AnimationHandler',\n      `Generating ${frames} reverse transition frames to idle`,\n    );\n\n    // Set guard flag before async operation\n    this.isGeneratingEndTransition = true;\n\n    try {\n      // Generate transition frames (renderer decodes protobuf internally), then reverse\n      const transitionFrames = await this.renderer.generateTransitionFromProtobuf(\n        protobufData,\n        frames,\n      );\n      logger.info(\n        'AnimationHandler',\n        `Generated ${transitionFrames.length} transition frames, reversing for playback`,\n      );\n\n      // Reverse frames to play from last animation frame back to idle\n      const reversedFrames = transitionFrames.slice().reverse();\n\n      // Start playing reversed transition at 25fps\n      this.isPlayingTransition = true;\n      this.isTransitioningToIdle = true;\n      this.transitionFrames = reversedFrames;\n      this.transitionFrameIndex = 0;\n\n      this.playTransitionFrame();\n    } catch (error) {\n      logger.error(\n        'AnimationHandler',\n        'Failed to generate reverse transition:',\n        error,\n      );\n      this.renderer.renderFrame(undefined, true);\n      this.logRenderedFrame('idle');\n    } finally {\n      this.isGeneratingEndTransition = false;\n    }\n  }\n\n  /**\n   * Start idle animation.\n   * @internal\n   */\n  startIdle(): void {\n    this.reportConversationStats();\n    this.isInSession = false;\n    this.hasReportedStall = false;\n    this.renderer.renderFrame(undefined, true);\n    this.logRenderedFrame('idle');\n  }\n\n  /**\n   * Ensure session-level timers/stats are active.\n   * @internal\n   */\n  private ensureSessionActive(frameSeq?: number): void {\n    if (this.isInSession) {\n      return;\n    }\n\n    this.isInSession = true;\n    this.lastFrameReceivedTime = Date.now();\n    this.hasReportedStall = false;\n    if (!this.conversationStartTime) {\n      this.conversationStartTime = Date.now();\n    }\n    this.startWatchdog();\n    this.startPlaybackStats();\n\n    if (frameSeq !== undefined) {\n      logger.info(\n        'AnimationHandler',\n        `Session started from animation frame seq=${frameSeq}`,\n      );\n    }\n  }\n\n  /**\n   * Reset animation frame tracking (call on session start).\n   * @internal\n   */\n  resetTracking(): void {\n    this.lastRenderedFrameSeq = -1;\n    this.renderedFrameCount = 0;\n    this.animationFrameCount = 0;\n    // Reset session-level transition flags for new session\n    this.hasHandledTransitionStart = false;\n    this.hasHandledTransitionEnd = false;\n    this.resetPlaybackStats();\n    this.flushBuffer();\n    logger.info('AnimationHandler', 'Frame tracking reset');\n  }\n\n  /**\n   * Check if currently playing transition frames.\n   * @internal\n   */\n  isInTransition(): boolean {\n    return (\n      this.isPlayingTransition ||\n      this.isGeneratingStartTransition ||\n      this.isGeneratingEndTransition\n    );\n  }\n\n  /**\n   * Stop transition playback.\n   * @internal\n   */\n  stopTransition(): void {\n    if (\n      this.isPlayingTransition ||\n      this.isGeneratingStartTransition ||\n      this.isGeneratingEndTransition\n    ) {\n      logger.info('AnimationHandler', 'Stopping transition playback');\n    }\n    this.isPlayingTransition = false;\n    this.isTransitioningToIdle = false;\n    this.isGeneratingStartTransition = false;\n    this.isGeneratingEndTransition = false;\n    // Note: We intentionally do NOT reset hasHandledTransitionStart/End here\n    // Those are session-level flags, only reset in resetTracking()\n    this.transitionFrames = [];\n    this.transitionFrameIndex = 0;\n    if (this.transitionTimeoutId !== null) {\n      clearTimeout(this.transitionTimeoutId);\n      this.transitionTimeoutId = null;\n    }\n    this.flushBuffer();\n  }\n\n  /**\n   * Get cumulative session summary for telemetry reporting.\n   * @internal\n   */\n  getSessionSummary(): {\n    totalFrames: number;\n    totalLost: number;\n    totalRecovered: number;\n    totalDropped: number;\n    avgFps: number;\n  } {\n    const avgFps =\n      this.cumulativeFpsReadings.length > 0\n        ? Math.round(\n            this.cumulativeFpsReadings.reduce((a, b) => a + b, 0) /\n              this.cumulativeFpsReadings.length,\n          )\n        : 0;\n\n    return {\n      totalFrames: this.cumulativeTotalFrames,\n      totalLost: this.cumulativeLost,\n      totalRecovered: this.cumulativeRecovered,\n      totalDropped: this.cumulativeDropped,\n      avgFps,\n    };\n  }\n\n  /**\n   * Report per-conversation playback stats via telemetry.\n   * Called when a conversation ends (transition to idle).\n   * @internal\n   */\n  private reportConversationStats(): void {\n    if (this.conversationFrameCount === 0) return;\n\n    const durationMs = this.conversationStartTime\n      ? Date.now() - this.conversationStartTime\n      : 0;\n    const avgFps =\n      this.conversationFpsReadings.length > 0\n        ? Math.round(\n            this.conversationFpsReadings.reduce((a, b) => a + b, 0) /\n              this.conversationFpsReadings.length,\n          )\n        : 0;\n    const totalExpected = this.conversationFrameCount + this.conversationLost;\n    const lossRate =\n      totalExpected > 0\n        ? Number(((this.conversationLost / totalExpected) * 100).toFixed(1))\n        : 0;\n\n    trackEvent('rtc_playback_stats', 'info', {\n      provider: this.providerName,\n      avg_fps: avgFps,\n      frame_count: this.conversationFrameCount,\n      frames_lost: this.conversationLost,\n      frames_recovered: this.conversationRecovered,\n      frames_dropped: this.conversationDropped,\n      loss_rate: lossRate,\n      duration_ms: durationMs,\n    });\n\n    // Accumulate into session-level stats\n    this.cumulativeTotalFrames += this.conversationFrameCount;\n    this.cumulativeLost += this.conversationLost;\n    this.cumulativeRecovered += this.conversationRecovered;\n    this.cumulativeDropped += this.conversationDropped;\n    this.cumulativeFpsReadings.push(...this.conversationFpsReadings);\n\n    // Reset per-conversation counters\n    this.conversationFrameCount = 0;\n    this.conversationLost = 0;\n    this.conversationRecovered = 0;\n    this.conversationDropped = 0;\n    this.conversationFpsReadings = [];\n    this.conversationStartTime = 0;\n  }\n\n  /**\n   * Clean up resources.\n   * @internal\n   */\n  dispose(): void {\n    this.stopTransition();\n    this.stopWatchdog();\n  }\n\n  /**\n   * Start the watchdog timer to detect stalled data streams.\n   * @internal\n   */\n  private startWatchdog(): void {\n    if (this.watchdogTimer) {\n      return; // Already running\n    }\n\n    this.watchdogTimer = setInterval(() => {\n      if (!this.isInSession) {\n        return;\n      }\n\n      // Don't check during transition playback (we're playing generated frames, not receiving)\n      if (this.isPlayingTransition) {\n        return;\n      }\n\n      const elapsed = Date.now() - this.lastFrameReceivedTime;\n      if (\n        elapsed > AnimationHandler.STALL_TIMEOUT_MS &&\n        !this.hasReportedStall\n      ) {\n        logger.error(\n          'AnimationHandler',\n          `Data stream stalled: no frames received for ${elapsed}ms, falling back to idle`,\n        );\n        this.hasReportedStall = true;\n        this.isStalledFallback = true;\n\n        // Trigger fallback to idle\n        this.startIdle();\n\n        // Notify external listener\n        if (this.onStreamStalledCallback) {\n          try {\n            this.onStreamStalledCallback();\n          } catch (e) {\n            logger.error(\n              'AnimationHandler',\n              'Error in onStreamStalled callback:',\n              e,\n            );\n          }\n        }\n      }\n    }, 1000); // Check every 1 second\n  }\n\n  /**\n   * Stop the watchdog timer.\n   * @internal\n   */\n  private stopWatchdog(): void {\n    if (this.watchdogTimer) {\n      clearInterval(this.watchdogTimer);\n      this.watchdogTimer = null;\n    }\n    this.hasReportedStall = false;\n    this.isStalledFallback = false;\n    this.stopPlaybackStats();\n  }\n\n  /**\n   * Start the playback stats reporting timer.\n   * @internal\n   */\n  private startPlaybackStats(): void {\n    if (this.playbackStatsTimer) {\n      return; // Already running\n    }\n    this.resetPlaybackStats();\n    this.playbackStatsTimer = setInterval(() => {\n      this.reportPlaybackStats();\n    }, 1000);\n  }\n\n  /**\n   * Stop the playback stats reporting timer.\n   * @internal\n   */\n  private stopPlaybackStats(): void {\n    if (this.playbackStatsTimer) {\n      clearInterval(this.playbackStatsTimer);\n      this.playbackStatsTimer = null;\n    }\n    this.resetPlaybackStats();\n  }\n\n  /**\n   * Reset playback stats counters.\n   * @internal\n   */\n  private resetPlaybackStats(): void {\n    this.playbackFrameCount = 0;\n    this.playbackFrameTimestamps = [];\n    this.playbackGapCount = 0;\n    this.playbackExpectedSeq = -1;\n  }\n\n  /**\n   * Report playback stats (called every 1s by timer).\n   * Logs FPS, frame loss rate, and playback jitter.\n   * @internal\n   */\n  private reportPlaybackStats(): void {\n    // Skip reporting during transitions (locally generated frames)\n    if (this.isPlayingTransition) {\n      this.resetPlaybackStats();\n      return;\n    }\n\n    // Skip if no frames were rendered this interval\n    if (this.playbackFrameCount === 0) {\n      return;\n    }\n\n    const fps = this.playbackFrameCount;\n    const totalExpected = this.playbackFrameCount + this.playbackGapCount;\n    const lossRate =\n      totalExpected > 0 ? (this.playbackGapCount / totalExpected) * 100 : 0;\n\n    // Calculate jitter: std deviation of inter-frame intervals\n    let jitter = 0;\n    if (this.playbackFrameTimestamps.length >= 2) {\n      const intervals: number[] = [];\n      for (let i = 1; i < this.playbackFrameTimestamps.length; i++) {\n        intervals.push(\n          this.playbackFrameTimestamps[i] - this.playbackFrameTimestamps[i - 1],\n        );\n      }\n      const mean = intervals.reduce((a, b) => a + b, 0) / intervals.length;\n      const variance =\n        intervals.reduce((sum, v) => sum + (v - mean) ** 2, 0) /\n        intervals.length;\n      jitter = Math.sqrt(variance);\n    }\n\n    logger.info(\n      'AnimationHandler',\n      `Playback stats: fps=${fps}, lossRate=${lossRate.toFixed(1)}%, jitter=${jitter.toFixed(1)}ms`,\n    );\n\n    // Feed per-conversation counters\n    this.conversationFrameCount += this.playbackFrameCount;\n    this.conversationLost += this.playbackGapCount;\n    this.conversationFpsReadings.push(fps);\n\n    // Reset counters for next interval\n    this.playbackFrameCount = 0;\n    this.playbackFrameTimestamps = [];\n    this.playbackGapCount = 0;\n  }\n\n  // ── Jitter Buffer ──\n\n  /**\n   * Insert a frame into the jitter buffer.\n   * Handles dedup, enforces max size, and drives the buffer state machine.\n   * @internal\n   */\n  private bufferFrame(protobufData: ArrayBuffer, seq: number): void {\n    // Never allow frames older than what we've already rendered.\n    if (this.lastRenderedFrameSeq >= 0 && seq <= this.lastRenderedFrameSeq) {\n      logger.warn(\n        'AnimationHandler',\n        `Jitter buffer: dropping stale frame seq=${seq} (lastRendered=${this.lastRenderedFrameSeq})`,\n      );\n      this.conversationDropped++;\n      return;\n    }\n\n    // If we're already waiting for a newer sequence, this frame arrived too late.\n    if (this.bufferNextSeq >= 0 && seq < this.bufferNextSeq) {\n      logger.warn(\n        'AnimationHandler',\n        `Jitter buffer: dropping late frame seq=${seq} (nextExpected=${this.bufferNextSeq})`,\n      );\n      this.conversationDropped++;\n      return;\n    }\n\n    // Dedup — server sends each frame twice for resilience\n    if (this.frameBuffer.has(seq)) {\n      return;\n    }\n\n    this.frameBuffer.set(seq, { protobufData, seq, receivedAt: performance.now() });\n\n    // Enforce max buffer size — drop oldest when full\n    if (this.frameBuffer.size > AnimationHandler.BUFFER_MAX_SIZE) {\n      let oldestSeq = Infinity;\n      for (const k of this.frameBuffer.keys()) {\n        if (k < oldestSeq) oldestSeq = k;\n      }\n      this.frameBuffer.delete(oldestSeq);\n      this.conversationDropped++;\n      logger.warn(\n        'AnimationHandler',\n        `Jitter buffer: overflow, dropping seq=${oldestSeq} (nextExpected=${this.bufferNextSeq})`,\n      );\n    }\n\n    // State machine transitions\n    switch (this.bufferState) {\n      case 'direct':\n        this.bufferState = 'filling';\n        if (this.bufferNextSeq < 0) {\n          this.bufferNextSeq = seq;\n        }\n        logger.info(\n          'AnimationHandler',\n          `Jitter buffer: filling (first frame seq=${seq})`,\n        );\n        if (this.frameBuffer.size >= AnimationHandler.BUFFER_INITIAL_FILL) {\n          this.startBufferDrain();\n        }\n        break;\n      case 'filling':\n        if (this.frameBuffer.size >= AnimationHandler.BUFFER_INITIAL_FILL) {\n          this.startBufferDrain();\n        }\n        break;\n      case 'starved':\n        this.startBufferDrain();\n        break;\n      case 'draining':\n        // Already draining, frame will be picked up by drain loop\n        break;\n    }\n  }\n\n  /**\n   * Drop buffered frames that are now too old to ever be rendered in-order.\n   * @internal\n   */\n  private dropStaleBufferedFrames(): void {\n    if (this.frameBuffer.size === 0) {\n      return;\n    }\n\n    const minAllowedSeq = Math.max(\n      this.bufferNextSeq,\n      this.lastRenderedFrameSeq + 1,\n    );\n    if (minAllowedSeq < 0) {\n      return;\n    }\n\n    let dropped = 0;\n    for (const seq of Array.from(this.frameBuffer.keys())) {\n      if (seq < minAllowedSeq) {\n        this.frameBuffer.delete(seq);\n        dropped++;\n      }\n    }\n\n    if (dropped > 0) {\n      logger.warn(\n        'AnimationHandler',\n        `Jitter buffer: dropped ${dropped} stale frame(s) older than seq=${minAllowedSeq}`,\n      );\n    }\n  }\n\n  /**\n   * Find the lowest buffered sequence at or after minSeq.\n   * @internal\n   */\n  private findLowestBufferedSeqAtOrAfter(minSeq: number): number | null {\n    let candidate = Infinity;\n    for (const seq of this.frameBuffer.keys()) {\n      if (seq >= minSeq && seq < candidate) {\n        candidate = seq;\n      }\n    }\n    return candidate === Infinity ? null : candidate;\n  }\n\n  /**\n   * Begin draining the buffer at 25fps.\n   * @internal\n   */\n  private startBufferDrain(): void {\n    this.bufferState = 'draining';\n    if (this.bufferNextSeq < 0) {\n      let minSeq = Infinity;\n      for (const k of this.frameBuffer.keys()) {\n        if (k < minSeq) minSeq = k;\n      }\n      this.bufferNextSeq = minSeq;\n    }\n    logger.info(\n      'AnimationHandler',\n      `Jitter buffer: draining (${this.frameBuffer.size} frames buffered)`,\n    );\n    this.bufferLastDrainTime = performance.now();\n    this.drainBufferFrame();\n  }\n\n  /**\n   * Drain one frame from the buffer and schedule the next drain.\n   * Handles missing frames (skip-ahead after maxBufferDelayMs) and starvation.\n   * @internal\n   */\n  private drainBufferFrame(): void {\n    this.bufferDrainTimer = null;\n\n    if (this.bufferState !== 'draining') {\n      return;\n    }\n\n    this.dropStaleBufferedFrames();\n\n    const frame = this.frameBuffer.get(this.bufferNextSeq);\n\n    if (frame) {\n      // Expected frame found — render it\n      this.renderBufferedFrame(frame);\n      this.frameBuffer.delete(this.bufferNextSeq);\n      this.bufferNextSeq++;\n    } else if (this.frameBuffer.size > 0) {\n      // Expected frame missing — check if we should skip ahead to the next in-order frame.\n      const nextSeq = this.findLowestBufferedSeqAtOrAfter(this.bufferNextSeq);\n\n      if (nextSeq === null) {\n        this.bufferState = 'starved';\n        logger.warn(\n          'AnimationHandler',\n          'Jitter buffer: no in-order frames available, pausing drain',\n        );\n        return;\n      }\n\n      const nextFrame = this.frameBuffer.get(nextSeq)!;\n      const waitTime = performance.now() - nextFrame.receivedAt;\n\n      if (waitTime > this.config.maxBufferDelayMs) {\n        // Missing frame didn't arrive in time — skip ahead to the next available sequence.\n        const gap = Math.max(0, nextSeq - this.bufferNextSeq);\n        this.playbackGapCount += gap;\n        logger.warn(\n          'AnimationHandler',\n          `Jitter buffer: skipping ${gap} frame(s) from seq ${this.bufferNextSeq} to ${nextSeq} after ${waitTime.toFixed(1)}ms`,\n        );\n        this.renderBufferedFrame(nextFrame);\n        this.frameBuffer.delete(nextSeq);\n        this.bufferNextSeq = nextSeq + 1;\n      }\n      // else: wait for the missing frame (render nothing this cycle)\n    } else {\n      // Buffer empty — starvation\n      this.bufferState = 'starved';\n      logger.warn('AnimationHandler', 'Jitter buffer: starved, pausing drain');\n      return; // Don't schedule next drain\n    }\n\n    // Schedule next drain with drift correction\n    const now = performance.now();\n    const nextTarget =\n      this.bufferLastDrainTime + AnimationHandler.BUFFER_FRAME_INTERVAL_MS;\n    const delay = Math.max(0, nextTarget - now);\n    this.bufferLastDrainTime = nextTarget;\n    this.bufferDrainTimer = setTimeout(() => this.drainBufferFrame(), delay);\n  }\n\n  /**\n   * Render a single frame from the buffer and collect playback stats.\n   * @internal\n   */\n  private renderBufferedFrame(frame: BufferedFrame): void {\n    if (\n      this.lastRenderedFrameSeq >= 0 &&\n      frame.seq <= this.lastRenderedFrameSeq\n    ) {\n      logger.warn(\n        'AnimationHandler',\n        `Jitter buffer: refusing out-of-order render seq=${frame.seq} (lastRendered=${this.lastRenderedFrameSeq})`,\n      );\n      return;\n    }\n\n    this.renderer.renderFromProtobuf(frame.protobufData);\n    this.lastRenderedFrameSeq = frame.seq;\n    this.renderedFrameCount++;\n    this.logRenderedFrame('buffer', frame.seq);\n\n    // Playback stats\n    this.playbackFrameTimestamps.push(performance.now());\n    this.playbackFrameCount++;\n  }\n\n  /**\n   * Flush the jitter buffer, stop the drain loop, and revert to direct mode.\n   * @internal\n   */\n  private flushBuffer(): void {\n    this.frameBuffer.clear();\n    this.bufferState = 'direct';\n    this.bufferNextSeq = -1;\n    this.bufferLastDrainTime = 0;\n    if (this.bufferDrainTimer !== null) {\n      clearTimeout(this.bufferDrainTimer);\n      this.bufferDrainTimer = null;\n    }\n  }\n\n  /**\n   * Play a single transition frame and schedule the next one.\n   * @internal\n   */\n  private playTransitionFrame(): void {\n    if (\n      !this.isPlayingTransition ||\n      this.transitionFrameIndex >= this.transitionFrames.length\n    ) {\n      // Transition complete\n      const wasTransitioningToIdle = this.isTransitioningToIdle;\n      this.isPlayingTransition = false;\n      this.isTransitioningToIdle = false;\n      this.transitionFrames = [];\n      this.transitionFrameIndex = 0;\n      if (this.transitionTimeoutId !== null) {\n        clearTimeout(this.transitionTimeoutId);\n        this.transitionTimeoutId = null;\n      }\n      logger.info('AnimationHandler', 'Transition playback complete');\n\n      // If transitioning to idle, start idle animation\n      if (wasTransitioningToIdle) {\n        logger.info(\n          'AnimationHandler',\n          'Starting idle animation after transition',\n        );\n        this.renderer.renderFrame(undefined, true);\n        this.logRenderedFrame('idle');\n      }\n      return;\n    }\n\n    if (!this.renderer.isReady()) {\n      this.isPlayingTransition = false;\n      this.isTransitioningToIdle = false;\n      return;\n    }\n\n    const frame = this.transitionFrames[this.transitionFrameIndex];\n    this.renderer.renderFrame(frame);\n    this.logRenderedFrame('transition');\n    this.transitionFrameIndex++;\n\n    // Schedule next frame at 25fps (40ms)\n    this.transitionTimeoutId = setTimeout(() => {\n      if (this.isPlayingTransition) {\n        this.playTransitionFrame();\n      }\n    }, 40);\n  }\n\n  /**\n   * Emit a per-frame render log for debugging ordering issues.\n   * @internal\n   */\n  private logRenderedFrame(\n    source: 'direct' | 'buffer' | 'transition' | 'idle' | 'transition-fallback',\n    seq?: number,\n    isRecovered?: boolean,\n  ): void {\n    logger.info(\n      'AnimationHandler',\n      `Rendered frame: source=${source}, seq=${seq ?? 'n/a'}${isRecovered ? ' [RECOVERED]' : ''}`,\n    );\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/index8.js

@@ -1,189 +1,150 @@
 import { logger } from "./index7.js";
-import { BinaryReader } from "./index9.js";
-function decodeFlame(reader, length) {
-  const end = reader.pos + length;
-  const flame = {
-    translation: [],
-    rotation: [],
-    neckPose: [],
-    jawPose: [],
-    eyePose: [],
-    eyeLid: [],
-    expression: []
-  };
-  while (reader.pos < end) {
-    const tag = reader.uint32();
-    switch (tag >>> 3) {
-      case 1:
-        if (tag === 13) {
-          flame.translation.push(reader.float());
-        } else if (tag === 10) {
-          const end2 = reader.uint32() + reader.pos;
-          while (reader.pos < end2) {
-            flame.translation.push(reader.float());
-          }
-        }
-        break;
-      case 2:
-        if (tag === 21) {
-          flame.rotation.push(reader.float());
-        } else if (tag === 18) {
-          const end2 = reader.uint32() + reader.pos;
-          while (reader.pos < end2) {
-            flame.rotation.push(reader.float());
-          }
-        }
-        break;
-      case 3:
-        if (tag === 29) {
-          flame.neckPose.push(reader.float());
-        } else if (tag === 26) {
-          const end2 = reader.uint32() + reader.pos;
-          while (reader.pos < end2) {
-            flame.neckPose.push(reader.float());
-          }
-        }
-        break;
-      case 4:
-        if (tag === 37) {
-          flame.jawPose.push(reader.float());
-        } else if (tag === 34) {
-          const end2 = reader.uint32() + reader.pos;
-          while (reader.pos < end2) {
-            flame.jawPose.push(reader.float());
-          }
-        }
-        break;
-      case 5:
-        if (tag === 45) {
-          flame.eyePose.push(reader.float());
-        } else if (tag === 42) {
-          const end2 = reader.uint32() + reader.pos;
-          while (reader.pos < end2) {
-            flame.eyePose.push(reader.float());
-          }
-        }
-        break;
-      case 6:
-        if (tag === 53) {
-          flame.eyeLid.push(reader.float());
-        } else if (tag === 50) {
-          const end2 = reader.uint32() + reader.pos;
-          while (reader.pos < end2) {
-            flame.eyeLid.push(reader.float());
-          }
-        }
-        break;
-      case 7:
-        if (tag === 61) {
-          flame.expression.push(reader.float());
-        } else if (tag === 58) {
-          const end2 = reader.uint32() + reader.pos;
-          while (reader.pos < end2) {
-            flame.expression.push(reader.float());
-          }
-        }
-        break;
-      default:
-        reader.skip(tag & 7);
+const SDK_POSTHOG_INSTANCE_NAME = "spatialwalk-posthog";
+let posthogInstance = null;
+let sdkVersion = "1.0.0";
+let appId = "";
+let environment = "";
+const eventQueue = [];
+const MAX_QUEUE_SIZE = 50;
+let retryTimer = null;
+const RETRY_INTERVAL_MS = 500;
+const MAX_RETRY_MS = 1e4;
+const FILTERED_HOSTNAMES = ["localhost", "127.0.0.1", "0.0.0.0"];
+function initializeTelemetry(config) {
+  if (typeof window === "undefined") return;
+  if (config.sdkVersion) sdkVersion = config.sdkVersion;
+  if (config.appId) appId = config.appId;
+  if (config.environment) environment = config.environment;
+  posthogInstance = getPostHogInstance();
+  if (posthogInstance) {
+    logger.info("Telemetry", "PostHog instance found, telemetry enabled");
+    flushEventQueue();
+  } else {
+    logger.info("Telemetry", "PostHog instance not found yet, will retry");
+    startRetry();
+  }
+}
+function startRetry() {
+  if (retryTimer) return;
+  const startTime = Date.now();
+  retryTimer = setInterval(() => {
+    const instance = getPostHogInstance();
+    if (instance) {
+      logger.info("Telemetry", "PostHog instance found after retry, telemetry enabled");
+      flushEventQueue();
+      stopRetry();
+    } else if (Date.now() - startTime > MAX_RETRY_MS) {
+      logger.info("Telemetry", "PostHog instance not found after retries, queued events dropped");
+      eventQueue.length = 0;
+      stopRetry();
     }
+  }, RETRY_INTERVAL_MS);
+}
+function stopRetry() {
+  if (retryTimer) {
+    clearInterval(retryTimer);
+    retryTimer = null;
   }
-  return flame;
 }
-function decodeFlameAnimation(reader, length) {
-  const end = reader.pos + length;
-  const animation = { keyframes: [] };
-  while (reader.pos < end) {
-    const tag = reader.uint32();
-    switch (tag >>> 3) {
-      case 1:
-        if (tag === 10) {
-          animation.keyframes.push(decodeFlame(reader, reader.uint32()));
-        }
-        break;
-      default:
-        reader.skip(tag & 7);
+function flushEventQueue() {
+  if (!posthogInstance || eventQueue.length === 0) return;
+  logger.info("Telemetry", `Flushing ${eventQueue.length} queued events`);
+  for (const { event, level, properties } of eventQueue) {
+    try {
+      posthogInstance.capture(event, {
+        ...getCommonFields(),
+        level,
+        ...properties
+      });
+    } catch {
     }
   }
-  return animation;
+  eventQueue.length = 0;
 }
-function decodeServerResponseAnimation(reader, length) {
-  const end = reader.pos + length;
-  const response = {
-    connectionId: "",
-    reqId: "",
-    end: false,
-    animation: void 0
-  };
-  while (reader.pos < end) {
-    const tag = reader.uint32();
-    switch (tag >>> 3) {
-      case 1:
-        if (tag === 10) {
-          response.connectionId = reader.string();
-        }
-        break;
-      case 2:
-        if (tag === 18) {
-          response.reqId = reader.string();
-        }
-        break;
-      case 3:
-        if (tag === 24) {
-          response.end = reader.bool();
-        }
-        break;
-      case 4:
-        if (tag === 34) {
-          response.animation = decodeFlameAnimation(reader, reader.uint32());
+function getPostHogInstance() {
+  if (posthogInstance) return posthogInstance;
+  try {
+    const posthog = window.__posthog;
+    if (posthog && typeof posthog === "object") {
+      const instance = posthog[SDK_POSTHOG_INSTANCE_NAME];
+      if (instance && typeof instance.capture === "function") {
+        posthogInstance = instance;
+        return instance;
+      }
+    }
+    try {
+      const posthogModule = window.posthog;
+      if (posthogModule && typeof posthogModule.getInstance === "function") {
+        const instance = posthogModule.getInstance(SDK_POSTHOG_INSTANCE_NAME);
+        if (instance && typeof instance.capture === "function") {
+          posthogInstance = instance;
+          return instance;
         }
-        break;
-      default:
-        reader.skip(tag & 7);
+      }
+    } catch {
     }
+  } catch {
   }
-  return response;
+  return null;
 }
-function decodeAnimationMessage(data) {
-  const reader = new BinaryReader(data);
-  const message = {
-    type: 0,
-    serverResponseAnimation: void 0
+function shouldFilterHostname() {
+  if (typeof window === "undefined") return false;
+  return FILTERED_HOSTNAMES.includes(window.location.hostname);
+}
+function getCommonFields() {
+  return {
+    platform: "Web",
+    sdk_version: sdkVersion,
+    service_module: "rtc",
+    app_id: appId,
+    env: environment
   };
-  while (reader.pos < reader.len) {
-    const tag = reader.uint32();
-    switch (tag >>> 3) {
-      case 1:
-        if (tag === 8) {
-          message.type = reader.int32();
-        }
-        break;
-      case 6:
-        if (tag === 50) {
-          message.serverResponseAnimation = decodeServerResponseAnimation(reader, reader.uint32());
-        }
-        break;
-      default:
-        reader.skip(tag & 7);
+}
+function trackEvent(event, level = "info", properties = {}) {
+  if (typeof window === "undefined") return;
+  if (shouldFilterHostname()) return;
+  const fullProperties = {
+    ...properties,
+    timestamp: Date.now()
+  };
+  const instance = posthogInstance || getPostHogInstance();
+  if (!instance) {
+    if (eventQueue.length < MAX_QUEUE_SIZE) {
+      eventQueue.push({ event, level, properties: fullProperties });
     }
+    return;
+  }
+  if (eventQueue.length > 0) {
+    flushEventQueue();
+    stopRetry();
+  }
+  try {
+    instance.capture(event, {
+      ...getCommonFields(),
+      level,
+      ...fullProperties
+    });
+  } catch (error) {
+    logger.warn(
+      "Telemetry",
+      "Failed to track event:",
+      error instanceof Error ? error.message : String(error)
+    );
   }
-  return message;
 }
-function decodeAnimationKeyframes(protobufData) {
-  var _a, _b;
+function flushTelemetry() {
+  const instance = posthogInstance || getPostHogInstance();
+  if (!instance) return;
   try {
-    const message = decodeAnimationMessage(new Uint8Array(protobufData));
-    if ((_b = (_a = message.serverResponseAnimation) == null ? void 0 : _a.animation) == null ? void 0 : _b.keyframes) {
-      return message.serverResponseAnimation.animation.keyframes;
+    if (typeof instance.flush === "function") {
+      instance.flush();
     }
-    return null;
-  } catch (error) {
-    logger.error("proto", "Failed to decode animation keyframes:", error);
-    return null;
+  } catch {
   }
 }
 export {
-  decodeAnimationKeyframes,
-  decodeAnimationMessage
+  flushTelemetry,
+  initializeTelemetry,
+  trackEvent
 };
 //# sourceMappingURL=index8.js.map

package/dist/index8.js.map

@@ -1 +1 @@
-{"version":3,"file":"index8.js","sources":["../src/proto/animation.ts"],"sourcesContent":["/**\n * Minimal protobuf definitions for animation data decoding.\n *\n * This is a stripped-down version containing only the types needed\n * to decode animation frames from the server response.\n *\n * Based on driveningress/v2/driveningress.proto\n *\n * @packageDocumentation\n */\n\nimport { BinaryReader } from '@bufbuild/protobuf/wire';\nimport { logger } from '../utils';\n\n/**\n * Flame - represents a single animation frame.\n * Contains FLAME model parameters for facial animation.\n * @internal\n */\nexport interface Flame {\n  /** Translation parameters (3 floats: x, y, z) */\n  translation: number[];\n  /** Rotation parameters (quaternion or euler angles) */\n  rotation: number[];\n  /** Neck pose parameters */\n  neckPose: number[];\n  /** Jaw pose parameters */\n  jawPose: number[];\n  /** Eye pose parameters */\n  eyePose: number[];\n  /** Eyelid parameters */\n  eyeLid: number[];\n  /** Expression blend shape weights */\n  expression: number[];\n}\n\n/**\n * FlameAnimation - contains keyframes.\n * @internal\n */\nexport interface FlameAnimation {\n  keyframes: Flame[];\n}\n\n/**\n * ServerResponseAnimation - server response containing animation data.\n * @internal\n */\nexport interface ServerResponseAnimation {\n  connectionId: string;\n  reqId: string;\n  end: boolean;\n  animation?: FlameAnimation | undefined;\n}\n\n/**\n * AnimationMessage - top-level message wrapper.\n * @internal\n */\nexport interface AnimationMessage {\n  type: number;\n  serverResponseAnimation?: ServerResponseAnimation | undefined;\n}\n\n// ============== Decoders ==============\n\n/**\n * Decode a Flame message from protobuf.\n * @internal\n */\nfunction decodeFlame(reader: BinaryReader, length: number): Flame {\n  const end = reader.pos + length;\n  const flame: Flame = {\n    translation: [],\n    rotation: [],\n    neckPose: [],\n    jawPose: [],\n    eyePose: [],\n    eyeLid: [],\n    expression: [],\n  };\n\n  while (reader.pos < end) {\n    const tag = reader.uint32();\n    switch (tag >>> 3) {\n      case 1: // translation\n        if (tag === 13) {\n          flame.translation.push(reader.float());\n        } else if (tag === 10) {\n          const end2 = reader.uint32() + reader.pos;\n          while (reader.pos < end2) {\n            flame.translation.push(reader.float());\n          }\n        }\n        break;\n      case 2: // rotation\n        if (tag === 21) {\n          flame.rotation.push(reader.float());\n        } else if (tag === 18) {\n          const end2 = reader.uint32() + reader.pos;\n          while (reader.pos < end2) {\n            flame.rotation.push(reader.float());\n          }\n        }\n        break;\n      case 3: // neckPose\n        if (tag === 29) {\n          flame.neckPose.push(reader.float());\n        } else if (tag === 26) {\n          const end2 = reader.uint32() + reader.pos;\n          while (reader.pos < end2) {\n            flame.neckPose.push(reader.float());\n          }\n        }\n        break;\n      case 4: // jawPose\n        if (tag === 37) {\n          flame.jawPose.push(reader.float());\n        } else if (tag === 34) {\n          const end2 = reader.uint32() + reader.pos;\n          while (reader.pos < end2) {\n            flame.jawPose.push(reader.float());\n          }\n        }\n        break;\n      case 5: // eyePose\n        if (tag === 45) {\n          flame.eyePose.push(reader.float());\n        } else if (tag === 42) {\n          const end2 = reader.uint32() + reader.pos;\n          while (reader.pos < end2) {\n            flame.eyePose.push(reader.float());\n          }\n        }\n        break;\n      case 6: // eyeLid\n        if (tag === 53) {\n          flame.eyeLid.push(reader.float());\n        } else if (tag === 50) {\n          const end2 = reader.uint32() + reader.pos;\n          while (reader.pos < end2) {\n            flame.eyeLid.push(reader.float());\n          }\n        }\n        break;\n      case 7: // expression\n        if (tag === 61) {\n          flame.expression.push(reader.float());\n        } else if (tag === 58) {\n          const end2 = reader.uint32() + reader.pos;\n          while (reader.pos < end2) {\n            flame.expression.push(reader.float());\n          }\n        }\n        break;\n      default:\n        reader.skip(tag & 7);\n    }\n  }\n\n  return flame;\n}\n\n/**\n * Decode a FlameAnimation message from protobuf.\n * @internal\n */\nfunction decodeFlameAnimation(reader: BinaryReader, length: number): FlameAnimation {\n  const end = reader.pos + length;\n  const animation: FlameAnimation = { keyframes: [] };\n\n  while (reader.pos < end) {\n    const tag = reader.uint32();\n    switch (tag >>> 3) {\n      case 1: // keyframes\n        if (tag === 10) {\n          animation.keyframes.push(decodeFlame(reader, reader.uint32()));\n        }\n        break;\n      default:\n        reader.skip(tag & 7);\n    }\n  }\n\n  return animation;\n}\n\n/**\n * Decode a ServerResponseAnimation message from protobuf.\n * @internal\n */\nfunction decodeServerResponseAnimation(reader: BinaryReader, length: number): ServerResponseAnimation {\n  const end = reader.pos + length;\n  const response: ServerResponseAnimation = {\n    connectionId: \"\",\n    reqId: \"\",\n    end: false,\n    animation: undefined,\n  };\n\n  while (reader.pos < end) {\n    const tag = reader.uint32();\n    switch (tag >>> 3) {\n      case 1: // connectionId\n        if (tag === 10) {\n          response.connectionId = reader.string();\n        }\n        break;\n      case 2: // reqId\n        if (tag === 18) {\n          response.reqId = reader.string();\n        }\n        break;\n      case 3: // end\n        if (tag === 24) {\n          response.end = reader.bool();\n        }\n        break;\n      case 4: // animation\n        if (tag === 34) {\n          response.animation = decodeFlameAnimation(reader, reader.uint32());\n        }\n        break;\n      default:\n        reader.skip(tag & 7);\n    }\n  }\n\n  return response;\n}\n\n/**\n * Decode an AnimationMessage from protobuf bytes.\n * @param data - Raw protobuf bytes\n * @returns Decoded AnimationMessage\n * @internal\n */\nexport function decodeAnimationMessage(data: Uint8Array): AnimationMessage {\n  const reader = new BinaryReader(data);\n  const message: AnimationMessage = {\n    type: 0,\n    serverResponseAnimation: undefined,\n  };\n\n  while (reader.pos < reader.len) {\n    const tag = reader.uint32();\n    switch (tag >>> 3) {\n      case 1: // type\n        if (tag === 8) {\n          message.type = reader.int32();\n        }\n        break;\n      case 6: // serverResponseAnimation (field number 6 in the proto)\n        if (tag === 50) {\n          message.serverResponseAnimation = decodeServerResponseAnimation(reader, reader.uint32());\n        }\n        break;\n      default:\n        reader.skip(tag & 7);\n    }\n  }\n\n  return message;\n}\n\n/**\n * Decode animation keyframes from protobuf data.\n * @param protobufData - Raw protobuf bytes\n * @returns Array of Flame keyframes, or null if decoding fails\n * @internal\n */\nexport function decodeAnimationKeyframes(protobufData: ArrayBuffer): Flame[] | null {\n  try {\n    const message = decodeAnimationMessage(new Uint8Array(protobufData));\n\n    if (message.serverResponseAnimation?.animation?.keyframes) {\n      return message.serverResponseAnimation.animation.keyframes;\n    }\n\n    return null;\n  } catch (error) {\n    logger.error('proto', 'Failed to decode animation keyframes:', error);\n    return null;\n  }\n}\n"],"names":[],"mappings":";;AAsEA,SAAS,YAAY,QAAsB,QAAuB;AAChE,QAAM,MAAM,OAAO,MAAM;AACzB,QAAM,QAAe;AAAA,IACnB,aAAa,CAAA;AAAA,IACb,UAAU,CAAA;AAAA,IACV,UAAU,CAAA;AAAA,IACV,SAAS,CAAA;AAAA,IACT,SAAS,CAAA;AAAA,IACT,QAAQ,CAAA;AAAA,IACR,YAAY,CAAA;AAAA,EAAC;AAGf,SAAO,OAAO,MAAM,KAAK;AACvB,UAAM,MAAM,OAAO,OAAA;AACnB,YAAQ,QAAQ,GAAA;AAAA,MACd,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,gBAAM,YAAY,KAAK,OAAO,MAAA,CAAO;AAAA,QACvC,WAAW,QAAQ,IAAI;AACrB,gBAAM,OAAO,OAAO,OAAA,IAAW,OAAO;AACtC,iBAAO,OAAO,MAAM,MAAM;AACxB,kBAAM,YAAY,KAAK,OAAO,MAAA,CAAO;AAAA,UACvC;AAAA,QACF;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,gBAAM,SAAS,KAAK,OAAO,MAAA,CAAO;AAAA,QACpC,WAAW,QAAQ,IAAI;AACrB,gBAAM,OAAO,OAAO,OAAA,IAAW,OAAO;AACtC,iBAAO,OAAO,MAAM,MAAM;AACxB,kBAAM,SAAS,KAAK,OAAO,MAAA,CAAO;AAAA,UACpC;AAAA,QACF;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,gBAAM,SAAS,KAAK,OAAO,MAAA,CAAO;AAAA,QACpC,WAAW,QAAQ,IAAI;AACrB,gBAAM,OAAO,OAAO,OAAA,IAAW,OAAO;AACtC,iBAAO,OAAO,MAAM,MAAM;AACxB,kBAAM,SAAS,KAAK,OAAO,MAAA,CAAO;AAAA,UACpC;AAAA,QACF;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,gBAAM,QAAQ,KAAK,OAAO,MAAA,CAAO;AAAA,QACnC,WAAW,QAAQ,IAAI;AACrB,gBAAM,OAAO,OAAO,OAAA,IAAW,OAAO;AACtC,iBAAO,OAAO,MAAM,MAAM;AACxB,kBAAM,QAAQ,KAAK,OAAO,MAAA,CAAO;AAAA,UACnC;AAAA,QACF;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,gBAAM,QAAQ,KAAK,OAAO,MAAA,CAAO;AAAA,QACnC,WAAW,QAAQ,IAAI;AACrB,gBAAM,OAAO,OAAO,OAAA,IAAW,OAAO;AACtC,iBAAO,OAAO,MAAM,MAAM;AACxB,kBAAM,QAAQ,KAAK,OAAO,MAAA,CAAO;AAAA,UACnC;AAAA,QACF;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,gBAAM,OAAO,KAAK,OAAO,MAAA,CAAO;AAAA,QAClC,WAAW,QAAQ,IAAI;AACrB,gBAAM,OAAO,OAAO,OAAA,IAAW,OAAO;AACtC,iBAAO,OAAO,MAAM,MAAM;AACxB,kBAAM,OAAO,KAAK,OAAO,MAAA,CAAO;AAAA,UAClC;AAAA,QACF;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,gBAAM,WAAW,KAAK,OAAO,MAAA,CAAO;AAAA,QACtC,WAAW,QAAQ,IAAI;AACrB,gBAAM,OAAO,OAAO,OAAA,IAAW,OAAO;AACtC,iBAAO,OAAO,MAAM,MAAM;AACxB,kBAAM,WAAW,KAAK,OAAO,MAAA,CAAO;AAAA,UACtC;AAAA,QACF;AACA;AAAA,MACF;AACE,eAAO,KAAK,MAAM,CAAC;AAAA,IAAA;AAAA,EAEzB;AAEA,SAAO;AACT;AAMA,SAAS,qBAAqB,QAAsB,QAAgC;AAClF,QAAM,MAAM,OAAO,MAAM;AACzB,QAAM,YAA4B,EAAE,WAAW,GAAC;AAEhD,SAAO,OAAO,MAAM,KAAK;AACvB,UAAM,MAAM,OAAO,OAAA;AACnB,YAAQ,QAAQ,GAAA;AAAA,MACd,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,oBAAU,UAAU,KAAK,YAAY,QAAQ,OAAO,OAAA,CAAQ,CAAC;AAAA,QAC/D;AACA;AAAA,MACF;AACE,eAAO,KAAK,MAAM,CAAC;AAAA,IAAA;AAAA,EAEzB;AAEA,SAAO;AACT;AAMA,SAAS,8BAA8B,QAAsB,QAAyC;AACpG,QAAM,MAAM,OAAO,MAAM;AACzB,QAAM,WAAoC;AAAA,IACxC,cAAc;AAAA,IACd,OAAO;AAAA,IACP,KAAK;AAAA,IACL,WAAW;AAAA,EAAA;AAGb,SAAO,OAAO,MAAM,KAAK;AACvB,UAAM,MAAM,OAAO,OAAA;AACnB,YAAQ,QAAQ,GAAA;AAAA,MACd,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,mBAAS,eAAe,OAAO,OAAA;AAAA,QACjC;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,mBAAS,QAAQ,OAAO,OAAA;AAAA,QAC1B;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,mBAAS,MAAM,OAAO,KAAA;AAAA,QACxB;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,mBAAS,YAAY,qBAAqB,QAAQ,OAAO,QAAQ;AAAA,QACnE;AACA;AAAA,MACF;AACE,eAAO,KAAK,MAAM,CAAC;AAAA,IAAA;AAAA,EAEzB;AAEA,SAAO;AACT;AAQO,SAAS,uBAAuB,MAAoC;AACzE,QAAM,SAAS,IAAI,aAAa,IAAI;AACpC,QAAM,UAA4B;AAAA,IAChC,MAAM;AAAA,IACN,yBAAyB;AAAA,EAAA;AAG3B,SAAO,OAAO,MAAM,OAAO,KAAK;AAC9B,UAAM,MAAM,OAAO,OAAA;AACnB,YAAQ,QAAQ,GAAA;AAAA,MACd,KAAK;AACH,YAAI,QAAQ,GAAG;AACb,kBAAQ,OAAO,OAAO,MAAA;AAAA,QACxB;AACA;AAAA,MACF,KAAK;AACH,YAAI,QAAQ,IAAI;AACd,kBAAQ,0BAA0B,8BAA8B,QAAQ,OAAO,QAAQ;AAAA,QACzF;AACA;AAAA,MACF;AACE,eAAO,KAAK,MAAM,CAAC;AAAA,IAAA;AAAA,EAEzB;AAEA,SAAO;AACT;AAQO,SAAS,yBAAyB,cAA2C;;AAClF,MAAI;AACF,UAAM,UAAU,uBAAuB,IAAI,WAAW,YAAY,CAAC;AAEnE,SAAI,mBAAQ,4BAAR,mBAAiC,cAAjC,mBAA4C,WAAW;AACzD,aAAO,QAAQ,wBAAwB,UAAU;AAAA,IACnD;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,WAAO,MAAM,SAAS,yCAAyC,KAAK;AACpE,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"index8.js","sources":["../src/utils/telemetry.ts"],"sourcesContent":["/**\n * PostHog telemetry for @spatialwalk/avatarkit-rtc SDK.\n *\n * Reuses the same PostHog named instance as @spatialwalk/avatarkit to avoid\n * duplicate SDK initializations. If avatarkit has already initialized PostHog,\n * this module piggybacks on that instance. Otherwise events are silently dropped.\n *\n * @packageDocumentation\n * @internal\n */\n\nimport { logger } from './logger';\n\n// PostHog named instance (must match avatarkit's instance name)\nconst SDK_POSTHOG_INSTANCE_NAME = 'spatialwalk-posthog';\n\n// Cached PostHog instance\nlet posthogInstance: any = null;\n\n// SDK metadata\nlet sdkVersion = '1.0.0';\nlet appId = '';\nlet environment = '';\n\n// Event queue for events fired before PostHog is available\ninterface QueuedEvent {\n  event: string;\n  level: 'info' | 'warning' | 'error';\n  properties: Record<string, unknown>;\n}\nconst eventQueue: QueuedEvent[] = [];\nconst MAX_QUEUE_SIZE = 50;\n\n// Retry timer for finding PostHog instance\nlet retryTimer: ReturnType<typeof setInterval> | null = null;\nconst RETRY_INTERVAL_MS = 500;\nconst MAX_RETRY_MS = 10000;\n\n// Hostnames to filter (no telemetry)\nconst FILTERED_HOSTNAMES = ['localhost', '127.0.0.1', '0.0.0.0'] as const;\n\n/**\n * Telemetry configuration options.\n */\nexport interface TelemetryConfig {\n  /** SDK version string */\n  sdkVersion?: string;\n  /** Application ID */\n  appId?: string;\n  /** Environment (cn/intl) */\n  environment?: string;\n}\n\n/**\n * Initialize telemetry by locating the shared PostHog instance from avatarkit.\n * Must be called after AvatarSDK.initialize().\n * @internal\n */\nexport function initializeTelemetry(config: TelemetryConfig): void {\n  if (typeof window === 'undefined') return;\n\n  if (config.sdkVersion) sdkVersion = config.sdkVersion;\n  if (config.appId) appId = config.appId;\n  if (config.environment) environment = config.environment;\n\n  posthogInstance = getPostHogInstance();\n  if (posthogInstance) {\n    logger.info('Telemetry', 'PostHog instance found, telemetry enabled');\n    flushEventQueue();\n  } else {\n    logger.info('Telemetry', 'PostHog instance not found yet, will retry');\n    startRetry();\n  }\n}\n\n/**\n * Periodically retry finding the PostHog instance (avatarkit may initialize later).\n * @internal\n */\nfunction startRetry(): void {\n  if (retryTimer) return;\n\n  const startTime = Date.now();\n  retryTimer = setInterval(() => {\n    const instance = getPostHogInstance();\n    if (instance) {\n      logger.info('Telemetry', 'PostHog instance found after retry, telemetry enabled');\n      flushEventQueue();\n      stopRetry();\n    } else if (Date.now() - startTime > MAX_RETRY_MS) {\n      logger.info('Telemetry', 'PostHog instance not found after retries, queued events dropped');\n      eventQueue.length = 0;\n      stopRetry();\n    }\n  }, RETRY_INTERVAL_MS);\n}\n\n/**\n * Stop the retry timer.\n * @internal\n */\nfunction stopRetry(): void {\n  if (retryTimer) {\n    clearInterval(retryTimer);\n    retryTimer = null;\n  }\n}\n\n/**\n * Flush queued events to PostHog.\n * @internal\n */\nfunction flushEventQueue(): void {\n  if (!posthogInstance || eventQueue.length === 0) return;\n\n  logger.info('Telemetry', `Flushing ${eventQueue.length} queued events`);\n  for (const { event, level, properties } of eventQueue) {\n    try {\n      posthogInstance.capture(event, {\n        ...getCommonFields(),\n        level,\n        ...properties,\n      });\n    } catch {\n      // Ignore flush errors for individual events\n    }\n  }\n  eventQueue.length = 0;\n}\n\n/**\n * Try to get the shared PostHog named instance from avatarkit.\n * @internal\n */\nfunction getPostHogInstance(): any {\n  if (posthogInstance) return posthogInstance;\n\n  try {\n    // PostHog JS SDK stores named instances that can be retrieved\n    // We try to get the instance that avatarkit already initialized\n    const posthog = (window as any).__posthog;\n    if (posthog && typeof posthog === 'object') {\n      // Try direct named instance lookup\n      const instance = posthog[SDK_POSTHOG_INSTANCE_NAME];\n      if (instance && typeof instance.capture === 'function') {\n        posthogInstance = instance;\n        return instance;\n      }\n    }\n\n    // Fallback: try posthog-js getInstance API\n    try {\n      const posthogModule = (window as any).posthog;\n      if (posthogModule && typeof posthogModule.getInstance === 'function') {\n        const instance = posthogModule.getInstance(SDK_POSTHOG_INSTANCE_NAME);\n        if (instance && typeof instance.capture === 'function') {\n          posthogInstance = instance;\n          return instance;\n        }\n      }\n    } catch {\n      // getInstance not available\n    }\n  } catch {\n    // PostHog not available\n  }\n\n  return null;\n}\n\n/**\n * Check if current hostname should be filtered.\n * @internal\n */\nfunction shouldFilterHostname(): boolean {\n  if (typeof window === 'undefined') return false;\n  return (FILTERED_HOSTNAMES as readonly string[]).includes(window.location.hostname);\n}\n\n/**\n * Get common fields attached to all events.\n * @internal\n */\nfunction getCommonFields(): Record<string, unknown> {\n  return {\n    platform: 'Web',\n    sdk_version: sdkVersion,\n    service_module: 'rtc',\n    app_id: appId,\n    env: environment,\n  };\n}\n\n/**\n * Track a telemetry event.\n * @param event - Event name\n * @param level - Log level\n * @param properties - Event-specific properties\n * @internal\n */\nexport function trackEvent(\n  event: string,\n  level: 'info' | 'warning' | 'error' = 'info',\n  properties: Record<string, unknown> = {},\n): void {\n  if (typeof window === 'undefined') return;\n  if (shouldFilterHostname()) return;\n\n  const fullProperties = {\n    ...properties,\n    timestamp: Date.now(),\n  };\n\n  // Try to get instance if not cached yet\n  const instance = posthogInstance || getPostHogInstance();\n  if (!instance) {\n    // Queue event for later\n    if (eventQueue.length < MAX_QUEUE_SIZE) {\n      eventQueue.push({ event, level, properties: fullProperties });\n    }\n    return;\n  }\n\n  // Instance just became available — flush any queued events first\n  if (eventQueue.length > 0) {\n    flushEventQueue();\n    stopRetry();\n  }\n\n  try {\n    instance.capture(event, {\n      ...getCommonFields(),\n      level,\n      ...fullProperties,\n    });\n  } catch (error) {\n    logger.warn(\n      'Telemetry',\n      'Failed to track event:',\n      error instanceof Error ? error.message : String(error),\n    );\n  }\n}\n\n/**\n * Flush pending events (for page close / disconnect).\n * @internal\n */\nexport function flushTelemetry(): void {\n  const instance = posthogInstance || getPostHogInstance();\n  if (!instance) return;\n\n  try {\n    if (typeof instance.flush === 'function') {\n      instance.flush();\n    }\n  } catch {\n    // Ignore flush errors\n  }\n}\n"],"names":[],"mappings":"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"}