package com.ruoyi.security.mapper;

import java.util.List;
import com.ruoyi.security.domain.MfaToken;
import org.apache.ibatis.annotations.Param;

/**
 * MFA令牌Mapper接口
 * 
 * @author ruoyi
 * @date 2025-12-20
 */
public interface MfaTokenMapper 
{
    /**
     * 查询MFA令牌
     * 
     * @param tokenId MFA令牌主键
     * @return MFA令牌
     */
    public MfaToken selectMfaTokenByTokenId(Long tokenId);

    /**
     * 根据令牌值查询MFA令牌
     * 
     * @param tokenValue 令牌值
     * @return MFA令牌
     */
    public MfaToken selectMfaTokenByValue(String tokenValue);

    /**
     * 查询用户有效的MFA令牌
     * 
     * @param userId 用户ID
     * @param tokenType 令牌类型
     * @return MFA令牌
     */
    public MfaToken selectValidTokenByUser(@Param("userId") Long userId, @Param("tokenType") String tokenType);

    /**
     * 查询过期的MFA令牌列表
     * 
     * @return MFA令牌集合
     */
    public List<MfaToken> selectExpiredTokens();

    /**
     * 查询MFA令牌列表
     * 
     * @param mfaToken MFA令牌
     * @return MFA令牌集合
     */
    public List<MfaToken> selectMfaTokenList(MfaToken mfaToken);

    /**
     * 新增MFA令牌
     * 
     * @param mfaToken MFA令牌
     * @return 结果
     */
    public int insertMfaToken(MfaToken mfaToken);

    /**
     * 修改MFA令牌
     * 
     * @param mfaToken MFA令牌
     * @return 结果
     */
    public int updateMfaToken(MfaToken mfaToken);

    /**
     * 删除MFA令牌
     * 
     * @param tokenId MFA令牌主键
     * @return 结果
     */
    public int deleteMfaTokenByTokenId(Long tokenId);

    /**
     * 批量删除MFA令牌
     * 
     * @param tokenIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteMfaTokenByTokenIds(Long[] tokenIds);
}