domain

type Library struct {
	ID        string // Server-specific unique identifier
	Name      string // Display name
	Type      string // "movie" or "show"
	UpdatedAt int64  // Server's contentChangedAt timestamp
}

type LibraryClient interface {
	GetLibraries(ctx context.Context) ([]Library, error)
	GetMovies(ctx context.Context, libID string, offset, limit int) ([]*MediaItem, int, error)
	GetShows(ctx context.Context, libID string, offset, limit int) ([]*Show, int, error)
	GetMixedContent(ctx context.Context, libID string, offset, limit int) ([]ListItem, int, error)
	GetSeasons(ctx context.Context, showID string) ([]*Season, error)
	GetEpisodes(ctx context.Context, seasonID string) ([]*MediaItem, error)
	GetContinueWatching(ctx context.Context) ([]*MediaItem, error)
}

type ListItem interface {
	// GetID returns the unique identifier for this item
	GetID() string

	// GetLibraryID returns the parent library ID
	GetLibraryID() string

	// GetTitle returns the display title
	GetTitle() string

	// GetSortTitle returns the title used for alphabetical sorting (handles "The", "A", etc.)
	GetSortTitle() string

	// GetYear returns the release/air year (0 if not applicable)
	GetYear() int

	// GetDescription returns secondary info for display (e.g., "2024" for movies, "3 Seasons" for shows)
	GetDescription() string

	// GetItemType returns the type identifier: "movie", "show", "season", "episode"
	GetItemType() string

	// GetWatchStatus returns the watch status for indicator rendering
	GetWatchStatus() WatchStatus

	// CanDrillDown returns true if this item can be drilled into (shows child content)
	CanDrillDown() bool

	// GetAddedAt returns the unix timestamp when added to library (0 if not applicable)
	GetAddedAt() int64

	// GetUpdatedAt returns the unix timestamp when last updated (0 if not applicable)
	GetUpdatedAt() int64

	// GetDuration returns the duration (0 if not applicable)
	GetDuration() time.Duration

	// GetRating returns the audience/community rating 0-10 (0 if not applicable)
	GetRating() float64
}

type MediaItem struct {
	ID         string        // Server-specific unique identifier
	Title      string        // Display title
	SortTitle  string        // Title used for sorting
	LibraryID  string        // Parent library ID
	Summary    string        // Plot synopsis
	Year       int           // Release year
	AddedAt    int64         // Unix timestamp when added to library
	UpdatedAt  int64         // Unix timestamp when last updated
	Duration   time.Duration // Total runtime
	ViewOffset time.Duration // Watch progress
	IsPlayed   bool          // Whether item is marked as watched
	Type       MediaType     // Movie or Episode

	// Episode-specific fields (empty for movies)
	ShowTitle  string // Parent show name
	ShowID     string // Parent show ID (for navigation)
	SeasonNum  int    // Season number (0 = specials)
	EpisodeNum int    // Episode number within season
	ParentID   string // Season ID (for navigation)

	// Rating (0-10 scale, audience/community rating)
	Rating float64

	// Content rating (e.g., "PG-13", "R", "TV-MA")
	ContentRating string

	// Technical metadata
	AirDate       string // Full release/air date (e.g. "2023-10-25")
	FileSize      int64  // File size in bytes
	Bitrate       int    // Bitrate in kbps
	Width         int    // Video width in pixels
	Height        int    // Video height in pixels
	VideoCodec    string // Normalized: "HEVC", "H.264", "AV1"
	AudioCodec    string // Normalized: "AAC", "AC3", "DTS"
	AudioChannels int    // Channel count: 2, 6, 8
	Container     string // "mkv", "mp4"

	// Image URLs
	ThumbURL string // Poster/thumbnail image URL
	ArtURL   string // Background art URL
}

type MediaType int

type PlayableMedia struct {
	URL       string
	Subtitles []Subtitle
}

type PlaybackClient interface {
	ResolvePlayable(ctx context.Context, itemID string) (PlayableMedia, error)
	MarkPlayed(ctx context.Context, itemID string) error
	MarkUnplayed(ctx context.Context, itemID string) error
	// UpdateProgress reports the current playback position to the server.
	// positionMs is the current position in milliseconds.
	UpdateProgress(ctx context.Context, itemID string, positionMs int64) error
}

