wechatbot

type BaseInfo struct {
	ChannelVersion string `json:"channel_version"`
}

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

type CDNMedia struct {
	EncryptQueryParam string `json:"encrypt_query_param"`
	AESKey            string `json:"aes_key"`
	EncryptType       int    `json:"encrypt_type,omitempty"`
	// FullURL is the complete download URL returned by server; when set, use directly.
	FullURL string `json:"full_url,omitempty"`
}

type CommandFunc func(ctx context.Context, msg *IncomingMessage, args string) bool

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

type ContentType string

type Credentials struct {
	Token     string `json:"token"`
	BaseURL   string `json:"baseUrl"`
	AccountID string `json:"accountId"`
	UserID    string `json:"userId"`
	SavedAt   string `json:"savedAt,omitempty"`
}

type DownloadedMedia struct {
	Data     []byte
	Type     string // "image", "file", "video", "voice"
	FileName string
	Format   string // "silk" for voice
}

type FileContent struct {
	Media    *CDNMedia
	FileName string
	MD5      string
	Size     int64
}

type FileItem struct {
	Media    *CDNMedia `json:"media,omitempty"`
	FileName string    `json:"file_name,omitempty"`
	MD5      string    `json:"md5,omitempty"`
	Len      string    `json:"len,omitempty"`
}

type HookFunc[T any] func(payload T) error

type HookRegistry[T any] struct {
	// contains filtered or unexported fields
}

type ImageContent struct {
	Media      *CDNMedia
	ThumbMedia *CDNMedia
	AESKey     string
	URL        string
	Width      int
	Height     int
}

type ImageItem struct {
	Media       *CDNMedia `json:"media,omitempty"`
	ThumbMedia  *CDNMedia `json:"thumb_media,omitempty"`
	AESKey      string    `json:"aeskey,omitempty"`
	URL         string    `json:"url,omitempty"`
	MidSize     int64     `json:"mid_size,omitempty"`
	ThumbSize   int64     `json:"thumb_size,omitempty"`
	ThumbWidth  int       `json:"thumb_width,omitempty"`
	ThumbHeight int       `json:"thumb_height,omitempty"`
	HDSize      int64     `json:"hd_size,omitempty"`
}

type IncomingMessage struct {
	UserID        string
	Text          string
	Type          ContentType
	Timestamp     time.Time
	Images        []ImageContent
	Voices        []VoiceContent
	Files         []FileContent
	Videos        []VideoContent
	QuotedMessage *QuotedMessage
	Raw           *WireMessage
	ContextToken  string // internal, managed by SDK
}

type LifecycleHooks struct {
	// BeforeLogin runs after QR/login starts but before credentials are finalized.
	BeforeLogin HookRegistry[*Credentials]
	// AfterLogin runs after credentials are loaded or created.
	AfterLogin HookRegistry[*Credentials]
	// OnError runs when the bot encounters a non-fatal runtime error.
	OnError HookRegistry[error]
	// BeforeSend runs before a message is sent; mutate payload to change content.
	BeforeSend HookRegistry[*SendContent]
	// AfterReceive runs after a message is parsed and before handlers run.
	AfterReceive HookRegistry[*IncomingMessage]
}

type MediaType int

type MessageHandler func(msg *IncomingMessage)

type MessageItem struct {
	Type      MessageItemType `json:"type"`
	TextItem  *TextItem       `json:"text_item,omitempty"`
	ImageItem *ImageItem      `json:"image_item,omitempty"`
	VoiceItem *VoiceItem      `json:"voice_item,omitempty"`
	FileItem  *FileItem       `json:"file_item,omitempty"`
	VideoItem *VideoItem      `json:"video_item,omitempty"`
	RefMsg    *RefMessage     `json:"ref_msg,omitempty"`
}

type MessageItemType int

type MessageState int

type MessageType int

type Middleware func(msg *IncomingMessage) bool

type Options struct {
	BaseURL          string
	AccountID        string // optional account identifier for multi-bot isolation
	CredPath         string
	ContextTokenPath string
	CursorPath       string
	BotAgent         string // UA-style, e.g. "MyBot/1.2.0"
	RouteTag         string // sent as SKRouteTag header
	StripMarkdown    bool   // strip markdown from outbound text
	NotifyErrors     bool   // automatically notify user on send failure
	LogLevel         string // "debug", "info", "warn", "error", "silent"
	Logger           *botlog.Logger
	OnQRURL          func(url string)
	OnScanned        func()
	OnExpired        func()
	OnVerifyCode     func() (string, error)
	OnError          func(err error)
}

type QuotedMessage struct {
	Title string
	Text  string
	Type  ContentType
}

type RefMessage struct {
	Title       string       `json:"title,omitempty"`
	MessageItem *MessageItem `json:"message_item,omitempty"`
}

type SendContent struct {
	Text     string
	Image    []byte
	Video    []byte
	File     []byte
	FileName string
	Caption  string
	ImageURL string
	VideoURL string
	FileURL  string
}

type TextItem struct {
	Text string `json:"text"`
}

type UploadResult struct {
	Media             CDNMedia
	ThumbMedia        CDNMedia
	AESKey            []byte
	EncryptedFileSize int
}

type VideoContent struct {
	Media      *CDNMedia
	ThumbMedia *CDNMedia
	DurationMs int
	Width      int
	Height     int
}

type VideoItem struct {
	Media      *CDNMedia `json:"media,omitempty"`
	VideoSize  int64     `json:"video_size,omitempty"`
	PlayLength int       `json:"play_length,omitempty"`
	ThumbMedia *CDNMedia `json:"thumb_media,omitempty"`
}

type VoiceContent struct {
	Media      *CDNMedia
	Text       string
	DurationMs int
	EncodeType int
}

type VoiceItem struct {
	Media      *CDNMedia `json:"media,omitempty"`
	EncodeType int       `json:"encode_type,omitempty"`
	Text       string    `json:"text,omitempty"`
	Playtime   int       `json:"playtime,omitempty"`
}

type WireMessage struct {
	Seq          int64         `json:"seq,omitempty"`
	MessageID    int64         `json:"message_id,omitempty"`
	FromUserID   string        `json:"from_user_id"`
	ToUserID     string        `json:"to_user_id"`
	ClientID     string        `json:"client_id"`
	CreateTimeMs int64         `json:"create_time_ms"`
	MessageType  MessageType   `json:"message_type"`
	MessageState MessageState  `json:"message_state"`
	ContextToken string        `json:"context_token"`
	ItemList     []MessageItem `json:"item_list"`
}