feishu

type App interface {
	GetAppAccessTokenInternal() (AppAccessTokenInternal, error)
	GetAppAccessTokenInternalWithContext(ctx context.Context) (AppAccessTokenInternal, error)
	GetTenantAccessTokenInternal() (TenantAccessTokenInternal, error)
	GetTenantAccessTokenInternalWithContext(ctx context.Context) (TenantAccessTokenInternal, error)

	SendMessage(receiver MessageReceiver, msg *Message) (MessageDetail, error)
	SendMessageWithContext(ctx context.Context, receiver MessageReceiver, msg *Message) (MessageDetail, error)
	ReplyMessage(messageID string, msg *Message) (MessageDetail, error)
	ReplyMessageWithContext(ctx context.Context, messageID string, msg *Message) (MessageDetail, error)

	UploadImage(src UploadImageOption) (imageKey string, err error)
	UploadImageWithContext(ctx context.Context, src UploadImageOption) (imageKey string, err error)

	GetAllGroupChats(opts ...GetAllGroupChatsOption) (GroupChatsResponse, error)
	GetAllGroupChatsWithContext(ctx context.Context, opts ...GetAllGroupChatsOption) (GroupChatsResponse, error)

	ListenEventCallback(w http.ResponseWriter, r *http.Request)
	RegisterEventCallback(eventType EventType, handler EventHandler)
	RegisterEventCallbackV1(eventType EventType, handler EventHandlerV1)
}

type AppAccessTokenInternal struct {
	AppAccessToken string `json:"app_access_token"` // 访问 token
	Expire         int    `json:"expire"`           // app_access_token 过期时间，单位：秒
}

type AppOption func(*app)

type Card func() i18nCard

type CardConfig func() cardConfig

type CardConfigOption func(*cardConfig)

type CardElemImageOption func() (key string, v interface{})

type CardElement func(isEmbedded bool) interface{}

type CardElementAction func() interface{}

type CardElementActionOption func() (key string, v interface{})

type CardElementField func() interface{}

type CardExtraElement func() (key string, v interface{})

type CardTitleBgColor string

type ElementButton string

type EventHandler func(header EventHeaderV2, event json.RawMessage)

type EventHandlerV1 func(header EventHeaderV1, event json.RawMessage)

type EventHeaderV1 struct {
	Timestamp string    `json:"ts,omitempty"`    // 事件发送的时间，一般近似于事件发生的时间
	UUID      string    `json:"uuid,omitempty"`  // 事件的唯一标识
	Token     string    `json:"token,omitempty"` // 即 Verification Token
	Type      EventType `json:"type,omitempty"`  // 事件类型
}

type EventHeaderV2 struct {
	EventID    string    `json:"event_id,omitempty"`    // 事件 ID
	EventType  EventType `json:"event_type,omitempty"`  // 事件类型
	CreateTime string    `json:"create_time,omitempty"` // 事件创建时间戳（单位：毫秒）
	Token      string    `json:"token,omitempty"`       // 事件 Token
	AppID      string    `json:"app_id,omitempty"`      // 应用 ID
	TenantKey  string    `json:"tenant_key,omitempty"`  // 租户 Key
}

type EventMention struct {
	Key       string      `json:"key"`        // mention key
	ID        EventUserID `json:"id"`         // 用户 ID
	Name      string      `json:"name"`       // 用户姓名
	TenantKey string      `json:"tenant_key"` // tenant key
}

type EventMessage struct {
	MessageID   string         `json:"message_id"`   // 消息的 open_message_id
	RootID      string         `json:"root_id"`      // 回复消息 根 id
	ParentID    string         `json:"parent_id"`    // 回复消息 父 id
	CreateTime  string         `json:"create_time"`  // 消息发送时间 毫秒
	ChatID      string         `json:"chat_id"`      // 消息所在的群组 id
	ChatType    string         `json:"chat_type"`    // 消息所在的群组类型，单聊（p2p）或群聊（group）
	MessageType string         `json:"message_type"` // 消息类型
	Content     string         `json:"content"`      // 消息内容, json 格式各类型消息Content
	Mentions    []EventMention `json:"mentions"`     // 被提及用户的信息
}

type EventMessageReceived struct {
	Sender  EventSender  `json:"sender"`  // 事件的发送者
	Message EventMessage `json:"message"` // 事件中包含的消息内容
}

