wecom

type ActionItem struct {
	Text string `json:"text"` // 操作的描述文案
	Key  string `json:"key"`  // 操作key值
}

type ActionMenu struct {
	Desc       string       `json:"desc"`        // 更多操作界面的描述
	ActionList []ActionItem `json:"action_list"` // 操作列表 [1, 3]
}

type AttachmentPayload struct {
	CallbackID string `json:"callback_id"`
	Actions    []struct {
		Name  string `json:"name"`
		Value string `json:"value"`
		Type  string `json:"type"`
	} `json:"actions"`
}

type Bot struct {
	Sessions *SessionManager
	Crypto   *Crypt
	Pipeline botcore.PipelineInvoker
	Adapter  botcore.Adapter
	Emitter  botcore.Emitter
	Timeout  time.Duration
	// contains filtered or unexported fields
}

type BotOption func(*Bot)

type Button struct {
	Text  string `json:"text"`            // 按钮文案
	Style int    `json:"style,omitempty"` // 按钮样式 1~4
	Key   string `json:"key"`             // 按钮key
}

type CardAction struct {
	Type     int    `json:"type"`               // 跳转类型: 1url, 2小程序
	URL      string `json:"url,omitempty"`      // 跳转url
	AppID    string `json:"appid,omitempty"`    // 小程序appid
	PagePath string `json:"pagepath,omitempty"` // 小程序pagepath
}

type CardImage struct {
	URL         string  `json:"url"`                    // 图片url
	AspectRatio float64 `json:"aspect_ratio,omitempty"` // 宽高比 1.3 ~ 2.25
}

type Checkbox struct {
	QuestionKey string           `json:"question_key"`      // 题目key
	Disable     bool             `json:"disable,omitempty"` // 是否不可选 (更新时有效)
	Mode        int              `json:"mode,omitempty"`    // 模式: 0单选, 1多选
	OptionList  []CheckboxOption `json:"option_list"`       // 选项列表
}

type CheckboxOption struct {
	ID        string `json:"id"`         // 选项id
	Text      string `json:"text"`       // 选项文案
	IsChecked bool   `json:"is_checked"` // 是否默认选中
}

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

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

type EmphasisContent struct {
	Title string `json:"title,omitempty"` // 关键数据内容
	Desc  string `json:"desc,omitempty"`  // 关键数据描述
}

type EncryptedRequest struct {
	Encrypt string `json:"encrypt"`
}

type EncryptedResponse struct {
	Encrypt      string `json:"encrypt"`
	MsgSignature string `json:"msgsignature"`
	Timestamp    string `json:"timestamp"`
	Nonce        string `json:"nonce"`
}

type EventPayload struct {
	EventType         string             `json:"eventtype"`
	EnterChat         *struct{}          `json:"enter_chat,omitempty"`
	TemplateCardEvent *TemplateCardEvent `json:"template_card_event,omitempty"`
	FeedbackEvent     *FeedbackEvent     `json:"feedback_event,omitempty"`
}

type FeedbackEvent struct {
	ID                   string `json:"id"`                               // 反馈ID
	Type                 int    `json:"type"`                             // 1:准确, 2:不准确, 3:取消
	Content              string `json:"content,omitempty"`                // 反馈内容
	InaccurateReasonList []int  `json:"inaccurate_reason_list,omitempty"` // 负反馈原因
}

type FeedbackInfo struct {
	ID string `json:"id,omitempty"` // 反馈ID
}

type FilePayload struct {
	URL string `json:"url"` // 文件下载地址
}

type HorizontalContent struct {
	Type    int    `json:"type,omitempty"`   // 链接类型: 0普通文本, 1跳转url, 3点击跳转成员详情
	KeyName string `json:"keyname"`          // 二级标题
	Value   string `json:"value,omitempty"`  // 二级文本
	URL     string `json:"url,omitempty"`    // 跳转url
	UserID  string `json:"userid,omitempty"` // 成员详情userid
}

type ImagePayload struct {
	URL    string `json:"url,omitempty"`    // 图片访问地址
	Base64 string `json:"base64,omitempty"` // 流式回复时使用
	MD5    string `json:"md5,omitempty"`    // 流式回复时使用
}

type ImageTextArea struct {
	Type     int    `json:"type,omitempty"`     // 点击事件: 0无, 1url, 2小程序
	URL      string `json:"url,omitempty"`      // 跳转url
	AppID    string `json:"appid,omitempty"`    // 小程序appid
	PagePath string `json:"pagepath,omitempty"` // 小程序pagepath
	Title    string `json:"title,omitempty"`    // 标题
	Desc     string `json:"desc,omitempty"`     // 描述
	ImageURL string `json:"image_url"`          // 图片url
}

