package cn.iocoder.yudao.module.im.service.channel;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.im.controller.admin.manager.channel.vo.material.ImChannelMaterialPageReqVO;
import cn.iocoder.yudao.module.im.controller.admin.manager.channel.vo.material.ImChannelMaterialSaveReqVO;
import cn.iocoder.yudao.module.im.dal.dataobject.channel.ImChannelMaterialDO;
import jakarta.validation.Valid;

import java.util.Collection;
import java.util.List;
import java.util.Map;

import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;

/**
 * IM 频道素材 Service 接口
 *
 * @author 芋道源码
 */
public interface ImChannelMaterialService {

    // ==================== 用户端 ====================

    /**
     * 校验素材存在
     *
     * @param id 素材编号
     * @return 素材 DO
     */
    ImChannelMaterialDO validateMaterialExists(Long id);

    /**
     * 按编号批量查询素材
     *
     * @param ids 素材编号列表
     * @return 素材列表
     */
    List<ImChannelMaterialDO> getMaterialList(Collection<Long> ids);

    /**
     * 按编号批量查询素材 Map
     *
     * @param ids 素材编号列表
     * @return id -> 素材 Map
     */
   default Map<Long, ImChannelMaterialDO> getMaterialMap(Collection<Long> ids) {
       return convertMap(getMaterialList(ids), ImChannelMaterialDO::getId);
   }

    /**
     * 统计指定频道下的素材数量
     *
     * @param channelId 频道编号
     * @return 数量
     */
    Long getMaterialCountByChannelId(Long channelId);

    // ==================== 管理后台 ====================

    /**
     * 按频道查询素材精简列表
     *
     * @param channelId 频道编号
     * @return 素材列表
     */
    List<ImChannelMaterialDO> getMaterialListByChannelId(Long channelId);

    /**
     * 分页查询素材
     *
     * @param reqVO 分页查询条件
     * @return 素材分页
     */
    PageResult<ImChannelMaterialDO> getMaterialPage(ImChannelMaterialPageReqVO reqVO);

    /**
     * 获取素材详情（含 content 富文本）
     *
     * @param id 素材编号
     * @return 素材 DO
     */
    ImChannelMaterialDO getMaterial(Long id);

    /**
     * 新增素材
     *
     * @param reqVO 新增请求
     * @return 新增素材编号
     */
    Long createMaterial(@Valid ImChannelMaterialSaveReqVO reqVO);

    /**
     * 修改素材
     *
     * @param reqVO 修改请求
     */
    void updateMaterial(@Valid ImChannelMaterialSaveReqVO reqVO);

    /**
     * 删除素材；素材已被推送过时拒绝，避免历史消息无法回查
     *
     * @param id 素材编号
     */
    void deleteMaterial(Long id);

}