package com.vetti.hotake.mapper;

import com.vetti.hotake.domain.HotakeSecurityLoginSessions;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户登录会话Mapper接口
 *
 * @author vetti
 * @date 2026-02-02
 */
public interface HotakeSecurityLoginSessionsMapper
{
    /**
     * 查询用户登录会话
     *
     * @param id 用户登录会话主键
     * @return 用户登录会话
     */
    public HotakeSecurityLoginSessions selectHotakeSecurityLoginSessionsById(Long id);

    /**
     * 根据会话令牌查询会话
     *
     * @param sessionToken 会话令牌
     * @return 用户登录会话
     */
    public HotakeSecurityLoginSessions selectHotakeSecurityLoginSessionsByToken(String sessionToken);

    /**
     * 查询用户登录会话列表
     *
     * @param hotakeSecurityLoginSessions 用户登录会话
     * @return 用户登录会话集合
     */
    public List<HotakeSecurityLoginSessions> selectHotakeSecurityLoginSessionsList(HotakeSecurityLoginSessions hotakeSecurityLoginSessions);

    /**
     * 查询用户的活跃会话列表
     *
     * @param userId 用户ID
     * @return 用户登录会话集合
     */
    public List<HotakeSecurityLoginSessions> selectActiveSessionsByUserId(Long userId);

    /**
     * 新增用户登录会话
     *
     * @param hotakeSecurityLoginSessions 用户登录会话
     * @return 结果
     */
    public int insertHotakeSecurityLoginSessions(HotakeSecurityLoginSessions hotakeSecurityLoginSessions);

    /**
     * 修改用户登录会话
     *
     * @param hotakeSecurityLoginSessions 用户登录会话
     * @return 结果
     */
    public int updateHotakeSecurityLoginSessions(HotakeSecurityLoginSessions hotakeSecurityLoginSessions);

    /**
     * 删除用户登录会话
     *
     * @param id 用户登录会话主键
     * @return 结果
     */
    public int deleteHotakeSecurityLoginSessionsById(Long id);

    /**
     * 批量删除用户登录会话
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteHotakeSecurityLoginSessionsByIds(Long[] ids);

    /**
     * 终止用户的其他会话（除了当前会话）
     *
     * @param userId 用户ID
     * @param currentSessionToken 当前会话令牌
     * @return 结果
     */
    public int terminateOtherSessions(@Param("userId") Long userId, @Param("currentSessionToken") String currentSessionToken);

    /**
     * 终止指定会话
     *
     * @param id 会话ID
     * @param userId 用户ID
     * @return 结果
     */
    public int terminateSession(@Param("id") Long id, @Param("userId") Long userId);
}