type JumpAction struct {
	Type     int    `json:"type,omitempty"`     // 跳转类型: 0无, 1url, 2小程序, 3触发消息智能回复
	Question string `json:"question,omitempty"` // 智能问答问题 (type=3)
	Title    string `json:"title"`              // 文案内容
	URL      string `json:"url,omitempty"`      // 跳转url
	AppID    string `json:"appid,omitempty"`    // 小程序appid
	PagePath string `json:"pagepath,omitempty"` // 小程序pagepath
}

type MainTitle struct {
	Title string `json:"title,omitempty"` // 一级标题
	Desc  string `json:"desc,omitempty"`  // 标题辅助信息
}

type MarkdownMessage struct {
	MsgType  string          `json:"msgtype"` // markdown
	Markdown MarkdownPayload `json:"markdown"`
}

type MarkdownPayload struct {
	Content  string        `json:"content"`
	Feedback *FeedbackInfo `json:"feedback,omitempty"`
}

type Message struct {
	MsgID       string             `json:"msgid"`                 // 企业微信消息唯一标识
	CreateTime  int64              `json:"create_time,omitempty"` // 消息创建时间
	AIBotID     string             `json:"aibotid"`               // 机器人 ID
	ChatID      string             `json:"chatid"`                // 群或私聊会话 ID
	ChatType    string             `json:"chattype"`              // chat 类型（single/chatroom）
	From        MessageSender      `json:"from"`                  // 触发者信息
	ResponseURL string             `json:"response_url"`          // 异步回复 URL (部分事件有)
	MsgType     string             `json:"msgtype"`               // 消息类型: text, image, voice, file, mixed, stream, event
	Text        *TextPayload       `json:"text,omitempty"`
	Image       *ImagePayload      `json:"image,omitempty"`
	Voice       *VoicePayload      `json:"voice,omitempty"`
	File        *FilePayload       `json:"file,omitempty"`
	Mixed       *MixedPayload      `json:"mixed,omitempty"`
	Stream      *StreamPayload     `json:"stream,omitempty"`
	Quote       *QuotePayload      `json:"quote,omitempty"`
	Event       *EventPayload      `json:"event,omitempty"`
	Attachment  *AttachmentPayload `json:"attachment,omitempty"` // 某些事件可能带附件
}

type MessageAdapter struct{}

type MessageSender struct {
	UserID string `json:"userid"`           // 用户 ID
	CorpID string `json:"corpid,omitempty"` // 企业 ID (事件中可能返回)
}

type MixedItem struct {
	MsgType string        `json:"msgtype"`
	Text    *TextPayload  `json:"text,omitempty"`
	Image   *ImagePayload `json:"image,omitempty"`
}

type MixedPayload struct {
	Items []MixedItem `json:"msg_item"`
}

type OptionIDs struct {
	OptionID []string `json:"option_id"`
}

type QuoteArea struct {
	Type      int    `json:"type,omitempty"`       // 点击事件: 0无, 1跳转url, 2跳转小程序
	URL       string `json:"url,omitempty"`        // 跳转url
	AppID     string `json:"appid,omitempty"`      // 小程序appid
	PagePath  string `json:"pagepath,omitempty"`   // 小程序pagepath
	Title     string `json:"title,omitempty"`      // 标题
	QuoteText string `json:"quote_text,omitempty"` // 引用文案
}

type QuotePayload struct {
	MsgType string        `json:"msgtype"`
	Text    *TextPayload  `json:"text,omitempty"`
	Image   *ImagePayload `json:"image,omitempty"`
	Mixed   *MixedPayload `json:"mixed,omitempty"`
	Voice   *VoicePayload `json:"voice,omitempty"`
	File    *FilePayload  `json:"file,omitempty"`
}

type SelectOption struct {
	ID   string `json:"id"`   // 选项id
	Text string `json:"text"` // 选项文案
}

type SelectedItem struct {
	QuestionKey string     `json:"question_key"`
	OptionIDs   *OptionIDs `json:"option_ids,omitempty"`
}

type SelectedItems struct {
	SelectedItem []SelectedItem `json:"selected_item"`
}

type SelectionItem struct {
	QuestionKey string         `json:"question_key"`          // 题目key
	Title       string         `json:"title,omitempty"`       // 标题
	Disable     bool           `json:"disable,omitempty"`     // 是否不可选 (更新时有效)
	SelectedID  string         `json:"selected_id,omitempty"` // 默认选中id
	OptionList  []SelectOption `json:"option_list"`           // 选项列表
}

type Session struct {
	StreamID   string         // 流式会话唯一标识
	MsgID      string         // 对应企业微信消息 ID
	ChatID     string         // 会话所属聊天 ID
	UserID     string         // 发起用户 ID
	Update     botcore.Update // 标准化事件上下文
	CreatedAt  time.Time      // 创建时间
	LastAccess time.Time      // 最近访问时间

	Finished    bool                 // 会话是否已完成
	LastChunk   *botcore.StreamChunk // 最近一次发送的片段，用于超时兜底
	Accumulated string               // 已累积的完整内容，用于满足企业微信“最新完整内容”语义
	// contains filtered or unexported fields
}

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

