botapi-py 1.5.11__tar.gz → 1.5.12__tar.gz

{botapi_py-1.5.11 → botapi_py-1.5.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: botapi-py
-Version: 1.5.11
+Version: 1.5.12
 Summary: A simple and flexible Python library to conveniently build fast Telegram bots using the Bot API.
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.12.0

{botapi_py-1.5.11 → botapi_py-1.5.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "botapi-py"
-version = "1.5.11"
+version = "1.5.12"
 description = "A simple and flexible Python library to conveniently build fast Telegram bots using the Bot API."
 # readme = "README.md"
 # authors = [

{botapi_py-1.5.11 → botapi_py-1.5.12}/src/botapi/methods.py

@@ -26,6 +26,7 @@ from .types import (
 	TextQuote,
 	ExternalReplyInfo,
 	ReplyParameters,
+	EphemeralMessageParameters,
 	MessageOrigin,
 	_MessageOrigin,
 	MessageOriginAdapter,
@@ -77,6 +78,7 @@ from .types import (
 	ManagedBotCreated,
 	ManagedBotUpdated,
 	BotSubscriptionUpdated,
+	MessageGenerationStopped,
 	PollOptionAdded,
 	PollOptionDeleted,
 	ChatBoostAdded,
@@ -97,6 +99,7 @@ from .types import (
 	ChecklistTasksDone,
 	ChecklistTasksAdded,
 	CommunityChatAdded,
+	CommunityChatJoined,
 	CommunityChatRemoved,
 	ForumTopicCreated,
 	ForumTopicClosed,
@@ -144,6 +147,7 @@ from .types import (
 	LoginUrl,
 	SwitchInlineQueryChosenChat,
 	CopyTextButton,
+	DisabledButton,
 	CallbackQuery,
 	ForceReply,
 	Community,
@@ -288,6 +292,7 @@ from .types import (
 	RichMessage,
 	InputRichMessage,
 	InputRichMessageMedia,
+	RichMessageButton,
 	RichText,
 	_RichText,
 	RichTextAdapter,
@@ -312,6 +317,7 @@ from .types import (
 	RichTextHashtag,
 	RichTextCashtag,
 	RichTextBotCommand,
+	RichTextButton,
 	RichTextAnchor,
 	RichTextAnchorLink,
 	RichTextReference,
@@ -331,14 +337,17 @@ from .types import (
 	RichBlockAnchor,
 	RichBlockList,
 	RichBlockBlockQuotation,
+	RichBlockExpandableBlockQuotation,
 	RichBlockPullQuotation,
 	RichBlockCollage,
 	RichBlockSlideshow,
 	RichBlockTable,
 	RichBlockDetails,
 	RichBlockMap,
+	RichBlockButtons,
 	RichBlockAnimation,
 	RichBlockAudio,
+	RichBlockDocument,
 	RichBlockPhoto,
 	RichBlockVideo,
 	RichBlockVoiceNote,
@@ -356,14 +365,17 @@ from .types import (
 	InputRichBlockAnchor,
 	InputRichBlockList,
 	InputRichBlockBlockQuotation,
+	InputRichBlockExpandableBlockQuotation,
 	InputRichBlockPullQuotation,
 	InputRichBlockCollage,
 	InputRichBlockSlideshow,
 	InputRichBlockTable,
 	InputRichBlockDetails,
 	InputRichBlockMap,
+	InputRichBlockButtons,
 	InputRichBlockAnimation,
 	InputRichBlockAudio,
+	InputRichBlockDocument,
 	InputRichBlockPhoto,
 	InputRichBlockVideo,
 	InputRichBlockVoiceNote,
@@ -609,8 +621,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		entities: Optional[List[MessageEntity]] = None,
 		link_preview_options: Optional[LinkPreviewOptions] = None,
@@ -634,8 +645,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'text': text,
 			'parse_mode': parse_mode,
 			'entities': entities,
@@ -823,8 +833,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		caption: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		caption_entities: Optional[List[MessageEntity]] = None,
@@ -850,8 +859,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'photo': photo,
 			'caption': caption,
 			'parse_mode': parse_mode,
@@ -876,8 +884,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		caption: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		caption_entities: Optional[List[MessageEntity]] = None,
@@ -903,8 +910,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'live_photo': live_photo,
 			'photo': photo,
 			'caption': caption,
@@ -929,8 +935,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		caption: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		caption_entities: Optional[List[MessageEntity]] = None,
@@ -964,8 +969,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'audio': audio,
 			'caption': caption,
 			'parse_mode': parse_mode,
@@ -991,8 +995,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		thumbnail: Optional[Union[InputFile, str]] = None,
 		caption: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
@@ -1021,8 +1024,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'document': document,
 			'thumbnail': thumbnail,
 			'caption': caption,
@@ -1046,8 +1048,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		duration: Optional[int] = None,
 		width: Optional[int] = None,
 		height: Optional[int] = None,
@@ -1084,8 +1085,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'video': video,
 			'duration': duration,
 			'width': width,
@@ -1116,8 +1116,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		duration: Optional[int] = None,
 		width: Optional[int] = None,
 		height: Optional[int] = None,
@@ -1151,8 +1150,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'animation': animation,
 			'duration': duration,
 			'width': width,
@@ -1180,8 +1178,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		caption: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		caption_entities: Optional[List[MessageEntity]] = None,
@@ -1215,8 +1212,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'voice': voice,
 			'caption': caption,
 			'parse_mode': parse_mode,
@@ -1239,8 +1235,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		duration: Optional[int] = None,
 		length: Optional[int] = None,
 		thumbnail: Optional[Union[InputFile, str]] = None,
@@ -1253,10 +1248,9 @@ class Methods(core.BaseBot):
 		reply_markup: Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] = None,
 	) -> Message:
 		'''
-        As of v.4.0, Telegram clients support rounded square
-        MPEG4 videos of up to 1 minute long.
-        Use this method to send video messages. On
-        success, the sent Message is returned.
+        Use this method to send a rounded square
+        MPEG4 video of up to 1 minute long.
+        On success, the sent Message is returned.
 
         Reference: https://core.telegram.org/bots/api#sendvideonote
 		'''
@@ -1266,8 +1260,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'video_note': video_note,
 			'duration': duration,
 			'length': length,
@@ -1376,8 +1369,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		horizontal_accuracy: Optional[float] = None,
 		live_period: Optional[int] = None,
 		heading: Optional[int] = None,
@@ -1402,8 +1394,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'latitude': latitude,
 			'longitude': longitude,
 			'horizontal_accuracy': horizontal_accuracy,
@@ -1430,8 +1421,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		foursquare_id: Optional[str] = None,
 		foursquare_type: Optional[str] = None,
 		google_place_id: Optional[str] = None,
@@ -1456,8 +1446,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'latitude': latitude,
 			'longitude': longitude,
 			'title': title,
@@ -1484,8 +1473,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		last_name: Optional[str] = None,
 		vcard: Optional[str] = None,
 		disable_notification: Optional[bool] = None,
@@ -1508,8 +1496,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'phone_number': phone_number,
 			'first_name': first_name,
 			'last_name': last_name,
@@ -1684,6 +1671,8 @@ class Methods(core.BaseBot):
 		text: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		entities: Optional[List[MessageEntity]] = None,
+		can_stop: Optional[bool] = None,
+		keep_on_stop: Optional[bool] = None,
 	) -> bool:
 		'''
         Use this method to stream a partial message
@@ -1704,6 +1693,8 @@ class Methods(core.BaseBot):
 			'text': text,
 			'parse_mode': parse_mode,
 			'entities': entities,
+			'can_stop': can_stop,
+			'keep_on_stop': keep_on_stop,
 		})
 		return BoolAdapter.validate_python(response)
 
@@ -1957,6 +1948,7 @@ class Methods(core.BaseBot):
 		can_manage_topics: Optional[bool] = None,
 		can_manage_direct_messages: Optional[bool] = None,
 		can_manage_tags: Optional[bool] = None,
+		can_send_welcome_messages: Optional[bool] = None,
 	) -> bool:
 		'''
         Use this method to promote or demote a
@@ -1990,6 +1982,7 @@ class Methods(core.BaseBot):
 			'can_manage_topics': can_manage_topics,
 			'can_manage_direct_messages': can_manage_direct_messages,
 			'can_manage_tags': can_manage_tags,
+			'can_send_welcome_messages': can_send_welcome_messages,
 		})
 		return BoolAdapter.validate_python(response)
 
@@ -4345,18 +4338,19 @@ class Methods(core.BaseBot):
 		chat_id: Union[int, str],
 		receiver_user_id: int,
 		ephemeral_message_id: int,
-		text: str,
+		text: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		entities: Optional[List[MessageEntity]] = None,
+		rich_message: Optional[InputRichMessage] = None,
 		link_preview_options: Optional[LinkPreviewOptions] = None,
 		reply_markup: Optional[InlineKeyboardMarkup] = None,
 	) -> bool:
 		'''
         Use this method to edit an ephemeral text
-        message. Note that it is not guaranteed that
-        the user will receive the message edit event,
-        especially if they are offline. On success, True
-        is returned.
+        or rich message. Note that it is not
+        guaranteed that the user will receive the message
+        edit event, especially if they are offline. On
+        success, True is returned.
 
         Reference: https://core.telegram.org/bots/api#editephemeralmessagetext
 		'''
@@ -4368,6 +4362,7 @@ class Methods(core.BaseBot):
 			'text': text,
 			'parse_mode': parse_mode,
 			'entities': entities,
+			'rich_message': rich_message,
 			'link_preview_options': link_preview_options,
 			'reply_markup': reply_markup,
 		})
@@ -4408,6 +4403,7 @@ class Methods(core.BaseBot):
 		caption: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		caption_entities: Optional[List[MessageEntity]] = None,
+		show_caption_above_media: Optional[bool] = None,
 		reply_markup: Optional[InlineKeyboardMarkup] = None,
 	) -> bool:
 		'''
@@ -4427,6 +4423,7 @@ class Methods(core.BaseBot):
 			'caption': caption,
 			'parse_mode': parse_mode,
 			'caption_entities': caption_entities,
+			'show_caption_above_media': show_caption_above_media,
 			'reply_markup': reply_markup,
 		})
 		return BoolAdapter.validate_python(response)
@@ -4630,8 +4627,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
-		receiver_user_id: Optional[int] = None,
-		callback_query_id: Optional[str] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		emoji: Optional[str] = None,
 		disable_notification: Optional[bool] = None,
 		protect_content: Optional[bool] = None,
@@ -4654,8 +4650,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
-			'receiver_user_id': receiver_user_id,
-			'callback_query_id': callback_query_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'sticker': sticker,
 			'emoji': emoji,
 			'disable_notification': disable_notification,
@@ -4982,6 +4977,7 @@ class Methods(core.BaseBot):
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
+		ephemeral_message_parameters: Optional[EphemeralMessageParameters] = None,
 		disable_notification: Optional[bool] = None,
 		protect_content: Optional[bool] = None,
 		allow_paid_broadcast: Optional[bool] = None,
@@ -5005,6 +5001,7 @@ class Methods(core.BaseBot):
 			'chat_id': chat_id,
 			'message_thread_id': message_thread_id,
 			'direct_messages_topic_id': direct_messages_topic_id,
+			'ephemeral_message_parameters': ephemeral_message_parameters,
 			'rich_message': rich_message,
 			'disable_notification': disable_notification,
 			'protect_content': protect_content,
@@ -5022,6 +5019,8 @@ class Methods(core.BaseBot):
 		draft_id: int,
 		rich_message: InputRichMessage,
 		message_thread_id: Optional[int] = None,
+		can_stop: Optional[bool] = None,
+		keep_on_stop: Optional[bool] = None,
 	) -> bool:
 		'''
         Use this method to stream a partial rich
@@ -5041,6 +5040,8 @@ class Methods(core.BaseBot):
 			'message_thread_id': message_thread_id,
 			'draft_id': draft_id,
 			'rich_message': rich_message,
+			'can_stop': can_stop,
+			'keep_on_stop': keep_on_stop,
 		})
 		return BoolAdapter.validate_python(response)
 

