home

type ContinueWatchingService interface {
	// HasHistory returns true if the user has watch history.
	HasHistory(ctx context.Context, userID string) bool

	// GetContinueWatchingFull returns items the user is currently watching with full typed data.
	GetContinueWatchingFull(ctx context.Context, userID string, limit int) ([]MediaItemWithTime, error)
}

type ContinueWatchingServiceImpl struct {
	// contains filtered or unexported fields
}

type FavoritesService interface {
	// HasFavorites returns true if the user has any favorites.
	HasFavorites(ctx context.Context, userID string) bool

	// GetFavorites returns the user's favorite media items.
	GetFavorites(ctx context.Context, userID string, limit int) ([]*home.MediaItem, error)

	// GetFavoritesFull returns favorite media with full typed data.
	GetFavoritesFull(ctx context.Context, userID string, limit int) ([]MediaItemWithTime, error)
}

type FavoritesServiceImpl struct {
	// contains filtered or unexported fields
}

type GenresService interface {
	// GetDistinctGenres returns distinct genres from the library.
	GetDistinctGenres(ctx context.Context, limit int) ([]string, error)
}

type GenresServiceImpl struct {
	// contains filtered or unexported fields
}

type MediaItemWithTime struct {
	Type      string // "movie" or "tv_show"
	Movie     *movies.MovieResponse
	TVShow    *tv.TVShowSummary
	CreatedAt time.Time
	UpdatedAt time.Time

	// Progress contains playback progress (for continue watching).
	Progress *home.MediaProgress

	// EpisodeContext contains episode details for TV shows (for continue watching).
	EpisodeContext *home.EpisodeContext
}

type PluginLookup interface {
	// GetPlugin returns a plugin instance by ID.
	GetPlugin(id string) (*types.Instance, bool)
}

type PluginWidgetFetcher struct {
	// contains filtered or unexported fields
}

type RecentlyAddedService interface {
	// GetRecentlyAdded returns recently added media items.
	GetRecentlyAdded(ctx context.Context, limit int) ([]*home.MediaItem, error)

	// GetRecentlyAddedFull returns recently added media with full typed data.
	GetRecentlyAddedFull(ctx context.Context, limit int) ([]MediaItemWithTime, error)
}

type RecentlyAddedServiceImpl struct {
	// contains filtered or unexported fields
}

type Service struct {
	// contains filtered or unexported fields
}

type TrendingService interface {
	// GetTrending returns trending items matched to the local library.
	GetTrending(ctx context.Context, mediaType string, limit int) (*apptrending.Result, error)
	// HasProvider returns true if a trending provider is available.
	HasProvider() bool
}

type WidgetDataFetcher interface {
	// FetchWidgetData fetches data for a widget.
	// The path is the widget's configured endpoint (e.g., "/recommendations").
	// The params map contains additional query parameters from endpoint_params config.
	FetchWidgetData(ctx context.Context, pluginID, path, userID, clientType string, params map[string]string) (map[string]any, error)
}