namespace OASystem.API.OAMethodLib.MicrosoftGraphMailbox;

public interface IMicrosoftGraphMailboxService
{
    /// <summary>
    /// GET /me 原始 JSON（使用调用方提供的 Graph 访问令牌）。
    /// </summary>
    Task<string?> GetMeRawJsonAsync(string graphAccessToken, CancellationToken cancellationToken = default);

    /// <summary>
    /// 拉取收件箱中 receivedDateTime &gt;= startUtc 的邮件列表 JSON。
    /// </summary>
    Task<string?> GetInboxMessagesJsonSinceAsync(DateTime startUtc, string graphAccessToken, CancellationToken cancellationToken = default);

    /// <summary>
    /// POST /me/sendMail 发送纯文本邮件。
    /// </summary>
    Task SendMailAsync(string toEmail, string subject, string textBody, string graphAccessToken, CancellationToken cancellationToken = default);

    /// <summary>
    /// 刷新 access_token
    /// </summary>
    Task<string> RefreshAccessTokenAsync(string clientId,
        string tenant,
        string[] scopes,
        string tokenCacheBase64,   // 从Redis拿到的缓存（Base64字符串）
        string homeAccountId       // 用户标识（建议存这个）
        );
}