onebot_v11 0.1.5

use crate::{event::message::Anonymous, traits::EndPoint, MessageSegment};
use onebot_v11_macro::{endpoint, ApiDataDerive};
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, PartialEq, Eq, ApiDataDerive)]
pub enum ApiPayload {
    /// 发送私聊消息
    SendPrivateMsg(SendPrivateMsg),
    /// 发送群消息
    SendGroupMsg(SendGroupMsg),
    /// 发送消息
    SendMsg(SendMsg),
    /// 撤回消息
    DeleteMsg(DeleteMsg),
    /// 获取消息
    GetMsg(GetMsg),
    /// 获取合并转发消息
    GetForwardMsg(GetForwardMsg),
    /// 发送好友赞
    SendLike(SendLike),
    /// 群组踢人
    SetGroupKick(SetGroupKick),
    /// 群组禁言
    SetGroupBan(SetGroupBan),
    /// 群组匿名用户禁言
    SetGroupAnonymousBan(SetGroupAnonymousBan),
    /// 群组全员禁言
    SetGroupWholeBan(SetGroupWholeBan),
    /// 群组设置管理员
    SetGroupAdmin(SetGroupAdmin),
    /// 群组匿名
    SetGroupAnonymous(SetGroupAnonymous),
    /// 设置群名片（群备注）
    SetGroupCard(SetGroupCard),
    /// 设置群名
    SetGroupName(SetGroupName),
    /// 退出群组
    SetGroupLeave(SetGroupLeave),
    /// 设置群组专属头衔
    SetGroupSpecialTitle(SetGroupSpecialTitle),
    /// 处理加好友请求
    SetFriendAddRequest(SetFriendAddRequest),
    /// 处理加群请求／邀请
    SetGroupAddRequest(SetGroupAddRequest),
    /// 获取登录号信息
    GetLoginInfo(GetLoginInfo),
    /// 获取陌生人信息
    GetStrangerInfo(GetStrangerInfo),
    /// 获取好友列表
    GetFriendList(GetFriendList),
    /// 获取群信息
    GetGroupInfo(GetGroupInfo),
    /// 获取群列表
    GetGroupList(GetGroupList),
    /// 获取群成员信息
    GetGroupMemberInfo(GetGroupMemberInfo),
    /// 获取群成员列表
    GetGroupMemberList(GetGroupMemberList),
    /// 获取群荣誉信息
    GetGroupHonorInfo(GetGroupHonorInfo),
    /// 获取 Cookies
    GetCookies(GetCookies),
    /// 获取 CSRF Token
    GetCsrfToken(GetCsrfToken),
    /// 获取 QQ 相关接口凭证
    GetCredentials(GetCredentials),
    /// 获取语音
    GetRecord(GetRecord),
    /// 获取图片
    GetImage(GetImage),
    /// 检查是否可以发送图片
    CanSendImage(CanSendImage),
    /// 检查是否可以发送语音
    CanSendRecord(CanSendRecord),
    /// 获取运行状态
    GetStatus(GetStatus),
    /// 获取版本信息
    GetVersionInfo(GetVersionInfo),
    /// 重启 OneBot 实现
    SetRestart(SetRestart),
    /// 清理 OneBot 实现缓存
    CleanCache(CleanCache),

    // NapCat / llOneBot扩展
    /// 设置头像
    SetQQAvatar(SetQQAvatar),
    /// 获取群系统通知
    GetGroupSystemMsg(GetGroupSystemMsg),
    /// 下载群文件或私聊文件
    GetFile(GetFile),
    /// 转发单条消息给好友
    ForwardFriendSingleMsg(ForwardFriendSingleMsg),
    /// 转发单条消息给群
    ForwardGroupSingleMsg(ForwardGroupSingleMsg),
    /// 设置表情回应
    SetMsgEmojiLike(SetMsgEmojiLike),
    /// 标记私聊消息为已读
    MarkPrivateMsgAsRead(MarkPrivateMsgAsRead),
    /// 标记群消息为已读
    MarkGroupMsgAsRead(MarkGroupMsgAsRead),
    /// 获取官方bot qq号范围
    GetRobotUinRange(GetRobotUinRange),
    /// 设置自身在线状态
    SetOnlineStatus(SetOnlineStatus),
    /// 获取好友分类列表
    GetFriendsWithCategory(GetFriendsWithCategory),
    /// 获取群文件数量
    GetGroupFileCount(GetGroupFileCount),
    /// 获取群文件列表
    GetGroupFileList(GetGroupFileList),
    /// 创建群文件夹
    SetGroupFileFolder(SetGroupFileFolder),
    /// 删除群文件
    DelGroupFile(DelGroupFile),
    /// 删除群文件夹
    DelGroupFileFolder(DelGroupFileFolder),