type EventSender struct {
	SenderID   EventSenderID `json:"sender_id"`   // 用户 ID
	SenderType string        `json:"sender_type"` // 消息发送者类型。目前只支持用户(user)发送的消息。
	TenantKey  string        `json:"tenant_key"`  // tenant key
}

type EventSenderID struct {
	UnionID string `json:"union_id"` // 用户的 union id
	UserID  string `json:"user_id"`  // 用户的 user id
	OpenID  string `json:"open_id"`  // 用户的 open id
}

type EventType string

type EventUserID struct {
	UnionID string `json:"union_id"` // 用户的 union id
	UserID  string `json:"user_id"`  // 用户的 user id
	OpenID  string `json:"open_id"`  // 用户的 open id
}

type GetAllGroupChatsOption = doOption

type GroupChat struct {
	ChatID      string `json:"chat_id"`       // 群组 ID
	Avatar      string `json:"avatar"`        // 群头像 URL
	Name        string `json:"name"`          // 群名称
	Description string `json:"description"`   // 群描述
	OwnerID     string `json:"owner_id"`      // 群主 ID (查询参数 user_id_type 将影响该值的类型)
	OwnerIDType string `json:"owner_id_type"` // 群主 ID 类型
	External    bool   `json:"external"`      // 是否是外部群
	TenantKey   string `json:"tenant_key"`    // tenant key
}

type GroupChatsResponse struct {
	Items     []GroupChat `json:"items"`      // chat 列表
	PageToken string      `json:"page_token"` // 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则为空字符串
	HasMore   bool        `json:"has_more"`   // 是否还有更多项
}

type IDType string

type ImageMode string

type Language string

type Logger interface {
	Debug(string)
}

type Mention struct {
	Key       string `json:"key"`        // 被@的用户或机器人的序号。例如，第3个被@到的成员，值为“@_user_3”
	ID        string `json:"id"`         // 被@的用户或者机器人的open_id
	IDType    string `json:"id_type"`    // 被@的用户或机器人 id 类型，目前仅支持 open_id
	Name      string `json:"name"`       // 被@的用户或机器人的姓名
	TenantKey string `json:"tenant_key"` // 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识
}

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

type MessageBody struct {
	// json结构序列化后的字符串。不同msg_type对应不同内容。
	//
	// 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等
	Content string `json:"content"`
}

type MessageDetail struct {
	MessageID      string      `json:"message_id"`       // 消息id
	RootID         string      `json:"root_id"`          // 根消息id
	ParentID       string      `json:"parent_id"`        // 父消息的id
	MsgType        string      `json:"msg_type"`         // 消息类型 包括：text、post、image、file、audio、media、sticker、interactive、share_chat、share_user等
	CreateTime     string      `json:"create_time"`      // 消息生成的时间戳（毫秒）
	UpdateTime     string      `json:"update_time"`      // 消息更新的时间戳（毫秒）
	Deleted        bool        `json:"deleted"`          // 消息是否被撤回
	Updated        bool        `json:"updated"`          // 消息是否被更新
	ChatID         string      `json:"chat_id"`          // 所属的群
	Sender         Sender      `json:"sender"`           // 发送者，可以是用户或应用
	Body           MessageBody `json:"body"`             // 消息内容
	Mentions       []Mention   `json:"mentions"`         // 被@的用户或机器人的id列表
	UpperMessageID string      `json:"upper_message_id"` // 合并转发消息中，上一层级的消息id message_id
}

type MessageReceiver struct {
	IDType IDType // 接收者的 🆔 类型
	ID     string // 接收者 🆔
}

type Post func() i18nPost

type PostElement func() postElement

type Sender struct {
	ID         string `json:"id"`          // 发送者的id
	IDType     string `json:"id_type"`     // 发送者的id类型
	SenderType string `json:"sender_type"` // 发送者的类型
	TenantKey  string `json:"tenant_key"`  // 为租户在飞书上的唯一标识，用来换取对应的tenant_access_token，也可以用作租户在应用里面的唯一标识
}

type TenantAccessTokenInternal struct {
	TenantAccessToken string `json:"tenant_access_token"` // 访问 token
	Expire            int    `json:"expire"`              // token 过期时间，单位: 秒
}

type UploadImageOption = doOption