namespace OASystem.API.OAMethodLib.MicrosoftGraphMailbox;

public interface IMicrosoftGraphMailboxService
{
    /// <summary>
    /// 获取 Graph 访问令牌（优先静默；失败则交互式浏览器登录）。
    /// </summary>
    Task<string> GetAccessTokenAsync(CancellationToken cancellationToken = default);

    /// <summary>
    /// GET /me 原始 JSON（用于诊断）。
    /// </summary>
    Task<string?> GetMeRawJsonAsync(CancellationToken cancellationToken = default);

    /// <summary>
    /// 拉取收件箱中 receivedDateTime &gt;= startUtc 的邮件列表 JSON（与示例控制台相同查询）。
    /// </summary>
    Task<string?> GetInboxMessagesJsonSinceAsync(DateTime startUtc, CancellationToken cancellationToken = default);

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