using ErsatzTV.Core.Domain;

namespace ErsatzTV.Core.Interfaces.Repositories;

public interface ILibraryRepository
{
    Task<LibraryPath> Add(LibraryPath libraryPath);
    Task<Option<Library>> GetLibrary(int libraryId);
    Task<Option<LocalLibrary>> GetLocal(int libraryId);

    /// <summary>
    ///     Resolves the owning library id for a library path, without loading the full entity graph.
    ///     Used by the local-libraries API to pre-check a path's existence/ownership before a move
    ///     (see design #202 §C6 — the 404/lock-check for <c>POST .../paths/{pathId}/move</c>).
    /// </summary>
    Task<Option<int>> GetLibraryIdForPath(int libraryPathId);

    Task<List<Library>> GetAll();
    Task<Unit> UpdateLastScan(Library library);
    Task<Unit> UpdateLastScan(LibraryPath libraryPath);
    Task<List<LibraryPath>> GetLocalPaths(int libraryId);
    Task<int> CountMediaItemsByPath(int libraryPathId);
    Task SetEtag(LibraryPath libraryPath, Option<LibraryFolder> knownFolder, string path, string etag);
    Task CleanEtagsForLibraryPath(LibraryPath libraryPath);
    Task<Option<int>> GetParentFolderId(LibraryPath libraryPath, string folder, CancellationToken cancellationToken);

    /// <summary>
    ///     Returns the <see cref="LibraryFolder" /> at <paramref name="folder" /> under
    ///     <paramref name="libraryPath" />, creating it if it does not yet exist.
    /// </summary>
    /// <remarks>
    ///     The existing folder is looked up from the database by <c>(LibraryPathId, Path)</c>. Callers do
    ///     <b>not</b> need to eager-load <see cref="LibraryPath.LibraryFolders" /> — the remote (Jellyfin)
    ///     sync path never does, and relying on that navigation collection here previously NRE'd every
    ///     Jellyfin music-video scan (ersatztv#488).
    /// </remarks>
    Task<LibraryFolder> GetOrAddFolder(LibraryPath libraryPath, Option<int> maybeParentFolder, string folder);
    Task UpdateLibraryFolderId(MediaFile mediaFile, int libraryFolderId);
    Task UpdatePath(LibraryPath libraryPath, string normalizedLibraryPath);
}