shoc-backend/SeaHaven.DataServices/Interfaces/IVendorDocumentDataService.cs

using Data.SeaHavenIndustries;

namespace SeaHaven.DataServices.Interfaces
{
    public interface IVendorDocumentDataService
    {
        Task<VendorCompletionDocument?> GetLatestForDispatchAsync(int dispatchId, CancellationToken cancellationToken);
        Task<VendorCompletionDocument?> GetForVendorDispatchAsync(int documentId, int dispatchId, int vendorId, CancellationToken cancellationToken);
        Task<VendorCompletionDocument?> GetMetadataForVendorDispatchAsync(int documentId, int dispatchId, int vendorId, CancellationToken cancellationToken);
        Task<List<VendorCompletionDocument>> ListForVendorDispatchAsync(int dispatchId, int vendorId, CancellationToken cancellationToken);
        Task<VendorCompletionDocument?> GetUpliftEvidenceAsync(int documentId, int dispatchId, int vendorId, CancellationToken cancellationToken);
        /// <summary>
        /// Content types of the work order's current vendor documents (not deleted, not replaced by a
        /// newer completion version), optionally excluding one being replaced. Feeds the per-work-order photo/video counts.
        /// </summary>
        Task<IReadOnlyList<string>> ListActiveContentTypesForWorkOrderAsync(
            int workOrderId,
            int? excludingDocumentId,
            CancellationToken cancellationToken);

        /// <summary>Stored URLs of the work order's non-deleted dispatcher attachments (photo/video counts).</summary>
        Task<IReadOnlyList<string>> ListActiveWorkOrderAttachmentUrlsAsync(
            int workOrderId,
            CancellationToken cancellationToken);
        Task AddAsync(VendorCompletionDocument document, CancellationToken cancellationToken);
        Task SaveChangesAsync(CancellationToken cancellationToken);
    }
}