first commit

Jellyfin.Plugin.JRay/Services/Interfaces/IManagedTruthStore.cs

@@ -0,0 +1,38 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using Jellyfin.Plugin.JRay.Models;
+
+namespace Jellyfin.Plugin.JRay.Services.Interfaces;
+
+/// <summary>
+/// Stores and retrieves truth files that were pushed to JRay directly
+/// (e.g. by a remote extraction worker), independent of any sidecar file
+/// on the media filesystem.
+/// </summary>
+public interface IManagedTruthStore
+{
+    /// <summary>
+    /// Loads the managed truth file for the given item, if one was uploaded.
+    /// </summary>
+    /// <param name="itemId">The Jellyfin library item id.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>The parsed truth file, or null if none has been uploaded for this item.</returns>
+    Task<TruthFile?> LoadAsync(Guid itemId, CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Saves (creates or replaces) the managed truth file for the given item.
+    /// </summary>
+    /// <param name="itemId">The Jellyfin library item id.</param>
+    /// <param name="truth">The truth file contents to persist.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>A task that completes when the file has been written.</returns>
+    Task SaveAsync(Guid itemId, TruthFile truth, CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Deletes the managed truth file for the given item, if one exists.
+    /// </summary>
+    /// <param name="itemId">The Jellyfin library item id.</param>
+    /// <returns><c>true</c> if a file was deleted; <c>false</c> if none existed.</returns>
+    bool Delete(Guid itemId);
+}

Jellyfin.Plugin.JRay/Services/Interfaces/ITruthDataService.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using Jellyfin.Plugin.JRay.Models;
+
+namespace Jellyfin.Plugin.JRay.Services.Interfaces;
+
+/// <summary>
+/// Loads and caches scene-actor-extraction "truth" files for library items.
+/// </summary>
+public interface ITruthDataService
+{
+    /// <summary>
+    /// Gets the truth file for the given library item, if one exists.
+    /// </summary>
+    /// <param name="itemId">The Jellyfin library item id.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>The parsed truth file, or null if no truth file exists for this item.</returns>
+    Task<TruthFile?> GetTruthAsync(Guid itemId, CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Removes any cached truth file for the given item, so the next
+    /// <see cref="GetTruthAsync"/> call re-reads from the managed store or sidecar file.
+    /// </summary>
+    /// <param name="itemId">The Jellyfin library item id.</param>
+    void Invalidate(Guid itemId);
+}