timothy
64decd492e
Music videos carried no server identity, so JellyfinMusicVideoLibraryScanner had to reconcile by a (LibraryPathId, path) diff and HARD-delete the remainder. A file served by two libraries with overlapping local paths is a single row owned by whichever library scanned it first, so that owner's sweep destroyed a row another library still served — taking collection membership and playout references with it, irreversibly. This is #494's deferred "option 2": - New JellyfinMusicVideo : MusicVideo (ItemId/Etag), mirroring JellyfinMovie — TPT table, varchar(36), ItemId index. Dual-provider migration Add_JellyfinMusicVideo. - New IMediaServerMusicVideoRepository + JellyfinMusicVideoRepository: itemId-keyed existing-set/lookup and Flag{Normal,Unavailable,FileNotFound} seams, all scoped per library via LibraryPath.LibraryId. - New MediaServerMusicVideoLibraryScanner base; JellyfinMusicVideoLibraryScanner folds onto it and keeps the #177/#488/#497/#500 metadata-reconcile logic verbatim. - The sweep now soft-trashes (FileNotFound) instead of deleting, so removal is reversible and EmptyTrash-governed. DeleteEmptyArtists consequently no longer fires from a sweep. - Pre-identity rows are ADOPTED in place: the identity row is inserted against the same MediaItem id, scoped to the scanned library's own LibraryPath, so collection membership survives and a local/second-library row is never hijacked. - AddMusicVideo normalizes Path/PathHash to the path-REPLACED local path; the projection fills them from the server-reported path, which would break every later PathHash lookup. Docs: scan.musicvideo-reconciliation relocated to docs/decisions/archive/scan.md as superseded; new active record scan.musicvideo-server-identity. fixes #496
96 lines
3.7 KiB
C#
96 lines
3.7 KiB
C#
using ErsatzTV.Core.Domain;
|
|
using ErsatzTV.Core.Jellyfin;
|
|
using ErsatzTV.Core.Metadata;
|
|
|
|
namespace ErsatzTV.Core.Interfaces.Jellyfin;
|
|
|
|
public interface IJellyfinApiClient
|
|
{
|
|
Task<Either<BaseError, JellyfinServerInformation>> GetServerInformation(string address, string authorizationHeader);
|
|
Task<Either<BaseError, List<JellyfinLibrary>>> GetLibraries(string address, string authorizationHeader);
|
|
|
|
// #484: the six enumerations that feed a reconciliation sweep accept an optional per-enumeration
|
|
// counter -- the three library-level ones (movies, music videos, shows) AND the three nested ones
|
|
// (seasons per show, episodes per season, both episode variants), which feed the per-parent sweeps
|
|
// in MediaServerTelevisionLibraryScanner. The caller creates one instance per enumeration, scoped
|
|
// to the parent it sweeps, and reads it only after that enumeration completes; passing null (the
|
|
// default) opts out and costs existing callers nothing.
|
|
IAsyncEnumerable<Tuple<JellyfinMovie, int>> GetMovieLibraryItems(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
MediaServerProjectionFailureCounter projectionFailures = null);
|
|
|
|
IAsyncEnumerable<Tuple<JellyfinMusicVideo, int>> GetMusicVideoLibraryItems(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
MediaServerProjectionFailureCounter projectionFailures = null);
|
|
|
|
IAsyncEnumerable<Tuple<JellyfinShow, int>> GetShowLibraryItemsWithoutPeople(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
MediaServerProjectionFailureCounter projectionFailures = null);
|
|
|
|
// #484: the nested per-show season and per-season episode enumerations feed their own sweeps
|
|
// (FlagFileNotFoundSeasons / FlagFileNotFoundEpisodes), so they carry the same optional counter.
|
|
IAsyncEnumerable<Tuple<JellyfinSeason, int>> GetSeasonLibraryItems(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
string showId,
|
|
MediaServerProjectionFailureCounter projectionFailures = null);
|
|
|
|
IAsyncEnumerable<Tuple<JellyfinEpisode, int>> GetEpisodeLibraryItems(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
string seasonId,
|
|
MediaServerProjectionFailureCounter projectionFailures = null);
|
|
|
|
IAsyncEnumerable<Tuple<JellyfinEpisode, int>> GetEpisodeLibraryItemsWithoutPeople(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
string seasonId,
|
|
MediaServerProjectionFailureCounter projectionFailures = null);
|
|
|
|
IAsyncEnumerable<Tuple<JellyfinCollection, int>> GetCollectionLibraryItems(
|
|
string address,
|
|
string authorizationHeader,
|
|
int mediaSourceId);
|
|
|
|
IAsyncEnumerable<Tuple<MediaItem, int>> GetCollectionItems(
|
|
string address,
|
|
string authorizationHeader,
|
|
int mediaSourceId,
|
|
string collectionId);
|
|
|
|
Task<Either<BaseError, MediaVersion>> GetPlaybackInfo(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
string itemId);
|
|
|
|
Task<Either<BaseError, Option<JellyfinShow>>> GetSingleShow(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
string showId);
|
|
|
|
Task<Either<BaseError, List<JellyfinShow>>> SearchShowsByTitle(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
string showTitle);
|
|
|
|
Task<Either<BaseError, Option<JellyfinEpisode>>> GetSingleEpisode(
|
|
string address,
|
|
string authorizationHeader,
|
|
JellyfinLibrary library,
|
|
string seasonId,
|
|
string episodeId);
|
|
|
|
}
|