ug-js-sdk 3.0.51 → 3.0.57

package/dist/ug-core/playback-manager/PlaybackManager.d.ts

@@ -1,17 +1,71 @@
 import { EventEmitter } from '../core/EventEmitter';
 import { InteractResponse, PlaybackCapabilities } from '../types';
 import { IConversationManager } from '../conversation-manager/types';
+/**
+ * Events emitted by the PlaybackManager.
+ */
 export declare const PlaybackManagerEvents: {
+    /** Emitted when audio playback starts */
     readonly Playing: "playing";
+    /** Emitted when audio playback is paused */
     readonly Paused: "paused";
+    /** Emitted when a playback error occurs */
     readonly PlaybackError: "playbackError";
+    /** Emitted when subtitle word highlighting changes (karaoke-style) */
     readonly SubtitleWordChange: "subtitleWordChange";
+    /** Emitted when subtitle text changes (new sentence/phrase) */
     readonly SubtitleChange: "subtitleChange";
+    /** Emitted when the displayed image changes */
     readonly ImageChange: "imageChange";
+    /** Emitted ~500ms before playback completes (for pre-loading next content) */
     readonly AboutToComplete: "aboutToComplete";
+    /** Emitted when all audio playback has finished */
     readonly Finished: "finished";
+    /** Emitted when avatar animation state changes */
     readonly AvatarAnimationChanged: "avatarAnimationChanged";
 };
