Fix missing parameters, inconsistent descriptions, content type services

Author: coder2020official

telebot/__init__.py

@@ -2010,14 +2010,14 @@ def copy_message(
             ))
 
 
-    def approve_suggested_post(self, chat_id: Union[int, str], message_id: int, send_date: Optional[int]=None) -> bool:
+    def approve_suggested_post(self, chat_id: int, message_id: int, send_date: Optional[int]=None) -> bool:
         """
         Use this method to approve a suggested post in a direct messages chat. The bot must have the 'can_post_messages' administrator right in the corresponding channel chat. Returns True on success.
 
         Telegram documentation: https://core.telegram.org/bots/api#approvesuggestedpost
 
         :param chat_id: Unique identifier for the target direct messages chat
-        :type chat_id: :obj:`int` or :obj:`str`
+        :type chat_id: :obj:`int`
 
         :param message_id: Identifier of a suggested post message to approve
         :type message_id: :obj:`int`
@@ -2032,15 +2032,15 @@ def approve_suggested_post(self, chat_id: Union[int, str], message_id: int, send
         return apihelper.approve_suggested_post(self.token, chat_id, message_id,
             send_date=send_date)
 
-    def decline_suggested_post(self, chat_id: Union[int, str], message_id: int, comment: Optional[str]=None) -> bool:
+    def decline_suggested_post(self, chat_id: int, message_id: int, comment: Optional[str]=None) -> bool:
         """
         Use this method to decline a suggested post in a direct messages chat. The bot must have
         the 'can_manage_direct_messages' administrator right in the corresponding channel chat. Returns True on success.
 
         Telegram documentation: https://core.telegram.org/bots/api#declinesuggestedpost
 
         :param chat_id: Unique identifier for the target direct messages chat
-        :type chat_id: :obj:`int` or :obj:`str`
+        :type chat_id: :obj:`int`
 
         :param message_id: Identifier of a suggested post message to decline
         :type message_id: :obj:`int`

telebot/async_telebot.py

@@ -3537,14 +3537,14 @@ async def copy_message(
                                                 )
         )
 
-    async def approve_suggested_post(self, chat_id: Union[int, str], message_id: int, send_date: Optional[int]=None) -> bool:
+    async def approve_suggested_post(self, chat_id: int, message_id: int, send_date: Optional[int]=None) -> bool:
         """
         Use this method to approve a suggested post in a direct messages chat. The bot must have the 'can_post_messages' administrator right in the corresponding channel chat. Returns True on success.
 
         Telegram documentation: https://core.telegram.org/bots/api#approvesuggestedpost
 
         :param chat_id: Unique identifier for the target direct messages chat
-        :type chat_id: :obj:`int` or :obj:`str`
+        :type chat_id: :obj:`int`
 
         :param message_id: Identifier of a suggested post message to approve
         :type message_id: :obj:`int`
@@ -3559,15 +3559,15 @@ async def approve_suggested_post(self, chat_id: Union[int, str], message_id: int
         return await asyncio_helper.approve_suggested_post(self.token, chat_id, message_id,
             send_date=send_date)
 
-    async def decline_suggested_post(self, chat_id: Union[int, str], message_id: int, comment: Optional[str]=None) -> bool:
+    async def decline_suggested_post(self, chat_id: int, message_id: int, comment: Optional[str]=None) -> bool:
         """
         Use this method to decline a suggested post in a direct messages chat. The bot must have
         the 'can_manage_direct_messages' administrator right in the corresponding channel chat. Returns True on success.
 
         Telegram documentation: https://core.telegram.org/bots/api#declinesuggestedpost
 
         :param chat_id: Unique identifier for the target direct messages chat
-        :type chat_id: :obj:`int` or :obj:`str`
+        :type chat_id: :obj:`int`
 
         :param message_id: Identifier of a suggested post message to decline
         :type message_id: :obj:`int`

telebot/types.py

@@ -13097,18 +13097,19 @@ class SuggestedPostApproved(JsonDeserializable):
     :param price: Optional. Amount paid for the post
     :type price: :class:`SuggestedPostPrice`
 
