telegram

type APIError struct {
	Code        int                 `json:"error_code"`
	Description string              `json:"description"`
	Parameters  *ResponseParameters `json:"parameters,omitempty"`
}

type APIResponse struct {
	Ok          bool                `json:"ok"`
	Result      json.RawMessage     `json:"result,omitempty"`
	Description string              `json:"description,omitempty"`
	ErrorCode   int                 `json:"error_code,omitempty"`
	Parameters  *ResponseParameters `json:"parameters,omitempty"`
}

type Animation struct {
	FileID       string     `json:"file_id"`
	FileUniqueID string     `json:"file_unique_id"`
	Width        int        `json:"width"`
	Height       int        `json:"height"`
	Duration     int        `json:"duration"`
	Thumbnail    *PhotoSize `json:"thumbnail,omitempty"`
	FileName     string     `json:"file_name,omitempty"`
	MimeType     string     `json:"mime_type,omitempty"`
	FileSize     int64      `json:"file_size,omitempty"`
}

type Audio struct {
	FileID       string     `json:"file_id"`
	FileUniqueID string     `json:"file_unique_id"`
	Duration     int        `json:"duration"`
	Performers   string     `json:"performer,omitempty"`
	Title        string     `json:"title,omitempty"`
	FileName     string     `json:"file_name,omitempty"`
	MimeType     string     `json:"mime_type,omitempty"`
	FileSize     int64      `json:"file_size,omitempty"`
	Thumbnail    *PhotoSize `json:"thumbnail,omitempty"`
}

type BotAPI interface {
	SendMessage(ctx context.Context, req SendMessageRequest) (*Message, error)
	SendRichMessage(ctx context.Context, req SendRichMessageRequest) (*Message, error)
	SendRichMessageDraft(ctx context.Context, req SendRichMessageDraftRequest) error
	EditMessageText(ctx context.Context, req EditMessageTextRequest) (*Message, error)
	SendPhoto(ctx context.Context, req SendPhotoRequest) (*Message, error)
	SendDocument(ctx context.Context, req SendDocumentRequest) (*Message, error)
	SendMediaGroup(ctx context.Context, req SendMediaGroupRequest) ([]Message, error)
	SendMediaGroupDocuments(ctx context.Context, req SendMediaGroupDocumentsRequest) ([]Message, error)
	SetMyCommands(ctx context.Context, req SetMyCommandsRequest) error
	SetWebhook(ctx context.Context, req SetWebhookRequest) error
	SendChatAction(ctx context.Context, req SendChatActionRequest) error
	GetFile(ctx context.Context, req GetFileRequest) (*File, error)
	SetMessageReaction(ctx context.Context, req SetMessageReactionRequest) error
	GetUpdates(ctx context.Context, req GetUpdatesRequest) ([]Update, error)
	GetToken() string
}

type BotCommand struct {
	Command     string `json:"command"`
	Description string `json:"description"`
}

type Chat struct {
	ID       int64  `json:"id"`
	Type     string `json:"type"`
	Title    string `json:"title,omitempty"`
	Username string `json:"username,omitempty"`
}

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

type CodeBlock struct {
	Start int
	End   int
}

type DirectMessagesTopic struct {
	TopicID int64 `json:"topic_id"`
}

type Document struct {
	FileID       string `json:"file_id"`
	FileUniqueID string `json:"file_unique_id"`
	FileName     string `json:"file_name,omitempty"`
	MimeType     string `json:"mime_type,omitempty"`
	FileSize     int64  `json:"file_size,omitempty"`
}

type EditMessageTextRequest struct {
	ChatID    int64  `json:"chat_id"`
	MessageID int    `json:"message_id"`
	Text      string `json:"text"`
	ParseMode string `json:"parse_mode,omitempty"`
}

type ExtendedClient struct {
	*Client
}

type File struct {
	FileID       string `json:"file_id"`
	FileUniqueID string `json:"file_unique_id"`
	FileSize     int64  `json:"file_size,omitempty"`
	FilePath     string `json:"file_path,omitempty"`
}

type FileDownloader interface {
	DownloadFile(ctx context.Context, fileID string) ([]byte, error)
	// DownloadFileWithLimit applies a caller-provided byte ceiling before the
	// response is buffered. It is used by aggregate-budget schedulers, where the
	// ordinary per-file ceiling is too coarse to bound concurrent allocations.
	DownloadFileWithLimit(ctx context.Context, fileID string, maxBytes int64) ([]byte, error)
	DownloadFileAsBase64(ctx context.Context, fileID string) (string, error)
}