{botapi_py-1.5.11 → botapi_py-1.5.12}/src/botapi/types.py

@@ -119,6 +119,7 @@ class Message(MaybeInaccessibleMessage):
 	checklist_tasks_done: Optional[ChecklistTasksDone] = Field(default=None)
 	checklist_tasks_added: Optional[ChecklistTasksAdded] = Field(default=None)
 	community_chat_added: Optional[CommunityChatAdded] = Field(default=None)
+	community_chat_joined: Optional[CommunityChatJoined] = Field(default=None)
 	community_chat_removed: Optional[CommunityChatRemoved] = Field(default=None)
 	direct_message_price_changed: Optional[DirectMessagePriceChanged] = Field(default=None)
 	forum_topic_created: Optional[ForumTopicCreated] = Field(default=None)
@@ -1011,6 +1012,7 @@ class ChatMemberAdministrator(ChatMember):
 	can_post_stories: bool
 	can_edit_stories: bool
 	can_delete_stories: bool
+	can_send_welcome_messages: bool
 	can_post_messages: Optional[bool] = Field(default=None)
 	can_edit_messages: Optional[bool] = Field(default=None)
 	can_pin_messages: Optional[bool] = Field(default=None)
@@ -1584,7 +1586,7 @@ _InputStoryContent = Union[
 InputStoryContentAdapter = TypeAdapter[_InputStoryContent](_InputStoryContent) 
 
 class RichText(BaseModel):	
-	type: Literal['bold', 'italic', 'underline', 'strikethrough', 'spoiler', 'date_time', 'text_mention', 'subscript', 'superscript', 'marked', 'code', 'custom_emoji', 'mathematical_expression', 'url', 'email_address', 'phone_number', 'bank_card_number', 'mention', 'hashtag', 'cashtag', 'bot_command', 'anchor', 'anchor_link', 'reference', 'reference_link']
+	type: Literal['bold', 'italic', 'underline', 'strikethrough', 'spoiler', 'date_time', 'text_mention', 'subscript', 'superscript', 'marked', 'code', 'custom_emoji', 'mathematical_expression', 'url', 'email_address', 'phone_number', 'bank_card_number', 'mention', 'hashtag', 'cashtag', 'bot_command', 'button', 'anchor', 'anchor_link', 'reference', 'reference_link']
 
 class RichTextBold(RichText):
 	'''
@@ -1809,6 +1811,16 @@ class RichTextBotCommand(RichText):
 	text: _RichText
 	bot_command: str 
 
+class RichTextButton(RichText):
+	'''
+    A button.
+
+    Reference: https://core.telegram.org/bots/api#richtextbutton
+	'''
+
+	type: Literal['button'] = 'button' # pyright: ignore[reportIncompatibleVariableOverride]
+	button: RichMessageButton 
+
 class RichTextAnchor(RichText):
 	'''
     An anchor.
@@ -1874,6 +1886,7 @@ _RichText = Union[
 	RichTextHashtag,
 	RichTextCashtag,
 	RichTextBotCommand,
+	RichTextButton,
 	RichTextAnchor,
 	RichTextAnchorLink,
 	RichTextReference,
@@ -1882,7 +1895,7 @@ _RichText = Union[
 RichTextAdapter = TypeAdapter[_RichText](_RichText) 
 
 class RichBlock(BaseModel):	
-	type: Literal['paragraph', 'heading', 'pre', 'footer', 'divider', 'mathematical_expression', 'anchor', 'list', 'blockquote', 'pullquote', 'collage', 'slideshow', 'table', 'details', 'map', 'animation', 'audio', 'photo', 'video', 'voice_note', 'thinking']
+	type: Literal['paragraph', 'heading', 'pre', 'footer', 'divider', 'mathematical_expression', 'anchor', 'list', 'blockquote', 'expandable_blockquote', 'pullquote', 'collage', 'slideshow', 'table', 'details', 'map', 'buttons', 'animation', 'audio', 'document', 'photo', 'video', 'voice_note', 'thinking']
 
 class RichBlockParagraph(RichBlock):
 	'''
@@ -1984,6 +1997,18 @@ class RichBlockBlockQuotation(RichBlock):
 	blocks: List[_RichBlock]
 	credit: Optional[_RichText] = Field(default=None) 
 
+class RichBlockExpandableBlockQuotation(RichBlock):
+	'''
+    A block quotation, corresponding to the HTML tag
+    <blockquote> with custom attribute "collapsed".
+
+    Reference: https://core.telegram.org/bots/api#richblockexpandableblockquotation
+	'''
+
+	type: Literal['expandable_blockquote'] = 'expandable_blockquote' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	credit: Optional[_RichText] = Field(default=None) 
+
 class RichBlockPullQuotation(RichBlock):
 	'''
     A quotation with centered text, loosely corresponding to
@@ -2031,6 +2056,7 @@ class RichBlockTable(RichBlock):
 	cells: List[List[RichBlockTableCell]]
 	is_bordered: Optional[bool] = Field(default=None)
 	is_striped: Optional[bool] = Field(default=None)
+	is_compact: Optional[bool] = Field(default=None)
 	caption: Optional[_RichText] = Field(default=None) 
 
 class RichBlockDetails(RichBlock):
@@ -2061,6 +2087,19 @@ class RichBlockMap(RichBlock):
 	height: int
 	caption: Optional[RichBlockCaption] = Field(default=None) 
 
+class RichBlockButtons(RichBlock):
+	'''
+    A block containing a list of buttons that
+    are shown in one row, corresponding to the
+    custom HTML tag <tg-button-row>.
+
+    Reference: https://core.telegram.org/bots/api#richblockbuttons
+	'''
+
+	type: Literal['buttons'] = 'buttons' # pyright: ignore[reportIncompatibleVariableOverride]
+	buttons: List[RichMessageButton]
+	align: Optional[str] = Field(default=None) 
+
 class RichBlockAnimation(RichBlock):
 	'''
     A block with an animation, corresponding to the
@@ -2086,6 +2125,18 @@ class RichBlockAudio(RichBlock):
 	audio: Audio
 	caption: Optional[RichBlockCaption] = Field(default=None) 
 
+class RichBlockDocument(RichBlock):
+	'''
+    A block with a general file, corresponding to
+    the custom HTML tag <tg-document>.
+
+    Reference: https://core.telegram.org/bots/api#richblockdocument
+	'''
+
+	type: Literal['document'] = 'document' # pyright: ignore[reportIncompatibleVariableOverride]
+	document: Document
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
 class RichBlockPhoto(RichBlock):
 	'''
     A block with a photo, corresponding to the
@@ -2149,14 +2200,17 @@ _RichBlock = Union[
 	RichBlockAnchor,
 	RichBlockList,
 	RichBlockBlockQuotation,
+	RichBlockExpandableBlockQuotation,
 	RichBlockPullQuotation,
 	RichBlockCollage,
 	RichBlockSlideshow,
 	RichBlockTable,
 	RichBlockDetails,
 	RichBlockMap,
+	RichBlockButtons,
 	RichBlockAnimation,
 	RichBlockAudio,
+	RichBlockDocument,
 	RichBlockPhoto,
 	RichBlockVideo,
 	RichBlockVoiceNote,
@@ -2165,7 +2219,7 @@ _RichBlock = Union[
 RichBlockAdapter = TypeAdapter[_RichBlock](_RichBlock) 
 
 class InputRichBlock(BaseModel):	
-	type: Literal['paragraph', 'heading', 'pre', 'footer', 'divider', 'mathematical_expression', 'anchor', 'list', 'blockquote', 'pullquote', 'collage', 'slideshow', 'table', 'details', 'map', 'animation', 'audio', 'photo', 'video', 'voice_note', 'thinking']
+	type: Literal['paragraph', 'heading', 'pre', 'footer', 'divider', 'mathematical_expression', 'anchor', 'list', 'blockquote', 'expandable_blockquote', 'pullquote', 'collage', 'slideshow', 'table', 'details', 'map', 'buttons', 'animation', 'audio', 'document', 'photo', 'video', 'voice_note', 'thinking']
 
 class InputRichBlockParagraph(InputRichBlock):
 	'''
@@ -2267,6 +2321,18 @@ class InputRichBlockBlockQuotation(InputRichBlock):
 	blocks: List[_InputRichBlock]
 	credit: Optional[_RichText] = Field(default=None) 
 
+class InputRichBlockExpandableBlockQuotation(InputRichBlock):
+	'''
+    A block quotation, corresponding to the HTML tag
+    <blockquote> with custom attribute "collapsed".
+
+    Reference: https://core.telegram.org/bots/api#inputrichblockexpandableblockquotation
+	'''
+
+	type: Literal['expandable_blockquote'] = 'expandable_blockquote' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	credit: Optional[_RichText] = Field(default=None) 
+
 class InputRichBlockPullQuotation(InputRichBlock):
 	'''
     A quotation with centered text, loosely corresponding to
@@ -2314,6 +2380,7 @@ class InputRichBlockTable(InputRichBlock):
 	cells: List[List[RichBlockTableCell]]
 	is_bordered: Optional[bool] = Field(default=None)
 	is_striped: Optional[bool] = Field(default=None)
+	is_compact: Optional[bool] = Field(default=None)
 	caption: Optional[_RichText] = Field(default=None) 
 
 class InputRichBlockDetails(InputRichBlock):
@@ -2342,11 +2409,24 @@ class InputRichBlockMap(InputRichBlock):
 
 	type: Literal['map'] = 'map' # pyright: ignore[reportIncompatibleVariableOverride]
 	location: Location
-	zoom: int
-	width: int
-	height: int
+	zoom: Optional[int] = Field(default=None)
+	width: Optional[int] = Field(default=None)
+	height: Optional[int] = Field(default=None)
 	caption: Optional[RichBlockCaption] = Field(default=None) 
 
+class InputRichBlockButtons(InputRichBlock):
+	'''
+    A block containing a list of buttons that
+    are shown in one row, corresponding to the
+    custom HTML tag <tg-button-row>.
+
+    Reference: https://core.telegram.org/bots/api#inputrichblockbuttons
+	'''
+
+	type: Literal['buttons'] = 'buttons' # pyright: ignore[reportIncompatibleVariableOverride]
+	buttons: List[RichMessageButton]
+	align: Optional[str] = Field(default=None) 
+
 class InputRichBlockAnimation(InputRichBlock):
 	'''
     A block with an animation, corresponding to the
@@ -2371,6 +2451,18 @@ class InputRichBlockAudio(InputRichBlock):
 	audio: InputMediaAudio
 	caption: Optional[RichBlockCaption] = Field(default=None) 
 
+class InputRichBlockDocument(InputRichBlock):
+	'''
+    A block with a general file, corresponding to
+    the custom HTML tag <tg-document>.
+
+    Reference: https://core.telegram.org/bots/api#inputrichblockdocument
+	'''
+
+	type: Literal['document'] = 'document' # pyright: ignore[reportIncompatibleVariableOverride]
+	document: InputMediaDocument
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
 class InputRichBlockPhoto(InputRichBlock):
 	'''
     A block with a photo, corresponding to the
@@ -2432,14 +2524,17 @@ _InputRichBlock = Union[
 	InputRichBlockAnchor,
 	InputRichBlockList,
 	InputRichBlockBlockQuotation,
+	InputRichBlockExpandableBlockQuotation,
 	InputRichBlockPullQuotation,
 	InputRichBlockCollage,
 	InputRichBlockSlideshow,
 	InputRichBlockTable,
 	InputRichBlockDetails,
 	InputRichBlockMap,
+	InputRichBlockButtons,
 	InputRichBlockAnimation,
 	InputRichBlockAudio,
+	InputRichBlockDocument,
 	InputRichBlockPhoto,
 	InputRichBlockVideo,
 	InputRichBlockVoiceNote,
@@ -3378,6 +3473,7 @@ class Update(BaseModel):
 	removed_chat_boost: Optional[ChatBoostRemoved] = Field(default=None)
 	managed_bot: Optional[ManagedBotUpdated] = Field(default=None)
 	subscription: Optional[BotSubscriptionUpdated] = Field(default=None)
+	stopped_message_generation: Optional[MessageGenerationStopped] = Field(default=None)
 	
 	@staticmethod
 	def from_dict(
@@ -3624,6 +3720,18 @@ class ReplyParameters(BaseModel):
 	checklist_task_id: Optional[int] = Field(default=None)
 	poll_option_id: Optional[str] = Field(default=None) 
 
+class EphemeralMessageParameters(BaseModel):
+	'''
+    This object describes the origin of a message.
+    It can be one of
+
+    Reference: https://core.telegram.org/bots/api#ephemeralmessageparameters
+	'''
+
+	receiver_user_id: int
+	callback_query_id: Optional[str] = Field(default=None)
+	replace_callback_query_message: Optional[bool] = Field(default=None) 
+
 class PhotoSize(BaseModel):
 	'''
     This object represents one size of a photo
@@ -3752,8 +3860,7 @@ class Video(BaseModel):
 
 class VideoNote(BaseModel):
 	'''
-    This object represents a video message (available in
-    Telegram apps as of v.4.0).
+    This object represents a video message.
 
     Reference: https://core.telegram.org/bots/api#videonote
 	'''
@@ -4064,6 +4171,18 @@ class BotSubscriptionUpdated(BaseModel):
 	invoice_payload: str
 	state: str 
 
+class MessageGenerationStopped(BaseModel):
+	'''
+    This object describes an update about a user
+    stopping message generation.
+
+    Reference: https://core.telegram.org/bots/api#messagegenerationstopped
+	'''
+
+	chat: Chat
+	draft_id: int
+	message_thread_id: Optional[int] = Field(default=None) 
+
 class PollOptionAdded(BaseModel):
 	'''
     Describes a service message about an option added
@@ -4134,18 +4253,29 @@ class ChecklistTasksAdded(BaseModel):
 
 class CommunityChatAdded(BaseModel):
 	'''
-    Describes a service message about a chat being
-    added to a community.
+    Describes a service message about a chat or
+    a bot being added to a community.
 
     Reference: https://core.telegram.org/bots/api#communitychatadded
 	'''
 
 	community: Community 
 
-class CommunityChatRemoved(BaseModel):
+class CommunityChatJoined(BaseModel):
 	'''
     Describes a service message about a chat being
-    removed from a community. Currently holds no information.
+    joined by a user from a community.
+
+    Reference: https://core.telegram.org/bots/api#communitychatjoined
+	'''
+
+	community: Community 
+
+class CommunityChatRemoved(BaseModel):
+	'''
+    Describes a service message about a chat or
+    a bot being removed from a community. Currently
+    holds no information.
 
     Reference: https://core.telegram.org/bots/api#communitychatremoved
 	'''
@@ -4629,7 +4759,8 @@ class ReplyKeyboardMarkup(BaseModel):
 	resize_keyboard: Optional[bool] = Field(default=None)
 	one_time_keyboard: Optional[bool] = Field(default=None)
 	input_field_placeholder: Optional[str] = Field(default=None)
-	selective: Optional[bool] = Field(default=None) 
+	selective: Optional[bool] = Field(default=None)
+	force_reply: Optional[bool] = Field(default=None) 
 
 class KeyboardButton(BaseModel):
 	'''
@@ -4749,6 +4880,7 @@ class InlineKeyboardMarkup(BaseModel):
 	'''
 
 	inline_keyboard: List[List[InlineKeyboardButton]]
+	force_reply: Optional[bool] = Field(default=None)
 	
 	@staticmethod
 	def from_dict(
@@ -4787,17 +4919,18 @@ class InlineKeyboardButton(BaseModel):
 	switch_inline_query_chosen_chat: Optional[SwitchInlineQueryChosenChat] = Field(default=None)
 	copy_text: Optional[CopyTextButton] = Field(default=None)
 	callback_game: Optional[CallbackGame] = Field(default=None)
-	pay: Optional[bool] = Field(default=None) 
+	pay: Optional[bool] = Field(default=None)
+	disabled: Optional[DisabledButton] = Field(default=None) 
 
 class LoginUrl(BaseModel):
 	'''
     This object represents a parameter of the inline
     keyboard button used to automatically authorize a user.
-    Serves as a great replacement for the Telegram
-    Login Widget when the user is coming from
-    Telegram. All the user needs to do is
-    tap/click a button and confirm that they want
-    to log in:
+    It serves as a great replacement for the
+    Telegram Login Widget when the user is coming
+    from Telegram. All the user needs to do
+    is tap/click a button and confirm that they
+    want to log in:
 
     Reference: https://core.telegram.org/bots/api#loginurl
 	'''
@@ -4832,6 +4965,17 @@ class CopyTextButton(BaseModel):
 
 	text: str 
 
+class DisabledButton(BaseModel):
+	'''
+    This object represents a disabled button which does
+    nothing. Currently holds no information.
+
+    Reference: https://core.telegram.org/bots/api#disabledbutton
+	'''
+
+	pass
+ 
+
 class CallbackQuery(BaseModel):
 	'''
     This object represents an incoming callback query from
@@ -4933,6 +5077,7 @@ class ChatAdministratorRights(BaseModel):
 	can_post_stories: bool
 	can_edit_stories: bool
 	can_delete_stories: bool
+	can_send_welcome_messages: bool
 	can_post_messages: Optional[bool] = Field(default=None)
 	can_edit_messages: Optional[bool] = Field(default=None)
 	can_pin_messages: Optional[bool] = Field(default=None)
@@ -5349,6 +5494,9 @@ class UniqueGiftInfo(BaseModel):
 
 	gift: UniqueGift
 	origin: str
+	text: Optional[str] = Field(default=None)
+	entities: Optional[List[MessageEntity]] = Field(default=None)
+	is_private: Optional[bool] = Field(default=None)
 	last_resale_currency: Optional[str] = Field(default=None)
 	last_resale_amount: Optional[int] = Field(default=None)
 	owned_gift_id: Optional[str] = Field(default=None)
@@ -5757,7 +5905,29 @@ class InputRichMessageMedia(BaseModel):
 	'''
 
 	id: str
-	media: Union[InputMediaAnimation, InputMediaAudio, InputMediaPhoto, InputMediaVideo, InputMediaVoiceNote] 
+	media: Union[InputMediaAnimation, InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo, InputMediaVoiceNote] 
+
+class RichMessageButton(BaseModel):
+	'''
+    This object represents a button in a RichMessage.
+    Exactly one of the fields other than text
+    and style must be used to specify the
+    type of the button.
+
+    Reference: https://core.telegram.org/bots/api#richmessagebutton
+	'''
+
+	text: _RichText
+	style: Optional[str] = Field(default=None)
+	url: Optional[str] = Field(default=None)
+	callback_data: Optional[str] = Field(default=None)
+	web_app: Optional[WebAppInfo] = Field(default=None)
+	login_url: Optional[LoginUrl] = Field(default=None)
+	switch_inline_query: Optional[str] = Field(default=None)
+	switch_inline_query_current_chat: Optional[str] = Field(default=None)
+	switch_inline_query_chosen_chat: Optional[SwitchInlineQueryChosenChat] = Field(default=None)
+	copy_text: Optional[CopyTextButton] = Field(default=None)
+	disabled: Optional[DisabledButton] = Field(default=None) 
 
 class RichBlockCaption(BaseModel):
 	'''