botapi-py 1.4.5__tar.gz → 1.4.7__tar.gz

{botapi_py-1.4.5 → botapi_py-1.4.7}/PKG-INFO

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

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

{botapi_py-1.4.5 → botapi_py-1.4.7}/src/botapi/methods.py

@@ -140,6 +140,7 @@ from .types import (
 	BusinessLocation,
 	BusinessOpeningHoursInterval,
 	BusinessOpeningHours,
+	UserRating,
 	StoryAreaPosition,
 	LocationAddress,
 	StoryAreaType,
@@ -160,12 +161,14 @@ from .types import (
 	MessageReactionUpdated,
 	MessageReactionCountUpdated,
 	ForumTopic,
+	GiftBackground,
 	Gift,
 	Gifts,
 	UniqueGiftModel,
 	UniqueGiftSymbol,
 	UniqueGiftBackdropColors,
 	UniqueGiftBackdrop,
+	UniqueGiftColors,
 	UniqueGift,
 	GiftInfo,
 	UniqueGiftInfo,
@@ -316,7 +319,9 @@ from .types import (
 	BoolAdapter,
 )
 
-class Bot(core.BaseBot):
+from .shortcuts import BotShortcuts
+
+class Bot(core.BaseBot, BotShortcuts):
 	'''
 	Creates an instance of a new Bot API client.
 
@@ -522,6 +527,7 @@ class Bot(core.BaseBot):
 		video_start_timestamp: Optional[int] = None,
 		disable_notification: Optional[bool] = None,
 		protect_content: Optional[bool] = None,
+		message_effect_id: Optional[str] = None,
 		suggested_post_parameters: Optional[SuggestedPostParameters] = None,
 	) -> Message:
 		'''
@@ -541,6 +547,7 @@ class Bot(core.BaseBot):
 			'video_start_timestamp': video_start_timestamp,
 			'disable_notification': disable_notification,
 			'protect_content': protect_content,
+			'message_effect_id': message_effect_id,
 			'suggested_post_parameters': suggested_post_parameters,
 			'message_id': message_id,
 		})
@@ -594,6 +601,7 @@ class Bot(core.BaseBot):
 		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,
@@ -627,6 +635,7 @@ class Bot(core.BaseBot):
 			'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,
@@ -1062,7 +1071,7 @@ class Bot(core.BaseBot):
 		self,
 		chat_id: Union[int, str],
 		star_count: int,
-		media: List[_InputPaidMedia],
+		media: List[InputPaidMedia],
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
@@ -1418,6 +1427,34 @@ class Bot(core.BaseBot):
 		})
 		return Message.model_validate(response)
 
+	async def send_message_draft(
+		self,
+		chat_id: int,
+		draft_id: int,
+		text: str,
+		message_thread_id: Optional[int] = None,
+		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
+		entities: Optional[List[MessageEntity]] = None,
+	) -> bool:
+		'''
+        Use this method to stream a partial message
+        to a user while the message is being
+        generated; supported only for bots with forum topic
+        mode enabled. Returns True on success.
+
+        Reference: https://core.telegram.org/bots/api#sendmessagedraft
+		'''
+
+		response = await self._send_request('sendMessageDraft', {
+			'chat_id': chat_id,
+			'message_thread_id': message_thread_id,
+			'draft_id': draft_id,
+			'text': text,
+			'parse_mode': parse_mode if not entities else None, # FIX,
+			'entities': entities,
+		})
+		return BoolAdapter.validate_python(response)
+
 	async def send_chat_action(
 		self,
 		chat_id: Union[int, str],
@@ -1448,7 +1485,7 @@ class Bot(core.BaseBot):
 		self,
 		chat_id: Union[int, str],
 		message_id: int,
-		reaction: Optional[List[_ReactionType]] = None,
+		reaction: Optional[List[ReactionType]] = None,
 		is_big: Optional[bool] = None,
 	) -> bool:
 		'''
@@ -2158,7 +2195,7 @@ class Bot(core.BaseBot):
 	async def get_chat_administrators(
 		self,
 		chat_id: Union[int, str],
-	) -> List[_ChatMember]:
+	) -> List[ChatMember]:
 		'''
         Use this method to get a list of
         administrators in a chat, which aren't bots. Returns
@@ -2192,7 +2229,7 @@ class Bot(core.BaseBot):
 		self,
 		chat_id: Union[int, str],
 		user_id: int,
-	) -> _ChatMember:
+	) -> ChatMember:
 		'''
         Use this method to get information about a
         member of a chat. The method is only
@@ -2303,11 +2340,13 @@ class Bot(core.BaseBot):
 	) -> bool:
 		'''
         Use this method to edit name and icon
-        of a topic in a forum supergroup chat.
-        The bot must be an administrator in the
-        chat for this to work and must have
-        the can_manage_topics administrator rights, unless it is the
-        creator of the topic. Returns True on success.
+        of a topic in a forum supergroup chat
+        or a private chat with a user. In
+        the case of a supergroup chat the bot
+        must be an administrator in the chat for
+        this to work and must have the can_manage_topics
+        administrator rights, unless it is the creator of
+        the topic. Returns True on success.
 
         Reference: https://core.telegram.org/bots/api#editforumtopic
 		'''
@@ -2372,10 +2411,11 @@ class Bot(core.BaseBot):
 		'''
         Use this method to delete a forum topic
         along with all its messages in a forum
-        supergroup chat. The bot must be an administrator
-        in the chat for this to work and
-        must have the can_delete_messages administrator rights. Returns True
-        on success.
+        supergroup chat or a private chat with a
+        user. In the case of a supergroup chat
+        the bot must be an administrator in the
+        chat for this to work and must have
+        the can_delete_messages administrator rights. Returns True on success.
 
         Reference: https://core.telegram.org/bots/api#deleteforumtopic
 		'''
@@ -2393,11 +2433,13 @@ class Bot(core.BaseBot):
 	) -> bool:
 		'''
         Use this method to clear the list of