-    :param send_date: Optional. Date when the post will be published
-    :type send_date: int
+    :param send_date: Date when the post will be published
+    :type send_date: :obj:`int`
 
     :return: Instance of the class
     :rtype: :class:`SuggestedPostApproved`
     """
-    def __init__(self, suggested_post_message: Optional[Message] = None,
+    def __init__(self, send_date: int,
+                    suggested_post_message: Optional[Message] = None,
                     price: Optional[SuggestedPostPrice] = None,
-                    send_date: Optional[int] = None, **kwargs):
+                    **kwargs):
         self.suggested_post_message: Optional[Message] = suggested_post_message 
         self.price: Optional[SuggestedPostPrice] = price
-        self.send_date: Optional[int] = send_date
+        self.send_date: int = send_date
 
     @classmethod
     def de_json(cls, json_string):
@@ -13130,18 +13131,24 @@ class SuggestedPostApprovalFailed(JsonDeserializable):
     :param suggested_post_message: Optional. Message containing the suggested post whose approval has failed. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.
     :type suggested_post_message: :class:`Message`
 
+    :param price: Expected price of the post
+    :type price: :class:`SuggestedPostPrice`
+
     :return: Instance of the class
     :rtype: :class:`SuggestedPostApprovalFailed`
     """
-    def __init__(self, suggested_post_message: Optional[Message] = None, **kwargs):
+    def __init__(self, price: SuggestedPostPrice,
+                 suggested_post_message: Optional[Message] = None, **kwargs):
         self.suggested_post_message: Optional[Message] = suggested_post_message
+        self.price: SuggestedPostPrice = price
 
     @classmethod
     def de_json(cls, json_string):
         if json_string is None: return None
         obj = cls.check_json(json_string)
         if 'suggested_post_message' in obj:
             obj['suggested_post_message'] = Message.de_json(obj['suggested_post_message'])
+        obj['price'] = SuggestedPostPrice.de_json(obj['price'])
         return cls(**obj)
 
 class SuggestedPostDeclined(JsonDeserializable):
@@ -13153,6 +13160,9 @@ class SuggestedPostDeclined(JsonDeserializable):
     :param suggested_post_message: Optional. Message containing the suggested post. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.
     :type suggested_post_message: :class:`Message`
 
+    :param comment: Optional. Comment with which the post was declined
+    :type comment: :obj:`str`
+
     :return: Instance of the class
     :rtype: :class:`SuggestedPostDeclined`
     """
@@ -13221,9 +13231,9 @@ class SuggestedPostRefunded(JsonDeserializable):
     :return: Instance of the class
     :rtype: :class:`SuggestedPostRefunded`
     """
-    def __init__(self, suggested_post_message: Optional[Message] = None, reason: Optional[str] = None, **kwargs):
+    def __init__(self, reason: str, suggested_post_message: Optional[Message] = None, **kwargs):
         self.suggested_post_message: Optional[Message] = suggested_post_message
-        self.reason: Optional[str] = reason
+        self.reason: str = reason
 
     @classmethod
     def de_json(cls, json_string):

telebot/util.py

@@ -41,7 +41,9 @@
     'chat_background_set', 'forum_topic_created', 'forum_topic_closed', 'forum_topic_reopened', 'forum_topic_edited',
     'general_forum_topic_hidden', 'general_forum_topic_unhidden', 'write_access_allowed', 'users_shared', 'chat_shared',
     'giveaway_created', 'giveaway_winners', 'giveaway_completed', 'boost_added', 'paid_message_price_changed',
-    'checklist_tasks_done', 'checklist_tasks_added', 'direct_message_price_changed',
+    'checklist_tasks_done', 'checklist_tasks_added', 'direct_message_price_changed', 'suggested_post_refunded',
+    'suggested_post_info', 'suggested_post_approved', 'suggested_post_approval_failed', 'suggested_post_declined',
+    'suggested_post_paid'
 ]
 
 #: All update types, should be used for allowed_updates parameter in polling.