mediaserver

type AuthFlow interface {
	// Run executes the authentication flow and returns credentials.
	// The serverURL parameter is the base URL of the media server.
	// Implementations handle their own user interaction (prompting for credentials, etc.)
	Run(ctx context.Context, serverURL string) (*AuthResult, error)
}

type AuthResult struct {
	Token    string // Access token for API calls
	UserID   string // User identifier (required for Jellyfin)
	Username string // Display username
}

type MediaSource interface {
	domain.LibraryClient  // Browsing: GetLibraries, GetMovies, GetShows, GetSeasons, GetEpisodes
	domain.PlaybackClient // Playback: ResolvePlayableURL, MarkPlayed/Unplayed
	domain.SearchClient   // Search: Search(query) across all libraries
	domain.PlaylistClient // Playlists: GetPlaylists, CreatePlaylist, AddToPlaylist, etc.

	// GetMediaItem fetches full metadata for a single item.
	// Kept on MediaSource (not in a domain interface) as it's only used
	// by specific features that need detailed item metadata.
	GetMediaItem(ctx context.Context, itemID string) (*domain.MediaItem, error)
}