package dev.lions.unionflow.client.service;

import dev.lions.unionflow.server.api.dto.paiement.request.InitierPaiementEnLigneRequest;
import dev.lions.unionflow.server.api.dto.paiement.response.IntentionStatutResponse;
import dev.lions.unionflow.server.api.dto.paiement.response.PaiementGatewayResponse;
import org.eclipse.microprofile.rest.client.annotation.RegisterClientHeaders;
import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;
import jakarta.ws.rs.*;
import jakarta.ws.rs.core.MediaType;
import java.util.UUID;

/**
 * Client REST pour les paiements en ligne (Wave Checkout QR).
 */
@RegisterRestClient(configKey = "unionflow-api")
@RegisterClientHeaders(dev.lions.unionflow.client.security.AuthHeaderFactory.class)
@Path("/api/paiements")
@Consumes(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
public interface PaiementClientService {

    /**
     * Initie un paiement Wave et retourne le wave_launch_url à encoder en QR code.
     * Sur le web, laisser {@code numeroTelephone} null → pas de restriction de payeur.
     */
    @POST
    @Path("/initier-paiement-en-ligne")
    PaiementGatewayResponse initierPaiementEnLigne(InitierPaiementEnLigneRequest request);

    /**
     * Polling du statut d'une intention Wave.
     * Si Wave a confirmé, retourne statut=COMPLETEE et la cotisation est marquée PAYEE.
     *
     * @param intentionId UUID retourné dans {@code clientReference} de {@link PaiementGatewayResponse}
     */
    @GET
    @Path("/statut-intention/{intentionId}")
    IntentionStatutResponse getStatutIntention(@PathParam("intentionId") UUID intentionId);
}
