using System.Security.Claims;

namespace StoreHub.Framework.Security;

/// <summary>
/// 令牌生成结果
/// </summary>
public class TokenResult
{
	/// <summary>
	/// 令牌类型（Bearer）
	/// </summary>
	public string TokenType { get; set; } = "Bearer";

	/// <summary>
	/// 访问令牌
	/// </summary>
	public string Token { get; set; } = string.Empty;

	/// <summary>
	/// 过期时间（本地时间）
	/// </summary>
	public DateTime ExpiresAt { get; set; }
}

/// <summary>
/// JWT 令牌服务：生成与校验访问令牌。
/// </summary>
public interface ITokenService
{
	/// <summary>
	/// 根据声明集合生成访问令牌
	/// </summary>
	TokenResult CreateToken(IEnumerable<Claim> claims);

	/// <summary>
	/// 校验令牌，校验失败返回 null
	/// </summary>
	Task<ClaimsPrincipal?> ValidateTokenAsync(string token);
}