message

type ChannelOffsetResp = channelOffsetResp

type ChannelState struct {
	ChannelID   string `json:"channel_id"`
	ChannelType uint8  `json:"channel_type"`
	Calling     int    `json:"calling"` // 是否正在通话
}

type Conversation struct {
	log.Log
	// contains filtered or unexported fields
}

type DB struct {
	// contains filtered or unexported fields
}

type GroupCategorySetting struct {
	GroupNo string
	// CategoryID 是 "live" category id —— 已经过 group_category.status != 2
	// 过滤。NULL 含义统一为"该群当前未分类"，同时覆盖三种数据情况：
	//   (a) group_setting 行不存在 category_id（用户从未分配）；
	//   (b) group_setting.category_id 指向已被软删的 category
	//       （TOCTOU race 残留 / category_cleanup 未跑）；
	//   (c) group_setting.category_id 指向根本不存在的 category（异常残留）。
	// 三种情况下游一律按"未分类"处理 —— sidebar 不展示在 follow tab、
	// 物化路径不写 ext 行、API 不向客户端暴露 dangling id。这是 follow-tab
	// 整套机制（issue #151）依赖的 schema-app 不变量：sidebar 显示 / 物化 /
	// /v1/follow/sort 鉴权三处都按这个语义统一判定，不再有 stale-id 暴露。
	//
	// 实现上 SELECT 必须取 gc.category_id（JOIN 出来的字段），不是 gs.category_id
	// （持久化的 stale 字段）—— 二者只在 JOIN 命中时相等，JOIN miss（status=2 或
	// gc 不存在）时 gc.category_id 自然为 NULL，恰好对应 (b)(c) 两种 dangling 情况。
	CategoryID *string
	// CategorySort 是 group_setting.category_sort —— 类别内排序（v1 兼容字段，
	// v1 API_conversation 直接回显该值，故保留语义不变）。
	CategorySort int `db:"category_sort"`
	// CategoryGroupSort 是 group_category.sort —— 类别之间的排序权重，
	// 对应 swagger v2 sidebar 的 SidebarItem.category_sort 字段。
	CategoryGroupSort int `db:"category_group_sort"`
}

type IService interface {
	// 查询消息拥有者uid的已删除消息
	GetDeletedMessagesWithUID(uid string, messageIDs []string) ([]*messageUserExtraResp, error)
	// 查询消息的撤回消息
	GetRevokedMessages(messageIDs []string) ([]*messageExtraResp, error)
	// 查询消息的删除消息
	GetDeletedMessages(messageIDs []string) ([]*messageExtraResp, error)
	// 查询用户清空channel消息标记
	GetChannelOffsetWithUID(uid string, channelIDs []string) ([]*channelOffsetResp, error)
	// 删除会话
	DeleteConversation(uid string, channelID string, channelType uint8) error
}

type Manager struct {
	log.Log
	// contains filtered or unexported fields
}

type Message struct {
	log.Log
	// contains filtered or unexported fields
}

type MessageExtraResp = messageExtraResp

type MessageUserExtraResp = messageUserExtraResp

