botapi-py 1.5.9__tar.gz → 1.5.10__tar.gz

{botapi_py-1.5.9 → botapi_py-1.5.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: botapi-py
-Version: 1.5.9
+Version: 1.5.10
 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.9 → botapi_py-1.5.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "botapi-py"
-version = "1.5.9"
+version = "1.5.10"
 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.9 → botapi_py-1.5.10}/src/botapi/enums.py

@@ -133,6 +133,7 @@ class OtherMessageType(enum.StrEnum):
 	multimedia nor service content.
 	'''
 	TEXT = 'text'
+	RICH_MESSAGE = 'rich_message'
 	CHECKLIST = 'checklist'
 	POLL = 'poll'
 	GAME = 'game'

{botapi_py-1.5.9 → botapi_py-1.5.10}/src/botapi/methods.py

@@ -53,6 +53,7 @@ from .types import (
 	PaidMediaVideo,
 	Contact,
 	Dice,
+	Link,
 	PollMedia,
 	InputPollMedia,
 	_InputPollMedia,
@@ -251,6 +252,7 @@ from .types import (
 	InputMediaAnimation,
 	InputMediaAudio,
 	InputMediaDocument,
+	InputMediaLink,
 	InputMediaLivePhoto,
 	InputMediaLocation,
 	InputMediaPhoto,
@@ -278,6 +280,63 @@ from .types import (
 	StickerSet,
 	MaskPosition,
 	InputSticker,
+	RichMessage,
+	InputRichMessage,
+	RichText,
+	_RichText,
+	RichTextAdapter,
+	RichTextBold,
+	RichTextItalic,
+	RichTextUnderline,
+	RichTextStrikethrough,
+	RichTextSpoiler,
+	RichTextDateTime,
+	RichTextTextMention,
+	RichTextSubscript,
+	RichTextSuperscript,
+	RichTextMarked,
+	RichTextCode,
+	RichTextCustomEmoji,
+	RichTextMathematicalExpression,
+	RichTextUrl,
+	RichTextEmailAddress,
+	RichTextPhoneNumber,
+	RichTextBankCardNumber,
+	RichTextMention,
+	RichTextHashtag,
+	RichTextCashtag,
+	RichTextBotCommand,
+	RichTextAnchor,
+	RichTextAnchorLink,
+	RichTextReference,
+	RichTextReferenceLink,
+	RichBlockCaption,
+	RichBlockTableCell,
+	RichBlockListItem,
+	RichBlock,
+	_RichBlock,
+	RichBlockAdapter,
+	RichBlockParagraph,
+	RichBlockSectionHeading,
+	RichBlockPreformatted,
+	RichBlockFooter,
+	RichBlockDivider,
+	RichBlockMathematicalExpression,
+	RichBlockAnchor,
+	RichBlockList,
+	RichBlockBlockQuotation,
+	RichBlockPullQuotation,
+	RichBlockCollage,
+	RichBlockSlideshow,
+	RichBlockTable,
+	RichBlockDetails,
+	RichBlockMap,
+	RichBlockAnimation,
+	RichBlockAudio,
+	RichBlockPhoto,
+	RichBlockVideo,
+	RichBlockVoiceNote,
+	RichBlockThinking,
 	InlineQuery,
 	InlineQueryResultsButton,
 	InlineQueryResult,
@@ -307,6 +366,7 @@ from .types import (
 	_InputMessageContent,
 	InputMessageContentAdapter,
 	InputTextMessageContent,
+	InputRichMessageContent,
 	InputLocationMessageContent,
 	InputVenueMessageContent,
 	InputContactMessageContent,
@@ -2160,6 +2220,44 @@ class Methods(core.BaseBot):
 		})
 		return BoolAdapter.validate_python(response)
 
+	async def answer_chat_join_request_query(
+		self,
+		chat_join_request_query_id: str,
+		result: str,
+	) -> bool:
+		'''
+        Use this method to process a received chat
+        join request query. Returns True on success.
+
+        Reference: https://core.telegram.org/bots/api#answerchatjoinrequestquery
+		'''
+
+		response = await self._send_request('answerChatJoinRequestQuery', {
+			'chat_join_request_query_id': chat_join_request_query_id,
+			'result': result,
+		})
+		return BoolAdapter.validate_python(response)
+
+	async def send_chat_join_request_web_app(
+		self,
+		chat_join_request_query_id: str,
+		web_app_url: str,
+	) -> bool:
+		'''
+        Use this method to process a received chat
+        join request query by showing a Mini App
+        to the user before deciding the outcome. Returns
+        True on success.
+
+        Reference: https://core.telegram.org/bots/api#sendchatjoinrequestwebapp
+		'''
+
+		response = await self._send_request('sendChatJoinRequestWebApp', {
+			'chat_join_request_query_id': chat_join_request_query_id,
+			'web_app_url': web_app_url,
+		})
+		return BoolAdapter.validate_python(response)
+
 	async def set_chat_photo(
 		self,
 		chat_id: Union[int, str],
@@ -3881,25 +3979,26 @@ class Methods(core.BaseBot):
 
 	async def edit_message_text(
 		self,
-		text: str,
 		business_connection_id: Optional[str] = None,
 		chat_id: Optional[Union[int, str]] = None,
 		message_id: Optional[int] = None,
 		inline_message_id: Optional[str] = None,
+		text: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		entities: Optional[List[MessageEntity]] = None,
 		link_preview_options: Optional[LinkPreviewOptions] = None,
+		rich_message: Optional[InputRichMessage] = None,
 		reply_markup: Optional[InlineKeyboardMarkup] = None,
 	) -> Union[Message, bool]:
 		'''
