synxed-sdk 0.2.3 → 0.2.5

package/dist/index.d.mts

@@ -12,7 +12,14 @@ declare enum ContentKind {
     SONG = 1,
     PLAYLIST = 2,
     CATEGORY = 3,
-    RADIO = 4
+    RADIO = 4,
+    VOICE = 5
+}
+declare enum SdkVoiceAction {
+    VOICE_UNSPECIFIED = 0,
+    VOICE_START = 1,
+    VOICE_CHUNK = 2,
+    VOICE_END = 3
 }
 declare enum ErrorCode {
     UNSPECIFIED = 0,
@@ -32,6 +39,8 @@ interface SynxedConfig {
     /** Listening context sent on init for ad targeting (e.g. "menu", "gameplay"). */
     gameContext?: string;
     deviceType?: string;
+    /** Default voice silence detection settings (used by `beginVoiceHold`). */
+    voice?: Omit<VoiceHoldOptions, 'listenerId'>;
 }
 interface PlaySongOptions {
     catalogTrackId?: string;
@@ -66,6 +75,26 @@ interface PlayerState {
     duration: number;
     volume: number;
 }
+type VoiceState = 'idle' | 'listening' | 'processing' | 'ready' | 'error';
+interface VoiceResult {
+    status: string;
+    transcript?: string;
+    playlistCode?: string;
+    playlistName?: string;
+}
+interface VoiceHoldOptions {
+    listenerId?: string;
+    /** Auto-end capture when the user stops talking. Default `true`. */
+    autoEndOnSilence?: boolean;
+    /** RMS level below which audio counts as silence (0–1). Default `0.018`. */
+    silenceThreshold?: number;
+    /** Ms of silence after speech before auto-end. Default `1500`. */
+    silenceDurationMs?: number;
+    /** Minimum speech ms before silence can trigger end. Default `400`. */
+    minSpeechMs?: number;
+    /** Max capture length in ms. Default `30000`. */
+    maxDurationMs?: number;
+}
 interface SynxedEvents {
     stateChange: (state: PlayerState) => void;
     timeUpdate: (time: {
@@ -76,6 +105,13 @@ interface SynxedEvents {
     queueUpdated: (tracks: TrackInfo[]) => void;
     adStart: (ad: AdInfo) => void;
     adEnd: (ad: AdInfo) => void;
+    adSkipUpdate: (state: AdSkipState) => void;
+    voiceStateChange: (state: VoiceState) => void;
+    voiceResult: (result: VoiceResult) => void;
+    /** Mic level crossed above silence threshold — user started speaking. */
+    voiceSpeechStart: () => void;
+    /** Silence detected after speech — user stopped talking. */
+    voiceSpeechEnd: () => void;
     error: (error: Error) => void;
     connected: () => void;
     disconnected: (reason: string) => void;
@@ -93,29 +129,69 @@ interface AdInfo {
     companionBannerUrl: string;
     campaignName: string;
 }
+/** Emitted while a skippable ad plays — use for custom skip UI (YouTube-style countdown). */
+interface AdSkipState {
+    ad: AdInfo;
+    /** Seconds remaining before skip is allowed (0 when `canSkip` is true). */
+    countdownSeconds: number;
+    /** True once the ad has played for `skipAfterSeconds` (e.g. 5s). */
+    canSkip: boolean;
+}
 
 declare class SynxedPlayer extends EventEmitter<SynxedEvents> {
     private transport;
     private audio;
     private playlist;
+    private voiceCapture;
     private config;
     private status;
     private volume;
     private activeContentKind;
     private heartbeatTimer;
     private adPlaying;
-    private currentAd;
+    private _currentAd;
+    private _voiceState;
+    private voiceMimeType;
+    private voiceListenerId;
+    private pendingPlaybackLoad;
+    private voiceAutoEndOnSilence;
+    private pausedForVoice;
     constructor(config: SynxedConfig);
     get currentTrack(): TrackInfo | null;
     /** Active playback init kind from the last `play*` call (RADIO, PLAYLIST, SONG, …). */
     get contentKind(): ContentKind;
+    get currentAd(): AdInfo | null;
+    get isAdPlaying(): boolean;
+    /** True when a skippable ad has played for at least `skipAfterSeconds` (default 5s). */
+    canSkipAd(): boolean;
+    /** Seconds until skip unlocks; `0` when skip is available; `null` when not in a skippable ad. */
+    getAdSkipCountdownSeconds(): number | null;
+    get voiceState(): VoiceState;
     private controlPositionMs;
     private setupListeners;
+    private resolveVoiceOptions;
     private connect;
     private buildInitExtras;
     playSong(options: PlaySongOptions): Promise<void>;
     playPlaylist(options: PlayPlaylistOptions): Promise<void>;
     playRadio(options?: PlayRadioOptions): Promise<void>;
+    /**
+     * Press-and-hold the DJ avatar (or call manually): start mic capture and stream chunks.
+     * Ends automatically when the user stops talking (`voiceSpeechEnd`) or call `endVoiceHold()`.
+     */
+    beginVoiceHold(options?: VoiceHoldOptions): Promise<void>;
+    /**
+     * Release press-and-hold: flush final audio chunk and request playlist generation.
+     */
+    endVoiceHold(): Promise<void>;
+    /** Cancel an in-progress voice hold without sending audio to the server. */
+    cancelVoiceHold(): void;
+    /**
+     * Close the voice UI: cancel recording if active and resume playback if it was
+     * paused for voice.
+     */
+    dismissVoiceAndResume(): void;
+    get isVoiceUiActive(): boolean;
     pause(): void;
     resume(): void;
     stop(): void;
@@ -129,7 +205,11 @@ declare class SynxedPlayer extends EventEmitter<SynxedEvents> {
     private clearHeartbeat;
     private startHeartbeat;
     private applyContentSummary;
+    private emitAdSkipUpdate;
+    private setVoiceState;
+    private handleVoiceAck;
     private handleServerMessage;
+    private startContentPlayback;
     private handleAdPlayback;
     skipAd(): void;
     clickAd(): void;
@@ -168,6 +248,15 @@ declare class TransportManager extends EventEmitter<TransportEvents> {
     sendInit(params: any): void;
     sendControl(params: any): void;
     sendAnalytics(params: any): void;
+    sendVoice(params: {
+        action: number;
+        audioData?: Uint8Array;
+        mimeType?: string;
+        sequence?: number;
+        listenerId?: string;
+        deviceType?: string;
+        gameContext?: string;
+    }): void;
     get isConnected(): boolean;
     private sendBytes;
 }
@@ -178,8 +267,51 @@ declare class TransportManager extends EventEmitter<TransportEvents> {
  */
 declare function fetchRadioNowPlaying(serverUrl: string, init?: RequestInit): Promise<RadioNowPlaying | null>;
 
-type SynxedWebPlayerMode = 'mini' | 'wide' | 'large';
-type SynxedWebPlayerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'bottom-center';
+interface VoiceCaptureEvents {
+    chunk: (data: Uint8Array, sequence: number) => void;
+    error: (error: Error) => void;
+    /** User started speaking (level crossed above silence threshold). */
+    speechStart: () => void;
+    /** User stopped speaking (silence after speech, or max duration reached). */
+    speechEnd: () => void;
+}
+interface VoiceCaptureOptions {
+    /** RMS level below which audio counts as silence (0–1). Default `0.018`. */
+    silenceThreshold?: number;
+    /** Ms of silence after speech before `speechEnd`. Default `1500`. */
+    silenceDurationMs?: number;
+    /** Minimum speech ms before silence can end capture. Default `400`. */
+    minSpeechMs?: number;
+    /** Safety cap — auto `speechEnd` after this many ms. Default `30000`. */
+    maxDurationMs?: number;
+    /** Monitor mic levels for end-of-speech. Default `true`. */
+    detectSilence?: boolean;
+}
+/**
+ * Native MediaRecorder capture with optional Web Audio silence detection.
+ */
+declare class VoiceCaptureManager extends EventEmitter<VoiceCaptureEvents> {
+    private stream;
+    private recorder;
+    private sequence;
+    private capturing;
+    private mimeType;
+    private audioContext;
+    private silenceRaf;
+    private speechEndEmitted;
+    private captureOptions;
+    get isCapturing(): boolean;
+    get activeMimeType(): string;
+    start(options?: VoiceCaptureOptions): Promise<string>;
+    stop(): Promise<void>;
+    cancel(): void;
+    private startSilenceMonitor;
+    private stopSilenceMonitor;
+    private releaseStream;
+}
+
+type SynxedWebPlayerMode = "mini" | "wide" | "large";
+type SynxedWebPlayerPlacement = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "bottom-center";
 interface SynxedWebPlayerTheme {
     accent?: string;
     accentMuted?: string;
@@ -198,10 +330,10 @@ interface SynxedWebPlayerPosition {
     offsetY?: number;
 }
 type SynxedWebPlayerSource = {
-    type: 'playlist';
+    type: "playlist";
     playlistCode: string;
 } | {
-    type: 'radio';
+    type: "radio";
 };
 interface SynxedWebPlayerOptions {
     /** Mount target. If omitted, a fixed overlay root is appended to `document.body`. */
@@ -213,6 +345,7 @@ interface SynxedWebPlayerOptions {
     theme?: SynxedWebPlayerTheme;
     position?: SynxedWebPlayerPosition;
     avatarUrl?: string;
+    voiceAvatarUrl?: string;
     attribution?: string;
     nowPlayingPollMs?: number;
     powerByLabel?: string;
@@ -221,6 +354,11 @@ interface SynxedWebPlayerOptions {
     style?: Partial<CSSStyleDeclaration>;
     onMiniClick?: () => void;
     draggable?: boolean;
+    /** Press-and-hold DJ avatar for voice. Set `false` to disable. Default `true`. */
+    enableVoice?: boolean;
+    /** Ms to hold before voice starts (prevents opening AI on quick tap). Default `450`. */
+    voiceHoldMs?: number;
+    listenerId?: string;
 }
 
 /**
@@ -248,6 +386,13 @@ declare class SynxedWebPlayer {
     private artistBlockEl;
     private footerEl;
     private playBtn;
+    private avatarVoiceHolding;
+    private suppressMiniClick;
+    private voiceAvatarPreview;
+    private voiceHoldActivated;
+    private voiceUiDismissed;
+    private voiceHoldTimer;
+    private readonly defaultVoiceHoldMs;
     constructor(options: SynxedWebPlayerOptions);
     /** Convenience factory — same as `new SynxedWebPlayer(options)`. */
     static mount(options: SynxedWebPlayerOptions): SynxedWebPlayer;
@@ -255,12 +400,14 @@ declare class SynxedWebPlayer {
     get player(): SynxedPlayer | null;
     get element(): HTMLElement;
     destroy(): void;
+    private get voiceEnabled();
     private get isRadio();
     private get mode();
     private mountShell;
     private makeDraggable;
     private buildAvatar;
     private buildMini;
+    private handleMiniActivate;
     private buildWide;
     private buildLarge;
     private roundControlStyle;
@@ -268,8 +415,22 @@ declare class SynxedWebPlayer {
     private buildVisualizer;
     private decoLines;
     private initEngine;
+    /** Press-and-hold DJ avatar to stream voice; release or silence auto-ends capture. */
+    private wireAvatarVoiceHold;
+    private isVoiceUiOpen;
+    private dismissVoiceUi;
+    private resetVoiceHoldState;
+    private applyVoiceVisual;
+    private isVoiceAvatarActive;
+    private getAvatarImageUrl;
+    private refreshAvatarImage;
     private startNowPlayingPoll;
     private stopNowPlayingPoll;
+    private handleSkipClick;
+    /** Countdown in the skip control during ads — no extra chrome. */
+    private applyAdSkipUi;
+    private clearAdSkipStyleOverrides;
+    private restoreTrackSkipButton;
     private displayLine;
     private refreshLabels;
     private updateAvatar;
@@ -277,4 +438,4 @@ declare class SynxedWebPlayer {
     private togglePlay;
 }
 
-export { type AdInfo, ContentKind, ErrorCode, type PlayPlaylistOptions, type PlayRadioOptions, type PlaySongOptions, type PlayerState, type RadioNowPlaying, type SynxedConfig, SynxedConnectionError, SynxedError, type SynxedEvents, SynxedPlaybackError, SynxedPlayer, SynxedProtocolError, SynxedWebPlayer, type SynxedWebPlayerMode, type SynxedWebPlayerOptions, type SynxedWebPlayerPlacement, type SynxedWebPlayerPosition, type SynxedWebPlayerSource, type SynxedWebPlayerTheme, type TrackInfo, type TransportEvents, TransportManager, buildSdkWebSocketUrl, fetchRadioNowPlaying };
+export { type AdInfo, type AdSkipState, ContentKind, ErrorCode, type PlayPlaylistOptions, type PlayRadioOptions, type PlaySongOptions, type PlayerState, type RadioNowPlaying, SdkVoiceAction, type SynxedConfig, SynxedConnectionError, SynxedError, type SynxedEvents, SynxedPlaybackError, SynxedPlayer, SynxedProtocolError, SynxedWebPlayer, type SynxedWebPlayerMode, type SynxedWebPlayerOptions, type SynxedWebPlayerPlacement, type SynxedWebPlayerPosition, type SynxedWebPlayerSource, type SynxedWebPlayerTheme, type TrackInfo, type TransportEvents, TransportManager, VoiceCaptureManager, type VoiceCaptureOptions, type VoiceHoldOptions, type VoiceResult, type VoiceState, buildSdkWebSocketUrl, fetchRadioNowPlaying };

package/dist/index.d.ts

@@ -12,7 +12,14 @@ declare enum ContentKind {
     SONG = 1,
     PLAYLIST = 2,
     CATEGORY = 3,
-    RADIO = 4
+    RADIO = 4,
+    VOICE = 5
+}
+declare enum SdkVoiceAction {
+    VOICE_UNSPECIFIED = 0,
+    VOICE_START = 1,
+    VOICE_CHUNK = 2,
+    VOICE_END = 3
 }
 declare enum ErrorCode {
     UNSPECIFIED = 0,
@@ -32,6 +39,8 @@ interface SynxedConfig {
     /** Listening context sent on init for ad targeting (e.g. "menu", "gameplay"). */
     gameContext?: string;
     deviceType?: string;
+    /** Default voice silence detection settings (used by `beginVoiceHold`). */
+    voice?: Omit<VoiceHoldOptions, 'listenerId'>;
 }
 interface PlaySongOptions {
     catalogTrackId?: string;
@@ -66,6 +75,26 @@ interface PlayerState {
     duration: number;
     volume: number;
 }
+type VoiceState = 'idle' | 'listening' | 'processing' | 'ready' | 'error';
+interface VoiceResult {
+    status: string;
+    transcript?: string;
+    playlistCode?: string;
+    playlistName?: string;
+}
+interface VoiceHoldOptions {
+    listenerId?: string;
+    /** Auto-end capture when the user stops talking. Default `true`. */
+    autoEndOnSilence?: boolean;
+    /** RMS level below which audio counts as silence (0–1). Default `0.018`. */
+    silenceThreshold?: number;
+    /** Ms of silence after speech before auto-end. Default `1500`. */
+    silenceDurationMs?: number;
+    /** Minimum speech ms before silence can trigger end. Default `400`. */
+    minSpeechMs?: number;
+    /** Max capture length in ms. Default `30000`. */
+    maxDurationMs?: number;
+}
 interface SynxedEvents {
     stateChange: (state: PlayerState) => void;
     timeUpdate: (time: {
@@ -76,6 +105,13 @@ interface SynxedEvents {
     queueUpdated: (tracks: TrackInfo[]) => void;
     adStart: (ad: AdInfo) => void;
     adEnd: (ad: AdInfo) => void;
+    adSkipUpdate: (state: AdSkipState) => void;
+    voiceStateChange: (state: VoiceState) => void;
+    voiceResult: (result: VoiceResult) => void;
+    /** Mic level crossed above silence threshold — user started speaking. */
+    voiceSpeechStart: () => void;
+    /** Silence detected after speech — user stopped talking. */
+    voiceSpeechEnd: () => void;
     error: (error: Error) => void;
     connected: () => void;
     disconnected: (reason: string) => void;
@@ -93,29 +129,69 @@ interface AdInfo {
     companionBannerUrl: string;
     campaignName: string;
 }
+/** Emitted while a skippable ad plays — use for custom skip UI (YouTube-style countdown). */
+interface AdSkipState {
+    ad: AdInfo;
+    /** Seconds remaining before skip is allowed (0 when `canSkip` is true). */
+    countdownSeconds: number;
+    /** True once the ad has played for `skipAfterSeconds` (e.g. 5s). */
+    canSkip: boolean;
+}
 
 declare class SynxedPlayer extends EventEmitter<SynxedEvents> {
     private transport;
     private audio;
     private playlist;
+    private voiceCapture;
     private config;
     private status;
     private volume;
     private activeContentKind;
     private heartbeatTimer;
     private adPlaying;
-    private currentAd;
+    private _currentAd;
+    private _voiceState;
+    private voiceMimeType;
+    private voiceListenerId;
+    private pendingPlaybackLoad;
+    private voiceAutoEndOnSilence;
+    private pausedForVoice;
     constructor(config: SynxedConfig);
     get currentTrack(): TrackInfo | null;
     /** Active playback init kind from the last `play*` call (RADIO, PLAYLIST, SONG, …). */
     get contentKind(): ContentKind;
+    get currentAd(): AdInfo | null;
+    get isAdPlaying(): boolean;
+    /** True when a skippable ad has played for at least `skipAfterSeconds` (default 5s). */
+    canSkipAd(): boolean;
+    /** Seconds until skip unlocks; `0` when skip is available; `null` when not in a skippable ad. */
+    getAdSkipCountdownSeconds(): number | null;
+    get voiceState(): VoiceState;
     private controlPositionMs;
     private setupListeners;
+    private resolveVoiceOptions;
     private connect;
     private buildInitExtras;
     playSong(options: PlaySongOptions): Promise<void>;
     playPlaylist(options: PlayPlaylistOptions): Promise<void>;
     playRadio(options?: PlayRadioOptions): Promise<void>;
+    /**
+     * Press-and-hold the DJ avatar (or call manually): start mic capture and stream chunks.
+     * Ends automatically when the user stops talking (`voiceSpeechEnd`) or call `endVoiceHold()`.
+     */
+    beginVoiceHold(options?: VoiceHoldOptions): Promise<void>;
+    /**
+     * Release press-and-hold: flush final audio chunk and request playlist generation.
+     */
+    endVoiceHold(): Promise<void>;
+    /** Cancel an in-progress voice hold without sending audio to the server. */
+    cancelVoiceHold(): void;
+    /**
+     * Close the voice UI: cancel recording if active and resume playback if it was
+     * paused for voice.
+     */
+    dismissVoiceAndResume(): void;
+    get isVoiceUiActive(): boolean;
     pause(): void;
     resume(): void;
     stop(): void;
@@ -129,7 +205,11 @@ declare class SynxedPlayer extends EventEmitter<SynxedEvents> {
     private clearHeartbeat;
     private startHeartbeat;
     private applyContentSummary;
+    private emitAdSkipUpdate;
+    private setVoiceState;
+    private handleVoiceAck;
     private handleServerMessage;
+    private startContentPlayback;
     private handleAdPlayback;
     skipAd(): void;
     clickAd(): void;
@@ -168,6 +248,15 @@ declare class TransportManager extends EventEmitter<TransportEvents> {
     sendInit(params: any): void;
     sendControl(params: any): void;
     sendAnalytics(params: any): void;
+    sendVoice(params: {
+        action: number;
+        audioData?: Uint8Array;
+        mimeType?: string;
+        sequence?: number;
+        listenerId?: string;
+        deviceType?: string;
+        gameContext?: string;
+    }): void;
     get isConnected(): boolean;
     private sendBytes;
 }
@@ -178,8 +267,51 @@ declare class TransportManager extends EventEmitter<TransportEvents> {
  */
 declare function fetchRadioNowPlaying(serverUrl: string, init?: RequestInit): Promise<RadioNowPlaying | null>;
 
-type SynxedWebPlayerMode = 'mini' | 'wide' | 'large';
-type SynxedWebPlayerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'bottom-center';
+interface VoiceCaptureEvents {
+    chunk: (data: Uint8Array, sequence: number) => void;
+    error: (error: Error) => void;
+    /** User started speaking (level crossed above silence threshold). */
+    speechStart: () => void;
+    /** User stopped speaking (silence after speech, or max duration reached). */
+    speechEnd: () => void;
+}
+interface VoiceCaptureOptions {
+    /** RMS level below which audio counts as silence (0–1). Default `0.018`. */
+    silenceThreshold?: number;
+    /** Ms of silence after speech before `speechEnd`. Default `1500`. */
+    silenceDurationMs?: number;
+    /** Minimum speech ms before silence can end capture. Default `400`. */
+    minSpeechMs?: number;
+    /** Safety cap — auto `speechEnd` after this many ms. Default `30000`. */
+    maxDurationMs?: number;
+    /** Monitor mic levels for end-of-speech. Default `true`. */
+    detectSilence?: boolean;
+}
+/**
+ * Native MediaRecorder capture with optional Web Audio silence detection.
+ */
+declare class VoiceCaptureManager extends EventEmitter<VoiceCaptureEvents> {
+    private stream;
+    private recorder;
+    private sequence;
+    private capturing;
+    private mimeType;
+    private audioContext;
+    private silenceRaf;
+    private speechEndEmitted;
+    private captureOptions;
+    get isCapturing(): boolean;
+    get activeMimeType(): string;
+    start(options?: VoiceCaptureOptions): Promise<string>;
+    stop(): Promise<void>;
+    cancel(): void;
+    private startSilenceMonitor;
+    private stopSilenceMonitor;
+    private releaseStream;
+}
+
+type SynxedWebPlayerMode = "mini" | "wide" | "large";
+type SynxedWebPlayerPlacement = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "bottom-center";
 interface SynxedWebPlayerTheme {
     accent?: string;
     accentMuted?: string;
@@ -198,10 +330,10 @@ interface SynxedWebPlayerPosition {
     offsetY?: number;
 }
 type SynxedWebPlayerSource = {
-    type: 'playlist';
+    type: "playlist";
     playlistCode: string;
 } | {
-    type: 'radio';
+    type: "radio";
 };
 interface SynxedWebPlayerOptions {
     /** Mount target. If omitted, a fixed overlay root is appended to `document.body`. */
@@ -213,6 +345,7 @@ interface SynxedWebPlayerOptions {
     theme?: SynxedWebPlayerTheme;
     position?: SynxedWebPlayerPosition;
     avatarUrl?: string;
+    voiceAvatarUrl?: string;
     attribution?: string;
     nowPlayingPollMs?: number;
     powerByLabel?: string;
@@ -221,6 +354,11 @@ interface SynxedWebPlayerOptions {
     style?: Partial<CSSStyleDeclaration>;
     onMiniClick?: () => void;
     draggable?: boolean;
+    /** Press-and-hold DJ avatar for voice. Set `false` to disable. Default `true`. */
+    enableVoice?: boolean;
+    /** Ms to hold before voice starts (prevents opening AI on quick tap). Default `450`. */
+    voiceHoldMs?: number;
+    listenerId?: string;
 }
 
 /**
@@ -248,6 +386,13 @@ declare class SynxedWebPlayer {
     private artistBlockEl;
     private footerEl;
     private playBtn;
+    private avatarVoiceHolding;
+    private suppressMiniClick;
+    private voiceAvatarPreview;
+    private voiceHoldActivated;
+    private voiceUiDismissed;
+    private voiceHoldTimer;
+    private readonly defaultVoiceHoldMs;
     constructor(options: SynxedWebPlayerOptions);
     /** Convenience factory — same as `new SynxedWebPlayer(options)`. */
     static mount(options: SynxedWebPlayerOptions): SynxedWebPlayer;
@@ -255,12 +400,14 @@ declare class SynxedWebPlayer {
     get player(): SynxedPlayer | null;
     get element(): HTMLElement;
     destroy(): void;
+    private get voiceEnabled();
     private get isRadio();
     private get mode();
     private mountShell;
     private makeDraggable;
     private buildAvatar;
     private buildMini;
+    private handleMiniActivate;
     private buildWide;
     private buildLarge;
     private roundControlStyle;
@@ -268,8 +415,22 @@ declare class SynxedWebPlayer {
     private buildVisualizer;
     private decoLines;
     private initEngine;
+    /** Press-and-hold DJ avatar to stream voice; release or silence auto-ends capture. */
+    private wireAvatarVoiceHold;
+    private isVoiceUiOpen;
+    private dismissVoiceUi;
+    private resetVoiceHoldState;
+    private applyVoiceVisual;
+    private isVoiceAvatarActive;
+    private getAvatarImageUrl;
+    private refreshAvatarImage;
     private startNowPlayingPoll;
     private stopNowPlayingPoll;
+    private handleSkipClick;
+    /** Countdown in the skip control during ads — no extra chrome. */
+    private applyAdSkipUi;
+    private clearAdSkipStyleOverrides;
+    private restoreTrackSkipButton;
     private displayLine;
     private refreshLabels;
     private updateAvatar;
@@ -277,4 +438,4 @@ declare class SynxedWebPlayer {
     private togglePlay;
 }
 
-export { type AdInfo, ContentKind, ErrorCode, type PlayPlaylistOptions, type PlayRadioOptions, type PlaySongOptions, type PlayerState, type RadioNowPlaying, type SynxedConfig, SynxedConnectionError, SynxedError, type SynxedEvents, SynxedPlaybackError, SynxedPlayer, SynxedProtocolError, SynxedWebPlayer, type SynxedWebPlayerMode, type SynxedWebPlayerOptions, type SynxedWebPlayerPlacement, type SynxedWebPlayerPosition, type SynxedWebPlayerSource, type SynxedWebPlayerTheme, type TrackInfo, type TransportEvents, TransportManager, buildSdkWebSocketUrl, fetchRadioNowPlaying };
+export { type AdInfo, type AdSkipState, ContentKind, ErrorCode, type PlayPlaylistOptions, type PlayRadioOptions, type PlaySongOptions, type PlayerState, type RadioNowPlaying, SdkVoiceAction, type SynxedConfig, SynxedConnectionError, SynxedError, type SynxedEvents, SynxedPlaybackError, SynxedPlayer, SynxedProtocolError, SynxedWebPlayer, type SynxedWebPlayerMode, type SynxedWebPlayerOptions, type SynxedWebPlayerPlacement, type SynxedWebPlayerPosition, type SynxedWebPlayerSource, type SynxedWebPlayerTheme, type TrackInfo, type TransportEvents, TransportManager, VoiceCaptureManager, type VoiceCaptureOptions, type VoiceHoldOptions, type VoiceResult, type VoiceState, buildSdkWebSocketUrl, fetchRadioNowPlaying };