bot_context

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

type BaseMessage struct {
	MessageType MessageType
	ID          string
	Content     string
	Elements    []*MessageElement
	Sender      *entity.Sender
	Time        time.Time
}

type BotContext interface {
	FeatureProvider
	ID() string
	Name() string
	Protocol() string
	Status() LoginStatus
	NewMessageBuilder() MessageBuilder
	SendDirectMessage(target entity.User, elements []*MessageElement) (*BaseMessage, error)
	SendGroupMessage(target entity.Group, elements []*MessageElement) (*BaseMessage, error)
	Contacts() []entity.User
	Groups() []entity.Group
	DownloadResourceFromRefLink(refLink string) (string, error)
}

type ButtonActionType int

type ElementType int

type Feature string

type FeatureProvider interface {
	// Features 返回当前适配器所支持的所有特性列表
	Features() []Feature
	// SupportsFeature 判断当前适配器是否支持某个特性
	SupportsFeature(feature Feature) bool
}

type InlineKeyboard struct {
	Rows [][]InlineKeyboardButton `json:"rows"`
}

type InlineKeyboardButton struct {
	// Text 按钮显示文本
	Text string `json:"text"`
	// Action 动作类型：ActionURL, ActionCallback, ActionCommand
	Action ButtonActionType `json:"action"`
	// Data 对应动作携带的数据：ActionURL为链接，ActionCallback为回调标识/数据，ActionCommand为待发送文本
	Data string `json:"data"`
	// DirectSend 指令型按钮是否直接发送（仅对支持的平台有效，如 QQ 机器人 enter=true）
	DirectSend bool `json:"direct_send,omitempty"`
	// ID 可选，指定按钮唯一ID（QQ等平台需要时使用，留空则自动生成）
	ID string `json:"id,omitempty"`
}

type LoginStatus int

type MessageBuilder interface {
	Protocol() string
	Text(text string) MessageBuilder
	Markdown(content string) MessageBuilder
	Quote(msg *BaseMessage) MessageBuilder
	Mention(id string) MessageBuilder
	ImageFromFile(path string) MessageBuilder
	ImageFromUrl(url string) MessageBuilder
	ImageFromData(data []byte) MessageBuilder
	InlineKeyboard(kb *InlineKeyboard) MessageBuilder
	ReplyTo(msg MessageContext) (*BaseMessage, error)
	Send(id string) (*BaseMessage, error)
}

type MessageContext interface {
	FeatureProvider
	Protocol() string
	BotContext() BotContext
	String() string
	Message() *BaseMessage
	SenderID() string
	NewMessageBuilder() MessageBuilder
	Reply(elements []*MessageElement) (*BaseMessage, error)
	ReplyText(a ...any) (*BaseMessage, error)
}

type MessageElement struct {
	Type    ElementType
	Content string
	Source  string
}

type MessageType int