handler

type AddFriendInviteRequest struct {
	// UserID 目标用户ID
	UserID int64 `json:"user_id" binding:"required" min:"1" example:"1"`

	// Note 添加好友时,给对方看的备注
	Note string `json:"note" example:"你好,我是Jerbe"`
}

type AddGroupMemberRequest struct {
	// GroupID 群ID
	GroupID int64 `json:"group_id" binding:"required" example:"1098"`

	// UserIDs 被邀请加入的用户ID列表
	UserIDs []int64 `json:"user_ids" binding:"required"  example:"1,2,3,4"`
}

type AddGroupMemberResponse struct {
	// Count 成功加入群的成员数量
	Count int64 `json:"count" binding:"required" example:"22"`
}

type AuthLoginRequest struct {
	// Username 账户名
	Username string `json:"username" binding:"required" example:"admin"`

	// Password 密码
	Password string `json:"password" binding:"required" example:"password"`
}

type AuthLoginResponse struct {
	// Token 认证Token
	Token string `` /* 163-byte string literal not displayed */

	// ExpiresAt 到期时间
	ExpiresAt int64 `json:"expires_at" binding:"required" example:"1725249106"`
}

type AuthRegisterRequest struct {
	// Username 账户名
	Username string `json:"username" binding:"required" example:"admin"`

	// Password 密码
	Password string `json:"password" binding:"required" minLength:"8" example:"password"`

	// ConfirmPassword 确认密码
	ConfirmPassword string `json:"confirm_password" binding:"required" minLength:"8" example:"password"`

	// BirthDate 生辰八字
	BirthDate string `json:"birth_date,omitempty" minLength:"8" example:"2016-01-02"`

	// Nickname 昵称
	Nickname string `json:"nickname,omitempty"  minLength:"2" example:"昵称"`
}

type AuthRegisterResponse struct {
	// UserID 用户ID
	UserID *int64 `json:"user_id" binding:"required" example:"10086"`

	// Username 账户名
	Username string `json:"username" binding:"required" example:"admin"`

	// Nickname 昵称
	Nickname string `json:"nickname" binding:"required" example:"the king"`

	// BirthDate 生辰八字
	BirthDate string `form:"birth_date" binding:"required" example:"2016-01-02"`

	// Avatar 头像地址
	Avatar string `json:"avatar" binding:"required" example:"https://www.baidu.com/logo.png"`
}

type ChatMessageBody struct {
	// 文本信息。适用消息类型: 1
	Text string `json:"text,omitempty" example:"这是一条聊天文案"`

	// 来源地址。通用字段，适用消息类型: 2,3,4
	Src string `json:"src,omitempty" example:"https://www.baidu.com/logo.png"`

	// 文件格式。适用消息类型: 2,3,4
	Format string `json:"format,omitempty" example:"jpeg"`

	// 文件大小。适用消息类型: 2,3,4
	Size string `json:"size,omitempty" example:"1234567890"`

	// 位置信息-经度。 适用消息类型: 5
	Longitude string `json:"longitude,omitempty" example:"0.213124212313"`

	// 位置信息-纬度。 适用消息类型: 5
	Latitude string `json:"latitude,omitempty" example:"0.913124212313"`

	// 位置信息-地图缩放级别。 适用消息类型: 5
	Scale float64 `json:"scale,omitempty" example:"0.22"`

	// 位置信息标签。适用消息类型: 5
	LocationLabel string `json:"location_label,omitempty" example:"成人影视学院"`
}

type CreateGroupRequest struct {
	// MemberIDs 其他成员的用户ID
	MemberIDs []int64 `json:"member_ids" binding:"required" minLength:"1" maxLength:"50" example:"1,2,3,4"`
}

type CreateGroupResponse struct {
	// GroupID 群ID
	GroupID int64 `json:"group_id" binding:"required" example:"1098"`

	// GroupName 群名称
	GroupName string `json:"group_name"  binding:"required" example:"群聊1098"`
}

type FindFriendRequest struct {
	// UserID 用户ID
	UserID *int64 `json:"user_id"  example:"1"`

	// Nickname 昵称
	Nickname *string `json:"nickname" example:"昵称"`

	// StartID 开始搜索ID,下次搜索用上返回的最大ID
	StartID *int64 `json:"start_id" example:"0"`
}

type FindFriendResponse struct {
	Users []*User `json:"users" `
}

type JoinGroupRequest struct {
	// GroupID 群ID
	GroupID int64 `json:"group_id" binding:"required" example:"1098"`
}

type LeaveGroupRequest struct {
	// GroupID 群ID
	GroupID int64 `json:"group_id" binding:"required" example:"1098"`
}

type ProfileInfoResponse struct {
	Username     string `json:"username"`
	BirthDate    string `json:"birth_date" `
	Avatar       string `json:"avatar"`
	OnlineStatus int    `json:"online_status"`
}

