telegrinder 0.1.dev158__py3-none-any.whl → 0.1.dev160__py3-none-any.whl

telegrinder/types/objects.py

@@ -1,9 +1,9 @@
 import typing
 
-from fntypes.variative import Variative
+from fntypes.co import Some, Variative
 
 from telegrinder.model import Model
-from telegrinder.msgspec_utils import Nothing, Option
+from telegrinder.msgspec_utils import Nothing, Option, datetime
 from telegrinder.types.enums import *  # noqa: F403
 
 
@@ -12,7 +12,8 @@ class ReactionType(Model):
 
     This object describes the type of a reaction. Currently, it can be one of
     - ReactionTypeEmoji
-    - ReactionTypeCustomEmoji"""
+    - ReactionTypeCustomEmoji
+    """
 
 
 class PassportElementError(Model):
@@ -27,7 +28,8 @@ class PassportElementError(Model):
     - PassportElementErrorFiles
     - PassportElementErrorTranslationFile
     - PassportElementErrorTranslationFiles
-    - PassportElementErrorUnspecified"""
+    - PassportElementErrorUnspecified
+    """
 
 
 class MessageOrigin(Model):
@@ -37,7 +39,8 @@ class MessageOrigin(Model):
     - MessageOriginUser
     - MessageOriginHiddenUser
     - MessageOriginChat
-    - MessageOriginChannel"""
+    - MessageOriginChannel
+    """
 
 
 class MaybeInaccessibleMessage(Model):
@@ -45,7 +48,8 @@ class MaybeInaccessibleMessage(Model):
 
     This object describes a message that can be inaccessible to the bot. It can be one of
     - Message
-    - InaccessibleMessage"""
+    - InaccessibleMessage
+    """
 
 
 class MenuButton(Model):
@@ -67,7 +71,8 @@ class InputMessageContent(Model):
     - InputLocationMessageContent
     - InputVenueMessageContent
     - InputContactMessageContent
-    - InputInvoiceMessageContent"""
+    - InputInvoiceMessageContent
+    """
 
 
 class InputMedia(Model):
@@ -78,7 +83,8 @@ class InputMedia(Model):
     - InputMediaDocument
     - InputMediaAudio
     - InputMediaPhoto
-    - InputMediaVideo"""
+    - InputMediaVideo
+    """
 
 
 class InlineQueryResult(Model):
@@ -118,7 +124,8 @@ class ChatMember(Model):
     - ChatMemberMember
     - ChatMemberRestricted
     - ChatMemberLeft
-    - ChatMemberBanned"""
+    - ChatMemberBanned
+    """
 
 
 class ChatBoostSource(Model):
@@ -127,7 +134,8 @@ class ChatBoostSource(Model):
     This object describes the source of a chat boost. It can be one of
     - ChatBoostSourcePremium
     - ChatBoostSourceGiftCode
-    - ChatBoostSourceGiveaway"""
+    - ChatBoostSourceGiveaway
+    """
 
 
 class BotCommandScope(Model):
@@ -140,14 +148,16 @@ class BotCommandScope(Model):
     - BotCommandScopeAllChatAdministrators
     - BotCommandScopeChat
     - BotCommandScopeChatAdministrators
-    - BotCommandScopeChatMember"""
+    - BotCommandScopeChatMember
+    """
 
 
 class Update(Model):
     """Object `Update`, see the [documentation](https://core.telegram.org/bots/api#update)
 
     This object represents an incoming update.
-    At most one of the optional parameters can be present in any given update."""
+    At most one of the optional parameters can be present in any given update.
+    """
 
     update_id: int
     """The update's unique identifier. Update identifiers start from a certain 
@@ -235,11 +245,26 @@ class Update(Model):
     """Optional. A boost was removed from a chat. The bot must be an administrator 
     in the chat to receive these updates."""
 
