shoc-backend/SeaHaven.Services/Interfaces/IUpliftService.cs

using System.Security.Claims;
using SeaHaven.Services.DTOs;

namespace SeaHaven.Services.Interfaces
{
    public interface IUpliftService
    {
        Task<UpliftListResultDTO> ListAsync(ClaimsPrincipal user, string? status, int? tier, int page, int pageSize, CancellationToken cancellationToken);
        Task<IEnumerable<UpliftForDispatchDTO>> ListForDispatchAsync(ClaimsPrincipal user, int dispatchId, CancellationToken cancellationToken);
        Task<UpliftApproveResultDTO> ApproveAsync(ClaimsPrincipal user, int id, string? note, CancellationToken cancellationToken);
        Task<UpliftDenyResultDTO> DenyAsync(ClaimsPrincipal user, int id, string? note, CancellationToken cancellationToken);
        // SH-101: canonical reject (alias of deny; writes Rejected).
        Task<UpliftDecisionResultDTO> RejectAsync(ClaimsPrincipal user, int id, string? note, CancellationToken cancellationToken);
        Task<UpliftDecisionResultDTO> RevokeAsync(ClaimsPrincipal user, int id, string reason, CancellationToken cancellationToken);
        // SH-101: internal request-changes route (note + tier authorization + audit).
        Task<UpliftDecisionResultDTO> RequestChangesAsync(ClaimsPrincipal user, int id, string note, CancellationToken cancellationToken);
        // SH-101: authorized internal download of a Passed UpliftEvidence file linked to an uplift request.
        Task<UpliftEvidenceDownloadResultDTO> GetEvidenceForDownloadAsync(
            ClaimsPrincipal user,
            int id,
            CancellationToken cancellationToken,
            int? documentId = null);
        bool CanApprove(ClaimsPrincipal user, int tier);
    }
}