type GetFileRequest struct {
	FileID string `json:"file_id"`
}

type GetUpdatesRequest struct {
	Offset         int      `json:"offset,omitempty"`
	Limit          int      `json:"limit,omitempty"`
	Timeout        int      `json:"timeout,omitempty"`
	AllowedUpdates []string `json:"allowed_updates,omitempty"`
}

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

type InputMediaDocument struct {
	Data      []byte
	Filename  string
	Caption   string
	ParseMode string
}

type InputMediaPhoto struct {
	// Data holds the raw image bytes; the corresponding media JSON entry will
	// reference "attach://photo_<index>".
	Data     []byte
	Filename string // e.g. "generated_1.png"
	Caption  string // optional; only the first item's caption is shown on the group
	// ParseMode applies to Caption; uses "HTML" by default when empty.
	ParseMode string
}

type InputRichMessage struct {
	HTML                string                  `json:"html,omitempty"`
	Media               []InputRichMessageMedia `json:"media,omitempty"`
	SkipEntityDetection bool                    `json:"skip_entity_detection,omitempty"`
}

type InputRichMessageMedia struct {
	ID    string                `json:"id"`
	Media InputRichMessagePhoto `json:"media"`
}

type InputRichMessagePhoto struct {
	Media string `json:"media"`
}

type Location struct {
	Latitude             float64 `json:"latitude"`
	Longitude            float64 `json:"longitude"`
	HorizontalAccuracy   float64 `json:"horizontal_accuracy,omitempty"`
	LivePeriod           int     `json:"live_period,omitempty"`
	Heading              int     `json:"heading,omitempty"`
	ProximityAlertRadius int     `json:"proximity_alert_radius,omitempty"`
}

type MediaType string

type Message struct {
	MessageID            int                  `json:"message_id"`
	MessageThreadID      int                  `json:"message_thread_id,omitempty"`
	BusinessConnectionID string               `json:"business_connection_id,omitempty"`
	DirectMessagesTopic  *DirectMessagesTopic `json:"direct_messages_topic,omitempty"`
	From                 *User                `json:"from,omitempty"`
	Chat                 *Chat                `json:"chat"`
	Date                 int                  `json:"date"`
	Text                 string               `json:"text,omitempty"`
	Entities             []MessageEntity      `json:"entities,omitempty"`
	Caption              string               `json:"caption,omitempty"`
	CaptionEntities      []MessageEntity      `json:"caption_entities,omitempty"`
	Photo                []PhotoSize          `json:"photo,omitempty"`
	Document             *Document            `json:"document,omitempty"`
	Voice                *Voice               `json:"voice,omitempty"`
	Audio                *Audio               `json:"audio,omitempty"`
	VideoNote            *VideoNote           `json:"video_note,omitempty"`
	RichMessage          *RichMessage         `json:"rich_message,omitempty"`
	ForwardOrigin        *MessageOrigin       `json:"forward_origin,omitempty"`
}

type MessageEntity struct {
	Type           MessageEntityType `json:"type"`
	Offset         int               `json:"offset"`
	Length         int               `json:"length"`
	URL            string            `json:"url,omitempty"`
	User           *User             `json:"user,omitempty"`
	Language       string            `json:"language,omitempty"`
	CustomEmojiID  string            `json:"custom_emoji_id,omitempty"`
	UnixTime       int64             `json:"unix_time,omitempty"`
	DateTimeFormat string            `json:"date_time_format,omitempty"`
}

type MessageEntityProjection struct {
	Markdown    string
	Partial     bool
	EntityCount int
}

type MessageEntityProjectionError struct {
	Field       string
	EntityIndex int
	Reason      string
	Limit       int
	Actual      int
}

type MessageEntityType string

type MessageOrigin struct {
	Type            string `json:"type"`
	Date            int    `json:"date"`
	SenderUser      *User  `json:"sender_user,omitempty"`
	SenderUserName  string `json:"sender_user_name,omitempty"`
	SenderChat      *Chat  `json:"sender_chat,omitempty"`
	AuthorSignature string `json:"author_signature,omitempty"`
}

type MessageReactionUpdated struct {
	Chat        *Chat          `json:"chat"`
	MessageID   int            `json:"message_id"`
	User        *User          `json:"user,omitempty"`
	Date        int            `json:"date"`
	OldReaction []ReactionType `json:"old_reaction"`
	NewReaction []ReactionType `json:"new_reaction"`
}

