using adas_core.Domain.Models.MongoModels;
using adas_core.Domain.Models.Responses;
using MongoDB.Bson;

namespace adas_core.Application.Services.Interfaces;

public interface IAuthService
{
    /// <summary>
    /// Asynchronously retrieves the current login response, returning <c>null</c> when no login state is available.
    /// </summary>
    /// <returns>A <see cref="Task{TResult}"/> that resolves to the current <see cref="LoginResponse"/>, or <c>null</c> if no login response exists.</returns>
    /// <!-- aidoc:v1 sig=17789be -->
    Task<LoginResponse?> GetLoginResponse();
    /// <summary>
    /// Asynchronously retrieves a token.
    /// </summary>
    /// <returns>A task that represents the asynchronous operation. The task result contains the retrieved token string.</returns>
    /// <!-- aidoc:v1 sig=288a8f8 -->
    Task<string> GetToken();
    /// <summary>
    /// Retrieves a list of authorizations associated with the specified unit identifier.
    /// </summary>
    /// <param name="unitId">The unique identifier of the unit whose authorizations are being queried.</param>
    /// <returns>A task that represents the asynchronous operation, containing a list of <see cref="Authorization"/> objects matching the provided unit identifier.</returns>
    /// <!-- aidoc:v1 sig=82be9e3 -->
    Task<List<Authorization>> GetByUnitId(ObjectId unitId);
    /// <summary>
    /// Asynchronously deletes the record identified by the specified display identifier.
    /// </summary>
    /// <param name="displayId">The display identifier of the record to delete.</param>
    /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the record was successfully deleted.</returns>
    /// <!-- aidoc:v1 sig=9bea906 -->
    Task<bool> DeleteByDisplayId(ObjectId displayId);
    /// <summary>
    /// Asynchronously deletes the entity associated with the specified unit identifier.
    /// </summary>
    /// <param name="unitId">The unique identifier of the unit whose associated entity should be deleted.</param>
    /// <returns>A task that represents the asynchronous operation, containing a value indicating whether the deletion was successful.</returns>
    /// <!-- aidoc:v1 sig=7032be4 -->
    Task<bool> DeleteByUnitId(ObjectId unitId);
    /// <summary>
    /// Retrieves the list of authorizations associated with the specified user identifier.
    /// </summary>
    /// <param name="id">The unique identifier of the user whose authorizations are being retrieved.</param>
    /// <returns>A task that represents the asynchronous operation, containing the list of authorizations for the user.</returns>
    /// <!-- aidoc:v1 sig=884297c -->
    Task<List<Authorization>> GetUserAuthorities(ObjectId id);
}