-        Use this method to edit text and game
-        messages. On success, if the edited message is
-        not an inline message, the edited Message is
-        returned, otherwise True is returned. Note that business
-        messages that were not sent by the bot
-        and do not contain an inline keyboard can
-        only be edited within 48 hours from the
-        time they were sent.
+        Use this method to edit text, rich and
+        game messages. On success, if the edited message
+        is not an inline message, the edited Message
+        is returned, otherwise True is returned. Note that
+        business messages that were not sent by the
+        bot and do not contain an inline keyboard
+        can only be edited within 48 hours from
+        the time they were sent.
 
         Reference: https://core.telegram.org/bots/api#editmessagetext
 		'''
@@ -3913,6 +4012,7 @@ class Methods(core.BaseBot):
 			'parse_mode': parse_mode,
 			'entities': entities,
 			'link_preview_options': link_preview_options,
+			'rich_message': rich_message,
 			'reply_markup': reply_markup,
 		})
 		if isinstance(response, (dict, list)):
@@ -3973,21 +4073,22 @@ class Methods(core.BaseBot):
 		'''
         Use this method to edit animation, audio, document,
         live photo, photo, or video messages, or to
-        add media to text messages. If a message
-        is part of a message album, then it
-        can be edited only to an audio for
-        audio albums, only to a document for document
-        albums and to a photo, a live photo,
-        or a video otherwise. When an inline message
-        is edited, a new file can't be uploaded;
-        use a previously uploaded file via its file_id
-        or specify a URL. On success, if the
-        edited message is not an inline message, the
-        edited Message is returned, otherwise True is returned.
-        Note that business messages that were not sent
-        by the bot and do not contain an
-        inline keyboard can only be edited within 48
-        hours from the time they were sent.
+        replace a text or a rich message with
+        a media. If a message is part of
+        a message album, then it can be edited
+        only to an audio for audio albums, only
+        to a document for document albums and to
+        a photo, a live photo, or a video
+        otherwise. When an inline message is edited, a
+        new file can't be uploaded; use a previously
+        uploaded file via its file_id or specify a
+        URL. On success, if the edited message is
+        not an inline message, the edited Message is
+        returned, otherwise True is returned. Note that business
+        messages that were not sent by the bot
+        and do not contain an inline keyboard can
+        only be edited within 48 hours from the
+        time they were sent.
 
         Reference: https://core.telegram.org/bots/api#editmessagemedia
 		'''
@@ -4651,6 +4752,75 @@ class Methods(core.BaseBot):
 		})
 		return BoolAdapter.validate_python(response)
 
+	async def send_rich_message(
+		self,
+		chat_id: Union[int, str],
+		rich_message: InputRichMessage,
+		business_connection_id: Optional[str] = None,
+		message_thread_id: Optional[int] = None,
+		direct_messages_topic_id: Optional[int] = None,
+		disable_notification: Optional[bool] = None,
+		protect_content: Optional[bool] = None,
+		allow_paid_broadcast: Optional[bool] = None,
+		message_effect_id: Optional[str] = None,
+		suggested_post_parameters: Optional[SuggestedPostParameters] = None,
+		reply_parameters: Optional[ReplyParameters] = None,
+		reply_markup: Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] = None,
+	) -> Message:
+		'''
+        Use this method to send rich messages. If
+        the message contains a block with a media
+        element, then the bot must have the right
+        to send the media to the chat. On
+        success, the sent Message is returned.
+
+        Reference: https://core.telegram.org/bots/api#sendrichmessage
+		'''
+
+		response = await self._send_request('sendRichMessage', {
+			'business_connection_id': business_connection_id,
+			'chat_id': chat_id,
+			'message_thread_id': message_thread_id,
+			'direct_messages_topic_id': direct_messages_topic_id,
+			'rich_message': rich_message,
+			'disable_notification': disable_notification,
+			'protect_content': protect_content,
+			'allow_paid_broadcast': allow_paid_broadcast,
+			'message_effect_id': message_effect_id,
+			'suggested_post_parameters': suggested_post_parameters,
+			'reply_parameters': reply_parameters,
+			'reply_markup': reply_markup,
+		})
+		return Message.model_validate(response)
+
+	async def send_rich_message_draft(
+		self,
+		chat_id: int,
+		draft_id: int,
+		rich_message: InputRichMessage,
+		message_thread_id: Optional[int] = None,
+	) -> bool:
+		'''
+        Use this method to stream a partial rich
+        message to a user while the message is
+        being generated. Note that the streamed draft is
+        ephemeral and acts as a temporary 30-second preview
+        - once the output is finalized, you must
+        call sendRichMessage with the complete message to persist
+        it in the user's chat. Returns True on
+        success.
+
+        Reference: https://core.telegram.org/bots/api#sendrichmessagedraft
+		'''
+
+		response = await self._send_request('sendRichMessageDraft', {
+			'chat_id': chat_id,
+			'message_thread_id': message_thread_id,
+			'draft_id': draft_id,
+			'rich_message': rich_message,
+		})
+		return BoolAdapter.validate_python(response)
+
 	async def answer_inline_query(
 		self,
 		inline_query_id: str,

{botapi_py-1.5.9 → botapi_py-1.5.10}/src/botapi/types.py

@@ -63,6 +63,7 @@ class Message(MaybeInaccessibleMessage):
 	link_preview_options: Optional[LinkPreviewOptions] = Field(default=None)
 	suggested_post_info: Optional[SuggestedPostInfo] = Field(default=None)
 	effect_id: Optional[str] = Field(default=None)
+	rich_message: Optional[RichMessage] = Field(default=None)
 	animation: Optional[Animation] = Field(default=None)
 	audio: Optional[Audio] = Field(default=None)
 	document: Optional[Document] = Field(default=None)
@@ -318,7 +319,7 @@ class Message(MaybeInaccessibleMessage):
 		reply_markup: Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] = None,
 	) -> Message:
 		'''