type NormalizedRichMessage struct {
	Markdown       string
	Media          []RichMediaOccurrence
	UnknownKinds   []string
	Disposition    RichDisposition
	HasVisibleText bool
	IsRTL          bool
	Stats          RichProjectionStats
}

type PhotoSize struct {
	FileID       string `json:"file_id"`
	FileUniqueID string `json:"file_unique_id"`
	Width        int    `json:"width"`
	Height       int    `json:"height"`
	FileSize     int64  `json:"file_size,omitempty"`
}

type ReactionType struct {
	Type  string `json:"type"`
	Emoji string `json:"emoji,omitempty"`
}

type ReplyParameters struct {
	MessageID int `json:"message_id"`
}

type ResponseParameters struct {
	RetryAfter int `json:"retry_after,omitempty"`
}

type RichBlock struct {
	Type RichBlockType

	Text       *RichText
	Size       int
	Language   string
	Expression string
	Name       string

	Items   []RichBlockListItem
	Blocks  []RichBlock
	Credit  *RichText
	Caption *RichBlockCaption

	Cells      [][]RichBlockTableCell
	IsBordered bool
	IsStriped  bool

	Summary *RichText
	IsOpen  bool

	Location *Location
	Zoom     int
	Width    int
	Height   int

	Animation  *Animation
	Audio      *Audio
	Photo      []PhotoSize
	Video      *Video
	VoiceNote  *Voice
	HasSpoiler bool

	Unknown   bool
	Malformed bool
}

type RichBlockCaption struct {
	Text   *RichText
	Credit *RichText

	Malformed bool
}

type RichBlockListItem struct {
	Label       string
	Blocks      []RichBlock
	HasCheckbox bool
	IsChecked   bool
	Value       *int
	Type        string

	Malformed bool
}

type RichBlockTableCell struct {
	Text     *RichText
	IsHeader bool
	Colspan  int
	Rowspan  int
	Align    string
	VAlign   string

	Malformed bool
}

type RichBlockType string

type RichDisposition string

type RichMediaKind string

type RichMediaOccurrence struct {
	Ordinal   int
	Marker    string
	Kind      RichMediaKind
	BlockPath string

	Caption string
	Credit  string

	ContainerPath    string
	ContainerCaption string
	ContainerCredit  string

	HasSpoiler bool
	Photo      []PhotoSize
	Video      *Video
	Animation  *Animation
	Audio      *Audio
	Voice      *Voice
}

type RichMessage struct {
	Blocks []RichBlock `json:"-"`
	IsRTL  bool        `json:"-"`

	Malformed bool `json:"-"`
}

type RichMessageAttachment struct {
	ID          string `json:"-"`
	Filename    string `json:"-"`
	ContentType string `json:"-"`
	Data        []byte `json:"-"`
}

type RichPhotoUpload struct {
	Filename string
	MIME     string
	Data     []byte
}

type RichProjectionLimits struct {
	Characters       int
	Blocks           int
	NestingDepth     int
	Media            int
	TableColumns     int
	RichTextNodes    int
	OutputCharacters int
	UnknownKinds     int
}

type RichProjectionStats struct {
	Characters       int
	Blocks           int
	MaxDepth         int
	Media            int
	MaxTableColumns  int
	RichTextNodes    int
	OutputCharacters int
	Unknown          int
}

type RichText struct {
	Kind     RichTextKind
	Value    string
	Children []RichText
	Text     *RichText

	UnixTime       int64
	DateTimeFormat string
	User           *User

	CustomEmojiID   string
	AlternativeText string
	Expression      string
	URL             string
	EmailAddress    string
	PhoneNumber     string
	BankCardNumber  string
	Username        string
	Hashtag         string
	Cashtag         string
	BotCommand      string
	Name            string
	AnchorName      string
	ReferenceName   string

	Unknown   bool
	Malformed bool
}

type RichTextKind string

type RichValidationError struct {
	Field  string
	Limit  int
	Actual int
}

type SendChatActionRequest struct {
	ChatID          int64  `json:"chat_id"`
	MessageThreadID *int   `json:"message_thread_id,omitempty"`
	Action          string `json:"action"`
}

type SendDocumentRequest struct {
	ChatID           int64
	MessageThreadID  *int
	Data             []byte
	Filename         string
	Caption          string
	ParseMode        string
	ReplyToMessageID int
}

