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

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "botapi-py"
-version = "1.4.5"
+version = "1.4.6"
 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.6}/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,
@@ -522,6 +525,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 +545,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 +599,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 +633,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 +1069,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 +1425,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 +1483,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 +2193,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 +2227,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 +2338,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 +2409,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 +2431,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 +2634,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 +2654,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 +2675,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 +2807,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 +2826,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 +3126,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 +3226,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 +3247,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 +3395,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 +3425,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 +3590,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 +4234,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 +4261,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 +4282,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 +4567,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.5 → botapi_py-1.4.6}/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)
@@ -554,7 +555,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 +584,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 +755,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 +872,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 +1314,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 +1337,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 +1360,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 +1384,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 +1408,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 +1425,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 +1449,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 +1471,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 +1484,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 +1513,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 +1533,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 +1573,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 +1603,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 +1626,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 +1657,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 +1683,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 +1706,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 +1738,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 +1761,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 +1946,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 +1982,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 +2253,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 +2298,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 +2325,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 +2397,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 +2570,7 @@ class PaidMediaInfo(BaseModel, frozen=True):
 	'''
 
 	star_count: int
-	paid_media: List[_PaidMedia] 
+	paid_media: List[PaidMedia] 
 
 class Contact(BaseModel, frozen=True):
 	'''
@@ -2659,6 +2666,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 +2811,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 +2823,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 +3434,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 +3524,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 +3647,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 +3695,7 @@ class StoryArea(BaseModel, frozen=True):
 	'''
 
 	position: StoryAreaPosition
-	type: _StoryAreaType 
+	type: StoryAreaType 
 
 class ChatLocation(BaseModel, frozen=True):
 	'''
@@ -3694,7 +3716,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 +3730,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 +3758,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 +3784,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 +3852,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 +3876,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 +3900,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 +3917,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 +3932,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 +3947,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 +4007,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 +4031,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 +4412,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):
 	'''