type Source struct {
	IconURL   string `json:"icon_url,omitempty"`   // 来源图片的url
	Desc      string `json:"desc,omitempty"`       // 来源图片的描述
	DescColor int    `json:"desc_color,omitempty"` // 来源文字的颜色: 0(默认)灰色, 1黑色, 2红色, 3绿色
}

type StreamEmitter struct{}

type StreamPayload struct {
	ID      string      `json:"id"`
	Finish  bool        `json:"finish,omitempty"`
	Content string      `json:"content,omitempty"`
	MsgItem []MixedItem `json:"msg_item,omitempty"` // 流式结束时支持图文
}

type StreamReply struct {
	MsgType string          `json:"msgtype"`
	Stream  StreamReplyBody `json:"stream"`
}

type StreamReplyBody struct {
	ID      string      `json:"id"`
	Finish  bool        `json:"finish"`
	Content string      `json:"content"`
	MsgItem []MixedItem `json:"msg_item,omitempty"`
}

type StreamWithTemplateCardMessage struct {
	MsgType      string          `json:"msgtype"`
	Stream       StreamReplyBody `json:"stream"`
	TemplateCard *TemplateCard   `json:"template_card"`
}

type SubmitButton struct {
	Text string `json:"text"` // 按钮文案
	Key  string `json:"key"`  // 按钮key
}

type TemplateCard struct {
	CardType              string              `json:"card_type"`                         // 模版类型: text_notice, news_notice, button_interaction, vote_interaction, multiple_interaction
	Source                *Source             `json:"source,omitempty"`                  // 卡片来源样式信息
	ActionMenu            *ActionMenu         `json:"action_menu,omitempty"`             // 卡片右上角更多操作按钮
	MainTitle             *MainTitle          `json:"main_title,omitempty"`              // 一级标题
	EmphasisContent       *EmphasisContent    `json:"emphasis_content,omitempty"`        // 关键数据样式
	QuoteArea             *QuoteArea          `json:"quote_area,omitempty"`              // 引用文献样式
	SubTitleText          string              `json:"sub_title_text,omitempty"`          // 二级普通文本
	VerticalContentList   []VerticalContent   `json:"vertical_content_list,omitempty"`   // 二级垂直内容列表
	HorizontalContentList []HorizontalContent `json:"horizontal_content_list,omitempty"` // 二级标题+文本列表
	JumpList              []JumpAction        `json:"jump_list,omitempty"`               // 跳转指引样式列表
	CardAction            *CardAction         `json:"card_action,omitempty"`             // 整体卡片点击跳转
	TaskID                string              `json:"task_id,omitempty"`                 // 任务id
	CardImage             *CardImage          `json:"card_image,omitempty"`              // 图片样式 (news_notice)
	ImageTextArea         *ImageTextArea      `json:"image_text_area,omitempty"`         // 左图右文样式 (news_notice)
	ButtonSelection       *SelectionItem      `json:"button_selection,omitempty"`        // 下拉式选择器 (button_interaction)
	ButtonList            []Button            `json:"button_list,omitempty"`             // 按钮列表 (button_interaction)
	Checkbox              *Checkbox           `json:"checkbox,omitempty"`                // 选择题样式 (vote_interaction)
	SubmitButton          *SubmitButton       `json:"submit_button,omitempty"`           // 提交按钮 (vote_interaction, multiple_interaction)
	SelectList            []SelectionItem     `json:"select_list,omitempty"`             // 下拉式选择器列表 (multiple_interaction)
	Feedback              *FeedbackInfo       `json:"feedback,omitempty"`                // 反馈信息 (主动回复时使用)
}

type TemplateCardEvent struct {
	CardType      string         `json:"card_type"`                // 模版类型
	EventKey      string         `json:"event_key"`                // 按钮Key
	TaskID        string         `json:"task_id"`                  // 任务ID
	SelectedItems *SelectedItems `json:"selected_items,omitempty"` // 选择结果
}

type TemplateCardMessage struct {
	MsgType      string        `json:"msgtype"`
	TemplateCard *TemplateCard `json:"template_card"`
}

type TextMessage struct {
	MsgType string       `json:"msgtype"`
	Text    *TextPayload `json:"text"`
}

type TextPayload struct {
	Content string `json:"content"` // 文本内容
}

type UpdateTemplateCardMessage struct {
	ResponseType string        `json:"response_type"` // update_template_card
	UserIDs      []string      `json:"userids,omitempty"`
	TemplateCard *TemplateCard `json:"template_card"`
}

type VerticalContent struct {
	Title string `json:"title"`          // 二级标题
	Desc  string `json:"desc,omitempty"` // 二级普通文本
}

type VoicePayload struct {
	Content string `json:"content"` // 语音转文本内容
}