-        pinned messages in a forum topic. The bot
-        must be an administrator in the chat for
-        this to work and must have the can_pin_messages
-        administrator right in the supergroup. Returns True on
-        success.
+        pinned messages in a forum topic in a
+        forum supergroup chat or a private chat with
+        a user. In the case of a supergroup
+        chat the bot must be an administrator in
+        the chat for this to work and must
+        have the can_pin_messages administrator right in the supergroup.
+        Returns True on success.
 
         Reference: https://core.telegram.org/bots/api#unpinallforumtopicmessages
 		'''
@@ -2594,7 +2636,7 @@ class Bot(core.BaseBot):
 	async def set_my_commands(
 		self,
 		commands: List[BotCommand],
-		scope: Optional[_BotCommandScope] = None,
+		scope: Optional[BotCommandScope] = None,
 		language_code: Optional[str] = None,
 	) -> bool:
 		'''
@@ -2614,7 +2656,7 @@ class Bot(core.BaseBot):
 
 	async def delete_my_commands(
 		self,
-		scope: Optional[_BotCommandScope] = None,
+		scope: Optional[BotCommandScope] = None,
 		language_code: Optional[str] = None,
 	) -> bool:
 		'''
@@ -2635,7 +2677,7 @@ class Bot(core.BaseBot):
 
 	async def get_my_commands(
 		self,
-		scope: Optional[_BotCommandScope] = None,
+		scope: Optional[BotCommandScope] = None,
 		language_code: Optional[str] = None,
 	) -> List[BotCommand]:
 		'''
@@ -2767,7 +2809,7 @@ class Bot(core.BaseBot):
 	async def set_chat_menu_button(
 		self,
 		chat_id: Optional[int] = None,
-		menu_button: Optional[_MenuButton] = None,
+		menu_button: Optional[MenuButton] = None,
 	) -> bool:
 		'''
         Use this method to change the bot's menu
@@ -2786,7 +2828,7 @@ class Bot(core.BaseBot):
 	async def get_chat_menu_button(
 		self,
 		chat_id: Optional[int] = None,
-	) -> _MenuButton:
+	) -> MenuButton:
 		'''
         Use this method to get the current value
         of the bot's menu button in a private
