bot/CHANGELOG.md

# Changelog

## v1.13.3 (2025-01-11)

- add option `WithInitialOffset(offset int64)` - allows to set initial offset for getUpdates method

## v1.13.2 (2025-01-11)

- change field type `WebAppUser.ID` from `int` to `int64`

## v1.13.1 (2025-01-10)

- add method `bot.ID() int64`
- add method `bot.Token() string`

## v1.13.0 (2025-01-10)

- support API 8.2 (#144)
- fix unmarshal ChatBackground 
- ValidateWebappRequest - now returns model WebAppUser (#143)

## v1.12.1 (2024-12-19)

- add handler type for photo captions (#138)

## v1.12.0 (2024-12-19)

- support API v8.1

## v1.11.1 (2024-11-21)

- fix CreateNewStickerSetParams (#132) 

## v1.11.0 (2024-11-18)

- support API v8.0

## v1.10.1 (2024-11-08)

- Fix arm64 panic (#130) 

## v1.10.0 (2024-10-31)

- support API v7.11

## v1.9.1 (2024-10-21)

- fix unmarshal `ChatBackground` type (#126)

## v1.9.0 (2024-10-17)

- IMPORTANT! New option `WithNotAsyncHandlers` allows to run handlers in the main goroutine. Now, by default, all handlers are run in separate goroutines.

## v1.8.4 (2024-10-10)

- add method GetBusinessConnection (#123)

## v1.8.3 (2024-10-07)

- add function `bot.SetToken`
- update GitHub action versions

## v1.8.2 (2024-09-23)

- change field type `FromChatID` from string to any for `ForwardMessageParams`, `ForwardMessagesParams`, `CopyMessageParams` and `CopyMessagesParams` params  

## v1.8.1 (2024-09-16)

- change handlers map to slice (#115) 
- feat: Ability to process updates across multiple gorutines (#112)
- add 'HandlerTypeCallbackQueryGameShortName' (#108)
- feat: add middlewares for handler (#105)

## v1.8.0 (2024-09-13)

- support API v7.10
- change type for field Type in models.Chat and models.ChatFullInfo from `string` to `models.ChatType`
- add consts for ChatType
  - models.ChatTypePrivate
  - models.ChatTypeGroup
  - models.ChatTypeSupergroup
  - models.ChatTypeChannel


## v1.7.3 (2024-09-10)

- Fix findHandler behavior

## v1.7.2 (2024-08-23)

- fix: pass error with `%w` instead `%v` after rawRequest

## v1.7.1 (2024-08-22)

- add option `UseTestEnvironment` for use test environment in API requests

## v1.7.0 (2024-08-14)

- support API v7.9

## v1.6.1 (2024-07-25)

- add ValidateWebappRequest func for validate MiniApp requests

## v1.6.0 (2024-07-18)

- support API v7.6, 7.7
- add const `models.ParseModeMarkdownV1`

## v1.5.0 (2024-06-24)

- support API v7.5

## v1.4.1 (2024-06-19)

- fix: getGameHighScores returns an array of high scores instead of a single object (#94)  
- Use any type for ChatID in SetGameScoreParams and GetGameHighScoreParams (#88)

## v1.4.0 (2024-05-29)

- support API v7.4

## v1.3.1 (2024-05-22)

- add Marshal functions for struct with many types
  - ChatBoostSource
  - ChatBackground
  - ChatMember
  - MenuButton
  - MaybeInaccessibleMessage
  - ReactionType
  - MessageOrigin

## v1.3.0 (2024-05-20)

- support API v7.3

## v1.2.2 (2024-04-25)

- fix race in test 
- add example inline_keyboard_multiselect 

## v1.2.1 (2024-04-03)

- Added error handling for specific error codes (#69) 
- fix: exit from waitUpdates function when context is terminated (#75) 

## v1.2.0 (2024-04-02)

- support API v7.2
- remove worker pool
- add option `WithUpdatesChannelCap`

## v1.1.7 (2024-03-11)

- add error `ErrorForbidden` for responses with error code 403
- fix CopyMessages capture response 
- ForwardMessages properly unmarshal result (#68) 

## v1.1.6 (2024-03-05)

- ForwardMessages return slice of MessageID (#66)

## v1.1.5 (2024-03-04)

- add option WithAllowedUpdates (#65)

## v1.1.4 (2024-02-27)

- fix `CallbackQuery.Message` field type from `InaccessibleMessage` to `MaybeInaccessibleMessage`

## v1.1.3 (2024-02-22)

- fix json tag for DeleteMessagesParams.MessageIDs

## v1.1.2 (2024-02-21)

- fix SetMessageReaction marshal func, fix get response for this method

## v1.1.1 (2024-02-21)

- fix typo in json tag `models.UsersShared` for field UserIDs 

## v1.1.0 (2024-02-19)

- support API v7.1

## v1.0.1 (2024-01-15)

- fix: add 'omitempty' to LinkPreviewOptions.URL

## v1.0.0 (2024-01-10)

- support API v7.0

## v0.8.3 (2023-12-07)

- Fix typo for setChatDescription params (#49)
- add example handler_match_func
- add function bot.FileDownloadLink

## v0.8.2 (2023-10-16)

- add missed field HasSpoiler to InputMedia types

## v0.8.1 (2023-10-09)

- json tag typo fix (#41) vvok12* 

## v0.8.0 (2023-09-28)

- support bot api 6.9 

## v0.7.15 (2023-08-24)

- support bot api 6.8 

## v0.7.14 (2023-08-14)

- update `defaultUpdatesChanCap` from 64 to 1024

## v0.7.13 (2023-06-14)

- revert `v0.7.7` changes

## v0.7.12 (2023-06-13)

- check for empty token on bot init

## v0.7.11 (2023-05-26)

- add missed ChatID to BotCommandScopeChat
- add missed BotCommandScopeChatAdministrators.MarshalCustom

## v0.7.10 (2023-05-22)

- add ChatAction type with consts for `sendChatAction` method

## v0.7.9 (2023-05-16)

- add option `WithSkipGetMe()`

## v0.7.8 (2023-04-26)

- [BUGFIX] fix type of field `Message.ReplyMarkup` (#30)
- improve examples (#31)

## v0.7.7 (2023-04-24)

- change `models.ReplyMarkup` from `any` to interface

## v0.7.6 (2023-04-24)

- support bot api 6.7

## v0.7.5 (2023-04-13)

- add option `WithDebugHandler`

## v0.7.4 (2023-04-10)

- [BUGFIX] change field `SendPollParams.IsAnonymous` to *bool (#26)
- add helpers `bot.True()` and `bot.False()` for define *bool values

## v0.7.3 (2023-04-05)

- make `bot.ProcessUpdate` public 

## v0.7.2 (2023-04-03)

- fix copyMessage method (#24)

## v0.7.1 (2023-03-20)

- fix field name in MenuButtonWebApp #21

## v0.7.0 (2023-03-14)

- support bot api 6.6

## v0.6.0 (2023-03-01)

- [BREAKING] change UserID field type in methods params and models from `int` to `int64` #19

## v0.5.1 (2023-02-10)

- [BUGFIX] send http.NoBody if all params fields are empty. For example, method `getMyCommands` has not required fields

## v0.5.0 (2023-02-06)

- support bot api 6.5 

## v0.4.3 (2023-02-05)

- [BUGFIX] SendChatAction now calls `sendChatAction` instead `sendDice`

## v0.4.2 (2023-01-30)

- [BUGFIX] change field Thumb to InputFile type

## v0.4.1 (2023-01-19)

- add func `EscapeMarkdownUnescaped` for escape only unescaped symbols

## v0.4.0 (2023-01-13)

- [BREAKING] change some types from `int` to `int64` #11

## v0.3.4 (2023-01-10)

- support bot api 6.4

## v0.3.3 (2022-12-28)

- add `RegisterHandlerMatchFunc` 

## v0.3.2 (2022-11-28)

- fix field type SendDocumentParams.Document from string to InputFile, add example

## v0.3.1 (2022-11-05)

- support bot api 6.3

## v0.3.0 (2022-10-14)

- **[API CHANGE]** method New now call `getMe` after init and returns error as second result on fail

## v0.2.2 (2022-08-23)

- support bot api v6.2

## v0.2.1 (2022-07-08)

- support bot api v6.1

## v0.2.0 (2022-05-06)

- change API. Use bot funcs instead of`methods` package.

## v0.1.1 (2022-05-02)

- add webhook support
- API refactoring
  - use bot.GetUpdates() instead of bot.Start()

## v0.1.0 (2022-05-02)

- initial release
initial 2022-04-26 00:02:51 +08:00			`# Changelog`
update changelog 2022-05-02 22:08:43 +08:00
- add option `WithInitialOffset(offset int64)` - allows to set initial offset for getUpdates method (#148) 2025-01-13 15:59:56 +08:00			`## v1.13.3 (2025-01-11)`

			- add option `WithInitialOffset(offset int64)` - allows to set initial offset for getUpdates method

changelog 2025-01-11 17:26:46 +08:00			`## v1.13.2 (2025-01-11)`

			- change field type `WebAppUser.ID` from `int` to `int64`

- add method `bot.ID() int64` - add method `bot.Token() string` 2025-01-10 17:00:32 +08:00			`## v1.13.1 (2025-01-10)`

			- add method `bot.ID() int64`
			- add method `bot.Token() string`

update changelog 2025-01-10 16:13:20 +08:00			`## v1.13.0 (2025-01-10)`

			`- support API 8.2 (#144)`
			`- fix unmarshal ChatBackground`
			`- ValidateWebappRequest - now returns model WebAppUser (#143)`

changelog 2024-12-23 16:13:28 +08:00			`## v1.12.1 (2024-12-19)`

			`- add handler type for photo captions (#138)`

8.1 (#137) * api 8.1 * readme 2024-12-19 20:12:11 +08:00			`## v1.12.0 (2024-12-19)`

			`- support API v8.1`

fix CreateNewStickerSetParams 2024-11-21 16:00:16 +08:00			`## v1.11.1 (2024-11-21)`

			`- fix CreateNewStickerSetParams (#132)`

API v8.0 (#133) * bot api 8.0 * readme 2024-11-18 16:37:50 +08:00			`## v1.11.0 (2024-11-18)`

			`- support API v8.0`

changelog 2024-11-08 16:02:23 +08:00			`## v1.10.1 (2024-11-08)`

			`- Fix arm64 panic (#130)`

v7.11 (#127) 2024-10-31 23:39:49 +08:00			`## v1.10.0 (2024-10-31)`

			`- support API v7.11`

changelog 2024-10-21 16:48:06 +08:00			`## v1.9.1 (2024-10-21)`

			- fix unmarshal `ChatBackground` type (#126)

add option WithNoAsyncHandlers 2024-10-17 16:17:15 +08:00			`## v1.9.0 (2024-10-17)`

			- IMPORTANT! New option `WithNotAsyncHandlers` allows to run handlers in the main goroutine. Now, by default, all handlers are run in separate goroutines.

changelog 2024-10-10 21:25:17 +08:00			`## v1.8.4 (2024-10-10)`

			`- add method GetBusinessConnection (#123)`

changelog 2024-10-07 16:17:58 +08:00			`## v1.8.3 (2024-10-07)`

			- add function `bot.SetToken`
			`- update GitHub action versions`

- change field type `FromChatID` from string to any for `ForwardMessageParams`, `ForwardMessagesParams`, `CopyMessageParams` and `CopyMessagesParams` params 2024-09-23 15:31:59 +08:00			`## v1.8.2 (2024-09-23)`

			- change field type `FromChatID` from string to any for `ForwardMessageParams`, `ForwardMessagesParams`, `CopyMessageParams` and `CopyMessagesParams` params

changelog 2024-09-16 17:06:25 +08:00			`## v1.8.1 (2024-09-16)`

			`- change handlers map to slice (#115)`
			`- feat: Ability to process updates across multiple gorutines (#112)`
			`- add 'HandlerTypeCallbackQueryGameShortName' (#108)`
			`- feat: add middlewares for handler (#105)`

7.10 (#114) * 7.10 * changelog 2024-09-13 20:43:05 +08:00			`## v1.8.0 (2024-09-13)`

			`- support API v7.10`
			- change type for field Type in models.Chat and models.ChatFullInfo from `string` to `models.ChatType`
			`- add consts for ChatType`
			`- models.ChatTypePrivate`
			`- models.ChatTypeGroup`
			`- models.ChatTypeSupergroup`
			`- models.ChatTypeChannel`


changelog 2024-09-10 23:25:47 +08:00			`## v1.7.3 (2024-09-10)`

			`- Fix findHandler behavior`

changelog 2024-08-23 22:13:45 +08:00			`## v1.7.2 (2024-08-23)`

			- fix: pass error with `%w` instead `%v` after rawRequest

add option `UseTestEnvironment` (#109) * add option `UseTestEnvironment` #89 * add test 2024-08-22 16:45:37 +08:00			`## v1.7.1 (2024-08-22)`

			- add option `UseTestEnvironment` for use test environment in API requests

7.9 (#103) * api 7.9 * changelog, readme 2024-08-14 21:43:42 +08:00			`## v1.7.0 (2024-08-14)`

			`- support API v7.9`

update changelog 2024-07-25 20:31:42 +08:00			`## v1.6.1 (2024-07-25)`

			`- add ValidateWebappRequest func for validate MiniApp requests`

V7.6 (#102) * add models.ParseModeMarkdownV1 const * fix typo in readme * add method SendPaidMedia * add field PaidMedia * add InvoicePayload to TransactionPartnerUser * add PaidMedia * remove comments from example * add refunded_payment * changelog, readme 2024-07-18 22:37:31 +08:00			`## v1.6.0 (2024-07-18)`

			`- support API v7.6, 7.7`
			- add const `models.ParseModeMarkdownV1`

7.5 (#98) * api v7.5 * update readme, changelog 2024-06-24 18:13:37 +08:00			`## v1.5.0 (2024-06-24)`

			`- support API v7.5`

changelog 2024-06-19 19:59:11 +08:00			`## v1.4.1 (2024-06-19)`

			`- fix: getGameHighScores returns an array of high scores instead of a single object (#94)`
			`- Use any type for ChatID in SetGameScoreParams and GetGameHighScoreParams (#88)`

Update CHANGELOG.md edit version 2024-05-29 19:09:28 +08:00			`## v1.4.0 (2024-05-29)`
7.4 (#86) * add omitempty for `provider_token` fields * add RefundStarPayment method * add effect_id to message * add message_effect_id * add show_caption_above_media * add show_caption_above_media * add types for chatAction consts * changelog, readme 2024-05-29 19:08:43 +08:00
			`- support API v7.4`

changelog 2024-05-22 22:15:30 +08:00			`## v1.3.1 (2024-05-22)`

			`- add Marshal functions for struct with many types`
			`- ChatBoostSource`
			`- ChatBackground`
			`- ChatMember`
			`- MenuButton`
			`- MaybeInaccessibleMessage`
			`- ReactionType`
			`- MessageOrigin`

support api 7.3 (#84) 2024-05-20 17:07:43 +08:00			`## v1.3.0 (2024-05-20)`

			`- support API v7.3`

changelog 2024-04-25 23:18:44 +08:00			`## v1.2.2 (2024-04-25)`

			`- fix race in test`
			`- add example inline_keyboard_multiselect`

changelog 2024-04-03 19:47:57 +08:00			`## v1.2.1 (2024-04-03)`

			`- Added error handling for specific error codes (#69)`
			`- fix: exit from waitUpdates function when context is terminated (#75)`

update readme and changelog 2024-04-02 23:12:13 +08:00			`## v1.2.0 (2024-04-02)`

			`- support API v7.2`
			`- remove worker pool`
			- add option `WithUpdatesChannelCap`

changelog 2024-03-11 16:29:18 +08:00			`## v1.1.7 (2024-03-11)`

			- add error `ErrorForbidden` for responses with error code 403
changelog 2024-04-03 19:47:57 +08:00			`- fix CopyMessages capture response`
changelog 2024-03-11 16:29:18 +08:00			`- ForwardMessages properly unmarshal result (#68)`

ForwardMessages return slice of MessageID 2024-03-05 15:51:20 +08:00			`## v1.1.6 (2024-03-05)`

			`- ForwardMessages return slice of MessageID (#66)`

changelog 2024-03-05 00:07:37 +08:00			`## v1.1.5 (2024-03-04)`

			`- add option WithAllowedUpdates (#65)`

- fix `CallbackQuery.Message` field type from `InaccessibleMessage` to `MaybeInaccessibleMessage` (#63) 2024-02-27 16:06:57 +08:00			`## v1.1.4 (2024-02-27)`

			- fix `CallbackQuery.Message` field type from `InaccessibleMessage` to `MaybeInaccessibleMessage`

changelog 2024-02-22 17:28:46 +08:00			`## v1.1.3 (2024-02-22)`

			`- fix json tag for DeleteMessagesParams.MessageIDs`

changelog 2024-02-21 17:23:17 +08:00			`## v1.1.2 (2024-02-21)`

			`- fix SetMessageReaction marshal func, fix get response for this method`

fix typo in json tag `models.UsersShared` for field UserIDs 2024-02-21 16:13:15 +08:00			`## v1.1.1 (2024-02-21)`

			- fix typo in json tag `models.UsersShared` for field UserIDs

support API v7.1 (#61) 2024-02-19 16:56:20 +08:00			`## v1.1.0 (2024-02-19)`

			`- support API v7.1`

fix: add 'omitempty' to LinkPreviewOptions.URL 2024-01-15 16:05:16 +08:00			`## v1.0.1 (2024-01-15)`

			`- fix: add 'omitempty' to LinkPreviewOptions.URL`

v7.0 (#55) * API v7.0 * readme 2024-01-10 20:16:04 +08:00			`## v1.0.0 (2024-01-10)`

			`- support API v7.0`

readme, changelog 2023-12-07 15:54:53 +08:00			`## v0.8.3 (2023-12-07)`

			`- Fix typo for setChatDescription params (#49)`
			`- add example handler_match_func`
			`- add function bot.FileDownloadLink`

Has spoiler input media (#43) * add missed field HasSpoiler to InputMedia types * changelog 2023-10-16 20:35:48 +08:00			`## v0.8.2 (2023-10-16)`

			`- add missed field HasSpoiler to InputMedia types`

changelog 2023-10-09 16:52:14 +08:00			`## v0.8.1 (2023-10-09)`

			`- json tag typo fix (#41) vvok12*`

6.9 (#40) * Added the new administrator privileges can_post_stories, can_edit_stories and can_delete_stories to the classes ChatMemberAdministrator and ChatAdministratorRights. * update PromoteChatMemberParams * update WriteAccessAllowed * update changelog, readme 2023-09-28 18:57:02 +08:00			`## v0.8.0 (2023-09-28)`

			`- support bot api 6.9`

6.8 (#38) 2023-08-24 16:29:23 +08:00			`## v0.7.15 (2023-08-24)`

			`- support bot api 6.8`

- update `defaultUpdatesChanCap` from 64 to 1024 2023-08-14 17:55:32 +08:00			`## v0.7.14 (2023-08-14)`

			- update `defaultUpdatesChanCap` from 64 to 1024

revert changes 2023-06-14 15:51:00 +08:00			`## v0.7.13 (2023-06-14)`

			- revert `v0.7.7` changes

check for empty token on bot init 2023-06-13 21:47:20 +08:00			`## v0.7.12 (2023-06-13)`

			`- check for empty token on bot init`

fixes in BotCommandScope (#37) * - add missed ChatID to BotCommandScopeChat - add missed BotCommandScopeChatAdministrators.MarshalCustom * changelog 2023-05-26 23:10:18 +08:00			`## v0.7.11 (2023-05-26)`

			`- add missed ChatID to BotCommandScopeChat`
			`- add missed BotCommandScopeChatAdministrators.MarshalCustom`

update changelog 2023-05-22 16:05:28 +08:00			`## v0.7.10 (2023-05-22)`

			- add ChatAction type with consts for `sendChatAction` method

add option WithSkipGetMe (#32) 2023-05-16 15:38:28 +08:00			`## v0.7.9 (2023-05-16)`

			- add option `WithSkipGetMe()`

changelog 2023-04-26 17:04:17 +08:00			`## v0.7.8 (2023-04-26)`

			- [BUGFIX] fix type of field `Message.ReplyMarkup` (#30)
			`- improve examples (#31)`

change `models.ReplyMarkup` from `any` to interface 2023-04-24 18:24:19 +08:00			`## v0.7.7 (2023-04-24)`

			- change `models.ReplyMarkup` from `any` to interface

bot api 6.7 (#28) 2023-04-24 14:11:48 +08:00			`## v0.7.6 (2023-04-24)`

			`- support bot api 6.7`

changelog 2023-04-13 16:45:09 +08:00			`## v0.7.5 (2023-04-13)`

			- add option `WithDebugHandler`

- add helpers `bot.True()` and `bot.False()` for define *bool values 2023-04-10 15:43:31 +08:00			`## v0.7.4 (2023-04-10)`

			- [BUGFIX] change field `SendPollParams.IsAnonymous` to *bool (#26)
			- add helpers `bot.True()` and `bot.False()` for define *bool values

make `bot.ProcessUpdate` public 2023-04-05 17:58:39 +08:00			`## v0.7.3 (2023-04-05)`

			- make `bot.ProcessUpdate` public

changelog 2023-04-03 15:13:38 +08:00			`## v0.7.2 (2023-04-03)`

			`- fix copyMessage method (#24)`

update changelog 2023-03-20 15:17:05 +08:00			`## v0.7.1 (2023-03-20)`

			`- fix field name in MenuButtonWebApp #21`

V6.6 (#20) * api v6.6 * fix some tests on golangci lint * update changelog and readme 2023-03-14 16:26:55 +08:00			`## v0.7.0 (2023-03-14)`

			`- support bot api 6.6`

changelog 2023-03-01 15:28:16 +08:00			`## v0.6.0 (2023-03-01)`

			- [BREAKING] change UserID field type in methods params and models from `int` to `int64` #19

update changelog 2023-02-10 18:02:01 +08:00			`## v0.5.1 (2023-02-10)`

			- [BUGFIX] send http.NoBody if all params fields are empty. For example, method `getMyCommands` has not required fields

api 6.5 (#16) 2023-02-06 15:54:44 +08:00			`## v0.5.0 (2023-02-06)`

			`- support bot api 6.5`

changelog 2023-02-05 18:33:28 +08:00			`## v0.4.3 (2023-02-05)`

			- [BUGFIX] SendChatAction now calls `sendChatAction` instead `sendDice`

Change field Thumb type (#13) * change Thumb fields to InputFile * change Thumb fields to InputFile * fix test 2023-01-31 04:05:50 +08:00			`## v0.4.2 (2023-01-30)`

			`- [BUGFIX] change field Thumb to InputFile type`

update changelog and readme 2023-01-19 16:42:39 +08:00			`## v0.4.1 (2023-01-19)`

			- add func `EscapeMarkdownUnescaped` for escape only unescaped symbols

update changelog 2023-01-13 22:20:47 +08:00			`## v0.4.0 (2023-01-13)`

			- [BREAKING] change some types from `int` to `int64` #11

api 6.4 2023-01-10 16:18:24 +08:00			`## v0.3.4 (2023-01-10)`

			`- support bot api 6.4`

update readme and changelog 2022-12-28 15:43:04 +08:00			`## v0.3.3 (2022-12-28)`

			- add `RegisterHandlerMatchFunc`

update changelog 2022-11-28 16:19:59 +08:00			`## v0.3.2 (2022-11-28)`

			`- fix field type SendDocumentParams.Document from string to InputFile, add example`

6.3 (#7) * support 6.3 API * update readme 2022-11-06 00:31:41 +08:00			`## v0.3.1 (2022-11-05)`

			`- support bot api 6.3`

Check on start (#6) * call getMe on New and returns error * update changelog 2022-10-14 18:48:02 +08:00			`## v0.3.0 (2022-10-14)`

			- [API CHANGE] method New now call `getMe` after init and returns error as second result on fail

v6.2 (#3) 2022-08-23 18:24:20 +08:00			`## v0.2.2 (2022-08-23)`

			`- support bot api v6.2`

bot api v6.1 (#2) 2022-07-08 17:20:49 +08:00			`## v0.2.1 (2022-07-08)`

			`- support bot api v6.1`

refactoring, add missing sticker methods 2022-05-06 17:47:43 +08:00			`## v0.2.0 (2022-05-06)`

			- change API. Use bot funcs instead of`methods` package.

changelog 2022-05-03 00:42:55 +08:00			`## v0.1.1 (2022-05-02)`

			`- add webhook support`
			`- API refactoring`
			`- use bot.GetUpdates() instead of bot.Start()`

update changelog 2022-05-02 22:08:43 +08:00			`## v0.1.0 (2022-05-02)`

			`- initial release`