Merge pull request #41 from OvyFlash/bot-api-7.10

BotAPI 7.10 implementation

Author: OvyFlash

configs.go

@@ -96,6 +96,10 @@ const (
 	// UpdateTypePreCheckoutQuery is new incoming pre-checkout query. Contains full information about checkout
 	UpdateTypePreCheckoutQuery = "pre_checkout_query"
 
+	// UpdateTypePurchasedPaidMedia is a user purchased paid media with a non-empty payload
+	// sent by the bot in a non-channel chat
+	UpdateTypePurchasedPaidMedia = "purchased_paid_media"
+
 	// UpdateTypePoll is new poll state. Bots receive only updates about stopped polls and polls
 	// which are sent by the bot
 	UpdateTypePoll = "poll"
@@ -559,7 +563,7 @@ func (config DocumentConfig) params() (Params, error) {
 	if err != nil {
 		return params, err
 	}
-	
+
 	params.AddNonEmpty("caption", config.Caption)
 	params.AddNonEmpty("parse_mode", config.ParseMode)
 	params.AddBool("disable_content_type_detection", config.DisableContentTypeDetection)
@@ -774,6 +778,7 @@ type PaidMediaConfig struct {
 	BaseChat
 	StarCount             int64
 	Media                 []InputPaidMedia
+	Payload               string          // optional
 	Caption               string          // optional
 	ParseMode             string          // optional
 	CaptionEntities       []MessageEntity // optional
@@ -787,6 +792,7 @@ func (config PaidMediaConfig) params() (Params, error) {
 	}
 
 	params.AddNonZero64("star_count", config.StarCount)
+	params.AddNonEmpty("payload", config.Payload)
 	params.AddNonEmpty("caption", config.Caption)
 	params.AddNonEmpty("parse_mode", config.ParseMode)
 	params.AddBool("show_caption_above_media", config.ShowCaptionAboveMedia)

types.go

@@ -114,6 +114,11 @@ type Update struct {
 	//
 	// optional
 	PreCheckoutQuery *PreCheckoutQuery `json:"pre_checkout_query,omitempty"`
+	// PurchasedPaidMedia is user purchased paid media with a non-empty
+	// payload sent by the bot in a non-channel chat
+	//
+	// optional
+	PurchasedPaidMedia *PaidMediaPurchased `json:"purchased_paid_media,omitempty"`
 	// Pool new poll state. Bots receive only updates about stopped polls and
 	// polls, which are sent by the bot
 	//
@@ -2032,7 +2037,14 @@ type VideoChatParticipantsInvited struct {
 }
 
 // This object represents a service message about the creation of a scheduled giveaway. Currently holds no information.
-type GiveawayCreated struct{}
+type GiveawayCreated struct {
+	// PrizeStarCount is the number of Telegram Stars to be split
+	// between giveaway winners;
+	// for Telegram Star giveaways only
+	//
+	// optional
+	PrizeStarCount int `json:"prize_star_count,omitempty"`
+}
 
 // Giveaway represents a message about a scheduled giveaway.
 type Giveaway struct {
@@ -2063,6 +2075,12 @@ type Giveaway struct {
 	//
 	// optional
 	CountryCodes []string `json:"country_codes,omitempty"`
+	// PrizeStarCount is the number of Telegram Stars to be split
+	// between giveaway winners;
+	// for Telegram Star giveaways only
+	//
+	// optional
+	PrizeStarCount int `json:"prize_star_count,omitempty"`
 	// PremiumSubscriptionMonthCount the number of months the Telegram Premium
 	// subscription won from the giveaway will be active for
 	//
@@ -2089,6 +2107,12 @@ type GiveawayWinners struct {
 	//
 	// optional
 	AdditionalChatCount int `json:"additional_chat_count,omitempty"`
+	// PrizeStarCount is the number of Telegram Stars to be split
+	// between giveaway winners;
+	// for Telegram Star giveaways only
+	//
+	// optional
+	PrizeStarCount int `json:"prize_star_count,omitempty"`
 	// PremiumSubscriptionMonthCount the number of months the Telegram Premium
 	// subscription won from the giveaway will be active for
 	//
@@ -2125,6 +2149,11 @@ type GiveawayCompleted struct {
 	//
 	// optional
 	GiveawayMessage *Message `json:"giveaway_message,omitempty"`
+	// IsStarGiveaway True, if the giveaway is a Telegram Star giveaway. 
+	// Otherwise, currently, the giveaway is a Telegram Premium giveaway.
+	//
+	// optional
+	IsStarGiveaway bool `json:"is_star_giveaway,omitempty"`
 }
 
 // LinkPreviewOptions describes the options used for link preview generation.
@@ -3261,6 +3290,13 @@ type ChatBoostSource struct {
 	// Is an identifier of a message in the chat with the giveaway;
 	// the message could have been deleted already. May be 0 if the message isn't sent yet.
 	GiveawayMessageID int `json:"giveaway_message_id,omitempty"`
+	// PrizeStarCount "giveaway" only.
+	// The number of Telegram Stars to be split
+	// between giveaway winners;
+	// for Telegram Star giveaways only
+	//
+	// optional
+	PrizeStarCount int `json:"prize_star_count,omitempty"`
 	// IsUnclaimed "giveaway" only.
 	// True, if the giveaway was completed, but there was no user to win the prize
 	//
@@ -5045,6 +5081,14 @@ type PreCheckoutQuery struct {
 	OrderInfo *OrderInfo `json:"order_info,omitempty"`
 }
 
+// PaidMediaPurchased contains information about a paid media purchase.
+type PaidMediaPurchased struct {
+	// From is the user who purchased the media
+	From User `json:"from"`
+	// PaidMediaPayload bot-specified paid media payload
+	PaidMediaPayload string `json:"paid_media_payload"`
+}
+
 // RevenueWithdrawalState describes the state of a revenue withdrawal operation.
 // Currently, it can be one of
 //   - RevenueWithdrawalStatePending