abeya-tg-api 0.0.1-security → 1.0.0

package/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,68 @@
+<!--
+This template includes three sections:
+1. Bug reporting
+2. Feature request
+3. Question
+
+Please remove sections that do not apply to your issue
+-->
+
+
+
+<!--********************************************************************
+Reporting a Bug.
+*********************************************************************-->
+
+> Bug Report
+
+I have read:
+
+* [Usage information](https://github.com/yagop/node-telegram-bot-api/tree/master/doc/usage.md)
+* [Help information](https://github.com/yagop/node-telegram-bot-api/tree/master/doc/help.md)
+
+I am using the latest version of the library.
+
+### Expected Behavior
+
+<!-- Explain what you are trying to achieve -->
+
+### Actual Behavior
+
+<!-- Explain what happens, contrary to what you expected -->
+
+### Steps to reproduce the Behavior
+
+<!-- Explain how we can reproduce the bug -->
+
+
+
+<!--********************************************************************
+Feature Request.
+*********************************************************************-->
+
+> Feature Request
+
+I have:
+
+* searched for such a feature request (https://github.com/yagop/node-telegram-bot-api/labels/enhancement) and found none
+
+### Introduction
+
+<!-- Describe what value this feature would add, and in which use case,
+or scenario -->
+
+### Example
+
+<!-- A code snippet of how this feature would work, were it already
+implemented -->
+
+
+
+<!--********************************************************************
+Question.
+*********************************************************************-->
+
+> Question
+
+<!-- Ask your question here. Please be precise, adding as much detail
+as necessary. Also, add a code snippet(s) if possible. -->

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+<!--
+Mark whichever option below applies to this PR.
+For example, if your PR passes all tests, you would mark the option as so:
+- [x] All tests pass
+Note the 'x' in between the square brackets '[]'
+-->
+- [ ] All tests pass
+- [ ] I have run `npm run doc`
+
+### Description
+
+<!-- Explain what you are trying to achieve with this PR -->
+
+### References
+
+<!--
+Add references to other documents/pages that are relevant to this
+PR, such as related issues, documentation, etc.
+
+For example,
+* Issue #1: https://github.com/yagop/node-telegram-bot-api/issues/1
+* Telegram Bot API - Getting updates: https://core.telegram.org/bots/api#getting-updates
+-->

package/CHANGELOG.md

@@ -0,0 +1,565 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+This project adheres to [Semantic Versioning](http://semver.org/).
+
+## [0.68.0][0.68.0] - UNRELEASE
+
+1. Support Telegram Bot API 9.1 (@danielperez9430)
+   * sendChecklist
+   * editMessageChecklist
+   * getMyStarBalance
+
+2. Support Telegram Bot API 9.0 (@danielperez9430)
+   * readBusinessMessage
+   * deleteBusinessMessages
+   * setBusinessAccountName
+   * setBusinessAccountUsername
+   * setBusinessAccountBio
+   * setBusinessAccountProfilePhoto
+   * removeBusinessAccountProfilePhoto
+   * setBusinessAccountGiftSettings
+   * getBusinessAccountStarBalance
+   * transferBusinessAccountStars
+   * getBusinessAccountGifts
+   * convertGiftToStars
+   * upgradeGift
+   * transferGift
+   * postStory
+   * editStory
+   * deleteStory
+   * giftPremiumSubscription
+
+3. Support Telegram Bot API 8.2 and 8.3 (@danielperez9430)
+   * verifyUser
+   * verifyChat
+   * removeUserVerification
+   * removeChatVerification
+
+4. Support Telegram Bot API 8.0 and 8.1
+   * savePreparedInlineMessage (@IsmailBinMujeeb & @danielperez9430)
+   * setUserEmojiStatus (@danielperez9430)
+   * editUserStarSubscription (@danielperez9430)
+   * getAvailableGifts (@danielperez9430)
+   * sendGift (@danielperez9430)
+
+5. Support Telegram Bot API 7.10 (@danielperez9430)
+  * Update: `purchased_paid_media`
+
+6. Support Telegram Bot API 7.6 (@danielperez9430)
+   * sendPaidMedia
+
+## [0.67.0][0.67.0] - 2024-05-30
+
+1. Support Telegram Bot API 7.4 (@danielperez9430)
+  * refundStarPayment
+  
+## [0.66.0][0.66.0] - 2024-05-03
+
+1. Support Telegram Bot API 7.2 & 7.3 (@danielperez9430)
+  * getBusinessConnection
+  * replaceStickerInSet
+
+2. Support for updates: (@danielperez9430)
+  * business_connection
+  * business_message
+  * edited_business_message
+  * deleted_business_messages
+
+3. Minor fixes: (@danielperez9430)
+  * getUserChatBoosts
+
+## [0.65.1][0.65.1] - 2024-03-09
+
+1. Support for updates (@danielperez9430)
+  * message_reaction
+  * message_reaction_count
+  * chat_boost
+  * removed_chat_boost
+
+## [0.65.0][0.65.0] - 2024-02-20
+
+1. Support Telegram Bot API v7.1
+  * deleteMessages (@Sp3ricka)
+  * copyMessages (@xjx0106 & @Sp3ricka)
+  * setMessageReaction (@Sp3ricka)
+  * forwardMessages (@danielperez9430)
+  * getUserChatBoosts (@danielperez9430)
+
+2. Minor changes: (@danielperez9430)
+  * Refactor methods order
+  * Fix copyMessages & setMessageReaction methods
+  * Added missing tests 
+  * Fix tests for methods copyMessages & getMyDefaulAdministratorRights
+
+## [0.64.0][0.64.0] - 2023-10-25
+
+1. Replace `request` with a maintained version (@danielperez9430)
+ * Change `request` to `@cypress/request`
+ * Change `request-promise` to `@cypress/request-promise`
+
+## [0.63.0][0.63.0] - 2023-08-23
+
+1. Support Telegram Bot API v6.8 (@danielperez9430)
+ * unpinAllGeneralForumTopicMessages
+
+## [0.62.0][0.62.0] - 2023-03-19
+
+1. Support Telegram Bot API v6.6 & v6.7 (@danielperez9430)
+ * setMyDescription
+ * getMyDescription
+ * setMyShortDescription
+ * getMyShortDescription
+ * setCustomEmojiStickerSetThumbnail
+ * setStickerSetTitle
+ * deleteStickerSet 
+ * setStickerEmojiList 
+ * setStickerKeywords 
+ * setStickerMaskPosition 
+
+## [0.61.0][0.61.0] - 2022-12-30
+
+1. Support Telegram Bot API v6.4 (@danielperez9430)
+ * editGeneralForumTopic
+ * closeGeneralForumTopic
+ * reopenGeneralForumTopic
+ * hideGeneralForumTopic
+ * unhideGeneralForumTopic
+
+2. Minor changes: (@danielperez9430)
+ * The parameters `name` and `icon_custom_emoji_id` of the method `editForumTopic` are now optional.
+ * Fix add thumb in sendAudio, sendVideo and sendVideoNote
+ * Fix getMyCommands and setMyCommands
+ * Suggested tip amounts stringify in sendInvoice
+
+## [0.60.0][0.60.0] - 2022-10-06
+
+1. Support Telegram Bot API v6.3 (@danielperez9430)
+ * createForumTopic
+ * closeForumTopic
+ * reopenForumTopic
+ * deleteForumTopic
+ * unpinAllForumTopicMessages
+ * getForumTopicIconStickers
+
+2. Fix test getMyDefaultAdministratorRights (@danielperez9430)
+
+3. Fix parse entities - (@toniop99)
+
+## [0.59.0][0.59.0] - 2022-08-15
+
+1. Support Telegram Bot API v6.2 (@danielperez9430)
+ * getCustomEmojiStickers
+
+2. Support test enviroment (@tinsaeDev & @kamikazechaser)
+
+3. Remove dependencies: (@danielperez9430)
+   * Remove *bluebird* => Use NodeJS Native Promises
+   * Remove *depd* => Use node native deprecate util for warnings
+   * Remove contributor dev dependency and add list of contributors in the readme
+
+4. Remove legacy methods: (@danielperez9430)
+  * getChatMembersCount
+  * kickChatMember
+
+5. Docs: (@danielperez9430)
+ * Update the docs of the methods
+ * Order methods follow the Telegram bot API docs in src/telegram.js
+ * Update README
+
+6. Fix: (@danielperez9430)
+ * addStickerToSet() -> Allow to send tgs_sticker + webm_sticker
+ * Remove mandatory param “start_parameter” from sendInvoice, because in the docs is a optional param
+ * getStickerSet test fix deprecated response value "contains_masks" change to "sticker_type"
+ * Fix some other tests
+
+7. New Test: (@danielperez9430)
+ * deleteStickerFromSet
+ * setStickerPositionInSet
+ * getCustomEmojiStickers
+
+## [0.58.0][0.58.0] - 2022-06-22
+
+1. Support Bot API v6.1: (@danielperez9430)
+   * Add method *createInvoiceLink()*
+
+2. Support for setStickerSetThumb (@elihaidv)
+
+3. Add new test (@danielperez9430)
+   * createInvoiceLink
+
+4. Test fixes (@danielperez9430)
+   * sendVideoNote
+   * createNewStickerSet
+   * setStickerSetThumb
+   * getChatMenuButton
+   * setWebHook
+
+5. Bug fixes (@danielperez9430)
+   * answerWebAppQuery
+   * Support for send thumb in sendAudio 
+
+## [0.57.0][0.57.0] - 2022-04-23
+
+Added:
+
+1. Support Bot API v6: (@danielperez9430)
+
+   * Add method *setChatMenuButton()*
+   * Add method *getChatMenuButton()*
+   * Add method *setMyDefaultAdministratorRights()*
+   * Add method *getMyDefaultAdministratorRights()*
+   * Add method *answerWebAppQuery()*
+   * Renamed the fields voice_chat_scheduled, voice_chat_started, voice_chat_ended, and voice_chat_participants_invited to video_chat_scheduled, video_chat_started, video_chat_ended, and video_chat_participants_invited 
+
+
+   Tests:
+
+   * answerWebAppQuery
+   * setChatMenuButton
+   * getChatMenuButton
+   * setMyDefaultAdministratorRights
+   * getMyDefaultAdministratorRights
+
+## [0.56.0][0.56.0] - 2021-12-07
+
+Added:
+
+1. Support Bot API v5.5: (@danielperez9430)
+
+   * Add method *banChatSenderChat()*
+   * Add method *unbanChatSenderChat()*
+
+   Fixes:
+
+   * Tests for support with new invite link format
+
+## [0.55.0][0.55.0] - 2021-11-06
+
+Added:
+
+1. Support Bot API v5.4: (@danielperez9430)
+
+   * Add method *approveChatJoinRequest()*
+   * Add method *declineChatJoinRequest()*
+   * Add support for new updates:
+     * *chat_join_request*
+   
+   Fixes:
+
+   * Method *editMessageMedia*: Now you can send a local file (`"attach://" + filePatch`)
+
+## [0.54.0][0.54.0] - 2021-06-29
+
+Added:
+
+1. Support Bot API v5.3: (@danielperez9430)
+
+   * Add method *deleteMyCommands()*
+   * Add method *banChatMember()*
+   * Add method *getChatMemberCount()*
+
+   New Test:
+   
+   * deleteMyCommands
+   * banChatMember
+   * getChatMemberCount
+
+   Deprecated:
+   * Method *kickChatMember()*
+   * Method *getChatMembersCount()*
+
+## [0.53.0][0.53.0] - 2021-04-26
+
+Added:
+
+1. Support Bot API v5.2:(@danielperez9430)
+
+   * Add support for new messageTypes:
+     * *voice_chat_scheduled*
+
+## [0.52.0][0.52.0] - 2021-03-20
+
+Added:
+
+1. Support Bot API v5.1: (by @danielperez9430)
+   
+   * Add method *createChatInviteLink()*
+   * Add method *editChatInviteLink()*
+   * Add method *revokeChatInviteLink()*
+   * Add support for new messageTypes:
+     * *voice_chat_started*
+     * *voice_chat_ended*
+     * *voice_chat_participants_invited*
+     * *message_auto_delete_timer_changed*
+     * *chat_invite_link*
+     * *chat_member_updated*
+   * Add support for new updates:
+     * *my_chat_member*
+     * *chat_member*
+   
+   New Test: (by @danielperez9430)
+   
+   * createChatInviteLink
+   * editChatInviteLink
+   * revokeChatInviteLink
+
+## [0.51.0][0.51.0] - 2020-11-04
+
+Added:
+
+1. Support Bot API v5.0: (by @danielperez9430)
+   
+   * Add method *copyMessage()*
+   * Add method *unpinAllChatMessages()*
+   * Add method *close()*
+   * Add method *logOut()*
+   
+   Changed: (by @danielperez9430)
+   
+   * Remove trailing-spaces
+   * Fix Bugs in Test
+   
+   New Test: (by @danielperez9430)
+   
+   * copyMessage
+   * unpinAllChatMessages
+
+## [0.50.0][0.50.0] - 2020-05-2020
+
+Added:
+
+1. Support Bot API v4.8: (by @danielperez9430)
+   * Add methods: *sendDice()*
+2. Support Bot API v4.7: (by @danielperez9430)
+   * Add methods: *getMyCommands()*,*setMyCommands()*
+3. Support Bot API v4.5: (by @danielperez9430)
+   * Add methods: *setChatAdministratorCustomTitle()*
+4. Support Bot API v4.4: (by @danielperez9430)
+   * Add methods: *setChatPermissions()*
+5. Support for poll_answer (by @JieJiSS)
+6. Add request options in file stream (by @zhangpanyi )
+
+Changed: (by @danielperez9430)
+
+* New message type: *dice*
+* Fix Bugs in tests
+* Fix regex compare (by @ledamint)
+* Fix listening for error events when downloading files (by @Kraigo)
+
+New Test: (by @danielperez9430)
+
+* sendDice
+* getMyCommands
+* setMyCommands
+* setChatAdministratorCustomTitle
+* setChatPermissions
+
+## [0.40.0][0.40.0] - 2019-05-04
+
+Added:
+
+1. Support Bot API v4.2: (by @kamikazechaser)
+   * Add methods: *TelegramBot#sendPoll()*, *TelegramBot#stopPoll()*
+   * Support events: *poll*
+2. Support Bot API v4.0: (by @kamikazechaser)
+   * Add methods: *TelegramBot#editMessageMedia()*, *TelegramBot#sendAnimation()*
+   * Support new message types: *passport_data*, *animation*
+
+* * *
+
+## [0.30.0][0.30.0] - 2017-12-21
+
+Added:
+
+1. Support Bot API v3.5: (by @GochoMugo)
+   * Allow `provider_data` parameter in *TelegramBot#sendInvoice*
+   * Add method *TelegramBot#sendMediaGroup()*
+2. Support Bot API v3.4: (by @kamikazechaser)
+   * Add methods *TelegramBot#editMessageLiveLocation*, *TelegramBot#stopMessageLiveLocation* (#439)
+   * Add methods *TelegramBot#setChatStickerSet*, *TelegramBot#deleteChatStickerSet* (#440)
+3. Add methods:
+   * *TelegramBot#getFileStream* (#442) (by @GochoMugo, requested-by @Xaqron)
+4. Add options to *TelegramBot#stopPolling()* (by @GochoMugo)
+5. Add `metadata` argument in `message` event (and friends e.g. `text`, `audio`, etc.) (#409) (by @jlsjonas, @GochoMugo)
+6. Add forward-compatibility i.e. support future additional Telegram options (by @GochoMugo)
+7. Add support for Node.js v9 (by @GochoMugo)
+8. Document *TelegramBot.errors*, *TelegramBot.messageTypes* (by @GochoMugo)
+
+Changed:
+
+1. Update *TelegramBot#answerCallbackQuery()* signature (by @GochoMugo)
+2. Improve default error logging of `polling_error` and `webhook_error` (#377)
+3. Update dependencies
+
+Deprecated:
+
+1. Sending files: *(See [usage guide][usage-sending-files])* (by @hufan-akari, @GochoMugo)
+   * Error will **not** be thrown if `Buffer` is used and file-type could **not** be detected.
+   * Filename will **not** be set to `data.${ext}` if `Buffer` is used
+   * Content type will **not** default to `null` or `undefined`
+
+Fixed:
+
+1. Fix the offset infinite loop bug (#265, #36) (by @GochoMugo)
+2. Fix game example (#449, #418) (by @MCSH)
+
+* * *
+
+## [0.29.0][0.29.0] - 2017-10-22
+
+Added:
+
+1. Add Bot API v3.2 methods:
+   * (#429) *TelegramBot#getStickerSet* (by @CapacitorSet, @LibertyLocked)
+   * (#430) *TelegramBot#uploadStickerFile* (by @CapacitorSet)
+   * *TelegramBot#createNewStickerSet*, *TelegramBot#addStickerToSet*, *TelegramBot#setStickerPositionInSet*, *TelegramBot#deleteStickerFromSet* (by @GochoMugo)
+2. Supports API v3.3
+
+Deprecated:
+
+1. Auto-enabling Promise cancellation (#319) (by @GochoMugo)
+
+* * *
+
+## [0.28.0][0.28.0] - 2017-08-06
+
+Added:
+
+1. (#361) Support Bot API v3.1 (by @Lord-Protector, @kamikazechaser)
+2. (#332) Support Bot API v3.0 (by @kamikazechaser, @GochoMugo)
+3. Add *TelegramBot#removeTextListener()* (by @GochoMugo)
+4. (#342) Add game example (by @MCSH)
+5. (#315) List 'bot-brother' project in community section in README (by @saeedhei)
+
+Changed:
+
+1. (#367) Update *TelegramBot#answerCallbackQuery()* signature (by @mnb3000)
+
+Fixed:
+
+1. (#325) Fix global regexp state reset (by @Sirius-A)
+2. (#363) Fix download file path on windows (by @kucherenkovova)
+3. (#346) Fix anchor webhook link in docs (by @Coac)
+
+* * *
+
+## [0.27.1][0.27.1] - 2017-04-07
+
+Added:
+
+1. (#287) Add Express WebHook example (by @kamikazechaser)
+
+Fixed:
+
+1. (#291) Improve docs (by @preco21)
+2. (#298) Fix running on Node v5 (by @jehy)
+3. (#307) Fix badge links in README (by @JaakkoLipsanen)
+4. Fix defaulting value of `options.polling.params.timeout` (by @GochoMugo)
+5. Fix typos in Github issue template (by @GochoMugo, requested-by @GingerPlusPlus)
+
+* * *
+
+## [0.27.0][0.27.0] - 2017-02-10
+
+Added:
+
+1. Add constructor options:
+   * (#243) `options.polling.params` (by @GochoMugo, requested-by @sidelux)
+2. Add methods:
+   * (#74) *TelegramBot#removeReplyListener()* (by @githugger)
+3. (#283) Add proper error handling (by @GochoMugo)
+4. (#272) Add health-check endpoint (by @mironov)
+   * `options.webHook.healthEndpoint`
+5. (#152) Add test for TelegramBot#sendDocument() using 'fileOpts'
+   param (by @evolun)
+6. Document `options.webHook.host` (by @GochoMugo)
+7. (#264) Add Bot API version to README (by @kamikazechaser)
+8. Add examples:
+   - (#271) WebHook on Heroku (by @TheBeastOfCaerbannog)
+   - (#274) WebHook on Zeit Now (by @Ferrari)
+
+Changed:
+
+1. (#147) Use *String#indexOf()*, instead of *RegExp#test()*, to
+   find token in webhook request (by @AVVS)
+
+Fixed:
+
+* Fix bug:
+  - (#275, #280) fix es6 syntax error on Node.js v4.x (by @crazyabdul)
+  - (#276) promise.warning from `request-promise` (by @GochoMugo,
+    reported-by @preco21)
+  - (#281) fix handling error during polling (by @GochoMugo,
+    reported-by @dimawebmaker)
+  - (#284) fix error during deletion of already-set webhook, during
+    polling (by @GochoMugo, reported-by @dcparga)
+1. Fix links in documentation (by @Ni2c2k)
+
+* * *
+
+## [0.26.0][0.26.0] - 2017-01-20
+
+Added:
+
+1. Add *TelegramBot* constructor options:
+   * `options.https`
+   * `options.baseApiUrl`
+   * `options.filepath`
+2. Add methods:
+   * *TelegramBot#stopPolling()*
+   * *TelegramBot#isPolling()*
+   * *TelegramBot#openWebHook()*
+   * *TelegramBot#closeWebHook()*
+   * *TelegramBot#hasOpenWebHook()*
+   * *TelegramBot#deleteWebHook()*
+   * *TelegramBot#getWebHookInfo()*
+
+Changed:
+
+1. Use POST requests by default
+2. Ensure all relevant methods return Promises
+3. Document auto-deletion of webhook during polling
+4. Deprecate support for Node.js v0.12
+5. Fix consistency of methods signatures
+6. Rename *TelegramBot#initPolling()* to *TelegramBot#startPolling()*
+   * Deprecate *TelegramBot#initPolling()*
+
+Fixed:
+
+1. Handle error during formatting `formData`
+2. Fix ES6 syntax
+
+*Credits/Blames: Unless explicitly stated otherwise, above work was
+done by @GochoMugo*
+
+* * *
+
+## [0.25.0][0.25.0] - 2016-12-21
+
+Added:
+
+1. Supports the API v2.3 updates (by @kamikazechaser)
+2. Add *TelegramBot* constructor option:
+   * `options.request`: proxy extra request options (by @tarmolov)
+   * `options.onlyFirstMatch` (by @GingerPlusPlus)
+3. Add methods:
+   * *TelegramBot#sendVenue()* (by Tketa)
+   * *TelegramBot#sendContact()* (by @GochoMugo)
+   * *TelegramBot#getGameHighScores()* (by @jishnu7)
+
+Fixed:
+
+1. Fix request performance issue (by @preco21)
+2. Fix typos (by oflisback)
+
+[usage-sending-files]:https://github.com/yagop/node-telegram-bot-api/blob/master/doc/usage.md#sending-files-options
+
+[0.25.0]:https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.25.0
+[0.26.0]:https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.26.0
+[0.27.0]:https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.27.0
+[0.27.1]:https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.27.1
+[0.28.0]:https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.28.0
+[0.29.0]:https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.29.0
+[0.30.0]:https://github.com/yagop/node-telegram-bot-api/releases/tag/v0.30.0
+[Unreleased]:https://github.com/yagop/node-telegram-bot-api/compare/v0.30.0...master