elemes/services/token_service.py

"""
Token & progress facade — kontrak publik yang dipakai routes.

Mendelegasikan ke satu-satunya storage backend aktif: PostgreSQL
(services.storage.postgres_backend). Backend CSV sudah dicabut setelah
cutover penuh — routes TIDAK boleh tahu detail backend, cukup import sini.
"""

from services.storage import get_backend_module


def _backend():
    return get_backend_module()


def validate_token(token):
    """Valid token → {'student_name', 'is_teacher'} | None."""
    return _backend().validate_token(token)


def is_teacher_token(token):
    return _backend().is_teacher_token(token)


def get_student_progress(token):
    """Dict {lesson_slug: status} | None."""
    return _backend().get_student_progress(token)


def has_quiz_attempt(token, lesson_name):
    """Cek apakah siswa sudah memiliki rekaman attempt kuis untuk lesson."""
    return _backend().has_quiz_attempt(token, lesson_name)


def is_quiz_attempt_resumable(token, lesson_name):
    """True bila attempt terminated siswa di-resume guru (bisa dilanjutkan)."""
    return _backend().is_quiz_attempt_resumable(token, lesson_name)


def reset_student_progress(student_id, lesson_name):
    """Reset progress siswa by student_id (id anonim dari report — bukan token)."""
    return _backend().reset_progress(student_id, lesson_name)


def resume_quiz_attempt(student_id, lesson_name):
    """Beri izin guru melanjutkan attempt terminated siswa (via student_id)."""
    return _backend().resume_quiz_attempt(student_id, lesson_name)


def get_all_students_progress(all_lessons_func):
    """(students, ordered_lessons) — tanpa token mentah di student dict."""
    return _backend().get_all_students_progress(all_lessons_func)


def calculate_student_completion(student_data, all_lessons):
    """Helper murni bersama (parity kedua backend)."""
    from services.storage.completion import calculate_student_completion as _calc

    return _calc(student_data, all_lessons)