type RemoveGroupMemberRequest struct {
	// GroupID 群ID
	GroupID int64 `json:"group_id" binding:"required" min:"1" example:"1"`

	// UserIDs 当UserIDs为空时,表示主动当前用户退出群组,当不为空是表示将他人提出群组
	UserIDs []int64 `json:"user_ids" binding:"required" example:"1,2,3,4"`
}

type RemoveGroupMemberResponse struct {
	// Count 成功移除成员数量
	Count int64 `json:"count" binding:"required" example:"22"`
}

type Response struct {
	Status int    `json:"status" binding:"required" example:"1"`
	Error  string `json:"error,omitempty" example:"系统内部错误"`
	Data   any    `json:"data,omitempty" `
}

type SendChatMessageRequest struct {
	// ActionID 行为ID,由前端生成
	ActionID string `json:"action_id" example:"8d7a3bcd72"`

	// ReceiverID 接收人; 可以是用户ID,也可以是群号
	ReceiverID int64 `json:"receiver_id" binding:"required" example:"1234"`

	// SessionType 会话类型; 1:私聊, 2:群聊
	SessionType int `json:"session_type" binding:"required" enums:"1,2" example:"1"`

	// Type 消息类型: 1-纯文本,2-图片,3-语音,4-视频, 5-位置
	Type int `json:"type" enums:"1,2,3,4,5" binding:"required" example:"1"`

	// Body 消息体;
	Body ChatMessageBody `json:"body" binding:"required"`
}

type SendChatMessageResponse struct {
	// 发送人ID
	SenderID int64 `json:"sender_id" binding:"required" example:"1234456"`

	// MessageID 消息ID
	MessageID int64 `json:"message_id" binding:"required" example:"123"`

	// CreatedAt 创建
	CreatedAt int64 `json:"created_at" binding:"required" example:"12345678901234"`

	SendChatMessageRequest
}

type UpdateFriendInviteRequest struct {
	// ID 邀请记录ID号
	ID int64 `json:"id" binding:"required" min:"1" example:"1"`

	// Status 设置状态
	// 1-确认加为好友关系,2-拒绝加为好友
	Status int `json:"status" binding:"required" enums:"1,2" example:"1"`

	// Reply 回复信息
	// status:1 为打招呼
	// status:2 为拒绝理由
	Reply string `json:"reply" example:"我拒绝"`
}

type UpdateFriendRequest struct {
	// UserID 对方的用户ID
	UserID int64 `json:"user_id" binding:"required" min:"1" example:"1"`

	// Status 好友状态, 0-删除对方
	Status *int `json:"status" enums:"0" example:"0"`

	// BlockStatus 黑名单状态, 0-把对方加入黑名单, 1-将对方从黑名单中移除
	BlockStatus *int `json:"block_status" enums:"0" example:"1"`

	// Remark 备注
	Remark *string `json:"remark" example:"这个是我基友"`
}

type UpdateGroupMemberRequest struct {
	// GroupID 群ID
	GroupID int64 `json:"group_id" binding:"required" example:"1098"`

	// UserID 成员用户ID
	UserID int64 `json:"user_id" binding:"required" example:"45"`

	// Role 角色, 只能群主才可操作
	Role *int `json:"role,omitempty" enums:"0,2" example:"0"`

	// SpeakStatus 发言权限, 管理者以上都可以操作, 管理员不能禁言管理员及以上权限的成员
	SpeakStatus *int `json:"speak_status" enums:"0,1" example:"1"`
}

type UpdateGroupRequest struct {
	// GroupID 群组ID
	GroupID int64 `json:"group_id" binding:"required" example:"1098"`

	// Name 群名称
	Name *string `json:"name,omitempty" minLength:"1" maxLength:"50" example:"昵称"`

	// SpeakStatus 发言状态, 必须为管理员以上级别
	SpeakStatus *int `json:"speak_status,omitempty" enums:"0,1" example:"1"`

	// OwnerID 新群主
	OwnerID *int64 `json:"owner_id,omitempty" example:"1"`
}

type User struct {
	// ID 用户ID
	ID int64 `json:"id" example:"10096"`

	// Username 用户名
	Username string `json:"username,omitempty" example:"admin"`

	// Nickname 用户昵称
	Nickname string `json:"nickname" example:"昵称"`

	// BirthDate 出生日期
	BirthDate *time.Time `json:"birth_date,omitempty" example:"2018-01-02"`

	// Avatar 头像地址
	Avatar string `json:"avatar,omitempty" format:"url" example:"https://www.baidu.com/logo.png"`

	// OnlineStatus 在线状态
	OnlineStatus int `json:"online_status,omitempty" enums:"0,1" example:"1"`
}

type UserClaims struct {
	UserID int64 `json:"user_id"`
	jwt.RegisteredClaims
}

type WebsocketMessageRequest struct {
	Action   string `json:"action"`
	ActionID string `json:"action_id"`
	Data     any    `json:"data"`
}

type WebsocketMessageResponse struct {
	Action   string `json:"action"`
	ActionID string `json:"action_id"`
	Data     any    `json:"data"`
}