@nice2dev/ui-audio 0.1.0 → 1.0.2

package/dist/radio/NiceRadioPlayer.d.ts

@@ -0,0 +1,141 @@
+import { default as React } from 'react';
+/** ICY metadata from a radio stream. */
+export interface RadioStreamMetadata {
+    title?: string;
+    artist?: string;
+    album?: string;
+    genre?: string;
+    bitrate?: number;
+    sampleRate?: number;
+}
+/** A radio station definition. */
+export interface RadioStation {
+    id: string;
+    name: string;
+    streamUrl: string;
+    logoUrl?: string;
+    genre?: string;
+    country?: string;
+    language?: string;
+    bitrate?: number;
+    codec?: string;
+    description?: string;
+    isFavorite?: boolean;
+}
+/** EQ preset definition. */
+export interface EQPreset {
+    name: string;
+    /** Frequency → gain(dB) pairs for parametric EQ bands. */
+    bands: {
+        frequency: number;
+        gain: number;
+        Q?: number;
+    }[];
+}
+/** State returned by {@link useRadioStream}. */
+export interface RadioStreamState {
+    /** Whether the stream is currently playing. */
+    isPlaying: boolean;
+    /** Current volume (0–1). */
+    volume: number;
+    /** Whether the stream is buffering/connecting. */
+    isBuffering: boolean;
+    /** ICY metadata from the current stream. */
+    metadata: RadioStreamMetadata | null;
+    /** Error message, if any. */
+    error: string | null;
+    /** Active EQ preset name. */
+    activePreset: string | null;
+}
+/** Controls returned by {@link useRadioStream}. */
+export interface RadioStreamControls {
+    play: () => void;
+    pause: () => void;
+    toggle: () => void;
+    setVolume: (v: number) => void;
+    setStation: (station: RadioStation) => void;
+    applyEQPreset: (preset: EQPreset) => void;
+    clearEQ: () => void;
+}
+/** Props for {@link NiceRadioPlayer}. */
+export interface NiceRadioPlayerProps {
+    /** List of available radio stations. */
+    stations: RadioStation[];
+    /** Initially selected station ID. */
+    initialStationId?: string;
+    /** Auto-play when a station is selected. */
+    autoPlay?: boolean;
+    /** Built-in EQ presets. */
+    eqPresets?: EQPreset[];
+    /** Called when the active station changes. */
+    onStationChange?: (station: RadioStation) => void;
+    /** Called when play/pause state changes. */
+    onPlayingChange?: (playing: boolean) => void;
+    /** Called when ICY metadata is received. */
+    onMetadata?: (meta: RadioStreamMetadata) => void;
+    /** Show station browser panel. */
+    showBrowser?: boolean;
+    /** Show equalizer panel. */
+    showEqualizer?: boolean;
+    /** Show simple spectrum visualizer. */
+    showVisualizer?: boolean;
+    /** Show metadata history panel */
+    showMetadataHistory?: boolean;
+    /** Show recording controls */
+    showRecording?: boolean;
+    /** Show sleep timer */
+    showSleepTimer?: boolean;
+    /** Called when a station is favorited/unfavorited */
+    onToggleFavorite?: (stationId: string) => void;
+    /** Called when recording starts */
+    onRecordingStart?: () => void;
+    /** Called when recording stops with the recorded blob */
+    onRecordingStop?: (blob: Blob) => void;
+    /** Additional CSS class. */
+    className?: string;
+    /** Inline styles. */
+    style?: React.CSSProperties;
+}
+/** Props for {@link NiceStationBrowser}. */
+export interface NiceStationBrowserProps {
+    /** Available stations. */
+    stations: RadioStation[];
+    /** Currently active station ID. */
+    activeStationId?: string;
+    /** Called when a station is selected. */
+    onSelect: (station: RadioStation) => void;
+    /** Called when toggling favorite status. */
+    onToggleFavorite?: (stationId: string) => void;
+    /** Additional CSS class. */
+    className?: string;
+}
+/**
+ * Hook for managing an internet radio stream with Web Audio API.
+ *
+ * @example
+ * ```tsx
+ * const [state, controls] = useRadioStream();
+ * controls.setStation({ id: '1', name: 'Jazz FM', streamUrl: 'https://...' });
+ * controls.play();
+ * ```
+ */
+export declare function useRadioStream(): [RadioStreamState, RadioStreamControls];
+/** Browsable, filterable list of radio stations. */
+export declare function NiceStationBrowser({ stations, activeStationId, onSelect, onToggleFavorite, className, }: NiceStationBrowserProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Full-featured internet radio player with station browser, equalizer, and visualizer.
+ *
+ * @example
+ * ```tsx
+ * <NiceRadioPlayer
+ *   stations={[
+ *     { id: '1', name: 'Jazz FM', streamUrl: 'https://stream.jazzfm.com/aac', genre: 'Jazz' },
+ *     { id: '2', name: 'Rock Radio', streamUrl: 'https://stream.rock.com/mp3', genre: 'Rock' },
+ *   ]}
+ *   showBrowser
+ *   showEqualizer
+ * />
+ * ```
+ */
+export declare function NiceRadioPlayer({ stations, initialStationId, autoPlay, eqPresets, onStationChange, onPlayingChange, onMetadata, onToggleFavorite, onRecordingStart, onRecordingStop, showBrowser, showEqualizer, showVisualizer, showMetadataHistory, showRecording, showSleepTimer, className, style, }: NiceRadioPlayerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NiceRadioPlayer.d.ts.map

package/dist/radio/NiceRadioPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceRadioPlayer.d.ts","sourceRoot":"","sources":["../../src/radio/NiceRadioPlayer.tsx"],"names":[],"mappings":"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"}

package/dist/streaming/NiceStreamingVisualizer.d.ts

@@ -0,0 +1,86 @@
+import { default as React } from 'react';
+export type VisualizerMode = 'bars' | 'waveform' | 'circle' | 'mirror-bars';
+export interface NiceStreamingVisualizerProps {
+    /** Visualizer style: bars, waveform, circle, or mirror-bars (default: 'bars') */
+    mode?: VisualizerMode;
+    /** Canvas width (default: 300) */
+    width?: number;
+    /** Canvas height (default: 100) */
+    height?: number;
+    /** Number of frequency bars (default: 32, only for 'bars' and 'mirror-bars') */
+    barCount?: number;
+    /** Bar color or gradient colors (default: '#3b82f6') */
+    barColor?: string | string[];
+    /** Background color (default: 'transparent') */
+    backgroundColor?: string;
+    /** FFT size for frequency analysis (default: 256) */
+    fftSize?: 64 | 128 | 256 | 512 | 1024 | 2048;
+    /** Smoothing time constant 0-1 (default: 0.8) */
+    smoothing?: number;
+    /** Minimum decibel value (default: -90) */
+    minDecibels?: number;
+    /** Maximum decibel value (default: -10) */
+    maxDecibels?: number;
+    /** Device ID for specific microphone (default: system default) */
+    deviceId?: string;
+    /** Whether to start capturing immediately (default: false) */
+    autoStart?: boolean;
+    /** Callback when capture starts */
+    onStart?: () => void;
+    /** Callback when capture stops */
+    onStop?: () => void;
+    /** Callback with current audio level (0-1) */
+    onAudioLevel?: (level: number) => void;
+    /** Callback on error (e.g., permission denied) */
+    onError?: (error: Error) => void;
+    /** Additional CSS class */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Border radius for bars (default: 2) */
+    barBorderRadius?: number;
+    /** Gap between bars in pixels (default: 2) */
+    barGap?: number;
+    /** Line width for waveform mode (default: 2) */
+    lineWidth?: number;
+}
+export interface StreamingVisualizerRef {
+    /** Start capturing audio */
+    start: () => Promise<void>;
+    /** Stop capturing audio */
+    stop: () => void;
+    /** Check if currently capturing */
+    isCapturing: () => boolean;
+    /** Get current audio level (0-1) */
+    getAudioLevel: () => number;
+}
+/**
+ * Real-time microphone audio visualizer component.
+ *
+ * @example
+ * ```tsx
+ * import { NiceStreamingVisualizer, StreamingVisualizerRef } from '@nice2dev/ui-audio';
+ *
+ * function VoiceIndicator() {
+ *   const visualizerRef = useRef<StreamingVisualizerRef>(null);
+ *
+ *   return (
+ *     <div>
+ *       <NiceStreamingVisualizer
+ *         ref={visualizerRef}
+ *         mode="bars"
+ *         width={200}
+ *         height={60}
+ *         barColor={['#3b82f6', '#8b5cf6']}
+ *         autoStart
+ *         onAudioLevel={(level) => console.log('Level:', level)}
+ *       />
+ *       <button onClick={() => visualizerRef.current?.stop()}>Stop</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const NiceStreamingVisualizer: React.ForwardRefExoticComponent<NiceStreamingVisualizerProps & React.RefAttributes<StreamingVisualizerRef>>;
+export default NiceStreamingVisualizer;
+//# sourceMappingURL=NiceStreamingVisualizer.d.ts.map

package/dist/streaming/NiceStreamingVisualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceStreamingVisualizer.d.ts","sourceRoot":"","sources":["../../src/streaming/NiceStreamingVisualizer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAMxE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE5E,MAAM,WAAW,4BAA4B;IAC3C,iFAAiF;IACjF,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,OAAO,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7C,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mCAAmC;IACnC,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,oCAAoC;IACpC,aAAa,EAAE,MAAM,MAAM,CAAC;CAC7B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,uBAAuB,6GA6VlC,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

package/dist/streaming/NiceVoiceChatOverlay.d.ts

@@ -0,0 +1,97 @@
+import { default as React } from 'react';
+import { WebRTCAudioManager, WebRTCAudioConfig, SignalingMessage } from './webrtcAudio';
+export interface VoiceChatParticipant {
+    /** Unique participant ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Avatar URL (optional) */
+    avatarUrl?: string;
+    /** Whether currently speaking (based on audio level) */
+    isSpeaking?: boolean;
+    /** Whether muted */
+    isMuted?: boolean;
+}
+export interface NiceVoiceChatOverlayProps {
+    /** Current user ID */
+    userId: string;
+    /** Current user display name */
+    userName: string;
+    /** Current user avatar URL */
+    userAvatarUrl?: string;
+    /** List of remote participants */
+    participants?: VoiceChatParticipant[];
+    /** WebRTC configuration */
+    rtcConfig?: WebRTCAudioConfig;
+    /** Position of the overlay */
+    position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Whether the overlay is expanded (default: true) */
+    expanded?: boolean;
+    /** Callback to send signaling messages (required for peer connections) */
+    onSignalingMessage?: (message: SignalingMessage) => void;
+    /** Callback when user toggles mute */
+    onMuteToggle?: (muted: boolean) => void;
+    /** Callback when user leaves the chat */
+    onLeave?: () => void;
+    /** Callback when a participant's speaking state changes */
+    onSpeakingChange?: (participantId: string, isSpeaking: boolean) => void;
+    /** Audio level threshold for speaking detection (default: 0.1) */
+    speakingThreshold?: number;
+    /** Theme: 'light' | 'dark' | 'auto' */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Additional CSS class */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Z-index for positioning (default: 1000) */
+    zIndex?: number;
+}
+export interface VoiceChatOverlayRef {
+    /** Connect to a peer */
+    connectToPeer: (peerId: string) => Promise<void>;
+    /** Handle incoming signaling message */
+    handleSignalingMessage: (message: SignalingMessage) => Promise<void>;
+    /** Toggle mute state */
+    toggleMute: () => void;
+    /** Check if muted */
+    isMuted: () => boolean;
+    /** Leave the voice chat */
+    leave: () => void;
+    /** Get the WebRTC manager instance */
+    getManager: () => WebRTCAudioManager | null;
+}
+/**
+ * Voice chat overlay widget for embedding in applications.
+ *
+ * @example
+ * ```tsx
+ * import { NiceVoiceChatOverlay, VoiceChatOverlayRef } from '@nice2dev/ui-audio';
+ *
+ * function App() {
+ *   const overlayRef = useRef<VoiceChatOverlayRef>(null);
+ *   const [participants, setParticipants] = useState<VoiceChatParticipant[]>([]);
+ *
+ *   // Handle signaling via WebSocket
+ *   useEffect(() => {
+ *     socket.on('voice-signal', (msg) => {
+ *       overlayRef.current?.handleSignalingMessage(msg);
+ *     });
+ *   }, []);
+ *
+ *   return (
+ *     <NiceVoiceChatOverlay
+ *       ref={overlayRef}
+ *       userId="user-123"
+ *       userName="John Doe"
+ *       participants={participants}
+ *       onSignalingMessage={(msg) => socket.emit('voice-signal', msg)}
+ *       onLeave={() => console.log('Left voice chat')}
+ *       theme="dark"
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare const NiceVoiceChatOverlay: React.ForwardRefExoticComponent<NiceVoiceChatOverlayProps & React.RefAttributes<VoiceChatOverlayRef>>;
+export default NiceVoiceChatOverlay;
+//# sourceMappingURL=NiceVoiceChatOverlay.d.ts.map

package/dist/streaming/NiceVoiceChatOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceVoiceChatOverlay.d.ts","sourceRoot":"","sources":["../../src/streaming/NiceVoiceChatOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOlG,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;IACrE,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,sCAAsC;IACtC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACxE,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,wCAAwC;IACxC,sBAAsB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,wBAAwB;IACxB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,qBAAqB;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sCAAsC;IACtC,UAAU,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;CAC7C;AAmED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,oBAAoB,uGA6b/B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/streaming/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Streaming Audio Module — WebRTC, real-time visualizers, voice chat
+ *
+ * @module @nice2dev/ui-audio/streaming
+ */
+export { WebRTCAudioManager, isWebRTCSupported, getAudioInputDevices, createVoiceChatAudioContext, type WebRTCAudioConfig, type PeerConnection, type SignalingMessage, type OnRemoteStreamCallback, type OnPeerStateChangeCallback, type OnSignalingMessageCallback, } from './webrtcAudio';
+export { NiceStreamingVisualizer, default as StreamingVisualizer, type NiceStreamingVisualizerProps, type StreamingVisualizerRef, type VisualizerMode, } from './NiceStreamingVisualizer';
+export { NiceVoiceChatOverlay, default as VoiceChatOverlay, type NiceVoiceChatOverlayProps, type VoiceChatOverlayRef, type VoiceChatParticipant, } from './NiceVoiceChatOverlay';
+export { LiveStreamManager, detectStreamProtocol, createLiveStream, type StreamProtocol, type QualityLevel, type LiveStreamConfig, type StreamState, type StreamEvents, type BufferHealth, type StreamMetadata, } from './liveStreamManager';
+export { useLiveStream, type UseLiveStreamOptions, type UseLiveStreamReturn, } from './useLiveStream';
+//# sourceMappingURL=index.d.ts.map

package/dist/streaming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,uBAAuB,EACvB,OAAO,IAAI,mBAAmB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,oBAAoB,EACpB,OAAO,IAAI,gBAAgB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/streaming/liveStreamManager.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Live Streaming Ingest — RTMP/HLS/DASH audio stream playback.
+ *
+ * Features:
+ * - HLS (HTTP Live Streaming) playback via hls.js
+ * - DASH (Dynamic Adaptive Streaming) playback via dash.js
+ * - RTMP-over-WebSocket proxied playback
+ * - Adaptive bitrate (ABR) monitoring
+ * - Buffer health monitoring
+ * - Latency tracking
+ * - Stream quality selection
+ */
+/** Supported stream protocols. */
+export type StreamProtocol = 'hls' | 'dash' | 'rtmp-ws' | 'icecast' | 'shoutcast';
+/** Stream quality level. */
+export interface QualityLevel {
+    index: number;
+    bitrate: number;
+    codecs?: string;
+    width?: number;
+    height?: number;
+    label: string;
+}
+/** Stream configuration. */
+export interface LiveStreamConfig {
+    url: string;
+    protocol: StreamProtocol;
+    /** Auto-start playback. */
+    autoPlay?: boolean;
+    /** Target latency for low-latency streams (seconds). */
+    targetLatency?: number;
+    /** Maximum buffer length (seconds). */
+    maxBufferLength?: number;
+    /** Initial quality level index (-1 = auto). */
+    initialQuality?: number;
+    /** Enable ABR (adaptive bitrate). */
+    enableABR?: boolean;
+    /** Custom headers for requests. */
+    headers?: Record<string, string>;
+    /** Retry configuration. */
+    retry?: {
+        maxAttempts: number;
+        delayMs: number;
+        backoffMultiplier: number;
+    };
+}
+/** Stream state. */
+export interface StreamState {
+    status: 'idle' | 'connecting' | 'buffering' | 'playing' | 'paused' | 'error' | 'ended';
+    currentTime: number;
+    duration: number;
+    buffered: number;
+    latency: number;
+    bitrate: number;
+    currentQuality: QualityLevel | null;
+    availableQualities: QualityLevel[];
+    error: string | null;
+    isLive: boolean;
+}
+/** Stream events. */
+export interface StreamEvents {
+    onStateChange?: (state: StreamState) => void;
+    onQualityChange?: (quality: QualityLevel) => void;
+    onError?: (error: Error) => void;
+    onBufferHealth?: (health: BufferHealth) => void;
+    onMetadata?: (metadata: StreamMetadata) => void;
+}
+/** Buffer health metrics. */
+export interface BufferHealth {
+    currentLevel: number;
+    targetLevel: number;
+    isHealthy: boolean;
+    stallCount: number;
+    lastStallDuration: number;
+}
+/** Stream metadata. */
+export interface StreamMetadata {
+    title?: string;
+    artist?: string;
+    album?: string;
+    genre?: string;
+    bitrate?: number;
+    sampleRate?: number;
+    channels?: number;
+    [key: string]: unknown;
+}
+/**
+ * Manages live audio streaming from various sources.
+ */
+export declare class LiveStreamManager {
+    private config;
+    private audioContext;
+    private audioElement;
+    private sourceNode;
+    private analyserNode;
+    private hlsInstance;
+    private dashInstance;
+    private state;
+    private events;
+    private retryCount;
+    private retryTimeout;
+    private bufferCheckInterval;
+    private stallCount;
+    private lastStallTime;
+    constructor(config: LiveStreamConfig, events?: StreamEvents);
+    private getInitialState;
+    /**
+     * Initialize and connect to stream.
+     */
+    connect(): Promise<void>;
+    /**
+     * Set up HLS playback using hls.js.
+     */
+    private setupHLS;
+    /**
+     * Set up DASH playback using dash.js.
+     */
+    private setupDASH;
+    /**
+     * Set up RTMP stream over WebSocket proxy.
+     */
+    private setupRTMPOverWebSocket;
+    /**
+     * Set up Icecast/Shoutcast stream (direct MP3/AAC stream).
+     */
+    private setupIcecast;
+    /**
+     * Poll for Icecast metadata (title/artist).
+     */
+    private metadataInterval;
+    private startMetadataPolling;
+    /**
+     * Set up audio element event listeners.
+     */
+    private setupEventListeners;
+    /**
+     * Start buffer health monitoring.
+     */
+    private startBufferMonitoring;
+    /**
+     * Handle stream error with retry logic.
+     */
+    private handleError;
+    /**
+     * Update state and emit events.
+     */
+    private updateState;
+    /**
+     * Start playback.
+     */
+    play(): Promise<void>;
+    /**
+     * Pause playback.
+     */
+    pause(): void;
+    /**
+     * Set quality level.
+     */
+    setQuality(levelIndex: number): void;
+    /**
+     * Seek to the live edge of the stream.
+     */
+    seekToLive(): void;
+    /**
+     * Get current state.
+     */
+    getState(): StreamState;
+    /**
+     * Get analyser node for visualization.
+     */
+    getAnalyserNode(): AnalyserNode | null;
+    /**
+     * Get audio context.
+     */
+    getAudioContext(): AudioContext | null;
+    /**
+     * Disconnect and cleanup.
+     */
+    disconnect(): void;
+}
+/**
+ * Auto-detect stream protocol from URL.
+ */
+export declare function detectStreamProtocol(url: string): StreamProtocol;
+/**
+ * Create LiveStreamManager with auto-detected protocol.
+ * @param urlOrConfig - Stream URL string or full config object
+ * @param events - Optional stream event handlers
+ */
+export declare function createLiveStream(urlOrConfig: string | Omit<LiveStreamConfig, 'protocol'> & {
+    protocol?: StreamProtocol;
+}, events?: StreamEvents): LiveStreamManager;
+export default LiveStreamManager;
+//# sourceMappingURL=liveStreamManager.d.ts.map

package/dist/streaming/liveStreamManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveStreamManager.d.ts","sourceRoot":"","sources":["../../src/streaming/liveStreamManager.ts"],"names":[],"mappings":"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"}

package/dist/streaming/useLiveStream.d.ts

@@ -0,0 +1,19 @@
+import { LiveStreamConfig, StreamState, BufferHealth, StreamMetadata } from './liveStreamManager';
+export interface UseLiveStreamOptions extends Omit<LiveStreamConfig, 'url'> {
+    url: string;
+    /** Auto-connect on mount. */
+    autoConnect?: boolean;
+}
+export interface UseLiveStreamReturn {
+    state: StreamState;
+    bufferHealth: BufferHealth | null;
+    metadata: StreamMetadata | null;
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    play: () => Promise<void>;
+    pause: () => void;
+    setQuality: (index: number) => void;
+    seekToLive: () => void;
+}
+export declare function useLiveStream(options: UseLiveStreamOptions): UseLiveStreamReturn;
+//# sourceMappingURL=useLiveStream.d.ts.map

package/dist/streaming/useLiveStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveStream.d.ts","sourceRoot":"","sources":["../../src/streaming/useLiveStream.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAGhB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAmEhF"}