@@ -3086,7 +3128,7 @@ class Bot(core.BaseBot):
 	async def set_business_account_profile_photo(
 		self,
 		business_connection_id: str,
-		photo: _InputProfilePhoto,
+		photo: InputProfilePhoto,
 		is_public: Optional[bool] = None,
 	) -> bool:
 		'''
@@ -3186,8 +3228,10 @@ class Bot(core.BaseBot):
 		exclude_unsaved: Optional[bool] = None,
 		exclude_saved: Optional[bool] = None,
 		exclude_unlimited: Optional[bool] = None,
-		exclude_limited: Optional[bool] = None,
+		exclude_limited_upgradable: Optional[bool] = None,
+		exclude_limited_non_upgradable: Optional[bool] = None,
 		exclude_unique: Optional[bool] = None,
+		exclude_from_blockchain: Optional[bool] = None,
 		sort_by_price: Optional[bool] = None,
 		offset: Optional[str] = None,
 		limit: Optional[int] = None,
@@ -3205,7 +3249,77 @@ class Bot(core.BaseBot):
 			'exclude_unsaved': exclude_unsaved,
 			'exclude_saved': exclude_saved,
 			'exclude_unlimited': exclude_unlimited,
-			'exclude_limited': exclude_limited,
+			'exclude_limited_upgradable': exclude_limited_upgradable,
+			'exclude_limited_non_upgradable': exclude_limited_non_upgradable,
+			'exclude_unique': exclude_unique,
+			'exclude_from_blockchain': exclude_from_blockchain,
+			'sort_by_price': sort_by_price,
+			'offset': offset,
+			'limit': limit,
+		})
+		return OwnedGifts.model_validate(response)
+
+	async def get_user_gifts(
+		self,
+		user_id: int,
+		exclude_unlimited: Optional[bool] = None,
+		exclude_limited_upgradable: Optional[bool] = None,
+		exclude_limited_non_upgradable: Optional[bool] = None,
+		exclude_from_blockchain: Optional[bool] = None,
+		exclude_unique: Optional[bool] = None,
+		sort_by_price: Optional[bool] = None,
+		offset: Optional[str] = None,
+		limit: Optional[int] = None,
+	) -> OwnedGifts:
+		'''
+        Returns the gifts owned and hosted by a
+        user. Returns OwnedGifts on success.
+
+        Reference: https://core.telegram.org/bots/api#getusergifts
+		'''
+
+		response = await self._send_request('getUserGifts', {
+			'user_id': user_id,
+			'exclude_unlimited': exclude_unlimited,
+			'exclude_limited_upgradable': exclude_limited_upgradable,
+			'exclude_limited_non_upgradable': exclude_limited_non_upgradable,
+			'exclude_from_blockchain': exclude_from_blockchain,
+			'exclude_unique': exclude_unique,
+			'sort_by_price': sort_by_price,
+			'offset': offset,
+			'limit': limit,
+		})
+		return OwnedGifts.model_validate(response)
+
+	async def get_chat_gifts(
+		self,
+		chat_id: Union[int, str],
+		exclude_unsaved: Optional[bool] = None,
+		exclude_saved: Optional[bool] = None,
+		exclude_unlimited: Optional[bool] = None,
+		exclude_limited_upgradable: Optional[bool] = None,
+		exclude_limited_non_upgradable: Optional[bool] = None,
+		exclude_from_blockchain: Optional[bool] = None,
+		exclude_unique: Optional[bool] = None,
+		sort_by_price: Optional[bool] = None,
+		offset: Optional[str] = None,
+		limit: Optional[int] = None,
+	) -> OwnedGifts:
+		'''
+        Returns the gifts owned by a chat. Returns
+        OwnedGifts on success.
+
+        Reference: https://core.telegram.org/bots/api#getchatgifts
+		'''
+
+		response = await self._send_request('getChatGifts', {
+			'chat_id': chat_id,
+			'exclude_unsaved': exclude_unsaved,
+			'exclude_saved': exclude_saved,
+			'exclude_unlimited': exclude_unlimited,
+			'exclude_limited_upgradable': exclude_limited_upgradable,
+			'exclude_limited_non_upgradable': exclude_limited_non_upgradable,
+			'exclude_from_blockchain': exclude_from_blockchain,
 			'exclude_unique': exclude_unique,
 			'sort_by_price': sort_by_price,
 			'offset': offset,
@@ -3283,7 +3397,7 @@ class Bot(core.BaseBot):
 	async def post_story(
 		self,
 		business_connection_id: str,
-		content: _InputStoryContent,
+		content: InputStoryContent,
 		active_period: int,
 		caption: Optional[str] = None,
 		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
@@ -3313,11 +3427,42 @@ class Bot(core.BaseBot):
 		})
 		return Story.model_validate(response)
 
+	async def repost_story(
+		self,
+		business_connection_id: str,
+		from_chat_id: int,
+		from_story_id: int,
+		active_period: int,
+		post_to_chat_page: Optional[bool] = None,
+		protect_content: Optional[bool] = None,
+	) -> Story:
+		'''
+        Reposts a story on behalf of a business
+        account from another business account. Both business accounts
+        must be managed by the same bot, and
+        the story on the source account must have
+        been posted (or reposted) by the bot. Requires
+        the can_manage_stories business bot right for both business
+        accounts. Returns Story on success.
+
+        Reference: https://core.telegram.org/bots/api#repoststory
+		'''
+
+		response = await self._send_request('repostStory', {
+			'business_connection_id': business_connection_id,
+			'from_chat_id': from_chat_id,
+			'from_story_id': from_story_id,
+			'active_period': active_period,
+			'post_to_chat_page': post_to_chat_page,
+			'protect_content': protect_content,
+		})
+		return Story.model_validate(response)
+
 	async def edit_story(
 		self,
 		business_connection_id: str,
 		story_id: int,
-		content: _InputStoryContent,
+		content: InputStoryContent,
 		caption: Optional[str] = None,
 		parse_mode: Optional[enums.ParseMode] = enums.ParseMode.HTML,
 		caption_entities: Optional[List[MessageEntity]] = None,
@@ -3447,7 +3592,7 @@ class Bot(core.BaseBot):
 
 	async def edit_message_media(
 		self,
-		media: _InputMedia,
+		media: InputMedia,
 		business_connection_id: Optional[str] = None,
 		chat_id: Optional[Union[int, str]] = None,
 		message_id: Optional[int] = None,
@@ -4091,7 +4236,7 @@ class Bot(core.BaseBot):
 	async def answer_inline_query(
 		self,
 		inline_query_id: str,
-		results: List[_InlineQueryResult],
+		results: List[InlineQueryResult],
 		cache_time: Optional[int] = None,
 		is_personal: Optional[bool] = None,
 		next_offset: Optional[str] = None,
@@ -4118,7 +4263,7 @@ class Bot(core.BaseBot):
 	async def answer_web_app_query(
 		self,
 		web_app_query_id: str,
-		result: _InlineQueryResult,
+		result: InlineQueryResult,
 	) -> SentWebAppMessage:
 		'''
         Use this method to set the result of
