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

using Data.SeaHavenIndustries;

namespace SeaHaven.DataServices.Interfaces
{
    public interface IWorkOrderMediaDataService
    {
        /// <summary>AsNoTracking base (+ optional account) scoped load for pre-mutation auth.</summary>
        Task<WorkOrder?> GetWorkOrderForMediaAuthAsync(
            int workOrderId,
            int? accountId,
            CancellationToken cancellationToken);

        Task<WorkOrder?> GetTrackedWorkOrderAsync(
            int workOrderId,
            int? accountId,
            CancellationToken cancellationToken);

        Task<WorkOrderAttachments?> GetAttachmentForReadAsync(
            int mediaId,
            int workOrderId,
            CancellationToken cancellationToken);

        Task<WorkOrderAttachments?> GetTrackedAttachmentAsync(int mediaId, int workOrderId, CancellationToken cancellationToken);
        void TrackAttachment(WorkOrderAttachments attachment);

        /// <summary>Stored URLs of the work order's non-deleted attachments (SH-116 photo/video counts).</summary>
        Task<IReadOnlyList<string>> ListActiveAttachmentUrlsAsync(
            int workOrderId,
            CancellationToken cancellationToken);

        /// <summary>
        /// Content types of the work order's current vendor-portal documents (not deleted, not
        /// replaced by a newer completion version). SH-116 counts span both upload surfaces.
        /// </summary>
        Task<IReadOnlyList<string>> ListActiveVendorMediaContentTypesAsync(
            int workOrderId,
            CancellationToken cancellationToken);
        void SetExpectedWorkOrderVersion(WorkOrder workOrder, byte[] version);
        void MarkWorkOrderModified(WorkOrder workOrder);
        Task SaveAsync(CancellationToken cancellationToken);
    }
}