/**
 * Copyright (c) Double Symmetry GmbH
 * Commercial use requires a license. See https://rntp.dev/pricing
 */

/**
 * Normalized error category indicating whether a retry is likely to help.
 *
 * - `'network'` — transient connectivity issue (timeout, connection lost). Retryable.
 * - `'source'` — the media itself is bad (404, unsupported format, DRM). Not retryable.
 * - `'renderer'` — decoder or audio output failure. Not retryable.
 * - `'play-not-permitted'` — web only: the browser's autoplay policy rejected
 *   `play()` without a user gesture. The player stays paused; calling
 *   {@link play} from a user gesture succeeds.
 * - `'unknown'` — could not be classified.
 *
 * @since 5.6.0 added `'play-not-permitted'`
 */
export type PlaybackErrorCode =
  | 'network'
  | 'source'
  | 'renderer'
  | 'play-not-permitted'
  | 'unknown';

export interface PlaybackErrorEvent {
  code: PlaybackErrorCode;
  message: string;
}