    /// NapCat / GoCq 拓展
    /// 合并转发消息给群聊
    SendGroupForwardMsg(SendGroupForwardMsg),
    /// 合并转发消息给好友
    SendPrivateForwardMsg(SendPrivateForwardMsg),
}

/// 发送私聊消息结构体
#[endpoint("send_private_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SendPrivateMsg {
    /// 对方 QQ 号
    pub user_id: i64,
    /// 要发送的内容
    pub message: Vec<MessageSegment>,
    /// 消息内容是否作为纯文本发送（即不解析 CQ 码），只在 message 字段是字符串时有效
    pub auto_escape: bool,
}

/// 发送群消息结构体
#[endpoint("send_group_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SendGroupMsg {
    /// 群号
    pub group_id: i64,
    /// 要发送的消息内容
    pub message: Vec<MessageSegment>,
    /// 消息内容是否作为纯文本发送（不解析 CQ 码）
    pub auto_escape: bool,
}

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub enum MessageType {
    #[serde(rename = "private")]
    Private,
    #[serde(rename = "group")]
    Group,
}

/// 发送消息结构体
#[endpoint("send_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SendMsg {
    /// 消息类型（private 或 group）
    pub message_type: MessageType,
    /// 对方 QQ 号（私聊时需要）
    pub user_id: Option<i64>,
    /// 群号（群聊时需要）
    pub group_id: Option<i64>,
    /// 要发送的消息内容
    pub message: Vec<MessageSegment>,
    /// 消息内容是否作为纯文本发送（不解析 CQ 码）
    pub auto_escape: bool,
}

/// 撤回消息结构体
#[endpoint("delete_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct DeleteMsg {
    /// 消息 ID
    pub message_id: i64,
}

/// 获取消息结构体
#[endpoint("get_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetMsg {
    /// 消息 ID
    pub message_id: i64,
}

/// 获取合并转发消息结构体
#[endpoint("get_forward_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetForwardMsg {
    /// 合并转发 ID
    pub id: String,
}

/// 发送好友赞结构体
#[endpoint("send_like")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SendLike {
    /// 对方 QQ 号
    pub user_id: i64,
    /// 赞的次数，每个好友每天最多 10 次
    pub times: i64,
}

/// 群组踢人结构体
#[endpoint("set_group_kick")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupKick {
    /// 群号
    pub group_id: i64,
    /// 要踢的 QQ 号
    pub user_id: i64,
    /// 拒绝此人的加群请求
    pub reject_add_request: bool,
}

/// 群组单人禁言结构体
#[endpoint("set_group_ban")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupBan {
    /// 群号
    pub group_id: i64,
    /// 要禁言的 QQ 号
    pub user_id: i64,
    /// 禁言时长，单位秒，0 表示取消禁言
    pub duration: i64,
}

/// 群组匿名用户禁言结构体
#[endpoint("set_group_anonymous_ban")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupAnonymousBan {
    /// 群号
    pub group_id: i64,
    /// 可选，要禁言的匿名用户对象
    pub anonymous: Option<Anonymous>,
    /// 可选，要禁言的匿名用户的 flag
    pub anonymous_flag: Option<String>,
    /// 禁言时长，单位秒，无法取消匿名用户禁言
    pub duration: i64,
}

/// 群组全员禁言结构体
#[endpoint("set_group_whole_ban")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupWholeBan {
    /// 群号
    pub group_id: i64,
    /// 是否禁言
    pub enable: bool,
}

/// 群组设置管理员结构体
#[endpoint("set_group_admin")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupAdmin {
    /// 群号
    pub group_id: i64,
    /// 要设置管理员的 QQ 号
    pub user_id: i64,
    /// true 为设置，false 为取消
    pub enable: bool,
}

/// 群组匿名结构体
#[endpoint("set_group_anonymous")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupAnonymous {
    /// 群号
    pub group_id: i64,
    /// 是否允许匿名聊天
    pub enable: bool,
}

