mediaserver

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

type Dispatcher struct{}

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

type Manager interface {
	Test(ctx context.Context, p TestParams) error
	TestByName(ctx context.Context, name string) error
	DiscoverSections(ctx context.Context, p TestParams) ([]Section, error)
	// BeginPlexPin starts a Plex PIN OAuth flow. Caller opens PlexPin.AuthURL
	// in a browser popup; admin authenticates with Plex; caller polls
	// PollPlexPin(pin.ID) until AuthToken is non-empty (5-minute window).
	BeginPlexPin(ctx context.Context) (PlexPin, error)
	PollPlexPin(ctx context.Context, pinID uint64) (PlexPinResult, error)
}

type PlayOnResult struct {
	Name       string
	ServerType string
	URL        string
	Fallback   bool
	Status     PlayOnStatus
}

type PlayOnStatus string

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

type PlexClientCreds struct {
	ClientID string
	Product  string
	Version  string
}

type PlexPin struct {
	ID      uint64
	Code    string
	AuthURL string
	// ClientID is the X-Plex-Client-Identifier the flow used. Surfaced so a
	// read-only deploy operator can commit it to media_server.plex_client_id.
	ClientID string
}

type PlexPinResult struct {
	AuthToken string
	Expired   bool
}

type Section struct {
	Key       string
	Name      string
	Locations []string
	Type      string
}

type Server interface {
	TestConnection(ctx context.Context) error
	// RefreshLibrary triggers a re-scan on the server. sectionKey is the
	// Plex-internal section identifier when targeting a specific library;
	// pass "" to fall back to legacy behavior (path-match for Plex, full
	// refresh for Jellyfin/Emby).
	RefreshLibrary(ctx context.Context, libraryPath, sectionKey string) error
	// MovieDeepLink returns a web URL pointing at the movie's details page on
	// this server. Returns ErrMovieNotFound when no item matches. hintSection
	// is the configured Plex library section (key) to check first; Jellyfin
	// and Emby ignore it.
	MovieDeepLink(
		ctx context.Context,
		hintSection string,
		tmdbID uint32,
		title string,
		year uint16,
	) (string, error)
	// TVShowDeepLink returns a web URL pointing at the series' details page on
	// this server. Returns ErrShowNotFound when no item matches. hintSection
	// is the configured Plex TV library section (key) to check first; Jellyfin
	// and Emby ignore it.
	TVShowDeepLink(
		ctx context.Context,
		hintSection string,
		tvdbID uint32,
		title string,
		year uint16,
	) (string, error)
}

type TestParams struct {
	ServerType string
	Host       string
	APIKey     string
}