type SendMediaGroupDocumentsRequest struct {
	ChatID           int64
	MessageThreadID  *int
	Media            []InputMediaDocument
	ReplyToMessageID int
}

type SendMediaGroupRequest struct {
	ChatID           int64
	MessageThreadID  *int
	Media            []InputMediaPhoto
	ReplyToMessageID int
}

type SendMessageRequest struct {
	ChatID           int64  `json:"chat_id"`
	MessageThreadID  *int   `json:"message_thread_id,omitempty"`
	Text             string `json:"text"`
	ParseMode        string `json:"parse_mode,omitempty"`
	ReplyToMessageID int    `json:"reply_to_message_id,omitempty"`
}

type SendPhotoRequest struct {
	ChatID           int64
	MessageThreadID  *int
	PhotoData        []byte
	PhotoFilename    string // e.g. "generated.png"
	Caption          string // optional, ≤1024 UTF-16 chars
	ParseMode        string // "HTML" or "MarkdownV2" or ""
	ReplyToMessageID int
}

type SendRichMessageDraftRequest struct {
	ChatID          int64            `json:"chat_id"`
	MessageThreadID *int             `json:"message_thread_id,omitempty"`
	DraftID         int64            `json:"draft_id"`
	RichMessage     InputRichMessage `json:"rich_message"`
}

type SendRichMessageRequest struct {
	ChatID          int64                   `json:"chat_id"`
	MessageThreadID *int                    `json:"message_thread_id,omitempty"`
	RichMessage     InputRichMessage        `json:"rich_message"`
	ReplyParameters *ReplyParameters        `json:"reply_parameters,omitempty"`
	Attachments     []RichMessageAttachment `json:"-"`
}

type SetMessageReactionRequest struct {
	ChatID    int64          `json:"chat_id"`
	MessageID int            `json:"message_id"`
	Reaction  []ReactionType `json:"reaction,omitempty"`
	IsBig     bool           `json:"is_big,omitempty"`
}

type SetMyCommandsRequest struct {
	Commands []BotCommand `json:"commands"`
}

type SetWebhookRequest struct {
	URL            string   `json:"url"`
	SecretToken    string   `json:"secret_token,omitempty"`
	AllowedUpdates []string `json:"allowed_updates,omitempty"`
}

type Update struct {
	UpdateID        int                     `json:"update_id"`
	Message         *Message                `json:"message,omitempty"`
	MessageReaction *MessageReactionUpdated `json:"message_reaction,omitempty"`
}

type User struct {
	ID        int64  `json:"id"`
	IsBot     bool   `json:"is_bot"`
	FirstName string `json:"first_name"`
	LastName  string `json:"last_name,omitempty"`
	Username  string `json:"username,omitempty"`
}

type Video struct {
	FileID         string         `json:"file_id"`
	FileUniqueID   string         `json:"file_unique_id"`
	Width          int            `json:"width"`
	Height         int            `json:"height"`
	Duration       int            `json:"duration"`
	Thumbnail      *PhotoSize     `json:"thumbnail,omitempty"`
	Cover          []PhotoSize    `json:"cover,omitempty"`
	StartTimestamp int            `json:"start_timestamp,omitempty"`
	Qualities      []VideoQuality `json:"qualities,omitempty"`
	FileName       string         `json:"file_name,omitempty"`
	MimeType       string         `json:"mime_type,omitempty"`
	FileSize       int64          `json:"file_size,omitempty"`
}

type VideoNote struct {
	FileID       string     `json:"file_id"`
	FileUniqueID string     `json:"file_unique_id"`
	Length       int        `json:"length"`   // Video width and height (diameter of the video message)
	Duration     int        `json:"duration"` // Duration of the video in seconds
	Thumbnail    *PhotoSize `json:"thumbnail,omitempty"`
	FileSize     int64      `json:"file_size,omitempty"`
}

type VideoQuality struct {
	FileID       string `json:"file_id"`
	FileUniqueID string `json:"file_unique_id"`
	Width        int    `json:"width"`
	Height       int    `json:"height"`
	Codec        string `json:"codec"`
	FileSize     int64  `json:"file_size,omitempty"`
}

type Voice struct {
	FileID       string `json:"file_id"`
	FileUniqueID string `json:"file_unique_id"`
	Duration     int    `json:"duration"`
	MimeType     string `json:"mime_type,omitempty"`
	FileSize     int64  `json:"file_size,omitempty"`
}