Cleanuparr/code/backend/Cleanuparr.Infrastructure/Features/DownloadCleaner/Services/IOrphanedFilesCleanupService.cs

using Cleanuparr.Infrastructure.Features.DownloadClient;

namespace Cleanuparr.Infrastructure.Features.DownloadCleaner.Services;

/// <summary>
/// Scans configured directories for files that aren't claimed by any active
/// torrent and moves them to a dedicated orphaned directory. Optionally
/// purges old entries from the orphaned directory.
/// </summary>
public interface IOrphanedFilesCleanupService
{
    /// <summary>
    /// Processes orphaned files for every enabled per-client configuration.
    /// Claims are computed only for clients that have ScanDirectories configured.
    /// </summary>
    Task ProcessAsync(IReadOnlyList<IDownloadService> downloadServices, CancellationToken cancellationToken);
}