AvaloniaStack/Avalonia-Services/Services/AuthService/AuthContracts.cs

namespace Avalonia_Services.Services.AuthService
{
    /// <summary>
    /// API 登录请求。
    /// </summary>
    /// <param name="Account">账号（邮箱或用户名）。</param>
    /// <param name="Password">密码。</param>
    /// <param name="Roles">请求的角色列表。</param>
    public sealed record ApiLoginRequest(string? Account, string? Password, string[]? Roles = null);

    /// <summary>
    /// API Refresh Token 请求。
    /// </summary>
    /// <param name="RefreshToken">刷新令牌。</param>
    public sealed record ApiRefreshTokenRequest(string? RefreshToken);

    /// <summary>
    /// API 登出请求。
    /// </summary>
    /// <param name="RefreshToken">要撤销的刷新令牌。</param>
    public sealed record ApiLogoutRequest(string? RefreshToken);

    /// <summary>
    /// 认证 Token 响应，包含 Access Token 和 Refresh Token 及其过期时间。
    /// </summary>
    /// <param name="AccessToken">访问令牌。</param>
    /// <param name="RefreshToken">刷新令牌。</param>
    /// <param name="AccessTokenExpiresAt">访问令牌过期时间。</param>
    /// <param name="RefreshTokenExpiresAt">刷新令牌过期时间。</param>
    /// <param name="Roles">用户角色列表。</param>
    public sealed record AuthTokenResponse(
        string AccessToken,
        string RefreshToken,
        DateTime AccessTokenExpiresAt,
        DateTime RefreshTokenExpiresAt,
        string[] Roles);

    /// <summary>
    /// PC 端授权码登录请求。
    /// </summary>
    /// <param name="AuthorizationCode">第三方授权码。</param>
    public sealed record PcAuthorizeRequest(string? AuthorizationCode);

    /// <summary>
    /// PC 端 Token 刷新请求。
    /// </summary>
    /// <param name="Token">当前 Token。</param>
    public sealed record PcRefreshRequest(string? Token);

    /// <summary>
    /// PC 端登出请求。
    /// </summary>
    /// <param name="Token">要清除的 Token。</param>
    public sealed record PcLogoutRequest(string? Token);

    /// <summary>
    /// PC 端 Token 响应。
    /// </summary>
    /// <param name="Token">访问令牌。</param>
    /// <param name="ExpiresAt">过期时间。</param>
    /// <param name="Roles">用户角色列表。</param>
    public sealed record PcTokenResponse(string Token, DateTime ExpiresAt, string[] Roles);

    /// <summary>
    /// 第三方授权检查结果。
    /// </summary>
    public enum ThirdPartyAuthCheckResult
    {
        /// <summary>授权有效。</summary>
        Valid,
        /// <summary>授权已丢失。</summary>
        AuthorizationLost,
        /// <summary>暂时性失败。</summary>
        TemporaryFailure,
    }

    /// <summary>
    /// 第三方授权客户端接口，用于验证和刷新第三方授权。
    /// </summary>
    public interface IPcThirdPartyAuthorizationClient
    {
        /// <summary>
        /// 验证第三方授权码是否有效。
        /// </summary>
        /// <param name="authorizationCode">第三方授权码。</param>
        /// <param name="cancellationToken">取消令牌。</param>
        /// <returns>授权检查结果。</returns>
        Task<ThirdPartyAuthCheckResult> ValidateAuthorizationCodeAsync(string authorizationCode, CancellationToken cancellationToken = default);

        /// <summary>
        /// 刷新第三方授权。
        /// </summary>
        /// <param name="authorizationReference">授权引用标识。</param>
        /// <param name="cancellationToken">取消令牌。</param>
        /// <returns>授权检查结果。</returns>
        Task<ThirdPartyAuthCheckResult> RefreshAuthorizationAsync(string authorizationReference, CancellationToken cancellationToken = default);
    }
}