package dev.lions.user.manager.api;

import dev.lions.user.manager.dto.sync.HealthStatusDTO;
import dev.lions.user.manager.dto.sync.SyncConsistencyDTO;
import dev.lions.user.manager.dto.sync.SyncHistoryDTO;
import dev.lions.user.manager.dto.sync.SyncResultDTO;
import jakarta.ws.rs.*;
import jakarta.ws.rs.core.MediaType;
import org.eclipse.microprofile.openapi.annotations.Operation;
import org.eclipse.microprofile.openapi.annotations.tags.Tag;

/**
 * Interface JAX-RS définissant le contrat de l'API de synchronisation.
 * Cette interface doit être implémentée par le serveur et utilisée par le
 * client (via MicroProfile Rest Client).
 */
@Path("/api/sync")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
@Tag(name = "Sync", description = "Synchronisation avec Keycloak et health checks")
public interface SyncResourceApi {

    @GET
    @Path("/health/keycloak")
    @Operation(summary = "Vérifier la santé de Keycloak", description = "Retourne le statut de santé de Keycloak")
    HealthStatusDTO checkKeycloakHealth();

    @POST
    @Path("/users")
    @Operation(summary = "Synchroniser les utilisateurs", description = "Synchronise tous les utilisateurs depuis Keycloak")
    SyncResultDTO syncUsers(@QueryParam("realm") String realmName);

    @POST
    @Path("/roles")
    @Operation(summary = "Synchroniser les rôles", description = "Synchronise les rôles (realm et/ou client)")
    SyncResultDTO syncRoles(
            @QueryParam("realm") String realmName,
            @QueryParam("clientName") String clientName);

    @GET
    @Path("/consistency")
    @Operation(summary = "Vérifier la cohérence des données", description = "Compare le cache local et Keycloak pour un realm")
    SyncConsistencyDTO checkDataConsistency(@QueryParam("realm") String realmName);

    @GET
    @Path("/status")
    @Operation(summary = "Statut de la dernière synchro", description = "Retourne le statut de la dernière synchronisation du realm")
    SyncHistoryDTO getLastSyncStatus(@QueryParam("realm") String realmName);

    @POST
    @Path("/force")
    @Operation(summary = "Forcer une synchro", description = "Lance une synchronisation complète du realm (users + roles)")
    SyncHistoryDTO forceSyncRealm(@QueryParam("realm") String realmName);
}
