@vyonio/player 0.0.0-stage → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/** Authentication errors contain safe codes rather than endpoint response details. */
+export class PlaybackTokenError extends Error {
+  constructor(code?: string);
+  code: string;
+}
+
+export interface VyonioPlayerError {
+  code: string;
+  message: string;
+  /** Raw engine diagnostics are available only for public playback. */
+  data?: unknown[];
+  error: Error;
+}
+
+export interface VyonioPlayerState {
+  currentTime: number;
+  duration: number | null;
+  paused: boolean;
+  ended: boolean;
+  muted: boolean;
+}
+
+export interface VyonioPlayerMount {
+  /** Advanced Shaka access; intentionally opaque to avoid requiring Shaka types. */
+  player: unknown;
+  mediaElement: HTMLVideoElement;
+  play(): Promise<void>;
+  pause(): void;
+  seek(seconds: number): void;
+  setMuted(muted: boolean): void;
+  getState(): VyonioPlayerState;
+  destroy(): Promise<void>;
+}
+
+export type VyonioPlayerAuthentication =
+  | { tokenEndpoint: string; tokenHeaders?: HeadersInit; getPlaybackToken?: never }
+  | { getPlaybackToken?: () => Promise<string>; tokenEndpoint?: never; tokenHeaders?: never };
+
+export type VyonioPlayerOptions = VyonioPlayerAuthentication & {
+  /** Defaults to https://api.vyonio.com. */
+  apiBase?: string;
+  embedUuid: string;
+  onError?: (detail: VyonioPlayerError) => void;
+  autoplay?: boolean;
+  muted?: boolean;
+  loop?: boolean;
+  controls?: boolean;
+  controlItems?: Array<'play-large' | 'play' | 'progress' | 'current-time' | 'mute' | 'volume' | 'captions' | 'settings' | 'pip' | 'airplay' | 'fullscreen'>;
+  settingsItems?: Array<'quality' | 'speed'>;
+  language?: 'en' | 'cs';
+  accentColor?: string | null;
+  badge?: {
+    text: string;
+    position: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    style: 'dark' | 'light' | 'accent';
+  } | null;
+  startSeconds?: number;
+  popularityHistogram?: { buckets: number[] };
+};
+
+/** Resolves after the manifest is loaded and playback controls are ready. */
+export function mount(element: HTMLElement, options: VyonioPlayerOptions): Promise<VyonioPlayerMount>;
+export const VyonioPlayer: { mount: typeof mount };