/// 设置群名片（群备注）结构体
#[endpoint("set_group_card")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupCard {
    /// 群号
    pub group_id: i64,
    /// 要设置的 QQ 号
    pub user_id: i64,
    /// 群名片内容，不填或空字符串表示删除群名片
    pub card: String,
}

/// 设置群名结构体
#[endpoint("set_group_name")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupName {
    /// 群号
    pub group_id: i64,
    /// 新群名
    pub group_name: String,
}

/// 退出群组结构体
#[endpoint("set_group_leave")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupLeave {
    /// 群号
    pub group_id: i64,
    /// 是否解散，如果登录号是群主，则仅在此项为 true 时能够解散
    pub is_dismiss: bool,
}

/// 设置群组专属头衔结构体
#[endpoint("set_group_special_title")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupSpecialTitle {
    /// 群号
    pub group_id: i64,
    /// 要设置的 QQ 号
    pub user_id: i64,
    /// 专属头衔，不填或空字符串表示删除专属头衔
    pub special_title: String,
    /// 专属头衔有效期，单位秒，-1 表示永久，此项似乎没有效果，有待测试
    pub duration: i64,
}

/// 处理加好友请求结构体
#[endpoint("set_friend_add_request")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetFriendAddRequest {
    /// 加好友请求的 flag
    pub flag: String,
    /// 是否同意请求
    pub approve: bool,
    /// 添加后的好友备注（仅在同意时有效）
    #[serde(skip_serializing_if = "Option::is_none")]
    pub remark: Option<String>,
}

/// 处理加群请求／邀请结构体
#[endpoint("    set_group_add_request")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupAddRequest {
    /// 加群请求的 flag
    pub flag: String,
    /// 请求类型（add 或 invite）
    pub sub_type: String,
    /// 是否同意请求／邀请
    pub approve: bool,
    /// 拒绝理由（仅在拒绝时有效）
    #[serde(skip_serializing_if = "Option::is_none")]
    pub reason: Option<String>,
}

/// 获取登录号信息结构体
#[endpoint("get_login_info")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetLoginInfo {}

/// 获取陌生人信息结构体
#[endpoint("get_stranger_info")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetStrangerInfo {
    /// QQ 号
    pub user_id: i64,
    /// 是否不使用缓存
    pub no_cache: bool,
}

/// 获取好友列表结构体
#[endpoint("get_friend_list")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetFriendList {}

/// 获取群信息结构体
#[endpoint("get_group_info")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupInfo {
    /// 群号
    pub group_id: i64,
    /// 是否不使用缓存
    pub no_cache: bool,
}

/// 获取群列表结构体
#[endpoint("get_group_list")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupList {}

/// 获取群成员信息结构体
#[endpoint("get_group_member_info")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupMemberInfo {
    /// 群号
    pub group_id: i64,
    /// QQ 号
    pub user_id: i64,
    /// 是否不使用缓存
    pub no_cache: bool,
}

/// 获取群成员列表结构体
#[endpoint("get_group_member_list")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupMemberList {
    /// 群号
    pub group_id: i64,
}

/// 获取群荣誉信息结构体
#[endpoint("get_group_honor_info")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupHonorInfo {
    /// 群号
    pub group_id: i64,
    /// 要获取的群荣誉类型
    #[serde(rename = "type")]
    pub honor_type: String,
}

/// 获取 Cookies 结构体
#[endpoint("get_cookies")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetCookies {
    /// 需要获取 cookies 的域名
    pub domain: String,
}

/// 获取 CSRF Token 结构体
#[endpoint("get_csrf_token")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetCsrfToken {}

/// 获取 QQ 相关接口凭证结构体
#[endpoint("get_credentials")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetCredentials {
    /// 需要获取 cookies 的域名
    pub domain: String,
}

/// 获取语音结构体
#[endpoint("get_record")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetRecord {
    /// 收到的语音文件名
    pub file: String,
    /// 要转换到的格式
    pub out_format: String,
}

/// 获取图片结构体
#[endpoint("get_image")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetImage {
    /// 收到的图片文件名
    pub file: String,
}

/// 检查是否可以发送图片结构体
#[endpoint("can_send_image")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct CanSendImage {}

/// 检查是否可以发送语音结构体
#[endpoint("can_send_record")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct CanSendRecord {}