type MsgSyncResp struct {
	Header       messageHeader `json:"header"`              // 消息头部
	Setting      uint8         `json:"setting"`             // 设置
	MessageID    int64         `json:"message_id"`          // 服务端的消息ID(全局唯一)
	MessageIDStr string        `json:"message_idstr"`       // 服务端的消息ID(全局唯一)字符串形式
	MessageSeq   uint32        `json:"message_seq"`         // 消息序列号 （用户唯一，有序递增）
	ClientMsgNo  string        `json:"client_msg_no"`       // 客户端消息唯一编号
	StreamNo     string        `json:"stream_no,omitempty"` // 流编号
	FromUID      string        `json:"from_uid"`            // 发送者UID
	// 外部来源标识：仅在 /message/channel/sync 群聊路径填充，供前端在外部群渲染来源 Space 徽标。
	// 详见 Mininglamp-OSS/octo-server#1188。
	FromIsExternal      int    `json:"from_is_external"`                 // 发送者是否为外部成员 0.否 1.是
	FromSourceSpaceName string `json:"from_source_space_name,omitempty"` // 发送者来源 Space 名称（为空则前端不渲染）
	// 归属 Space（YUJ-63 / #1208）：外部/内部语义由前端"相对当前查看 Space"判断。
	// 外部成员：from_home_space_id = 发送者来源 space_id；
	// 内部成员：from_home_space_id = 群自身 space_id。
	// 后端 from_is_external / from_source_space_name 原语义保留。
	FromHomeSpaceID   string                 `json:"from_home_space_id,omitempty"`   // 发送者归属 Space ID
	FromHomeSpaceName string                 `json:"from_home_space_name,omitempty"` // 发送者归属 Space 名称
	ToUID             string                 `json:"to_uid,omitempty"`               // 接受者uid
	ChannelID         string                 `json:"channel_id"`                     // 频道ID
	ChannelType       uint8                  `json:"channel_type"`                   // 频道类型
	Expire            uint32                 `json:"expire,omitempty"`               // expire
	Timestamp         int32                  `json:"timestamp"`                      // 服务器消息时间戳(10位，到秒)
	Payload           map[string]interface{} `json:"payload"`                        // 消息内容
	SignalPayload     string                 `json:"signal_payload"`                 // signal 加密后的payload base64编码,TODO: 这里为了兼容没加密的版本，所以新用SignalPayload字段
	ReplyCount        int                    `json:"reply_count,omitempty"`          // 回复集合
	ReplyCountSeq     string                 `json:"reply_count_seq,omitempty"`      // 回复数量seq
	ReplySeq          string                 `json:"reply_seq,omitempty"`            // 回复seq
	Reactions         []*reactionSimpleResp  `json:"reactions,omitempty"`            // 回应数据
	IsDeleted         int                    `json:"is_deleted"`                     // 是否已删除
	VoiceStatus       int                    `json:"voice_status,omitempty"`         // 语音状态 0.未读 1.已读
	Streams           []*streamItemResp      `json:"streams,omitempty"`              // 流数据
	// ---------- 旧字段 这些字段都放到MessageExtra对象里了 ----------
	Readed       int    `json:"readed"`                 // 是否已读（针对于自己）
	Revoke       int    `json:"revoke,omitempty"`       // 是否撤回
	Revoker      string `json:"revoker,omitempty"`      // 消息撤回者
	ReadedCount  int    `json:"readed_count,omitempty"` // 已读数量
	UnreadCount  int    `json:"unread_count,omitempty"` // 未读数量
	ExtraVersion int64  `json:"extra_version"`          // 扩展数据版本号

	// 消息扩展字段
	MessageExtra *messageExtraResp `json:"message_extra,omitempty"` // 消息扩展

}

type ProhibitWordModel struct {
	Content   string
	IsDeleted int
	Version   int64
	db.BaseModel
}

type ProhibitWordResp struct {
	Id        int64  `json:"id"`
	Content   string `json:"content"`    // 违禁词
	IsDeleted int    `json:"is_deleted"` // 是否删除
	Version   int64  `json:"version"`    // 版本
	CreatedAt string `json:"created_at"` // 时间
}

type ReminderType int

type Service struct {
	log.Log
	// contains filtered or unexported fields
}

type Sidebar struct {
	log.Log
	// contains filtered or unexported fields
}

type SidebarItem struct {
	TargetType  int    `json:"target_type"` // 1 DM / 2 group / 5 thread
	TargetID    string `json:"target_id"`
	ChannelType uint8  `json:"channel_type"`
	ChannelID   string `json:"channel_id"`
	// SpaceID 是该 sidebar 条目所属 Space 的 ID（GH octo-server#153）。
	//   - GROUP: group 表的 space_id；
	//   - COMMUNITY_TOPIC: 父群的 space_id；
	//   - PERSON: 留空 —— DM 的 Space 归属在消息级 payload.space_id 上，
	//     conversation 级别保持空避免误锁定。
	// 客户端 WebSocket 收到群消息时拿这个字段决定渲染到哪个 Space tab，
	// 与服务端 FilterRawConversationsBySpace 的可见性判定同口径。
	SpaceID string `json:"space_id,omitempty"`
	// MySourceSpaceID 是当前用户加入该群的"来源 Space"（外部成员场景）。
	//   - GROUP: externalGroupMap[channelID]，即 group_external_member.source_space_id；
	//   - COMMUNITY_TOPIC: externalGroupMap[parentGroupNo]（与父群保持同口径）；
	//   - 其它（PERSON / 内部群成员）: 留空。
	// 与 v1 SyncUserConversationResp.MySourceSpaceID 字段口径一致
	// （GH octo-server#153 Round-2 P1）。客户端在 source Space 下用 sidebar 时
	// 需要这个字段才能识别"我以哪个 Space 身份加入了这个外部群"。
	MySourceSpaceID string  `json:"my_source_space_id,omitempty"`
	Timestamp       int64   `json:"timestamp"`
	Unread          int     `json:"unread"`
	IsPinned        bool    `json:"is_pinned"`
	IsFollowed      bool    `json:"is_followed"`
	CategoryID      *string `json:"category_id,omitempty"`
	// CategorySort 暴露给客户端的"类别之间排序权重"，来源是 group_category.sort
	// （PR #21 review by lml2468 blocker #3）。改类别顺序会 bump follow_version
	// 并改变这里返回的值，与 /category/sort 接口及 swagger 一致。
	CategorySort int `json:"category_sort,omitempty"`

	FollowSort      int    `json:"follow_sort,omitempty"`
	ParentChannelID string `json:"parent_channel_id,omitempty"` // thread only
	// Status 仅对 thread 条目（target_type=5）有意义：1=active 2=archived
	// 3=deleted，语义与 modules/thread/const.go 的 ThreadStatus* 枚举一致
	// （GH octo-server#310）。客户端据此同步过滤已归档子区，无需等待 channelInfo。
	// omitempty 让 DM / 群条目不带该字段，保持线上协议向后兼容。
	Status int `json:"status,omitempty"`
	// contains filtered or unexported fields
}