type Playlist struct {
	ID           string        // Playlist identifier
	Title        string        // Display title
	PlaylistType string        // "video", "audio", "photo"
	Smart        bool          // Smart/dynamic playlist
	ItemCount    int           // Number of items in playlist
	Duration     time.Duration // Total duration of all items
	UpdatedAt    int64         // Unix timestamp when last updated
}

type PlaylistClient interface {
	GetPlaylists(ctx context.Context) ([]*Playlist, error)
	GetPlaylistItems(ctx context.Context, playlistID string) ([]*MediaItem, error)
	CreatePlaylist(ctx context.Context, title string, itemIDs []string) (*Playlist, error)
	AddToPlaylist(ctx context.Context, playlistID string, itemIDs []string) error
	RemoveFromPlaylist(ctx context.Context, playlistID string, itemID string) error
	DeletePlaylist(ctx context.Context, playlistID string) error
}

type ProgressFunc func(loaded, total int)

type SearchClient interface {
	Search(ctx context.Context, query string) ([]*MediaItem, error)
}

type Season struct {
	ID             string // Server-specific unique identifier
	LibraryID      string // Parent library ID
	ShowID         string // Parent show ID
	ShowTitle      string // Parent show name
	SeasonNum      int    // Season number (0 = Specials)
	Title          string // "Season 1" or custom name
	EpisodeCount   int    // Total number of episodes
	UnwatchedCount int    // Number of unwatched episodes

	// Image URLs
	ThumbURL string // Poster/thumbnail image URL
}

type Show struct {
	ID             string // Server-specific unique identifier
	Title          string // Series title
	SortTitle      string // Title used for sorting
	LibraryID      string // Parent library ID
	Summary        string // Series synopsis
	Year           int    // First air year
	AddedAt        int64  // Unix timestamp when added to library
	UpdatedAt      int64  // Unix timestamp when last updated
	SeasonCount    int    // Total number of seasons
	EpisodeCount   int    // Total number of episodes
	UnwatchedCount int    // Number of unwatched episodes

	// Rating (0-10 scale, audience/community rating)
	Rating float64

	// Content rating (e.g., "TV-MA", "TV-PG")
	ContentRating string

	// Image URLs
	ThumbURL string // Poster/thumbnail image URL
	ArtURL   string // Background art URL
}

type Store interface {
	// === Libraries ===
	GetLibraries() ([]Library, bool)
	SaveLibraries(libs []Library) error

	// === Library Content ===
	GetMovies(libID string) ([]*MediaItem, bool)
	SaveMovies(libID string, movies []*MediaItem, serverTS int64) error

	GetShows(libID string) ([]*Show, bool)
	SaveShows(libID string, shows []*Show, serverTS int64) error

	GetMixedContent(libID string) ([]ListItem, bool)
	SaveMixedContent(libID string, items []ListItem, serverTS int64) error

	// === Hierarchical (TV) ===
	GetSeasons(libID, showID string) ([]*Season, bool)
	SaveSeasons(libID, showID string, seasons []*Season) error

	GetEpisodes(libID, showID, seasonID string) ([]*MediaItem, bool)
	GetAllEpisodes(libID string) ([]*MediaItem, bool)
	SaveEpisodes(libID, showID, seasonID string, episodes []*MediaItem) error

	// === Playlists ===
	GetPlaylists() ([]*Playlist, bool)
	SavePlaylists(playlists []*Playlist) error

	GetPlaylistItems(playlistID string) ([]*MediaItem, bool)
	SavePlaylistItems(playlistID string, items []*MediaItem) error

	// === Local Queue ===
	GetQueueItems() ([]*MediaItem, bool)
	SaveQueueItems(items []*MediaItem) error

	// === Freshness ===
	IsValid(libID string, serverTS int64) bool

	// === Invalidation ===
	InvalidateLibrary(libID string)
	InvalidateShow(libID, showID string)
	InvalidateSeason(libID, showID, seasonID string)
	InvalidatePlaylists()
	InvalidatePlaylistItems(playlistID string)
	InvalidateQueue()
	InvalidateAll()

	Close() error
}

type Subtitle struct {
	URL      string // Direct URL the player can fetch
	Language string // ISO language code, e.g. "eng", "spa"
	Title    string // Human-readable label (may be empty)
	Codec    string // e.g. "srt", "ass", "vtt"
	Default  bool   // Server marked this track as default
	Forced   bool   // Forced subtitle track
}

type SyncResult struct {
	LibraryID string // Which library this result is for
	FromCache bool   // true if cache was fresh (no network fetch)
	Count     int    // total items after sync
}

type WatchStatus int