@vexor-video/player 0.0.0-stage → 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,120 @@
+import React$1, { ReactNode, CSSProperties } from 'react';
+import { W as WatermarkConfig, Q as QualityLevel } from './vanilla-BZJjSEad.js';
+export { V as VanillaPlayerInstance, c as createVexorPlayer } from './vanilla-BZJjSEad.js';
+
+interface VexorPlayerProps {
+    /** Full authenticated HLS manifest URL. */
+    src?: string;
+    /** Vexor asset UUID used when src is not provided. */
+    assetId?: string;
+    /** Short-lived playback token used with assetId. */
+    token?: string;
+    /** Vexor API base URL (default: https://api.vexor.et). */
+    baseUrl?: string;
+    /** Poster thumbnail URL. */
+    poster?: string;
+    /** Automatically start playback (browser policy may require muted=true). */
+    autoPlay?: boolean;
+    /** Start audio muted. */
+    muted?: boolean;
+    /** Loop playback. */
+    loop?: boolean;
+    /** HTML video preload behavior. */
+    preload?: "auto" | "metadata" | "none";
+    /** Fallback URL if HLS is unsupported or cannot be played. */
+    fallbackSrc?: string;
+    /** Display custom controls (default: true). */
+    controls?: boolean;
+    /** Use browser native controls instead of Vexor controls. */
+    nativeControls?: boolean;
+    /** Visible watermark overlay; this is a deterrent, not DRM or capture prevention. */
+    watermark?: string | WatermarkConfig;
+    /** Suppress context menu and drag interactions as a casual-copy deterrent only. */
+    protect?: boolean;
+    /** Retrieve a fresh playback token when an active token expires. */
+    refreshToken?: () => Promise<string>;
+    /** Playback lifecycle callbacks. */
+    onReady?: () => void;
+    onPlay?: () => void;
+    onPause?: () => void;
+    onEnded?: () => void;
+    onTimeUpdate?: (currentTime: number, duration: number) => void;
+    onError?: (error: {
+        code: string;
+        message: string;
+        fatal: boolean;
+    }) => void;
+    onQualityChange?: (levelIndex: number) => void;
+    /** Custom child elements rendered over the player. */
+    children?: ReactNode;
+    /** CSS class name applied to player container. */
+    className?: string;
+    /** Inline styles applied to player container. */
+    style?: CSSProperties;
+}
+
+declare const VexorPlayer: React$1.FC<VexorPlayerProps>;
+
+interface ControlsProps {
+    isPlaying: boolean;
+    isBuffering: boolean;
+    currentTime: number;
+    duration: number;
+    buffered: number;
+    volume: number;
+    isMuted: boolean;
+    isFullscreen: boolean;
+    qualityLevels: QualityLevel[];
+    currentQuality: number;
+    playbackRate: number;
+    visible: boolean;
+    onPlayPause: () => void;
+    onSeek: (time: number) => void;
+    onVolumeChange: (volume: number) => void;
+    onToggleMute: () => void;
+    onQualityChange: (levelIndex: number) => void;
+    onPlaybackRateChange: (rate: number) => void;
+    onToggleFullscreen: () => void;
+    onTogglePiP: () => void;
+}
+declare const Controls: React$1.FC<ControlsProps>;
+
+interface WatermarkProps {
+    config?: string | WatermarkConfig;
+}
+declare const Watermark: React$1.FC<WatermarkProps>;
+
+interface UseVexorPlayerReturn {
+    videoRef: React.RefObject<HTMLVideoElement | null>;
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    isPlaying: boolean;
+    isBuffering: boolean;
+    currentTime: number;
+    duration: number;
+    buffered: number;
+    volume: number;
+    isMuted: boolean;
+    isFullscreen: boolean;
+    qualityLevels: QualityLevel[];
+    currentQuality: number;
+    playbackRate: number;
+    error: {
+        code: string;
+        message: string;
+        fatal: boolean;
+    } | null;
+    play: () => Promise<void>;
+    pause: () => void;
+    togglePlay: () => void;
+    seek: (time: number) => void;
+    setVolume: (vol: number) => void;
+    toggleMute: () => void;
+    setQuality: (levelIndex: number) => void;
+    setPlaybackRate: (rate: number) => void;
+    toggleFullscreen: () => void;
+    togglePiP: () => void;
+    retry: () => void;
+}
+declare function useVexorPlayer({ src, assetId, token, baseUrl, fallbackSrc, autoPlay, muted, refreshToken, onReady, onPlay, onPause, onEnded, onTimeUpdate, onError, onQualityChange, }: VexorPlayerProps): UseVexorPlayerReturn;
+
+export { Controls, QualityLevel, type UseVexorPlayerReturn, VexorPlayer, type VexorPlayerProps, Watermark, WatermarkConfig, useVexorPlayer };