type SpaceMembership struct {
	ChannelID       string `json:"channel_id"`                   // 群 channel_id / group_no
	SpaceID         string `json:"space_id"`                     // 群表权威 Space ID
	MySourceSpaceID string `json:"my_source_space_id,omitempty"` // 外部群成员的 source Space ID
}

type SyncUserConversationResp struct {
	ChannelID   string `json:"channel_id"`         // 频道ID
	ChannelType uint8  `json:"channel_type"`       // 频道类型
	SpaceID     string `json:"space_id,omitempty"` // Space ID
	// MySourceSpaceID 仅在 GROUP / COMMUNITY_TOPIC 频道且当前用户以外部成员
	// 身份加入时非空。值取自 group_member.source_space_id，对应"我从哪个
	// Space 加入了这个外部群"。客户端 WebSocket 收到该群实时消息时，可据此
	// 把消息归属到当前 user 的 source Space —— 与服务端
	// FilterConversationsBySpace 对外部群的可见性判定保持同口径，避免
	// 三端 fail-open 把跨 Space 消息渲染到错误的 Space tab (GH#153)。
	MySourceSpaceID  string                 `json:"my_source_space_id,omitempty"` // 外部群成员的 source Space ID
	Thread           *threadMetaResp        `json:"thread,omitempty"`             // 子区元数据（仅 thread 频道）
	CategoryID       *string                `json:"category_id,omitempty"`        // 用户自定义分类ID（仅群组）
	CategorySort     int                    `json:"category_sort,omitempty"`      // 分类内排序（仅群组）
	Unread           int                    `json:"unread,omitempty"`             // 未读消息
	SpaceUnread      *int                   `json:"space_unread,omitempty"`       // Space 维度未读（仅 Person 频道）
	SpaceLastMessage *MsgSyncResp           `json:"space_last_message,omitempty"` // Space 维度最后一条消息（仅 Person 频道）
	Mute             int                    `json:"mute,omitempty"`               // 免打扰
	Stick            int                    `json:"stick,omitempty"`              //  置顶
	Timestamp        int64                  `json:"timestamp"`                    // 最后一次会话时间
	LastMsgSeq       int64                  `json:"last_msg_seq"`                 // 最后一条消息seq
	LastClientMsgNo  string                 `json:"last_client_msg_no"`           // 最后一条客户端消息编号
	OffsetMsgSeq     int64                  `json:"offset_msg_seq"`               // 偏移位的消息seq
	Version          int64                  `json:"version,omitempty"`            // 数据版本
	Recents          []*MsgSyncResp         `json:"recents,omitempty"`            // 最近N条消息
	Extra            *conversationExtraResp `json:"extra,omitempty"`              // 扩展
	BotType          string                 `json:"bot_type,omitempty"`           // Bot 类型（"app_bot" 表示应用 Bot）
}

type SyncUserConversationRespWrap struct {
	UID              string                      `json:"uid"` // 请求者uid
	Conversations    []*SyncUserConversationResp `json:"conversations"`
	Users            []*user.UserDetailResp      `json:"users"`             // 用户详情
	Groups           []*group.GroupResp          `json:"groups"`            // 群
	ChannelStates    []*ChannelState             `json:"channel_status"`    // 频道状态
	SpaceMemberships []SpaceMembership           `json:"space_memberships"` // 用户加入的全部群的 Space 归属
}