@@ -4139,7 +4284,7 @@ class Bot(core.BaseBot):
 	async def save_prepared_inline_message(
 		self,
 		user_id: int,
-		result: _InlineQueryResult,
+		result: InlineQueryResult,
 		allow_user_chats: Optional[bool] = None,
 		allow_bot_chats: Optional[bool] = None,
 		allow_group_chats: Optional[bool] = None,
@@ -4424,7 +4569,7 @@ class Bot(core.BaseBot):
 	async def set_passport_data_errors(
 		self,
 		user_id: int,
-		errors: List[_PassportElementError],
+		errors: List[PassportElementError],
 	) -> bool:
 		'''
         Informs a user that some of the Telegram

botapi_py-1.4.7/src/botapi/shortcuts.py

@@ -0,0 +1,141 @@
+from __future__ import annotations
+
+from typing import Optional, Union, List, cast
+
+from . import enums
+from . import types
+
+from . import methods
+
+
+class BotShortcuts:
+	'''
+	Mixin class containing shortcut bound methods for the `Bot` class.
+	These methods provide convenient wrappers around standard API methods.
+	'''
+	
+	async def send_media(
+		self,
+		chat_id: Union[int, str],
+		media: Union[types.InputFile, str],
+		file_type: enums.MediaType,
+		caption: Optional[str] = None,
+		parse_mode: Optional[Union[str, enums.ParseMode]] = enums.ParseMode.HTML,
+		caption_entities: Optional[List[types.MessageEntity]] = None,
+		show_caption_above_media: Optional[bool] = None,
+		has_spoiler: Optional[bool] = None,
+		disable_notification: Optional[bool] = None,
+		protect_content: Optional[bool] = None,
+		reply_parameters: Optional[types.ReplyParameters] = None,
+		reply_markup: Optional[Union[types.InlineKeyboardMarkup, types.ReplyKeyboardMarkup, types.ReplyKeyboardRemove, types.ForceReply]] = None,
+		message_effect_id: Optional[str] = None,
+		allow_paid_broadcast: Optional[bool] = None,
+		business_connection_id: Optional[str] = None,
+		message_thread_id: Optional[int] = None,
+	) -> types.Message:
+		'''
+		Method that sends common types of media by automatically routing to the correct `send_<type>` method.
+		
+		:param chat_id: Unique identifier for the target chat or username of the target channel.
+		:param media: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data.
+		:param file_type: The type of media to send. Use `enums.MediaType`.
+		:param caption: Media caption, 0-1024 characters.
+		:param parse_mode: Mode for parsing entities in the media caption.
+		:param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode.
+		:param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+		:param has_spoiler: Pass True if the media needs to be covered with a spoiler animation.
+		:param disable_notification: Sends the message silently. Users will receive a notification with no sound.
+		:param protect_content: Protects the contents of the sent message from forwarding and saving.
+		:param reply_parameters: Description of the message to reply to.
+		:param reply_markup: Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user.
+		:param message_effect_id: Unique identifier of the message effect to be added to the message.
+		:param allow_paid_broadcast: Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance.
+		:param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent.
+		:param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only.
+		:param kwargs: Additional arguments specific to the target method (e.g. `duration`, `width`, `height`, `thumbnail`, `performer`, `title`).
+		:return: On success, the sent Message is returned.
+		'''
+		bot = cast(methods.Bot, self)
+		
+		call_args: dict = {
+			'chat_id': chat_id,
+			'caption': caption,
+			'parse_mode': parse_mode,
+			'caption_entities': caption_entities,
+			'disable_notification': disable_notification,
+			'protect_content': protect_content,
+			'reply_parameters': reply_parameters,
+			'reply_markup': reply_markup,
+			'message_effect_id': message_effect_id,
+			'allow_paid_broadcast': allow_paid_broadcast,
+			'business_connection_id': business_connection_id,
+			'message_thread_id': message_thread_id,
+			'has_spoiler': has_spoiler,
+			'show_caption_above_media': show_caption_above_media,
+		}
+		
+		match file_type:
+			
+			case enums.MediaType.PHOTO:
+				call_args['photo'] = media
+				return await bot.send_photo(**call_args)
+				
+			case enums.MediaType.VIDEO:
+				call_args['video'] = media
+				return await bot.send_video(**call_args)
+				
+			case enums.MediaType.ANIMATION:
+				call_args['animation'] = media
+				return await bot.send_animation(**call_args)
+				
+			case enums.MediaType.AUDIO:
+				call_args['audio'] = media
+				# Audio doesn't support has_spoiler or show_caption_above_media in some versions, 
+				# but check API. core.telegram.org/bots/api#sendaudio says no spoiler, no caption above.
+				# We should probably filter them out to avoid errors if the underlying method relies on strict matching?
+				# generated methods typically accept **kwargs only if defined? No, generated methods have explicit args.
+				# If I pass 'has_spoiler' to send_audio and it's not in signature, it might fail if I use **call_args matching a signature.
+				# Python's **kwargs unpacking into a function call fails if keys don't match arguments (unless function has **kwargs).
+				# The generated methods DO NOT have **kwargs. They have explicit arguments.
+				# So I MUST NOT pass extra arguments.
+				
+				call_args.pop('has_spoiler', None)
+				call_args.pop('show_caption_above_media', None)
+				return await bot.send_audio(**call_args)
+				
+			case enums.MediaType.DOCUMENT:
+				call_args['document'] = media
+				# Document supports disable_content_type_detection
+				call_args.pop('has_spoiler', None)
+				call_args.pop('show_caption_above_media', None)
+				return await bot.send_document(**call_args)
+				
+			case enums.MediaType.VOICE:
+				call_args['voice'] = media
+				call_args.pop('has_spoiler', None)
+				call_args.pop('show_caption_above_media', None)
+				return await bot.send_voice(**call_args)
+				
+			case enums.MediaType.VIDEO_NOTE:
+				call_args['video_note'] = media
+				call_args.pop('has_spoiler', None)
+				call_args.pop('show_caption_above_media', None)
+				call_args.pop('caption', None) # Video notes don't have captions
+				call_args.pop('parse_mode', None)
+				call_args.pop('caption_entities', None)
+				return await bot.send_video_note(**call_args)
+				
+			case enums.MediaType.STICKER:
+				call_args['sticker'] = media
+				# Sticker is quite different
+				call_args.pop('caption', None)
+				call_args.pop('parse_mode', None)
+				call_args.pop('caption_entities', None)
+				call_args.pop('has_spoiler', None)
+				call_args.pop('show_caption_above_media', None)
+				return await bot.send_sticker(**call_args)
+				
+			case _:
+				# Fallback or Error
+				raise ValueError(f"Unsupported or unknown media type: {file_type}")
+				

{botapi_py-1.4.5 → botapi_py-1.4.7}/src/botapi/types.py

@@ -34,7 +34,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 	sender_boost_count: Optional[int] = Field(default=None)
 	sender_business_bot: Optional[User] = Field(default=None)
 	business_connection_id: Optional[str] = Field(default=None)
-	forward_origin: Optional[_MessageOrigin] = Field(default=None)
+	forward_origin: Optional[MessageOrigin] = Field(default=None)
 	is_topic_message: Optional[bool] = Field(default=None)
 	is_automatic_forward: Optional[bool] = Field(default=None)
 	reply_to_message: Optional[Message] = Field(default=None)
@@ -87,7 +87,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 	message_auto_delete_timer_changed: Optional[MessageAutoDeleteTimerChanged] = Field(default=None)
 	migrate_to_chat_id: Optional[int] = Field(default=None)
 	migrate_from_chat_id: Optional[int] = Field(default=None)
-	pinned_message: Optional[_MaybeInaccessibleMessage] = Field(default=None)
+	pinned_message: Optional[MaybeInaccessibleMessage] = Field(default=None)
 	invoice: Optional[Invoice] = Field(default=None)
 	successful_payment: Optional[SuccessfulPayment] = Field(default=None)
 	refunded_payment: Optional[RefundedPayment] = Field(default=None)
@@ -95,6 +95,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 	chat_shared: Optional[ChatShared] = Field(default=None)
 	gift: Optional[GiftInfo] = Field(default=None)
 	unique_gift: Optional[UniqueGiftInfo] = Field(default=None)
+	gift_upgrade_sent: Optional[GiftInfo] = Field(default=None)
 	connected_website: Optional[str] = Field(default=None)
 	write_access_allowed: Optional[WriteAccessAllowed] = Field(default=None)
 	passport_data: Optional[PassportData] = Field(default=None)
@@ -177,6 +178,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
 		video_start_timestamp: Optional[int] = None,
+		message_effect_id: Optional[str] = None,
 		# suggested_post_parameters: Optional[SuggestedPostParameters] = None,
 	) -> Message:
 		'''
@@ -192,6 +194,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 			video_start_timestamp=video_start_timestamp,
 			disable_notification=disable_notification,
 			protect_content=protect_content,
+			message_effect_id=message_effect_id,
 			# suggested_post_parameters=suggested_post_parameters
 		)
 	
