using System.Collections.Generic;
using GB5Shared.DTO.Framework.Login;
using TMSDAL.DTO.Assessment;
using TMSDAL.DTO.Quiz;

namespace TMSDAL.CustomCode.Quiz
{
    public interface IQuizAttemptDAL
    {
        Task<string> GetQuizAttempt(int quizAttemptId, LoginDTO loginDTO);
        Task<List<QuizAttemptListItemDTO>> GetQuizAttemptFullList(LoginDTO loginDTO);
        Task<List<QuizAttemptListItemDTO>> GetQuizAttemptListByEmployee(int employeeId, LoginDTO loginDTO);

        /// <summary>Instant-mode question selection — random pick from MQUESTIONBANK, optionally
        /// scoped to a topic (topicId = -1 for no filter).</summary>
        Task<List<QuestionBankItemDTO>> GetRandomQuestionsByTopic(int topicId, int questionCount, LoginDTO loginDTO);
        Task<int> GetQuizAttemptCount(int quizId, int employeeId, LoginDTO loginDTO);
        Task<int> SaveQuizAttempt(QuizAttemptDTO dto, LoginDTO loginDTO);
        Task<int> UpdateQuizAttemptScore(QuizAttemptDTO dto, LoginDTO loginDTO);
        Task<string> DeleteQuizAttempt(int quizAttemptId, LoginDTO loginDTO);

        Task<List<QuizAttemptResponseDTO>> GetResponsesByAttempt(int quizAttemptId, LoginDTO loginDTO);
        Task SaveQuizAttemptResponse(QuizAttemptResponseDTO dto, LoginDTO loginDTO);
        Task UpdateQuizAttemptResponse(QuizAttemptResponseDTO dto, LoginDTO loginDTO);

        /// <summary>Latest passing attempt for (quizId, employeeId), or null if none — consumed by
        /// GB5Framework's IValidationCriteriaEvaluator (VALIDATIONTYPE=Quiz).</summary>
        Task<QuizAttemptProofDTO?> GetLatestPassingAttempt(int quizId, int employeeId, LoginDTO loginDTO);
    }
}