/// 获取运行状态结构体
#[endpoint("get_status")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetStatus {}

/// 获取版本信息结构体
#[endpoint("get_version_info")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetVersionInfo {}

/// 重启 OneBot 实现结构体
#[endpoint("set_restart")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetRestart {
    /// 要延迟的毫秒数
    pub delay: i64,
}

/// 清理缓存结构体
#[endpoint("clean_cache")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct CleanCache {}

// NapCat / llOneBot扩展

/// 设置头像✔
#[endpoint("set_qq_avatar")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetQQAvatar {
    /// 图片路径/链接/base64
    pub file: String,
}

/// 获取群系统通知✔
#[endpoint("get_group_system_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupSystemMsg {
    /// 群号
    pub group_id: i64,
}

/// 下载群文件或私聊文件
#[endpoint("get_file")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetFile {
    /// 文件 ID
    pub file_id: String,
}

/// 转发单条消息给好友✔
#[endpoint("forward_friend_single_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct ForwardFriendSingleMsg {
    /// 对方 QQ 号
    pub user_id: i64,
    /// 消息 ID
    pub message_id: i64,
}

/// 转发单条消息给群✔
#[endpoint("forward_group_single_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct ForwardGroupSingleMsg {
    /// 群号
    pub group_id: i64,
    /// 消息 ID
    pub message_id: i64,
}

/// 设置表情回应✔
#[endpoint("set_msg_emoji_like")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetMsgEmojiLike {
    /// 消息 ID
    pub message_id: String,
    /// 表情 ID
    /// 参考 https://bot.q.qq.com/wiki/develop/api-v2/openapi/emoji/model.html#EmojiType
    pub emoji_id: String,
}

/// 设置私聊消息已读✔
#[endpoint("mark_private_msg_as_read")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct MarkPrivateMsgAsRead {
    /// 对方 QQ 号
    pub user_id: i64,
}

/// 设置群消息已读✔
#[endpoint("mark_group_msg_as_read")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct MarkGroupMsgAsRead {
    /// 群号
    pub group_id: i64,
}

/// 获取官方bot qq号范围✔
#[endpoint("get_robot_uin_range")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetRobotUinRange {}

/// 设置自身在线状态✔
/// 参考: https://napneko.github.io/zh-CN/develop/status_list
#[endpoint("set_online_status")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetOnlineStatus {
    /// 在线状态
    pub status: u32,
    // 扩展在线状态
    #[serde(rename = "extStatus")]
    pub ext_status: u32,
    /// 电量状态
    #[serde(rename = "batteryStatus")]
    pub battery_status: u32,
}

/// 获取好友分类列表(untested)
#[endpoint("get_friends_with_category")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetFriendsWithCategory {}

/// 获取群文件数量✔
#[endpoint("get_group_file_count")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupFileCount {
    // 群号
    pub group_id: i64,
}

/// 获取群文件列表✔
#[endpoint("get_group_file_list")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct GetGroupFileList {
    /// 群号
    pub group_id: i64,
    /// 起始文件序号
    pub start_index: i64,
    /// 获取的文件数量
    pub file_count: i64,
}

/// 创建群文件夹✔
#[endpoint("set_group_file_folder")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SetGroupFileFolder {
    /// 群号
    pub group_id: i64,
    /// 文件夹名称
    pub folder_name: String,
}

/// 删除群文件✔
#[endpoint("del_group_file")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct DelGroupFile {
    /// 群号
    pub group_id: i64,
    /// 文件 ID
    pub file_id: String,
}

/// 删除群文件夹✔
#[endpoint("del_group_file_folder")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct DelGroupFileFolder {
    /// 群号
    pub group_id: i64,
    /// 文件夹 ID
    pub folder_id: String,
}

// NapCat GoCq 拓展

/// 合并转发消息给群聊
#[endpoint("send_group_forward_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SendGroupForwardMsg {
    /// 群号
    pub group_id: i64,
    /// 要发送的消息内容
    pub messages: Vec<MessageSegment>,
}

/// 合并转发消息给好友
#[endpoint("send_private_forward_msg")]
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq)]
pub struct SendPrivateForwardMsg {
    /// 对方 QQ 号
    pub user_id: i64,
    /// 要发送的消息内容
    pub messages: Vec<MessageSegment>,
}