create invoice link & message caption above photo & save inline message & get star transactions

bot.go

@@ -719,6 +719,19 @@ func (bot *BotAPI) GetMyDefaultAdministratorRights(config GetMyDefaultAdministra
 	return rights, err
 }
 
+// SavePreparedInlineMessage stores a message that can be sent by a user of a Mini App.
+func (bot *BotAPI) SavePreparedInlineMessage(config SavePreparedInlineMessageConfig) (PreparedInlineMessage, error) {
+	var message PreparedInlineMessage
+
+	resp, err := bot.Request(config)
+	if err != nil {
+		return message, err
+	}
+
+	err = json.Unmarshal(resp.Result, &message)
+	return message, err
+}
+
 // EscapeText takes an input text and escape Telegram markup symbols.
 // In this way we can send a text without being afraid of having to escape the characters manually.
 // Note that you don't have to include the formatting style in the input text, or it will be escaped too.
@@ -746,3 +759,15 @@ func EscapeText(parseMode string, text string) string {
 
 	return replacer.Replace(text)
 }
+
+func (bot *BotAPI) GetStarTransactions(config GetStarTransactionsConfig) (StarTransactions, error) {
+	var starTransactions StarTransactions
+
+	resp, err := bot.Request(config)
+	if err != nil {
+		return starTransactions, err
+	}
+
+	err = json.Unmarshal(resp.Result, &starTransactions)
+	return starTransactions, err
+}

bot_test.go

