using JdeScoping.Core.Models;

namespace JdeScoping.Core.Interfaces;

/// <summary>
/// Core authentication service interface.
/// Provides credential-based user authentication.
/// </summary>
public interface IAuthenticationService
{
    /// <summary>
    /// Authenticates a user with the given credentials.
    /// </summary>
    /// <param name="username">Username</param>
    /// <param name="password">Password</param>
    /// <param name="ct">Cancellation token</param>
    /// <returns>Authentication result containing success status and user info if successful</returns>
    Task<AuthResult> AuthenticateAsync(
        string username,
        string password,
        CancellationToken ct = default);
}