package com.cico.nest.lcdp.boot.api.system.social;

import com.cico.nest.lcdp.boot.api.system.social.dto.SocialUserRespDTO;
import com.cico.nest.lcdp.boot.api.system.social.dto.SocialUserUnbindReqDTO;
import com.cico.nest.lcdp.boot.api.system.social.dto.SocialUserBindReqDTO;
import com.cico.nest.lcdp.framework.common.exception.ServiceException;
import jakarta.validation.Valid;


/**
 * 社交用户的 API 接口
 *
 * @author zws
 */
public interface SocialUserApi {

    /**
     * 绑定社交用户
     *
     * @param reqDTO 绑定信息
     * @return 社交用户 openid
     */
    String bindSocialUser(@Valid SocialUserBindReqDTO reqDTO);

    /**
     * 取消绑定社交用户
     *
     * @param reqDTO 解绑
     */
    void unbindSocialUser(@Valid SocialUserUnbindReqDTO reqDTO);

    /**
     * 获得社交用户，基于 userId
     *
     * @param userType 用户类型
     * @param userId 用户编号
     * @param socialType 社交平台的类型
     * @return 社交用户
     */
    SocialUserRespDTO getSocialUserByUserId(Integer userType, Long userId, Integer socialType);

    /**
     * 获得社交用户
     *
     * 在认证信息不正确的情况下，也会抛出 {@link ServiceException} 业务异常
     *
     * @param userType 用户类型
     * @param socialType 社交平台的类型
     * @param code 授权码
     * @param state state
     * @return 社交用户
     */
    SocialUserRespDTO getSocialUserByCode(Integer userType, Integer socialType, String code, String state);

}