+/**
+ * Manages playback of assistant responses including audio, subtitles, and avatar animations.
+ *
+ * The PlaybackManager coordinates multiple sub-components:
+ * - **AudioPlayer**: Gap-free MP3 audio playback using Web Audio API
+ * - **SubtitleManager**: Real-time captions with word-level highlighting
+ * - **VisemeScheduler**: Lip-sync data scheduling (for 3D avatars)
+ * - **AvatarManager**: Animation state management (idle, talking, thinking, listening)
+ *
+ * The manager receives messages from the WebSocket connection and routes them to
+ * the appropriate sub-component for synchronized playback.
+ *
+ * @example
+ * ```typescript
+ * const playback = new PlaybackManager({
+ *   audio: true,
+ *   subtitles: true,
+ *   avatar: true,
+ * })
+ *
+ * playback.on(PlaybackManagerEvents.SubtitleChange, (event) => {
+ *   displaySubtitle(event.subtitle)
+ * })
+ *
+ * playback.on(PlaybackManagerEvents.Finished, () => {
+ *   console.log('Playback complete')
+ * })
+ *
+ * await playback.initialize()
+ *
+ * // Messages from server are passed to handleMessage()
+ * playback.handleMessage(audioMessage)
+ * playback.handleMessage(subtitleMessage)
+ * ```
+ *
+ * @fires PlaybackManagerEvents.Playing - When playback starts
+ * @fires PlaybackManagerEvents.Paused - When playback is paused
+ * @fires PlaybackManagerEvents.Finished - When all playback completes
+ * @fires PlaybackManagerEvents.SubtitleChange - When subtitle text updates
+ * @fires PlaybackManagerEvents.SubtitleWordChange - For word-by-word highlighting
+ * @fires PlaybackManagerEvents.AvatarAnimationChanged - When avatar state changes
+ */
 export declare class PlaybackManager extends EventEmitter {
     private capabilities;
     private audioPlayer;
@@ -20,15 +74,65 @@ export declare class PlaybackManager extends EventEmitter {
     private isPaused;
     private hasStarted;
     private avatarManager;
+    /**
+     * Creates a new PlaybackManager instance.
+     *
+     * @param capabilities - Configuration for which playback features are enabled
+     * @param capabilities.audio - Enable audio playback (default: true)
+     * @param capabilities.subtitles - Enable real-time captions (default: true)
+     * @param capabilities.viseme - Enable lip-sync data (default: false)
+     * @param capabilities.avatar - Enable avatar animations (default: true)
+     */
     constructor(capabilities: PlaybackCapabilities);
     private setupChildListeners;
     resetState(): void;
+    /**
+     * Initializes the playback manager and its sub-components.
+     *
+     * Must be called before handling any messages. Initializes the
+     * AudioPlayer and prepares the AudioContext.
+     */
     initialize(): Promise<void>;
+    /**
+     * Handles incoming messages from the server and routes them to appropriate handlers.
+     *
+     * @param message - The interaction response message from the WebSocket
+     *
+     * Message types handled:
+     * - `audio`: Base64 audio chunk → AudioPlayer
+     * - `subtitles`: Caption data → SubtitleManager
+     * - `viseme`: Lip-sync data → VisemeScheduler
+     * - `audio_complete`: Signals all audio has been sent
+     * - `image`: Generated image data
+     */
     handleMessage(message: InteractResponse): void;
     enqueue(message: InteractResponse): void;
+    /**
+     * Convert PUG SubtitleUnit[] format to SDK SubtitleMessage format.
+     * PUG sends per-character timing as objects; SDK expects parallel arrays.
+     */
+    private convertSubtitleUnitsToMessage;
     markAudioComplete(): void;
+    /**
+     * Starts playback of queued audio, subtitles, and animations.
+     *
+     * Typically called automatically when enough audio is buffered.
+     * Sets avatar to "talking" animation state.
+     */
     play(): Promise<void>;
+    /**
+     * Pauses all playback.
+     *
+     * Pauses audio, subtitles, and visemes. Sets avatar to "idle" state.
+     * Can be resumed with `resume()`.
+     */
     pause(): Promise<void>;
+    /**
+     * Resumes paused playback.
+     *
+     * Continues audio, subtitles, and visemes from where they were paused.
+     * Sets avatar back to "talking" state.
+     */
     resume(): Promise<void>;
     resumeAudioContext(): Promise<void>;
     /**

package/dist/ug-core/playback-manager/PlaybackManager.js

@@ -6,17 +6,71 @@ import { SubtitleManager, SubtitleManagerEvents } from './subtitle-manager/Subti
 import { AudioPlayerEvents } from './types';
 import { VisemeScheduler } from './viseme-scheduler/VisemeScheduler';
 import { AvatarManager } from './avatar-manager/AvatarManager';
+/**
+ * Events emitted by the PlaybackManager.
+ */
 export const PlaybackManagerEvents = {
+    /** Emitted when audio playback starts */
     Playing: 'playing',
+    /** Emitted when audio playback is paused */
     Paused: 'paused',
+    /** Emitted when a playback error occurs */
     PlaybackError: 'playbackError',
+    /** Emitted when subtitle word highlighting changes (karaoke-style) */
     SubtitleWordChange: 'subtitleWordChange',
+    /** Emitted when subtitle text changes (new sentence/phrase) */
     SubtitleChange: 'subtitleChange',
+    /** Emitted when the displayed image changes */
     ImageChange: 'imageChange',
+    /** Emitted ~500ms before playback completes (for pre-loading next content) */
     AboutToComplete: 'aboutToComplete',
+    /** Emitted when all audio playback has finished */
     Finished: 'finished',
+    /** Emitted when avatar animation state changes */
     AvatarAnimationChanged: 'avatarAnimationChanged',
 };
+/**
+ * Manages playback of assistant responses including audio, subtitles, and avatar animations.
+ *
+ * The PlaybackManager coordinates multiple sub-components:
+ * - **AudioPlayer**: Gap-free MP3 audio playback using Web Audio API
+ * - **SubtitleManager**: Real-time captions with word-level highlighting
+ * - **VisemeScheduler**: Lip-sync data scheduling (for 3D avatars)
+ * - **AvatarManager**: Animation state management (idle, talking, thinking, listening)
+ *
+ * The manager receives messages from the WebSocket connection and routes them to
+ * the appropriate sub-component for synchronized playback.
+ *
+ * @example
+ * ```typescript
+ * const playback = new PlaybackManager({
+ *   audio: true,
+ *   subtitles: true,
+ *   avatar: true,
+ * })
+ *
+ * playback.on(PlaybackManagerEvents.SubtitleChange, (event) => {
+ *   displaySubtitle(event.subtitle)
+ * })
+ *
+ * playback.on(PlaybackManagerEvents.Finished, () => {
+ *   console.log('Playback complete')
+ * })
+ *
+ * await playback.initialize()
+ *
+ * // Messages from server are passed to handleMessage()
+ * playback.handleMessage(audioMessage)
+ * playback.handleMessage(subtitleMessage)
+ * ```
+ *
+ * @fires PlaybackManagerEvents.Playing - When playback starts
+ * @fires PlaybackManagerEvents.Paused - When playback is paused
+ * @fires PlaybackManagerEvents.Finished - When all playback completes
+ * @fires PlaybackManagerEvents.SubtitleChange - When subtitle text updates
+ * @fires PlaybackManagerEvents.SubtitleWordChange - For word-by-word highlighting
+ * @fires PlaybackManagerEvents.AvatarAnimationChanged - When avatar state changes
+ */
 export class PlaybackManager extends EventEmitter {
     capabilities;
     audioPlayer;
@@ -25,6 +79,15 @@ export class PlaybackManager extends EventEmitter {
     isPaused = true;
     hasStarted = false;
     avatarManager;
+    /**
+     * Creates a new PlaybackManager instance.
+     *
+     * @param capabilities - Configuration for which playback features are enabled
+     * @param capabilities.audio - Enable audio playback (default: true)
+     * @param capabilities.subtitles - Enable real-time captions (default: true)
+     * @param capabilities.viseme - Enable lip-sync data (default: false)
+     * @param capabilities.avatar - Enable avatar animations (default: true)
+     */
     constructor(capabilities) {
         const logger = new DefaultLogger({ category: '🎪 PlaybackManager', style: StyleOrange });
         super(logger);
@@ -72,12 +135,30 @@ export class PlaybackManager extends EventEmitter {
         this.isPaused = true;
         this.hasStarted = false;
     }
+    /**
+     * Initializes the playback manager and its sub-components.
+     *
+     * Must be called before handling any messages. Initializes the
+     * AudioPlayer and prepares the AudioContext.
+     */
     async initialize() {
         this.logger.debug('Initialized', this.capabilities);
         this.isPaused = true;
         this.hasStarted = false;
         await this.audioPlayer.initialize();
     }
+    /**
+     * Handles incoming messages from the server and routes them to appropriate handlers.
+     *
+     * @param message - The interaction response message from the WebSocket
+     *
+     * Message types handled:
+     * - `audio`: Base64 audio chunk → AudioPlayer
+     * - `subtitles`: Caption data → SubtitleManager
+     * - `viseme`: Lip-sync data → VisemeScheduler
+     * - `audio_complete`: Signals all audio has been sent
+     * - `image`: Generated image data
+     */
     handleMessage(message) {
         if (message.event === 'audio' || message.event === 'subtitles' || message.event === 'viseme') {
             this.enqueue(message);
@@ -93,11 +174,29 @@ export class PlaybackManager extends EventEmitter {
         if (this.capabilities.audio && message.event === 'audio') {
             const audioMessage = message;
             this.audioPlayer.enqueue(audioMessage.audio);
+            // Handle embedded subtitles from PUG backend (character-level timing)
+            if (this.capabilities.subtitles && audioMessage.subtitles?.length) {
+                const subtitleMessage = this.convertSubtitleUnitsToMessage(audioMessage.subtitles);
+                this.subtitleManager.enqueue(subtitleMessage);
+            }
+        }
+        // Legacy: handle separate subtitle events (kept for backwards compatibility)
+        if (this.capabilities.subtitles && message.event === 'subtitles') {
+            const subtitleMessage = message;
+            this.subtitleManager.enqueue(subtitleMessage);
         }
-        // if (this.capabilities.subtitles && message.event === 'subtitles') {
-        //   const subtitleMessage = message as SubtitleMessage
-        //   this.subtitleManager.enqueue(subtitleMessage)
-        // }
+    }
+    /**
+     * Convert PUG SubtitleUnit[] format to SDK SubtitleMessage format.
+     * PUG sends per-character timing as objects; SDK expects parallel arrays.
+     */
+    convertSubtitleUnitsToMessage(units) {
+        return {
+            type: 'subtitles',
+            characters: units.map((u) => u.text),
+            start_times_ms: units.map((u) => Math.round(u.start_time_sec * 1000)),
+            durations_ms: units.map((u) => Math.round(u.duration_sec * 1000)),
+        };
     }
     markAudioComplete() {
         this.logger.debug('Marking audio as complete');
@@ -105,6 +204,12 @@ export class PlaybackManager extends EventEmitter {
             this.audioPlayer.markComplete();
         }
     }
+    /**
+     * Starts playback of queued audio, subtitles, and animations.
+     *
+     * Typically called automatically when enough audio is buffered.
+     * Sets avatar to "talking" animation state.
+     */
     async play() {
         this.isPaused = false;
         this.hasStarted = true;
@@ -116,6 +221,12 @@ export class PlaybackManager extends EventEmitter {
         ]);
         await this.emit(PlaybackManagerEvents.Playing);
     }
+    /**
+     * Pauses all playback.
+     *
+     * Pauses audio, subtitles, and visemes. Sets avatar to "idle" state.
+     * Can be resumed with `resume()`.
+     */
     async pause() {
         this.isPaused = true;
         this.audioPlayer.pause();
@@ -124,6 +235,12 @@ export class PlaybackManager extends EventEmitter {
         this.avatarManager.playIdle();
         await this.emit(PlaybackManagerEvents.Paused);
     }
+    /**
+     * Resumes paused playback.
+     *
+     * Continues audio, subtitles, and visemes from where they were paused.
+     * Sets avatar back to "talking" state.
+     */
     async resume() {
         if (!this.isPaused)
             return;

package/dist/ug-core/playback-manager/PlaybackManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybackManager.js","sourceRoot":"","sources":["../../../src/ug-core/playback-manager/PlaybackManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PlaybackManager.js","sourceRoot":"","sources":["../../../src/ug-core/playback-manager/PlaybackManager.ts"],"names":[],"mappings":"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"}

package/dist/ug-core/playback-manager/audio-player/AudioPlayer.d.ts

@@ -1,5 +1,59 @@
 import { EventEmitter } from '../../core/EventEmitter';
 import { IAudioPlayer } from '../types';
+/**
+ * Audio player for streaming MP3 playback in the browser.
+ *
+ * Handles real-time audio streaming by decoding MP3 frames and scheduling
+ * playback through the Web Audio API. Used internally by the SDK for
+ * text-to-speech audio playback.
+ *
+ * **Main Methods for Users:**
+ * - {@link initialize} - Initialize the audio context (call first, requires user gesture)
+ * - {@link play} - Start audio playback
+ * - {@link pause} - Pause playback
+ * - {@link resume} - Resume paused playback
+ * - {@link stop} - Stop playback and clear queue
+ * - {@link dispose} - Clean up resources when done
+ *
+ * **Events emitted:**
+ * - `AudioPlayerEvents.Ready` - Audio is ready to play
+ * - `AudioPlayerEvents.Playing` - Playback started
+ * - `AudioPlayerEvents.Paused` - Playback paused
+ * - `AudioPlayerEvents.Stopped` - Playback stopped
+ * - `AudioPlayerEvents.Finished` - All audio finished playing
+ * - `AudioPlayerEvents.AboutToComplete` - Audio is about to finish (for pre-loading)
+ *
+ * @example
+ * ```typescript
+ * const player = new AudioPlayer();
+ *
+ * // Initialize (requires user gesture like button click)
+ * await player.initialize();
+ *
+ * // Listen for events
+ * player.on(AudioPlayerEvents.Ready, () => player.play());
+ * player.on(AudioPlayerEvents.Finished, () => console.log('Done'));
+ *
+ * // Enqueue audio data (base64 MP3 chunks)
+ * player.enqueue(base64AudioChunk);
+ * player.markComplete(); // Signal no more audio coming
+ *
+ * // Control playback
+ * await player.pause();
+ * await player.resume();
+ * await player.stop();
+ *
+ * // Clean up when done
+ * player.dispose();
+ * ```
+ *
+ * @fires AudioPlayerEvents.Ready - When audio is queued and ready to play
+ * @fires AudioPlayerEvents.Playing - When playback starts or resumes
+ * @fires AudioPlayerEvents.Paused - When playback is paused
+ * @fires AudioPlayerEvents.Stopped - When playback is stopped
+ * @fires AudioPlayerEvents.Finished - When all audio has finished playing
+ * @fires AudioPlayerEvents.AboutToComplete - When audio is about to finish
+ */
 export declare class AudioPlayer extends EventEmitter implements IAudioPlayer {
     private readonly MIN_CHUNKS_TO_PROCESS;
     private readonly FLUSH_DELAY_MS;
@@ -27,10 +81,54 @@ export declare class AudioPlayer extends EventEmitter implements IAudioPlayer {
     private allAudioPlayed;
     constructor();
     private setupTimingListeners;
+    /**
+     * Initialize the audio player and prepare for playback.
+     *
+     * **Must be called before any other methods.** Should be called in response
+     * to a user gesture (click, tap) to ensure the AudioContext can start.
+     *
+     * @example
+     * ```typescript
+     * // In a button click handler
+     * button.onclick = async () => {
+     *   await player.initialize();
+     *   // Now ready to receive and play audio
+     * };
+     * ```
+     */
     initialize(): Promise<void>;
     private resetState;
     reset(): void;
+    /**
+     * Enqueue audio data for playback.
+     *
+     * Add base64-encoded MP3 audio chunks to the playback queue.
+     * Call {@link markComplete} when all audio has been enqueued.
+     *
+     * @param audioData - Base64-encoded MP3 audio chunk
+     *
+     * @example
+     * ```typescript
+     * // Enqueue streaming audio chunks
+     * player.enqueue(chunk1);
+     * player.enqueue(chunk2);
+     * player.markComplete(); // Signal end of audio
+     * ```
+     */
     enqueue(audioData: string): void;
+    /**
+     * Signal that all audio has been enqueued.
+     *
+     * Call this after enqueuing all audio chunks to indicate that no more
+     * audio will be added. This triggers the `Finished` event when playback completes.
+     *
+     * @example
+     * ```typescript
+     * player.enqueue(chunk1);
+     * player.enqueue(chunk2);
+     * player.markComplete(); // No more audio coming
+     * ```
+     */
     markComplete(): void;
     private processChunkQueue;
     private decodeBase64ToUint8Array;
@@ -40,10 +138,68 @@ export declare class AudioPlayer extends EventEmitter implements IAudioPlayer {
      * Decodes frames individually to catch failures
      */
     private decodeAudioFrames;
+    /**
+     * Start audio playback.
+     *
+     * Begins playing audio from the queue. Emits `Playing` event on success.
+     * Does nothing if already playing or queue is empty.
+     *
+     * @fires AudioPlayerEvents.Playing - When playback starts
+     *
+     * @example
+     * ```typescript
+     * player.on(AudioPlayerEvents.Ready, async () => {
+     *   await player.play();
+     * });
+     * ```
+     */
     play(): Promise<void>;
     private schedulePlayback;
+    /**
+     * Pause audio playback.
+     *
+     * Suspends the audio context, pausing playback at the current position.
+     * Use {@link resume} to continue playback.
+     *
+     * @fires AudioPlayerEvents.Paused - When playback is paused
+     *
+     * @example
+     * ```typescript
+     * await player.pause();
+     * // Later...
+     * await player.resume();
+     * ```
+     */
     pause(): Promise<void>;
+    /**
+     * Resume paused audio playback.
+     *
+     * Continues playback from where it was paused.
+     *
+     * @fires AudioPlayerEvents.Playing - When playback resumes
+     *
+     * @example
+     * ```typescript
+     * await player.pause();
+     * // Later...
+     * await player.resume();
+     * ```
+     */
     resume(): Promise<void>;
+    /**
+     * Stop audio playback and clear the queue.
+     *
+     * Immediately stops all playback and clears any queued audio.
+     * To play again, you'll need to enqueue new audio.
+     *
+     * @fires AudioPlayerEvents.Stopped - When playback is stopped
+     *
+     * @example
+     * ```typescript
+     * // Stop playback immediately
+     * await player.stop();
+     * ```
+     */
     stop(): Promise<void>;
     getCurrentTime(): number;
     getQueueLength(): number;