@@ -209,6 +212,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 		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
@@ -231,6 +235,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 			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
@@ -337,19 +342,7 @@ class Message(MaybeInaccessibleMessage, frozen=True):
 		)
 	
 	@property
-	def media(self) -> Union[
-		Animation,
-		Audio,
-		Document,
-		list[PhotoSize],
-		Sticker,
-		Video,
-		VideoNote,
-		Voice,
-		Story,
-		PaidMedia,
-		None
-	]:
+	def media(self) -> Optional[MediaTypeUnion]:
 		'''
 		Actual multimedia content of this message.
 	
@@ -554,7 +547,7 @@ class BackgroundTypeFill(BackgroundType, frozen=True):
 	'''
 
 	type: Literal['fill'] = 'fill'
-	fill: _BackgroundFill
+	fill: BackgroundFill
 	dark_theme_dimming: int 
 
 class BackgroundTypeWallpaper(BackgroundType, frozen=True):
@@ -583,7 +576,7 @@ class BackgroundTypePattern(BackgroundType, frozen=True):
 
 	type: Literal['pattern'] = 'pattern'
 	document: Document
-	fill: _BackgroundFill
+	fill: BackgroundFill
 	intensity: int
 	is_inverted: Optional[bool] = Field(default=None)
 	is_moving: Optional[bool] = Field(default=None) 
@@ -754,7 +747,7 @@ class StoryAreaTypeSuggestedReaction(StoryAreaType, frozen=True):
 	'''
 
 	type: Literal['suggested_reaction'] = 'suggested_reaction'
-	reaction_type: _ReactionType
+	reaction_type: ReactionType
 	is_dark: Optional[bool] = Field(default=None)
 	is_flipped: Optional[bool] = Field(default=None) 
 
@@ -871,7 +864,9 @@ class OwnedGiftRegular(OwnedGift, frozen=True):
 	can_be_upgraded: Optional[bool] = Field(default=None)
 	was_refunded: Optional[bool] = Field(default=None)
 	convert_star_count: Optional[int] = Field(default=None)
-	prepaid_upgrade_star_count: Optional[int] = Field(default=None) 
+	prepaid_upgrade_star_count: Optional[int] = Field(default=None)
+	is_upgrade_separate: Optional[bool] = Field(default=None)
+	unique_gift_number: Optional[int] = Field(default=None) 
 
 class OwnedGiftUnique(OwnedGift, frozen=True):
 	'''
@@ -1311,7 +1306,7 @@ class InlineQueryResultCachedAudio(InlineQueryResult, frozen=True):
 	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultCachedDocument(InlineQueryResult, frozen=True):
 	'''
@@ -1334,7 +1329,7 @@ class InlineQueryResultCachedDocument(InlineQueryResult, frozen=True):
 	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultCachedGif(InlineQueryResult, frozen=True):
 	'''