-		Replies to this message with a text message.
+		Reply to this message with a text message.
 		Shortcut for `bot.send_message`.
 	
 		You can pass **either** `parse_mode` or `entities` to format the message text.
@@ -694,7 +695,17 @@ _InputPollMedia = Union[
 InputPollMediaAdapter = TypeAdapter[_InputPollMedia](_InputPollMedia) 
 
 class InputPollOptionMedia(BaseModel):	
-	type: Literal['animation', 'live_photo', 'location', 'photo', 'sticker', 'venue', 'video']
+	type: Literal['animation', 'link', 'live_photo', 'location', 'photo', 'sticker', 'venue', 'video']
+
+class InputMediaLink(InputPollOptionMedia):
+	'''
+    Represents an HTTP link to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmedialink
+	'''
+
+	type: Literal['link'] = 'link' # pyright: ignore[reportIncompatibleVariableOverride]
+	url: str 
 
 class InputMediaSticker(InputPollOptionMedia):
 	'''
@@ -709,6 +720,7 @@ class InputMediaSticker(InputPollOptionMedia):
 
 _InputPollOptionMedia = Union[
 	InputMediaAnimation,
+	InputMediaLink,
 	InputMediaLivePhoto,
 	InputMediaLocation,
 	InputMediaPhoto,
@@ -833,7 +845,7 @@ class ChatMember(BaseModel):
 	@property
 	def is_participant(self) -> bool:
 		'''
-		Returns a boolean indicating if the user is currently part of of the chat (i.e. not left/banned).
+		Boolean indicating if the user is currently part of of the chat (i.e. not left/banned).
 	
 		This function handles special cases, like `ChatMemberRestricted` with the `is_member` flag.
 		'''
@@ -855,7 +867,7 @@ class ChatMember(BaseModel):
 		until_date: Optional[int] = None
 	) -> bool:
 		'''
-		Bans this chat member.
+		Ban this chat member.
 		'''
 		return await bot.ban_chat_member(
 			chat_id=chat_id,
@@ -871,7 +883,7 @@ class ChatMember(BaseModel):
 		only_if_banned: Optional[bool] = None
 	) -> bool:
 		'''
-		Unbans this chat member.
+		Unban this chat member.
 		'''
 		return await bot.unban_chat_member(
 			chat_id=chat_id,
@@ -885,7 +897,7 @@ class ChatMember(BaseModel):
 		chat_id: Union[int, str]
 	) -> bool:
 		'''
-		Kicks this chat member (bans and immediately unbans).
+		Kick this chat member (ban and immediately unban).
 		'''
 		return await bot.unban_chat_member(
 			chat_id=chat_id,
@@ -900,7 +912,7 @@ class ChatMember(BaseModel):
 		until_date: Optional[int] = None
 	) -> bool:
 		'''
-		Mutes (restricts) this chat member.
+		Mute (restrict) this chat member.
 		'''
 		return await bot.restrict_chat_member(
 			chat_id=chat_id,
@@ -1567,6 +1579,587 @@ _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']
+
+class RichTextBold(RichText):
+	'''
+    A bold text.
+
+    Reference: https://core.telegram.org/bots/api#richtextbold
+	'''
+
+	type: Literal['bold'] = 'bold' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextItalic(RichText):
+	'''
+    An italicized text.
+
+    Reference: https://core.telegram.org/bots/api#richtextitalic
+	'''
+
+	type: Literal['italic'] = 'italic' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextUnderline(RichText):
+	'''
+    An underlined text.
+
+    Reference: https://core.telegram.org/bots/api#richtextunderline
+	'''
+
+	type: Literal['underline'] = 'underline' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextStrikethrough(RichText):
+	'''
+    A strikethrough text.
+
+    Reference: https://core.telegram.org/bots/api#richtextstrikethrough
+	'''
+
+	type: Literal['strikethrough'] = 'strikethrough' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextSpoiler(RichText):
+	'''
+    A text covered by a spoiler.
+
+    Reference: https://core.telegram.org/bots/api#richtextspoiler
+	'''
+
+	type: Literal['spoiler'] = 'spoiler' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextDateTime(RichText):
+	'''
+    Formatted date and time.
+
+    Reference: https://core.telegram.org/bots/api#richtextdatetime
+	'''
+
+	type: Literal['date_time'] = 'date_time' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	unix_time: int
+	date_time_format: str 
+
+class RichTextTextMention(RichText):
+	'''
+    A mention of a Telegram user by their
+    identifier.
+
+    Reference: https://core.telegram.org/bots/api#richtexttextmention
+	'''
+
+	type: Literal['text_mention'] = 'text_mention' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	user: User 
+
+class RichTextSubscript(RichText):
+	'''
+    A subscript text.
+
+    Reference: https://core.telegram.org/bots/api#richtextsubscript
+	'''
+
+	type: Literal['subscript'] = 'subscript' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextSuperscript(RichText):
+	'''
+    A superscript text.
+
+    Reference: https://core.telegram.org/bots/api#richtextsuperscript
+	'''
+
+	type: Literal['superscript'] = 'superscript' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextMarked(RichText):
+	'''
+    A marked text.
+
+    Reference: https://core.telegram.org/bots/api#richtextmarked
+	'''
+
+	type: Literal['marked'] = 'marked' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextCode(RichText):
+	'''
+    A monowidth text.
+
+    Reference: https://core.telegram.org/bots/api#richtextcode
+	'''
+
+	type: Literal['code'] = 'code' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichTextCustomEmoji(RichText):
+	'''
+    A custom emoji.
+
+    Reference: https://core.telegram.org/bots/api#richtextcustomemoji
+	'''
+
+	type: Literal['custom_emoji'] = 'custom_emoji' # pyright: ignore[reportIncompatibleVariableOverride]
+	custom_emoji_id: str
+	alternative_text: str 
+
+class RichTextMathematicalExpression(RichText):
+	'''
+    A mathematical expression.
+
+    Reference: https://core.telegram.org/bots/api#richtextmathematicalexpression
+	'''
+
+	type: Literal['mathematical_expression'] = 'mathematical_expression' # pyright: ignore[reportIncompatibleVariableOverride]
+	expression: str 
+
+class RichTextUrl(RichText):
+	'''
+    A text with a link.
+
+    Reference: https://core.telegram.org/bots/api#richtexturl
+	'''
+
+	type: Literal['url'] = 'url' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	url: str 
+
+class RichTextEmailAddress(RichText):
+	'''
+    A text with an email address.
+
+    Reference: https://core.telegram.org/bots/api#richtextemailaddress
+	'''
+
+	type: Literal['email_address'] = 'email_address' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	email_address: str 
+
+class RichTextPhoneNumber(RichText):
+	'''
+    A text with a phone number.
+
+    Reference: https://core.telegram.org/bots/api#richtextphonenumber
+	'''
+
+	type: Literal['phone_number'] = 'phone_number' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	phone_number: str 
+
+class RichTextBankCardNumber(RichText):
+	'''
+    A text with a bank card number.
+
+    Reference: https://core.telegram.org/bots/api#richtextbankcardnumber
+	'''
+
+	type: Literal['bank_card_number'] = 'bank_card_number' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	bank_card_number: str 
+
+class RichTextMention(RichText):
+	'''
+    A mention by a username.
+
+    Reference: https://core.telegram.org/bots/api#richtextmention
+	'''
+
+	type: Literal['mention'] = 'mention' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	username: str 
+
+class RichTextHashtag(RichText):
+	'''
+    A hashtag.
+
+    Reference: https://core.telegram.org/bots/api#richtexthashtag
+	'''
+
+	type: Literal['hashtag'] = 'hashtag' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	hashtag: str 
+
+class RichTextCashtag(RichText):
+	'''
+    A cashtag.
+
+    Reference: https://core.telegram.org/bots/api#richtextcashtag
+	'''
+
+	type: Literal['cashtag'] = 'cashtag' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	cashtag: str 
+
+class RichTextBotCommand(RichText):
+	'''
+    A bot command.
+
+    Reference: https://core.telegram.org/bots/api#richtextbotcommand
+	'''
+
+	type: Literal['bot_command'] = 'bot_command' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	bot_command: str 
+
+class RichTextAnchor(RichText):
+	'''
+    An anchor.
+
+    Reference: https://core.telegram.org/bots/api#richtextanchor
+	'''
+
+	type: Literal['anchor'] = 'anchor' # pyright: ignore[reportIncompatibleVariableOverride]
+	name: str 
+
+class RichTextAnchorLink(RichText):
+	'''
+    A link to an anchor.
+
+    Reference: https://core.telegram.org/bots/api#richtextanchorlink
+	'''
+
+	type: Literal['anchor_link'] = 'anchor_link' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	anchor_name: str 
+
+class RichTextReference(RichText):
+	'''
+    A reference.
+
+    Reference: https://core.telegram.org/bots/api#richtextreference
+	'''
+
+	type: Literal['reference'] = 'reference' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	name: str 
+
+class RichTextReferenceLink(RichText):
+	'''
+    A link to a reference.
+
+    Reference: https://core.telegram.org/bots/api#richtextreferencelink
+	'''
+
+	type: Literal['reference_link'] = 'reference_link' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	reference_name: str 
+
+_RichText = Union[
+	RichTextBold,
+	RichTextItalic,
+	RichTextUnderline,
+	RichTextStrikethrough,
+	RichTextSpoiler,
+	RichTextDateTime,
+	RichTextTextMention,
+	RichTextSubscript,
+	RichTextSuperscript,
+	RichTextMarked,
+	RichTextCode,
+	RichTextCustomEmoji,
+	RichTextMathematicalExpression,
+	RichTextUrl,
+	RichTextEmailAddress,
+	RichTextPhoneNumber,
+	RichTextBankCardNumber,
+	RichTextMention,
+	RichTextHashtag,
+	RichTextCashtag,
+	RichTextBotCommand,
+	RichTextAnchor,
+	RichTextAnchorLink,
+	RichTextReference,
+	RichTextReferenceLink,
+]
+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']
+
+class RichBlockParagraph(RichBlock):
+	'''
+    A text paragraph, corresponding to the HTML tag
+    <p>.
+
+    Reference: https://core.telegram.org/bots/api#richblockparagraph
+	'''
+
+	type: Literal['paragraph'] = 'paragraph' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichBlockSectionHeading(RichBlock):
+	'''
+    A section heading, corresponding to the HTML tags
+    <h1>, <h2>, <h3>, <h4>, <h5>, or <h6>.
+
+    Reference: https://core.telegram.org/bots/api#richblocksectionheading
+	'''
+
+	type: Literal['heading'] = 'heading' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	size: int 
+
+class RichBlockPreformatted(RichBlock):
+	'''
+    A preformatted text block, corresponding to the nested
+    HTML tags <pre> and <code>.
+
+    Reference: https://core.telegram.org/bots/api#richblockpreformatted
+	'''
+
+	type: Literal['pre'] = 'pre' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	language: Optional[str] = Field(default=None) 
+
+class RichBlockFooter(RichBlock):
+	'''
+    A footer, corresponding to the HTML tag <footer>.
+
+    Reference: https://core.telegram.org/bots/api#richblockfooter
+	'''
+
+	type: Literal['footer'] = 'footer' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+class RichBlockDivider(RichBlock):
+	'''
+    A divider, corresponding to the HTML tag <hr/>.
+
+    Reference: https://core.telegram.org/bots/api#richblockdivider
+	'''
+
+	type: Literal['divider'] = 'divider' # pyright: ignore[reportIncompatibleVariableOverride] 
+
+class RichBlockMathematicalExpression(RichBlock):
+	'''
+    A block with a mathematical expression in LaTeX
+    format, corresponding to the custom HTML tag <tg-math-block>.
+
+    Reference: https://core.telegram.org/bots/api#richblockmathematicalexpression
+	'''
+
+	type: Literal['mathematical_expression'] = 'mathematical_expression' # pyright: ignore[reportIncompatibleVariableOverride]
+	expression: str 
+
+class RichBlockAnchor(RichBlock):
+	'''
+    A block with an anchor, corresponding to the
+    HTML tag <a> with the attribute name.
+
+    Reference: https://core.telegram.org/bots/api#richblockanchor
+	'''
+
+	type: Literal['anchor'] = 'anchor' # pyright: ignore[reportIncompatibleVariableOverride]
+	name: str 
+
+class RichBlockList(RichBlock):
+	'''
+    A list of blocks, corresponding to the HTML
+    tag <ul> or <ol> with multiple nested tags
+    <li>.
+
+    Reference: https://core.telegram.org/bots/api#richblocklist
+	'''
+
+	type: Literal['list'] = 'list' # pyright: ignore[reportIncompatibleVariableOverride]
+	items: List[RichBlockListItem] 
+
+class RichBlockBlockQuotation(RichBlock):
+	'''
+    A block quotation, corresponding to the HTML tag
+    <blockquote>.
+
+    Reference: https://core.telegram.org/bots/api#richblockblockquotation
+	'''
+
+	type: Literal['blockquote'] = 'blockquote' # pyright: ignore[reportIncompatibleVariableOverride]
+	blocks: List[_RichBlock]
+	credit: Optional[_RichText] = Field(default=None) 
+
+class RichBlockPullQuotation(RichBlock):
+	'''
+    A quotation with centered text, loosely corresponding to
+    the HTML tag <aside>.
+
+    Reference: https://core.telegram.org/bots/api#richblockpullquotation
+	'''
+
+	type: Literal['pullquote'] = 'pullquote' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText
+	credit: Optional[_RichText] = Field(default=None) 
+
+class RichBlockCollage(RichBlock):
+	'''
+    A collage, corresponding to the custom HTML tag
+    <tg-collage>.
+
+    Reference: https://core.telegram.org/bots/api#richblockcollage
+	'''
+
+	type: Literal['collage'] = 'collage' # pyright: ignore[reportIncompatibleVariableOverride]
+	blocks: List[_RichBlock]
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockSlideshow(RichBlock):
+	'''
+    A slideshow, corresponding to the custom HTML tag
+    <tg-slideshow>.
+
+    Reference: https://core.telegram.org/bots/api#richblockslideshow
+	'''
+
+	type: Literal['slideshow'] = 'slideshow' # pyright: ignore[reportIncompatibleVariableOverride]
+	blocks: List[_RichBlock]
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockTable(RichBlock):
+	'''
+    A table, corresponding to the HTML tag <table>.
+
+    Reference: https://core.telegram.org/bots/api#richblocktable
+	'''
+
+	type: Literal['table'] = 'table' # pyright: ignore[reportIncompatibleVariableOverride]
+	cells: List[List[RichBlockTableCell]]
+	is_bordered: Optional[bool] = Field(default=None)
+	is_striped: Optional[bool] = Field(default=None)
+	caption: Optional[_RichText] = Field(default=None) 
+
+class RichBlockDetails(RichBlock):
+	'''
+    An expandable block for details disclosure, corresponding to
+    the HTML tag <details>.
+
+    Reference: https://core.telegram.org/bots/api#richblockdetails
+	'''
+
+	type: Literal['details'] = 'details' # pyright: ignore[reportIncompatibleVariableOverride]
+	summary: _RichText
+	blocks: List[_RichBlock]
+	is_open: Optional[bool] = Field(default=None) 
+
+class RichBlockMap(RichBlock):
+	'''
+    A block with a map, corresponding to the
+    custom HTML tag <tg-map>.
+
+    Reference: https://core.telegram.org/bots/api#richblockmap
+	'''
+
+	type: Literal['map'] = 'map' # pyright: ignore[reportIncompatibleVariableOverride]
+	location: Location
+	zoom: int
+	width: int
+	height: int
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockAnimation(RichBlock):
+	'''
+    A block with an animation, corresponding to the
+    HTML tag <video>.
+
+    Reference: https://core.telegram.org/bots/api#richblockanimation
+	'''
+
+	type: Literal['animation'] = 'animation' # pyright: ignore[reportIncompatibleVariableOverride]
+	animation: Animation
+	has_spoiler: Optional[bool] = Field(default=None)
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockAudio(RichBlock):
+	'''
+    A block with a music file, corresponding to
+    the HTML tag <audio>.
+
+    Reference: https://core.telegram.org/bots/api#richblockaudio
+	'''
+
+	type: Literal['audio'] = 'audio' # pyright: ignore[reportIncompatibleVariableOverride]
+	audio: Audio
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockPhoto(RichBlock):
+	'''
+    A block with a photo, corresponding to the
+    HTML tag <photo>.
+
+    Reference: https://core.telegram.org/bots/api#richblockphoto
+	'''
+
+	type: Literal['photo'] = 'photo' # pyright: ignore[reportIncompatibleVariableOverride]
+	photo: List[PhotoSize]
+	has_spoiler: Optional[bool] = Field(default=None)
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockVideo(RichBlock):
+	'''
+    A block with a video, corresponding to the
+    HTML tag <video>.
+
+    Reference: https://core.telegram.org/bots/api#richblockvideo
+	'''
+
+	type: Literal['video'] = 'video' # pyright: ignore[reportIncompatibleVariableOverride]
+	video: Video
+	has_spoiler: Optional[bool] = Field(default=None)
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockVoiceNote(RichBlock):
+	'''
+    A block with a voice note, corresponding to
+    the HTML tag <audio>.
+
+    Reference: https://core.telegram.org/bots/api#richblockvoicenote
+	'''
+
+	type: Literal['voice_note'] = 'voice_note' # pyright: ignore[reportIncompatibleVariableOverride]
+	voice_note: Voice
+	caption: Optional[RichBlockCaption] = Field(default=None) 
+
+class RichBlockThinking(RichBlock):
+	'''
+    A block with a “Thinking…” placeholder, corresponding to
+    the custom HTML tag <tg-thinking>. The block may
+    be used only in sendRichMessageDraft, therefore it can't
+    be received in messages. See https://t.me/addemoji/AIActions for examples
+    of custom emoji, which are recommended for usage
+    in the block.
+
+    Reference: https://core.telegram.org/bots/api#richblockthinking
+	'''
+
+	type: Literal['thinking'] = 'thinking' # pyright: ignore[reportIncompatibleVariableOverride]
+	text: _RichText 
+
+_RichBlock = Union[
+	RichBlockParagraph,
+	RichBlockSectionHeading,
+	RichBlockPreformatted,
+	RichBlockFooter,
+	RichBlockDivider,
+	RichBlockMathematicalExpression,
+	RichBlockAnchor,
+	RichBlockList,
+	RichBlockBlockQuotation,
+	RichBlockPullQuotation,
+	RichBlockCollage,
+	RichBlockSlideshow,
+	RichBlockTable,
+	RichBlockDetails,
+	RichBlockMap,
+	RichBlockAnimation,
+	RichBlockAudio,
+	RichBlockPhoto,
+	RichBlockVideo,
+	RichBlockVoiceNote,
+	RichBlockThinking,
+]
+RichBlockAdapter = TypeAdapter[_RichBlock](_RichBlock) 
+
 class InlineQueryResult(BaseModel):	
 	type: Literal['audio', 'document', 'gif', 'mpeg4_gif', 'photo', 'sticker', 'video', 'voice', 'article', 'contact', 'game', 'location', 'venue']	
 	id: str	
@@ -2081,6 +2674,17 @@ class InputTextMessageContent(InputMessageContent):
 	entities: Optional[List[MessageEntity]] = Field(default=None)
 	link_preview_options: Optional[LinkPreviewOptions] = Field(default=None) 
 
+class InputRichMessageContent(InputMessageContent):
+	'''
+    Represents the content of a rich message to
+    be sent as the result of an inline
+    query.
+
+    Reference: https://core.telegram.org/bots/api#inputrichmessagecontent
+	'''
+
+	rich_message: InputRichMessage 
+
 class InputLocationMessageContent(InputMessageContent):
 	'''
     Represents the content of a location message to
@@ -2161,6 +2765,7 @@ class InputInvoiceMessageContent(InputMessageContent):
 
 _InputMessageContent = Union[
 	InputTextMessageContent,
+	InputRichMessageContent,
 	InputLocationMessageContent,
 	InputVenueMessageContent,
 	InputContactMessageContent,
@@ -2536,7 +3141,8 @@ class User(BaseModel):
 	has_main_web_app: Optional[bool] = Field(default=None)
 	has_topics_enabled: Optional[bool] = Field(default=None)
 	allows_users_to_create_topics: Optional[bool] = Field(default=None)
-	can_manage_bots: Optional[bool] = Field(default=None) 
+	can_manage_bots: Optional[bool] = Field(default=None)
+	supports_join_request_queries: Optional[bool] = Field(default=None) 
 
 class Chat(BaseModel):
 	'''
@@ -2611,7 +3217,8 @@ class ChatFullInfo(BaseModel):
 	rating: Optional[UserRating] = Field(default=None)
 	first_profile_audio: Optional[Audio] = Field(default=None)
 	unique_gift_colors: Optional[UniqueGiftColors] = Field(default=None)
-	paid_message_star_count: Optional[int] = Field(default=None) 
+	paid_message_star_count: Optional[int] = Field(default=None)
+	guard_bot: Optional[User] = Field(default=None) 
 
 class MessageId(BaseModel):
 	'''
@@ -2915,6 +3522,15 @@ class Dice(BaseModel):
 	emoji: str
 	value: int 
 
+class Link(BaseModel):
+	'''
+    Represents an HTTP link.
+
+    Reference: https://core.telegram.org/bots/api#link
+	'''
+
+	url: str 
+
 class PollMedia(BaseModel):
 	'''
     At most one of the optional fields can
@@ -2926,6 +3542,7 @@ class PollMedia(BaseModel):
 	animation: Optional[Animation] = Field(default=None)
 	audio: Optional[Audio] = Field(default=None)
 	document: Optional[Document] = Field(default=None)
+	link: Optional[Link] = Field(default=None)
 	live_photo: Optional[LivePhoto] = Field(default=None)
 	location: Optional[Location] = Field(default=None)
 	photo: Optional[List[PhotoSize]] = Field(default=None)
@@ -4020,13 +4637,14 @@ class ChatJoinRequest(BaseModel):
 	date: int
 	bio: Optional[str] = Field(default=None)
 	invite_link: Optional[ChatInviteLink] = Field(default=None)
+	query_id: Optional[str] = Field(default=None)
 	
 	async def approve(
 		self,
 		bot: bot.Bot
 	) -> bool:
 		'''
-		Approves this chat join request.
+		Approve this chat join request.
 		'''
 		return await bot.approve_chat_join_request(
 			chat_id=self.chat.id,
@@ -4038,7 +4656,7 @@ class ChatJoinRequest(BaseModel):
 		bot: bot.Bot
 	) -> bool:
 		'''
-		Declines this chat join request.
+		Decline this chat join request.
 		'''
 		return await bot.decline_chat_join_request(
 			chat_id=self.chat.id,
@@ -4756,6 +5374,68 @@ class InputSticker(BaseModel):
 	mask_position: Optional[MaskPosition] = Field(default=None)
 	keywords: Optional[List[str]] = Field(default=None) 
 
+class RichMessage(BaseModel):
+	'''
+    Rich formatted message.
+
+    Reference: https://core.telegram.org/bots/api#richmessage
+	'''
+
+	blocks: List[_RichBlock]
+	is_rtl: Optional[bool] = Field(default=None) 
+
+class InputRichMessage(BaseModel):
+	'''
+    Describes a rich message to be sent. Exactly
+    one of the fields html or markdown must
+    be used.
+
+    Reference: https://core.telegram.org/bots/api#inputrichmessage
+	'''
+
+	html: Optional[str] = Field(default=None)
+	markdown: Optional[str] = Field(default=None)
+	is_rtl: Optional[bool] = Field(default=None)
+	skip_entity_detection: Optional[bool] = Field(default=None) 
+
+class RichBlockCaption(BaseModel):
+	'''
+    Caption of a rich formatted block.
+
+    Reference: https://core.telegram.org/bots/api#richblockcaption
+	'''
+
+	text: _RichText
+	credit: Optional[_RichText] = Field(default=None) 
+
+class RichBlockTableCell(BaseModel):
+	'''
+    Cell in a table.
+
+    Reference: https://core.telegram.org/bots/api#richblocktablecell
+	'''
+
+	align: str
+	valign: str
+	text: Optional[_RichText] = Field(default=None)
+	is_header: Optional[bool] = Field(default=None)
+	colspan: Optional[int] = Field(default=None)
+	rowspan: Optional[int] = Field(default=None) 
+
+class RichBlockListItem(BaseModel):
+	'''
+    An item of a list.
+
+    Reference: https://core.telegram.org/bots/api#richblocklistitem
+	'''
+
+	label: str
+	blocks: List[_RichBlock]
+	has_checkbox: Optional[bool] = Field(default=None)
+	is_checked: Optional[bool] = Field(default=None)
+	value: Optional[int] = Field(default=None)
+	type: Optional[str] = Field(default=None) 
+
 class InlineQuery(BaseModel):
 	'''
     This object represents an incoming inline query. When