+    @property
+    def update_type(self) -> Option[UpdateType]:
+        """Incoming update type."""
+
+        if update := next(
+            filter(
+                lambda x: bool(x[1]),
+                self.to_dict(exclude_fields={"update_id"}).items(),
+            ),
+            None,
+        ):
+            return Some(UpdateType(update[0]))
+        return Nothing
+
 
 class WebhookInfo(Model):
     """Object `WebhookInfo`, see the [documentation](https://core.telegram.org/bots/api#webhookinfo)
 
-    Describes the current status of a webhook."""
+    Describes the current status of a webhook.
+    """
 
     url: str
     """Webhook URL, may be empty if webhook is not set up."""
@@ -253,7 +278,7 @@ class WebhookInfo(Model):
     ip_address: Option[str] = Nothing
     """Optional. Currently used webhook IP address."""
 
-    last_error_date: Option[int] = Nothing
+    last_error_date: Option[datetime] = Nothing
     """Optional. Unix time for the most recent error that happened when trying 
     to deliver an update via webhook."""
 
@@ -261,7 +286,7 @@ class WebhookInfo(Model):
     """Optional. Error message in human-readable format for the most recent error 
     that happened when trying to deliver an update via webhook."""
 
-    last_synchronization_error_date: Option[int] = Nothing
+    last_synchronization_error_date: Option[datetime] = Nothing
     """Optional. Unix time of the most recent error that happened when trying to 
     synchronize available updates with Telegram datacenters."""
 
@@ -275,9 +300,10 @@ class WebhookInfo(Model):
 
 
 class User(Model):
-    """User object `User`, see the [documentation](https://core.telegram.org/bots/api#user)
+    """Object `User`, see the [documentation](https://core.telegram.org/bots/api#user)
 
-    This object represents a Telegram user or bot."""
+    This object represents a Telegram user or bot.
+    """
 
     id: int
     """Unique identifier for this user or bot. This number may have more than 32 
@@ -317,14 +343,14 @@ class User(Model):
     """Optional. True, if the bot supports inline queries. Returned only in getMe."""
 
     @property
-    def color(self) -> DefaultUserColor:
-        """User's or bot's color."""
+    def default_accent_color(self) -> DefaultAccentColor:
+        """User's or bot's accent color (non-premium)."""
 
-        return DefaultUserColor(self.id % 7)
+        return DefaultAccentColor(self.id % 7)
 
     @property
     def full_name(self) -> str:
-        """User's or bot's `first_name` + `last_name`."""
+        """User's or bot's full name (`first_name` + `last_name`)."""
 
         return self.first_name + self.last_name.map(lambda v: " " + v).unwrap_or("")
 
@@ -332,7 +358,8 @@ class User(Model):
 class Chat(Model):
     """Object `Chat`, see the [documentation](https://core.telegram.org/bots/api#chat)
 
-    This object represents a chat."""
+    This object represents a chat.
+    """
 
     id: int
     """Unique identifier for this chat. This number may have more than 32 significant 
@@ -392,7 +419,7 @@ class Chat(Model):
     """Optional. Custom emoji identifier of the emoji status of the chat or the 
     other party in a private chat. Returned only in getChat."""
 
-    emoji_status_expiration_date: Option[int] = Nothing
+    emoji_status_expiration_date: Option[datetime] = Nothing
     """Optional. Expiration date of the emoji status of the chat or the other party 
     in a private chat, in Unix time, if any. Returned only in getChat."""
 
@@ -486,16 +513,24 @@ class Chat(Model):
     """Optional. For supergroups, the location to which the supergroup is connected. 
     Returned only in getChat."""
 
+    @property
+    def full_name(self) -> Option[str]:
+        """Optional. Full name (`first_name` + `last_name`) of the
+        other party in a `private` chat."""
+
+        return self.first_name.map(lambda x: x + " " + self.last_name.unwrap_or(""))
+
 
 class Message(MaybeInaccessibleMessage):
-    """Message object `Message`, see the [documentation](https://core.telegram.org/bots/api#message)
+    """Object `Message`, see the [documentation](https://core.telegram.org/bots/api#message)
 
-    This object represents a message."""
+    This object represents a message.
+    """
 
     message_id: int
     """Unique message identifier inside this chat."""
 
-    date: int
+    date: datetime
     """Date the message was sent in Unix time. It is always a positive number, representing 
     a valid date."""
 
@@ -559,7 +594,7 @@ class Message(MaybeInaccessibleMessage):
     via_bot: Option["User"] = Nothing
     """Optional. Bot through which the message was sent."""
 
-    edit_date: Option[int] = Nothing
+    edit_date: Option[datetime] = Nothing
     """Optional. Date the message was last edited in Unix time."""
 
     has_protected_content: Option[bool] = Nothing
@@ -795,25 +830,47 @@ class Message(MaybeInaccessibleMessage):
 
     @property
     def from_user(self) -> "User":
-        """`from_user` instead of `from_.unwrap()`"""
+        """`from_user` instead of `from_.unwrap()`."""
 
         return self.from_.unwrap()
 
-    def __eq__(self, other: "Message") -> bool:
-        return self.message_id == other.message_id and self.chat.id == other.chat.id
+    @property
+    def chat_id(self) -> int:
+        """`chat_id` instead of `chat.id`."""
+
+        return self.chat.id
+
+    @property
+    def chat_title(self) -> str:
+        """Chat title, for `supergroups`, `channels` and `group` chats.
+        Full name, for `private` chat."""
+
+        return (
+            self.chat.full_name.unwrap()
+            if self.chat.type == ChatType.PRIVATE
+            else self.chat.title.unwrap()
+        )
+
+    def __eq__(self, other: typing.Any) -> bool:
+        return (
+            isinstance(other, self.__class__)
+            and self.message_id == other.message_id
+            and self.chat_id == other.chat_id
+        )
 
 
 class MessageId(Model):
     """Object `MessageId`, see the [documentation](https://core.telegram.org/bots/api#messageid)
 
-    This object represents a unique message identifier."""
+    This object represents a unique message identifier.
+    """
 
     message_id: int
     """Unique message identifier."""
 
 
-class InaccessibleMessage(Model):
-    """Model object `InaccessibleMessage`, see the [documentation](https://core.telegram.org/bots/api#inaccessiblemessage)
+class InaccessibleMessage(MaybeInaccessibleMessage):
+    """Object `InaccessibleMessage`, see the [documentation](https://core.telegram.org/bots/api#inaccessiblemessage)
 
     This object describes a message that was deleted or is otherwise inaccessible to the bot.
     """
@@ -979,7 +1036,8 @@ class ExternalReplyInfo(Model):
 class ReplyParameters(Model):
     """Object `ReplyParameters`, see the [documentation](https://core.telegram.org/bots/api#replyparameters)
 
-    Describes reply parameters for the message that is being sent."""
+    Describes reply parameters for the message that is being sent.
+    """
 
     message_id: int
     """Identifier of the message that will be replied to in the current chat, or 
@@ -1016,12 +1074,13 @@ class ReplyParameters(Model):
 class MessageOriginUser(MessageOrigin):
     """Object `MessageOriginUser`, see the [documentation](https://core.telegram.org/bots/api#messageoriginuser)
 
-    The message was originally sent by a known user."""
+    The message was originally sent by a known user.
+    """
 
     type: typing.Literal["user"]
     """Type of the message origin, always `user`."""
 
-    date: int
+    date: datetime
     """Date the message was sent originally in Unix time."""
 
     sender_user: "User"
@@ -1031,12 +1090,13 @@ class MessageOriginUser(MessageOrigin):
 class MessageOriginHiddenUser(MessageOrigin):
     """Object `MessageOriginHiddenUser`, see the [documentation](https://core.telegram.org/bots/api#messageoriginhiddenuser)
 
-    The message was originally sent by an unknown user."""
+    The message was originally sent by an unknown user.
+    """
 
     type: typing.Literal["hidden_user"]
     """Type of the message origin, always `hidden_user`."""
 
-    date: int
+    date: datetime
     """Date the message was sent originally in Unix time."""
 
     sender_user_name: str
@@ -1046,12 +1106,13 @@ class MessageOriginHiddenUser(MessageOrigin):
 class MessageOriginChat(MessageOrigin):
     """Object `MessageOriginChat`, see the [documentation](https://core.telegram.org/bots/api#messageoriginchat)
 
-    The message was originally sent on behalf of a chat to a group chat."""
+    The message was originally sent on behalf of a chat to a group chat.
+    """
 
     type: typing.Literal["chat"]
     """Type of the message origin, always `chat`."""
 
-    date: int
+    date: datetime
     """Date the message was sent originally in Unix time."""
 
     sender_chat: "Chat"
@@ -1065,12 +1126,13 @@ class MessageOriginChat(MessageOrigin):
 class MessageOriginChannel(MessageOrigin):
     """Object `MessageOriginChannel`, see the [documentation](https://core.telegram.org/bots/api#messageoriginchannel)
 
-    The message was originally sent to a channel chat."""
+    The message was originally sent to a channel chat.
+    """
 
     type: typing.Literal["channel"]
     """Type of the message origin, always `channel`."""
 
-    date: int
+    date: datetime
     """Date the message was sent originally in Unix time."""
 
     chat: "Chat"
@@ -1086,7 +1148,8 @@ class MessageOriginChannel(MessageOrigin):
 class PhotoSize(Model):
     """Object `PhotoSize`, see the [documentation](https://core.telegram.org/bots/api#photosize)
 
-    This object represents one size of a photo or a file / sticker thumbnail."""
+    This object represents one size of a photo or a file / sticker thumbnail.
+    """
 
     file_id: str
     """Identifier for this file, which can be used to download or reuse the file."""
@@ -1213,7 +1276,8 @@ class Document(Model):
 class Story(Model):
     """Object `Story`, see the [documentation](https://core.telegram.org/bots/api#story)
 
-    This object represents a story."""
+    This object represents a story.
+    """
 
     chat: "Chat"
     """Chat that posted the story."""
@@ -1225,7 +1289,8 @@ class Story(Model):
 class Video(Model):
     """Object `Video`, see the [documentation](https://core.telegram.org/bots/api#video)
 
-    This object represents a video file."""
+    This object represents a video file.
+    """
 
     file_id: str
     """Identifier for this file, which can be used to download or reuse the file."""
@@ -1262,7 +1327,8 @@ class Video(Model):
 class VideoNote(Model):
     """Object `VideoNote`, see the [documentation](https://core.telegram.org/bots/api#videonote)
 
-    This object represents a video message (available in Telegram apps as of v.4.0)."""
+    This object represents a video message (available in Telegram apps as of v.4.0).
+    """
 
     file_id: str
     """Identifier for this file, which can be used to download or reuse the file."""
@@ -1287,7 +1353,8 @@ class VideoNote(Model):
 class Voice(Model):
     """Object `Voice`, see the [documentation](https://core.telegram.org/bots/api#voice)
 
-    This object represents a voice note."""
+    This object represents a voice note.
+    """
 
     file_id: str
     """Identifier for this file, which can be used to download or reuse the file."""
@@ -1312,7 +1379,8 @@ class Voice(Model):
 class Contact(Model):
     """Object `Contact`, see the [documentation](https://core.telegram.org/bots/api#contact)
 
-    This object represents a phone contact."""
+    This object represents a phone contact.
+    """
 
     phone_number: str
     """Contact's phone number."""
@@ -1336,7 +1404,8 @@ class Contact(Model):
 class Dice(Model):
     """Object `Dice`, see the [documentation](https://core.telegram.org/bots/api#dice)
 
-    This object represents an animated emoji that displays a random value."""
+    This object represents an animated emoji that displays a random value.
+    """
 
     emoji: DiceEmoji
     """Emoji on which the dice throw animation is based."""
@@ -1349,7 +1418,8 @@ class Dice(Model):
 class PollOption(Model):
     """Object `PollOption`, see the [documentation](https://core.telegram.org/bots/api#polloption)
 
-    This object contains information about one answer option in a poll."""
+    This object contains information about one answer option in a poll.
+    """
 
     text: str
     """Option text, 1-100 characters."""
@@ -1361,7 +1431,8 @@ class PollOption(Model):
 class PollAnswer(Model):
     """Object `PollAnswer`, see the [documentation](https://core.telegram.org/bots/api#pollanswer)
 
-    This object represents an answer of a user in a non-anonymous poll."""
+    This object represents an answer of a user in a non-anonymous poll.
+    """
 
     poll_id: str
     """Unique poll identifier."""
@@ -1381,7 +1452,8 @@ class PollAnswer(Model):
 class Poll(Model):
     """Object `Poll`, see the [documentation](https://core.telegram.org/bots/api#poll)
 
-    This object contains information about a poll."""
+    This object contains information about a poll.
+    """
 
     id: str
     """Unique poll identifier."""
@@ -1401,7 +1473,7 @@ class Poll(Model):
     is_anonymous: bool
     """True, if the poll is anonymous."""
 
-    type: str
+    type: typing.Literal["regular", "quiz"]
     """Poll type, currently can be `regular` or `quiz`."""
 
     allows_multiple_answers: bool
@@ -1423,7 +1495,7 @@ class Poll(Model):
     open_period: Option[int] = Nothing
     """Optional. Amount of time in seconds the poll will be active after creation."""
 
-    close_date: Option[int] = Nothing
+    close_date: Option[datetime] = Nothing
     """Optional. Point in time (Unix timestamp) when the poll will be automatically 
     closed."""
 
@@ -1431,7 +1503,8 @@ class Poll(Model):
 class Location(Model):
     """Object `Location`, see the [documentation](https://core.telegram.org/bots/api#location)
 
-    This object represents a point on the map."""
+    This object represents a point on the map.
+    """
 
     latitude: float
     """Latitude as defined by sender."""
@@ -1459,7 +1532,8 @@ class Location(Model):
 class Venue(Model):
     """Object `Venue`, see the [documentation](https://core.telegram.org/bots/api#venue)
 
-    This object represents a venue."""
+    This object represents a venue.
+    """
 
     location: "Location"
     """Venue location. Can't be a live location."""
@@ -1487,7 +1561,8 @@ class Venue(Model):
 class WebAppData(Model):
     """Object `WebAppData`, see the [documentation](https://core.telegram.org/bots/api#webappdata)
 
-    Describes data sent from a Web App to the bot."""
+    Describes data sent from a Web App to the bot.
+    """
 
     data: str
     """The data. Be aware that a bad client can send arbitrary data in this field."""
@@ -1526,7 +1601,8 @@ class MessageAutoDeleteTimerChanged(Model):
 class ChatBoostAdded(Model):
     """Object `ChatBoostAdded`, see the [documentation](https://core.telegram.org/bots/api#chatboostadded)
 
-    This object represents a service message about a user boosting a chat."""
+    This object represents a service message about a user boosting a chat.
+    """
 
     boost_count: int
     """Number of boosts added by the user."""
@@ -1558,7 +1634,8 @@ class ForumTopicClosed(Model):
 class ForumTopicEdited(Model):
     """Object `ForumTopicEdited`, see the [documentation](https://core.telegram.org/bots/api#forumtopicedited)
 
-    This object represents a service message about an edited forum topic."""
+    This object represents a service message about an edited forum topic.
+    """
 
     name: Option[str] = Nothing
     """Optional. New name of the topic, if it was edited."""
@@ -1650,7 +1727,7 @@ class VideoChatScheduled(Model):
     This object represents a service message about a video chat scheduled in the chat.
     """
 
-    start_date: int
+    start_date: datetime
     """Point in time (Unix timestamp) when the video chat is supposed to be started 
     by a chat administrator."""
 
@@ -1665,7 +1742,8 @@ class VideoChatStarted(Model):
 class VideoChatEnded(Model):
     """Object `VideoChatEnded`, see the [documentation](https://core.telegram.org/bots/api#videochatended)
 
-    This object represents a service message about a video chat ended in the chat."""
+    This object represents a service message about a video chat ended in the chat.
+    """
 
     duration: int
     """Video chat duration in seconds."""
@@ -1691,12 +1769,13 @@ class GiveawayCreated(Model):
 class Giveaway(Model):
     """Object `Giveaway`, see the [documentation](https://core.telegram.org/bots/api#giveaway)
 
-    This object represents a message about a scheduled giveaway."""
+    This object represents a message about a scheduled giveaway.
+    """
 
     chats: list["Chat"]
     """The list of chats which the user must join to participate in the giveaway."""
 
-    winners_selection_date: int
+    winners_selection_date: datetime
     """Point in time (Unix timestamp) when winners of the giveaway will be selected."""
 
     winner_count: int
@@ -1735,7 +1814,7 @@ class GiveawayWinners(Model):
     giveaway_message_id: int
     """Identifier of the message with the giveaway in the chat."""
 
-    winners_selection_date: int
+    winners_selection_date: datetime
     """Point in time (Unix timestamp) when winners of the giveaway were selected."""
 
     winner_count: int
@@ -1786,7 +1865,8 @@ class GiveawayCompleted(Model):
 class LinkPreviewOptions(Model):
     """Object `LinkPreviewOptions`, see the [documentation](https://core.telegram.org/bots/api#linkpreviewoptions)
 
-    Describes the options used for link preview generation."""
+    Describes the options used for link preview generation.
+    """
 
     is_disabled: Option[bool] = Nothing
     """Optional. True, if the link preview is disabled."""
@@ -1813,7 +1893,8 @@ class LinkPreviewOptions(Model):
 class UserProfilePhotos(Model):
     """Object `UserProfilePhotos`, see the [documentation](https://core.telegram.org/bots/api#userprofilephotos)
 
-    This object represent a user's profile pictures."""
+    This object represent a user's profile pictures.
+    """
 
     total_count: int
     """Total number of profile pictures the target user has."""
@@ -1849,7 +1930,8 @@ class File(Model):
 class WebAppInfo(Model):
     """Object `WebAppInfo`, see the [documentation](https://core.telegram.org/bots/api#webappinfo)
 
-    Describes a Web App."""
+    Describes a Web App.
+    """
 
     url: str
     """An HTTPS URL of a Web App to be opened with additional data as specified in 
@@ -1894,6 +1976,12 @@ class ReplyKeyboardMarkup(Model):
     change the bot's language, bot replies to the request with a keyboard to 
     select the new language. Other users in the group don't see the keyboard."""
 
+    @property
+    def empty_markup(self) -> "ReplyKeyboardRemove":
+        """Empty keyboard to remove the custom keyboard."""
+
+        return ReplyKeyboardRemove(remove_keyboard=True, selective=self.selective)
+
 
 class KeyboardButton(Model):
     """Object `KeyboardButton`, see the [documentation](https://core.telegram.org/bots/api#keyboardbutton)
@@ -2005,7 +2093,7 @@ class KeyboardButtonPollType(Model):
     This object represents type of a poll, which is allowed to be created and sent when the corresponding button is pressed.
     """
 
-    type: Option[str] = Nothing
+    type: Option[typing.Literal["quiz", "regular"]] = Nothing
     """Optional. If quiz is passed, the user will be allowed to create only polls 
     in the quiz mode. If regular is passed, only regular polls will be allowed. 
     Otherwise, the user will be allowed to create a poll of any type."""
@@ -2104,7 +2192,8 @@ class LoginUrl(Model):
     """Object `LoginUrl`, see the [documentation](https://core.telegram.org/bots/api#loginurl)
 
     This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the Telegram Login Widget when the user is coming from Telegram. All the user needs to do is tap/click a button and confirm that they want to log in:
-    Telegram apps support these buttons as of version 5.7."""
+    Telegram apps support these buttons as of version 5.7.
+    """
 
     url: str
     """An HTTPS URL to be opened with user authorization data added to the query 
@@ -2208,7 +2297,8 @@ class ForceReply(Model):
 class ChatPhoto(Model):
     """Object `ChatPhoto`, see the [documentation](https://core.telegram.org/bots/api#chatphoto)
 
-    This object represents a chat photo."""
+    This object represents a chat photo.
+    """
 
     small_file_id: str
     """File identifier of small (160x160) chat photo. This file_id can be used 
@@ -2232,7 +2322,8 @@ class ChatPhoto(Model):
 class ChatInviteLink(Model):
     """Object `ChatInviteLink`, see the [documentation](https://core.telegram.org/bots/api#chatinvitelink)
 
-    Represents an invite link for a chat."""
+    Represents an invite link for a chat.
+    """
 
     invite_link: str
     """The invite link. If the link was created by another chat administrator, 
@@ -2253,7 +2344,7 @@ class ChatInviteLink(Model):
     name: Option[str] = Nothing
     """Optional. Invite link name."""
 
-    expire_date: Option[int] = Nothing
+    expire_date: Option[datetime] = Nothing
     """Optional. Point in time (Unix timestamp) when the link will expire or has 
     been expired."""
 
@@ -2268,7 +2359,8 @@ class ChatInviteLink(Model):
 class ChatAdministratorRights(Model):
     """Object `ChatAdministratorRights`, see the [documentation](https://core.telegram.org/bots/api#chatadministratorrights)
 
-    Represents the rights of an administrator in a chat."""
+    Represents the rights of an administrator in a chat.
+    """
 
     is_anonymous: bool
     """True, if the user's presence in the chat is hidden."""
@@ -2310,25 +2402,26 @@ class ChatAdministratorRights(Model):
 
     can_post_messages: Option[bool] = Nothing
     """Optional. True, if the administrator can post messages in the channel, 
-    or access channel statistics; channels only."""
+    or access channel statistics; for channels only."""
 
     can_edit_messages: Option[bool] = Nothing
     """Optional. True, if the administrator can edit messages of other users and 
-    can pin messages; channels only."""
+    can pin messages; for channels only."""
 
     can_pin_messages: Option[bool] = Nothing
-    """Optional. True, if the user is allowed to pin messages; groups and supergroups 
+    """Optional. True, if the user is allowed to pin messages; for groups and supergroups 
     only."""
 
     can_manage_topics: Option[bool] = Nothing
     """Optional. True, if the user is allowed to create, rename, close, and reopen 
-    forum topics; supergroups only."""
+    forum topics; for supergroups only."""
 
 
 class ChatMemberUpdated(Model):
     """Object `ChatMemberUpdated`, see the [documentation](https://core.telegram.org/bots/api#chatmemberupdated)
 
-    This object represents changes in the status of a chat member."""
+    This object represents changes in the status of a chat member.
+    """
 
     chat: "Chat"
     """Chat the user belongs to."""
@@ -2336,7 +2429,7 @@ class ChatMemberUpdated(Model):
     from_: "User"
     """Performer of the action, which resulted in the change."""
 
-    date: int
+    date: datetime
     """Date the change was done in Unix time."""
 
     old_chat_member: Variative[
@@ -2370,7 +2463,8 @@ class ChatMemberUpdated(Model):
 class ChatMemberOwner(ChatMember):
     """Object `ChatMemberOwner`, see the [documentation](https://core.telegram.org/bots/api#chatmemberowner)
 
-    Represents a chat member that owns the chat and has all administrator privileges."""
+    Represents a chat member that owns the chat and has all administrator privileges.
+    """
 
     status: typing.Literal["creator"]
     """The member's status in the chat, always `creator`."""
@@ -2388,7 +2482,8 @@ class ChatMemberOwner(ChatMember):
 class ChatMemberAdministrator(ChatMember):
     """Object `ChatMemberAdministrator`, see the [documentation](https://core.telegram.org/bots/api#chatmemberadministrator)
 
-    Represents a chat member that has some additional privileges."""
+    Represents a chat member that has some additional privileges.
+    """
 
     status: typing.Literal["administrator"]
     """The member's status in the chat, always `administrator`."""
@@ -2439,19 +2534,19 @@ class ChatMemberAdministrator(ChatMember):
 
     can_post_messages: Option[bool] = Nothing
     """Optional. True, if the administrator can post messages in the channel, 
-    or access channel statistics; channels only."""
+    or access channel statistics; for channels only."""
 
     can_edit_messages: Option[bool] = Nothing
     """Optional. True, if the administrator can edit messages of other users and 
-    can pin messages; channels only."""
+    can pin messages; for channels only."""
 
     can_pin_messages: Option[bool] = Nothing
-    """Optional. True, if the user is allowed to pin messages; groups and supergroups 
+    """Optional. True, if the user is allowed to pin messages; for groups and supergroups 
     only."""
 
     can_manage_topics: Option[bool] = Nothing
     """Optional. True, if the user is allowed to create, rename, close, and reopen 
-    forum topics; supergroups only."""
+    forum topics; for supergroups only."""
 
     custom_title: Option[str] = Nothing
     """Optional. Custom title for this user."""
@@ -2460,7 +2555,8 @@ class ChatMemberAdministrator(ChatMember):
 class ChatMemberMember(ChatMember):
     """Object `ChatMemberMember`, see the [documentation](https://core.telegram.org/bots/api#chatmembermember)
 
-    Represents a chat member that has no additional privileges or restrictions."""
+    Represents a chat member that has no additional privileges or restrictions.
+    """
 
     status: typing.Literal["member"]
     """The member's status in the chat, always `member`."""
@@ -2528,7 +2624,7 @@ class ChatMemberRestricted(ChatMember):
     can_manage_topics: bool
     """True, if the user is allowed to create forum topics."""
 
-    until_date: int
+    until_date: datetime
     """Date when restrictions will be lifted for this user; Unix time. If 0, then 
     the user is restricted forever."""
 
@@ -2558,7 +2654,7 @@ class ChatMemberBanned(ChatMember):
     user: "User"
     """Information about the user."""
 
-    until_date: int
+    until_date: datetime
     """Date when restrictions will be lifted for this user; Unix time. If 0, then 
     the user is banned forever."""
 
@@ -2566,7 +2662,8 @@ class ChatMemberBanned(ChatMember):
 class ChatJoinRequest(Model):
     """Object `ChatJoinRequest`, see the [documentation](https://core.telegram.org/bots/api#chatjoinrequest)
 
-    Represents a join request sent to a chat."""
+    Represents a join request sent to a chat.
+    """
 
     chat: "Chat"
     """Chat to which the request was sent."""
@@ -2583,7 +2680,7 @@ class ChatJoinRequest(Model):
     5 minutes to send messages until the join request is processed, assuming 
     no other administrator contacted the user."""
 
-    date: int
+    date: datetime
     """Date the request was sent in Unix time."""
 
     bio: Option[str] = Nothing
@@ -2596,7 +2693,8 @@ class ChatJoinRequest(Model):
 class ChatPermissions(Model):
     """Object `ChatPermissions`, see the [documentation](https://core.telegram.org/bots/api#chatpermissions)
 
-    Describes actions that a non-administrator user is allowed to take in a chat."""
+    Describes actions that a non-administrator user is allowed to take in a chat.
+    """
 
     can_send_messages: Option[bool] = Nothing
     """Optional. True, if the user is allowed to send text messages, contacts, 
@@ -2649,7 +2747,8 @@ class ChatPermissions(Model):
 class ChatLocation(Model):
     """Object `ChatLocation`, see the [documentation](https://core.telegram.org/bots/api#chatlocation)
 
-    Represents a location to which a chat is connected."""
+    Represents a location to which a chat is connected.
+    """
 
     location: "Location"
     """The location to which the supergroup is connected. Can't be a live location."""
@@ -2661,7 +2760,8 @@ class ChatLocation(Model):
 class ReactionTypeEmoji(ReactionType):
     """Object `ReactionTypeEmoji`, see the [documentation](https://core.telegram.org/bots/api#reactiontypeemoji)
 
-    The reaction is based on an emoji."""
+    The reaction is based on an emoji.
+    """
 
     type: typing.Literal["emoji"]
     """Type of the reaction, always `emoji`."""
@@ -2678,7 +2778,8 @@ class ReactionTypeEmoji(ReactionType):
 class ReactionTypeCustomEmoji(ReactionType):
     """Object `ReactionTypeCustomEmoji`, see the [documentation](https://core.telegram.org/bots/api#reactiontypecustomemoji)
 
-    The reaction is based on a custom emoji."""
+    The reaction is based on a custom emoji.
+    """
 
     type: typing.Literal["custom_emoji"]
     """Type of the reaction, always `custom_emoji`."""
@@ -2703,7 +2804,8 @@ class ReactionCount(Model):
 class MessageReactionUpdated(Model):
     """Object `MessageReactionUpdated`, see the [documentation](https://core.telegram.org/bots/api#messagereactionupdated)
 
-    This object represents a change of a reaction on a message performed by a user."""
+    This object represents a change of a reaction on a message performed by a user.
+    """
 
     chat: "Chat"
     """The chat containing the message the user reacted to."""
@@ -2711,7 +2813,7 @@ class MessageReactionUpdated(Model):
     message_id: int
     """Unique identifier of the message inside the chat."""
 
-    date: int
+    date: datetime
     """Date of the change in Unix time."""
 
     old_reaction: list[Variative["ReactionTypeEmoji", "ReactionTypeCustomEmoji"]]
@@ -2731,7 +2833,8 @@ class MessageReactionUpdated(Model):
 class MessageReactionCountUpdated(Model):
     """Object `MessageReactionCountUpdated`, see the [documentation](https://core.telegram.org/bots/api#messagereactioncountupdated)
 
-    This object represents reaction changes on a message with anonymous reactions."""
+    This object represents reaction changes on a message with anonymous reactions.
+    """
 
     chat: "Chat"
     """The chat containing the message."""
@@ -2739,7 +2842,7 @@ class MessageReactionCountUpdated(Model):
     message_id: int
     """Unique message identifier inside the chat."""
 
-    date: int
+    date: datetime
     """Date of the change in Unix time."""
 
     reactions: list["ReactionCount"]
@@ -2749,7 +2852,8 @@ class MessageReactionCountUpdated(Model):
 class ForumTopic(Model):
     """Object `ForumTopic`, see the [documentation](https://core.telegram.org/bots/api#forumtopic)
 
-    This object represents a forum topic."""
+    This object represents a forum topic.
+    """
 
     message_thread_id: int
     """Unique identifier of the forum topic."""
@@ -2767,7 +2871,8 @@ class ForumTopic(Model):
 class BotCommand(Model):
     """Object `BotCommand`, see the [documentation](https://core.telegram.org/bots/api#botcommand)
 
-    This object represents a bot command."""
+    This object represents a bot command.
+    """
 
     command: str
     """Text of the command; 1-32 characters. Can contain only lowercase English 
@@ -2790,7 +2895,8 @@ class BotCommandScopeDefault(BotCommandScope):
 class BotCommandScopeAllPrivateChats(BotCommandScope):
     """Object `BotCommandScopeAllPrivateChats`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallprivatechats)
 
-    Represents the scope of bot commands, covering all private chats."""
+    Represents the scope of bot commands, covering all private chats.
+    """
 
     type: typing.Literal["all_private_chats"]
     """Scope type, must be all_private_chats."""
@@ -2799,7 +2905,8 @@ class BotCommandScopeAllPrivateChats(BotCommandScope):
 class BotCommandScopeAllGroupChats(BotCommandScope):
     """Object `BotCommandScopeAllGroupChats`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallgroupchats)
 
-    Represents the scope of bot commands, covering all group and supergroup chats."""
+    Represents the scope of bot commands, covering all group and supergroup chats.
+    """
 
     type: typing.Literal["all_group_chats"]
     """Scope type, must be all_group_chats."""
@@ -2818,7 +2925,8 @@ class BotCommandScopeAllChatAdministrators(BotCommandScope):
 class BotCommandScopeChat(BotCommandScope):
     """Object `BotCommandScopeChat`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopechat)
 
-    Represents the scope of bot commands, covering a specific chat."""
+    Represents the scope of bot commands, covering a specific chat.
+    """
 
     type: typing.Literal["chat"]
     """Scope type, must be chat."""
@@ -2862,7 +2970,8 @@ class BotCommandScopeChatMember(BotCommandScope):
 class BotName(Model):
     """Object `BotName`, see the [documentation](https://core.telegram.org/bots/api#botname)
 
-    This object represents the bot's name."""
+    This object represents the bot's name.
+    """
 
     name: str
     """The bot's name."""
@@ -2871,7 +2980,8 @@ class BotName(Model):
 class BotDescription(Model):
     """Object `BotDescription`, see the [documentation](https://core.telegram.org/bots/api#botdescription)
 
-    This object represents the bot's description."""
+    This object represents the bot's description.
+    """
 
     description: str
     """The bot's description."""
@@ -2880,7 +2990,8 @@ class BotDescription(Model):
 class BotShortDescription(Model):
     """Object `BotShortDescription`, see the [documentation](https://core.telegram.org/bots/api#botshortdescription)
 
-    This object represents the bot's short description."""
+    This object represents the bot's short description.
+    """
 
     short_description: str
     """The bot's short description."""
@@ -2889,7 +3000,8 @@ class BotShortDescription(Model):
 class MenuButtonCommands(MenuButton):
     """Object `MenuButtonCommands`, see the [documentation](https://core.telegram.org/bots/api#menubuttoncommands)
 
-    Represents a menu button, which opens the bot's list of commands."""
+    Represents a menu button, which opens the bot's list of commands.
+    """
 
     type: typing.Literal["commands"]
     """Type of the button, must be commands."""
@@ -2898,7 +3010,8 @@ class MenuButtonCommands(MenuButton):
 class MenuButtonWebApp(MenuButton):
     """Object `MenuButtonWebApp`, see the [documentation](https://core.telegram.org/bots/api#menubuttonwebapp)
 
-    Represents a menu button, which launches a Web App."""
+    Represents a menu button, which launches a Web App.
+    """
 
     type: typing.Literal["web_app"]
     """Type of the button, must be web_app."""
@@ -2915,7 +3028,8 @@ class MenuButtonWebApp(MenuButton):
 class MenuButtonDefault(MenuButton):
     """Object `MenuButtonDefault`, see the [documentation](https://core.telegram.org/bots/api#menubuttondefault)
 
-    Describes that no specific value for the menu button was set."""
+    Describes that no specific value for the menu button was set.
+    """
 
     type: typing.Literal["default"]
     """Type of the button, must be default."""
@@ -2971,15 +3085,16 @@ class ChatBoostSourceGiveaway(ChatBoostSource):
 class ChatBoost(Model):
     """Object `ChatBoost`, see the [documentation](https://core.telegram.org/bots/api#chatboost)
 
-    This object contains information about a chat boost."""
+    This object contains information about a chat boost.
+    """
 
     boost_id: str
     """Unique identifier of the boost."""
 
-    add_date: int
+    add_date: datetime
     """Point in time (Unix timestamp) when the chat was boosted."""
 
-    expiration_date: int
+    expiration_date: datetime
     """Point in time (Unix timestamp) when the boost will automatically expire, 
     unless the booster's Telegram Premium subscription is prolonged."""
 
@@ -2992,7 +3107,8 @@ class ChatBoost(Model):
 class ChatBoostUpdated(Model):
     """Object `ChatBoostUpdated`, see the [documentation](https://core.telegram.org/bots/api#chatboostupdated)
 
-    This object represents a boost added to a chat or changed."""
+    This object represents a boost added to a chat or changed.
+    """
 
     chat: "Chat"
     """Chat which was boosted."""
@@ -3004,7 +3120,8 @@ class ChatBoostUpdated(Model):
 class ChatBoostRemoved(Model):
     """Object `ChatBoostRemoved`, see the [documentation](https://core.telegram.org/bots/api#chatboostremoved)
 
-    This object represents a boost removed from a chat."""
+    This object represents a boost removed from a chat.
+    """
 
     chat: "Chat"
     """Chat which was boosted."""
@@ -3012,7 +3129,7 @@ class ChatBoostRemoved(Model):
     boost_id: str
     """Unique identifier of the boost."""
 
-    remove_date: int
+    remove_date: datetime
     """Point in time (Unix timestamp) when the boost was removed."""
 
     source: Variative[
@@ -3024,7 +3141,8 @@ class ChatBoostRemoved(Model):
 class UserChatBoosts(Model):
     """Object `UserChatBoosts`, see the [documentation](https://core.telegram.org/bots/api#userchatboosts)
 
-    This object represents a list of boosts added to a chat by a user."""
+    This object represents a list of boosts added to a chat by a user.
+    """
 
     boosts: list["ChatBoost"]
     """The list of boosts added to the chat by the user."""
@@ -3033,7 +3151,8 @@ class UserChatBoosts(Model):
 class ResponseParameters(Model):
     """Object `ResponseParameters`, see the [documentation](https://core.telegram.org/bots/api#responseparameters)
 
-    Describes why a request was unsuccessful."""
+    Describes why a request was unsuccessful.
+    """
 
     migrate_to_chat_id: Option[int] = Nothing
     """Optional. The group has been migrated to a supergroup with the specified 
@@ -3050,12 +3169,13 @@ class ResponseParameters(Model):
 class InputMediaPhoto(InputMedia):
     """Object `InputMediaPhoto`, see the [documentation](https://core.telegram.org/bots/api#inputmediaphoto)
 
-    Represents a photo to be sent."""
+    Represents a photo to be sent.
+    """
 
     type: typing.Literal["photo"]
     """Type of the result, must be photo."""
 
-    media: str
+    media: Variative["InputFile", str]
     """File to send. Pass a file_id to send a file that exists on the Telegram servers 
     (recommended), pass an HTTP URL for Telegram to get a file from the Internet, 
     or pass `attach://<file_attach_name>` to upload a new one using multipart/form-data 
@@ -3080,12 +3200,13 @@ class InputMediaPhoto(InputMedia):
 class InputMediaVideo(InputMedia):
     """Object `InputMediaVideo`, see the [documentation](https://core.telegram.org/bots/api#inputmediavideo)
 
-    Represents a video to be sent."""
+    Represents a video to be sent.
+    """
 
     type: typing.Literal["video"]
     """Type of the result, must be video."""
 
-    media: str
+    media: Variative["InputFile", str]
     """File to send. Pass a file_id to send a file that exists on the Telegram servers 
     (recommended), pass an HTTP URL for Telegram to get a file from the Internet, 
     or pass `attach://<file_attach_name>` to upload a new one using multipart/form-data 
@@ -3137,7 +3258,7 @@ class InputMediaAnimation(InputMedia):
     type: typing.Literal["animation"]
     """Type of the result, must be animation."""
 
-    media: str
+    media: Variative["InputFile", str]
     """File to send. Pass a file_id to send a file that exists on the Telegram servers 
     (recommended), pass an HTTP URL for Telegram to get a file from the Internet, 
     or pass `attach://<file_attach_name>` to upload a new one using multipart/form-data 
@@ -3180,12 +3301,13 @@ class InputMediaAnimation(InputMedia):
 class InputMediaAudio(InputMedia):
     """Object `InputMediaAudio`, see the [documentation](https://core.telegram.org/bots/api#inputmediaaudio)
 
-    Represents an audio file to be treated as music to be sent."""
+    Represents an audio file to be treated as music to be sent.
+    """
 
     type: typing.Literal["audio"]
     """Type of the result, must be audio."""
 
-    media: str
+    media: Variative["InputFile", str]
     """File to send. Pass a file_id to send a file that exists on the Telegram servers 
     (recommended), pass an HTTP URL for Telegram to get a file from the Internet, 
     or pass `attach://<file_attach_name>` to upload a new one using multipart/form-data 
@@ -3225,12 +3347,13 @@ class InputMediaAudio(InputMedia):
 class InputMediaDocument(InputMedia):
     """Object `InputMediaDocument`, see the [documentation](https://core.telegram.org/bots/api#inputmediadocument)
 
-    Represents a general file to be sent."""
+    Represents a general file to be sent.
+    """
 
     type: typing.Literal["document"]
     """Type of the result, must be document."""
 
-    media: str
+    media: Variative["InputFile", str]
     """File to send. Pass a file_id to send a file that exists on the Telegram servers 
     (recommended), pass an HTTP URL for Telegram to get a file from the Internet, 
     or pass `attach://<file_attach_name>` to upload a new one using multipart/form-data 
@@ -3270,7 +3393,7 @@ class InputFile(typing.NamedTuple):
     """
 
     filename: str
-    """Filename."""
+    """File name."""
 
     data: bytes
     """Bytes of file."""
@@ -3279,7 +3402,8 @@ class InputFile(typing.NamedTuple):
 class Sticker(Model):
     """Object `Sticker`, see the [documentation](https://core.telegram.org/bots/api#sticker)
 
-    This object represents a sticker."""
+    This object represents a sticker.
+    """
 
     file_id: str
     """Identifier for this file, which can be used to download or reuse the file."""
@@ -3335,7 +3459,8 @@ class Sticker(Model):
 class StickerSet(Model):
     """Object `StickerSet`, see the [documentation](https://core.telegram.org/bots/api#stickerset)
 
-    This object represents a sticker set."""
+    This object represents a sticker set.
+    """
 
     name: str
     """Sticker set name."""
@@ -3386,7 +3511,8 @@ class MaskPosition(Model):
 class InputSticker(Model):
     """Object `InputSticker`, see the [documentation](https://core.telegram.org/bots/api#inputsticker)
 
-    This object describes a sticker to be added to a sticker set."""
+    This object describes a sticker to be added to a sticker set.
+    """
 
     sticker: Variative["InputFile", str]
     """The added sticker. Pass a file_id as a String to send a file that already exists 
@@ -3467,7 +3593,8 @@ class InlineQueryResultsButton(Model):
 class InlineQueryResultArticle(InlineQueryResult):
     """Object `InlineQueryResultArticle`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultarticle)
 
-    Represents a link to an article or web page."""
+    Represents a link to an article or web page.
+    """
 
     type: typing.Literal["article"]
     """Type of the result, must be article."""
@@ -3594,7 +3721,9 @@ class InlineQueryResultGif(InlineQueryResult):
     gif_duration: Option[int] = Nothing
     """Optional. Duration of the GIF in seconds."""
 
-    thumbnail_mime_type: Option[str] = Nothing
+    thumbnail_mime_type: Option[
+        typing.Literal["image/jpeg", "image/gif", "video/mp4"]
+    ] = Nothing
     """Optional. MIME type of the thumbnail, must be one of `image/jpeg`, `image/gif`, 
     or `video/mp4`. Defaults to `image/jpeg`."""
 
@@ -3655,7 +3784,9 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult):
     mpeg4_duration: Option[int] = Nothing
     """Optional. Video duration in seconds."""
 
-    thumbnail_mime_type: Option[str] = Nothing
+    thumbnail_mime_type: Option[
+        typing.Literal["image/jpeg", "image/gif", "video/mp4"]
+    ] = Nothing
     """Optional. MIME type of the thumbnail, must be one of `image/jpeg`, `image/gif`, 
     or `video/mp4`. Defaults to `image/jpeg`."""
 
@@ -3869,7 +4000,7 @@ class InlineQueryResultDocument(InlineQueryResult):
     document_url: str
     """A valid URL for the file."""
 
-    mime_type: str
+    mime_type: typing.Literal["application/pdf", "application/zip"]
     """MIME type of the content of the file, either `application/pdf` or `application/zip`."""
 
     caption: Option[str] = Nothing
@@ -4086,7 +4217,8 @@ class InlineQueryResultContact(InlineQueryResult):
 class InlineQueryResultGame(InlineQueryResult):
     """Object `InlineQueryResultGame`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultgame)
 
-    Represents a Game."""
+    Represents a Game.
+    """
 
     type: typing.Literal["game"]
     """Type of the result, must be game."""
@@ -4663,7 +4795,8 @@ class ChosenInlineResult(Model):
 class SentWebAppMessage(Model):
     """Object `SentWebAppMessage`, see the [documentation](https://core.telegram.org/bots/api#sentwebappmessage)
 
-    Describes an inline message sent by a Web App on behalf of a user."""
+    Describes an inline message sent by a Web App on behalf of a user.
+    """
 
     inline_message_id: Option[str] = Nothing
     """Optional. Identifier of the sent inline message. Available only if there 
@@ -4673,7 +4806,8 @@ class SentWebAppMessage(Model):
 class LabeledPrice(Model):
     """Object `LabeledPrice`, see the [documentation](https://core.telegram.org/bots/api#labeledprice)
 
-    This object represents a portion of the price for goods or services."""
+    This object represents a portion of the price for goods or services.
+    """
 
     label: str
     """Portion label."""
@@ -4688,7 +4822,8 @@ class LabeledPrice(Model):
 class Invoice(Model):
     """Object `Invoice`, see the [documentation](https://core.telegram.org/bots/api#invoice)
 
-    This object contains basic information about an invoice."""
+    This object contains basic information about an invoice.
+    """
 
     title: str
     """Product name."""
@@ -4712,7 +4847,8 @@ class Invoice(Model):
 class ShippingAddress(Model):
     """Object `ShippingAddress`, see the [documentation](https://core.telegram.org/bots/api#shippingaddress)
 
-    This object represents a shipping address."""
+    This object represents a shipping address.
+    """
 
     country_code: str
     """Two-letter ISO 3166-1 alpha-2 country code."""
@@ -4736,7 +4872,8 @@ class ShippingAddress(Model):
 class OrderInfo(Model):
     """Object `OrderInfo`, see the [documentation](https://core.telegram.org/bots/api#orderinfo)
 
-    This object represents information about an order."""
+    This object represents information about an order.
+    """
 
     name: Option[str] = Nothing
     """Optional. User name."""
@@ -4754,7 +4891,8 @@ class OrderInfo(Model):
 class ShippingOption(Model):
     """Object `ShippingOption`, see the [documentation](https://core.telegram.org/bots/api#shippingoption)
 
-    This object represents one shipping option."""
+    This object represents one shipping option.
+    """
 
     id: str
     """Shipping option identifier."""
@@ -4769,7 +4907,8 @@ class ShippingOption(Model):
 class SuccessfulPayment(Model):
     """Object `SuccessfulPayment`, see the [documentation](https://core.telegram.org/bots/api#successfulpayment)
 
-    This object contains basic information about a successful payment."""
+    This object contains basic information about a successful payment.
+    """
 
     currency: str
     """Three-letter ISO 4217 currency code."""
@@ -4799,7 +4938,8 @@ class SuccessfulPayment(Model):
 class ShippingQuery(Model):
     """Object `ShippingQuery`, see the [documentation](https://core.telegram.org/bots/api#shippingquery)
 
-    This object contains information about an incoming shipping query."""
+    This object contains information about an incoming shipping query.
+    """
 
     id: str
     """Unique query identifier."""
@@ -4817,7 +4957,8 @@ class ShippingQuery(Model):
 class PreCheckoutQuery(Model):
     """Object `PreCheckoutQuery`, see the [documentation](https://core.telegram.org/bots/api#precheckoutquery)
 
-    This object contains information about an incoming pre-checkout query."""
+    This object contains information about an incoming pre-checkout query.
+    """
 
     id: str
     """Unique query identifier."""
@@ -4847,7 +4988,8 @@ class PreCheckoutQuery(Model):
 class PassportData(Model):
     """Object `PassportData`, see the [documentation](https://core.telegram.org/bots/api#passportdata)
 
-    Describes Telegram Passport data shared with the bot by the user."""
+    Describes Telegram Passport data shared with the bot by the user.
+    """
 
     data: list["EncryptedPassportElement"]
     """Array with information about documents and other Telegram Passport elements 
@@ -4873,7 +5015,7 @@ class PassportFile(Model):
     file_size: int
     """File size in bytes."""
 
-    file_date: int
+    file_date: datetime
     """Unix time when the file was uploaded."""
 
 
@@ -4894,43 +5036,43 @@ class EncryptedPassportElement(Model):
 
     data: Option[str] = Nothing
     """Optional. Base64-encoded encrypted Telegram Passport element data provided 
-    by the user, available for `personal_details`, `passport`, `driver_license`, 
+    by the user; available only for `personal_details`, `passport`, `driver_license`, 
     `identity_card`, `internal_passport` and `address` types. Can be decrypted 
     and verified using the accompanying EncryptedCredentials."""
 
     phone_number: Option[str] = Nothing
-    """Optional. User's verified phone number, available only for `phone_number` 
+    """Optional. User's verified phone number; available only for `phone_number` 
     type."""
 
     email: Option[str] = Nothing
-    """Optional. User's verified email address, available only for `email` type."""
+    """Optional. User's verified email address; available only for `email` type."""
 
     files: Option[list["PassportFile"]] = Nothing
-    """Optional. Array of encrypted files with documents provided by the user, 
-    available for `utility_bill`, `bank_statement`, `rental_agreement`, 
+    """Optional. Array of encrypted files with documents provided by the user; 
+    available only for `utility_bill`, `bank_statement`, `rental_agreement`, 
     `passport_registration` and `temporary_registration` types. Files 
     can be decrypted and verified using the accompanying EncryptedCredentials."""
 
     front_side: Option["PassportFile"] = Nothing
     """Optional. Encrypted file with the front side of the document, provided 
-    by the user. Available for `passport`, `driver_license`, `identity_card` 
+    by the user; available only for `passport`, `driver_license`, `identity_card` 
     and `internal_passport`. The file can be decrypted and verified using 
     the accompanying EncryptedCredentials."""
 
     reverse_side: Option["PassportFile"] = Nothing
     """Optional. Encrypted file with the reverse side of the document, provided 
-    by the user. Available for `driver_license` and `identity_card`. The 
-    file can be decrypted and verified using the accompanying EncryptedCredentials."""
+    by the user; available only for `driver_license` and `identity_card`. 
+    The file can be decrypted and verified using the accompanying EncryptedCredentials."""
 
     selfie: Option["PassportFile"] = Nothing
     """Optional. Encrypted file with the selfie of the user holding a document, 
-    provided by the user; available for `passport`, `driver_license`, `identity_card` 
-    and `internal_passport`. The file can be decrypted and verified using 
-    the accompanying EncryptedCredentials."""
+    provided by the user; available if requested for `passport`, `driver_license`, 
+    `identity_card` and `internal_passport`. The file can be decrypted and 
+    verified using the accompanying EncryptedCredentials."""
 
     translation: Option[list["PassportFile"]] = Nothing
     """Optional. Array of encrypted files with translated versions of documents 
-    provided by the user. Available if requested for `passport`, `driver_license`, 
+    provided by the user; available if requested for `passport`, `driver_license`, 
     `identity_card`, `internal_passport`, `utility_bill`, `bank_statement`, 
     `rental_agreement`, `passport_registration` and `temporary_registration` 
     types. Files can be decrypted and verified using the accompanying EncryptedCredentials."""
@@ -4965,7 +5107,11 @@ class PassportElementErrorDataField(PassportElementError):
     """Error source, must be data."""
 
     type: typing.Literal[
-        "passport", "driver_license", "identity_card", "internal_passport", "address"
+        "passport",
+        "driver_license",
+        "identity_card",
+        "internal_passport",
+        "address",
     ]
     """The section of the user's Telegram Passport which has the error, one of `personal_details`, 
     `passport`, `driver_license`, `identity_card`, `internal_passport`, 
@@ -4991,7 +5137,10 @@ class PassportElementErrorFrontSide(PassportElementError):
     """Error source, must be front_side."""
 
     type: typing.Literal[
-        "passport", "driver_license", "identity_card", "internal_passport"
+        "passport",
+        "driver_license",
+        "identity_card",
+        "internal_passport",
     ]
     """The section of the user's Telegram Passport which has the issue, one of `passport`, 
     `driver_license`, `identity_card`, `internal_passport`."""
@@ -5033,7 +5182,10 @@ class PassportElementErrorSelfie(PassportElementError):
     """Error source, must be selfie."""
 
     type: typing.Literal[
-        "passport", "driver_license", "identity_card", "internal_passport"
+        "passport",
+        "driver_license",
+        "identity_card",
+        "internal_passport",
     ]
     """The section of the user's Telegram Passport which has the issue, one of `passport`, 
     `driver_license`, `identity_card`, `internal_passport`."""
@@ -5215,13 +5367,15 @@ class Game(Model):
 class CallbackGame(Model):
     """Object `CallbackGame`, see the [documentation](https://core.telegram.org/bots/api#callbackgame)
 
-    A placeholder, currently holds no information. Use BotFather to set up your game."""
+    A placeholder, currently holds no information. Use BotFather to set up your game.
+    """
 
 
 class GameHighScore(Model):
     """Object `GameHighScore`, see the [documentation](https://core.telegram.org/bots/api#gamehighscore)
 
-    This object represents one row of the high scores table for a game."""
+    This object represents one row of the high scores table for a game.
+    """
 
     position: int
     """Position in high score table for the game."""