@@ -1357,7 +1352,7 @@ class InlineQueryResultCachedGif(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultCachedMpeg4Gif(InlineQueryResult, frozen=True):
 	'''
@@ -1381,7 +1376,7 @@ class InlineQueryResultCachedMpeg4Gif(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultCachedPhoto(InlineQueryResult, frozen=True):
 	'''
@@ -1405,7 +1400,7 @@ class InlineQueryResultCachedPhoto(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultCachedSticker(InlineQueryResult, frozen=True):
 	'''
@@ -1422,7 +1417,7 @@ class InlineQueryResultCachedSticker(InlineQueryResult, frozen=True):
 	id: str
 	sticker_file_id: str
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultCachedVideo(InlineQueryResult, frozen=True):
 	'''
@@ -1446,7 +1441,7 @@ class InlineQueryResultCachedVideo(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultCachedVoice(InlineQueryResult, frozen=True):
 	'''
@@ -1468,7 +1463,7 @@ class InlineQueryResultCachedVoice(InlineQueryResult, frozen=True):
 	parse_mode: Optional[str] = Field(default=enums.ParseMode.HTML.value)
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultArticle(InlineQueryResult, frozen=True):
 	'''
@@ -1481,7 +1476,7 @@ class InlineQueryResultArticle(InlineQueryResult, frozen=True):
 	type: Literal['article'] = 'article'
 	id: str
 	title: str
-	input_message_content: _InputMessageContent
+	input_message_content: InputMessageContent
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
 	url: Optional[str] = Field(default=None)
 	description: Optional[str] = Field(default=None)
@@ -1510,7 +1505,7 @@ class InlineQueryResultAudio(InlineQueryResult, frozen=True):
 	performer: Optional[str] = Field(default=None)
 	audio_duration: Optional[int] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultContact(InlineQueryResult, frozen=True):
 	'''
@@ -1530,7 +1525,7 @@ class InlineQueryResultContact(InlineQueryResult, frozen=True):
 	last_name: Optional[str] = Field(default=None)
 	vcard: Optional[str] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None)
+	input_message_content: Optional[InputMessageContent] = Field(default=None)
 	thumbnail_url: Optional[str] = Field(default=None)
 	thumbnail_width: Optional[int] = Field(default=None)
 	thumbnail_height: Optional[int] = Field(default=None) 
@@ -1570,7 +1565,7 @@ class InlineQueryResultDocument(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	description: Optional[str] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None)
+	input_message_content: Optional[InputMessageContent] = Field(default=None)
 	thumbnail_url: Optional[str] = Field(default=None)
 	thumbnail_width: Optional[int] = Field(default=None)
 	thumbnail_height: Optional[int] = Field(default=None) 
@@ -1600,7 +1595,7 @@ class InlineQueryResultGif(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultLocation(InlineQueryResult, frozen=True):
 	'''
@@ -1623,7 +1618,7 @@ class InlineQueryResultLocation(InlineQueryResult, frozen=True):
 	heading: Optional[int] = Field(default=None)
 	proximity_alert_radius: Optional[int] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None)
+	input_message_content: Optional[InputMessageContent] = Field(default=None)
 	thumbnail_url: Optional[str] = Field(default=None)
 	thumbnail_width: Optional[int] = Field(default=None)
 	thumbnail_height: Optional[int] = Field(default=None) 
@@ -1654,7 +1649,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultPhoto(InlineQueryResult, frozen=True):
 	'''
@@ -1680,7 +1675,7 @@ class InlineQueryResultPhoto(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	show_caption_above_media: Optional[bool] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultVenue(InlineQueryResult, frozen=True):
 	'''
@@ -1703,7 +1698,7 @@ class InlineQueryResultVenue(InlineQueryResult, frozen=True):
 	google_place_id: Optional[str] = Field(default=None)
 	google_place_type: Optional[str] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None)
+	input_message_content: Optional[InputMessageContent] = Field(default=None)
 	thumbnail_url: Optional[str] = Field(default=None)
 	thumbnail_width: Optional[int] = Field(default=None)
 	thumbnail_height: Optional[int] = Field(default=None) 
@@ -1735,7 +1730,7 @@ class InlineQueryResultVideo(InlineQueryResult, frozen=True):
 	video_duration: Optional[int] = Field(default=None)
 	description: Optional[str] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 class InlineQueryResultVoice(InlineQueryResult, frozen=True):
 	'''
@@ -1758,7 +1753,7 @@ class InlineQueryResultVoice(InlineQueryResult, frozen=True):
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 	voice_duration: Optional[int] = Field(default=None)
 	reply_markup: Optional[InlineKeyboardMarkup] = Field(default=None)
-	input_message_content: Optional[_InputMessageContent] = Field(default=None) 
+	input_message_content: Optional[InputMessageContent] = Field(default=None) 
 
 _InlineQueryResult = Union[
 	InlineQueryResultCachedAudio,
@@ -1943,7 +1938,7 @@ class TransactionPartnerUser(TransactionPartner, frozen=True):
 	affiliate: Optional[AffiliateInfo] = Field(default=None)
 	invoice_payload: Optional[str] = Field(default=None)
 	subscription_period: Optional[int] = Field(default=None)
-	paid_media: Optional[List[_PaidMedia]] = Field(default=None)
+	paid_media: Optional[List[PaidMedia]] = Field(default=None)
 	paid_media_payload: Optional[str] = Field(default=None)
 	gift: Optional[Gift] = Field(default=None)
 	premium_subscription_duration: Optional[int] = Field(default=None) 
@@ -1979,7 +1974,7 @@ class TransactionPartnerFragment(TransactionPartner, frozen=True):
 	'''
 
 	type: Literal['fragment'] = 'fragment'
-	withdrawal_state: Optional[_RevenueWithdrawalState] = Field(default=None) 
+	withdrawal_state: Optional[RevenueWithdrawalState] = Field(default=None) 
 
 class TransactionPartnerTelegramAds(TransactionPartner, frozen=True):
 	'''
@@ -2250,7 +2245,8 @@ class User(BaseModel, frozen=True):
 	can_read_all_group_messages: Optional[bool] = Field(default=None)
 	supports_inline_queries: Optional[bool] = Field(default=None)
 	can_connect_to_business: Optional[bool] = Field(default=None)
-	has_main_web_app: Optional[bool] = Field(default=None) 
+	has_main_web_app: Optional[bool] = Field(default=None)
+	has_topics_enabled: Optional[bool] = Field(default=None) 
 
 class Chat(BaseModel, frozen=True):
 	'''
@@ -2294,7 +2290,7 @@ class ChatFullInfo(BaseModel, frozen=True):
 	business_opening_hours: Optional[BusinessOpeningHours] = Field(default=None)
 	personal_chat: Optional[Chat] = Field(default=None)
 	parent_chat: Optional[Chat] = Field(default=None)
-	available_reactions: Optional[List[_ReactionType]] = Field(default=None)
+	available_reactions: Optional[List[ReactionType]] = Field(default=None)
 	background_custom_emoji_id: Optional[str] = Field(default=None)
 	profile_accent_color_id: Optional[int] = Field(default=None)
 	profile_background_custom_emoji_id: Optional[str] = Field(default=None)
@@ -2321,7 +2317,10 @@ class ChatFullInfo(BaseModel, frozen=True):
 	can_set_sticker_set: Optional[bool] = Field(default=None)
 	custom_emoji_sticker_set_name: Optional[str] = Field(default=None)
 	linked_chat_id: Optional[int] = Field(default=None)
-	location: Optional[ChatLocation] = Field(default=None) 
+	location: Optional[ChatLocation] = Field(default=None)
+	rating: Optional[UserRating] = Field(default=None)
+	unique_gift_colors: Optional[UniqueGiftColors] = Field(default=None)
+	paid_message_star_count: Optional[int] = Field(default=None) 
 
 class MessageId(BaseModel, frozen=True):
 	'''
@@ -2390,7 +2389,7 @@ class ExternalReplyInfo(BaseModel, frozen=True):
     Reference: https://core.telegram.org/bots/api#externalreplyinfo
 	'''
 
-	origin: _MessageOrigin
+	origin: MessageOrigin
 	chat: Optional[Chat] = Field(default=None)
 	message_id: Optional[int] = Field(default=None)
 	link_preview_options: Optional[LinkPreviewOptions] = Field(default=None)
@@ -2563,7 +2562,7 @@ class PaidMediaInfo(BaseModel, frozen=True):
 	'''
 
 	star_count: int
-	paid_media: List[_PaidMedia] 
+	paid_media: List[PaidMedia] 
 
 class Contact(BaseModel, frozen=True):
 	'''
@@ -2659,6 +2658,7 @@ class ChecklistTask(BaseModel, frozen=True):
 	text: str
 	text_entities: Optional[List[MessageEntity]] = Field(default=None)
 	completed_by_user: Optional[User] = Field(default=None)
+	completed_by_chat: Optional[Chat] = Field(default=None)
 	completion_date: Optional[int] = Field(default=None) 
 
 class Checklist(BaseModel, frozen=True):
@@ -2803,7 +2803,7 @@ class ChatBackground(BaseModel, frozen=True):
     Reference: https://core.telegram.org/bots/api#chatbackground
 	'''
 
-	type: _BackgroundType 
+	type: BackgroundType 
 
 class ForumTopicCreated(BaseModel, frozen=True):
 	'''
@@ -2815,7 +2815,8 @@ class ForumTopicCreated(BaseModel, frozen=True):
 
 	name: str
 	icon_color: int
-	icon_custom_emoji_id: Optional[str] = Field(default=None) 
+	icon_custom_emoji_id: Optional[str] = Field(default=None)
+	is_name_implicit: Optional[bool] = Field(default=None) 
 
 class ForumTopicClosed(BaseModel, frozen=True):
 	'''
@@ -3425,7 +3426,7 @@ class CallbackQuery(BaseModel, frozen=True):
 	id: str
 	from_user: User = Field(alias='from') # FIX `from` is a python reserved keyword
 	chat_instance: str
-	message: Optional[_MaybeInaccessibleMessage] = Field(default=None)
+	message: Optional[MaybeInaccessibleMessage] = Field(default=None)
 	inline_message_id: Optional[str] = Field(default=None)
 	data: Optional[str] = Field(default=None)
 	game_short_name: Optional[str] = Field(default=None) 
@@ -3515,8 +3516,8 @@ class ChatMemberUpdated(BaseModel, frozen=True):
 	chat: Chat
 	from_user: User = Field(alias='from') # FIX `from` is a python reserved keyword
 	date: int
-	old_chat_member: _ChatMember
-	new_chat_member: _ChatMember
+	old_chat_member: ChatMember
+	new_chat_member: ChatMember
 	invite_link: Optional[ChatInviteLink] = Field(default=None)
 	via_join_request: Optional[bool] = Field(default=None)
 	via_chat_folder_invite_link: Optional[bool] = Field(default=None) 
@@ -3638,6 +3639,19 @@ class BusinessOpeningHours(BaseModel, frozen=True):
 	time_zone_name: str
 	opening_hours: List[BusinessOpeningHoursInterval] 
 
+class UserRating(BaseModel, frozen=True):
+	'''
+    This object describes the rating of a user
+    based on their Telegram Star spendings.
+
+    Reference: https://core.telegram.org/bots/api#userrating
+	'''
+
+	level: int
+	rating: int
+	current_level_rating: int
+	next_level_rating: Optional[int] = Field(default=None) 
+
 class StoryAreaPosition(BaseModel, frozen=True):
 	'''
     Describes the position of a clickable area within
@@ -3673,7 +3687,7 @@ class StoryArea(BaseModel, frozen=True):
 	'''
 
 	position: StoryAreaPosition
-	type: _StoryAreaType 
+	type: StoryAreaType 
 
 class ChatLocation(BaseModel, frozen=True):
 	'''
@@ -3694,7 +3708,7 @@ class ReactionCount(BaseModel, frozen=True):
     Reference: https://core.telegram.org/bots/api#reactioncount
 	'''
 
-	type: _ReactionType
+	type: ReactionType
 	total_count: int 
 
 class MessageReactionUpdated(BaseModel, frozen=True):
@@ -3708,8 +3722,8 @@ class MessageReactionUpdated(BaseModel, frozen=True):
 	chat: Chat
 	message_id: int
 	date: int
-	old_reaction: List[_ReactionType]
-	new_reaction: List[_ReactionType]
+	old_reaction: List[ReactionType]
+	new_reaction: List[ReactionType]
 	user: Optional[User] = Field(default=None)
 	actor_chat: Optional[Chat] = Field(default=None) 
 
@@ -3736,7 +3750,19 @@ class ForumTopic(BaseModel, frozen=True):
 	message_thread_id: int
 	name: str
 	icon_color: int
-	icon_custom_emoji_id: Optional[str] = Field(default=None) 
+	icon_custom_emoji_id: Optional[str] = Field(default=None)
+	is_name_implicit: Optional[bool] = Field(default=None) 
+
+class GiftBackground(BaseModel, frozen=True):
+	'''
+    This object describes the background of a gift.
+
+    Reference: https://core.telegram.org/bots/api#giftbackground
+	'''
+
+	center_color: int
+	edge_color: int
+	text_color: int 
 
 class Gift(BaseModel, frozen=True):
 	'''
@@ -3750,8 +3776,14 @@ class Gift(BaseModel, frozen=True):
 	sticker: Sticker
 	star_count: int
 	upgrade_star_count: Optional[int] = Field(default=None)
+	is_premium: Optional[bool] = Field(default=None)
+	has_colors: Optional[bool] = Field(default=None)
 	total_count: Optional[int] = Field(default=None)
 	remaining_count: Optional[int] = Field(default=None)
+	personal_total_count: Optional[int] = Field(default=None)
+	personal_remaining_count: Optional[int] = Field(default=None)
+	background: Optional[GiftBackground] = Field(default=None)
+	unique_gift_variant_count: Optional[int] = Field(default=None)
 	publisher_chat: Optional[Chat] = Field(default=None) 
 
 class Gifts(BaseModel, frozen=True):
@@ -3812,6 +3844,22 @@ class UniqueGiftBackdrop(BaseModel, frozen=True):
 	colors: UniqueGiftBackdropColors
 	rarity_per_mille: int 
 
+class UniqueGiftColors(BaseModel, frozen=True):
+	'''
+    This object contains information about the color scheme
+    for a user's name, message replies and link
+    previews based on a unique gift.
+
+    Reference: https://core.telegram.org/bots/api#uniquegiftcolors
+	'''
+
+	model_custom_emoji_id: str
+	symbol_custom_emoji_id: str
+	light_theme_main_color: int
+	light_theme_other_colors: List[int]
+	dark_theme_main_color: int
+	dark_theme_other_colors: List[int] 
+
 class UniqueGift(BaseModel, frozen=True):
 	'''
     This object describes a unique gift that was
@@ -3820,12 +3868,16 @@ class UniqueGift(BaseModel, frozen=True):
     Reference: https://core.telegram.org/bots/api#uniquegift
 	'''
 
+	gift_id: str
 	base_name: str
 	name: str
 	number: int
 	model: UniqueGiftModel
 	symbol: UniqueGiftSymbol
 	backdrop: UniqueGiftBackdrop
+	is_premium: Optional[bool] = Field(default=None)
+	is_from_blockchain: Optional[bool] = Field(default=None)
+	colors: Optional[UniqueGiftColors] = Field(default=None)
 	publisher_chat: Optional[Chat] = Field(default=None) 
 
 class GiftInfo(BaseModel, frozen=True):
@@ -3840,10 +3892,12 @@ class GiftInfo(BaseModel, frozen=True):
 	owned_gift_id: Optional[str] = Field(default=None)
 	convert_star_count: Optional[int] = Field(default=None)
 	prepaid_upgrade_star_count: Optional[int] = Field(default=None)
+	is_upgrade_separate: Optional[bool] = Field(default=None)
 	can_be_upgraded: Optional[bool] = Field(default=None)
 	text: Optional[str] = Field(default=None)
 	entities: Optional[List[MessageEntity]] = Field(default=None)
-	is_private: Optional[bool] = Field(default=None) 
+	is_private: Optional[bool] = Field(default=None)
+	unique_gift_number: Optional[int] = Field(default=None) 
 
 class UniqueGiftInfo(BaseModel, frozen=True):
 	'''
@@ -3855,7 +3909,8 @@ class UniqueGiftInfo(BaseModel, frozen=True):
 
 	gift: UniqueGift
 	origin: str
-	last_resale_star_count: Optional[int] = 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)
 	transfer_star_count: Optional[int] = Field(default=None)
 	next_transfer_date: Optional[int] = Field(default=None) 
@@ -3869,7 +3924,7 @@ class OwnedGifts(BaseModel, frozen=True):
 	'''
 
 	total_count: int
-	gifts: List[_OwnedGift]
+	gifts: List[OwnedGift]
 	next_offset: Optional[str] = Field(default=None) 
 
 class AcceptedGiftTypes(BaseModel, frozen=True):
@@ -3884,7 +3939,8 @@ class AcceptedGiftTypes(BaseModel, frozen=True):
 	unlimited_gifts: bool
 	limited_gifts: bool
 	unique_gifts: bool
-	premium_subscription: bool 
+	premium_subscription: bool
+	gifts_from_channels: bool 
 
 class StarAmount(BaseModel, frozen=True):
 	'''
@@ -3943,7 +3999,7 @@ class ChatBoost(BaseModel, frozen=True):
 	boost_id: str
 	add_date: int
 	expiration_date: int
-	source: _ChatBoostSource 
+	source: ChatBoostSource 
 
 class ChatBoostUpdated(BaseModel, frozen=True):
 	'''
@@ -3967,7 +4023,7 @@ class ChatBoostRemoved(BaseModel, frozen=True):
 	chat: Chat
 	boost_id: str
 	remove_date: int
-	source: _ChatBoostSource 
+	source: ChatBoostSource 
 
 class UserChatBoosts(BaseModel, frozen=True):
 	'''
@@ -4348,8 +4404,8 @@ class StarTransaction(BaseModel, frozen=True):
 	amount: int
 	date: int
 	nanostar_amount: Optional[int] = Field(default=None)
-	source: Optional[_TransactionPartner] = Field(default=None)
-	receiver: Optional[_TransactionPartner] = Field(default=None) 
+	source: Optional[TransactionPartner] = Field(default=None)
+	receiver: Optional[TransactionPartner] = Field(default=None) 
 
 class StarTransactions(BaseModel, frozen=True):
 	'''
@@ -4461,3 +4517,5 @@ IntAdapter = TypeAdapter[int](int)
 StrAdapter = TypeAdapter[str](str)
 FloatAdapter = TypeAdapter[float](float)
 BoolAdapter = TypeAdapter[bool](bool)
+
+MediaTypeUnion = Union[Animation, Audio, Document, List[PhotoSize], Sticker, Video, VideoNote, Voice, Story, PaidMedia]