package cn.iocoder.yudao.module.iot.service.ota;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwareCreateReqVO;
import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwarePageReqVO;
import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwareUpdateReqVO;
import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaFirmwareDO;
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;

/**
 * OTA 固件管理 Service 接口
 *
 * @author Shelly Chan
 */
public interface IotOtaFirmwareService {

    /**
     * 创建 OTA 固件
     *
     * @param saveReqVO 固件信息
     * @return 固件编号
     */
    Long createOtaFirmware(@Valid IotOtaFirmwareCreateReqVO saveReqVO);

    /**
     * 更新 OTA 固件信息
     *
     * @param updateReqVO 固件信息
     */
    void updateOtaFirmware(@Valid IotOtaFirmwareUpdateReqVO updateReqVO);

    /**
     * 获取 OTA 固件信息
     *
     * @param id 固件编号
     * @return 固件信息
     */
    IotOtaFirmwareDO getOtaFirmware(Long id);

    /**
     * 根据产品、版本号，获取 OTA 固件信息
     *
     * @param productId 产品编号
     * @param version 版本号
     * @return OTA 固件信息
     */
    IotOtaFirmwareDO getOtaFirmwareByProductIdAndVersion(Long productId, String version);

    /**
     * 获取 OTA 固件信息列表
     *
     * @param ids 固件编号集合
     * @return 固件信息列表
     */
    List<IotOtaFirmwareDO> getOtaFirmwareList(Collection<Long> ids);

    /**
     * 获取 OTA 固件信息 Map
     *
     * @param ids 固件编号集合
     * @return 固件信息 Map
     */
    default Map<Long, IotOtaFirmwareDO> getOtaFirmwareMap(Collection<Long> ids) {
        return convertMap(getOtaFirmwareList(ids), IotOtaFirmwareDO::getId);
    }

    /**
     * 分页查询 OTA 固件信息
     *
     * @param pageReqVO 分页查询条件
     * @return 分页结果
     */
    PageResult<IotOtaFirmwareDO> getOtaFirmwarePage(@Valid IotOtaFirmwarePageReqVO pageReqVO);

    /**
     * 验证 OTA 固件是否存在
     *
     * @param id  固件编号
     * @return 固件信息
     */
    IotOtaFirmwareDO validateFirmwareExists(Long id);

}