using EntitlementDAL.DTOs;
using GB5Shared.DTO.Framework.Login;

namespace EntitlementDAL.Interfaces;

public interface IAgreementDAL
{
    Task<AgreementTypeDTO?> GetTypeByCodeAsync(string typeCode, LoginDTO login, CancellationToken ct);

    Task InsertTypeAsync(AgreementTypeDTO dto, LoginDTO login, CancellationToken ct);

    /// <summary>Admin authoring list (tracker §51.13) — every real agreement type.</summary>
    Task<List<AgreementTypeDTO>> GetTypeListAsync(LoginDTO login, CancellationToken ct);

    /// <summary>Resolves the currently-applicable Published version bundle for the given
    /// AgreementTypeCodes and jurisdiction — one version per type, preferring a
    /// jurisdiction-specific override over the universal default.</summary>
    Task<List<AgreementVersionDTO>> GetApplicableVersionsAsync(
        IEnumerable<string> typeCodes, string jurisdictionCode, LoginDTO login, CancellationToken ct);

    Task<AgreementVersionDTO?> GetVersionByIdAsync(int agreementVersionId, LoginDTO login, CancellationToken ct);

    /// <summary>Admin authoring list (tracker §51.13) — every version ever created for one type,
    /// newest EffectiveFrom first, so full Draft/Published/Superseded/Retired history is visible.</summary>
    Task<List<AgreementVersionDTO>> GetVersionListByTypeAsync(int agreementTypeId, LoginDTO login, CancellationToken ct);

    /// <summary>Every currently-Published version of a RequiresIndividualAcceptance=1 type
    /// (e.g. an Enterprise Clickwrap EULA) — one per type, jurisdiction-preferring.</summary>
    Task<List<AgreementVersionDTO>> GetRequiredIndividualVersionsAsync(string jurisdictionCode, LoginDTO login, CancellationToken ct);

    Task InsertVersionAsync(AgreementVersionDTO dto, LoginDTO login, CancellationToken ct);

    Task UpdateVersionStatusAsync(int agreementVersionId, byte versionStatus, int modifiedById, DateTime modifiedOn, LoginDTO login, CancellationToken ct);

    /// <summary>Draft → Published specifically — sets VersionStatus and ContentHash together so
    /// the hash is never left uncommitted after a successful publish.</summary>
    Task PublishVersionAsync(int agreementVersionId, string? contentHash, int modifiedById, DateTime modifiedOn, LoginDTO login, CancellationToken ct);

    Task InsertAcceptanceAsync(AgreementAcceptanceDTO dto, LoginDTO login, CancellationToken ct);

    Task<List<AgreementAcceptanceDTO>> GetAcceptancesBySubjectAsync(byte subjectType, int subjectId, LoginDTO login, CancellationToken ct);
}