@@ -1,14 +1,15 @@
 package tgbotapi
 
 import (
+	"fmt"
 	"net/http"
 	"os"
 	"testing"
 	"time"
 )
 
 const (
-	TestToken               = "153667468:AAHlSHlMqSt1f_uFmVRJbm5gntu2HI4WW8I"
+	TestToken               = "6766212541:AAGQTAPSbZGQoJ-FmG-nyYZLPCQQCc5wFIw"
 	ChatID                  = 76918703
 	Channel                 = "@tgbotapitest"
 	SupergroupChatID        = -1001120141283
@@ -36,7 +37,6 @@ func (t testLogger) Printf(format string, v ...interface{}) {
 
 func getBot(t *testing.T) (*BotAPI, error) {
 	bot, err := NewBotAPI(TestToken)
-	bot.Debug = true
 
 	logger := testLogger{t}
 	SetLogger(logger)
@@ -45,6 +45,8 @@ func getBot(t *testing.T) (*BotAPI, error) {
 		t.Error(err)
 	}
 
+	bot.Debug = true
+
 	return bot, err
 }
 
@@ -1048,3 +1050,92 @@ func TestPrepareInputMediaForParams(t *testing.T) {
 		t.Error("Passthrough value was not the same")
 	}
 }
+
+func TestCreateInvoiceLink(t *testing.T) {
+	bot, err := getBot(t)
+	if err != nil {
+		t.Fatal(err)
+	}
+	resp, err := bot.Request(NewInvoiceLink("Demo Invoice", "This is a demo invoice link", "command", "", "XTR", []int{}, []LabeledPrice{
+		{
+			Label:  "Demo Digital Token",
+			Amount: 100,
+		},
+	}))
+
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !resp.Ok {
+		t.Fatal("Response not OK", resp.ErrorCode, resp.Description)
+	}
+	result, err := resp.Result.MarshalJSON()
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Log(string(result))
+}
+
+func TestSendPhoto(t *testing.T) {
+	bot, err := getBot(t)
+	if err != nil {
+		t.Fatal(err)
+	}
+	photo := NewPhoto(1632669575, FileURL("https://pub-4b4332e2985947ceacb0e1bdc9c540bd.r2.dev/novelcoronavirus-optimized.jpg"))
+	photo.Caption = "Welcome to Follow https://github.com/TUTUBIG"
+	photo.ShowCaptionAboveMedia = true
+	_, err = bot.Send(photo)
+	if err != nil {
+		t.Fatal(err)
+	}
+}
+
+func TestSaveInlineMessage(t *testing.T) {
+	bot, err := NewBotAPI(TestToken)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	photo := NewInlineQueryResultPhoto(fmt.Sprintf("%d", time.Now().Unix()), "https://pub-6c52100fa9ac41f681f0713eac878541.r2.dev/xxx.png")
+	photo.Caption = "This is a demo saved inline query messages"
+	photo.ParseMode = "HTML"
+	photo.ThumbURL = "https://pub-6c52100fa9ac41f681f0713eac878541.r2.dev/xxx.png"
+	markup := NewInlineKeyboardMarkup(NewInlineKeyboardRow(NewInlineKeyboardButtonURL("Open in TOMO", fmt.Sprintf("https://www.google.com"))))
+	photo.ReplyMarkup = &markup
+
+	message, err := bot.SavePreparedInlineMessage(SavePreparedInlineMessageConfig{
+		UserId:            1632669575,
+		Result:            photo,
+		AllowUserChats:    true,
+		AllowBotChats:     true,
+		AllowGroupChats:   true,
+		AllowChannelChats: true,
+	})
+
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	t.Log(message)
+}
+
+func TestGetStarTransactions(t *testing.T) {
+	bot, err := getBot(t)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	response, err := bot.GetStarTransactions(GetStarTransactionsConfig{
+		Offset: 200,
+		Limit:  100,
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	for _, transaction := range response.Transactions {
+		if transaction.Receiver != nil {
+			t.Logf("%+v\n", transaction)
+		}
+	}
+}

configs.go

@@ -405,10 +405,11 @@ func (config CopyMessageConfig) method() string {
 // PhotoConfig contains information about a SendPhoto request.
 type PhotoConfig struct {
 	BaseFile
-	Thumb           RequestFileData
-	Caption         string
-	ParseMode       string
-	CaptionEntities []MessageEntity
+	Thumb                 RequestFileData
+	Caption               string
+	ParseMode             string
+	CaptionEntities       []MessageEntity
+	ShowCaptionAboveMedia bool
 }
 
 func (config PhotoConfig) params() (Params, error) {
@@ -420,6 +421,7 @@ func (config PhotoConfig) params() (Params, error) {
 	params.AddNonEmpty("caption", config.Caption)
 	params.AddNonEmpty("parse_mode", config.ParseMode)
 	err = params.AddInterface("caption_entities", config.CaptionEntities)
+	params.AddBool("show_caption_above_media", config.ShowCaptionAboveMedia)
 
 	return params, err
 }
@@ -1784,6 +1786,65 @@ func (config InvoiceConfig) method() string {
 	return "sendInvoice"
 }
 
+// InvoiceLinkConfig contains information for createInvoiceLink request.
+type InvoiceLinkConfig struct {
+	Title                     string         // required
+	Description               string         // required
+	Payload                   string         // required
+	ProviderToken             string         // required
+	Currency                  string         // required
+	Prices                    []LabeledPrice // required
+	MaxTipAmount              int
+	SuggestedTipAmounts       []int
+	ProviderData              string
+	PhotoURL                  string
+	PhotoSize                 int
+	PhotoWidth                int
+	PhotoHeight               int
+	NeedName                  bool
+	NeedPhoneNumber           bool
+	NeedEmail                 bool
+	NeedShippingAddress       bool
+	SendPhoneNumberToProvider bool
+	SendEmailToProvider       bool
+	IsFlexible                bool
+}
+
+func (config InvoiceLinkConfig) params() (Params, error) {
+	params := make(Params)
+	var err error
+
+	params["title"] = config.Title
+	params["description"] = config.Description
+	params["payload"] = config.Payload
+	params["provider_token"] = config.ProviderToken
+	params["currency"] = config.Currency
+	if err = params.AddInterface("prices", config.Prices); err != nil {
+		return params, err
+	}
+
+	params.AddNonZero("max_tip_amount", config.MaxTipAmount)
+	err = params.AddInterface("suggested_tip_amounts", config.SuggestedTipAmounts)
+	params.AddNonEmpty("provider_data", config.ProviderData)
+	params.AddNonEmpty("photo_url", config.PhotoURL)
+	params.AddNonZero("photo_size", config.PhotoSize)
+	params.AddNonZero("photo_width", config.PhotoWidth)
+	params.AddNonZero("photo_height", config.PhotoHeight)
+	params.AddBool("need_name", config.NeedName)
+	params.AddBool("need_phone_number", config.NeedPhoneNumber)
+	params.AddBool("need_email", config.NeedEmail)
+	params.AddBool("need_shipping_address", config.NeedShippingAddress)
+	params.AddBool("is_flexible", config.IsFlexible)
+	params.AddBool("send_phone_number_to_provider", config.SendPhoneNumberToProvider)
+	params.AddBool("send_email_to_provider", config.SendEmailToProvider)
+
+	return params, err
+}
+
+func (config InvoiceLinkConfig) method() string {
+	return "createInvoiceLink"
+}
+
 // ShippingConfig contains information for answerShippingQuery request.
 type ShippingConfig struct {
 	ShippingQueryID string // required
@@ -2566,3 +2627,55 @@ func prepareInputMediaForFiles(inputMedia []interface{}) []RequestFile {
 
 	return files
 }
+
+type SavePreparedInlineMessageConfig struct {
+	UserId            int64
+	Result            interface{} // Too many definitions to use generics but please make sure it is InlineQueryResult. https://core.telegram.org/bots/api#inlinequeryresult
+	AllowUserChats    bool
+	AllowBotChats     bool
+	AllowGroupChats   bool
+	AllowChannelChats bool
+}
+
+func (config SavePreparedInlineMessageConfig) method() string {
+	return "savePreparedInlineMessage"
+}
+
+func (config SavePreparedInlineMessageConfig) params() (Params, error) {
+	params := make(Params)
+
+	params.AddNonZero64("user_id", config.UserId)
+	if err := params.AddInterface("result", config.Result); err != nil {
+		return nil, err
+	}
+	params.AddBool("allow_user_chats", config.AllowUserChats)
+	params.AddBool("allow_bot_chats", config.AllowBotChats)
+	params.AddBool("allow_group_chats", config.AllowGroupChats)
+	params.AddBool("allow_channel_chats", config.AllowChannelChats)
+
+	return params, nil
+}
+
+// GetStarTransactionsConfig Returns the bot's Telegram Star transactions in chronological order. On success, returns a StarTransactions object.
+type GetStarTransactionsConfig struct {
+	// Number of transactions to skip in the response
+	Offset int64
+	// The maximum number of transactions to be retrieved. Values between 1-100 are accepted. Defaults to 100.
+	Limit int64
+}
+
+func (config GetStarTransactionsConfig) method() string {
+	return "getStarTransactions"
+}
+
+func (config GetStarTransactionsConfig) params() (Params, error) {
+	params := make(Params)
+
+	err := params.AddInterface("offset", config.Offset)
+	if err != nil {
+		return nil, err
+	}
+	params.AddNonZero("limit", int(config.Limit))
+
+	return params, nil
+}

go.mod

@@ -1,3 +1,3 @@
-module github.com/go-telegram-bot-api/telegram-bot-api/v5
+module github.com/TUTUBIG/telegram-bot-api/v5
 
 go 1.16

helpers.go

@@ -777,6 +777,19 @@ func NewInvoice(chatID int64, title, description, payload, providerToken, startP
 		Prices:         prices}
 }
 
+// NewInvoiceLink creates a new Invoice link.
+func NewInvoiceLink(title, description, payload, providerToken, currency string, suggestedTipAmounts []int, prices []LabeledPrice) InvoiceLinkConfig {
+	return InvoiceLinkConfig{
+		Title:               title,
+		Description:         description,
+		Payload:             payload,
+		ProviderToken:       providerToken,
+		Currency:            currency,
+		Prices:              prices,
+		SuggestedTipAmounts: suggestedTipAmounts,
+	}
+}
+
 // NewChatTitle allows you to update the title of a chat.
 func NewChatTitle(chatID int64, title string) SetChatTitleConfig {
 	return SetChatTitleConfig{